Quelltext der Seite Images erstellen und Programme kompilieren unter OE 2.5

{|width="40%"
 |[[Bild:deutsch.png]] - [[Images erstellen und Programme kompilieren unter OE 2.5|in Deutsch]]
 |[[Bild:english.png]] - [[Build images and compile programs with OE 2.5|in English]]
 |}

{{Achtung| 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 [http://de.wikipedia.org/wiki/Linux Linux], um [[CVS / OE - Image|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
* DM 920

== 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]
* Mint 18 "Sarah" [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:
<syntaxhighlight>
sudo apt-get install git build-essential diffstat texi2html texinfo subversion chrpath cvs gawk gettext-lint autopoint gcc-multilib
</syntaxhighlight>
Fehlen Pakete, bricht später die Wunschimageerstellung mit einer Fehlermeldung ab. Wenn z.B. <code>wget</code> nicht installiert ist, mit:
<syntaxhighlight>
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
</syntaxhighlight>

=== andere Distributionen ===

Im englischsprachigen Reference Manual des Yocto Project werden im Abschnitt [https://www.yoctoproject.org/docs/2.1.1/ref-manual/ref-manual.html#required-packages-for-the-host-development-system 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 [http://de.wikipedia.org/wiki/Git git] Repository sind nach Ausführen des folgenden Befehls im Verzeichnis <code>opendreambox</code> zu finden.
<syntaxhighlight>
git clone -b krogoth git://git.opendreambox.org/git/opendreambox.git
</syntaxhighlight>
Wechselt nun in das <code>opendreambox</code> Verzeichnis mit folgendem Befehl.
<syntaxhighlight>
cd opendreambox
</syntaxhighlight>

=== Entwicklungsumgebung aktualisieren ===
Aktualisiert nun die OE 2.5 Entwicklungsumgebung (Dreambox [http://de.wikipedia.org/wiki/Software_Development_Kit SDK]) mit folgendem Befehl und wartet geduldig, bis der Vorgang mit der Meldung <code>[*] The Dreambox SDK is now up-to-date</code> abgeschlossen ist.
<syntaxhighlight>
make update
</syntaxhighlight>

=== 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]]).
<syntaxhighlight>
git config --global user.email "you@example.com"
</syntaxhighlight>
<syntaxhighlight>
git config --global user.name "Your Name"
</syntaxhighlight>

=== Informationen zur Entwicklungsumgebung ===
Mit folgendem Befehl können hilfreiche Informationen zu der Entwicklungsumgebung angezeigt werden.
<syntaxhighlight>
make help
</syntaxhighlight>

=== 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 [[Dreambox-Varianten|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.
<syntaxhighlight>
make image MACHINE=dm7080
</syntaxhighlight>

=== Images und Pakete ===
Die erstellten Images findet ihr im <code>opendreambox</code> Verzeichnis unter folgendem Pfad.
<syntaxhighlight>
/opendreambox/build/dm7080/tmp-xxx/deploy/images
</syntaxhighlight>
Pakete (deb) sind im folgenden Verzeichnis  zu finden.
<syntaxhighlight>
/opendreambox/build/dm7080/tmp-xxx/deploy/deb
</syntaxhighlight>

== Entwicklungsumgebung aktualisieren ==
Aktualisiert die Entwicklungsumgebung mit folgendem Befehl in eurem <code>opendreambox</code> Verzeichnis. So werden neue Änderungen im git in euer Dreambox SDK einfliessen.
<syntaxhighlight>
make update
</syntaxhighlight>

=== Aktuelles Image erstellen ===
Startet die Imageerstellung für eure Wunschbox (z.B. DM 7080 HD) mit dem Befehl:
<syntaxhighlight>
make image MACHINE=dm7080
</syntaxhighlight>

== Pakete mit BitBake erstellen ==
Mit den vorhandenen Recipes (Rezepten) im Dreambox-SDK könnt ihr mit dem [http://en.wikipedia.org/wiki/BitBake bitbake] Befehl Pakete (*.deb) erstellen. Zuerst muss mit folgendem Befehl die Umgebung für <code>bitbake</code> geschaffen werden. Wechselt in das  <code>opendreambox</code> Verzeichnis und gebt folgenden Befehl ein.
<syntaxhighlight>
source bitbake.env
</syntaxhighlight>
Öffnet das <code>build</code> Verzeichnis von eurem Dreamboxtyp. Für die DM 7080 HD wäre der Befehl wie folgt.
<syntaxhighlight>
cd build/dm7080
</syntaxhighlight>
Das Erstellen von einem Paket erfolgt mit dem Befehl.
<syntaxhighlight>
bitbake $Paketname
</syntaxhighlight>
Für das Programm [http://sourceforge.net/projects/atftp atftp] ist der Befehl:
<syntaxhighlight>
bitbake atftp
</syntaxhighlight>
Die erstellten Pakete sind nach erfolgreichem Bauen im folgenden Verzeichnis zu finden.
<syntaxhighlight>
/opendreambox/build/dm7080/tmp-xxx/deploy/deb
</syntaxhighlight>

=== Verfügbare Rezepte anzeigen ===
Die verfügbaren Rezepte für das Bauen mittels <code>bitbake</code> können mit folgendem Befehl aufgelistet werden. 
<syntaxhighlight>
bitbake -s
</syntaxhighlight>
Da die Liste relativ lang ist, könnt ihr das Suchergebnis einschränken:
<syntaxhighlight>
bitbake -s | grep $wunschpaket
</syntaxhighlight>
Wird das gewünschte Paket gefunden, kann es wieder mit dem Befehl <code>"bitbake $paketname"</code> erstellt werden. Erscheint das Wunschpaket nicht, muss es mit einem eigenen oder angepassten Rezept erstellt werden. Oder man benutzt den [http://de.wikipedia.org/wiki/Cross-Compiler Cross-Compiler] (<code>cross-compile.env</code> Skript), um den Quellcode einer Anwendung / Bibliothek zu kompilieren.

=== Hilfreiche bitbake Befehle ===
Listet alle Tätigkeiten (Tasks) von einem gewünschten Paketnamen auf.
<syntaxhighlight>
bitbake -c listtasks $paketname
</syntaxhighlight>

Löscht das Arbeitsverzeichnis eines gewünschten Paketes
<syntaxhighlight>
bitbake -c clean $paketname
</syntaxhighlight>

Baut ein manuell, definiertes Rezept.
<syntaxhighlight>
bitbake -b <pfad/zum/dem/recipe.bb>
</syntaxhighlight>

Der folgende Befehl wird zum Debuggen verwendet, wenn Variablen oder Dateien nicht gefunden werden.
<syntaxhighlight>
bitbake -D -D -D
</syntaxhighlight>

== Weblinks ==
* [http://opendreambox.org/ opendreambox.org]
* [http://git.opendreambox.org/?p=opendreambox.git;f=doc/opendreambox.txt;hb=refs/heads/krogoth Dokumentation zu opendreambox]
* [http://git.opendreambox.org/?p=opendreambox.git;a=shortlog;h=refs/heads/krogoth opendreambox git Repository]
* [http://www.openembedded.org/wiki/Main_Page OpenEmbedded]
* [http://docs.openembedded.org/usermanual/usermanual.html Openembedded Anleitung]
* [http://www.multitech.net/developer/products/multiconnect-ocg/development/writing-bitbake-recipes/ Writing BitBake Recipes]
* [https://www.yoctoproject.org/docs/2.1.1/ref-manual/ref-manual.html The Yocto Project Reference Manual (krogoth)]

[[Kategorie:Anleitungen]]
[[Kategorie:Software]]