touch_i2c

Supported ESP SoCs	ESP32	ESP32-C3	ESP32-C6	ESP32-H2	ESP32-S2	ESP32-S3	ESP32-P4

Supported Touch Controllers	AXS15231B	CHSC6540	CST816S	FT5x06	GT911	GT1151	SPD2010	ST1633	ST7123	TT21100

I2C Touch Example

Overview

This example demonstrates how to drive different model touches with I2C interface and test them by printing touched points and buttons.

How to Use

Step 1. Install SDK and dependencies

• Install the following SDK and library dependencies:

  • See SDK & Dependencies and Installing Libraries sections for more information

Step 2. Configure the libraries

• [Optional] ESP32_Display_Panel:

  • This example already has the esp_panel_drivers_conf.h configuration file in the project directory. Edit this file as needed
  • See Configuring Guide section for more information

• [Optional] esp-lib-utils :

  • This example already has the esp_utils_conf.h configuration file in the project directory. Edit this file as needed
  • See Configuring esp-lib-utils section for more information

Step 3. Configure the example

• [Mandatory] Edit the macro definitions in the touch_i2c.ino file

Step 4. Configure Arduino IDE

• Navigate to the Tools menu
• Select the target board in the Board menu
• Change the USB CDC On Boot option to Enabled if using USB port, or Disabled if using UART port. If this configuration differs from previous flashing, first enable Erase All Flash Before Sketch Upload, then it can be disabled after flashing.
• Change other configurations as needed
• see Configuring Arduino IDE for more information

Step 5. Compile and upload the project

• Connect the board to your computer
• Select the correct serial port
• Click the upload button

Step 6. Check the serial output

• Open the serial monitor and select the correct baud rate (like 115200)
• Check the output logs

Serial Output

The following are the logs output when using the GT911 touch. The logs content may vary with different touches or different configurations, and it is provided for reference only.

...
Initializing "I2C" touch without config
[I][Panel][esp_lcd_touch_gt911.c:0067](esp_lcd_touch_new_i2c_gt911): version: 1.1.1
[I][Panel][esp_lcd_touch_gt911.c:0401](touch_gt911_read_cfg): TouchPad_ID:0x39,0x31,0x31
[I][Panel][esp_lcd_touch_gt911.c:0402](touch_gt911_read_cfg): TouchPad_Config_Version:65
Reading touch points and buttons...
Touch interrupt callback
Touch button(0): 0
Touch interrupt callback
Touch button(0): 0
Touch interrupt callback
Touch point(0): x 72, y 76, strength 28
Touch button(0): 0
Touch interrupt callback
Touch point(0): x 72, y 76, strength 28
...

Troubleshooting

Please check the FAQ first to see if the same question exists. If not, please create a Github Issue. We will get back to you as soon as possible.