Zum Inhalt springen
Display Engineer
Leitfaden

Rundes 1,28-Zoll-Display mit ESP32 (GC9A01): Verdrahtung, Bibliotheken und Tipps für runde UIs

So steuern Sie ein rundes 240×240-GC9A01-TFT mit einem ESP32 an: SPI-Verdrahtung, Einrichtung von TFT_eSPI / LovyanGFX / ESP-IDF, realistische Bildraten und Layoutregeln für kreisförmige Bildschirme.

DEDisplay Engineer Applications Team · Display-ApplikationsingenieureVon Ingenieur geprüft am 11. Okt. 2026

Was ein rundes 1,28-Zoll-Display ist

Die meisten kleinen runden TFTs sind ein kreisförmig zugeschnittenes 240×240-Pixel-Panel mit einem GC9A01-Controller. Der Controller arbeitet weiterhin mit einem quadratischen Framebuffer; die Ecken haben einfach keine sichtbaren Pixel. Wearables, Drehknöpfe, Anzeigeinstrumente und Smart-Home-Controller nutzen dieses Format.

Verdrahtung (4-Draht-SPI)

Signal

Zweck

SCLK

SPI-Takt

MOSI (SDA)

SPI-Daten zum Panel

CS

Chip Select

DC

Auswahl Daten / Befehl

RST

Reset (oder mit dem MCU-Reset verbinden)

BL

Hintergrundbeleuchtung (PWM zum Dimmen)

MISO wird meist nicht genutzt. Eine bewährte Referenz-Pinbelegung finden Sie auf der Seite zum Board Waveshare ESP32-S3-Touch-LCD-1.28.

Bibliotheken

Bibliothek

Einstellung

TFT_eSPI (Arduino)

#define GC9A01_DRIVER, 240×240

LovyanGFX

lgfx::Panel_GC9A01

ESP-IDF

Komponente espressif/esp_lcd_gc9a01

LVGL

eine der obigen als Flush-Treiber, mit Teil-Zeichenpuffern

Auf der GC9A01-Seite finden Sie Konfigurationsvorlagen zum Herunterladen.

Wie schnell kann es auffrischen?

Ein voller Frame in RGB565 umfasst 240 × 240 × 16 Bit = 921.600 Bit (112,5 KB). Die theoretische SPI-Grenze liegt bei etwa 43 fps bei 40 MHz und 86 fps bei 80 MHz. Reale UIs sind wegen Befehls-Overhead und Renderzeit langsamer, daher zeichnet LVGL meist nur die geänderten Bereiche neu. Am ESP32 sind 80 MHz nur an den dedizierten SPI-Pins möglich; 40 MHz sind der sichere Standard.

Der volle Frame passt in den internen RAM, aber LVGL arbeitet gut mit zwei Teilpuffern von je 1/10 Bildschirm (etwa 11 KB) und lässt so RAM für die Anwendung übrig.

Für den Kreis gestalten

  • Text im einbeschriebenen Quadrat halten. Das größte Quadrat, das in einen Kreis von 240 Pixeln passt, misst etwa 170×170 Pixel; platzieren Sie Beschriftungen und Zahlen dort.
  • Bögen und Ringe für Daten nutzen. Anzeigeinstrumente, Fortschrittsringe und radiale Menüs nutzen den Rand, den Rechtecke verschenken.
  • Touch meldet quadratische Koordinaten. Runde Boards kombinieren das Panel oft mit einem CST816S-Touch-Controller; er liefert x/y im 240×240-Quadrat, ignorieren Sie also Berührungen außerhalb des Kreises.
  • Sichtbaren Bereich mit Ihrer Blende abgleichen. Was der Nutzer sieht, bestimmt die aktive Fläche des Panels, nicht das Glas.

Runde Displays in unserem Katalog

Unsere Direktfabriken bauen runde Module, darunter ein 1,28-Zoll-240×240-IPS-SPI-Modul, eine 1,3-Zoll-Version mit 360×360 und kapazitivem Touch sowie eine 2,1-Zoll-Version mit 480×480. Alle runden LCD-Displays ansehen; bestätigen Sie den Controller im Datenblatt, da er bei anderen Größen vom GC9A01 abweichen kann. Muster ab 1 Stück.

Häufige Fragen

Welche Auflösung hat ein rundes 1,28-Zoll-Display?

Meist 240×240 Pixel mit GC9A01-Controller; sichtbar ist der Kreis, der diesem Quadrat einbeschrieben ist.

Kann ein ESP32 einen GC9A01 mit 60 fps ansteuern?

Vollbild-Neuzeichnungen sind bei 40 MHz SPI theoretisch auf etwa 43 fps begrenzt. Teilaktualisierungen, wie LVGL sie nutzt, ermöglichen flüssige Animationen für typische Anzeige- und Uhren-UIs.

Welche Pins braucht ein GC9A01-Display?

SCLK, MOSI, CS, DC, Reset und Hintergrundbeleuchtung. MISO ist normalerweise nicht angeschlossen.

In diesem Leitfaden erwähnte Module

Unsicher, welches Display zu Ihrem Design passt?

Nennen Sie uns Größe, Schnittstelle und Host-Prozessor. Ein Display-Ingenieur antwortet innerhalb von 12 Stunden mit 2–3 Optionen, Datenblättern und Init-Code. Muster ab 1 Stk.