Hier starten: Welche Verbindung verwenden Sie?
Verbindung | Typisches Symptom | Zuerst prüfen |
|---|---|---|
MIPI-DSI-Flexkabel (offizielles Touch Display, die meisten 5–10"-Panels) | Hintergrundbeleuchtung aus, oder Beleuchtung an bei schwarzem Bildschirm | Kabeltyp und Ausrichtung, Display-Stromversorgung, |
HDMI (Monitore, HDMI-Treiberboards) | "Kein Signal", falsche Auflösung, schwarz nach dem Booten | Verwendeter Port, Modus erzwungen mit |
SPI am GPIO-Header (kleine 2,4–3,5"-Panels) | Weißes Bild, nichts nach dem Start des Desktops | Vom Panel-Hersteller bereitgestellter Treiber und Overlay |
Arbeiten Sie den Abschnitt zu Ihrer Verbindung der Reihe nach durch. Jeder Schritt schließt eine Ursache aus, und die frühen Schritte sind die, die am häufigsten die Fehlerquelle sind.
DSI-Display: schwarzer Bildschirm oder nur Hintergrundbeleuchtung
1. Das richtige Flexkabel für Ihren Pi verwenden
Der Raspberry Pi 5 hat einen kleineren DSI-Anschluss als frühere Modelle, daher passt das Kabel älterer Displays nicht dazu. Laut der Dokumentation von Raspberry Pi:
- Raspberry Pi 4 und früher: 15-poliges zu 15-poliges Flat-Flexible-Cable (FFC).
- Raspberry Pi 5: 22-poliges zu 15-poliges FFC (Standard – Mini). Das 22-polige Ende ist das kleinere Ende und kommt in den Pi; das größere Ende kommt ins Display.
- Touch Display 2, 10 Zoll, am Raspberry Pi 5: das mitgelieferte 22-polige zu 22-polige Mini – Mini-FFC.
Raspberry-Pi-Zero-Modelle haben keinen DSI-Anschluss, daher kann ein DSI-Display daran grundsätzlich nicht verwendet werden.
2. Prüfen, ob das Kabel richtig sitzt und herum eingesteckt ist
Öffnen Sie die Halteklammer des Anschlusses, schieben Sie das Kabel vollständig hinein und schließen Sie die Klammer. Beim Raspberry Pi 4B und früheren Modellen ist der Display-Anschluss mit DISPLAY beschriftet (nicht mit CAMERA), und die Metallkontakte zeigen zu den Ethernet- und USB-A-Ports. Ein verkehrt herum eingestecktes, nur halb eingestecktes oder im Kamera-Anschluss steckendes Kabel erzeugt genau dasselbe Symptom wie ein defektes Panel.
3. Dem Display eine eigene 5-V-Versorgung geben
Die offiziellen Displays werden getrennt vom DSI-Kabel mit Strom versorgt:
- Original Touch Display: Jumper-Kabel vom GPIO-Header des Pi, schwarz an Pin 6 (GND) und rot an Pin 4 (5 V) oder an Pin 2, wenn Pin 4 belegt ist. Sie können stattdessen ein Micro-USB-Netzteil verwenden, dürfen dann aber die GPIO-Stromkabel nicht zusätzlich anschließen.
- Touch Display 2: das mitgelieferte GPIO-Stromkabel, kleines Ende in den
J1-Port des Displays, rot an Pin 2 und schwarz an Pin 6.
Wenn die Hintergrundbeleuchtung nie angeht, ist die Stromversorgung der erste Verdächtige. Panels von Drittherstellern benötigen oft eine separate Versorgung für die Hintergrundbeleuchtung; prüfen Sie den Verdrahtungsplan des Anbieters.
4. Keine unnötige dtoverlay-Zeile hinzufügen
Raspberry Pi OS wird mit display_auto_detect=1 in /boot/firmware/config.txt ausgeliefert, und damit lädt die Firmware das Overlay für erkannte DSI-Displays automatisch. Auf einem Standard-Raspberry Pi benötigen die offiziellen Displays daher keine dtoverlay-Zeile. Eine von Hand hinzugefügte Zeile – für die falsche Größe oder den falschen Port – ist eine häufige Ursache für einen schwarzen Bildschirm.
Raspberry Pi Compute Modules sind anders: Sie erkennen DSI-Displays nicht automatisch, daher fügen Sie das Overlay selbst hinzu:
- Touch Display 2, 5 Zoll:
dtoverlay=vc4-kms-dsi-ili9881-5inch - Touch Display 2, 7 Zoll:
dtoverlay=vc4-kms-dsi-ili9881-7inch - Touch Display 2, 10 Zoll:
dtoverlay=vc4-kms-dsi-ili79600-10-1inch - Original 7-Zoll-Touch Display:
dtoverlay=vc4-kms-dsi-7inch
Der Standard ist der mit 1 beschriftete Port; hängen Sie ,dsi0 an, um Port 0 zu verwenden (zum Beispiel dtoverlay=vc4-kms-dsi-7inch,dsi0). Beim Original-Display entfernen Sie außerdem jede display_auto_detect-Zeile.
5. DSI-Panels von Drittherstellern benötigen ein eigenes Overlay
Die automatische Erkennung deckt nur Displays ab, die die Firmware kennt. Ein MIPI-DSI-Panel eines Drittherstellers benötigt ein Device-Tree-Overlay, das zu seinem Controller, seiner Lane-Anzahl und seinem Timing passt – normalerweise vom Panel-Anbieter bereitgestellt. Zielt das Overlay des Anbieters auf einen älteren Kernel oder ein anderes Pi-Modell, kann das Panel trotz korrekter Verdrahtung schwarz bleiben. Fordern Sie ein Overlay an, das auf genau Ihrem Pi-Modell und Ihrer OS-Version getestet wurde. Unsere Hinweise zu Raspberry-Pi-5-Displays und unsere MIPI-DSI-Display-Übersicht erläutern, was Sie anfragen sollten.
HDMI-Display: „Kein Signal“ oder falsche Auflösung
1. Verwenden Sie den ersten HDMI-Port
Beim Raspberry Pi 4B und 5 ist der auf dem Board mit HDMI0 beschriftete Port der erste Display-Ausgang (HDMI-A-1 unter Linux). Schließen Sie ein einzelnes Display dort an, bevor Sie etwas anderes testen.
2. Alte config.txt-HDMI-Einstellungen funktionieren nicht mehr
Viele Anleitungen empfehlen weiterhin, hdmi_force_hotplug, hdmi_group und hdmi_mode in der config.txt zu setzen. Die Raspberry-Pi-Dokumentation führt diese Optionen inzwischen als Legacy-Optionen, die „nicht mit Raspberry Pi OS Bookworm und neuer funktionieren“. Mit dem KMS-Grafiktreiber verwaltet Linux die gesamte Display-Pipeline, einschließlich der HDMI-Ausgänge.
3. Modus per video= in der cmdline.txt erzwingen
Ohne gesetzten Modus liest der Pi das EDID des Displays und wählt eine Auflösung. Kleine HDMI-Treiberboards melden manchmal ein EDID, das nicht zum Panel passt, was zu „Kein Signal“ oder einem beschnittenen Bild führt. Erzwingen Sie den nativen Modus des Panels, indem Sie einen video=-Parameter an die einzelne Zeile in /boot/firmware/cmdline.txt anhängen, z. B. video=HDMI-A-1:1024x600M@60 für ein 1024×600-Panel bei 60 Hz.
Das Format lautet video=<display>:<width>x<height>M@<refresh>. Verwenden Sie HDMI-A-2 für den zweiten HDMI-Port und DSI-1 für ein DSI- oder DPI-Display. Entnehmen Sie Auflösung und Bildwiederholrate dem Datenblatt des Panels. Halten Sie alles in der cmdline.txt in einer Zeile.
Bild gedreht oder gespiegelt
- Desktop: Preferences > Control Centre > Screens, das Display auswählen und dann Orientation auf Normal, Left, Inverted oder Right setzen.
- Nur Konsole: Erweitern Sie den
video=-Parameter, z. B.video=DSI-1:720x1280@60,rotate=90. Mitreflect_x,reflect_yoderreflect_xyspiegeln Sie das Bild.
Zwei Einschränkungen: Alle angeschlossenen Displays teilen sich dieselbe rotate=-Einstellung, und rotate= dreht nur die Textkonsole. Anwendungen, die direkt auf DRM zeichnen, wie cvlc oder die libcamera-Apps, benötigen ihre eigene Rotationsoption.
Touch passt nicht zum Bild
Auf dem Desktop stellen Sie die Ausrichtung im Control Centre ein, und der Touch folgt. In einem Setup ohne Desktop mit gedrehtem Display ergänzen Sie Touch-Parameter im Overlay des Displays in der config.txt: invx und invy invertieren eine Achse, swapxy tauscht sie, und disable_touch schaltet Touch ab. So invertiert beispielsweise dtoverlay=vc4-kms-dsi-ili9881-7inch,invx,invy beide Achsen beim 7-inch Touch Display 2.
Beim originalen 7-Zoll-Display entfernen Sie display_auto_detect=1, wenn Sie auf diese Weise ein Touch-Overlay hinzufügen. Raspberry Pi weist darauf hin, dass die Rotation von Touch im Device Tree mit Ihrer Input-Library kollidieren kann; rotieren Sie Touch-Events daher möglichst in der Library oder im Desktop.
Bildschirm wird nach zehn Minuten schwarz
Das ist Screen Blanking, kein Defekt. Wenn aktiviert, blendet Raspberry Pi OS den Bildschirm nach 600 Sekunden Inaktivität ab. Deaktivieren Sie die Funktion im Control Centre (Screen-Blanking-Schalter) oder mit sudo raspi-config > 2 Display Options > D2 Screen Blanking. Für eine Textkonsole hängen Sie consoleblank=0 an die cmdline.txt an, damit der Bildschirm nie abgeschaltet wird.
Wenn das Panel schuld ist, nicht der Pi
Bleibt das Panel an einem nachweislich funktionierenden Pi mit passendem Kabel, Stromversorgung und Einstellungen dunkel, messen Sie die Backlight-Versorgungsspannung und testen ein zweites Panel, bevor Sie an der Software arbeiten. Für ein Produkt statt eines Einzelstücks wählen Sie ein Panel, dessen Lieferant Ihnen Overlay, Timing und Power-Sequenz für Ihren exakten Host bereitstellt. Unser Display-Schnittstellenvergleich erklärt, wann DSI oder HDMI die bessere Wahl für ein Raspberry-Pi-Design ist.
Häufige Fragen
Warum funktioniert mein Raspberry-Pi-5-Display nicht mit dem Kabel meines alten Displays?
Der Raspberry Pi 5 hat einen kleineren 22-poligen DSI-Anschluss. Displays mit 15-poligem Anschluss benötigen ein 22-polig-auf-15-poliges Flachbandkabel, wobei das kleinere 22-polige Ende in den Pi gesteckt wird.
Brauche ich eine dtoverlay-Zeile für das offizielle Raspberry Pi Touch Display?
Nicht auf einem Standard-Raspberry Pi: Mit display_auto_detect=1, dem Standard in Raspberry Pi OS, lädt die Firmware das Overlay automatisch. Compute Modules erkennen DSI-Displays nicht automatisch; fügen Sie das Overlay, z. B. dtoverlay=vc4-kms-dsi-ili9881-7inch, daher selbst hinzu.
Warum funktioniert hdmi_mode nicht mehr?
hdmi_group, hdmi_mode und hdmi_force_hotplug sind Legacy-Optionen der config.txt, die mit Raspberry Pi OS Bookworm und neuer nicht funktionieren. Erzwingen Sie einen Modus mit video= in der cmdline.txt, z. B. video=HDMI-A-1:1024x600M@60.
Wie verhindere ich, dass sich der Raspberry-Pi-Bildschirm abschaltet?
Deaktivieren Sie Screen Blanking im Control Centre oder in raspi-config unter 2 Display Options > D2 Screen Blanking. Für eine Textkonsole hängen Sie consoleblank=0 an die cmdline.txt an.
Quellen
- Raspberry-Pi-Dokumentation: Touch Display 2
- Raspberry-Pi-Dokumentation: Touch Display (originales 7-Zoll-Display)
- Raspberry-Pi-Dokumentation: config.txt (display_auto_detect)
- Raspberry-Pi-Dokumentation: Legacy-Optionen der config.txt
- Raspberry-Pi-Dokumentation: Display-Konfiguration, Rotation und Bildschirmabschaltung