《WiFi 嵌入式物联网开发全套实战》| 第 20 章 WiFi 低功耗休眠、定时唤醒、保活机制（电池设备必备）

专栏《WiFi 嵌入式物联网开发全套实战》 专栏定位嵌入式 Linux/ESP32 WiFi 从原理→驱动→配网→协议→稳定性→抓包调试→量产优化全套工业实战适配物联网设备、智能家居、工控网关、无线透传设备、4GWiFi 双模设备 点赞 收藏 关注嵌入式 WiFi 量产实战全套教程持续更新本章前言前面章节我们开发的 ESP32 WiFi 工程全部为常开模式WiFi 射频持续工作功耗几百毫安只适合插电设备。 对于电池供电物联网产品电池传感器、无线门锁、电池摄像头产品要求电池工作数月甚至数年必须开启 WiFi 低功耗模式。ESP32 WiFi 提供 Modem‑sleep、Light‑sleep、Deep‑sleep 三级休眠方案。大量开发者踩坑休眠之后 WiFi 断开、唤醒无法重连 AP、休眠丢包、MQTT 掉线、唤醒网络延时大、电流降不下来、休眠功耗不稳定、定时唤醒抖动。休眠不是简单调用 sleep 接口需要理解 WiFi‑PSPower Save802.11 省电协议AP 与 STA 之间的休眠交互机制。本章对比三级休眠模式讲解 WiFi‑PS 信标监听、DTIM、Listen Interval 核心概念给出可直接编译完整工程包含定时唤醒、休眠进入退出、唤醒 WiFi 恢复、MQTT 保活梳理量产电池设备高频坑点给出功耗测试方法与调优方案。前置阅读第 14 章 STA 掉线恢复、第 19 章 MQTT 物联网上云完整工程。20.1 ESP32 三类休眠模式对比休眠模式CPUWiFi / 蓝牙RAM唤醒源典型休眠电流适用场景Modem‑sleep调制解调器休眠运行WiFi 射频间歇休眠全部保持定时器、IO~15‑40mACPU 业务持续运行WiFi 间歇省电不适合电池产品Light‑sleep轻度休眠暂停WiFi 可开启 WiFi‑PS 间歇收 BeaconRAM 保持定时器、IO、RTC~0.8‑3mA电池 WiFi 设备主流方案唤醒速度快WiFi 可维持连接Deep‑sleep深度休眠断电WiFi 完全关闭仅 RTC 内存保留RTC 定时器、IO~10‑80μA极低功耗但 WiFi 完全断开每次唤醒需要重新配网重连路由工程选型结论需要维持 WiFi 连接休眠不重连路由器选 Light‑sleep WiFi‑PS 省电模式不需要常驻 WiFi定时采集上报允许唤醒重新联网优先 Deep‑sleep功耗最低Modem‑sleep 省电幅度有限电池产品一般不采用。20.2 802.11 WiFi‑PS 省电核心原理STA 进入省电模式后会向 AP 发送 PS‑bit 置 1 的帧告知 AP我进入休眠不要向我直接发送单播数据。 AP 会把发给该 STA 的单播报文进行缓存等到 AP 发送 DTIM Beacon 信标帧的时候把缓存报文携带下发。 STA 休眠状态下不会一直接收无线信号只在 DTIM 时刻短暂唤醒监听 Beacon取回 AP 缓存数据包之后继续休眠。关键参数 DTIM / Listen IntervalDTIMAP 参数DTIM 间隔绝大多数家用路由器 DTIM1。代表每 1 个 Beacon 周期做一次组播 / 单播缓存下发。Listen IntervalSTA 参数STA 告诉 AP我每隔多少个 Beacon 周期醒来一次接收缓存数据。Listen Interval 越大休眠时间越长平均功耗越低但是 AP 缓存报文时间变长数据延迟变大AP 缓存资源有限过大 Listen Interval 会导致 AP 丢弃缓存报文出现丢包。量产坑Listen Interval 不能盲目设置很大很多路由器 AP 缓存队列很小超过阈值直接丢弃缓存数据包设备休眠期间消息丢失。WiFi‑PS 两种工作模式MAX_PS最大省电绝大部分时间射频关闭只在 DTIM 时刻唤醒功耗最低报文延迟高MIN_PS快速省电有数据交互之后短暂保持射频打开空闲一段时间进入休眠延迟低平均功耗更高。20.3 Light‑sleep WiFi‑PS 实战休眠保持 WiFi 连接重要约束Light‑sleep 模式下FreeRTOS 任务停止运行只有 RTC、外设可以工作WiFi 硬件由底层驱动自动完成间歇唤醒接收 Beacon应用层任务休眠期间停止执行。ESP‑IDF 开启 WiFi 省电 APIesp_wifi_set_ps(WIFI_PS_MIN_MODEM); // MIN_PS esp_wifi_set_ps(WIFI_PS_MAX_MODEM); // MAX_PS 最大省电电池设备首选设置 Listen Intervalwifi_ps_config_t ps_cfg { .listen_interval 3, // 单位Beacon周期默认Beacon 100ms → 300ms唤醒一次 }; esp_wifi_set_ps_config(ps_cfg);完整工程Light‑sleep 定时唤醒维持 WiFi、MQTT 连接功能平时进入 Light‑sleep 低功耗每隔 10s 唤醒一次上报 MQTT 状态上报完成继续休眠WiFi 不断开不需要每次重连路由。 基于 ESP‑IDF5.x继承第 14、19 章 WiFi、MQTT 基础代码。#include stdio.h #include string.h #include freertos/FreeRTOS.h #include freertos/task.h #include freertos/event_groups.h #include esp_wifi.h #include esp_event.h #include esp_log.h #include nvs_flash.h #include esp_netif.h #include esp_sleep.h #include mqtt_client.h #define WIFI_CONNECTED_BIT BIT0 static EventGroupHandle_t wifi_event_group; static esp_mqtt_client_handle_t mqtt_client NULL; static const char *TAG LOW_PS_WIFI; #define WIFI_SSID YourSSID #define WIFI_PASSWORD YourPassword #define MQTT_BROKER_URI mqtt://192.168.1.100:1883 #define MQTT_TOPIC_PUB device/battery/status #define LIGHT_SLEEP_PERIOD_S 10 /* Light‑sleep休眠周期单位秒 */ static void wifi_event_handler(void* arg, esp_event_base_t base, int32_t id, void* data) { if(base WIFI_EVENT id WIFI_EVENT_STA_DISCONNECTED) { ESP_LOGW(TAG,WiFi断开); xEventGroupClearBits(wifi_event_group, WIFI_CONNECTED_BIT); esp_wifi_connect(); } else if(base IP_EVENT id IP_EVENT_STA_GOT_IP) { ESP_LOGI(TAG,WiFi获取IP成功); xEventGroupSetBits(wifi_event_group, WIFI_CONNECTED_BIT); } } static void mqtt_event_handler(void *handler_args, esp_event_base_t base, int32_t event_id, void *event_data) { esp_mqtt_event_handle_t event event_data; switch ((esp_mqtt_event_id_t)event_id) { case MQTT_EVENT_CONNECTED: ESP_LOGI(TAG,MQTT已连接); break; case MQTT_EVENT_DISCONNECTED: ESP_LOGW(TAG,MQTT断开); break; default: break; } } static void lowpower_task(void *arg) { xEventGroupWaitBits(wifi_event_group, WIFI_CONNECTED_BIT, pdFALSE, pdFALSE, portMAX_DELAY); /* 开启WiFi MAX_PS最大省电模式 */ wifi_ps_config_t ps_conf { .listen_interval 3, }; esp_wifi_set_ps_config(ps_conf); esp_wifi_set_ps(WIFI_PS_MAX_MODEM); ESP_LOGI(TAG,WiFi MAX_PS省电模式开启进入Light‑sleep循环); while(1) { /* MQTT上报业务数据 */ if(mqtt_client esp_mqtt_client_get_state(mqtt_client) MQTT_CLIENT_STATE_CONNECTED) { const char *payload {\battery\:85}; esp_mqtt_client_publish(mqtt_client, MQTT_TOPIC_PUB, payload, strlen(payload),1,0); ESP_LOGI(TAG,唤醒上报电池数据完成); } /* 配置Light‑sleep休眠时长 */ esp_sleep_enable_timer_wakeup(LIGHT_SLEEP_PERIOD_S * 1000000ULL); ESP_LOGI(TAG,准备进入Light‑sleep); /* 进入轻度休眠此处CPU挂起任务暂停RTC定时器到期自动唤醒代码从此处继续往下跑 */ esp_light_sleep_start(); ESP_LOGI(TAG,Light‑sleep唤醒完成); vTaskDelay(pdMS_TO_TICKS(200)); } } static void wifi_sta_init(void) { wifi_event_group xEventGroupCreate(); esp_netif_init(); esp_event_loop_create_default(); esp_netif_create_default_wifi_sta(); wifi_init_config_t wcfg WIFI_INIT_CONFIG_DEFAULT(); esp_wifi_init(wcfg); esp_event_handler_instance_register(WIFI_EVENT, ESP_EVENT_ANY_ID, wifi_event_handler, NULL, NULL); esp_event_handler_instance_register(IP_EVENT, IP_EVENT_STA_GOT_IP, wifi_event_handler, NULL, NULL); wifi_config_t sta_cfg { .sta { .ssid WIFI_SSID, .password WIFI_PASSWORD, } }; esp_wifi_set_mode(WIFI_MODE_STA); esp_wifi_set_config(WIFI_IF_STA, sta_cfg); esp_wifi_start(); esp_wifi_connect(); } static void mqtt_init(void) { esp_mqtt_client_config_t mqtt_cfg { .broker.address.uri MQTT_BROKER_URI, }; mqtt_client esp_mqtt_client_init(mqtt_cfg); esp_mqtt_client_register_event(mqtt_client, ESP_EVENT_ANY_ID, mqtt_event_handler, NULL); esp_mqtt_client_start(mqtt_client); } void app_main(void) { nvs_flash_init(); wifi_sta_init(); mqtt_init(); xTaskCreate(lowpower_task, lowpower, 4096, NULL, 4, NULL); }Light‑sleep 代码关键点解读esp_light_sleep_start()调用之后 CPU 暂停任务停止运行RTC 定时器到期硬件唤醒程序从该函数返回继续执行WiFi‑PS 由 WiFi 硬件驱动自主管理休眠期间 WiFi 射频间歇工作维持 AP 连接不需要应用层干预Listen Interval 参数需要和路由器 DTIM 匹配DTIM1 路由器listen_interval 建议 2‑5唤醒之后预留短暂延时等待 WiFi 射频稳定再发送 MQTT/TCP 报文避免唤醒瞬间报文发送失败。20.4 Deep‑sleep 深度休眠实战WiFi 完全关闭功耗最低Deep‑sleep 下 WiFi、蓝牙全部断电WiFi 连接完全丢失。每次唤醒之后完整重新初始化 WiFi、连接 AP、连接 MQTT上报数据上报完成再次进入深度休眠。 适合低频次上报产品例如每隔 30s、几分钟上报一次传感器。void deep_sleep_example(void) { /* 业务采集传感器上报数据 */ /* 设置RTC定时唤醒20s之后唤醒 */ esp_sleep_enable_timer_wakeup(20 * 1000000ULL); ESP_LOGI(TAG,进入Deep‑sleepWiFi全部断电); esp_deep_sleep_start(); /* Deep‑sleep唤醒之后程序整体复位app_main重新运行不会执行本函数后面代码 */ }重要特性Deep‑sleep 唤醒等同于芯片软复位代码从头执行 app_main全局变量全部丢失只有 RTC slow memory 可以保存少量数据。20.5 电池设备量产高频故障现象与根因故障 1开启 MAX_PS 省电休眠之后 MQTT 收不到云端下发指令现象设备可以上报上行消息云端下发指令设备收不到。根因Listen Interval 设置过大AP 缓存满丢弃报文DTIM 配置不匹配。解决调小 listen_interval尽量使用 DTIM1 路由器电池设备不适合高频下行控制业务尽量改成设备主动上报。故障 2Light‑sleep 休眠电流降不下来电流几十 mA根因有其他任务持续运行、外设时钟没有关闭、没有真正进入 light‑sleepWiFi 没有开启 PS 模式射频一直常开。解决确认所有任务在休眠时刻阻塞开启WIFI_PS_MAX_MODEM测量休眠真实电流。故障 3Light‑sleep 长时间运行WiFi 随机断开根因Listen Interval 过大AP 超时把 PS 模式 STA 踢下线路由器 AP 对 PS 客户端兼容性差。解决适当减小 listen_interval产品兼容性测试多品牌路由器。故障 4Deep‑sleep 唤醒联网慢上报时延大根因每次唤醒完整扫描、认证、关联、MQTT 握手全部流程。解决优化 WiFi 快速重连参数NVS 保存 WiFi 配置减少扫描时间。故障 5休眠唤醒之后第一条 TCP/MQTT 报文发送失败根因刚唤醒 WiFi 射频还未稳定立刻发包。解决唤醒之后增加短暂延时等待 WiFi 链路就绪再执行业务发送。20.6 功耗测量实操方法使用直流电源带电流显示或者高精度电流表测量整机平均电流区分峰值电流WiFi 收发瞬间、休眠平均电流电池产品看平均电流不是峰值计算电池续航电池容量(mAh) / 平均工作电流(mA)同时考虑休眠与唤醒占空比。举例1000mAh 电池平均电流 1mA理论续航 1000 小时。20.7 menuconfig 低功耗关键配置Component config → ESP‑SLEEP使能 light sleep 支持Component config → Wi‑Fi → WiFi Power Save开启省电相关支持LWIP调大 socket 接收缓冲区应对休眠唤醒报文突发不需要的外设 UART、SPI、I2S 休眠之前关闭降低额外漏电。20.8 本章小结电池供电 WiFi 产品休眠方案选型是产品成败关键点。Light‑sleep WiFi‑PS MAX_MODEM休眠保持 WiFi 连接可接收下行消息代价功耗比 Deep‑sleep 高受 AP DTIM、缓存机制限制存在丢包风险。Deep‑sleep功耗极低但是每次唤醒必须完整重连 WiFi不适合需要实时接收云端指令的设备。802.11 WiFi‑PS 省电模式依赖路由器 AP 的缓存实现不同品牌路由器兼容性存在差异量产必须做多路由器兼容性测试。休眠调试不能只看日志必须实测整机电流验证休眠功耗是否达到设计指标。 点赞 收藏 关注嵌入式 WiFi 量产实战全套教程持续更新