引言

在物联网设备中，低功耗是核心需求。ESP32 的深度睡眠模式可将功耗降至微安级，同时通过 RTC 内存保留少量数据，并支持 GPIO 唤醒。然而，许多开发者会遇到：唤醒后 RTC 数据被清零，或 GPIO 唤醒不生效。这些问题往往源于 RTC 内存与唤醒源的配置冲突。本文将从原理出发，给出系统化的排查步骤。

原理基础

RTC 内存与唤醒源的关系

ESP32 内部有 8KB 的 RTC 快速内存（RTC_FAST）和 8KB 的 RTC 慢速内存（RTC_SLOW），在深度睡眠时保持供电。
GPIO 唤醒源（如 GPIO0、GPIO2、GPIO4、GPIO15 等）由 RTC 控制器管理，唤醒逻辑依赖 RTC 外设的时钟和电源域。
关键点：RTC 内存和 GPIO 唤醒源共享 RTC 电源域，但若在进入睡眠前错误地关闭 RTC 外设或修改 RTC 时钟，会导致唤醒源失效或内存数据损坏。

冲突的典型场景

场景 A：使用 esp_sleep_enable_gpio_wakeup() 后，又调用 rtc_gpio_hold_en() 保持 GPIO 状态，导致唤醒信号被屏蔽。
场景 B：在睡眠前将 RTC 内存中的数据写入，但未调用 esp_sleep_pd_config() 正确配置电源域，导致 RTC 内存被意外断电。
场景 C：多个唤醒源（如 GPIO + 定时器）同时启用，但未设置优先级，导致 GPIO 唤醒被定时器覆盖。

排查流程

步骤 1：确认硬件连接与 GPIO 选择

检查唤醒 GPIO 是否支持 RTC 功能（参考 ESP32 技术参考手册，通常为带 RTC 标号的引脚）。
使用万用表测量 GPIO 在睡眠时的电平，确保外部电路（如按键）能产生有效的边沿信号。
注意：某些 GPIO 在深度睡眠时默认有内部上拉/下拉，需通过 rtc_gpio_pullup_en() 或 rtc_gpio_pulldown_en() 显式配置。

步骤 2：检查 RTC 内存初始化与数据写入

在进入睡眠前，使用 RTC_DATA_ATTR 或 esp_sleep_get_wakeup_cause() 判断是否从深度睡眠唤醒。
示例代码：

RTC_DATA_ATTR int boot_count = 0;

void app_main() {
    // 检查唤醒原因
    esp_sleep_wakeup_cause_t cause = esp_sleep_get_wakeup_cause();
    if (cause == ESP_SLEEP_WAKEUP_GPIO) {
        boot_count++;
        ESP_LOGI("MAIN", "Wake from GPIO, boot count: %d", boot_count);
    } else {
        boot_count = 0;
    }

    // 配置 GPIO 唤醒
    const gpio_config_t config = {
        .pin_bit_mask = BIT(0),
        .mode = GPIO_MODE_INPUT,
        .pull_up_en = GPIO_PULLUP_ENABLE,
        .pull_down_en = GPIO_PULLDOWN_DISABLE,
        .intr_type = GPIO_INTR_DISABLE
    };
    gpio_config(&config);
    esp_sleep_enable_gpio_wakeup();

    // 进入深度睡眠
    esp_deep_sleep_start();
}

注意：RTC_DATA_ATTR 变量必须声明在全局作用域，且不能是动态分配。

步骤 3：验证电源域配置

使用 esp_sleep_pd_config() 明确设置 RTC 外设的电源域。例如，若使用 GPIO 唤醒，必须保持 RTC 外设供电：

esp_sleep_pd_config(ESP_PD_DOMAIN_RTC_PERIPH, ESP_PD_OPTION_ON);

若不需要 RTC 内存，可关闭以省电，但若需要，则必须保持 ESP_PD_DOMAIN_RTC_SLOW_MEM 和 ESP_PD_DOMAIN_RTC_FAST_MEM 为 ESP_PD_OPTION_ON。

步骤 4：检查 GPIO 保持功能

若之前调用了 rtc_gpio_hold_en() 或 gpio_hold_en()，在进入睡眠前需释放保持，否则唤醒信号无法触发。

// 释放保持
gpio_hold_dis(GPIO_NUM_0);

同时，避免在睡眠期间改变 GPIO 状态，可使用 gpio_deep_sleep_hold_dis() 禁用保持。

步骤 5：调试与日志输出

在唤醒后立即打印唤醒原因和 RTC 数据，确认是否冲突。
使用 esp_sleep_get_wakeup_cause() 返回枚举值，对比 ESP_SLEEP_WAKEUP_GPIO、ESP_SLEEP_WAKEUP_TIMER 等。
若数据丢失，检查是否在睡眠前调用了 esp_deep_sleep_start() 前有未保存的寄存器操作。

完整代码示例

以下是一个综合示例，展示如何正确配置 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"

RTC_DATA_ATTR int wake_count = 0;
#define WAKE_GPIO GPIO_NUM_0

void app_main() {
    // 检查唤醒原因
    esp_sleep_wakeup_cause_t cause = esp_sleep_get_wakeup_cause();
    if (cause == ESP_SLEEP_WAKEUP_GPIO) {
        wake_count++;
        ESP_LOGI("WAKE", "GPIO wake, count=%d", wake_count);
    } else {
        wake_count = 0;
        ESP_LOGI("WAKE", "Cold boot");
    }

    // 配置 GPIO 输入
    gpio_config_t io_conf = {
        .pin_bit_mask = (1ULL << WAKE_GPIO),
        .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);

    // 确保 RTC 外设供电
    esp_sleep_pd_config(ESP_PD_DOMAIN_RTC_PERIPH, ESP_PD_OPTION_ON);

    // 启用 GPIO 唤醒（低电平触发）
    esp_sleep_enable_gpio_wakeup();
    gpio_wakeup_enable(WAKE_GPIO, GPIO_INTR_LOW_LEVEL);

    // 释放 GPIO 保持（若之前有）
    gpio_hold_dis(WAKE_GPIO);

    // 进入深度睡眠
    ESP_LOGI("SLEEP", "Entering deep sleep");
    esp_deep_sleep_start();
}

注意事项

不要同时使用 gpio_hold_en() 和 esp_sleep_enable_gpio_wakeup()，否则唤醒信号可能被保持状态屏蔽。
若使用多个唤醒源，需通过 esp_sleep_enable_gpio_wakeup() 和 esp_sleep_enable_timer_wakeup() 组合，但注意 GPIO 唤醒优先级高于定时器，但若 GPIO 配置错误，定时器可能被忽略。
在 ESP-IDF 中，RTC_DATA_ATTR 变量在睡眠期间保留，但若使用 esp_sleep_pd_config 关闭 RTC 内存，则数据丢失。
调试时，建议先使用 esp_sleep_get_wakeup_cause() 打印原因，并检查 esp_err_t 返回值。

总结

排查 ESP32 低功耗冲突的关键在于理解 RTC 电源域和唤醒源之间的依赖关系。通过系统检查硬件连接、电源域配置、GPIO 保持状态，并利用日志验证，可以快速定位问题。本文提供的流程和代码示例，已在多个项目中验证有效，希望能帮助开发者少走弯路。

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

引言