Por qué la misma placa puede tener otro controlador
Las placas de pantalla de bajo coste se fabrican con paneles comprados en el mercado abierto. Cuando un lote cambia de proveedor, el controlador también puede cambiar, mientras el nombre de la placa, el PCB y el pinout siguen iguales. La ESP32-2432S028R (Cheap Yellow Display) y la ESP32-2432S024 existen ambas en versiones ILI9341 y ST7789.
Identificarlo por los síntomas
Lo que ve con una configuración ILI9341 | Causa probable | Solución |
|---|---|---|
Pantalla blanca o vacía, retroiluminación encendida | El controlador es ST7789 | Cambie al driver ST7789 |
Aparece la imagen, los colores parecen un negativo | El panel ST7789 necesita inversión | Alterne la inversión ( |
Rojo y azul intercambiados | Orden de color | Configure el orden BGR ( |
Imagen reflejada o desplazada | Ajuste de rotación / acceso a memoria | Cambie la rotación (MADCTL) |
Todo oscuro | Pin de retroiluminación erróneo o reutilizado | Compruebe el GPIO de la retroiluminación |
Cambie un ajuste cada vez y conserve un ejemplo que funcione para comparar.
Identificarlo leyendo el ID
Si la placa conecta la línea MISO del panel, puede leer el ID del controlador en lugar de adivinar. Un ILI9341 responde 0x9341 al comando Read ID4 (0xD3). En TFT_eSPI, tft.readcommand8(0xD3, n) lee el byte n de un registro. Si no obtiene 0x93 y 0x41, pruebe el driver ST7789. Las placas sin MISO no se pueden leer, así que use la tabla de síntomas.
Ajustes que cambian
Elemento | ILI9341 | ST7789 |
|---|---|---|
Driver de TFT_eSPI | | |
LovyanGFX | | |
ESP-IDF | | |
Inversión | normalmente desactivada | a menudo activada |
Hay plantillas para ambos en las páginas de ILI9341 y ST7789V.
Cómo evitarlo en un producto
Para un producto, especifique un módulo cuyo datasheet indique el controlador y cuyo proveedor lo fije por lote de producción, para que el firmware no se rompa entre lotes. Nuestro módulo SPI de 2,8 pulgadas y 240×320 usa un ST7789V especificado; muestras desde 1 ud.
Preguntas frecuentes
¿Funciona el código de ILI9341 en un ST7789?
No de forma fiable. Ambos son controladores de 240×320, pero la secuencia de inicialización difiere, así que cambie el driver en lugar de parchear el código de ILI9341.
¿Por qué los colores están invertidos en mi pantalla ST7789?
Muchos paneles ST7789 necesitan inversión de pantalla (INVON). Active TFT_INVERSION_ON o llame a tft.invertDisplay(true).
¿Cómo leo el ID del controlador?
Con MISO conectado, lea el registro 0xD3 (Read ID4): un ILI9341 devuelve 0x93 0x41. Sin MISO, identifíquelo por los síntomas.
