确认
资料包内 `src/main.cpp` 使用 `CST816S touch(39,38,36,4)`；TFT_eSPI 配置使用 ST7789、240×240。
02382 ESP32-S3 1.69寸电容触摸屏扩展板
淘宝链接：item.taobao.com/item.htm?id=692311588611
进入淘宝购买
Product
产品实物与规格
图片来自本店资料图，显示该款为 ESP32-S3 专用屏扩展板。尺寸和重量按图中标注整理。
注意
显示 SPI 和触摸 I2C 是两套接口。屏亮不代表触摸一定正常，触摸需要单独看 I2C 和 INT/RST。
建议
客户测试先跑资料包原例程。若改到 Arduino IDE，需要同步 TFT_eSPI 的 `User_Setup.h` 引脚。
Specs
规格说明
| 项目 | 当前确认 | 说明 |
|---|---|---|
| SKU | 02382 | 用户指定 |
| 产品名 | ESP32-S3 1.69寸电容触摸屏扩展板 | 按淘宝图和资料包整理 |
| 尺寸 | 约 63.3mm × 34mm | 图片标注 |
| 重量 | 约 15g | 图片标注 |
| 显示驱动 | ST7789 系列 | TFT_eSPI 配置启用 `ST7789_DRIVER` |
| 分辨率 | 240×240 | `TFT_WIDTH 240`，`TFT_HEIGHT 240`，LVGL 也设置 240×240 |
| 触摸驱动 | CST816S | 资料包使用 `CST816S` 库，地址为 0x15 |
| 工程类型 | PlatformIO / Arduino Framework | 板型为 `seeed_xiao_esp32s3`，依赖 LVGL、TFT_eSPI、CST816S |
Wiring
资料包代码里的接线
下面这张图按资料包配置重画。若后续发货批次或例程变更，以当前资料包和实物丝印为准。
| 模块功能 | ESP32-S3 GPIO | 代码来源 |
|---|---|---|
| LCD MOSI / SDA | GPIO45 | `TFT_MOSI 45` |
| LCD SCLK / SCL | GPIO40 | `TFT_SCLK 40` |
| LCD CS | GPIO42 | `TFT_CS 42` |
| LCD DC | GPIO41 | `TFT_DC 41` |
| LCD RST | GPIO37 | `TFT_RST 37` |
| 触摸 SDA | GPIO39 | `CST816S touch(39,38,36,4)` |
| 触摸 SCL | GPIO38 | `CST816S touch(39,38,36,4)` |
| 触摸 RST | GPIO36 | `CST816S touch(39,38,36,4)` |
| 触摸 IRQ / INT | GPIO4 | `CST816S touch(39,38,36,4)` |
| 背光 | 待实物确认 | 资料包主例程未单独定义 `TFT_BL` |
重点：屏幕排线里的 SCL/SDA 在 LCD 部分通常是 SPI 的 SCLK/MOSI，不等于 I2C。触摸 CST816S 才是 I2C，使用 GPIO39/GPIO38。
Download
资料和程序去哪里下载
客户先下载网盘资料包。这个资料包里包含 PlatformIO 工程、规格书、原理图和演示程序。
1打开网盘链接，输入提取码 `1111`，下载并解压资料包。
2优先按资料包里的 PlatformIO 工程测试。工程板型为 `seeed_xiao_esp32s3`。
3如要改 Arduino IDE，需要安装 ESP32 开发板包、TFT_eSPI、LVGL、CST816S，并同步 `User_Setup.h` 引脚。
4上传后看屏幕显示和触摸日志，显示和触摸需要分别验证。
Troubleshooting
常见问题排查
客户问程序在哪里下载？
发网盘链接和提取码：`https://pan.baidu.com/s/1G-xQaYLpmj9n3qY5JhcBFQ?pwd=1111`，提取码 `1111`。让客户先下载资料包，不要自己随便套其它 1.69 寸屏代码。
上传后黑屏怎么办？
先确认板型、端口、Flash/PSRAM、USB CDC、屏幕插接方向和 TFT_eSPI 引脚配置。LCD 引脚应对应 MOSI=45、SCLK=40、CS=42、DC=41、RST=37。
屏幕显示正常，但触摸没反应？
触摸是 CST816S I2C，地址 0x15。按资料包代码，SDA=GPIO39，SCL=GPIO38，RST=GPIO36，IRQ=GPIO4。显示正常只能说明 SPI 显示部分正常，不代表触摸 I2C 正常。
能不能用网上 Waveshare 或 Spotpear 的程序？
可以参考思路，但不能直接当成本 SKU 的最终引脚。屏幕驱动、触摸芯片、GPIO 和分辨率必须以本资料包代码为准。
References
公开资料参考
这些资料用于理解 ST7789/CST816 同类方案，具体引脚以本资料包为准。
Customer Reply