Pular para o conteúdo
Display Engineer
CI driver · Ilitek

ILI9341: datasheet, pinagem e código de inicialização

O ILI9341 aciona painéis TFT de 240×320 e é o controlador clássico dos módulos SPI de 2,2″–3,2″ e da "Cheap Yellow Display" com ESP32.

DEDisplay Engineer Applications Team · Engenheiros de aplicação de displaysRevisado por engenheiro em 11 de out. de 2026
FabricanteIlitek
TipoDriver de display
InterfacesSPI / MCU (paralelo 8080) / RGB (paralelo)
Resolução máxima240×320

O que é o ILI9341?

O ILI9341 é um driver TFT de 262 mil cores com 172.800 bytes de GRAM interna, exatamente um quadro completo de 240×320 em cor de 18 bits. Ele se tornou o controlador padrão dos módulos SPI de 2,4″ e 2,8″ para makers e indústria.

ILI9341 no ESP32

No ESP32 o painel normalmente é acionado por SPI a 40 MHz com DMA. Para interfaces LVGL fluidas, use buffers parciais de 1/10 da tela e ative o buffer duplo em projetos sem PSRAM.

Relacionados

Suporte de bibliotecas para o ILI9341

BibliotecaDriver / classeObservações
TFT_eSPI (Arduino)ILI9341_DRIVER (or ILI9341_2_DRIVER)
LovyanGFX (Arduino / ESP-IDF)lgfx::Panel_ILI9341
ESP-IDF esp_lcdespressif/esp_lcd_ili9341
Baixar modelos de configuração do ILI9341

User_Setup_ILI9341.h · LGFX_ILI9341.hpp. Os pinos são marcadores; enviamos atualizações por e-mail quando adicionamos configurações testadas.

Placas de desenvolvimento com ILI9341

Módulos de display com ILI9341

ILI9341: solução de problemas e perguntas frequentes

ILI9341 vs. ST7789: qual escolher?

Ambos são drivers de 240×320 com GRAM. Os módulos ILI9341 normalmente são TN ou IPS de 2,4″–3,2″; o ST7789 domina os painéis IPS menores. Ambos têm excelente suporte em bibliotecas, então escolha pelo tamanho do painel, ângulo de visão e disponibilidade.

Por que meu ILI9341 mostra a tela branca?

As causas mais comuns são reset ausente ou errado, MISO/MOSI trocados, alimentação só do backlight ou uma biblioteca configurada para outro driver. Confirme o ID do driver lendo o registrador 0xD3.

Que controlador de touch é usado com os módulos ILI9341?

As versões resistivas normalmente usam XPT2046 via SPI. As capacitivas normalmente usam FT6206/FT6336 via I2C.

Não sabe qual display combina com o seu projeto?

Envie o tamanho, a interface e o processador host. Um engenheiro de displays responde em até 12 horas com 2–3 opções, datasheets e código de inicialização. Amostras a partir de 1 pç.