KVM ueber USB OTG entbricken¶

In dieser Anleitung wird erklaert, wie Sie ein GL.iNet KVM-Geraet ueber USB OTG entbricken. Diese Methode eignet sich, wenn das KVM-Geraet gebrickt ist und nicht ueber ein normales Firmware-Update oder den U-Boot-Safe-Mode wiederhergestellt werden kann.

Unterstuetzte Geraete¶

RMQ1

Voraussetzungen¶

Bereiten Sie bitte die folgenden Werkzeuge vor, um das Geraet zu entbricken.

Ein Computer mit Windows, macOS oder Ubuntu

Hinweis

Verbinden Sie den RMQ1 nicht ueber seinen USB-C-Port mit einem Netzteil.
Sichern Sie vor dem Flashen der Firmware die Partition factory, um geraetespezifische Daten wie MAC-Adresse und Zertifikat zu erhalten. Wenn die Weboberflaeche weiterhin erreichbar ist, navigieren Sie bitte zu Toolbox -> Terminal -> Access und fuehren Sie den folgenden Befehl aus:
```
dd if=/dev/mtd6 of=/userdata/media/factory.bin
```
Die Sicherungsdatei erscheint unter Virtual Media und kann auf Ihren lokalen Computer heruntergeladen werden.
Trennen Sie das USB-C-Kabel zwischen RMQ1 und Computer waehrend der Wiederherstellung nicht. Andernfalls kann das Geraet beschaedigt werden.
Wenn das Geraet nach dem Flashen automatisch neu starten soll, navigieren Sie vor Beginn zu Settings -> Options -> Reboot to Normal Mode After Download und aktivieren Sie diese Option. Wenn diese Option nicht aktiviert ist, muessen Sie das Geraet nach Abschluss des Flashens manuell neu starten, d. h. das Stromkabel trennen und wieder anschliessen.

Schritte zum Entbricken¶

Windows¶

Laden Sie die U-Boot-Firmware fuer Ihr RMQ1-Geraet hier auf Ihren Computer herunter (waehlen Sie DOWNLOAD FOR USB OTG).
Installieren Sie die USB-Treiber:
- Laden Sie das Treiberpaket hier auf Ihren Computer herunter und entpacken Sie es in ein beliebiges Verzeichnis.
- Doppelklicken Sie auf die Datei DriverSetup.exe, um das Installationsprogramm auszufuehren.
Installieren Sie das AXDL-Tool.
- Laden Sie AXDL hier auf Ihren Computer herunter und entpacken Sie es in ein leicht erreichbares Verzeichnis.
- Doppelklicken Sie auf die Datei AXDL.exe, um das Flashing-Tool auszufuehren.
Oeffnen Sie das AXDL-Fenster, klicken Sie auf load.axp und waehlen Sie die in Schritt 1 heruntergeladene Firmware aus, um sie zu laden.

Klicken Sie auf Start downloading.
Schalten Sie Ihr KVM-Geraet aus. Halten Sie die RESET-Taste an der Unterseite des RMQ1 gedrueckt und verbinden Sie das Geraet mit dem mitgelieferten USB-C-Kabel mit Ihrem Computer.
Wenn in der Statusspalte Downloading... angezeigt wird, lassen Sie die RESET-Taste los.
Warten Sie, bis das AXDL-Tool Passed anzeigt. Damit wird bestaetigt, dass der Flashvorgang abgeschlossen ist.

macOS / Linux¶

Das offizielle AXDL-Tool ist nur fuer Windows verfuegbar. Unter macOS und Linux koennen Sie axdl-rs verwenden, einen quelloffenen, inoffiziellen Axera Image Downloader in Rust.

Installieren Sie die Rust-Toolchain ueber rustup
Laden Sie die U-Boot-Firmware fuer Ihr RMQ1-Geraet hier auf Ihren Computer herunter (waehlen Sie DOWNLOAD FOR USB OTG).
Installieren Sie die plattformspezifischen Abhaengigkeiten:
- Linux (Debian-basiert)
```
sudo apt install -y libudev-dev libusb-1.0-0-dev
```
  Konfigurieren Sie udev-Regeln, damit normale Benutzer auf das Geraet zugreifen koennen:
```
# Repository klonen
git clone https://github.com/gl-inet/axdl-rs.git

# In das Verzeichnis wechseln
cd axdl-rs

# udev-Regeldatei in das Systemverzeichnis kopieren
sudo cp 99-axdl.rules /etc/udev/rules.d/

# udev-Regeln neu laden, damit die Aenderungen wirksam werden
sudo udevadm control --reload
```
  Wenn der Benutzer nicht Mitglied der Gruppe plugdev ist, fuegen Sie ihn bitte der Gruppe hinzu und melden Sie sich danach erneut an, damit die Aenderung wirksam wird.
```
sudo usermod -a -G plugdev $USER
```
- macOS
  
  Installieren Sie libusb ueber brew, um die USB-Kommunikation mit KVM-Geraeten zu ermoeglichen:
```
brew install libusb
```
  Erstellen Sie das Tool axdl-cli
```
cargo build --bin axdl-cli --package axdl-cli
```
Geben Sie den folgenden Befehl ein, um die Firmware zu flashen. Ersetzen Sie /path/to/firmware.axp bitte durch den tatsaechlichen Pfad zu Ihrer heruntergeladenen Firmwaredatei.
```
cargo run --bin axdl-cli --package axdl-cli -- --file /path/to/firmware.axp --wait-for-device
```
Das Tool zeigt Waiting for device to be ready an und wechselt in einen Wartezustand.
Schalten Sie Ihr KVM-Geraet aus. Halten Sie die RESET-Taste an der Unterseite des RMQ1 gedrueckt und verbinden Sie das Geraet mit dem mitgelieferten USB-C-Kabel mit Ihrem Computer.

Warten Sie, bis der Flashvorgang abgeschlossen ist.

Hinweis: Nach Abschluss des Flashens startet das Geraet moeglicherweise nicht automatisch neu. Fuehren Sie beim RMQ1 manuell einen Power Cycle durch (aus- und wieder einschalten), um die neue Firmware zu aktivieren.

Erwartete Ausgabe

Nach einem erfolgreichen Flashvorgang zeigt das Terminal die folgende Ausgabe an.

Hinweis: Compiler-Warnungen koennen gefahrlos ignoriert werden.

$ cargo run --bin axdl-cli --package axdl-cli -- --file glkvm-RMQ1-nand-1.8.1-0518-1779101289.axp --wait-for-device
warning: `axdl` (lib) generated 6 warnings
   Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.07s
   Running `target/debug/axdl-cli --file glkvm-RMQ1-nand-1.8.1-0518-1779101289.axp --wait-for-device`
Waiting for the device to be ready
Loading the AXP image configuration
Start download
Handshaking with the device
Downloading the flash downloaders
[00:00:03] [############################################################################]
Downloading the partition table
Skipping partition: FACTORY (excluded by default)
Downloading image DDRINIT
Downloading image UBOOT
Downloading image LOGO
Downloading image DTB
Downloading image KERNEL
Downloading image RECOVERY
Downloading image MEDIA
Downloading image ROOTFS
[00:00:26] [############################################################################]
Downloading image SPL
Done

Letztes Update: 20. August 2026