From 27d099cf36b210cc803d526fceb9e754d4fe5f60 Mon Sep 17 00:00:00 2001
From: laokaiyao <laokaiyao@espressif.com>
Date: Fri, 7 Nov 2025 11:14:09 +0800
Subject: [PATCH] docs(pm): updated i2s pm lock type in DFS

Related https://github.com/espressif/esp-idf/issues/14707
---
 .../esp_driver_touch_sens/common/touch_sens_common.c  |  4 +++-
 docs/en/api-reference/system/power_management.rst     | 11 +++++++----
 docs/zh_CN/api-reference/system/power_management.rst  | 11 +++++++----
 3 files changed, 17 insertions(+), 9 deletions(-)

diff --git a/components/esp_driver_touch_sens/common/touch_sens_common.c b/components/esp_driver_touch_sens/common/touch_sens_common.c
index e9feeb46d0..39c12615c4 100644
--- a/components/esp_driver_touch_sens/common/touch_sens_common.c
+++ b/components/esp_driver_touch_sens/common/touch_sens_common.c
@@ -43,6 +43,8 @@ static void touch_channel_pin_init(int id)
 {
     gpio_num_t pin = touch_sensor_channel_io_map[id];
     assert(pin >= 0);
+    /* Touch pad will output the sawtooth wave on the pin,
+       so it needs to be reserved, in case of conflict with other output signals */
     if (esp_gpio_reserve(BIT64(pin)) & BIT64(pin)) {
         ESP_LOGW(TAG, "The GPIO%d is conflict with other module", (int)pin);
     }
@@ -53,7 +55,7 @@ static void touch_channel_pin_deinit(int id)
 {
     gpio_num_t pin = touch_sensor_channel_io_map[id];
     assert(pin >= 0);
-    esp_gpio_revoke(BIT64(pin));
+    /* esp_gpio_revoke is called in gpio_reset_pin */
     gpio_reset_pin(pin);
 }
 
diff --git a/docs/en/api-reference/system/power_management.rst b/docs/en/api-reference/system/power_management.rst
index a8c164ee9f..0c6d56741f 100644
--- a/docs/en/api-reference/system/power_management.rst
+++ b/docs/en/api-reference/system/power_management.rst
@@ -102,10 +102,13 @@ Peripheral clock sources such as ``REF_TICK``, ``XTAL``, ``RC_FAST`` (i.e., ``RT
 
 Currently, the following peripheral drivers are aware of DFS and use the ``ESP_PM_APB_FREQ_MAX`` lock for the duration of the transaction:
 
-- SPI master
-- I2C
-- I2S (If the APLL clock is used, then it will use the ``ESP_PM_NO_LIGHT_SLEEP`` lock)
-- SDMMC
+.. list::
+
+  - SPI master
+  - I2C
+  :SOC_I2S_HW_VERSION_1 or not SOC_I2S_SUPPORTS_APLL: - I2S
+  :not SOC_I2S_HW_VERSION_1 and SOC_I2S_SUPPORTS_APLL: - I2S (if the APLL clock is used, then it will use the ``ESP_PM_NO_LIGHT_SLEEP`` lock)
+  - SDMMC
 
 The following drivers hold the ``ESP_PM_APB_FREQ_MAX`` lock while the driver is enabled:
 
diff --git a/docs/zh_CN/api-reference/system/power_management.rst b/docs/zh_CN/api-reference/system/power_management.rst
index 32efa15b41..114de05791 100644
--- a/docs/zh_CN/api-reference/system/power_management.rst
+++ b/docs/zh_CN/api-reference/system/power_management.rst
@@ -102,10 +102,13 @@ ESP-IDF 中集成的电源管理算法可以根据应用程序组件的需求，
 
 目前以下外设驱动程序可感知动态调频，并在调频期间使用 ``ESP_PM_APB_FREQ_MAX`` 锁：
 
-- SPI master
-- I2C
-- I2S（如果 APLL 锁在使用中，I2S 则会启用 ``ESP_PM_NO_LIGHT_SLEEP`` 锁）
-- SDMMC
+.. list::
+
+  - SPI master
+  - I2C
+  :SOC_I2S_HW_VERSION_1 or not SOC_I2S_SUPPORTS_APLL: - I2S
+  :not SOC_I2S_HW_VERSION_1 and SOC_I2S_SUPPORTS_APLL: - I2S（如果 APLL 锁在使用中，I2S 则会启用 ``ESP_PM_NO_LIGHT_SLEEP`` 锁）
+  - SDMMC
 
 启用以下驱动程序时，将占用 ``ESP_PM_APB_FREQ_MAX`` 锁：