【产出】 > 让 ESP32 进入深度睡眠,用定时器、按键(ext0/ext1)或触摸把它唤醒,醒来后判断唤醒原因,并用 RTC 内存把计数等数据跨睡眠保留下来,做出一个"醒来干活、干完就睡"的低功耗程序。
【版本】 > 依据 ESP-IDF 编程指南稳定版 v6.1(ESP32)"睡眠模式"API 参考、"内存类型"和"深度睡眠唤醒桩"两章,以及 arduino-esp32 官方例程 DeepSleep/TimerWakeUp、ExternalWakeUp、TouchWakeUp 和 Touch API 文档编写。代码以 Arduino-ESP32 3.x 写法为主,调用的
esp_sleep_*函数就是 ESP-IDF 原生接口,在 ESP-IDF 工程里同样可用。引脚编号以经典 ESP32 为例,S2/S3/C3 等型号以对应芯片的技术参考手册为准。
一、深度睡眠时芯片里还剩什么
ESP32 有两种主要的省电睡眠:Light-sleep(浅睡眠)和 Deep-sleep(深度睡眠)。
| 对比项 | Light-sleep | Deep-sleep |
|---|---|---|
| CPU、大部分 RAM、数字外设 | 时钟门控、降压,状态保留 | 断电 |
| 仍然上电的部分 | 基本都在 | 只有 RTC 控制器、ULP 协处理器、RTC FAST 内存、RTC SLOW 内存 |
| 醒来后 | 从 esp_light_sleep_start() 的下一行继续执行 | 相当于重新启动,从头运行 bootloader 和程序,Arduino 里就是重新执行 setup() |
| Wi-Fi/蓝牙连接 | 不保持 | 不保持 |
深度睡眠省电最多,代价是醒来要重新启动,普通变量全部丢失。这也决定了程序的写法:所有逻辑都写在 setup() 里,最后一行进入睡眠,loop() 留空,因为它永远不会被执行到。
【注意】 > 进入任何睡眠前,Wi-Fi 和蓝牙都会断开。官方文档要求应用先主动关闭它们(ESP-IDF 中如
esp_wifi_stop(),蓝牙有对应的 disable/deinit 函数)。就算不调用,连接也不会在睡眠中保持。需要一直在线又想省电,应该用 Wi-Fi Modem-sleep 加自动 Light-sleep,而不是深度睡眠。
二、唤醒源一览(ESP32)
唤醒源用 esp_sleep_enable_xxx_wakeup() 系列函数打开,可以同时打开多个,任何一个触发都会唤醒。
| 唤醒源 | 启用函数 | 能用的引脚 | 要点 |
|---|---|---|---|
| 定时器 | esp_sleep_enable_timer_wakeup(us) | 无 | 单位微秒,实际分辨率取决于 RTC 慢速时钟源 |
| ext0 | esp_sleep_enable_ext0_wakeup(gpio, level) | 单个 RTC GPIO | 电平为 0 或 1 时唤醒;需要 RTC 外设电源域保持上电 |
| ext1 | esp_sleep_enable_ext1_wakeup_io(mask, mode) | 多个 RTC GPIO | 由 RTC 控制器实现,RTC 外设断电也能用 |
| 触摸 | esp_sleep_enable_touchpad_wakeup(),Arduino 用 touchSleepWakeUpEnable() | 触摸引脚 | 摸到触摸板唤醒 |
| ULP 协处理器 | esp_sleep_enable_ulp_wakeup() | 视程序而定 | 睡眠中由 ULP 轮询传感器,满足条件再唤醒主 CPU |
经典 ESP32 上带 RTC 功能、能做 ext0/ext1 唤醒的 GPIO 是:0、2、4、12–15、25–27、32–39(ESP32-S2、S3 是 0–21)。不在这个范围里的引脚,函数会返回 ESP_ERR_INVALID_ARG。不确定时可以调用 esp_sleep_is_valid_wakeup_gpio(gpio) 检查。
几条组合限制(经典 ESP32):
- ext0 不能和触摸唤醒、ULP 唤醒同时用。
- 强制让 RTC 外设电源域保持上电(
ESP_PD_OPTION_ON)时,触摸唤醒和 ULP 唤醒不能用。 - 唤醒源在醒来后不会自动关闭,不需要时用
esp_sleep_disable_wakeup_source()关掉,传ESP_SLEEP_WAKEUP_ALL可一次全关。 - 一个唤醒源都不设就调用
esp_deep_sleep_start(),芯片会一直睡下去,只能靠复位或重新上电叫醒。
三、RTC 内存:让数据熬过睡眠
普通全局变量放在主 RAM,深度睡眠时主 RAM 断电,醒来就恢复成初始值。要跨睡眠保留数据,就把变量放进 RTC 内存:
RTC_DATA_ATTR int bootCount = 0; // 放在 RTC 内存,深度睡眠后保留
RTC_DATA_ATTR float lastTemperature = 0;
官方文档对 RTC 内存的规则是:每次芯片重新启动时都会被初始化,唯独从深度睡眠唤醒时例外,唤醒时保留睡前的值。所以:
| 事件 | RTC_DATA_ATTR 变量 |
|---|---|
| 上电 | 初始化为声明时的初值 |
| 按 EN 复位、看门狗复位、重新烧录 | 初始化为初值 |
| 从深度睡眠唤醒 | 保留睡前的值 |
| 断电 | 丢失 |
几点补充:
RTC_DATA_ATTR默认放在 RTC SLOW 内存。只要程序里有变量放在 RTC SLOW 内存,睡眠时这块内存默认保持供电,不需要额外设置。- 另有一个
RTC_NOINIT_ATTR,放进去的数据在深度睡眠唤醒后同样保留。 - RTC 内存容量很小(以芯片技术参考手册为准),只适合放计数器、几个传感器读数、状态标志,别放大数组。
- RTC 内存怕断电。需要真正掉电保存的数据要写 Flash(NVS),见本站 Preferences 教程。
四、定时器唤醒
最常用的场景:每隔一段时间醒来采一次数据。
#include <Arduino.h>
#define uS_PER_S 1000000ULL // 1 秒 = 1000000 微秒,注意用 64 位
#define SLEEP_SECONDS 10
RTC_DATA_ATTR int bootCount = 0;
void printWakeupReason() {
esp_sleep_wakeup_cause_t cause = esp_sleep_get_wakeup_cause();
switch (cause) {
case ESP_SLEEP_WAKEUP_TIMER: Serial.println("唤醒原因:定时器"); break;
case ESP_SLEEP_WAKEUP_EXT0: Serial.println("唤醒原因:ext0 外部引脚"); break;
case ESP_SLEEP_WAKEUP_EXT1: Serial.println("唤醒原因:ext1 外部引脚"); break;
case ESP_SLEEP_WAKEUP_TOUCHPAD: Serial.println("唤醒原因:触摸"); break;
case ESP_SLEEP_WAKEUP_ULP: Serial.println("唤醒原因:ULP"); break;
default:
Serial.printf("不是从深度睡眠唤醒(上电或复位),代码 %d\n", cause);
break;
}
}
void setup() {
Serial.begin(115200);
delay(1000); // 给串口监视器留出连接时间,正式产品可删掉
++bootCount;
Serial.printf("第 %d 次启动\n", bootCount);
printWakeupReason();
// ---- 这里放醒来要做的事:采样、上报等 ----
esp_sleep_enable_timer_wakeup(SLEEP_SECONDS * uS_PER_S);
Serial.printf("进入深度睡眠 %d 秒\n", SLEEP_SECONDS);
Serial.flush(); // 等串口发完再睡,否则最后几行可能打印不全
esp_deep_sleep_start();
// 下面的代码不会执行
}
void loop() {
}
为什么常数要写 ULL:esp_sleep_enable_timer_wakeup() 的参数是 uint64_t,单位是微秒。写成 10 * 1000000 是 32 位 int 运算,睡眠时间一长(超过约 35 分钟)就会溢出,得到一个错误的时间。
定时时长有上限,取决于 RTC 定时器位宽和慢速时钟源,超出范围时函数返回 ESP_ERR_INVALID_ARG。也可以直接用 esp_deep_sleep(us),它等同于"设置定时器唤醒 + 立刻进入深度睡眠"。
【提示】 >
esp_sleep_get_wakeup_cause()只返回一个唤醒原因。多个唤醒源同时触发时,部分信息会丢失。上电和复位时它返回的是"未定义"(ESP_SLEEP_WAKEUP_UNDEFINED),可以据此区分"第一次上电"和"睡醒",比如只在第一次上电时做校准。
五、外部引脚唤醒:ext0 和 ext1
1. ext0:单个引脚、指定电平
按键接 GPIO33,另一端接 3.3 V,按下为高电平:
#include <Arduino.h>
#include "driver/rtc_io.h"
#define WAKEUP_GPIO GPIO_NUM_33 // 必须是 RTC GPIO
RTC_DATA_ATTR int bootCount = 0;
void setup() {
Serial.begin(115200);
delay(1000);
Serial.printf("第 %d 次启动\n", ++bootCount);
esp_sleep_enable_ext0_wakeup(WAKEUP_GPIO, 1); // 1 = 高电平唤醒,0 = 低电平唤醒
// 用 RTC 内部下拉把引脚平时拉在低电平,避免悬空误唤醒
rtc_gpio_pullup_dis(WAKEUP_GPIO);
rtc_gpio_pulldown_en(WAKEUP_GPIO);
Serial.println("按下按键唤醒");
Serial.flush();
esp_deep_sleep_start();
}
void loop() {
}
ext0 由 RTC IO 模块实现,RTC 外设电源域在睡眠中会因此保持上电,所以内部上下拉可以直接用 rtc_gpio_pullup_en() / rtc_gpio_pulldown_en() 配置,要在 esp_deep_sleep_start() 之前调用。
2. ext1:多个引脚
ext1 用一个 64 位位掩码选择引脚,每一位对应一个 GPIO 编号:
#define PIN_MASK(gpio) (1ULL << (gpio))
uint64_t mask = PIN_MASK(GPIO_NUM_32) | PIN_MASK(GPIO_NUM_33);
esp_sleep_enable_ext1_wakeup_io(mask, ESP_EXT1_WAKEUP_ANY_HIGH);
经典 ESP32 上 ext1 只有两种触发逻辑:
| 模式 | 含义 |
|---|---|
ESP_EXT1_WAKEUP_ANY_HIGH | 任意一个选中引脚为高电平就唤醒 |
ESP_EXT1_WAKEUP_ALL_LOW | 所有选中引脚同时为低电平才唤醒 |
ESP32-S2/S3/C6/H2 等型号支持的是 ANY_LOW 和 ANY_HIGH,换芯片时注意。多个引脚做 ext1 唤醒时,硬件不允许给它们设不同的唤醒电平。
醒来后查是哪个引脚触发的:
if (esp_sleep_get_wakeup_cause() == ESP_SLEEP_WAKEUP_EXT1) {
uint64_t status = esp_sleep_get_ext1_wakeup_status();
for (int gpio = 0; gpio < 64; gpio++) {
if (status & (1ULL << gpio)) {
Serial.printf("由 GPIO%d 唤醒\n", gpio);
}
}
}
esp_sleep_enable_ext1_wakeup_io() 是追加式的,多次调用会累加引脚;要移除某些引脚用 esp_sleep_disable_ext1_wakeup_io(mask),传 0 清空全部。旧函数 esp_sleep_enable_ext1_wakeup() 每次调用会覆盖之前的配置,官方已标注将被弃用,新代码用带 _io 的版本。
【注意】 > 用作唤醒的引脚在唤醒后会处于 RTC IO 状态。醒来后要把它当普通数字 GPIO 用(比如
digitalRead()),先调用rtc_gpio_deinit(gpio)把它交还给数字 GPIO 模块。
ext1 的上下拉:ext1 不依赖 RTC 外设电源域。官方文档说明,ESP-IDF 会在进入睡眠前自动锁存唤醒引脚状态(HOLD 功能),所以照样可以用 rtc_gpio_pulldown_en() 等函数配置内部上下拉。追求最低电流的产品,更稳妥的做法是在板子上放外部上下拉电阻。
六、触摸唤醒
经典 ESP32 有 10 个电容触摸通道。Arduino 里用 touchSleepWakeUpEnable(pin, threshold) 配置,下面用 T3(GPIO15)和 T7(GPIO27):
#include <Arduino.h>
#define TOUCH_THRESHOLD 40 // 经典 ESP32 官方例程取值,需按实测调整
RTC_DATA_ATTR int bootCount = 0;
void setup() {
Serial.begin(115200);
delay(1000);
Serial.printf("第 %d 次启动\n", ++bootCount);
if (esp_sleep_get_wakeup_cause() == ESP_SLEEP_WAKEUP_TOUCHPAD) {
int pad = esp_sleep_get_touchpad_wakeup_status();
Serial.printf("由触摸通道 T%d 唤醒\n", pad);
}
touchSleepWakeUpEnable(T3, TOUCH_THRESHOLD); // GPIO15
touchSleepWakeUpEnable(T7, TOUCH_THRESHOLD); // GPIO27
Serial.println("摸一下触摸板唤醒");
Serial.flush();
esp_deep_sleep_start();
}
void loop() {
}
阈值怎么定:经典 ESP32 上,手指触摸时 touchRead() 的读数会下降,读数低于阈值即视为触摸。先单独跑一个程序,循环打印 touchRead(T3),记下不摸和摸着时的读数,阈值取两者之间。触摸电极面积、走线长度、外壳厚度都会影响读数,40 只是官方例程的起点。ESP32-S2/S3 的触摸外设不同,读数方向和量级都不一样(官方例程里用 5000 量级的阈值),而且只支持一个触摸通道作为睡眠唤醒源。
七、低功耗注意事项
深度睡眠电流能不能降到芯片手册标的水平,往往取决于软件之外的东西。
| 项目 | 说明 |
|---|---|
| 开发板本身 | DevKit 上的 USB 转串口芯片、LDO 静态电流、电源指示灯会一直耗电,实测睡眠电流常远高于芯片手册数值。做电池产品要在最终电路上测 |
| 引脚漏电 | 外部电路在睡眠中驱动某个带内部上下拉的引脚,电流会流过这些电阻。官方例子:ESP32-WROVER 模组的 GPIO12 外部有上拉、芯片内部有下拉,睡眠中会持续漏电。在进入睡眠前调用 rtc_gpio_isolate(GPIO_NUM_12) 隔离 |
| 外设模块 | 传感器、显示屏等外围模块不受 ESP32 睡眠控制,需要用 MOS 管或 LDO 使能脚在睡前断电 |
| RTC 电源域 | esp_deep_sleep_start() 默认会关掉唤醒源用不到的 RTC 电源域。不要随手用 esp_sleep_pd_config() 强制打开,除非确实需要 |
| Flash | 深度睡眠时 SPI Flash 会被强制断电,无需额外设置 |
| 串口输出 | 深度睡眠前,系统默认会等控制台串口 FIFO 发完再睡。Arduino 里仍建议睡前 Serial.flush() |
| 醒着的时间 | 每次醒来都要重新启动,启动过程本身就耗电。醒来后尽快做完事情再睡,联网上报时尤其要控制连接耗时 |
【提示】 > 调试深度睡眠程序时,芯片睡着就断开 USB 串口(原生 USB 的 S3/C3 尤其明显),电脑上看到的是端口消失又出现。想重新烧录时,如果 IDE 连不上,按住 BOOT 再点 EN 进入下载模式即可。
八、常见问题
| 现象 | 原因与处理 |
|---|---|
bootCount 每次都是 1 | 变量没加 RTC_DATA_ATTR;或者其实是复位而不是睡眠唤醒,打印唤醒原因确认 |
| 一睡下去就再也醒不过来 | 没有设置任何唤醒源;或者定时时间算溢出了,检查 ULL |
| 刚睡下立刻醒,循环不停 | ext0/ext1 引脚悬空或一直处于唤醒电平,加上下拉;ext1 的 ALL_LOW 模式下所有选中引脚都是低就会立刻唤醒 |
esp_sleep_enable_ext0_wakeup 返回错误 | 引脚不是 RTC GPIO;或与触摸、ULP 唤醒同时使用 |
醒来后按键引脚 digitalRead 读数不对 | 引脚还在 RTC IO 模式,先 rtc_gpio_deinit() |
| 触摸唤醒太灵敏或不灵 | 阈值不合适,按第六节实测调整 |
| 睡眠电流远高于预期 | 按第七节逐项排查,先拿掉开发板上的指示灯和外设模块再测 |
参考资料
- ESP-IDF 睡眠模式(ESP32):https://docs.espressif.com/projects/esp-idf/en/stable/esp32/api-reference/system/sleep_modes.html
- ESP-IDF 内存类型(RTC 内存):https://docs.espressif.com/projects/esp-idf/en/stable/esp32/api-guides/memory-types.html
- ESP-IDF 深度睡眠唤醒桩:https://docs.espressif.com/projects/esp-idf/en/stable/esp32/api-guides/deep-sleep-stub.html
- arduino-esp32 Touch API:https://docs.espressif.com/projects/arduino-esp32/en/latest/api/touch.html
- arduino-esp32 深度睡眠例程:https://github.com/espressif/arduino-esp32/tree/master/libraries/ESP32/examples/DeepSleep
评价 (0)