单片机与物联网 / 系统课时
Flash 参数存储
Flash 参数存储
本课解决设备断电后配置丢失的问题:利用 STM32 片内 Flash 保存参数,并通过固定记录格式、完整性校验和默认值回退,让配置在重启后仍可可靠恢复。
学习目标
- 说明 Flash 擦除、编程和寿命限制
- 设计包含版本号与 CRC 的参数记录
- 实现参数读取、写入、校验和默认值回退
Flash 为什么不能当普通变量写
片内 Flash 断电后仍保留数据,但它不是可随意覆盖的 RAM。编程操作通常只能把位从 1 改成 0;要把 0 恢复为 1,必须先按页或扇区整体擦除。擦除粒度远大于单个参数,因此每次修改一个字段也可能需要重写整个参数区。
Flash 还有有限擦写寿命。按钮抖动、周期任务或通信报文若直接触发写入,会迅速增加磨损。可靠做法是只在参数确实变化时保存,并通过延迟合并、日志式存储或磨损均衡降低擦写频率。
参数记录设计
不要只把配置结构体原样写入 Flash。一个可维护的记录至少应包含固定标识、格式版本、数据长度、参数内容和 CRC。读取时先检查结构是否匹配,再校验内容是否损坏;任一检查失败都回退到默认值。

格式版本用于处理固件升级后的结构变化,数据长度可阻止旧固件误读新结构,CRC 用于发现掉电、越界写入或存储单元异常造成的数据损坏。CRC 只能检测错误,不能替代双备份或掉电保护。
读取与写入实现
下面是基于 STM32F4 HAL 的片段示例,使用最后一个 128 KB 扇区保存一条参数记录。它依赖 CubeMX 生成的 HAL 工程,并要求链接脚本没有把程序或常量放入 0x08060000 所在扇区。其他 STM32 系列需按参考手册替换擦除单元、地址和编程宽度。
#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, §or_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);
}
}预期结果
首次启动:记录校验失败,加载默认参数,将 brightness 改为 80 后写入一次。
再次复位:FlashParam_Read 返回 FLASH_PARAM_OK,读取到 brightness=80。
参数未变化:不再次擦除或编程 Flash。实际串口日志格式取决于工程中的打印函数;示例展示的是应观察到的状态变化。
上电加载与更新策略
上电时先读 Flash,校验成功就加载记录,失败则使用编译期默认值。默认值应立即投入运行,但是否马上回写要结合产品需求决定:频繁上电或供电不稳的设备可以等系统稳定后再写,避免启动阶段反复擦除。
参数更新时先比较新旧值。只有发生变化且通过范围检查后,才设置“待保存”标志;主循环在一段安静时间后统一写入。不要在中断服务函数里执行擦除或编程,因为操作耗时较长,且单 Bank 器件在写 Flash 时可能暂停取指。
可靠性边界
量产设计至少还要处理三类边界。第一,参数区必须在链接脚本中明确保留,防止固件增长后覆盖存储区域。第二,写入期间掉电可能留下半条记录,关键参数应使用 A/B 双槽、序号和“先写数据后写有效标志”的提交顺序。第三,写入前要确认电压稳定,并结合看门狗超时评估最坏擦除时间。
调试时不要反复下载包含整片擦除的固件后判断参数“没有保存”。应确认下载器的擦除策略,并用断点或内存窗口检查参数地址中的 Magic、版本和 CRC 是否一致。