Overview

This guide will go through setting up a build environment and building an x86_64 image, and adding a small „hello world“ application to it. This page is a summary of the information from Setup and Building, Recipes and devtool.

Setting up the Build Environment

Create a directory in a suitable place to store everything related to this build. This guide will assume everything is in a directory called yocto in your the home of the user ubuntu: /home/ubuntu/yocto. This folder can by anywhere on the system though.

Next, clone poky, yocto's reference distribution. At the time of writing yocto-3.0.2 is the newest release, feel free to substitute it for a newer/different version.

$ git clone -b kirkstone git://git.yoctoproject.org/poky 

Next, create a build directory:

$ mkdir build 

Now we can initialize yocto using:

$ . poky/oe-init-build-env build/ 

This will populate the build directory with all necessary files and give you access to bitbake, the build system used by yocto.

Setting the Machine

Setting the machine tells bitbake what hardware to build for. This build will be a 64bit qemu image, so we can set the machine to qemu86-64. This means we can run this image in Qemu.

Open local.conf

$ nano conf/local.conf 

and add this line to set the machine:

MACHINE = "qemux86-64"

The build environment is now set up.

Building an Image

You can now build an image. This command will build a minimal image provided by poky:

$ bitbake core-image-minimal 

Once the image is built, it can be run in qemu using

$ runqemu qemux86-64 nographic 

runqemu is a script that comes with bitbake, qemux86-64 specifies the machine, and nographic tells qemu to run in the terminal rather than its own window. This is useful when building on a system with no graphical environment such as a container or when building in the cloud.

The default login is root with no password. You can use poweroff to shut down the virtual machine and exit qemu.

Creating a Hello World C++ Application

This section will show you how to create a hello world application in C++ with Cmake.

First, create a directory in your yocto folder. This will contain the application itself. The location is arbitrary, and was chosen merely for convenience. It could be anywhere. Assuming you are still in the build directory:

$ mkdir ../helloworld 

Next, create a main.cpp in the new directory

$ cd ../helloworld 
$ nano helloworld.cpp 

with the following content:

#include<iostream>

int main() {
        std::cout << "Hello World!\n";
        return 0;
}

Now create a CMakeLists.txt for cmake:

$ nano CMakeLists.txt 

CMakeLists.txt

cmake_minimum_required(VERSION 3.5)

project(yocto-test LANGUAGES CXX)

add_executable(hello helloworld.cpp)

install(TARGETS hello DESTINATION bin)

Optional: Verifying that the Application Works

This is an optional step to verify the application itself is built correctly before adding it to the image. Create a build directory inside the application folder for cmake to store its data in. Then execute cmake inside that folder to create the build configuration and build the application by running make. Now there should be a hello executable that prints „hello world“ when executed. After confirming it works, change back to yocto/build before continuing with the next step.

$ mkdir build 
$ cd build 
$ cmake .. 
$ make 
$ ./hello 
$ cd ../../build 

Creating a Recipe for the application

We use devtool to create a new Recipe for our hello application.

$ devtool add ../helloworld/ 

This should finish with a message similar to this one:

$ INFO: Recipe /home/ubuntu/yocto/build/workspace/recipes/helloworld/helloworld.bb has been automatically created; further editing may be required to make it fully functional 

This means devtool ran successfully and created a recipe at the specified location.

To test whether this recipe works, build it by running bitbake:

$ bitbake helloworld 

This should run without errors and print something like this when it's finished:

$ NOTE: Tasks Summary: Attempted 506 tasks of which 497 didn't need to be rerun and all succeeded. 

This means the package provided by the recipe was built successfully.

Adding the Recipe to the Image

Now that we have a recipe, we need to add it to the image to test it out. Adding packages to recipes is done in conf/local.conf by appending them to CORE_IMAGE_EXTRA_INSTALL:

Edit local.conf

$ nano conf/local.conf 

and add the following:

CORE_IMAGE_EXTRA_INSTALL += "helloworld"

Rebuild the image

$ bitbake core-image-minimal 

And run qemu

$ runqemu qemux86-64 nographic 

Log in as root and you can now run our hello application:

root@qemux86-64:~# hello
root@qemux86-64:~# HELLO WORLD! 

Congratulations! You have now developed your own C++ application and added it to a yocto image.