Buildsystem:bbs

bbs

bbs ist der Nachfolger von bs4cs, welches wiederum ein Spin-Off des Buildsystems von Seife speziell für Coolsteam Set-Top-Boxen war.
Mit der Unterstützung der HD51 Set-Top-Box Platform war der Name bs4cs (buildsystem for coolstream) nicht mehr korrekt und wurde in bbs (bellum's buildsystem) geändert.

Grundlegende Änderungen an der Benutzung oder der Features wurden nicht vorgenommen.

Das Buildsystem erstellt eigentlich .opkg-Pakete, es ist damit aber auch die Erstellung von Neutrino Update .bin-Dateien und kompletten Flash-Images möglich.

ACHTUNG:

Entstanden ist bbs anfänglich auf einer Debian Stretch Linux-Distribution.

Getestet auf Debian Stretch, Buster, Kubuntu 19.10.

Andere Linux-Distributionen können, sie müssen aber nicht funktionieren!

Am besten erstellt man sich dafür eine eigene virtuelle Maschine und verwendet Debian Strech.

Vorbereitung

Folgende Pakete werden bei Debian Stretch zusätzlich zum minimalen Grundsystem (also ohne X-Desktop, etc.) benötigt:

• git (installiert automatisch gettext-base und patch)
• subversion
• make
• automake (installiert automatisch autoconf)
• cmake
• gcc
• g++
• bc
• bzip2
• gawk
• texinfo
• libtool-bin
• bison
• flex
• help2man
• pkg-config
• gperf
• lzma
• libarchive-dev
• libncurses5-dev
• libglib2.0-dev (installiert automatisch python und zlib1g-dev)
• liblzo2-dev
• ncftp
• mtd-utils
• dosfstools

Für Debian Systeme:

sudo apt-get -y install git subversion make automake cmake gcc g++ bc bzip2 gawk texinfo libtool-bin bison  flex help2man pkg-config gperf lzma libarchive-dev libncurses5-dev libglib2.0-dev liblzo2-dev ncftp mtd-utils dosfstools

Für andere Systeme sollte das gleiche gelten, allerdings wird es teilweise Unterschiede bei den Paketnamen geben und der für die jeweilige Distribution zuständige Installer muss natürlich verwendet werden (z.B. OpenSuse: zypper usw.).

Um visualisiert am Code arbeiten zu können, empfiehlt es sich zusätzlich die grafische Untertützung von Git (z.B. gitk, git gui) und eine IDE (z.B. Kdevelop, EMacs usw.) zu installieren.

Nun kann (als normaler Benutzer) das Buildsystem heruntergeladen werden.
bbs ist Hardware abhängig, daher muss es für die unterschiedlichen Plattformen in ein separates Verzeichnis geclont werden, z.B.:

git clone https://git.code.sf.net/p/bstuff/bbs bbs-nevis

oder

git clone https://git.code.sf.net/p/bstuff/bbs bbs-apollo

oder

git clone https://git.code.sf.net/p/bstuff/bbs bbs-kronos

oder

git clone https://git.code.sf.net/p/bstuff/bbs bbs-hd51

Anmerkung: Zur Vereinfachung wird im weiteren nur noch vom Verzeichnis 'bbs' gesprochen.
Dies bezieht sich dann auf das jeweilige Plattform-Verzeichnis, also 'bbs-nevis', 'bbs-apollo', 'bbs-kronos' oder 'bbs-hd51'.

Im verzeichnis 'bbs' sollte ein

make toolcheck

folgendes ausspucken:

All required tools seem to be installed.

Falls dies der Fall ist, sind einmalig die folgenden make Make-Targets auszuführen:

make dfolder

Anmerkung: Das Make-Target make dfolder erstellt hierbei ein Verzeichnis 'download' im Verzeichnis 'bbs'
Hat man im Überverzeichnis bereits ein (gemeinsamen) Ordner 'download' kann auf diesen verlinkt werden mit:

make dlink

Zum Abschluss der Vorbereitung muss nun noch folgendes Make-Target ausgeführt werden:

make preqs

Konfiguration und Benutzung

bbs wird über eine Config-Datei im Hauptverzeichnis des Buildsystems konfiguriert.
Am besten kopiert man aus dem Verzeichnis 'doc' die Datei 'config.example' ins bbs-Hauptverzeichnis und benennt diese in 'config' um.

Folgende Variablen sollten mindestens an die jeweiligen Gegebenheiten angepasst werden:

• MAINTAINER = (Nick)-Name

• BOXMODEL = hd51, tank, trinity, zee2, zee oder neo

• STB_IP = IP-Adresse der Set-Top-Box

Nun kann die cross toolchain gebaut werden mit:

make crosstool

Danach noch die restlichen Vorbereitungen durchführen mit:

make bootstrap

Als nächstes muss der entsprechende Kernel gebaut werden.

Für die HD51 STB kann dies direkt mit:

make kernel

durchgeführt werden.

Für alle Coolstream STBs müssen zunächst die Kernel-Sourcen lokal geclont werden, der Kernel kompiliert und in ein Kernel-Image umgewandelt werden.
Folgende Kommandos sind hierzu erforderlich:

make kernel-git
make kernel
make kernel-image

Jetzt können alle weiteren notwendigen Pakete (incl. Neutrino) gebaut werden mit:

make system-pkgs

Flash-Images

Ein Flash-Image wird erzeugt mit:

make flashimage

Danach kann das Flash-Image mit:

make flashimage-ftp

auf die STB übertragen und mit der Neutrino-Update Funktion unter 'Menü Service -> Software-Aktualisierung -> Lokales Update' geflasht werden.

Updates

Quellcode

Das Buildsystem bbs selbst kann mit:

make update-self

aktualisiert werden.

Gibt es Änderungen am Neutrino-Quellcode, so kann das lokale Neutrino-Repository mit:

make update-neutrino

auf den neuesten Stand gebracht werden.

Gibt es Änderungen in den anderen verwendeten Repositories, so werden diese mit:

make update-git

aktualisiert.

(Nur) Für alle Coolstream STBs müssen danach zusätzlich noch die aktualisierten Komponenten mit:

make update-git-target

in das Buildsystem eingespielt werden.

Neutrino Updates

opkg-Pakete

Nachdem der Quellcode aktualisiert wurde kann, ein neues Neutrino opkg-Paket mit:

make neutrino-pkg

erstellt werden.

Flash-Image

Um ein neues Flash-Image mit einem aktualisierten Neutrino opkg-Paket zu erzeugen, muss nach:

make neutrino-pkg

erneut ein:

make flashimage

ausgeführt werden.

Das dadurch erzeugte neue Flash-Image kann nun wieder mit:

make flashimage-ftp

auf die STB übertragen und mit der Neutrino-Update Funktion unter 'Menü Service -> Software-Aktualisierung -> Lokales Update' geflasht werden.

Sonstiges

"Clean-Targets"

Will man Neutrino doch einmal komplett neu von vorne bauen, genügt ein:

make neutrino-bin-clean

Hilfe

Eine Liste nützlicher make-Targets (Befehle) erhält man mit:

make help

Support bzgl. Fragen, Probleme, Anregungen, etc. gibt es im Tuxbox-Board.

bbs Source-Code

bbs erreicht man per Web-Frontend über https://sourceforge.net/p/bstuff/bbs/ci/master/tree/ -> 'History'

Have fun!
bellum