ESP32 低功耗模式下 RTC 内存保持与 GPIO 唤醒源冲突排查手册
👁 2 阅读 · 2026-08-27 · 嵌入式
在 ESP32 深度睡眠（Deep Sleep）中，RTC 内存用于保存关键数据，而 GPIO 唤醒源则负责将芯片从睡眠中唤醒。然而，两者在配置和使用上存在隐性冲突，常导致数据丢失或无法唤醒。本文从硬件原理出发，剖析冲突根源，提供系统化排查步骤与完整代码示例，帮助开发者快速定位并解决问题。
# ESP32 低功耗模式下 RTC 内存保持与 GPIO 唤醒源冲突排查手册
## 1. 背景与原理
ESP32 在深度睡眠（Deep Sleep）模式下，主 CPU 和大部分外设关闭，仅保留 ULP 协处理器、RTC 外设和部分 RTC 内存（RTC Fast Memory 和 RTC Slow Memory）供电。RTC 内存可用于保存唤醒后需要的数据，而 GPIO 唤醒源（如 EXT0/EXT1）则依赖 RTC 控制器检测引脚电平变化。
**冲突根源**：
- RTC 内存的保持需要 RTC 电源域稳定，而某些 GPIO 的唤醒配置（如启用内部上拉/下拉）会改变引脚状态，影响 RTC 内存的供电或时钟。
- 在配置 GPIO 唤醒时，若误将 RTC 内存所在的电源域（如 RTC_PERIPH）关闭，会导致内存数据丢失。
- 部分 GPIO 与 RTC 内存的电源管理寄存器共享，不当的 GPIO 配置可能触发意外的电源域切换。
## 2. 硬件与软件环境
- 芯片：ESP32（经典版，非 S2/S3）
- 开发框架：ESP-IDF v4.4 或 Arduino-ESP32 2.x
- 关键外设：RTC 内存、GPIO 唤醒源（EXT0/EXT1）
## 3. 冲突排查步骤
### 3.1 检查 RTC 内存保持配置
在进入 Deep Sleep 前，确保 RTC 内存的电源域保持开启。ESP-IDF 中，默认情况下 RTC 内存会保持，但若手动调用 `esp_sleep_pd_config()` 关闭了 `ESP_PD_DOMAIN_RTC_SLOW_MEM` 或 `ESP_PD_DOMAIN_RTC_FAST_MEM`，则数据会丢失。
```c
// 正确示例：保持 RTC 内存供电
esp_sleep_pd_config(ESP_PD_DOMAIN_RTC_SLOW_MEM, ESP_PD_OPTION_KEEP);
esp_sleep_pd_config(ESP_PD_DOMAIN_RTC_FAST_MEM, ESP_PD_OPTION_KEEP);
```
### 3.2 检查 GPIO 唤醒源配置
GPIO 唤醒源分为 EXT0（单引脚）和 EXT1（多引脚）。配置时需注意：
- EXT0 只能使用 RTC GPIO（编号 0-15），且不能与 RTC 内存的电源域冲突。
- EXT1 支持任意 GPIO，但会占用 RTC 控制器，可能影响 RTC 内存的访问。
```c
// 配置 EXT1 唤醒（GPIO 12 和 15）
esp_sleep_enable_ext1_wakeup(BIT(12) | BIT(15), ESP_EXT1_WAKEUP_ANY_HIGH);
```
### 3.3 冲突点定位
若出现数据丢失或无法唤醒，按以下顺序排查：
1. **检查电源域配置**：打印 `esp_sleep_get_wakeup_cause()` 和 RTC 内存内容，确认数据是否在唤醒后仍存在。
2. **检查 GPIO 内部上下拉**：某些 GPIO 在睡眠时若启用内部上拉，会拉高引脚电平，导致 EXT1 误触发或无法触发。
3. **检查 RTC 外设时钟**：若配置了 GPIO 唤醒，RTC 外设时钟必须开启，否则 GPIO 状态无法被检测。
## 4. 完整代码示例
以下代码演示了如何在 Deep Sleep 中保持 RTC 内存数据，并通过 GPIO 唤醒，同时避免冲突。
```c
#include
#include "esp_sleep.h"
#include "esp_log.h"
#include "driver/rtc_io.h"
#define WAKEUP_GPIO 12
#define DATA_ADDR (RTC_DATA_ATTR int counter) // 存储在 RTC 内存
void app_main() {
// 初始化 RTC 内存数据
if (esp_sleep_get_wakeup_cause() == ESP_SLEEP_WAKEUP_EXT1) {
counter++;
ESP_LOGI("MAIN", "Wakeup from GPIO, counter=%d", counter);
} else {
counter = 0;
ESP_LOGI("MAIN", "Fresh boot, counter reset");
}
// 配置 GPIO 唤醒源
esp_sleep_enable_ext1_wakeup(BIT(WAKEUP_GPIO), ESP_EXT1_WAKEUP_ANY_HIGH);
// 保持 RTC 内存供电
esp_sleep_pd_config(ESP_PD_DOMAIN_RTC_SLOW_MEM, ESP_PD_OPTION_KEEP);
esp_sleep_pd_config(ESP_PD_DOMAIN_RTC_FAST_MEM, ESP_PD_OPTION_KEEP);
// 设置 GPIO 为输入模式，并禁用内部上下拉（避免干扰）
rtc_gpio_init(WAKEUP_GPIO);
rtc_gpio_set_direction(WAKEUP_GPIO, RTC_GPIO_MODE_INPUT_ONLY);
rtc_gpio_pullup_dis(WAKEUP_GPIO);
rtc_gpio_pulldown_dis(WAKEUP_GPIO);
// 进入深度睡眠
ESP_LOGI("MAIN", "Entering deep sleep");
esp_deep_sleep_start();
}
```
## 5. 注意事项
- **避免使用 GPIO 0-15 作为 EXT0 唤醒**：这些引脚与 RTC 内存的电源管理寄存器有重叠，易引发冲突。推荐使用 EXT1。
- **禁用 GPIO 内部上下拉**：在睡眠前，通过 `rtc_gpio_pullup_dis()` 和 `rtc_gpio_pulldown_dis()` 禁用，防止电平漂移。
- **检查 RTC 内存大小**：RTC Fast Memory 仅 8KB，Slow Memory 8KB，存储数据时注意容量。
- **使用 `RTC_DATA_ATTR` 宏**：确保变量被放置在 RTC 内存段，否则数据不会保留。
- **测试唤醒原因**：在 app_main 开头打印 `esp_sleep_get_wakeup_cause()`，确认唤醒源是否符合预期。
## 6. 总结
RTC 内存保持与 GPIO 唤醒源的冲突，本质是电源域管理和引脚配置的交叉影响。通过正确配置电源域、谨慎选择 GPIO 并禁用内部上下拉，可以避免绝大多数问题。建议在开发阶段加入详细的日志输出，便于快速定位。希望本手册能帮助你高效排查相关故障。