---
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.