每次有同学拿着开发板跑来问“我想外挂一颗FlashGD25Q80E和W25Q16选哪个”我都会先反问一句你打算让它存什么字库、固件、参数还是日志别看SPI NOR Flash的命令表翻来覆去就那么十几条很多人折腾一整天最后卡住的地方根本不是命令没学会而是时序的边界条件没搞明白——CS该什么时候拉低、命令发完要不要拉高、擦除结束怎么判断、QSPI四线模式下Dummy Cycle设几位。这篇文章我就拿GD25Q80E这颗8Mbit的SPI NOR Flash当样本把命令时序到STM32 QSPI外设的实战路线完整走一遍。不管你是做毕业设计、产品原型还是刚摸到存储器件的新手都能直接照着往下做。GD25Q80E的命令集和Winbond W25Q系列基本兼容所以这篇里的东西学完你换W25Q80、W25Q128甚至其他几家国产Flash驱动的骨架都差不多。已经会玩SPI模式的朋友重点去看QSPI部分的差异和坑。1. GD25Q80E入手前先搞清楚这颗芯片的底细1.1 8Mbit到底有多大内部怎么组织GD25Q80E的“8Mbit”指的是存储阵列容量换算过来就是1MByte精确点是1048576字节。听起来不大但存一份12号中文字库大概1MB多点不太够存几张图标、一份字库子集、几十K的运行参数、或者一份启动代码那是绰绰有余。NOR Flash的内部不是一张“大饼”想写哪就写哪它有严格的粒度划分页Page256字节这是编程Program操作的最小单位一次页编程最多只能往Flash里写256字节。扇区Sector4KB这是擦除Erase操作的最小单位一次至少擦4KB。块Block32KB或64KBGD25Q80E也支持这两种块擦除适合需要快速大片清空数据的场景。整片擦除Chip Erase一条命令全部清空。这里有个反复强调都不过分的Flash基本原理Flash存储单元只能把1写成0把0恢复成1的唯一办法是擦除。所以任何写操作之前目标区域必须是“已擦除”状态全0xFF。你直接往一个之前写过数据的地址再写轻则数据错乱重则你以为写成功了断电一看还是旧数据。1.2 为什么拿GD25Q80E当样片最划算市面上SPI NOR Flash多得是Winbond的W25Q系列、Macronix的MX25系列、GD的GD25系列命令集大方向一致但细节有差异。我推荐用GD25Q80E起步理由很简单便宜练手成本低几毛钱一颗买错型号也不心疼。8脚SOP封装手工焊接友好热风枪一吹就上去。数据手册公开命令表一页能看完SPI模式、QSPI模式的时序图画得清楚。和W25Q80命令集几乎逐条对应驱动写好了以后换芯片很容易。有一点要提醒网上很多“GD25Q80E中文手册”是机翻或者旧版截图的年份、批次不同个别电气参数可能不一样。遇到和教程对不上的情况以你手上这颗芯片对应批次数据手册的时序图和参数表为准尤其是Dummy Cycle、最大时钟频率这类参数。1.3 引脚双功能QSPI的硬件门槛在这GD25Q80E常见的封装是8脚SOP引脚分布很典型引脚名标准SPI功能QSPI复用功能注意事项CS#片选片选拉低有效建议上拉CLK时钟时钟空闲极性由SPI模式决定DIMOSIIO0命令/地址/数据输入DOMISOIO1数据输出WP#写保护IO2QSPI四线模式下作为数据线HOLD#保持IO3QSPI四线模式下作为数据线VCC / GND电源电源3.3V供电注意去耦这个表就是QSPI和普通SPI最大的硬件分水岭标准SPI只用DI/DO两根线四线QSPI要把WP#和HOLD#统统变成数据线。很多开发板说“支持QSPI”但PCB上WP#/HOLD#不是没引出来就是被强上拉电阻钉死四线模式一跑就乱。所以玩QSPI之前先检查你的板子这两脚是不是真的可用。2. 命令时序读ID、写使能、页编程、擦除的核心指令全解2.1 所有命令共用的“底层语法”SPI NOR Flash的命令不是一次普通的SPI字节收发它是以CS电平为一帧边界的完整事务。整个通信的骨架是CS#拉低声明“我要开始一帧命令了”。在SCLK的节拍下依次移出命令码、地址、可能的数据字节。CS#拉高这一帧结束Flash收到帧尾并开始执行。所有字节都是MSB先行命令码、地址、数据都一样。Flash支持SPI Mode 0和Mode 3两者只是SCLK空闲极性和采样沿的差别STM32的SPI外设或QSPI外设都能配。很多人忽略的一个细节是CS#拉高的那一个上升沿才是Flash真正“锁存”命令并开始动作的时刻。比如写使能0x06你不拉高CS#它只是把字节收进去什么都没发生。反过来读数据的命令帧里CS#又必须一直保持低电平直到把该读的字节都读完提前拉高数据就丢了。2.2 读JEDEC ID0x9F最小可行验证这是接触一颗新Flash时第一件该干的事不需要地址、不需要写使能一条命令直接返回厂商和设备信息最适合验证通信链路是否通畅。时序分别是CS#拉低 → 发送0x9F → 连续读3个字节 → CS#拉高。GD25Q80E读回来通常是0xC8 0x40 0x14这样的组合第一字节0xC8表示GigadeviceGD厂商后面两字节是设备和容量信息。不同批次可能有些差异但第一字节厂商代码不会变。如果读回全0xFF或者全0x00说明通信链路有问题别急着往下面走。给一段用STM32 HAL库SPI外设读ID的参考void spi_flash_read_id(uint8_t *id) { uint8_t cmd 0x9F; flash_cs_low(); HAL_SPI_Transmit(hspi, cmd, 1, HAL_MAX_DELAY); HAL_SPI_Receive(hspi, id[0], 1, HAL_MAX_DELAY); HAL_SPI_Receive(hspi, id[1], 1, HAL_MAX_DELAY); HAL_SPI_Receive(hspi, id[2], 1, HAL_MAX_DELAY); flash_cs_high(); }有个初学者必踩的坑用HAL_SPI先Transmit命令字节后直接把CS拉高再开始Receive。这时候Flash只收到了0x9F你后面读的数据全是无效的。命令、数据必须在同一帧内完成。2.3 写使能0x06和状态寄存器轮询0x05一切写操作的前提Flash处于保护状态时光发擦除、编程命令是不执行的。它内部有个WEL锁存位即状态寄存器SR1的bit1只有WEL1才允许执行写操作。把它变成1的唯一办法就是发送写使能0x06CS#拉低 → 发送0x06 → CS#拉高。别嫌麻烦Flash每次写操作完成WIP清零后会自动把WEL清0也就是说每一次页编程、擦除之前都要重新发一次0x06。这不是冗余设计是Flash防止误擦写的基本保护机制。另外还要注意如果WP#引脚处于低电平同时状态寄存器里的写保护位被置1那么0x06会被忽略WEL永远置不上这种情况在后面的踩坑部分展开说。发完擦除或编程命令后怎么知道Flash干完活了轮询状态寄存器。0x05是读状态寄存器1的命令它的bit0就是WIPWrite In Progress位为1表示Flash正忙着擦除或编程为0表示空闲。void spi_flash_wait_busy(void) { uint8_t cmd 0x05; uint8_t sr 0; do { flash_cs_low(); HAL_SPI_Transmit(hspi, cmd, 1, HAL_MAX_DELAY); HAL_SPI_Receive(hspi, sr, 1, HAL_MAX_DELAY); flash_cs_high(); } while (sr 0x01); }注意这条命令的读法0x05本身占用了一个字节的时间但Flash的状态寄存器是从命令之后的SCLK边沿开始逐位移出的所以Receive一个字节时主机要再给8个时钟CS#全程保持低才能拿到完整的SR1。2.4 页编程0x02和扇区擦除0x20完整流程页编程的完整命令帧是CS#拉低 → 0x02 → 24位地址高字节在前 → 要写入的数据最多256字节 → CS#拉高 → 轮询WIP清零。void spi_flash_page_program(uint32_t addr, const uint8_t *buf, uint16_t len) { uint8_t cmd[4]; cmd[0] 0x02; cmd[1] (addr 16) 0xFF; cmd[2] (addr 8) 0xFF; cmd[3] addr 0xFF; spi_flash_write_enable(); // 先发0x06 flash_cs_low(); HAL_SPI_Transmit(hspi, cmd, 4, HAL_MAX_DELAY); HAL_SPI_Transmit(hspi, (uint8_t *)buf, len, HAL_MAX_DELAY); flash_cs_high(); spi_flash_wait_busy(); }页编程有一个硬性边界一次页编程不能跨越256字节的页边界。比如你要从0x00F0这个地址连续写32字节写到0x0100附近时会直接回绕到本页页首把刚开始写的数据覆盖掉。所以写数据前必须做拆分每个区块的地址范围都得落在同一页内。这块逻辑如果不想自己写可以单独抽成一个flash_write函数内部按页边界切割后循环调用页编程。扇区擦除0x20的地址必须对齐到4KB边界也就是地址低12位为0。命令帧CS#拉低 → 0x20 → 24位地址 → CS#拉高 → 轮询WIP清零。把常用命令整理成一张速查表方便照着手写驱动功能命令码地址Dummy数据方向Write Enable0x06无无无Read Status Register-10x05无无输出SR1Read Data0x0324位无输出数据Fast Read0x0B24位8个时钟输出数据Page Program0x0224位无输入数据Sector Erase (4KB)0x2024位无无Block Erase (32KB)0x5224位无无Block Erase (64KB)0xD824位无无Chip Erase0xC7无无无Read JEDEC ID0x9F无无输出3字节ID熟悉完这套SPI命令你已经能把Flash跑起来了。但如果你只是这么用STM32的SPI外设绰绰有余为什么要上QSPI看下一章。3. 从SPI到QSPI为什么要四条线STM32 QSPI外设到底是什么3.1 单线SPI的带宽天花板单线SPI每来一个时钟周期只能传输1位数据。假设你的SPI时钟跑在48MHz理论极限就是6MB/s。听起来还行但这是纯数据阶段的速度实际还要扣掉命令、地址、Dummy周期能拿到4~5MB/s已经不错。存字库、存图片、甚至直接从Flash执行代码这个带宽就紧张了。以一张800x480的RGB565图片为例约750KB6MB/s读出来需要125ms如果换成QSPI四线读同样的时钟下数据带宽变成4倍理论能压到30ms左右。这不是“快一点”是完全不同的体验。为什么写操作不强调QSPI因为写入的瓶颈根本不在传输而在Flash内部的编程时间。页编程256字节传输256字节用不了1ms但Flash内部编程典型就要几百微秒。所以QSPI提升的主要是读性能写操作用标准SPI命令就能满足绝大多数场景。3.2 QSPI的几种传输模式QSPI里常说的1-1-1、1-1-4、1-4-4三个数字分别代表命令、地址、数据三个阶段的线数。比如1-1-1命令1根线、地址1根线、数据1根线就是标准SPI。1-1-4命令和地址还是单线只有数据阶段变成4根线。典型命令是0x6BQuad Output Fast Read。1-4-4命令单线地址就切成4根线了数据自然也是4根线。典型命令是0xEBQuad I/O Fast Read。地址阶段用4根线传输后地址本身的时钟周期压缩到原来的四分之一但代价是地址发完后Flash需要额外的“Dummy Cycle”用来切换内部数据通路方向把四线数据准备好。Dummy Cycle的数目直接由Flash手册给出0x6B通常是8个0xEB一般是6个左右具体要看GD25Q80E手册里的Recommended Settings。这个参数在后面QSPI配置里是关键设错一位数据就全错位。3.3 STM32 QSPI外设不是“四线SPI”是个命令帧引擎很多人以为QSPI就是把SPI的数据线加宽其实不是。STM32的QuadSPI外设更像是为Flash定制的“命令帧引擎”你配置好指令码、地址、Alternate Byte、Dummy周期、数据长度硬件自动组装成一整帧自动控制CS的电平节奏。相比用普通SPI手动拉CS拼装每个字节QuadSPI在时序一致性上强得多尤其是进入内存映射模式后可以做到“像读内部Flash一样读外部Flash”。QuadSPI有三种工作模式间接模式Indirect ModeCPU或DMA发起命令帧适合常规的读写擦操作。内存映射模式Memory-Mapped ModeFlash内容映射到MCU地址空间直接指针读取适合字库、代码执行。状态轮询模式Status Polling Mode硬件自动轮询Flash状态寄存器适合等WIP。不是所有STM32都有QSPI外设。F103是肯定没有的F407也没有。常见带QuadSPI的有F446、F412/F413/F423、整个F7系列、H7系列、L4部分型号以及G0/G4的部分型号。在CubeMX里新建工程时如果找不到QuadSPI这个外设说明这颗芯片不支持。4. STM32 QSPI实战CubeMX配置和HAL代码直接抄作业4.1 硬件接线与CubeMX配置要点先用CubeMX的芯片引脚搜索功能输入QSPI相关信号比如QUADSPI_BK1_IO0、QUADSPI_BK1_NCS它会自动帮你过滤出支持该功能的引脚。以常见的STM32F446为例典型接线是STM32引脚信号上接Flash引脚PB2QUADSPI_CLKCLKPB6QUADSPI_BK1_NCSCS#PE7QUADSPI_BK1_IO0DI (IO0)PE8QUADSPI_BK1_IO1DO (IO1)PE9QUADSPI_BK1_IO2WP# (IO2)PE10QUADSPI_BK1_IO3HOLD# (IO3)不同型号的复用引脚差异很大CubeMX会自动显示有效引脚不用死记。CubeMX里QuadSPI的关键配置项Clock Prescaler时钟分频先给大一点比如8分频功能跑通再逐步降低。Sample Shift采样点偏移默认Half Period高速不稳定时切换Quarter Period或调整。Flash Size填的是“Flash容量bit的对数减1”。GD25Q80E是8Mbit2^23所以FlashSize填22。填错会直接导致地址访问越界或者读不出数据。ChipSelect High TimeCS高电平保持时间默认值即可不算关键。Clock Mode选Mode 0还是Mode 3GD25Q80E两者都支持保持与驱动约定一致。另外GPIO速度要设到High或Very High特别是四线高速模式下GPIO翻转速度不够会直接变成信号质量灾难。硬件上给Flash的VCC并一颗0.1uF去耦电容电容尽量靠近Flash引脚CS#建议加上拉电阻默认高电平避免上电瞬间误触发命令帧。IO2/IO3在标准SPI模式下是WP#/HOLD#很多现成模组上默认有上拉这没问题但如果要跑四线模式要确保这两脚不是被强上拉/强下拉钉死否则数据线拉不动。4.2 间接模式读写代码把命令帧翻译好接下来直接用HAL库的QuadSPI接口写驱动。核心对象是QSPI_CommandTypeDef结构体它描述一帧命令的所有要素。先看读IDuint8_t qspi_id[3]; void qspi_read_id(uint8_t *id) { QSPI_CommandTypeDef cmd {0}; cmd.Instruction 0x9F; cmd.InstructionMode QSPI_INSTRUCTION_1_LINE; cmd.AddressSize QSPI_ADDRESS_24_BITS; cmd.Address 0x000000; cmd.AddressMode QSPI_ADDRESS_NONE; // 读ID没有地址阶段 cmd.AlternateByteMode QSPI_ALTERNATE_BYTES_NONE; cmd.DataMode QSPI_DATA_1_LINE; // ID数据单线返回 cmd.DummyCycles 0; cmd.DdrMode QSPI_DDR_MODE_DISABLE; cmd.SIOOMode QSPI_SIOO_INST_EVERY_CMD; // 每条命令帧都带指令码 HAL_QSPI_Command(hqspi, cmd, 100); HAL_QSPI_Receive(hqspi, id, 3, 100); }这个结构体看起来字段多但规律很清晰每个阶段都要声明“有几根线参与”。最容易错的就是DummyCycles和SIOOMode。QSPI_SIOO_INST_EVERY_CMD表示每条命令都完整发送指令码等后面内存映射模式里就不会每条帧都重发指令要用QSPI_SIOO_INST_ONLY_FIRST_CMD。写使能和等WIP也按同样的套路翻译void qspi_write_enable(void) { QSPI_CommandTypeDef cmd {0}; cmd.Instruction 0x06; cmd.InstructionMode QSPI_INSTRUCTION_1_LINE; cmd.AddressMode QSPI_ADDRESS_NONE; cmd.AlternateByteMode QSPI_ALTERNATE_BYTES_NONE; cmd.DataMode QSPI_DATA_NONE; // 命令帧无数据阶段 cmd.DummyCycles 0; cmd.DdrMode QSPI_DDR_MODE_DISABLE; cmd.SIOOMode QSPI_SIOO_INST_EVERY_CMD; HAL_QSPI_Command(hqspi, cmd, 100); } void qspi_wait_busy(void) { QSPI_CommandTypeDef cmd {0}; uint8_t sr 0; cmd.Instruction 0x05; cmd.InstructionMode QSPI_INSTRUCTION_1_LINE; cmd.AddressMode QSPI_ADDRESS_NONE; cmd.AlternateByteMode QSPI_ALTERNATE_BYTES_NONE; cmd.DataMode QSPI_DATA_1_LINE; cmd.DummyCycles 0; cmd.DdrMode QSPI_DDR_MODE_DISABLE; cmd.SIOOMode QSPI_SIOO_INST_EVERY_CMD; do { HAL_QSPI_Command(hqspi, cmd, 100); HAL_QSPI_Receive(hqspi, sr, 1, 100); } while (sr 0x01); }页编程时命令帧里命令、地址、数据阶段都出现注意地址用单线数据也是单线0x02本身就是1-1-1的命令void qspi_page_program(uint32_t addr, const uint8_t *buf, uint16_t len) { QSPI_CommandTypeDef cmd {0}; qspi_write_enable(); cmd.Instruction 0x02; cmd.InstructionMode QSPI_INSTRUCTION_1_LINE; cmd.AddressSize QSPI_ADDRESS_24_BITS; cmd.Address addr; cmd.AddressMode QSPI_ADDRESS_1_LINE; cmd.AlternateByteMode QSPI_ALTERNATE_BYTES_NONE; cmd.DataMode QSPI_DATA_1_LINE; cmd.DummyCycles 0; cmd.DdrMode QSPI_DDR_MODE_DISABLE; cmd.SIOOMode QSPI_SIOO_INST_EVERY_CMD; HAL_QSPI_Command(hqspi, cmd, 100); HAL_QSPI_Transmit(hqspi, (uint8_t *)buf, len, 1000); qspi_wait_busy(); }这里再提醒一次页编程的len不能超过256也不能让这次传输跨页边界。跨页的拆分逻辑我在踩坑章节再展开。四线读则是另一套命令配置以0x6B为例数据阶段要切成四根线void qspi_read_fast(uint32_t addr, uint8_t *buf, uint32_t len) { QSPI_CommandTypeDef cmd {0}; cmd.Instruction 0x6B; // Quad Output Fast Read cmd.InstructionMode QSPI_INSTRUCTION_1_LINE; cmd.AddressSize QSPI_ADDRESS_24_BITS; cmd.Address addr; cmd.AddressMode QSPI_ADDRESS_1_LINE; cmd.AlternateByteMode QSPI_ALTERNATE_BYTES_NONE; cmd.DataMode QSPI_DATA_4_LINES; // 数据走四线 cmd.DummyCycles 8; // 手册给的典型值 cmd.DdrMode QSPI_DDR_MODE_DISABLE; cmd.SIOOMode QSPI_SIOO_INST_EVERY_CMD; HAL_QSPI_Command(hqspi, cmd, 100); HAL_QSPI_Receive(hqspi, buf, len, 1000); }DummyCycles如果设少读取结果会整体错位读出来的数据看起来像“少了几个字节”设多则只是慢一点不影响正确性但太慢了QSPI就失去意义。先按手册典型值设跑通后用示波器或逻辑分析仪对照数据。4.3 内存映射模式像访问数组一样读Flash内存映射模式是QSPI最爽的应用方式。配置完成后外部Flash会被映射到STM32的0x90000000地址空间你直接定义一个指针就能读完全不需要每次发命令。先要配置好映射参数void qspi_memory_mapped_init(void) { QSPI_CommandTypeDef cmd {0}; QSPI_MemoryMappedTypeDef mem_cfg {0}; cmd.Instruction 0xEB; // Quad I/O Fast Read cmd.InstructionMode QSPI_INSTRUCTION_1_LINE; cmd.AddressSize QSPI_ADDRESS_24_BITS; cmd.AddressMode QSPI_ADDRESS_4_LINES; // 地址阶段四线 cmd.AlternateByteMode QSPI_ALTERNATE_BYTES_NONE; cmd.DataMode QSPI_DATA_4_LINES; // 数据阶段四线 cmd.DummyCycles 6; // 按手册Recommended Settings调整 cmd.DdrMode QSPI_DDR_MODE_DISABLE; cmd.SIOOMode QSPI_SIOO_INST_ONLY_FIRST_CMD; // 之后帧不再重发指令 mem_cfg.TimeOutActivation QSPI_TIMEOUT_COUNTER_DISABLE; mem_cfg.TimeOutPeriod 0; mem_cfg.ClkDiv 4; // 分频先保守再往下压 HAL_QSPI_MemoryMapped(hqspi, cmd, mem_cfg); }配置完成后读取就是一行代码的事uint8_t data *(uint8_t *)(0x90000000 flash_offset);如果你存的是字库直接把地址偏移算好用memcpy批量读出来都行。如果固件支持XIPExecute In Place甚至可以跳到0x90000000执行代码这就是另一个话题了。但内存映射模式有个限制它是只读的。你要写Flash必须切回间接模式发页编程和擦除命令。有些库的做法是“先HAL_QSPI_DeInit再重新初始化配置”比较简陋更好的是保留一套间接模式的命令接口映射只是读路径。实际项目中经常是驱动初始化时用间接模式写数据写完以后切到内存映射模式跑应用。5. 踩坑实录我在这颗芯片上翻过的几个车5.1 读出来全是0xFF先别怀疑Flash坏了这是最常见的现象。通信链路没通Flash处于高阻态数据线被上拉电阻拉高读回来的自然全是0xFF。排查顺序如下量VCC和GND确认芯片真的上电了。有些核心板的排针默认没有3.3V输出或者引脚接触不良。确认CS#在空闲时是高电平拉低后能到0V。很多驱动库里CS极性写反导致整帧命令根本没有生效。确认SPI的时钟极性和相位。GD25Q80E支持Mode 0和Mode 3但如果你的主机配成了Mode 1或Mode 2协议就对不上。读ID时CS#是否保持到数据读完参考2.2节的坑。检查WP#/HOLD#引脚。HOLD#如果悬空或电平不稳定Flash可能一直处于HOLD状态所有命令都被忽略。把HOLD#接上拉、WP#接上拉先排除这两个引脚的影响。用软件模拟SPI去读ID是最快的定位手段。不依赖SPI外设的极性配置直接GPIO翻转每一拍都看得见能排除一大半外设配置问题。5.2 页编程跨页导致数据被覆盖这个坑我用一句话描述你就明白了Flash页编程命令里包含页内地址的全部低8位如果发送的数据长度超过了当前页剩余空间地址计数器会回绕到本页的起始位置而不是跑到下一页。举个例子地址0x00F0页内还剩16字节空间你要页编程32字节那前16字节写在了0x00F0~0x00FF后16字节直接覆盖到0x0000~0x000F。如果不做处理页首数据就毁了。解决办法是在应用层做拆分uint32_t remain_in_page 256 - (addr 0xFF); uint32_t chunk len remain_in_page ? remain_in_page : len; // 第一次写chunk长度addr chunk, len - chunk // 循环直到len为0擦除没有这个问题因为擦除的最小单位是4KB扇区地址范围天然对齐。但擦除地址不对齐低12位不为0时某些Flash会直接忽略这条命令所以擦除前要对地址做addr ~0xFFF这样的对齐操作。5.3 擦除看起来成功断电后数据还在“成功”的意思是命令发出去、WIP也等到0了但读回来发现数据根本没变。这种问题九成出在写使能没生效上。排查方法很简单执行0x06后立刻读SR1检查bit1WEL是不是1。如果WEL0说明命令被Flash拒绝了。常见的原因状态寄存器里的写保护位BP3~BP0还是1。新买的芯片不一定全是0有的出厂默认开了保护。WP#引脚被拉低同时SRP0位被置位导致状态寄存器被锁定0x06不生效。你的驱动里漏发了0x06或者CS#提前拉高导致写使能没有真正寄存。养成一个习惯每次擦除或编程后回读目标区域数据确认结果。Flash这东西命令返回成功不等于数据正确读回验证才是唯一标准。5.4 QSPI四线读失败指令线数和Dummy Cycle的锅从SPI切到QSPI最容易卡死的就是四线读。命令发出去读回来的数据要么全是乱码要么整体偏移几个字节。原因集中在两处第一DataMode和命令不匹配。0x6B是Quad Output Fast Read地址阶段还是单线但数据阶段是四线。如果你把它配置成QSPI_DATA_1_LINEFlash端的IO2/IO3不会被驱动读出来的数据自然不对。反过来0xEB是Quad I/O Fast Read地址阶段就是四线如果用QSPI_ADDRESS_1_LINE去配时序完全错乱。第二DummyCycles不对。0x6B的dummy通常设80xEB的dummy和mode周期更讲究不同厂家甚至不同容量的同厂芯片都可能不一样。设少了Flash还没准备好数据主机就开始采样读出来的每一位都错位设多了只是慢不会错所以调试时可以先多给几个dummy功能通了再优化。我建议QSPI调试分三步走先间接模式用0x6B单条命令读ID/读固定地址时钟分频往大调确认数据传输正确再切0xEB确认地址阶段四线没问题最后才上内存映射模式。跳步调试出了问题根本分不清是硬件还是配置。5.5 随机性误码和偶发卡死先在降低时钟上找答案如果你读100次有98次正确、2次乱码或者系统跑一段时间突然读回来全0xFF这类偶发问题比完全读不出来更让人头疼。根据我自己的经验按下面顺序查降低QSPI时钟分频。一上来就想跑满Flash标称的120MHzPCB走线、过孔、接插件质量都会成为瓶颈。降到50MHz以内先确认逻辑功能完全正确再一步一步提频。调整Sample Shift。CubeMX里QuadSPI有个采样点偏移选项默认Half Period也就是在时钟下降沿后采样。遇到信号边沿不够陡的情况可以切成Quarter Period相当于把采样点往后挪避开数据翻转的毛刺窗口。检查IO2/IO3的上拉/下拉。四线模式下IO2/IO3既是输入又是输出方向切换的那一瞬间如果电平不确定可能被Flash误判为非法状态。给这两个脚加10kΩ上拉最稳。检查电源。Flash在擦除时瞬间电流比读时要大不少如果VCC引脚上的去耦电容离得太远或者板子电源本身纹波大擦除过程中WIP轮询会偶发卡死。量一下Flash VCC引脚的纹波别只盯着开发板的3.3V指示灯看。最后还有个经验STM32刚上电那几十毫秒QSPI外设和Flash本身都还没稳定如果main函数第一条就访问Flash很容易拿回随机值。在初始化QSPI之前加几十毫秒延时或者等系统时钟完全稳定后再操作能少很多莫名其妙的“第一次上电读失败”。这阵子玩下来我最大的体会是SPI NOR Flash看起来就是一个“带时序的移位寄存器”命令表就那些难的是你把每条命令帧的边界条件记清楚。如果你现在正卡在读ID这步听我一句先用软件模拟SPI把0x9F、0x06、0x05、0x02、0x20这几条命令全部调通再上硬件SPI最后才碰QSPI。时序这种东西画在纸上、记在心里写代码只是把它翻译一遍。等你把0x6B和0xEB的Dummy Cycle都吃透了再看其他任何一片SPI NOR Flash都不会再有“这芯片到底怎么玩”的疑问了。