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获取最新版EasyFlashgit clone https://github.com/armink/EasyFlash2.3 CubeMX关键配置在CubeMX里需要特别注意这几个配置时钟树把HSE设为8MHzPLL倍频到72MHzUSART1启用异步模式波特率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系列32STM32F4系列8Nor Flash13.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 i0; isize; 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] count1 [区B] 空 更新2: [区A] count1 [区B] count2 更新3: [区A] count3 [区B] count2当任一区写满时会自动迁移到另一区并擦除旧区。实测在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字节。
