STM32F429 SPI读写W25Q128 Flash实战：从引脚配置到数据存储的完整流程

STM32F429 SPI读写W25Q128 Flash实战：从引脚配置到数据存储的完整流程

在嵌入式系统开发中，外部Flash存储器扩展是常见需求。W25Q128作为一款16MB容量的SPI Flash芯片，以其高性价比和易用性成为许多项目的首选。本文将手把手带你完成STM32F429与W25Q128的完整通信实现，从硬件连接到数据存取，涵盖工程实践中那些容易被忽视的关键细节。

1. 硬件设计与初始化配置

1.1 引脚连接与SPI模式选择

W25Q128与STM32F429的连接需要特别注意信号完整性和电气特性。推荐使用以下连接方式：

硬件设计时需注意：

• 在CLK信号线串联22Ω电阻可减少信号反射
• 电源引脚建议并联0.1μF和4.7μF电容组合
• 长距离布线时建议在MOSI/MISO线上串联33Ω电阻

1.2 SPI外设初始化代码实现

针对W25Q128的SPI初始化需要特别注意时钟极性和相位配置。以下是经过优化的初始化代码：

void SPI5_Init(void) { GPIO_InitTypeDef GPIO_InitStruct = {0}; SPI_InitTypeDef SPI_InitStruct = {0}; // 启用GPIOF和SPI5时钟 RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOF, ENABLE); RCC_APB2PeriphClockCmd(RCC_APB2Periph_SPI5, ENABLE); // 配置PF6(CS)为推挽输出 GPIO_InitStruct.GPIO_Pin = GPIO_Pin_6; GPIO_InitStruct.GPIO_Mode = GPIO_Mode_OUT; GPIO_InitStruct.GPIO_OType = GPIO_OType_PP; GPIO_InitStruct.GPIO_Speed = GPIO_Speed_50MHz; GPIO_InitStruct.GPIO_PuPd = GPIO_PuPd_UP; GPIO_Init(GPIOF, &GPIO_InitStruct); // 配置PF7-9为复用功能 GPIO_InitStruct.GPIO_Pin = GPIO_Pin_7 | GPIO_Pin_8 | GPIO_Pin_9; GPIO_InitStruct.GPIO_Mode = GPIO_Mode_AF; GPIO_InitStruct.GPIO_OType = GPIO_OType_PP; GPIO_InitStruct.GPIO_Speed = GPIO_Speed_50MHz; GPIO_InitStruct.GPIO_PuPd = GPIO_PuPd_NOPULL; GPIO_Init(GPIOF, &GPIO_InitStruct); // 引脚复用映射 GPIO_PinAFConfig(GPIOF, GPIO_PinSource7, GPIO_AF_SPI5); GPIO_PinAFConfig(GPIOF, GPIO_PinSource8, GPIO_AF_SPI5); GPIO_PinAFConfig(GPIOF, GPIO_PinSource9, GPIO_PinAF_SPI5); // SPI参数配置 SPI_InitStruct.SPI_Direction = SPI_Direction_2Lines_FullDuplex; SPI_InitStruct.SPI_Mode = SPI_Mode_Master; SPI_InitStruct.SPI_DataSize = SPI_DataSize_8b; SPI_InitStruct.SPI_CPOL = SPI_CPOL_High; // 空闲时高电平 SPI_InitStruct.SPI_CPHA = SPI_CPHA_2Edge; // 第二个边沿采样 SPI_InitStruct.SPI_NSS = SPI_NSS_Soft; SPI_InitStruct.SPI_BaudRatePrescaler = SPI_BaudRatePrescaler_4; // 22.5MHz SPI_InitStruct.SPI_FirstBit = SPI_FirstBit_MSB; SPI_InitStruct.SPI_CRCPolynomial = 7; SPI_Init(SPI5, &SPI_InitStruct); SPI_Cmd(SPI5, ENABLE); FLASH_CS_HIGH(); // 初始时取消片选 }

关键配置说明：

• CPOL/CPHA：W25Q128支持模式0(0,0)和模式3(1,1)，模式3在高速下更稳定
• 时钟分频：STM32F429的APB2时钟为90MHz，分频4得到22.5MHz通信速率
• 软件NSS：硬件NSS信号在DMA传输时可能有问题，推荐使用GPIO模拟

2. Flash基础操作与状态管理

2.1 基本读写函数实现

SPI通信的基础是字节传输函数，需要正确处理超时情况：

uint8_t SPI5_ReadWriteByte(uint8_t TxData) { uint32_t timeout = SPI_TIMEOUT; // 等待发送缓冲区空 while (SPI_I2S_GetFlagStatus(SPI5, SPI_I2S_FLAG_TXE) == RESET) { if ((timeout--) == 0) return SPI_TIMEOUT; } SPI_I2S_SendData(SPI5, TxData); timeout = SPI_TIMEOUT; // 等待接收缓冲区非空 while (SPI_I2S_GetFlagStatus(SPI5, SPI_I2S_FLAG_RXNE) == RESET) { if ((timeout--) == 0) return SPI_TIMEOUT; } return SPI_I2S_ReceiveData(SPI5); }

2.2 Flash状态机管理

W25Q128内部操作需要时间完成，必须正确检测状态寄存器：

#define W25X_WriteEnable 0x06 #define W25X_ReadStatusReg1 0x05 #define W25X_BUSY_MASK 0x01 void W25Q128_WaitForReady(void) { uint8_t status; do { FLASH_CS_LOW(); SPI5_ReadWriteByte(W25X_ReadStatusReg1); status = SPI5_ReadWriteByte(0xFF); FLASH_CS_HIGH(); } while (status & W25X_BUSY_MASK); } void W25Q128_WriteEnable(void) { FLASH_CS_LOW(); SPI5_ReadWriteByte(W25X_WriteEnable); FLASH_CS_HIGH(); }

注意：每次写操作前必须发送写使能指令，且该指令会在上电复位或写禁用指令后失效

3. 存储操作实战：从扇区擦除到数据写入

3.1 扇区擦除实现

Flash存储器的特性决定了必须先擦除后写入，擦除最小单位为4KB扇区：

#define W25X_SectorErase 0x20 void W25Q128_SectorErase(uint32_t addr) { W25Q128_WriteEnable(); FLASH_CS_LOW(); SPI5_ReadWriteByte(W25X_SectorErase); SPI5_ReadWriteByte((addr >> 16) & 0xFF); SPI5_ReadWriteByte((addr >> 8) & 0xFF); SPI5_ReadWriteByte(addr & 0xFF); FLASH_CS_HIGH(); W25Q128_WaitForReady(); }

擦除时间参数：

3.2 页编程与数据写入

W25Q128支持页编程（256字节）操作，跨页写入需要特殊处理：

#define W25X_PageProgram 0x02 #define PAGE_SIZE 256 void W25Q128_PageWrite(uint8_t *pBuffer, uint32_t addr, uint16_t len) { if (len > PAGE_SIZE) len = PAGE_SIZE; W25Q128_WriteEnable(); FLASH_CS_LOW(); SPI5_ReadWriteByte(W25X_PageProgram); SPI5_ReadWriteByte((addr >> 16) & 0xFF); SPI5_ReadWriteByte((addr >> 8) & 0xFF); SPI5_ReadWriteByte(addr & 0xFF); while (len--) { SPI5_ReadWriteByte(*pBuffer++); } FLASH_CS_HIGH(); W25Q128_WaitForReady(); } void W25Q128_BufferWrite(uint8_t *pBuffer, uint32_t addr, uint32_t len) { uint32_t pageOffset = addr % PAGE_SIZE; uint32_t remain = len; // 处理起始不完整页 if (pageOffset > 0) { uint32_t bytesToWrite = MIN(PAGE_SIZE - pageOffset, len); W25Q128_PageWrite(pBuffer, addr, bytesToWrite); pBuffer += bytesToWrite; addr += bytesToWrite; remain -= bytesToWrite; } // 写入完整页 while (remain >= PAGE_SIZE) { W25Q128_PageWrite(pBuffer, addr, PAGE_SIZE); pBuffer += PAGE_SIZE; addr += PAGE_SIZE; remain -= PAGE_SIZE; } // 写入剩余数据 if (remain > 0) { W25Q128_PageWrite(pBuffer, addr, remain); } }

4. 高级应用：数据类型存储与文件系统集成

4.1 结构化数据存储方案

实际项目中常需要存储结构化数据，推荐采用以下格式：

#pragma pack(push, 1) typedef struct { uint32_t magic; // 标识符 0x55AA55AA uint16_t version; // 数据结构版本 uint32_t crc; // 数据区CRC校验 uint32_t timestamp; // 最后更新时间 uint8_t data[]; // 实际数据区 } FlashDataHeader; #pragma pack(pop) void SaveStructuredData(void *data, uint16_t size, uint32_t sectorAddr) { uint8_t buffer[4096]; FlashDataHeader *header = (FlashDataHeader *)buffer; // 准备数据头 header->magic = 0x55AA55AA; header->version = 1; header->timestamp = HAL_GetTick(); memcpy(header->data, data, size); header->crc = Calculate_CRC32(header->data, size); // 擦除后写入 W25Q128_SectorErase(sectorAddr); W25Q128_BufferWrite(buffer, sectorAddr, sizeof(FlashDataHeader) + size); }

4.2 与FatFs文件系统集成

在Flash上实现文件系统可极大简化数据管理，FatFs是轻量级解决方案：

1. 首先实现底层磁盘接口：

DSTATUS disk_initialize(BYTE pdrv) { // 初始化SPI Flash return RES_OK; } DRESULT disk_read(BYTE pdrv, BYTE *buff, LBA_t sector, UINT count) { uint32_t addr = sector * FLASH_SECTOR_SIZE; W25Q128_BufferRead(buff, addr, count * FLASH_SECTOR_SIZE); return RES_OK; } DRESULT disk_write(BYTE pdrv, const BYTE *buff, LBA_t sector, UINT count) { uint32_t addr = sector * FLASH_SECTOR_SIZE; for (uint32_t i = 0; i < count; i++) { W25Q128_SectorErase(addr + i * FLASH_SECTOR_SIZE); } W25Q128_BufferWrite(buff, addr, count * FLASH_SECTOR_SIZE); return RES_OK; }

2. 然后进行文件系统格式化：

void FormatFlashFilesystem(void) { FATFS fs; uint8_t work[FF_MAX_SS]; // 擦除前4MB空间用于文件系统 for (uint32_t i = 0; i < 1024; i++) { W25Q128_SectorErase(i * 4096); } // 创建FAT文件系统 f_mkfs("0:", FM_FAT32, 0, work, sizeof(work)); f_mount(&fs, "0:", 1); }

5. 性能优化与错误处理

5.1 DMA加速SPI传输

对于大数据量传输，使用DMA可显著提升性能：

void SPI5_DMA_Init(void) { DMA_InitTypeDef DMA_InitStruct; // 启用DMA2时钟 RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_DMA2, ENABLE); // 配置DMA发送通道 DMA_InitStruct.DMA_Channel = DMA_Channel_2; DMA_InitStruct.DMA_PeripheralBaseAddr = (uint32_t)&SPI5->DR; DMA_InitStruct.DMA_Memory0BaseAddr = (uint32_t)0; // 动态设置 DMA_InitStruct.DMA_DIR = DMA_DIR_MemoryToPeripheral; DMA_InitStruct.DMA_BufferSize = 0; // 动态设置 DMA_InitStruct.DMA_PeripheralInc = DMA_PeripheralInc_Disable; DMA_InitStruct.DMA_MemoryInc = DMA_MemoryInc_Enable; DMA_InitStruct.DMA_PeripheralDataSize = DMA_PeripheralDataSize_Byte; DMA_InitStruct.DMA_MemoryDataSize = DMA_MemoryDataSize_Byte; DMA_InitStruct.DMA_Mode = DMA_Mode_Normal; DMA_InitStruct.DMA_Priority = DMA_Priority_High; DMA_InitStruct.DMA_FIFOMode = DMA_FIFOMode_Disable; DMA_InitStruct.DMA_FIFOThreshold = DMA_FIFOThreshold_HalfFull; DMA_InitStruct.DMA_MemoryBurst = DMA_MemoryBurst_Single; DMA_InitStruct.DMA_PeripheralBurst = DMA_PeripheralBurst_Single; DMA_DeInit(DMA2_Stream3); DMA_Init(DMA2_Stream3, &DMA_InitStruct); // 启用DMA中断 NVIC_InitTypeDef NVIC_InitStruct; NVIC_InitStruct.NVIC_IRQChannel = DMA2_Stream3_IRQn; NVIC_InitStruct.NVIC_IRQChannelPreemptionPriority = 0; NVIC_InitStruct.NVIC_IRQChannelSubPriority = 0; NVIC_InitStruct.NVIC_IRQChannelCmd = ENABLE; NVIC_Init(&NVIC_InitStruct); DMA_ITConfig(DMA2_Stream3, DMA_IT_TC, ENABLE); // 关联DMA到SPI SPI_I2S_DMACmd(SPI5, SPI_I2S_DMAReq_Tx, ENABLE); }

5.2 错误检测与恢复机制

可靠的Flash操作需要完善的错误处理：

#define FLASH_OP_TIMEOUT 1000 // 1秒超时 typedef enum { FLASH_OK = 0, FLASH_TIMEOUT, FLASH_VERIFY_FAIL, FLASH_WRITE_PROTECTED, FLASH_INVALID_SECTOR } FlashStatus; FlashStatus W25Q128_VerifyWrite(uint8_t *expected, uint32_t addr, uint32_t len) { uint8_t *readback = malloc(len); uint32_t startTime = HAL_GetTick(); // 等待写入完成 while ((HAL_GetTick() - startTime) < FLASH_OP_TIMEOUT) { uint8_t status; FLASH_CS_LOW(); SPI5_ReadWriteByte(W25X_ReadStatusReg1); status = SPI5_ReadWriteByte(0xFF); FLASH_CS_HIGH(); if (!(status & W25X_BUSY_MASK)) break; } if ((HAL_GetTick() - startTime) >= FLASH_OP_TIMEOUT) { free(readback); return FLASH_TIMEOUT; } // 读取验证 W25Q128_BufferRead(readback, addr, len); if (memcmp(expected, readback, len) != 0) { free(readback); return FLASH_VERIFY_FAIL; } free(readback); return FLASH_OK; } void FlashErrorHandler(FlashStatus status) { switch(status) { case FLASH_TIMEOUT: printf("[ERROR] Flash operation timeout\r\n"); break; case FLASH_VERIFY_FAIL: printf("[ERROR] Data verification failed\r\n"); break; case FLASH_WRITE_PROTECTED: printf("[ERROR] Flash is write protected\r\n"); break; case FLASH_INVALID_SECTOR: printf("[ERROR] Invalid sector address\r\n"); break; default: printf("[ERROR] Unknown flash error\r\n"); } // 尝试恢复操作 W25Q128_WriteDisable(); HAL_Delay(100); SPI5_Init(); // 重新初始化SPI }