ESP32 低功耗模式下 RTC 内存保持与 GPIO 唤醒源的冲突规避

1. 背景与冲突本质

ESP32 在深度睡眠（Deep Sleep）模式下，主 CPU 和大部分外设断电，仅 RTC 域（RTC 内存、RTC 外设、ULP 协处理器）保持供电。RTC 内存（约 8KB）用于保存唤醒后需要的数据，而 GPIO 唤醒源（EXT0/EXT1）依赖 RTC GPIO 控制器检测外部电平变化。

冲突根源：

引脚复用：并非所有 GPIO 都支持 RTC 功能，只有标有 RTC_GPIO 的引脚（如 GPIO0-15, 36-39）才能作为唤醒源。若将数据存储引脚与唤醒引脚混用，可能导致唤醒信号干扰内存写入。
电源域隔离：RTC 内存由 RTC 电源域供电，而 GPIO 唤醒逻辑依赖 RTC 外设域。若配置不当（如未启用 RTC_CNTL 的保持位），唤醒瞬间可能重置内存。
唤醒逻辑冲突：EXT0 支持单引脚电平触发，EXT1 支持多引脚任意触发，但两者共用 RTC 控制器，同时启用会引发优先级混乱。

2. 硬件与软件准备

硬件：ESP32 DevKitC（或任意模组），LED 和按键（接 GPIO 4 和 GPIO 5）。
软件：ESP-IDF v5.x（或 Arduino-ESP32 2.x，但本文以 IDF 为例）。
工具：串口监视器（波特率 115200）。

3. 核心原理：RTC 内存与唤醒源的协同机制

3.1 RTC 内存保持

RTC 内存分为 8 个段（RTC_DATA_ATTR 和 RTC_NOINIT_ATTR）。深度睡眠时，若未调用 esp_deep_sleep_start() 前写入数据，唤醒后数据仍在。关键点：必须使用 RTC_DATA_ATTR 或 RTC_NOINIT_ATTR 修饰全局变量，否则数据存于 DRAM 会丢失。

RTC_DATA_ATTR int boot_count = 0;  // 每次唤醒后保留
RTC_NOINIT_ATTR float sensor_val;  // 不初始化，保留原始值

3.2 GPIO 唤醒源

EXT0：单引脚，支持高/低电平触发，但只能使用 RTC GPIO（0-15, 36-39）。
EXT1：多引脚（最多 3 个），支持任意一个触发，但仅支持低电平或高电平（需统一）。

唤醒后，通过 esp_sleep_get_wakeup_cause() 判断唤醒源，并读取触发引脚状态。

3.3 冲突点分析

引脚冲突：若使用 GPIO 4 作为唤醒源，同时又在 RTC 内存中保存 GPIO 4 的配置（如 ADC 校准值），唤醒时 GPIO 4 的电平变化可能被误判为数据更新。
电源域冲突：RTC 内存的保持需要 RTC_SLEEP_PD_RTC_MEM 不置位（即保持供电），但某些低功耗配置会关闭 RTC 内存电源以省电，导致数据丢失。
唤醒源冲突：EXT0 和 EXT1 不能同时启用，否则唤醒后 esp_sleep_get_wakeup_cause() 返回错误。

4. 配置步骤与代码实现

4.1 引脚选择策略

专用唤醒引脚：选择不用于数据存储的 RTC GPIO，如 GPIO 5（RTC_GPIO5）。
避免复用：若必须复用，则在写入内存前禁用唤醒，唤醒后重新配置。

4.2 完整代码示例（ESP-IDF）

#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_GPIO 5  // 仅使用 RTC GPIO
#define BUTTON_GPIO 4  // 普通 GPIO，不用于唤醒

RTC_DATA_ATTR int boot_count = 0;
RTC_NOINIT_ATTR int last_wakeup_pin;

void app_main() {
    // 1. 检查唤醒原因
    esp_sleep_wakeup_cause_t cause = esp_sleep_get_wakeup_cause();
    if (cause == ESP_SLEEP_WAKEUP_EXT1) {
        uint64_t gpio_mask = esp_sleep_get_ext1_wakeup_status();
        if (gpio_mask & (1ULL << WAKEUP_GPIO)) {
            last_wakeup_pin = WAKEUP_GPIO;
        }
    }

    // 2. 更新数据（写入 RTC 内存）
    boot_count++;
    printf("Boot count: %d, wakeup pin: %d\n", boot_count, last_wakeup_pin);

    // 3. 配置 GPIO 唤醒源（EXT1，仅用 GPIO5）
    gpio_config_t io_conf = {
        .pin_bit_mask = (1ULL << WAKEUP_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);
    esp_sleep_enable_ext1_wakeup((1ULL << WAKEUP_GPIO), ESP_EXT1_WAKEUP_ANY_LOW);

    // 4. 确保 RTC 内存保持（默认保持，但显式设置）
    esp_sleep_pd_config(ESP_PD_DOMAIN_RTC_MEM, ESP_PD_OPTION_ON);  // 保持供电

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

4.3 冲突规避要点

禁用不必要的唤醒源：若同时使用 EXT0 和 EXT1，先调用 esp_sleep_disable_wakeup_source(ESP_SLEEP_WAKEUP_ALL) 清除。
电源域配置：esp_sleep_pd_config(ESP_PD_DOMAIN_RTC_MEM, ESP_PD_OPTION_ON) 确保内存不掉电，但会增加约 10μA 电流，需权衡。
引脚去抖：在唤醒源引脚上加 RC 滤波或软件去抖，避免误触发。

5. 常见问题与调试技巧

| 问题现象 | 可能原因 | 解决方案 | |---------|---------|---------| | 唤醒后数据丢失 | RTC 内存电源被关闭 | 检查 esp_sleep_pd_config 设置，或使用 RTC_NOINIT_ATTR | | 无法唤醒 | 引脚非 RTC GPIO | 更换为 0-15, 36-39 引脚 | | 唤醒后重启循环 | 唤醒源未清除 | 在 app_main 开头调用 esp_sleep_get_wakeup_cause() 并处理 | | EXT0/EXT1 冲突 | 同时启用 | 只启用一个，或先禁用所有再启用 |

调试技巧：

使用 esp_deep_sleep_start() 前打印 esp_sleep_get_wakeup_cause() 和 esp_sleep_get_ext1_wakeup_status()。
在 RTC 内存中存储 CRC 校验值，唤醒后校验数据完整性。

6. 总结与最佳实践

引脚规划：在 PCB 设计阶段就区分唤醒引脚和数据存储引脚，避免复用。
电源权衡：若电池供电，优先保持 RTC 内存（数据可靠），若数据可重新获取，可关闭以省电。
代码健壮性：始终检查唤醒原因，并初始化所有 RTC 变量（除非用 RTC_NOINIT_ATTR）。

通过以上策略，你可以有效规避 ESP32 低功耗模式下的冲突，实现稳定、低功耗的物联网节点。

ESP32 低功耗模式下 RTC 内存保持与 GPIO 唤醒源的冲突规避实战指南