Waveshare ESP32-C6-Touch-LCD-2.8
2.8" 240x320 IPS LCD (ST7789 (per the BSP's esp_lcd_new_panel_st7789; docs do not name the controller), SPI), CST3530 (Hynitron; waveshare__esp_lcd_touch_cst3530 component) touch, ES8311 audio, TF card, QMI8658, PCF85063A.
Building for it
A project is made for one toolchain, picked when you start it. For this board you can use one of them:
| Toolchain | |
|---|---|
| Arduino (C++) | Every board, every widget and every peripheral here. The most control, and the most to set up. Start a project |
| MicroPython | lvgl_micropython has no build for this chip. |
| ESPHome | ESPHome has no driver for this touch controller. |
At a glance
| Part | Detail |
|---|---|
| Maker | Waveshare |
| MCU | ESP32-C6 RISC-V @ 160 MHz, 512 KB SRAM (no PSRAM) |
| Display | Sitronix ST7789, 240 x 320 px, SPI (4-wire serial), 16-bit colour |
| Touch | Hynitron CST3530 (capacitive, I2C) |
| Backlight | IOExtension pin 8, dimmable (PWM) |
| Memory | 16 MB flash, no PSRAM (N16) |
| Graphics library | GFX Library for Arduino |
Display pins
ST7789 on SPI (4-wire serial): SPI clock 20 MHz, host SPI2_HOST, RGB colour order, inversion on.
| Signal | Pin |
|---|---|
| SCK / CLK | GPIO 0 |
| MOSI / SDA | GPIO 1 |
| CS | GPIO 11 |
| DC / RS | GPIO 10 |
| RESET | IOExtension pin 1 |
| Backlight | IOExtension pin 8 |
Touch pins
CST3530: I2C address 0x58, 400 kHz, shares the display bus.
| Signal | Pin |
|---|---|
| SDA | GPIO 6 |
| SCL | GPIO 7 |
| INT / IRQ | GPIO 18 |
| RESET | IOExtension pin 0 |
Also on the board
- I2C (GPIO 6 / 7) - SDA GPIO 6, SCL GPIO 7
- IOExtension I/O expander at 0x24, driving the lines marked above
The preset adds these to the Hardware tab with the board, so a sensor can go straight onto the connector.
Check your revision. Pins from Waveshare's demo code and schematic (https://github.com/waveshareteam/ESP32-C6-Touch-LCD-2.8 (commit c2a1cf84d6213597d47720a51b3e60cc7f1d5257)). Flash: docs say 16 MB and the 02_2048/04_sd_music sdkconfigs use 16 MB, but the schematic's module symbol reads ESP32-C6-WROOM-1-N8 (8 MB).
Designing for it in LCD Wizard
- Choose Waveshare ESP32-C6-Touch-LCD-2.8 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 CST3530 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.
- Screens are designed for 240 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.
CST3530. Waveshare's 2.8" ESP32-C5 and C6 touch boards.
ESP32-C6. No PSRAM. SPI displays only in practice.
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
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)
- Waveshare demo code (pins read from here)
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
LilyGO T-Display-S31.9" 170x320 ST7789 on an 8-bit parallel bus, CST816S touch on the touch model.ESP32-S3 · ST7789 170 x 320 · CST816S touch
Waveshare ESP32-C3-LCD-1.471.47" 180x320 IPS LCD (ST7789T (driven by Waveshare's 'Vernon_ST7789T' esp_lcd component; docs spec table says 'ST7798', a typo), SPI), TF card, QMI8658.ESP32-C3 · ST7789 180 x 320 · no touch
Waveshare ESP32-C5-LCD-1.471.47" 172x320 TFT (ST7789, SPI), TF card.ESP32-C5 · ST7789 172 x 320 · no touch
Waveshare ESP32-C5-Touch-LCD-1.691.69" 240x280 IPS LCD (ST7789V2, SPI), CST816T touch, ES8311 audio, QMI8658, PCF85063A.ESP32-C5 · ST7789 240 x 280 · CST816S 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