Un TFT táctil ILI9488 de 3.5 pulgadas en un ESP32
Intermedio
- 526componentes en el banco de trabajo
- 46placas funcionando ahora
- 1.00xtiempo real, en todas las placas
El ILI9488 es el chip de las pantallas SPI rojas de 3.5 pulgadas: 320 por 480 píxeles, con un panel táctil resistivo XPT2046 en la misma placa. Las placas de 4 pulgadas usan un ST7796S con la misma resolución y los mismos catorce pines. Ambas son demasiado grandes para que un Uno dibuje rápido, y ambas combinan bien con un ESP32 y la biblioteca TFT_eSPI.
El circuito de arriba es un ESP32 DevKit con la placa de 3.5 pulgadas: una fila de muestras de color en la parte superior y un lienzo negro debajo. Presiona Ejecutar, toca un color y luego dibuja en la pantalla con el mouse o el dedo.
Lo que necesitas
- Un ESP32 DevKit (la placa de 30 o 38 pines)
- Un TFT SPI ILI9488 de 3.5 pulgadas con táctil (la placa roja de 14 pines), o una de 4 pulgadas con ST7796S
- Cables jumper
Cableado
| Componente y pin | Va a | Nota |
|---|---|---|
| VCC y LED | 3V3 | LED es la luz de fondo |
| GND | GND | |
| CS | GPIO 15 | TFT_CS |
| DC | GPIO 2 | TFT_DC, la línea de comando o datos |
| RST | GPIO 4 | TFT_RST |
| MOSI (SDI) | GPIO 23 | TFT_MOSI |
| SCK | GPIO 18 | TFT_SCLK |
| MISO (SDO) | sin conexión | El ILI9488 nunca la suelta |
| T_CLK y T_DIN | GPIO 18 y 23 | El táctil comparte el reloj y la salida de datos |
| T_CS | GPIO 21 | TOUCH_CS, el chip select del táctil |
| T_DO | GPIO 19 | TFT_MISO: las lecturas del táctil regresan por aquí |
Configurar TFT_eSPI
TFT_eSPI no recibe la pantalla y sus pines en el código. Los lee de un archivo en la carpeta de la biblioteca, User_Setup.h, y ese archivo lo editas una sola vez: descomenta #define ILI9488_DRIVER y define TFT_MISO, TFT_MOSI, TFT_SCLK, TFT_CS, TFT_DC, TFT_RST y TOUCH_CS.
En Mokxi las mismas líneas van al inicio del sketch, arriba de #include <TFT_eSPI.h>, con los mismos nombres. Así toda la configuración queda en un solo lugar a la vista. Cópialas en User_Setup.h cuando lo construyas de verdad.
Para la placa de 4 pulgadas, cambia ILI9488_DRIVER por ST7796_DRIVER. Nada más cambia en el sketch.
#define ILI9488_DRIVER
#define TFT_MISO 19
#define TFT_MOSI 23
#define TFT_SCLK 18
#define TFT_CS 15
#define TFT_DC 2
#define TFT_RST 4
#define TOUCH_CS 21
#include <TFT_eSPI.h>
TFT_eSPI tft = TFT_eSPI();
void setup() {
Serial.begin(115200);
tft.init();
tft.setRotation(0); // portrait, 320x480
tft.fillScreen(TFT_BLACK);
}Por qué el ILI9488 necesita color de 18 bits
La mayoría de los TFT a color reciben un píxel como dos bytes, color de 16 bits "565": 5 bits de rojo, 6 de verde y 5 de azul. El ILI9488 no lo hace por SPI. Su hoja de datos solo lista píxeles de 3 y 18 bits para el bus serie, así que cada píxel viaja como tres bytes, uno para el rojo, el verde y el azul.
TFT_eSPI lo sabe. Con ILI9488_DRIVER configura el chip a 18 bits y convierte cada color 565 en tres bytes al enviarlo, así que tu código sigue usando TFT_RED y color565(). Con un controlador ILI9341 en su lugar, el chip lee dos píxeles de cada tres que recibe, con los colores equivocados.
Los tres bytes por píxel también explican por qué el ILI9488 es más lento. Aquí, con TFT_eSPI en el ESP32, fillScreen() tarda 261 ms en el ILI9488 y 192 ms en el ST7796S, que acepta color normal de 16 bits. Dibuja solo lo que cambió, no toda la pantalla.
Leer el panel táctil
El XPT2046 es un segundo chip en la placa, con su propio chip select (T_CS). Comparte las líneas de reloj y datos con la pantalla, y responde por T_DO. tft.getTouchRawZ() indica qué tan fuerte se presiona el panel, y tft.getTouchRaw(&x, &y) da dos números sin procesar que van de unos 200 en un borde del cristal a unos 3900 en el otro.
El sketch revisa primero la presión y luego convierte los números sin procesar en píxeles con map(). En la rotación 0 los números X corren al revés que en la imagen, así que su map de X va de 3890 a 205. En un panel real, tft.calibrateTouch() encuentra los bordes por ti.
void loop() {
if (tft.getTouchRawZ() < 300) return; // not pressed
uint16_t rx, ry;
tft.getTouchRaw(&rx, &ry);
int x = constrain(map(rx, 3890, 205, 0, 319), 0, 319);
int y = constrain(map(ry, 205, 3890, 0, 479), 0, 479);
tft.fillCircle(x, y, 4, TFT_YELLOW);
}Girar la pantalla de lado
tft.setRotation(1) gira la imagen un cuarto de vuelta, a 480 de ancho por 320 de alto, y tft.width() y tft.height() se intercambian para coincidir. Las rotaciones 0 y 2 son verticales, 1 y 3 horizontales. El giro lo hace el chip: TFT_eSPI escribe un byte, llamado MADCTL, que le indica en qué dirección recorrer su memoria.
El panel táctil no gira con ella, porque la película está pegada al vidrio, no a la imagen. Un sketch que rota la pantalla tiene que intercambiar e invertir sus números de toque de la misma manera, o dejar que tft.calibrateTouch() lo resuelva para esa rotación.
¿ILI9488 o ST7796S?
Las dos placas se parecen y usan los mismos pines, así que la decisión se reduce a tamaño y velocidad. La ST7796S de 4 pulgadas tiene una imagen más grande y acepta color de 16 bits, así que llena la pantalla cerca de un cuarto más rápido con los mismos cables. La ILI9488 de 3.5 pulgadas es más pequeña, más barata y más fácil de conseguir.
El código pasa de una a otra con una sola línea: el define del driver. El chip táctil, el cableado y cada llamada de dibujo se quedan igual. Algunas placas de 4 pulgadas son paneles IPS que muestran una imagen en negativo hasta que agregas #define TFT_INVERSION_ON; la placa TN sencilla de aquí no lo necesita.
Errores comunes
El MISO de la pantalla conectado con T_DO. La ILI9488 sigue impulsando su pin SDO incluso cuando no está seleccionada, así que las lecturas del tacto llegan como basura. Deja el MISO de la pantalla sin conectar.
El define del driver equivocado. ILI9341_DRIVER o ST7796_DRIVER en una ILI9488 da colores incorrectos; ILI9488_DRIVER en una ST7796S también.
Ejecutarlo desde un Uno. Funciona con la biblioteca ILI9488, pero 320 por 480 píxeles a tres bytes cada uno es mucho SPI para una placa de 16 MHz, y TFT_eSPI no funciona en las placas AVR para nada.
Dibujar toda la pantalla en cada ciclo. Incluso en un ESP32, un llenado completo toma un cuarto de segundo.
Abre este circuito en el editor. ESP32 DevKit: ILI9488 pintura táctil, cableado tal como se ejecuta en la parte superior de esta página. Cambia un componente o un valor y ejecútalo de nuevo.
Abrir el circuitoPreguntas
¿TFT_eSPI es compatible con la ILI9488?
Sí. Pon #define ILI9488_DRIVER en User_Setup.h (o arriba del include, en Mokxi). Envía color de 18 bits, que es el único formato a todo color que la ILI9488 acepta por SPI.
¿Cuál es la diferencia entre la ILI9488 y la ST7796S?
Ambas son controladores SPI TFT de 320x480 en placas táctiles de 14 pines. La ST7796S (normalmente de 4 pulgadas) acepta color de 16 bits como la ILI9341, así que llena más rápido; la ILI9488 (normalmente de 3.5 pulgadas) solo acepta color de 18 bits.
¿Por qué los colores están mal en mi ILI9488?
La mayoría de las veces el sketch usa un driver de ILI9341, que envía color de 16 bits. Usa ILI9488_DRIVER en TFT_eSPI, o la biblioteca ILI9488.
Sigue así
Ármalo en la vida real
Abre el editor, cambia un valor y mira cómo cambia el número con él. Nada que instalar y sin necesidad de cuenta.