Introduction

The Yocto Source Package allows the entire Linux software stack (Kernel, drivers, device tree, root file system) targeting the SoC FPGA to be built in a very simple and convenient way.

The Yocto Eclipse plugin fulfills the need of the application developers to be able to target the Linux software stack without requiring them to learn the details on how to build the system. This enables the developers to focus on what they know best – developing applications.

The Yocto Eclipse plugin installs on top of ARM DS-5 Altera Edition. This wiki contains the instructions on how to install and use the Eclipse Yocto Plugin.

Prerequisites

The following prerequisites need to be satisfied before using the Yocto Plugin:

• Install and build the Yocto Source Package as described in DocumentationAYoctoUserManual.

$ wget http://download.altera.com/akdlm/software/acdsinst/13.0/156/ib_installers/linux-socfpga-13.02-RC10-src.bsx
$ chmod +x linux-socfpga-13.02-RC10-src.bsx
$ sudo ./linux-socfpga-13.02-RC10-src.bsx
$ /opt/altera-linux/bin/install_altera_socfpga_src.sh ~/yocto
$ source ~/yocto/altera-init ~/yocto/build
$ bitbake virtual/kernel virtual/bootloader altera-image

• Build two additional targets in the Yocto Source Package using the following commands. They are required by the Eclipse Yocto Plugin:

$ source ~/yocto/altera-init ~/yocto/build
$ bitbake meta-ide-support adt-installer

• Install the SoC EDS toolset from: https://www.altera.com/download/software/soc-eds . If you do not have a license, follow the instructions to obtain the free Web Edition license.

Installing Eclipse Yocto Plugin

This section presents how to install the Eclipse Yocto plugin.

Note that, depending on your network configuration, you may need to setup a proxy for the Eclipse to be able to access the Internet. If you are behind a proxy, you may configure Eclipse to use it by going to Window → Preferences to open Preferences window. Then, in the Preferences window, go to General → Network Connections and enter the correct settings.

The steps to install the Eclipse Yocto plugin are:

• Start ARM DS-5 Altera Edition (part of the SoC EDS toolset)
• Go to Help → Install New Software
• In the Work With edit box, type the following address: http://downloads.yoctoproject.org/releases/eclipse-plugin/1.2.2 and click the Add button

• In the Add Repository window that appears, edit the name to be Yocto and click the OK button

• In the Install window, make sure the newly entered site is selected and click Next

• Eclipse will ask for a confirmation. Click Next

• Eclipse will then ask to accept the Licensing Terms. Select Accept and click Next

• Eclipse will then ask for confirmation on installing usigned content. Press OK

• Eclipse will then ask permission to restart in order to apply the updates. Press Restart Now

• Congratulations! The Eclipse Yocto Plugin is now installed.

Configuring Eclipse Yocto Plugin

The Eclipse Yocto plugin needs to be configured with the proper settings to be able to work with the Yocto source package on the host computer.

The following steps are required:

• In Eclipse, go to Window → Preferences to open the Preferences window.
• In Preferences window, select the last category in the left panel, which sould be Yocto Project ADT
• Enter the following settings:
  • Select the Build system dervied toolchain option.
  • For Toolchain Root Location enter /home/user/yocto/build
  • For Sysroot Location enter /home/user/yocto/build/tmp/sysroots/socfpga_cyclone5
  • For Target Architecture select armv7ahf-vfp-neon-poky-linux which should be the only available option.

• Press Apply to apply the settings. If there is any problem with them, Eclipse will signal it.
• Press OK to close the Settings window.

The above assume that you have used the default paths when you have built the Yocto source package and your user name is user. Update accordingly if these assumptions are not correct.

Creating and Building Sample Application

The Eclipse Yocto Plugin comes with an easy way to create a sample application. The steps to do that are:

• Start Eclipse
• Go to File → New → C Project
• Enter Project Name to be Hello
• Select the Project Type to be Yocto Project ADT Project → Hello World ANSI C Autotools Project

• Click the Next button
• Enter the desired options (or leave the defaults and just enter the Author) and click Finish

• The Eclipse will show the newly created project

• Build the project by selecting it and selecting Build from the menu that appears when right-clicking it. Eclipse will build the project, with the log being available in the Console window

• Congratulations! You have created an built your first project targetting the Yocto package.

Limitations

The Yocto Project and Yocto Eclipse plugin are rapidly evolving and there are some limitations that apply ….

References

• Yocto Eclipse Plugin web page: https://www.yoctoproject.org/tools-resources/projects/eclipse-ide-plug
• Yocto ADT web page: https://www.yoctoproject.org/tools-resources/projects/application-development-toolkit-adt
• Yocto ADT User Manual: http://www.yoctoproject.org/docs/current/adt-manual/adt-manual.html