Firmware installieren: Unterschied zwischen den Versionen

Aus Freifunk Franken
Wechseln zu:Navigation, Suche
(→‎Firmware Installation: aktuelle Version aktualisiert)
(32 dazwischenliegende Versionen von 7 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
<div style="margin-bottom:1em; padding:1em 1em 0.5em 1em; background-color:#ffFF00;">
= Der wichtigste Hinweis zuerst =
<b>Für ältere Versionen (vor 20160213-beta) [https://wiki.freifunk-franken.de/mediawiki/index.php?title=Anleitungen&oldid=5828 hier] gucken.</b>
 
<div style="margin-bottom:1em; padding:1em 1em 0.5em 1em; border:2px solid #dc0067;color:#000;">
Einen Freifunk-Router 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 Freifunk-Router, 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 zumindest grundlegendes Interesse an der Technik mitbringen. Aber keine Panik: Freifunk-Router sind im Allgemeinen sehr pflegeleicht.
 
Durch das Betreiben eines Freifunkrouters stimmt man dem [https://wiki.freifunk-franken.de/w/PicoPeeringAgreement PicoPeeringAgreement] zu.
</div>
</div>


= Firmware Installation =
= Firmware-Installation =
Diese Anleitung ist ab der Firmware Version 20160213-beta gültig!
Aktuell ist die Version 20181202: https://dev.freifunk-franken.de/firmware/current/


Aktuell ist die Version 20180802: https://dev.freifunk-franken.de/firmware/current/
Adrian Schmutzler stellt verschiedene alternative Firmwares auf seiner Seite zur Verfügung: https://freifunk.jubt.org/fff-firmware.php


Eine Anleitung, wie die aktuelle Firmware gebaut wird oder an der Entwicklung teilgenommen werden kann, gibt es [[FirmwareEntwicklung|hier]].
Fabian Bläse stellt alternative dezentrale Gateway Firmwares auf seiner Seite zur Verfügung: https://fw.sgstbr.de/gateway/


== Installationsanleitung für Erstinstallation ==


== Der wichtigste Hinweis zuerst ==
Eine Anleitung, wie die aktuelle Firmware gebaut wird oder an der Entwicklung teilgenommen werden kann, gibt es [[FirmwareEntwicklung|hier]].
 
<div style="margin-bottom:1em; padding:1em 1em 0.5em 1em; border:2px solid #dc0067;color:#000;">
Einen Freifunk-Router 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 Freifunk-Router, 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 zumindest grundlegendes Interesse an der Technik mitbringen. Aber keine Panik: Freifunk-Router sind im Allgemeinen sehr pflegeleicht.


Das [https://wiki.freifunk-franken.de/w/PicoPeeringAgreement PicoPeeringAgreement] solltest du auch schon mal gelesen haben.
== Installationsanleitung für Erstinstallation ==
</div>


[[Datei:dein_router.jpg|400px|thumb|Lieferinhalt (WR841ND)]]
[[Datei:dein_router.jpg|400px|thumb|Lieferinhalt (WR841ND)]]


für die Modelle TP-Link WR841N(D) und TP-Link WR1043N(D)
am Beispiel TP-Link WR841N(D) und TP-Link WR1043N(D)


'''Bitte beachte die Reihenfolge'''
'''Bitte beachte die Reihenfolge'''


# Melde dich für Informationen, Hilfe und Kontakt zur Community bei unserer [[Mailinglisten#franken-freifunk|Mailingliste]] an.
# Router flashen (= Firmware installieren).
# Router flashen (= Firmware installieren).
# Router im Webinterface konfigurieren.
# Router konfigurieren.
# (optional, jedoch empfohlen) Trage dich für Informationen in unsere Mailingliste ein.  


=== Auspacken ===
=== Auspacken ===
Zeile 46: Zeile 47:
* Hier eine [[Portal:Hardware|Liste der Routertypen]], welche für die Freifunk-Franken-Firmware geeignet sind.
* Hier eine [[Portal:Hardware|Liste der Routertypen]], welche für die Freifunk-Franken-Firmware geeignet sind.
* Herauszufinden, welche Firmware man braucht, ist ganz einfach: der Routertyp (1) und die Hardwareversion (2) stehen auf der Unterseite des Routers. Dabei unbedingt den richtigen Typ und die '''richtige Hardware-Version''' wählen!
* Herauszufinden, welche Firmware man braucht, ist ganz einfach: der Routertyp (1) und die Hardwareversion (2) stehen auf der Unterseite des Routers. Dabei unbedingt den richtigen Typ und die '''richtige Hardware-Version''' wählen!
* Die [https://dev.freifunk-franken.de/firmware/current/ passende aktuelle Firmware] herunterladen. Wenn der Dateiname länger als 63 Zeichen ist, muss der Name auf max. 63 Zeichen gekürzt werden, sonst weigert sich der Router.
* Die [https://dev.freifunk-franken.de/firmware/current/ passende aktuelle Firmware] herunterladen.  
** Die '''Factory'''-Version ist zu verwenden, wenn vorher noch keine Freifunk-Firmware installiert war.
<b>Ggf. muss der Dateiname gekürzt werden!</b> Manche Router verweigern das Flashen der Firmware aus der Herstellersoftware, wenn der Dateiname zu lang ist.  
** Die '''Sysupgrade'''-Version braucht man nur, wenn bereits eine Freifunk-Firmware installiert war.
Dafür einfach den Namen der Datei anpassen und nur 8 Zeichen stehen lassen.
** Die '''Factory'''-Version ist zu verwenden, wenn von der Herstellersoftware geflasht wird.
** Die '''Sysupgrade'''-Version braucht man, wenn von einem bereits installierten OpenWRT (bzw. Freifunk-Firwmare) geflasht wird.


[[Datei:gelbe_buchse.jpg|400px|thumb|gelbe Buchse]]
[[Datei:gelbe_buchse.jpg|400px|thumb|gelbe Buchse]]
* Den LAN-Anschluss am Computer z.B. mit dem beiliegenden Patchkabel mit einem der <span style="background-color:yellow">gelben LAN-Anschüsse</span> des neuen Routers verbinden, am besten Buchse '''3''' oder '''4'''.
* Den Computer mit einem LAN-Kabel mit einem der <span style="background-color:yellow">gelben LAN-Anschüsse</span> des neuen Routers verbinden. <b>Darauf achten, dass einer der beiden vom blauen Port am weitesten entfernten Ports verwendet wird.</b>
* Den Router an Strom anschließen und einschalten.
* Den Router an Strom anschließen und einschalten.
* Warten, bis der eigene Computer eine gültige IP-Adresse bekommen hat. (Falls dies nicht klappt, den Rechner neu starten und prüfen, ob die IP-Adresse automatisch vom Router bezogen wurde.)
* Warten, bis der eigene Computer eine gültige IP-Adresse bekommen hat. (Falls dies nicht klappt, den Rechner neu starten und prüfen, ob die IP-Adresse automatisch vom Router bezogen wurde.)
Zeile 57: Zeile 60:


[[Datei:TP_link_firmware.jpg|400px|thumb|Firmware-Update]]
[[Datei:TP_link_firmware.jpg|400px|thumb|Firmware-Update]]
* Unter dem Menüpunkt "System Tools" –> "Firmware Upgrade" die vorher heruntergeladene Firmware zum Gerät schicken. '''Achtung!''' Falls der Dateiname mehr als 63 Zeichen hat, muss er vorher entsprechend gekürzt werden!
* Unter dem Menüpunkt "System Tools" –> "Firmware Upgrade" die vorher heruntergeladene Firmware zum Gerät schicken. '''Achtung!''' Unter Umständen muss der Dateiname gekürzt werden, wenn die Software das Flashen verweigert.
* Geduldig warten, bis der Router neu startet (max. 4 Minuten) '''Während die Installation läuft, darf der Stecker und das Netzwerk-Kabel nicht abgezogen werden.'''
* Geduldig warten, bis der Router neu startet (max. 4 Minuten) '''Während die Installation läuft, darf der Stecker und das Netzwerk-Kabel nicht abgezogen werden.'''
* Jetzt muss man sich neu mit dem Router verbinden, entweder wieder per LAN (Buchse '''3''' oder '''4''') oder mit dem WLAN ''franken.freifunk.de'' verbinden. Der WAN Anschluss muss dazu nicht zwingend mit dem Internet verbunden sein.
* Jetzt muss man sich neu mit dem Router verbinden. Dafür müssen die beiden am weitesten vom blauen Anschluss entfernten Ports verwendet werden! Der WAN Anschluss (blau) sollte dabei noch nicht mit dem Internet verbunden sein, damit man zuerst ein Passwort setzen kann!
* Auf diese Seite gehen: [https://[fdff::1] https://[fdff::1]] und die Sicherheitswarnung ignorieren: "Diese Verbindung ist nicht sicher" SEC_ERROR_UNKNOWN_ISSUER
* Über die Adresse [https://[fdff::1] https://[fdff::1]] auf den frisch geflashten Freifunkrouter gehen und die Sicherheitswarnung ignorieren: "Diese Verbindung ist nicht sicher" SEC_ERROR_UNKNOWN_ISSUER
** '''Achtung:''' Sicherheitswarnungen dürfen nur ignoriert werden, wenn man genau weiß, was man tut. In diesem Fall hat der Router kein von einer CA signiertes Zertifikat für die Adresse, daher wird ein selbstsigniertes Zertifikat verwendet.
* Falls die Seite nicht aufgerufen werden kann, gibt es [[Anleitungen#Zugriff_auf_das_Webinterface_zum_Konfigurieren_des_Routers|noch mehr Möglichkeiten]].
* Falls die Seite nicht aufgerufen werden kann, gibt es [[Anleitungen#Zugriff_auf_das_Webinterface_zum_Konfigurieren_des_Routers|noch mehr Möglichkeiten]].
* Es kommt das Login der Weboberfläche. Benutzer: '''root''' Passwort: '''ffol'''
* Es kommt das Login der Weboberfläche. Benutzer: '''root''' Passwort: '''ffol'''
Zeile 73: Zeile 77:


Folge der [[Anleitung_ab_20160213-beta#Zugriff_auf_das_Webinterface_zum_Konfigurieren_des_Routers|Anleitung für Zugriff auf das Webinterface]]. (Vor der Firmware Version 20160213-beta wurde Netmon zum konfigurieren benötigt, dies ist seither nicht mehr erforderlich).
Folge der [[Anleitung_ab_20160213-beta#Zugriff_auf_das_Webinterface_zum_Konfigurieren_des_Routers|Anleitung für Zugriff auf das Webinterface]]. (Vor der Firmware Version 20160213-beta wurde Netmon zum konfigurieren benötigt, dies ist seither nicht mehr erforderlich).


<div style="margin-bottom:1em; padding:1em 1em 0.5em 1em; border:2px solid #dc0067;color:#000;">
<div style="margin-bottom:1em; padding:1em 1em 0.5em 1em; border:2px solid #dc0067;color:#000;">
Zeile 84: Zeile 87:
Wer seinen Standort nicht bekannt geben möchte, möge ihn im Webinterface in der gleichen Hood, in welche der Router seinen tatsächlichen Standort hat, an einem beliebigen anderen Ort platzieren.
Wer seinen Standort nicht bekannt geben möchte, möge ihn im Webinterface in der gleichen Hood, in welche der Router seinen tatsächlichen Standort hat, an einem beliebigen anderen Ort platzieren.


Die Aufteilung der Hoods kann man in der [https://monitoring.freifunk-franken.de/map Monitoring-Map] sehen, indem man im Overlay (rechte obere Ecke) die Checkbox "Hoods" aktiviert.  
Die Aufteilung der Hoods kann man in der [https://monitoring.freifunk-franken.de/map Monitoring-Map] sehen, indem man im Overlay (rechte obere Ecke) die Checkbox "Hoods" aktiviert.
 
Gut geeignete Fake-Standorte sind die, die sofort als solche erkannt werden können, z.B.:
* für die Fürther Hood: Mitten im Stadtparkweiher, auf der Pegnitz oder auf der Rednitz
* für die Nürnberger Hood: Mitten auf dem Wöhrder See
* für die Erlanger Hood: Im Schlossgarten oder auf dem Rathausplatz
* für die Würzburger Hood: Im Main oder im Ringpark
* ganz allgemein: Flüsse, Seen, Flughafenrollbahnen, auf der Autobahnmitte, mitten auf dem Fußballplatz


Die richtige Angabe des tatsächlichen Standorts erachten wir selbstverständlich für vorteilhafter, u.a. weil dies das Finden von Mesh-Partnern erleichtert. Wer keinen Standort angeben möchte, möge sich einen beliebigen innerhalb derselben Hood aussuchen.
Die richtige Angabe des tatsächlichen Standorts erachten wir selbstverständlich für vorteilhafter, u.a. weil dies das Finden von Mesh-Partnern erleichtert. Wer keinen Standort angeben möchte, möge sich einen beliebigen innerhalb derselben Hood aussuchen.
Zeile 101: Zeile 97:
Hat sich der Router schon mit einen Nachbarrouter vermesht, ist er direkt in Betrieb und vergrößert von nun an das Freifunknetz.
Hat sich der Router schon mit einen Nachbarrouter vermesht, ist er direkt in Betrieb und vergrößert von nun an das Freifunknetz.


==== VPN Verbindung ====
==== VPN-Verbindung ====
Ist kein weiterer Freifunkrouter in Reichweite, kann der Router auch über den blauen WAN Port mit dem Internet verbunden werden. Es wird dann eine VPN Verbindung über das Internet zu unseren Gatewayservern aufgebaut, und der Router ist nach einiger Zeit (5-30 Minuten) per VPN mit dem Freifunknetz verbunden.
Ist kein weiterer Freifunkrouter in Reichweite, kann der Router auch über den blauen WAN Port mit dem Internet verbunden werden. Es wird dann eine VPN Verbindung über das Internet zu unseren Gatewayservern aufgebaut, und der Router ist nach einiger Zeit (5-30 Minuten) per VPN mit dem Freifunknetz verbunden.


Es sollte pro Internetuplink nur ein Router eine VPN Verbindung aufbauen. Werden an einen Standort mit einen Internetuplink mehrer Router betrieben, so sollten alle weiteren Router per Batman miteinander verbunden werden. Der stärkste Router sollte an den Internetuplink angebunden werden.
Es sollte pro Internetuplink nur ein Router eine VPN Verbindung aufbauen. Werden an einen Standort mit einen Internetuplink mehrer Router betrieben, so sollten alle weiteren Router per [[B.A.T.M.A.N.]] miteinander verbunden werden. Der stärkste Router sollte an den Internetuplink angebunden werden.


==== Batman Ports ====
==== B.A.T.M.A.N.-Ports ====


Die Batmanports dürfen auch an einen Switch sternförmig zusammen geschlossen werden. Es sollte allerdings vermieden werden, an einen Switch ein normales Netzwerk und Batman gleichzeitig zu betreiben, da dies zu unvorhersehbaren Ereignissen führen kann. Sollte dennoch gewünscht werden, über ein Kabel oder an einen Switch mehrere Netzwerke mit Batman zu verwenden, so sollten die Netze in getrennte VLANs geführt werden. Eine Grundlegende Anleitung zu VLANs ist hier zu finden [[https://wiki.freifunk-franken.de/w/Batman_Funkbr%C3%BCcke]], allerdings in einem anderen Zusammenhang.
Die [[B.A.T.M.A.N.]]-Ports dürfen auch an einen Switch sternförmig zusammen geschlossen werden. Es sollte allerdings vermieden werden, an einen Switch ein normales Netzwerk und B.A.T.M.A.N. gleichzeitig zu betreiben, da dies zu unvorhersehbaren Ereignissen führen kann. Sollte dennoch gewünscht werden, über ein Kabel oder an einen Switch mehrere Netzwerke mit B.A.T.M.A.N. zu verwenden, so sollten die Netze in getrennte VLANs geführt werden. Eine Grundlegende Anleitung zu VLANs ist [[Batman_Funkbr%C3%BCcke|hier]] zu finden, allerdings in einem anderen Zusammenhang.


Natürlich verbinden sich die Router auch per Funk miteinander, wo immer es möglich ist sollte aber aus Geschwindigkeitsgründen ein Kabel verwendet werden. Für weitere Strecken sollten 5GHz Richtfunkverbindungen verwendet werden, Infos dazu hier: [[https://wiki.freifunk-franken.de/w/Batman_Funkbr%C3%BCcke]]
Natürlich verbinden sich die Router auch per Funk miteinander, wo immer es möglich ist sollte aber aus Geschwindigkeitsgründen ein Kabel verwendet werden. Für weitere Strecken sollten 5GHz Richtfunkverbindungen verwendet werden, Infos dazu [[Batman_Funkbr%C3%BCcke|hier]].


== Firmware-Update ==
== Firmware-Update ==


* [[Anleitung:FirmwareUpdate]]
* [[Anleitung:FirmwareUpdate]]
* [[KeyXchangeV2#Gefahren_eines_Updates_vom_alten_System|Gefahren beim Update von V1 auf V2]]


== Versionierung ==
== Versionierung ==
Zeile 125: Zeile 122:


=== Schema ===
=== Schema ===
Die Versionsnummer orientiert sich grundsätzlich am Datum des letzten Commits. Auf diesen Commit wird dann entsprechend das Git-Tag gesetzt.
Die Versionsnummer orientiert sich grundsätzlich am Commit-Datum des letzten Commits. Auf diesen Commit wird dann entsprechend das Git-Tag gesetzt.
Daraus ergibt sich folgendes Schema:
Daraus ergibt sich folgendes Schema:


Zeile 161: Zeile 158:
== Siehe auch ==
== Siehe auch ==
[http://wiki.freifunk.net/Kommandos Kommandoliste auf den Freifunk-Routern]
[http://wiki.freifunk.net/Kommandos Kommandoliste auf den Freifunk-Routern]
= Auf dem Router läuft DD-WRT =
Mitunter bekommt man einen gebrauchten Router, auf dem nicht die Original-Firmware, sondern DD-WRT läuft. Dann ist ein Flashen der Freifunk-Firmware via Webinterface nicht möglich, da DD-WRT nur DD-WRT-Firmware flasht.
Mit folgendem Vorgehen habe ich mehrere TP-Link TL-1043ND mit DD-WRT darauf geflasht (von Linux aus):
Zunächst muss Telnet aktiviert werden. Hierzu per Webinterface anmelden, und unter „Administration“ den Telnet-Zugriff aktivieren.
Dann wird die Firmware auf den Router kopiert. Es wird die „sysupgrade“-Variante benötigt, in meinem Fall „fff-20181202-ar71xx-g-tl-wr1043nd-v1-squashfs-sysupgrade.bin“.
Die einfachste Variante, die Firmware auf den Router zu bekommen, ist, sie von da aus per wget von einem Webserver abzuholen. Entweder verwendet man einen richtigen HTTP-Server, oder behilft sich – wie im folgenden beschrieben – mit dem Mini-Webserver, den Python mitbringt:
Der Einfachheit halber macht man zunächst eine Kopie mit einem griffigeren Namen:
:<code>cp fff-20181202-ar71xx-g-tl-wr1043nd-v1-squashfs-sysupgrade.bin firmware.bin</code>
Dann startet man im selben Verzeichnis den Mini-Python-Webserver:
:<code>python -m http.server</code>
Der Server lauscht auf 0.0.0.0 (also allen verfügbaren Netzwerkinterfaces) auf dem Port 8000. Wenn man in einem Webbrowser die Adresse [http://127.0.0.1:8000/ 127.0.0.1:8000] öffnet, sieht man ein Directory Listing (incl. der Datei „firmware.bin“).
Dann auf dem Router einoggen (der Router hatte hier die IP-Adresse 192.168.11.1):
:<code>telnet 192.168.11.1</code>
Dann die Firmware nach /tmp kopieren (der Client hatte hier die IP-Adresse 192.168.11.147):
:<code>cd /tmp<br/>wget http://192.168.11.147:8000/firmware.bin</code>
und schließlich die Firmware flashen mit
:<code>mtd -r write /tmp/firmware.bin linux</code>
Der Router startet neu und begrüßt einen dann mit der Freifunk-Firmware.
= FF-Router mit Original-Firmware flashen =
Manchmal will man einen FF-Router wieder mit der Original-FW des Herstellers flashen. Hier folgen die Anleitungen:
== TP-Link WR 841 ==
Erfolgreich durchgeführt wurde folgendes Vorgehen für die Version 11 des Routers. bei anderen funktioniert es vermutlich genauso, bitte ergänzen!
Zunächst braucht man die Original-Firmware, erhältlich von der [https://www.tp-link.com/de/support/download/ Hersteller-Seite]. In meinem Fall war es ein Zip-Archiv, das zunächst noch entpackt werden musste und neben der Firmware noch die GPL und eine Anleitung enthielt.
'''So geht man unter Linux vor:'''
Wenn das Firmware-Image „boot“ enthält, muss zunächst der Boot-Part entfernt werden. Das geht sehr einfach mittels ''dd''. In meinem Fall hieß die Firmware-Datei ''wr841ndv11_en_3_16_9_up_boot(150616).bin''.
:<code> dd if=wr841ndv11_en_3_16_9_up_boot(150616).bin of=tl-wr841n_v11-orig.bin skip=257 bs=512</code>
Die Ausgabedatei (in diesem Fall ''tl-wr841n_v11-orig.bin'') muss dann auf den Router. Das geht am einfachsten per ''scp'' und direkter LAN-Verbindung. Also eine LAN-Verbindung zum Router herstellen, am einfachsten per DHCP. Der Router ist dann unter ''fdff::1'' zu erreichen.
Folgendermaßen kann man dann das Image auf den Router kopieren (bei scp über IPV6 muss man die eckigen Klammern um die IP-Adresse mit einem
Backslash escapen):
:<code> scp -6 tl-wr841n_v11-orig.bin root@\[fdff::1\]:/tmp/ </code>
Dann per ''ssh'' auf dem Router einloggen:
:<code> ssh root@fdff::1 </code>
und schließlich das draufkopierte Image flashen (der Befehl muss natürlich auf der Konsole des Routers ausgeführt werden):
:<code> mtd -r write /tmp/tl-wr841n_v11-orig.bin firmware </code>
Das war’s schon! Es kommen noch ein paar Sekunden Schreib-Meldungen, dann schmeißt einen der Router raus und startet neu — und begrüßt einen nach dem Reboot mit der Original-Firmware.
[[Kategorie:Technik]]
[[Kategorie:Technik]]
[[Kategorie:EinstiegsInformationen]]

Version vom 7. Februar 2019, 13:04 Uhr

Der wichtigste Hinweis zuerst

Einen Freifunk-Router 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 Freifunk-Router, 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 zumindest grundlegendes Interesse an der Technik mitbringen. Aber keine Panik: Freifunk-Router sind im Allgemeinen sehr pflegeleicht.

Durch das Betreiben eines Freifunkrouters stimmt man dem PicoPeeringAgreement zu.

Firmware-Installation

Aktuell ist die Version 20181202: https://dev.freifunk-franken.de/firmware/current/

Adrian Schmutzler stellt verschiedene alternative Firmwares auf seiner Seite zur Verfügung: https://freifunk.jubt.org/fff-firmware.php

Fabian Bläse stellt alternative dezentrale Gateway Firmwares auf seiner Seite zur Verfügung: https://fw.sgstbr.de/gateway/


Eine Anleitung, wie die aktuelle Firmware gebaut wird oder an der Entwicklung teilgenommen werden kann, gibt es hier.


Installationsanleitung für Erstinstallation

Lieferinhalt (WR841ND)

am Beispiel TP-Link WR841N(D) und TP-Link WR1043N(D)

Bitte beachte die Reihenfolge

  1. Melde dich für Informationen, Hilfe und Kontakt zur Community bei unserer Mailingliste an.
  2. Router flashen (= Firmware installieren).
  3. Router konfigurieren.

Auspacken

  • Router (1) auspacken, Teile auf Vollständigkeit überprüfen.
  • Falls die Antenne (2) noch nicht angeschlossen ist, schraubt man diese jetzt an.
  • Das Netzteil (3) für die Stromversorgung des Routers und das LAN-Kabel (4) braucht man später.
    • Es sollte immer das original Netzteil verwendet werden, um Probleme während dem Flashen zu vermeiden.

Firmware (Erst-)Installation

Router Rückseite
  • Hier eine Liste der Routertypen, welche für die Freifunk-Franken-Firmware geeignet sind.
  • Herauszufinden, welche Firmware man braucht, ist ganz einfach: der Routertyp (1) und die Hardwareversion (2) stehen auf der Unterseite des Routers. Dabei unbedingt den richtigen Typ und die richtige Hardware-Version wählen!
  • Die passende aktuelle Firmware herunterladen.

Ggf. muss der Dateiname gekürzt werden! Manche Router verweigern das Flashen der Firmware aus der Herstellersoftware, wenn der Dateiname zu lang ist. Dafür einfach den Namen der Datei anpassen und nur 8 Zeichen stehen lassen.

    • Die Factory-Version ist zu verwenden, wenn von der Herstellersoftware geflasht wird.
    • Die Sysupgrade-Version braucht man, wenn von einem bereits installierten OpenWRT (bzw. Freifunk-Firwmare) geflasht wird.
gelbe Buchse
  • Den Computer mit einem LAN-Kabel mit einem der gelben LAN-Anschüsse des neuen Routers verbinden. Darauf achten, dass einer der beiden vom blauen Port am weitesten entfernten Ports verwendet wird.
  • Den Router an Strom anschließen und einschalten.
  • Warten, bis der eigene Computer eine gültige IP-Adresse bekommen hat. (Falls dies nicht klappt, den Rechner neu starten und prüfen, ob die IP-Adresse automatisch vom Router bezogen wurde.)
  • Mit dem Browser im Webinterface des Routers einloggen. Nutzername und Passwort stehen auf der Unterseite des Routers; normalerweise funktioniert: http://admin:admin@192.168.0.1
Firmware-Update
  • Unter dem Menüpunkt "System Tools" –> "Firmware Upgrade" die vorher heruntergeladene Firmware zum Gerät schicken. Achtung! Unter Umständen muss der Dateiname gekürzt werden, wenn die Software das Flashen verweigert.
  • Geduldig warten, bis der Router neu startet (max. 4 Minuten) Während die Installation läuft, darf der Stecker und das Netzwerk-Kabel nicht abgezogen werden.
  • Jetzt muss man sich neu mit dem Router verbinden. Dafür müssen die beiden am weitesten vom blauen Anschluss entfernten Ports verwendet werden! Der WAN Anschluss (blau) sollte dabei noch nicht mit dem Internet verbunden sein, damit man zuerst ein Passwort setzen kann!
  • Über die Adresse https://[fdff::1] auf den frisch geflashten Freifunkrouter gehen und die Sicherheitswarnung ignorieren: "Diese Verbindung ist nicht sicher" SEC_ERROR_UNKNOWN_ISSUER
    • Achtung: Sicherheitswarnungen dürfen nur ignoriert werden, wenn man genau weiß, was man tut. In diesem Fall hat der Router kein von einer CA signiertes Zertifikat für die Adresse, daher wird ein selbstsigniertes Zertifikat verwendet.
  • Falls die Seite nicht aufgerufen werden kann, gibt es noch mehr Möglichkeiten.
  • Es kommt das Login der Weboberfläche. Benutzer: root Passwort: ffol
  • Das Standardpasswort des Routers gleich ändern und aufschreiben z.B. mit einem Stift auf dem Router. Siehe auch: Neues Passwort setzen.
  • Unter Einstellungen den Standort eingeben. Der Standort sollte möglichst genau angegeben werden
  • Eine Kontaktmöglichkeit ist nach dem PPA Pflicht um ein Freifunknetz zu betreiben. Im Router kann dazu eine E-Mail Adresse hinterlegt werden.

Somit kann so im FFF Monitoring der Router deinem Account zugeordnet werden. Dazu dort mit der gleichen Mailadresse registrieren.

  • Den Router neustarten.
  • Fertig!

Konfigurieren über das Webinterface

Folge der Anleitung für Zugriff auf das Webinterface. (Vor der Firmware Version 20160213-beta wurde Netmon zum konfigurieren benötigt, dies ist seither nicht mehr erforderlich).

Wichtig:
Der Ortseintrag im Webinterface ist für die korrekte Funktion des Freifunknetzes von hoher Bedeutung. Das Freifunk-Franken Netz ist in verschiedene Hoods segmentiert (Vgl. Portal:Netz). Ein in die falsche Hood oder ein nicht eingetragener Router, der mit anderen Routern mesht, umgeht die beabsichtigte Segmentierung und verbindet die jeweiligen Hoods auf Level 2 Ebene miteinander, wo lediglich ein Level 3 Routing stattfinden sollte.

Dies ist die momentan häufigste Ursache für Schwierigkeiten und Performance-Defizite im Freifunk Netz.

Wer seinen Standort nicht bekannt geben möchte, möge ihn im Webinterface in der gleichen Hood, in welche der Router seinen tatsächlichen Standort hat, an einem beliebigen anderen Ort platzieren.

Die Aufteilung der Hoods kann man in der Monitoring-Map sehen, indem man im Overlay (rechte obere Ecke) die Checkbox "Hoods" aktiviert.

Die richtige Angabe des tatsächlichen Standorts erachten wir selbstverständlich für vorteilhafter, u.a. weil dies das Finden von Mesh-Partnern erleichtert. Wer keinen Standort angeben möchte, möge sich einen beliebigen innerhalb derselben Hood aussuchen.

Inbetriebname

Meshverbindung

Hat sich der Router schon mit einen Nachbarrouter vermesht, ist er direkt in Betrieb und vergrößert von nun an das Freifunknetz.

VPN-Verbindung

Ist kein weiterer Freifunkrouter in Reichweite, kann der Router auch über den blauen WAN Port mit dem Internet verbunden werden. Es wird dann eine VPN Verbindung über das Internet zu unseren Gatewayservern aufgebaut, und der Router ist nach einiger Zeit (5-30 Minuten) per VPN mit dem Freifunknetz verbunden.

Es sollte pro Internetuplink nur ein Router eine VPN Verbindung aufbauen. Werden an einen Standort mit einen Internetuplink mehrer Router betrieben, so sollten alle weiteren Router per B.A.T.M.A.N. miteinander verbunden werden. Der stärkste Router sollte an den Internetuplink angebunden werden.

B.A.T.M.A.N.-Ports

Die B.A.T.M.A.N.-Ports dürfen auch an einen Switch sternförmig zusammen geschlossen werden. Es sollte allerdings vermieden werden, an einen Switch ein normales Netzwerk und B.A.T.M.A.N. gleichzeitig zu betreiben, da dies zu unvorhersehbaren Ereignissen führen kann. Sollte dennoch gewünscht werden, über ein Kabel oder an einen Switch mehrere Netzwerke mit B.A.T.M.A.N. zu verwenden, so sollten die Netze in getrennte VLANs geführt werden. Eine Grundlegende Anleitung zu VLANs ist hier zu finden, allerdings in einem anderen Zusammenhang.

Natürlich verbinden sich die Router auch per Funk miteinander, wo immer es möglich ist sollte aber aus Geschwindigkeitsgründen ein Kabel verwendet werden. Für weitere Strecken sollten 5GHz Richtfunkverbindungen verwendet werden, Infos dazu hier.

Firmware-Update

Versionierung

Beim Techniktreffen vom 06.02.2016 wurde ein neues Versionierungsschema beschlossen. Am 10.02.2016 wurden noch einige Details geklärt.

Begründung

Wir haben leider nicht die Men-Power um immer sicherzustellen, dass die Kompatibilität nach einem Release noch oder eben nicht mehr vorhanden ist. Dadurch ist der Interpretationsspielraum bei regulären Versionsnummern sehr hoch. Um diesen Spielraum abzuschaffen, steigen wir auf das Datumsschema um.

Schema

Die Versionsnummer orientiert sich grundsätzlich am Commit-Datum des letzten Commits. Auf diesen Commit wird dann entsprechend das Git-Tag gesetzt. Daraus ergibt sich folgendes Schema:

Build ohne release Tag: YYYYMMDD-[Anzahl commits seit vorherigem Release]-[Commit-ID]
Alpha: YYYYMMDD-alpha
Beta: YYYYMMDD-beta
Release: YYYYMMDD

Sonderfall

Für den seltenen Fall, dass es mehrere Tags an einem Tag geben muss, wird der Präfix entsprechend angepasst. Daraus ergibt sich folgendes Schema:

Build ohne release Tag: YYYYMMDD.[1-n]-[Anzahl commits seit vorherigem Release]-[Commit-ID]
Alpha: YYYYMMDD.[1-n]-alpha
Beta: YYYYMMDD.[1-n]-beta
Release: YYYYMMDD.[1-n]

Beispiele

Folgendes Beispiel geht davon aus, dass es eine Alpha und eine Beta Version auf dem selben Commit gegeben hat. In der Beta wurde am selben Tag ein massives Problem festgestellt, deshalb gab es eine neue Beta. Diese basiert auf einem neueren Commit und wird später auch so released.

20160130-alpha
20160130-beta
20160130.1-beta
20160130.1

Das nächste Beispiel geht davon aus, dass es auf dem selben Commit eine Alpha, Beta und Stable gibt:

20160130-alpha
20160130-beta
20160130

Noch eine Bitte

Bitte melde dich bei unserer Mailingliste an! Die Infos dazu gibt es unter Kommunikation. Dort gibt es auch Hilfe und Support bei der Installation. Danke!

Siehe auch

Kommandoliste auf den Freifunk-Routern

Auf dem Router läuft DD-WRT

Mitunter bekommt man einen gebrauchten Router, auf dem nicht die Original-Firmware, sondern DD-WRT läuft. Dann ist ein Flashen der Freifunk-Firmware via Webinterface nicht möglich, da DD-WRT nur DD-WRT-Firmware flasht.

Mit folgendem Vorgehen habe ich mehrere TP-Link TL-1043ND mit DD-WRT darauf geflasht (von Linux aus):

Zunächst muss Telnet aktiviert werden. Hierzu per Webinterface anmelden, und unter „Administration“ den Telnet-Zugriff aktivieren.

Dann wird die Firmware auf den Router kopiert. Es wird die „sysupgrade“-Variante benötigt, in meinem Fall „fff-20181202-ar71xx-g-tl-wr1043nd-v1-squashfs-sysupgrade.bin“.

Die einfachste Variante, die Firmware auf den Router zu bekommen, ist, sie von da aus per wget von einem Webserver abzuholen. Entweder verwendet man einen richtigen HTTP-Server, oder behilft sich – wie im folgenden beschrieben – mit dem Mini-Webserver, den Python mitbringt:

Der Einfachheit halber macht man zunächst eine Kopie mit einem griffigeren Namen:

cp fff-20181202-ar71xx-g-tl-wr1043nd-v1-squashfs-sysupgrade.bin firmware.bin

Dann startet man im selben Verzeichnis den Mini-Python-Webserver:

python -m http.server

Der Server lauscht auf 0.0.0.0 (also allen verfügbaren Netzwerkinterfaces) auf dem Port 8000. Wenn man in einem Webbrowser die Adresse 127.0.0.1:8000 öffnet, sieht man ein Directory Listing (incl. der Datei „firmware.bin“).

Dann auf dem Router einoggen (der Router hatte hier die IP-Adresse 192.168.11.1):

telnet 192.168.11.1

Dann die Firmware nach /tmp kopieren (der Client hatte hier die IP-Adresse 192.168.11.147):

cd /tmp
wget http://192.168.11.147:8000/firmware.bin

und schließlich die Firmware flashen mit

mtd -r write /tmp/firmware.bin linux

Der Router startet neu und begrüßt einen dann mit der Freifunk-Firmware.

FF-Router mit Original-Firmware flashen

Manchmal will man einen FF-Router wieder mit der Original-FW des Herstellers flashen. Hier folgen die Anleitungen:

TP-Link WR 841

Erfolgreich durchgeführt wurde folgendes Vorgehen für die Version 11 des Routers. bei anderen funktioniert es vermutlich genauso, bitte ergänzen!

Zunächst braucht man die Original-Firmware, erhältlich von der Hersteller-Seite. In meinem Fall war es ein Zip-Archiv, das zunächst noch entpackt werden musste und neben der Firmware noch die GPL und eine Anleitung enthielt.

So geht man unter Linux vor:

Wenn das Firmware-Image „boot“ enthält, muss zunächst der Boot-Part entfernt werden. Das geht sehr einfach mittels dd. In meinem Fall hieß die Firmware-Datei wr841ndv11_en_3_16_9_up_boot(150616).bin.

dd if=wr841ndv11_en_3_16_9_up_boot(150616).bin of=tl-wr841n_v11-orig.bin skip=257 bs=512

Die Ausgabedatei (in diesem Fall tl-wr841n_v11-orig.bin) muss dann auf den Router. Das geht am einfachsten per scp und direkter LAN-Verbindung. Also eine LAN-Verbindung zum Router herstellen, am einfachsten per DHCP. Der Router ist dann unter fdff::1 zu erreichen.

Folgendermaßen kann man dann das Image auf den Router kopieren (bei scp über IPV6 muss man die eckigen Klammern um die IP-Adresse mit einem Backslash escapen):

scp -6 tl-wr841n_v11-orig.bin root@\[fdff::1\]:/tmp/

Dann per ssh auf dem Router einloggen:

ssh root@fdff::1

und schließlich das draufkopierte Image flashen (der Befehl muss natürlich auf der Konsole des Routers ausgeführt werden):

mtd -r write /tmp/tl-wr841n_v11-orig.bin firmware

Das war’s schon! Es kommen noch ein paar Sekunden Schreib-Meldungen, dann schmeißt einen der Router raus und startet neu — und begrüßt einen nach dem Reboot mit der Original-Firmware.