# Adafruit 1.28" 240x240 Round TFT LCD

## Overview

![](https://cdn-learn.adafruit.com/assets/assets/000/135/088/medium800thumb/adafruit_products_6178-04.jpg?1738976876)

'Round these parts we enjoy unusually-shaped displays. And this one certainly fits the description - it's a 1.28" diagonal TFT that comes in a round shape and contains a high density 220 ppi, 240x240 pixel RGB display with full-angle viewing.

It&nbsp;_looks_ a lot like our [1.54" 240x240 square display](https://www.adafruit.com/product/3787), but with the edges beveled off. We've seen displays like this often used in smartwatches and small electronic devices but they've always been MIPI interface. Finally, we found one that is SPI and has a friendly display driver, so it works with any and all microcontrollers or microcomputers!

![](https://cdn-learn.adafruit.com/assets/assets/000/135/089/medium800/adafruit_products_6178-03.jpg?1738976932)

This lovely little display breakout is the best way to add a small, round, colorful and very bright display to any project. Since the display uses 4-wire SPI to communicate and has its own pixel-addressable frame buffer, it can be used with every kind of microcontroller. Even a very small one with low memory and few pins available! The 1.28" display has 240x240 16-bit full color pixels and is an **IPS** display, so the color looks great up to 80 degrees off axis in any direction. The TFT driver (GC9A01A) is very similar to the popular ST7789, [and our Arduino library supports it well](https://github.com/adafruit/Adafruit_GC9A01A).

![](https://cdn-learn.adafruit.com/assets/assets/000/135/090/medium800/adafruit_products_6178-02.jpg?1738976972)

The breakout has the TFT display soldered on (it uses a delicate flex-circuit connector) as well as an ultra-low-dropout 3.3V regulator, auto-reset circuitry, and a 3/5V level shifter so you can use it with 3.3V or 5V power and logic. We also had a little extra space, so we placed a microSD card holder so you can easily load full color bitmaps from a FAT16/FAT32 formatted microSD card. The microSD card is not included, [but you can pick one up here](https://www.adafruit.com/product/5251).

![](https://cdn-learn.adafruit.com/assets/assets/000/135/091/medium800/adafruit_products_6178-01.jpg?1738977001)

Of course, we wouldn't just leave you with a datasheet and a "good luck!" - [we've written a full open-source graphics Arduino library that can draw pixels, lines, rectangles, circles, text, and bitmaps as well as example code](https://github.com/adafruit/Adafruit_GC9A01A). The code is written for Arduino but can be easily ported to your favorite microcontroller! Wiring is easy, we strongly encourage using the hardware SPI pins of your Arduino as software SPI is noticeably slower when dealing with this size display. [For Raspberry Pi or other Single Board Computer Python users, we have a user-space Pillow-compatible library](https://github.com/adafruit/Adafruit_CircuitPython_RGB_Display). For [CircuitPython there's a contributed displayio driver for native support](https://github.com/tylercrumpton/CircuitPython_GC9A01).

This display breakout also features a [18-pin "EYESPI" standard FPC connector](https://www.adafruit.com/?q=eyespi&sort=BestMatch) with flip-top connector. [You can use a 18-pin 0.5mm pitch FPC cable](https://www.adafruit.com/product/5239) **(not included!)** to connect to all the GPIO pins, for when you want to skip the soldering.

# Adafruit 1.28" 240x240 Round TFT LCD

## Pinouts

![](https://cdn-learn.adafruit.com/assets/assets/000/135/087/medium800/adafruit_products_double.jpg?1738976110)

## Power Pins

- **V+ / Vin** &nbsp;- This is the power pin. To power the board, give it the same power as the logic level of your microcontroller - e.g. for a 3V microcontroller like a Feather M4, use 3V, or for a 5V microcontroller like Arduino, use 5V.
- **3V / 3Vo** - This is the output from the onboard 3.3V regulator. If you have a need for a clean 3.3V output, you can use this! It can provide at least 100mA output.
- **G / Gnd** - This is common ground for power and logic.

## SPI Pins

- **SCK** - this is the **S** PI **C** loc **k** pin. Use 3-5V logic level.
- **MOSI** - this is the **S** erial **Da** ta In / **M** icrocontroller **O** ut **S** ensor **I** n pin. It is used to send data from the microcontroller to the SD card and/or TFT. Use either a 3.3 or 5V logic level
- **MISO** - this is the **S** erial **D** ata **O** ut / **M** icrocontroller **I** n **S** ensor **O** ut pin. It is used for the SD card. It isn't used for the TFT display which is write-only. It is 3.3V logic out (but can be read by 5V logic)
- **TFTCS** - this is the&nbsp; **TFT**  **C** hip **S** elect pin. Use either a 3.3 or 5V logic level

## Other Pins

- **RST** - This is the TFT reset pin. Connect to ground to reset the TFT! It's best to have this pin controlled by the library so the display is reset cleanly, but you can also connect it to the microcontroller Reset pin, which works for most cases. There is an automatic-reset chip connected so it will reset on power-up. Use either a 3.3 or 5V logic level
- **DC** - This is the TFT SPI data or command selector pin. Use either a 3.3 or 5V logic level
- **CC / SDCS** - This is the SD card chip select pin, used if you want to read from the SD card. Use either a 3.3 or 5V logic level
- **BL / Lite** - This is the PWM input for the backlight control. It is by default pulled high (backlight on) you can PWM at any frequency or pull down to turn the backlight off. Use either a 3.3V or 5V logic level

## micro SD Card Slot

- On the back of the board, towards the middle, is the micro SD card slot. You can use any micro SD card that supports SPI mode with one CS pin.

## EYESPI Connector

At the top edge of the back of the display is the EYESPI connector. This 18-pin FPC connector allows you to connect EYESPI-compatible displays using an EYESPI cable, with no soldering or jumper wires needed. All of the pins broken out at the bottom of the display board are available through the EYESPI connector:

1. VIN (3 to 5V DC power)
2. Backlight (Use either a 3.3 or 5V logic level, PWM optional input)
3. Ground
4. SPI Clock (Use either a 3.3 or 5V logic level in)
5. SPI MOSI (Use either a 3.3 or 5V logic level Microcontroller Out, Screen/SD In)
6. SPI MISO (Use either a 3.3 or 5V logic level Microcontroller In, Screen/SD Out)
7. TFT Data/Command (Use either a 3.3 or 5V logic level in)
8. TFT Reset (optional either a 3.3 or 5V logic level in)
9. TFT SPI Chip Select (Use either a 3.3 or 5V logic level in)
10. SD Card SPI Chip Select (Use either a 3.3 or 5V logic level in)
11. Unused
12. Unused
13. Unused
14. Unused
15. Unused
16. Unused
17. Unused
18. Unused

# Adafruit 1.28" 240x240 Round TFT LCD

## Plugging in an EYESPI Cable

![](https://cdn-learn.adafruit.com/assets/assets/000/116/975/medium800/adafruit_products_edited_P1390328.jpg?1670356850)

You can connect an EYESPI compatible display to the EYESPI breakout board using an EYESPI cable. An EYESPI cable is an 18 pin flexible PCB (FPC). The FPC can only be connected properly in one orientation, so be sure to follow the steps below to ensure that your display and breakout are plugged in properly.

Each EYESPI cable has **blue stripes** on either end. On the other side of the cable, underneath the blue stripe, are the connector pins that make contact with the FPC connector pins on the display or breakout.

![adafruit_products_cableStripe.gif](https://cdn-learn.adafruit.com/assets/assets/000/116/970/medium640thumb/adafruit_products_cableStripe.jpg?1670356463)

To begin inserting an EYESPI cable to an FPC connector, gently lift the FPC connector black latch up.&nbsp;

![adafruit_products_liftLatch.gif](https://cdn-learn.adafruit.com/assets/assets/000/116/971/medium640thumb/adafruit_products_liftLatch.jpg?1670356608)

Then, insert the EYESPI cable into the open FPC connector by sliding the cable into the connector. You want to **see the blue stripe facing up towards you**. This inserts the cable pins into the FPC connector.

![adafruit_products_insertCable.gif](https://cdn-learn.adafruit.com/assets/assets/000/116/972/medium640thumb/adafruit_products_insertCable.jpg?1670356741)

To secure the cable, lower the FPC connector latch onto the EYESPI cable.

![adafruit_products_lowerLatch.gif](https://cdn-learn.adafruit.com/assets/assets/000/116/973/medium640thumb/adafruit_products_lowerLatch.jpg?1670356793)

Repeat this process for the FPC connector on your display. Again, ensure that the **blue stripe** on either end of the cable is facing up.

![adafruit_products_edited_P1390333.jpg](https://cdn-learn.adafruit.com/assets/assets/000/116/974/medium640/adafruit_products_edited_P1390333.jpg?1670356806)

# Adafruit 1.28" 240x240 Round TFT LCD

## CircuitPython

Using the 240x240 round TFT with CircuitPython involves wiring up the display to your board and loading the code and necessary libraries onto your board to see the graphics test on the display.

You can wire up the display with a breadboard or using an EYESPI breakout board.

### Adafruit EYESPI Breakout Board - 18 Pin FPC Connector

[Adafruit EYESPI Breakout Board - 18 Pin FPC Connector](https://www.adafruit.com/product/5613)
Our most recent [display breakouts have come with a new feature:&nbsp;an 18-pin "EYE SPI" standard FPC connector with flip-top connector](https://www.adafruit.com/?q=eyespi&sort=BestMatch). This is intended to be a sort-of "<a...></a...>

In Stock
[Buy Now](https://www.adafruit.com/product/5613)
[Related Guides to the Product](https://learn.adafruit.com/products/5613/guides)
![Overhead video of a 1.9" TFT display connected via 18-pin FPC ribbon cable to a square-shaped microcontroller on a breadboard. The TFT plays an animated boot-up demo.](https://cdn-shop.adafruit.com/product-videos/640x480/5613-06.jpg)

### EYESPI Cable - 18 Pin 100mm long Flex PCB (FPC) A-B type

[EYESPI Cable - 18 Pin 100mm long Flex PCB (FPC) A-B type](https://www.adafruit.com/product/5239)
Connect this to that when a 18-pin FPC connector is needed. This 25 cm long cable is made of a flexible PCB. It's A-B style which means that pin one on one side will match with pin one on the other side. How handy!

<a...></a...>

In Stock
[Buy Now](https://www.adafruit.com/product/5239)
[Related Guides to the Product](https://learn.adafruit.com/products/5239/guides)
![Angled shot of a EYESPI Cable - 18 Pin 100mm long Flex PCB (FPC) A-B type. ](https://cdn-shop.adafruit.com/640x480/5239-00.jpg)

## Wiring

First, wire the TFT to your CircuitPython-compatible microcontroller. The diagram below shows wiring up to a Feather RP2040 with an EYESPI breakout:

- **Feather 3.3V** to **breakout Vin (red wire)**
- **Feather GND** to **breakout Gnd (black wire)**
- **Feather SCK** to **breakout SCK (cyan wire)**
- **Feather MO** to **breakout MOSI (purple wire)**
- **Feather MI** to **breakout MISO (orange wire)**
- **Feather D9** to **breakout RST (blue wire)**
- **Feather D6** to **breakout DC (yellow wire)**
- **Feather D5** to **breakout TCS (pink wire)**

Attach the **TFT screen to the EYESPI breakout** with an **EYESPI cable** as described on the [Plugging in an EYESPI Cable](https://learn.adafruit.com/adafruit-1-28-240x240-round-tft-lcd/plugging-in-an-eyespi-cable) page.

![adafruit_products_featherEYESPI_bb.jpg](https://cdn-learn.adafruit.com/assets/assets/000/135/208/medium640/adafruit_products_featherEYESPI_bb.jpg?1739223335)

The following is the TFT wired to a Feather RP2040 using a solderless breadboard:

- **Feather 3.3V** to **TFT V+ (red wire)**
- **Feather GND** to **TFT G (black wire)**
- **Feather SCK** to **TFT SCK (cyan wire)**
- **Feather MO** to **TFT MOSI (purple wire)**
- **Feather MI** to **TFT MISO (orange wire)**
- **Feather D9** to **TFT RST (blue wire)**
- **Feather D6** to **TFT DC (yellow wire)**
- **Feather D5** to **TFT TCS (pink wire)**

![adafruit_products_featherBB_bb.jpg](https://cdn-learn.adafruit.com/assets/assets/000/135/209/medium640/adafruit_products_featherBB_bb.jpg?1739223396)

## CircuitPython Usage

To use with CircuitPython, you need to first install the necessary libraries, and their dependencies, into the **lib** folder on your **CIRCUITPY** drive. Then you need to update **code.py** with the example script.

Thankfully, we can do this in one go. In the example below, click the **Download Project Bundle** button below to download the necessary libraries and the **code.py** file in a zip file. Extract the contents of the zip file.

Connect the microcontroller to your computer via a known-good USB power+data cable. The board shows up as a thumb drive named **CIRCUITPY**. Copy the **entire lib folder** , **blinka\_round.bmp** bitmap file&nbsp;and the **code.py** file to your **CIRCUITPY** drive.

Your **CIRCUITPY/lib** folder should contain the following folders and files:

- **/adafruit\_bitmap\_font**
- **/adafruit\_display\_text**
- **/adafruit\_imageload**
- **adafruit\_gc9a01a.mpy**
- **adafruit\_ticks.mpy**

Once you have copied over the necessary folders and files, your **CIRCUITPY** drive should resemble the following:

![CIRCUITPY](https://adafruit.github.io/Adafruit_Learning_System_Guides/GC9A01A_Demo_Code_CircuitPython_GC9A01A.png )

## Example Code
https://github.com/adafruit/Adafruit_Learning_System_Guides/blob/main/GC9A01A_Demo_Code/CircuitPython_GC9A01A/code.py

After running the code, you should see a green circle appear on your display, followed by a smaller, inset purple circle, and finally, yellow text centered on the display saying, "Hello World!". This is followed by a bitmap of Blinka in her ouroboros circular pose. The two graphics will alternate being displayed every 2 seconds.

![](https://cdn-learn.adafruit.com/assets/assets/000/135/253/medium800thumb/adafruit_products_roundDisplayCP.jpg?1739290403)

# Adafruit 1.28" 240x240 Round TFT LCD

## CircuitPython Docs

# Adafruit 1.28" 240x240 Round TFT LCD

## Python

It's easy to use display breakouts with Python and the [Adafruit CircuitPython RGB Display](https://github.com/adafruit/Adafruit_CircuitPython_RGB_Display) module. This module allows you to easily write Python code to control the display.

Since there's _dozens_ of Linux computers/boards you can use we will show wiring for Raspberry Pi. For other platforms, [please visit the guide for CircuitPython on Linux to see whether your platform is supported](https://learn.adafruit.com/circuitpython-on-raspberrypi-linux).

You can wire up the TFT to your Raspberry Pi using a breadboard, [EYESPI breakout](https://www.adafruit.com/product/5613) or [EYESPI Pi Beret](https://www.adafruit.com/product/5783).

### Adafruit EYESPI Breakout Board - 18 Pin FPC Connector

[Adafruit EYESPI Breakout Board - 18 Pin FPC Connector](https://www.adafruit.com/product/5613)
Our most recent [display breakouts have come with a new feature:&nbsp;an 18-pin "EYE SPI" standard FPC connector with flip-top connector](https://www.adafruit.com/?q=eyespi&sort=BestMatch). This is intended to be a sort-of "<a...></a...>

In Stock
[Buy Now](https://www.adafruit.com/product/5613)
[Related Guides to the Product](https://learn.adafruit.com/products/5613/guides)
![Overhead video of a 1.9" TFT display connected via 18-pin FPC ribbon cable to a square-shaped microcontroller on a breadboard. The TFT plays an animated boot-up demo.](https://cdn-shop.adafruit.com/product-videos/640x480/5613-06.jpg)

### Adafruit EYESPI Pi Beret - Buttons, EYESPI and STEMMA QT

[Adafruit EYESPI Pi Beret - Buttons, EYESPI and STEMMA QT](https://www.adafruit.com/product/5783)
Raspberry Pi's make for handy lil computers, but they're really wonderful when you can connect all sorts of nifty hardware to them: color TFT or E-Ink displays, and sensors are our go-to favorites. Even better is when we make it fast and effortless to wire these up. With this new...

In Stock
[Buy Now](https://www.adafruit.com/product/5783)
[Related Guides to the Product](https://learn.adafruit.com/products/5783/guides)
![Overhead shot of long, black, slim add-on board installed on a Raspberry Pi computer and cabled to a sensor board and an electronic ink display.](https://cdn-shop.adafruit.com/640x480/5783-04.jpg)

### EYESPI Cable - 18 Pin 100mm long Flex PCB (FPC) A-B type

[EYESPI Cable - 18 Pin 100mm long Flex PCB (FPC) A-B type](https://www.adafruit.com/product/5239)
Connect this to that when a 18-pin FPC connector is needed. This 25 cm long cable is made of a flexible PCB. It's A-B style which means that pin one on one side will match with pin one on the other side. How handy!

<a...></a...>

In Stock
[Buy Now](https://www.adafruit.com/product/5239)
[Related Guides to the Product](https://learn.adafruit.com/products/5239/guides)
![Angled shot of a EYESPI Cable - 18 Pin 100mm long Flex PCB (FPC) A-B type. ](https://cdn-shop.adafruit.com/640x480/5239-00.jpg)

## Wiring

Here is how you'll connect your Raspberry Pi to the round TFT with an EYESPI breakout.

- **Pi 3V** to **breakout VIN (red wire)**
- **Pi GND** to **breakout GND (black wire)**
- **Pi SLCK (GPIO 11)** to **breakout SCK (blue wire)**
- **Pi MISO (GPIO 9)** to **breakout MISO (green wire)**
- **Pi MOSI (GPIO 10)** to **breakout MOSI (yellow wire)**
- **Pi CE0 (GPIO 8)** to **breakout TCS (purple wire)**
- **Pi GPIO 25** to **breakout DC (white wire)**
- **Pi GPIO 27** to **breakout RST (pink wire)**

**Attach the**  **TFT screen** to the **EYESPI breakout** with an **EYESPI cable** as described on the [Plugging in an EYESPI Cable](https://learn.adafruit.com/adafruit-1-28-240x240-round-tft-lcd/plugging-in-an-eyespi-cable) page.

![adafruit_products_piEYESPI_bb.jpg](https://cdn-learn.adafruit.com/assets/assets/000/135/212/medium640/adafruit_products_piEYESPI_bb.jpg?1739223810)

The following is the TFT wired to a Raspberry Pi using a solderless breadboard:

- **Pi 3V** to **TFT V+ (red wire)**
- **Pi GND** to **TFT G (black wire)**
- **Pi SLCK (GPIO 11)** to **TFT SCK (blue wire)**
- **Pi MISO (GPIO 9)** to **TFT MISO (green wire)**
- **Pi MOSI (GPIO 10)** to **TFT MOSI (yellow wire)**
- **Pi CE0 (GPIO 8)** to **TFT TCS (purple wire)**
- **Pi GPIO 25** to **TFT DC (white wire)**
- **Pi GPIO 27** to **TFT RST (pink wire)**

![adafruit_products_piBB_bb.jpg](https://cdn-learn.adafruit.com/assets/assets/000/135/213/medium640/adafruit_products_piBB_bb.jpg?1739223856)

## Software Setup

You'll need to install the Adafruit\_Blinka library that provides the CircuitPython support in Python. This may also require enabling SPI on your platform and verifying you are running Python 3. [Since each platform is a little different, and Linux changes often, please visit the CircuitPython on Linux guide to get your computer ready](https://learn.adafruit.com/circuitpython-on-raspberrypi-linux)!

### Python Installation of RGB Display Library

Once that's done, from your command line run the following command:

- `sudo pip3 install adafruit-circuitpython-rgb-display`

If your default Python is version 3 you may need to run 'pip' instead. Just make sure you aren't trying to use CircuitPython on Python 2.x, it isn't supported!

If that complains about pip3 not being installed, then run this first to install it:

- `sudo apt-get install python3-pip`

### DejaVu TTF Font

Run the following command to install the DejaVu font:

- `sudo apt-get install fonts-dejavu`

### Pillow Library

We also need PIL, the Python Imaging Library, to allow graphics and using text with custom fonts. There are several system libraries that PIL relies on, so installing via a package manager is the easiest way to bring in everything:

- `sudo apt-get install python3-pil`

If you installed the PIL through PIP, you may need to install some additional libraries:

- `sudo apt-get install libopenjp2-7 libtiff5 libatlas-base-dev`

### Blinka JPEG

Save the JPEG image of Blinka in the same directory as your **code.py** file. You can download the image from here or through the Project Bundle from GitHub.

![](https://cdn-learn.adafruit.com/assets/assets/000/135/202/medium800/adafruit_products_blinka_round.jpg?1739199210)

## Python Usage

Once you have all of the requirements installed on your Raspberry Pi, copy or download the following example, and run the following, replacing&nbsp; **code.py** &nbsp;with whatever you named the file:

`python3 code.py`

## Example Code
https://github.com/adafruit/Adafruit_Learning_System_Guides/blob/main/GC9A01A_Demo_Code/Python_GC9A01A/code.py

You'll see the graphics example show on the TFT. First, you'll see a purple circle on top of a green circle with the text "Hello World!" in the center. Then, you'll see the Blinka JPEG displayed. These two images will swap back and forth in the loop.

![](https://cdn-learn.adafruit.com/assets/assets/000/135/252/medium800thumb/adafruit_products_roundDisplayCP.jpg?1739290377)

# Adafruit 1.28" 240x240 Round TFT LCD

## Python Docs

# Adafruit 1.28" 240x240 Round TFT LCD

## Arduino

Using the 240x240 Round TFT Display with Arduino involves wiring up the display to your Arduino-compatible board, installing the libraries and running the provided example code.

You can wire up the display with a breadboard or using an EYESPI breakout board.

### Adafruit EYESPI Breakout Board - 18 Pin FPC Connector

[Adafruit EYESPI Breakout Board - 18 Pin FPC Connector](https://www.adafruit.com/product/5613)
Our most recent [display breakouts have come with a new feature:&nbsp;an 18-pin "EYE SPI" standard FPC connector with flip-top connector](https://www.adafruit.com/?q=eyespi&sort=BestMatch). This is intended to be a sort-of "<a...></a...>

In Stock
[Buy Now](https://www.adafruit.com/product/5613)
[Related Guides to the Product](https://learn.adafruit.com/products/5613/guides)
![Overhead video of a 1.9" TFT display connected via 18-pin FPC ribbon cable to a square-shaped microcontroller on a breadboard. The TFT plays an animated boot-up demo.](https://cdn-shop.adafruit.com/product-videos/640x480/5613-06.jpg)

### EYESPI Cable - 18 Pin 100mm long Flex PCB (FPC) A-B type

[EYESPI Cable - 18 Pin 100mm long Flex PCB (FPC) A-B type](https://www.adafruit.com/product/5239)
Connect this to that when a 18-pin FPC connector is needed. This 25 cm long cable is made of a flexible PCB. It's A-B style which means that pin one on one side will match with pin one on the other side. How handy!

<a...></a...>

In Stock
[Buy Now](https://www.adafruit.com/product/5239)
[Related Guides to the Product](https://learn.adafruit.com/products/5239/guides)
![Angled shot of a EYESPI Cable - 18 Pin 100mm long Flex PCB (FPC) A-B type. ](https://cdn-shop.adafruit.com/640x480/5239-00.jpg)

## Wiring

Wire as shown for a **5V** board like an Uno. If you are using a **3V** board, like an Adafruit Feather, wire the board's 3V pin to the breakout VDD.

Here is an Adafruit Metro wired up to the TFT with an EYESPI breakout.

- **Board 5V** to **breakout VIN (red wire)**
- **Board GND** to **breakout GND (black wire)**
- **Board pin 13** to **breakout SCK (blue wire)**
- **Board pin 12** to **breakout MISO (green wire)**
- **Board pin 11** to **breakout MOSI (yellow wire)**
- **Board pin 10** to **breakout TCS (purple wire)**
- **Board pin 9** to **breakout RST (orange wire)**
- **Board pin 8** to **breakout DC (white wire)**

**Attach the**  **TFT screen** to the **EYESPI breakout** with an **EYESPI cable** as described on the [Plugging in an EYESPI Cable](https://learn.adafruit.com/adafruit-1-28-240x240-round-tft-lcd/plugging-in-an-eyespi-cable) page.

![adafruit_products_arduinoEYESPI_bb.jpg](https://cdn-learn.adafruit.com/assets/assets/000/135/214/medium640/adafruit_products_arduinoEYESPI_bb.jpg?1739223903)

The following is the TFT wired to an Adafruit Metro using a solderless breadboard:

- **Board 5V** to **TFT VIN (red wire)**
- **Board GND** to **TFT GND (black wire)**
- **Board pin 13** to **TFT SCK (blue wire)**
- **Board pin 12** to **TFT MISO (green wire)**
- **Board pin 11** to **TFT MOSI (yellow wire)**
- **Board pin 10** to **TFT TCS (purple wire)**
- **Board pin 9** to **TFT RST (orange wire)**
- **Board pin 8** to **TFT DC (white wire)**

![adafruit_products_arduinoBB_bb.jpg](https://cdn-learn.adafruit.com/assets/assets/000/135/215/medium640/adafruit_products_arduinoBB_bb.jpg?1739223925)

## Library Installation

You can install the&nbsp; **Adafruit GC9A01A&nbsp;** library&nbsp;for Arduino using the Library Manager in the Arduino IDE.

![](https://cdn-learn.adafruit.com/assets/assets/000/135/203/medium800/adafruit_products_Arduino_Open_Library_Manager.png?1739200947)

Click the&nbsp; **Manage Libraries ...** &nbsp;menu item, search for&nbsp; **Adafruit GC9A01A** ,&nbsp;and select the&nbsp; **Adafruit GC9A01A** &nbsp;library:

![](https://cdn-learn.adafruit.com/assets/assets/000/135/216/medium800/adafruit_products_Screenshot_2025-02-10_150901.png?1739223970)

If asked about dependencies, click "Install all".

![](https://cdn-learn.adafruit.com/assets/assets/000/135/217/medium800/adafruit_products_Screenshot_2025-02-10_150913.png?1739223984)

If the "Dependencies" window does not come up, then you already have the dependencies installed.&nbsp;

Warning: If the dependencies are already installed, you must make sure you update them through the Arduino Library Manager before loading the example!

## Example Code
https://github.com/adafruit/Adafruit_Learning_System_Guides/blob/main/GC9A01A_Demo_Code/Arduino_GC9A01A/Arduino_GC9A01A.ino

Upload the sketch to your board. You should see a modified graphics test begin running on your display. The tests include drawing shapes, graphs and text. After every loop of the test, the code will rotate the screen orientation by 90 degrees and run the test again. The code is heavily commented so you can utilize the examples for various graphic techniques in your projects.

![](https://cdn-learn.adafruit.com/assets/assets/000/135/251/medium800thumb/adafruit_products_roundDisplayArduino.jpg?1739290244)

# Adafruit 1.28" 240x240 Round TFT LCD

## Arduino Docs

# Adafruit 1.28" 240x240 Round TFT LCD

## Downloads

## Files

- [GC9A01A Datasheet](https://cdn-learn.adafruit.com/assets/assets/000/135/078/original/GC9A01A.pdf?1738962643)
- [TFT Display Datasheet](https://cdn-shop.adafruit.com/product-files/6178/round+TFT+1.28in+GC9A01.png)
- [EagleCAD PCB files on GitHub](https://github.com/adafruit/Adafruit-1.28-240x240-Round-Display-PCB)
- [3D models on GitHub](https://github.com/adafruit/Adafruit_CAD_Parts/tree/main/6178%201.28in%20Round%20TFT)
- [Fritzing object in the Adafruit Fritzing Library](https://github.com/adafruit/Fritzing-Library/blob/master/parts/Adafruit%201.28%20240x240%20Round%20Display.fzpz)

## Schematic and Fab Print
![](https://cdn-learn.adafruit.com/assets/assets/000/135/082/medium800/adafruit_products_schem.png?1738964031)

![](https://cdn-learn.adafruit.com/assets/assets/000/135/083/medium800/adafruit_products_fab.png?1738964038 dimensions are in inches)

![](https://cdn-learn.adafruit.com/assets/assets/000/136/279/medium800/adafruit_products_6178_1.28in_Round_TFT.jpg?1744659860 )


## Primary Products

### Adafruit 1.28" 240x240 Round TFT LCD Display with MicroSD

[Adafruit 1.28" 240x240 Round TFT LCD Display with MicroSD](https://www.adafruit.com/product/6178)
'Round these parts we enjoy unusually-shaped displays. And this one certainly fits the description - it's a 1.28" diagonal TFT that comes in a round shape and contains a high density 220 ppi, 240x240 pixel RGB display with full-angle viewing. It _looks_ a lot like our <a...></a...>

In Stock
[Buy Now](https://www.adafruit.com/product/6178)
[Related Guides to the Product](https://learn.adafruit.com/products/6178/guides)

## Featured Products

### EYESPI Cable - 18 Pin 100mm long Flex PCB (FPC) A-B type

[EYESPI Cable - 18 Pin 100mm long Flex PCB (FPC) A-B type](https://www.adafruit.com/product/5239)
Connect this to that when a 18-pin FPC connector is needed. This 25 cm long cable is made of a flexible PCB. It's A-B style which means that pin one on one side will match with pin one on the other side. How handy!

<a...></a...>

In Stock
[Buy Now](https://www.adafruit.com/product/5239)
[Related Guides to the Product](https://learn.adafruit.com/products/5239/guides)
### EYESPI Cable - 18-pin 50mm long Flex PCB (FPC) A-B Type

[EYESPI Cable - 18-pin 50mm long Flex PCB (FPC) A-B Type](https://www.adafruit.com/product/5462)
Connect this to that when an 18-pin FPC connector is needed. This 50mm long cable is made of a flexible PCB. It's A-B style which means that pin one on one side will match with pin one on the other side. How handy!

<a...></a...>

In Stock
[Buy Now](https://www.adafruit.com/product/5462)
[Related Guides to the Product](https://learn.adafruit.com/products/5462/guides)
### EYESPI Cable - 18 Pin 200mm long Flex PCB (FPC) A-B type

[EYESPI Cable - 18 Pin 200mm long Flex PCB (FPC) A-B type](https://www.adafruit.com/product/5240)
Connect this to that when a 18-pin FPC connector is needed. This 20 cm long cable is made of a flexible PCB. It's A-B style which means that pin one on one side will match with pin one on the other side. How handy!

<a...></a...>

In Stock
[Buy Now](https://www.adafruit.com/product/5240)
[Related Guides to the Product](https://learn.adafruit.com/products/5240/guides)
### Adafruit EYESPI Breakout Board - 18 Pin FPC Connector

[Adafruit EYESPI Breakout Board - 18 Pin FPC Connector](https://www.adafruit.com/product/5613)
Our most recent [display breakouts have come with a new feature:&nbsp;an 18-pin "EYE SPI" standard FPC connector with flip-top connector](https://www.adafruit.com/?q=eyespi&sort=BestMatch). This is intended to be a sort-of "<a...></a...>

In Stock
[Buy Now](https://www.adafruit.com/product/5613)
[Related Guides to the Product](https://learn.adafruit.com/products/5613/guides)

## Related Guides

- [Adafruit EYESPI Breakout Board](https://learn.adafruit.com/adafruit-eyespi-breakout-board.md)
- [QT Py S2 Round Display Compass](https://learn.adafruit.com/qt-py-s2-round-display-compass.md)
- [Adafruit 3.5" 320x480 Color TFT Touchscreen Breakout](https://learn.adafruit.com/adafruit-3-5-color-320x480-tft-touchscreen-breakout.md)
- [Cartoon Character Clock](https://learn.adafruit.com/cartoon-character-clock.md)
- [Adafruit 2.13" 250x122 Quad-Color eInk](https://learn.adafruit.com/adafruit-2-13-250x122-quad-color-eink.md)
- [Adafruit PiCowbell Camera Breakout](https://learn.adafruit.com/adafruit-picowbell-camera-breakout.md)
- [Asteroid Tracker](https://learn.adafruit.com/asteroid-tracker.md)
- [World Clock](https://learn.adafruit.com/world-clock.md)
- [Raspberry Pi I2C Clock Stretching Fixes](https://learn.adafruit.com/raspberry-pi-i2c-clock-stretching-fixes.md)
- [CircuitPython on Raspberry Pi (Bare Metal / No OS)](https://learn.adafruit.com/circuitpython-on-raspberry-pi-bare-metal-no-os.md)
- [Con Badge with Circuit Playground Express](https://learn.adafruit.com/circuit-playground-express-con-badge.md)
- [NeoPixel Infinity Cube](https://learn.adafruit.com/neopixel-infinity-cube.md)
- [Qualia S3 Compass](https://learn.adafruit.com/qualia-s3-compass.md)
- [Adafruit PiCowbell CAN Bus for Pico](https://learn.adafruit.com/adafruit-picowbell-can-bus-for-pico.md)
- [Adafruit PCA9546 4-Channel I2C Multiplexer](https://learn.adafruit.com/adafruit-pca9546-4-channel-i2c-multiplexer.md)
