Raspberry Pi Troubleshooting: ACT-LED-Blinkcodes, SSH-Reparatur & Spannungsdiagnose
Erstellt: 08.11.2026 Zuletzt aktualisiert: 08.11.2026
Management Summary: Wenn ein Raspberry Pi nicht startet, plötzlich abstürzt oder keine SSH-Verbindungen annimmt, stehen Einsteiger mangels Monitor oder Fehlermeldungen oft vor einem Rätsel. Die Hardware verfügt jedoch über eingebaute Diagnosewerkzeuge: Der Bootloader und die VideoCore-Firmware signalisieren Fehler bereits vor dem Betriebssystemstart über rhythmische Blinkmuster der grünen ACT-LED, während der Linux-Kernel Spannungseinbrüche und Überhitzung in internen Firmware-Registern protokolliert. Dieser Leitfaden dient als Erste-Hilfe-Kasten: mit präzisen Diagnose-Tabellen, SSH-Reparaturbefehlen und einem strukturierten Entscheidungsbaum für den Notfall.
-
ACT-LED-Blinkcodes
Die Signale des Bootloaders entschlüsseln: Fehlende
start.elf-Dateien, inkompatible OS-Versionen und defekte RAM-Chips auf einen Blick erkennen. -
SSH-Verbindungen reparieren
"Connection Refused" lösen, veraltete Host-Fingerprints bereinigen (
ssh-keygen -R) und die deutsche Tastaturlayout-Falle (Z vs. Y) umgehen. -
Unterspannungs-Telemetrie
Die Bitmaske von
vcgencmd get_throttleddecodieren, um Spannungseinbrüche durch ungeeignete Handy-Netzteile präzise nachzuweisen. -
SD-Karten-Notfallrettung
Verstehen, warum Speicherkarten in den schreibgeschützten Lock-Zustand wechseln, und Dateisystemfehler mit
fsckreparieren.
1. Die Blinkcodes der grünen ACT-LED decodieren
Beim Einschalten eines Raspberry Pi startet nicht sofort der Hauptprozessor, sondern zunächst der fest im Chip integrierte Bootloader und der VideoCore-Grafikchip. Diese prüfen die FAT32-Boot-Partition der microSD-Karte bzw. NVMe-SSD.
Tritt dabei ein Fehler auf, signalisiert die grüne ACT-LED einen wiederkehrenden Blinkcode:
%%{init: {'flowchart': {'wrappingWidth': 350}}}%%
flowchart TB
POWER["USB-C Stromversorgung anstecken"] --> PWR_CHECK{"Leuchtet rote PWR-LED konstant?"}
PWR_CHECK -->|"Nein (Flackert/Aus)"| BAD_POWER["Unterspannungsausfall!<br/>Netzteil durch offizielles 27W/15W Netzteil ersetzen."]
PWR_CHECK -->|"Ja (Konstant rot)"| ACT_CHECK["Muster der grünen ACT-LED prüfen"]
subgraph BootDiagnose["ACT-LED Diagnose"]
direction TB
OK_BOOT["Schnelles unregelmäßiges Flackern:<br/>Normaler Boot (Kernel startet)"]
BLINK_ERROR["Wiederkehrendes rhythmisches Blinken:<br/>Firmware POST-Fehler (Blinks zählen)"]
NO_CARD["Dauerhaft AN oder dauerhaft AUS:<br/>Bootloader kann Karte nicht lesen"]
OK_BOOT --> BLINK_ERROR --> NO_CARD
end
ACT_CHECK --> BootDiagnose
Die Bootloader-Blinktabelle
Zähle die Anzahl der schnellen grünen Blinkimpulse, die sich zwischen längeren Dunkelphasen wiederholen:
| Blink-Anzahl | Technische Bedeutung | Ursache & Sofortlösung |
|---|---|---|
| 3-mal Blinken | start.elf nicht gefunden |
Die FAT32-Boot-Partition ist nicht lesbar, beschädigt oder die Startdatei fehlt. Lösung: SD-Karte mit dem Raspberry Pi Imager neu beschreiben. |
| 4-mal Blinken | start.elf kann nicht starten |
Das installierte System-Image ist mit diesem Board-Modell inkompatibel (z. B. ein altes 32-Bit Buster-Image auf einem Pi 5). Lösung: Aktuelles 64-Bit Bookworm-Image verwenden. |
| 7-mal Blinken | Kernel-Image nicht gefunden | start.elf lief an, aber die Kernel-Datei (kernel8.img) fehlt in /boot/firmware/. |
| 8-mal Blinken | SDRAM-Fehler / nicht erkannt | Der fest verlötete LPDDR-Arbeitsspeicher hat den Power-On Self-Test (POST) nicht bestanden. Meist liegt ein physischer Defekt der Platine vor. |
| Dauerhaft langsames Blinken | Notabschaltung / System halt | Der SoC hat die thermische Notabschaltung erreicht oder das System wurde mit sudo poweroff sauber heruntergefahren. |
2. Typische SSH-Verbindungsprobleme beheben
Ein frisch geflashter Raspberry Pi, der normal bootet, kann Verbindungen dennoch verweigern. Hier sind die drei häufigsten Ursachen:
Problem 1: ssh: connect to host ... port 22: Connection refused
- Ursache: Der SSH-Dienst wurde beim Schreiben im Imager nicht aktiviert.
- Die Lösung ohne Neu-Flashen:
- SD-Karte entnehmen und in den Kartenleser deines Computers stecken.
- Das sichtbare FAT32-Laufwerk (beschriftet als
bootfsoderboot) öffnen. - Eine leere Textdatei mit dem exakten Namen
ssh(ohne jegliche Dateiendung wie.txt) erstellen. - Karte auswerfen, in den Pi stecken und starten. Beim Booten erkennt das System die Datei, aktiviert den OpenSSH-Server und löscht die Datei automatisch.
Problem 2: WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!
Wurde der Raspberry Pi neu aufgesetzt oder hat er eine IP-Adresse erhalten, die zuvor einem anderen Gerät gehörte, warnt dein Computer vor einem möglichen Angriff:
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@ WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED! @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
IT IS POSSIBLE THAT SOMEONE IS DOING SOMETHING NASTY!
Someone could be eavesdropping on you right now (man-in-the-middle attack)!
Offending key in /home/user/.ssh/known_hosts:42
- Ursache: Auf deinem PC ist noch der alte kryptografische Schlüssel hinterlegt.
- Die Lösung: Lösche den veralteten Schlüssel aus dem Cache deines PCs mit einem einzigen Befehl:
ssh-keygen -R rpi-server.local
# Oder alternativ über die IP-Adresse:
ssh-keygen -R 192.168.1.145
Verbinde dich danach erneut per ssh deinbenutzer@rpi-server.local und bestätige den neuen Schlüssel mit yes.
Problem 3: Permission denied (publickey,password)
- Ursache: Ein Vertipper beim Passwort durch die deutsche vs. englische Tastaturlayout-Falle.
- Wenn im Imager das Passwort auf einer deutschen Tastatur eingegeben wurde, der Pi im Hintergrund jedoch auf englisches Layout eingestellt war, sind die Tasten
ZundYvertauscht, und Sonderzeichen (-,_,!,?) liegen auf völlig anderen Tasten! - Lösung: Enthält dein Passwort ein
zodery, versuche beim Login das jeweils andere Zeichen einzugeben.
3. Unterspannungs-Diagnose: vcgencmd get_throttled
Bei unzureichender Spannung stürzt der Raspberry Pi nicht zwingend ab. Stattdessen drosselt der Stromsteuerungs-Chip (PMIC) die Taktraten und vermerkt das Ereignis in einem internen Firmware-Register.
Frage dieses Register per SSH ab:
%%{init: {'flowchart': {'wrappingWidth': 350}}}%%
flowchart TB
VAL["Hex-Wert: 0x50005"]
L16["Untere 16 Bit (Aktueller Zustand):<br/>Bit 0 (0x1) + Bit 2 (0x4)<br/>Aktuell: Unterspannung & Takt gedrosselt!"]
H16["Obere 16 Bit (Historische Ereignisse):<br/>Bit 16 (0x10000) + Bit 18 (0x40000)<br/>Vergangene Unterspannung seit Boot registriert!"]
VAL --> L16
L16 --> H16
Die Bitmasken-Werte decodiert
Der hexadezimale Rückgabewert ist ein 32-Bit-Feld: Die unteren 16 Bit beschreiben den aktuellen Zustand, die oberen 16 Bit protokollieren aufgetretene Ereignisse seit dem letzten Bootvorgang:
| Bit-Position | Hex-Maske | Bedeutung | Ursache & Lösung |
|---|---|---|---|
| Bit 0 | 0x1 |
Unterspannung liegt aktuell an (< 4,63V) |
Netzteil bricht ein. Durch offizielles 27W/15W Netzteil ersetzen. |
| Bit 1 | 0x2 |
CPU-Takt aktuell gedrosselt (> 80°C) |
Prozessor wird zu heiß. Aktiven Lüfter oder Kühlkörper montieren. |
| Bit 2 | 0x4 |
Hard-Throttling aktiv | Notdrosselung auf Minimaltakt (600 MHz) zum Schutz des Siliziums. |
| Bit 16 | 0x10000 |
Unterspannung ist seit Boot aufgetreten | Spannung brach kurzzeitig ein (z. B. beim Anlaufen einer externen USB-Festplatte). |
| Bit 17 | 0x20000 |
Taktdrosselung ist seit Boot aufgetreten | Das System war zwischenzeitlich überhitzt und hat den Takt gesenkt. |
| Bit 18 | 0x40000 |
Hard-Throttling ist aufgetreten | Schwere thermische Überlastung im bisherigen Betrieb. |
Liefert vcgencmd get_throttled etwas anderes als throttled=0x0 zurück, leidet das System unter unsauberer Stromversorgung oder unzureichender Kühlung!
4. MicroSD-Lebensdauer & Schreibschutz-Defekt
MicroSD-Karten besitzen Flash-Speicherzellen mit einer begrenzten Anzahl von Schreibzyklen (~3.000 bis 10.000 Zyklen).
Gehen einer billigen Karte durch ständiges Logging oder Datenbank-Schreibvorgänge die Reserveblöcke aus, schaltet der interne Controller die Karte in einen permanenten Hardware-Schreibschutz (Read-Only Mode), um die vorhandenen Daten vor totalem Verlust zu schützen.
Typische Symptome einer verschlissenen SD-Karte:
- Man kann per SSH eine Datei erstellen (
touch test.txt), nach einem Neustart des Pi ist die Datei jedoch spurlos verschwunden! apt updatebricht mit Fehlern wieRead-only file systemoderI/O errorab.- Die grüne ACT-LED flackert ununterbrochen, ohne dass das System weiterbootet.
Dateisystemfehler reparieren (fsck)
Wurde die Karte versehentlich ohne sudo poweroff ausgesteckt, lässt sich das Dateisystem an einem anderen Linux-PC reparieren:
5. Der Notfall-Entscheidungsbaum
Wenn der Raspberry Pi nicht bootet, gehe diese Prüfschritte der Reihe nach durch:
-
Rote PWR-LED prüfen
Leuchtet sie dauerhaft rot? Wenn sie flackert oder dunkel bleibt, das minderwertige Handyladekabel entsorgen und das offizielle Netzteil anschließen.
-
Grüne ACT-LED beobachten
Blinkt sie in einem festen Rhythmus? Wenn du 3 oder 4 Blinkimpulse zählst, ist das Betriebssystem-Image beschädigt. Karte im Imager neu beschreiben.
-
Netzwerk & mDNS prüfen
Blinken die Netzwerk-Buchsen-LEDs (Gelb/Grün)? Wenn ja, in der Router-Oberfläche nachsehen, welche IP-Adresse dem Gerät zugewiesen wurde.
-
/boot/firmware/config.txtprüfen
Wurden kürzlich Overlays oder Overclocking-Parameter eingetragen? Ein kleiner Tippfehler kann den Bootloader blockieren. Änderungen rückgängig machen.
Zusammenfassung des Grundlagen-Moduls
Du hast das gesamte Curriculum von Säule 1 (Fundamentals & First Steps) erfolgreich durchlaufen:
1. Du verstehst die Hardware-Architektur, Stromanforderungen und A2-Speicherkarten.
2. Du hast ein Headless-System mit dem Raspberry Pi Imager und OpenSSH aufgesetzt.
3. Du beherrschst raspi-config, Debian APT und saubere Shutdown-Befehle.
4. Du hast deine ersten Hardware-Schaltungen auf dem Steckbrett aufgebaut und mit Python gesteuert.
5. Du kannst Blinkcodes decodieren, SSH-Fehler lösen und Unterspannung diagnostizieren.
Weiter geht es mit Säule 2, wo wir uns fortgeschrittener Hardware-Architektur, NVMe-SSDs über PCIe und aktiver Kühlung widmen:
-
Nächstes Modul: Hardware Architecture, Power & Storage
Broadcom-SoC-Interna, die RP1-Southbridge, PCIe Gen 3 NVMe-Boot und automatisiertes Flotten-Provisioning meistern.