Chapter 2. API Reference
• Sleep mode wakeup source
• Hardware internal de-noise
• Hardware filter
• Hardware waterproof sensor
• Hardware proximity sensor
The channels are located as follows:
Channel ESP32-S2
Channel 0 GPIO 0 (reserved)
Channel 1 GPIO 1
Channel 2 GPIO 2
Channel 3 GPIO 3
Channel 4 GPIO 4
Channel 5 GPIO 5
Channel 6 GPIO 6
Channel 7 GPIO 7
Channel 8 GPIO 8
Channel 9 GPIO 9
Channel 10 GPIO 10
Channel 11 GPIO 11
Channel 12 GPIO 12
Channel 13 GPIO 13
Channel 14 GPIO 14
Terminology
The terms used in relation to the Touch Element library are given in the below.
Term Definition
Touch sensor Touch sensor peripheral inside the chip
Touch channel Touch sensor channels inside the touch sensor peripheral
Touch pad Off-chip physical solder pad (Generally inside the PCB)
De-noise channel Internal de-noise channel (Is always Channel 0 and it is reserved)
Shield sensor One of the waterproof sensor, use for compensating the influence of water drop
Guard sensor One of the waterproof sensor, use for detecting the water stream
Shield channel The channel that waterproof shield sensor connected to (Is always Channel 14)
Guard channel The channel that waterproof guard sensor connected to
Shield pad Off-chip physical solder pad (Generally is grids) and is connected to shield sensor
Guard pad Off-chip physical solder pad (Is usually a ring) and is connected to guard sensor
Touch Sensor Signal Each touch senor is able to provide the following types of signals:
• Raw: The Raw signal is the unfiltered signal from the touch sensor
• Smooth: The Smooth signal is a filtered version of the Raw signal via an internal hardware filter
• Benchmark: The Benchmark signal is also a filtered signal that filters out extremely low-frequency noise.
All of these signals can be obtained using touch sensor driver API.
Touch Sensor Threshold The Touch Sensor Threshold value is a configurable threshold value used to determine
when a touch sensor is touched or not. When difference between the Smooth signal and the Benchmark signal becomes
greater than the threshold value (i.e., (smooth - benchmark) > threshold), the touch channel’s state
will be changed and a touch interrupt will be triggered simultaneously.
Espressif Systems 420
Submit Document Feedback
Release v4.4