1. 项目缘起为什么从读取ID开始很多朋友刚开始玩STM32和SPI外设时可能会直接上手读写数据比如在W25Q64里存个“Hello World”。但我的经验是先学会读取芯片的ID信息是后续所有操作成功与否的基石。这就像你拿到一个新设备第一件事不是让它干活而是先确认“你是谁”、“我们能不能正常对话”。W25Q64是一颗64M-bit也就是8M-byte的SPI Flash芯片应用非常广泛。读取其ID本质上是一次最基础的SPI通信验证。这个过程能帮你一次性排查好几个关键问题硬件连接是否正确SPI的MOSI、MISO、SCK、CS四根线有没有接反或虚焊软件配置是否匹配SPI的时钟极性CPOL、时钟相位CPHA、数据位顺序MSB/LSB是否和W25Q64手册要求的一致芯片本身是否就绪你买的芯片是好的吗焊接过程有没有损坏它如果ID都读不对后面的页编程、扇区擦除、整片读写都是空中楼阁。所以这个看似简单的“读取ID”操作实际上是一个包含了硬件检查、软件驱动验证、协议理解在内的综合性实验。我当年就曾因为CPHA配置错了一位死活读不出正确的ID折腾了大半天。下面我就把整个流程连同那些容易踩坑的细节掰开揉碎了讲清楚。2. 硬件连接与SPI模式深析在写代码之前我们必须把硬件和通信协议的基础打牢。这一步没搞对后面全是白费功夫。2.1 硬件连线图与引脚复用W25Q64是标准的4线SPI器件。以STM32F103C8T6蓝色药丸板为例我们通常使用SPI1或SPI2。这里我推荐使用SPI1因为它的引脚是固定的不容易搞错。连接方式如下STM32 SPI1_MOSI (PA7)-W25Q64 DI (Data Input)STM32 SPI1_MISO (PA6)-W25Q64 DO (Data Output)STM32 SPI1_SCK (PA5)-W25Q64 CLKSTM32 任意GPIO (如PA4)-W25Q64 CS# (Chip Select)注意CS#引脚必须用普通的GPIO来控制而不是SPI外设自带的NSS引脚。这是因为SPI的NSS引脚在主模式下功能有限而我们需要在通信前后精确地控制片选信号的高低电平。用软件控制GPIO来拉低选中和拉高取消选中芯片是最灵活可靠的方式。这里有个关键点STM32的SPI引脚是复用的。以PA5、PA6、PA7为例它们默认可能是普通的GPIO或者调试接口。你需要先将这些引脚配置为复用推挽输出对于MOSI和SCK和浮空输入/上拉输入对于MISO然后再使能SPI外设的时钟。顺序错了SPI可能无法正常工作。2.2 理解SPI模式0与W25Q64的时钟约定SPI有四种模式由时钟极性CPOL和时钟相位CPHA组合而成。W25Q64支持模式0 (CPOL0, CPHA0)和模式3 (CPOL1, CPHA1)。绝大多数情况下我们使用模式0。我用一个生活中的场景来解释这两个参数CPOL (Clock Polarity)时钟极性。它定义的是SCK线在空闲状态没有数据传输时的电平。CPOL0空闲时SCK是低电平。就像你家的门铃不按的时候是“安静”的低电平。CPOL1空闲时SCK是高电平。就像一个常亮的指示灯平时就是亮的高电平。CPHA (Clock Phase)时钟相位。它定义的是数据在时钟的哪个边沿被采样读取。CPHA0数据在时钟的第一个边沿对于CPOL0就是上升沿被采样。好比说门铃一响上升沿你就立刻去看是谁采样数据。CPHA1数据在时钟的第二个边沿对于CPOL0就是下降沿被采样。门铃响完上升沿结束你等了一下到下降沿才去看。对于W25Q64的模式0CPOL0, CPHA0空闲时SCK保持低电平。当SCK出现上升沿时主机STM32和从机W25Q64同时采样输入引脚上的数据即读取对方发来的数据位。当SCK出现下降沿时双方同时更新输出引脚上的数据即准备好下一个要发送的数据位。为什么模式0最常用因为它的时序非常直观数据在时钟上升沿稳定下降沿变化。逻辑分析仪抓到的波形也最容易看。配置STM32的SPI时一定要把这两个参数设对。在标准库中对应SPI_InitStructure.SPI_CPOL SPI_CPOL_Low;和SPI_InitStructure.SPI_CPHA SPI_CPHA_1Edge;。在HAL库中则是hspi1.Init.CLKPolarity SPI_POLARITY_LOW;和hspi1.Init.CLKPase SPI_PHASE_1EDGE;。2.3 片选信号CS#的时序要求片选信号CS#是低电平有效。在发起任何一次SPI通信序列前必须先将CS#拉低并在整个通信序列结束后再拉高。W25Q64的数据手册里对CS#的下降沿到第一个SCK上升沿之间有一个最短时间要求t_CS通常很短纳秒级STM32的GPIO操作足以满足。但我们需要在代码逻辑上保证这个顺序// 正确的操作顺序 W25Q64_CS_LOW(); // 1. 先拉低片选选中芯片 SPI_Transmit(...); // 2. 进行SPI数据传输 W25Q64_CS_HIGH(); // 3. 最后拉高片选结束通信一个常见的坑是在连续发送多个字节比如发送命令字后接着发送地址时错误地在每个字节之间都操作了CS#。这会导致W25Q64认为一次命令传输被中断从而无法正确响应。正确的做法是一次完整的命令操作如读ID、读数据、写使能必须在一次连续的CS#低电平期间完成。3. 软件驱动层构建与核心函数实现理解了硬件和协议我们就可以动手写代码了。我将采用STM32标准外设库来演示因为它的代码层次清晰更适合理解原理。HAL库的思路是类似的。3.1 SPI与GPIO的初始化配置首先我们需要初始化连接W25Q64的GPIO和SPI1外设。/** * brief 初始化SPI1接口用于W25Q64 * param 无 * retval 无 */ void SPI1_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; SPI_InitTypeDef SPI_InitStructure; /* 1. 开启时钟 */ RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_SPI1, ENABLE); /* 2. 配置SPI引脚: SCK/MOSI为复用推挽输出 MISO为上拉输入 */ // PA5 - SPI1_SCK // PA6 - SPI1_MISO // PA7 - SPI1_MOSI GPIO_InitStructure.GPIO_Pin GPIO_Pin_5 | GPIO_Pin_7; GPIO_InitStructure.GPIO_Mode GPIO_Mode_AF_PP; // 复用推挽输出 GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOA, GPIO_InitStructure); GPIO_InitStructure.GPIO_Pin GPIO_Pin_6; GPIO_InitStructure.GPIO_Mode GPIO_Mode_IPU; // 上拉输入稳定电平 GPIO_Init(GPIOA, GPIO_InitStructure); /* 3. 配置CS引脚(PA4)为普通推挽输出初始状态为高不选中*/ GPIO_InitStructure.GPIO_Pin GPIO_Pin_4; GPIO_InitStructure.GPIO_Mode GPIO_Mode_Out_PP; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOA, GPIO_InitStructure); GPIO_SetBits(GPIOA, GPIO_Pin_4); // CS高电平 /* 4. 配置SPI1工作参数 */ SPI_InitStructure.SPI_Direction SPI_Direction_2Lines_FullDuplex; // 全双工 SPI_InitStructure.SPI_Mode SPI_Mode_Master; // 主模式 SPI_InitStructure.SPI_DataSize SPI_DataSize_8b; // 8位数据 SPI_InitStructure.SPI_CPOL SPI_CPOL_Low; // CPOL0 SPI_InitStructure.SPI_CPHA SPI_CPHA_1Edge; // CPHA0 (对应1Edge) SPI_InitStructure.SPI_NSS SPI_NSS_Soft; // 软件控制NSS(CS) SPI_InitStructure.SPI_BaudRatePrescaler SPI_BaudRatePrescaler_256; // 预分频决定SCK速度 SPI_InitStructure.SPI_FirstBit SPI_FirstBit_MSB; // 高位先发 SPI_InitStructure.SPI_CRCPolynomial 7; // CRC值本例不用 SPI_Init(SPI1, SPI_InitStructure); /* 5. 使能SPI1 */ SPI_Cmd(SPI1, ENABLE); }关键参数解析SPI_BaudRatePrescaler这是SPI时钟SCK的分频系数。STM32的APB2总线时钟通常是72MHz。256分频后SCK频率约为281.25KHz。初期调试强烈建议使用低速比如256或128分频波形稳定容易用逻辑分析仪抓取。等所有通信稳定后再尝试提高速度如4分频到18MHz。W25Q64最高支持104MHz但受限于STM32的IO口速度和PCB布线实际能稳定运行的频率会低一些。SPI_FirstBit_MSBSPI协议可以高位MSB先发也可以低位LSB先发。W25Q64要求MSB first这个必须设置对否则你读到的数据每一位都是反的。3.2 封装基础的SPI读写字节函数SPI外设的发送和接收是同步完成的。当我们向发送寄存器DR写入一个字节时硬件会自动在SCK时钟的驱动下将这个字节的每一位从MOSI线移出同时MISO线上的数据也会被一位位地移入接收寄存器。所以我们通常用一个函数同时完成发送和接收。/** * brief 通过SPI1读写一个字节 * param TxData: 要发送的字节 * retval 接收到的字节 */ uint8_t SPI1_ReadWriteByte(uint8_t 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通信的基石。这里有一个非常重要的细节很多初学者会忽略“发送的数据和接收的数据是什么关系”。当你调用SPI1_ReadWriteByte(0xAB)时返回值并不是W25Q64对你这个0xAB的回应。返回值是上一次SPI传输周期时从MISO线上移入的数据而0xAB则会在本次函数调用引发的传输周期中被发送出去并在下一次调用该函数时其回应数据才会被读取。为了能读到本次命令的回应我们通常需要先发送一个“哑元”Dummy Byte通常是0xFF或0x00来“启动”一次传输从而获取芯片的第一次回应。这在读ID操作中会看到。3.3 W25Q64读ID命令的完整实现W25Q64有两个ID命令0x90(Read Manufacturer/Device ID) 和0x9F(Read JEDEC ID)。0x9F更常用它一次性能返回3个字节制造商ID、存储器类型、容量ID。我们就以实现0x9F命令为例。根据W25Q64数据手册执行0x9F命令的时序是CS#拉低。主机发送命令字节0x9F。主机继续发送时钟从机则连续返回3个字节的ID数据先返回制造商ID。CS#拉高。/** * brief 读取W25Q64的JEDEC ID (0x9F命令) * param manufacturerID: 指向存放制造商ID的变量指针 * param deviceType: 指向存放存储器类型的变量指针 * param capacityID: 指向存放容量ID的变量指针 * retval 无 */ void W25Q64_ReadJDECID(uint8_t *manufacturerID, uint8_t *deviceType, uint8_t *capacityID) { /* 拉低片选开始通信 */ W25Q64_CS_LOW(); // 宏定义GPIO_ResetBits(GPIOA, GPIO_Pin_4) /* 发送读ID命令 0x9F */ SPI1_ReadWriteByte(0x9F); /* 发送哑元时钟同时读取返回的三个ID字节 */ // 发送第一个哑元字节读回制造商ID (对于Winbond应该是0xEF) *manufacturerID SPI1_ReadWriteByte(0xFF); // 发送第二个哑元字节读回存储器类型 (对于W25Q64应该是0x40) *deviceType SPI1_ReadWriteByte(0xFF); // 发送第三个哑元字节读回容量ID (对于64M-bit应该是0x17) *capacityID SPI1_ReadWriteByte(0xFF); /* 拉高片选结束通信 */ W25Q64_CS_HIGH(); // 宏定义GPIO_SetBits(GPIOA, GPIO_Pin_4) }代码逻辑解读SPI1_ReadWriteByte(0x9F)这行代码执行了两个动作。它把命令0x9F发送了出去但同时它返回的值是之前可能残留在SPI数据寄存器里的垃圾值我们直接丢弃。接下来的三行SPI1_ReadWriteByte(0xFF)是关键。当我们第一次调用它发送0xFF时SPI硬件开始一次新的8时钟周期传输。在这个周期里MOSI线输出0xFF而MISO线上W25Q64正在输出制造商ID比如0xEF的第一位。当8个时钟结束后这个完整的0xEF字节就被接收到了STM32的SPI数据寄存器。所以这行代码的返回值就是W25Q64对0x9F命令的第一个回应字节制造商ID。同理第二次调用SPI1_ReadWriteByte(0xFF)发送第二个哑元0xFF时会触发第二个8时钟周期读回的是W25Q64输出的第二个字节存储器类型。第三次调用则读回容量ID。重要心得理解“发送哑元时钟以读取数据”是掌握SPI通信的关键。对于只需要发送命令而不需要返回数据的操作如写使能0x06发送完命令后直接拉高CS#即可。但对于任何需要读取数据的操作主机必须提供足够的时钟边沿通过发送哑元字节从机才能把数据一位位地“推”出来。4. 调试实战从现象倒推问题的完整链路代码写好了烧录进去串口打印出来的ID可能是0xFF 0xFF 0xFF也可能是0x00 0x00 0x00或者别的乱码。别慌这是学习过程中最有价值的部分。我们来建立一个系统的排查链路。4.1 现象1ID全为0xFF或0x00可能原因及排查步骤电源和地线最基础也最容易被忽视。用万用表测量W25Q64的VCC通常是3.3V和GND引脚电压是否正常、稳定。CS片选信号CS#引脚是否一直为高电平导致芯片从未被选中在W25Q64_ReadJDECID函数开头和结尾设置GPIO翻转用逻辑分析仪或示波器观察CS#引脚是否有从高到低再到高的跳变。确保你的GPIO初始化代码里已经把CS#引脚设置为高电平了。SPI时钟SCK有无波形用逻辑分析仪连接SCK引脚。运行读ID函数时应该能看到8个发命令24个读3字节32个时钟脉冲。如果完全没有波形说明SPI外设没有正确初始化或使能或者引脚复用模式配置错误比如配成了普通输出GPIO_Mode_Out_PP而不是复用输出GPIO_Mode_AF_PP。MOSI线上有无命令字逻辑分析仪同时抓取MOSI线。在CS#拉低后你应该能看到MOSI线上出现0x9F二进制1001 1111的数据波形。如果看不到原因同上。如果看到的数据位顺序不对比如变成了1111 1001那就是SPI_FirstBit设置错了不是MSB first。MISO线电平如果以上都正常但MISO线始终是高电平0xFF或低电平0x00那可能是芯片损坏或型号不对。MISO引脚配置错误必须配置为**上拉输入GPIO_Mode_IPU**或浮空输入GPIO_Mode_IN_FLOATING。如果配置成了输出模式MISO线会被STM32控制无法读取W25Q64的数据。SPI模式错误W25Q64和STM32的CPOL/CPHA不匹配。这是最隐蔽的坑。请用逻辑分析仪仔细对照波形。正确的模式0波形应该是CS#拉低后SCK从低电平开始在第一个上升沿之前MOSI上的数据命令的第一位已经稳定。你可以搜索“SPI Mode 0 timing diagram”图片与你的实测波形对比。4.2 现象2ID错误但非全0xFF/0x00如果读出的三个字节有值但不是预期的0xEF, 0x40, 0x17这是Winbond W25Q64的典型值比如读出来是0x68, 0x00, 0x00。检查预分频和时钟极性/相位SPI速度太快可能导致时序不满足。尝试将SPI_BaudRatePrescaler设置为SPI_BaudRatePrescaler_256甚至_512用最低速测试。同时再次确认CPOL和CPHA是否为0。检查逻辑分析仪采样设置确保逻辑分析仪的采样率足够高至少是SCK频率的4倍以上并且触发条件设置正确在CS下降沿触发。对比发送与接收波形同时抓取MOSI和MISO。分析在发送0x9F命令后主机发送的三个0xFF哑元期间MISO线上出现的波形是什么。将波形转换成二进制再转换成十六进制看是否与你代码读到的值一致。这能帮你判断是硬件通信问题还是代码解析问题。查阅具体芯片的数据手册不同厂家、甚至同厂家不同批次的芯片JEDEC ID可能略有不同。以你手中芯片的数据手册为准。0xEF是Winbond的ID0x40和0x17的组合代表W25Q64。如果你的芯片是别的品牌如GDID就会不同。4.3 使用逻辑分析仪进行“抓包”解码逻辑分析仪是调试SPI/I2C等数字通信协议的利器。以Saleae Logic为例将通道0接CS#通道1接SCK通道2接MOSI通道3接MISO。设置一个异步串行分析器协议选择“SPI”。根据你的接线设置正确的通道映射CS CLK MOSI MISO。关键步骤设置正确的“位顺序”Bit Order为“MSB”时钟边沿Clock Edge根据CPHA设置对于模式0是上升沿采样。开始录制然后触发单片机运行读ID函数。停止录制后分析器会自动解码。你应该能看到一次SPI传输内容为MOSI: 9F(命令)MISO: EF(制造商ID)MOSI: FF(哑元1)MISO: 40(存储器类型)MOSI: FF(哑元2)MISO: 17(容量ID)MOSI: FF(哑元3 可能还会跟一个MISO的回复但命令已结束可忽略)如果解码结果正确但你的代码读出的值不对那问题一定出在代码的SPI读写函数或数据处理逻辑上。如果解码结果本身就是乱的那问题就是硬件连接或SPI配置。5. 进阶思考与项目延伸成功读取ID只是第一步但它验证了整个SPI通信链路是通的。基于这个稳定的基础我们可以做很多扩展。5.1 封装更通用的W25Q64读写函数读ID函数可以抽象出一个底层模型发送命令-可选发送地址-可选发送或接收数据。我们可以据此封装出几个核心函数// 发送一个字节的命令 void W25Q64_WriteCmd(uint8_t cmd) { W25Q64_CS_LOW(); SPI1_ReadWriteByte(cmd); W25Q64_CS_HIGH(); } // 读取状态寄存器 uint8_t W25Q64_ReadStatusReg(void) { uint8_t status; W25Q64_CS_LOW(); SPI1_ReadWriteByte(0x05); // 读状态寄存器1命令 status SPI1_ReadWriteByte(0xFF); W25Q64_CS_HIGH(); return status; } // 等待芯片空闲检查BUSY位 void W25Q64_WaitBusy(void) { while((W25Q64_ReadStatusReg() 0x01) 0x01); // 等待BUSY位为0 }有了这些实现页编程Page Program, 0x02、扇区擦除Sector Erase, 0x20、读取数据Read Data, 0x03就只是组合调用的问题了。记住任何写操作编程或擦除前必须先发送写使能命令0x06并在操作后等待BUSY位清零。5.2 提升通信速率与稳定性优化当功能都实现后可以考虑优化提高SPI时钟频率将预分频系数改小如SPI_BaudRatePrescaler_4。注意频率越高对PCB布线和电源去耦的要求也越高。如果出现数据错误可能需要降低频率或在时钟线上串联一个小电阻如22欧姆来改善信号完整性。使用DMA进行大数据块传输对于读写大量数据如更新字库、图片使用SPI的DMA功能可以极大解放CPU。这涉及到DMA控制器的配置以及处理“SPI传输完成”中断。一个坑点是在DMA传输完成中断里需要先关闭SPI的DMA请求再清除相关标志位最后拉高CS#顺序错了可能导致状态锁死。驱动分层设计将底层SPI读写、W25Q64基本命令、上层应用如文件系统分开。这样更换SPI端口从SPI1换到SPI2或更换存储芯片换用别的SPI Flash时只需要修改底层驱动上层业务逻辑无需变动。5.3 从读ID到文件系统与掉电保存W25Q64容量有8MB直接操作地址很麻烦。通常我们会为其移植一个文件系统如FATFS通过SPI Flash驱动层或LittleFS。读ID的成功意味着你拥有了访问这块存储介质的“钥匙”。在物联网或数据记录设备中W25Q64常用来存储系统配置、历史日志或采集到的传感器数据。这时掉电保护就至关重要。你需要设计一个机制确保正在写入的数据在突然断电时不会损坏。常见的策略包括写前擦除Flash特性决定了只能把1写成0不能把0写成1。所以写数据前必须先擦除整片、块、扇区或页擦除操作会把所有位置1。异地更新准备两个或多个固定的存储区比如两个扇区轮流写入数据并附带一个版本号或校验和。每次更新数据时写到另一个区然后更新指针。这样即使一个区的数据在写入中途断电损坏另一个区还保留着上一次完好的数据。使用事务日志在真正修改目标数据前先在一个独立的日志区记录下要做的操作。操作完成后再清除日志。如果系统启动时发现日志存在说明上次操作未完成可以进行恢复。读取ID这个简单的起点最终可以通向一个稳定、可靠的非易失性存储解决方案。把每一步的原理和细节都抠明白后面复杂的应用构建起来才会得心应手。我个人的习惯是每接触一款新的SPI器件第一个程序一定是读它的ID或寄存器这个“握手”成功带来的信心比什么都重要。