ESP32-C3 低功耗模式下 RTC 内存数据完整性校验与恢复策略

1. 为什么需要RTC内存校验？

ESP32-C3在深度睡眠（Deep Sleep）模式下，主CPU、SRAM和Flash均断电，仅RTC外设和RTC内存（约8KB）保持供电。开发者常将传感器校准值、设备状态、网络配置等关键数据存入RTC内存，以在唤醒后快速恢复上下文。

但RTC内存并非绝对可靠：

  • 电源噪声：电池电压波动或电源切换瞬间可能翻转存储位。
  • 代码越界：指针错误或缓冲区溢出可能意外写入RTC区域。
  • 静电干扰：在恶劣电磁环境下，数据位翻转概率上升。

一旦RTC数据损坏，设备可能以错误参数运行，导致测量偏差、通信失败甚至死循环。因此，必须引入完整性校验和恢复机制。

2. 校验策略设计：CRC32 + 双区备份

2.1 核心思想

  • CRC32校验：对数据区计算32位循环冗余校验值，存储于数据尾部。唤醒后重新计算并与存储值比对，若一致则数据有效。
  • 双区备份：将同一份数据复制到两个独立区域（A区和B区）。若A区校验失败，尝试B区；若B区也失败，则恢复默认值。

2.2 内存布局

#define RTC_DATA_ATTR rtc_store_t rtc_data_a;
#define RTC_DATA_ATTR rtc_store_t rtc_data_b;

typedef struct {
    uint32_t magic;      // 魔数，用于快速识别有效性
    uint32_t crc;        // CRC32值
    uint8_t data[256];   // 实际数据（示例大小）
} rtc_store_t;
  • magic：固定值如0xA5A5A5A5，用于快速判断区域是否被初始化。
  • crc：对magic和data字段计算CRC32。
  • data：用户自定义数据，可扩展为结构体。

3. 实现步骤

3.1 初始化与写入

#include "esp_sleep.h"
#include "esp_crc.h"

#define RTC_MAGIC 0xA5A5A5A5

void rtc_store_write(rtc_store_t *store, const uint8_t *data, size_t len) {
    store->magic = RTC_MAGIC;
    memcpy(store->data, data, len);
    // 计算CRC：覆盖magic和data区域
    uint32_t crc = esp_crc32_le(0, (uint8_t*)store, offsetof(rtc_store_t, crc));
    store->crc = crc;
}
  • 写入时先更新magic和数据，再计算CRC并存储。
  • 注意：CRC计算范围从结构体起始到crc字段之前，避免包含crc自身。

3.2 读取与校验

bool rtc_store_validate(const rtc_store_t *store) {
    if (store->magic != RTC_MAGIC) return false;
    uint32_t calc_crc = esp_crc32_le(0, (uint8_t*)store, offsetof(rtc_store_t, crc));
    return (calc_crc == store->crc);
}

bool rtc_store_read(uint8_t *out_data, size_t len) {
    // 优先A区，其次B区
    if (rtc_store_validate(&rtc_data_a)) {
        memcpy(out_data, rtc_data_a.data, len);
        return true;
    }
    if (rtc_store_validate(&rtc_data_b)) {
        memcpy(out_data, rtc_data_b.data, len);
        // 可选：修复A区为B区内容
        rtc_store_write(&rtc_data_a, rtc_data_b.data, len);
        return true;
    }
    // 双区均无效，恢复默认值
    return false;
}
  • 校验失败时，尝试备用区，并自动修复主区，避免下次再次失败。

3.3 恢复策略

当双区均损坏时，需恢复默认配置。建议在系统初始化时调用：

void rtc_store_restore_default() {
    uint8_t default_data[256] = {0}; // 实际默认值由业务定义
    rtc_store_write(&rtc_data_a, default_data, sizeof(default_data));
    rtc_store_write(&rtc_data_b, default_data, sizeof(default_data));
}
  • 恢复后，设备以默认参数启动，并记录错误日志（如写入NVS）。

4. 完整示例：休眠唤醒计数器

以下代码演示在深度睡眠中保存唤醒次数，并校验恢复。

#include <string.h>
#include "esp_sleep.h"
#include "esp_crc.h"
#include "nvs_flash.h"

typedef struct {
    uint32_t magic;
    uint32_t crc;
    uint32_t wake_count;
} rtc_store_t;

RTC_DATA_ATTR rtc_store_t rtc_a;
RTC_DATA_ATTR rtc_store_t rtc_b;

#define MAGIC 0x12345678

void write_store(rtc_store_t *store, uint32_t count) {
    store->magic = MAGIC;
    store->wake_count = count;
    store->crc = esp_crc32_le(0, (uint8_t*)store, offsetof(rtc_store_t, crc));
}

bool validate_store(const rtc_store_t *store) {
    if (store->magic != MAGIC) return false;
    uint32_t crc = esp_crc32_le(0, (uint8_t*)store, offsetof(rtc_store_t, crc));
    return crc == store->crc;
}

void app_main() {
    // 初始化NVS（用于日志）
    nvs_flash_init();

    uint32_t count = 0;
    if (validate_store(&rtc_a)) {
        count = rtc_a.wake_count;
    } else if (validate_store(&rtc_b)) {
        count = rtc_b.wake_count;
        // 修复A区
        write_store(&rtc_a, count);
    } else {
        // 双区损坏，恢复默认
        count = 0;
        write_store(&rtc_a, count);
        write_store(&rtc_b, count);
    }

    count++;
    write_store(&rtc_a, count);
    write_store(&rtc_b, count);

    printf("Wake count: %lu\n", count);

    // 进入深度睡眠10秒
    esp_sleep_enable_timer_wakeup(10 * 1000000);
    esp_deep_sleep_start();
}

5. 注意事项

  • RTC内存容量有限：ESP32-C3的RTC内存约8KB，设计数据结构时需控制大小，避免溢出。
  • CRC计算范围：务必排除crc字段本身，否则计算值依赖自身导致错误。
  • 原子性：写入RTC内存时，建议先关闭中断，防止写入过程中被唤醒打断。
  • 电源稳定性：在掉电瞬间写入RTC内存可能失败，建议在检测到低电压时提前保存。
  • 测试覆盖：模拟数据损坏（如手动修改RTC内存值）验证恢复逻辑。

6. 总结

通过CRC32校验和双区备份，可以显著提升ESP32-C3低功耗模式下RTC内存数据的可靠性。该策略实现简单、开销极小，适合资源受限的嵌入式场景。开发者可根据实际需求扩展数据结构，并加入日志记录以便远程诊断。