Google-Suche erfordert Ihre Zustimmung für die Kategorie Funktionell.

In folgenden Fällen kann es erforderlich sein, dein RevPi Basismodul zu flashen, also das gesamte Betriebssystem neu zu installieren:

  • Wenn ein Versions-Upgrade erforderlich ist, z. B. von RevPi Bookworm auf RevPi Trixie.

  • Wenn das System durch zahlreiche manuelle Änderungen instabil geworden ist.

  • Bei unlösbaren Abhängigkeitsproblemen.

  • Wenn das System nicht mehr bootfähig ist, z. B. bei kritischen Systemfehlern (Kernel Panic) nach fehlgeschlagenen Updates.

Mit dem Befehl cat /etc/revpi/image-release erfährst du, welche Image-Version aktuell auf deinem RevPi installiert ist, siehe Geräteinformation abfragen.

In den Release Notes findest du Breaking Changes, Bug-Fixes, Sicherheitspatches und Systemvoraussetzungen, die für die Migration und Kompatibilität deiner bestehenden Installation relevant sind.

Voraussetzungen #

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.

Benötigte Software

  • Windows

  • Linux

✓ ein Imager-Programm, z. B. Raspberry Pi Imager (ab Windows 10) oder
Win32 Disk Imager (ermöglicht direkte Backup-Speicherung)

✓ ein Verifikationstool, z. B. gpg4win mit Kleopatra

✓ das USB-Boot-Hilfsprogramm rpiboot

✓ ein Imager-Programm, z. B. Raspberry Pi Imager

✓ ein Verifikationstool, z. B. GPG

✓ das USB-Boot-Hilfsprogramm rpiboot

1. RevPi im Bootloader-Modus starten #

▷ Deaktiviere ggf. den Watchdog.

Betrifft die Geräte RevPi Connect 5, RevPi Connect 4, RevPi Connect S und RevPi Flat S.

▷ Fahre den RevPi herunter und trenne ihn von der Spannungsversorgung ab.

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

▷ Starte rpiboot auf deinem PC.

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

❯ rpiboot erkennt das Gerät und lädt die erforderlichen Dateien, bis der RevPi als Wechseldatenträger angezeigt wird, z. B. als D:\.

Siehe auch: Bootloader-Modus mit rpiboot

2. Backup erstellen #

▷ Sichere ein Backup deiner bestehenden System-Installation als Image ab, siehe Backup erstellen.

3. Neues Image herunterladen und prüfen #

▷ Lade das neue Betriebssystem-Image herunter.

▷ Entpacke das Image-Paket (.zip).

Das Paket enthält u. a.:

  • das Image in einer Datenträgerimagedatei (.img)

  • die MD5-Datei (.md5sum.txt)

  • die Image-Signatur-Datei (.img.asc)

  • Windows

  • Linux

▷ Installiere das Verifikationstool gpg4win und starte die Anwendung Kleopatra.

▷ Erzeuge ein neues Schlüsselpaar, falls noch nicht vorhanden.

▷ Lade den RevPi GPG-Release-Schlüssel herunter.

▷ Entpacke, importiere und beglaubige den Schlüssel (.asc) in Kleopatra.

▷ Wähle Decrypt/Verify.

▷ Wähle die Image-Signatur-Datei (.img.asc) aus dem Image-Paket.

❯❯ Die Signatur wird geprüft.

  • Valid signature zeigt an, dass KUNBUS als Herausgeber erfolgreich verifiziert wurde.

  • Wird The files could not be verified angezeigt, muss das Image-Paket erneut heruntergeladen und geprüft werden.

▷ Installiere das Verifikationstool GPG auf deinem PC:

sudo apt install gnupg

▷ Lade den RevPi GPG-Release-Schlüssel herunter.

wget https://revolutionpi.com/fileadmin/downloads/gpg/revpi-public-key.zip

▷ Importiere den öffentlichen RevPi Schlüssel von KUNBUS mit:

gpg --import revpi-public-key.asc

▷ Prüfe die Signatur mit:

gpg --verify <.img.asc> <.img>

❯❯ Die Signatur wird geprüft.

  • Good signature zeigt an, dass KUNBUS als Herausgeber erfolgreich verifiziert wurde.

  • Wird Bad signature angezeigt, muss das Image-Paket erneut heruntergeladen und geprüft werden.

4. Neues Image installieren #

  • Windows

  • Linux

▷ Starte das Imager-Programm (hier: Raspberry Pi Imager).

▷ Wähle das passende Raspberry Pi-Modell aus, z. B. Raspberry Pi 5 für den RevPi Connect 5.

▷ Wähle als Betriebssystem aus: Eigenes Image.

❯ Der Dialog zum Auswählen einer Datei öffnet sich.

▷ Wähle die neue Image-Datei aus (.img) und bestätige mit WEITER.

▷ Wähle als Speichermedium den RevPi, im Beispiel [D:\], und bestätige mit WEITER.

▷ Überprüfe alle Angaben noch einmal im Dialog Schreibe Image und bestätige mit SCHREIBEN.

▷ Bestätige den Schreibvorgang ein weiteres Mal mit ICH VERSTEHE. LÖSCHE UND SCHREIBE.

❯ Der Schreibvorgang beginnt. Das neue Image wird auf dem RevPi installiert. Der Vorgang kann einige Minuten dauern. Die Meldung Schreibvorgang beendet! erscheint.

▷ Bestätige die Meldung mit BEENDEN.

▷ Starte den Raspberry Pi Imager auf deinem PC:

rpi-imager

❯ Die Linux-GUI öffnet sich.

▷ Wähle Choose OS.

▷ Wähle Use custom.

▷ Wähle die neue Image-Datei aus (.img).

▷ Wähle unter Choose Storage als Speichermedium den RevPi.

▷ Wähle Write.

❯ Der Schreibvorgang beginnt. Das neue Image wird auf dem RevPi installiert. Der Vorgang kann einige Minuten dauern.

5. Initiales Geräte-Setup starten #

▷ Trenne den RevPi von der Spannungsversorgung ab.

▷ Entferne das USB-Kabel.

Note

Solange das Micro-USB-/USB-C-Kabel angeschlossen ist, befindet sich der RevPi im Bootloader-Modus und kann nicht im Betriebs-Modus gestartet werden.

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

❯ Der RevPi bootet zum ersten Mal nach der Neuinstallation[2].

Du benötigst nun wieder Zugriff auf das Gerät, mögliche Optionen sind:

  • via Cockpit

  • via SSH

  • via Desktop-Betrieb

▷ Rufe über einen Webbrowser revpi<Seriennummer>.local auf[3].
Alternativ kannst du die IP-Adresse des RevPi in den Webbrowser eingeben.

❯ Ggf. erscheint im Browser eine Sicherheitswarnung.

▷ Akzeptiere die Sicherheitsausnahme, um mit dem Login fortzufahren.

❯ Der Login-Bildschirm für Cockpit erscheint.

▷ Melde dich initial an mit:

  • Standardbenutzer: pi

  • Standardpasswort: revolutionpi (bis RevPi Bookworm: raspberry)

❯ Das Geräte-Setup startet automatisch[4].

▷ Wähle Neustart.

▷ Baue die SSH-Verbindung erneut auffootnote:hostname:

ssh pi@revpi<Seriennummer>.local

▷ Melde dich initial an mit:

  • Standardbenutzer: pi

  • Standardpasswort: revolutionpi (bis RevPi Bookworm: raspberry)

❯ Das Geräte-Setup startet automatisch[4].

▷ Starte den RevPi neu mit:

sudo reboot

▷ Melde dich initial an mit:

  • Standardbenutzer: pi

  • Standardpasswort: revolutionpi (bis RevPi Bookworm: raspberry)

❯ Das Geräte-Setup startet automatisch[4].

▷ Starte den RevPi neu mit:

sudo reboot

▷ Melde dich mit Benutzernamen pi und dem Gerätepasswort an.

❯❯ Das neue Image ist nun erfolgreich installiert.

▷ Installiere zeitnah alle Updates, um Sicherheitslücken zu schließen.

Mögliche Fehlerquellen #

Fehler Ursache Abhilfe

RevPi wird nicht als Laufwerk am PC erkannt.

Falsche Reihenfolge der Schritte

Die Reihenfolge der Schritte muss stimmen:

1. Spannungsversorgung am RevPi unterbrechen.
2. Micro-USB-Kabel anschließen.
3. rpiboot auf dem PC starten.
4. Spannungsversorgung am RevPi wiederherstellen.

Falsches USB-Kabel

Verwende ein USB-Kabel, das Daten übertragen kann. Reine Ladekabel sind nicht geeignet.

rpiboot nicht aktuell

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

rpiboot kann nicht installiert werden.

Trusted-Publisher-Fehler

Deaktiviere die Überprüfung der Treibersignatur.
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. Ab RevPi Trixie startet das Geräte-Setup bei Geräten mit HAT-EEPROM automatisch. Der Login nach dem Geräte-Setup erfolgt mit Benutzernamen pi und dem Gerätepasswort.
3. Bis RevPi Bookworm und bei Geräten ohne HAT-EEPROM lautet der Hostname revpi.local.
4. Bei Geräten ohne HAT-EEPROM muss die Ersteinrichtung manuell gestartet werden, siehe RevPi Geräte mit und ohne HAT-EEPROM.