Diese Anleitung dient der Erstinstallation der Freifunk-Firmware auf Ubiquiti Unifi Geräten ausgehend von der Herstellerfirmware. Diese Anleitung wurde auf folgenden Modellen getestet: - Unifi AC Lite - Unifi AC Mesh - Unifi AC Pro Sie sollte grundsätzlich auf allen gängigen Unifi APs seit dem ersten 2.4 GHz AP funktionieren. Eine Ausnahme stellt hierbei die erste Generation der UniFi AC Modelle (eckiges Gehäuse) dar. ### 1. Mit dem Gerät verbinden Konfiguriere deinen Computer auf `192.168.1.100/24`. Verbinde dann mit dem Standardbenutzer `ubnt` (Passwort: `ubnt`) per SSH zum Router: ``` # ssh ubnt@192.168.1.20 ``` Hierbei kommt ggf. die Nachfrage, ob ein RSA-Hostkey gültig ist. Diese Frage ist in diesem Fall schlicht mit `yes` quittieren. ### 2. Freifunk-Firmware herunterladen Unter https://firmware.darmstadt.freifunk.net das jeweilige Modell auswählen und die Firmware herunterladen. Es gibt für die Unifi AC Reihe kein `factory` Image, sondern nur ein `sysupgrade` Image. ### 3. Firmware hochladen Eine weitere Konsole auf dem lokalen Computer öffnen, in den Download-Ordner wechseln und von dort die Freifunk-Firmware per SCP hochladen. ``` # scp firmware.bin ubnt@192.168.1.20:/tmp ``` ### 4. Firmware flashen In die Konsole mit der laufenden SSH-Verbindung mit dem Router wechseln und dort das Firmware-Image nach `kernel0` und `kernel1` schreiben: Dazu ist es zunächst notwendig die Partitionskennung von `kernel0` und `kernel1` herauszufinden: ``` # grep kernel /proc/mtd mtd2: 00790000 00010000 "kernel0" mtd3: 00790000 00010000 "kernel1" ``` In diesem Beispiel sind dies die Partionen *mtd2* und *mtd3*. Im folgenden Schritt kopieren wir die Firmware nun also nach `/dev/mtdblock2` und `/dev/mtdblock3`. Diese Nummerierung kann je nach Gerät abweichen. ``` # dd if=/tmp/firmware.bin of=/dev/mtdblock2 # dd if=/tmp/firmware.bin of=/dev/mtdblock3 ``` ### 5. Bootselect schreiben Nun die mtd Partition mit dem Label `bs` ausfindig machen und ein Nullbyte an den Anfang der Partition schreiben: ``` # grep bs /proc/mtd mtd4: 00020000 00010000 "bs" # dd if=/dev/zero bs=1 count=1 of=/dev/mtdX ``` In der Regel ist die gesuchte Partition `/dev/mtd4`, das sollte aber durch den obigen Schritt sichergestellt werden. ### 6. Neustarten Danach den Router neustarten, woraufhin die in Freifunk-Firmware gestartet wird. ``` # reboot ``` Während dem Bootvorgang blinkt das Gerät weiß, wenn es dauerhaft weiß leuchtet ist der Router fertig gestartet. ### 7. Config Mode Der Router ist nun im Config Mode, und unter `192.168.1.1` erreichbar. Er verteilt IP-Adressen via DHCP, damit deinem Computer automatisch eine passende Adresse zugeteilt wird. Starte nun die Konfiguration: http://192.168.1.1/ Für den Fall, dass du einen Unifi AP Mesh oder Mesh Pro installierst so sollte der Haken für den Betrieb im Außenbereich gesetzt sein.