Um TFT de toque ILI9488 de 3,5 polegadas em um ESP32
Intermediário
- 526componentes na bancada
- 46placas rodando agora
- 1.00xtempo real, em todas as placas
O ILI9488 é o chip das telas SPI vermelhas de 3,5 polegadas: 320 por 480 pixels, com um painel de toque resistivo XPT2046 na mesma placa. As placas de 4 polegadas usam um ST7796S na mesma resolução e com os mesmos quatorze pinos. As duas são grandes demais para um Uno desenhar rápido, e as duas combinam bem com um ESP32 e a biblioteca TFT_eSPI.
O circuito acima é um ESP32 DevKit com a placa de 3,5 polegadas: uma fileira de cores no topo e um canvas preto abaixo. Aperte Rodar, toque em uma cor e desenhe na tela com o mouse ou o dedo.
O que você precisa
- Um ESP32 DevKit (a placa de 30 ou 38 pinos)
- Um TFT SPI ILI9488 de 3,5 polegadas com toque (a placa vermelha de 14 pinos), ou uma de 4 polegadas com ST7796S
- Jumpers
Ligação
| Componente e pino | Vai para | Nota |
|---|---|---|
| VCC e LED | 3V3 | LED é a luz de fundo |
| GND | GND | |
| CS | GPIO 15 | TFT_CS |
| DC | GPIO 2 | TFT_DC, a linha de comando ou dados |
| RST | GPIO 4 | TFT_RST |
| MOSI (SDI) | GPIO 23 | TFT_MOSI |
| SCK | GPIO 18 | TFT_SCLK |
| MISO (SDO) | não conectado | O ILI9488 nunca solta essa linha |
| T_CLK e T_DIN | GPIO 18 e 23 | O toque compartilha o clock e os dados de saÃda |
| T_CS | GPIO 21 | TOUCH_CS, o chip select do toque |
| T_DO | GPIO 19 | TFT_MISO: as leituras do toque voltam por aqui |
Configurando a TFT_eSPI
A TFT_eSPI não recebe a tela e seus pinos no código. Ela lê isso de um arquivo na pasta da biblioteca, User_Setup.h, e você edita esse arquivo uma vez: descomente #define ILI9488_DRIVER e defina TFT_MISO, TFT_MOSI, TFT_SCLK, TFT_CS, TFT_DC, TFT_RST e TOUCH_CS.
No Mokxi as mesmas linhas vão no topo do sketch, acima de #include <TFT_eSPI.h>, com os mesmos nomes. Assim toda a configuração fica em um só lugar, visÃvel. Copie-as para o User_Setup.h quando você montar o projeto de verdade.
Para a placa de 4 polegadas, troque ILI9488_DRIVER por ST7796_DRIVER. Nada mais muda no 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 que o ILI9488 precisa de cor de 18 bits
A maioria dos TFTs coloridos recebe um pixel como dois bytes, cor de 16 bits "565": 5 bits de vermelho, 6 de verde e 5 de azul. O ILI9488 não faz isso por SPI. Seu datasheet lista apenas pixels de 3 e 18 bits para o barramento serial, então cada pixel vai como três bytes, um para vermelho, verde e azul.
A TFT_eSPI sabe disso. Com ILI9488_DRIVER ela configura o chip para 18 bits e transforma cada cor 565 em três bytes ao enviar, então seu código continua usando TFT_RED e color565(). Com um driver ILI9341 em vez disso, o chip lê dois pixels a cada três enviados, com as cores erradas.
Três bytes por pixel também explica por que o ILI9488 é mais lento. Aqui, com a TFT_eSPI no ESP32, fillScreen() leva 261 ms no ILI9488 e 192 ms no ST7796S, que aceita a cor comum de 16 bits. Desenhe só o que mudou, não a tela inteira.
Lendo o painel de toque
O XPT2046 é um segundo chip na placa, com seu próprio chip select (T_CS). Ele compartilha as linhas de clock e dados com a tela e responde em T_DO. tft.getTouchRawZ() diz o quão forte o painel está pressionado, e tft.getTouchRaw(&x, &y) devolve dois números brutos, de cerca de 200 em uma borda do vidro a cerca de 3900 na outra.
O sketch primeiro verifica a pressão e depois converte os números brutos em pixels com map(). Na rotação 0 os números de X vão ao contrário da imagem, então o map de X vai de 3890 até 205. Em um painel de verdade, tft.calibrateTouch() encontra as bordas para você.
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);
}Girando a tela de lado
tft.setRotation(1) gira a imagem em um quarto de volta, para 480 de largura por 320 de altura, e tft.width() e tft.height() trocam para acompanhar. As rotações 0 e 2 são retrato, 1 e 3 paisagem. O chip faz a rotação: a TFT_eSPI escreve um byte, chamado MADCTL, que diz a ele como percorrer a memória.
O painel de toque não gira junto, porque o filme está colado no vidro, não na imagem. Um sketch que rotaciona a tela precisa trocar e inverter seus números de toque da mesma forma, ou deixar tft.calibrateTouch() resolver para aquela rotação.
ILI9488 ou ST7796S?
As duas placas são parecidas e usam os mesmos pinos, então a escolha vem do tamanho e da velocidade. A ST7796S de 4 polegadas tem uma imagem maior e aceita cor de 16 bits, então preenche cerca de um quarto mais rápido com os mesmos fios. A ILI9488 de 3,5 polegadas é menor, mais barata e mais fácil de encontrar.
O código passa de uma para outra com uma linha: o define do driver. O chip de toque, a ligação e todas as chamadas de desenho ficam iguais. Algumas placas de 4 polegadas são painéis IPS que mostram uma imagem em negativo até você adicionar #define TFT_INVERSION_ON; a placa TN comum aqui não precisa disso.
Erros comuns
O MISO do display ligado ao T_DO. A ILI9488 continua acionando o pino SDO mesmo quando não está selecionada, então as leituras de toque voltam como lixo. Deixe o MISO do display desconectado.
O define errado do driver. ILI9341_DRIVER ou ST7796_DRIVER em uma ILI9488 dá cores erradas; ILI9488_DRIVER em uma ST7796S também.
Rodando em um Uno. Funciona com a biblioteca ILI9488, mas 320 por 480 pixels a três bytes cada é muita SPI para uma placa de 16 MHz, e a TFT_eSPI não roda nas placas AVR.
Desenhar a tela inteira a cada loop. Mesmo em um ESP32, um preenchimento completo leva um quarto de segundo.
Abra este circuito no editor. ESP32 DevKit: ILI9488 com pintura por toque, ligado como roda no topo desta página. Troque um componente ou um valor e rode de novo.
Abrir o circuitoPerguntas
A TFT_eSPI suporta a ILI9488?
Sim. Coloque #define ILI9488_DRIVER em User_Setup.h (ou acima do include, no Mokxi). Ela envia cor de 18 bits, que é o único formato em cores completas que a ILI9488 aceita por SPI.
Qual a diferença entre a ILI9488 e a ST7796S?
Ambas são controladores SPI TFT de 320x480 em placas de toque de 14 pinos. A ST7796S (normalmente 4 polegadas) aceita cor de 16 bits como a ILI9341, então preenche mais rápido; a ILI9488 (normalmente 3,5 polegadas) aceita apenas cor de 18 bits.
Por que as cores estão erradas na minha ILI9488?
Na maioria das vezes o sketch usa um driver ILI9341, que envia cor de 16 bits. Use ILI9488_DRIVER na TFT_eSPI, ou a biblioteca ILI9488.
Continuar
Monte isto de verdade
Abra o editor, mude um valor e veja o número mudar junto. Nada para instalar, e não precisa de conta.