rpiboot (Raspberry Pi USB boot) ist ein Hilfsprogramm von Raspberry Pi, das ein Compute Module in den Bootloader-Modus versetzen kann. Dieser Zustand wird auch Device Mode genannt.

Im Bootloader-Modus wird der RevPi über eine USB-Verbindung vom Host-PC als externes Speichergerät erkannt. Damit lässt sich eine Image-Datei (.img) auf den RevPi übertragen, sodass er anschließend mit dem neuen Betriebssystem startet.

Du benötigst:

✓ RevPi Basismodul

✓ Host-PC (Windows oder Linux)

✓ Zugriff auf den RevPi ist hergestellt.

✓ USB-2.0-Datenkabel:

  • für RevPi Connect 5: Typ-A auf USB-C

  • für alle anderen RevPi Basismodule[1]: Typ-A auf Micro-USB

✓ Einen direkten Zugang zu deinem RevPi Basismodul, da die Image-Datei über das USB-Kabel von deinem PC auf den RevPi übertragen wird. Es ist nicht möglich, das Betriebssystem-Image über Fernzugriff zu installieren.

1. rpiboot auf dem Host-PC installieren #

Note

▷ Verwende immer die neueste Version von rpiboot, um sicherzustellen, dass die aktuellen Hardwareversionen unterstützt werden.

  • Windows

  • Linux

▷ Lade rpiboot_setup.exe herunter.

▷ Starte die .exe, um rpiboot über den Installationsassistenten auf deinem PC zu installieren. Verwende immer die neueste Version von rpiboot, d. h. ggf. musst du eine ältere Version deinstallieren.

▷ Installiere für Linux (Debian) folgende Abhängigkeiten:

sudo apt install git pkg-config build-essential libusb-1.0-0-dev

Das Paket build-essential enthält alle Werkzeuge zum Kompilieren, z. B. make und gcc. Wenn du eine andere Linux-Distribution verwendest, installiere die entsprechenden Pakete über deren Paketverwaltung.

▷ Klone das usbboot-Repository über Git:

git clone https://github.com/raspberrypi/usbboot

▷ Wechsle in das Verzeichnis usbboot:

cd usbboot

▷ Kompiliere das Programm:

make

❯ rpiboot steht danach im Verzeichnis usbboot zur Verfügung.

2. RevPi herunterfahren #

▷ Deaktiviere ggf. einen aktiven Hardware- oder Software-Watchdog, da dieser den Bootloader-Modus unterbrechen kann. Betrifft die Geräte:

▷ Fahre den RevPi herunter.

▷ Trenne den RevPi von seiner Spannungsversorgung ab.

▷ Schließe den RevPi über die Micro-USB- bzw. USB-C-Buchse an deinen PC an.

3. rpiboot starten #

  • Windows

  • Linux

▷ Öffne auf deinem PC das Verzeichnis, unter dem rpiboot installiert wurde.

▷ Starte rpiboot.exe.

Raspberry Pi entwickelt rpiboot kontinuierlich weiter. Daher können die Dateinamen der aktuellen Version von den hier genannten abweichen. Wähle ggf. die für deinen RevPi passende Variante, z. B. …​ CM5 für einen RevPi Connect 5.

❯ Ein Terminal öffnet sich auf deinem PC. Die Meldung Waiting for BCM…​ erscheint.

❯ rpiboot ist nun bereit und wartet auf den RevPi als externes Speichergerät.

▷ Starte rpiboot im Verzeichnis usbboot:

sudo ./rpiboot

❯ Die Meldung Waiting for BCM…​ erscheint.

❯ rpiboot ist nun bereit und wartet auf den RevPi als externes Speichergerät.

4. RevPi im Bootloader-Modus starten #

▷ Schließe die Spannungsversorgung wieder an den RevPi an.

❯ Der RevPi startet nun im Bootloader-Modus[2].

❯ rpiboot erkennt das Raspberry Pi Compute Module und lädt die erforderlichen Dateien, bis der RevPi auf deinem PC als externes Speichergerät angezeigt wird.

  • Windows

  • Linux

▷ Wähle Keine Aktion, um keine automatische Aktion für externe Speichergeräte zu aktivieren.

❯ Der RevPi erscheint im Explorer als neues Laufwerk, z. B. D:\.

▷ Prüfe, ob der RevPi als Blockdevice erkannt wurde:

lsblk

❯ Der RevPi erscheint als neues Blockdevice, z. B. /dev/sdX.

❯❯ Der RevPi steht nun im Bootloader-Modus bereit für das Sichern oder Aufspielen eines Betriebssystem-Images, siehe Betriebssystem neu installieren.

Fehlerbehebung #

Problem Ursache Lösung

RevPi wird nicht als externes Speichergerät erkannt.

Falsche Reihenfolge.

Achte unbedingt auf die richtige Reihenfolge:

  • RevPi von der Spannungsversorgung abtrennen.

  • USB-Datenkabel anschließen.Waiting for BCM…

  • rpiboot auf dem Host-PC starten.

  • RevPi wieder an die Spannungsversorgung anschließen.

Falsches USB-Kabel verwendet.

Verwende ein OTG-fähiges USB-Kabel, das Datenübertragung unterstützt. Ein Power-Only-USB-Ladekabel ist nicht geeignet.

Veraltete Version von rpiboot verwendet.

Deinstalliere rpiboot und installiere die neueste Version.

Falsche Version von rpiboot verwendet.

Unter Windows können mehrere Versionen von rpiboot zur Verfügung stehen. Verwende z. B. …​ CM5 für einen RevPi Connect 5.

Windows verwendet falschen Treiber.

Installiere manuell den Treiber WinUSB, z. B. über Zadig.

Standard-Bootdateien nicht für das Compute Module geeignet.

Starte rpiboot mit sudo ./rpiboot -d mass-storage-gadget64.

Bootloader-Modus bricht ab.

Hardware- oder Software-Watchdog ist aktiv.

Deaktiviere alle Watchdogs.

Fehlermeldung: TrustedPublisher.

Treiber-Signaturprüfung fehlgeschlagen.

Deaktiviere temporär die Treiber-Signaturprüfung, z. B. unter Windows beim Neustart über Taste F7 (erweiterte Starteinstellungen).

Keine Micro-USB-Schnittstelle am RevPi.

Dein Basisgerät ist ein RevPi Connect 5 oder ein RevPi Flat.

Verwende für RevPi Connect 5 die USB-C-Schnittstelle.
Der RevPi Flat ist manipulationssicher ausgelegt und besitzt keinen Micro-USB-Anschluss.


1. Der RevPi Flat wurde als manipulationssicheres Gerät konzipiert. Deshalb ist ein Micro-USB-Anschluss für das Flashen des Image nicht vorgesehen.
2. Solange das Micro-USB-/USB-C-Kabel angeschlossen ist, befindet sich der RevPi im Bootloader-Modus und kann nicht im Betriebs-Modus gestartet werden.