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

一、问题背景与现象

在 ESP32 低功耗应用中，开发者常使用 Deep Sleep 模式来降低功耗，同时利用 RTC 内存（RTC Fast Memory 或 RTC Slow Memory）保存关键数据（如传感器校准值、状态标志），并通过 GPIO 唤醒源（EXT0/EXT1）实现外部事件触发唤醒。

然而，不少开发者会遇到以下诡异现象：

唤醒后 RTC 内存中的部分数据被清零或篡改；
配置了 GPIO 唤醒，但设备无法从 Deep Sleep 中唤醒；
唤醒后系统复位（而非从睡眠点继续执行）。

这些问题的根源往往在于 RTC 内存保持与 GPIO 唤醒源在 RTC 域资源上的冲突。

二、底层原理：RTC 域资源分配

ESP32 的 Deep Sleep 模式下，主 CPU、Wi-Fi、蓝牙等外设均断电，仅 RTC 域（RTC 外设、RTC 内存、ULP 协处理器）保持供电。

RTC 内存：分为 Fast（8KB）和 Slow（8KB）两部分，用于保存数据。其供电由 RTC 电源域控制，可通过 esp_sleep_pd_config() 配置保持策略。
GPIO 唤醒源：EXT0 唤醒（单引脚）和 EXT1 唤醒（多引脚）均由 RTC 控制器（RTC IO）实现，需要 RTC 外设（RTCIO）保持供电。

冲突点：

电源域冲突：如果显式关闭了 RTC 外设的电源（例如 esp_sleep_pd_config(ESP_PD_DOMAIN_RTC_PERIPH, ESP_PD_OPTION_OFF)），则 GPIO 唤醒功能失效，同时可能影响 RTC 内存的访问（因为 RTC 内存控制器属于 RTC 外设）。
内存访问冲突：在 Deep Sleep 期间，ULP 协处理器或 RTC 外设可能访问 RTC 内存，若与主 CPU 写入操作重叠，会导致数据损坏。
唤醒源配置错误：EXT1 唤醒需要指定触发模式（高/低电平），若与 RTC 内存中保存的引脚状态冲突，可能导致意外唤醒或无法唤醒。

三、排查流程与配置步骤

1. 确认 RTC 内存保持配置

使用 esp_sleep_pd_config() 显式设置 RTC 内存的电源策略，确保在 Deep Sleep 期间保持供电。

#include "esp_sleep.h"

void configure_rtc_memory() {
    // 保持 RTC 快速内存和慢速内存供电
    esp_sleep_pd_config(ESP_PD_DOMAIN_RTC_FAST_MEM, ESP_PD_OPTION_ON);
    esp_sleep_pd_config(ESP_PD_DOMAIN_RTC_SLOW_MEM, ESP_PD_OPTION_ON);
    // 保持 RTC 外设供电（GPIO 唤醒需要）
    esp_sleep_pd_config(ESP_PD_DOMAIN_RTC_PERIPH, ESP_PD_OPTION_ON);
}

注意：ESP_PD_OPTION_ON 表示强制保持供电，ESP_PD_OPTION_OFF 表示关闭，ESP_PD_OPTION_AUTO 表示由系统自动决定。

2. 正确配置 GPIO 唤醒源

EXT1 唤醒支持多个引脚，需指定掩码和触发模式。

#define WAKEUP_PIN_1  GPIO_NUM_4
#define WAKEUP_PIN_2  GPIO_NUM_5

void setup_gpio_wakeup() {
    // 配置 GPIO 为输入模式，并启用内部上拉（根据触发模式）
    gpio_config_t io_conf = {
        .pin_bit_mask = (1ULL << WAKEUP_PIN_1) | (1ULL << WAKEUP_PIN_2),
        .mode = GPIO_MODE_INPUT,
        .pull_up_en = GPIO_PULLUP_ENABLE,
        .pull_down_en = GPIO_PULLDOWN_DISABLE,
        .intr_type = GPIO_INTR_DISABLE
    };
    gpio_config(&io_conf);

    // 配置 EXT1 唤醒，低电平触发（根据实际电路选择）
    esp_sleep_enable_ext1_wakeup((1ULL << WAKEUP_PIN_1) | (1ULL << WAKEUP_PIN_2), ESP_EXT1_WAKEUP_ANY_LOW);
}

3. 数据保存与恢复

使用 RTC 内存时，建议定义在 .rtc.data 段，或使用 RTC_DATA_ATTR 宏。

RTC_DATA_ATTR int boot_count = 0;
RTC_DATA_ATTR float sensor_calibration = 1.0f;

void save_data_to_rtc() {
    boot_count++;
    sensor_calibration = 2.5f; // 示例数据
}

void load_data_from_rtc() {
    ESP_LOGI("MAIN", "Boot count: %d, Calibration: %.2f", boot_count, sensor_calibration);
}

4. 进入 Deep Sleep 前的完整流程

void enter_deep_sleep() {
    // 1. 配置电源域
    configure_rtc_memory();
    // 2. 配置 GPIO 唤醒
    setup_gpio_wakeup();
    // 3. 保存数据
    save_data_to_rtc();
    // 4. 进入睡眠
    esp_deep_sleep_start();
}

5. 唤醒后的处理

在 app_main() 中，通过 esp_sleep_get_wakeup_cause() 判断唤醒源，并恢复数据。

void app_main() {
    esp_sleep_wakeup_cause_t cause = esp_sleep_get_wakeup_cause();
    if (cause == ESP_SLEEP_WAKEUP_EXT1) {
        ESP_LOGI("MAIN", "Woken up by GPIO");
        load_data_from_rtc();
        // 执行唤醒后的任务
    } else {
        ESP_LOGI("MAIN", "First boot or other wakeup");
        // 初始化数据
    }
    // 模拟工作后进入睡眠
    vTaskDelay(pdMS_TO_TICKS(5000));
    enter_deep_sleep();
}

四、冲突排查清单

当遇到问题时，按以下顺序检查：

检查电源域配置：确保 ESP_PD_DOMAIN_RTC_PERIPH 和 RTC 内存域均为 ESP_PD_OPTION_ON。若使用 esp_sleep_pd_config 关闭了 RTC 外设，GPIO 唤醒必然失败。
检查 GPIO 引脚是否被占用：某些 GPIO 在 Deep Sleep 下默认有特殊功能（如 ADC、触摸），需通过 rtc_gpio_hold_en() 保持状态，但可能影响唤醒。
检查唤醒电平与外部电路：EXT1 的触发模式必须与外部信号匹配（如按键接地则用低电平触发）。
检查 RTC 内存地址对齐：使用 RTC_DATA_ATTR 或 __attribute__((section(".rtc.data")))，避免编译器优化。
检查 ULP 协处理器：若启用了 ULP，确保其不访问 RTC 内存的同一区域，否则需使用互斥机制（如 RTC 内存锁）。
查看日志：启用 esp_sleep 调试日志（CONFIG_LOG_DEFAULT_LEVEL_DEBUG），观察睡眠和唤醒时的电源域状态。

五、完整代码示例

以下是一个完整的示例，演示了 RTC 内存保持与 GPIO 唤醒的协同工作。

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

#define WAKEUP_PIN GPIO_NUM_4

RTC_DATA_ATTR int boot_count = 0;

void configure_rtc_memory() {
    esp_sleep_pd_config(ESP_PD_DOMAIN_RTC_FAST_MEM, ESP_PD_OPTION_ON);
    esp_sleep_pd_config(ESP_PD_DOMAIN_RTC_SLOW_MEM, ESP_PD_OPTION_ON);
    esp_sleep_pd_config(ESP_PD_DOMAIN_RTC_PERIPH, ESP_PD_OPTION_ON);
}

void setup_gpio_wakeup() {
    gpio_config_t io_conf = {
        .pin_bit_mask = (1ULL << WAKEUP_PIN),
        .mode = GPIO_MODE_INPUT,
        .pull_up_en = GPIO_PULLUP_ENABLE,
        .pull_down_en = GPIO_PULLDOWN_DISABLE,
        .intr_type = GPIO_INTR_DISABLE
    };
    gpio_config(&io_conf);
    esp_sleep_enable_ext1_wakeup((1ULL << WAKEUP_PIN), ESP_EXT1_WAKEUP_ANY_LOW);
}

void app_main() {
    esp_sleep_wakeup_cause_t cause = esp_sleep_get_wakeup_cause();
    if (cause == ESP_SLEEP_WAKEUP_EXT1) {
        ESP_LOGI("MAIN", "Wakeup from GPIO, boot_count=%d", boot_count);
        boot_count++;
    } else {
        ESP_LOGI("MAIN", "First boot, initializing...");
        boot_count = 1;
    }

    // 模拟工作
    vTaskDelay(pdMS_TO_TICKS(2000));

    // 配置并进入睡眠
    configure_rtc_memory();
    setup_gpio_wakeup();
    ESP_LOGI("MAIN", "Entering deep sleep...");
    esp_deep_sleep_start();
}

六、注意事项

电源域配置顺序：必须在进入睡眠前调用 esp_sleep_pd_config()，且应在 esp_deep_sleep_start() 之前完成。
GPIO 保持：在 Deep Sleep 期间，GPIO 状态由 RTC 域保持，但若使用 gpio_hold_en()，需在唤醒后手动 gpio_hold_dis()，否则可能影响后续操作。
内存对齐：RTC 内存访问速度较慢，且容量有限（8KB），避免存储大数组。
唤醒源优先级：若同时配置多个唤醒源（如定时器 + GPIO），需在唤醒后逐一判断。
调试技巧：使用 esp_sleep_get_wakeup_cause() 打印原因，并利用 esp_deep_sleep_start() 的返回值（实际上不会返回）来确认是否进入睡眠。

七、总结

ESP32 的 Deep Sleep 模式是低功耗应用的核心，但 RTC 内存与 GPIO 唤醒源的冲突往往隐蔽。通过理解 RTC 电源域架构、正确配置电源策略、并遵循排查清单，可以快速定位问题。本文提供的示例代码可直接用于实际项目，开发者可根据具体硬件调整引脚和触发模式。记住：先保证 RTC 外设供电，再谈唤醒；先验证数据保持，再优化功耗。

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