From f8a5ae28a7bb47f6a52bbf8a7ba6923400f6bdc4 Mon Sep 17 00:00:00 2001 From: hebinglin Date: Sat, 11 Oct 2025 16:14:19 +0800 Subject: [PATCH] docs(pm): update power management related docs for esp32c61 --- docs/docs_not_updated/esp32c61.txt | 2 -- .../current-consumption-measurement-modules.rst | 8 ++++++-- docs/en/api-reference/system/power_management.rst | 2 +- .../current-consumption-measurement-modules.rst | 8 ++++++-- docs/zh_CN/api-reference/system/power_management.rst | 2 +- 5 files changed, 14 insertions(+), 8 deletions(-) diff --git a/docs/docs_not_updated/esp32c61.txt b/docs/docs_not_updated/esp32c61.txt index cbe60a6fb2..ccc58f1a95 100644 --- a/docs/docs_not_updated/esp32c61.txt +++ b/docs/docs_not_updated/esp32c61.txt @@ -11,7 +11,6 @@ api-guides/esp-wifi-mesh.rst api-guides/core_dump.rst api-guides/inc/external-ram-esp32-notes.rst api-guides/dfu.rst -api-guides/current-consumption-measurement-modules.rst api-guides/wifi-security.rst api-reference/storage/vfs.rst api-reference/storage/spiffs.rst @@ -45,7 +44,6 @@ api-reference/network/index.rst api-reference/network/esp_netif.rst api-reference/system/sleep_modes.rst api-reference/system/app_trace.rst -api-reference/system/power_management.rst api-reference/system/inc/power_management_esp32c61.rst api-reference/index.rst api-reference/protocols/icmp_echo.rst diff --git a/docs/en/api-guides/current-consumption-measurement-modules.rst b/docs/en/api-guides/current-consumption-measurement-modules.rst index 1c73558532..cda7dd12c7 100644 --- a/docs/en/api-guides/current-consumption-measurement-modules.rst +++ b/docs/en/api-guides/current-consumption-measurement-modules.rst @@ -3,7 +3,7 @@ Current Consumption Measurement of Modules :link_to_translation:`zh_CN:[中文]` -{IDF_TARGET_SOC_BOOT_PIN:default="Not updated", esp32="IO0", esp32s2="IO0", esp32s3="IO0", esp32c3="IO9", esp32c2="IO9", "esp32c6"="IO9", "esp32h2"="IO9", "esp32p4"="IO35", "esp32c5"="IO28"} +{IDF_TARGET_SOC_BOOT_PIN:default="Not updated", esp32="IO0", esp32s2="IO0", esp32s3="IO0", esp32c3="IO9", esp32c2="IO9", "esp32c6"="IO9", "esp32h2"="IO9", "esp32p4"="IO35", "esp32c5"="IO28", "esp32c61"="IO9"} You may want to know the current consumption of a `module `__ in Deep-sleep mode, :doc:`other power-saving modes `, and Active mode to develop some applications sensitive to power consumption. This section introduces how to measure the current consumption of a module running such an application. @@ -26,7 +26,11 @@ Can We Use a Development Board? For {IDF_TARGET_NAME}, you can use development boards such as `ESP32-C5-DevKitC-1 `__ to measure current consumption of corresponding modules as these development boards are equipped with headers, which can be used to measure current drawn by modules. -.. only:: esp32c6 or esp32h2 or esp32c5 +.. only:: esp32c61 + + For {IDF_TARGET_NAME}, you can use development boards such as `ESP32-C61-DevKitC-1 `__ to measure current consumption of corresponding modules as these development boards are equipped with headers, which can be used to measure current drawn by modules. + +.. only:: esp32c6 or esp32h2 or esp32c5 or esp32c61 With such development boards, you can measure current consumption of modules in Deep-sleep mode by flashing chips with the :example:`deep_sleep ` example. However, you can also measure current of bare modules equipped with {IDF_TARGET_NAME} chip using the following method. diff --git a/docs/en/api-reference/system/power_management.rst b/docs/en/api-reference/system/power_management.rst index 911a5bddc1..7d96d7f8d9 100644 --- a/docs/en/api-reference/system/power_management.rst +++ b/docs/en/api-reference/system/power_management.rst @@ -55,7 +55,7 @@ Dynamic frequency scaling (DFS) and automatic Light-sleep can be enabled in an a Power Management Locks ---------------------- -{IDF_TARGET_MAX_CPU_FREQ: default="Not updated yet", esp32="80 MHz, 160 MHz, or 240 MHz", esp32s2="80 MHz, 160 MHz, or 240 MHz", esp32s3="80 MHz, 160 MHz, or 240 MHz", esp32c2="80 MHz or 120 MHz", esp32c3="80 MHz or 160 MHz", esp32c6="80 MHz or 160 MHz", esp32p4="360 MHz", esp32c5="80 MHz, 160 MHz or 240 MHz"} +{IDF_TARGET_MAX_CPU_FREQ: default="Not updated yet", esp32="80 MHz, 160 MHz, or 240 MHz", esp32s2="80 MHz, 160 MHz, or 240 MHz", esp32s3="80 MHz, 160 MHz, or 240 MHz", esp32c2="80 MHz or 120 MHz", esp32c3="80 MHz or 160 MHz", esp32c6="80 MHz or 160 MHz", esp32p4="360 MHz", esp32c5="80 MHz, 160 MHz or 240 MHz", esp32c61="80 MHz or 160 MHz"} Applications have the ability to acquire/release locks in order to control the power management algorithm. When an application acquires a lock, the power management algorithm operation is restricted in a way described below. When the lock is released, such restrictions are removed. diff --git a/docs/zh_CN/api-guides/current-consumption-measurement-modules.rst b/docs/zh_CN/api-guides/current-consumption-measurement-modules.rst index 17893ee2bc..d17b3330e3 100644 --- a/docs/zh_CN/api-guides/current-consumption-measurement-modules.rst +++ b/docs/zh_CN/api-guides/current-consumption-measurement-modules.rst @@ -3,7 +3,7 @@ :link_to_translation:`en:[English]` -{IDF_TARGET_SOC_BOOT_PIN:default="Not updated", esp32="IO0", esp32s2="IO0", esp32s3="IO0", esp32c3="IO9", esp32c2="IO9", "esp32c6"="IO9", "esp32h2"="IO9", "esp32p4"="IO35", "esp32c5"="IO28"} +{IDF_TARGET_SOC_BOOT_PIN:default="Not updated", esp32="IO0", esp32s2="IO0", esp32s3="IO0", esp32c3="IO9", esp32c2="IO9", "esp32c6"="IO9", "esp32h2"="IO9", "esp32p4"="IO35", "esp32c5"="IO28", "esp32c61"="IO9"} 开发功耗敏感型应用时，需要了解 `模组 `__ 在 Deep-sleep 模式、:doc:`其他节能模式 ` 和 Active 模式下的功耗。本节介绍如何测量运行此类应用程序时模组的功耗。 @@ -26,7 +26,11 @@ 对于 {IDF_TARGET_NAME}，可以使用 `ESP32-C5-DevKitC-1 `__ 等开发板。这些开发板配有排针，可以用来测量模组的功耗。 -.. only:: esp32c6 or esp32h2 or esp32c5 +.. only:: esp32c61 + + 对于 {IDF_TARGET_NAME}，可以使用 `ESP32-C61-DevKitC-1 `__ 等开发板。这些开发板配有排针，可以用来测量模组的功耗。 + +.. only:: esp32c6 or esp32h2 or esp32c5 or esp32c61 使用上述开发板，可以烧写 :example:`deep_sleep ` 示例来测量模组在 Deep-sleep 模式下的功耗。也可以使用以下方法来测量配有 {IDF_TARGET_NAME} 芯片的裸模组的电流。 diff --git a/docs/zh_CN/api-reference/system/power_management.rst b/docs/zh_CN/api-reference/system/power_management.rst index 0c459aac70..32efa15b41 100644 --- a/docs/zh_CN/api-reference/system/power_management.rst +++ b/docs/zh_CN/api-reference/system/power_management.rst @@ -55,7 +55,7 @@ ESP-IDF 中集成的电源管理算法可以根据应用程序组件的需求， 电源管理锁 ---------------------- -{IDF_TARGET_MAX_CPU_FREQ: default="Not updated yet", esp32="80 MHz, 160 MHz, or 240 MHz", esp32s2="80 MHz, 160 MHz, 或 240 MHz", esp32s3="80 MHz, 160 MHz, 或 240 MHz", esp32c2="80 MHz 或 120 MHz", esp32c3="80 MHz 或 160 MHz", esp32c6="80 MHz 或 160 MHz", esp32p4="360 MHz", esp32c5="80 MHz, 160 MHz, 或 240 MHz"} +{IDF_TARGET_MAX_CPU_FREQ: default="Not updated yet", esp32="80 MHz, 160 MHz, or 240 MHz", esp32s2="80 MHz, 160 MHz, 或 240 MHz", esp32s3="80 MHz, 160 MHz, 或 240 MHz", esp32c2="80 MHz 或 120 MHz", esp32c3="80 MHz 或 160 MHz", esp32c6="80 MHz 或 160 MHz", esp32p4="360 MHz", esp32c5="80 MHz, 160 MHz, 或 240 MHz", esp32c61="80 MHz 或 160 MHz"} 应用程序可以通过获取或释放管理锁来控制电源管理算法。应用程序获取电源管理锁后，电源管理算法的操作将受到下面的限制。释放电源管理锁后，限制解除。