TT21100 触摸屏控制器

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

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

ESP32-S3-BOX 上的 TT21100 触摸屏

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

基本触摸屏配置

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

配置变量

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

• interrupt_pin (**必填”, 引脚模式)：触摸检测引脚。

• reset_pin (可选, 引脚模式)：控制器的复位引脚。

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

WARNING

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

二进制传感器

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

# 配置示例
binary_sensor:
  - platform: tt21100
    name: "Home"
    index: 0

配置变量

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

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

• 所有其他选项来自 二进制传感器。

另见

• 二进制传感器过滤器
• API Reference: tt21100.h
• API Reference: tt21100_button.h