Aprender

Um TFT de toque ILI9488 de 3,5 polegadas em um ESP32

Intermediário

Ou veja todas as aulas.

  • 526componentes na bancada
  • 46placas rodando agora
  • 1.00xtempo real, em todas as placas
ESP32 DevKit: desenho no ILI9488 com toqueao vivo0.000 s 0.00x
Clique para abrir no editor
Aperte Rodar e desenhe no canvas. Toque em uma cor para mudar a tinta e na linha de texto para limpar. O XPT2046 lê onde você toca, e o sketch converte isso em pixels.

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 pinoVai paraNota
VCC e LED3V3LED é a luz de fundo
GNDGND
CSGPIO 15TFT_CS
DCGPIO 2TFT_DC, a linha de comando ou dados
RSTGPIO 4TFT_RST
MOSI (SDI)GPIO 23TFT_MOSI
SCKGPIO 18TFT_SCLK
MISO (SDO)não conectadoO ILI9488 nunca solta essa linha
T_CLK e T_DINGPIO 18 e 23O toque compartilha o clock e os dados de saída
T_CSGPIO 21TOUCH_CS, o chip select do toque
T_DOGPIO 19TFT_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.

O sketch de desenho com toque, parte de configuração
#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ê.

O sketch de desenho com toque, o loop
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 circuito

Perguntas

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.

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.