gt911 Touch Screen Controller¶
The gt911 touchscreen platform allows using the touch screen controllers based on the gt911 chip with ESPHome.
The I²C is required to be set up in your configuration for this touchscreen to work.
This controller is used in the Espressif ESP32-S3-BOX-3 and the m5paper;
gt911 touchscreen on ESP32-S3-BOX-3¶
Base Touchscreen Configuration¶
# Example configuration entry
touchscreen:
platform: gt911
id: my_touchscreen
interrupt_pin: GPIO3
Configuration variables:¶
id (Optional, ID): Manually set the ID of this touchscreen.
interrupt_pin (Required, Pin Schema): The touch detection pin.
rotation (Optional): Set the rotation of the touchscreen. By default this will be set to match the display associated with the touchscreen, but this allows more control. Choices are
0,90,180and270.All other options from Touchscreen.
Binary Sensor¶
In addition to touch areas on the screen configured through the Touchscreen component, the gt911 supports up to four buttons located outside of the normal touchscreen area. On the ESP32-S3-BOX-3 the red circle below the display is such a button. A binary sensor can be configured to react to touching these buttons.
# Example configuration entry
binary_sensor:
- platform: gt911
name: "Home"
index: 0
Configuration variables:¶
gt911_id (Optional, ID): Manually specify the ID of the touchscreen.
index (Optional, int): Internal index of the touch button, between 0 and 3. The default is 0.
All other options from Binary Sensor.