Langsung ke konten
Display Engineer
Panduan

Display Bundar 1,28 Inci dengan ESP32 (GC9A01): Pengkabelan, Pustaka, dan Tips UI Bundar

Cara menggerakkan TFT bundar GC9A01 240×240 dari ESP32: pengkabelan SPI, pengaturan TFT_eSPI / LovyanGFX / ESP-IDF, frame rate realistis, dan aturan tata letak untuk layar melingkar.

DEDisplay Engineer Applications Team · Display application engineerDitinjau engineer 11 Okt 2026

Apa itu display bundar 1,28 inci

Sebagian besar TFT bundar kecil adalah panel 240×240 piksel yang dipotong melingkar, dengan pengontrol GC9A01. Pengontrol tetap bekerja dengan frame buffer persegi; sudut-sudutnya hanya tidak memiliki piksel yang terlihat. Wearable, kenop, pengukur, dan pengontrol smart home memakai format ini.

Pengkabelan (SPI 4-kabel)

Sinyal

Fungsi

SCLK

Clock SPI

MOSI (SDA)

Data SPI ke panel

CS

Chip select

DC

Pemilih data / perintah

RST

Reset (atau sambungkan ke reset MCU)

BL

Backlight (PWM untuk peredupan)

MISO biasanya tidak dipakai. Untuk peta pin referensi yang terbukti, lihat halaman board Waveshare ESP32-S3-Touch-LCD-1.28.

Pustaka

Pustaka

Pengaturan

TFT_eSPI (Arduino)

#define GC9A01_DRIVER, 240×240

LovyanGFX

lgfx::Panel_GC9A01

ESP-IDF

komponen espressif/esp_lcd_gc9a01

LVGL

salah satu di atas sebagai flush driver, dengan buffer gambar parsial

Halaman GC9A01 memiliki templat konfigurasi yang dapat Anda unduh.

Seberapa cepat refresh-nya?

Satu frame penuh dalam RGB565 adalah 240 × 240 × 16 bit = 921.600 bit (112,5 KB). Batas SPI teoretis sekitar 43 fps pada 40 MHz dan 86 fps pada 80 MHz. UI nyata lebih lambat karena overhead perintah dan waktu rendering, sehingga LVGL biasanya hanya menggambar ulang area yang berubah. Di ESP32, 80 MHz hanya mungkin pada pin SPI khusus; 40 MHz adalah default yang aman.

Frame penuh muat di RAM internal, tetapi LVGL bekerja baik dengan dua buffer parsial masing-masing 1/10 layar (sekitar 11 KB), menyisakan RAM untuk aplikasi.

Mendesain untuk lingkaran

  • Letakkan teks di dalam persegi yang tertulis. Persegi terbesar yang muat dalam lingkaran 240 piksel berukuran sekitar 170×170 piksel; letakkan label dan angka di sana.
  • Gunakan busur dan cincin untuk data. Pengukur, cincin progres, dan menu radial memanfaatkan tepi yang terbuang pada persegi panjang.
  • Sentuh melaporkan koordinat persegi. Board bundar sering memasangkan panel dengan pengontrol sentuh CST816S; pengontrol ini mengembalikan x/y dalam persegi 240×240, jadi abaikan sentuhan di luar lingkaran.
  • Periksa area terlihat terhadap bezel Anda. Area aktif panel, bukan kaca, yang menentukan apa yang dilihat pengguna.

Display bundar di katalog kami

Pabrik langsung kami membuat modul bundar, termasuk modul SPI IPS 1,28 inci 240×240, versi 1,3 inci 360×360 dengan sentuh kapasitif, dan versi 2,1 inci 480×480. Lihat semua display LCD bundar; konfirmasikan pengontrol di datasheet, karena bisa berbeda dari GC9A01 pada ukuran lain. Sampel mulai 1 pcs.

Pertanyaan yang sering diajukan

Berapa resolusi display bundar 1,28 inci?

Biasanya 240×240 piksel dengan pengontrol GC9A01; area yang terlihat adalah lingkaran yang tertulis dalam persegi tersebut.

Bisakah ESP32 menggerakkan GC9A01 pada 60 fps?

Penggambaran ulang layar penuh secara teoretis dibatasi sekitar 43 fps pada SPI 40 MHz. Pembaruan parsial, yang dipakai LVGL, memungkinkan animasi halus untuk UI pengukur dan jam yang umum.

Pin apa saja yang dibutuhkan display GC9A01?

SCLK, MOSI, CS, DC, reset, dan backlight. MISO biasanya tidak tersambung.

Modul yang disebut dalam panduan ini

Belum yakin display mana yang cocok untuk desain Anda?

Kirimkan ukuran, antarmuka, dan prosesor host Anda. Display engineer akan membalas dalam 12 jam dengan 2–3 opsi, datasheet, dan kode inisialisasi. Sampel mulai 1 pcs.