定位与 PIC 优势

• 位置无关代码（PIC）：镜像以 -fpic -fpie 编译，不含任何绝对地址假设。主机应用从镜像基址（FLS_DRV_BASE_ADDR）处的函数表中解析每个函数入口，因此二进制可被加载到不同的 SRAM/Flash 地址而无需重新编译。
• 从 SRAM 运行：驱动在 SRAM 中执行，因此可以擦除、编程任意 Flash 区域，包括应用自身所在的区域——这正是 Bootloader/OTA 更新的典型需求。
• 占用极小：整个镜像（函数表 + 代码 + 常量）必须放入 4 KB 链接区域（link/relative.ld）；当前 YTM32B1ME1 构建产物仅约 856 字节。
• 单头文件集成：主机侧只需 fls_drv_bin.h（数组模式下另需生成的 data 头文件）。API 签名遵循 SDK Flash 驱动惯例并返回 status_t，覆盖引导加载所需的核心操作（Init/Deinit、扇区擦除、编程、BootSwap）。它是 SDK 驱动的紧凑子集，并非完整替代品。
• 多芯片一次构建：一次 CMake 调用即可产出全部芯片变体。

注意事项

1. 校验函数表：FLASH_DRV_GetVersion() 应返回 1。否则说明 FLS_DRV_BASE_ADDR 处的镜像不正确（数组未链接，或二进制下载到了错误的 SRAM 地址）。
2. PRESCALER：在 FLASH_DRV_Init() 之前且每次时钟变更后将 EFM CTRL 的 PRESCALER 配置为 flashClockHz / 2,000,000；以目标芯片 SDK/参考手册为准。
3. 对齐：EraseSector 的 dest/size 为扇区大小整数倍；Program 的 dest/size 为 FEATURE_EFM_WRITE_UNIT_SIZE 整数倍且 pData 4 字节对齐。
4. 先擦除再编程：编程前目标区域必须为 0xFF（已擦除）；操作后回读校验。
5. SRAM 模式：FlashDriver.bin 必须实际加载到 FLS_DRV_BASE_ADDR 处；地址错误会在首次 API 调用时导致硬错误（Hard Fault）或未定义行为。
6. 链接溢出：若构建报 "region m_text overflowed"，说明镜像超过 4 KB 链接区域。
7. 缺少 bin2h.exe：若 bin_project/tools/bin2h.exe 不存在，生成 fls_drv_bin_data.h 的构建后步骤将失败。
8. 中断/cache：若 ISR 可能访问被操作的 Flash 区域，请在擦除/编程期间屏蔽中断；建议在 Flash 操作前禁用 cache。
9. BootSwap：仅在芯片支持时调用，且仅在具备已验证恢复路径的流程中使用。
10. 不建议将驱动作为常驻可执行内容持久保存：函数表中保存的是基于 FLS_DRV_BASE_ADDR 解析的相对偏移。建议仅在需要执行 Flash 操作时，将镜像加载到受控的 SRAM 地址，并在调用任何擦除/编程 API 前校验基址和 FLASH_DRV_GetVersion()。若基址错误、镜像损坏或程序异常跑飞，可能解析到错误的函数地址，进而造成 Flash 误擦除或误编程。

提示： 请在使用前，仔细阅读项目根目录下的 README 文档，以获取完整的环境配置与运行说明。
关于各版本的迭代细节与功能变更，敬请参阅 CHANGELOG 文件。

相关链接：

https://forum.ytmicro.com/topic/164/ytm32mc03-有没有ram-flashdriver的案例-做boot用的?_=1767074645275

工程下载：

flash_driver_bin-v1.1.1-20260814.zip