gt911 触摸屏控制器

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

此控制器用于 Espressif ESP32-S3-BOX-3 和 m5paper 以及一些 Waveshare-ESP32-S3-Touch 设备；

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

基础触摸屏配置

# Example configuration entry for board with interrupt line run directly to ESP GPIO
touchscreen:
  platform: gt911
  id: my_touchscreen
  interrupt_pin: GPIOXX

# Example configuration entry for board with interrupt line run through IO Expander
touchscreen:
  platform: gt911
  id: my_touchscreen
  interrupt_pin:
    waveshare_io_ch32v003: wave_io_hub
    number: 2

配置变量

id (可选, ID): 手动设置此触摸屏的 ID。
interrupt_pin (可选, Pin Schema): 如果运行到 MCU 引脚上的触摸检测引脚。
如果触摸屏中断信号通过 IO 扩展器而不是直接连接到 ESP GPIO，这将允许在启动时配置触摸屏地址，但不会用于中断，驱动程序将回退到轮询操作。
reset_pin (可选, Pin Schema): 复位引脚。
还包括 Touchscreen 的所有其他选项。

二进制传感器

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

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

配置变量

gt911_id (可选, ID): 手动指定触摸屏的 ID。
index (可选, int): 触摸按钮的内部索引，介于 0 和 3 之间。默认为 0。
还包括 Binary Sensor 的所有其他选项。

另请参阅