STM32F7裸机C开发QSPI间接模式读操作返回乱码故障排查

问题基础信息 #

• 开发环境：Windows 10、STM32CubeIDE 1.8.0
• 硬件：STM32F746 Discovery开发板，主控STM32F746，板载QSPI Flash型号MT25QL128ABA1EW9-0SIT
• 调试设备：入门级示波器、带协议解码功能的入门级逻辑分析仪
• 开发目标：实现QSPI间接模式读写

已确认现象 #

• 间接写模式指令发送功能正常，间接读模式读取Flash寄存器时总线持续返回固定乱码，暂未开展存储阵列读写测试
• 时钟、GPIO初始化配置与TouchGFX生成的QSPI内存映射模式代码、ST官方STM32F7固件包QSPI例程完全一致
• 分别测试1MHz（适配调试设备带宽）、108MHz（Flash标称工作时钟）两种QSPI时钟，读操作均返回乱码，ST官方提供的QSPI例程本身无法正常运行
• 现有驱动包含4个核心函数：qspi_setup_indirect_mode（间接模式初始化）、qspi_set_command_mode（命令模式配置）、qspi_sendCommandIndirectWrite（间接写实现）、qspi_sendCommandIndirectRead（间接读实现）；仅当执行「每次传输前禁用QSPI外设→完成配置后重新使能→写入指令启动传输」的流程时，间接写功能可正常运行，该操作要求未在STM32参考手册中提及
• 逻辑分析仪捕获的读状态寄存器时序存在多处异常：
  • Flash返回数据未按参考手册说明在DQ1线传输
  • DQ3引脚偶发随机拉高
  • 总线时钟周期数不符合配置预期
  • 总线上出现未定义的0x80数据帧
• 经多轮配置排查未定位故障根因，公开渠道可参考的QSPI裸机开发资料极少

可直接落地的排查与修复步骤 #

1. 优先修复引脚配置问题
   单线SPI模式下Flash返回数据走DQ1（MISO），你看到数据不在DQ1、DQ3随机拉高，90%概率是引脚配置不全：不要觉得单线模式不需要用到DQ2、DQ3就不配这两个引脚。MT25QL128上电默认DQ3引脚为/HOLD功能，只要该引脚电平被拉低，Flash就会暂停总线传输，直接导致时钟数不对、数据错乱。必须把QSPI Bank1的所有引脚（CLK、NCS、DQ0~DQ3）全部配置为复用推挽输出、最高速度等级、无上下拉，不要留任何一个DQ引脚为浮空输入状态。
   接逻辑分析仪时先核对接线：探头通道对应PB2（DQ0/MOSI）、PD12（DQ1/MISO）、PD13（DQ2）、PD11（DQ3/HOLD）、PB6（NCS）、PB1（CLK），不要接反DQ0和DQ1。
2. 修复QSPI外设初始化的状态残留问题
   STM32F746的QSPI外设有未公开的状态锁死问题，从内存映射模式切到间接模式时，必须先发送终止命令清空状态，否则所有寄存器配置都不会生效——这也是ST官方例程跑不起来的核心原因：Discovery板默认启动流程会先进入TouchGFX的QSPI内存映射初始化，你自己的代码如果不先清状态，后续配置全无效。
   初始化QSPI的第一步固定执行以下操作：

   // 终止所有正在进行的传输，退出内存映射/间接读/写状态
   QUADSPI->CR |= QUADSPI_CR_ABORT;
   while(QUADSPI->SR & QUADSPI_SR_BUSY);
   // 清空所有状态标志
   QUADSPI->FCR = 0x3F;
   

3. 修正间接读的配置流程
   你现在用的「禁用→配置→使能→启动传输」流程是对的，STM32F7的QSPI在间接模式下确实需要这个操作，属于硅片bug，参考手册未标注，不用怀疑。额外要加几个关键配置：
   • 每次配置前读4次QUADSPI->DR寄存器，清空FIFO里的残留数据，否则旧数据会和新读的数据错位
   • FIFO阈值固定设为1字节（即QUADSPI->CR的FTHRES位域设为0），不要用默认的4字节阈值，否则低速下会出现FIFO读空/溢出问题
   • 读状态寄存器这类无地址、无Dummy周期的指令，必须把QUADSPI->CCR的DCYC位域设为0，ADMODE位域设为0（无地址阶段），所有阶段线宽都设为单线模式，不要开多线模式
   • 传输长度寄存器QUADSPI->DLR必须配置为「待读字节数-1」，读1字节状态寄存器就设为0，配置错误会直接导致输出时钟数不对，多出来的时钟采到总线空闲电平（通常就是你看到的0x80固定值）
   • 1MHz低速测试时必须关闭采样移位（即SAMPLE_SHIFTING位清0），只有时钟超过50MHz时才需要开这个位，否则采样点错位会直接读回乱码
4. 修正读数据的标志判断逻辑
   不要等传输完成标志（TCF）置位后再读FIFO，要等FIFO阈值标志（FTF）置位就立刻读数据寄存器，等TCF置位时FIFO里的有效数据已经被后续时钟覆盖，必然读回乱码。
   读1字节状态寄存器的标准流程参考：

   uint8_t QSPI_ReadStatusReg(void)
   {
       uint8_t res = 0;
       // 等待总线空闲
       while(QUADSPI->SR & QUADSPI_SR_BUSY);
       // 禁用QSPI
       QUADSPI->CR &= ~QUADSPI_CR_EN;
       // 清空FIFO残留
       for(uint8_t i=0; i<4; i++){ volatile uint8_t tmp = QUADSPI->DR; (void)tmp; }
       // 清空所有标志
       QUADSPI->FCR = 0x3F;
       // 配置CCR：0x05读状态指令，无地址，无Dummy，单线传输
       QUADSPI->CCR = 0x00000105;
       // 传输长度1字节，DLR设为0
       QUADSPI->DLR = 0;
       // FIFO阈值1字节，使能QSPI
       QUADSPI->CR = (QUADSPI->CR & ~QUADSPI_CR_FTHRES) | QUADSPI_CR_EN;
       // 启动间接读传输
       QUADSPI->CCR |= QUADSPI_CCR_FMODE_0;
       // 等FIFO有数据立刻读取
       while(!(QUADSPI->SR & QUADSPI_SR_FTF));
       res = QUADSPI->DR;
       // 等传输完成清除标志
       while(!(QUADSPI->SR & QUADSPI_SR_TCF));
       QUADSPI->FCR = QUADSPI_FCR_CTCF;
       return res;
   }
   

按以上步骤配置完，先在1MHz时钟下抓时序，确认DQ3电平稳定为高、时钟数为8个（对应1字节数据传输）、DQ1线上能读到正确的状态寄存器默认值（MT25QL128上电默认值为0x00或0x08），再逐步提高时钟频率即可。

内容的提问来源于stack exchange，提问作者Ilya