Inhaltsverzeichnis

Zielgruppe

Interessierte, die die Freifunk Images selbst kompilieren wollen. Fertige Images von Freifunk stuttgart sind hier zu finden: http://firmware.freifunk-stuttgart.de

Unsere Firmware kann ab Version 1.6 ueber eine Continious Integration unter https://gitlab.freifunk-stuttgart.de/firmware/site-ffs gebaut werden. Alternativ ist es natuerlich auch immer noch moeglich, auf der lokalen Maschine zu bauen, dazu findet ihr hier die Anleitung.

Voraussetzungen

Bevor die Firmware für Freifunk Stuttgart kompiliert werden kann, müssen folgende Voraussetzungen erfüllt sein. Es müssen die genannten Pakete auf dem verwendeten System installiert sein und die Build-Umgebung eingerichtet werden.

Firmware bauen

Benötigte Pakete

Um die Firmware kompilieren zu können, müssen folgende Pakete auf dem System vorhanden sein:

siehe auch https://gluon.readthedocs.io/en/v2018.2.x/user/getting_started.html#dependencies

Bauen

  1. site-ffs mit Submodules klonen: git clone --recurse https://gitlab.freifunk-stuttgart.de/firmware/site-ffs.git
  2. das Build-Skript buildall.sh aufrufen

Firmware-Image manuell flashen

Prinzipiell ist so vorzugehen, wie auf der Seite router_flashen beschrieben.

Firmware-Image für Autoupdate vorbereiten

Damit die Firmware an alle Stuttgart-Knoten verteilt wird, muss die Firmware noch signiert werden. Die folgenden Schritte sind nicht notwendig wenn die Images nur selbst manuell auf die Router gespielt werden. Für das signieren muss zuerst eine Manifest-Datei erzeugt werden, welche die Signaturen enthalten wird.

Benötigte Pakete

pkg-config (wird für ECDSA-Utils benötigt) cmake (wird für ECDSA-Utils benötigt)

sudo apt get install pkg-config cmake

ECDSA-Utils

Wichtig hierzu ist, dass auf dem System die ECDSA-Utils vorhanden sind. So werden diese installiert:

cd
 git clone http://git.universe-factory.net/libuecc
 cd libuecc
 cmake ./
 make
 sudo make install
 sudo ldconfig
 cd
 git clone https://github.com/tcatm/ecdsautils.git
 cd ecdsautils
 mkdir build
 cd build/
 cmake ../
 make
 sudo make install 
Eventuelle Probleme

Falls eine Shared Library libuecc.so.0 nicht gefunden werden kann, könnte es sein, dass die Umgebungsvariable LD_LIBRARY_PATH noch nicht vorhanden ist. Diese kann so gesetzt werden:

LD_LIBRARY_PATH=/usr/local/lib
export LD_LIBRARY_PATH

Privaten und öffentlichen Schlüssel zum Signieren erzeugen

Privaten Schlüssel in Datei 'key.secret' erzeugen:

 ecdsautil generate-key > key.secret 

Öffentlichen Schlüssel aus privatem erzeugen:

cat key.secret | ecdsautil show-key > key.public

Der Schlüssel sollte nur für den eigenen Benutzer lesbar sein:

chmod 600 key.secret

Firmware signieren

Die Manifestdateien wurden durch das oben aufgeführte Build Skript bereits erzeugt.

Nun muss für die gewünschte GLUON_BRANCH noch das Signieren vorgenommen werden:

cd gluon
contrib/sign.sh $SECRETKEY output/images/sysupgrade/stable.manifest
contrib/sign.sh $SECRETKEY output/images/sysupgrade/beta.manifest
contrib/sign.sh $SECRETKEY output/images/sysupgrade/nightly.manifest

Quellen: