Dies ist eine alte Version des Dokuments!
Testseite Sunny
Sollte etwas beim Flashen schief gehen (Softbrick) kann man die UAP AC MESH PRO in einen „TFTP RECOVERY MODE“ versetzen und dann mittels TFTP mit der Stock-FW mit folgenden Schritten retten (siehe auch: UniFi-TFTP-Recovery-for-Bricked-Access-Points):
Das Überspielen von Firmware (FW) auf die Ubiquity UniFi Access Point (UAP) AC MESH PRO mittels TFTP funktioniert nur mit Ubiquity Stock-Firmware (Stock-FW). Daher kann die Freifunk-Firmware (FF-FW) leider nicht einfach mittels TFTP aufgespielt werden. Statt dessen ist es notwendig, ausgehend von einer geeigneten Stock-FW die FF-FW innerhalb eines SSH-Zugriffs mittels MTD2) zu überspielen, wie nachfolgend näher beschrieben wird.
Vor dem Flashen muss unbedingt darauf geachtet werden, dass die vorinstallierte originale Ubiquity Firmware (Stock-FW) die Version 3.7.58 ist! Gemäß /5/ führen Ubiquiti Firmware Versionen abwärts beim Aufspielen und Updaten mit unserer Freifunk Firmware (ab Version 0.9.4 / GLUON 2017.1.7) zum Soft-Brick! Ab neueren Versionen der Stock-FW von Ubiquity (3.8.6 und neuer) ist leider kein “MTD” mehr dabei und ein Flashen wird so unmöglich. Nachfolgend wird beschrieben, wie man die vorinstallierte FW auf der UAP AC MESH PRO prüfen und ggf.
up-/downgraden kann, um dann anschließend die FF-FW zu überspielen.
Die UAP AC MESH PRO hat zwei Netzwerkanschlüsse: „PRIMARY LAN“ und „SECONDARY LAN“. Es ist wichtig für die jeweiligen Schritte den Computer mit dem „passenden“ LAN-Anschluß zu verbinden, dies wird nachfolgend jeweils angegeben. Der PoE-Anschluß für die UAP AC MESH PRO ist der Anschluß „PRIMARY LAN“.
Bei den nachfolgenden Angaben von Befehlen, die in ein Terminalfester einzugeben sind, bezeichnet das Symbol :~# das Eingabeprompt im Terminalfenster und muss nicht mit eingegeben werden. Es soll damit veranschaulicht werden, dass man bis zur Eingabe dieses Befehls auf dieses Eingabeprompt warten soll.
WICHTIG:
Falls die UAP AC MESH PRO im Außenbereich (Outdoor) eingesetzt werden soll (wofür sie ja eigentlich auch gemacht ist) muss man nach der Einrichtung im Config-Mode für das WLan auf der Konsole per ssh-Zugriff noch einige Einstellungen hinsichtlich Erkennung von Flugradar (radar detect) ausführen (sogen. DFS Mode für 5GHz) und die Sendeleistung anpassen (5 GHz und 2.4 GHz). Dies wird am Ende dieser Anleitung unter dem Punkt „VI. UAP AC MESH PRO für den Einsatz im Außenbereich (Outdoor) einrichten“ beschrieben.
Auf dem Computer den LAN-Anschluß auf statische IP konfigurieren mit:
Den Computer mit dem LAN-Anschluß „PRIMARY LAN“ der UAP AC MESH PRO verbinden.
Terminalfenster öffnen und mittels ssh auf die UAP AC MESH PRO zugreifen
Im Idealfall sieht das Antwortprompt der UAP AC MESH PRO in dem Terminalfenster dann so aus:
BZ.v3.7.58#
D.h. es ist die Stock-FW von Ubiquity mit der Versionsnummer 3.7.58 installiert. Dann kann man mit dem nachfolgenden Punkt „IV. Flashen der Freifunk-Firmware auf die UAP AC MESH PRO“ fortfahren.
Wenn die angegebene Versionsnummer eine Andere als 3.7.58 ist, bitte vor dem Flashen der FF-FW mit dem nachfolgenden Punkt „III. Durchführen eines up/downgrades der UAP AC MESH PRO“ fortfahren.
Dieses Terminalfenster kann nun wieder geschlossen werden.
Auf die Downloadseite von Ubiquity https://www.ui.com/download/unifi/unifi-mesh/uap-ac-m gehen.
Dort in der linken Spalte unter „UniFi®Mesh“ die „UAP-AC-M-PRO“ anklicken, dann erscheint im Fenster rechts ganz oben die aktuelle Firmware-Version. Hier auf den Button „SEE PAST FIRMWARE“ klicken. In der nun aufklappenden Firmware-Liste sollte ganz unten die mit „UniFi firmware 3.7.58 for UAP-AC-Lite/LR/Pro/EDU/M/M-PRO/IW/IW-Pro“ bezeichnete Version 3.7.58 stehen. Diese Version 3.7.58 durch Klick auf das Download-Symbol ganz rechts herunterladen.
Zur Vereinfachung der folgenden Schritte die Firmware-Datei umbenennen in „firmware.bin“.
UAP AC MESH PRO mit gerückter RESET-Taste einschalten.
RESET-Taste gedrückt halten, bis LED abwechselnd blau-weiß-aus blinkt (ca. 20s).
Auf dem Computer den LAN-Anschluß auf statische IP konfigurieren mit:
Den Computer mit dem LAN-Anschluß „PRIMARY LAN“ der UAP AC MESH PRO verbinden.
Wie nachfolgend beschrieben für Linux, Mac OS und Windows mit einem geeignet TFTP CLIENT (Windows, Mac OS) oder mit „put“ (Linux) die Firmware „firmware.bin“ auf die UAP AC MESH PRO aufspielen, hierzu folgende Parameter verwenden:
Anleitung für Linux:
In den Ordner gehen, in dem die Datei „firmware.bin“ gespeichert ist (z.B. der Ordner Downloads):
cd /usr/Downloads
Dort folgende Kommandos nacheinander eingeben:
tftp 192.168.1.20
binary
rexmt 1
timeout 60
trace
put firmware.bin
Anleitung für Mac OS:
Hier gibt es z.B. die Software „TFTP CLIENT“ von Kem Tekinay unter https://apps.apple.com/de/app/tftp-client/id500493199?mt=12.
In das Eingabe-Fenster von „TFTP CLIENT“ folgendes Eintragen:
Mit Klick auf den Button „START“ die Übertragung ausführen.
Anleitung für Windows:
Hier gibt es beispielsweise die Software „tftp2.exe“. Diese kann man u.a. hier herunter laden: http://www.shadowsoftware.net/shadowgameworld/downloads/
In das Eingabe-Fenster von „tftp2.exe“ folgendes Eintragen:
Mit Klick auf den Button „UPGRADE“ die Übertragung ausführen.
Nach dem TFTP/put startet die UAP AC MESH PRO selbstätig neu und ist, sobald die LED dauerhaft weiß leuchtet, wieder unter der IP 192.168.1.20 für einen ssh-Zugriff erreichbar
Jetzt noch mal mit Punkt „II. Prüfen der auf der UAP AC MESH PRO vorinstallierten Stock-Firmware“ prüfen, ob die gewünschte Stock-FW erfolgreich aufgespielt wurde.
Dann kann mit Punkt „IV. Flashen der Freifunk-Firmware auf die UAP AC MESH PRO“ fortgefahren werden.
IV.1. Freifunk-Firmware für die UAP AC MESH PRO herunterladen:
Auf der Seite von z.B. Freifunk München https://firmware.ffmuc.net/stable/sysupgrade/
oder der entsprechenden Seite der regionalen Freifunkgruppe das Sysupgrade-Image für die UAP AC MESH PRO herunterladen.
Diese heißt z.B. für München (Stand 29. Juli 2019) „gluon-ffmuc-v2019.0.7-ubiquiti-unifi-ac-mesh-pro-sysupgrade.bin“.
Zur Vereinfachung der folgenden Schritte diese Datei umbenennen in „firmware.bin“.
IV.2. Sysupgrade-Image in den Speicher der UAP AC MESH PRO kopieren:
Auf dem Computer ein Terminalfenster öffnen und in den Ordner gehen, in dem die „firmware.bin“ gespeichert ist:
cd /home/USER/PFAD/ZUR/FIRMWARE.BIN
Kopieren der „firmware.bin“ in das /tmp Verzeichnis auf der UAP AC MESH PRO mit folgendem Befehl:
scp firmware.bin ubnt@192.168.1.20:/tmp/
IV.3. Freifunk-Firmware auf die UAP AC MESH PRO flashen:
Auf dem Computer den LAN-Anschluß auf statische IP konfigurieren mit
Den Computer mit dem LAN-Anschluß „PRIMARY LAN“ der UAP AC MESH PRO verbinden.
Ein Terminalfenster öffnen und per ssh-Zugriff mit der UAP AC MESH PRO verbinden (password: ubnt:
ssh ubnt@192.168.1.20
Folgenden Befehl eingeben:
mtd write /tmp/firmware.bin kernel0
Warten, bis das Eingabeprompt :~# wieder erscheint, das dauert etwas, dann den nächsten Befehl eingeben:
:~# mtd write /tmp/firmware.bin kernel1
Erneut warten, bis das Eingabeprompt :~# wieder erscheint.
Als nächstes müssen wir die MTD Partition mit dem Label “bs” ausfindig machen.
Hierzu eingeben:
:~# cat /proc/mtd | grep bs
Als Ausgabe erscheint z.B.:
mtd7: 00020000 00010000 “bs”
:~#
Wir merken uns die „7“ der Partition „mtd7“ bzw. diejenige Partitions-Zahl, die in der Zeile mit „bs“ hinter „mtd“ angezeigt wird.
Jetzt muss noch der Bootselect geschrieben werden. In dem nachfolgenden Befehl ist das
X bei mtdX durch die Partitions-Zahl zu ersetzen, die wir uns zuvor in Schritt 5. gemerkt haben. Vorliegend wäre also das X mit 7 zu ersetzen:
:~# dd if=/dev/zero bs=1 count=1 of=/dev/mtdX
Mit dem Befehl
:~# reboot
die UAP AC MESH PRO neu starten, wodurch der Flash-Vorgang initiiert wird.
Nach dem Flash-Vorgang befindet sich die UAP AC MESH PRO im config-Mode.
ACHTUNG ACHTUNG ACHTUNG
Die UAP AC MESH PRO startet während das Flash-Vorgangs mindestens zweimal neu. Hier heißt es Geduld haben (mind. 10-15 min (!)). Der Flashvorgang ist erst beendet, wenn die LED einige Minuten lang ohne Unterbrechung weiß leuchtet. IN DIESER ZEIT DARF DIE „UAP AC MESH PRO“ KEINESFALLS VON DER ELEKTRISCHEN ENERGIEVERSORGUNG GETRENNT WERDEN, SONST IST SIE GGF. GEBRICKT! (Falls es versehentlich doch passiert, nicht verzweifeln: Der TFTP RECOVERY MODE, wie oben beschrieben, funktioniert meist noch…)
Auf dem Computer den
LAN-Anschluß auf DHCP und automatische IP konfigurieren.
WICHTIG: Das PoE-Adapter bleibt mit dem „PRIMARY
LAN“ verbunden, um die UAP AC MESH PRO mit elektrischer Energie zu versogen.
NUR den Computer mit dem
LAN-Anschluß „SECONDARY
LAN“ der UAP AC MESH PRO verbinden.
(Wer ganz sicher gehen will, der nimmt für den Computer ein zusätzliches Lan-Kabel und lässt den Anschluß am „PRIMARY
LAN“ unangetastet.)
Der Computer erhält nun eine Netzwerkadresse per DHCP von der UAP AC MESH PRO, dies kann ein paar Sekunden dauern.
Hinweis: Der Config-Mode mit DHCP steht nur am „SECONDARY
LAN“-Anschluß zur Verfügung. Am „PRIMARY
LAN“-Anschluß ist die UAP AC MESH PRO nicht erreichbar.
Das
GUI des Config-Modes ist nun über ein Browser-Fenster mit der Adresse 192.168.1.1 zu erreichen.
-
-
VI.1. Hinweise:
VI.2. DFS-Mode aktivieren:
Per ssh auf der Konsole anmelden und folgendes Eingeben:
uci set gluon-core.@wireless[0].preserve_channels='1'
uci commit gluon-core
uci set wireless.radio0.channel='auto'
uci set wireless.radio0.channels='100-140'
uci set wireless.mesh_radio0.disabled='1'
uci commit wireless
wifi
reboot
Dadurch werden folgende Parameter des Gerätes für den Outdoorbetrieb eingerichtet:
VI.3. Sendeleistung einstellen:
VI.3.a. 5GHz:
VI.3.b 2.4GHz:
Die Bundesnetzagentur bestimmt die zulässige Sendeleistung für WLan-Anwendungen im Bereich 2.4 GHz gemäß Vfg 10/2013, geändert mit Vfg 64/2018 „Allgemeinzuteilung von Frequenzen für die Nutzung in lokalen Netzwerken; Wireless Local Area Networks (WLAN-Funkanwendungen)“. Diese Frequenzzuteilung ist befristet bis 31.12.2023.
Für die Kanäle 1 bis 14 (2412 MHz bis 2484 MHz; wir nutzen Kanal 6 mit 2437 MHz) ist die maximal zulässige Sendeleistung auf 100mW EIRP begrenzt, dies entspricht 20dBm. Die UAP AC MESH PRO hat bei 2.4GHz einen Antennegewinn von 8dBi. Somit können wir die Sendeleistung auf 12dBm einstellen:
12dBm Sendeleistung + 8dBi Antennengewinn = 20dBm EIRP
Sendeleistung für 2.4GHZ auf 12dBm einstellen:
uci set wireless.radio1.txpower=12
uci commit
wifi
reboot
Stand: Montag, 29. Juli 2019 18:00 Uhr
