¿La pantalla de tu Raspberry Pi no funciona? Soluciones para DSI, HDMI y táctil en Pi 4 y Pi 5

Empieza aquí: ¿qué conexión estás usando?

Sigue en orden la sección correspondiente a tu conexión. Cada paso descarta una causa, y los primeros pasos son los que fallan con más frecuencia.

Pantalla DSI: pantalla en negro o solo retroiluminación

1. Usa el cable flex adecuado para tu Pi

Raspberry Pi 5 tiene un conector DSI más pequeño que los modelos anteriores, por lo que el cable incluido con pantallas antiguas no encaja en él. Según la documentación de Raspberry Pi:

• Raspberry Pi 4 y anteriores: cable flexible plano (FFC) de 15 vías a 15 vías.
• Raspberry Pi 5: FFC de 22 vías a 15 vías (Standard – Mini). El extremo de 22 vías es el más pequeño y se conecta a la Pi; el extremo mayor se conecta a la pantalla.
• Touch Display 2, 10 pulgadas, en Raspberry Pi 5: el FFC de 22 vías a 22 vías Mini – Mini incluido.

Los modelos Raspberry Pi Zero no tienen conector DSI, por lo que no se puede usar una pantalla DSI en ellos.

2. Comprueba que el cable esté bien insertado y en la orientación correcta

Abre el clip de sujeción del conector, inserta el cable por completo y cierra el clip. En Raspberry Pi 4B y anteriores, el conector de pantalla está etiquetado DISPLAY (no CAMERA), y los contactos metálicos miran hacia los puertos Ethernet y USB-A. Un cable invertido, insertado a medias o conectado al conector de cámara da exactamente el mismo síntoma que un panel averiado.

3. Alimenta la pantalla con sus propios 5 V

Las pantallas oficiales se alimentan de forma independiente del cable DSI:

• Touch Display original: cables puente desde el header GPIO de la Pi, negro al pin 6 (GND) y rojo al pin 4 (5 V), o al pin 2 si el pin 4 está ocupado. Puedes usar en su lugar una fuente micro USB, pero entonces no conectes también los cables de alimentación GPIO.
• Touch Display 2: el cable de alimentación GPIO incluido, extremo pequeño al puerto J1 de la pantalla, rojo al pin 2 y negro al pin 6.

Si la retroiluminación nunca se enciende, la alimentación es la primera sospechosa. Los paneles de terceros a menudo necesitan una alimentación independiente para la retroiluminación; consulta el esquema de cableado del fabricante.

4. No añadas una línea dtoverlay que no necesitas

Raspberry Pi OS incluye display_auto_detect=1 en /boot/firmware/config.txt, y con ello el firmware carga automáticamente el overlay de las pantallas DSI reconocidas. En una Raspberry Pi estándar, las pantallas oficiales por tanto no necesitan ninguna línea dtoverlay. Añadir una a mano, con el tamaño o el puerto equivocado, es una causa común de pantalla en negro.

Los Raspberry Pi Compute Modules son distintos: no detectan automáticamente las pantallas DSI, así que el overlay lo añades tú:

• Touch Display 2, 5 pulgadas: dtoverlay=vc4-kms-dsi-ili9881-5inch
• Touch Display 2, 7 pulgadas: dtoverlay=vc4-kms-dsi-ili9881-7inch
• Touch Display 2, 10 pulgadas: dtoverlay=vc4-kms-dsi-ili79600-10-1inch
• Touch Display original de 7 pulgadas: dtoverlay=vc4-kms-dsi-7inch

El valor por defecto es el puerto etiquetado 1; añade ,dsi0 para usar el puerto 0 (por ejemplo dtoverlay=vc4-kms-dsi-7inch,dsi0). Para la pantalla original, elimina también cualquier línea display_auto_detect.

5. Los paneles DSI de terceros necesitan su propio overlay

La detección automática solo cubre las pantallas que el firmware reconoce. Un panel MIPI DSI de terceros necesita un overlay de device-tree que coincida con su controlador, su número de lanes y su temporización, normalmente proporcionado por el fabricante del panel. Si el overlay del fabricante está pensado para un kernel más antiguo u otro modelo de Pi, el panel puede permanecer en negro incluso con el cableado correcto. Pide un overlay probado en tu modelo exacto de Pi y versión del OS. Nuestras notas sobre pantallas para Raspberry Pi 5 y resumen de pantallas MIPI DSI explican qué solicitar.

Pantalla HDMI: «sin señal» o una resolución incorrecta

1. Usa el primer puerto HDMI

En Raspberry Pi 4B y 5, el puerto etiquetado HDMI0 en la placa es la primera salida de vídeo (HDMI-A-1 en Linux). Conecta una única pantalla ahí antes de probar cualquier otra cosa.

2. Los ajustes HDMI antiguos de config.txt ya no funcionan

Muchas guías siguen indicando que establezcas hdmi_force_hotplug, hdmi_group y hdmi_mode en config.txt. La documentación de Raspberry Pi ya los clasifica como opciones obsoletas que «no funcionan con Raspberry Pi OS Bookworm ni versiones posteriores». Con el controlador gráfico KMS, Linux gestiona toda la tubería de vídeo, incluidas las salidas HDMI.

3. Fuerza un modo con video= en cmdline.txt

Sin un modo establecido, la Pi lee el EDID de la pantalla y elige una resolución. Las placas controladoras HDMI pequeñas a veces informan de un EDID que no coincide con el panel, lo que produce «sin señal» o una imagen recortada. Fuerza el modo nativo del panel añadiendo un parámetro video= a la única línea de /boot/firmware/cmdline.txt, por ejemplo video=HDMI-A-1:1024x600M@60 para un panel de 1024×600 a 60 Hz.

El formato es video=<display>:<width>x<height>M@<refresh>. Usa HDMI-A-2 para el segundo puerto HDMI y DSI-1 para una pantalla DSI o DPI. Toma la resolución y la frecuencia de actualización de la hoja de datos del panel. Mantén todo el contenido de cmdline.txt en una sola línea.

Imagen rotada o reflejada

• Escritorio: Preferences > Control Centre > Screens, selecciona la pantalla y después establece Orientation en Normal, Left, Inverted o Right.
• Solo consola: amplía el parámetro video=, por ejemplo video=DSI-1:720x1280@60,rotate=90. Usa reflect_x, reflect_y o reflect_xy para reflejar la imagen.

Dos limitaciones: todas las pantallas conectadas comparten el mismo ajuste de rotate=, y rotate= solo rota la consola de texto. Las aplicaciones que dibujan directamente sobre DRM, como cvlc o las apps de libcamera, necesitan su propia opción de rotación.

El táctil no coincide con la imagen

En el escritorio, establece la orientación en Control Centre y el táctil la seguirá. En una configuración sin escritorio con la pantalla rotada, añade parámetros de táctil al overlay de la pantalla en config.txt: invx y invy invierten un eje, swapxy los intercambia y disable_touch desactiva el táctil. Por ejemplo, dtoverlay=vc4-kms-dsi-ili9881-7inch,invx,invy invierte ambos ejes en una Touch Display 2 de 7 pulgadas.

Para la pantalla original de 7 pulgadas, elimina display_auto_detect=1 al añadir un overlay de táctil de esta manera. Raspberry Pi señala que rotar el táctil en el device tree puede entrar en conflicto con tu librería de entrada, así que rota los eventos táctiles en la librería o en el escritorio cuando sea posible.

La pantalla se pone en negro a los diez minutos

Es el apagado de pantalla (screen blanking), no una avería. Cuando está activado, Raspberry Pi OS pone la pantalla en negro tras 600 segundos de inactividad. Desactívalo en Control Centre (interruptor Screen Blanking) o con sudo raspi-config > 2 Display Options > D2 Screen Blanking. Para una consola de texto, añade consoleblank=0 a cmdline.txt para que nunca se apague.

Cuando el problema es el panel y no la Pi

Si el panel permanece oscuro en una Pi que funciona correctamente con el cable, la alimentación y la configuración adecuados, mide la alimentación del retroiluminado y prueba con un segundo panel antes de tocar el software. Para un producto en lugar de un montaje único, elige un panel cuyo proveedor te facilite el overlay, el timing y la secuencia de encendido para tu host exacto. Nuestra comparación de interfaces de pantalla explica cuándo DSI o HDMI es la mejor opción para un diseño con Raspberry Pi.