ESP-IDF 电源管理（Power Management）深度实战指南：动态频率缩放、自动 Light-sleep 与电源管理锁

ESP-IDF 电源管理（Power Management）深度实战指南：动态频率缩放、自动 Light-sleep 与电源管理锁

【免费下载链接】esp-idfEspressif IoT Development Framework. Official development framework for Espressif SoCs.项目地址: https://gitcode.com/GitHub_Trending/es/esp-idf

导读

ESP-IDF 内置的电源管理（Power Management）子系统，能够在满足应用组件需求的前提下，动态调整 APB 外设总线频率、CPU 频率，并在空闲时自动进入 Light-sleep 模式，从而让应用以尽可能小的功耗运行。本文以官方文档 power_management.rst 为主体，结合仓库中的头文件、Kconfig 与示例源码，系统讲解电源管理的启用方式、esp_pm_config_t配置结构、三类电源管理锁的使用、自动 Light-sleep 的时间补偿机制、调试与性能分析方法，以及 DFS 下各外设驱动与 Light-sleep 外设下电的注意事项。读完本文，你将能够为基于 ESP32 / ESP32-C / ESP32-S / ESP32-P4 等芯片的工程正确开启并调优电源管理，显著降低设备平均功耗。

概述：ESP-IDF 电源管理的工作原理

ESP-IDF 的电源管理算法会在运行时调整三类系统资源，以"恰好满足应用组件当前需求"为原则把功耗降到最低：

• APB 外设总线（Advanced Peripheral Bus）频率：APB 是大部分外设的时钟来源，降低 APB 频率可以降低动态功耗；
• CPU 频率：在任务繁忙时保持高频以保障性能，在空闲时降频省电；
• Light-sleep 模式：当系统完全空闲（没有任何锁被持有）时自动进入 Light-sleep，将芯片整体功耗降到最低。

应用组件通过**创建并获取电源管理锁（Power Management Lock）**来表达自己的需求。例如：

• 某个由 APB 时钟驱动外设的驱动，可以在使用外设期间请求将 APB 频率保持在 80 MHz；
• RTOS 在有任务就绪运行时，可以请求 CPU 运行在最高配置频率；
• 某些外设驱动需要中断保持可用，就必须请求禁用 Light-sleep（因为 Light-sleep 期间中断不会被触发）。

由于提高 APB/CPU 频率或禁用 Light-sleep 都会带来更高的电流消耗，因此各组件应当尽可能少地使用电源管理锁，仅在确实需要时才获取。该算法与锁机制的实现位于 components/esp_pm 目录下，核心源码包括 pm_impl.c、pm_locks.c 等。

配置：启用并初始化电源管理

编译期开关 CONFIG_PM_ENABLE

电源管理必须在编译期显式启用。在 menuconfig 中打开：

Component config > Power Management > Support for power management

对应的 Kconfig 选项为CONFIG_PM_ENABLE，定义于 components/esp_pm/Kconfig。该选项依赖SOC_PM_SUPPORTED（即芯片必须硬件支持电源管理），默认关闭。Kconfig 的帮助文本明确提示：启用后会有运行时开销（中断延迟增大、进入空闲状态耗时变长），同时会降低 RTOS tick 与计时定时器的精度，因此只有应用确实使用电源管理 API 时才应开启。

关于中断延迟的开销，官方文档给出了量化范围：

• 最小额外延迟 0.2 µs：CPU 频率为 240 MHz 且未启用频率缩放（frequency scaling）时；
• 最大额外延迟 40 µs：启用了频率缩放，并且在中断入口处需要执行从 40 MHz 到 80 MHz 的切换时。

延迟大小取决于 CPU 频率、单核/双核模式以及是否需要执行频率切换。

运行时配置：esp_pm_configure 与 esp_pm_config_t

应用调用esp_pm_configure来启用动态频率缩放（DFS，Dynamic Frequency Scaling）和自动 Light-sleep，其原型与配置结构定义在 components/esp_pm/include/esp_pm.h：

typedef struct { int max_freq_mhz; /*!< Maximum CPU frequency, in MHz */ int min_freq_mhz; /*!< Minimum CPU frequency to use when no locks are taken, in MHz */ bool light_sleep_enable; /*!< Enter light sleep when no locks are taken */ } esp_pm_config_t; esp_err_t esp_pm_configure(const void* config);

三个字段的含义与取值说明如下：

esp_pm_configure的返回值语义（见头文件注释）：

• ESP_OK：配置成功；
• ESP_ERR_INVALID_ARG：配置值不正确；
• ESP_ERR_NOT_SUPPORTED：参数组合不受支持，或CONFIG_PM_ENABLE未在 sdkconfig 中启用。

与之配套的还有esp_pm_get_configuration，用于读取当前的电源管理配置（示例task_pm_dump中即用它周期性打印配置）。

自动初始化：CONFIG_PM_DFS_INIT_AUTO

除了在应用代码中手动调用esp_pm_configure，还可以在 menuconfig 中开启CONFIG_PM_DFS_INIT_AUTO（Component config > Power Management > Enable dynamic frequency scaling (DFS) at startup）。开启后，启动代码会自动配置动态频率缩放：

• 最大 CPU 频率取CONFIG_ESP_DEFAULT_CPU_FREQ_MHZ的值；
• 最小 CPU 频率固定锁定为 XTAL 晶振频率。

若该选项关闭（默认），则 DFS 不会生效，直到应用主动调用esp_pm_configure。

使用自动 Light-sleep 的两条硬性前提

1. 必须开启 FreeRTOS Tickless Idle：自动 Light-sleep 基于 FreeRTOS 的 Tickless Idle 功能实现。如果请求自动 Light-sleep 时CONFIG_FREERTOS_USE_TICKLESS_IDLE未在 menuconfig 中启用，esp_pm_configure将返回错误码ESP_ERR_NOT_SUPPORTED。
2. 禁止手动配置定时器唤醒源：自动 Light-sleep 本身使用定时器唤醒（timer wakeup）实现，因此应用不得手动配置定时器唤醒源，否则会与电源管理机制冲突。

另外需要理解：在 Light-sleep 中，外设被时钟门控（clock gated），GPIO 与内部外设产生的中断不会被触发。芯片需要依靠 睡眠模式文档 中描述的唤醒源（wakeup source）从 Light-sleep 状态唤醒，例如：

• 支持 EXT0/EXT1 唤醒的芯片（如 ESP32、ESP32-S2、ESP32-S3 等），可通过 GPIO 触发 EXT0/EXT1 唤醒；
• 仅支持 EXT1 唤醒的芯片，则使用 EXT1 唤醒源。

电源管理锁（Power Management Locks）

应用通过获取/释放电源管理锁来控制电源管理算法的行为：获取锁后，算法受到相应约束（例如必须保持高频、必须禁用 Light-sleep）；释放锁后约束解除。

关键机制：电源管理锁带有获取/释放计数器（acquire/release counters）。锁被获取 N 次，就必须释放 N 次，相关约束才会真正解除。这一点在头文件 esp_pm.h 的注释中也有明确说明："锁是递归的（recursive），esp_pm_lock_acquire被调用多少次，就必须调用相同次数的esp_pm_lock_release才能释放。"此外，esp_pm_lock_acquire/esp_pm_lock_release允许在中断上下文（ISR）中调用，而esp_pm_lock_create/esp_pm_lock_delete不允许。

三种锁类型

esp_pm_lock_type_t枚举定义了三种锁，定义于 esp_pm.h：

三种锁的arg参数均未使用，应设置为 0。ESP_PM_LOCK_MAX是枚举的哨兵值，用于数组边界（如统计 API 中）。

锁的完整生命周期 API

锁的创建、获取、释放与删除对应四个 API（原型见 esp_pm.h）：

esp_err_t esp_pm_lock_create(esp_pm_lock_type_t lock_type, int arg, const char* name, esp_pm_lock_handle_t* out_handle); esp_err_t esp_pm_lock_acquire(esp_pm_lock_handle_t handle); esp_err_t esp_pm_lock_release(esp_pm_lock_handle_t handle); esp_err_t esp_pm_lock_delete(esp_pm_lock_handle_t handle);

• esp_pm_lock_create：创建锁句柄。name是任意字符串（如"wifi"、"spi"），用于esp_pm_dump_locks列出锁时标识身份，可为 NULL；若非 NULL，则必须指向在锁整个生命周期内有效的字符串。初始状态为"未获取"。若lock_type非法会导致 abort。
• esp_pm_lock_acquire：获取锁。获取后，电源管理算法将不会切换到该锁对应的低功耗状态。可在 ISR 中调用。
• esp_pm_lock_release：释放锁。若锁未被获取过，返回ESP_ERR_INVALID_STATE。可在 ISR 中调用。
• esp_pm_lock_delete：删除锁。必须先完全释放再删除，否则返回ESP_ERR_INVALID_STATE。不能在 ISR 中调用。

频率切换算法（以具体芯片为例）

启用 DFS 后，CPU 与 APB 频率会根据锁的获取情况自动切换。最大 CPU 频率由esp_pm_configure或CONFIG_ESP_DEFAULT_CPU_FREQ_MHZ指定。官方文档通过inc/power_management_{chip}.rst按芯片分别给出切换表，这里以 ESP32 为例（见 power_management_esp32.rst）：

而对于 ESP32-C3（见 power_management_esp32c3.rst），规律相同但最大频率档位不同（160 MHz 或 80 MHz）。其余芯片的切换表可分别查阅仓库中的 power_management_esp32c2.rst、power_management_esp32c5.rst、power_management_esp32c6.rst、power_management_esp32c61.rst、power_management_esp32h2.rst、power_management_esp32p4.rst、power_management_esp32s2.rst、power_management_esp32s3.rst 等文件。

总体规律可以概括为：ESP_PM_APB_FREQ_MAX是"更强"的约束——它同时把 CPU 拉到不低于 80 MHz（保证 CPU 能跟上 APB 外设的通信速率）；ESP_PM_CPU_FREQ_MAX只在 CPU 频率是瓶颈时使用；当没有任何锁时，CPU 与 APB 均降至min_freq_mhz。

Light-sleep 的进入时机与时长确定

当没有任何锁被获取，且esp_pm_configure中启用了 Light-sleep 时，系统自动进入 Light-sleep。睡眠时长由以下事件共同决定：

• 带有有限超时（finite timeouts）阻塞的 FreeRTOS 任务；
• 通过 高分辨率定时器 API 注册的定时器。

系统会选择在最近的下一个事件（任务被解除阻塞，或定时器到期）之前唤醒芯片。若希望跳过不必要的唤醒，可以创建一个skip_unhandled_events选项为true的esp_timer——带此标志的定时器不会唤醒系统，从而进一步降低功耗。

自动 Light-sleep 的时间补偿机制

预测式时间补偿原理

ESP-IDF 对自动 Light-sleep 采用预测式时间补偿机制。系统在每次 Light-sleep 周期结束后测量实际唤醒开销（wakeup overhead），并用该测量值预测下一次睡眠周期的唤醒开销。流程如下：

1. 根据下一个计划事件计算睡眠时长，再减去（上一次周期测得的）预测唤醒开销，据此设置唤醒定时器；
2. 唤醒后，由于 FreeRTOS 的 systick 中断在睡眠期间被挂起，系统需要调用vTaskStepTick()补偿睡眠期间流逝的 tick，以维持 FreeRTOS tick 计数的准确性；
3. 同时测量本次实际开销并保存，用于下一次预测——形成一个随系统行为自适应调整的反馈闭环。

为什么需要 Tick 溢出保护

实际唤醒开销可能因缓存未命中（cache misses）、CPU 频率变化、Flash 延迟波动或硬件状态恢复时间而波动。当实际开销超过预测值时，实际睡眠时间可能超出预期，导致vTaskStepTick()收到过大的 tick 补偿值，从而触发断言失败（assertion failure）。

为此，ESP-IDF 提供CONFIG_PM_LIGHTSLEEP_TICK_OVERFLOW_PROTECTION（Component config > Power Management > Enable light sleep tick overflow protection），定义于 Kconfig。开启后系统会限制 tick 补偿值以防止溢出，对"睡过头（oversleep）"的处理逻辑如下：

• 睡过头在容差范围内（容差由CONFIG_PM_LIGHTSLEEP_TICK_OVERFLOW_TOLERANCE配置，默认 2 tick，取值范围 1~10）：系统静默地将slept_ticks限制为xExpectedIdleTime，避免断言失败；
• 睡过头超过容差（可能意味着存在 bug）：系统不限制 tick，打印错误日志，随后断言失败仍会发生；
• 极端边缘情况：可能丢失 tick，导致 FreeRTOS 的 tick 计数（xTickCount）滞后于真实时间（esp_timer）。使用vTaskDelay()的任务可能经历比预期稍长的延迟，FreeRTOS 软件定时器精度也可能下降。

开启 vs 关闭的权衡（官方建议）：

• 关闭（默认）：tick 补偿精确，对时间敏感型应用精度更好；但在边缘情况下，若唤醒开销估计不足导致 Light-sleep 睡过头，可能触发断言失败与系统崩溃；
• 开启：牺牲少量 RTOS tick 精度，换取系统健壮性。官方建议默认保持关闭以维持 tick 精度，仅当遇到与vTaskStepTick()相关的断言失败、且能接受 RTOS tick 时间相对真实时间的轻微偏差时，才启用该保护。

Kconfig 中对该选项的help文本与上文语义完全一致，并进一步说明：更高的容差值对估计方差有更多容忍，但可能掩盖真实问题并导致更多 tick 丢失，使 RTOS tick 相对真实时间的偏差更大；更低的容差值则 tick 精度更好，但可能产生误报。

调试与性能分析（Debugging and Profiling）

电源管理子系统提供三个函数，帮助应用调试和分析锁的使用情况（原型均见 esp_pm.h）：

这些函数对以下场景尤其有用：

1. 识别锁泄漏——锁被获取后从未释放；
2. 判断是哪些组件在阻止系统省电；
3. 通过分析锁的使用模式优化功耗；
4. 调试应用中与锁管理相关的问题。

注意：esp_pm_dump_locks不能在 ISR 中调用；若在转储过程中有其他线程并发执行acquire/release，可能输出不一致的结果。

若要启用 profiling 功能（记录单个锁的持有时间），需要在 menuconfig 中开启CONFIG_PM_PROFILING（Kconfig）。该选项开启后，esp_pm_*函数会跟踪每个锁被持有的时长，esp_pm_dump_locks会打印这些信息，esp_pm_lock_instance_stats_t中才会填充times_taken与time_held字段（见头文件中的#ifdef CONFIG_PM_PROFILING条件编译）。Kconfig 同时提示：该功能有运行时开销，生产构建通常应保持关闭。

应用示例：lowpower/power_management

官方示例 lowpower/power_management 演示了动态频率缩放、自动 Light-sleep 与电源管理锁的完整用法。其主程序 power_management_example_main.c 的核心逻辑非常具有代表性，包含两个任务：

app_main中的初始化与配置（对应"运行时配置"一节）：

esp_pm_config_t pm_config = { .max_freq_mhz = CONFIG_EXAMPLE_PM_MAX_FREQ, .min_freq_mhz = CONFIG_EXAMPLE_PM_MIN_FREQ, .light_sleep_enable = CONFIG_EXAMPLE_PM_LIGHT_SLEEP_ENABLE, }; ESP_ERROR_CHECK(esp_pm_configure(&pm_config));

三个字段全部通过示例自身的 Kconfig 选项（CONFIG_EXAMPLE_PM_MAX_FREQ/CONFIG_EXAMPLE_PM_MIN_FREQ/CONFIG_EXAMPLE_PM_LIGHT_SLEEP_ENABLE）在 menuconfig 中配置。

task_demo_nested_locks中的嵌套锁演示（对应"锁的完整生命周期"一节）：

esp_pm_lock_create(ESP_PM_NO_LIGHT_SLEEP, 0, "demo_no_ls", &lock_no_ls); esp_pm_lock_create(ESP_PM_APB_FREQ_MAX, 0, "demo_apb", &lock_apb); esp_pm_lock_create(ESP_PM_CPU_FREQ_MAX, 0, "demo_cpu", &lock_cpu); esp_pm_lock_acquire(lock_no_ls); // CPU 工作在 min_freq_mhz，但不会进入 Light-sleep，保持中断响应能力 vTaskDelay(pdMS_TO_TICKS(200)); esp_pm_lock_acquire(lock_apb); // CPU 提升到 APB 最大频率对应的档位，保证外设以高频工作 vTaskDelay(pdMS_TO_TICKS(200)); esp_pm_lock_acquire(lock_cpu); // CPU 工作在 max_freq_mhz，达到最佳性能 vTaskDelay(pdMS_TO_TICKS(200)); esp_pm_lock_release(lock_cpu); esp_pm_lock_release(lock_apb); esp_pm_lock_release(lock_no_ls); // 若 light_sleep_enable 为 true，系统进入 Light-sleep；否则 CPU 在 IDLE 时停在 min_freq_mhz vTaskDelay(pdMS_TO_TICKS(400));

这段代码清晰地展示了三种锁各自约束的状态：NO_LIGHT_SLEEP只禁睡眠不升频；APB_FREQ_MAX把 CPU/APB 拉到外设可用档位；CPU_FREQ_MAX进一步把 CPU 拉满。释放顺序与获取顺序相反，且每个锁只 acquire/release 一次。

task_pm_dump中的调试输出（对应"调试与性能分析"一节）：每 10 秒调用一次esp_pm_get_configuration打印当前 max/min 频率与 light_sleep 开关，并调用esp_pm_dump_locks(stdout)转储所有锁的状态，方便在串口监视器上直观观察锁的持有与释放过程。

仓库中对应的自动化测试位于 components/esp_pm/test_apps/esp_pm，其中的 test_pm.c 覆盖了esp_pm_configure、各类锁的获取/释放行为、DFS 频率切换以及 tickless idle 等场景，可作为理解算法行为的补充参考。

DFS 与外设驱动：哪些驱动感知频率变化

启用 DFS 后，APB 频率可能在单个 RTOS tick 内多次变化。频率变化对部分外设没有影响，对另一些外设则可能产生问题。例如：

• Timer Group 外设定时器：在 APB 频率变化时依然继续计数，但其计数速率会随 APB 频率成比例变化——若应用依赖定时器计数值换算时间，就必须考虑这一点。

建议：像REF_TICK、XTAL、RC_FAST（即RTC_8M）这样的外设时钟源，其频率不受 APB 频率影响。为保证外设在 DFS 期间行为一致，建议选择其中一种作为外设时钟源。更具体的指导请查阅各外设的 "API Reference > Peripherals API" 页面中的 "Power Management" 小节。

事务期间持有锁的驱动（transaction 期间持 ESP_PM_APB_FREQ_MAX）

目前以下外设驱动感知 DFS，并在事务持续期间持有ESP_PM_APB_FREQ_MAX锁：

• SPI master
• I2C
• I2S：对于 I2S 硬件版本 1 或不支持 APLL 的芯片，直接持有ESP_PM_APB_FREQ_MAX；对于非版本 1 且支持 APLL 的芯片，若使用 APLL 时钟，则改用ESP_PM_NO_LIGHT_SLEEP锁
• SDMMC

驱动使能期间持续持有锁的驱动

以下驱动在"驱动使能"的整个生命周期内持续持有ESP_PM_APB_FREQ_MAX锁：

理解这些行为有助于判断"为什么系统没有进入更低的功耗状态"——很可能是某个已使能的驱动在持有ESP_PM_APB_FREQ_MAX锁。

进阶特性：Light-sleep 外设下电（Peripheral Power Down）

对于支持 TOP 电源域下电的芯片（SOC_PM_SUPPORT_TOP_PD），Light-sleep 期间可以将数字外设电源域一并下电，进一步降低睡眠电流。

工作机制

开启CONFIG_PM_POWER_DOWN_PERIPHERAL_IN_LIGHT_SLEEP（Component config > Power Management > Power down Digital Peripheral in light sleep，Kconfig，默认关闭）后：

1. 驱动初始化外设时，会将该外设的工作寄存器上下文注册到 sleep retention link；
2. 进入睡眠前，REG_DMA外设读取 sleep retention link 中的配置，按配置把寄存器上下文备份到内存；
3. 唤醒时，REG_DMA再从内存把上下文恢复到外设寄存器。

这样上层应用基本无感知地实现了"外设随睡眠下电、随唤醒恢复"。

已支持上下文保持的外设

目前 ESP-IDF 支持以下外设的 Light-sleep 上下文保持（寄存器上下文自动恢复，或提供选项供用户开启后进入外设下电模式）：

• INT_MTX（中断矩阵）
• TEE/APM
• IO_MUX / GPIO
• MSPI（SPI0/1）
• SYSTIMER
• GPTimer（SOC_TIMER_SUPPORT_SLEEP_RETENTION）
• RMT（SOC_RMT_SUPPORT_SLEEP_RETENTION）
• ETM（SOC_ETM_SUPPORT_SLEEP_RETENTION）
• LEDC（SOC_LEDC_SUPPORT_SLEEP_RETENTION）
• I2C（SOC_I2C_SUPPORT_SLEEP_RETENTION）
• I2S（SOC_I2S_SUPPORT_SLEEP_RETENTION）
• MCPWM（SOC_MCPWM_SUPPORT_SLEEP_RETENTION）
• 所有 UART（SOC_UART_SUPPORT_SLEEP_RETENTION）
• Temperature Sensor（SOC_TEMPERATURE_SENSOR_SUPPORT_SLEEP_RETENTION）
• 所有 TWAI（SOC_TWAI_SUPPORT_SLEEP_RETENTION）
• PARL_IO（SOC_PARLIO_SUPPORT_SLEEP_RETENTION）
• 所有 GPSPI（SOC_SPI_SUPPORT_SLEEP_RETENTION）
• EMAC（SOC_EMAC_SUPPORT_SLEEP_RETENTION）
• I80 LCD（SOC_LCDCAM_LCD_SUPPORT_SLEEP_RETENTION）

会阻止外设下电与暂不支持的外设

部分外设尚未支持上下文保持，或无法在寄存器丢失后存活，只要它们处于使能状态，即使开启了该功能，外设电源域也不会下电：

• SDIO Slave（SOC_SDIO_SLAVE_SUPPORTED）
• PCNT（SOC_PCNT_SUPPORTED）

以下外设（以及本节未列出的任何外设）尚未支持。若应用使用了这些外设，它们可能在从睡眠唤醒后无法正常工作：

• ASSIST_DEBUG
• Trace
• Crypto 系列：AES / ECC / HMAC / RSA / SHA / DS / XTA_AES / ECDSA
• USB-Serial-JTAG
• SARADC

使用该功能的重要注意事项

1. IO 保持（hold）：当外设电源域在睡眠期间下电时，IO_MUX 和 GPIO 模块均处于非活动状态，芯片引脚的状态不再由这两个模块维持。若需要在睡眠期间保持某个 IO 的状态，必须在配置 GPIO 状态前后调用gpio_hold_dis和gpio_hold_en，将 IO 配置锁存，防止 IO 在睡眠期间悬空（floating）。
2. 内存开销：启用该选项会增加静态 RAM 与堆（heap）占用（具体取决于已初始化的外设），为运行 FreeRTOS 所需硬件的上下文保存/恢复，睡眠时至少需要约 4.55 KB 可用堆，否则睡眠将不会对外设下电。
3. 与 Tickless Idle 的配合：同时启用该选项与FREERTOS_USE_TICKLESS_IDLE时，由于 UART 会被下电，睡眠前会冲刷 UART FIFO 以避免数据丢失，但这可能阻塞睡眠过程、错过唤醒时间点，导致唤醒后 FreeRTOS tick 无法正确补偿而崩溃。可通过提高FREERTOS_IDLE_TIME_BEFORE_SLEEP阈值来规避。
4. 优先级：esp_sleep_pd_config的优先级高于该选项——用户代码仍可通过esp_sleep_pd_config(ESP_PD_DOMAIN_TOP, ESP_PD_OPTION_ON)阻止外设电源域在睡眠期间下电。此外，只要属于外设电源域的任何一个模块选择不在睡眠期间下电，整个外设电源域都不会下电。

相关的其他低功耗配置项

除上文重点讲解的选项外，components/esp_pm/Kconfig 还提供了若干可选的功耗优化配置，可供进阶调优：

总结

ESP-IDF 的电源管理是一个"需求驱动"的闭环系统：应用组件通过三种电源管理锁（ESP_PM_CPU_FREQ_MAX、ESP_PM_APB_FREQ_MAX、ESP_PM_NO_LIGHT_SLEEP）表达约束，电源管理算法据此实时调节 CPU/APB 频率，并在完全空闲时进入自动 Light-sleep。掌握这一机制的关键在于理解：

1. 配置链路：CONFIG_PM_ENABLE（编译期）→esp_pm_configure（运行时）或CONFIG_PM_DFS_INIT_AUTO（启动时自动），且自动 Light-sleep 依赖CONFIG_FREERTOS_USE_TICKLESS_IDLE；
2. 锁的计数语义：获取与释放必须成对，且驱动持有锁的时机决定了系统能否降频/入睡；
3. 时间补偿与健壮性权衡：默认关闭CONFIG_PM_LIGHTSLEEP_TICK_OVERFLOW_PROTECTION以保 tick 精度，遇到vTaskStepTick()断言失败时再开启；
4. 调试手段：esp_pm_dump_locks、esp_pm_get_lock_stats_all、esp_pm_lock_get_stats配合CONFIG_PM_PROFILING，可快速定位锁泄漏与功耗瓶颈；
5. 外设协同：了解哪些驱动在什么时机持有锁、哪些外设支持 Light-sleep 上下文保持，是低功耗设计落地的前提。

如需进一步深入，建议直接阅读 esp_pm.h 的 API 注释、Kconfig 各选项的 help 文本、运行 lowpower/power_management 示例观察串口输出，并结合 睡眠模式文档 选择合适的唤醒源。

【免费下载链接】esp-idfEspressif IoT Development Framework. Official development framework for Espressif SoCs.项目地址: https://gitcode.com/GitHub_Trending/es/esp-idf