Difference between revisions of "OpenEmbedded Tools for Eclipse (OTE)"

From Openembedded.org
Jump to: navigation, search
(Install OpenEmbedded)
 
(30 intermediate revisions by 5 users not shown)
Line 1: Line 1:
NOTE: page not complete.
+
{{Outdated}}
  
 
= Overview =
 
= Overview =
  
OpenEmbedded Tools for Eclipse (OTE) is a set of Eclipse plugins to make using OpenEmbedded from within Eclipse possible.   
+
OpenEmbedded Tools for Eclipse (OTE) is a set of Eclipse plugins to make using OpenEmbedded from within Eclipse possible.  This page describes a set of workflows that perform common OpenEmbedded tasks, as well as the current state of development of the plugins.
  
 
= Status =
 
= Status =
  
 
OTE is in a beta form.  Functionality present within the plugins should work well, but development on them is fairly new.  Bugs are expected!
 
OTE is in a beta form.  Functionality present within the plugins should work well, but development on them is fairly new.  Bugs are expected!
 +
 +
== Changelog ==
 +
 +
=== <tt>0.8.5</tt>===
 +
Bug Fixes
 +
* Invalid thread access in console view when starting build.
 +
* No longer use "-b" option in Bitbake to specify build recipe, due to
 +
problems in Bitbake.
 +
 +
Features
 +
* Deprecate outdated Bug Labs Linux installer option.
 +
* Update OpenEmbedded Dev installer option with newer bitbake and
 +
configuration variables.
 +
 +
Known Issues
 +
* "Import recipe as project" feature relies on "bitbake -b" option.
 +
In recent Bitbake versions, this feature is broken, so the Eclipse
 +
action is also broken.
 +
 +
=== <tt>0.7.0</tt> ===
 +
* Numerous fixes in <b>Create Project Wizard</b> to sync to latest OE-Dev install.
  
 
== License ==
 
== License ==
Line 43: Line 64:
  
 
[[Image:Ote create project wizard 4.png]]
 
[[Image:Ote create project wizard 4.png]]
 +
 +
5. Now by clicking finish, an Eclipse project will be created.  It may take a few moments for Eclipse to index all the files in the project.  Your workbench should look something like this:
 +
 +
[[Image:Ote workbench 1.png]]
  
 
== Import Existing OE into Workspace ==
 
== Import Existing OE into Workspace ==
 +
To access the Import Project wizard, select <tt>File -> Import...</tt> and select the <b>Import OpenEmbedded Project</b> wizard from the general dialog like so:
 +
 +
[[Image:Ote import project wizard 1.png]]
 +
 +
Next fill in the three fields required for importing the project. 
 +
* Name: this is the name of the Eclipse project in your workspace and can be anything.
 +
* Location: this is the base directory of your OpenEmbedded project.
 +
* Init Script: this is the shell script that initializes OE environment variables and updates the path.
 +
 +
[[Image:Ote_import_project_wizard_2.png]]
 +
 +
The final wizard page shows the output of what you would see in the terminal after executing <tt>bitbake -e</tt>.
 +
 +
[[Image:Ote_import_project_wizard_3.png]]
 +
 +
After clicking finish a new project should be available in your workspace.  Depending on your machine it may take some moments for Eclipse to scan the entire set of files.  It is important to note that even though the project appears in your Eclipse workspace, the files are accessed from your OE project root.  So, modifications to these files will be reflected in your existing OE install.
  
 
== Create Recipe ==
 
== Create Recipe ==
 +
 +
This simple wizard generates a template recipe file based on fields that are entered by the user.  The wizard can be accessed via <tt>File -> New...</tt> and selecting New OpenEmbedded Recipe from the dialog.  Here is what the wizard looks like:
 +
 +
[[Image:Ote create recipe wizard 1.png]]
 +
 +
Now by entering the fields and selecting <b>Finish</b> a new recipe will be generated.  Note that currently the Location field must contain a valid directory, so if you're creating a completely new recipe you'll need to create the directory before running this wizard.  Here is an example of a recipe filled out:
 +
 +
[[Image:Ote create recipe wizard 2.png]]
 +
 +
After clicking <b>Finish</b> Eclipse will open an editor on the generated file.  Here is an example:
 +
 +
[[Image:Ote create recipe wizard 3.png]]
 +
 +
From here the user can add necessary details to the recipe for building.
  
 
== Edit Recipe ==
 
== Edit Recipe ==
  
=== Editor templates and hover-over information ===
+
 
 +
 
 +
Recipes can be selected in the Navigator view by opening the <tt>recipes</tt> or <tt>packages</tt> directory in your OpenEmbedded install.  Any file with a <tt>.bb, .inc</tt> or <tt>.conf</tt> extension will be loaded by the BitBake editor.  This editor offers the following features.
 +
=== Find Recipe ===
 +
Eclipse offers a nice file selection dialog that allows for files to be quickly edited without navigating through many folders.  This dialog is activated with <tt>ctrl-shift-r</tt>.  The 'r' stands for resource, Eclipse terminology for a file.  In this dialog begin typing the file you want to edit.  Wildcards and regular expressions are supported.  Previously edited files are already available.  Here is a screenshot of the dialog:
 +
 
 +
[[Image:Ote_resource_browser_1.png]]
 +
 
 +
=== Syntax Highlighting ===
 +
The recipe file in the editor will color various sections of the recipe.  For example comments will be green, variable declarations will be blue.
 +
=== Variable Auto-Completion ===
 +
Some conventional variables are available by hitting <tt>ctrl-space</tt> in the editor window.  Here is a screenshot of the context menu:
 +
 
 +
[[Image:Ote_edit_recipe_3.png]]
 +
=== Function Templates ===
 +
The bitbake editor will create a template function or <tt>addtask</tt> declaration when selected from the <tt>ctrl-space</tt> menu.
 +
=== Hover-over Variable Information ===
 +
The bitbake editor will show the value of previously declared variables when the mouse is put over them.  The appear as tooltip text.  Here is an example of this feature:
 +
 
 +
[[Image:Ote_edit_recipe_2.png]]
  
 
== Build Recipe ==
 
== Build Recipe ==
  
== Import Recipe sources as new project ==
+
A package can be generated from Eclipse via the toolbar or the context menu.  This function essentially calls <b><tt>bitbake -b <selected package></tt></b> to perform the build.  The output of the <tt>bitbake</tt> command will be displayed in the console view.
 +
 
 +
== Import Recipe Sources as New Project ==
 +
 
 +
This allows application developers to create a source project from an OpenEmbedded recipe.  This is a simple way to begin modifying a project from within Eclipse.  Other Eclipse plugins such as [http://www.eclipse.org/cdt/ CDT (C/C++ development tools)] or [http://pydev.org/ PyDev (Python development tools)] may be used with these imported projects.  However automatic integration is not supported from within OTE and adding appropriate project natures will either need to be done from within the respective plugin or manually by editing the <tt>.project</tt> file in your project.
  
 
== Browse OE variables ==
 
== Browse OE variables ==
 +
OTE provides a quick way of viewing and searching through BitBake/OE variables.  The wizard is activate from the OTE toolbar and looks like this:
 +
 +
[[Image:Ote variable browser 1.png]]
 +
 +
= Contact =
 +
Please see the [http://groups.google.com/group/openembedded-tools-for-eclipse OTE Google Group] for questions or problems with OTE.
 +
 +
[[Category:User]]

Latest revision as of 17:43, 3 November 2012

NOTE: This page has been identified as having content that is significantly out-of-date, usually because it refers to OpenEmbedded-Classic - for new projects, you should use OpenEmbedded-Core.

See OpenEmbedded Wiki Update Project for more details.

Overview

OpenEmbedded Tools for Eclipse (OTE) is a set of Eclipse plugins to make using OpenEmbedded from within Eclipse possible. This page describes a set of workflows that perform common OpenEmbedded tasks, as well as the current state of development of the plugins.

Status

OTE is in a beta form. Functionality present within the plugins should work well, but development on them is fairly new. Bugs are expected!

Changelog

0.8.5

Bug Fixes

  • Invalid thread access in console view when starting build.
  • No longer use "-b" option in Bitbake to specify build recipe, due to

problems in Bitbake.

Features

  • Deprecate outdated Bug Labs Linux installer option.
  • Update OpenEmbedded Dev installer option with newer bitbake and

configuration variables.

Known Issues

  • "Import recipe as project" feature relies on "bitbake -b" option.

In recent Bitbake versions, this feature is broken, so the Eclipse action is also broken.

0.7.0

  • Numerous fixes in Create Project Wizard to sync to latest OE-Dev install.

License

OTE is licensed under the Eclipse Public License (EPL).

Source

Sources are available at svn://svn.buglabs.net/ote/trunk.

Updatesite

The OTE updatesite, used to install the plugins from within Eclipse:

http://bugcommunity.com/downloads/files/ote/updatesite/

Workflow

OTE is designed to facilitate a set of typical actions or tasks that an OE developer would do.

Install OpenEmbedded

1. To install a new copy of OpenEmbedded, select the wizard from the File -> New... -> Other... menu. Ote create project wizard 1.png


2. Next, select the flavor of OpenEmbedded you wish to install. Ote create project wizard 2.png


3. Now specify configuration parameters. If fields are unfamiliar, leave the defaults and proceed. Ote create project wizard 3.png


4. Assuming all the necessary system tools are available, the wizard will download sources and configure your new OpenEmbedded install.


Ote create project wizard 4.png

5. Now by clicking finish, an Eclipse project will be created. It may take a few moments for Eclipse to index all the files in the project. Your workbench should look something like this:

Ote workbench 1.png

Import Existing OE into Workspace

To access the Import Project wizard, select File -> Import... and select the Import OpenEmbedded Project wizard from the general dialog like so:

Ote import project wizard 1.png

Next fill in the three fields required for importing the project.

  • Name: this is the name of the Eclipse project in your workspace and can be anything.
  • Location: this is the base directory of your OpenEmbedded project.
  • Init Script: this is the shell script that initializes OE environment variables and updates the path.

Ote import project wizard 2.png

The final wizard page shows the output of what you would see in the terminal after executing bitbake -e.

Ote import project wizard 3.png

After clicking finish a new project should be available in your workspace. Depending on your machine it may take some moments for Eclipse to scan the entire set of files. It is important to note that even though the project appears in your Eclipse workspace, the files are accessed from your OE project root. So, modifications to these files will be reflected in your existing OE install.

Create Recipe

This simple wizard generates a template recipe file based on fields that are entered by the user. The wizard can be accessed via File -> New... and selecting New OpenEmbedded Recipe from the dialog. Here is what the wizard looks like:

Ote create recipe wizard 1.png

Now by entering the fields and selecting Finish a new recipe will be generated. Note that currently the Location field must contain a valid directory, so if you're creating a completely new recipe you'll need to create the directory before running this wizard. Here is an example of a recipe filled out:

Ote create recipe wizard 2.png

After clicking Finish Eclipse will open an editor on the generated file. Here is an example:

Ote create recipe wizard 3.png

From here the user can add necessary details to the recipe for building.

Edit Recipe

Recipes can be selected in the Navigator view by opening the recipes or packages directory in your OpenEmbedded install. Any file with a .bb, .inc or .conf extension will be loaded by the BitBake editor. This editor offers the following features.

Find Recipe

Eclipse offers a nice file selection dialog that allows for files to be quickly edited without navigating through many folders. This dialog is activated with ctrl-shift-r. The 'r' stands for resource, Eclipse terminology for a file. In this dialog begin typing the file you want to edit. Wildcards and regular expressions are supported. Previously edited files are already available. Here is a screenshot of the dialog:

Ote resource browser 1.png

Syntax Highlighting

The recipe file in the editor will color various sections of the recipe. For example comments will be green, variable declarations will be blue.

Variable Auto-Completion

Some conventional variables are available by hitting ctrl-space in the editor window. Here is a screenshot of the context menu:

Ote edit recipe 3.png

Function Templates

The bitbake editor will create a template function or addtask declaration when selected from the ctrl-space menu.

Hover-over Variable Information

The bitbake editor will show the value of previously declared variables when the mouse is put over them. The appear as tooltip text. Here is an example of this feature:

Ote edit recipe 2.png

Build Recipe

A package can be generated from Eclipse via the toolbar or the context menu. This function essentially calls bitbake -b <selected package> to perform the build. The output of the bitbake command will be displayed in the console view.

Import Recipe Sources as New Project

This allows application developers to create a source project from an OpenEmbedded recipe. This is a simple way to begin modifying a project from within Eclipse. Other Eclipse plugins such as CDT (C/C++ development tools) or PyDev (Python development tools) may be used with these imported projects. However automatic integration is not supported from within OTE and adding appropriate project natures will either need to be done from within the respective plugin or manually by editing the .project file in your project.

Browse OE variables

OTE provides a quick way of viewing and searching through BitBake/OE variables. The wizard is activate from the OTE toolbar and looks like this:

Ote variable browser 1.png

Contact

Please see the OTE Google Group for questions or problems with OTE.