OpenEmbedded Tools for Eclipse (OTE)

From Openembedded.org
Revision as of 19:33, 24 December 2009 by Kengilmer (talk | contribs) (Browse OE variables)
Jump to: navigation, search

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

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