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.

▷ Klone dieses Repository über Git:

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

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

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

▷ Installiere ggf. fehlende Werkzeuge zum Kompilieren von rpiboot, z. B. make:

sudo apt install make

▷ 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.

▷ Fahre den RevPi herunter.

▷ Trenne den RevPi von seiner Spannungsversorgung ab.

3. rpiboot starten #

  • Windows

  • Linux

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

▷ Starte rpiboot.exe.

Die Raspberry Pi Foundation 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:

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 #

▷ Verbinde den RevPi über das USB-Datenkabel mit deinem PC.

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

❯ Der RevPi startet nun im Bootloader-Modus.

❯ 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-Image 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.

  • rpiboot auf dem Host-PC starten.

  • USB-Datenkabel anschließen.

  • 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.

Windows verwendet falschen Treiber.

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

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.