SFUD与HAL库结合使用：STM32CubeMX配置实例

SFUD（Serial Flash Universal Driver）是一款使用JEDEC SFDP标准的串行SPI Flash通用驱动库，它能够自动识别Flash芯片型号并适配不同的操作时序，极大简化了嵌入式系统中Flash存储器的开发工作。本文将以STM32微控制器为例，详细介绍如何通过STM32CubeMX配置HAL库与SFUD的集成方法，帮助开发者快速实现Flash数据的读写功能。##

gitblog_00051

617人浏览 · 2026-02-18 05:01:25

gitblog_00051 · 2026-02-18 05:01:25 发布

SFUD与HAL库结合使用：STM32CubeMX配置实例

【免费下载链接】SFUD An using JEDEC's SFDP standard serial (SPI) flash universal driver library | 一款使用 JEDEC SFDP 标准的串行 (SPI) Flash 通用驱动库项目地址: https://gitcode.com/GitHub_Trending/sf/SFUD

一、准备工作：环境与文件说明

在开始配置前，请确保已准备以下开发环境和文件：

STM32CubeMX（版本6.0以上）
STM32 HAL库（通过CubeMX自动生成）
SFUD源码文件：
- 核心头文件：sfud.h、sfud_cfg.h
- 源文件：sfud.c、sfud_sfdp.c

硬件连接参考

以ART WiFi开发板为例，其SPI Flash接口定义如下： 图1：ART WiFi开发板SPI Flash引脚分布图，标注了SPI3接口的MOSI（PB5）、MISO（PB4）、SCK（PB3）和SS（PA15）引脚

二、STM32CubeMX配置步骤

2.1 配置SPI外设

打开STM32CubeMX，创建新项目并选择目标芯片（如STM32L475VETx）
在"Pinout & Configuration"标签页中：
- 配置SPI接口（如SPI3），设置模式为"Full-Duplex Master"
- 启用NSS引脚（软件控制模式）
- 配置SCLK、MOSI、MISO引脚为复用功能

2.2 生成HAL库代码

在"Project Manager"中设置项目名称和路径
选择工具链（如MDK-ARM或STM32CubeIDE）
点击"Generate Code"生成初始化代码，CubeMX会自动创建SPI相关的HAL库函数

三、SFUD移植与初始化

3.1 添加SFUD文件到工程

将SFUD源码文件添加到项目中：

头文件路径：sfud/inc/
源文件路径：sfud/src/

3.2 实现SPI底层接口

在sfud_port.c中实现SPI通信函数：

static sfud_err spi_write_read(const sfud_spi *spi, const uint8_t *write_buf, size_t write_size, uint8_t *read_buf, size_t read_size) {
    HAL_StatusTypeDef status;
    // 片选拉低
    HAL_GPIO_WritePin(SPI_CS_GPIO_Port, SPI_CS_Pin, GPIO_PIN_RESET);
    // 发送数据
    if (write_size > 0) {
        status = HAL_SPI_Transmit(&hspi3, write_buf, write_size, 100);
    }
    // 接收数据
    if (read_size > 0) {
        status = HAL_SPI_Receive(&hspi3, read_buf, read_size, 100);
    }
    // 片选拉高
    HAL_GPIO_WritePin(SPI_CS_GPIO_Port, SPI_CS_Pin, GPIO_PIN_SET);
    return status == HAL_OK ? SFUD_SUCCESS : SFUD_ERR_SPI;
}

3.3 初始化SFUD库

在main函数中调用SFUD初始化函数：

#include "sfud.h"

int main(void) {
    HAL_Init();
    SystemClock_Config();
    MX_GPIO_Init();
    MX_SPI3_Init();
    
    // 初始化SFUD
    if (sfud_init() == SFUD_SUCCESS) {
        // 初始化成功，获取Flash信息
        const sfud_flash *flash = sfud_get_device_table()[0];
        printf("Flash ID: 0x%08X, Size: %dKB\r\n", flash->id, flash->chip_size / 1024);
    }
    
    while (1) {
        // 应用逻辑
    }
}

四、常用功能示例

4.1 读取Flash ID

sfud_flash *flash = sfud_get_device_table()[0];
printf("Manufacturer ID: 0x%02X\r\n", flash->manufacturer_id);
printf("Device ID: 0x%04X\r\n", flash->device_id);

4.2 擦除与写入数据

uint8_t write_buf[256] = "Hello SFUD!";
uint8_t read_buf[256] = {0};

// 擦除扇区
sfud_erase(flash, 0x000000, 4096);
// 写入数据
sfud_write(flash, 0x000000, sizeof(write_buf), write_buf);
// 读取数据
sfud_read(flash, 0x000000, sizeof(read_buf), read_buf);