Source: https://mokxi.com/libraries/adafruit-gc9a01a
Updated: 2026-11-17

Libraries / Displays

Arduino library · Displays

# Adafruit GC9A01A: the 1.28 inch round TFT on Arduino

Yes. You can use the Adafruit GC9A01A library online in Mokxi with nothing to install, and the sketch runs in your browser against the simulated part (Round display, GC9A01). The example below, "Round watch face", runs on the Arduino Uno R3.

Run the example in Mokxi See the calls

Built in on Mokxi: #include <Adafruit_GC9A01A.h> and it builds, with nothing to install. Free, and no account needed.

## What Adafruit GC9A01A does

The GC9A01 is the controller behind the round 1.28 inch 240x240 screens used in DIY smartwatches, gauges and robot eyes. Adafruit_GC9A01A drives it over SPI and hands the drawing to Adafruit_GFX, so circles, lines, text and bitmaps use the same calls as on any Adafruit screen.

The thing to keep in mind is that the memory is square and the glass is not. Pixels drawn into the four corners are stored and never seen, so lay out a design around the center at (120, 120) with a radius of 120. Rotation needs no offsets on this chip, which makes setRotation() simple compared with the ST7789.

begin() sends the long vendor start-up sequence these panels need, including the inversion command for the IPS glass. The runnable example is a watch face on an Uno with a DS3231 clock: it erases each hand by drawing it again in black and draws the new one, because repainting 240x240 pixels every second is too slow over an Uno’s SPI.

Library Manager name | Adafruit GC9A01A

Author | Adafruit

Include | #include <Adafruit_GC9A01A.h>

Boards | every board Mokxi compiles for but ATtiny85

In the simulator | Simulated: it runs against the part the way it does on the bench.

Parts it drives | Round display, GC9A01

## Install it

It builds on every board Mokxi compiles for but ATtiny85.

In Mokxi it is built in: #include <Adafruit_GC9A01A.h> and the sketch compiles, with no download, no zip and no Library Manager.

On a real board, install "Adafruit GC9A01A" by Adafruit from the Arduino IDE’s Library Manager (Sketch, Include Library, Manage Libraries), or add Adafruit GC9A01A to lib_deps in PlatformIO. Mokxi follows the calls of release 1.2.0, so a sketch written here builds there too.

- ESP32-C3
- Arduino Uno
- Arduino Nano
- Arduino Mega 2560
- Arduino Leonardo
- SparkFun Pro Micro
- Arduino Micro
- ESP32-C6
- WCH CH32V003
- Raspberry Pi Pico
- Raspberry Pi Pico W
- Seeed XIAO SAMD21
- STM32
- STM32 Nucleo-F411RE
- STM32 Blue Pill
- micro:bit V2
- Arduino Uno R4
- ESP32 DevKit
- ESP32-S3-DevKitC-1
- ESP8266 NodeMCU
- Arduino Pro Mini 3.3 V
- Seeed XIAO ESP32-C3
- ESP32-C3 SuperMini
- Seeed XIAO ESP32-C6
- ESP32-DevKitC V4
- LOLIN32 Lite
- Wemos D1 R32
- Cheap Yellow Display
- TTGO T-Display
- Seeed XIAO ESP32-S3
- Arduino Nano ESP32
- Arduino Nano RP2040 Connect
- Seeed XIAO RP2040
- Waveshare RP2040-Zero
- Arduino Uno R4 WiFi

## The calls you will use

In the order a sketch meets them.

### Adafruit_GC9A01A tft(10, 9)

Makes the display on the hardware SPI pins with CS on 10 and DC on 9. A third argument names the reset pin; leave it out when RES is not wired.

### tft.begin()

Resets the panel if a reset pin was given and sends the start-up sequence. An optional argument sets the SPI speed.

### tft.fillScreen(GC9A01A_BLACK)

Paints every pixel, the visible circle and the hidden corners. Do it once in setup(), not on every frame.

### tft.drawLine(120, 120, x, y, GC9A01A_WHITE)

A line from the center outward, which is all a clock hand is. Work the end point out from the angle with a sine table or sin() and cos().

### tft.fillCircle(120, 120, 60, GC9A01A_RED)

A filled disc around the center. Concentric circles make a quick gauge face or an eye.

### tft.setRotation(1)

Turns the drawing by quarter turns. On round glass it mostly matters for where text and the 12 o’clock mark end up.

## Example: Round watch face

On the Arduino Uno R3. It runs in the browser exactly as printed.

sketch.ino · Arduino Uno R3

Open it in the editor, wired and ready to run · Round watch face: the project page

## Common errors and how to fix them

### The screen stays black, or shows only a flash of noise

Check that DC and CS match the constructor and that the module’s SDA and SCL go to MOSI and SCK (11 and 13 on an Uno). Despite the labels these pins are SPI, not I2C.

### Text near the edge is cut off

The corners of the 240x240 memory are outside the round glass. Keep anything you need to read inside a circle of radius about 110 from (120, 120).

### The display flickers badly when the clock updates

The sketch clears the whole screen every second. Erase only what moved, by drawing the old hand or digits in the background color, then draw the new ones.

## Questions and answers

### Is the GC9A01 an I2C display?

No. The pins are often labeled SDA and SCL, but they carry SPI data and clock, and the module also needs DC and CS.

## Projects that use Adafruit GC9A01A

Built-in projects that include it. Each page has the full sketch and opens in the editor, already wired.

Animatronic eyes Two GC9A01 round displays, one on each side of an ESP32: eyes that glide to follow a joystick, blink on their own or when it is pressed, and drift when nobody is steering. Desk buddy robot Animated robot eyes on a round GC9A01: it blinks and glances about, beams when you stroke it, gets dizzy when rocked and lonely when ignored. Moon phase clock The Moon's phase for today, computed from a DS3231 clock and drawn on a round GC9A01 display, with the days left to the next full moon.

## Keep going

### Learn

- Arduino GC9A01: Round Display Library and Example
- Arduino DS3231 Clock With a TM1637 Display

### Parts

- Round display, GC9A01

### More displays libraries

- Adafruit SSD1306
- Adafruit GFX Library
- LiquidCrystal I2C
- LiquidCrystal
- LCD_I2C
- hd44780
- TFT_eSPI
- U8g2
- SevenSegmentTM1637
- OLED_I2C
- Adafruit PCD8544 Nokia 5110 LCD library
- LedController
- DigitLedDisplay

Every built-in library · Open the editor

## Try Adafruit GC9A01A without installing anything

Open the example, change the sketch, and keep your version in a free account.

Start building free

Open the editor
