🛠 Brancher un écran DSI sur un CM3+

Objetivos

El CM3+ expone en el SODIMM dos interfaces MIPI DSI (una de 4 vías + una de 2 vías, datasheet RP-008163-DS §2.2) para controlar directamente pantallas DSI sin controlador HDMI — ideal para interfaces hombre-máquina (IHM) compactas. Como en el caso de la cámara, la pila de software es cerrada: solo funcionan las pantallas conocidas por el firmware (pantalla oficial de 7", pantallas en la lista de compatibilidad); un panel MIPI de terceros requiere un port no documentado. Este tutorial activa la pantalla DSI, configura la rotación y el framebuffer.

Material

• CM3+ sobre CMIO3 (conector DISPLAY1 = DSI de 4 vías)
• Pantalla DSI oficial Raspberry Pi de 7" (o pantalla listada por el firmware) + cable plano FFC
• Fuente de alimentación generosa: la retroiluminación de la pantalla de 7" se alimenta desde la CMIO3

Código completo

# 1. Activer l'écran DSI dans config.txt
sudo tee -a /boot/firmware/config.txt <<'EOF'
display_auto_detect=1
dtoverlay=vc4-kms-dsi-7inch
# Rotation de l'écran si besoin (0/1/2/3 = 0/90/180/270°)
dtoverlay=vc4-kms-dsi-7inch,invscreen
EOF
sudo reboot

# 2. Vérifier que le contrôleur vidéo voit la dalle
modetest | head -40            # paquet libdrm-tests ; chercher l'encodeur DSI
ls /dev/dri/card0

# 3. Afficher une image de test sur le framebuffer
sudo apt install -y fbv fbi
fbv /usr/share/raspberrypi-artwork/raspipi.png

# 4. Tournage 90° du bureau complet (X11)
xrandr -o right

Verificación esperada

Al reiniciar, el logo de Raspberry Pi y luego el escritorio se muestran en la pantalla DSI; modetest lista un conector DSI conectado con el modo nativo de la pantalla (800x480 para la pantalla oficial). fbv dibuja la imagen directamente en el framebuffer, sin HDMI conectado — la salida de vídeo está correctamente enrutada hacia el bus DSI.

Errores frecuentes

• Conectar la pantalla en DISPLAY2 pensando que los dos conectores son idénticos: DISPLAY1 es la DSI de 4 vías (resolución completa), DISPLAY2 solo tiene 2 vías y no soporta pantallas de 4 vías.
• Utilizar una pantalla MIPI genérica de AliExpress: la pila cerrada solo controla las pantallas conocidas por el firmware — verificar la compatibilidad antes de comprar (límite documentado en el datasheet §9.3).
• Cable plano FFC mal insertado o al revés: pantalla totalmente negra sin mensaje de error; desenergizar y reinsertar con los contactos hacia la marca silk.
• Mezclar overlays antiguos y recientes: las viejas documentaciones hablan de dtoverlay=pitft o del controlador SPI; con las imágenes KMS actuales, es vc4-kms-dsi-7inch lo que se necesita.
• Sobrecargar la alimentación: retroiluminación máxima + CPU bajo carga se acercan a los límites del riel de 3V3 de la placa base — reducir el brillo si aparecen reinicios.