1. 从零开始:为什么你的项目需要SPI和Flash?
如果你玩过正点原子的STM32F4开发板,肯定对点亮LED、驱动屏幕这些基础操作不陌生了。但当你做的项目稍微复杂一点,比如想做个数据采集器,需要把传感器数据存起来,或者想做个简单的文件系统,你就会发现一个问题:STM32F4自带的SRAM和Flash容量不够用了。这时候,你就需要外挂一个“大硬盘”——这就是我们常说的外部Flash芯片,比如W25Q128。
我刚开始做项目的时候,也遇到过这种尴尬。当时想做一个长时间记录温湿度的小设备,数据量不大,但需要掉电保存。一开始傻乎乎地想用单片机内部的Flash来存,结果发现写操作特别麻烦,还要整页擦除,一不小心就把程序给擦没了,真是踩了个大坑。后来老工程师指点我,说“你为啥不用SPI Flash呢?便宜、容量大、接口简单”。这才让我真正开始研究SPI通信和W25Q128。
SPI,全称是Serial Peripheral Interface,你可以把它理解成单片机和其他芯片之间说“悄悄话”的一种方式。它比我们熟悉的I2C要快得多,是全双工的,也就是能同时“听”和“说”。而W25Q128,就是那个能存16兆字节数据的“大仓库”,相当于你给STM32配了个U盘。通过SPI这根“电话线”,STM32就能自由地往这个“仓库”里存东西、取东西了。
这个组合在实战中应用太广了。比如,你的智能手环需要存储运动轨迹和睡眠数据;你的物联网设备需要缓存网络数据包;甚至你想在液晶屏上显示一张图片,都可以先把图片存到W25Q128里,需要的时候再读出来。掌握了它,你的嵌入式开发技能就从“点亮小灯”升级到了“处理复杂数据”,能玩的东西一下子就多了起来。
2. 硬件连接:把线接对,就成功了一半
搞嵌入式开发,硬件是基础,线接错了,代码写得再漂亮也是白搭。正点原子探索者STM32F407开发板已经非常贴心地帮我们把W25Q128和STM32F4的SPI1接口连好了,但我们还是得搞清楚它们是怎么“牵手”的,这样以后自己画板子或者换其他芯片心里才有底。
2.1 认识SPI的“四根金线”
SPI通信通常只需要四根线,比I2C还少一根(I2C有SDA和SCL两根)。但这四根线各有各的职责,一根都不能乱:
- SCLK (Serial Clock):时钟线,由主机(也就是我们的STM32)产生。你可以把它想象成乐队指挥的指挥棒,它挥一下,所有乐手(从设备)就动一下。数据的发送和接收节奏全靠它来同步。
- MOSI (Master Out Slave In):主机输出,从机输入。这是STM32对W25Q128“说话”的通道。比如STM32说:“我要往地址0x1000写数据0xAA”,这个命令就是通过MOSI线传过去的。
- MISO (Master In Slave Out):主机输入,从机输出。这是W25Q128对STM32“回话”的通道。当STM32问:“0x1000地址里存的是啥?” W25Q128就会通过MISO线把数据0xAA送回来。
- CS/SS (Chip Select / Slave Select):片选线。这根线是关键中的关键!SPI总线理论上可以挂很多个从设备,大家都连着SCLK、MOSI、MISO。那STM32怎么知道现在是在跟谁说话呢?就是靠片选线。当STM32想和W25Q128通信时,就把连接W25Q128的那根CS线拉低(通常是低电平有效),相当于点名:“W25Q128,你出来一下”。其他从设备的CS线保持高电平,它们就会自动进入“静音”模式,不理睬总线上的信号。
在探索者开发板上,W25Q128的这四根线是和STM32F407的SPI1接口固定连接的:
- W25Q128 CLK -> PB3 (SPI1_SCK)
- W25Q128 DO -> PB4 (SPI1_MISO)
- W25Q128 DI -> PB5 (SPI1_MOSI)
- W25Q128 CS -> PB14 (普通GPIO,软件控制)
这里注意一个细节:CS线没有接到STM32的硬件NSS引脚上,而是用了一个普通的GPIO口(PB14)来控制。这是因为硬件NSS管理起来有时不够灵活,用软件控制CS我们可以更自由地控制通信的起始和结束时刻。
2.2 一个容易忽略的“坑”:器件分时复用
正点原子的板子上还有一个设计需要我们特别注意:W25Q128和无线模块NRF24L01共用同一组SPI1接口。它们的SCK、MISO、MOSI是并联在一起的,区别只在于CS片选线不同。
| 器件 | CS引脚 | 状态 |
|---|---|---|
| W25Q128 | PB14 | 低电平选中 |
| NRF24L01 | PG8 | 低电平选中 |
这带来一个非常重要的原则:同一时间,只能有一个器件的CS线被拉低。如果你想操作Flash,就必须确保NRF24L01的CS(PG8)是高电平;反之亦然。如果同时拉低,两个器件都会响应总线上的数据,必然导致通信混乱,数据读写出错。我在早期调试时就犯过这个错,同时初始化了两个器件,结果数据死活不对,排查了好久才发现是片选冲突。所以,在软件设计上,一定要养成“操作谁,就选谁;不操作,就放开”的好习惯。
3. 软件配置:让STM32的SPI1动起来
硬件通路打通了,接下来就是软件配置,告诉STM32的SPI外设该怎么工作。STM32的SPI功能很强大,配置项也多,但跟着步骤走,一步步来并不难。
3.1 初始化SPI的五个核心步骤
初始化SPI就像给一个新员工做岗前培训,得把规矩一条条讲清楚。
第一步,开启时钟和配置引脚复用。 单片机内部任何外设要工作,都得先给它供电(开时钟)。SPI1的时钟挂在APB2总线上,所以先要使能SPI1和对应GPIO口的时钟。然后,要把PB3、PB4、PB5这三个引脚从普通的“输入输出”模式,切换到“复用功能”模式,并且指定为SPI1的复用功能AF5。这样,这些引脚才真正连接到了内部的SPI1模块上,而不是被GPIO模块控制。
// 1. 使能GPIOB和SPI1的时钟
RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOB, ENABLE);
RCC_APB2PeriphClockCmd(RCC_APB2Periph_SPI1, ENABLE);
// 2. 初始化PB3,4,5为复用推挽输出
GPIO_InitStructure.GPIO_Pin = GPIO_Pin_3 | GPIO_Pin_4 | GPIO_Pin_5;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF; // 复用功能
GPIO_InitStructure.GPIO_OType = GPIO_OType_PP; // 推挽输出
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_100MHz; // 高速
GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_UP; // 上拉
GPIO_Init(GPIOB, &GPIO_InitStructure);
// 3. 将引脚映射到SPI1复用功能上
GPIO_PinAFConfig(GPIOB, GPIO_PinSource3, GPIO_AF_SPI1);
GPIO_PinAFConfig(GPIOB, GPIO_PinSource4, GPIO_AF_SPI1);
GPIO_PinAFConfig(GPIOB, GPIO_PinSource5, GPIO_AF_SPI1);
第二步,配置SPI工作模式。 这是最关键的一步,通过填充一个SPI_InitTypeDef结构体来完成。这里有几个参数需要你根据W25Q128的数据手册来定:
- SPI_Mode: 我们当然是主机模式 (
SPI_Mode_Master)。 - SPI_Direction: 选择全双工 (
SPI_Direction_2Lines_FullDuplex),这样收发可以同时进行。 - SPI_DataSize: 数据帧8位 (
SPI_DataSize_8b),这是最常用的。 - SPI_CPOL 和 SPI_CPHA: 这两个决定了时钟极性和相位,也就是SPI的“工作模式”。W25Q128通常支持模式0和模式3。在正点原子的例程里,他们选择了
CPOL=1(时钟空闲时为高电平),CPHA=1(在第二个时钟边沿采样数据),这对应的是模式3。这里必须和从设备匹配,否则数据采样会错位。 - SPI_NSS: 我们用的是软件控制片选,所以选
SPI_NSS_Soft。 - SPI_BaudRatePrescaler: 波特率预分频,决定通信速度。初始化为
256分频,速度较慢(约328KHz),有利于提高初始通信的稳定性。后面可以动态调整加快速度。 - SPI_FirstBit: 数据传输顺序,选择
MSB(高位在前),这也是最常见的。
第三步,使能SPI外设。 调用SPI_Cmd(SPI1, ENABLE),SPI1就开始待命了。
第四步,编写数据收发函数。 STM32库函数提供了SPI_I2S_SendData发送和SPI_I2S_ReceiveData接收函数。但实际使用时,我们通常封装一个SPI_ReadWriteByte函数,因为SPI收发是同步的,发送一个字节的同时也会收到一个字节。
u8 SPI1_ReadWriteByte(u8 TxData) {
// 等待发送缓冲区为空(可以发送新数据了)
while (SPI_I2S_GetFlagStatus(SPI1, SPI_I2S_FLAG_TXE) == RESET);
SPI_I2S_SendData(SPI1, TxData); // 扔一个字节进去发送
// 等待接收缓冲区非空(数据已经收到了)
while (SPI_I2S_GetFlagStatus(SPI1, SPI_I2S_FLAG_RXNE) == RESET);
return SPI_I2S_ReceiveData(SPI1); // 把收到的字节读出来
}
第五步,动态调整SPI速度。 初始化时用低速保证稳定,在确认通信正常后,我们可以提速。W25Q128最高支持80MHz的SPI时钟,但STM32F4的APB2时钟是84MHz,所以最快可以设置到42MHz分频(2分频)。我一般会写一个速度设置函数,在读写不同阶段灵活切换速度。
void SPI1_SetSpeed(u8 SPI_BaudRatePrescaler) {
SPI1->CR1 &= 0xFFC7; // 清除原来的分频设置位
SPI1->CR1 |= SPI_BaudRatePrescaler; // 设置新的分频值
}
// 调用示例:SPI1_SetSpeed(SPI_BaudRatePrescaler_4); // 设置为21MHz
3.2 理解SPI的四种模式与时序
很多新手配置SPI出错,八成是栽在CPOL和CPHA这两个参数上。我刚开始也总混淆,后来用示波器抓了一下波形才彻底明白。
你可以把SPI通信想象成两个人(主机和从机)在时钟的“滴答”声下传递小纸条。CPOL决定了时钟线在空闲不传数据时,是“高电平举着手”(CPOL=1)还是“低电平垂着手”(CPOL=0)。CPHA则决定了是在“滴”声(第一个边沿)时传递/接收纸条,还是在“答”声(第二个边沿)时。
对于W25Q128,数据手册明确写了它支持模式0(CPOL=0, CPHA=0)和模式3(CPOL=1, CPHA=1)。正点原子例程用了模式3。怎么验证你配对了呢?最好的办法就是用逻辑分析仪或者示波器,抓一下CS拉低后第一个时钟周期的波形,对照数据手册的时序图看,数据线(MOSI)上的变化是否发生在正确的时钟边沿。这是硬件调试的必备技能,能帮你省下大量瞎猜的时间。
4. 深入W25Q128:不仅仅是简单的读写
把SPI调通后,我们就要来认识一下W25Q128这位“仓库管理员”了。它可不是一个简单的存储单元,内部有复杂的结构和一套完整的指令集。
4.1 芯片内部结构与寻址方式
W25Q128容量是128Mb,也就是16MB。它把这16MB的空间像一本书一样组织起来:
- 全书(Chip):16MB。
- 章(Block):共256章,每章64KB。
- 节(Sector):每章有16节,每节4KB。
- 页(Page):每节有16页,每页256字节。
这里有个至关重要的特性:W25Q128的最小擦除单位是扇区(Sector),也就是4KB! 这意味着,哪怕你只想改其中一个字节,也必须先把包含这个字节的整个4KB扇区数据读出来,在内存中修改好,然后擦除整个扇区,最后再把4KB数据全部写回去。这是和操作EEPROM最大的不同,也是新手最容易犯错的地方。我当年就曾试图直接覆盖某个地址的数据,结果发现数据根本没变,还以为是芯片坏了。
它的地址是24位的,最大可以寻址16MB空间。在发送读写命令后,需要连续发送3个字节(24位)的地址。比如要操作地址0x123456,就依次发送0x12, 0x34, 0x56。
4.2 核心指令与读写流程剖析
和W25Q128通信,就是向它发送特定的指令(Command)。这些指令都是8位的,比如读数据是0x03,写使能是0x06,扇区擦除是0x20。
读操作流程是最简单的:
- 拉低CS片选。
- 发送读指令(0x03)。
- 发送24位地址。
- 然后就可以连续地从MISO线上读取数据了,芯片内部的地址指针会自动递增,你一直读,它就一直给,直到你拉高CS结束通信。
void W25QXX_Read(u8* pBuffer, u32 ReadAddr, u16 NumByteToRead) {
u16 i;
W25QXX_CS = 0; // 选中芯片
SPI1_ReadWriteByte(W25X_ReadData); // 发送读指令 0x03
SPI1_ReadWriteByte((u8)((ReadAddr)>>16)); // 发送地址高8位
SPI1_ReadWriteByte((u8)((ReadAddr)>>8)); // 发送地址中8位
SPI1_ReadWriteByte((u8)ReadAddr); // 发送地址低8位
for(i=0; i<NumByteToRead; i++) {
pBuffer[i] = SPI1_ReadWriteByte(0XFF); // 循环读数,发送0xFF产生时钟
}
W25QXX_CS = 1; // 释放芯片
}
写操作流程则复杂得多,必须遵循“擦除-写入”的步骤,并且写入前必须发送“写使能”指令(0x06):
- 发送写使能指令(0x06)。
- 等待芯片内部“忙”状态结束(通过读状态寄存器1判断)。
- 发送页编程指令(0x02)或扇区擦除指令(0x20)。
- 发送地址和数据。
- 再次等待“忙”状态结束。
一个健壮的写函数必须要处理跨扇区的问题。正点原子提供的W25QXX_Write函数就做了很好的封装:它先计算起始地址所在的扇区,判断要写的数据是否会超出这个扇区。如果超出,就把第一个扇区剩余部分写完,然后地址跳到下一个扇区,循环处理。在写每个扇区前,它会先读出整个扇区的旧数据,检查是否需要擦除(判断是否有非0xFF的字节),如果需要,则先擦除整个扇区,再把新老数据合并后写回。这个逻辑稍微有点绕,但却是安全操作SPI Flash的黄金法则。
4.3 状态寄存器与保护机制
W25Q128内部有几个状态寄存器,其中状态寄存器1(Status Register 1) 最常用。它的第0位(BUSY位)尤其重要:当芯片正在执行写、擦除等内部操作时,这位是1;操作完成后,这位自动清零。在任何写或擦除操作后,都必须轮询等待BUSY位变为0,才能进行下一步操作,否则会导致数据错误或指令不被响应。
此外,状态寄存器还提供了写保护(WP)、上电写保护等功能。比如,你可以通过写状态寄存器把某些扇区设置为只读,防止程序跑飞意外篡改关键数据。在项目实践中,我通常会把存放系统参数、校准数据的区域进行写保护,增加系统的鲁棒性。
5. 实战代码解析:从初始化到完整读写
理论说得再多,不如一行代码来得实在。我们结合正点原子的例程,看看一个完整的SPI Flash操作项目是怎么搭建起来的。
5.1 工程框架与初始化顺序
在MDK工程里,除了主函数main.c,我们主要会用到这几个文件:
spi.c/h:封装了SPI1的初始化、速度设置和字节读写函数。这是底层驱动。w25qxx.c/h:封装了W25Q128的各种指令操作,如读ID、读数据、写数据、擦除等。这是器件驱动。main.c:应用层逻辑,调用驱动函数完成业务功能。
正确的初始化顺序很重要:
int main(void) {
delay_init(168); // 1. 初始化系统时钟和延时
uart_init(115200); // 2. 初始化串口(用于调试打印)
LED_Init(); // 3. 初始化LED(状态指示)
LCD_Init(); // 4. 初始化LCD(显示界面)
KEY_Init(); // 5. 初始化按键(用户输入)
SPI1_Init(); // 6. 初始化SPI1硬件
W25QXX_Init(); // 7. 初始化W25Q128(实质是初始化CS引脚GPIO)
// ... 后续应用代码
}
W25QXX_Init()函数主要就是初始化连接CS脚的GPIO(PB14)为推挽输出,并默认拉高(不选中)。然后通常会尝试读取芯片的JEDEC ID(通常用0x9F指令)来检测芯片是否存在。这是硬件自检的关键一步。
5.2 关键函数拆解与优化
让我们深入看看W25QXX_Write这个核心函数,它体现了处理Flash擦写特性的完整思路。
- 参数与缓存:函数接收要写入的数据指针、起始地址和长度。它内部定义了一个4KB的全局数组
W25QXX_BUFFER,用作扇区缓存。 - 计算扇区位置:
secpos = WriteAddr / 4096;计算出地址属于第几个扇区。secoff = WriteAddr % 4096;计算出在扇区内的偏移量。 - 处理首扇区:判断要写入的数据长度是否超过第一个扇区的剩余空间。然后,将整个目标扇区4KB数据读入缓存。接着,检查缓存中从偏移量
secoff开始、长度为本次要写入数据secremain的区域内,是否有字节不是0xFF。如果有任何一个不是0xFF,说明这个位置之前写过数据,必须执行擦除。 - 擦除与合并:如果需要擦除,就调用
W25QXX_Erase_Sector(secpos)擦除整个扇区。擦除后,扇区所有位变为1(0xFF)。然后,将缓存中的旧数据(已读入)和要写入的新数据在内存中合并,覆盖到缓存数组的对应位置。 - 写入扇区:调用
W25QXX_Write_NoCheck函数,将合并好的4KB缓存数据,写回刚才擦除的扇区。这个函数内部会处理页编程(一次最多写256字节)和跨页的问题。 - 循环处理:如果数据还没写完,就更新扇区号、地址指针、数据指针和剩余长度,跳回第3步继续处理下一个扇区。
这个函数虽然保证了安全性,但频繁的“读-改-擦-写”会影响速度。一个重要的优化点是:如果你的应用场景是顺序写入大块新数据(比如日志),你可以自己记录写入位置,确保每次都写入全新的、未使用过的扇区。这样在写入前就可以跳过“读旧数据检查”和“擦除”的步骤,直接写入,速度会快很多倍。 这其实就是简易文件系统(如FATFS、LittleFS)在底层做的事情之一。
5.3 调试技巧与常见问题排查
调试SPI Flash时,逻辑分析仪是你的最佳伙伴。没有的话,串口打印调试信息也很有用。
问题一:根本读不到正确的ID。
- 检查硬件:首先用万用表量一下电源和地,再量一下CS、SCK、MOSI、MISO四根线是否连通。确认CS引脚初始化正确,默认是高电平。
- 检查时序模式:确认CPOL和CPHA设置与W25Q128匹配(尝试模式0和模式3)。用逻辑分析仪抓取发送0x9F指令(读ID)时的波形,看时序是否符合数据手册。
- 检查速度:把SPI速度降到最低(256分频)再试。
问题二:可以读ID,但不能读写数据。
- 检查写使能:在每次写或擦除操作前,是否成功发送了0x06(Write Enable)指令?可以通过读状态寄存器(0x05)来确认写使能锁存器(WEL)位是否被置1。
- 检查等待忙状态:写或擦除操作后,必须等待BUSY位清零。在
W25QXX_Write或擦除函数后,是否调用了W25QXX_Wait_Busy函数? - 检查地址:读写函数的24位地址计算是否正确?是否超出了16MB的范围?
问题三:写进去的数据,读出来不对。
- 擦除问题:是否忘记了擦除?Flash只能把1变成0,不能把0变成1。擦除操作是把整个扇区变成1(0xFF)。如果你要写入数据的位置原本不是0xFF,又没有擦除,写入就会失败。
- 跨页/跨扇区:你的写入操作是否跨越了页边界(256字节)或扇区边界(4KB)?自己写的简单写入函数需要处理这些边界情况,正点原子的
W25QXX_Write函数已经处理好了。 - 电源噪声:在写入瞬间,如果电源有较大波动,可能导致写入错误。确保电源稳定,并在芯片电源引脚附近放置一个0.1uF和10uF的电容进行退耦。
6. 项目进阶:构建更可靠的数据存储方案
当你掌握了基本的读写后,就可以考虑更实际的应用了。直接操作底层扇区就像直接往硬盘的物理扇区写数据,既危险又低效。我们需要构建更上层的存储方案。
方案一:实现简单的键值对存储。 对于存储一些系统配置参数(如Wi-Fi密码、设备ID、校准系数),你可以设计一个简单的结构体,并固定存储在Flash的某个或某几个扇区。例如:
typedef struct {
char ssid[32];
char password[64];
uint32_t device_id;
float calibration_factor;
uint8_t checksum; // 用于校验数据完整性
} SystemParams_t;
每次更新参数时,先擦除整个参数扇区,再将新的结构体数据写入。读取时,读出数据后计算校验和,与存储的checksum对比,判断数据是否有效。这种方法简单可靠,我很多小项目里都这么用。
方案二:移植文件系统(如FATFS或LittleFS)。 如果你需要存储大量文件,比如图片、音频、日志文件,移植一个文件系统是必经之路。FATFS兼容性好,可以在电脑上直接读取SD卡。LittleFS则专为Flash设计,具有掉电安全、磨损均衡等优点。
- FATFS:你需要实现FATFS要求的底层磁盘读写接口(
disk_read,disk_write),这些接口内部调用我们的W25QXX_Read和W25QXX_Write函数。还需要处理擦除(disk_ioctl中的CTRL_ERASE_SECTOR命令)。正点原子通常有现成的移植例程可以参考。 - LittleFS:同样需要实现
littlefs要求的read,prog,erase等接口。它的API更现代,能更好地处理Flash特性。
方案三:设计循环队列存储日志。 对于需要记录运行日志的应用(比如记录设备重启原因、错误代码),可以分配一块固定的Flash区域(比如最后64个扇区,256KB),将其视为一个环形的缓冲区。用一个变量在RAM中记录当前写入的地址。每次写日志,就追加到当前地址,写满一个扇区就擦除下一个扇区继续写。当写到区域的末尾时,再绕回到开头,覆盖最早的日志。这样你总能保存最新的一段日志,而不用担心Flash被写满。这是嵌入式设备中非常实用的一个技巧。
最后,再提一个性能优化点。在初始化完成、确认芯片工作正常后,记得把SPI的时钟速度提上去。在W25QXX_Init函数末尾或主循环开始前,调用SPI1_SetSpeed(SPI_BaudRatePrescaler_4),将时钟设置为21MHz(84MHz/4),你会发现读写速度有质的飞跃。当然,如果追求极限,可以尝试2分频(42MHz),但需要确保你的PCB布线质量好,信号完整性没问题。我在实际项目中,对于频繁读写Flash的操作,都会在操作前后动态切换速度,平时高速运行,在关键的命令发送和状态检查时短暂切回低速以保证稳定,这个平衡需要根据实际情况测试把握。
937



被折叠的 条评论
为什么被折叠?



