View source for Using Yocto/ELBE SDK for application development

'''<big>This site is under construction!</big>'''

Root filesystems made by Yocto and ELBE can come with a SDK to build applications for the rootFS.

__TOC__

== Installation ==

To install the SDK the following packets have to be installed on the machine:
* xz-utils
* file
* patchelf

Run the setup-script (e.g. setup-elbe-sdk-arm-linux-gnueabihf-dhcom-buster-1.0.sh) as root to start the installation.

== Using the SDK ==

The SDK consists of two parts:
* A folder with two sysroots
** "host": In this folder are the programms for the development host for using the SDK (e.g. compiler, debugger, ...).
** "target": This sysroot contains headers and libraries needed by the linker to build applications for the rootFS.
* A file with environment variables to setup the build environment (sourcing this file sets variables like ${CC} or ${LD})

Folowing are instructions how to use the SDK with different build-systems and IDEs (All examples using an ELBE toolchain installed at "<nowiki>opt/elbe-sdk-arm-linux-gnueabihf-dhcom-buster-1.0</nowiki>"):

=== Makefiles ===

Open a shell and source the file with the environment variables:

 <nowiki>user@machine:/<projectdir># source /opt/elbe-sdk-arm-linux-gnueabi-dhcom-buster-1.0/environment-setup-elbe-arm-linux-gnueabihf-dhcom-buster-1.0</nowiki>

Now you can use make to build applications in this shell session.

 <nowiki>user@machine:/<projectdir># make</nowiki>

If you want to use another toolchain, you have to start a new shell session.

'''Important:''' Do not overwrite variables which were set by SDK in the makefile (or call make with '-e' to discard variables set in the makefile).

=== CMake ===

Setting up CMake to use the toolchain in the SDK is not much different than makefiles:

At first source the file with the environment variables inside a shell:

 <nowiki>user@machine:/<projectdir># source /opt/elbe-sdk-arm-linux-gnueabi-dhcom-buster-1.0/environment-setup-elbe-arm-linux-gnueabihf-dhcom-buster-1.0</nowiki>

Now, for the remainder of this shell session, you can use CMake with this SDK:

 <nowiki>user@machine:/<projectdir># cd build
user@machine:/<projectdir>/build# cmake ..
user@machine:/<projectdir>/build# cd ..
user@machine:/<projectdir># cmake --build build</nowiki>

If you want to use another toolchain, you have to start a new shell session.

=== Qt-Creator ===

Start Qt Creator.

Now open the "Options"-window (Tools -> Options).

In the section "Build & Run" add in the "Compilers"-tab new compilers for C and C++ (Add -> GCC --> C / C++). Set the compiler path to the fitting executable in "/opt/elbe-sdk-arm-linux-gnueabihf-dhcom-buster-1.0/sysroots/host/usr/bin/".

[[File:QtCreatorGCC.png|none|Example configuration for the compiler of the SDK]]

If the toolchain in the SDK includes Qt, switch to the "Qt Versions"-tab and add the qmake executable of the toolchain (usually in "/opt/elbe-sdk-arm-linux-gnueabihf-dhcom-buster-1.0/sysroots/host/usr/bin/qt5/qmake").

For the debugger, change to the "Debuggers"-tab and add the gdb-multiarch executable of the toolchain (usually in "/opt/elbe-sdk-arm-linux-gnueabihf-dhcom-buster-1.0/sysroots/host/usr/bin/gdb-multiarch").

[[File:QtCreatorGDB.png]]

If you want to deploy built software directly onto the embedded device, then change to the section "Devices" and add a new device. Select "Generic Linux Device" and set the IP-address, username and password.

Now change back to the section "Build & Run". In the tab "Kits" you have to add a new Kit for the toolchain. Set the compilers, debuggers, Qt and the device to these, which you have defined at the preceding steps. If the SDK does not include Qt you have to set Qt to "None" (like in the example).

[[File:QtCreatorKit.png]]

Now you have to define the environment. Set the environment for the kit according to the environment setup file (but remove the "export" statements). If there are files inside the folders "/opt/elbe-sdk-arm-linux-gnueabihf-dhcom-buster-1.0/sysroots/host/environment-setup.d/" or "/opt/elbe-sdk-arm-linux-gnueabihf-dhcom-buster-1.0/sysroots/target/environment-setup.d/", any environment variables which are set in those have also be included.

[[File:QtCreatorEnv.png|1311px]]


Now any project in Qt Creator can use the toolchain of the SDK if the kit is selected for the project. If you want to use another SDK-toolchain, you can switch the used kit for the project.

=== Eclipse ===

==External Links==

* [https://www.yoctoproject.org/docs/3.1/sdk-manual/sdk-manual.html Yocto SDK documentation]
* [https://www.ics.com/blog/configuring-qt-creator-yocto-development Blog on configuring Qt Creator for Yocto SDK]
* [https://wiki.phytec.com/productinfo/how-to-articles/how-to-set-up-yocto-plugin-for-eclipse How-to for using the Yocto SDK with Eclipse] - NOTE: The Yocto plugin for Eclipse mentioned at this site is no longer maintained (in 2020) and is not available on recent versions of Eclipse!