Firmware installieren

= Der wichtigste Hinweis zuerst =
Einen Freifunkrouter stellt man nicht einfach hin und überlässt ihn sich selbst – wie es eigentlich für sämtliche am Internet angeschlossene Geräte gilt, wenn es auch oft genug nicht beachtet wird –, sondern man übernimmt langfristig Verantwortung, v. a. was regelmäßige Updates und Übernahme größerer Änderungen im Netzwerk angeht. Diese werden mit hinreichend großem Vorlauf angekündigt. Wenn diese trotzdem nicht beachtet werden, läuft man Gefahr, dass der Router irgendwann nicht mehr funktioniert oder, wenn er Störungen im Netz produziert, gesperrt wird. Das gilt gerade auch für Freifunkrouter, wo eigene Modifikationen – die wir explizit unterstützen, solange sie das Netz nicht stören und kompatibel zu unseren Netz sind – vorgenommen wurden.
Der Routeraufsteller/Betreiber ist für seinen Router verantwortlich. Dies gilt auch für die Einstellungen wie z. B. Sendeleistung.
Auch sollte man Netzwerkkenntnisse mitbringen. Aber keine Panik: Freifunkrouter sind im Allgemeinen nicht pflegeintensiv.
Durch das Betreiben eines Freifunkrouters stimmt man dem Pico Peering Agreement (PPA) zu.
= Die richtige Hardware auswählen =
Das Portal Hardware enthält eine Liste unserer unterstützten Geräte.
Im Zweifel nimm Kontakt mit der Community auf, hier wird dir weitergeholfen wenn du Probleme hast.
== Die richtige Firmware Variante auswählen ==
Seit dem Release im Dezember 2019 gibt es zwei verschiedene Varianten der Firmware: 
* die Node Firmware, die mit dem zentralen KeyXchange-V2 laufen. (Empfohlen für Anfänger mit dem ersten Freifunk-Router.)
* die neue Layer3-Firmware für ein dezentrales Netz. Mehr unter Layer3Firmware und Layer_3_Firmware. (Aufwändiger, dafür dezentral.)
Der Vorteil der "dezentralen Firmware" wird unter Layer_3_Firmware -> Redundanz beschrieben.
= Firmware-Installation =
== Firmware-Download ==
Die aktuelle Version findet man hier:
* Node: https://dev.freifunk-franken.de/node/
* Layer-3: https://dev.freifunk-franken.de/layer3/
Adrian Schmutzler stellte bis 2020 verschiedene alternative Firmwares auf seiner Seite zur Verfügung: https://freifunk.jubt.org/fff-firmware.php
Mehr Infos zu den Dateinamen der Firmware sind zu finden unter: Anleitungen -> Aufbau_des_Dateinamens_der_Firmware 
=== Checksumme prüfen ===
Für jede Firmware-Datei gibt es eine Datei mit der SHA256-Prüfsumme, um den korrekten Download zu überprüfen. Früher gab es zusätzlich MD5-Prüfsummen.
==== Linux ====
 christiand@christianpc:/tmp/fw$ ls
 fff-layer3-20200118-archer-c25-v1-factory.bin fff-layer3-20200118-archer-c25-v1-factory.bin.sha256
 christiand@christianpc:/tmp/fw$ sha256sum -c fff-layer3-20200118-archer-c25-v1-factory.bin.sha256 
 fff-layer3-20200118-archer-c25-v1-factory.bin: OK
Sollte beim Download was fehlgeschlagen sein (hier wurde zum Test händisch die *.bin manipuliert) kommt es zu folgender Ausgabe, die Firmware sollte dann keinesfalls geflasht werden:
 christiand@christianpc:/tmp/fw$ sha256sum -c fff-layer3-20200118-archer-c25-v1-factory.bin.sha256 
 fff-layer3-20200118-archer-c25-v1-factory.bin: FEHLSCHLAG
 sha256sum: WARNUNG: die 1 berechnete Prüfsumme passte NICHT
==== Windows ====
Unter Windows 10 und 11 kann über PowerShell mit dem Befehl Get-FileHash der Hash erzeugt und dann manuell mit dem Inhalt der .md5- und .sha256-Datei verglichen werden.
PS C:\> Get-FileHash -Path C:\Temp\fff-node-20230330-tplink_c2600-factory.bin -Algorithm MD5
Algorithm Hash Path
--------- ---- ----
MD5 F1D1F031B5EC7982648179D12D9915CB C:\Temp\fff-node-20230330-tplink_c2600-factory.bin
PS C:\> Get-FileHash -Path C:\Temp\fff-node-20230330-tplink_c2600-factory.bin -Algorithm SHA256
Algorithm Hash Path
--------- ---- ----
SHA256 C6B9AEFA786E0BEE4B7CC065AE86DF9C3818E1DB33C3AA9D0F94B212F16B79A3 C:\Temp\fff-node-20230330-tplink_c2600-factory.bin
==== macOS ====
;Öffne das Terminal
;um einen MD5 Hash zu generieren gebe
: md5 und den Dateipfad ein. (Einfach der Drag & Drop aus dem Finder)
;um einen SHA256 Hash zu generieren gebe
: shasum -a 256 und den Dateipfad ein. (Einfach der Drag & Drop aus dem Finder)
== Firmware-Installation ==
Die Installation ist je nach Modell sehr unterschiedlich, hier eine Liste diverser Modelle:
* ER-X / ER-X-SFP / EP-R6
* Xiaomi Mi Router 4A
* Fritzbox 4040
* Edgerouter 4
* Ubiquiti (diverse Geräte)
* GL AR150
* Ubiquiti AC Mesh
* TP-Link WR841 und WR1043 (gilt für viele TP-Link Geräte)
* x86 PC und VM
Die Liste ist nicht abschließend und darf gerne erweitert werden. Allgemein ist es sehr hilfreich im OpenWrt-Wiki zu gucken, dort wird eigentlich für jedes Gerät eine Installationsanleitung angeboten. Da unsere Firmware auf OpenWrt basiert, ist ein Flashen nach dieser Anleitung immer möglich, erst ab der Einrichtung/Konfiguration unterscheidet sich die Freifunk Franken Firmware deutlich von OpenWrt.
== Firmware-Konfiguration ==
=== Node Firmware ===
* Node Firmware
=== Layer-3 ===
Dies ist aktuell hier beschrieben:
* Ablauf einer Installation
* Schritt für Schritt Anleitung
Zur Konfiguration gibt es hier eine Hilfe:
* Layer-3 Firmware Konfiguration
== Probleme bei der Installation ==
Melde dich auf unserer Mailingliste! Die Infos dazu gibt es unter Kommunikation. Dort gibt es auch Hilfe und Support bei der Installation.
== Nach der Installation ==
Lerne das Freifunknetz kennen. Beschäftige dich mit dem Netz und verbessere dein Setup laufend. Versuche dich mit Nachbarn zu verbinden, baue dazu Richtfunkstrecken auf oder wirf einfach ein Kabel über den Gartenzaun zum Nachbarn
= Firmware-Update =
Bitte haltet eure Router immer auf den aktuellsten Stand. Ein altes System kann Probleme verursachen und enthält u.U. Sicherheitslücken. Allgemein sollten alle Geräte die an das Internet angeschlossen sind (dazu zählen natürlich auch Freifunk Router) immer mit der aktuellsten Software betrieben werden.
* Anleitung:FirmwareUpdate
* Gefahren beim Update von V1 auf V2
Freifunk Franken hat keinen Autoupdater. Wir erwarten von jeden Freifunker der Freifunkrouter betreibt, dass er sich selbst um seine Router kümmert. Du bist für deine Router selbst verantwortlich.
= Firmware selbst entwickeln =
Eine Anleitung, wie die aktuelle Firmware gebaut wird oder an der Entwicklung teilgenommen werden kann, gibt es auf der Seite FirmwareEntwicklung.