STM32H743 QSPI PSRAM内存扩展实战：从硬件连接到XIP代码执行-平芜编程栈

简介：本资源是面向嵌入式开发工程师与STM32进阶学习者的实战型工程例程，聚焦STM32H7系列高性能MCU在复杂存储扩展场景下的QSPI外设驱动开发。针对64 Mbit容量VTI7064 SRAM芯片，完整实现基于STM32H743VIT6的QSPI总线读写控制、时序配置与内存映射访问，适用于工业控制、图像缓存及实时数据交换等对高速外部存储有明确需求的应用场景。压缩包共262个文件，含36个C源码与76个头文件（构建HAL库驱动与应用逻辑）、37个编译中间文件（.o/.d）及36个调试符号文件（.su），另有PDF说明文档、BIN/ELF可执行镜像、IOC引脚配置及Makefile构建脚本，整体18.55MB，结构规范便于二次开发与移植。已有526人学习下载，提供开箱即用的CubeIDE工程、关键外设初始化代码（如QSPI、RCC、DMA、TIM）、实测时序验证逻辑及硬件连接说明，显著降低QSPI-SRAM集成门槛。

1. 项目背景与核心需求解析

最近在做一个基于STM32H743VIT6的图像处理项目，遇到了一个典型的内存瓶颈。项目需要缓存和处理来自摄像头的高分辨率图像帧，一帧720P的RGB565图像就需要大约1.4MB的存储空间。STM32H743VIT6虽然内置了1MB的SRAM，但系统本身、各种外设缓冲区和中间处理过程已经占用了不少，留给图像帧的连续空间非常紧张，经常出现内存不足导致程序跑飞的情况。

这时候，外扩内存就成了一个必须考虑的方案。常见的方案有几种：使用并行总线外扩SDRAM，或者使用QSPI接口外扩PSRAM。前者速度快，但需要占用大量IO引脚，布线复杂，对PCB层数和设计都有较高要求。后者，也就是QSPI接口，只需要6根线（CLK, CS, IO0-IO3），就能实现高速的四线通信，极大地节省了宝贵的IO资源，尤其适合引脚已经比较紧张的复杂应用。

我手头正好有一片VTI7064，这是一款8MB容量的QSPI接口PSRAM。PSRAM可以简单理解为一种具有SRAM接口的DRAM，它内部是DRAM的存储单元，但通过内置的刷新控制器，对外提供了类似SRAM的静态接口，无需主控操心刷新时序。它的成本比传统SRAM低，容量又比片内SRAM大得多，是STM32这类MCU进行内存扩展的一个高性价比选择。

所以，这个项目的核心目标就非常明确了：将VTI7064这颗8MB的QSPI PSRAM，配置为STM32H743VIT6的可执行内存（XIP）或高速数据缓冲区，以解决大容量图像数据缓存的问题。这不仅仅是简单的读写测试，而是要让它能像使用片内SRAM一样方便、高效。

2. QSPI与PSRAM基础：为什么是这对组合？

在深入配置之前，有必要先厘清几个关键概念，这能帮助我们理解后续每一个配置参数的意义。

2.1 QSPI接口的工作模式剖析

QSPI，全称Quad SPI，是SPI接口的增强版。传统的SPI有MOSI（主机输出）、MISO（主机输入）、CLK和CS四根线，是单线双向通信。而QSPI在四线模式下，可以将IO0-IO3这四根线都用于数据收发，从而实现四线双向通信，理论带宽是标准SPI的四倍。

STM32的QSPI外设通常支持三种模式：

间接模式：最像传统SPI。每次传输都需要CPU通过寄存器明确指定命令、地址、数据。灵活性最高，但效率较低，CPU介入深。
状态轮询模式：一种特殊的间接模式，用于周期性读取外设的状态寄存器，直到满足某个条件（如擦除/写入完成）。常用于控制Flash的编程操作。
内存映射模式：这是实现“像使用内存一样使用外设”的关键。在此模式下，QSPI外设会将外部存储器的地址空间映射到MCU的地址总线上。CPU通过访问一段特定的内存地址（例如0x9000 0000），其访问请求会被QSPI外设自动转换为对应的命令、地址周期，并返回数据。CPU感知不到QSPI的存在，它以为自己在访问一段慢一点的片上RAM。这种模式是实现XIP（eXecute In Place，芯片内执行）的基础。

我们的目标，就是将VTI7064配置到内存映射模式。

2.2 VTI7064 PSRAM的关键特性

VTI7064是一颗8M x 8bit（即8MB）的PSRAM。与标准SRAM相比，有几点需要特别注意：

混合接口：它支持标准的SPI、Dual-SPI和Quad-SPI指令集，兼容性很好。但它的底层是DRAM，需要定期刷新。
内置刷新：幸运的是，VTI7064内部集成了自刷新控制器。这意味着我们不需要像控制SDRAM那样，在软件中定时发送刷新命令。它对外完全表现为一个静态存储器，大大简化了驱动设计。
封装与速度：常见的VTI7064是WSON-8封装，工作电压在1.8V或3.3V。其最高时钟频率可达133MHz（在Fast Read Quad I/O模式下）。在四线模式下，理论数据吞吐量可达133MHz * 4 bit = 532Mbps，这对于MCU来说是非常可观的带宽。
命令集：它有一套自己的指令，例如读ID（0x9F）、写使能（0x06）、四线读（0xEB）等。初始化过程就是通过QSPI向它发送一系列正确的命令。

2.3 SRAM、DRAM与PSRAM的异同

这是一个常见的困惑点，简单梳理一下：

SRAM（静态随机存储器）：每个存储单元由6个晶体管组成，只要通电数据就一直保持，速度快，但结构复杂、成本高、密度低。STM32片内的RAM就是SRAM。
DRAM（动态随机存储器）：每个存储单元由1个晶体管和1个电容组成，依靠电容电荷存储数据。电容会漏电，所以需要定期刷新（Refresh）以维持数据。成本低，密度高，但速度相对慢且需要刷新逻辑。电脑的内存条就是DRAM。
PSRAM（伪静态随机存储器）：本质是DRAM，但在芯片内部集成了刷新控制电路。对外部控制器而言，它表现得像SRAM一样，无需管理刷新时序，提供了“静态”的接口。VTI7064就是这种芯片。

因此，选择VTI7064这类PSRAM，是在成本、容量、易用性和速度之间取得的一个很好平衡。

3. 硬件设计要点与陷阱规避

硬件连接是稳定的基础，这里有几个坑我踩过，需要特别注意。

3.1 引脚连接与上拉电阻

STM32H743VIT6的QSPI引脚是固定的（Bank1在PE2, PE3, PE4, PE5, PE6, PD11）。连接非常简单：

QSPI_CLK->VTI7064_CLK
QSPI_BK1_IO0->VTI7064_IO0(D0)
QSPI_BK1_IO1->VTI7064_IO1(D1)
QSPI_BK1_IO2->VTI7064_IO2(D2)
QSPI_BK1_IO3->VTI7064_IO3(D3)
QSPI_BK1_NCS->VTI7064_CS#

关键陷阱1：上拉电阻。VTI7064的IO线是开漏输出吗？并不是，它的IO是推挽/开漏可配的，但通常数据手册会建议在IO0-IO3上连接弱上拉电阻（例如10KΩ）。尤其是在上电初始阶段，QSPI外设还未配置，这些引脚可能处于高阻态，弱上拉可以确保电平稳定，避免因引脚浮空产生意外电流或误触发。这个电阻虽然小，但对系统稳定性至关重要，我曾在早期版本中省略，导致在高温环境下偶发通信失败。

关键陷阱2：电源与去耦。VTI7064通常采用3.3V供电。必须在其电源引脚附近放置一个0.1uF的陶瓷去耦电容，并且尽量靠近芯片的电源引脚。QSPI工作在高频下，瞬间电流变化大，良好的去耦是保证信号完整性的前提。如果板子空间允许，再并联一个10uF的钽电容作为储能电容会更稳。

3.2 电平匹配与时钟布局

STM32H743的IO口电压域由VDD决定，通常是3.3V。确保VTI7064也工作在3.3V，这样就不需要电平转换。

时钟线（CLK）是高频信号线，在PCB布局时应尽量短，并避免靠近其他高频信号或模拟信号。如果CLK线走线过长或过绕，可能会引入振铃或边沿退化，导致在最高速率下采样失败。一个实用的做法是，将QSPI相关器件（MCU和PSRAM）尽可能靠近放置，并优先布置CLK和CS线。

4. 软件驱动层：从零构建QSPI PSRAM驱动

这里我们使用HAL库进行开发，但会深入理解其背后的寄存器操作。整个过程分为初始化、配置内存映射模式、测试验证三个部分。

4.1 QSPI外设初始化与GPIO配置

首先，需要开启QSPI和对应GPIO口的时钟，并配置引脚复用功能。

// 启用时钟 __HAL_RCC_QSPI_CLK_ENABLE(); __HAL_RCC_GPIOE_CLK_ENABLE(); __HAL_RCC_GPIOD_CLK_ENABLE(); // 配置GPIO GPIO_InitTypeDef GPIO_InitStruct = {0}; GPIO_InitStruct.Pin = GPIO_PIN_2 | GPIO_PIN_3 | GPIO_PIN_4 | GPIO_PIN_5 | GPIO_PIN_6; // PE2~PE6 GPIO_InitStruct.Mode = GPIO_MODE_AF_PP; // 复用推挽输出 GPIO_InitStruct.Pull = GPIO_NOPULL; GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_VERY_HIGH; // 非常重要！必须设为最高速 GPIO_InitStruct.Alternate = GPIO_AF9_QUADSPI; // 引脚复用为QSPI功能 HAL_GPIO_Init(GPIOE, &GPIO_InitStruct); GPIO_InitStruct.Pin = GPIO_PIN_11; // PD11, NCS GPIO_InitStruct.Alternate = GPIO_AF9_QUADSPI; HAL_GPIO_Init(GPIOD, &GPIO_InitStruct);

注意：GPIO_SPEED_FREQ_VERY_HIGH必须设置。QSPI通信速率可能超过100MHz，如果GPIO速度等级不够，信号边沿会变得缓慢，无法正确传输数据。

接下来，配置QSPI外设的基本参数。在内存映射模式之前，我们需要先用间接模式与VTI7064“对话”，发送命令来配置它。

QSPI_HandleTypeDef hqspi; hqspi.Instance = QUADSPI; // 配置时钟预分频器。假设HCLK为200MHz，我们希望QSPI时钟为100MHz // QSPI Clock = 200MHz / (2 + 1) = 66.6MHz。 保守起步，后续可调高。 hqspi.Init.ClockPrescaler = 2; // 采样时钟边沿。通常选择下降沿，具体需参考VTI7064数据手册时序图 hqspi.Init.ClockMode = QSPI_CLOCK_MODE_0; // 空闲时CLK为低电平，在下降沿采样 hqspi.Init.FlashSize = 23; // 关键参数！地址线宽度。8MB = 2^23 字节，所以这里是 23 (位置) hqspi.Init.ChipSelectHighTime = QSPI_CS_HIGH_TIME_2_CYCLE; // CS高电平时间，2个周期 hqspi.Init.FifoThreshold = 1; // FIFO阈值，通常为1 hqspi.Init.SampleShifting = QSPI_SAMPLE_SHIFTING_HALFCYCLE; // 半周期采样偏移，有助于数据建立保持 hqspi.Init.FlashID = QSPI_FLASH_ID_1; // 使用Bank1 hqspi.Init.DualFlash = QSPI_DUALFLASH_DISABLE; // 单Flash模式 if (HAL_QSPI_Init(&hqspi) != HAL_OK) { Error_Handler(); }

FlashSize这个参数非常关键，它告诉STM32的QSPI控制器你的外部存储器有多大，用于正确生成地址周期。设置错误会导致访问的地址错乱。

4.2 VTI7064 PSRAM的初始化序列

在内存映射之前，必须通过间接模式发送一系列命令来配置VTI7064的工作模式。这个过程类似于配置一个复杂的寄存器。

首先，我们发送读ID命令（0x9F）来验证通信是否正常。

uint8_t id_buffer[3] = {0}; QSPI_CommandTypeDef s_command = {0}; s_command.InstructionMode = QSPI_INSTRUCTION_1_LINE; // 指令阶段用1根线 s_command.Instruction = 0x9F; // Read ID命令 s_command.AddressMode = QSPI_ADDRESS_NONE; // 此命令无地址阶段 s_command.DataMode = QSPI_DATA_1_LINE; // 数据阶段用1根线 s_command.NbData = 3; // 预期读回3字节ID s_command.DdrMode = QSPI_DDR_MODE_DISABLE; s_command.DdrHoldHalfCycle = QSPI_DDR_HHC_ANALOG_DELAY; s_command.SIOOMode = QSPI_SIOO_INST_EVERY_CMD; if (HAL_QSPI_Command(&hqspi, &s_command, HAL_QPSI_TIMEOUT_DEFAULT_VALUE) != HAL_OK) { // 错误处理 } if (HAL_QSPI_Receive(&hqspi, id_buffer, HAL_QPSI_TIMEOUT_DEFAULT_VALUE) != HAL_OK) { // 错误处理 } // 打印或比对 id_buffer[0], [1], [2]，应与VTI7064数据手册的制造商ID、存储器类型ID、容量ID一致

通信正常后，我们需要配置VTI7064进入“Quad I/O”模式，并使其支持所谓的“Continuous Read”模式（命令0xEB），这是实现高性能内存映射读操作的关键。

写使能：在修改配置寄存器前，需要先发送写使能命令（0x06）。
写状态寄存器：VTI7064有一个状态寄存器，我们需要设置其中的某个位（具体位需查数据手册，例如可能是“QE”位，即Quad Enable）来使能四线输出模式。通过写状态寄存器命令（0x01）完成。
发送模式设置命令：有些PSRAM需要通过特定的命令序列（如0x35）来激活持续读模式。VTI7064可能需要通过写配置寄存器（0xC0）来设置延迟周期（Dummy Cycle）等参数。

这里是一个极易出错的地方：Dummy Cycle（空指令周期）的设置。在发送0xEB（Fast Read Quad I/O）命令时，命令格式通常是：1字节指令 + 3字节地址 + M个Dummy Cycle + 数据。Dummy Cycle的数量取决于QSPI的时钟频率。频率越高，PSRAM内部准备数据需要的时间越多，需要的Dummy Cycle就越多。VTI7064的数据手册会提供一个表格。例如，在104MHz下可能需要6个Dummy Cycle。这个值必须设置正确，否则读回的数据全是错乱的。

// 示例：配置VTI7064进入Quad模式并设置内存映射读参数（假设） s_command.InstructionMode = QSPI_INSTRUCTION_1_LINE; s_command.Instruction = 0x06; // Write Enable s_command.AddressMode = QSPI_ADDRESS_NONE; s_command.DataMode = QSPI_DATA_NONE; HAL_QSPI_Command(&hqspi, &s_command, HAL_QPSI_TIMEOUT_DEFAULT_VALUE); HAL_Delay(1); // 短暂延时，确保命令执行完毕 // 假设通过写寄存器0xC0来设置，具体值需查手册 uint8_t config_value = 0x02; // 例如，设置Dummy Cycle=6 s_command.Instruction = 0xC0; // Write Configuration Register s_command.DataMode = QSPI_DATA_1_LINE; s_command.NbData = 1; HAL_QSPI_Command(&hqspi, &s_command, HAL_QPSI_TIMEOUT_DEFAULT_VALUE); HAL_QSPI_Transmit(&hqspi, &config_value, HAL_QPSI_TIMEOUT_DEFAULT_VALUE);

4.3 配置内存映射模式

这是最后一步，也是让QSPI PSRAM变身成“内存”的一步。我们需要告诉STM32的QSPI控制器，以后所有对特定地址范围的访问，都应该自动转换为对VTI7064的0xEB读命令。

QSPI_CommandTypeDef s_mem_mapped_cmd = {0}; QSPI_MemoryMappedTypeDef s_mem_mapped_cfg = {0}; // 配置用于内存映射读的命令序列 s_mem_mapped_cmd.InstructionMode = QSPI_INSTRUCTION_1_LINE; s_mem_mapped_cmd.Instruction = 0xEB; // Fast Read Quad I/O 命令 s_mem_mapped_cmd.AddressMode = QSPI_ADDRESS_4_LINES; // 地址阶段使用4根线 s_mem_mapped_cmd.AddressSize = QSPI_ADDRESS_24_BITS; // 24位地址，对应8MB s_mem_mapped_cmd.AlternateByteMode = QSPI_ALTERNATE_BYTES_NONE; s_mem_mapped_cmd.DataMode = QSPI_DATA_4_LINES; // 数据阶段使用4根线！！！ s_mem_mapped_cmd.DummyCycles = 6; // ！！！这是关键，根据时钟频率和手册设置 s_mem_mapped_cmd.DdrMode = QSPI_DDR_MODE_DISABLE; s_mem_mapped_cmd.DdrHoldHalfCycle = QSPI_DDR_HHC_ANALOG_DELAY; s_mem_mapped_cmd.SIOOMode = QSPI_SIOO_INST_EVERY_CMD; // 配置内存映射模式 s_mem_mapped_cfg.TimeOutActivation = QSPI_TIMEOUT_COUNTER_DISABLE; // 禁用超时 s_mem_mapped_cfg.TimeOutPeriod = 0; if (HAL_QSPI_MemoryMapped(&hqspi, &s_mem_mapped_cmd, &s_mem_mapped_cfg) != HAL_OK) { Error_Handler(); }

当HAL_QSPI_MemoryMapped调用成功后，VTI7064的存储空间就已经被映射到了STM32的地址总线上。映射的基地址是固定的，对于QSPI Bank1，通常是0x9000 0000。这意味着，你现在可以像使用指针一样访问这片内存了：

volatile uint8_t *ext_ram = (volatile uint8_t *)0x90000000; uint32_t test_addr = 0x1000; // 偏移地址 // 写入数据 ext_ram[test_addr] = 0xAA; // 读取数据 uint8_t read_data = ext_ram[test_addr]; // 这里会触发QSPI控制器自动执行一次完整的0xEB读命令序列

5. 实战测试、性能优化与深度避坑

配置完成后，必须进行严格的测试，并了解其性能边界。

5.1 基础读写测试与数据完整性验证

简单的逐字节读写测试是第一步，但不足以发现所有问题。我推荐进行以下几种测试：

递增模式测试：向整个内存区域（或一大块）写入一个递增的模式（如0x00, 0x01, 0x02...），然后读回校验。这能检测地址线是否有错位或短路。
** walking 1/0 测试**：写入0x01，然后左移一位变成0x02，再写入，如此循环。这能检测数据线的每一位是否都能正确写入和读取。
伪随机数测试：使用一个伪随机数生成器（如简单的线性同余生成器）生成测试数据写入，再读回比对。这种随机模式更容易发现时序上的边际错误。
跨页边界测试：PSRAM内部有页（Page）或行（Row）的概念。连续访问同一行内部速度很快，但跨行访问可能会有一个额外的延迟（tRC）。测试连续访问行末和行首的数据，看是否有数据错误或速度突变。

一个真实的坑：我曾发现写入后立即读取正确，但断电再上电后数据丢失。问题根源在于写操作没有成功执行。QSPI内存映射模式默认只配置了读命令序列（0xEB）。向映射地址写数据，QSPI控制器并不会自动处理！内存映射模式通常只用于XIP或只读数据。如果需要对PSRAM进行写操作，必须切回间接模式，使用写命令（如0x02 Page Program）来完成。或者，需要更复杂的配置，将写命令也映射到总线上（部分STM32型号支持，但配置极其复杂）。因此，不要试图通过内存映射地址直接写入数据，这会导致未定义行为。正确的做法是：读用内存映射，写用间接模式API。

5.2 性能基准测试与优化策略

使用内存映射模式读取数据，性能如何？我们可以用CoreMark或一个简单的内存拷贝循环来测试。

volatile uint8_t *src = (volatile uint8_t *)0x90000000; uint8_t dst[1024]; uint32_t start, end; start = DWT->CYCCNT; // 使用DWT周期计数器测量 for(int i=0; i<1024; i++) { dst[i] = src[i]; } end = DWT->CYCCNT; uint32_t cycles = end - start; float speed_MBps = (1024.0f / (cycles / (SystemCoreClock / 1e6f))); // 计算速度

你会发现，即使QSPI时钟开到100MHz，实际有效带宽可能也只有20-30MB/s左右，远低于理论值。原因如下：

指令、地址、Dummy Cycle开销：每次读操作，QSPI控制器都要先发送1字节指令+3字节地址+6个Dummy Cycle，然后才是数据。这些开销在连续读取时，只有第一次是必须的，后续可以“连续读”。但STM32的QSPI在内存映射模式下，是否启用了“连续读”或“自动递增地址”模式，需要仔细配置。SIOOMode参数设置为QSPI_SIOO_INST_EVERY_CMD意味着每次传输都发送指令，这会降低连续读效率。对于某些存储器，可以设置为只在第一次访问时发送指令。
AHB总线与缓存的影响：CPU通过AHB总线访问0x9000 0000这个区域。这个访问不会经过Cache（除非你特别配置了MPU）。每次读取都是实实在在的、慢速的外部总线访问。对于需要频繁访问的数据，性能是瓶颈。
优化手段：
- 启用指令缓存（ICache）和数据缓存（DCache）：STM32H7系列有独立的L1 Cache。虽然QSPI区域默认非缓存，但可以通过配置MPU（内存保护单元）将其设置为“Write-through”或“Write-back”缓存策略。这是一个巨大的性能提升点。将QSPI映射区域设置为可缓存后，CPU第一次读取会较慢，但数据会被加载到Cache中，后续的重复访问速度就是CPU内核的速度了。这对于执行代码（XIP）或频繁读取的查表数据非常有效。
- 使用DMA进行大数据块搬运：如果需要在片内SRAM和外部PSRAM之间搬运大量数据（如图像帧），使用QSPI的DMA模式是最高效的。你可以配置DMA从QSPI数据寄存器直接搬运到目标内存地址，解放CPU。
- 提高时钟频率与优化Dummy Cycle：在保证信号完整性的前提下，尝试提高ClockPrescaler，并精确调整DummyCycles到数据手册允许的最小值。

5.3 高级话题：将QSPI PSRAM用于代码执行（XIP）

这是更进阶的用法。通过链接脚本（Linker Script），我们可以把一部分函数或只读数据段（如.constdata）放到QSPI PSRAM中。

修改链接脚本：在Keil的.sct文件或GCC的.ld文件中，定义一个新的内存区域（如QSPI_RAM），起始地址为0x90000000，长度8M。然后将某个输入段（如.text.xiptext）放置到这个区域。
```
MEMORY { RAM (xrw) : ORIGIN = 0x20000000, LENGTH = 512K QSPI (rx) : ORIGIN = 0x90000000, LENGTH = 8M /* 定义为只读执行 */ } SECTIONS { .xiptext : { . = ALIGN(4); *(.xiptext) *(.xiptext*) . = ALIGN(4); } >QSPI }
```

代码修饰：在C/C++中，通过__attribute__((section(".xiptext")))将特定的函数放到这个段里。

__attribute__((section(".xiptext"))) void MyFunction_In_QSPI(void) { // 这个函数的代码将被链接到0x90000000开始的区域 }

关键配置：
- MPU配置：必须将0x90000000区域配置为XN（eXecute Never）为0（即可执行），并且强烈建议设置为CACHEABLE。启用ICache后，从QSPI执行代码的性能可以接受。
- 初始化时机：绝对不能在QSPI初始化完成之前，调用任何存放在QSPI中的函数！这意味着SystemInit、main函数之前的启动代码必须在片内Flash或SRAM中。通常的做法是，在main函数开头完成QSPI和MPU的初始化后，再跳转或调用QSPI中的函数。

一个致命的陷阱：中断向量表与XIP。中断向量表必须放在CPU上电后能立即访问到的地方，通常是片内Flash。绝对不能将中断向量表放到未初始化的QSPI存储器中。同样，中断服务函数（ISR）也最好放在片内RAM或Flash，以确保最低延迟和最高可靠性。将性能不敏感、体积较大的非实时函数（如图像解码库、UI资源处理函数）放到QSPI中，是一个更合理的策略。

6. 调试技巧与常见问题排查

当QSPI PSRAM不工作时，可以按照以下链路排查：

硬件连接检查：
- 使用万用表测量VTI7064的电源是否为稳定的3.3V。
- 检查所有连接线，特别是CLK和CS，是否有虚焊或短路。
- 用示波器观察CLK引脚。在调用HAL_QSPI_Init后，即使不发送数据，CLK也应该有一个稳定的低电平（如果配置为Mode 0）。尝试发送一个命令，看CLK上是否有脉冲波形。如果没有，检查GPIO复用配置和时钟使能。
软件初始化流程检查：
- 确认时钟：确保HCLK和QSPI Ker Clock已正确使能且频率符合预期。可以在SystemClock_Config函数中设置断点查看。
- 分步测试：不要一次性配置到内存映射模式。先确保最基本的间接模式单线读写ID能成功。这是最底层的通信，如果失败，说明硬件或最基础的QSPI配置有问题。
- 指令与响应：利用逻辑分析仪或带高级触发功能的示波器，抓取QSPI总线上的波形。对照VTI7064数据手册的时序图，检查你发送的命令（Instruction）、地址（Address）、数据（Data）是否与波形一致。特别检查Dummy Cycle的数量和CS信号的拉高拉低时机。
内存映射模式失败：
- 症状：能读到ID，但一旦进入内存映射模式，读取数据全是0xFF或随机值。
- 排查：99%的问题出在DummyCycles和DataMode上。确认DummyCycles的值是否与当前QSPI时钟频率匹配。确认DataMode是否设置为QSPI_DATA_4_LINES（对于Quad I/O读）。检查AddressMode和AddressSize是否正确。
- 使用调试器查看内存：在IDE（如STM32CubeIDE）的内存观察窗口中，直接输入0x90000000地址，查看数据。如果显示全0xFF或无法访问，说明内存映射未成功建立。单步调试HAL_QSPI_MemoryMapped函数，看返回值。
性能低下或不稳定：
- 降低时钟频率：先将ClockPrescaler设大，降低通信频率。如果低频下工作正常，高频下失败，问题可能出在PCB布局、信号完整性或电源噪声上。
- 调整采样点：SampleShifting参数可以微调数据采样时刻。尝试在QSPI_SAMPLE_SHIFTING_NONE和QSPI_SAMPLE_SHIFTING_HALFCYCLE之间切换。
- 检查MPU/Cache配置：如果启用了Cache但数据不一致，检查MPU区域配置的属性（WT写通还是WB写回）。对于需要DMA搬运或与其他主控共享的数据区域，要小心处理Cache维护操作（SCB_CleanDCache_by_Addr等）。