TT21100 触摸屏控制器

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

此控制器用于 Espressif ESP32-S3-BOX 和 ESP32-S3-Korvo-2-LCD 扩展板（用于 ESP32-S3-Korvo-2）。

ESP32-S3-BOX 上的 TT21100 触摸屏

ESP32-S3-Korvo-2 上的 TT21100 触摸屏

基础触摸屏配置

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

配置变量

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

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

• reset_pin (可选, Pin Schema): 控制器的复位引脚。

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

WARNING

如果复位引脚在显示屏和 TT21100 触摸屏之间共享 （ESP32-S3-BOX 和 ESP32-S3-Korvo-2-LCD 的情况如此）， 请仅配置显示屏的复位引脚，并移除 TT21100 触摸屏的 reset_pin 变量。 显示屏组件应在触摸屏组件之前初始化，触摸屏组件此时已经执行了复位。

二进制传感器

除了通过 Touchscreen 组件在屏幕上配置的触摸区域外， TT21100 最多支持四个位于正常触摸屏区域外的按钮。 在 ESP32-S3-BOX 和 ESP32-S3-Korvo-2-LCD 上，显示屏下方的红色圆圈就是这样的按钮。 可以配置二进制传感器以响应触摸这些按钮。

# Example configuration entry
binary_sensor:
  - platform: tt21100
    name: "Home"
    index: 0

配置变量

• tt21100_id (可选, ID): 手动指定触摸屏的 ID。

• index (必填, int): 触摸按钮的内部索引，介于 0 和 3 之间。

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

另请参阅

• 二进制传感器过滤器
• API 参考：tt21100.h
• API 参考：tt21100_button.h