Images erstellen und Programme kompilieren unter OE 2.5

- in Deutsch

- in English

Dieser Artikel erfordert mehr Erfahrung im Umgang mit der Dreambox / Linux und ist daher nur für fortgeschrittene Benutzer gedacht.

Der Beitrag beschreibt das Einrichten der OE 2.5 Entwicklungsumgebung unter Linux, um Images und Programme für die Dreambox zu bauen. Unterstützt werden folgende Modelle:

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

Unterstützte Betriebssysteme

Für das erstellen der Entwicklungsumgebung wird zwingend Linux vorausgesetzt. In der Theorie können verschiedene Linux Distributionen eingesetzt werden. Aber nicht viele sind fähig OpenDreambox zu bauen. Die folgenden Distributionen sind dazu in der Lage ;)

• Ubuntu 16.04.1 LTS ”Xenial Xerus” [amd64]
• Xubuntu 16.04.1 LTS ”Xenial Xerus” [amd64]
• Debian 8.6 ”Jessie” [amd64]

Abhängigkeiten installieren

Das Einrichten der OE 2.5 Entwicklungsumgebung und das spätere Erstellen von Images und der einzelnen Pakete (deb) benötigt weitere Pakete, welche nachfolgend beschrieben sind. Der folgende Absatz beschreibt die Installation der Abhängigkeiten für verschiedene Linux Distributionen:

Debian / Ubuntu / Mint

Installiert die Abhängigkeiten mit folgendem Befehl:

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

Fehlen Pakete, bricht später die Wunschimageerstellung mit einer Fehlermeldung ab. Wenn z.B. wget nicht installiert ist, mit:

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

andere Distributionen

Im englischsprachigen Reference Manual des Yocto Project werden im Abschnitt System Requirements die Abhängigkeiten für andere Distributionen beschrieben.

Entwicklungsumgebung erstellen

Öffnet das Terminal und wechselt in euer Wunschverzeichnis, wo das Grundgerüst der Entwicklungsgebung abgelegt werden soll. Die Daten aus dem git Repository sind nach Ausführen des folgenden Befehls im Verzeichnis opendreambox zu finden.

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

Wechselt nun in das opendreambox Verzeichnis mit folgendem Befehl.

cd opendreambox

Entwicklungsumgebung aktualisieren

Aktualisiert nun die OE 2.5 Entwicklungsumgebung (Dreambox SDK) mit folgendem Befehl und wartet geduldig, bis der Vorgang mit der Meldung [*] The Dreambox SDK is now up-to-date abgeschlossen ist.

make update

git Benutzerinformationen (optional)

Gebt eure Email Adresse und den Benutzernamen mit folgenden Befehlen ein (wenn nicht schon gemacht für ältere OE Versionen z.B. OE 2.2).

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

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

Informationen zur Entwicklungsumgebung

Mit folgendem Befehl können hilfreiche Informationen zu der Entwicklungsumgebung angezeigt werden.

make help

Wunschimage bauen

Das Wunschimage könnt ihr für folgende Dreamboxtypen bauen.

• dm520, dm525, dm820, dm7080, dm900

Startet das Erstellen mit folgendem Befehl für den gewünschten Dreamboxtyp (z.B. für die DM 7080 HD). Das Herunterladen mit anschließendem Erstellen des Images und Paketen benötigt seine Zeit. Seid also bitte bei dem Vorgang sehr geduldig. Das Bauen benötigt je nach Rechnerleistung mehrere Stunden und der Speicherplatz pro Image beträgt ca. 38GB.

make image MACHINE=dm7080

Images und Pakete

Die erstellten Images findet ihr im opendreambox Verzeichnis unter folgendem Pfad.

/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.

Hilfreiche bitbake Befehle

Listet alle Tätigkeiten (Tasks) von einem gewünschten Paketnamen auf.

bitbake -c listtasks $paketname

Löscht das Arbeitsverzeichnis eines gewünschten Paketes

bitbake -c clean $paketname

Baut ein manuell, definiertes Rezept.

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

Der folgende Befehl wird zum Debuggen verwendet, wenn Variablen oder Dateien nicht gefunden werden.

bitbake -D -D -D

Weblinks

• opendreambox.org
• Dokumentation zu opendreambox
• opendreambox git Repository
• OpenEmbedded
• Openembedded Anleitung
• Writing BitBake Recipes
• The Yocto Project Reference Manual (krogoth)