CST328：设置与常见问题排查

CST328 概览

以上数据并非出自海栎创的官方数据手册。我们在网上找到的资料手册是经销商上传的版本，因此上述数值来自驱动源码和板卡文档。

换用 CST3530 的情况

LilyGO 的 T-Deck Pro README 称，CST328 供应商“已停产”，因此较新的 T-Deck Pro v1.1 板卡改用 CST3530。README 还指出“两款芯片使用相同的设备地址”，因此固件必须在初始化阶段识别具体芯片。LilyGO 对 CST3530 使用海栎创的 cst66xx 例程，对 CST328 则使用 cst3xx。

Waveshare 的 RP2350-Touch-LCD-2.8 也做了同样的改动。RS-Key 项目记录了 V1 版本使用地址为 0x1A 的 CST328，V2 版本使用地址为 0x58 的 CST3530。在 T-Deck Pro 上地址保持不变，而在这块板卡上地址会变。

CST3530 相关栏目来自 RS-Key 的合并驱动（其作者已在 V2 板上测试过）以及 LilyGO 的 README。

换料问题的具体表现

遇到此问题的两个项目报告的情况完全相同：固件正常运行、显示屏正常显示，但触摸无任何响应。reticulum-tdeck 的 issue 提到，部分 T-Deck Pro v1.1 设备正常、部分不正常，这更符合生产批次之间的变更，而非接线故障。

另外两个陷阱：

• I2C 扫描无法识别芯片型号。在 T-Deck Pro 上，两颗芯片都在 0x1A 地址应答。reticulum-tdeck 的作者会优先探测 CST3530，因为 CST3530 也"会正常应答 CST328 的寄存器读取"。他们还表示，这段代码尚未在 CST3530 板上运行过。meshcore-firmware 在 T-Deck Pro V1.1 上的台架测试也显示了同样的结果：CST328 风格的读取虽然得到应答，但没有返回芯片型号和分辨率，而 CST3530 风格的读取返回了带有 0xCA 0xCA 标记和面板 240×320 分辨率的有效数据块。
• 其他驱动也可能把 0x1A 误认为别的芯片。一个公开的 Meshtastic pull request 报告称，其 I2C 扫描把 T-Deck Pro 的触摸芯片误判为 DS2482-800 桥接器，原因是状态寄存器测试恰好匹配。

这是小型触摸控制器的常见情况：板卡上的料号保持不变，而芯片却已更换。如果您批量生产，请向显示供应商确认所贴装的触摸 IC 型号，并要求其在变更前提前告知。我们的EOL 与 PCN 术语表说明了变更通知应包含哪些内容。

使用 ESPHome 进行点亮调试

ESPHome 的 cst328 平台需要先配置 I2C，并支持可选的 interrupt_pin 和 reset_pin。其初始化流程如下：

• 将复位引脚拉低 5 ms，然后等待。
• 读取固件 CRC，期望值为 0xCACA。若为其他任何值，则将该组件标记为失败。
• 读取芯片型号、项目 ID、固件版本和分辨率，然后将芯片切换到正常模式。

如果 ESPHome 报告触摸屏失败，CRC 校验是首先要排查的地方。ESPHome 使用带 2 字节寄存器地址的 CST328 读取方式，而在 meshcore-firmware 的台架测试中，这种读取方式从 CST3530 上没有返回任何有用信息。因此，在搭载 CST3530 的板卡上，预计此校验会失败。这是我们的推断：我们尚未在 CST3530 板上运行过 ESPHome。

驱动支持

• ESPHome：cst328 平台。其文档中提及 Waveshare ESP32-S3 Touch LCD 2.8 板卡。该平台不支持 CST3530。
• ESP-IDF：Waveshare 在 Espressif 组件仓库中发布了 esp_lcd_touch_cst328。其兼容性表格仅列出 CST328。
• Rust：crates.io 上的 cst328 crate，以及支持两颗芯片的 RS-Key 固件。
• Hynitron 官方驱动：LilyGO 链接了 Hynitron 的 hyn_driver 源码，支持两颗芯片。

相关控制器

关于圆形显示屏的单点触摸，请参阅同为 Hynitron 产品的 CST816S。关于最多支持 5 点触摸的更大尺寸面板，请参阅 GT911。