2.8-inch 240 × 320 ESP32-C5 Wi-Fi 6 touch display development board
English | 简体中文
🌐 Product · 📦 Firmware · 🧩 ESP-IDF · 🔧 Arduino · 📚 Documentation
Examples and hardware resources for the ESP32-C5 touch display board, including LCD, touch, audio, SD card and sensors. CH32V003 provides IO expansion and backlight PWM control.
| Feature | Device / interface |
|---|---|
| MCU | ESP32-C5 |
| Memory | Schematic module: ESP32-C5-WROOM-1-N32R8, 32 MB Flash and 8 MB PSRAM; examples use a 16 MB Flash layout |
| Display | 2.8-inch ST7789 SPI LCD, 240 × 320 |
| Touch | CST3530, I2C |
| Audio | ES8311 codec and onboard microphone |
| Sensors | QMI8658 IMU, PCF85063 RTC, SHTC3 temperature/humidity |
| Expansion | CH32V003 IO expander, microSD over shared SPI |
| Board support | BSP and compatibility notes |
- Download the required example package from Releases.
- Extract it and install esptool with
python -m pip install esptool. - Connect the board over USB.
- Follow the flashing script and instructions included in that package, then reset the board.
Factory firmware: download the file whose name contains FactoryOnly from firmware to restore the supplied demonstration.
| Example | Main feature |
|---|---|
| 01_lvgl_demo | LVGL widgets, touch and backlight |
| 02_sd_card | SD write/read verification with LCD results |
| 03_qmi8658 | Serial acceleration and angular velocity |
| 04_pcf85063 | RTC set/read |
| 05_shtc3 | Serial temperature and humidity |
| 06_exio | Header EXIO6/7 and backlight PWM |
| 07_audio | Touchscreen microphone meter, 10 s recording and playback |
| 08_battery_voltage | LCD/serial battery voltage and raw ADC |
| Example | Main feature |
|---|---|
| 01_exio | CH32V003 IO expander |
| 02_I2C_qmi8658 | IMU readings |
| 03_SD_Card | SD detection and capacity |
| 04_I2C_pcf85063 | RTC |
| 05_shtc3 | Temperature and humidity |
| 06_lvgl_demo | LCD, touch and backlight |
| 07_battery_voltage | Battery voltage and raw ADC |
Libraries are bundled in examples/arduino/libraries. Arduino uses LVGL 8.4; ESP-IDF and factory use LVGL 9.5.0.
The factory project provides 12 applications: Display Test, Settings, AIChats, Touch Test, GravityBall, Photos, Weather, SD Music, Sensor, 2048, Mic Test and Button Test. AIChats runs inside the desktop firmware; see the user guide for network setup, activation and application controls.
The framework versions and board options are defined in product.json.
| Framework | Version | Examples |
|---|---|---|
| ESP-IDF | v5.5.4 |
8 |
| ESP-IDF (factory project) | v5.5.4 |
1 |
| Arduino-ESP32 | 3.3.12 |
7 |
For first use, follow the ESP-IDF guide or Arduino guide, then prepare the hardware, upload and operate the selected example as described in its README. Each example explains whether to check the screen, serial monitor or speaker for its results.
- Example or repository problem: open an issue.
- Product usage, hardware or order questions: Waveshare support.
Apache License 2.0. See LICENSE.