1 SFUD介绍
1.1 初步介绍
SFUD 是一个开源的串行 SPI 闪存通用驱动库。由于市面上有各种类型的串行闪存设备，每种设备都具有不同的规格和指令，因此 SFUD 的设计目的是解决这些差异。这使得我们的产品可以支持不同品牌和规格的闪存，增强了软件功能的重用性和可扩展性。此外，它有助于减轻闪存供应短缺或产品停产的风险。
代码连接如下：源码连接
所以选择flash只要采用spi或者qspi通讯的SPI, 通过这个通用driver。
同事需要注意问题是：主控芯片的RAM: 0.2KB ROM: 5.5KB 尽量在这个以上，基本上市场上常见的主流芯片都可以支持。
1.2 支持 SFDP 标准的flash
SFDP 全程是Serial Flash Discoverable Parameter。通过一套标准的内部参数表。这些参数表可以由主机系统软件查询，以调整以适应多个供应商的不同特性。
该标准规定每个闪存中都将有一个参数表，其中存储着闪存规格参数，如闪存容量、写入粒度、擦除命令和地址模式等。目前，除了一些制造商的旧款闪存不支持这一标准外，其他新工厂生产的大多数闪存都已支持 SFDP 标准。因此，在初始化过程中，库将首先读取 SFDP 表参数
1.3 不支持 SFDP 标准的flash
如果闪存不支持 SFDP 标准，SFUD 将查询配置文件（/sfud/inc/sfud_flash_def.h）中提供的闪存参数信息表，以查看是否支持该闪存。如果不支持，则可以在配置文件中添加该闪存的参数信息。
1.4 为什么选择SFDP
避免因闪存断货、闪存停产或产品扩展而引起的项目风险。越来越多的项目将固件存储在串行闪存中，例如：ESP8266固件、主板BIOS以及其他常见电子产品的固件等。然而，各种闪存规格和指令并不统一。
使用SFUD可以避免不能适应不同类型的基于同一功能软件平台的闪存硬件平台的问题，提高软件的可重用性，简化软件流程，减少开发难度。
现在只需配置SPI通信，即可自由玩转串行闪存，也可用于制作闪存编程器/写入器。
2 SFUD 如何使用
2.1 选择合适的flash
以下flash 已经经过测试的，更到flash型号，要去看原有github上面介绍
型号 制造商 容量 最高速度 SFDP 标准 QSPI 模式 备注
W25Q40BV Winbond 4Mb 50Mhz 不支持 双线 已停产
W25Q80DV Winbond 8Mb 104Mhz 支持 双线
W25Q16BV Winbond 16Mb 104Mhz 不支持 双线 by slipperstree
W25Q16CV Winbond 16Mb 104Mhz 支持 未测试
W25Q16DV Winbond 16Mb 104Mhz 支持 未测试 by slipperstree
W25Q32BV Winbond 32Mb 104Mhz 支持 双线
W25Q64CV Winbond 64Mb 80Mhz 支持 四线
W25Q128BV Winbond 128Mb 104Mhz 支持 四线
2.2 基本结构体介绍
先说明下本库主要使用的一个结构体 sfud_flash 。其定义位于 /sfud/inc/sfud_def.h。每个 SPI Flash 会对应一个该结构体，该结构体指针下面统称为 Flash 设备对象。初始化成功后在 sfud_flash->chip 结构体中会存放 SPI Flash 的常见参数。如果 SPI Flash 还支持 SFDP ，还可以通过 sfud_flash->sfdp 看到更加全面的参数信息。以下很多函数都将使用 Flash 设备对象作为第一个入参，实现对指定 SPI Flash 的操作。
2.2.1 初始化设备
sfud_err sfud_init(void)
2.2.2 初始化指定的 Flash 设备
sfud_err sfud_device_init(sfud_flash *flash)
2.2.3 获取 Flash 设备对象
sfud_flash *sfud_get_device(size_t index)
2.2.4 读取数据
sfud_err sfud_read(const sfud_flash *flash, uint32_t addr, size_t size, uint8_t *data)
2.2.5 擦除flash数据
sfud_err sfud_erase(const sfud_flash *flash, uint32_t addr, size_t size)
2.2.6 擦除全部数据
sfud_err sfud_chip_erase(const sfud_flash *flash)
2.2.7 写入数据
sfud_err sfud_write(const sfud_flash *flash, uint32_t addr, size_t size, const uint8_t *data)
参数 描述
flash Flash 设备对象
addr 起始地址
size 从起始地址开始写入数据的总大小
data 待写入的数据
2.2.8 先擦除再往 Flash 写数据
注意：擦除操作将会按照 Flash 芯片的擦除粒度（详见 Flash 数据手册，一般为 block 大小。初始化完成后，可以通过 sfud_flash->chip.erase_gran 查看）对齐，请注意保证起始地址和擦除数据大小按照 Flash 芯片的擦除粒度对齐，否则执行擦除操作后，将会导致其他数据丢失。
sfud_err sfud_read_status(const sfud_flash *flash, uint8_t *status)
3 SFUD库的移植到KEIL工程中
3.1 下载源码
可以从github上面下载，也可以从这里下载。
3.2 文件夹介绍
- demo 文件是参考代码
- docs 是文档说明
- 里面源代码
3.3 移植文件
-
把SFUD的代码移植到你的工程下面；
-
添加源文件；
-
添加头文件路径；
-
编译通过没有问题，说明代码移植到工程没有问题。
