cst816 触摸屏控制器

cst816 触摸屏平台允许使用基于 CST816 系列芯片的触摸屏控制器与 ESPHome。 配置中需要设置 I²C 才能使此触摸屏正常工作。

此控制器用于 Lilygo T-Display S3 AMOLED。该组件应与 CST716、CST816D、CST816S、 CST816T、CST820、CST826 和 CST836 控制芯片一起工作。

T-Display S3 AMOLED 上的 cst816t 触摸屏

基础触摸屏配置

# Example configuration entry
touchscreen:
  platform: cst816
  id: my_touchscreen
  interrupt_pin: GPIOXX
  reset_pin: GPIOXX

配置变量

• id (可选, ID): 手动设置此触摸屏的 ID。

• interrupt_pin (可选, Pin Schema): 触摸检测引脚。

• reset_pin (可选, Pin Schema): 芯片复位引脚。

• skip_probe (可选, boolean): 启动时跳过读取芯片 ID。某些变体（例如 CST816S）可能需要此设置，因为它们在注册触摸之前不响应 i2c 命令。默认为 false。

• 还包括 Touchscreen 的所有其他选项。

二进制传感器

除了通过 Touchscreen 组件在屏幕上配置的触摸区域外， cst816 可以报告显示区域外专用按钮上的触摸。可以通过使用 use_raw 选项和表示传感器触摸区域的最小/最大值来配置 触摸屏二进制传感器 来利用此功能。

T-Display S3 AMOLED 示例配置

i2c:
  sda: GPIO3
  scl: GPIO2

touchscreen:
  - platform: cst816
    id: my_touchscreen
    interrupt_pin: GPIO21

另请参阅

• API 参考：cst816_touchscreen.h