An Arduino_GFX display driver for the GalaxyCore GC9B72, the controller on 2.1-inch 360×360 round SPI TFT panels that ship with no public driver anywhere. If you bought one of these round color displays and only got a blank screen, garbage, or noise with every "similar" driver (GC9A01, GC9C01, ST7789, ST77916), this is why: the GC9B72 needs its own specific initialization sequence, and until now that sequence wasn't available in any Arduino library.
This library adds a proper Arduino_GC9B72 class to
GFX Library for Arduino so the
panel just works: solid colors, shapes, text, the full GFX API.
These are sold on AliExpress/Amazon under generic names, but the way to identify yours for certain is the silkscreen printed on the back of the panel PCB, which reads:
VER:TFT 2.1 0_10
Driver IC: GC9B72
Resolution: 360x360
- Controller IC: GalaxyCore GC9B72
- Size / resolution: 2.1" round, 360 × 360
- Brand seen on these: EstarDyn (also listed as "GoldenMorning", "M17 2.1 TFT YuanXing", or just "2.1 inch round display")
- Interface: 4-wire SPI (SCL, SDA, DC, CS, RST) + backlight
- Power: 3.3 V logic, do NOT feed 5 V to VCC
If the back of your board says GC9B72, this is your driver.
The 10-pad breakout exposes: GND VCC SCL SDA RST DC CS BL SDO TE.
Only 8 are needed; SDO (read-back) and TE (frame-sync) are left unconnected.
| Panel pad | Meaning | Notes |
|---|---|---|
| VCC | Power | 3.3 V only (no onboard reg) |
| GND | Ground | |
| SCL | SPI clock | -> your TFT_SCLK |
| SDA | SPI data (MOSI) | -> your TFT_MOSI |
| RST | Reset | -> your TFT_RST |
| DC | Data / command | -> your TFT_DC |
| CS | Chip select | -> your TFT_CS |
| BL | Backlight | -> a GPIO (drive HIGH to turn on) |
| SDO | Data out (read) | leave unconnected |
| TE | Tearing effect | leave unconnected |
| Panel | ESP32-S3 |
|---|---|
| VCC | 3V3 |
| GND | GND |
| SCL | GPIO 12 |
| SDA | GPIO 11 |
| RST | GPIO 8 |
| DC | GPIO 9 |
| CS | GPIO 10 |
| BL | GPIO 14 |
Change the #defines in the sketch to match your own wiring.
- Install GFX Library for Arduino (Library Manager → search "GFX Library for Arduino" by moononournation). This is a required dependency.
- Install this library (copy the folder into your Arduino
libraries/, or add it as a ZIP).
#include <Arduino_GFX_Library.h>
#include <Arduino_GC9B72.h>
Arduino_DataBus *bus = new Arduino_ESP32SPI(TFT_DC, TFT_CS, TFT_SCLK, TFT_MOSI, GFX_NOT_DEFINED);
Arduino_GFX *gfx = new Arduino_GC9B72(bus, TFT_RST, 0 /*rotation*/, false /*IPS*/, 360, 360);
void setup() {
pinMode(TFT_BL, OUTPUT); // turn the backlight on, or the screen stays black
digitalWrite(TFT_BL, HIGH);
gfx->begin(); // or gfx->begin(spiHz) to set the SPI clock
gfx->fillScreen(BLACK);
gfx->setTextColor(WHITE);
gfx->setTextSize(4);
gfx->setCursor(90, 170);
gfx->println("GC9B72");
}If the screen stays black, check the backlight first: TFT_BL has to be driven
HIGH. Jumper the BL pad to 3V3 to test the panel independently of any code.
From here it's the standard Arduino_GFX API: drawLine, fillRect,
drawCircle, fonts, Arduino_Canvas, etc.
See examples/GC9B72_ColorTest.
- SPI mode is 0 (set automatically). The controller handles fast SPI
(tested up to ~20 MHz on short leads); if you use long/breadboard jumpers and
see speckle, lower the clock via
gfx->begin(<hz>). - Color format is 16-bit RGB565, MADCTL RGB order (rotation 0). Rotations
1-3 are supported via
setRotation(). - The panel has a hardware reset line; wire
RSTfor reliable startup.
The GC9B72 initialization register sequence is ported from the
xboot project's fb-gc9b72.c reference
driver, the only known-good public GC9B72 init. This library repackages it as
an Arduino_GFX display class.
MIT. See LICENSE.