Component guide · Intermediate · 3 min read
GC9A01 1.28 Inch Round Display

Pinout, Wiring and Code
By Geekobot Learning Team · Updated 29 Oct 2026
On this page
The GC9A01 is the driver chip in the popular 1.28 inch round IPS display with 240 × 240 pixels. It connects over a 4-wire SPI bus, runs from 3.3 V and looks great for watch faces, gauges and eyes. An ESP32 or RP2040 has the memory and speed for smooth graphics; an Uno can drive it slowly with a level shifter, but it is not a good match.
Key specs at a glance
- Size
- 1.28 inch round, 240 × 240 pixels
- Panel
- IPS, 65K colours, wide viewing angle
- Driver
- GC9A01
- Interface
- 4-wire SPI (write only)
- Supply
- 3.3 V (many boards accept 5 V on VCC, logic stays 3.3 V)
- Backlight
- LED, often always on or on a BL pin
What the GC9A01 round display is
The pixel memory is a square 240 × 240, but the corners fall outside the round glass, so draw your design inside a 120-pixel radius circle.
Use a full-colour frame buffer or sprites on an ESP32 for smooth needle and dial animations. A 115 KB frame does not fit in an Uno's 2 KB of RAM.
GC9A01 round display pinout
The pins on the GC9A01 round display and what each one does.
| Pin | Function |
|---|---|
| VCC | 3.3 V (check your board for 5 V support) |
| GND | Ground |
| SCL / SCK | SPI clock |
| SDA / MOSI | SPI data |
| DC | Data or command select |
| CS | Chip select |
| RST | Reset |
| BL | Backlight (on some boards) |
- VCC
- 3.3 V (check your board for 5 V support)
- GND
- Ground
- SCL / SCK
- SPI clock
- SDA / MOSI
- SPI data
- DC
- Data or command select
- CS
- Chip select
- RST
- Reset
- BL
- Backlight (on some boards)
Wiring the GC9A01 round display
The logic is 3.3 V; a 5 V Uno needs a level shifter on every signal. On the ESP32 these pins match the TFT_eSPI setup below.
| GC9A01 round display pin | Arduino Uno | ESP32 |
|---|---|---|
| VCC | 3.3V | 3V3 |
| GND | GND | GND |
| SCL | D13 via level shifter | GPIO 18 |
| SDA | D11 via level shifter | GPIO 23 |
| DC | D8 via level shifter | GPIO 2 |
| CS | D10 via level shifter | GPIO 15 |
| RST | D9 via level shifter | GPIO 4 |
- VCC
- Arduino Uno:
- 3.3V
- ESP32:
- 3V3
- GND
- Arduino Uno:
- GND
- ESP32:
- GND
- SCL
- Arduino Uno:
- D13 via level shifter
- ESP32:
- GPIO 18
- SDA
- Arduino Uno:
- D11 via level shifter
- ESP32:
- GPIO 23
- DC
- Arduino Uno:
- D8 via level shifter
- ESP32:
- GPIO 2
- CS
- Arduino Uno:
- D10 via level shifter
- ESP32:
- GPIO 15
- RST
- Arduino Uno:
- D9 via level shifter
- ESP32:
- GPIO 4
Example code
Use TFT_eSprite to draw into memory and push the whole image at once for flicker-free animation.
// In TFT_eSPI User_Setup.h: #define GC9A01_DRIVER, TFT_WIDTH 240, TFT_HEIGHT 240,
// TFT_MOSI 23, TFT_SCLK 18, TFT_CS 15, TFT_DC 2, TFT_RST 4
#include <TFT_eSPI.h>
TFT_eSPI tft;
void setup() {
tft.init();
tft.fillScreen(TFT_BLACK);
tft.drawCircle(120, 120, 118, TFT_DARKGREY);
}
void loop() {
static int v = 0;
float a = (v * 2.7 - 135) * DEG_TO_RAD; // -135 to +135 degrees
tft.fillCircle(120, 120, 100, TFT_BLACK);
tft.drawLine(120, 120, 120 + 90 * sin(a), 120 - 90 * cos(a), TFT_ORANGE);
tft.setTextColor(TFT_WHITE, TFT_BLACK);
tft.drawCentreString(String(v), 120, 150, 4);
v = (v + 1) % 101;
delay(30);
}Setup and tuning
select GC9A01_DRIVER and set the pins in User_Setup.h before compiling.
40 MHz works on most boards; lower it if you see noise.
keep text and graphics inside a 120-pixel radius.
share SCK, MOSI and DC, and give each its own CS for a pair of eyes.
What you need
Shop this list5 of 5 found in our store · ₹995
1.28" Round IPS Display (GC9A01, 240x240): the part this guide covers1.28" Round IPS Display (GC9A01, 240x240)₹469
ESP32-WROOM-32 38-pin development board: for Wi-Fi logging and dashboardsESP32-WROOM-32 38-Pin Development Board₹389
4-channel logic level converter (BSS138): only if you use a 5 V board4-Channel Logic Level Converter (BSS138)₹20
Solderless breadboard: to build without solderingSolderless Breadboard₹68
Dupont jumper wires: for the connectionsDupont Jumper Wires (40 pcs)₹49Closest match, check the specs
Alternatives and when to choose them
- ST7735 TFT display: small rectangular colour screen.
- ILI9488 3.5 inch display: larger 480 × 320 screen with touch.
- TFT displays: how the common TFT drivers compare.
Common mistakes to avoid
- Driving it from a 5 V Uno without level shifting.
- Not setting the driver in TFT_eSPI, so the screen stays white.
- Drawing in the corners, which are outside the round glass.
- Expecting smooth animation from an Uno with 2 KB of RAM.
Frequently asked questions
What resolution is the GC9A01?
240 × 240 pixels on a 1.28 inch round IPS panel.
Does it work with Arduino Uno?
It can, with level shifters and simple graphics, but an ESP32 or RP2040 works much better.
Why is my screen white?
Usually wrong pins or driver in the library setup, or RST not connected.
Can I use two round displays?
Yes, share the SPI and DC lines and give each its own CS.
Is it touch?
This version has no touch; some boards add a CST816S touch chip.
Parts for this guide
Projects that use it
Put this into practice: 7 step-by-step builds in our project library use parts from this guide.
Keep learning
Sources
- GC9A01 a-Si TFT LCD single-chip driver datasheet (Galaxycore)
- TFT_eSPI library documentation (Bodmer)
Written by the Geekobot team from manufacturer datasheets. Always check the datasheet for the exact part and variant you buy.
