Vai al contenuto
Display Engineer
Guida

Display rotondo da 1,28 pollici con ESP32 (GC9A01): cablaggio, librerie e consigli per UI rotonde

Come pilotare un TFT rotondo GC9A01 240×240 da un ESP32: cablaggio SPI, configurazione TFT_eSPI / LovyanGFX / ESP-IDF, frame rate realistici e regole di layout per schermi circolari.

DEDisplay Engineer Applications Team · Display application engineerRevisionato da un ingegnere il 11 ott 2026

Che cos’è un display rotondo da 1,28 pollici

La maggior parte dei piccoli TFT rotondi è un pannello da 240×240 pixel tagliato a cerchio, con controller GC9A01. Il controller funziona comunque con un frame buffer quadrato; gli angoli semplicemente non hanno pixel visibili. Wearable, manopole, indicatori e controller smart home usano questo formato.

Cablaggio (SPI a 4 fili)

Segnale

Funzione

SCLK

Clock SPI

MOSI (SDA)

Dati SPI verso il pannello

CS

Chip select

DC

Selezione dati / comando

RST

Reset (o collegato al reset della MCU)

BL

Retroilluminazione (PWM per la regolazione)

MISO di solito non è usato. Per una mappa dei pin di riferimento collaudata, vedi la pagina della scheda Waveshare ESP32-S3-Touch-LCD-1.28.

Librerie

Libreria

Impostazione

TFT_eSPI (Arduino)

#define GC9A01_DRIVER, 240×240

LovyanGFX

lgfx::Panel_GC9A01

ESP-IDF

componente espressif/esp_lcd_gc9a01

LVGL

uno qualsiasi dei precedenti come driver di flush, con buffer di disegno parziali

La pagina GC9A01 offre modelli di configurazione scaricabili.

Quanto velocemente si aggiorna?

Un frame completo in RGB565 è 240 × 240 × 16 bit = 921.600 bit (112,5 KB). Il limite SPI teorico è di circa 43 fps a 40 MHz e 86 fps a 80 MHz. Le UI reali sono più lente per l’overhead dei comandi e il tempo di rendering, quindi LVGL di solito ridisegna solo le aree modificate. Su ESP32, 80 MHz è possibile solo sui pin SPI dedicati; 40 MHz è il valore predefinito sicuro.

Il frame completo entra nella RAM interna, ma LVGL funziona bene con due buffer parziali da 1/10 di schermo ciascuno (circa 11 KB), lasciando RAM per l’applicazione.

Progettare per un cerchio

  • Tieni il testo dentro il quadrato inscritto. Il quadrato più grande che entra in un cerchio di 240 pixel misura circa 170×170 pixel; metti lì etichette e numeri.
  • Usa archi e anelli per i dati. Indicatori, anelli di avanzamento e menu radiali sfruttano il bordo che i rettangoli sprecano.
  • Il touch restituisce coordinate quadrate. Le schede rotonde abbinano spesso il pannello a un controller touch CST816S, che restituisce x/y nel quadrato 240×240, quindi ignora i tocchi fuori dal cerchio.
  • Confronta l’area visibile con la cornice. È l’area attiva del pannello, non il vetro, a determinare ciò che vede l’utente.

Display rotondi nel nostro catalogo

Le nostre fabbriche dirette producono moduli rotondi, tra cui un modulo SPI IPS da 1,28 pollici 240×240, una versione da 1,3 pollici 360×360 con touch capacitivo e una versione da 2,1 pollici 480×480. Vedi tutti i display LCD rotondi; verifica il controller sul datasheet, perché in altre dimensioni può differire dal GC9A01. Campioni da 1 pz.

Domande frequenti

Che risoluzione ha un display rotondo da 1,28 pollici?

Di solito 240×240 pixel con controller GC9A01; l’area visibile è il cerchio inscritto in quel quadrato.

Un ESP32 può pilotare un GC9A01 a 60 fps?

I ridisegni a schermo intero sono teoricamente limitati a circa 43 fps con SPI a 40 MHz. Gli aggiornamenti parziali, usati da LVGL, rendono possibile un’animazione fluida per le tipiche UI di indicatori e orologi.

Di quali pin ha bisogno un display GC9A01?

SCLK, MOSI, CS, DC, reset e retroilluminazione. MISO normalmente non è collegato.

Moduli citati in questa guida

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.