单片机与物联网 / 系统课时

Flash 与 EEPROM 数据保存

Flash 与 EEPROM 数据保存

单片机掉电后,RAM 中的参数会消失。本课将围绕“如何可靠保存配置”建立一套可落地的方法:先区分 Flash 与 EEPROM 的擦写特性,再设计带版本号、序号和校验值的数据记录,最后用双槽策略降低掉电中断写入造成的数据损坏风险。

学习目标

  • 理解 Flash 与 EEPROM 在擦除粒度、写入方向和寿命方面的差异。
  • 设计包含有效标记、版本、序号和 CRC 的参数记录。
  • 使用双槽轮换完成写入、读取和掉电恢复。

为什么不能直接覆盖参数

内部 Flash 通常按页擦除、按半字或字编程。未擦除时,位只能从 1 写成 0;要把 0 恢复为 1,必须先擦除整页。EEPROM 更适合小数据随机改写,但许多 MCU 没有独立 EEPROM,只能使用 Flash 仿真。

对比项 Flash EEPROM
擦除粒度 页或扇区 字节或小页
写入前提 常需先擦除 通常可直接更新
单次容量 较大 较小
典型用途 程序、批量参数、日志 少量高频参数
主要风险 页擦除、掉电、磨损集中 写入寿命、写入时间

Flash 参数双槽保存与恢复流程

可靠数据记录的组成

一条可恢复的数据记录至少应包含以下信息:

  • magic:判断该区域是否曾被本程序初始化。
  • version:支持结构升级,避免旧固件误读新格式。
  • sequence:判断多个有效副本中哪一个更新。
  • payload:真正需要保存的参数。
  • crc:检测写入中断、地址错误和随机位翻转。

读取时不能只检查 magic。正确顺序是先检查固定字段,再验证版本和长度,最后重新计算 CRC。两个槽都有效时选择 sequence 较大的记录;新记录验证成功后,旧记录才允许擦除。

完整可运行示例

下面的 C 程序模拟两个 Flash 槽。它先写入两条记录,再故意破坏较新的记录,最后验证加载器是否能回退到旧记录。保存为 flash_record_demo.c。

c
#include <inttypes.h>
#include <stdint.h>
#include <stdio.h>
#include <string.h>

#define RECORD_MAGIC 0x50415241u
#define RECORD_VERSION 1u

typedef struct {
    int16_t threshold;
    int16_t offset;
    uint8_t mode;
} Parameters;

typedef struct {
    uint32_t magic;
    uint16_t version;
    uint16_t reserved;
    uint32_t sequence;
    Parameters params;
    uint32_t crc;
} Record;

static uint32_t crc32_update(uint32_t crc, uint8_t data) {
    crc ^= data;
    for (int i = 0; i < 8; ++i) {
        uint32_t mask = (uint32_t)-(int32_t)(crc & 1u);
        crc = (crc >> 1) ^ (0xEDB88320u & mask);
    }
    return crc;
}

static uint32_t crc32_bytes(uint32_t crc, const void *data, size_t length) {
    const uint8_t *bytes = data;
    for (size_t i = 0; i < length; ++i) {
        crc = crc32_update(crc, bytes[i]);
    }
    return crc;
}

static uint32_t record_crc(const Record *record) {
    uint32_t crc = 0xFFFFFFFFu;
    crc = crc32_bytes(crc, &record->magic, sizeof(record->magic));
    crc = crc32_bytes(crc, &record->version, sizeof(record->version));
    crc = crc32_bytes(crc, &record->reserved, sizeof(record->reserved));
    crc = crc32_bytes(crc, &record->sequence, sizeof(record->sequence));
    crc = crc32_bytes(crc, &record->params.threshold, sizeof(record->params.threshold));
    crc = crc32_bytes(crc, &record->params.offset, sizeof(record->params.offset));
    crc = crc32_bytes(crc, &record->params.mode, sizeof(record->params.mode));
    return crc ^ 0xFFFFFFFFu;
}

static Record make_record(uint32_t sequence, Parameters params) {
    Record record;
    memset(&record, 0, sizeof(record));
    record.magic = RECORD_MAGIC;
    record.version = RECORD_VERSION;
    record.sequence = sequence;
    record.params = params;
    record.crc = record_crc(&record);
    return record;
}

static int is_valid(const Record *record) {
    return record->magic == RECORD_MAGIC &&
           record->version == RECORD_VERSION &&
           record->crc == record_crc(record);
}

static const Record *select_latest(const Record *a, const Record *b) {
    int a_valid = is_valid(a);
    int b_valid = is_valid(b);

    if (a_valid && b_valid) {
        return a->sequence >= b->sequence ? a : b;
    }
    if (a_valid) {
        return a;
    }
    if (b_valid) {
        return b;
    }
    return NULL;
}

int main(void) {
    Record slot_a = make_record(1u, (Parameters){120, -3, 2});
    Record slot_b = make_record(2u, (Parameters){135, -2, 3});

    /* 模拟新记录写入过程中掉电,导致内容与 CRC 不一致。 */
    slot_b.params.threshold ^= 1;

    printf("slotA valid=%d seq=%" PRIu32 "\n", is_valid(&slot_a), slot_a.sequence);
    printf("slotB valid=%d seq=%" PRIu32 "\n", is_valid(&slot_b), slot_b.sequence);

    const Record *loaded = select_latest(&slot_a, &slot_b);
    if (loaded == NULL) {
        puts("no valid record");
        return 1;
    }

    printf("loaded threshold=%d offset=%d mode=%u\n",
           loaded->params.threshold,
           loaded->params.offset,
           loaded->params.mode);
    return 0;
}

使用 GCC 编译并运行:

bash
gcc -std=c11 -Wall -Wextra -O2 flash_record_demo.c -o flash_record_demo
./flash_record_demo

预期输出:

text
slotA valid=1 seq=1
slotB valid=0 seq=2
loaded threshold=120 offset=-3 mode=2

在 STM32F1 工程中,可将“写槽”映射为 HAL_FLASH_Unlock、页擦除、HAL_FLASH_Program 和 HAL_FLASH_Lock。必须先完整写入新槽并回读校验,不能先擦除唯一有效槽。具体编程宽度和页大小应以芯片参考手册与链接脚本为准。

写入、读取与更新流程

首次启动时,如果两个槽都无效,应加载编译期默认值,并在业务稳定后写入第一条记录。正常更新时,先选择非当前槽,必要时擦除其所在页,再写入新记录。写完后回读并校验 CRC;只有校验成功,才把新槽视为当前版本。

频繁变化的数据不要每次修改都立即写 Flash。可以设置“脏标记”,在参数停止变化一段时间后再提交,或累计到固定周期写入。计数器、运行时长等高频数据应采用日志式追加、磨损均衡或外部 EEPROM。

Tips 与常见故障

  • 把参数区放到链接脚本明确保留的 Flash 页,避免固件升级覆盖。
  • 写入前检查供电稳定性;需要时用欠压复位或掉电检测阻止低电压编程。
  • 结构体直接写入会受到填充字节、大小端和版本变化影响,长期格式宜显式序列化。
  • CRC 能发现损坏,但不能保证数据语义正确。范围、枚举值和组合关系仍需单独校验。
  • 若两个槽都无效,不要继续使用未初始化内存,应加载默认值并上报恢复事件。

本课练习

  1. 将示例扩展为三个槽,要求加载器选择有效且 sequence 最大的记录,并验证任意一个槽损坏时仍能恢复。
  2. 为 Parameters 增加 samplePeriodMs 字段,设计从版本 1 迁移到版本 2 的兼容逻辑,并说明旧记录如何转换。

本课总结

  • Flash 擦除粒度大、写入方向受限,不能像 RAM 一样直接覆盖。
  • 可靠记录应同时具备格式标识、版本、递增序号和完整性校验。
  • 双槽轮换的关键是先写新副本并验证,再处理旧副本。

下一课预告

下一课将学习“RTC 实时时钟”,配置低速时钟源和备份域,并实现时间设置、读取以及掉电后的状态保持。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

Flash 与 EEPROM 数据保存

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通