Anleitungen

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.

Das PicoPeeringAgreement solltest du auch schon mal gelesen haben.

Wie flashe (= installiere) ich meinen Router?

Anleitung zum Flashen oder Aktualisieren der Freifunk Firmware.

Wie ist meine MAC Adresse?

Die MAC-Adresse des Routers steht auf der Unterseite des Routers unter "MAC" / "MAC ID" / "Hardware Adresse". Diese sieht in etwa so aus:

00:1E:58:C2:F1:95 (Manchmal sind keine Doppelpunkte dabei.)

Zugriff auf das Webinterface zum Konfigurieren des Routers

Zuerst brauchst Du eine Verbindung vom Rechner zum FFF-Router. Dazu gibt es vier Möglichkeiten:

mit LAN Kabel

Vom LAN-Anschluss am Rechner mit LAN-Kabel direkt zum FFF-Router in einen der beiden gelben LAN-Anschüsse, die am weitesten vom blauen WAN-Anschluss entfernt sind: LAN-3 und LAN-4.

Nun hat aber der Rechner keine Verbindung mehr zum Internet. Verbinde deshalb den FFF-Router von der blaue WAN-Anschluss, mit einem zweiten Kabel, zu einem freien LAN-Anschluss deines Internet-Routers. Damit kann sich der Freifunkrouter mit dem Freifunknetz verbinden und dein PC hängt als Client im Freifunknetz und kann somit auch das Webinterface aufrufen oder sich im Freifunknetz bewegen.

Anschliessend die Monitoring-Seite des FFF-Routers aufrufen, und dort über den Link "WebUI" auf die Konfigurationsseite des Routers (s. unten Link im Monitoring)

mit WLAN

franken.freifunk.net (mit Notebook, Tablet, oder WLAN-Stick an PC)
Einwahl über Browser mit: https://[fdff::1] dann mit Benutzername und Passwort.

Remote

(anderer Freifunkrouter in gleicher Hood) ???

Link im Monitoring

Wenn der Router schon im Monitoring auftaucht, ist das Webinterface über einen Direktlink erreichbar. Mit einem Klick auf einen Knoten in der Monitoring-Map öffnet sich ein Popup mit dem Knotennamen. Mit einem Klick auf den Knotennamen öffnet sich die Monitoringseite des Knotens. Der Link "WebUI" neben dem Hostnamen führt direkt zum Webinterface.

Konfiguration des Routers über das Webinterface

Nach dem Klick aur "WebUI" in der Monitoring-Seite des Routers landet man im Webinterface zur Konfiguration des Routers. Dort muss man sich erst einloggen.

Einloggen im Webinterface

Der Benutzername ist root, das Passwort lautet bei neuen Routern standardmäßig ffol. (Passwort bitte umgehend ändern, sonst kann jeder den Router manipulieren!). Danach muss man natürlich das geänderte Passwort kennen.

Aufpassen, dass das Netzwerkinterface am PC/Laptop auf "IP automatisch beziehen steht". Der Router vergibt dem Laptop nun eine IPv6-Adresse in der Art fdff::MAC. Der Router ist unter folgenden Adressen erreichbar:

fdff::1 (nur möglich, wenn man direkt mit dem Router verbunden ist)
fdff::MAC (Möglich innerhalb der gleichen Hood)
fdff::locallink (Möglich innerhalb der gleichen Hood)

Ein Interfaceidentifier ist nicht mehr nötig.

Der Zugriff per Webbrowser geschieht über http(s)://[fdff::XXXX] Am Beispiel der MAC-Adresse 12:34:56:78:90:23 wäre folgendes möglich:

http(s)://[fdff::1234:5678:9023] (MAC)
http(s)://[fdff::1034:56ff:fe78:9023] (locallink)
http(s)://[fdff::1] (Nur wenn man direkt mit dem Router verbunden ist)

Die Adressen findet man im Monitoring auch auf der Routerseite unter dem Interface br-mesh.

Wird im Normalfall nicht mehr benötigt, aber falls es noch jemand sucht: Umrechnung locallink: http://ben.akrin.com/?p=1347 oder https://ssl.mastersword.de/~reddog/ll.php

Hat man nun Zugriff auf das Webinterface steht der Konfiguration fast nichts mehr im Wege. Habt Ihr euch erfolgreich mit dem Benutzername root und dem Passwort ffol angemeldet seht Ihr folgende Seite: <<BILD von Home-Site EINFÜGEN>> Ihr solltet folgenden Konfigurationen vornehmen:

Tab "Passwort"

Als erstes solltet du das root Passwort ändern damit niemand sonst administrativen Zugriff auf deinen Router bekommen kann. Klicke auf den Reiter Passwort. Du solltest unbedingt ein sicheres Passwort verwenden. Zum Thema sicheres Passwort kannst du dich auf der Seite des Bundesamt für Sicherheit in der Informationstechnik schlau machen. Das neue Passwort einfach in die Felder eintragen und dann auf Submit Query klicken. Nun solltet du über den Feldern die Bestätigung Passwort geändert! sehen.

Tab "Einstellungen"

Als nächstes klickt auf den Tab Einstellungen. Falls du das Passwort geändetrt hast, wirst du hier aufgefordert, dich mit deinem neuen Passwort anzumelden. Unter diesem Tab kannst du nun folgende Felder ausfüllen:

Knotennamen: Gib hier einen Namen für deinen Router ein (kann beliebig gewählt werden, da das Monitoring die über die MAC Adresse zuornet). Sinnvolle Namen sind: Bäckerei Schmidt, HNO Dr. Müller, ASTA Uni Erlangen, Grundschule Pestalozzi, Busstation Rosenstr., Heinrich-Heine-Platz, etc.

Knotenbeschreibung: Hier kannst du deinen Knoten beschreiben.

GPS Breitengrad

Klicke auf Position auf Karte anzeigen / setzen. Nun öffnet sich ein keines Fenster mit einem Kartenausschnitt von OpenStreetMap. Verschiebe die Karte zum Standort des Routers und zoome möglichst weit rein, damit der Standort Haus-genau gesetzt werden kann. Klicke an der genauen Position in die Karte. Jedes weitere Klicken verschiebt den blauen Punkt. Die Koordinaten werden dabei automatisch in die entsprechenden Felder übenommen. Wenn alles passt annst du das Fenster wieder schliessen.

Wenn die Karte in deinem Gebiet noch nicht genau ist, dann kannst du sie bei OpenStreetMap ändern und/oder ergänzen. Das Ergebnis ist in wenigen Minuten auf der Karte sichtbar.

GPS Längengrad: siehe GPS Breitengrad

E-Mail Adresse: Gib hier deine E-Mail Adresse an, über die man dich für etwaige Rückfragen erreichen kann.

Standortbeschreibung: Hier kannst du den Ort, Strasse und Hausnummer, und den genauen Standort angeben. Dies ist kein Pflichtfeld!
Beispiel: Erlangen, Müller-Weg 6, 1. Stock links, Fenster zum Hof

Bitratenbegrenzung: Hier kannst du den Traffic limitieren. Dies ist nur sinnvoll wenn du einen sehr langsamen Internetanschluss hast. Bei schnellen VDSL / Kabelanschlüssen ist sowieso der Router der bergenzende Faktor

Tab "Anschlüsse"

Hier wird nach kurzer Berechnungszeit die Belegung der Anschlüsse am Router grafisch dargestellt.

Beispiel:

WAN-Port	Verbindung zum Internet-Router
Port #0
Port #1	B.A.T.M.A.N
Port #2	B.A.T.M.A.N
Port #3	LAN
Port #4	LAN

Tab "Neustart"

Nach Änderung der Einstellungen muss der Router neu gestartet werden.
Klicke auf Router neustarten.

Monitoring (früher Netmon)

Damit der Router dir in deinem Account zugeordnet wird, musst du dich auf der Website FFF Monitoring mit der gleichen Mailadresse registrieren, die du schon im Webinterface des Routers angegeben hast oder die du auf dem Router hinterlegt hast. Dies ist keine Pflicht um den Router zu betreiben, die Konfiguration geschieht einzig und alleine auf dem Webinterface.

Eine Konfiguration im früheren "Netmon" (bis 2016?) ist nicht mehr möglich und auch nicht mehr nötig. Der Router wird ab dem Firmwarerelease 20160213-beta nur noch über das Webinterface konfiguriert und ist im Netmon nicht mehr sichtbar.

Sollte ein Router nach Update noch im Netmon existieren, wird dringend empfohlen ihn dort komplett zu löschen.

Wie ändere ich das Passwort für den Router?

Geht ab sofort über das Webinterface (WebUI). Das Standardpasswort ist weiterhin "ffol" was für FreiFunkOnLine steht. Das Passwort gilt auch für das WebUI mit dem Benutzernamen root.

Zugriff per SSH

Das Kommandozeilen-Interface (Konsole) des Routers erreicht man via ssh (unter Windows z.B. mittels PuTTY). Per SSH kann nun über die oben genannten Adressen zugegriffen werden, diese sind im Monitoring auch auf der Routerseite unter Interfaces beim br-mesh zu finden. Die Locallink-Adresse funktioniert aber auch weiterhin. Wird das Passwort per SSH geändert, wird es im WebUI erst nach einen Neustart des Routers übernommen, wird es im WebUI geändert wirkt es sofort.

Per Linux sieht das Kommando zum Beispiel so aus:

ssh root@fdff::6872:5136:1083

Man muss für die fdff:: Adressen natürlich in der gleichen Hood sein, damit dies funktioniert.

Link Local Adresse per Multicast Ping herausfinden

Jedes Interface weißt sich automatisch selbst eine IPv6 Link Local Adresse aus fe80::/64 zu. Dabei wird der Interface Identifier (die hinteren 64bit) aus der MAC-Adresse generiert.

Diese Adresse ist nur auf einem Link gültig (hat also "link scope"), daher muss

Jedes Gerät, mit dem man reden möchte, direkt per Ethernet (direkt, über einen Switch, über eine Bridge, ..) verbunden sein.
Zusätzlich zur Adresse muss eine "Zone ID" angegeben werden, also das Interface, auf dem man reden möchte.
- Dies wird mit %interface, also z.B. fe80::1%eth0 angegeben.

Mithilfe diverser Multicast-Adresse kann man mehrere (oder alle) Nachbarn auf einem Link erreichen. Dazu zählen:

ff02::1 erreicht alle link-lokalen Nachbarn, also alles, was direkt verbunden ist.
ff02::2 erreicht alle link-lokalen Router.
Eine vollständige Übersicht gibts auf den Seiten der IANA.

Sendet man also einen ping an eine dieser Multicast Adressen, erhält man eine Antwort von allen Hosts, die sich darunter angesprochen fühlen (und ICMPv6 nicht blockieren, shame on you Windows..).

Die erste Antwort kommt dabei normalerweise vom eigenen Rechner, der auf den Ping am schnellsten antworten kann. Ist man also direkt mit einem anderen Gerät verbunden, sieht man 2 Ping-Antworten.

Das sieht dann etwa so aus:

~$ ping ff02::1%eth0
PING ff02::1%eth0(ff02::1%eth0) 56 data bytes
64 bytes from fe80::803:cb9c:dd14:7af%eth0: icmp_seq=1 ttl=64 time=0.030 ms
64 bytes from fe80::5054:ff:fe13:21c9%eth0: icmp_seq=1 ttl=64 time=1.266 ms (DUP!)
64 bytes from fe80::5054:ff:fe28:3d79%eth0: icmp_seq=1 ttl=64 time=1.321 ms (DUP!)
64 bytes from fe80::f29f:c2ff:fe61:baca%eth0: icmp_seq=1 ttl=64 time=1.355 ms (DUP!)
[..]

Wie kann ich die Sendeleistung anpassen?

Wenn bei einem Router die mitgelieferten Antennen (z.B. mit 5 dBi) gegen solche mit höherem Gewinn ausgetauscht werden (mit z.B. 9 dBi), muss (rein rechtlich) die Sendeleistung des Routers reduziert werden, um die maximal abgestrahlte Leistung von 100 mW nicht zu überschreiten.

Die Angabe der Leistung erfolgt in dBm, 100 mW entsprechen 20 dBm als maximal zulässige Leistung. Dieser Wert ergibt sich vereinfacht aus der Summe der Sendeleistung des Routers und dem Antennengewinn, die Leistungsdämpfung durch Kabel und Steckverbindungen kann noch abgezogen werden. Bei den standardmäßig mitgelieferten Rundstrahlantennen der Router-Hersteller liegt der Antennengewinn meist bei ca. 3-5 dBi. Die Dämpfung kann ungefähr mit 2-3 dB beziffert werden.

Berechnung

Somit ergeben sich folgende Formeln:

Gesamtleistung = Sendeleistung - Dämpfung + Antennengewinn
Sendeleistung = Gesamtleistung + Dämpfung - Antennengewinn

Beispiel für die maximale Gesamtleistung von 20 dBm, einer Dämpfung von 3 dB und einem Antennengewinn von 8 dBi - die Sendeleistung des Routers dürfe somit 15 dBm betragen:

Sendeleistung = 20 dBm + 3 dB - 8 dBi = 15 dBm

Anpassung am Router per SSH

Die folgenden Befehle nach Anmeldung in der SSH-Konsole des Routers verwendet.

Werte ermitteln

iwconfig

Resultat (Beispiel mit 19 dBm Sendeleistung)

w2ap      IEEE 802.11bgn  Mode:Master  Tx-Power=19 dBm   
          RTS thr:off   Fragment thr:off
          Power Management:off

Werte anpassen (beispielsweise für eine Antenne mit 8 dBi Zugewinn, liegt die Sendeleistung bei 15 dBm)

uci set wireless.radio0.txpower=15
uci commit wireless
wifi

Beim Update ging etwas komplett schief

Wenn der Router sich nach dem Update nicht mehr meldet bzw. etwas schief gegangen ist (weil z.B. die Stromzufuhr unterbrochen wurde), kann eventuell diese Anleitung helfen, das Gerät wieder funktionsfähig zu bekommen. Es wird dabei dir Firmware über die serielle Schnittstelle neu geflasht. Dieses Vorgehen nennt man auch unbrick, da aus dem "Backstein" wieder ein funktionierender Router wird.

Ihr benötigt allerdings hierfür:

einen Rechner mit einem seriellen Anschluss (RS232) oder
ein USB-to-Serial-Adapterkabel, wie es diese zum Beispiel für Handys gibt

Weiterhin braucht ihr einen Lötkolben und etwas Erfahrung im Umgang mit diesem. Um die Verbindung herzustellen ist außerdem ein Programm wie PuTTY, Hyperterminal oder cutecom (Linux) notwendig. Zusätzlich muss auf dem Rechner ein TFTP-Server installiert werden und die zu flashende Firmware muss sich im Rootverzeichnis des Servers befinden. Anschließend geht ihr am besten nach folgender Anleitung vor.

Eine schrittweise Anleitungen zum Wiederbeleben eines defekten Routers, der nicht mehr durchstartet, gibt es auch hier:

https://wiki.freifunk-franken.de/w/Unbricken_eines_TP-Link_1043ND

Bei einem gebrickten Ubiquiti-Router war tftp von der Kommandozeile per ethernet erfolgreich. Man benötigt dazu natürlich das factory binary.

Unter Windows:

Ethernet-Schnittstelle auf 192.168.1.1 setzen, mit dem Ubiquiti verbinden, im stromlosen Zustand den Resetknopf drücken und halten, Gerät bestromen, ca. 20-30 Sekunden die Taste gedrückt halten, bis die LEDs alle wild und bunt blinken, die obersten beiden im Wechsel.

Jetzt unter Windows von der Kommandozeile aus dem Ordner, in dem auch das factory binary liegt:

tftp -i 192.168.1.20 put openwrt-ar71xx-generic-ubnt-nano-m-squashfs-factory.bin

Während der Übertragung flackert die zweite LED von unten, dann beginnt bissl wilde Lichtorgel in wechselnden Mustern, irgendwann macht der Router 'n reboot und ist wieder im normalen Freifunk-Betrieb aktiv.

Die Linuxianer wissen sicher eh, wie das geht bzw. unter Linux umzusetzen ist.

Jedenfalls benötigt man so keinerlei tftp-Server, keinerlei RS232-Kabel, muß auch nicht erst mit wireshark irgendwelche Adressen rauskriegen, daher ist das wohl einen Versuch wert, vor man tiefer einsteigt :)

Für UART hier paar hilfreiche Tipps: https://community.ubnt.com/t5/airOS-SDK-Custom-Development/AirMAX-Device-Firmware-Recovery-Procedure/m-p/1499583#M2499 Man benötigt keinen Lötkolben, die UART Pins sind bereits aufgelötet. Jumperkabel passen nicht richtig wenn man sie aber fest andrückt funktionieren sie auch wenn sie nicht richtig von selbst halten/fest sitzen