gt911 触摸屏控制器

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

此控制器用于 Espressif ESP32-S3-BOX-3 和 m5paper；

ESP32-S3-BOX-3 上的 gt911 触摸屏

基本触摸屏配置

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

配置变量

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

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

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

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

二进制传感器

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

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

配置变量

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

• index (可选, int)：触摸按钮的内部索引，介于 0 和 3 之间。默认为 0。

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

另见

• 二进制传感器过滤器
• API Reference: gt911.h
• API Reference: gt911_button.h