Pantalla ESP32-2432S028R (CYD): especificaciones, revisiones del driver y configuración
La Cheap Yellow Display: un TFT SPI de 2,8 pulgadas y 240×320 en una placa ESP32. Los lotes se envían con un controlador de pantalla ILI9341 o ST7789, así que el mismo sketch puede funcionar en una placa y mostrar la pantalla en blanco en otra.
Especificaciones de la pantalla del ESP32-2432S028R (CYD)
| MCU | ESP32 (ESP32-WROOM-32) |
|---|---|
| Pantalla | 2.8″ · 240×320 |
| Bus de pantalla | SPI (HSPI) |
| IC controlador | ILI9341 o ST7789 |
| Táctil | XPT2046 resistivo (pines SPI separados) |
¿Qué revisión del ESP32-2432S028R (CYD) tiene?
Las placas vendidas con el mismo nombre se envían con distintos ICs controladores de pantalla. El código escrito para una revisión muestra pantalla blanca, colores erróneos o nada en la otra, así que identifique primero la suya.
| Revisión | IC controlador | Cómo identificarla | Ajustes de la biblioteca |
|---|---|---|---|
| Original (micro-USB) | ILI9341 | Funciona con el User_Setup.h de la comunidad sin cambios | TFT_eSPI: ILI9341_2_DRIVER, sin inversión |
| Lotes posteriores (algunos con dos puertos USB) | ST7789 | Pantalla en blanco, colores lavados o invertidos con la configuración ILI9341 | TFT_eSPI: ST7789_DRIVER; pruebe TFT_INVERSION_ON/OFF y TFT_RGB_ORDER TFT_BGR de uno en uno; la retroiluminación sigue en el GPIO 21 |
Pines de pantalla y táctil del ESP32-2432S028R (CYD)
| Señal | GPIO | Notas |
|---|---|---|
| TFT MOSI | 13 | HSPI |
| TFT MISO | 12 | HSPI |
| TFT SCLK | 14 | HSPI |
| TFT CS | 15 | |
| TFT DC | 2 | |
| TFT RST | -1 | No conectado a un GPIO |
| Backlight | 21 | Activo a nivel alto; no lo reutilice |
| Touch CLK | 25 | XPT2046 |
| Touch CS | 33 | XPT2046 |
| Touch DIN (MOSI) | 32 | XPT2046 |
| Touch DO (MISO) | 39 | XPT2046 |
| Touch IRQ | 36 | XPT2046 |
La misma especificación de pantalla para producción en volumen
¿Ha hecho el prototipo con el ESP32-2432S028R (CYD)? Estos módulos de nuestras fábricas directas comparten tamaño y resolución de panel, incluyen datasheet y un IC controlador fijo por lote de producción, y están disponibles en muestras desde 1 ud. La cantidad mínima y el plazo se acuerdan por proyecto.
Del prototipo con ESP32-2432S028R (CYD) a la producción
Las placas de desarrollo son ideales para validar una interfaz, pero sus paneles se compran en el mercado abierto: el controlador puede cambiar entre lotes (como ya ha ocurrido con esta placa), rara vez hay datasheet y la vida útil no está garantizada. Para un producto, especifique un módulo con IC controlador fijo por lote de producción, datasheet y compromiso de ciclo de vida.
Nuestras fábricas directas fabrican módulos con el mismo formato de 2,8″ y 240×320. Muestras desde 1 ud.; la cantidad mínima y el plazo se acuerdan por proyecto con nuestro equipo comercial.
Antes de depurar el código
- Confirme qué revisión tiene (tabla anterior): los cambios de IC controlador son la causa más común de una pantalla en blanco.
- Compruebe que el pin de retroiluminación no se reutiliza en su sketch.
- Cambie un ajuste cada vez (driver, inversión, orden de color) y conserve un ejemplo que funcione para comparar.
Ejemplos de configuración
#define ILI9341_2_DRIVER
#define TFT_WIDTH 240
#define TFT_HEIGHT 320
#define TFT_BL 21
#define TFT_BACKLIGHT_ON HIGH
#define TFT_MISO 12
#define TFT_MOSI 13
#define TFT_SCLK 14
#define TFT_CS 15
#define TFT_DC 2
#define TFT_RST -1
#define SPI_FREQUENCY 55000000
#define SPI_READ_FREQUENCY 20000000
#define SPI_TOUCH_FREQUENCY 2500000
#define USE_HSPI_PORT// replace the ILI9341_2_DRIVER line with:
#define ST7789_DRIVER
#define TFT_WIDTH 240
#define TFT_HEIGHT 320
// if colours are inverted, toggle ONE of these:
#define TFT_INVERSION_ON
// #define TFT_INVERSION_OFF
// if red and blue are swapped:
// #define TFT_RGB_ORDER TFT_BGR
// pins and SPI settings stay the same as the ILI9341 setupPreguntas frecuentes
¿Por qué mi CYD muestra la pantalla en blanco con un código que a otros les funciona?
Probablemente su placa tiene el controlador de pantalla ST7789 en lugar del ILI9341. Cambie el driver de TFT_eSPI a ST7789_DRIVER y ajuste la inversión y el orden de color; los pines siguen siendo los mismos.
¿Qué GPIO controla la retroiluminación de la CYD?
GPIO 21, activo a nivel alto. Reutilizar el GPIO 21 en su sketch apaga la pantalla.
¿Por qué no funciona el táctil con TFT_eSPI en la CYD?
El controlador táctil XPT2046 está en sus propios pines (CLK 25, CS 33, DIN 32, DO 39, IRQ 36), no en el bus SPI de la pantalla, así que use una instancia aparte de la biblioteca XPT2046 en esos pines.
Fuentes
¿No sabe qué pantalla encaja en su diseño?
Envíenos el tamaño, la interfaz y el procesador host. Un ingeniero de pantallas responde en 12 horas con 2–3 opciones, datasheets y código de inicialización. Muestras desde 1 ud.