ESP32 Light-sleep 性能实测指南睡眠延迟、唤醒耗时与电流消耗全解析esp-iot-solution【免费下载链接】esp-iot-solutionEspressif IoT Library. IoT Device Drivers, Documentations and Solutions.项目地址: https://gitcode.com/GitHub_Trending/es/esp-iot-solutionLight-sleep浅睡眠是 ESP32 系列在深度睡眠与全速运行之间的一种关键低功耗模式CPU、数字外设和大部分 RAM 被时钟门控供电电压降低而唤醒后外设与 CPU 立即恢复运行且内部状态完整保留。本文基于 esp-iot-solution 仓库中的官方性能测试文档 light_sleep_performance.rst结合仓库内的实际示例代码完整呈现进入睡眠的时间、唤醒恢复的时间、不同唤醒源下的睡眠电流实测数据以及 GPIO 泄漏电流对功耗的影响与规避方法帮助开发者在电池供电、按钮唤醒、GUI 待机等场景中正确使用esp_light_sleep_start()并预估真实功耗表现。Light-sleep 模式原理概述Light-sleep 是 ESP-IDF 提供的另一种省电模式。在 Light-sleep 状态下CPU 与数字外设被时钟门控clock-gated停止执行指令与驱动外设大部分 RAM 保持供电因此不需要像 Deep-sleep 那样保存与恢复上下文供电电压被降低从而进一步削减静态功耗唤醒后程序从上次暂停的位置继续执行而不是像复位后那样从头运行。应用代码只需要调用esp_err_t esp_light_sleep_start()即可进入 Light-sleep 模式。该调用会阻塞直到某个已配置的唤醒源触发之后函数返回程序继续执行。由于不需要重新初始化外设和恢复内存状态Light-sleep 非常适合“短暂待机 快速响应”的场景例如按下按钮后进入待机、再次按下立即恢复GUI 界面空闲超时后自动休眠、触摸唤醒参见 lvgl_light_sleep_demo定时巡检类传感器应用。进入睡眠的延迟约 200us官方测试首先测量了从调用esp_light_sleep_start()到芯片完全进入 Light-sleep所需的时间。测试方法是在调用前将 GPIO18 从高电平拉低用逻辑分析仪/示波器观察芯片电流变化gpio_set_level(GPIO_NUM_18, 1); vTaskDelay(2000 / portTICK_PERIOD_MS); gpio_set_level(GPIO_NUM_18, 0); esp_light_sleep_start();从波形可以看到调用esp_light_sleep_start()之后芯片电流从工作态约 20mA 量级快速下降并稳定在约 1.8mA 的睡眠水平整个进入过程大约耗时200us。这个量级意味着即使频繁进出 Light-sleep模式切换本身带来的时间开销也很小不会明显影响系统的响应性。唤醒恢复时间约 566us第二次测试测量的是从唤醒源触发到芯片恢复运行的时间。文档中以 ext0 作为唤醒源进行验证。测试流程是先通过esp_sleep_enable_ext0_wakeup()将 GPIO34 配置为 ext0 唤醒源低电平触发然后进入睡眠唤醒后立即把 GPIO18 拉高以标记恢复时刻esp_sleep_enable_ext0_wakeup(GPIO_NUM_34, 0); gpio_set_level(GPIO_NUM_18, 0); esp_light_sleep_start(); gpio_set_level(GPIO_NUM_18, 1);从波形可以看出ext0 唤醒源触发后芯片电流从睡眠水平回升至工作电流整个恢复过程约566us。需要特别强调的是唤醒后程序从上次停止的位置继续执行即esp_light_sleep_start()返回而不是重新启动这正是 Light-sleep 相比 Deep-sleep 在“恢复速度 无需重建上下文”上的核心优势。唤醒源配置小结API作用esp_sleep_enable_ext0_wakeup(gpio, level)单个 GPIO 电平触发唤醒RTC GPIOesp_sleep_enable_ext1_wakeup(mask, mode)多个 GPIO 组合触发唤醒esp_sleep_enable_timer_wakeup(us)定时器周期唤醒esp_sleep_get_wakeup_cause()查询本次唤醒原因在 lvgl_light_sleep_demo 中可以看到更完整的组合用法先用esp_sleep_enable_timer_wakeup()配置保底定时唤醒再用gpio_wakeup_enable()esp_sleep_enable_gpio_wakeup()配置触摸 INT 引脚即时唤醒最后调用esp_light_sleep_start()进入睡眠esp_sleep_disable_wakeup_source(ESP_SLEEP_WAKEUP_TIMER); ret esp_sleep_enable_timer_wakeup((uint64_t)CONFIG_EXAMPLE_LIGHT_SLEEP_WAKE_TIMER_MS * 1000ULL); ... if (touch_int_gpio ! GPIO_NUM_NC) { gpio_wakeup_enable(touch_int_gpio, GPIO_INTR_LOW_LEVEL); esp_sleep_enable_gpio_wakeup(); } ... ret esp_light_sleep_start();该示例在进入睡眠前还会依次执行esp_lv_adapter_sleep_prepare()、注销触摸输入、hw_lcd_deinit()等准备工作并在唤醒后重新初始化 LCD、恢复触摸与适配器构成了一个完整的“休眠-唤醒-恢复”工业级流程可作为带显示屏产品集成 Light-sleep 的参考模板。不同唤醒源下的睡眠电流实测文档还对不同唤醒源下的睡眠电流进行了对比测试结论是唤醒源的配置方式会影响 Light-sleep 期间的电流消耗实测结果如下唤醒源睡眠期间电流消耗ext01.15 mAext11.14 mAtimer0.79 mA几点值得注意ext0 / ext1GPIO 唤醒的睡眠电流基本一致约为 1.15 mA比 timer 唤醒高约 0.35 mA原因是 RTC GPIO 唤醒电路需要保持使能以实时监测引脚电平timer 唤醒的睡眠电流最低0.79 mA适合“定时巡检、到点唤醒”类应用以上数据来自官方文档在特定测试板/特定固件配置下测得实际数值会因芯片型号、Flash 配置、GPIO 状态、电源设计等因素变化设计阶段应以自己板卡上的实测为准但相对关系timer ext1 ≈ ext0具有普遍参考价值。GPIO 泄漏电流VDD3P3_CPU 供电引脚的功耗陷阱文档最后给出了一个非常实用的工程提醒进入 Light-sleep 之前所有由VDD3P3_CPU供电的 GPIO 都应被禁用否则由于 GPIO 泄漏电流整体电流会升高大约增加 1.5 mA。这是因为 ESP32 的部分 GPIO 由内部 VDD3P3_CPU 电源轨供电在 Light-sleep 时若这些引脚仍保持使能尤其处于输入/输出悬空等状态会产生额外的泄漏电流路径。在 button_power_save 示例 中按键组件通过button_gpio_config_t的.enable_power_save true选项让按键引脚在休眠期间自动进入省电状态正是为了避免此类问题button_gpio_config_t gpio_cfg { .gpio_num button_num, .active_level BUTTON_ACTIVE_LEVEL, .enable_power_save true, };实操建议在调用esp_light_sleep_start()之前遍历所有未使用的外设 GPIO将其配置为 GPIO 模式并禁用上拉/下拉或根据电路需求显式置为确定电平必要时调用gpio_hold_enable()保持电平仅保留唤醒所需的 RTC GPIO 处于工作状态。这一步对延长电池寿命往往比选择唤醒源本身更关键。实战在项目中落地 Light-sleep最小集成步骤在menuconfig中启用电源管理Component config → Power Management → PM_ENABLE相关配置说明可参考同目录下的 DFS_test_manual.rst在进入睡眠前配置好唤醒源ext0 / ext1 / timer / GPIO 组合禁用 VDD3P3_CPU 供电的多余 GPIO降低泄漏电流调用esp_light_sleep_start()阻塞进入睡眠函数返回后通过esp_sleep_get_wakeup_cause()判断唤醒原因再决定继续工作或再次休眠。button_power_save 是理解这套流程的最小可运行示例app_main中初始化按键button_enter_power_save回调中直接调用esp_light_sleep_start()唤醒后打印esp_sleep_get_wakeup_cause()的返回值。与自动 Light-sleeptickless idle的区别手动调用esp_light_sleep_start()是“应用决定何时休眠”的显式方式而在CONFIG_FREERTOS_USE_TICKLESS_IDLE开启时配合esp_pm_configure()中.light_sleep_enable true系统会在所有任务空闲时自动进入 Light-sleep应用无需主动调用。同一示例中 power_save_init() 展示了这两种模式的切换配置两者在低功耗策略上互为补充。性能数据汇总为便于工程评估将本文涉及的官方实测数据汇总如下指标实测值进入 Light-sleep 延迟约 200usext0 唤醒恢复时间约 566usext0 唤醒时睡眠电流1.15 mAext1 唤醒时睡眠电流1.14 mAtimer 唤醒时睡眠电流0.79 mA未禁用 VDD3P3_CPU GPIO 时额外泄漏约 1.5 mA结合同仓库的 DFS动态频率调节测试数据XTAL 40MHz 下 13.32mA、240MHz 下 39.95mA详见 DFS_test_manual.rst可以看出Light-sleep 能将电流压到 1mA 量级是普通降频40MHz 仍约 13mA无法比拟的。对于“大部分时间待机、偶尔工作”的物联网设备Light-sleep 事件唤醒是兼顾功耗与响应速度的首选方案而本文的 200us 进睡 / 566us 唤醒指标也为系统在“睡眠-唤醒”间频繁切换的可行性提供了量化依据。【免费下载链接】esp-iot-solutionEspressif IoT Library. IoT Device Drivers, Documentations and Solutions.项目地址: https://gitcode.com/GitHub_Trending/es/esp-iot-solution创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
ESP32 Light-sleep 性能实测指南：睡眠延迟、唤醒耗时与电流消耗全解析（esp-iot-solution）
ESP32 Light-sleep 性能实测指南睡眠延迟、唤醒耗时与电流消耗全解析esp-iot-solution【免费下载链接】esp-iot-solutionEspressif IoT Library. IoT Device Drivers, Documentations and Solutions.项目地址: https://gitcode.com/GitHub_Trending/es/esp-iot-solutionLight-sleep浅睡眠是 ESP32 系列在深度睡眠与全速运行之间的一种关键低功耗模式CPU、数字外设和大部分 RAM 被时钟门控供电电压降低而唤醒后外设与 CPU 立即恢复运行且内部状态完整保留。本文基于 esp-iot-solution 仓库中的官方性能测试文档 light_sleep_performance.rst结合仓库内的实际示例代码完整呈现进入睡眠的时间、唤醒恢复的时间、不同唤醒源下的睡眠电流实测数据以及 GPIO 泄漏电流对功耗的影响与规避方法帮助开发者在电池供电、按钮唤醒、GUI 待机等场景中正确使用esp_light_sleep_start()并预估真实功耗表现。Light-sleep 模式原理概述Light-sleep 是 ESP-IDF 提供的另一种省电模式。在 Light-sleep 状态下CPU 与数字外设被时钟门控clock-gated停止执行指令与驱动外设大部分 RAM 保持供电因此不需要像 Deep-sleep 那样保存与恢复上下文供电电压被降低从而进一步削减静态功耗唤醒后程序从上次暂停的位置继续执行而不是像复位后那样从头运行。应用代码只需要调用esp_err_t esp_light_sleep_start()即可进入 Light-sleep 模式。该调用会阻塞直到某个已配置的唤醒源触发之后函数返回程序继续执行。由于不需要重新初始化外设和恢复内存状态Light-sleep 非常适合“短暂待机 快速响应”的场景例如按下按钮后进入待机、再次按下立即恢复GUI 界面空闲超时后自动休眠、触摸唤醒参见 lvgl_light_sleep_demo定时巡检类传感器应用。进入睡眠的延迟约 200us官方测试首先测量了从调用esp_light_sleep_start()到芯片完全进入 Light-sleep所需的时间。测试方法是在调用前将 GPIO18 从高电平拉低用逻辑分析仪/示波器观察芯片电流变化gpio_set_level(GPIO_NUM_18, 1); vTaskDelay(2000 / portTICK_PERIOD_MS); gpio_set_level(GPIO_NUM_18, 0); esp_light_sleep_start();从波形可以看到调用esp_light_sleep_start()之后芯片电流从工作态约 20mA 量级快速下降并稳定在约 1.8mA 的睡眠水平整个进入过程大约耗时200us。这个量级意味着即使频繁进出 Light-sleep模式切换本身带来的时间开销也很小不会明显影响系统的响应性。唤醒恢复时间约 566us第二次测试测量的是从唤醒源触发到芯片恢复运行的时间。文档中以 ext0 作为唤醒源进行验证。测试流程是先通过esp_sleep_enable_ext0_wakeup()将 GPIO34 配置为 ext0 唤醒源低电平触发然后进入睡眠唤醒后立即把 GPIO18 拉高以标记恢复时刻esp_sleep_enable_ext0_wakeup(GPIO_NUM_34, 0); gpio_set_level(GPIO_NUM_18, 0); esp_light_sleep_start(); gpio_set_level(GPIO_NUM_18, 1);从波形可以看出ext0 唤醒源触发后芯片电流从睡眠水平回升至工作电流整个恢复过程约566us。需要特别强调的是唤醒后程序从上次停止的位置继续执行即esp_light_sleep_start()返回而不是重新启动这正是 Light-sleep 相比 Deep-sleep 在“恢复速度 无需重建上下文”上的核心优势。唤醒源配置小结API作用esp_sleep_enable_ext0_wakeup(gpio, level)单个 GPIO 电平触发唤醒RTC GPIOesp_sleep_enable_ext1_wakeup(mask, mode)多个 GPIO 组合触发唤醒esp_sleep_enable_timer_wakeup(us)定时器周期唤醒esp_sleep_get_wakeup_cause()查询本次唤醒原因在 lvgl_light_sleep_demo 中可以看到更完整的组合用法先用esp_sleep_enable_timer_wakeup()配置保底定时唤醒再用gpio_wakeup_enable()esp_sleep_enable_gpio_wakeup()配置触摸 INT 引脚即时唤醒最后调用esp_light_sleep_start()进入睡眠esp_sleep_disable_wakeup_source(ESP_SLEEP_WAKEUP_TIMER); ret esp_sleep_enable_timer_wakeup((uint64_t)CONFIG_EXAMPLE_LIGHT_SLEEP_WAKE_TIMER_MS * 1000ULL); ... if (touch_int_gpio ! GPIO_NUM_NC) { gpio_wakeup_enable(touch_int_gpio, GPIO_INTR_LOW_LEVEL); esp_sleep_enable_gpio_wakeup(); } ... ret esp_light_sleep_start();该示例在进入睡眠前还会依次执行esp_lv_adapter_sleep_prepare()、注销触摸输入、hw_lcd_deinit()等准备工作并在唤醒后重新初始化 LCD、恢复触摸与适配器构成了一个完整的“休眠-唤醒-恢复”工业级流程可作为带显示屏产品集成 Light-sleep 的参考模板。不同唤醒源下的睡眠电流实测文档还对不同唤醒源下的睡眠电流进行了对比测试结论是唤醒源的配置方式会影响 Light-sleep 期间的电流消耗实测结果如下唤醒源睡眠期间电流消耗ext01.15 mAext11.14 mAtimer0.79 mA几点值得注意ext0 / ext1GPIO 唤醒的睡眠电流基本一致约为 1.15 mA比 timer 唤醒高约 0.35 mA原因是 RTC GPIO 唤醒电路需要保持使能以实时监测引脚电平timer 唤醒的睡眠电流最低0.79 mA适合“定时巡检、到点唤醒”类应用以上数据来自官方文档在特定测试板/特定固件配置下测得实际数值会因芯片型号、Flash 配置、GPIO 状态、电源设计等因素变化设计阶段应以自己板卡上的实测为准但相对关系timer ext1 ≈ ext0具有普遍参考价值。GPIO 泄漏电流VDD3P3_CPU 供电引脚的功耗陷阱文档最后给出了一个非常实用的工程提醒进入 Light-sleep 之前所有由VDD3P3_CPU供电的 GPIO 都应被禁用否则由于 GPIO 泄漏电流整体电流会升高大约增加 1.5 mA。这是因为 ESP32 的部分 GPIO 由内部 VDD3P3_CPU 电源轨供电在 Light-sleep 时若这些引脚仍保持使能尤其处于输入/输出悬空等状态会产生额外的泄漏电流路径。在 button_power_save 示例 中按键组件通过button_gpio_config_t的.enable_power_save true选项让按键引脚在休眠期间自动进入省电状态正是为了避免此类问题button_gpio_config_t gpio_cfg { .gpio_num button_num, .active_level BUTTON_ACTIVE_LEVEL, .enable_power_save true, };实操建议在调用esp_light_sleep_start()之前遍历所有未使用的外设 GPIO将其配置为 GPIO 模式并禁用上拉/下拉或根据电路需求显式置为确定电平必要时调用gpio_hold_enable()保持电平仅保留唤醒所需的 RTC GPIO 处于工作状态。这一步对延长电池寿命往往比选择唤醒源本身更关键。实战在项目中落地 Light-sleep最小集成步骤在menuconfig中启用电源管理Component config → Power Management → PM_ENABLE相关配置说明可参考同目录下的 DFS_test_manual.rst在进入睡眠前配置好唤醒源ext0 / ext1 / timer / GPIO 组合禁用 VDD3P3_CPU 供电的多余 GPIO降低泄漏电流调用esp_light_sleep_start()阻塞进入睡眠函数返回后通过esp_sleep_get_wakeup_cause()判断唤醒原因再决定继续工作或再次休眠。button_power_save 是理解这套流程的最小可运行示例app_main中初始化按键button_enter_power_save回调中直接调用esp_light_sleep_start()唤醒后打印esp_sleep_get_wakeup_cause()的返回值。与自动 Light-sleeptickless idle的区别手动调用esp_light_sleep_start()是“应用决定何时休眠”的显式方式而在CONFIG_FREERTOS_USE_TICKLESS_IDLE开启时配合esp_pm_configure()中.light_sleep_enable true系统会在所有任务空闲时自动进入 Light-sleep应用无需主动调用。同一示例中 power_save_init() 展示了这两种模式的切换配置两者在低功耗策略上互为补充。性能数据汇总为便于工程评估将本文涉及的官方实测数据汇总如下指标实测值进入 Light-sleep 延迟约 200usext0 唤醒恢复时间约 566usext0 唤醒时睡眠电流1.15 mAext1 唤醒时睡眠电流1.14 mAtimer 唤醒时睡眠电流0.79 mA未禁用 VDD3P3_CPU GPIO 时额外泄漏约 1.5 mA结合同仓库的 DFS动态频率调节测试数据XTAL 40MHz 下 13.32mA、240MHz 下 39.95mA详见 DFS_test_manual.rst可以看出Light-sleep 能将电流压到 1mA 量级是普通降频40MHz 仍约 13mA无法比拟的。对于“大部分时间待机、偶尔工作”的物联网设备Light-sleep 事件唤醒是兼顾功耗与响应速度的首选方案而本文的 200us 进睡 / 566us 唤醒指标也为系统在“睡眠-唤醒”间频繁切换的可行性提供了量化依据。【免费下载链接】esp-iot-solutionEspressif IoT Library. IoT Device Drivers, Documentations and Solutions.项目地址: https://gitcode.com/GitHub_Trending/es/esp-iot-solution创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
