Écran Raspberry Pi qui ne fonctionne pas ? Correctifs DSI, HDMI et tactile pour Pi 4 et Pi 5

Commencez ici : quelle connexion utilisez-vous ?

Parcourez dans l'ordre la section correspondant à votre connexion. Chaque étape élimine une cause, et les premières étapes sont celles qui échouent le plus souvent.

Écran DSI : écran noir ou rétroéclairage seul

1. Utilisez la bonne nappe pour votre Pi

Le Raspberry Pi 5 dispose d'un connecteur DSI plus petit que les modèles précédents ; la nappe fournie avec les écrans plus anciens ne convient donc pas. Selon la documentation de Raspberry Pi :

• Raspberry Pi 4 et antérieurs : câble souple (FFC) 15 voies vers 15 voies.
• Raspberry Pi 5 : FFC 22 voies vers 15 voies (Standard – Mini). L'extrémité 22 voies est la plus petite et se branche sur le Pi ; l'extrémité la plus grande se branche sur l'écran.
• Touch Display 2, 10 pouces, sur Raspberry Pi 5 : le FFC Mini – Mini 22 voies vers 22 voies fourni.

Les modèles Raspberry Pi Zero n'ont pas de connecteur DSI ; un écran DSI ne peut donc absolument pas être utilisé avec eux.

2. Vérifiez que le câble est bien enfoncé et dans le bon sens

Ouvrez le clip de retenue du connecteur, enfoncez complètement la nappe et refermez le clip. Sur le Raspberry Pi 4B et les modèles antérieurs, le connecteur d'écran est marqué DISPLAY (pas CAMERA), et les contacts métalliques font face aux ports Ethernet et USB-A. Une nappe inversée, à moitié insérée ou branchée sur le connecteur caméra donne exactement le même symptôme qu'une dalle hors service.

3. Alimentez l'écran avec son propre 5 V

Les écrans officiels sont alimentés séparément de la nappe DSI :

• Touch Display d'origine : fils de connexion depuis le header GPIO du Pi, noir sur la broche 6 (GND) et rouge sur la broche 4 (5 V), ou broche 2 si la broche 4 est déjà utilisée. Vous pouvez utiliser une alimentation micro USB à la place, mais dans ce cas ne connectez pas aussi les fils d'alimentation GPIO.
• Touch Display 2 : le câble d'alimentation GPIO fourni, petite extrémité dans le port J1 de l'écran, rouge sur la broche 2 et noir sur la broche 6.

Si le rétroéclairage ne s'allume jamais, l'alimentation est le premier suspect. Les dalles tierces nécessitent souvent une alimentation séparée pour le rétroéclairage ; consultez le schéma de câblage du fabricant.

4. N'ajoutez pas de ligne dtoverlay inutile

Raspberry Pi OS est livré avec display_auto_detect=1 dans /boot/firmware/config.txt ; avec ce paramètre, le firmware charge automatiquement l'overlay des écrans DSI reconnus. Sur un Raspberry Pi standard, les écrans officiels n'ont donc besoin d'aucune ligne dtoverlay. En ajouter une à la main, pour une mauvaise taille ou un mauvais port, est une cause fréquente d'écran noir.

Les Raspberry Pi Compute Modules sont différents : ils ne détectent pas automatiquement les écrans DSI, c'est donc à vous d'ajouter l'overlay :

• Touch Display 2, 5 pouces : dtoverlay=vc4-kms-dsi-ili9881-5inch
• Touch Display 2, 7 pouces : dtoverlay=vc4-kms-dsi-ili9881-7inch
• Touch Display 2, 10 pouces : dtoverlay=vc4-kms-dsi-ili79600-10-1inch
• Touch Display 7 pouces d'origine : dtoverlay=vc4-kms-dsi-7inch

Par défaut, c'est le port marqué 1 qui est utilisé ; ajoutez ,dsi0 pour utiliser le port 0 (par exemple dtoverlay=vc4-kms-dsi-7inch,dsi0). Pour l'écran d'origine, supprimez également toute ligne display_auto_detect.

5. Les dalles DSI tierces nécessitent leur propre overlay

La détection automatique ne couvre que les écrans reconnus par le firmware. Une dalle MIPI DSI tierce nécessite un device-tree overlay correspondant à son contrôleur, à son nombre de lanes et à ses timings, normalement fourni par le fabricant de la dalle. Si l'overlay du fabricant cible un noyau plus ancien ou un autre modèle de Pi, la dalle peut rester noire même avec un câblage correct. Demandez un overlay testé sur votre modèle de Pi exact et votre version d'OS. Nos notes sur les écrans pour Raspberry Pi 5 et notre vue d'ensemble des écrans MIPI DSI indiquent quoi demander.

Écran HDMI : « no signal » ou résolution incorrecte

1. Utilisez le premier port HDMI

Sur Raspberry Pi 4B et 5, le port étiqueté HDMI0 sur la carte est la première sortie d'affichage (HDMI-A-1 sous Linux). Connectez un seul écran sur ce port avant de tester quoi que ce soit d'autre.

2. Les anciens réglages HDMI de config.txt ne fonctionnent plus

De nombreux guides vous demandent encore de définir hdmi_force_hotplug, hdmi_group et hdmi_mode dans config.txt. La documentation de Raspberry Pi liste désormais ces options comme obsolètes : elles « ne fonctionnent pas avec Raspberry Pi OS Bookworm et ultérieur ». Avec le pilote graphique KMS, Linux gère l'ensemble du pipeline d'affichage, y compris les sorties HDMI.

3. Imposez un mode avec video= dans cmdline.txt

Sans mode défini, le Pi lit l'EDID de l'écran et choisit une résolution. Certaines petites cartes pilotes HDMI rapportent parfois un EDID qui ne correspond pas au panneau, ce qui donne un « no signal » ou une image rognée. Imposez le mode natif du panneau en ajoutant un paramètre video= à l'unique ligne de /boot/firmware/cmdline.txt, par exemple video=HDMI-A-1:1024x600M@60 pour un panneau 1024×600 à 60 Hz.

Le format est video=<display>:<width>x<height>M@<refresh>. Utilisez HDMI-A-2 pour le second port HDMI et DSI-1 pour un écran DSI ou DPI. Prenez la résolution et la fréquence de rafraîchissement dans la fiche technique du panneau. Gardez tout le contenu de cmdline.txt sur une seule ligne.

Image pivotée ou inversée en miroir

• Bureau : Préférences > Control Centre > Screens, sélectionnez l'écran, puis réglez Orientation sur Normal, Left, Inverted ou Right.
• Console uniquement : étendez le paramètre video=, par exemple video=DSI-1:720x1280@60,rotate=90. Utilisez reflect_x, reflect_y ou reflect_xy pour obtenir un effet miroir.

Deux limites : tous les écrans connectés partagent le même réglage rotate=, et rotate= ne fait pivoter que la console texte. Les applications qui dessinent directement via DRM, comme cvlc ou les outils libcamera, nécessitent leur propre option de rotation.

Le tactile ne correspond pas à l'image

Sur le bureau, définissez l'orientation dans le Control Centre et le tactile suit. Dans une configuration sans bureau avec un écran pivoté, ajoutez des paramètres tactiles à l'overlay de l'écran dans config.txt : invx et invy inversent un axe, swapxy les permute, et disable_touch désactive le tactile. Par exemple, dtoverlay=vc4-kms-dsi-ili9881-7inch,invx,invy inverse les deux axes sur un Touch Display 2 de 7 pouces.

Pour le modèle d'origine de 7 pouces, retirez display_auto_detect=1 lorsque vous ajoutez un overlay tactile de cette manière. Raspberry Pi signale que la rotation du tactile dans le device tree peut entrer en conflit avec votre bibliothèque d'entrée ; faites donc pivoter les événements tactiles dans la bibliothèque ou le bureau lorsque c'est possible.

L'écran devient noir au bout de dix minutes

Il s'agit de la mise en veille de l'écran, pas d'une panne. Lorsqu'elle est activée, Raspberry Pi OS met l'écran en veille après 600 secondes d'inactivité. Désactivez-la dans le Control Centre (interrupteur Screen Blanking) ou avec sudo raspi-config > 2 Display Options > D2 Screen Blanking. Pour une console texte, ajoutez consoleblank=0 à cmdline.txt pour ne jamais mettre l'écran en veille.

Quand c'est le panneau, pas le Pi

Si le panneau reste noir sur un Pi connu comme fonctionnel, avec le bon câble, l'alimentation et les réglages, mesurez l'alimentation du rétroéclairage et remplacez le panneau par un second avant de retravailler le logiciel. Pour un produit plutôt qu'un prototype unique, choisissez un panneau dont le fournisseur vous fournit l'overlay, les timings et la séquence d'alimentation pour votre hôte exact. Notre comparaison des interfaces d'affichage explique quand DSI ou HDMI est le meilleur choix pour une conception à base de Raspberry Pi.