Pular para o conteúdo
Display Engineer
Guia

Display redondo de 1,28 polegadas com ESP32 (GC9A01): fiação, bibliotecas e dicas de interface redonda

Como acionar um TFT redondo GC9A01 de 240×240 com ESP32: fiação SPI, configuração de TFT_eSPI / LovyanGFX / ESP-IDF, taxas de quadros realistas e regras de layout para telas circulares.

DEDisplay Engineer Applications Team · Engenheiros de aplicação de displaysRevisado por engenheiro em 11 de out. de 2026

O que é um display redondo de 1,28 polegadas

A maioria dos TFTs redondos pequenos é um painel de 240×240 pixels recortado em círculo, com controlador GC9A01. O controlador continua trabalhando com um frame buffer quadrado; simplesmente os cantos não têm pixels visíveis. Wearables, botões giratórios, mostradores e controladores de casa inteligente usam esse formato.

Fiação (SPI de 4 fios)

Sinal

Função

SCLK

Clock SPI

MOSI (SDA)

Dados SPI para o painel

CS

Chip select

DC

Seleção dados / comando

RST

Reset (ou ligado ao reset da MCU)

BL

Backlight (PWM para dimerizar)

O MISO normalmente não é usado. Para um mapa de pinos de referência que funciona, veja a página da placa Waveshare ESP32-S3-Touch-LCD-1.28.

Bibliotecas

Biblioteca

Ajuste

TFT_eSPI (Arduino)

#define GC9A01_DRIVER, 240×240

LovyanGFX

lgfx::Panel_GC9A01

ESP-IDF

componente espressif/esp_lcd_gc9a01

LVGL

qualquer um dos anteriores como driver de flush, com buffers parciais de desenho

A página do GC9A01 tem modelos de configuração para download.

Qual a velocidade de atualização?

Um quadro completo em RGB565 é 240 × 240 × 16 bits = 921.600 bits (112,5 KB). O limite teórico do SPI é cerca de 43 fps a 40 MHz e 86 fps a 80 MHz. Interfaces reais são mais lentas por causa da sobrecarga de comandos e do tempo de renderização, então o LVGL normalmente redesenha só as áreas alteradas. No ESP32, 80 MHz só é possível nos pinos SPI dedicados; 40 MHz é o padrão seguro.

O quadro completo cabe na RAM interna, mas o LVGL funciona bem com dois buffers parciais de 1/10 da tela cada (cerca de 11 KB), deixando RAM para a aplicação.

Projetando para um círculo

  • Mantenha o texto dentro do quadrado inscrito. O maior quadrado que cabe em um círculo de 240 pixels tem cerca de 170×170 pixels; coloque rótulos e números ali.
  • Use arcos e anéis para dados. Mostradores, anéis de progresso e menus radiais aproveitam a borda que os retângulos desperdiçam.
  • O touch retorna coordenadas quadradas. Placas redondas costumam combinar o painel com um controlador de touch CST816S; ele retorna x/y no quadrado de 240×240, então ignore toques fora do círculo.
  • Compare a área visível com a sua moldura. O que o usuário vê é definido pela área ativa do painel, não pelo vidro.

Displays redondos no nosso catálogo

Nossas fábricas diretas fabricam módulos redondos, incluindo um módulo IPS SPI de 1,28 polegadas e 240×240, uma versão de 1,3 polegadas e 360×360 com touch capacitivo e uma versão de 2,1 polegadas e 480×480. Veja todos os displays LCD redondos; confirme o controlador no datasheet, pois em outros tamanhos ele pode não ser o GC9A01. Amostras a partir de 1 pç.

Perguntas frequentes

Qual é a resolução de um display redondo de 1,28 polegadas?

Normalmente 240×240 pixels com controlador GC9A01; a área visível é o círculo inscrito nesse quadrado.

Um ESP32 consegue acionar um GC9A01 a 60 fps?

Em teoria, redesenhos de tela cheia ficam limitados a cerca de 43 fps com SPI a 40 MHz. Atualizações parciais, usadas pelo LVGL, permitem animações suaves em interfaces típicas de mostradores e relógios.

Quais pinos um display GC9A01 precisa?

SCLK, MOSI, CS, DC, reset e backlight. O MISO normalmente não é conectado.

Módulos citados neste guia

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ç.