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

Flash 参数存储

Flash 参数存储

本课解决设备断电后配置丢失的问题:利用 STM32 片内 Flash 保存参数,并通过固定记录格式、完整性校验和默认值回退,让配置在重启后仍可可靠恢复。

学习目标

  • 说明 Flash 擦除、编程和寿命限制
  • 设计包含版本号与 CRC 的参数记录
  • 实现参数读取、写入、校验和默认值回退

Flash 为什么不能当普通变量写

片内 Flash 断电后仍保留数据,但它不是可随意覆盖的 RAM。编程操作通常只能把位从 1 改成 0;要把 0 恢复为 1,必须先按页或扇区整体擦除。擦除粒度远大于单个参数,因此每次修改一个字段也可能需要重写整个参数区。

Flash 还有有限擦写寿命。按钮抖动、周期任务或通信报文若直接触发写入,会迅速增加磨损。可靠做法是只在参数确实变化时保存,并通过延迟合并、日志式存储或磨损均衡降低擦写频率。

参数记录设计

不要只把配置结构体原样写入 Flash。一个可维护的记录至少应包含固定标识、格式版本、数据长度、参数内容和 CRC。读取时先检查结构是否匹配,再校验内容是否损坏;任一检查失败都回退到默认值。

Flash 参数记录与校验流程

格式版本用于处理固件升级后的结构变化,数据长度可阻止旧固件误读新结构,CRC 用于发现掉电、越界写入或存储单元异常造成的数据损坏。CRC 只能检测错误,不能替代双备份或掉电保护。

读取与写入实现

下面是基于 STM32F4 HAL 的片段示例,使用最后一个 128 KB 扇区保存一条参数记录。它依赖 CubeMX 生成的 HAL 工程,并要求链接脚本没有把程序或常量放入 0x08060000 所在扇区。其他 STM32 系列需按参考手册替换擦除单元、地址和编程宽度。

c
#include "stm32f4xx_hal.h"
#include <stddef.h>
#include <stdint.h>
#include <string.h>

#define PARAM_FLASH_ADDRESS  0x08060000U
#define PARAM_FLASH_SECTOR   FLASH_SECTOR_7
#define PARAM_MAGIC          0x50415241U
#define PARAM_VERSION        1U

typedef struct {
    uint16_t brightness;
    uint16_t sample_period_ms;
    uint32_t baud_rate;
} AppConfig;

typedef struct {
    uint32_t magic;
    uint16_t version;
    uint16_t length;
    AppConfig config;
    uint32_t crc32;
} FlashRecord;

typedef enum {
    FLASH_PARAM_OK = 0,
    FLASH_PARAM_INVALID,
    FLASH_PARAM_ERASE_ERROR,
    FLASH_PARAM_PROGRAM_ERROR,
    FLASH_PARAM_VERIFY_ERROR
} FlashParamStatus;

static uint32_t Crc32_Calculate(const uint8_t *data, size_t length)
{
    uint32_t crc = 0xFFFFFFFFU;

    for (size_t i = 0; i < length; ++i) {
        crc ^= data[i];
        for (uint32_t bit = 0; bit < 8U; ++bit) {
            uint32_t mask = (uint32_t)-(int32_t)(crc & 1U);
            crc = (crc >> 1U) ^ (0xEDB88320U & mask);
        }
    }
    return ~crc;
}

static AppConfig AppConfig_Default(void)
{
    AppConfig config = {
        .brightness = 50U,
        .sample_period_ms = 1000U,
        .baud_rate = 115200U
    };
    return config;
}

FlashParamStatus FlashParam_Read(AppConfig *config)
{
    const FlashRecord *record = (const FlashRecord *)PARAM_FLASH_ADDRESS;
    const size_t payload_size = offsetof(FlashRecord, crc32);

    if (config == NULL ||
        record->magic != PARAM_MAGIC ||
        record->version != PARAM_VERSION ||
        record->length != sizeof(AppConfig)) {
        return FLASH_PARAM_INVALID;
    }

    uint32_t actual_crc = Crc32_Calculate(
        (const uint8_t *)record,
        payload_size
    );
    if (actual_crc != record->crc32) {
        return FLASH_PARAM_INVALID;
    }

    *config = record->config;
    return FLASH_PARAM_OK;
}

FlashParamStatus FlashParam_Write(const AppConfig *config)
{
    if (config == NULL) {
        return FLASH_PARAM_INVALID;
    }

    FlashRecord record = {
        .magic = PARAM_MAGIC,
        .version = PARAM_VERSION,
        .length = sizeof(AppConfig),
        .config = *config,
        .crc32 = 0U
    };
    record.crc32 = Crc32_Calculate(
        (const uint8_t *)&record,
        offsetof(FlashRecord, crc32)
    );

    FLASH_EraseInitTypeDef erase = {0};
    uint32_t sector_error = 0U;
    erase.TypeErase = FLASH_TYPEERASE_SECTORS;
    erase.VoltageRange = FLASH_VOLTAGE_RANGE_3;
    erase.Sector = PARAM_FLASH_SECTOR;
    erase.NbSectors = 1U;

    HAL_FLASH_Unlock();

    if (HAL_FLASHEx_Erase(&erase, &sector_error) != HAL_OK) {
        HAL_FLASH_Lock();
        return FLASH_PARAM_ERASE_ERROR;
    }

    const uint32_t *words = (const uint32_t *)&record;
    const size_t word_count = sizeof(record) / sizeof(uint32_t);

    for (size_t i = 0; i < word_count; ++i) {
        uint32_t address = PARAM_FLASH_ADDRESS + (uint32_t)(i * 4U);
        if (HAL_FLASH_Program(
                FLASH_TYPEPROGRAM_WORD,
                address,
                words[i]) != HAL_OK) {
            HAL_FLASH_Lock();
            return FLASH_PARAM_PROGRAM_ERROR;
        }
    }

    HAL_FLASH_Lock();

    if (memcmp((const void *)PARAM_FLASH_ADDRESS,
               &record,
               sizeof(record)) != 0) {
        return FLASH_PARAM_VERIFY_ERROR;
    }
    return FLASH_PARAM_OK;
}

void FlashParam_Demo(void)
{
    AppConfig config;
    uint8_t need_save = 0U;

    if (FlashParam_Read(&config) != FLASH_PARAM_OK) {
        config = AppConfig_Default();
        need_save = 1U;
    }

    if (config.brightness != 80U) {
        config.brightness = 80U;
        need_save = 1U;
    }

    if (need_save != 0U) {
        (void)FlashParam_Write(&config);
    }
}

预期结果

text
首次启动:记录校验失败,加载默认参数,将 brightness 改为 80 后写入一次。
再次复位:FlashParam_Read 返回 FLASH_PARAM_OK,读取到 brightness=80。
参数未变化:不再次擦除或编程 Flash。

实际串口日志格式取决于工程中的打印函数;示例展示的是应观察到的状态变化。

上电加载与更新策略

上电时先读 Flash,校验成功就加载记录,失败则使用编译期默认值。默认值应立即投入运行,但是否马上回写要结合产品需求决定:频繁上电或供电不稳的设备可以等系统稳定后再写,避免启动阶段反复擦除。

参数更新时先比较新旧值。只有发生变化且通过范围检查后,才设置“待保存”标志;主循环在一段安静时间后统一写入。不要在中断服务函数里执行擦除或编程,因为操作耗时较长,且单 Bank 器件在写 Flash 时可能暂停取指。

可靠性边界

量产设计至少还要处理三类边界。第一,参数区必须在链接脚本中明确保留,防止固件增长后覆盖存储区域。第二,写入期间掉电可能留下半条记录,关键参数应使用 A/B 双槽、序号和“先写数据后写有效标志”的提交顺序。第三,写入前要确认电压稳定,并结合看门狗超时评估最坏擦除时间。

调试时不要反复下载包含整片擦除的固件后判断参数“没有保存”。应确认下载器的擦除策略,并用断点或内存窗口检查参数地址中的 Magic、版本和 CRC 是否一致。

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

目录与阅读设置

阅读设置

17

记录一个想法

Flash 参数存储

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

登录哪都通