Build images and compile programs with OE 2.5

- in Deutsch

- in English

This article requires some in-depth experience with Dreambox / Linux and is for advanced users.

The article describes the configuration of the OE 2.5 development environment under Linux, to build images and programs for a Dreambox. Supported models are:

• DM 520
• DM 525
• DM 820 HD
• DM 7080 HD
• DM 900
• DM 920

Supported operating systems

For the setup of the development environment linux is mandatory. Theoretically it's possible different distros. But only some are able to build OpenDreambox. The following distros can handle this ;)

• Ubuntu 16.04.1 LTS ”Xenial Xerus” [amd64]
• Xubuntu 16.04.1 LTS ”Xenial Xerus” [amd64]
• Debian 8.6 ”Jessie” [amd64]
• Mint 18 "Sarah" [amd64]

Install dependencies

The setup of the OE 2.5 development environment, and afterwards building the images and packages (deb) require some additional packages. The following sections describes the installation of the dependencies for the different Linux distros:

Debian / Ubuntu / Mint

Use the following command to install the dependencies:

sudo apt-get install git build-essential diffstat texi2html texinfo subversion chrpath cvs gawk gettext-lint autopoint gcc-multilib

If packages are missing, the build of the image will be terminated with an error message. E.g. if wget is not installed:

ERROR:  OE-core's config sanity checker detected a potential misconfiguration.
    Either fix the cause of this error or at your own risk disable the checker (see sanity.conf).
    Following is the list of potential problems / advisories:
 
    Please install following missing utilities: wget

other distros

In the Yocto Project Reference Manual, the dependencies for other distributions are described in the System Requirements section.

Create the development environment

Open the terminal and change the working directory, to the directory you want to use for the environment. The files of the git repository will be available in the directory opendreambox once the following command is executed.

git clone -b krogoth git://git.opendreambox.org/git/opendreambox.git

Now you can enter the directory opendreambox with the following command.

cd opendreambox

Update the development environment

Use the following command to update the OE 2.5 development environment (Dreambox SDK). Have some patience and wait until the update is completed. At the end you will see [*] The Dreambox SDK is now up-to-date.

make update

git user information (optional)

Enter your email address and user name with following commands (if not done before for older OE version, e.g. OE 2.2).

git config --global user.email "you@example.com"

git config --global user.name "Your Name"

Informations about the development environment

The following command will display useful informations concerning the development environment.

make help

Build an image

An image can be build for the following Dreamboxes.

• dm520, dm525, dm820, dm7080, dm900

Start the building process with the following command for the desired Dreambox type (e.g. for the DM 7080 HD). The download and the subsequent build of the image and packages can take a while. So please, be patient. The building process takes, depending on the resources, several hours and for every image approximately 38GB is needed.

make image MACHINE=dm7080

Images and packages

The images can be found in the following paths of the opendreambox environment.

/opendreambox/build/dm7080/tmp-xxx/deploy/images

Pakete (deb) sind im folgenden Verzeichnis zu finden.

/opendreambox/build/dm7080/tmp-xxx/deploy/deb

Update the development environment

Use the following command in your opendreambox directory to update the development environment. As a result, the changes of the git will be transfered into your local Dreambox SDK.

make update

Build an image

Start the building process with the following command for the desired Dreambox type (e.g. for the DM 7080 HD).:

make image MACHINE=dm7080

Build packages with BitBake

With the available recipes of the Dreambox SDK it's possible to use the bitbake command to create packages (*.deb). First of all, create the bitbake environment with following commands. Go to the opendreambox directory before entering the command.

source bitbake.env

Open the build directory of your Dreambox type. For the DM 7080 HD the command is:

cd build/dm7080

The build of a package is done like this:

bitbake $Package_name

For the program atftp the command is:

bitbake atftp

After the successful build, the package is available in the following directory:

/opendreambox/build/dm7080/tmp-xxx/deploy/deb

Show available recipes

The following command will display the available recipes for bitbake.

bitbake -s

As the list is quite long, you can limit the result:

bitbake -s | grep $desired_package

If the recipe for the wanted package is found, the package can be rebuild withe the command "bitbake $package_name". If the package is not found, you should use a personal or modified recipe to build the package. Or you can use the Cross Compiler (cross-compile.env Script), to compile the source code of a program / library.

Useful bitbake commands

List all of the tasks defined for a given package_name.

bitbake -c listtasks $package_name

Clean the work directory of a desired package.

bitbake -c clean $package_name

Build a desired recipe.

bitbake -b <pfad/zum/dem/recipe.bb>

Debug if files or variables are not found with the following command.

bitbake -D -D -D

Weblinks

• opendreambox.org
• Documentation about opendreambox
• opendreambox git Repository
• OpenEmbedded
• Openembedded manual
• Writing BitBake Recipes
• The Yocto Project Reference Manual (krogoth)]]