alex/esp-idf
alex/esp-idf
1
0
Fork 0
mirror of https://github.com/espressif/esp-idf.git synced 2024-10-05 20:47:46 -04:00
Code Issues Actions 2 Packages Projects Releases Wiki Activity

Merge branch 'docs/update_touch_sensor_esp32s2s3' into 'master'

Browse Source 
docs: update touch sensor of esp32s2 and esp32s3

Closes DOC-3193

See merge request espressif/esp-idf!19696
This commit is contained in:
morris 2022-08-30 17:08:06 +08:00
commit c7696fb8ef
3 changed files with 39 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

BIN
docs/_static/touch_pad-measurement-parameters-version2.png vendored Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 67 KiB

27
docs/en/api-reference/peripherals/touch_pad.rst
View File

@ -131,16 +131,29 @@ The following list summarizes available measurement parameters and corresponding
* Charge and discharge times of one measurement: :cpp:func:`touch_pad_set_charge_discharge_times`
Relationship between the voltage range (high / low reference voltages), speed (slope), and measurement time is shown in the figure below.
Relationship between the voltage range (high/low reference voltages), speed (slope), and measurement time is shown in the figure below.
.. figure:: ../../../_static/touch_pad-measurement-parameters.jpg
:align: center
:alt: Touch Pad - relationship between measurement parameters
:figclass: align-center
.. only:: SOC_TOUCH_VERSION_1
Touch pad - relationship between measurement parameters
.. figure:: ../../../_static/touch_pad-measurement-parameters.jpg
:align: center
:alt: Touch Pad - relationship between measurement parameters
:figclass: align-center
The last chart *Output* represents the touch sensor reading, i.e., the count of pulses collected within the measurement time.
Touch pad - relationship between measurement parameters
The last chart *Output* represents the touch sensor reading, i.e., the count of pulses collected within the measurement time.
.. only:: SOC_TOUCH_VERSION_2
.. figure:: ../../../_static/touch_pad-measurement-parameters-version2.png
:align: center
:alt: Touch Pad - relationship between measurement parameters
:figclass: align-center
Touch pad - relationship between measurement parameters
The last chart *Output* represents the touch sensor reading, i.e., the time taken to accumulate the fixed number of cycles.
All functions are provided in pairs to *set* a specific parameter and to *get* the current parameter's value, e.g., :cpp:func:`touch_pad_set_voltage` and :cpp:func:`touch_pad_get_voltage`.

25
docs/zh_CN/api-reference/peripherals/touch_pad.rst
View File

@ -133,14 +133,27 @@
电压门限（参考低值/参考高值）、速率（斜率）与测量时间的关系如下图所示：
.. figure:: ../../../_static/touch_pad-measurement-parameters.jpg
:align: center
:alt: Touch Pad - relationship between measurement parameters
:figclass: align-center
.. only:: SOC_TOUCH_VERSION_1
触摸传感器 - 测量参数之间的关系
.. figure:: ../../../_static/touch_pad-measurement-parameters.jpg
:align: center
:alt: Touch Pad - relationship between measurement parameters
:figclass: align-center
上图中的 *Output* 代表触摸传感器读值，即一个测量周期内测得的脉冲计数值。
触摸传感器 - 测量参数之间的关系
上图中的 *Output* 代表触摸传感器读值，即一个测量周期内测得的脉冲计数值。
.. only:: SOC_TOUCH_VERSION_2
.. figure:: ../../../_static/touch_pad-measurement-parameters-version2.png
:align: center
:alt: Touch Pad - relationship between measurement parameters
:figclass: align-center
触摸传感器 - 测量参数之间的关系
上图中的 *Output* 代表触摸传感器读值，即固定充放电次数所需的时间。
所有函数均成对出现，用于设定某一特定参数，并获取当前参数值。例如：:cpp:func:`touch_pad_set_voltage` 和 :cpp:func:`touch_pad_get_voltage`。