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，则数据会丢失。

// 正确示例：保持 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 内存的访问。
// 配置 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 唤醒，同时避免冲突。

#include <stdio.h>
#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 并禁用内部上下拉，可以避免绝大多数问题。建议在开发阶段加入详细的日志输出，便于快速定位。希望本手册能帮助你高效排查相关故障。