【开箱即用】STM32F407 用 SPI 三步搞定 W25Q128 Flash 读写:完整工程一步到位
【开箱即用】STM32F407 用 SPI 三步搞定 W25Q128 Flash 读写:完整工程一步到位
STM32-F407SPI通讯协议读取与写入Flash数据 这个仓库做的事情很直接:用 STM32F407 的 SPI 外设,把 W25Q128 这块 128 Mbit 的串行 Flash 当成外部存储器,随时读、随时写。主板上塞一颗这种芯片,程序、配置、日志数据就不用和代码抢那几百 KB 片内 RAM 了——很多"数据掉电保存"的需求,靠它一个器件就能闭环。
先看懂数据流向
整条链路只有三个角色:
- STM32F407 当主设备,SPI 外设以 Master 身份发出时钟和数据;
- SPI 总线 只有 SCK、MOSI、MISO 加一条片选 CS,半双工但带宽富余;
- W25Q128 当从设备,内部把 16 MB 存储切成 256 字节一页,靠命令字区分操作。
选 SPI 而不是 I²C,理由很实际:W25Q128 最高支持 16 MHz,搬大块数据时 I²C 的几十 kbit/s 级别根本喂不饱它;而且 CS 是独立引脚,将来并挂第二颗 Flash 也只是多拉一根线的事。
接线对照表与软件准备
硬件侧照这张表连即可,W25Q128 选 3.3 V 模块:
| W25Q128 | STM32F407 | 说明 |
|---|---|---|
| SCK | PA5 (SPI1_SCK) | 时钟输出 |
| MOSI | PA6 (SPI1_MISO) | MCU 发数据 |
| MISO | PA7 (SPI1_MOSI) | MCU 收数据 |
| CS | PB6 | 软件 GPIO 拉低选中 |
| WP / HOLD | 接 VCC | 悬空或误接会锁死写操作 |
| VCC / GND | 3.3 V / GND | 电源共地 |
软件侧准备:Keil MDK 或 STM32CubeIDE 任选,驱动用官方 HAL 库;核心依赖就两个初始化函数——SPI_Init() 配置总线、HAL_GPIO_WritePin() 控制片选。完整工程在仓库根目录的 407-12-SPI-FLASH.rar 里,解压后按板级文件结构搭工程即可。
配置 SPI:Mode 0 是关键
W25Q128 在标准 SPI 模式下认 MODE 0(CPOL=0,CPHA=0),8 位帧、Master、MSB 先发,时钟分频给个 2~4 分频(8~16 MHz)足够稳定。
为什么单独强调这一条:极性配反不会报错,MISO 上会吐出一串看似连续的垃圾数据,调试起来比"完全没数据"更迷惑。
发送 0x9F 读出芯片 ID
通电后第一件事不是读写数据,而是发 0x9F(Read JEDEC ID)命令,后面跟 3 个 dummy 字节,正确响应应为 0x01 0xEF 0x40——W25Q 系列的厂商标识加容量码。
这一步是最低成本的硬件体检:ID 读对了,说明 SCK、MOSI、MISO 三根线和供电全都没接错,后面所有软件问题都排除了接线嫌疑。
写数据:三步缺一不可
写入的最小流程可以浓缩成这样(对应工程里的 Flash 写函数):
spi_send_byte(0x06); // Write Enable,置 WEL 位
spi_send_byte(0x02); // Page Program
spi_send_byte(addr >> 16); // 24 位地址,高字节先发
spi_send_byte(addr >> 8);
spi_send_byte(addr);
// 随后循环读 0x05 状态寄存器,BUSY 清零才算写完
为什么必须带 0x06:W25Q128 内部有个 WEL 写使能锁存位,不先解锁,0x02 命令会被芯片静默丢弃,现象是代码跑完没报错、读回来却是旧数据。写完还要轮询 0x05 状态寄存器的 BUSY 位,不能拍脑袋延时。
读数据与跨页写入
读取很简单:发 0x03 + 24 位地址,之后持续发 dummy 字节,MISO 上吐回的就是数据,想读多少读多少。
写入则要克制:Page Program 每次最多 256 字节且不能跨页。正确姿势是按 256 字节分块,每块走完"使能—写入—等 BUSY 清零"循环;如果数据跨了页边界,下一块必须从页首地址重新发一次 0x02,不能顺延。
⚠️ 避坑清单
- 现象:写入静默失败,读回旧值。原因:WEL 位在写完一次后就被芯片复位。解法:每页写入前都补发一次 0x06;大批量写入可换
0xD8(Write Enable Any),写完全部后再用0xC0恢复保护。 - 现象:程序卡死或读到乱码。原因:BUSY 位轮询超时没处理,或把轮询写成了固定
delay_ms。解法:循环读 0x05 检查 bit0,配合超时计数兜底。 - 现象:上电后 ID 读不回。原因:CS 引脚方向配成了输入,或 WP/HOLD 悬空被内部弱上拉锁住。解法:CS 用 GPIO 推挽输出、平时拉高;WP 和 HOLD 直接接 VCC。
- 现象:写进去的数据时好时坏。原因:用了 2.5 V 的 W25Q 模块接 3.3 V MCU,电平不匹配。解法:换 3.3 V 版本模块,或中间加电平转换。
- 现象:写到 256 字节倍数后地址跳变。原因:内部地址计数器在页边界回绕到页首,继续发数据会覆盖页内前面内容。解法:跨页时重新发 0x02 并给新地址。
收尾
这套方案的价值在于把"外部 Flash 存取"这件容易踩坑的事压成了三步:配置 MODE 0、验证 ID、按流程写读。完整工程源码就在 407-12-SPI-FLASH.rar,上手路径:解压工程 → 先跑 ID 读取验证接线 → 再试 Page Program 和 Read Data。项目说明见 README.md,开源协议见 LICENSE。