LilyGO T-Display-S3
1.9" 170x320 ST7789 on an 8-bit parallel bus, CST816S touch on the touch model.
Building for it
A project is made for one toolchain, picked when you start it. All four can drive this board:
| Toolchain | |
|---|---|
| Arduino (C++) | Every board, every widget and every peripheral here. The most control, and the most to set up. Start a project |
| MicroPython | Change a screen by editing a file on the board. No compiler once it is flashed. Start a project |
| ESPHome | No compiler to install, and the panel can join Home Assistant as real entities. Start a project |
| ESP-IDF (C) | Espressif's own framework: esp_lcd, the component registry and idf.py, with nothing of Arduino in it. Start a project |
At a glance
| Part | Detail |
|---|---|
| Maker | LilyGO |
| MCU | ESP32-S3 Xtensa LX7 dual-core @ 240 MHz, 512 KB SRAM (+ 2-16 MB PSRAM on most modules) |
| Display | Sitronix ST7789, 170 x 320 px, 8-bit parallel (i80 / 8080), 16-bit colour |
| Touch | Hynitron CST816S (capacitive, I2C) |
| Backlight | GPIO 38, dimmable (PWM) |
| Memory | 16 MB flash, 8 MB octal PSRAM (N16R8) |
| Graphics library | GFX Library for Arduino |
Display pins
ST7789 on 8-bit parallel (i80 / 8080): PAR8 clock 20 MHz, RGB colour order, inversion on.
| Signal | Pin |
|---|---|
| WR | GPIO 8 |
| RD | GPIO 9 |
| DC / RS | GPIO 7 |
| CS | GPIO 6 |
| RESET | GPIO 5 |
| D0 - D7 | GPIO 39, 40, 41, 42, 45, 46, 47, 48 |
| Backlight | GPIO 38 |
Touch pins
CST816S: I2C address 0x15, 400 kHz.
| Signal | Pin |
|---|---|
| SDA | GPIO 18 |
| SCL | GPIO 17 |
| INT / IRQ | GPIO 16 |
| RESET | GPIO 21 |
Also on the board
- GPIO 15 is set high at boot - LCD power enable
The preset adds these to the Hardware tab with the board, so a sensor can go straight onto the connector.
Check your revision. GPIO15 must be driven HIGH to enable the LCD power rail before init. The generated sketch does this for you.
Designing for it in LCD Wizard
- Choose LilyGO T-Display-S3 on the Hardware tab (or use the button above) and every pin on this page is filled in. The export writes the sketch,
lcd_pins.h, the GFX Library for Arduino configuration,lv_conf.handplatformio.ini- a project that builds for this board as it comes. - The CST816S is capacitive and needs no calibration. The firmware resets it and checks it answers on every boot.
- The backlight is dimmable: give a slider or a button a Set backlight action.
- With PSRAM the LVGL memory pool can live there, leaving internal RAM for everything else.
- Screens are designed for 170 x 320 px in either orientation, with LVGL 9 or LVGL 8.
The parts
ST7789. Excellent colour and tolerates 80 MHz SPI. Many modules have no CS pin - tie it low and set CS to -1.
CST816S. Single touch plus gestures. Standard on 1.28" round GC9A01 modules. Needs RST wired.
ESP32-S3. The only common Arduino target with a hardware RGB565 LCD peripheral. PSRAM is effectively required for RGB panels.
GFX Library for Arduino. Moshi Liu's library. Best QSPI/AMOLED and RGB coverage. Configured in code.
The pinout on one page
Every pin above, laid out to print and keep beside the bench. Generated from this preset, so it says exactly what the designer writes into lcd_pins.h.
Download the pinout (PNG)Open it as SVG
The same pins as data - board.json and pins.csv - are in the open pinout dataset on GitHub, free to reuse under CC BY 4.0.
From the people who made it
The board’s own documentation. Pinouts on vendor pages do sometimes disagree with the hardware in front of you - where this page and that one differ, trust your board and tell us.
- The vendor’s product page
- Vendor documentation
- Schematic (PDF)
- ST7789V panel datasheet (in the vendor repo)
- LilyGo-display-library (vendor GitHub)
Designs for this board
Clone any of them into the designer, or see every design for this board in the gallery.
Similar boards
LilyGO T-Display-S3 AMOLED1.91" 240x536 RM67162 AMOLED over QSPI with CST226SE touch.ESP32-S3 · RM67162 240 x 536 · CST226SE touch
Waveshare ESP32-S3-GEEK1.14" 135x240 IPS LCD (ST7789, SPI), TF card.ESP32-S3 · ST7789 135 x 240 · no touchPurchase this board
Waveshare ESP32-S3-LCD-1.31.3" 240x240 IPS LCD (ST7789VW, SPI), TF card, QMI8658.ESP32-S3 · ST7789 240 x 240 · no touchPurchase this board
Waveshare ESP32-S3-LCD-1.471.47" 172x320 IPS LCD (ST7789 (ST7789T per the IDF driver name), SPI), TF card.ESP32-S3 · ST7789 172 x 320 · no touchPurchase this board
Waveshare ESP32-S3-LCD-1.47B1.47" 172x320 IPS LCD (ST7789, SPI), TF card, QMI8658.ESP32-S3 · ST7789 172 x 320 · no touchPurchase this board
Waveshare ESP32-S3-LCD-1.541.54" 240x240 IPS LCD (ST7789, SPI), ES8311 audio, TF card, QMI8658.ESP32-S3 · ST7789 240 x 240 · no touchPurchase this boardNext
- Quick start - from an empty screen to firmware on the board
- Boards and displays - presets, controllers, pins and touch in the designer
- Flashing and configuration - PlatformIO, the Arduino IDE and first-boot checks
- Troubleshooting - a white screen, mirrored image or touch that misses