|
|
@@ -2,6 +2,8 @@ Touch Sensor
|
|
|
============
|
|
|
:link_to_translation:`zh_CN:[中文]`
|
|
|
|
|
|
+{IDF_TARGET_TOUCH_SENSOR_VERSION:default="v2", esp32="v1"}
|
|
|
+
|
|
|
Introduction
|
|
|
------------
|
|
|
|
|
|
@@ -9,13 +11,13 @@ A touch sensor system is built on a substrate which carries electrodes and relev
|
|
|
|
|
|
.. only:: esp32
|
|
|
|
|
|
- ESP32 can handle up to 10 capacitive touch pads / GPIOs.
|
|
|
+ Touch sensor on {IDF_TARGET_NAME} is version 1 which supports up to 10 capacitive touch pads / GPIOs.
|
|
|
|
|
|
-.. only:: esp32s2
|
|
|
+.. only:: esp32s2 or esp32s3
|
|
|
|
|
|
- {IDF_TARGET_NAME} can handle up to 14 capacitive touch pads / GPIOs.
|
|
|
+ Touch sensor on {IDF_TARGET_NAME} is version 2 which supports up to 14 capacitive touch pads / GPIOs.
|
|
|
|
|
|
- The sensing pads can be arranged in different combinations (e.g., matrix, slider), so that a larger area or more points can be detected. The touch pad sensing process is under the control of a hardware-implemented finite-state machine (FSM) which is initiated by software or a dedicated hardware timer.
|
|
|
+The sensing pads can be arranged in different combinations (e.g., matrix, slider), so that a larger area or more points can be detected. The touch pad sensing process is under the control of a hardware-implemented finite-state machine (FSM) which is initiated by software or a dedicated hardware timer.
|
|
|
|
|
|
For design, operation, and control registers of a touch sensor, see *{IDF_TARGET_NAME} Technical Reference Manual* > *On-Chip Sensors and Analog Signal Processing* [`PDF <{IDF_TARGET_TRM_EN_URL}#sensor>`__].
|
|
|
|
|
|
@@ -72,7 +74,7 @@ Touch State Measurements
|
|
|
|
|
|
Before using :cpp:func:`touch_pad_read_filtered`, you need to initialize and configure the filter by calling specific filter functions described in Section `Filtering of Measurements`_.
|
|
|
|
|
|
-.. only:: esp32s2
|
|
|
+.. only:: esp32s2 or esp32s3
|
|
|
|
|
|
The following function come in handy to read raw measurements from the sensor:
|
|
|
|
|
|
@@ -80,7 +82,7 @@ Touch State Measurements
|
|
|
|
|
|
It can also be used, for example, to evaluate a particular touch pad design by checking the range of sensor readings when a pad is touched or released. This information can be then used to establish a touch threshold.
|
|
|
|
|
|
-For the demonstration of how to read the touch pad data, check the application example :example:`peripherals/touch_pad_read`.
|
|
|
+For the demonstration of how to read the touch pad data, check the application example :example:`peripherals/touch_sensor/touch_sensor_{IDF_TARGET_TOUCH_SENSOR_VERSION}/touch_pad_read`.
|
|
|
|
|
|
Optimization of Measurements
|
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
@@ -123,7 +125,7 @@ Filtering of Measurements
|
|
|
|
|
|
You can stop the filter with :cpp:func:`touch_pad_filter_stop`. If not required anymore, the filter can be deleted by invoking :cpp:func:`touch_pad_filter_delete`.
|
|
|
|
|
|
-.. only:: esp32s2
|
|
|
+.. only:: esp32s2 or esp32s3
|
|
|
|
|
|
If measurements are noisy, you can filter them with provided API functions. The {IDF_TARGET_NAME}'s touch functionality provide two sets of APIs for doing this.
|
|
|
|
|
|
@@ -139,7 +141,7 @@ Touch detection is implemented in ESP32's hardware based on the user-configured
|
|
|
|
|
|
Hardware touch detection can also be wired to interrupts. This is described in the next section.
|
|
|
|
|
|
-If measurements are noisy and capacity changes are small, hardware touch detection might be unreliable. To resolve this issue, instead of using hardware detection / provided interrupts, implement measurement filtering and perform touch detection in your own application. For sample implementation of both methods of touch detection, see :example:`peripherals/touch_pad_interrupt`.
|
|
|
+If measurements are noisy and capacity changes are small, hardware touch detection might be unreliable. To resolve this issue, instead of using hardware detection / provided interrupts, implement measurement filtering and perform touch detection in your own application. For sample implementation of both methods of touch detection, see :example:`peripherals/touch_sensor/touch_sensor_{IDF_TARGET_TOUCH_SENSOR_VERSION}/touch_pad_interrupt`.
|
|
|
|
|
|
Touch Triggered Interrupts
|
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
@@ -182,8 +184,8 @@ When interrupts are operational, you can obtain the information from which parti
|
|
|
Application Examples
|
|
|
--------------------
|
|
|
|
|
|
-- Touch sensor read example: :example:`peripherals/touch_pad_read`.
|
|
|
-- Touch sensor interrupt example: :example:`peripherals/touch_pad_interrupt`.
|
|
|
+ - Touch sensor read example: :example:`peripherals/touch_sensor/touch_sensor_{IDF_TARGET_TOUCH_SENSOR_VERSION}/touch_pad_read`.
|
|
|
+ - Touch sensor interrupt example: :example:`peripherals/touch_sensor/touch_sensor_{IDF_TARGET_TOUCH_SENSOR_VERSION}/touch_pad_interrupt`.
|
|
|
|
|
|
.. _touch_pad-api-reference:
|
|
|
|
laokaiyao