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

From Openembedded.org
Jump to: navigation, search
(Create Recipe)
(Edit Recipe)
Line 97: Line 97:
 
== 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.
 +
=== 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 ==

Revision as of 19:20, 24 December 2009

Overview

This page is a work in progress.  

OpenEmbedded Tools for Eclipse (OTE) is a set of Eclipse plugins to make using OpenEmbedded from within Eclipse possible.

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!

Current Work

  • Documentation
  • Bug Fixes

Version

Current available version is 0.7.0.

Changelog

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.

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

Import Recipe sources as new project

Browse OE variables