使用极海APM32F427驱动QSPI XIP内存映射流程

《APM32芯得》系列内容为用户使用APM32系列产品的经验总结，均转载自21ic论坛极海半导体专区，全文未作任何修改，未经原文作者授权禁止转载。

1. QSPI XIP 是个啥？？

• QSPI（Quad SPI）和普通 SPI 的主要区别在于：

– 数据线从原本的 MOSI/MISO 升级为 IO0~IO3 四线，速度噌噌往上飙。传统SPI通信与QSPI通信对比图：

– 控制器提供指令、地址阶段的自动管理以及内存映射模式，更加“省心”。

• XIP (eXecute In Place) 就是 QSPI 内存映射的“王牌功能”。

– 传统 SPI：读写外部 Flash 时，每次都要软件发送指令、配置地址。烦！

– QSPI + XIP：把外部 Flash 直接映射到 MCU 地址空间，读数据就像读内存一样简单。

读取外部flash时，使用不同形式读取示意：

2.板载 W25Q16JV 外部 Flash

APM32F427 Tiny 板子上放了 W25Q16JV (16Mbit 容量)，支持 Quad I/O、Fast Read 等多种读指令。只要采用正确的指令码、地址模式和 Dummy Cycle，就能高速访问它。

3.驱动QSPI XIP内存映射流程（代码示例）

下面这部分源自APM32F4xx_DAL_SDK_V1.3.0中的示例工程，并基于“QSPI_ReadWrite”例程进行修改，演示如何实现W25Q16JV的擦除、写入、读取，以及如何进入XIP内存映射模式。

3.1 基础读写操作

还没上 XIP，就先测试基本的擦写流程，保证外部 Flash 的读写通路 OK。大致就几步：

1. 擦除指定扇区。

2. 写入测试数据。

3. 再回读来对比。

4. Check 成功则万事俱备。

示例代码片段如下：

/* Erase sector */

FLASH_EraseSector(0);

LOG_Print("FLASH_EraseSector (Sector 0 erased). ");

LOG_Print("Data read from offset 0 via QSPI. Dump rxBuffer: ");

FLASH_ReadData(0, rxBuffer, BUFFER_SIZE);

PrintArray32((uint32_t *)rxBuffer, BUFFER_SIZE / sizeof(uint32_t));

/* Write data */

FLASH_WriteData(0, txBuffer, BUFFER_SIZE);

LOG_Print("Data written to offset 0 via QSPI. Dump txBuffer: ");

PrintArray32((uint32_t *)txBuffer, BUFFER_SIZE / sizeof(uint32_t));

/* Read data */

FLASH_ReadData(0, rxBuffer, BUFFER_SIZE);

LOG_Print("Data read from offset 0 via QSPI. Dump rxBuffer: ");

PrintArray32((uint32_t *)rxBuffer, BUFFER_SIZE / sizeof(uint32_t));

/* Compare data */

if (BufferCmp((uint8_t*)txBuffer, (uint8_t*)rxBuffer, BUFFER_SIZE) != true)

{

BOARD_LED_On(LED3);

LOG_Print("Data compare failed! Error_Handler. ");

Error_Handler();

}

LOG_Print("Data compare success! ");

3.2 一键切换 XIP 模式

基础读写没问题后，就可以开启 XIP。只需在 main.c 调用一个 FLASH_EnterXIPMode() 函数，它的核心是利用 QSPI 控制器的 MemoryMapped 功能：

void FLASH_EnterXIPMode(void)

{

QSPI_XIPTypeDef xipConfig = {0};

// 1) Instruction code: 0xEB (Quad I/O Fast Read)

xipConfig.Instruction = 0xEB;

// 2) WrapCode: if not using wrap, set 0

xipConfig.WrapCode = 0x00;

// 3) Address size: 24 bits, suitable for W25Q16JV

xipConfig.AddressSize = QSPI_XIP_ADDRESS_SIZE_24_BITS;

// 4) InstructionMode: how instruction and address are transmitted

// e.g. QSPI_XIP_INSTRUCTION_STANDARD_INS_ADDR, QSPI_XIP_INSTRUCTION_FRF_INS_ADDR

xipConfig.InstructionMode = QSPI_XIP_INSTRUCTION_STANDARD_INS;

// 5) Instruction bit length

xipConfig.InstructionSize = QSPI_XIP_INSTRUCTION_SIZE_8_BITS;

// 6) FrameFormat: QUAD

xipConfig.FrameFormat = QSPI_XIP_FRAME_FORMAT_QUAD;

// 7) DummyCycles: typically 6~10 cycles for 0xEB in W25Q16JV

xipConfig.DummyCycles = 6;

// 8) Endianness: little-endian

xipConfig.Endianness = QSPI_XIP_MEM_ACCESS_FORMAT_LITTLE_ENDIAN;

// 9) ContinuousMode / PrefetchMode

// For higher performance, can enable them if needed

xipConfig.ContinuousMode = ENABLE;

xipConfig.PrefetchMode = ENABLE;

// Enable chip select, then call the library function to enter memory-mapped mode

FLASH_ChipSelect(ENABLE);

if (DAL_QSPIEx_MemoryMapped(&hqspi, &xipConfig) != DAL_OK)

{

Error_Handler();

}

}

代码中的配置要点主要是根据连接的SPI flash参数所决定的：

如图所示我们需要使用的模式是

1.Fast Read Quad I/O：0xEB

2.地址是24Bit

等这个函数执行完，W25Q16JV 就“挂”在了地址 0x90000000。此后，对该地址的访问会自动触发 READ 指令+地址+数据返回，无需编写更多指令/地址逻辑。可以像这样验证：

FLASH_EnterXIPMode();

LOG_Print("XIP mode enabled. External flash is mapped at 0x90000000. ");

PrintArray32((uint32_t *)0x90000000, BUFFER_SIZE / sizeof(uint32_t));

只要打印出的数据和之前写进去的一样，就说明XIP成功啦！

4.如何根据实验现象判断XIP是否成功

1. 串口日志：read(0x90000000) 与原始写入数据完全吻合，妥妥的 XIP。

2. 调试器内存窗口（如 MDK、IAR）：直接查看 0x90000000 区域，看到和 Flash 中相同的内容，毫无违和感。

总结

APM32F427 通过 QSPI XIP，让外部 Flash 使用体验大幅提升：

– 免去频繁发送指令、设置地址的烦恼；

– 连续读速度快，代码逻辑简单。

当然，如果仅用于小数据量存储，XIP 可能不是必需。但一旦想实现就地执行代码（Execute In Place）或需要快速读取远超内部容量的数据，XIP 就能让项目如虎添翼。

注：文章作者在原帖中提供了代码文件，有需要请至原文21ic论坛

原文地址：https://bbs.21ic.com/icview-3496231-1-1.html?_dsign=206adb5a

或点击下方阅读原文跳转