---
format: markdown
categories: Netz-Infrastruktur, Nodes
title: Firmware
...
# Download
Die momentan aktuellen Versionen sind immer hier zu finden:
Autoupdate-Kanal Für neu gekaufte Router (factory) Upgrade von bestehenden Freifunk-Knoten (sysupgrade)
---------------- ---------------------------------------------------------- -------------------------------------------------------------
**Stabil** (*stable*) <https://images.ffdo.de/ffdo/stable/images/factory/> <https://images.ffdo.de/ffdo/stable/images/sysupgrade/>
Test (*beta*) <https://images.ffdo.de/ffdo/beta/images/factory/> <https://images.ffdo.de/ffdo/beta/images/sysupgrade/>
Experimentell (*experimental*) <https://images.ffdo.de/ffdo/experimental/images/factory/> <https://images.ffdo.de/ffdo/experimental/images/sysupgrade/>
Alle Firmware-Releases, auch archivierte und noch nicht für ein Autoupdate freigegebene Versionen können hier heruntergeladen werden:
<https://images.ffdo.de/ffdo/releases/>
**Falls ihr euch nicht sicher seid, welche Version ihr butzen sollt bitte *immer* die stabilen (stable)-Images nutzen.**
# Versionen
## Historie
FFDO-Release Gluon-Version Aktuelle Kanäle Netz Erstellt am Erstellt von Änderungen
------------ ------------- --------------- ----- ----------- ------------ ----------
0.10.2 2016.2.3 e+b neu 13.02.2017 Markus TP-Link TL-WR940N v4, TP-Link TL-WR1043ND v4
0.10.1 2016.2.2 neu 02.02.2017 Markus TP-Link CPE210/510, TL-WA801N/ND v3, TL-WR841ND v11
0.10.0 2016.2.1 neu 12.11.2016 Markus Gluon v2016.2.1, keine 802.11b-1999 Rates mehr, viele neue Geräte
0.9.2 2016.1.5 s neu 01.06.2016 Markus Gluon v2016.1.5, kein Alfred mehr, Support für 841 V11, x86 und x86-64 Images
0.9.1 2016.1.3 neu 15.04.2016 Markus Ad-Hoc anstatt 802.11s, Gluon v2016.1.3
0.9.0 2016.1.2 neu 20.03.2016 Markus Umstellung auf neue Supernodes und 802.11s statt Ad-Hoc
0.8.2 2016.1.3 alt 16.04.2016 Markus Gluon 2016.1.3 mit Fix für Flash-Bug in 2016.1.2
0.8.1 2016.1.2 alt 20.03.2016 Markus Update auf Gluon 2016.1.2
0.8.0 2016.1 alt 27.02.2016 Markus Ein Tunnel pro Node, Autoupdate-Keys von FFDO statt FFRL
0.7.2 2015.1.2 alt Update auf FFRUHR-FFDO Subdomäne
0.6.1 ffrg
## Autoupdate
Es gibt drei mögliche Update-Kanäle (*Branches*), aus denen ein Knoten Firmware-Upates automatisch beziehen kann. Eine neu erstellte Firmware durchläuft immer erst die Branches *experimental* und *beta* bevor das Update als *stable* fúr alle Knoten freigegeben wird.
Der zu nutzende Kanal kann im Konfigurationsmodus der Knoten ausgewählt werden. **Als Standard bei neu installierten Knoten ist immer ein Autoupdate über den *stable*-Kanal eingestellt, egal ob die Firmware aus einem anderen Kanal bezogen wurde.** Falls die Einstellung geändert wird bleibt die Änderung aber auch nach einem Update erhalten.
### Stable
Bei allen Knoten, an die man nicht problemlos ran kommt und die nicht direkt von Menschen aus der FFDO-Community betrieben werden sollte der Autoupdater i.d.r. immer aktiv sein und auf *stable* gestellt sein. Es werden nur ausgiebig getestete Updates verteilt.
### Beta
Knoten, auf ihr im Notfall physikalischen Zugriff habt können problemlos auf *beta* betrieben werden. Die Updates werden in den Beta-Branch gelegt wenn sie nach der Verteilung über *experimental* keine offensichtlichen Fehler mehr enthalten, aber noch ausgiebig getestet werden müssen bevor sie für alle Knoten freigegeben werden können.
**Es ist wichtig, viele unterschiedliche Router-Modell im Beta-Test zu haben, da vorher nur einige wenige Modelle getestet werden können.**
### Experimental
Neue Firmware, die für ein Autoupdate vorgesehen ist wird kurz nach der Erstellung in den *experimental*-Branch gelegt. Die Updates sind hier noch nicht ausgiebig getestet, es kann also passieren dass ein Router nicht mehr korrekt funktioniert nach dem Update.
# Entwicklung
## Buildsystem
Unsere Router-Firmware basiert auf dem [Gluon-Projekt](https://gluon.readthedocs.org/). Die FFDO-spezifische Konfiguration und die zur Erstellung der Firmware genutzten Build-Scripte werden auf Github im Repository [site-ffdo](https://github.com/ffdo/site-ffdo) gepflegt. Der Build-Vorgang ist komplett automatisiert und kann auf jedem Host mit [Docker](https://www.docker.com/) ohne großes Vorwissen nachvollzogen werden.
## Image-Server
Alle Releases liegen auf <https://images.ffdo.de/ffdo/>
Die Firmware wird im Verzeichnis "releases" versioniert abgelegt:
/ffdo/releases/x.x.x/images
/ffdo/releases/x.x.x/modules
/ffdo/releases/y.y.y/images
/ffdo/releases/y.y.y/modules
Das in einem Branch aktuell ausgelieferte Release wird durch Softlinks festgelegt:
/ffdo/stable -> /ffdo/releases/0.7.2
/ffdo/beta -> /ffdo/releases/0.8.0
/ffdo/experimental -> /ffdo/releases/0.8.1
## Freigabe von Autoupdates
Damit ein automatisches Update von den Knoten akzeptiert wird muss im Sysupgrade-Verzeichnis ein *Manifest* für das jeweilige Branch liegen (`stable.manifest`, `beta.manifest`, `experimental.manifest`).
Das Manifest enthält SHA512-Checksummen aller Update-Dateien und den Release-Kanal. Das Manifest muss digital unterschrieben sein, damit das Update von den Knoten akzeptiert wird.
Momenten sind folgene Regelungen konfiguriert:
* Stable und Beta benötigen **zwei Unterschriften** zur Freigabe
* Experimental benötigt nur eine Unterschrift.
Schlüssel zum Unterschreiben von Firmware-Releases besitzen Till, Torben, Tim und Markus.