基于STM32CubeMX与HAL库的W25Q64 SPI Flash开发实战指南
在嵌入式系统开发中，外部Flash存储器常被用于数据存储、固件升级等场景。W25Q64作为一款常见的64M-bit SPI Flash芯片，因其高性价比和易用性广受欢迎。传统开发方式多基于标准库或寄存器操作，而现代STM32开发更倾向于使用STM32CubeMX配合HAL库，这种方式能显著提升开发效率，降低硬件抽象层的工作量。
本文将全面介绍如何利用STM32CubeMX工具配置SPI外设，通过HAL库函数实现W25Q64的完整驱动，包括芯片识别、擦除、读写等操作，并探讨如何将驱动封装为可复用模块。相比标准库，HAL库在SPI通信接口上提供了更高层次的抽象，使开发者能更专注于业务逻辑而非底层细节。
1. 开发环境搭建与CubeMX配置
1.1 硬件准备与连接
W25Q64与STM32的典型连接方式如下表所示：
| W25Q64引脚 | STM32引脚 | 功能说明 |
|---|---|---|
| CS | PA4 | 片选信号(低有效) |
| DO(MISO) | PA6 | 主设备输入 |
| CLK | PA5 | 时钟信号 |
| DI(MOSI) | PA7 | 主设备输出 |
| VCC | 3.3V | 电源 |
| GND | GND | 地线 |
注意：W25Q64工作电压为2.7V-3.6V，必须确保供电电压不超过3.6V，否则可能损坏芯片。
1.2 CubeMX SPI外设配置
- 打开STM32CubeMX，创建新工程并选择目标STM32型号
- 在"Pinout & Configuration"标签页中启用SPI外设：
- 模式选择"Full-Duplex Master"
- 硬件NSS信号选择"Disable"（使用软件控制片选）
- 配置SPI参数：
// 典型配置参数 Prescaler = 8 (SPI时钟分频) Clock Polarity = Low Clock Phase = 1 Edge Data Size = 8 bits First Bit = MSB first CRC Calculation = Disable NSS Signal Type = Software - 生成代码时勾选"Generate peripheral initialization as a pair of .c/.h files"
1.3 HAL库SPI函数概览
HAL库提供了丰富的SPI操作函数，主要包含以下几类：
- 阻塞式传输：
HAL_SPI_Transmit/Receive/TransmitReceive - 中断方式：
HAL_SPI_Transmit_IT/Receive_IT/TransmitReceive_IT - DMA方式：
HAL_SPI_Transmit_DMA/Receive_DMA/TransmitReceive_DMA - 状态管理：
HAL_SPI_GetState,HAL_SPI_GetError
对于W25Q64这类SPI Flash设备，通常使用阻塞式传输即可满足需求，代码实现简单可靠。
2. W25Q64驱动实现
2.1 基本宏定义与辅助函数
首先定义W25Q64的指令集和基本参数：
/* W25Q64指令定义 */ #define W25X_WriteEnable 0x06 #define W25X_WriteDisable 0x04 #define W25X_ReadStatusReg1 0x05 #define W25X_ReadStatusReg2 0x35 #define W25X_ReadData 0x03 #define W25X_FastReadData 0x0B #define W25X_PageProgram 0x02 #define W25X_SectorErase 0x20 #define W25X_BlockErase 0xD8 #define W25X_ChipErase 0xC7 #define W25X_PowerDown 0xB9 #define W25X_ReleasePowerDown 0xAB #define W25X_DeviceID 0xAB #define W25X_ManufactDeviceID 0x90 #define W25X_JedecDeviceID 0x9F /* W25Q64参数 */ #define W25Q64_PAGE_SIZE 256 #define W25Q64_SECTOR_SIZE 4096 #define W25Q64_BLOCK_SIZE 65536 #define W25Q64_CHIP_SIZE 8388608实现片选控制函数：
void W25Q64_CS_Enable(void) { HAL_GPIO_WritePin(FLASH_CS_GPIO_Port, FLASH_CS_Pin, GPIO_PIN_RESET); } void W25Q64_CS_Disable(void) { HAL_GPIO_WritePin(FLASH_CS_GPIO_Port, FLASH_CS_Pin, GPIO_PIN_SET); }2.2 设备识别与状态检测
读取设备ID是验证硬件连接是否正常的第一步：
uint32_t W25Q64_ReadID(void) { uint8_t cmd = W25X_JedecDeviceID; uint8_t data[3] = {0}; W25Q64_CS_Enable(); HAL_SPI_Transmit(&hspi1, &cmd, 1, HAL_MAX_DELAY); HAL_SPI_Receive(&hspi1, data, 3, HAL_MAX_DELAY); W25Q64_CS_Disable(); return (data[0] << 16) | (data[1] << 8) | data[2]; }检测Flash是否处于忙状态：
uint8_t W25Q64_IsBusy(void) { uint8_t cmd = W25X_ReadStatusReg1; uint8_t status; W25Q64_CS_Enable(); HAL_SPI_Transmit(&hspi1, &cmd, 1, HAL_MAX_DELAY); HAL_SPI_Receive(&hspi1, &status, 1, HAL_MAX_DELAY); W25Q64_CS_Disable(); return (status & 0x01); // 检查BUSY位 }2.3 擦除操作实现
W25Q64支持三种擦除粒度：扇区(4KB)、块(64KB)和整片擦除。以下是扇区擦除的实现：
void W25Q64_SectorErase(uint32_t addr) { uint8_t cmd[4] = { W25X_SectorErase, (addr >> 16) & 0xFF, (addr >> 8) & 0xFF, addr & 0xFF }; W25Q64_WriteEnable(); W25Q64_CS_Enable(); HAL_SPI_Transmit(&hspi1, cmd, 4, HAL_MAX_DELAY); W25Q64_CS_Disable(); while(W25Q64_IsBusy()); }重要提示：擦除操作耗时较长（典型值400ms/扇区），必须等待操作完成才能进行后续操作。
3. 数据读写实现与优化
3.1 页编程与数据写入
W25Q64支持页编程(Page Program)操作，每页256字节：
void W25Q64_PageWrite(uint8_t *pData, uint32_t addr, uint16_t len) { uint8_t cmd[4] = { W25X_PageProgram, (addr >> 16) & 0xFF, (addr >> 8) & 0xFF, addr & 0xFF }; if(len > W25Q64_PAGE_SIZE) { len = W25Q64_PAGE_SIZE; } W25Q64_WriteEnable(); W25Q64_CS_Enable(); HAL_SPI_Transmit(&hspi1, cmd, 4, HAL_MAX_DELAY); HAL_SPI_Transmit(&hspi1, pData, len, HAL_MAX_DELAY); W25Q64_CS_Disable(); while(W25Q64_IsBusy()); }对于超过一页的数据写入，需要分多次页编程：
void W25Q64_WriteBuffer(uint8_t *pData, uint32_t addr, uint32_t len) { uint32_t pageRemain; uint32_t writeLen; uint32_t currentAddr = addr; while(len > 0) { pageRemain = W25Q64_PAGE_SIZE - (currentAddr % W25Q64_PAGE_SIZE); writeLen = (len > pageRemain) ? pageRemain : len; W25Q64_PageWrite(pData, currentAddr, writeLen); pData += writeLen; currentAddr += writeLen; len -= writeLen; } }3.2 数据读取实现
W25Q64支持标准读和快速读两种模式，以下是标准读实现：
void W25Q64_ReadBuffer(uint8_t *pData, uint32_t addr, uint32_t len) { uint8_t cmd[4] = { W25X_ReadData, (addr >> 16) & 0xFF, (addr >> 8) & 0xFF, addr & 0xFF }; W25Q64_CS_Enable(); HAL_SPI_Transmit(&hspi1, cmd, 4, HAL_MAX_DELAY); HAL_SPI_Receive(&hspi1, pData, len, HAL_MAX_DELAY); W25Q64_CS_Disable(); }为提高读取速度，可以使用快速读模式（需额外发送一个dummy字节）：
void W25Q64_FastReadBuffer(uint8_t *pData, uint32_t addr, uint32_t len) { uint8_t cmd[5] = { W25X_FastReadData, (addr >> 16) & 0xFF, (addr >> 8) & 0xFF, addr & 0xFF, 0xFF // dummy byte }; W25Q64_CS_Enable(); HAL_SPI_Transmit(&hspi1, cmd, 5, HAL_MAX_DELAY); HAL_SPI_Receive(&hspi1, pData, len, HAL_MAX_DELAY); W25Q64_CS_Disable(); }4. 驱动封装与高级应用
4.1 模块化驱动设计
为提高代码复用性，建议将W25Q64驱动封装为独立模块：
w25q64_driver/ ├── w25q64.c // 驱动实现 ├── w25q64.h // 公共接口定义 └── w25q64_conf.h // 硬件相关配置w25q64.h中定义公共接口：
typedef enum { W25Q64_OK = 0, W25Q64_ERROR, W25Q64_BUSY, W25Q64_TIMEOUT } W25Q64_StatusTypeDef; W25Q64_StatusTypeDef W25Q64_Init(void); uint32_t W25Q64_ReadID(void); W25Q64_StatusTypeDef W25Q64_EraseSector(uint32_t sectorAddr); W25Q64_StatusTypeDef W25Q64_WritePage(uint8_t *pData, uint32_t addr, uint16_t len); W25Q64_StatusTypeDef W25Q64_ReadBuffer(uint8_t *pData, uint32_t addr, uint32_t len);4.2 与FatFs文件系统集成
W25Q64可作为FatFs的底层存储设备，需要实现diskio接口：
#include "ff.h" #include "diskio.h" DSTATUS disk_initialize(BYTE pdrv) { if(W25Q64_Init() == W25Q64_OK) { return RES_OK; } return RES_ERROR; } DRESULT disk_read(BYTE pdrv, BYTE *buff, LBA_t sector, UINT count) { uint32_t addr = sector * W25Q64_SECTOR_SIZE; uint32_t len = count * W25Q64_SECTOR_SIZE; if(W25Q64_ReadBuffer(buff, addr, len) == W25Q64_OK) { return RES_OK; } return RES_ERROR; } DRESULT disk_write(BYTE pdrv, const BYTE *buff, LBA_t sector, UINT count) { uint32_t addr = sector * W25Q64_SECTOR_SIZE; uint32_t len = count * W25Q64_SECTOR_SIZE; // 必须先擦除扇区 for(UINT i = 0; i < count; i++) { W25Q64_EraseSector((sector + i) * W25Q64_SECTOR_SIZE); } if(W25Q64_WriteBuffer(buff, addr, len) == W25Q64_OK) { return RES_OK; } return RES_ERROR; }4.3 性能优化技巧
SPI时钟优化：
- W25Q64最高支持104MHz时钟
- 在CubeMX中合理配置SPI预分频器
- 实测不同时钟下的传输稳定性
双缓冲机制：
#define BUF_SIZE 512 uint8_t buf1[BUF_SIZE], buf2[BUF_SIZE]; uint8_t *currentBuf = buf1; // 使用DMA双缓冲 HAL_SPI_TransmitReceive_DMA(&hspi1, txBuf, currentBuf, len);写操作批处理：
- 收集多个写请求后批量执行
- 减少擦除操作次数
在实际项目中，我发现合理设置SPI时钟分频对稳定性影响很大。当系统时钟为72MHz时，SPI分频设为4(18MHz)既能保证速度又足够稳定。另外，使用双缓冲机制配合DMA传输可以显著提升大数据量读写时的效率。
