STM32HAL 集成 EasyFlash：打造轻量级嵌入式键值存储数据库(裸机开发)
1. 为什么选择EasyFlash作为嵌入式键值存储方案
在嵌入式开发中，数据存储一直是个让人头疼的问题。我做过不少STM32项目，经常遇到需要保存设备参数、运行日志的场景。传统做法要么用EEPROM（容量小、成本高），要么直接操作Flash（容易出错），直到发现了EasyFlash这个神器。
EasyFlash最吸引我的地方是它把Flash变成了一个轻量级键值数据库。你可以像操作Redis那样简单地使用ef_set_env("key","value")和ef_get_env("key")，完全不用关心底层Flash的读写细节。实测在STM32F103C8T6上，存储100组键值对只占用不到3KB内存，这对于资源受限的MCU简直是福音。
它的三大核心功能特别适合物联网设备：
- ENV环境变量：像系统环境变量一样管理设备参数
- 写平衡机制：自动均衡Flash擦写次数，延长芯片寿命
- 掉电保护：意外断电时数据不会丢失
2. 环境搭建与工程配置
2.1 硬件准备清单
我这次用的是最常见的STM32F103C8T6最小系统板（淘宝20块钱那种），你需要准备：
- ST-Link V2下载器
- USB转串口模块（用于打印调试信息）
- 杜邦线若干
2.2 软件环境搭建
- 安装Keil MDK 5.29（记得装STM32F1的Device Family Pack）
- 下载STM32CubeMX 6.0.1
- 从GitHub获取最新版EasyFlash：
git clone https://github.com/armink/EasyFlash2.3 CubeMX关键配置
在CubeMX里需要特别注意这几个配置：
- 时钟树：把HSE设为8MHz，PLL倍频到72MHz
- USART1：启用异步模式，波特率115200（用于调试输出）
- Flash读写保护：一定要取消PCROP和写保护！
生成代码后，在main.c添加串口重定向代码（方便printf调试）：
int fputc(int ch, FILE *f) { HAL_UART_Transmit(&huart1, (uint8_t *)&ch, 1, 100); return ch; }3. EasyFlash移植实战
3.1 文件添加与工程配置
把EasyFlash源码中的这些文件复制到项目：
easyflash/src/ef_env.c easyflash/src/ef_utils.c easyflash/port/ef_port.c easyflash/inc/easyflash.h在Keil里添加分组时有个小技巧：把ef_port.c单独放在"Port"分组，其他源文件放在"EasyFlash"分组。这样结构更清晰，后续换平台时只需替换Port文件。
3.2 关键参数配置
修改ef_cfg.h中的这几个宏定义：
#define EF_ERASE_MIN_SIZE 1024 // F103的页大小是1KB #define EF_WRITE_GRAN 32 // F1系列必须设为32 #define EF_START_ADDR (0x08000000 + 64*1024) // 从64KB地址开始 #define ENV_AREA_SIZE (2*EF_ERASE_MIN_SIZE) // 环境变量区2KB这里有个坑我踩过：EF_WRITE_GRAN一定要按芯片型号设置：
- STM32F1系列：32
- STM32F4系列：8
- Nor Flash：1
3.3 移植接口实现
ef_port.c需要实现四个关键函数：
EfErrCode ef_port_read(uint32_t addr, uint32_t *buf, size_t size) { // 按字节读取Flash内容 uint8_t *buf_8 = (uint8_t *)buf; for(size_t i=0; i<size; i++) { buf_8[i] = *(uint8_t *)(addr + i); } return EF_NO_ERR; } EfErrCode ef_port_erase(uint32_t addr, size_t size) { // 调用HAL库的Flash擦除API HAL_FLASH_Unlock(); FLASH_EraseInitTypeDef erase; erase.TypeErase = FLASH_TYPEERASE_PAGES; erase.PageAddress = addr; erase.NbPages = (size + EF_ERASE_MIN_SIZE -1)/EF_ERASE_MIN_SIZE; uint32_t pageError; if(HAL_FLASHEx_Erase(&erase, &pageError) != HAL_OK) { return EF_ERASE_ERR; } HAL_FLASH_Lock(); return EF_NO_ERR; }4. ENV功能深度使用
4.1 基础CRUD操作
EasyFlash的ENV功能用起来就像个微型数据库：
// 保存WiFi配置 ef_set_env("wifi_ssid", "MyRouter"); ef_set_env("wifi_pwd", "12345678"); // 读取配置 char *ssid = ef_get_env("wifi_ssid"); uint32_t boot_count = atoi(ef_get_env("boot_count")); // 删除配置 ef_del_env("wifi_pwd");4.2 掉电保护实战
我做过一个智能插座项目，要求断电后能记住开关状态。用EasyFlash可以这样实现：
void save_power_state(bool on) { ef_set_env("power_state", on ? "1" : "0"); ef_save_env(); // 立即保存 } bool load_power_state() { char *state = ef_get_env("power_state"); return state && (strcmp(state, "1") == 0); }4.3 写平衡机制解析
EasyFlash通过双存储区轮换实现写平衡。假设我们频繁更新一个计数器：
更新1: [区A] count=1 [区B] 空 更新2: [区A] count=1 [区B] count=2 更新3: [区A] count=3 [区B] count=2当任一区写满时，会自动迁移到另一区并擦除旧区。实测在F103上，1KB的ENV区可以支持10万次以上的写操作。
5. 高级应用与性能优化
5.1 批量操作技巧
当需要保存多个参数时，建议使用批量接口减少Flash操作：
// 批量设置 EfErrCode set_settings() { ef_set_env("brightness", "80"); ef_set_env("volume", "60"); ef_set_env("mode", "auto"); return ef_save_env(); // 只触发一次保存 }5.2 内存优化配置
对于资源紧张的芯片（如STM32F030），可以调整这些配置：
#define EF_ENV_USING_PFS_MODE // 使用更省内存的模式 #define EF_ENV_CACHE_TABLE_SIZE 20 // 减少缓存表大小5.3 故障排查指南
常见问题及解决方法：
- 写入失败：检查Flash解锁和写保护位
- 数据读取异常：确认
EF_WRITE_GRAN设置正确 - HardFault：确保
EF_START_ADDR在合法地址范围内
我在项目中发现一个有趣的现象：如果频繁写入小数据（小于32字节），建议先攒到一定量再写入，因为STM32的Flash写入最小单位是字（4字节）。