Waveshare · 显示开发板
Waveshare ESP32-S3-Touch-LCD-1.28 显示屏：参数、驱动版本与配置
基于 ESP32-S3 的 1.28 英寸圆形 240×240 IPS 显示主板，带 GC9A01 控制器、CST816S 触摸和 QMI8658 IMU：表盘和旋钮界面的常用基础板。
工程师审核于 2026年10月11日
Waveshare ESP32-S3-Touch-LCD-1.28 显示参数
| MCU | ESP32-S3 |
|---|---|
| 显示屏 | 1.28″ · 240×240 · 圆形 |
| 显示总线 | SPI |
| 驱动 IC | GC9A01 |
| 触摸 | CST816S 电容触摸（I2C） |
你手上的 Waveshare ESP32-S3-Touch-LCD-1.28 是哪个版本？
该板已知的显示配置。
| 版本 | 驱动 IC | 识别方法 | 库设置 |
|---|---|---|---|
| ESP32-S3-Touch-LCD-1.28 | GC9A01 | TFT_eSPI：GC9A01_DRIVER；LovyanGFX：Panel_GC9A01 |
Waveshare ESP32-S3-Touch-LCD-1.28 显示与触摸引脚
| 信号 | GPIO | 备注 |
|---|---|---|
| LCD SCLK | 10 | SPI |
| LCD MOSI | 11 | SPI |
| LCD CS | 9 | |
| LCD DC | 8 | |
| LCD RST | 14 | |
| Backlight | 2 | |
| Touch/IMU SDA | 6 | I2C，与 QMI8658 共用 |
| Touch/IMU SCL | 7 | I2C |
| Touch INT | 5 | CST816S |
| Touch RST | 13 | CST816S |
同规格显示屏，用于批量生产
在 Waveshare ESP32-S3-Touch-LCD-1.28 上做的原型？这些直营工厂模组的面板尺寸和分辨率相同，附规格书，每个生产批次固定驱动 IC，样品 1 片起。起订量和交期按项目商定。
从 Waveshare ESP32-S3-Touch-LCD-1.28 原型到量产
开发板很适合验证界面，但它们的面板是从公开市场采购的：控制器可能在批次之间更换，很少有规格书，寿命也没有保证。做产品时，请选用每个生产批次固定驱动 IC、有规格书和生命周期承诺的模组。
我们的直营工厂生产同为 1.28″ 240×240 规格的模组。样品 1 片起；起订量和交期由销售团队按项目商定。
调试代码之前
- 先确认你手上的版本（见上表）：驱动 IC 变更是白屏最常见的原因。
- 检查背光引脚没有在你的代码中被复用。
- 一次只改一个设置（驱动、反转、颜色顺序），并保留一个已知正常的示例用于对比。
配置示例
TFT_eSPI User_Setup.hc
#define GC9A01_DRIVER
#define TFT_WIDTH 240
#define TFT_HEIGHT 240
#define TFT_SCLK 10
#define TFT_MOSI 11
#define TFT_CS 9
#define TFT_DC 8
#define TFT_RST 14
#define TFT_BL 2
#define SPI_FREQUENCY 40000000参考资料· Community / vendor configuration (see sources)
常见问题
为什么触摸返回的坐标是零？
CST816S 与 IMU 共用 I2C 总线（SDA 6、SCL 7），并且需要释放它的复位（GPIO 13）；调试驱动前先检查 I2C 设置和地址。