{{Node
|Funkzelle=Troisdorf
|Hersteller=TP-Link
|Typ=TP-Link WR841n

|Seriennummer=2151336003596

|Standort=Marconi
|Einsatzstatus=Eingelagert
}}

2015-08-31T18:53:27Z

2015-08-11T13:07:58Z

Marconi: Die Seite wurde neu angelegt: „= Ausgangspunkt = Du hast einen Router, auf welchem bereits die Troisdorf Freifunk-Firmware läuft. Du hast entweder [https://wiki.freifunk-rheinland.net/Troi…“

Troisdorf/Firmware-Upload

2015-08-11T12:52:53Z

Troisdorf/Firmware-Upload

2015-08-11T12:49:54Z

Marconi: /* Firmware Upgrade durchführen */

= Ausgangspunkt =

Du hast einen Router des Herstellers TP-Link, für den es eine passende Freifunk Firmware-Version gibt. Auf diesem Router läuft noch die Firmware des Herstellers. Dann kannst Du diese Anleitung befolgen. Die Screenshots und Bilder beziehen sich auf das Modell TP-Link TP-WR841N(D), Hardware-Version 9. Für andere Geräte des Herstellers TP-Link ist das Vorgehen aber gleich oder zumindest sehr ähnlich.

Falls die ein Freifunk-kompatibles Gerät eines anderen Herstellers hast, ist das Vorgehen prinzipiell analog. Gerne helfen wir Dir beim Aufspielen der Firmware ("Flashen").

= Ermitteln des genauer Geräte-Typs =

Die Freifunk-Firmware wird für eine Reihe von Routern erstellt. Eine Liste der empfohlenen Geräte findest Du auf dieser Seite: [https://freifunk-troisdorf.de/empfohlene-hardware/ Empfohlene Handware]

Um die für Deinen Router passende Firmware-Datei herunterladen zu können, mußt Du zunächst den genauen Router-Typ ermitteln. Hierbei hilft ein Blick auf das Typen-Schild auf der Unterseite des Routers:

[[File:router-unterseite.jpg|center|400px]]

Im obigen Beispiel handelt es sich um ein TP-Link TP-WR841N, Hardware-Version 9.

= Herunterladen der passenden Firmware-Datei =

* Öffne die folgende Webseite: [http://images.freifunk-troisdorf.de/ Freifunk Troisdorf Firmware].
* Wechsle in das Unterverzeichnis '/stable/factory'. Wir empfehlen grundsätzlich, die stabilen ("stable") Versionen unserer Firmware zu verwenden. Für einen Router, auf den noch die Firmware des Herstellers TP-Link läuft, wird ausßerdem die factory-Variante der Firmware benötigt.
* Aus der Liste suche die für Deinen Router passende Firmware-Datei heraus. Die Dateinamen haben grundsätzlich folgenden Aufbau:

gluon-tdf-<Gluon-Version>-stable-<Firmware-Version>-tp-link-<Geräte-Typ>-<Hardware-Version>.bin

* Für einen TP-Link TP-WR-841N, Hardware-Version 9 lautet der Name der Firmware-Datei also:

gluon-tdf-2015.1.1-stable-1.1-tp-link-tl-wr841n-nd-v9.bin

* Lade die passende Firmware-Datei auf Deinen Computer herunter und lege sie an einem Ort ab, wo Du sie später wiederfindest.

= Router mit dem Computer verbinden =

* Verbinde den Router mit einem Netzwerkkabel mit einem Computer. Benutze hierfür einen der gelben LAN-Buchsen auf der Rückseite des Routers.
* Ist der Router angeschaltet, so erhält der Computer vom Router eine IP-Adresse aus dem Adressbereich 192.168.0.* zugeordnet.
* Öffne nun einen Webbrowser und gib in die Adresszeile folgende Adresse ein:

http://192.168.0.1

= Firmware Upgrade durchführen =

* Nun mußt Du Dich anmelden. Bei einem Fabrik-frischen TP-Link Router lauten Username und Passwort jeweils 'admin'. Sollte dies nicht funktionieren, lese bitte die Dokumentation, die dem Router beiliegt. Nun siehst Du folgende Seite im Browser:

[[File:tpl-flsh-01.png|center|600px]]

* Klicke auf "System Tools" im Menü links, ganz unten. Es öffnet sich folgende Seite:

[[File:tpl-flsh-02.png|center|600px]]

* Klicke auf den Menü-Eintrag "Firmware Upgrade". Nun öffnet sich folgende Seite:

[[File:tpl-flsh-03.png|center|600px]]

* Klicke auf die Schaltfläche "Browse..." und wähle die zuvor heruntergeladene Firmware-Datei aus. Nun hat sich die Seite wie folgt verändert (Firmware-Datei wird angezeigt):

[[File:tpl-flsh-04.png|center|600px]]

* Klicke nun auf die Schaltfläche "Upgrade" und bestätige das nachfolgende Dialogfenster mit einem Klick auf die Schaltfläche "OK":

[[File:tpl-flsh-05.png|center|600px]]

* Nun wird die Firmware-Datei auf den Router hochgeladen und installiert. Anschließend wird der Router automatisch neugestartet, dann mit der neuen Freifunk-Firmware! Das Upgrade - oder "Flashen" dauert ca 1 Minute. Bitte trenne in dieser Zeit weder den Router vom Strom oder vom Netwerkkabel! Der Reboot des Routers ist daran erkennbar, daß alle LEDs des Routers einmal kurz ausgehen.

Nach dem Upload der Firmware bootet der Router mit der Freifunk-Firmware in den sog. Config-Mode, in welchem sich der Router einrichten läßt. Die nun notwendigen Schritte sind auf dieser Seite beschrieben: [https://wiki.freifunk-rheinland.net/Troisdorf/Firmware-Konfiguration Firmware Konfiguration].

2015-07-28T17:22:23Z

Marconi:

= Bemerkungen =

Obwohl das Flashen von Routern mit der Freifunk-Firmware einfach ist, kann es vorkommen, daß das Flashen schiefläuft. Das Ergebnis ist dann ein Router ohne Firmware, auf den ein Zugriff über WLAN oder Ethernet nicht mehr möglich ist ("gebrickter" Router). Allerdings ist häufig der Bootloader [[http://wiki.openwrt.org/doc/techref/bootloader/uboot uboot]] noch funktionstüchtig. Über eine serielle Schnittstelle kann man auf die Konsole des uboot zugreifen und eine Firmware auf das Gerät nachladen ("debricken").

Um Zugriff auf die serielle Schnittstelle zu bekommen, muß das Routergehäuse geöffnet werden. Außerdem muß eine Stiftleiste auf die Platine des Routers gelötet werden. Über einen Pegelwandler kann dann die serielle Schnittstelle des Routers mit einem Computer verbunden werden. Dann kann mit Hilfe eines Terminalprogramms eine Verbindung mit der Konsole des uboot hergestellt werden.

Über die Konsole von uboot kann dem Router eine IP-Adresse zugewiesen werden. Außerdem wird eine IP-Adresse eines Computers angegeben. Auf diesem Computer muß man einen [[https://de.wikipedia.org/wiki/Trivial_File_Transfer_Protocol tftp]]-Server aktivieren, über welchem dem Router die passenden Firmware-Datei angeboten wird.

Dieses Howto beschreibt das Unbricken des Routers TP-Link TP-WR841n(d), Version 9. Unterschiede beim Debricken anderer TP-Link Router werden ergänzt.

== Benötigte Hilfsmittel ==

Für das Debricken eines Routers werden benötigt:
* Kreuzschraubendreher zum Öffnen des Routergehäuses
* Stiftleiste Rastermaß 2,54mm, 1-reihig, 4-polig
* Lötkolben und Lötzinn
* Ein Netzwerkkabel zur Verbindung des Routers mit dem Computer via Ethernet
* Ein UART-USB-Konverter als Pegelwandler und Seriell-USB-Konverter. Sehr günstige Konverter auf Basis des Chips CP210x gibt es z.B. bei [[http://www.ebay.de/sch/i.html?_odkw=cp210+uasb+uart&_osacat=0&_from=R40&_trksid=p2045573.m570.l1313.TR0.TRC0.H0.Xcp210+usb+uart.TRS0&_nkw=cp210+usb+uart&_sacat=0 eBay]]. Außerdem wird ein passendes Kabel zwischen Konverter und Router benötigt (siehe unten).

== Anlöten der Stiftleiste auf die Platine des Routers ==

Nach dem Öffnen des Routers ist die serielle Schnittstelle des Routers zugänglich. Es handelt sich um eine viepolige Reihe von Lötpads. Beim TP-WR841 v9 ist der Anschluß mit J3 bezeichnet. Bei diesem und vielen anderen Routern von TP-Link ist die Belegung der Schnittstelle wie folgt (dicken weißen Balken an einem Ende des Anschlusses beachten):

[[File:tpl-uart.png|center|200px]]

Auf die Oberseite der Routerplatine (Bestückungsseite) wird nun die 4-polige Stiftleiste eingelötet. Das Ergebnis sieht dann wie im folgenden Bild aus:

[[File:tpl-stiftleiste.jpg|center|400px]]

== Vorbereitung des UART-USB-Konverters ==

Der UART-USB-Konverter dient der Verbindung des Routers über dessen [[https://de.wikipedia.org/wiki/Universal_Asynchronous_Receiver_Transmiter serielle UART-Schnittstelle]] mit einem Computer. Günstige Konverter auf Basis des Chips [[http://www.silabs.com/products/mcu/Pages/USBtoUARTBridgeVCPDrivers.aspx CP210x]] finden sich auf eBay.

[[File:tp-uart-konverter.jpg|center|400px]]

Das obige Bild zeigt einen Konverter auf Basis eines CP210x, an welchem ein passendes Adapter-Kabel aufgesteckt ist. Das Adapterkabel verbindet RX, TX und GND des seriellen Anschlusses des Routers mit dem Konverter. Hierbei ist zu beachten, daß RX des Konverters mit TX des Routers und TX des Konverters mit RX des Routers verbunden werden muß (Kreuzung). '''VCC wird nicht verbunden!'''

Die Schematik des Adapterkabels ist in folgender Abbildung dargestellt.

[[File:adapterkabel.png|center|150px]]

Viele der UART-USB-Adapter haben eine Stiftleiste. Es bietet sich also an, das Adapterkabel an beiden Enden mit passenden Buchsenleisten vorzusehen.

== Verbindung des Routers mit dem Computer ==

Der Router wird auf zweierlei Arten mit dem Computer verbunden:
* Mittels des UART-USB-Konverters zur Verbindung mit der Konsole des Bootloaders uboot
* Mittels Netzwerkkabel zur Übertragung der Firmware-Datei auf den Router via tftp-Protokoll.

'''UART-USB-Konverter'''

Ggf. ist für den UART-USB-Konverter ein passender Treiber für das jeweilige Betriebssystem des Computers zu installieren.

Den Router über das Adapter-Kabel und den Konverter mit dem USB-Port des Computers verbinden. Den Router zunächst nicht einschalten.

'''Ethernet-Kabel'''

Das Ethernet-Kabel wird am Router an einem der gelben Netzwerk-Ports angeschlossen sowie am Computer. Anschließend wird der Computer auf eine feste IP-Adresse konfiguriert.

[[File:router-computer.jpg|center|400px]]

=== Linux ===

==== Netzwerkeinstellungen und tftp-Server ====

Zunächst werden alle IP-Adressen des Ethernet-Devices des Computers zurückgesetzt und eine statische IP-Adresse gesetzt. Hierzu benötigt man den Device-Namen des Ethernet-Devices (z.B. eth0 oder enp0s25). Der Name läßt sich über das Kommando

# ifconfig

ermitteln. Für das Device (hier: eth0) werden dann zunächst alle IP-Adressen gelöscht und anschließend eine feste IP-Adresse (hier: 192.168.3.2/24) gesetzt:

# ip addr flush dev eth0
# ip addr add 192.168.3.2/24 dev eth0

Die korrekte Einstellung kann mit

# ifconfig

überprüft werden.

Für den tftp-Client und -Server empfiehlt sich das Paket atftp.

Jetzt wird ein Verzeichnis für den tftp-Server angelegt:

# mkdir /var/tftpd
# chown 777 /var/tftpd

Nun muß eine passende Firmware für den Router heruntergeladen werden - am besten gleich die passende [[http://images.freifunk-troisdorf.de/stable/factory/ Freifunk-Firmware]]. Bitte die genaue Angabe der Modellversion des Routers beachten und die Factory-Version der Firmware verwenden! Die Firmware-datei kann direkt in das tftp-Verzeichnis heruntergeladen werden und sollte aus praktischen Gründen einen kurzen Dateinamen haben (hier: firmware.bin):

# cd /var/tftpd
# wget <URL Firmware> -O firmware.bin

Jetzt muß der tftp-Server gestartet werden:

# atftpd --daemon /var/tftpd/

Ob der tftp-Server ordnungsgemäß funktioniert, kann man testen, indem man einen tftp-Client auf dem Computer startet und versucht, die Firmware-Datei herunterzuladen:

$ atftp 192.168.3.2
tftp> get firmware.bin
tftp>

Ggf. ist in der Firewall des Computers der UDP-Port 69 für den tftp-Server zu öffnen.

==== UART-USB-Konverter ====

Unter Linux kann das ordnungsgemäße Erkennen des Konverters überprüft werden, in dem man nach dem Einstecken in einen USB-Steckplatz in einem Terminalfenster den folgenden Befehl eingibt:

$ dmesg

Üblicherweise wird der Konverter als Schnittstelle /dev/ttyUSB0 erkannt. Es ist sicherzustellen, daß der jeweilige Benutzer Zugriff auf diese Schnittstelle hat.

Nun wird ein geeignetes Terminalprogramm benötigt. In einem grafischen System empfiehlt sich [[https://launchpad.net/gtkterm gtkTerm]], in einem textbasierten System [[https://help.ubuntu.com/community/Minicom minicom]].

==== gtkTerm ====

In gtkTerm sind die Verbindungsparameter unter Configuration --> Port wie folgt einzustellen:

* Port: /dev/ttyUSB0 (siehe Ausgabe von dmesg)
* Baud rate: 115200
* Parity: none
* Bits: 8
* Stopbits: 1
* Flow control: none

[[File:gtkterm.png|center|500px]]

Nun den Router anschalten. Es sollten lesbare Zeichen im Terminalprogramm erscheinen (Konsole von uboot).

Wenn nun die Meldung

Autobooting in 1 seconds

erscheint, schnell die Zeichen

tpl

eingeben, um den Bootvorgang zu unterbrechen. Nun setzen wir einige Parameter:

> setenv ipaddr 192.168.3.1
> setenv serverip 192.168.3.2

Die Einstellungen können mit

> printenv

überprüft und ggf. erneut gesetzt werden. Nun holen wir das Firmware-File vom tftp-Server:

> tftpboot 0x80000000 firmware.bin

Und jetzt schreiben wir das Image in den Flash-Speicher:

> erase 0x9f020000 +0x3c0000
...
> cp.b 0x80000000 0x9f020000 0x3c0000
> bootm 0x9f020000

Nach Eingabe des letzten Befehls bootet der Router (hoffentlich) in den Setup-Modus der Freifunk-Firmware.

Die statische IP-Adresse am Ethernet-Port des Computers kann nun entfernt werden

# ip addr flush dev eth0

und die Adresse wie gewohnt vom Router bezogen werden. Falls dies ordnungsgemäß funktioniert, kann nun auch der Konverter samt Adapter-Kabel vom Router entfernt werden.

=== Windows ===

Unter Windows ist das Vorgehen prinzipiell analog wie unter Linux. Im Gerätemanager ist zu klären, unter welcher COM-Schnittstelle der Konverter verfügbar ist. Als Terminalprogramm empfiehlt sich [[http://www.chiark.greenend.org.uk/~sgtatham/putty/ PuTTY]].

== Tipps ==

* Damit ein Benutzer in Linux Zugriff auf eine serielle Schnitstelle hat, muß dieser abhängig von der eingesetzten Linux-Distribution Mitglied in den Gruppen uucp, dialout bzw. tty sein.
* Das ordnungsgemäße Funktionieren von Terminalprogramm und Konverter kann man dadurch überprüfen, daß man RX und TX des Konverters mittels eines Drahtstücks kurzschließt (Loopback). Wenn man nun beliebige Zeichen in das Terminalprogramm eingibt, so erscheinen diese wiederum im Terminalprogramm. Ist im Terminalprogramm "lokales Echo" aktiviert, erscheinen die Zeichen doppelt.

== Links und Referenzen ==

* [[http://blog.flozz.fr/2013-07-14/debriquer-routeur-tp-link-tl-wr841nd/]]
* [[https://forum.openwrt.org/viewtopic.php?id=33906]]

Troisdorf-Unbricking

2015-07-28T17:18:18Z

Marconi: /* gtkTerm */