diff --git a/docs/_static/touch_pad-measurement-parameters-version2.png b/docs/_static/touch_pad-measurement-parameters-version2.png new file mode 100644 index 0000000000..b138b0d4b5 Binary files /dev/null and b/docs/_static/touch_pad-measurement-parameters-version2.png differ diff --git a/docs/en/api-reference/peripherals/touch_pad.rst b/docs/en/api-reference/peripherals/touch_pad.rst index 2f89be7042..6223b0784a 100644 --- 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 - 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`. diff --git a/docs/zh_CN/api-reference/peripherals/touch_pad.rst b/docs/zh_CN/api-reference/peripherals/touch_pad.rst index 42b161e2f3..cfc9413a17 100644 --- 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* 代表触摸传感器读值,即一个测量周期内测得的脉冲计数值。 + 触摸传感器 - 测量参数之间的关系 + + 上图中的 *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`。