mirror of
https://github.com/espressif/esp-idf.git
synced 2026-05-05 12:25:03 +02:00
docs: add pin information of touch sensor
This commit is contained in:
@@ -9,14 +9,6 @@ Introduction
|
||||
|
||||
A touch sensor system is built on a substrate which carries electrodes and relevant connections under a protective flat surface. When a user touches the surface, the capacitance variation is used to evaluate if the touch was valid.
|
||||
|
||||
.. only:: SOC_TOUCH_VERSION_1
|
||||
|
||||
Touch sensor on {IDF_TARGET_NAME} can support up to 10 capacitive touch pads / GPIOs.
|
||||
|
||||
.. only:: SOC_TOUCH_VERSION_2
|
||||
|
||||
Touch sensor on {IDF_TARGET_NAME} can support 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.
|
||||
|
||||
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>`__].
|
||||
@@ -43,7 +35,6 @@ Description of API is broken down into groups of functions to provide a quick ov
|
||||
|
||||
For detailed description of a particular function, please go to Section :ref:`touch_pad-api-reference`. Practical implementation of this API is covered in Section :ref:`Application Examples <touch_pad-api-examples>`.
|
||||
|
||||
|
||||
Initialization
|
||||
^^^^^^^^^^^^^^
|
||||
|
||||
@@ -54,7 +45,79 @@ If the driver is not required anymore, deinitialize it by calling :cpp:func:`tou
|
||||
Configuration
|
||||
^^^^^^^^^^^^^
|
||||
|
||||
Enabling the touch sensor functionality for a particular GPIO is done with :cpp:func:`touch_pad_config`.
|
||||
.. only:: esp32
|
||||
|
||||
Enabling the touch sensor functionality for a particular GPIO is done with :cpp:func:`touch_pad_config()`. The following 10 capacitive touch pads are supported for {IDF_TARGET_NAME}.
|
||||
|
||||
.. list-table::
|
||||
:align: center
|
||||
:widths: 50 50
|
||||
:header-rows: 1
|
||||
|
||||
* - Touch Pad
|
||||
- GPIO Pin
|
||||
* - T0
|
||||
- GPIO4
|
||||
* - T1
|
||||
- GPIO0
|
||||
* - T2
|
||||
- GPIO2
|
||||
* - T3
|
||||
- MTDO
|
||||
* - T4
|
||||
- MTCK
|
||||
* - T5
|
||||
- MTDI
|
||||
* - T6
|
||||
- MTMS
|
||||
* - T7
|
||||
- GPIO27
|
||||
* - T8
|
||||
- 32K_XN
|
||||
* - T9
|
||||
- 32K_XP
|
||||
|
||||
.. only:: esp32s2 or esp32s3
|
||||
|
||||
Enabling the touch sensor functionality for a particular GPIO is done with :cpp:func:`touch_pad_config()`. The following 14 capacitive touch pads are supported for {IDF_TARGET_NAME}.
|
||||
|
||||
.. list-table::
|
||||
:align: center
|
||||
:widths: 50 50
|
||||
:header-rows: 1
|
||||
|
||||
* - Touch Pad
|
||||
- GPIO Pin
|
||||
* - T0
|
||||
- Internal channel, not connect to a GPIO
|
||||
* - T1
|
||||
- GPIO1
|
||||
* - T2
|
||||
- GPIO2
|
||||
* - T3
|
||||
- GPIO3
|
||||
* - T4
|
||||
- GPIO4
|
||||
* - T5
|
||||
- GPIO5
|
||||
* - T6
|
||||
- GPIO6
|
||||
* - T7
|
||||
- GPIO7
|
||||
* - T8
|
||||
- GPIO8
|
||||
* - T9
|
||||
- GPIO9
|
||||
* - T10
|
||||
- GPIO10
|
||||
* - T11
|
||||
- GPIO11
|
||||
* - T12
|
||||
- GPIO12
|
||||
* - T13
|
||||
- GPIO13
|
||||
* - T14
|
||||
- GPIO14
|
||||
|
||||
Use the function :cpp:func:`touch_pad_set_fsm_mode` to select if touch pad measurement (operated by FSM) should be started automatically by a hardware timer, or by software. If software mode is selected, use :cpp:func:`touch_pad_sw_start` to start the FSM.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user