EasyFlash是一款开源的轻量级嵌入式Flash存储器库，非常适合智能家居、可穿戴、工控、医疗、物联网等需要断电存储功能的产品，资源占用极低，并且支持各种 MCU 片上存储器。

之所以将其移植到 robomaste-C 型开发板上，是为了存储重要日志，以及在正常运行情况下存储重要数据用于调试分析，尽量减小 debug 环境下对系统行为的影响。目前该开发板已经支持 easyflash ，进入 menucofig 中使能即可，main 函数中会进行初始化。（不需要使用 easyflash 时，一定要记得关闭该功能，Flash 的擦除次数有限）

robomaster C 板使用芯片 STM32F407IGH6 片上搭载 1MB Flash，具体参数如下所示：

对接要点

对接的具体流程就不详细描述了，有很多大佬成功移植的教程，项目仓库中也有丰富的相关文档。这里记录对接要点，以及需要注意的一些坑。

因为使用的是 STM32F407 1MB 的片上 Flash， 直接使用 HAL 库的相关 API，需要引用 Incstm32f4xx_hal_flash.h、 Incstm32f4xx_hal_flash_ex.h 这两个头文件；

对接时需要 Flash 的具体参数如，开始地址，操作粒度等，这些参数需要了解清楚，文章前面的图片中也可以读出；

可以搭配 STM32 ST-LINK Utility 工具查看 Flash 存储情况，擦除后全为 0xffffffff；
擦除和写入 Flash 时，需要先解锁 Flash，操作完之后再上锁；
HAL_FLASH_Program()函数对于不同芯片的HAL库，入参也不甚相同，有的芯片可以按1字节、2字节、4字节、8字节写入，比如STM32F407，有的芯片只能按8字节写入，比如STM32L4。同时，Flash写入时要注意字节对齐；

很多博客都是关于 F1 移植的，F4 和 F1 的是有区别的，而且网上大部分使用 HAL 都是 2016 年的，现在 HAL 以及更新过，并且相关 API 有变动，可以参考我的具体实现：

EfErrCode ef_port_erase(uint32_t addr, size_t size) {
EfErrCode result = EF_NO_ERR;
FLASH_Status flash_status;
size_t erased_size = 0;
uint32_t cur_erase_sector;
/* make sure the start address is a multiple of EF_ERASE_MIN_SIZE /
EF_ASSERT(addr % EF_ERASE_MIN_SIZE == 0);
/ start erase /
FLASH_Unlock();
FLASH_ClearFlag(FLASH_FLAG_EOP | FLASH_FLAG_OPERR | FLASH_FLAG_WRPERR | FLASH_FLAG_PGAERR
| FLASH_FLAG_PGPERR | FLASH_FLAG_PGSERR);
/ it will stop when erased size is greater than setting size */
while(erased_size < size) {
cur_erase_sector = stm32_get_sector(addr + erased_size);
flash_status = FLASH_EraseSector(cur_erase_sector, VoltageRange_3);
if (flash_status != FLASH_COMPLETE) {
result = EF_ERASE_ERR;
break;
}
erased_size += stm32_get_sector_size(cur_erase_sector);
}
FLASH_Lock();
return result;
}
EfErrCode ef_port_write(uint32_t addr, const uint32_t *buf, size_t size) {
EfErrCode result = EF_NO_ERR;
size_t i;
uint32_t read_data;
uint8_t *buf_8 = (uint8_t )buf;
FLASH_Unlock();
FLASH_ClearFlag(
FLASH_FLAG_EOP | FLASH_FLAG_OPERR | FLASH_FLAG_WRPERR | FLASH_FLAG_PGAERR | FLASH_FLAG_PGPERR
| FLASH_FLAG_PGSERR);
for (i = 0; i < size; i++, buf_8++, addr++)
{
/ write data */
FLASH_ProgramByte(addr, *buf_8);
read_data = *(uint8_t ) addr;
/ check data */
if (read_data != *buf_8) {
result = EF_WRITE_ERR;
break;
}
}
FLASH_Lock();
return result;
}

分区首次使用的话是要擦除一次的，所以第一次报sector header check failed是对的；