Unterschiede
Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
Beide Seiten der vorigen Revision Vorhergehende Überarbeitung Nächste Überarbeitung | Vorhergehende Überarbeitung | ||
knb:acmesh [2019/07/29 15:59] – [Tipp:] sunny | knb:acmesh [2020/06/09 17:02] (aktuell) – Externe Bearbeitung 127.0.0.1 | ||
---|---|---|---|
Zeile 1: | Zeile 1: | ||
- | ====== Flashen eines UNIFY UAP AC MESH PRO ====== | + | ====== Flashen eines Ubiquity UniFi Access Point (UAP) AC MESH PRO ====== |
{{: | {{: | ||
+ | |||
+ | |||
+ | |||
Zeile 9: | Zeile 12: | ||
/2/ https:// | /2/ https:// | ||
/3/ https:// | /3/ https:// | ||
- | /4/ https:// | + | /4/ https:// |
- | /5/ https:// | + | {{anchor: |
Auf diese Quellen wird nachfolgend mit den voranstehenden Nummern in Slashes Bezug genommen. | Auf diese Quellen wird nachfolgend mit den voranstehenden Nummern in Slashes Bezug genommen. | ||
Zeile 16: | Zeile 19: | ||
---- | ---- | ||
===== Tipp: ===== | ===== Tipp: ===== | ||
- | 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: [[https:// | + | 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: [[https:// |
+ | |||
+ | * UAP AC MESH PRO mit gerückter RESET-Taste einschalten\\ | ||
+ | * RESET-Taste gedrückt halten, bis LED abwechselnd blau-weiß-aus blinkt (ca. 20s, jetzt haben wir den "TFTP RECOVERY MODE" erreicht)\\ | ||
+ | * Auf dem Computer den LAN-Anschluß auf statische IP mit IP: 192.168.1.100 und NETMASK: 255.255.255.0 konfigurieren.\\ | ||
+ | * Den Computer mit dem LAN-Anschluß " | ||
+ | * Mit einem geeignet TFTP CLIENT die Stock-FW wieder aufspielen, hierzu folgende Parameter((detailliertere Beschreibung hierzu für LINUX, MAC OS und WINDOWS siehe unten unter Punkt "// | ||
+ | * '' | ||
+ | * '' | ||
+ | * Nach dem TFTP 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: | ||
+ | * '' | ||
+ | * '' | ||
+ | |||
+ | ===== I. Einleitung und Hinweise: ===== | ||
+ | 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 **MTD**((**M**emory **T**echnology **D**evices; | ||
+ | |||
+ | Vor dem Flashen muss unbedingt darauf geachtet werden, dass die vorinstallierte originale Ubiquity Firmware (Stock-FW) die Version 3.7.58 ist! Gemäß **[[# | ||
+ | |||
+ | Die UAP AC MESH PRO hat zwei Netzwerkanschlüsse: | ||
+ | |||
+ | 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. | ||
+ | |||
+ | <WRAP center round important 90%> | ||
+ | **__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 "// | ||
+ | </ | ||
- | - UAP AC MESH PRO mit gerückter RESET-Taste einschalten\\ | ||
- | - RESET-Taste gedrückt halten, bis LED abwechselnd blau-weiß-aus blinkt (ca. 20s, jetzt haben wir den "TFTP RECOVERY MODE" erreicht)\\ | ||
- | - auf dem Computer den LAN-Anschluß auf statische IP mit IP: 192.168.1.100 und NETMASK: 255.255.255.0 konfigurieren\\ | ||
- | - den Computer mit dem LAN-Anschluß " | ||
- | - mit einem geeignet TFTP CLIENT die Stock-FW wieder aufspielen, hierzu folgende Parameter verwenden: | ||
- | Adress: | ||
- | Password: ubnt | ||
- | </ | ||
- | - Nach dem TFTP 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: < | ||
- | ssh ubnt@192.168.1.20 | ||
- | Passwort: ubnt</ | ||
---- | ---- | ||
+ | ===== II. Prüfen der auf der UAP AC MESH PRO vorinstallierten Stock-Firmware: | ||
+ | |||
+ | Auf dem Computer den LAN-Anschluß auf statische IP konfigurieren mit: | ||
+ | * '' | ||
+ | * '' | ||
+ | Den Computer mit dem LAN-Anschluß " | ||
+ | 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 "// | ||
+ | |||
+ | Wenn die angegebene Versionsnummer eine Andere als 3.7.58 ist, bitte vor dem Flashen der FF-FW mit dem nachfolgenden Punkt "// | ||
+ | |||
+ | Dieses Terminalfenster kann nun wieder geschlossen werden. | ||
+ | |||
+ | ---- | ||
+ | ===== III. Durchführen eines up/ | ||
+ | |||
+ | ==== III.1. Ubiquity Stock-FW Version 3.7.58 herunterladen: | ||
+ | |||
+ | Auf die Downloadseite von Ubiquity https:// | ||
+ | Dort in der linken Spalte unter " | ||
+ | Zur Vereinfachung der folgenden Schritte die Firmware-Datei umbenennen in " | ||
+ | |||
+ | ==== III.2. Ubiquity Stock-FW Version 3.7.58 auf die UAP AC MESH PRO aufspielen: ==== | ||
+ | \\ | ||
+ | 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ß " | ||
+ | \\ | ||
+ | Wie nachfolgend beschrieben für **[[# | ||
+ | * '' | ||
+ | * '' | ||
+ | \\ | ||
+ | {{anchor: | ||
+ | cd / | ||
+ | </ | ||
+ | Dort folgende Kommandos eingeben: | ||
+ | < | ||
+ | tftp 192.168.1.20 | ||
+ | binary | ||
+ | rexmt 1 | ||
+ | timeout 60 | ||
+ | trace | ||
+ | put firmware.bin | ||
+ | </ | ||
+ | |||
+ | {{anchor: | ||
+ | In das Eingabe-Fenster von "TFTP CLIENT" | ||
+ | * '' | ||
+ | * '' | ||
+ | * '' | ||
+ | Mit Klick auf den Button " | ||
+ | \\ | ||
+ | {{anchor: | ||
+ | Hier gibt es beispielsweise die Software " | ||
+ | In das Eingabe-Fenster von " | ||
+ | * '' | ||
+ | * '' | ||
+ | * '' | ||
+ | Mit Klick auf den Button " | ||
+ | \\ | ||
+ | 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 "// | ||
+ | Dann kann mit Punkt "// | ||
+ | \\ | ||
+ | ==== IV. Flashen der Freifunk-Firmware auf die UAP AC MESH PRO: ==== | ||
+ | \\ | ||
+ | === IV.1. Freifunk-Firmware für die UAP AC MESH PRO herunterladen: | ||
+ | Auf der Seite von z.B. Freifunk München https:// | ||
+ | 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) " | ||
+ | \\ | ||
+ | \\ | ||
+ | === 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 " | ||
+ | cd / | ||
+ | </ | ||
+ | Kopieren der " | ||
+ | < | ||
+ | scp firmware.bin ubnt@192.168.1.20:/ | ||
+ | </ | ||
+ | * '' | ||
+ | \\ | ||
+ | |||
+ | === 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ß " | ||
+ | Ein Terminalfenster öffnen und per ssh-Zugriff mit der UAP AC MESH PRO verbinden ('' | ||
+ | < | ||
+ | ssh ubnt@192.168.1.20 | ||
+ | </ | ||
+ | Folgende Befehle eingeben: | ||
+ | < | ||
+ | mtd write / | ||
+ | mtd write / | ||
+ | </ | ||
+ | |||
+ | 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 " | ||
+ | \\ | ||
+ | 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=/ | ||
+ | </ | ||
+ | \\ | ||
+ | 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.\\ | ||
+ | \\ | ||
+ | <WRAP center round alert 90%> | ||
+ | <fs large> | ||
+ | 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: | ||
+ | </ | ||
+ | \\ | ||
+ | ==== V. UAP AC MESH PRO im Config-Mode einrichten: ==== | ||
+ | \\ | ||
+ | Auf dem Computer den LAN-Anschluß auf DHCP und automatische IP konfigurieren.\\ | ||
+ | \\ | ||
+ | <WRAP center round important 95%> | ||
+ | <fs large> | ||
+ | Das PoE-Adapter bleibt mit dem " | ||
+ | NUR den Computer mit dem LAN-Anschluß " | ||
+ | </ | ||
+ | \\ | ||
+ | Der Computer erhält nun eine Netzwerkadresse per DHCP von der UAP AC MESH PRO, dies kann ein paar Sekunden dauern.\\ | ||
+ | \\ | ||
+ | <WRAP center round tip 95%> | ||
+ | <fs large> | ||
+ | Der Config-Mode mit DHCP steht nur am " | ||
+ | </ | ||
+ | \\ | ||
+ | Das GUI des Config-Modes ist nun über ein Browser-Fenster mit der Adresse 192.168.1.1 zu erreichen.\\ | ||
+ | \\ | ||
+ | Einrichten im Config-Mode gemäß der Anleitung der jeweiligen regionalen Freifunkgruppe.\\ | ||
+ | Für die Freifunkgruppe München findet man die Anleitung hier im WIKI: **[[knb: | ||
+ | |||
+ | \\ <WRAP center round tip 95%>< | ||
+ | Im Config-Mode auch einen SSH-Schlüssel hinterlegen. Dies ist auf jedenfall notwendig, falls eine Anwendung im Außenbereich (Outdoor) geplant ist, denn die dafür nötigen Einstellungen sind nur per ssh-Zugriff auf die Konsole der UAP AC MESH PRO möglich und die Konsole ist nur per ssh erreichbar. | ||
+ | </ | ||
+ | |||
+ | Eine Beschreibung für das Arbeiten per ssh auf der Konsole befindet sich z.B. hier im WIKI: **[[knb: | ||
+ | \\ | ||
+ | Jeweilige Beschreibungen für die Erstellung eines SSH-Schlüsselpaares findet man z.B. hier: | ||
+ | \\ | ||
+ | MAC OS (engl.):\\ https:// | ||
+ | \\ | ||
+ | WINDOWS (dt.):\\ https:// | ||
+ | \\ | ||
+ | LINUX/Mac OS (dt.):\\ https:// | ||
+ | \\ | ||
+ | \\ | ||
+ | ==== VI. UAP AC MESH PRO für den Einsatz im Außenbereich (Outdoor) einrichten: ==== | ||
+ | \\ | ||
+ | === VI.1. Hinweise: === | ||
+ | Eine Anleitung für den ssh-Zugriff auf die Konsole findet man hier im WIKI unter **[[knb: | ||
+ | \\ | ||
+ | Hinweis für die uci-Parameter: | ||
+ | * '' | ||
+ | * '' | ||
+ | \\ | ||
+ | === VI.2. DFS-Mode aktivieren: === | ||
+ | Per ssh auf der Konsole anmelden und folgendes Eingeben: | ||
+ | < | ||
+ | uci set gluon-core.@wireless[0].preserve_channels=' | ||
+ | uci commit gluon-core | ||
+ | uci set wireless.radio0.channel=' | ||
+ | uci set wireless.radio0.channels=' | ||
+ | uci set wireless.mesh_radio0.disabled=' | ||
+ | uci commit wireless | ||
+ | wifi | ||
+ | reboot | ||
+ | </ | ||
+ | \\ | ||
+ | Dadurch werden folgende Parameter des Gerätes für den Outdoorbetrieb eingerichtet: | ||
+ | * Es werden eine Reihe von Outdoor-Kanälen konfiguriert | ||
+ | * Auf diesen ist DFS erforderlich, | ||
+ | * Zusätzlich wird das Meshing auf 5 GHz deaktiviert, | ||
+ | \\ | ||
+ | \\ | ||
+ | === VI.3. Sendeleistung einstellen: === | ||
+ | \\ | ||
+ | == VI.3.a. 5GHz: == | ||
+ | Die Bundesnetzagentur bestimmt die zulässige Sendeleistung für WLan-Anwendungen im Bereich 5GHz gemäß Vfg. 151/2018 "// | ||
+ | \\ | ||
+ | Für die Kanäle 100 bis 140 (5500 MHz bis 5700 MHz), die wir zuvor unter Punkt "// | ||
+ | |||
+ | Sendeleistung für 5GHz auf 22dBm in der Konsole einstellen: | ||
+ | < | ||
+ | uci set wireless.radio0.txpower=22 | ||
+ | uci commit | ||
+ | wifi | ||
+ | reboot | ||
+ | </ | ||
+ | \\ | ||
+ | == 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 "// | ||
+ | \\ | ||
+ | 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: \\ '' | ||
- | **//coming soon ... //** FIXME | + | Sendeleistung für 2.4GHZ auf 12dBm einstellen: |
+ | < | ||
+ | uci set wireless.radio1.txpower=12 | ||
+ | uci commit | ||
+ | wifi | ||
+ | reboot | ||
+ | </ | ||
+ | \\ | ||
+ | \\ | ||
+ | \\ | ||
+ | ---<fs small>< |