VAR-SOM-MX6 Yocto GS eclipse

Programming with Eclipse and Yocto

Variscite added the required packages to the build images fsl-image-test and fsl-image-gui to enable Eclipse based Yocto development. This guide will describe how to install and use Eclipse/Yocto to develop application to run on VAR-SOM-MX6.
Detail information can be found:
http://www.yoctoproject.org/docs/latest/mega-manual/mega-manual.html#application-development-workflow
We tried to make this wiki as simple as possible.

Host tools

Build

make sure you are your build directory and environment are set correctly.

$ . ./setup-environment build_mx6q/

Build the tools:

$ bitbake meta-ide-support
$ bitbake meta-toolchain adt-installer

The result are a tools installer

$ ls tmp/deploy/sdk/

The results should be:
adt_installer.tar.bz2 poky-eglibc-x86_64-meta-toolchain-cortexa9hf-vfp-neon-toolchain-1.5.1.sh

Install

$ tmp/deploy/sdk/poky-eglibc-x86_64-meta-toolchain-cortexa9hf-vfp-neon-toolchain-1.5.1.sh

When system prompt "Enter target directory for SDK (default: /opt/poky/1.5.1):" hit enter.

When system prompt "You are about to install the SDK to "/opt/poky/1.5.1". Proceed[Y/n]?" hit Y and enter.

An install log should look like:

 tmp/deploy/sdk/poky-eglibc-x86_64-meta-toolchain-cortexa9hf-vfp-neon-toolchain-1.5.1.sh
 Enter target directory for SDK (default: /opt/poky/1.5.1):
 You are about to install the SDK to "/opt/poky/1.5.1". Proceed[Y/n]?Y
 Extracting SDK...done
 Setting it up...done
 SDK has been successfully set up and is ready to be used.

Eclipse installation

The following steps will guide you how to download and install Eclipse Keler CDT SR1.

Download and install

Download from:

http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/kepler/SR1/eclipse-cpp-kepler-SR1-linux-gtk-x86_64.tar.gz

$ cd ~/
$ tar xvf ../Downloads/eclipse-cpp-kepler-SR1-linux-gtk-x86_64.tar.gz

Run Eclipse:

$ eclipse/eclipse &

Set your workspace:

You can select any folder you like.
Close the "welcome window".
You should be at:

Eclipse install additional packages

Based on: http://www.yoctoproject.org/docs/latest/mega-manual/mega-manual.html#application-development-workflow

1. Start the Eclipse IDE.
2. Make sure you are in your Workbench and select "Install New Software" from the "Help" pull-down menu.
3. Select Kepler - http://download.eclipse.org/releases/kepler from the "Work with:" pull-down menu.
4. Expand the box next to "Linux Tools" and select the LTTng - Linux Tracing Toolkit boxes.
5. Expand the box next to "Mobile and Device Development" and select the following boxes:
   1. C/C++ Remote Launch
   2. Remote System Explorer End-user Runtime
   3. Remote System Explorer User Actions
   4. Target Management Terminal
   5. TCF Remote System Explorer add-in
   6. TCF Target Explorer
6. Expand the box next to "Programming Languages" and select the Autotools Support for CDT and C/C++ Development Tools boxes.
7. Complete the installation and restart the Eclipse IDE.
   

Comment:
Some of the packages may be already installed.

An install window example:

Yocto plug-in

There are more then one option to get the plug-in. We selected to use: Pre-built Plug-in from the Yocto Project Eclipse Update Site

To install the Eclipse Yocto Plug-in from the update site, follow these steps:

1. Start up the Eclipse IDE.
2. In Eclipse, select "Install New Software" from the "Help" menu.
3. Click "Add..." in the "Work with:" area.
4. Enter http://downloads.yoctoproject.org/releases/eclipse-plugin/1.5/kepler in the URL field and provide a meaningful name in the "Name" field.
5. Click "OK" to have the entry added to the "Work with:" drop-down list.
6. Select the entry for the plug-in from the "Work with:" drop-down list.
7. Check the boxes next to Yocto Project ADT Plug-in, Yocto Project Bitbake Commander Plug-in, and Yocto Project Documentation plug-in.
8. Complete the remaining software installation steps and then restart the Eclipse IDE to finish the installation of the plug-in.
   

Configuring the Eclipse Yocto Plug-in

Configuring the Eclipse Yocto Plug-in involves setting the Cross Compiler options and the Target options. The configurations you choose become the default settings for all projects. You do have opportunities to change them later when you configure the project (see the following section). To start, you need to do the following from within the Eclipse IDE:

• Choose "Preferences" from the "Windows" menu to display the Preferences Dialog.
• Click "Yocto Project ADT".

Configuring the Cross-Compiler Options

To configure the Cross Compiler Options, you must select the type of toolchain, point to the toolchain, specify the sysroot location, and select the target architecture.

• Selecting the Toolchain Type:

If you build your target based on Variscite WIKI your Toolchanin path will be /home/<uname>/var-som-mx6-dora-v3/build_mx6q. Otherwise point to your build folder.

• Specify the Sysroot Location:

If you build your target based on Variscite WIKI your Toolchanin path will be /home/<uname>/var-som-mx6-dora-v3/build_mx6q/tmp/sysroots/varsommx6q. Otherwise point to your build folder.

This location is where the root filesystem for the target hardware resides.

• Select the Target Architecture: The target architecture will be selected automatically based on your build.
  

Configuring the Target Options

You can choose to emulate hardware using the QEMU emulator, or you can choose to run your image on actual hardware.

   QEMU: Select this option if you will be using the QEMU emulator. If you are using the emulator, you also need to locate the kernel and specify any custom options.

   If you selected Build system derived toolchain, the target kernel you built will be located in the Build Directory in tmp/deploy/images/<machine> directory. If you selected Standalone pre-built toolchain, the pre-built image you downloaded is located in the directory you specified when you downloaded the image.

   Most custom options are for advanced QEMU users to further customize their QEMU instance. These options are specified between paired angled brackets. Some options must be specified outside the brackets. In particular, the options serial, nographic, and kvm must all be outside the brackets. Use the man qemu command to get help on all the options and their use. The following is an example:

       serial ‘<-m 256 -full-screen>’
                                   

   Regardless of the mode, Sysroot is already defined as part of the Cross-Compiler Options configuration in the Sysroot Location: field.

   External HW: Select this option if you will be using actual hardware.

Click the "OK" to save your plug-in configurations.