Flashen-von-Ubiquiti

Nette Anleitung von Freifunk Magdeburg CC BY-SA 4.0 2016 Freifunk Magdeburg

Aktualisierung abgeschlossen am 26.6.2020

Flashen von Ubiquiti Routern

Kompatible Geräte

• Ubiquiti Bullet M2
• Ubiquiti Nanostation Loco M2 XM
• Ubiquiti Nanostation Loco M5 XM
• Ubiquiti Nanostation Loco M2 XW
• Ubiquiti Nanostation Loco M5 XW
• Ubiquiti Nanostation M2 XM
• Ubiquiti Nanostation M5 XM
• Ubiquiti Nanostation M2 XW
• Ubiquiti Nanostation M5 XW
• Ubiquiti Picostation M2 - nicht mehr erhältlich
• Ubiquiti Picostation M5 - nicht mehr erhältlich
• Ubiquiti Rocket M2
• Ubiquiti Rocket M5 Betrieb seit 17. Juni 2020 durch BNetzA verboten!
• Ubiquiti Unifi AP
• Ubiquiti Unifi AP LR
• Ubiquiti Unifi AP Pro
• Ubiquiti Unifi AP Outdoor

Schritt 1: Einloggen in das UBNT Gerät

Netzwerkeinstellungen des Rechners konfigurieren wie folgt:
    IP Adresse: 192.168.1.21
    Subnetzmaske: 255.255.255.0
anschließend das UBNT Gerät mit dem Rechner verbinden

(Achtung: nicht das Netzwerkkabel des Rechners in den PoE Port des UBNT Gerätes verbinden)

Browser öffnen und folgende IP Adresse eingeben: http://192.168.1.20 Auf der Startseite gibt man dem Gerät zuerst Benuternamen und ein password, default werte sind:

• User: ubnt
• Password: ubnt

Schritt 2: Auswählen der richtigen Firmware

Auf der Seite "Main" sieht man nun die Bezeichnung des Gerätes und auch die verwendete Hardwareversion sowie die aktuelle Firmwareversion. In unserem Beispiel:

• Model: Nanostation Loco M5
• Hardwareversion: XW (steht in Klammern hinter der Firmware)
• Firmwareversion: v.5.62 (XW)

Die Hardwareversion des Gerätes befindet sich i.d.R. nicht auf der Verpackung, sondern ist nur direkt in der Weboberfläche erkennbar.

Schritt 2a: Downgrad der AirOS Firmware

(Nutzer der Firmware 0.37 können diesen Schritt 2a direkt überspringen)

Bei Ubiquiti mit der Firmware AirOS XM.v5.6.X / XW.v5.6.X (oder neuer) kommt es zu Komplikationen. Ein direktes Einspielen der Freifunk Firmware ist NICHT MÖGLICH. Es ist notwendig, bevor man die Freifunk Firmware oder OpenWRT aufspielt, zuerst ein Firmwaredowngrade auf die Version AirOS XM.v5.5.X oder XW.v5.5.X durchzuführen. Ohne diesen Firmwaredowngrade WIRD DAS GERÄT NICHT BOOTEN!

Wenn dein Ubiquiti aktuell AirOS XM.v5.5.X oder AirOS XW.v5.5.X als Firmware verwendet, folge bitte diese Anleitung direkt ab dem Schritt 2b.

Je nach Hardwareversion deines Gerätes musst du nun die Firmware AirOS XM.v5.5.X oder AirOS XW.v5.5.X downloaden von der Herstellerseite.

• Download der Passenden Firmware AirOS XM.v5.5.X
• Download AirOS XM.v5.5.10-u2.28005.150723.1358.bin for: AG-HP-2G16, AG-HP-5G23, AG-HP-5G27, AirGrid M2, AirGrid M5, AR, AR-HP, BM2HP, BM2-Ti, BM5HP, BM5-Ti, LiteStation M5, locoM2, locoM5, locoM9, M2, M3, M365, M5, M900, NB-2G18, NB-5G25, NBM3, NBM365, NBM9, NS2, NSM3, NSM365, NSM5, PBM10, PBM3, PBM5, Power AP N
• Download AirOS XW.v5.5.10-u2.28005.150723.1358.bin, for: AG-HP-2G16, AG-HP-2G20, AG-HP-5G23, AG-HP-5G27, AirGrid M, AirGrid M2, AirGrid M5, locoM2, locoM5, locoM9, M2, M3, M365, M5, M900, NBE-M2-13, NBE-M5-16, NBE-M5-19, NSM2, NSM3, NSM365, NSM5, PBM3, PBM365, PBM5, RM2-Ti, RM5-Ti

Nachdem du die Firmware auf deiner Festplatte gespeichert hast, gehe nun zur Seite "System" und klicke auf den Buttom "Datei auswählen" oben rechts.

Hier wählst du nun das passende Image für dein Gerät aus, im Beispiel "AirOS XW.v5.5.10-u2.28005.150723.1358.bin"

Anschließend musst du für das Downgrade der Firmware auf AirOS XM.v5.5.X / AirOS XW.v5.5.X auf den Button "Absenden" klicken.

Jetzt wird die Firmware von deinem PC auf das UBNT Gerät geladen.

Mit dem klicken auf "Update" wird nun die Fireware geladen.

Der Updatevorgang dauert in der Regel 1-2 Minuten.

Schritt 2b: Einspielen der Freifunk Firmware

Wie bereits in Schritt 1 beschrieben musst du dich nach dem Eingeben der Logindaten unter der http://192.168.1.20 anmelden.

Auf der Seite "System" sieht man nun die Bezeichnung des Gerätes und auch die verwendete Hardwareversion sowie die aktuelle Firmwareversion. In unserem Beispiel:

• Model: Nanostation Loco M5
• Hardwareversion: XW (steht in Klammern hinter der Firmware)
• FirmwareversioN: v.5.5.10 (XW)

Mit dem oben rechts kann man nun die Freifunk-Firmware mit dem Button "Datei auswählen" hochladen.

Bitte beachte die Hardwareversion der Geräte. XM ist die Normale. Die passende Firmware findest du unter https://downloads.bremen.freifunk.net/firmware/stable/factory/.

Hier wählst du nun das passende Image für dein Gerät aus, als Beispiel "gluon-ffhb-2019.1.1+bremen3-ubiquiti-nanostation-loco-m5-xw.bin" für unsere Nanostation Loco M5 (XW).

Jetzt wird die Firmware von deinem PC auf das UBNT Gerät geladen.

Anschließend muss man mit dem klick auf "Update" das Einspielen der Freifunk Firmware bestätigen.

Der Updatevorgang dauert in der Regel 1-2 Minuten.

Schritt 3: Knoten konfigurieren

Nachdem die Freifunk Firmware erfolgreich eingespielt wurde, musst du nun deinen Freifunk Knoten konfigurieren.

Ubiquiti M-Serie/Flash-Anleitung kleine Ergänzung

Ein Update auf OpenWrt oder Gluon für Freifunk kann direkt über das Webinterface erfolgen. Das Gerät wird dazu über ein Netzwerkkabel direkt mit dem PC verbunden, der PC bekommt eine feste IP wie z.B. 192.168.1.100. Das Webinterface ist dann wie folgend erreichbar:

IP-Adresse: https://192.168.1.20
Benutzername: ubnt
Passwort: ubnt

Sollte das nicht funktionieren, kann das Gerät durch Drücken der Reset-Taste für etwa 10 Sekunden (bis die LEDs aufblinken) zurückgesetzt werden und ist dann unter dieser Adresse erreichbar.

Zu beachten ist, dass die airOS-Firmwareversion nicht neuer als v5.5.10 sein darf (Downgrade siehe unten!)

OpenWrtT/Gluon kann dann direkt über das Web-Interface über das factory-Image eingespielt werden. Firmware-Downgrade auf v5.5.10 (XM)

Vor dem Flashen von OpenWRT oder Gluon auf die Geräte muss zwingend ein Downgrade der airOS-Firmware auf v5.5.10 erfolgen. Möchte man dazu v5.5.10 direkt flashen, erhält man auf der Weboberfläche bei neuerer Firmware allerdings den Fehler "Firmware image check failed. Error code: 43". Dieser Code 43 erscheint wegen einer nichtsignierten Firmware. Ein Downgrade auf nichtsignierte Firmware ist nur über den Umweg einer Beta-Firmware möglich, sobald einmal eine signierte Firmware eingespielt wurde.

Ein Downgrade von z.B. v6.1.7 auf v5.5.10 kann in dieser Reihenfolge über das WebUI erfolgen (Per SSH ist übrigens genauso zwecklos, da gibt es ebenfalls Fehlermeldungen):

v6.0.6-beta https://www.ui.com/downloads/XN-fw-internal/v6.0.6/XM.v6.0.6-beta.30875.170526.0038.bin
v6.0.4 (unsigned) https://www.ui.com/downloads/XN-fw-internal/v6.0.4/XM.v6.0.4.30805.170505.1525.bin
v5.6.15 (unsigned) https://dl.ui.com/firmwares/XN-fw/v5.6.15/XM.v5.6.15.30572.170328.1107.bin
v5.5.10 (unsigned) https://www.ui.com/downloads/XN-fw-internal/v5.5.10/XM.v5.5.10.24241.141001.1649.bin

Von v5.5.10 lässt sich über das WebUI die Freifunk-, Gluon- oder andere OpenWrt-Firmware einspielen.