# Adafruit EYESPI Breakout Board
## Overview
Adafruit's most recent [display breakouts have come with a new feature: 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 "[STEMMA QT](https://learn.adafruit.com/introducing-adafruit-stemma-qt) for displays" - a way to quickly connect and extend display wiring that uses a lot of SPI pins. In this case, we need a lot of SPI pins, and we want to be able to use long distances, so the answer is an 18-pin 0.5mm pitch FPC connector.
Now you can connect to the displays, but what goes on the other side of the FPC? Here is one possibility - a simple breakout board that brings all the GPIO to 0.1" spaced header, for breadboarding use. Each pin usage is labeled, and for most display purposes, you only need the left half of the display for power and SPI connectivity.
Don't forget: you'll also want an [18-pin EYESPI FPC cable](https://www.adafruit.com/product/5462).
# Adafruit EYESPI Breakout Board
## Pinouts
The EYESPI breakout board breaks out all 18 pins of the display connector, for breadboarding use. This breakout is a passthrough for the display connector.
Info:
## Power Pins
- **Vin** - This is the power pin. To power the board (and thus your display), connect to the same power as the logic level of your microcontroller, e.g. for a 3V micro like a Feather, use 3V, and for a 5V micro like an Arduino, use 5V.
- **Gnd** - This is common ground for power and logic.
## I2C Logic Pins
- **SCL** - This is the I2C serial clock pin. Connect to the desired I2C clock pin on your microcontroller.
- **SDA** - This is the I2C serial data pin. Connect to the desired I2C data pin on your microcontroller.
## SPI Pins
- **SCK** - This is the SPI clock input pin.
- **MOSI** - This is the SPI MOSI ( **M** icrocontroller **O** ut / **S** erial **I** n) pin. It is used to send data from the microcontroller to the SD card and/or display.
- **MISO** - This is the SPI MISO ( **M** icrocontroller **I** n / **S** erial **O** ut) pin. It's used for the SD card. It isn't used for the display because it's write-only. It is 3.3V logic out (but can be read by 5V logic).
- **DC** - This is the display SPI data/command selector pin.
- **RST** - This is the display reset pin. Connecting to ground resets the display! 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's Reset pin, which works for most cases. Often, there is an automatic-reset chip on the display which will reset it on power-up, making this connection unnecessary in that case.
- **TCS** - This is the TFT or eInk SPI chip select pin.
## GPIO Pins
- **GP1 and GP2** - These are the GPIO pins.
## Chip Select Pins
- **TSCS** - This is the Touch Screen Chip Select pin.
- **MEMCS** - This is the Memory Chip Select. This pin is required for communicating with the onboard RAM chip.
- **SDCS** - This is the SD card chip select pin. This pin is required for communicating with the onboard SD card holder. You can leave this disconnected if you aren't going to access SD cards.
## Backlight Pin
- **Lite** - This is the PWM input for the backlight control. It is by default pulled high (backlight on), however, you can PWM at any frequency or pull down to turn the backlight off.
## Other Pins
- **BUSY** - This is the busy-detect pin used by eInk displays. It is optional, and if not connected, the code will wait an approximate number of seconds.
- **INT** - This is the capacitive touch interrupt pin. When a touch is detected, this pin goes low. This is only necessary when using a capacitive touch display.
# Adafruit EYESPI Breakout Board
## Plugging in an EYESPI Cable
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.
To begin inserting an EYESPI cable to an FPC connector, gently lift the FPC connector black latch up.
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.
To secure the cable, lower the FPC connector latch onto the EYESPI cable.
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 EYESPI Breakout Board
## CircuitPython
Using the EYESPI breakout with CircuitPython involves wiring up the breakout to your CircuitPython-compatible microcontroller and plugging in your EYESPI-compatible display via an EYESPI cable. Then, you load the code and necessary libraries onto your microcontroller to see the graphics test on the display.
This page uses the 1.54" 240x240 ST7789 TFT display for demonstrating CircuitPython usage. You can use the same concepts to get going with any EYESPI-compatible display.
### Adafruit 1.54" 240x240 Wide Angle TFT LCD Display with MicroSD
[Adafruit 1.54" 240x240 Wide Angle TFT LCD Display with MicroSD](https://www.adafruit.com/product/3787)
We've been looking for a display like this for a long time - it's only 1.5" diagonal but has a high density 220 ppi, 240x240 pixel display with full-angle viewing. It _looks_ a lot like our 1.44" 128x128 display, but has 4x as many pixels and looks great at any angle....
In Stock
[Buy Now](https://www.adafruit.com/product/3787)
[Related Guides to the Product](https://learn.adafruit.com/products/3787/guides)
## Wiring
First, wire the EYESPI breakout to your CircuitPython-compatible microcontroller. The diagram below shows wiring up to a Feather RP2040. Then, connect your EYESPI-compatible display via an EYESPI cable to the breakout.
- **Feather 3.3V** to **breakout Vin**
- **Feather GND** to **breakout Gnd**
- **Feather SCK** to **breakout SCK**
- **Feather MO** to **breakout MOSI**
- **Feather MI** to **breakout MISO**
- **Feather D9** to **breakout RST**
- **Feather D6** to **breakout DC**
- **Feather D5** to **breakout TCS**
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-eyespi-breakout-board/plugging-in-an-eyespi-cable) page.
## 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** , the **tom-thumb.pcf** font file, 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\_st7789.mpy**
Once you have copied over the necessary folders and files, your **CIRCUITPY** drive should resemble the following:
## Example Code
https://github.com/adafruit/Adafruit_CircuitPython_ST7789/blob/main/examples/st7789_simpletest.py
Once everything is copied over, on your display, you should see a green rectangle appear, followed by a smaller, inset purple rectangle, and finally, yellow text centered on the display saying, "Hello World!".
# Adafruit EYESPI Breakout Board
## CircuitPython Docs
# Adafruit EYESPI Breakout Board
## Python
There's two ways you can use the **EYESPI breakout board** with a computer that has GPIO and Python [thanks to Adafruit\_Blinka, our CircuitPython-for-Python compatibility library](https://learn.adafruit.com/circuitpython-on-raspberrypi-linux). You can utilize CPython graphics libraries, such as [PIL](https://pillow.readthedocs.io/en/stable/), when using the EYESPI breakout with Blinka.
Additionally, you can install a kernel module to add support for a supported TFT display that will make the console appear. This is cute because you can have any program print text or draw to the framebuffer (or, say, with pygame) and Linux will take care of displaying it for you. If you **don't** need the console or direct framebuffer access, **please consider using the 'pure Python' technique** instead as it is not as delicate.
Warning:
Below is example wiring and code for an ST7789 TFT display using the [Adafruit\_CircuitPython\_RGB\_Display](https://github.com/adafruit/Adafruit_CircuitPython_RGB_Display) library.
### Adafruit 1.54" 240x240 Wide Angle TFT LCD Display with MicroSD
[Adafruit 1.54" 240x240 Wide Angle TFT LCD Display with MicroSD](https://www.adafruit.com/product/3787)
We've been looking for a display like this for a long time - it's only 1.5" diagonal but has a high density 220 ppi, 240x240 pixel display with full-angle viewing. It _looks_ a lot like our 1.44" 128x128 display, but has 4x as many pixels and looks great at any angle....
In Stock
[Buy Now](https://www.adafruit.com/product/3787)
[Related Guides to the Product](https://learn.adafruit.com/products/3787/guides)
## Python Computer Wiring
Since there's _dozens_ of Linux computers/boards you can use, below shows 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).
Here's the Raspberry Pi wired to the EYESPI breakout board connected to an ST7789 1.54" 240x240 TFT Display:
- **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 24** 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-eyespi-breakout-board/plugging-in-an-eyespi-cable) page.
## Python Installation of the RGB Display Library
You'll need to install the **Adafruit\_Blinka** library that provides the CircuitPython support in Python. This may also require enabling I2C 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)!
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. Make sure you aren't trying to use CircuitPython on Python 2.x, it isn't supported!
## Python Usage
Once you have the library `pip3` installed on your computer, copy or download the following example to your computer, and run the following, replacing **code.py** with whatever you named the file:
`python3 code.py`
## Example Code
https://github.com/adafruit/Adafruit_CircuitPython_RGB_Display/blob/main/examples/rgb_display_pillow_demo.py
## Edit the Code for the ST7789 Display
In the code, comment out the ILI9341 `disp` object and replace it with an ST7789 `disp` object:
```python
'''disp = ili9341.ILI9341(
spi,
rotation=90, # 2.2", 2.4", 2.8", 3.2" ILI9341
cs=cs_pin,
dc=dc_pin,
rst=reset_pin,
baudrate=BAUDRATE,
)'''
disp = st7789.ST7789(
spi,
height=240,
y_offset=80,
rotation=180,
cs=cs_pin,
dc=dc_pin,
rst=reset_pin,
baudrate=BAUDRATE,
)
```
The code begins by instantiating your display over SPI. Then, a green rectangle is drawn, followed by a smaller purple rectangle. The text `"Hello World"` is displayed over both of the rectangles.
## Kernel Module Install
You can install a kernel module using one of Adafruit's [Raspberry-Pi-Installer-Scripts](https://github.com/adafruit/Raspberry-Pi-Installer-Scripts) to view your Raspberry Pi's terminal or desktop on a display connected to the EYESPI breakout board. This can be handy for projects such as cyberdecks or headless setups. Please proceed with caution though, as it can be tricky to setup and you may find that a 'pure Python' method with Blinka and Pillow (detailed above) can answer your Raspberry Pi display needs.
The following will detail an example of showing the terminal via an ST7789 display. If you want to run it on a different display, please reference [this guide on PiTFT](https://learn.adafruit.com/adafruit-pitft-28-inch-resistive-touchscreen-display-raspberry-pi/easy-install-2), which has terminal inputs for all of the supported displays.
[PiTFT Display for Raspberry Pi Learn Guide - Installation Page](https://learn.adafruit.com/adafruit-pitft-28-inch-resistive-touchscreen-display-raspberry-pi/easy-install-2)
## Prepare the Pi
After [wiring your ST7789 display to the Raspberry Pi with the EYESPI breakout as detailed above](https://learn.adafruit.com/adafruit-eyespi-breakout-board/python#python-computer-wiring-3132690), its a good idea to get your Pi completely updated and upgraded. We assume you have burned an SD card and can log into the console to install stuff.
To update and upgrade, run:
```terminal
sudo apt update -y
sudo apt-get update -y
sudo apt-get upgrade -y
```
Then, reboot the Pi with:
```terminal
sudo reboot
```
Then, run the following at the terminal:
```terminal
cd ~
sudo pip3 install --upgrade adafruit-python-shell click
sudo apt-get install -y git
git clone https://github.com/adafruit/Raspberry-Pi-Installer-Scripts.git
cd Raspberry-Pi-Installer-Scripts
sudo python3 adafruit-pitft.py --display=st7789_240x240 --rotation=0 --install-type=console
```
When you get asked to reboot, reboot!
After rebooting, you'll see the terminal on the ST7789 TFT display.
## Uninstall the Kernel Module
If you decide that you no longer want to show the terminal on the ST7789 display, you can run the following at the terminal:
```terminal
cd ~
cd Raspberry-Pi-Installer-Scripts
sudo python3 adafruit-pitft.py --install-type=uninstall
```
When you get asked to reboot, reboot!
After rebooting, you'll be brought to the terminal on your HDMI connected display. If you want to get back to the desktop, enter `startx` into the terminal.
```terminal
startx
```
To permanently boot to the desktop going forward, enter the `raspi-config` tool via the terminal with:
```terminal
sudo raspi-config
```
Select **1 System Options** in the menu.
On the next screen, select **S5 Boot / Auto Login**.
Finally, select **B4 Desktop Autologin** to return to the default desktop login mode.
Exit the `raspi-config` by selecting **Finish**. When prompted to reboot, select **Yes**.
# Adafruit EYESPI Breakout Board
## Python Docs
# Adafruit EYESPI Breakout Board
## Arduino
Using the EYESPI breakout with Arduino involves wiring up the breakout to your Arduino-compatible microcontroller, plugging in your EYESPI compatible screen via the EYESPI cable, installing the library for your display type and running the provided example code.
Below is example wiring and code for an ILI9341 TFT display using the [Adafruit\_ILI9341](https://github.com/adafruit/Adafruit_ILI9341) library.
### 2.2" 18-bit color TFT LCD display with microSD card breakout
[2.2" 18-bit color TFT LCD display with microSD card breakout](https://www.adafruit.com/product/1480)
This lovely little display breakout is the best way to add a small, colorful, and 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...
In Stock
[Buy Now](https://www.adafruit.com/product/1480)
[Related Guides to the Product](https://learn.adafruit.com/products/1480/guides)
## 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 EYESPI breakout VIN.
Here is an Adafruit Metro wired up to the EYESPI breakout with an ILI9341 240x320 2.2" TFT Display:
- **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-eyespi-breakout-board/plugging-in-an-eyespi-cable) page.
## Library Installation
You can install the **Adafruit ILI9341 ** library for Arduino using the Library Manager in the Arduino IDE.
Click the **Manage Libraries ...** menu item, search for **Adafruit ILI9341** , and select the **Adafruit\_ILI9341** library:
If asked about dependencies, click "Install all".
If the "Dependencies" window does not come up, then you already have the dependencies installed.
Warning:
## Example Code
https://github.com/adafruit/Adafruit_Learning_System_Guides/blob/main/EYESPI/Arduino/Color/EYESPI_Test/EYESPI_Test.ino
The example code uses the product ID number of your display to determine which library and attributes to select when running the code. This section is located at the top of the code. By default, the code uses product ID `5393`.
```cpp
// *** EDIT THIS VALUE TO MATCH THE ADAFRUIT PRODUCT ID FOR YOUR DISPLAY: ***
#define SCREEN_PRODUCT_ID 5393
// You can find the product ID several ways:
// - "PID" accompanies each line-item on your receipt or order details page.
// - Visit adafruit.com and search for EYESPI displays. On product pages,
// PID is shown just below product title, and is at the end of URLs.
// - Check the comments in setup() later that reference various screens.
```
To have the code work for the ILI9341 240x320 2.2" TFT, change `SCREEN_PRODUCT_ID` to `1480`.
```cpp
// *** EDIT THIS VALUE TO MATCH THE ADAFRUIT PRODUCT ID FOR YOUR DISPLAY: ***
#define SCREEN_PRODUCT_ID 1480
// You can find the product ID several ways:
// - "PID" accompanies each line-item on your receipt or order details page.
// - Visit adafruit.com and search for EYESPI displays. On product pages,
// PID is shown just below product title, and is at the end of URLs.
// - Check the comments in setup() later that reference various screens.
```
After updating the `SCREEN_PRODUCT_ID`, upload the sketch to your board. You should see the 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.
# Adafruit EYESPI Breakout Board
## Arduino Docs
# Adafruit EYESPI Breakout Board
## Downloads
## Files
- [EagleCAD PCB files on GitHub](https://github.com/adafruit/Adafruit-EYESPI-PCB)
- [Fritzing object in the Adafruit Fritzing Library](https://github.com/adafruit/Fritzing-Library/blob/master/parts/Adafruit%20EYESPI%20Breakout%20Board.fzpz)
- [Fritzing object with EYESPI cable in the Adafruit Fritzing Library](https://github.com/adafruit/Fritzing-Library/blob/master/parts/Adafruit%20EYESPI%20Breakout%20Board%20with%20EYESPI%20Cable.fzpz)
## Schematic and Fab Print
## Primary Products
### 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: 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 "
In Stock
[Buy Now](https://www.adafruit.com/product/5613)
[Related Guides to the Product](https://learn.adafruit.com/products/5613/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!
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 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!
In Stock
[Buy Now](https://www.adafruit.com/product/5240)
[Related Guides to the Product](https://learn.adafruit.com/products/5240/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!
In Stock
[Buy Now](https://www.adafruit.com/product/5462)
[Related Guides to the Product](https://learn.adafruit.com/products/5462/guides)
## Related Guides
- [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)
- [Adafruit 3.5" 320x480 Color TFT Touchscreen Breakout](https://learn.adafruit.com/adafruit-3-5-color-320x480-tft-touchscreen-breakout.md)
- [Adafruit 1.28" 240x240 Round TFT LCD](https://learn.adafruit.com/adafruit-1-28-240x240-round-tft-lcd.md)
- [Networking in CircuitPython](https://learn.adafruit.com/networking-in-circuitpython.md)
- [DIY Trinkey No-Soldering USB Air Quality Monitor](https://learn.adafruit.com/diy-trinkey-no-solder-air-quality-monitor.md)
- [Adafruit Metro RP2040](https://learn.adafruit.com/adafruit-metro-rp2040.md)
- [Bluetooth Remote Control for the Lego Droid Developer Kit](https://learn.adafruit.com/bluetooth-remote-for-lego-droid.md)
- [Adafruit STEMMA Analog SPDT Switch](https://learn.adafruit.com/adafruit-stemma-analog-spdt-switch.md)
- [Adabox 001](https://learn.adafruit.com/adabox001.md)
- [Adafruit Sparkle Motion Stick](https://learn.adafruit.com/adafruit-sparkle-motion-stick.md)
- [Digital Clock with CircuitPython](https://learn.adafruit.com/digital-clock-with-circuitpython.md)
- [Adafruit Wiz5500 Ethernet Co-Processor Breakout Board](https://learn.adafruit.com/adafruit-wiz5500-ethernet-co-processor-breakout-board.md)
- [Adafruit 2.8" PiTFT - Capacitive Touch](https://learn.adafruit.com/adafruit-2-8-pitft-capacitive-touch.md)
- [Trellis M4 Expressive MIDI Controller](https://learn.adafruit.com/trellis-m4-midi-keypad-and-tilt-controller.md)