Skip to content
Snippets Groups Projects
README.md 2.14 KiB
Newer Older
## Als Entwickler tätig werden

Lorenz Wenner's avatar
Lorenz Wenner committed
Falls dich das Thema der Softwareentwicklung begeistert und du gerne bereit bist dich in komplexe Strukturen einzuarbeiten, sowie gerne einen Beitrag zu Freifunk leisten möchtest kannst du dich unter folgendem Link über einen Einstieg erkundigen:
https://wiki.ffnw.de/Entwicklung/Als\_Entwickler\_t%C3%A4tig\_werden

## Firmware Kompilieren

Lorenz Wenner's avatar
Lorenz Wenner committed
### Voraussetzungen (Stand Gluon v2020.1.x):
Lorenz Wenner's avatar
Lorenz Wenner committed
Folgende Pakete müssen auf dem Rechner installiert sein. Hier Beispiel Debian:
Lorenz Wenner's avatar
Lorenz Wenner committed
    apt-get install git subversion python build-essential gawk unzip libncurses-dev libz-dev libssl-dev wget time

### Gluon kompilieren

Auf dieser Seite wird beschrieben, wie man die Gluon Firmware für das Freifunk Nordwest Netzwerk kompiliert. Um die Firmware zu kompilieren wird ein Rechner mit einem Linux Betriebssystem und ca. 70-100GB freier Speicher benötigt. Der make Befehl passt sich automatisch an die Anzahl von cores an.

*Wichtig* Je nach Entwicklungsstand muss die Branch Version angepasst werden.

Lorenz Wenner's avatar
Lorenz Wenner committed
    git clone https://github.com/freifunk-gluon/gluon.git -b v2020.1.x && cd gluon
    git clone https://git.ffnw.de/ffnw-firmware/siteconf.git site && cd site
Lorenz Wenner's avatar
Lorenz Wenner committed
    ./buildscript.sh patch
    ./buildscript.sh prepare GLUON_BRANCH <autoupdater-branch, also zB "stable" oder "testing">
    ./buildscript.sh prepare GLUON_RELEASE <Releasecodename, zB das aktuelle Datum im Format YYYYMMDD>
    ./buildscript.sh prepare <vpn, zB "fastd" oder "l2tp">
Lorenz Wenner's avatar
Lorenz Wenner committed
    ./buildscript.sh build <target, zB "x86-generic"> fast
Lorenz Wenner's avatar
Lorenz Wenner committed
*Hinweis* Auf Multicoresystemen sorgt die option `fast` dafür, dass alle vefügbaren CPU-Kerne für den Build genutzt werden.

### Manifest und initiale Signatur erstellen

Lorenz Wenner's avatar
Lorenz Wenner committed
    ./buildscript.sh create_manifest manifest
    ./contrib/sign.sh ../firmware/release_keys/ecdsa-privatekey ./output/images/sysupgrade/stable.manifest

Weitere Informationen z.B. zu automatischen Builds auch unter https://gluon.readthedocs.org/en/latest/features/autoupdater.html

### Prüfsummen erstellen

Die Prüfsummen werden auf dem Server automatisiert generiert.

### Referenzen

* https://wiki.openwrt.org/doc/howto/build
* https://buildroot.org/downloads/manual/manual.html