1. 项目概述
在嵌入式系统开发中，数据持久化存储是一个基础但至关重要的功能。STM32系列微控制器提供了多种数据存储方案，其中片内EEPROM和Flash存储是最常用的两种方式。本文将深入探讨如何在FreeRTOS环境下使用HAL库对STM32的片内EEPROM和Flash进行高效、安全的数据读写操作。
2. 存储基础知识
2.1 存储单位与容量
在嵌入式系统中，理解存储单位是基础中的基础：
- 1字节(Byte) = 8位(bit)
- 1千字节(KB) = 1024字节
- 1兆字节(MB) = 1024千字节
- 1吉字节(GB) = 1024兆字节
- 1太字节(TB) = 1024吉字节
以常见的STM32F103C8T6为例，其内部Flash容量为64KB，即64×1024=65536字节。这个容量对于大多数嵌入式应用来说已经足够。
2.2 STM32存储结构
STM32F1系列芯片根据容量可分为三类：
| 容量范围 | 芯片型号示例 | Flash大小 | 实际字节数 |
|---|---|---|---|
| 小容量 | STM32F103C8T6 | 64KB | 65536字节 |
| STM32F103RCT6 | 256KB | 262144字节 | |
| 中容量 | STM32F103RBT6 | 128KB | 131072字节 |
| STM32F103RET6 | 512KB | 524288字节 | |
| 大容量 | STM32F103VET6 | 512KB | 524288字节 |
| STM32F103ZET6 | 1024KB | 1048576字节 |
3. Flash存储详解
3.1 Flash扇区划分
STM32内部Flash被划分为多个扇区，不同容量的芯片扇区大小不同：
- 64KB Flash：1KB/扇区，地址范围0x08000000-0x08010000
- 128KB Flash：1KB/扇区，地址范围0x08000000-0x08020000
- 256KB Flash：2KB/扇区，地址范围0x08000000-0x08040000
- 512KB Flash：2KB/扇区，地址范围0x08000000-0x08080000
以STM32F103C8T6(64KB)为例，其扇区划分如下：
| 扇区编号 | 起始地址 | 结束地址 | 大小 |
|---|---|---|---|
| 扇区0 | 0x08000000 | 0x080003FF | 1KB |
| 扇区1 | 0x08000400 | 0x080007FF | 1KB |
| ... | ... | ... | ... |
| 扇区63 | 0x0800FC00 | 0x0800FFFF | 1KB |
3.2 Flash操作注意事项
- 写操作前必须先擦除：Flash只能将1变为0，不能将0变为1。因此写入前必须擦除整个扇区(全部变为1)
- 擦除操作以扇区为单位：不能单独擦除某个字节或字
- 写入操作以半字(16位)、字(32位)或双字(64位)为单位
- 操作期间不能执行Flash中的代码，因此操作代码最好在RAM中运行
4. 片内EEPROM操作
4.1 EEPROM基本特性
STM32的部分系列(如L系列)内置了真正的EEPROM，其主要特点：
- 不需要外设支持，是片内资源
- 可以按字节读写，不需要先擦除
- 擦写寿命通常为10万次以上
- 不需要CubeMX配置，直接调用库函数即可使用
4.2 EEPROM基本操作步骤
EEPROM的基本操作分为三步：
- 解锁：
HAL_FLASHEx_DATAEEPROM_Unlock() - 写入数据：
HAL_FLASHEx_DATAEEPROM_Program() - 上锁：
HAL_FLASHEx_DATAEEPROM_Lock()
注意：虽然不上锁也能工作，但建议每次操作后上锁，以防止意外写入。
4.3 EEPROM读写示例
写入单个字节：
c复制HAL_FLASHEx_DATAEEPROM_Unlock();
HAL_FLASHEx_DATAEEPROM_Program(FLASH_TYPEPROGRAMDATA_BYTE,
DATA_EEPROM_BASE+0x00,
233); // 写入值233到地址0x00
HAL_FLASHEx_DATAEEPROM_Lock();
读取单个字节：
c复制uint8_t data = *(uint8_t *)(DATA_EEPROM_BASE+0x00);
写入结构体：
c复制struct {
double input_wh;
double output_mah;
} eeprom_data;
HAL_FLASHEx_DATAEEPROM_Unlock();
for (uint8_t i = 0; i < sizeof(eeprom_data); i++) {
HAL_FLASHEx_DATAEEPROM_Program(FLASH_TYPEPROGRAMDATA_BYTE,
DATA_EEPROM_BASE+i,
*(((uint8_t *)&eeprom_data)+i));
}
HAL_FLASHEx_DATAEEPROM_Lock();
读取结构体：
c复制for (uint8_t i = 0; i < sizeof(eeprom_data); i++) {
*(((uint8_t *)&eeprom_data)+i) = *(uint8_t *)(DATA_EEPROM_BASE+i);
}
5. Flash模拟EEPROM
对于没有内置EEPROM的STM32型号(如F1系列)，可以使用部分Flash来模拟EEPROM功能。
5.1 实现原理
- 选择一个不常用的Flash扇区作为"模拟EEPROM"区域
- 实现类似EEPROM的读写接口
- 通过软件管理擦写次数和磨损均衡
5.2 实现步骤
- 定义模拟EEPROM区域：
c复制#define EEPROM_START_ADDR 0x0800F000 // 使用最后一个扇区
#define EEPROM_SIZE 1024 // 1KB
- 擦除函数：
c复制void EEPROM_Erase(void) {
FLASH_EraseInitTypeDef EraseInitStruct;
uint32_t SectorError = 0;
HAL_FLASH_Unlock();
EraseInitStruct.TypeErase = FLASH_TYPEERASE_PAGES;
EraseInitStruct.PageAddress = EEPROM_START_ADDR;
EraseInitStruct.NbPages = 1;
HAL_FLASHEx_Erase(&EraseInitStruct, &SectorError);
HAL_FLASH_Lock();
}
- 写入函数：
c复制HAL_StatusTypeDef EEPROM_Write(uint32_t addr, uint64_t data) {
if(addr >= EEPROM_SIZE) return HAL_ERROR;
HAL_FLASH_Unlock();
if(HAL_FLASH_Program(FLASH_TYPEPROGRAM_DOUBLEWORD,
EEPROM_START_ADDR + addr,
data) != HAL_OK) {
HAL_FLASH_Lock();
return HAL_ERROR;
}
HAL_FLASH_Lock();
return HAL_OK;
}
- 读取函数：
c复制uint64_t EEPROM_Read(uint32_t addr) {
if(addr >= EEPROM_SIZE) return 0;
return *(uint64_t *)(EEPROM_START_ADDR + addr);
}
6. FreeRTOS中的安全操作
在FreeRTOS环境下操作Flash或EEPROM时，需要考虑多任务环境下的安全性。
6.1 互斥保护
由于Flash/EEPROM操作不是原子性的，在多任务环境中需要互斥保护：
c复制SemaphoreHandle_t xFlashMutex;
// 创建互斥量
xFlashMutex = xSemaphoreCreateMutex();
// 使用互斥量保护Flash操作
if(xSemaphoreTake(xFlashMutex, portMAX_DELAY) == pdTRUE) {
// 执行Flash/EEPROM操作
xSemaphoreGive(xFlashMutex);
}
6.2 任务优先级考虑
Flash操作期间会阻塞CPU，因此：
- 避免在高优先级任务中执行长时间Flash操作
- 考虑将Flash操作放在低优先级任务中
- 必要时挂起调度器：
vTaskSuspendAll()
7. 数据校验与错误处理
7.1 校验方法
- CRC校验：为数据添加CRC校验码
- 双备份存储：存储两份数据，读取时比较
- 写后验证：写入后立即读取验证
7.2 CRC校验实现示例
c复制uint32_t Calculate_CRC32(const uint8_t *data, size_t length) {
uint32_t crc = 0xFFFFFFFF;
for(size_t i = 0; i < length; i++) {
crc ^= data[i];
for(uint8_t j = 0; j < 8; j++) {
crc = (crc >> 1) ^ (0xEDB88320 & -(crc & 1));
}
}
return ~crc;
}
void Write_With_CRC(uint32_t addr, void *data, size_t length) {
uint32_t crc = Calculate_CRC32(data, length);
// 写入数据
// 写入CRC
}
int Read_With_CRC(uint32_t addr, void *data, size_t length) {
// 读取数据
// 读取CRC
uint32_t crc_calc = Calculate_CRC32(data, length);
if(crc_calc != crc_read) {
// 校验失败处理
return -1;
}
return 0;
}
8. 性能优化技巧
- 批量写入：尽量减少擦写次数，批量写入数据
- 缓存机制：在RAM中缓存频繁访问的数据
- 磨损均衡：对于Flash模拟EEPROM，实现简单的磨损均衡算法
- 数据压缩：对大容量数据考虑压缩存储
9. 常见问题与解决方案
9.1 写入失败
可能原因：
- 未解锁Flash/EEPROM
- 地址超出范围
- 电压不稳定
解决方案：
- 检查解锁流程
- 验证地址有效性
- 确保供电稳定
9.2 数据损坏
可能原因：
- 写入过程中断电
- 电磁干扰
- 擦写次数超过限制
解决方案：
- 实现双备份存储
- 添加校验机制
- 监控擦写次数
9.3 性能瓶颈
可能原因：
- 频繁擦写
- 大块数据操作
解决方案：
- 优化写入策略
- 使用DMA加速数据传输
10. 实际应用案例
10.1 系统参数存储
c复制typedef struct {
uint32_t serial_number;
float calibration_factor;
uint8_t device_name[16];
uint32_t crc;
} SystemParams;
void SaveSystemParams(SystemParams *params) {
params->crc = Calculate_CRC32((uint8_t *)params, sizeof(SystemParams)-4);
HAL_FLASHEx_DATAEEPROM_Unlock();
for(uint16_t i=0; i<sizeof(SystemParams); i++) {
HAL_FLASHEx_DATAEEPROM_Program(FLASH_TYPEPROGRAMDATA_BYTE,
DATA_EEPROM_BASE+i,
*((uint8_t *)params + i));
}
HAL_FLASHEx_DATAEEPROM_Lock();
}
int LoadSystemParams(SystemParams *params) {
for(uint16_t i=0; i<sizeof(SystemParams); i++) {
*((uint8_t *)params + i) = *(uint8_t *)(DATA_EEPROM_BASE+i);
}
uint32_t crc_calc = Calculate_CRC32((uint8_t *)params, sizeof(SystemParams)-4);
if(crc_calc != params->crc) {
return -1; // 校验失败
}
return 0;
}
10.2 运行日志存储
对于需要记录运行日志的应用，可以设计循环缓冲区结构：
c复制#define LOG_ENTRY_SIZE 64
#define LOG_ENTRY_COUNT 32
typedef struct {
uint32_t timestamp;
uint8_t log_level;
char message[56];
uint32_t crc;
} LogEntry;
void WriteLogEntry(LogEntry *entry) {
static uint16_t log_index = 0;
uint32_t base_addr = EEPROM_START_ADDR + (log_index * LOG_ENTRY_SIZE);
entry->crc = Calculate_CRC32((uint8_t *)entry, LOG_ENTRY_SIZE-4);
// 写入日志条目
// ...
log_index = (log_index + 1) % LOG_ENTRY_COUNT;
}
11. 高级话题：Flash模拟EEPROM的磨损均衡
对于需要频繁写入且没有真正EEPROM的芯片，实现简单的磨损均衡可以延长Flash寿命。
11.1 基本思路
- 将模拟EEPROM区域划分为多个块
- 记录每个块的擦写次数
- 选择擦写次数最少的块进行新数据写入
11.2 简单实现
c复制#define BLOCK_SIZE 256
#define BLOCK_COUNT 4
typedef struct {
uint32_t write_count;
uint8_t data[BLOCK_SIZE-4];
} EEPROM_Block;
void WearLeveling_Write(uint32_t addr, uint8_t *data, uint32_t size) {
// 1. 查找写入次数最少的块
uint32_t min_count = 0xFFFFFFFF;
uint32_t target_block = 0;
for(uint32_t i=0; i<BLOCK_COUNT; i++) {
EEPROM_Block block;
ReadBlock(i, &block);
if(block.write_count < min_count) {
min_count = block.write_count;
target_block = i;
}
}
// 2. 更新数据并增加写入计数
EEPROM_Block new_block;
memcpy(new_block.data, data, size);
new_block.write_count = min_count + 1;
// 3. 写入新块
WriteBlock(target_block, &new_block);
}
12. 调试技巧
- 内存查看器：使用IDE的内存查看功能直接查看Flash/EEPROM内容
- 写入验证：每次写入后立即读取验证
- 边界测试：特别测试边界地址的读写
- 压力测试：模拟频繁擦写测试长期稳定性
13. 安全注意事项
- 关键数据备份：对重要参数实现双备份存储
- 写保护：必要时启用Flash写保护功能
- 操作原子性：确保多字节写入的原子性，避免部分写入
- 异常处理：考虑电源故障等异常情况的恢复机制
14. 性能对比：EEPROM vs Flash
| 特性 | 片内EEPROM | Flash模拟EEPROM |
|---|---|---|
| 擦写寿命 | 10万-100万次 | 约1万次 |
| 擦除单位 | 字节 | 扇区 |
| 写入速度 | 较快 | 较慢(需先擦除) |
| 使用复杂度 | 简单 | 较复杂 |
| 可靠性 | 高 | 中 |
| 适用场景 | 频繁小数据量写入 | 不频繁的大数据量写入 |
15. 最佳实践建议
- 数据分类存储：根据数据特性选择合适的存储介质
- 最小化写入：减少不必要的写入操作
- 定期维护：实现数据完整性检查和修复机制
- 文档记录：详细记录存储结构和地址分配
- 版本兼容：考虑数据结构的版本兼容性
在实际项目中，我通常会为每个存储的数据项定义明确的地址映射表：
c复制typedef enum {
PARAM_SERIAL_NUMBER = 0x00, // 4 bytes
PARAM_CALIBRATION = 0x04, // 4 bytes float
PARAM_DEVICE_NAME = 0x08, // 16 bytes
// ...
} EEPROM_Params;
这种明确的地址映射可以避免后续开发中的混乱，也便于团队协作。