cst816 触摸屏控制器

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

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

T-Display S3 AMOLED 上的 cst816t 触摸屏

基本触摸屏配置

# 配置示例
touchscreen:
  platform: cst816
  id: my_touchscreen
  interrupt_pin: GPIOXX
  reset_pin: GPIOXX

配置变量

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

• interrupt_pin (可选, 引脚模式)：触摸检测引脚。

• reset_pin (可选, 引脚模式)：芯片复位引脚。

• skip_probe (可选, 布尔值)：跳过启动时读取芯片 ID。某些不响应 i2c 命令的变体（如 CST816S）可能需要此选项，除非在注册触摸后。默认为 false。

• 所有其他选项来自 触摸屏。

二进制传感器

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

T-Display S3 AMOLED 配置示例

i2c:
  sda: GPIO3
  scl: GPIO2

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

另见

• API Reference: cst816_touchscreen.h