ESP32 低功耗模式下 RTC 内存保持外设状态机的设计陷阱与规避

引言

在物联网设备中，低功耗是核心需求。ESP32 的深度睡眠模式可将电流降至 10μA 以下，同时利用 RTC 内存（RTC Fast Memory 和 RTC Slow Memory）在唤醒后恢复数据。然而，许多开发者将外设状态机直接映射到 RTC 内存，却忽略了外设寄存器在深睡时全部丢失、时钟域切换、以及复位源不同导致的初始化差异，最终导致状态机“卡死”或行为异常。本文从底层机制出发，剖析陷阱并给出可落地的解决方案。

1. RTC 内存与外设状态机的关系

1.1 RTC 内存特性

  • RTC Fast Memory：8KB，CPU 可快速访问，适合存放频繁读写的状态变量。
  • RTC Slow Memory：8KB，访问速度较慢，适合存放配置数据。
  • 深睡期间，RTC 外设（包括 RTC 定时器、ULP 协处理器）仍工作，但主 CPU、Wi-Fi、蓝牙及绝大多数外设（UART、SPI、I2C、GPIO 等）均断电。

1.2 外设状态机的典型结构

typedef enum {
    STATE_IDLE,
    STATE_INIT,
    STATE_RUNNING,
    STATE_ERROR
} state_t;

// 状态机上下文（存储在 RTC 内存中）
RTC_DATA_ATTR state_t current_state;
RTC_DATA_ATTR uint32_t retry_count;

2. 设计陷阱深度剖析

陷阱 1：外设寄存器状态未保存

深睡唤醒后，所有外设寄存器恢复默认值。若状态机依赖外设的当前配置（如 UART 波特率、GPIO 方向），则必须重新初始化。

错误示例：

// 唤醒后直接发送数据，但 UART 未重新初始化
void on_wakeup() {
    if (current_state == STATE_RUNNING) {
        uart_write_bytes(UART_NUM, "hello", 5); // 失败！UART 寄存器已复位
    }
}

后果：数据丢失、状态机进入错误分支。

陷阱 2：状态变量与硬件状态不一致

状态机变量保存在 RTC 内存中，但硬件（如 GPIO 输出电平）在深睡时丢失。若状态机认为“LED 已点亮”，实际 GPIO 为高阻态，则后续操作可能基于错误假设。

陷阱 3：唤醒后时钟未稳定

ESP32 深睡唤醒后，系统时钟从 XTAL 切换到 PLL 需要时间。若立即访问外设，可能因时钟未稳定导致读写错误。

陷阱 4：复位源混淆

深睡唤醒的复位源是 ESP_RST_DEEPSLEEP，但若同时发生电源复位或软件复位，RTC 内存内容可能被清空（取决于复位类型）。状态机必须检查复位原因，否则可能用垃圾数据初始化。

3. 规避策略与代码实现

3.1 统一的状态机封装

设计一个结构体，包含状态、外设配置快照、校验和，并全部存入 RTC 内存。

#define STATE_MAGIC 0xA5A5A5A5

typedef struct {
    uint32_t magic;
    state_t state;
    uint32_t uart_baudrate;
    uint8_t gpio_level;
    uint32_t checksum;
} state_machine_t;

RTC_DATA_ATTR state_machine_t sm;

// 计算校验和
uint32_t calc_checksum(const state_machine_t* p) {
    uint32_t sum = p->magic ^ p->state ^ p->uart_baudrate ^ p->gpio_level;
    return sum;
}

// 保存状态（带校验）
void state_save(state_t s, uint32_t baud, uint8_t gpio) {
    sm.magic = STATE_MAGIC;
    sm.state = s;
    sm.uart_baudrate = baud;
    sm.gpio_level = gpio;
    sm.checksum = calc_checksum(&sm);
}

// 加载状态，返回是否有效
bool state_load(state_t* s, uint32_t* baud, uint8_t* gpio) {
    if (sm.magic != STATE_MAGIC) return false;
    if (sm.checksum != calc_checksum(&sm)) return false;
    *s = sm.state;
    *baud = sm.uart_baudrate;
    *gpio = sm.gpio_level;
    return true;
}

3.2 唤醒后强制重新初始化外设

无论状态机处于何状态，唤醒后必须重新配置所有用到的外设。将初始化函数设计为幂等。

void periph_init_from_state() {
    // 重新配置 UART
    uart_config_t uart_cfg = {
        .baud_rate = sm.uart_baudrate,
        .data_bits = UART_DATA_8_BITS,
        .parity = UART_PARITY_DISABLE,
        .stop_bits = UART_STOP_BITS_1,
        .flow_ctrl = UART_HW_FLOWCTRL_DISABLE
    };
    uart_param_config(UART_NUM_1, &uart_cfg);
    uart_driver_install(UART_NUM_1, 1024, 0, 0, NULL, 0);

    // 重新配置 GPIO
    gpio_set_direction(GPIO_NUM_2, GPIO_MODE_OUTPUT);
    gpio_set_level(GPIO_NUM_2, sm.gpio_level);
}

3.3 等待时钟稳定

在初始化外设前，调用 esp_wifi_stop() 或延迟一段时间（通常 10ms 足够）。更可靠的方法是使用 ets_delay_us(1000) 或等待系统时钟标志。

void wait_for_stable_clock() {
    // 简单延迟，实际可检查 rtc_clk_cal 等
    vTaskDelay(pdMS_TO_TICKS(10));
}

3.4 检查复位原因

在 app_main 开头判断复位源，区分深睡唤醒与其他复位。

void app_main() {
    esp_sleep_wakeup_cause_t cause = esp_sleep_get_wakeup_cause();
    if (cause == ESP_SLEEP_WAKEUP_UNDEFINED) {
        // 非深睡唤醒，可能是上电或软件复位，RTC 内存可能无效
        state_init_default();
    } else {
        if (!state_load(&current_state, &baud, &gpio_level)) {
            // 校验失败，回退到默认状态
            state_init_default();
        }
    }
    // 后续初始化
}

4. 完整示例：带状态机的深睡唤醒

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

// 状态机定义（见上文）

void app_main() {
    // 1. 检查复位原因
    esp_sleep_wakeup_cause_t cause = esp_sleep_get_wakeup_cause();
    if (cause != ESP_SLEEP_WAKEUP_UNDEFINED) {
        if (!state_load(&current_state, &baud, &gpio_level)) {
            // 数据损坏，重新初始化
            state_init_default();
        }
    } else {
        state_init_default();
    }

    // 2. 等待时钟稳定
    wait_for_stable_clock();

    // 3. 重新初始化外设
    periph_init_from_state();

    // 4. 根据状态执行操作
    switch (current_state) {
        case STATE_IDLE:
            // 进入深睡
            esp_sleep_enable_timer_wakeup(10 * 1000000); // 10秒
            esp_deep_sleep_start();
            break;
        case STATE_RUNNING:
            // 发送数据，更新状态
            uart_write_bytes(UART_NUM_1, "wake", 4);
            state_save(STATE_IDLE, baud, 0);
            break;
        default:
            // 错误处理
            break;
    }
}

5. 注意事项与最佳实践

  • 避免在 RTC 内存中存储指针：深睡后指针指向的地址可能无效，应存储数据本身。
  • 使用 RTC_DATA_ATTR 时注意对齐：某些结构体需要 __attribute__((aligned(4)))。
  • 测试不同复位源：使用 esp_sleep_get_wakeup_cause() 区分，并模拟电源复位验证校验和机制。
  • 外设初始化必须幂等：重复调用不会产生副作用。
  • 考虑 ULP 协处理器：如果使用 ULP 修改状态，需确保 RTC 内存访问一致性（使用 RTC_ENTER_CRITICAL）。

结语

ESP32 的 RTC 内存是低功耗设计的利器，但外设状态机若设计不当，极易在深睡唤醒后崩溃。通过封装状态机、强制重新初始化外设、检查复位原因和等待时钟稳定，可以构建可靠的系统。记住：RTC 内存只保存“数据”，不保存“硬件状态”，一切以硬件实际为准。

希望本文能帮你避开这些深坑，让你的设备在低功耗下依然稳定运行。