QSPI XIP需Flash支持Quad Read（0xEB）和Continuous Read（0xE7）指令，并使能QE位；MCU端须配置Memory-mapped模式、ABR/FCONT、AHB映射地址与链接脚本一致，且向量表必须复制到RAM并更新VTOR。
QSPI XIP 的硬件前提：Flash 必须支持 Quad Read 和 Continuous Read 模式
不是所有 QSPI Flash 都能开 XIP。关键看数据手册里是否明确标注支持 0xEB（Quad I/O Read）或 0xE7（Quad I/O Continuous Read）指令，且地址线和数据线在读取时能稳定维持信号完整性。常见兼容型号如 Winbond W25Q80、Macronix MX25L3233F，但 W25Q32JV 的某些批次因内部时序限制，默认不支持连续读，强行 XIP 会跳飞或取指错误。
实操建议：
- 用示波器抓
IO0–IO3和SCLK，确认读取时是真正的四线并行传输，而非模拟 Quad 模式 - 检查 Flash 的
CR2[1]（或类似寄存器位）是否已使能Quad Enable (QE)—— 很多芯片出厂默认关闭，需通过Write Status Register命令写入0x40或0x02（依型号而异） - 确认 Flash 的
Reset Enable位未被意外置位，否则上电后可能进入复位态，XIP 地址访问直接返回全 0xFF
MCU 端 QSPI 控制器配置：以 STM32H7 为例配 QSPI AHB 总线映射
STM32H7 的 QSPI 外设必须启用 Memory-mapped mode 并正确设置 ABR (Address Bit Rate) 和 FCONT (Flash Continuation)，否则 CPU 访问 QSPI 地址空间时会触发 BusFault 或返回哑数据。
关键配置点：
立即学习“C++免费学习笔记（深入）”；
-
QUADSPI->CR |= QUADSPI_CR_EN必须在所有寄存器初始化完成后最后使能，否则部分寄存器写入会被忽略 -
QUADSPI->DCR &= ~QUADSPI_DCR_CKMODE—— 若 Flash 要求 DTR（Double Transfer Rate），此处不能清零，否则时钟相位错位导致取指乱码 - AHB 映射起始地址（如
0x90000000）必须与链接脚本中.text段的ORIGIN完全一致；若 Flash 实际容量为 8MB，但映射窗口设成 16MB，末尾越界访问会回绕或触发错误响应 - 务必调用
__DSB()+__ISB()在使能映射后刷新流水线，否则 CPU 可能仍在执行旧 cache 中的指令
链接脚本与启动流程：把代码段放 Flash 地址，但向量表仍需复制到 RAM
XIP 不等于“完全不动 RAM”。Cortex-M 内核要求中断向量表必须位于可写内存（即 RAM），因为复位后内核会从 0x00000000（或 VTOR）读取向量，而 Flash 不可写。所以即使 .text 放在 QSPI 地址，.isr_vector 必须在 RAM 中初始化。
典型处理方式：
- 链接脚本中定义两个区域：
MEMORY { FLASH (rx) : ORIGIN = 0x90000000, LENGTH = 8M; RAM (rwx) : ORIGIN = 0x30000000, LENGTH = 1M } -
.isr_vector段放在 RAM 区，并在Reset_Handler开头手动 memcpy 初始化：memcpy((void*)0x30000000, (const void*)0x90000000, 0x400); - 确保
VTOR寄存器在SystemInit()后被设为 RAM 中向量表地址：SCB->VTOR = 0x30000000; - 不要在 QSPI 地址上放全局构造函数（
.init_array）—— C++ 全局对象构造依赖 RAM 中的函数指针数组，XIP 下无法原地执行构造逻辑
调试与验证：用 GDB 直接反汇编 QSPI 地址确认指令真实性
烧录后看似运行正常，不代表真正在 Flash 中取指。常见假象是：QSPI 控制器实际工作在 indirect mode（比如调试器自动切换模式），或者 Flash 返回了缓存副本而非真实内容。
验证步骤：
- GDB 下执行
x/4i 0x90000100，观察反汇编结果是否与你源码编译出的.text段二进制完全一致；若显示undefined instruction或全是0xe7e7e7e7，说明映射失败或 Flash 未正确使能 QE - 暂停运行后，用
monitor qspi reset（OpenOCD）或直接读QUADSPI->SR，确认TCF (Transfer Complete Flag)和FSMF (FIFO Status Match Flag)是否正常置位 - 测量从跳转到 QSPI 地址开始，到第一条有效指令执行的时间差 —— XIP 应比 memcpy 到 RAM 后再跳转慢 3~5 个周期（因额外等待 Flash 延迟），若慢一个数量级，大概率是控制器降频到安全模式或走 fallback path
最易被忽略的一点：QSPI XIP 的性能对 Flash 的 Wrap Boundary 敏感。如果代码跨 4KB 边界（常见于函数末尾紧邻边界），而 Flash 不支持跨页连续读，控制器会插入额外等待周期甚至重发命令 —— 这种问题只能靠实际跑 benchmark 发现，仿真器看不到。
