Build images and compile programs with OE 2.2

Aus Gemini-Wiki
Zur Navigation springen Zur Suche springen
Deutsch.png - in Deutsch English.png - in English
Ambox attention.png This article requires some in-depth experience with Dreambox / Linux and is for advanced users.

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

  • DM 500 HD
  • DM 500 HD V2
  • DM 800 HD SE
  • DM 800 HD SE V2
  • DM 7020 HD
  • DM 7020 HD V2
  • DM 7080 HD
  • DM 8000 HD PVR
Ambox warning.png At this moment the images will only run on the DM 7080 HD, and not on the other listed Dreamboxes!

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 ;)

  • Debian 7.6 "Wheezy" [i386, amd64]
  • Ubuntu 14.04.1 LTS "Trusty Tahr" [amd64]
  • Mint Linux 17 [amd64]

Install dependencies

The setup of the OE 2.2 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:

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

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 Getting started of the Openembedded project the dependencies for other distros are described.

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 dora 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.2 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

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

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.

  • dm500hd, dm500hdv2, dm800se, dm800sev2, dm7020hd, dm7020hdv2, dm7080, dm8000
Ambox warning.png At this moment the images will only run on the DM 7080 HD, and not on the other listed Dreamboxes!

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

Entwicklungsumgebung aktualisieren

Aktualisiert die Entwicklungsumgebung mit folgendem Befehl in eurem opendreambox Verzeichnis. So werden neue Änderungen im git in euer Dreambox SDK einfliessen.

make update

Aktuelles Image erstellen

Startet die Imageerstellung für eure Wunschbox (z.B. DM 7080 HD) mit dem Befehl:

make image MACHINE=dm7080

Pakete mit BitBake erstellen

Mit den vorhandenen Recipes (Rezepten) im Dreambox-SDK könnt ihr mit dem bitbake Befehl Pakete (*.deb) erstellen. Zuerst muss mit folgendem Befehl die Umgebung für bitbake geschaffen werden. Wechselt in das opendreambox Verzeichnis und gebt folgenden Befehl ein.

source bitbake.env

Öffnet das build Verzeichnis von eurem Dreamboxtyp. Für die DM 7080 HD wäre der Befehl wie folgt.

cd build/dm7080

Das Erstellen von einem Paket erfolgt mit dem Befehl.

bitbake $Paketname

Für das Programm atftp ist der Befehl:

bitbake atftp

Die erstellten Pakete sind nach erfolgreichem Bauen im folgenden Verzeichnis zu finden.

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

Verfügbare Rezepte anzeigen

Die verfügbaren Rezepte für das Bauen mittels bitbake können mit folgendem Befehl aufgelistet werden.

bitbake -s

Da die Liste relativ lang ist, könnt ihr das Suchergebnis einschränken:

bitbake -s | grep $wunschpaket

Wird das gewünschte Paket gefunden, kann es wieder mit dem Befehl "bitbake $paketname" erstellt werden. Erscheint das Wunschpaket nicht, muss es mit einem eigenen oder angepassten Rezept erstellt werden. Oder man benutzt den Cross-Compiler (cross-compile.env Skript), um den Quellcode einer Anwendung / Bibliothek zu kompilieren.

Weblinks