ESP32 低功耗模式下 RTC 内存保持与 GPIO 唤醒源的冲突排查清单

一、背景与冲突本质

ESP32 在深度睡眠模式下，主 CPU 和大部分外设关闭，仅 RTC 域（RTC 内存、RTC 外设、ULP 协处理器）保持供电。开发者常利用 RTC 内存保存传感器校准值或状态标志，同时使用 GPIO 唤醒（如按键或外部信号）来恢复运行。

冲突通常源于以下三点：

  • 引脚复用冲突：部分 GPIO 在深度睡眠时被 RTC 外设占用，或未配置为 RTC 功能。
  • 唤醒电平与 RTC 内存写入时序：唤醒瞬间 GPIO 状态变化可能触发意外中断，导致 RTC 内存写入被破坏。
  • 电源域隔离：RTC 内存的保持依赖 RTC 电源域，若 GPIO 唤醒源使用外部上拉/下拉，可能引入额外电流路径，影响 RTC 域稳定性。

二、核心原理：RTC 内存与唤醒源的工作机制

1. RTC 内存（RTC Fast Memory / RTC Slow Memory）

  • 容量：8KB 快速内存 + 8KB 慢速内存（实际可用约 8KB）。
  • 访问方式：通过 esp_sleep_get_retention_data() 或直接指针访问（需 RTC_NOINIT_ATTR 属性）。
  • 保持条件：RTC 电源域必须开启（esp_sleep_pd_config(ESP_PD_DOMAIN_RTC_SLOW_MEM, ESP_PD_OPTION_ON)）。

2. GPIO 唤醒源

  • 支持 EXT0（单引脚）和 EXT1（多引脚，任一触发）。
  • 唤醒电平：高电平或低电平（由 esp_sleep_enable_ext0_wakeup() 的 level 参数决定）。
  • 关键点：唤醒引脚必须属于 RTC GPIO（编号 0-15、32-39），且需配置为输入模式。

3. 冲突根源

  • 若 RTC 内存写入操作与 GPIO 唤醒中断同时发生（例如在 loop() 中写 RTC 内存，而 GPIO 电平抖动触发唤醒），可能导致数据半写入。
  • 若 GPIO 唤醒引脚未正确配置为 RTC 功能，深度睡眠时该引脚会浮空，产生漏电流，干扰 RTC 域供电。

三、系统化排查清单

1. 引脚配置检查

  • [ ] 确认唤醒引脚是否为 RTC GPIO（参考 ESP32 数据手册，如 GPIO2、GPIO4、GPIO12-15、GPIO32-39）。
  • [ ] 在进入睡眠前，使用 gpio_set_direction(pin, GPIO_MODE_INPUT) 和 gpio_pullup_en(pin) 或 gpio_pulldown_en(pin) 设置明确电平。
  • [ ] 避免使用 GPIO12（内置上拉，且影响 flash 电压），GPIO0 和 GPIO2 需注意外部连接。

2. RTC 内存访问保护

  • [ ] 使用 RTC_NOINIT_ATTR 定义全局变量，确保数据存于 RTC 内存。
  • [ ] 在写 RTC 内存前，禁用唤醒中断：esp_sleep_disable_wakeup_source(ESP_SLEEP_WAKEUP_EXT0)（或 EXT1）。
  • [ ] 写入完成后，重新启用唤醒源。

3. 电源域配置

  • [ ] 确保 RTC 内存电源域开启：esp_sleep_pd_config(ESP_PD_DOMAIN_RTC_SLOW_MEM, ESP_PD_OPTION_ON)。
  • [ ] 若使用 EXT1，检查 esp_sleep_enable_ext1_wakeup() 的 mode 参数（ESP_EXT1_WAKEUP_ALL_LOW 或 ESP_EXT1_WAKEUP_ANY_HIGH），确保与外部电路匹配。

4. 唤醒时序与数据完整性

  • [ ] 在唤醒后，立即读取 RTC 内存，并校验 CRC 或魔数（Magic Number）。
  • [ ] 若数据损坏，可增加写入重试机制，或使用双缓冲。

四、完整代码示例

以下代码演示如何安全地使用 RTC 内存保存计数器，并通过 GPIO4（EXT0）唤醒。

#include <stdio.h>
#include "esp_sleep.h"
#include "driver/gpio.h"
#include "esp_log.h"

// 定义 RTC 内存变量（带魔数校验）
RTC_NOINIT_ATTR uint32_t rtc_counter;
RTC_NOINIT_ATTR uint32_t rtc_magic;
#define MAGIC 0xDEADBEEF

#define WAKEUP_PIN GPIO_NUM_4

void app_main(void) {
    // 初始化串口
    printf("ESP32 Wakeup Test\n");

    // 检查是否为深度睡眠唤醒
    if (esp_sleep_get_wakeup_cause() == ESP_SLEEP_WAKEUP_EXT0) {
        // 校验魔数
        if (rtc_magic == MAGIC) {
            rtc_counter++;
            printf("Wakeup from EXT0, counter = %lu\n", (unsigned long)rtc_counter);
        } else {
            // 首次启动或数据损坏
            rtc_counter = 0;
            rtc_magic = MAGIC;
            printf("First boot or data corrupted, counter reset\n");
        }
    } else {
        // 正常启动
        rtc_counter = 0;
        rtc_magic = MAGIC;
        printf("Normal boot\n");
    }

    // 配置唤醒引脚
    gpio_set_direction(WAKEUP_PIN, GPIO_MODE_INPUT);
    gpio_pullup_en(WAKEUP_PIN);  // 默认高电平，低电平唤醒

    // 确保 RTC 内存电源域开启
    esp_sleep_pd_config(ESP_PD_DOMAIN_RTC_SLOW_MEM, ESP_PD_OPTION_ON);

    // 在写入 RTC 内存前，禁用唤醒源（避免写入冲突）
    esp_sleep_disable_wakeup_source(ESP_SLEEP_WAKEUP_EXT0);
    rtc_counter++;  // 模拟写入数据
    rtc_magic = MAGIC;
    // 重新启用唤醒源
    esp_sleep_enable_ext0_wakeup(WAKEUP_PIN, 0);  // 低电平唤醒

    // 进入深度睡眠
    printf("Entering deep sleep...\n");
    esp_deep_sleep_start();
}

五、注意事项

  • 避免在中断回调中写 RTC 内存：深度睡眠前，中断可能被触发，但 RTC 内存写入非原子操作，建议在任务中完成。
  • EXT1 与 EXT0 互斥：不能同时启用 EXT0 和 EXT1，否则会报错。
  • GPIO 唤醒电平选择：若外部电路有上拉，应选择低电平唤醒；反之亦然，避免浮空。
  • 测试工具：使用 esp_sleep_get_wakeup_cause() 区分唤醒源，便于调试。
  • 功耗优化：若不需要 RTC 内存，可关闭其电源域以降低功耗，但本场景必须保持开启。

六、总结

通过上述清单，你可以系统性地排查 ESP32 低功耗模式下 RTC 内存与 GPIO 唤醒源的冲突。核心在于：正确配置 RTC GPIO、保护 RTC 内存写入时序、确保电源域稳定，并在唤醒后校验数据完整性。实践时，建议先用最小示例验证，再逐步集成到复杂系统中。