2023-11-20 06:22:25 -05:00
低功耗模式使用指南
==================
:link_to_translation:`en:[English]`
对于物联网应用场景，终端的待机性能表现十分重要，本文档旨在介绍 {IDF_TARGET_NAME} 低功耗的基本原理，同时介绍 {IDF_TARGET_NAME} 支持的低功耗模式，需注意本文档主要针对 station mode。文档还会具体给出每种模式的配置步骤、推荐配置和功耗表现，
系统低功耗模式介绍
----------------------------------
低功耗模式不仅涉及到系统相关问题，还涉及到芯片具体的工作场景，如处在 Wi-Fi 工作场景就会与处在蓝牙工作场景时产生不同。为此本节将首先介绍纯系统角度，即不涉及具体场景的低功耗模式，主要有 DFS、Light-sleep、Deep-sleep。纯系统下的低功耗模式主要思想就是在休眠时关闭或门控一些功能模块来降低功耗。
DFS
++++++++++++++++++++++++++++++++++
DFS (Dynamic frequency scaling) 即动态频率切换，是 ESP-IDF 中集成的电源管理机制的基础功能。DFS 可以根据应用程序持有电源锁的情况，调整外围总线 (APB) 频率和 CPU 频率。持有高性能锁就使用高频，空闲状态不持有电源锁时则使用低频来降低功耗，以此来尽可能减少运行应用程序的功耗。
DFS 的调频机制即根据持有电源锁的最大频率需求来调整频率， ， :doc: `电源管理 <../api-reference/system/power_management>` 。
下图为 DFS 调频机制运行的理想电流情况。
.. figure :: ../../_static/Low-power-DFS-current.png
:align: center
理想 DFS 机制调频电流图
DFS 适用于 CPU 必须处于工作状态但是对低功耗有需求的场景，因此 DFS 经常与其他低功耗模式共同开启，下文会详细介绍。
Light-sleep
++++++++++++++++++++++++++++++++++
Light-sleep 模式是 {IDF_TARGET_NAME} 预设的一种低功耗模式， ，
Auto Light-sleep 模式是 ESP-IDF 电源管理机制和 Light-sleep 模式的结合。开启电源管理机制是其前置条件， ， ， ，
Auto Light-sleep 依赖于电源管理机制，系统经过提前判断，发现空闲时间超过设定时间时，则直接进入休眠。该过程为自动进行。休眠时会自动关闭 RF、8 MHz 振荡器、40 MHz 高速晶振、PLL、门控数字内核时钟，
Auto Light-sleep 模式需配置唤醒源。该模式拥有多种唤醒源，支持相互组合，此时任何一个唤醒源都可以触发唤醒。唤醒后，会从进入休眠的位置继续执行程序。若不配置唤醒源，进入 Light-sleep 休眠后，芯片将一直处在睡眠状态，直到外部复位。具体唤醒源有 RTC 定时器、触摸传感器、外部唤醒 (ext0)、外部唤醒 (ext1)、ULP 协处理器、SDIO、GPIO、UART、Wi-Fi、BT 唤醒等。
Auto Light-sleep 模式工作流程相对复杂，但是进入休眠状态是自动进行，同时需注意在进入前配置好唤醒源，防止芯片一直处在休眠状态。
.. figure :: ../../_static/Low-power-auto-light-sleep-process.png
:align: center
Auto Light-sleep 模式工作流程图
根据 Auto Light-sleep 的工作流程可得其理想电流图，关键节点均在图上标出。
.. figure :: ../../_static/Low-power-auto-light-sleep-current.png
:align: center
Auto Light-sleep 模式模式理想电流图
.. note ::
为更加清晰地展现出 Auto Light-sleep 的主要变化，图中省略了 DFS 降频过程。
Auto Light-sleep 模式适用于不需要实时响应外界需求的场景。
Deep-sleep
++++++++++++++++++++++++++++++++++
Deep-sleep 模式是为了追求更好的功耗表现所设计，休眠时仅保留 RTC 控制器、RTC 外设（ ） ，
Deep-sleep 通过调用 API 进入，休眠时会关闭除 RTC 控制器、RTC 外设、ULP 协处理器、RTC 高速内存、RTC 低速内存外的所有模块。
Deep-sleep 模式需配置唤醒源，其拥有多种唤醒源，这些唤醒源也可以组合在一起，此时任何一个唤醒源都可以触发唤醒。若不配置唤醒源进入 Deep-sleep 模式，芯片将一直处在睡眠状态，直到外部复位。具体唤醒源有 RTC 定时器、触摸传感器、外部唤醒 (ext0)、外部唤醒 (ext1)、ULP 协处理器、GPIO 唤醒等。
Deep-sleep 模式工作流程如下图所示：
.. figure :: ../../_static/Low-power-deep-sleep-process.png
:align: center
Deep-sleep 模式工作流程图
Deep-sleep 模式主要应用场景决定了系统很长时间才会苏醒一次，完成工作后又会继续进入 Deep-sleep，
.. figure :: ../../_static/Low-power-deep-sleep-current.png
:align: center
Deep-sleep 模式理想电流图
Deep-sleep 可以用于低功耗的传感器应用，或是大部分时间都不需要进行数据传输的情况，也就是通常所说的待机模式。设备可以每隔一段时间从 Deep-sleep 状态醒来测量数据并上传，之后重新进入 Deep-sleep； ，
如何配置纯系统下低功耗模式
+++++++++++++++++++++++++++++++++++++
介绍完纯系统下的低功耗模式后，本节将介绍公共配置选项、每种模式独有的配置选项，以及相应低功耗模式 API 的使用说明，同时给出相应模式推荐的配置。
公共配置选项
+++++++++++++
.. only :: esp32 or esp32s3
- 单双核工作模式
对于多核心芯片，可以选择单核工作模式。
- RTOS Tick rate (Hz)
该参数表示系统周期任务调度的频率。例如，当 RTOS Tick rate 配置为 1000 时，系统每毫秒都会进行一次任务调度；空闲时，系统也能够更敏锐的感知到空闲状态。
DFS 配置
+++++++++++++++++++++++
DFS 有如下可配置选项：
- max_freq_mhz
该参数表示最大 CPU 频率 (MHz)，即 CPU 最高性能工作时候的频率，一般设置为芯片参数的最大值。
- min_freq_mhz
该参数表示最小 CPU 频率 (MHz)，即系统处在空闲状态时 CPU 的工作频率。该字段可设置为晶振 (XTAL) 频率值，或者 XTAL 频率值除以整数。
- light_sleep_enable
使能该选项，系统将在空闲状态下自动进入 Light-sleep 状态，即 Auto Light-sleep 使能，上文已经具体介绍。
具体配置方法如下：
- 1. 使能 CONFIG_PM_ENABLE
- 2. 配置 max_freq_mhz 和 min_freq_mhz，
::
esp_pm_config_t pm_config = {
.max_freq_mhz = CONFIG_EXAMPLE_MAX_CPU_FREQ_MHZ,
.min_freq_mhz = CONFIG_EXAMPLE_MIN_CPU_FREQ_MHZ,
2024-01-19 06:29:00 -05:00
.light_sleep_enable = false
2023-11-20 06:22:25 -05:00
};
2024-01-19 06:29:00 -05:00
ESP_ERROR_CHECK(esp_pm_configure(&pm_config));
2023-11-20 06:22:25 -05:00
推荐配置：
.. list-table ::
:header-rows: 1
:widths: 20 20
* - 配置名称
- 设置情况
* - CONFIG_PM_ENABLE
- ON
* - RTOS Tick rate (Hz)
- 1000
* - max_freq_mhz
- 160
* - min_freq_mhz
- 40
* - light_sleep_enable
- false
.. note ::
上表中不涉及的配置均是默认。
Light-sleep 配置
+++++++++++++++++++
本节介绍 Auto Light-sleep 的推荐配置和配置步骤。
Auto Light-sleep 有如下可配置选项：
- Minimum step to enter sleep mode
该参数表示系统自动进入休眠的阈值。该参数单位为 RTOS Tick， ，
- Put light sleep related codes in internal RAM
2024-01-19 06:29:00 -05:00
如果使能该选项，一些 light-sleep 功能将被移至 IRAM， ， ，
2023-11-20 06:22:25 -05:00
- Put RTOS IDLE related codes in internal RAM
2024-01-19 06:29:00 -05:00
如果使能该选项，一些 RTOS IDLE 功能将被移至 IRAM， ， ，
2023-11-20 06:22:25 -05:00
- RTC slow clock source
该参数表表示 RTC 慢速时钟源。系统休眠时计时器模块的时钟被门控，此时使用 RTC Timer 进行计时，唤醒后使用 RTC Timer 的计数值对系统时间进行补偿。
.. list-table ::
:header-rows: 1
:widths: 20 20 20
* - 时钟源
- 精度
- 频偏
2024-01-19 06:29:00 -05:00
* - Internal 150 kHz OSC
- 约 6.7 us/cycle
2023-11-20 06:22:25 -05:00
- 大
2024-01-19 06:29:00 -05:00
* - External 32 kHz XTAL
- 约 30.5 us/cycle
2023-11-20 06:22:25 -05:00
- 小
- Disable all GPIO when chip at sleep
如果使能该选项，系统将在休眠过程中禁用所有 GPIO 管脚，消除 GPIO 漏电，降低功耗，但是休眠过程中 GPIO 无法进行信号输入和输出。
.. only :: esp32c3 or esp32s3
- Power down MAC and baseband
如果使能该选项，系统将在休眠时关闭 Wi-Fi 和蓝牙的 MAC 和 baseband 来降低功耗，休眠电流约降低 100 uA，
- Power down CPU
2024-01-19 06:29:00 -05:00
如果使能该选项，系统将在休眠时将关闭 CPU 来降低功耗，对于 ESP32-C3， ， ， ，
2023-11-20 06:22:25 -05:00
- Power down I/D-cache tag memory
如果使能该选项，系统将在休眠时关闭 I/D cache tag memory 来降低功耗， 但是为保存 tag memory 信息，将额外消耗最大约 9 KB DRAM，
- Power down flash in Light-sleep
如果使能该选项，系统将在 Light-sleep 休眠时关闭 flash， ，
唤醒源：
- RTC Timer Wakeup
- GPIO Wakeup
- UART Wakeup
- Touchpad Wakeup
- External Wakeup (ext0)
- External Wakeup (ext1)
- ULP Coprocessor Wakeup
.. note ::
以上仅列出可配置唤醒源，详细介绍请参考 :doc: `睡眠模式 <../api-reference/system/sleep_modes>` 。
配置方法：
- 1. 配置唤醒源
- 2. 使能 CONFIG_PM_ENABLE
- 3. 使能 CONFIG_FREERTOS_USE_TICKLESS_IDLE
- 4. 配置 DFS 参数
- 5. light_sleep_enable = true，
::
esp_pm_config_t pm_config = {
.max_freq_mhz = CONFIG_EXAMPLE_MAX_CPU_FREQ_MHZ,
.min_freq_mhz = CONFIG_EXAMPLE_MIN_CPU_FREQ_MHZ,
#if CONFIG_FREERTOS_USE_TICKLESS_IDLE
.light_sleep_enable = true
#endif
};
2024-01-19 06:29:00 -05:00
ESP_ERROR_CHECK(esp_pm_configure(&pm_config));
2023-11-20 06:22:25 -05:00
- 6. 配置介绍的其余相关参数
推荐配置：
.. only :: esp32c3 or esp32s3
.. list-table ::
:header-rows: 1
:widths: 30 15
* - 配置名称
- 设置情况
* - CONFIG_PM_ENABLE
- ON
* - CONFIG_FREERTOS_USE_TICKLESS_IDLE
- ON
* - max_freq_mhz
- 160
* - min_freq_mhz
- 40
* - RTOS Tick rate (Hz)
- 1000
* - light_sleep_enable
- true
* - Minimum step to enter sleep mode
- 3
* - Put light sleep codes in IRAM
- OFF
* - Put RTOS IDLE codes in IRAM
- OFF
* - RTC slow clock source
2024-01-19 06:29:00 -05:00
- Internal 150 kHz OSC
2023-11-20 06:22:25 -05:00
* - Disable all GPIO when chip at sleep
- ON
* - Power down MAC and baseband
- ON
* - Power down I/D-cache tag memory
- ON
* - Power down CPU
- ON
* - Power down flash in light sleep
- OFF
.. note ::
上表中不涉及的配置均是默认
.. only :: esp32 or esp32s2
.. list-table ::
:header-rows: 1
:widths: 30 15
* - 配置名称
- 设置情况
* - CONFIG_PM_ENABLE
- ON
* - CONFIG_FREERTOS_USE_TICKLESS_IDLE
- ON
* - max_freq_mhz
- 160
* - min_freq_mhz
- 40
* - RTOS Tick rate (Hz)
- 1000
* - light_sleep_enable
- true
* - Minimum step to enter sleep mode
- 3
* - Put light sleep codes in IRAM
- OFF
* - Put RTOS IDLE codes in IRAM
- OFF
* - RTC slow clock source
2024-01-19 06:29:00 -05:00
- Internal 150 kHz OSC
2023-11-20 06:22:25 -05:00
* - Disable all GPIO when chip at sleep
- ON
.. note ::
上表中不涉及的配置均是默认
.. only :: esp32c2
.. list-table ::
:header-rows: 1
:widths: 30 15
* - 配置名称
- 设置情况
* - CONFIG_PM_ENABLE
- ON
* - CONFIG_FREERTOS_USE_TICKLESS_IDLE
- ON
* - max_freq_mhz
- 120
* - min_freq_mhz
- 40
* - RTOS Tick rate (Hz)
- 1000
* - light_sleep_enable
- true
* - Minimum step to enter sleep mode
- 3
* - Put light sleep codes in IRAM
- OFF
* - Put RTOS IDLE codes in IRAM
- OFF
* - RTC slow clock source
2024-01-19 06:29:00 -05:00
- Internal 150 kHz OSC
2023-11-20 06:22:25 -05:00
* - Disable all GPIO when chip at sleep
- ON
* - Power down MAC and baseband
- ON
* - Power down I/D-cache tag memory
- ON
* - Power down CPU
- ON
* - Power down flash in light sleep
- OFF
.. note ::
上表中不涉及的配置均是默认
Deep-sleep 配置
++++++++++++++++++
对 Deep-sleep 模式来说，除了唤醒源相关配置，其余配置意义已经不大。
Deep-sleep 有如下可配置选项：
- RTC Timer wakeup
- EXT0/1 wakeup
- Touchpad wakeup
- ULP wakeup
.. note ::
以上仅列出可配置唤醒源，详细介绍请参考 :doc: `睡眠模式 <../api-reference/system/sleep_modes>` 。
配置步骤：
- 配置唤醒源
- 调用 API，
/* Enter deep sleep * /
esp_deep_sleep_start();
用户可以通过下列配置选项，让一些特定模块在休眠时保持开启状态：
- Power up External 40 MHz XTAL
在一些特殊应用中，部分模块对休眠时的时钟精度及稳定度有很高要求（例如 BT） ，
打开和关闭代码如下::
ESP_ERROR_CHECK(esp_sleep_pd_config(ESP_PD_DOMAIN_XTAL, ESP_PD_OPTION_ON));
ESP_ERROR_CHECK(esp_sleep_pd_config(ESP_PD_DOMAIN_XTAL, ESP_PD_OPTION_OFF));
- Power up Internal 8 MHz OSC
在一些特殊应用中，部分模块（例如 LEDC）
打开和关闭代码如下::
ESP_ERROR_CHECK(esp_sleep_pd_config(ESP_PD_DOMAIN_RTC8M, ESP_PD_OPTION_ON));
ESP_ERROR_CHECK(esp_sleep_pd_config(ESP_PD_DOMAIN_RTC8M, ESP_PD_OPTION_OFF));
2023-12-05 03:26:24 -05:00
.. only :: SOC_WIFI_SUPPORTED
2024-01-19 06:29:00 -05:00
2023-11-20 06:22:25 -05:00
Wi-Fi 场景下低功耗模式介绍
----------------------------------
上文介绍了纯系统方向下的低功耗模式，但在实际应用中还需结合具体应用场景。本节将结合纯系统下的功耗模式来介绍在 Wi-Fi 场景下的低功耗模式。因为 Wi-Fi 场景的复杂性，本节会会首先介绍 Wi-Fi 省电的基本原理，然后再介绍具体的低功耗模式，同时本节主要针对 station 模式。
Wi-Fi 场景如何选择低功耗模式
++++++++++++++++++++++++++++++++++
为方便用户选择合适的低功耗模式，在介绍具体内容前先给出 Wi-Fi 场景下低功耗模式总结表，以方便用户根据需求快速选择想要了解的内容。
2024-03-28 08:52:43 -04:00
.. todo - add sleep-current/esp32c5_summary.inc
.. only :: not esp32c5
.. include :: sleep-current/{IDF_TARGET_PATH_NAME}_summary.inc
2023-11-20 06:22:25 -05:00
.. note ::
上表中所有电流均为平均电流，表中术语在下文均有介绍，用户可根据需求进行查看
Wi-Fi 省电的基本原理
+++++++++++++++++++++
首先，在 station 的工作过程中，为在接收发送过程中避免冲突，需要长时间监听信道，能耗较大的 RF 模块会一直处于工作中， ，
省电模式的基本原理是通过减少不必要的监听时间来降低耗能。AP 会缓存进入省电模式的 station 的包，同时周期发送包含 TIM 信息的 Beacon 帧， ， ） ， ， （
.. figure :: ../../_static/Low-power-DTIM4.png
:align: center
DTIM4 省电模式示意图
其次，
- 时钟准确性导致的 time offset， ，
- 处理 Beacon 漏听后的时间，如漏听后持续监听时间、允许最多丢失 Beacon 数目等，这段时间存不存在以及存在多久都不定，但是可以配置范围。
- 为了确保能够接受突发数据包而添加的 active 时间，可由配置决定。
- ILDE 时间是具体某些功耗模式进入条件要求。因此在满足通信需求的情况下，降低工作时间可以改善功耗表现。
.. figure :: ../../_static/Low-power-time.png
:align: center
芯片工作时间组成图
此外，在 station 没有处于 Wi-Fi 接收或发送状态时，影响功耗的因素变成了芯片的其他模块。不同的功耗模式会配置不同的时钟源，或者动态调整一些模块的工作频率如 CPU， ， ，
如果以时间为横轴，电流大小为纵轴建立坐标轴，那么处在低功耗模式下芯片的理想工作电流图可以简化成下图：
.. figure :: ../../_static/Low-power-WiFi-base-current.png
:align: center
理想情况下 Wi-Fi 场景低功耗模式电流图
其中 station 要进行 Wi-Fi 通信时，
可以看出影响功耗表现的主要有三点：
- Interval 是 station Wi-Fi 相关模块工作的间隔，既可以由低功耗模式自定义，也可根据 Wi-Fi 协议省电机制（ ，
- Period 可以看作每次 station Wi-Fi 工作的时间， （ ，
- Base current 是 Wi-Fi 相关模块不工作时芯片的电流，影响其大小的因素很多，不同的功耗模式下休眠策略不同。所以，在满足功能的情况下，优化配置降低该电流大小可以提高功耗表现，但同时关闭其余模块会影响相关功能和芯片的唤醒时间。
知道了影响功耗的三点因素之后， ， ，
Modem-sleep Mode
++++++++++++++++++
Modem-sleep 模式主要工作原理基于 DTIM 机制，周期性的醒来处理 Wi-Fi 相关工作，又在周期间隔之间进入休眠，关闭 PHY（ ，
Modem-sleep 模式会在 Wi-Fi task 结束后自动进入休眠无需调用 API，
Modem-sleep 模式默认会根据 DTIM 周期或 listen interval（ ） ，
Modem-sleep 是一个开关型的模式，调用 API 开启后一直自动运行，其工作流程十分简单，具体如下图。
.. figure :: ../../_static/Low-power-modem-process.png
:align: center
Modem sleep 工作流程图
2024-01-19 06:29:00 -05:00
根据上文的基本电流图，结合 Modem-sleep 的工作原理，以 Min Modem（ ）
2023-11-20 06:22:25 -05:00
.. figure :: ../../_static/Low-power-modem-current.png
:align: center
Min Modem-sleep 理想电流图
Modem-sleep 一般用于 CPU 持续处于工作状态并需要保持 Wi-Fi 连接的应用场景，例如，使用 {IDF_TARGET_NAME} 本地语音唤醒功能，
2024-01-19 06:29:00 -05:00
DFS + Modem sleep
2023-11-20 06:22:25 -05:00
++++++++++++++++++
Modem sleep 模式休眠状态中 CPU 仍处在工作状态，而 DFS 机制主要作用于 CPU 和 APB 工作频率来降低功耗，因此 DFS + Modem sleep 可以进一步优化功耗表现，又因为 Wi-Fi task 会申请 ESP_PM_CPU_FREQ_MAX 电源锁来保证 Wi-Fi 任务快速运行，所以 DFS + Modem sleep 产生调频只会发生在 base current 阶段，即 Wi-Fi task 结束后。
在 Wi-Fi 场景下， ， ， ， ， ， （
在 Wi-Fi 场景下，
.. figure :: ../../_static/Low-power-DFS-process.png
:align: center
2024-01-19 06:29:00 -05:00
Wi-Fi 场景 DFS 简化流程图
2023-11-20 06:22:25 -05:00
在 Wi-Fi 工作的 active 状态与系统空闲的 IDLE 状态转换，
2024-01-19 06:29:00 -05:00
简化过后的 DFS + Modem sleep 模式理想状态下的电流大小如下图所示：
2023-11-20 06:22:25 -05:00
.. figure :: ../../_static/Low-power-DFS-modem-current.png
:align: center
2024-01-19 06:29:00 -05:00
DFS + Modem sleep 模式理想电流图
2023-11-20 06:22:25 -05:00
2024-01-19 06:29:00 -05:00
Auto Light-sleep + Wi-Fi 场景
2023-11-20 06:22:25 -05:00
+++++++++++++++++++++++++++++++
Auto Light-sleep 模式在 Wi-Fi 场景下是 ESP-IDF 电源管理机制、DTIM 机制和 light-sleep 的结合。开启电源管理是其前置条件，
Auto Light-sleep 模式在 Wi-Fi 场景下休眠机制与纯系统下一样，仍然依赖于电源管理机制，进入休眠的条件为系统处于 IDLE 状态的时间超过设定时间，并且系统会提前判断空闲时间是否满足条件，若满足直接休眠。该过程为自动进行。休眠时会自动关闭 RF、8 MHz 振荡器、40 MHz 高速晶振、PLL， ，
Auto Light-sleep 模式在 Wi-Fi 场景下遵循 DTIM 机制，自动在 DTIM 帧到来前苏醒，相当于系统自动设置了一个 Wi-Fi 唤醒源，因此用户无需再配置唤醒源。同时系统主动发包时也可以唤醒。
Auto Light-sleep 模式在 Wi-Fi 场景下工作流程较为复杂，但全程都是自动进行，具体如下图所示。
.. figure :: ../../_static/Low-power-wifi-auto-light-process.png
:align: center
Auto Light-sleep 工作流程图
2024-01-19 06:29:00 -05:00
Auto Light-sleep 模式在 Wi-Fi 场景下经常与 modem sleep 同时开启，这里给出 modem + auto light-sleep 模式的理想电流图，关键节点均在图上标出。
2023-11-20 06:22:25 -05:00
.. figure :: ../../_static/Low-power-wifi-auto-light-current.png
:align: center
2024-01-19 06:29:00 -05:00
modem + auto light-sleep 模式理想电流图
2023-11-20 06:22:25 -05:00
Auto Light-sleep 模式在 Wi-Fi 场景下可用于需要保持 Wi-Fi 连接，可以实时响应 AP 发来数据的场景。并且在未接收到命令时， ， ，
2024-01-19 06:29:00 -05:00
Deep-sleep + Wi-Fi 场景
2023-11-20 06:22:25 -05:00
+++++++++++++++++++++++++++++++++
Deep-sleep 模式在 Wi-Fi 场景下与纯系统下基本相同，详情可以参考 `Deep-sleep`_ 这里不再介绍。
如何配置 Wi-Fi 场景下低功耗模式
+++++++++++++++++++++++++++++++++++++
介绍完 Wi-Fi 场景下低功耗模式后，本节将介绍公共配置选项、每种模式独有的配置选项，以及相应低功耗模式 API 的使用说明，同时给出相应模式推荐的配置（包含纯系统下的低功耗推荐配置）以及该配置的具体表现。
公共配置选项：
- 功耗类：
- Max Wi-Fi TX power (dBm)
该参数表示最大 TX 功率，降低该参数会减小发包功耗，但会影响 Wi-Fi 性能，默认设置最大 20。
- IRAM 类：
- Wi-Fi IRAM speed optimization
如果使能该选项，一些 Wi-Fi 功能将被移至 IRAM， ， ，
- Wi-Fi RX IRAM speed optimization
如果使能该选项，一些 Wi-Fi RX 功能将被移至 IRAM， ， ，
- Wi-Fi Sleep IRAM speed optimization
如果使能该选项，一些 Wi-Fi sleep 功能将被移至 IRAM， ， ，
- Wi-Fi 协议类：
- Minimum active time
该参数表示 Station 接收完一次数据后需要等待时间。当终端与 AP 进行通信时，
- Maximum keep alive time
该参数表示周期性的发送 sleep null data 来通告 AP 维持连接的时间。在 DTIM 机制下，若 AP 长时间没有某个 station 的包，可能会断开连接，因此需要 station 需要周期发送 sleep null data 维持连接。默认 10。
- Send gratuitous ARP periodically
如果使能该选项，
- Wi-Fi sleep optimize when beacon lost
如果使能该选项，
Modem sleep 配置方法如下:
- 可配置选项
- Min Modem
该参数表示 station 按照 DTIM 周期工作，在每个 DTIM 前醒来接收 Beacon， ，
- Max Modem
该参数表示 station 会自定义一个 listen interval， ，
- 配置方法：
- 调用 API，
typedef enum {
WIFI_PS_NONE,
WIFI_PS_MIN_MODEM,
WIFI_PS_MAX_MODEM,
} wifi_ps_type_t;
esp_err_t esp_wifi_set_ps(wifi_ps_type_t type);
若选择 WIFI_PS_MAX_MODEM， ，
#define LISTEN_INTERVAL 3
wifi_config_t wifi_config = {
.sta = {
.ssid = "SSID",
.password = "Password",
.listen_interval = LISTEN_INTERVAL,
},
};
ESP_ERROR_CHECK(esp_wifi_set_mode(WIFI_MODE_STA));
ESP_ERROR_CHECK(esp_wifi_set_config(ESP_IF_WIFI_STA, &wifi_config));
ESP_ERROR_CHECK(esp_wifi_start());
配置推荐：
这里给出的配置推荐是 Min Modem sleep + DFS 开启的配置
.. list-table ::
:header-rows: 1
:widths: 20 15
* - 配置名称
- 设置情况
* - WIFI_PS_MIN_MODEM
- ON
* - CONFIG_PM_ENABLE
- ON
* - RTOS Tick rate (Hz)
- 1000
* - max_freq_mhz
- 160
* - min_freq_mhz
- 40
* - light_sleep_enable
- false
配置表现：
2024-03-28 08:52:43 -04:00
.. todo - add sleep-current/esp32c5_modem_sleep.inc
.. only :: not esp32c5
.. include :: sleep-current/{IDF_TARGET_PATH_NAME}_modem_sleep.inc
2023-11-20 06:22:25 -05:00
Auto Light-sleep + Wi-Fi 场景配置：
Auto Light-sleep 在 Wi-Fi 场景下的配置比纯系统下少了唤醒源的配置要求，其余几乎与纯系统下配置一致，因此可配置选项、配置步骤、推荐配置的详细介绍可以参考上文 `Light-sleep`_ 。同时 Wi-Fi 相关配置保持默认。
配置表现：
该配置表现为 Auto Light-sleep 纯系统推荐配置 + 默认的 Wi-Fi 相关配置在 Wi-Fi 场景的表现。
2024-03-28 08:52:43 -04:00
.. todo - add sleep-current/esp32c5_light_sleep.inc
.. only :: not esp32c5
.. include :: sleep-current/{IDF_TARGET_PATH_NAME}_light_sleep.inc
2023-11-20 06:22:25 -05:00
Deep-sleep + Wi-Fi 场景配置：
Deep-sleep 模式在 Wi-Fi 场景下的配置与纯系统下配置基本一致，因此可配置选项、配置步骤、推荐配置的详细介绍可以参考上文 `Deep-sleep`_ 。同时 Wi-Fi 相关配置保持默认。
配置表现：
该配置表现为 Deep-sleep 纯系统推荐配置 + 默认的 Wi-Fi 相关配置在 Wi-Fi 场景的表现。
.. only :: esp32
平均电流约 5.0 μA
.. only :: esp32s2
平均电流约 5.0 μA
.. only :: esp32s3
平均电流约 6.9 μA
.. only :: esp32c3
平均电流约 4.8 μA
.. only :: esp32c2
平均电流约 4.9 μA
