告别手册恐惧症：手把手教你用STM32CubeMX驱动W25Q16 Flash（附完整代码）
从零玩转W25Q16 Flash：STM32CubeMX实战指南
第一次拿到W25Q16 Flash芯片时，面对密密麻麻的英文手册和SPI协议，相信不少嵌入式开发者都会感到无从下手。本文将带你用STM32CubeMX和HAL库，一步步实现从芯片驱动到数据读写的完整流程。不同于单纯的手册翻译，我们会聚焦如何将理论转化为可运行的代码，并分享实际开发中容易踩坑的细节。
1. 环境搭建与工程配置
在开始编写代码前，我们需要准备好开发环境。这里推荐使用STM32CubeMX进行初始化配置，它能极大简化外设设置过程。
1.1 硬件连接
W25Q16通过SPI接口与STM32通信，典型连接方式如下：
| W25Q16引脚 | STM32引脚 | 功能说明 |
|---|---|---|
| CS | GPIO_PINx | 片选信号（低电平有效） |
| DO | MISO | 主设备输入，从设备输出 |
| DI | MOSI | 主设备输出，从设备输入 |
| CLK | SCK | 时钟信号 |
| VCC | 3.3V | 电源 |
| GND | GND | 地线 |
提示：片选信号(CS)可以使用任意GPIO引脚控制，不一定要使用硬件SPI的NSS引脚。
1.2 CubeMX配置
- 打开STM32CubeMX，选择你的STM32型号
- 启用SPI外设（SPI1或SPI2等）
- 配置SPI参数：
- Mode: Full-Duplex Master
- Hardware NSS: Disable
- Prescaler: 根据主频选择适当分频（建议先使用低速如256分频调试）
- Clock Polarity: Low
- Clock Phase: 1 Edge
- 为CS引脚配置一个GPIO输出模式（推挽输出，初始高电平）
- 生成代码前，确保勾选了"HAL库"选项
// 生成的SPI初始化代码示例（HAL库） hspi1.Instance = SPI1; hspi1.Init.Mode = SPI_MODE_MASTER; hspi1.Init.Direction = SPI_DIRECTION_2LINES; hspi1.Init.DataSize = SPI_DATASIZE_8BIT; hspi1.Init.CLKPolarity = SPI_POLARITY_LOW; hspi1.Init.CLKPhase = SPI_PHASE_1EDGE; hspi1.Init.NSS = SPI_NSS_SOFT; hspi1.Init.BaudRatePrescaler = SPI_BAUDRATEPRESCALER_256; hspi1.Init.FirstBit = SPI_FIRSTBIT_MSB; hspi1.Init.TIMode = SPI_TIMODE_DISABLE; hspi1.Init.CRCCalculation = SPI_CRCCALCULATION_DISABLE; hspi1.Init.CRCPolynomial = 10;2. 基础驱动函数实现
有了SPI基础配置后，我们需要实现几个核心功能函数来操作W25Q16。
2.1 片选控制
片选信号(CS)是SPI通信中区分设备的关键。我们需要实现简单的控制函数：
#define W25Q_CS_PIN GPIO_PIN_4 #define W25Q_CS_PORT GPIOA void W25Q_CS_LOW(void) { HAL_GPIO_WritePin(W25Q_CS_PORT, W25Q_CS_PIN, GPIO_PIN_RESET); } void W25Q_CS_HIGH(void) { HAL_GPIO_WritePin(W25Q_CS_PORT, W25Q_CS_PIN, GPIO_PIN_SET); }2.2 基本读写函数
实现SPI的读写函数，用于发送指令和接收数据：
uint8_t W25Q_SPI_ReadWriteByte(uint8_t data) { uint8_t ret; HAL_SPI_TransmitReceive(&hspi1, &data, &ret, 1, 100); return ret; }2.3 状态检测
W25Q16在执行写入或擦除操作时，需要轮询状态寄存器判断是否完成：
uint8_t W25Q_ReadStatusReg1(void) { uint8_t status; W25Q_CS_LOW(); W25Q_SPI_ReadWriteByte(0x05); // Read Status Register-1指令 status = W25Q_SPI_ReadWriteByte(0xFF); W25Q_CS_HIGH(); return status; } void W25Q_WaitForWriteComplete(void) { while(W25Q_ReadStatusReg1() & 0x01); // 检查BUSY位 }3. 核心功能实现
掌握了基础函数后，我们可以实现W25Q16的核心功能。
3.1 写使能与擦除
在执行任何写入操作前，必须先发送写使能指令：
void W25Q_WriteEnable(void) { W25Q_CS_LOW(); W25Q_SPI_ReadWriteByte(0x06); // Write Enable指令 W25Q_CS_HIGH(); }扇区擦除是Flash操作中最常用的擦除方式：
void W25Q_SectorErase(uint32_t addr) { W25Q_WriteEnable(); W25Q_CS_LOW(); W25Q_SPI_ReadWriteByte(0x20); // Sector Erase指令 W25Q_SPI_ReadWriteByte((addr >> 16) & 0xFF); // 地址高位 W25Q_SPI_ReadWriteByte((addr >> 8) & 0xFF); // 地址中位 W25Q_SPI_ReadWriteByte(addr & 0xFF); // 地址低位 W25Q_CS_HIGH(); W25Q_WaitForWriteComplete(); }3.2 页编程与数据读取
页编程是向Flash写入数据的主要方式：
void W25Q_PageProgram(uint32_t addr, uint8_t *data, uint16_t len) { W25Q_WriteEnable(); W25Q_CS_LOW(); W25Q_SPI_ReadWriteByte(0x02); // Page Program指令 W25Q_SPI_ReadWriteByte((addr >> 16) & 0xFF); W25Q_SPI_ReadWriteByte((addr >> 8) & 0xFF); W25Q_SPI_ReadWriteByte(addr & 0xFF); for(uint16_t i=0; i<len; i++) { W25Q_SPI_ReadWriteByte(data[i]); } W25Q_CS_HIGH(); W25Q_WaitForWriteComplete(); }数据读取相对简单，但要注意时序：
void W25Q_ReadData(uint32_t addr, uint8_t *buf, uint16_t len) { W25Q_CS_LOW(); W25Q_SPI_ReadWriteByte(0x03); // Read Data指令 W25Q_SPI_ReadWriteByte((addr >> 16) & 0xFF); W25Q_SPI_ReadWriteByte((addr >> 8) & 0xFF); W25Q_SPI_ReadWriteByte(addr & 0xFF); for(uint16_t i=0; i<len; i++) { buf[i] = W25Q_SPI_ReadWriteByte(0xFF); } W25Q_CS_HIGH(); }4. 实战技巧与常见问题
在实际项目中，有几个关键点需要特别注意。
4.1 跨页写入处理
W25Q16的页大小为256字节，如果写入数据跨越页边界，需要特殊处理：
void W25Q_WriteMultiPage(uint32_t addr, uint8_t *data, uint32_t len) { uint32_t pos = 0; while(pos < len) { uint16_t chunk = 256 - (addr % 256); // 当前页剩余空间 if(chunk > (len - pos)) { chunk = len - pos; } W25Q_PageProgram(addr, &data[pos], chunk); addr += chunk; pos += chunk; } }4.2 读写速度优化
默认SPI配置可能速度较慢，调试稳定后可以调整预分频值：
// 在初始化后调整SPI速度 void W25Q_SetHighSpeed(void) { hspi1.Instance->CR1 &= ~SPI_BAUDRATEPRESCALER_256; hspi1.Instance->CR1 |= SPI_BAUDRATEPRESCALER_4; }4.3 常见问题排查
遇到通信失败时，可以按以下步骤排查：
检查硬件连接
- 确认所有引脚连接正确
- 测量电源电压是否稳定(3.3V±10%)
- 检查地线连接是否良好
验证SPI基本通信
- 使用逻辑分析仪抓取SPI波形
- 检查时钟极性和相位设置
- 确认片选信号时序符合要求
Flash特定问题
- 确保在执行写入/擦除操作前发送了写使能指令
- 检查地址是否对齐到页或扇区边界
- 轮询状态寄存器确认操作完成
在实际项目中，我发现最容易出错的地方是片选信号的时序控制。有些情况下需要在指令之间保持足够的CS高电平时间，否则Flash可能无法正确识别后续指令。