Flashen von Ubiquiti UniFi AC Geräten mit Firmwareloader
Access Points wie der „UniFi AP AC Pro“ und „UniFi AC Mesh“ von Ubiquiti sind seit vielen Jahren beliebte Modelle für Freifunk Installationen.
Wie alle Freifunk Router bzw. Freifunk Access Points müssen diese zuerst von der Hersteller Firmware, auf unsere Freifunk Firmware „geflasht“ werden. Das übliche Verfahren über ein Update in der Web Oberfläche ist hier leider nicht möglich. Wir benötigen somit ein spezielles Tool um die Freifunk Firmware auf diese Geräte zu bekommen.
Folgende Geräte sind von diesem Vorgang unterstützt:
- Ubiquiti UniFi AP AC PRO
- Ubiquiti UniFi AP AC Mesh
- Ubiquiti UniFi AP AC Mesh PRO
- Ubiquiti UniFi AP AC Lite
- Ubiquiti UniFi AP AC LR
Vorbereitung
Benötigt werden:
- Der Access Point
- Ein PoE-Injektor (alternativ PoE Switch)
- Ein PC/Laptop mit LAN Port (auch USB auf LAN Adapter möglich)
- Zwei LAN Kabel
Der Access Point muss aus dem UniFi Controller entfernt oder extern über den Reset-Knopf zurückgesetzt sein.
Achtung: Bitte besonders vorsichtig mit dem Reset-Knopf des UAP-AC-Mesh umgehen! Dieser ist rein durch eine Lötverbindung gehalten, die leider sehr klein dimensioniert ist und gerne abbricht. Die Reset-Taste muss für 10 Sekunden gedrückt gehalten werden. Damit setzt sich der AP zurück.
Zunächst lädt man die erforderlichen Dateien herunter.
Die Freifunk Firmware für den Access Point:
https://download.freifunk-nordhessen.de
Das Tool zum Einspielen der Firmware:
https://codeberg.org/pitch/firmwareloader_uap_ac_pro/releases
Den Firmwareloader hat eine Person aus der Freifunk Community entwickelt und wird von uns als Vertrauenswürdig eingestuft. Den Download findet man unter der Version v1.0.1 unter Downloads. Wählen Sie die Datei die zu ihrem PC und Betriebssystem passt.
Freifunk Firmware flashen
Der AP wird an einen PoE Injektor oder Switch angeschlossen und der Rechner muss genauso an dieses Netzwerk angeschlossen werden. Von hier an ist ein separates Netzwerk oder eine direkte Verbindung zum PoE Injektor Pflicht, da der AP sich sonst eine andere IPv4-Adresse bezieht.
Den LAN Netzwerkport des Rechners konfiguriert man auf:
IPv4-Adresse: 192.168.1.150
Subnetzmaske: 255.255.255.0
Gateway kann frei bleiben
Tool ausführen und AP flashen
Gehen Sie in ihrem Dateimanager zu dem Ordner in dem die beiden heruntergeladen Dateien liegen. Mit der rechten Maustaste auf den Ordner geklickt, wählen Sie “In Terminal öffnen” aus.
Mit dem nun geöffneten Terminal, muss das heruntergeladene Tool ausführbar gemacht werden.
(Text kopieren, einfügen und mit der Enter-Taste starten)
chmod +x firmwareloader-linuxNun lässt sich der Firmwareloader ausführen.
(Text kopieren, einfügen, “DATEINAME” durch passende Firmware Datei ersetzen und mit der Enter-Taste starten)
./firmwareloader-linux -f DATEINAME.binÖffnen Sie das Terminal.
Gehen sie dort in den Ordner, in dem die beiden heruntergeladen Dateien liegen.
(Text kopieren, einfügen und mit der Enter-Taste starten)
cd ~/Downloads
Das heruntergeladene Tool muss zuerst ausführbar gemacht werden.
(eines der beiden kopieren, einfügen und mit der Enter-Taste starten)
chmod +x firmwareloader-macOS-armoder
chmod +x firmwareloader-macOS-intelNun lässt sich der Firmwareloader ausführen.
(eines der beiden kopieren, einfügen, “DATEINAME” durch passende Firmware Datei ersetzen und mit der Enter-Taste starten)
./firmwareloader-macOS-arm -f DATEINAME.binoder
./firmwareloader-macOS-intel -f DATEINAME.binÖffnen Sie im Windows Explorer das Downloads-Verzeichnis und klicken Sie mit gedrückter Umschalt-/Shift-Taste mit der rechten Maustaste auf einen freien Bereich neben den Dateien. Hier klicken Sie je nach Windows-Version auf „Im Terminal öffnen“ oder „PowerShell öffnen“ oder „Eingabeaufforderung öffnen“.
In der neu geöffneten Kommandozeile lässt sich nun der Firmwareloader ausführen.
(Text kopieren, einfügen, “DATEINAME” durch passende Firmware Datei ersetzen und mit der Enter-Taste starten)
.\firmwareloader-win.exe -f DATEINAME.binDamit sollte der Knoten vollautomatisch mit der Freifunk Firmware bespielt werden.
Ersteinrichtung
Nach ca. 2-10 Minuten kommt der AP wieder erreichbar und kann an der Kabelschnittstelle über die URL http://192.168.1.1 angesprochen werden.
Wichtig: Das „http://“ bitte nicht weglassen! Moderne Browser probieren oft zuerst via HTTPS, dann ist die Oberfläche unerreichbar.
Von dort an kann man unsere generische Anleitung zum Konfigurieren des Knotens verwenden:
Nach der Konfiguration kann der AP vom Kabel getrennt und mit einem an das Internet verbundene Netzwerk angeschlossen werden.
Damit ist der Freifunk Knoten fertig eingerichtet und kommt binnen wenigen Minuten online!
Nicht vergessen: Den Netzwerkport des Rechners zurück auf automatischen Bezug von IP-Adressen mittels DHCP zu stellen.
The text of this work is marked CC0 1.0
