Vai al contenuto
Display Engineer
Driver IC · Ilitek

ILI9341: datasheet, pinout e codice di inizializzazione

L’ILI9341 pilota pannelli TFT 240×320 ed è il controller classico dei moduli display SPI da 2,2″ a 3,2″ e del “Cheap Yellow Display” ESP32.

DEDisplay Engineer Applications Team · Display application engineerRevisionato da un ingegnere il 11 ott 2026
ProduttoreIlitek
TipoDriver display
InterfacceSPI / MCU (8080 parallelo) / RGB (parallelo)
Risoluzione max240×320

Che cos’è l’ILI9341?

L’ILI9341 è un driver TFT a 262K colori con 172.800 byte di GRAM interna, esattamente un frame completo 240×320 a colori a 18 bit. È diventato il controller predefinito per i moduli SPI da 2,4″ e 2,8″ hobbistici e industriali.

ILI9341 su ESP32

Su ESP32 il pannello viene di solito pilotato su SPI a 40 MHz con DMA. Per UI LVGL fluide usa buffer parziali di 1/10 dello schermo e abilita il double buffering nei progetti senza PSRAM.

Correlati

Supporto delle librerie per il ILI9341

LibreriaDriver / classeNote
TFT_eSPI (Arduino)ILI9341_DRIVER (or ILI9341_2_DRIVER)
LovyanGFX (Arduino / ESP-IDF)lgfx::Panel_ILI9341
ESP-IDF esp_lcdespressif/esp_lcd_ili9341
Scarica i modelli di configurazione ILI9341

User_Setup_ILI9341.h · LGFX_ILI9341.hpp. I pin sono provvisori; ti scriviamo quando aggiungiamo configurazioni testate.

Schede di sviluppo con ILI9341

Moduli display con ILI9341

ILI9341: risoluzione dei problemi e FAQ

ILI9341 o ST7789: quale scegliere?

Entrambi sono driver 240×320 con GRAM. I moduli ILI9341 sono di solito TN o IPS da 2,4″ a 3,2″; l’ST7789 domina i pannelli IPS più piccoli. Il supporto delle librerie è eccellente per entrambi, quindi scegli in base a dimensione del pannello, angolo di visione e disponibilità.

Perché il mio ILI9341 mostra uno schermo bianco?

Le cause più comuni sono un reset mancante o errato, MISO/MOSI invertiti, un’alimentazione che raggiunge solo la retroilluminazione o una libreria configurata per un altro driver. Verifica l’ID del driver leggendo il registro 0xD3.

Quale controller touch si usa con i moduli ILI9341?

Le versioni resistive usano tipicamente XPT2046 su SPI. Le versioni capacitive usano di solito FT6206/FT6336 su I2C.

Non sai quale display è adatto al tuo progetto?

Inviaci dimensione, interfaccia e processore host. Un display engineer risponde entro 12 ore con 2–3 opzioni, datasheet e codice di inizializzazione. Campioni da 1 pz.