从时序到实战：基于STM32 HAL库的W25Q64 SPI驱动开发全解析-平芜编程栈

1. SPI协议基础与硬件连接

SPI协议作为嵌入式开发中最常用的通信协议之一，其全称是Serial Peripheral Interface（串行外设接口）。我第一次接触SPI是在做一个传感器项目时，当时需要高速读取加速度计数据，I2C的速率已经无法满足需求。SPI的突出特点就是全双工通信和高速传输，实测在STM32F4系列上可以达到42MHz的时钟频率。

硬件连接上，SPI比I2C要简单直接。我画过最复杂的SPI连接是在一个智能家居项目中，主控STM32需要同时连接W25Q64 Flash、RFID读卡器和TFT屏幕。这里有个经验：所有从设备的SCK、MOSI、MISO都可以并联，唯独片选线（NSS/CS）必须独立。具体到W25Q64的连接：

SCK（PA5）：时钟线，配置为推挽输出
MISO（PA6）：主入从出，配置为上拉输入
MOSI（PA7）：主出从入，推挽输出
CS（PA4）：片选，普通GPIO输出

实际布线时有个坑要注意：如果SPI速率超过10MHz，PCB走线最好等长，我的一个项目因为MISO走线比SCK长了3cm，导致数据采样出错。后来用逻辑分析仪抓波形才发现是信号延迟导致的相位偏移。

2. SPI四种模式深度解析

很多新手会困惑SPI的模式选择，我第一次用W25Q64时就因为模式设错导致读出的ID全是0xFF。SPI模式本质是由**CPOL（时钟极性）和CPHA（时钟相位）**两个参数决定的：

CPOL=0：时钟空闲时为低电平
CPOL=1：时钟空闲时为高电平
CPHA=0：在第一个边沿采样数据
CPHA=1：在第二个边沿采样数据

W25Q64使用的是Mode 0（CPOL=0, CPHA=0），这也是最常用的模式。在CubeMX中配置时要特别注意：

hspi1.Init.CLKPolarity = SPI_POLARITY_LOW; hspi1.Init.CLKPha = SPI_PHASE_1EDGE;

验证模式是否正确有个技巧：用逻辑分析仪捕获波形时，观察数据变化和采样边沿。正确的Mode 0波形应该是：

片选拉低后，SCK从低电平开始
数据在SCK上升沿变化
在SCK下降沿采样数据

3. W25Q64芯片特性与指令集

W25Q64是Winbond推出的64M-bit（8MB）SPI Flash，我在五个以上项目中使用过这款芯片，它的稳定性经受住了工业环境的考验。几个关键特性需要牢记：

扇区结构：共128个块(Block)，每块16个扇区(Sector)，每扇区4KB
擦除要求：必须按扇区擦除（最小4KB）
写入限制：每次最多写入256字节（一页）

指令操作流程有个固定套路：

拉低片选
发送指令码（如读ID是0x9F）
发送地址（3字节）
读写数据
拉高片选

特别注意写操作前必须先发送写使能指令（0x06），我有次调试一整天写不进去数据，最后发现漏了这步。完整的指令表如下：

指令名	指令码	功能描述
Read ID	0x9F	读取厂商和设备ID
Write Enable	0x06	使能写操作
Sector Erase	0x20	擦除一个扇区
Page Program	0x02	写入一页数据
Read Data	0x03	读取数据

4. HAL库驱动开发实战

4.1 CubeMX基础配置

在CubeMX中配置SPI1为全双工主机模式，关键参数设置：

时钟分频：选择PCLK/4（对应STM32F103为9MHz）
数据宽度：8位
先发送MSB
NSS使用软件控制

GPIO配置有个细节：CS引脚要设置为普通输出，不能复用为SPI_NSS，因为W25Q64需要主动控制片选时机。我遇到过设置为硬件NSS导致通信失败的情况。

4.2 驱动函数实现

读取ID函数是最基础的验证函数，实现如下：

void W25Q64_ReadID(uint16_t *manufID, uint16_t *deviceID) { uint8_t cmd = 0x9F; uint8_t buf[3]; CS_LOW(); HAL_SPI_Transmit(&hspi1, &cmd, 1, 100); HAL_SPI_Receive(&hspi1, buf, 3, 100); CS_HIGH(); *manufID = buf[0]; *deviceID = (buf[1]<<8) | buf[2]; }

扇区擦除要注意必须先检查BUSY标志：

void W25Q64_EraseSector(uint32_t addr) { uint8_t cmd[4] = {0x20, addr>>16, addr>>8, addr}; W25Q64_WaitBusy(); W25Q64_WriteEnable(); CS_LOW(); HAL_SPI_Transmit(&hspi1, cmd, 4, 100); CS_HIGH(); }

页编程函数实现数据写入：

void W25Q64_PageProgram(uint32_t addr, uint8_t *data, uint16_t len) { uint8_t cmd[4] = {0x02, addr>>16, addr>>8, addr}; W25Q64_WaitBusy(); W25Q64_WriteEnable(); CS_LOW(); HAL_SPI_Transmit(&hspi1, cmd, 4, 100); HAL_SPI_Transmit(&hspi1, data, len, 100); CS_HIGH(); }

4.3 调试技巧与常见问题

调试SPI设备时，逻辑分析仪是必备工具。我总结了几种典型问题现象：

全FF或全00响应：通常是模式配置错误或片选信号问题
数据错位：检查MSB/LSB设置是否正确
偶尔通信失败：可能是信号干扰，尝试降低时钟频率

一个实用的调试函数是打印Flash状态寄存器：

void W25Q64_PrintStatus(void) { uint8_t cmd = 0x05; uint8_t status; CS_LOW(); HAL_SPI_Transmit(&hspi1, &cmd, 1, 100); HAL_SPI_Receive(&hspi1, &status, 1, 100); CS_HIGH(); printf("Status: BUSY=%d WEL=%d\n", (status&0x01), (status>>1)&0x01); }

5. 高级应用与性能优化

5.1 DMA传输实现

当需要高速读写大量数据时，可以使用DMA。我在一个数据记录仪项目中，用DMA实现了5MB/s的持续写入速度。关键配置：

// CubeMX中启用SPI TX/RX DMA hspi1.hdmatx = &hdma_spi1_tx; hspi1.hdmarx = &hdma_spi1_rx; // DMA传输函数 HAL_SPI_Transmit_DMA(&hspi1, txData, length); HAL_SPI_Receive_DMA(&hspi1, rxData, length);

5.2 文件系统集成

对于需要存储结构化数据的场景，可以移植FatFs文件系统。移植要点：

实现diskio.c中的底层接口：

DRESULT disk_read(BYTE pdrv, BYTE *buff, LBA_t sector, UINT count) { W25Q64_Read(sector*4096, buff, count*4096); return RES_OK; }

擦除策略建议使用懒擦除：

void W25Q64_EraseAsync(uint32_t addr) { // 标记需要擦除的扇区 erasePending = addr; } void W25Q64_BackgroundTask(void) { if(erasePending != 0xFFFFFFFF) { W25Q64_EraseSector(erasePending); erasePending = 0xFFFFFFFF; } }

5.3 磨损均衡实现

Flash的每个扇区有约10万次擦写寿命，频繁更新的数据需要实现磨损均衡。我的一个方案是：

将Flash划分为多个逻辑区
维护一个映射表记录物理地址到逻辑地址的映射
每次写入时选择使用最少的物理块

typedef struct { uint32_t physicalAddr; uint32_t eraseCount; } BlockInfo; BlockInfo blockTable[128]; // 对应128个物理块 uint32_t GetWearLevelingBlock(uint32_t logicAddr) { // 找出擦除次数最少的块 uint32_t minErase = 0xFFFFFFFF; uint32_t targetBlock = 0; for(int i=0; i<128; i++) { if(blockTable[i].eraseCount < minErase) { minErase = blockTable[i].eraseCount; targetBlock = i; } } return blockTable[targetBlock].physicalAddr; }

6. 项目实战：数据记录仪案例

去年我做了一个工业温度记录仪，核心需求是每5秒记录一次温度数据，保存3个月的历史数据。使用W25Q64的方案如下：

存储结构设计：
- 前4KB存储元数据（记录指针、设备信息等）
- 后续空间按环形缓冲存储数据记录
- 每条记录包含时间戳(4B)+温度值(2B)+校验和(1B)
关键实现代码：

#define RECORD_SIZE 7 #define RECORDS_PER_SECTOR (4096/RECORD_SIZE) void SaveTemperature(float temp) { static uint32_t currentSector = 1; static uint16_t recordIndex = 0; uint8_t record[RECORD_SIZE]; uint32_t timestamp = HAL_GetTick(); // 填充记录 memcpy(record, &timestamp, 4); uint16_t tempRaw = (uint16_t)(temp * 100); memcpy(record+4, &tempRaw, 2); record[6] = CalculateChecksum(record, 6); // 写入Flash if(recordIndex >= RECORDS_PER_SECTOR) { currentSector++; if(currentSector >= 2048) currentSector = 1; W25Q64_EraseSector(currentSector*4096); recordIndex = 0; } W25Q64_PageProgram(currentSector*4096 + recordIndex*RECORD_SIZE, record, RECORD_SIZE); recordIndex++; }