docs: update touch sensor of esp32s2 and esp32s3

espressif · Aug 24, 2022 · 0fa32f2 · 0fa32f2
1 parent abb35ac
commit 0fa32f2
Show file tree

Hide file tree

Showing 3 changed files with 39 additions and 13 deletions.
diff --git a/docs/_static/touch_pad-measurement-parameters-version2.png b/docs/_static/touch_pad-measurement-parameters-version2.png
diff --git a/docs/en/api-reference/peripherals/touch_pad.rst b/docs/en/api-reference/peripherals/touch_pad.rst
@@ -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
+
+    .. figure:: ../../../_static/touch_pad-measurement-parameters.jpg
+        :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 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
+        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.
+    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`.
 

diff --git a/docs/zh_CN/api-reference/peripherals/touch_pad.rst b/docs/zh_CN/api-reference/peripherals/touch_pad.rst
@@ -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* 代表触摸传感器读值，即一个测量周期内测得的脉冲计数值。
+
+.. 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* 代表触摸传感器读值，即一个测量周期内测得的脉冲计数值。
+    上图中的 *Output* 代表触摸传感器读值，即固定充放电次数所需的时间。
 
 所有函数均成对出现，用于设定某一特定参数，并获取当前参数值。例如：:cpp:func:`touch_pad_set_voltage` 和 :cpp:func:`touch_pad_get_voltage`。