Freifunk Franken - Benutzerbeiträge [de]

Portal:Firmware OUT

2015-10-22T11:24:31Z

Goredon: /* Firmware */

= Firmware =
Aktuell ist die Version 0.5.1. https://dev.freifunk-franken.de/firmware/ .

Eine Anleitung wie die aktuellen Firmware gebaut wird oder an der Entwicklung teilgenommen werden kann gibt es [[FirmwareEntwicklung|hier]].

== Anleitung zur Routerinstallation ==

für WR841N(D) WR1043N(D)

=== Auspacken ===
[[Datei:dein_router.jpg|400px|Lieferinhalt]]
* Router (1) auspacken, Teile auf Vollständigkeit überprüfen
* falls die Antenne (2) noch nicht angeschlossen ist, schraubt man diese jetzt auf
* das Netzteil (3) für die Stromversorgung des Routers und das LAN-Kabel (4) braucht man später

=== Firmware (Erst-)Installation ===
[[Datei:TP_link_version.jpg|400px|Router Rückseite]]
* Hier eine [[Portal:Hardware|Liste]], welche Routertypen 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.
* Die passende aktuelle Firmware [https://dev.freifunk-franken.de/firmware/current/ hier] herunterladen. Die '''Factory'''-Version ist die richtige. (Die '''Sysupgrade'''-Version braucht man nur, wenn bereits eine Freifunk-Firmware installiert ist.)
'''Achtung!'''
Die Firmware für den WR841ND V7 (und nur genau für diesen) ist kaputt. Hier sollte [https://dev.freifunk-franken.de/firmware/dev/20150907_meskal/ diese Firmware] verwendet werden bis ein fix eingespielt wurde. Wurde die falsche Firmware bereits geflasht kann mit folgender Lösung das Problem behoben werden:
* nichts am WAN Port anschließen
* Kein meshfähiges Gerät in der nähe betreiben
* LAN Kabel an einen gelben Port ran und probieren per Locallink drauf zu kommen, eventuell auch die letzte Ziffer der MAC +1 oder -1 rechnen (ich glaub -1) sollte eigentlich dann klappen.
Folgendes Kommando dann am Router ausführen:
<pre>
cp /etc/network.tl-wr841nd-v7 /etc/network.tl-wr841n-v7
</pre>
Danach rebooten und der Router sollte sich problemlos im Netmon melden.

[[Datei:gelbe_buchse.jpg|400px|gelbe Buchse]]
* den Computer z.B. mit dem beiliegenden Patchkabel an einen der LAN-Ports (gelb) des Routers anschließen
* 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.)
* im Webinterface des Routers einloggen (Nutzername und Passwort stehen auf der Unterseite des Routers; normalerweise funktioniert http://admin:admin@192.168.0.1)

[[Datei:TP_link_firmware.jpg|400px|Firmware-Update]]
* unter "System Tools" –> "Firmware Upgrade" die vorher heruntergeladene Firmware zum Gerät schicken
* Geduldig warten, bis der Router neu startet. '''Während die Installation läuft, ziehe bitte auf keinen Fall den Stecker oder das Netzwerk-Kabel!'''
* Im Webinterface kann nach dem Neustart gegebenenfalls die Fehlermeldung kommen, dass keine Verbindung möglich ist. Die neue Firmware hat kein Webinterface.
* Das Passwort sollte geändert werden! Siehe [[Anleitungen|hier]].

=== Registrierung/Übernahme im Netmon ===
* Router nach dem Firmware Flash nicht manuell booten oder vom Strom trennen
* über den WAN-Port (blau) den Router mit dem Internet verbinden (einfach von gelb auf blau umstecken oder per B.A.T.M.A.N über WLAN mit schon in der Nähe stehenden Freifunkroutern verbinden lassen)
* Router sollte innerhalb der nächsten 5-10 Minuten im Netmon unter Router/Neue Router auftauchen
* auf [https://netmon.freifunk-franken.de/routerlist.php Routerliste] gehen
* auf "Registrieren" klicken (oben rechts)
* Benutzername und Passwort ausdenken und eingeben, E-Mail eingeben, auf Registrieren klicken
* wenn E-Mail da ist, Registrierung abschließen
* neue Router tauchen unter "Router" (Routerliste) –> "[https://netmon.freifunk-franken.de/routers_trying_to_assign.php Neue Router]" auf
* Router übernehmen und Name sowie Position auf Karte eintragen, den Router erkennt man an seiner MAC-Adresse (siehe Aufkleber Unterseite)
* fertig :-)
'''Tipp:''' Die Inbetriebnahme eines mit FF-Firmware geflashten Router/Registrierung zum Weitergeben/Ausdrucken als [[media:Anleitung_zur_Inbetriebnahme_eines_Freifunkrouters.pdf|PDF]].

== Firmware-Update ==
Wenn bereits eine Freifunk-Franken-Firmware auf dem Router installiert ist, geht man zum Updaten nach einer der folgenden Methoden vor:

=== Möglichkeit 1: sysupgrade.sh ===
'''Achtung:''' Benötigt eine Firmware neuer als Version 0.5.0
* Man loggt sich auf dem Router per ssh ein, siehe auch [[Anleitungen|hier]].
* Und startet folgendes Skript ''/etc/sysupgrade.sh''

=== Möglichkeit 2: Skript einfügen ===
* Man loggt sich auf dem Router per ssh ein, siehe auch [[Anleitungen|hier]].
* Man fügt in das Fenster der Konsole dieses Skript ein und bestätigt gegebenenfalls mit [Enter]:
<pre>
BOARD=$(cat /var/sysinfo/board_name)
case "$BOARD" in
tl-wr1043nd)
BOARD=tl-wr1043nd-v1
;;
tl-wr741nd)
grep "Atheros AR7240 rev 2" /proc/cpuinfo && BOARD=tl-wr741nd-v2 || BOARD=tl-wr741nd-v4
;;
tl-wr741nd-v4)
grep 740 /var/sysinfo/model && BOARD=tl-wr740n-v4
;;
tl-wr841n-v7)
BOARD=tl-wr841nd-v7
;;
esac
FILE="openwrt-ar71xx-generic-$BOARD-squashfs-sysupgrade.bin"
echo "Loading $FILE"
cd /tmp/
wget http://$(uci get configurator.@api[0].ipv6_address)%$(uci get configurator.@api[0].ipv6_interface)/dev/firmware/current/${FILE}
wget http://$(uci get configurator.@api[0].ipv6_address)%$(uci get configurator.@api[0].ipv6_interface)/dev/firmware/current/${FILE}.md5
md5sum -c ${FILE}.md5 && sysupgrade ${FILE}
</pre>
'''Tipp:''' Unter Windows kann der Inhalt der Zwischenablage durch [Umschalt]+[Einfg] in das PuTTY-Konsolenfenster eingefügt werden.

=== Möglichkeit 3: manuelles Vorgehen ===
* Man loggt sich per ssh auf dem Router ein: <tt>ssh root@<ipv6%iface></tt>, siehe auch [[Anleitungen|hier]].
* Man wechselt mit <tt>cd /tmp</tt> in das richtige Verzeichnis. Das aktuelle Verzeichnis kann man sich mit <tt>pwd</tt> anzeigen lassen.
** Das Image wird auf den lokalen PC heruntergeladen und dann auf den Router hochgeladen, dazu gibst du auf deinem Rechner diesen Befehl in die Linux-Konsole ein: <tt>scp <imagename> root@[<ipv6%iface>]:/tmp</tt>, das sieht dann z.B. so aus: <tt>scp openwrt-ar71xx-generic-tl-wr741nd-v4-squashfs-sysupgrade.bin root@[fe80::fad1:11ff:fe90:3e6e%wlan0]:/tmp</tt>
** Unter Windows kann mit dem Befehl "pscp" das Image wie folgt hochgeladen werden: <tt>pscp -scp -6 <imagename> root@[<ipv6%iface>]:/tmp</tt>
** Alternativ erfolgt der Download direkt auf dem Router <tt>cd /tmp && wget http://[fe80::ff:feee:1%br-mesh]/dev/firmware/<version>/<image></tt>, z.B. <tt>cd /tmp && wget http://[fe80::ff:feee:1%br-mesh]/dev/firmware/fff_0.4.0rc5/openwrt-ar71xx-generic-tl-wr741nd-v4-squashfs-sysupgrade.bin</tt>
* Zuletzt führt man das update aus: <tt>sysupgrade -n <imagename></tt>. Solange du kein sehr altes Image (vor 0.3.999) auf dem Router hast, kannst du versuchen, ohne <tt>-n</tt> zu flashen, dann bleibt das Passwort erhalten.

'''Bitte beachten:''' Nach dem Flashen sollte der Router-Hash im Netmon gelöscht werden, damit Router und Netmon einen neuen Hash aushandeln können. Dazu einfach im Netmon einloggen: "Router" (Liste der Router) –> "Routerbezeichnung" (Router ''Bezeichnung'') –> "Routeroptionen" -> "Konfig. bearbeiten" –> "Router auto assign Hash zurücksetzen".

Der SSH-Fingerprint ändert sich beim Update.

=== Besonderheiten beim Update ===
==== Besonderheiten beim Update auf 0.4.0 ====
Wenn bereits 0.4.0rc3f oder neuer installiert ist, einfach mit <tt>sysupgrade</tt> (ohne <tt>-n</tt> Schalter) updaten. Die vorherigen Versionen benötigen zum Flashen noch das <tt>sysupgrade -n</tt> (mit <tt>-n</tt> Schalter). Die alten Images (ab 0.3.999) weisen bei der Verwendung von Sysupgrade bereits auf diesen Umstand hin.

Einfache Regel: Solange du kein sehr altes Image (vor 0.3.999) auf dem Router hast, versuche, ohne <tt>-n</tt> zu flashen. Sollte die Firmware dies noch nicht unterstützen, meldet sie sich mit einer Fehlermeldung. Es geht ansonsten auch nichts kaputt, wenn du mit <tt>-n</tt> flashst.

==== Besonderheiten beim Update auf 0.3.999 ====
Durch den geänderten WLAN-Kanal 1 ist nach dem Flashen die Verbindung zu Routern mit der alten Version über Funk nicht mehr möglich. Sollen also Router aus der Ferne upgedated werden, sollte dies beachtet werden. Nach dem Update bitte im Netmon den Router-Hash zurücksetzen.

==== Besonderheiten beim Update von einer Firmware vor 0.4.0rc4f ====
Gilt nur, wenn auf dem Router eine Firmware vor 0.4.0rc4f installiert ist:

Beim Sysupgrade bitte mit <tt>-n</tt> flashen, damit die alte Config durch die neue überschrieben wird. Dies ist nötig, damit die Daten nicht falsch vermischt werden und am Ende das Passwort nicht mehr stimmt.

=== Failsafe-Modus ===
Wenn beim Flashen etwas schiefgegangen ist und der Router nicht mehr antwortet, dann gibt es als Notnagel noch den [http://wiki.openwrt.org/de/doc/howto/generic.failsafe Failsafe-Modus].
# Router einschalten
# Schalter (QSS) jede Sekunde drücken, etwa eine halbe Minute lang, bis die System-Led schnell blinkt
# IP des eigenen Rechners einstellen auf 192.168.1.2
# Telnet auf den Router 192.168.1.1
# Im Telnet-Fenster (auf dem Router) eingeben:
#: <pre>mount_root</pre>
#: <pre>passwd</pre>
#: <pre>dropbear</pre>
# Unter Windows in Cygwin oder unter Linux in der Konsole:
#: <pre>rm .ssh/known_hosts (nur falls sich scp beschwert, dass der Fingerprint nicht stimmt)</pre>
#: <pre>scp '/pfad/zur/datei/openwrt-ar71xx-generic-tl-wr841nd-v7-squashfs-factory.bin' root@192.168.1.1:/tmp</pre>
# Im Telnet-Fenster (auf dem Router):
#: <pre>sysupgrade -n /tmp/openwrt-ar71xx-generic-tl-wr841nd-v7-squashfs-factory.bin</pre>
# Abwarten und den Router '''nicht''' ausschalten, er rebootet von alleine.

Wenn das nicht geklappt hat, dann schau [http://wiki.openwrt.org/de/doc/howto/generic.debrick hier her].

=== Reflash zur Orginal TP-Link Firmware ===
Eine schöne Anleitung zum Zurück-Flashen eines WR841 gibt es hier im [http://wiki.freifunk-mainz.de/w/Howto/Originalfirmware_zur%C3%BCckflashen Freifunk Mainz Wiki] von ''Antennen-Wolfgang''. Diese Methode funktioniert mit Sicherheit auch mit anderen TP-Link-Modellen. Eine Anleitung für den Router TP 841 mit der Firmware 9.x geht über die Anleitung vom [https://www.freifunk-gera-greiz.de/wiki/-/wiki/Allgemein/WR841N+%3CSLASH%3E+WR841ND Freifunk Gera-Greiz]. Wenn diese Methode angewendet wird und der Router schon im Netmon angelegt war, sollte man ihn vorher dort löschen.

== Noch eine Bitte ==
Bitte melde dich bei unserer Mailingliste an! Die Infos dazu gibt es unter [[Portal:Kommunikation|Kommunikation]]. Dort gibt es auch Hilfe und Support bei der Installation. Danke!

== Siehe auch ==
[http://wiki.freifunk.net/Kommandos Kommandoliste auf den Freifunk-Routern]
[[Kategorie:Technik]]

Anleitungen

2015-08-23T09:40:50Z

Goredon: Absatz zur ntp-Konfiguration hinzugefügt

{{Entwurf}}
__TOC__

== Wie flashe ich meinen Router? ==
<div style="clear:both;margin:30px;" align="center">
<youtube>aFMLIP6gABs</youtube>
</div>

Weitere Infos zum Flashen oder aktualisieren der Freifunk Firmware gibt es [[Portal:Firmware|hier]].

== Wie ist meine MAC? ==
Um zu sehen, wie die MAC vom Router ist, schaust du auf der Rückseite
nach der "MAC" / "MAC ID" / "Hardware Adresse". Diese sieht in etwa so
aus:

<tt>00:1E:58:C2:F1:95</tt> (Manchmal sind die Doppelpunkte nicht dabei.)

=== MAC zu IPv6 wandeln ===

Zur einfachen Umwandlung gibt es ein Skript das einem das "Kippen des Bits" und die manuelle Wandlung/Zusammensetzung erspart. Wer aber wissen will wie man es selbst berechnen findet die Informationen unter "manuelle Wandlung/Berechnun".

==== Verwenden des Skripts ====

Gib deine MAC in folgendes Skript ein und klicke auf "Calc": [https://ssl.mastersword.de/~reddog/ll.php https://ssl.mastersword.de/~reddog/ll.php]

==== manuelle Wandlung/Berechnung ====

Angenommen du hast folgende MAC: <tt>00:1E:58:C2:F1:95</tt>
Um die IPv6 aus der MAC zu berechnen, kippst du vom ersten Byte das
zweite Bit:

<tt>02:1E:58:C2:F1:95</tt>

Dann entfernst du die Doppelpunkte:
<tt>021E58C2F195</tt>

Nun fügst du an den Anfang: <tt>fe80::</tt>, in die Mitte: <tt>ff:fe</tt> an:
<tt>fe80::021E58ff:feC2F195</tt>

Alle vier Zeichen wird nun ein Doppelpunkt gesetzt:
<tt>fe80::021E:58ff:feC2:F195</tt>

== Wie kann ich mich auf den Router einloggen? ==
Zunächst musst du seine IP-Adresse kennen. Der Router ist ausschließlich
über seine IPv6-Link-Local-Adresse über das WLAN-Interface zu erreichen, d.h. man muss per WLAN mit dem Router verbunden sein.

Die IPv6-Adresse kannst du anhand der MAC berechnen, siehe dazu den vorherigen Abschnitt.

Da es sich hierbei "nur" um eine Link-Local-Adresse handelt, ist sie ohne die Scope-ID – das ausgehende Interface – nutzlos.

Bei SSH wird die Scope-ID wie folgt angegeben:
<tt>1234::5678:9012:3456:7890%wlan0</tt>

=== Vorgehen mit Linux ===
Unter '''Linux''' logt man sich mit folgendem Befehl ein:
<tt>ssh root@<ipv6%iface></tt>

Beispiel: <tt>ssh root@fe80::fad1:11ff:fe90:3592%wlan0</tt>

Beim ersten Einloggen sollte unbedingt das Passwort des Routers geändert werden.

=== Vorgehen mit Windows ===
Unter '''Windows''' haben die Interfaces anstatt Namen Nummern, welche sich mit <tt>ipconfig /all</tt> bestimmen lassen. Dazu auf "Start" -> "Ausführen" -> <tt>cmd</tt> [Enter] -> <tt>ipconfig /all</tt> [Enter]. Dann erscheint eine lange Liste, aus der man sich den Eintrag mit <tt>freifunk-franken.de</tt> heraussucht:

<code>
Drahtlos-LAN-Adapter Drahtlosnetzwerkverbindung:
Verbindungsspezifisches DNS-Suffix: freifunk-franken.de
Beschreibung. . . . . . . . . . . : DW1521 Wireless-N Half Mini Card
Physikalische Adresse . . . . . . : 78-F4-00-91-E7-59
DHCP aktiviert. . . . . . . . . . : Ja
Autokonfiguration aktiviert . . . : Ja
Verbindungslokale IPv6-Adresse . : fe80::4d3a:9fa9:c57b:3567%11(Bevorzugt)
</code>

Die gesuchte Interface-Nummer ist in diesem Fall <tt>%11</tt>, was man einfach an die IPv6-Adresse des Routers anhängt. Wie man die bekommt, steht einen Abschnitt weiter oben. Man erhält so z.B.: <tt>fe80::fad1:11ff:fe90:3592%11</tt>

Als SSH-Programm ist [http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html PuTTY] in einer aktuellen Version zu empfehlen. Hat man PuTTY gestartet, gibt man als IP-Adresse die gerade zusammengesetzte Zeichenfolge ein, klickt auf "SSH" und dann auf "Open".

Unmittelbar nach dem ersten Einloggen sollte '''unbedingt''' das Passwort des Routers geändert werden.

== Wie ändere ich das Passwort für den Router? ==
Auf dem Router ist nur der <tt>root</tt>-User aktiv, das Default-Passwort ist <tt>ffol</tt>.
Das Passwort sollte '''in jedem Fall''' mit dem Befehl <tt>passwd</tt> geändert werden, da der Zugriff auf den Router über das gesamte Freifunk-Netz möglich ist. Schreibe das Passwort '''immer''' direkt beim Ändern auf einen Aufkleber (Klebeband) und klebe es auf den Router! Dort ist es sicher und kann nicht verloren gehen. Wenn es verloren gegangen ist, ist das Flashen einer neuen Firmware nur noch mit großem Aufwand möglich.

'''Hinweis:''' Bei der Eingabe eines Passworts unter PuTTY werden die einzelnen eingegebenen Zeichen aus Sicherheitsgründen '''nicht''' angezeigt, man schreibt sozusagen blind.

== Wie kann ich die Routerzeit automatisch synchronisieren? ==
Die Uhr des Routers kann automatisch über das <tt>ntp-Protokoll</tt> synchronisiert werden. Dafür muss lediglich ein ensprechender Absatz zu <tt>/etc/config/system</tt> hinzugefügt werden:

Zuerst sollte die Zeit einmal manuell synchronisiert werden:
<tt>
ntpd -q -p 0.de.pool.ntp.org
</tt>
Dieser Schritt muss wiederholt werden, wenn der Router längere Zeit offline war oder die Routerzeit sehr stark abweicht.

Nun konfiguriert man den automatischen Start des ntp clients:
<tt>
vi /etc/config/system
</tt>
Und fügt folgendes hinzu:
<code>
config 'timeserver' 'ntp'
list 'server' '0.de.pool.ntp.org'
list 'server' '1.de.pool.ntp.org'
list 'server' '2.de.pool.ntp.org'
list 'server' '3.de.pool.ntp.org'
option enable_server 0
</code>

Die Servernamen sind hier nur ein Vorschlag, es können beliebige erreichbare Zeitserver eingetragen werden. Beim nächsten Reboot sollte ntp-client automatisch gestartet werden.
Weitere Informationen erhält man unter: [http://wiki.openwrt.org/doc/howto/ntp.client openwrt: ntp client]

== Wie kann ich die Sendeleistung anpassen? ==
Wenn bei den Routern die mitgelieferten Antennen (mit 5 dBi) gegen solche mit höherem Gewinn ausgetauscht wird (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.

''Bitte Anleitung ergänzen …''

== Router taucht in Netmon nach Benutzerlöschung nicht mehr auf ==
Entweder den Router [[Portal:Firmware#Firmware_Update|neu flashen]] oder per [[Anleitungen#Wie_kann_ich_mich_auf_den_Router_einloggen.3F|SSH einloggen]] und folgendes ausführen:

<code>
cp /rom/etc/config/configurator /etc/config/configurator
</code>

== 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 [http://dev.wlan-si.net/wiki/Routers/TP-LINK/WR741ND Anleitung] vor.

[[Kategorie:EinstiegsInformationen]]