流云轻落STM32CubeMX + HAL库实战：手把手教你驱动W25Q128存储数据（附完整工程）
在嵌入式开发中，外部Flash存储器常被用于扩展存储空间，保存日志、配置参数或传感器数据。W25Q128作为一款128M-bit的SPI Flash芯片，以其高性价比和稳定性受到开发者青睐。本文将基于STM32CubeMX和HAL库，从零开始构建完整的W25Q128驱动方案，特别适合需要在项目中快速集成Flash存储功能的开发者。
1. 硬件准备与CubeMX配置
1.1 硬件连接检查
W25Q128与STM32的典型连接方式如下：
| W25Q128引脚 | STM32引脚 | 功能说明 |
|---|---|---|
| CS | GPIOx_Py | 片选信号（低有效） |
| DO | MISO | 主设备输入从设备输出 |
| WP | VCC | 写保护（通常接高） |
| DI | MOSI | 主设备输出从设备输入 |
| CLK | SCK | 串行时钟 |
| GND | GND | 地线 |
| VCC | 3.3V | 电源 |
注意：确保硬件连接正确，特别是片选引脚(CS)必须连接到普通GPIO而非SPI_NSS，以便软件控制。
1.2 CubeMX SPI配置步骤
- 打开CubeMX，选择对应STM32型号
- 启用SPI接口（通常SPI1）：
- Mode: Full-Duplex Master
- Hardware NSS: Disabled
- 配置参数：
c复制Prescaler: 256 (初始建议值，后续可优化) Clock Polarity: Low Clock Phase: 1 Edge Data Size: 8 bits First Bit: MSB - 为CS引脚分配GPIO：
- 选择任意GPIO，配置为Output Push-Pull
- 初始电平设置为High（不选中状态）
1.3 时钟配置建议
- SPI时钟不宜过高，W25Q128最高支持104MHz，但实际使用建议：
- 初次调试：≤1MHz
- 稳定运行：≤25MHz
- 在Clock Configuration中确保系统时钟足够支持所需SPI速度
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 驱动文件结构与工程集成
2.1 文件组织规范
推荐的项目文件结构：
code复制/Drivers
/BSP
w25qxx.h # 驱动头文件
w25qxx.c # 驱动实现
/Inc
/config
w25qxx_conf.h # 硬件配置
/Src
main.c # 应用代码
2.2 关键头文件配置
w25qxx_conf.h示例：
c复制#pragma once
// 硬件依赖配置
#define W25QXX_SPI_HANDLE hspi1
#define W25QXX_CS_GPIO_PORT GPIOA
#define W25QXX_CS_PIN GPIO_PIN_4
// 设备类型检测
#define W25Q128_ID 0xEF17
w25qxx.h中需要包含HAL库支持：
c复制#include "stm32f4xx_hal.h"
#include "w25qxx_conf.h"
2.3 驱动初始化流程
完整的初始化函数实现：
`