ESP32-S3 + ST7701S 480x480 round
480x480 RGB panel that needs a 3-wire SPI init sequence alongside the RGB bus.
Building for it
A project is made for one toolchain, picked when you start it. For this board you can use two of the four:
| 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 | An ST7701 needs a register load written for its particular panel, sent over SPI alongside the RGB bus, and there is no generic one. ESPHome carries the sequence inside its model for a few named boards - the Guition ESP32-4848S040 among them - so pick one of those on the Board tab, or use the Arduino export, which can send every sequence the Display tab offers. |
| ESP-IDF (C) | The ESP-IDF export has no read for this touch controller yet. The Arduino export reads it. |
At a glance
| Part | Detail |
|---|---|
| Maker | Generic |
| MCU | ESP32-S3 Xtensa LX7 dual-core @ 240 MHz, 512 KB SRAM (+ 2-16 MB PSRAM on most modules) |
| Display | Sitronix ST7701 / ST7701S, 480 x 480 px, RGB565 parallel (DPI), 16-bit colour |
| Touch | Hynitron CST328 (capacitive, I2C) |
| Backlight | GPIO 38, dimmable (PWM) |
| Memory | 16 MB flash, 8 MB octal PSRAM (N16R8) |
| Graphics library | GFX Library for Arduino |
Display pins
ST7701 / ST7701S on RGB565 parallel (DPI): RGB colour order, inversion off.
| Signal | Pin |
|---|---|
| DE | GPIO 18 |
| VSYNC | GPIO 17 |
| HSYNC | GPIO 16 |
| PCLK | GPIO 21 |
| R0 - R4 | GPIO 4, 3, 2, 1, 0 |
| G0 - G5 | GPIO 10, 9, 8, 7, 6, 5 |
| B0 - B4 | GPIO 15, 14, 13, 12, 11 |
| CS (init only) | GPIO 39 |
| SCK (init only) | GPIO 48 |
| MOSI (init only) | GPIO 47 |
| RESET | not connected |
| Backlight | GPIO 38 |
Touch pins
CST328: I2C address 0x1A, 400 kHz.
| Signal | Pin |
|---|---|
| SDA | GPIO 19 |
| SCL | GPIO 45 |
| INT / IRQ | GPIO 40 |
| RESET | GPIO 41 |
Check your revision. CS/SCK/MOSI carry the ST7701 init commands only; pixels go over the RGB bus. The init sequence is the type 1 one; a panel that stays black on a board wired like this usually wants a different type.
Designing for it in LCD Wizard
- Choose ESP32-S3 + ST7701S 480x480 round 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 CST328 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.
- An RGB panel keeps its frame buffer in PSRAM, which this board has.
- Screens are designed for 480 x 480 px in either orientation, with LVGL 9 or LVGL 8.
The parts
ST7701 / ST7701S. RGB data plus a 3-wire SPI init sequence. You must wire CS/SCK/MOSI as well, and pick the init sequence your panel wants.
CST328. Waveshare ESP32-S3 Touch LCD 2.8"/4" boards.
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.
- ST7701 panel controller datasheet (Sitronix, via Crystalfontz)
- Arduino_GFX - source of the ST7701 init sequence types this preset selects
Designs for this board
Nobody has published a design for this board yet. Publish yours from the designer and it appears here and in the gallery.
Similar boards
Guition ESP32-4848S040 (4" 480x480)4" 480x480 square ST7701 panel with GT911 touch, sold as the "86 box" wall-plate unit.ESP32-S3 · ST7701 / ST7701S 480 x 480 · GT911 touch
Waveshare ESP32-S3-Touch-LCD-2.8B2.8" 480x640 IPS panel (ST7701, RGB) with GT911 touch, a TF card slot, QMI8658 IMU, PCF85063 RTC and battery sense. A TCA9554 expander handles the panel's reset and chip select and the touch reset.ESP32-S3 · ST7701 / ST7701S 480 x 640 · GT911 touchPurchase this board
Waveshare ESP32-S3-Touch-LCD-2.8C2.8" 480x480 round IPS panel (ST7701, RGB) with GT911 touch, a TF card slot, QMI8658 IMU, PCF85063 RTC, a buzzer and battery sense. A TCA9554 expander handles the panel's reset and chip select and the touch reset.ESP32-S3 · ST7701 / ST7701S 480 x 480 · GT911 touch
ESP32-S3 + GC9A01 1.28" round240x240 round panel with CST816S single-touch. Popular for watch faces and gauges.ESP32-S3 · GC9A01 / GC9A01A 240 x 240 · CST816S touch
ESP32-S3 + ILI9341 SPIESP32-S3 DevKitC wired to a 2.8" ILI9341 with XPT2046 touch.ESP32-S3 · ILI9341 240 x 320 · XPT2046 touch
VIEWE UEDX48480040E-WB-A (4" 480x480)4" 480x480 square GC9503V RGB panel with FT6336U touch, on an ESP32-S3 N16R8.ESP32-S3 · GC9503V 480 x 480 · FT6236 / FT6336U touchNext
- 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