简介一套基于STM32F103的软件SPI读写W25Q64 Flash完整工程面向学习SPI通信的单片机开发者解决不使用硬件SPI外设时如何用GPIO模拟时序完成Flash数据读写。案例以W25Q64为从机、STM32为主机按SPI1外设引脚给出接线PA4接CS、PA5接CLK、PA6接DO、PA7接DI便于后续切换至硬件SPI继续学习。资源包共83个文件以36个h头文件、33个c源文件为主涵盖外设库、延时、按键、LED、OLED及W25Q64驱动等模块另有启动文件、工程配置和接线图压缩包仅1004KB结构清晰适合直接编译或移植复用。已有2052人学习可掌握软件SPI时序、W25Q64读写流程及工程模块划分方法。1. 软件SPI总线为什么非要用GPIO硬拼出W25Q64的时序做单片机开发久了你会发现一个反直觉的结论硬件SPI外设并不总是最省事的选择。某次我在一块开发板上调试W25Q64 flash存储器硬件SPI怎么都读不出正确的JEDEC ID示波器抓波形发现时钟线毛刺严重翻遍了芯片手册才发现是引脚复用冲突加上时钟极性配置被库函数默认值坑了。换了软件SPI——直接用GPIO模拟时序——十分钟就跑通了。这篇就拆一下这个思路不依赖STM32的SPI外设用普通GPIO模拟出W25Q64所需的全部时序实现读写flash存储器。适合刚接触STM32 SPI通信、或者被硬件SPI折腾到想换方案的单片机开发者也适合想彻底搞懂SPI时序本质的嵌入式入门者。2. 整体架构与工程结构软件SPI的层次设计2.1 为什么选W25Q64和软件SPIW25Q64是华邦生产的SPI NOR Flash容量64Mbit也就是8MByte256字节为一页4KB为一个扇区64KB为一个块。这个容量在嵌入式里非常百搭——存字库、存配置参数、存OTA固件都够用。它支持标准SPI、双输出、四输出等多种模式但最基础、最通用的还是标准SPI时序这就给了软件模拟一个很好的切入点。选择软件SPI而不是硬件SPI通常出于三个考虑。第一是引脚自由度硬件SPI往往绑定固定引脚PCB布线不方便的时候软件SPI可以随意映射到任意GPIO第二是抗干扰调试便利软件SPI的时序完全由代码控制时钟极性和相位怎么配、每bit之间延时多久都可以现场调出问题可以直接用逻辑分析仪对比代码逻辑第三是某些芯片的SPI时序比较特殊硬件外设适配起来反而麻烦比如需要在时钟中间切换数据线方向的双向IO场景。我之前在一个项目里用过某款带SPI接口的传感器硬件SPI死活读不到正确数据换成软件SPI把时钟拉慢到几百kHz一次就读通了。这不是说硬件SPI不好而是软件SPI在调试阶段确实更有掌控感。2.2 引脚分配与接线软件SPI的接线比硬件SPI直观很多四根线加电源地线全部接到普通GPIO上就行。这里以某常见开发板为例我选用了PA4、PA5、PA6、PA7四个引脚对应关系如下信号引脚GPIO模式说明CSPA4推挽输出片选低电平有效CLKPA5推挽输出时钟线空闲时为低MOSIPA7推挽输出主机输出从机输入MISOPA6浮空输入或上拉输入主机输入从机输出VCC3.3V-W25Q64供电GNDGND-共地注意MISO这根线软件SPI下它不需要配置为复用功能普通输入模式就够了。但是建议配置为上拉输入因为W25Q64的DO引脚在片选拉高后会变成高阻态如果没有上拉电阻读数据时第一个bit可能是随机电平。这里有个常见误用有人把MISO也配成推挽输出读数据的时候两个输出短接在一起轻则读数错误重则烧引脚。读方向时MISO必须是输入写方向时MOSI是输出这两根线的方向是固定的不需要像I2C那样切换方向这是SPI比I2C简单的地方。2.3 工程目录结构解析一个典型的软件SPI读写W25Q64工程目录结构大致如下Project/ ├── Core/ │ ├── Inc/ │ │ ├── main.h │ │ ├── soft_spi.h │ │ └── w25q64.h │ └── Src/ │ ├── main.c │ ├── soft_spi.c │ └── w25q64.c ├── Drivers/ │ ├── CMSIS/ │ └── STM32F1xx_HAL_Driver/ ├── Hardware/ │ └── usart.c └── MDK-ARM/重点看soft_spi.c和w25q64.c这两个文件。soft_spi.c负责最底层的GPIO模拟时序只做四件事起始、结束、读写一个字节w25q64.c是基于底层时序封装出来的芯片操作层包含读ID、擦除、页编程、读数据等功能。这种分层方式非常重要后续如果要把软件SPI换成硬件SPI只需要改soft_spi.c上面的w25q64.c一行都不用动。main.c里则是测试入口初始化GPIO、初始化串口、调用W25Q64的读写函数把结果通过串口打印到PC端观察。整个工程没有复杂的RTOS依赖裸机一套跑下来非常适合初学者理解完整的数据流。3. 核心代码实现从GPIO模拟到读写数据的完整链路3.1 软件SPI的时序基础SPI时序的基础是四个相位时钟极性CPOL和时钟相位CPHA。W25Q64支持模式0和模式3我们常用模式0即CPOL0、CPHA0意思是空闲时时钟为低电平数据在时钟上升沿采样在下降沿改变。这个细节对软件模拟至关重要。因为你是用GPIO手掰时序不是硬件自动处理必须明确知道什么时候拉高时钟、什么时候数据线上放数据、什么时候采样。搞反了数据就会错位。// W25Q64要求的数据时序MSB先行时钟上升沿采样 // 写数据时在时钟上升沿之前把数据放到MOSI上 // 读数据时在时钟下降沿之后从MISO上读取实际调试中我习惯先用逻辑分析仪抓一次读ID的波形对照芯片手册确认时钟极性和数据采样点是否正确。这一步省下来后面排查问题会花十倍时间。3.2 GPIO初始化与SPI起始/结束先看底层GPIO初始化。软件SPI的核心就是把这几个引脚设置成普通GPIO开启时钟配置模式。void Soft_SPI_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE); // CS、CLK、MOSI配置为推挽输出速度50MHz GPIO_InitStructure.GPIO_Pin GPIO_Pin_4 | GPIO_Pin_5 | GPIO_Pin_7; GPIO_InitStructure.GPIO_Mode GPIO_Mode_Out_PP; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOA, GPIO_InitStructure); // MISO配置为上拉输入 GPIO_InitStructure.GPIO_Pin GPIO_Pin_6; GPIO_InitStructure.GPIO_Mode GPIO_Mode_IPU; GPIO_Init(GPIOA, GPIO_InitStructure); // 空闲状态CS拉高CLK拉低 GPIO_SetBits(GPIOA, GPIO_Pin_4); GPIO_ResetBits(GPIOA, GPIO_Pin_5); }这里的重点是CS空闲时必须拉高CLK空闲时拉低对应模式0的CPOL0。GPIO速度配50MHz是为了保证边沿足够陡峭如果配成低速模式时钟频率提上来之后波形会变圆可能触发误采样。SPI通信的起始和结束很简单就是控制CS这根片选线。CS拉低表示主机开始与从机通信CS拉高表示通信结束。void Soft_SPI_Start(void) { GPIO_ResetBits(GPIOA, GPIO_Pin_4); // CS拉低选中W25Q64 } void Soft_SPI_Stop(void) { GPIO_SetBits(GPIOA, GPIO_Pin_4); // CS拉高释放W25Q64 }有人可能会问CS拉高之后W25Q64的DO引脚会变成高阻态这个要不要处理不需要硬件上高阻态就相当于断开了不会影响MOSI上的数据。3.3 SPI读写一个字节读写一个字节是整个软件SPI最核心的函数也是唯一真正模拟时序的地方。SPI是同步全双工协议主机发一个bit的同时会收到一个bit所以读和写在同一个函数里完成。uint8_t Soft_SPI_ReadWriteByte(uint8_t data) { uint8_t i; uint8_t receive 0; for (i 0; i 8; i) { // 先拉低时钟准备发送数据 GPIO_ResetBits(GPIOA, GPIO_Pin_5); // 发送当前bitMSB先行 if (data 0x80) GPIO_SetBits(GPIOA, GPIO_Pin_7); else GPIO_ResetBits(GPIOA, GPIO_Pin_7); data 1; // 给一点延时让数据稳定 Soft_SPI_Delay(); // 拉高时钟上升沿采样数据 GPIO_SetBits(GPIOA, GPIO_Pin_5); // 在上升沿读取MISO引脚 if (GPIO_ReadInputDataBit(GPIOA, GPIO_Pin_6)) receive | 0x01; receive 1; Soft_SPI_Delay(); } // 最后拉低时钟结束一个字节的传输 GPIO_ResetBits(GPIOA, GPIO_Pin_5); return receive; }逻辑说明每个bit的传输分为四步——拉低时钟、在MOSI上放数据、拉高时钟模拟上升沿、在上升沿后读取MISO。发送的数据从最高位开始每发送一个bit左移一次接收的数据也是从最高位开始累积每次或上一个bit后左移。循环8次完成一个字节。参数说明data是主机要发送的字节如果只是读取数据比如读ID操作传入0xFF即可因为SPI协议里主机不发时钟从机就无法输出数据发送0xFF只是提供时钟信号。Soft_SPI_Delay()是一个简单的空循环延时函数控制SPI时钟频率。在调试初期我一般把延时调大一点让时钟降到几百kHz方便逻辑分析仪抓波形确认时序正确后再逐步减小延时提高速度。这个延时也可以不用直接让GPIO翻转的固有延迟充当时序间隔但那样时钟频率就不可控了。3.4 读取JEDEC ID读取JEDEC ID是验证SPI通信是否正确的第一步也是最有成就感的步骤——如果ID读对了说明底层时序没问题后面操作flash就有底气。W25Q64的JEDEC ID指令是0x9F发送该指令后芯片会返回三个字节厂商ID、存储器类型、容量ID。W25Q64的三字节固定是0xEF、0x40、0x17。void W25Q64_ReadID(uint8_t *mid, uint8_t *type, uint8_t *did) { Soft_SPI_Start(); Soft_SPI_ReadWriteByte(0x9F); // 发送JEDEC ID读取指令 *mid Soft_SPI_ReadWriteByte(0xFF); // 读取厂商ID如0xEF *type Soft_SPI_ReadWriteByte(0xFF); // 读取存储器类型如0x40 *did Soft_SPI_ReadWriteByte(0xFF); // 读取容量ID如0x17 Soft_SPI_Stop(); }逻辑说明发送0x9F指令后W25Q64会从DO引脚连续输出三个字节的设备信息。主机只需要持续发送0xFF产生时钟同时读取MISO数据。Soft_SPI_Stop()拉高CS结束通信。这里有个细节值得注意读ID之前不需要发送写使能指令也没有写保护的限制因为读操作不改变flash内容。如果读ID都是0xFF说明时序大概率有问题常见原因是CLK极性和数据采样点不对。3.5 写使能与页编程写入数据是W25Q64操作中最复杂的一步因为flash写入前必须保证目标区域是擦除状态。W25Q64的写入单位是页一页256字节。写数据之前要发送写使能指令0x06让状态寄存器的WEL位变成1否则写操作会被忽略。void W25Q64_WriteEnable(void) { Soft_SPI_Start(); Soft_SPI_ReadWriteByte(0x06); // 写使能指令 Soft_SPI_Stop(); } void W25Q64_PageProgram(uint32_t addr, uint8_t *data, uint16_t len) { uint8_t i; W25Q64_WriteEnable(); Soft_SPI_Start(); Soft_SPI_ReadWriteByte(0x02); // 页编程指令 Soft_SPI_ReadWriteByte((addr 16) 0xFF); // 地址高字节 Soft_SPI_ReadWriteByte((addr 8) 0xFF); // 地址中字节 Soft_SPI_ReadWriteByte(addr 0xFF); // 地址低字节 // 写入数据 for (i 0; i len; i) { Soft_SPI_ReadWriteByte(data[i]); } Soft_SPI_Stop(); }逻辑说明页编程指令0x02后面跟24位地址然后是待写入的数据。W25Q64内部会在页缓冲区内写入数据然后再编程到存储阵列。注意一次最多只能写256字节如果地址跨越了页边界数据会回卷到页首这就需要额外处理。参数说明addr是24位地址范围0x000000到0x7FFFFF对应8MB空间。data是待写入数据的缓冲区指针len是数据长度最大256。地址分解为三个字节发送时要注意移位和掩码的配合(addr 16) 0xFF取最高字节addr 0xFF取最低字节。写使能操作每次写操作前都要执行读操作不需要。如果写完发现数据不对先检查是不是忘了调W25Q64_WriteEnable()。3.6 读取数据相比写入读取就简单多了不需要擦除、不需要写使能直接发送读数据指令0x03加24位地址然后持续读字节就行。void W25Q64_ReadData(uint32_t addr, uint8_t *buf, uint16_t len) { uint16_t i; Soft_SPI_Start(); Soft_SPI_ReadWriteByte(0x03); // 读数据指令 Soft_SPI_ReadWriteByte((addr 16) 0xFF); Soft_SPI_ReadWriteByte((addr 8) 0xFF); Soft_SPI_ReadWriteByte(addr 0xFF); // 连续读取len个字节 for (i 0; i len; i) { buf[i] Soft_SPI_ReadWriteByte(0xFF); // 发送0xFF产生时钟 } Soft_SPI_Stop(); }逻辑说明读数据指令0x03后面跟24位地址然后主机会连续发送0xFF来产生时钟脉冲W25Q64从DO引脚逐bit输出数据主机在每个时钟上升沿采样。这个操作可以连续读取多个字节地址自动递增直到CS拉高停止。注意buf缓冲区必须由调用者分配足够空间函数本身不做越界检查。我之前就犯过这个错误——读256字节数据缓冲区只开了100字节结果后面的变量全被冲掉了。嵌入式开发中这种低级错误最容易让人血压升高。3.7 状态寄存器与忙等待flash编程和擦除都需要时间W25Q64内部有一个忙状态位BUSY位于状态寄存器的bit 0。写入或擦除期间这个位为1完成后变为0。主机需要不断读取状态寄存器直到BUSY位清零才能进行下一次操作。void W25Q64_WaitBusy(void) { uint8_t status; Soft_SPI_Start(); Soft_SPI_ReadWriteByte(0x05); // 读状态寄存器指令 do { status Soft_SPI_ReadWriteByte(0xFF); } while (status 0x01); // 等待BUSY位清零 Soft_SPI_Stop(); }逻辑说明读状态寄存器指令0x05后面不跟地址主机发送0xFF读取状态寄存器的值。status 0x01判断BUSY位是否为1如果为1说明flash还在忙继续循环读取直到为0。这个函数看着简单实际坑不少。如果读ID正常但写入不成功多半是WaitBusy这里出了问题。比如读状态寄存器时CS拉高早了或者时钟极性和数据采样点没对上读到的状态永远不对导致死循环。在等待循环里加一个超时计数是更稳妥的做法防止flash异常时程序卡死。4. 运行与验证从编译到串口打印实验4.1 工程配置与编译拿到工程后第一步是配置编译环境。这里以Keil MDK为例也可以换成IAR或者STM32CubeIDE代码本身不挑编译器。打开工程后先检查芯片型号是否选对——用的是STM32F103系列就选对应的Device用的是其他系列就替换启动文件和设备头文件。编译前需要在魔术棒选项卡里检查两个配置一个是C语言标准建议选C99因为代码里用了在for循环内声明变量的写法C89标准会报错另一个是宏定义如果用HAL库版本需要确保USE_HAL_DRIVER和STM32F103xE这类芯片宏有定义。标准外设库版本则不需要。配置完成后直接编译如果代码是从头开始写的大概率会遇到一些基础错误。最常见的是GPIO时钟没使能就调用GPIO_Init这时候程序会跑飞或者直接HardFault。检查的顺序是时钟使能 → 引脚配置 → 外设初始化这个顺序不能乱。4.2 测试代码设计在main函数里我习惯的测试流程是初始化LED和串口 → 读取JEDEC ID并打印 → 擦除一个扇区 → 写入一组测试数据 → 读回数据并比对 → 打印测试结果。int main(void) { uint8_t mid, type, did; uint8_t write_buf[256]; uint8_t read_buf[256]; uint8_t i; delay_init(); USART_Init(115200); Soft_SPI_Init(); // 第一步读取JEDEC ID W25Q64_ReadID(mid, type, did); printf(MID:0x%02X, Type:0x%02X, DID:0x%02X\r\n, mid, type, did); // 第二步擦除扇区0地址0x000000 W25Q64_EraseSector(0x000000); W25Q64_WaitBusy(); // 第三步写入测试数据 for (i 0; i 256; i) { write_buf[i] i; } W25Q64_PageProgram(0x000000, write_buf, 256); W25Q64_WaitBusy(); // 第四步读回数据并校验 W25Q64_ReadData(0x000000, read_buf, 256); for (i 0; i 256; i) { if (write_buf[i] ! read_buf[i]) { printf(Compare Error at %d\r\n, i); break; } } if (i 256) { printf(Test Passed!\r\n); } while(1); }逻辑说明整个测试流程覆盖了读ID、擦除、写入、读回比对四个核心操作。测试数据从0到255写入每个字节如果擦除不彻底或者写入时序有问题比对过程会立刻暴露出来。这里有个值得注意的地方擦除操作必须在写入之前执行而且擦除的单位是扇区而不是页。如果只往一个没擦除过的地址写入数据读回的可能是旧数据和写入数据按位与的混合结果看起来就像写入失败。4.3 串口打印与结果判断串口打印是嵌入式开发中最常用的调试手段。测试代码里用printf输出结果需要把printf重定向到串口标准做法是在代码里实现fputc函数int fputc(int ch, FILE *f) { USART_SendData(USART1, (uint8_t)ch); while (USART_GetFlagStatus(USART1, USART_FLAG_TXE) RESET); return ch; }注意在Keil里要勾选微库MicroLib否则printf会占用大量代码空间F103这种小容量芯片很容易爆flash。连接到PC后打开串口助手波特率设置和代码里一致我一般用115200复位开发板串口助手应该能看到三行输出。第一行是JEDEC ID正常情况是0xEF 0x40 0x17第二行是测试结果如果写入和读回一致会打印Test Passed!。如果ID读出来全是0xFF先别慌按经验排查三步先检查SPI四根线的接线有没有松动特别是CS和CLK再用逻辑分析仪抓CLK和MOSI的波形看有没有正常的脉冲输出最后检查代码里GPIO配置MOSI是不是被配置成了输入模式。这三步走完90%的问题都能解决。5. 避坑指南软件SPI调试中的常见问题与排查软件SPI的调试看起来简单实际踩坑不少。我总结了四个高频问题每个都是真实调试经历的血泪经验。坑一读ID全是0xFF一个有效数据都没有现象方面调用W25Q64_ReadID之后打印结果是FF FF FF或者最后一个字节能看到点变化。原因通常是以下几种CS片选时序不对发送指令之前CS没拉低或者指令发送完CS就拉高了导致W25Q64认为通信没开始就已经结束MISO引脚配置错误比如配成了输出模式读到的永远是高电平还有一种可能是时钟极性和相位跟芯片期望的不一致。解决方法是先确认接线没问题然后用逻辑分析仪抓时序。看CS是否在指令发送前拉低、数据是否在时钟上升沿稳定、时钟空闲时是否为低。如果没有逻辑分析仪可以降低SPI时钟频率把延时函数调大再用万用表量MISO引脚看是否有电平变化。坑二写入后读回全是0xFF写入看起来失败了现象方面擦除操作正常但写入的数据读不回来打印比对结果全是错误。原因大概率是忽略了写使能。W25Q64的写操作前必须发送0x06指令设置WEL位否则芯片会忽略写操作。另一个常见原因是往没擦除的区域写入数据flash的编程操作只能把1变成0不能把0变成1所以未擦除区域写入就会得到意料之外的结果。解决方法是每次写操作前调用W25Q64_WriteEnable()并且在写之前先执行扇区擦除。确认这两个步骤做到了写入问题基本就解决了。坑三页编程超过256字节边界数据错乱现象方面写入超过256字节后超出的数据没有写到期望地址而是写到了页首位置。原因是W25Q64的页编程原理决定的。一页256字节如果写入的数据跨越页边界芯片会把超出部分回卷到当前页的起始地址覆盖之前写入的数据。解决方法是把写入逻辑做分页处理。比如写300字节先写第一页256字节再写第二页44字节每次写入前判断剩余空间是否足够不够就先写满当前页再切换到下一页。嵌入式里处理这种逻辑我一般封装一个跨页写入函数上层调用时不用关心页边界函数内部自动分段。坑四WaitBusy死循环程序卡死在等待状态现象方面页编程或者擦除之后调用W25Q64_WaitBusy()程序跑不到下一行。原因是读状态寄存器的时序有问题。比如读状态指令0x05后面少发了产生时钟的0xFF字节或者CS拉高早了导致读到的状态值永远是0x00BUSY位永远为0但flash实际上还在写。也可能是flash芯片虚焊或者供电不稳定导致状态寄存器异常。解决方法是先检查读状态时序是否符合预期然后在WaitBusy里加一个超时计数器比如循环100万次还没等到底就报错退出避免程序死磕到底。硬件方面检查flash供电是否稳定3.3V有没有明显纹波。6. 二次开发把软件SPI改造成可复用、可扩展的存储层6.1 参数化改造换引脚不改代码工程跑通之后第一个值得做的改造是把引脚定义从代码里抽出来。现在把GPIO操作直接写在函数里换个引脚就得改一大片代码。常见的做法是用宏把引脚封装起来#define SPI_CS_PIN GPIO_Pin_4 #define SPI_CLK_PIN GPIO_Pin_5 #define SPI_MOSI_PIN GPIO_Pin_7 #define SPI_MISO_PIN GPIO_Pin_6 #define SPI_GPIO_PORT GPIOA这样换引脚的时候只需要修改宏定义函数体里的逻辑不用动。更进一步可以把这个宏定义放到一个单独的头文件里移植到其他板子时只改这个文件。这是嵌入式工程最值得养成的习惯——硬件相关的代码尽可能收敛到一个位置。6.2 向上抽象提供统一存储接口第二个值得做的改造是加一层存储抽象。现在上层逻辑直接调用W25Q64_ReadData和W25Q64_PageProgram如果哪天要换存储介质比如换成SD卡或者内部flash所有上层代码都要重写。我一般会定义一个简单的存储接口结构体typedef struct { void (*init)(void); int (*read)(uint32_t addr, uint8_t *buf, uint16_t len); int (*write)(uint32_t addr, uint8_t *buf, uint16_t len); int (*erase)(uint32_t addr); } storage_ops_t;再写一个全局实例指向W25Q64的具体实现函数上层代码只跟这个结构体打交道。这样之后换存储介质只需要新增一个实现文件替换实例指针上层逻辑不用动。这个抽象能省下后面无数改动存储方案的返工时间。6.3 扩展方向从裸机到FATFS文件系统W25Q64加上软件SPI之后最自然的扩展方向是挂一个文件系统。把flash的读写擦除接口适配到FATFS的底层磁盘驱动接口就能在8MB的flash上创建文件、写日志、存配置。FATFS的底层接口需要实现disk_initialize、disk_read、disk_write、disk_ioctl这几个函数适配起来并不复杂W25Q64的扇区擦除4KB对应FATFS的擦除粒度也正合适。另一个方向是做掉电安全的参数存储。把W25Q64按扇区管理用双扇区备份加校验和的方式存储系统参数掉电时即使写入一半下次启动也能从备份扇区恢复。这个需求在产品化项目里很常见比裸写flash要实用得多。从那以后我每次拿到一块新板子第一件事就是写一个软件SPI的读写demo先把芯片时序跑通再考虑要不要切到硬件SPI。这个习惯帮我避开了很多硬件外设引脚的坑。希望这篇拆解对你也有点帮助。本文还有配套的精品资源点击获取
简介一套基于STM32F103的软件SPI读写W25Q64 Flash完整工程面向学习SPI通信的单片机开发者解决不使用硬件SPI外设时如何用GPIO模拟时序完成Flash数据读写。案例以W25Q64为从机、STM32为主机按SPI1外设引脚给出接线PA4接CS、PA5接CLK、PA6接DO、PA7接DI便于后续切换至硬件SPI继续学习。资源包共83个文件以36个h头文件、33个c源文件为主涵盖外设库、延时、按键、LED、OLED及W25Q64驱动等模块另有启动文件、工程配置和接线图压缩包仅1004KB结构清晰适合直接编译或移植复用。已有2052人学习可掌握软件SPI时序、W25Q64读写流程及工程模块划分方法。1. 软件SPI总线为什么非要用GPIO硬拼出W25Q64的时序做单片机开发久了你会发现一个反直觉的结论硬件SPI外设并不总是最省事的选择。某次我在一块开发板上调试W25Q64 flash存储器硬件SPI怎么都读不出正确的JEDEC ID示波器抓波形发现时钟线毛刺严重翻遍了芯片手册才发现是引脚复用冲突加上时钟极性配置被库函数默认值坑了。换了软件SPI——直接用GPIO模拟时序——十分钟就跑通了。这篇就拆一下这个思路不依赖STM32的SPI外设用普通GPIO模拟出W25Q64所需的全部时序实现读写flash存储器。适合刚接触STM32 SPI通信、或者被硬件SPI折腾到想换方案的单片机开发者也适合想彻底搞懂SPI时序本质的嵌入式入门者。2. 整体架构与工程结构软件SPI的层次设计2.1 为什么选W25Q64和软件SPIW25Q64是华邦生产的SPI NOR Flash容量64Mbit也就是8MByte256字节为一页4KB为一个扇区64KB为一个块。这个容量在嵌入式里非常百搭——存字库、存配置参数、存OTA固件都够用。它支持标准SPI、双输出、四输出等多种模式但最基础、最通用的还是标准SPI时序这就给了软件模拟一个很好的切入点。选择软件SPI而不是硬件SPI通常出于三个考虑。第一是引脚自由度硬件SPI往往绑定固定引脚PCB布线不方便的时候软件SPI可以随意映射到任意GPIO第二是抗干扰调试便利软件SPI的时序完全由代码控制时钟极性和相位怎么配、每bit之间延时多久都可以现场调出问题可以直接用逻辑分析仪对比代码逻辑第三是某些芯片的SPI时序比较特殊硬件外设适配起来反而麻烦比如需要在时钟中间切换数据线方向的双向IO场景。我之前在一个项目里用过某款带SPI接口的传感器硬件SPI死活读不到正确数据换成软件SPI把时钟拉慢到几百kHz一次就读通了。这不是说硬件SPI不好而是软件SPI在调试阶段确实更有掌控感。2.2 引脚分配与接线软件SPI的接线比硬件SPI直观很多四根线加电源地线全部接到普通GPIO上就行。这里以某常见开发板为例我选用了PA4、PA5、PA6、PA7四个引脚对应关系如下信号引脚GPIO模式说明CSPA4推挽输出片选低电平有效CLKPA5推挽输出时钟线空闲时为低MOSIPA7推挽输出主机输出从机输入MISOPA6浮空输入或上拉输入主机输入从机输出VCC3.3V-W25Q64供电GNDGND-共地注意MISO这根线软件SPI下它不需要配置为复用功能普通输入模式就够了。但是建议配置为上拉输入因为W25Q64的DO引脚在片选拉高后会变成高阻态如果没有上拉电阻读数据时第一个bit可能是随机电平。这里有个常见误用有人把MISO也配成推挽输出读数据的时候两个输出短接在一起轻则读数错误重则烧引脚。读方向时MISO必须是输入写方向时MOSI是输出这两根线的方向是固定的不需要像I2C那样切换方向这是SPI比I2C简单的地方。2.3 工程目录结构解析一个典型的软件SPI读写W25Q64工程目录结构大致如下Project/ ├── Core/ │ ├── Inc/ │ │ ├── main.h │ │ ├── soft_spi.h │ │ └── w25q64.h │ └── Src/ │ ├── main.c │ ├── soft_spi.c │ └── w25q64.c ├── Drivers/ │ ├── CMSIS/ │ └── STM32F1xx_HAL_Driver/ ├── Hardware/ │ └── usart.c └── MDK-ARM/重点看soft_spi.c和w25q64.c这两个文件。soft_spi.c负责最底层的GPIO模拟时序只做四件事起始、结束、读写一个字节w25q64.c是基于底层时序封装出来的芯片操作层包含读ID、擦除、页编程、读数据等功能。这种分层方式非常重要后续如果要把软件SPI换成硬件SPI只需要改soft_spi.c上面的w25q64.c一行都不用动。main.c里则是测试入口初始化GPIO、初始化串口、调用W25Q64的读写函数把结果通过串口打印到PC端观察。整个工程没有复杂的RTOS依赖裸机一套跑下来非常适合初学者理解完整的数据流。3. 核心代码实现从GPIO模拟到读写数据的完整链路3.1 软件SPI的时序基础SPI时序的基础是四个相位时钟极性CPOL和时钟相位CPHA。W25Q64支持模式0和模式3我们常用模式0即CPOL0、CPHA0意思是空闲时时钟为低电平数据在时钟上升沿采样在下降沿改变。这个细节对软件模拟至关重要。因为你是用GPIO手掰时序不是硬件自动处理必须明确知道什么时候拉高时钟、什么时候数据线上放数据、什么时候采样。搞反了数据就会错位。// W25Q64要求的数据时序MSB先行时钟上升沿采样 // 写数据时在时钟上升沿之前把数据放到MOSI上 // 读数据时在时钟下降沿之后从MISO上读取实际调试中我习惯先用逻辑分析仪抓一次读ID的波形对照芯片手册确认时钟极性和数据采样点是否正确。这一步省下来后面排查问题会花十倍时间。3.2 GPIO初始化与SPI起始/结束先看底层GPIO初始化。软件SPI的核心就是把这几个引脚设置成普通GPIO开启时钟配置模式。void Soft_SPI_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE); // CS、CLK、MOSI配置为推挽输出速度50MHz GPIO_InitStructure.GPIO_Pin GPIO_Pin_4 | GPIO_Pin_5 | GPIO_Pin_7; GPIO_InitStructure.GPIO_Mode GPIO_Mode_Out_PP; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOA, GPIO_InitStructure); // MISO配置为上拉输入 GPIO_InitStructure.GPIO_Pin GPIO_Pin_6; GPIO_InitStructure.GPIO_Mode GPIO_Mode_IPU; GPIO_Init(GPIOA, GPIO_InitStructure); // 空闲状态CS拉高CLK拉低 GPIO_SetBits(GPIOA, GPIO_Pin_4); GPIO_ResetBits(GPIOA, GPIO_Pin_5); }这里的重点是CS空闲时必须拉高CLK空闲时拉低对应模式0的CPOL0。GPIO速度配50MHz是为了保证边沿足够陡峭如果配成低速模式时钟频率提上来之后波形会变圆可能触发误采样。SPI通信的起始和结束很简单就是控制CS这根片选线。CS拉低表示主机开始与从机通信CS拉高表示通信结束。void Soft_SPI_Start(void) { GPIO_ResetBits(GPIOA, GPIO_Pin_4); // CS拉低选中W25Q64 } void Soft_SPI_Stop(void) { GPIO_SetBits(GPIOA, GPIO_Pin_4); // CS拉高释放W25Q64 }有人可能会问CS拉高之后W25Q64的DO引脚会变成高阻态这个要不要处理不需要硬件上高阻态就相当于断开了不会影响MOSI上的数据。3.3 SPI读写一个字节读写一个字节是整个软件SPI最核心的函数也是唯一真正模拟时序的地方。SPI是同步全双工协议主机发一个bit的同时会收到一个bit所以读和写在同一个函数里完成。uint8_t Soft_SPI_ReadWriteByte(uint8_t data) { uint8_t i; uint8_t receive 0; for (i 0; i 8; i) { // 先拉低时钟准备发送数据 GPIO_ResetBits(GPIOA, GPIO_Pin_5); // 发送当前bitMSB先行 if (data 0x80) GPIO_SetBits(GPIOA, GPIO_Pin_7); else GPIO_ResetBits(GPIOA, GPIO_Pin_7); data 1; // 给一点延时让数据稳定 Soft_SPI_Delay(); // 拉高时钟上升沿采样数据 GPIO_SetBits(GPIOA, GPIO_Pin_5); // 在上升沿读取MISO引脚 if (GPIO_ReadInputDataBit(GPIOA, GPIO_Pin_6)) receive | 0x01; receive 1; Soft_SPI_Delay(); } // 最后拉低时钟结束一个字节的传输 GPIO_ResetBits(GPIOA, GPIO_Pin_5); return receive; }逻辑说明每个bit的传输分为四步——拉低时钟、在MOSI上放数据、拉高时钟模拟上升沿、在上升沿后读取MISO。发送的数据从最高位开始每发送一个bit左移一次接收的数据也是从最高位开始累积每次或上一个bit后左移。循环8次完成一个字节。参数说明data是主机要发送的字节如果只是读取数据比如读ID操作传入0xFF即可因为SPI协议里主机不发时钟从机就无法输出数据发送0xFF只是提供时钟信号。Soft_SPI_Delay()是一个简单的空循环延时函数控制SPI时钟频率。在调试初期我一般把延时调大一点让时钟降到几百kHz方便逻辑分析仪抓波形确认时序正确后再逐步减小延时提高速度。这个延时也可以不用直接让GPIO翻转的固有延迟充当时序间隔但那样时钟频率就不可控了。3.4 读取JEDEC ID读取JEDEC ID是验证SPI通信是否正确的第一步也是最有成就感的步骤——如果ID读对了说明底层时序没问题后面操作flash就有底气。W25Q64的JEDEC ID指令是0x9F发送该指令后芯片会返回三个字节厂商ID、存储器类型、容量ID。W25Q64的三字节固定是0xEF、0x40、0x17。void W25Q64_ReadID(uint8_t *mid, uint8_t *type, uint8_t *did) { Soft_SPI_Start(); Soft_SPI_ReadWriteByte(0x9F); // 发送JEDEC ID读取指令 *mid Soft_SPI_ReadWriteByte(0xFF); // 读取厂商ID如0xEF *type Soft_SPI_ReadWriteByte(0xFF); // 读取存储器类型如0x40 *did Soft_SPI_ReadWriteByte(0xFF); // 读取容量ID如0x17 Soft_SPI_Stop(); }逻辑说明发送0x9F指令后W25Q64会从DO引脚连续输出三个字节的设备信息。主机只需要持续发送0xFF产生时钟同时读取MISO数据。Soft_SPI_Stop()拉高CS结束通信。这里有个细节值得注意读ID之前不需要发送写使能指令也没有写保护的限制因为读操作不改变flash内容。如果读ID都是0xFF说明时序大概率有问题常见原因是CLK极性和数据采样点不对。3.5 写使能与页编程写入数据是W25Q64操作中最复杂的一步因为flash写入前必须保证目标区域是擦除状态。W25Q64的写入单位是页一页256字节。写数据之前要发送写使能指令0x06让状态寄存器的WEL位变成1否则写操作会被忽略。void W25Q64_WriteEnable(void) { Soft_SPI_Start(); Soft_SPI_ReadWriteByte(0x06); // 写使能指令 Soft_SPI_Stop(); } void W25Q64_PageProgram(uint32_t addr, uint8_t *data, uint16_t len) { uint8_t i; W25Q64_WriteEnable(); Soft_SPI_Start(); Soft_SPI_ReadWriteByte(0x02); // 页编程指令 Soft_SPI_ReadWriteByte((addr 16) 0xFF); // 地址高字节 Soft_SPI_ReadWriteByte((addr 8) 0xFF); // 地址中字节 Soft_SPI_ReadWriteByte(addr 0xFF); // 地址低字节 // 写入数据 for (i 0; i len; i) { Soft_SPI_ReadWriteByte(data[i]); } Soft_SPI_Stop(); }逻辑说明页编程指令0x02后面跟24位地址然后是待写入的数据。W25Q64内部会在页缓冲区内写入数据然后再编程到存储阵列。注意一次最多只能写256字节如果地址跨越了页边界数据会回卷到页首这就需要额外处理。参数说明addr是24位地址范围0x000000到0x7FFFFF对应8MB空间。data是待写入数据的缓冲区指针len是数据长度最大256。地址分解为三个字节发送时要注意移位和掩码的配合(addr 16) 0xFF取最高字节addr 0xFF取最低字节。写使能操作每次写操作前都要执行读操作不需要。如果写完发现数据不对先检查是不是忘了调W25Q64_WriteEnable()。3.6 读取数据相比写入读取就简单多了不需要擦除、不需要写使能直接发送读数据指令0x03加24位地址然后持续读字节就行。void W25Q64_ReadData(uint32_t addr, uint8_t *buf, uint16_t len) { uint16_t i; Soft_SPI_Start(); Soft_SPI_ReadWriteByte(0x03); // 读数据指令 Soft_SPI_ReadWriteByte((addr 16) 0xFF); Soft_SPI_ReadWriteByte((addr 8) 0xFF); Soft_SPI_ReadWriteByte(addr 0xFF); // 连续读取len个字节 for (i 0; i len; i) { buf[i] Soft_SPI_ReadWriteByte(0xFF); // 发送0xFF产生时钟 } Soft_SPI_Stop(); }逻辑说明读数据指令0x03后面跟24位地址然后主机会连续发送0xFF来产生时钟脉冲W25Q64从DO引脚逐bit输出数据主机在每个时钟上升沿采样。这个操作可以连续读取多个字节地址自动递增直到CS拉高停止。注意buf缓冲区必须由调用者分配足够空间函数本身不做越界检查。我之前就犯过这个错误——读256字节数据缓冲区只开了100字节结果后面的变量全被冲掉了。嵌入式开发中这种低级错误最容易让人血压升高。3.7 状态寄存器与忙等待flash编程和擦除都需要时间W25Q64内部有一个忙状态位BUSY位于状态寄存器的bit 0。写入或擦除期间这个位为1完成后变为0。主机需要不断读取状态寄存器直到BUSY位清零才能进行下一次操作。void W25Q64_WaitBusy(void) { uint8_t status; Soft_SPI_Start(); Soft_SPI_ReadWriteByte(0x05); // 读状态寄存器指令 do { status Soft_SPI_ReadWriteByte(0xFF); } while (status 0x01); // 等待BUSY位清零 Soft_SPI_Stop(); }逻辑说明读状态寄存器指令0x05后面不跟地址主机发送0xFF读取状态寄存器的值。status 0x01判断BUSY位是否为1如果为1说明flash还在忙继续循环读取直到为0。这个函数看着简单实际坑不少。如果读ID正常但写入不成功多半是WaitBusy这里出了问题。比如读状态寄存器时CS拉高早了或者时钟极性和数据采样点没对上读到的状态永远不对导致死循环。在等待循环里加一个超时计数是更稳妥的做法防止flash异常时程序卡死。4. 运行与验证从编译到串口打印实验4.1 工程配置与编译拿到工程后第一步是配置编译环境。这里以Keil MDK为例也可以换成IAR或者STM32CubeIDE代码本身不挑编译器。打开工程后先检查芯片型号是否选对——用的是STM32F103系列就选对应的Device用的是其他系列就替换启动文件和设备头文件。编译前需要在魔术棒选项卡里检查两个配置一个是C语言标准建议选C99因为代码里用了在for循环内声明变量的写法C89标准会报错另一个是宏定义如果用HAL库版本需要确保USE_HAL_DRIVER和STM32F103xE这类芯片宏有定义。标准外设库版本则不需要。配置完成后直接编译如果代码是从头开始写的大概率会遇到一些基础错误。最常见的是GPIO时钟没使能就调用GPIO_Init这时候程序会跑飞或者直接HardFault。检查的顺序是时钟使能 → 引脚配置 → 外设初始化这个顺序不能乱。4.2 测试代码设计在main函数里我习惯的测试流程是初始化LED和串口 → 读取JEDEC ID并打印 → 擦除一个扇区 → 写入一组测试数据 → 读回数据并比对 → 打印测试结果。int main(void) { uint8_t mid, type, did; uint8_t write_buf[256]; uint8_t read_buf[256]; uint8_t i; delay_init(); USART_Init(115200); Soft_SPI_Init(); // 第一步读取JEDEC ID W25Q64_ReadID(mid, type, did); printf(MID:0x%02X, Type:0x%02X, DID:0x%02X\r\n, mid, type, did); // 第二步擦除扇区0地址0x000000 W25Q64_EraseSector(0x000000); W25Q64_WaitBusy(); // 第三步写入测试数据 for (i 0; i 256; i) { write_buf[i] i; } W25Q64_PageProgram(0x000000, write_buf, 256); W25Q64_WaitBusy(); // 第四步读回数据并校验 W25Q64_ReadData(0x000000, read_buf, 256); for (i 0; i 256; i) { if (write_buf[i] ! read_buf[i]) { printf(Compare Error at %d\r\n, i); break; } } if (i 256) { printf(Test Passed!\r\n); } while(1); }逻辑说明整个测试流程覆盖了读ID、擦除、写入、读回比对四个核心操作。测试数据从0到255写入每个字节如果擦除不彻底或者写入时序有问题比对过程会立刻暴露出来。这里有个值得注意的地方擦除操作必须在写入之前执行而且擦除的单位是扇区而不是页。如果只往一个没擦除过的地址写入数据读回的可能是旧数据和写入数据按位与的混合结果看起来就像写入失败。4.3 串口打印与结果判断串口打印是嵌入式开发中最常用的调试手段。测试代码里用printf输出结果需要把printf重定向到串口标准做法是在代码里实现fputc函数int fputc(int ch, FILE *f) { USART_SendData(USART1, (uint8_t)ch); while (USART_GetFlagStatus(USART1, USART_FLAG_TXE) RESET); return ch; }注意在Keil里要勾选微库MicroLib否则printf会占用大量代码空间F103这种小容量芯片很容易爆flash。连接到PC后打开串口助手波特率设置和代码里一致我一般用115200复位开发板串口助手应该能看到三行输出。第一行是JEDEC ID正常情况是0xEF 0x40 0x17第二行是测试结果如果写入和读回一致会打印Test Passed!。如果ID读出来全是0xFF先别慌按经验排查三步先检查SPI四根线的接线有没有松动特别是CS和CLK再用逻辑分析仪抓CLK和MOSI的波形看有没有正常的脉冲输出最后检查代码里GPIO配置MOSI是不是被配置成了输入模式。这三步走完90%的问题都能解决。5. 避坑指南软件SPI调试中的常见问题与排查软件SPI的调试看起来简单实际踩坑不少。我总结了四个高频问题每个都是真实调试经历的血泪经验。坑一读ID全是0xFF一个有效数据都没有现象方面调用W25Q64_ReadID之后打印结果是FF FF FF或者最后一个字节能看到点变化。原因通常是以下几种CS片选时序不对发送指令之前CS没拉低或者指令发送完CS就拉高了导致W25Q64认为通信没开始就已经结束MISO引脚配置错误比如配成了输出模式读到的永远是高电平还有一种可能是时钟极性和相位跟芯片期望的不一致。解决方法是先确认接线没问题然后用逻辑分析仪抓时序。看CS是否在指令发送前拉低、数据是否在时钟上升沿稳定、时钟空闲时是否为低。如果没有逻辑分析仪可以降低SPI时钟频率把延时函数调大再用万用表量MISO引脚看是否有电平变化。坑二写入后读回全是0xFF写入看起来失败了现象方面擦除操作正常但写入的数据读不回来打印比对结果全是错误。原因大概率是忽略了写使能。W25Q64的写操作前必须发送0x06指令设置WEL位否则芯片会忽略写操作。另一个常见原因是往没擦除的区域写入数据flash的编程操作只能把1变成0不能把0变成1所以未擦除区域写入就会得到意料之外的结果。解决方法是每次写操作前调用W25Q64_WriteEnable()并且在写之前先执行扇区擦除。确认这两个步骤做到了写入问题基本就解决了。坑三页编程超过256字节边界数据错乱现象方面写入超过256字节后超出的数据没有写到期望地址而是写到了页首位置。原因是W25Q64的页编程原理决定的。一页256字节如果写入的数据跨越页边界芯片会把超出部分回卷到当前页的起始地址覆盖之前写入的数据。解决方法是把写入逻辑做分页处理。比如写300字节先写第一页256字节再写第二页44字节每次写入前判断剩余空间是否足够不够就先写满当前页再切换到下一页。嵌入式里处理这种逻辑我一般封装一个跨页写入函数上层调用时不用关心页边界函数内部自动分段。坑四WaitBusy死循环程序卡死在等待状态现象方面页编程或者擦除之后调用W25Q64_WaitBusy()程序跑不到下一行。原因是读状态寄存器的时序有问题。比如读状态指令0x05后面少发了产生时钟的0xFF字节或者CS拉高早了导致读到的状态值永远是0x00BUSY位永远为0但flash实际上还在写。也可能是flash芯片虚焊或者供电不稳定导致状态寄存器异常。解决方法是先检查读状态时序是否符合预期然后在WaitBusy里加一个超时计数器比如循环100万次还没等到底就报错退出避免程序死磕到底。硬件方面检查flash供电是否稳定3.3V有没有明显纹波。6. 二次开发把软件SPI改造成可复用、可扩展的存储层6.1 参数化改造换引脚不改代码工程跑通之后第一个值得做的改造是把引脚定义从代码里抽出来。现在把GPIO操作直接写在函数里换个引脚就得改一大片代码。常见的做法是用宏把引脚封装起来#define SPI_CS_PIN GPIO_Pin_4 #define SPI_CLK_PIN GPIO_Pin_5 #define SPI_MOSI_PIN GPIO_Pin_7 #define SPI_MISO_PIN GPIO_Pin_6 #define SPI_GPIO_PORT GPIOA这样换引脚的时候只需要修改宏定义函数体里的逻辑不用动。更进一步可以把这个宏定义放到一个单独的头文件里移植到其他板子时只改这个文件。这是嵌入式工程最值得养成的习惯——硬件相关的代码尽可能收敛到一个位置。6.2 向上抽象提供统一存储接口第二个值得做的改造是加一层存储抽象。现在上层逻辑直接调用W25Q64_ReadData和W25Q64_PageProgram如果哪天要换存储介质比如换成SD卡或者内部flash所有上层代码都要重写。我一般会定义一个简单的存储接口结构体typedef struct { void (*init)(void); int (*read)(uint32_t addr, uint8_t *buf, uint16_t len); int (*write)(uint32_t addr, uint8_t *buf, uint16_t len); int (*erase)(uint32_t addr); } storage_ops_t;再写一个全局实例指向W25Q64的具体实现函数上层代码只跟这个结构体打交道。这样之后换存储介质只需要新增一个实现文件替换实例指针上层逻辑不用动。这个抽象能省下后面无数改动存储方案的返工时间。6.3 扩展方向从裸机到FATFS文件系统W25Q64加上软件SPI之后最自然的扩展方向是挂一个文件系统。把flash的读写擦除接口适配到FATFS的底层磁盘驱动接口就能在8MB的flash上创建文件、写日志、存配置。FATFS的底层接口需要实现disk_initialize、disk_read、disk_write、disk_ioctl这几个函数适配起来并不复杂W25Q64的扇区擦除4KB对应FATFS的擦除粒度也正合适。另一个方向是做掉电安全的参数存储。把W25Q64按扇区管理用双扇区备份加校验和的方式存储系统参数掉电时即使写入一半下次启动也能从备份扇区恢复。这个需求在产品化项目里很常见比裸写flash要实用得多。从那以后我每次拿到一块新板子第一件事就是写一个软件SPI的读写demo先把芯片时序跑通再考虑要不要切到硬件SPI。这个习惯帮我避开了很多硬件外设引脚的坑。希望这篇拆解对你也有点帮助。本文还有配套的精品资源点击获取
平方复杂度无法被常规优化消除｜TaoToken 统一 Key 通道实测)
