前言
STM32 提供了灵活多样的外扩存储器访问实现。本文中，介绍如何利用 QSPI (QuadSPI) 外扩串行NOR Flash 存储器。首先对 QSPI 接口功能特性进行介绍，然后分别介绍硬件设计和软件开发。并基于 STM32CubeMX，提供访问 MICRON N25Q128A13EF840F 的实现参考。
- a/ P  G% x0 t* W4 ^& b' `
一 实现环境
5 t! f+ a- J. ^! u# g2 G+ q开发板：STM32F469G-DISCO
' I. o! _4 e7 F3 R0 `) G开发库：STM32CubeF4 v1.16.0
STM32CubeMX: v4.22.0
集成开发环境：IAR v7.70.1.11486

: }: Y7 ~1 ~/ \4 i% A4 G2 O2 c" _3 n实现过程在 STM32F469I-DISCO 板上展开，利用板上已有的串行 NOR Flash 存储器（MICRONN25Q128A13EF840F）。呈现整个开发涉及环节。在本文中，首先根据 QSPI 接口，介绍 QSPI 与外扩串行存储器硬件连接。另外，Cube 软件包中包含 QSPI 实现例，在本文对库中实现的 QSPI 例不做讨论，读者也可参考这些 QSPI 例进行设计。本文围绕由 STM32CubeMX 生成的工程，介绍如何实现对外扩串行 NOR Flash 存储器的访问。


二 QSPI 介绍
/ J+ ^8 D2 u: i" a' ]在呈现 QSPI 访问外扩 Flash 的实现例前， 需要对 QSPI 有一定的了解，在此对 QSPI 进行简短的介绍。更多内容请参考AN4760。
. H: H* h1 p' m6 t
& [% D% V5 k+ y' _& q- f2 G6 o) ?
QSPI（Quad-SPI）支持四线串行访问形式。同时，QSPI 支持传统 SPI 和 Dual-SPI 模式，Dual-SPI 模式支持两线串行访问。与 FMC/FSMC 比较，QSPI 支持更低成本、更小封装外部串行 Flash 存储器，更少的 IO 引脚占用，有效减少 PCB 面积，降低 PCB 设计复杂度。
QSPI 在不同系列 STM32 产品线的支持情况（仅部分罗列，未涵盖所有支持型号）。
" V. w* d: q$ ^3 p0 K$ R5 d8 N
8 U4 h, Z, g& y. e7 l( J2 [
8 {+ W6 e  j1 o6 l" f0 I; Z0 `0 h9 i
QSPI 接口提供了灵活可配置的 5 个阶段，如下图所示（仅用于理解阶段构成，时序图根据配置不同存在差异）。分别是命令阶段、地址阶段、复用字节阶段、Dummy 阶段和数据阶段。可以根据外扩 Flash 中命令时序对不同阶段进行配置。后续会以实例进行呈现。更多内容请参考 AN4760。
2 f+ L5 Y( V% L$ n; Q" Z2 d3 D
" b7 z4 [, T) ]
1 [. C3 n1 X6 P& P. j/ S* w. I
QSPI 支持三种模式，分别是：
间接模式  所有操作通过 QSPI 寄存器实现，类似于传统 SPI，可以使用阻塞模式、中断模式或者 DMA 模式进行读写等访问。本文中提供的实现例为间接模式下的实现。
状态轮询模式  接口自动轮询指定寄存器，直到回读寄存器内容与指定条件匹配。可应用于状态检测，从而实现忙等待等效果。本文不对此模式进行实现介绍，应用实现可参考 Cube 软件包中 QSPI 例程。
) i6 V# Q- f& a0 c3 ?存储器映射模式  外扩 Flash 被视为内部存储器，支持 AHB 主器件直接访问，CPU 能够直接运行位于 QSPI 存储器的执行代码。内部系统架构如下图所示（以 STM32F469/F479 为例）。本文不对此模式进行实现介绍，应用实现可参考 Cube软件包中 QSPI 例程 QSPI_ExecuteInPlace。
1 d5 M4 @/ I/ L3 T& E/ b

' Z6 c+ Q; D. C6 `8 w1 g
. _& g8 S  k: Z1 @0 ]. Y8 ^# [2 ~- z5 o
三 QSPI 外扩串行 Flash 实现例
3.1 串行 Flash 介绍
以 MICRON N25Q128A13EF840F 为例，更多细节请参考存储器手册。N25Q128A13EF840F 引脚图、时序图和电气参数来源于 N25Q128A13 手册文档。
4 c2 A. j! R# V% i支持协议： SPI, Dual I/O（对应 Dual-SPI）, Quad I/O（对应 Quad-SPI）
支持访问模式： 单线访问、双线访问、四线访问，得益于 QSPI 接口的灵活可配性，三种访问模式全部支持。
2 z- a# w% p- e4 y$ p9 X; E供电电压范围： 2.7 ~ 3.6V
最大时钟频率： 108MHz
1 P  H- \4 N* P* T存储空间： 128Mb （16MB）
器件引脚示意图如下所示。由两根电源引脚和六根 QSPI 信号线构成。

0 O0 T& ?+ A# j  D3 C

7 D3 G" Q* D5 a# F1 L. H下表为存储器 N25Q128A13xxx 命令（未列出全部命令）。通过下表可知，存储器提供了灵活的访问实现形式，而结合同样灵活可配的 QSPI 接口，能够实现存储器命令全支持。而本文仅为提供设计思路，呈现了部分命令在 QSPI 上的实现。



( Z# w' K) U7 a2 Q其中，默认读写默认 3 字节地址，四线快速读命令默认 Dummy 周期数为 8。

3.2 硬件设计
涉及到的信号线少，硬件设计简单，只需直接将 QSPI 的六根信号线与存储器连接即可。考虑到可测性，可以增加串行电阻或者测试点。硬件电路图如下所示。

4 ~0 c5 ~$ \- n: o

QSPI 接口 PCB 设计遵循如下几点，更多硬件设计内容请参考 AN4488。
a. 线阻 50Ω ±10%
9 }( b& A( P5 k% nb. 最大线长 < 120mmc. 避免在不同信号层走信号线
$ e! i) V; N: d6 A9 `d. 时钟线至少离其他信号线 3 倍线宽距离
e. 数据信号线长差 ≤ 10mm
, w  X2 D7 x- r( v! pf. 避免时钟线采用蛇形走线，同时尽量减少数据线上过孔。

% }0 y& i+ T# L" ~  k
. h8 Z, Q( g0 ]# ^% v$ i3.3 软件开发流程


6 F$ ~8 t+ l6 C4 y' _" B9 s8 C8 e
/ q1 {$ h2 P) C/ u) d; y% {3.4 软件实现例
在环境搭建完成后，就可以利用 STM32CubeMX 根据硬件连接情况，进行 QSPI 配置，获取 IAR 工程。具体软件实现流
, A8 M5 ?, R8 l$ a+ W程如下。





a. 利用 STM32CubeMX 生成 IAR 工程
/ `4 d5 q& ^  z- ?& Z1 B3 f打开 STM32CubeMX - 点击”New project” - 在”Part Number Search’中输入 STM32F469NI - 点击”MCUs Liast”中出现的 STM32F469NIHx - 点击“Start Project” - 此时，基于 STM32F469NIHx 的 STM32CubeMX 工程被打开。如下，根据 STM32F469I-DISCO 板硬件连接情况（QSPI NCS, CLK, Q0, Q1, Q2, Q3 对应 PB6, PF10, PF8, PF9,PF7, PF6；外部高速晶振为 8MHz 无源晶振；调试接口采用 SWD 接口，其中 SWCLK, SWDIO 对应 PA14, PA13）：选择” QuadSPI”为”Bank1 with Quad SPI Lines”（注：也可在开发过程中，先用 STM32CubeMX 查看 QSPI 接口对应的 IO 引脚，进行硬件开发） 。
注： 在如上选择后，右侧引脚图中 QSPI 对应的引脚会呈现绿色显示。需要根据电路图中所连接的 QSPI 引脚，进行复用引脚确认。例如，在默认情况下，QSPI IO0 对应到 PC9 引脚，而 STM32F469I-DISCO 板上的 QSPI IO0 与PF8 连接，并非 PC9。所以，需要在右侧引脚图中，按住 Ctrl 键，左键在 PC9 引脚按下，拖动至 PF8 处，松开左键和 Ctrl 键，实现 IO0 引脚的关联。
选择“High Speed Clock（HSE）”为“Crystal/Ceramic Resonator”。
+ g5 `) o3 \4 N# S选择”Debug”为”Serial Wire”
1 f6 J/ R$ [4 v. L& D

7 B  i* s2 S+ ?# K; C% N6 b2 A, @

0 o+ v) c3 z! V6 X, h时钟配置如下图所示。设置输入时钟频率为 8MHz - 选择”HSE”做为 PLL 倍频时钟源 - 选择”PLLCLK”做为主频时钟源 - 设置 “HCLK”为 180MHz （FAHB 为 180MHz）- 点击 Enter 键，自动生成对应主频的时钟参数（仅提供时钟配置参考，并不限制一定要设置 180MHz 主频）。




$ i% |. I# M( V) H6 `; @- J; QQSPI 配置如下图。参数的配置需要与存储器参数匹配。
• FIFO Threshold（FIFO 阈值） 配置为 4，并不严格要求。
• Smaple shift 选择“Sample shifting half cycle”。延后半个时钟，获取数据线上数据。可以使用在由于线路设计，数
! v' }$ \& }2 G* o5 \/ w7 M8 [4 P$ W据信号存在较大延迟的场景。
# |$ ?( w: [! Y

- c  q) h2 R4 y9 k) N' n

使能 QSPI 中断。


- Y' f, T4 v4 k) Z' I  o
点击菜单栏”Project” - “Settings” - 设置”Project Name” , “Project Location” 和 “Toolchain / IDE” 。其中“Toolchain/ IDE”设置为 EWARM 以便生成对应 IDE 的工程。其他选项保持默认。
点击菜单栏”Project”  “Generate Code”  等待 IAR 工程生成，出现”Code Generation”界面 - 点击”Open Project”打开工程。

b. 完善工程。
由上述步骤获得的 IAR 工程中，包含了时钟配置及 QSPI 接口的初始化。对于外扩 Flash 的操作，还需要 添加外扩Flash 支持的命令进行操作。N25Q128A13EF840F 支持的部分命令可参见本文 3.1 小结。
; k  {8 G! P& N: G" o8 e: q5 e在这里出于简化考虑，仅提供了阻塞式读取 ID，擦除 Flash，块写和快读操作的实现。更多实现模式，可以参考Cube 软件包中提供的 QSPI 例程。
在 N25Q128A13EF840F 手册中提供了读 ID 命令时序，如下图所示。


3 x; f9 c5 W0 Q, I
9 g  i, T5 k, U3 k' M" g5 g% @5 s0 k由时序图可知，读 ID 时序构成： 命令阶段 + 数据阶段。命令阶段和数据阶段线宽都为 1，读 ID 命令码为 0x9E 或者0x9F，ID 数据长度为 17 字节。
在 N25Q128A13EF840F 手册中提供了写使能命令时序，如下图所示。
( ~& X1 [' I! m, \- U# d; l1 _
" t. s3 w" L) q0 a

! z) P+ B0 B4 _# P& i: r; V$ L
由时序图可知，块擦除时序仅有命令阶段。命令阶段线宽为 1，写使能命令码为 0x06。（注：这里仅呈现了单线命令模式的实现。除此之外，STM32 QSPI 接口和外扩存储器支持双线、四线模式）。
在 N25Q128A13EF840F 手册中提供了扇区擦除命令时序，如下图所示。


6 M& X' U# M9 Z* G! y
由时序图可知，扇区擦除时序构成：命令阶段+地址阶段。命令阶段和地址阶段线宽为 1，扇区擦除命令码为 0xD8。其中地址为 24-bit，任一位于需要进行擦除操作的扇区范围内地址都有效。在此简单选择扇区 0 进行擦除，选择地址为 0。（注：这里仅呈现了单线命令模式的实现。除此之外，STM32 QSPI 接口和外扩存储器支持双线、四线模式）。在 N25Q128A13EF840F 手册中提供了四线快速写命令时序，如下图所示。
( a) V& j2 ~2 Q
' P9 W) n6 Q& y# r+ L

由时序图可知，四线快速写命令时序构成：命令阶段+地址阶段+数据阶段。命令阶段和地址阶段线宽为 1，数据阶段线宽为 4，四线快速写命令码为 0x32。其中地址为 24-bit，对应写入起始地址。（注：这里仅呈现了单线命令模式的实现。除此之外，STM32 QSPI 接口和外扩存储器支持双线、四线模式）。
0 X9 l; X5 i* H* P1 b# U在 N25Q128A13EF840F 手册中提供了四线快速读命令时序，如下图所示。



由时序图可知，四线快速读命令时序构成：命令阶段+地址阶段+数据阶段。命令阶段和地址阶段线宽为 1，数据阶段线宽为 4，四线快速读命令码为 0x6B。其中地址为 24-bit，对应写入起始地址。四线快速读命令默认 Dummycycles 为 8。（注：这里仅呈现了单线命令模式的实现。除此之外，STM32 QSPI 接口和外扩存储器支持双线、四线模式）。
在 main.c \ main 函数中，增加代码如下。
2 q8 z3 P( {' [

1. … //系统、时钟、IO 和 QSPI 初始化
   4 {- ]& j/ t  q
2. /* USER CODE BEGIN 2 */
   
3. QSPI_CommandTypeDef sCommand;
   - D/ t3 q7 Z& ?$ y
4. static uint8_t Buf_ID[17] = {0};
   
5. static uint8_t TxBuf[0x10] = "Ext Flash", RxBuf[0x10] = {0};
   
6. 
   
7. sCommand.DdrMode = QSPI_DDR_MODE_DISABLE; //DDR 模式失能
   
8. sCommand.DdrHoldHalfCycle = QSPI_DDR_HHC_ANALOG_DELAY; //DDR 模式下，数据延迟输出
   5 f# ], n0 Y4 C! \6 i$ F, T5 ]
9. sCommand.SIOOMode = QSPI_SIOO_INST_EVERY_CMD; //每次发送都包含命令阶段
   
10. /***** 读 ID 操作 *****/
    " U3 J- e( _9 F3 n
11. sCommand.Instruction = 0x9F; //READ ID 命令码
    3 s, ?2 q6 \  s. U5 q
12. sCommand.InstructionMode = QSPI_INSTRUCTION_1_LINE; //命令线宽
    
13. sCommand.AddressMode = QSPI_ADDRESS_NONE; //地址线宽。无地址阶段
    * Q+ k4 R9 W  y. V8 [1 h* G
14. sCommand.DataMode = QSPI_DATA_1_LINE; //数据线宽
    
15. sCommand.NbData = 17; //读取数据长度。ID 长度为 17 字节
    
16. sCommand.AlternateByteMode = QSPI_ALTERNATE_BYTES_NONE; //无复用字节阶段
    , i: {2 i9 _$ D2 a$ l7 J
17. sCommand.DummyCycles = 0; //无 Dummy 阶段
    
18. //配置命令（在有数据阶段时，命令在后续发送/接收 API 调用时发送）
    0 p: y- y# T) ~; w' I
19. if (HAL_QSPI_Command(&hqspi, &sCommand, 5000) != HAL_OK)
    
20. {
    9 v! j, f4 f9 K" `; D$ D
21. Error_Handler();
    + N; O# y1 a2 |) Q/ u# u
22. }
    0 o, A. R! D/ T- |5 \( ]* g% _  B
23. //执行 QSPI 接收
    
24. if (HAL_QSPI_Receive(&hqspi, Buf_ID,5000) != HAL_OK)
    
25. {
    
26. Error_Handler();
    
27. }
    & A. Z" ^" T; V" k- c/ e
28. HAL_Delay(1); //延时 1ms. 单位为 SysTick 定时中断周期
    
29. 
    
30. /***** 写使能操作（需要在块擦除之前，使外扩存储器处于写使能状态） *****/
    
31. sCommand.Instruction = 0x06; //写使能 命令码
    
32. sCommand.InstructionMode = QSPI_INSTRUCTION_1_LINE; //命令线宽
    / ~2 O! L; g. _% M8 f/ d, }
33. sCommand.AddressMode = QSPI_ADDRESS_NONE; //地址线宽。无地址阶段
    
34. sCommand.DataMode = QSPI_DATA_NONE; //数据线宽。无数据阶段
    
35. sCommand.AlternateByteMode = QSPI_ALTERNATE_BYTES_NONE; //无复用字节阶段
    
36. sCommand.DummyCycles = 0; //无 Dummy 阶段
    % y, ~7 T3 Q' _- `+ y
37. //配置发送命令
    ) Y4 b6 \7 P  u, `  u. A- W6 M2 Y  W
38. if (HAL_QSPI_Command(&hqspi, &sCommand, 5000) != HAL_OK)
    
39. {
    ' L$ _4 w1 D# J# P5 ~
40. Error_Handler();
    
41. }
    
42. 
    
43. /***** 块擦除操作 *****/
    
44. sCommand.Instruction = 0xD8; //扇区擦除 命令码
    - q4 }$ u0 ^4 ?" g2 L% w9 b' a) U
45. sCommand.InstructionMode = QSPI_INSTRUCTION_1_LINE; //命令线宽
    
46. sCommand.AddressMode = QSPI_ADDRESS_1_LINE; //地址线宽。无地址阶段
    , S  K2 ]2 l: W+ Z( t% P, [
47. sCommand.AddressSize = QSPI_ADDRESS_24_BITS; //地址长度
    $ @# l+ m, x* ?6 \# g% ]# C
48. sCommand.Address = 0; //位于所需擦除扇区内的任一地址。
    , X! y% F' ]; s# l3 b. A" V2 k
49. sCommand.DataMode = QSPI_DATA_NONE; //数据线宽。无数据阶段
    
50. sCommand.AlternateByteMode = QSPI_ALTERNATE_BYTES_NONE; //无复用字节阶段
    5 S* X6 R3 I4 g* [5 w5 Q
51. sCommand.DummyCycles = 0; //无 Dummy 阶段
    . c' q4 @/ M3 U3 Y  r# K: m
52. //配置发送命令
    
53. if (HAL_QSPI_Command(&hqspi, &sCommand, 5000) != HAL_OK)
    
54. {
    $ ^0 e- Y  f1 c; B% n! m: p/ z& W" T1 I
55. Error_Handler();
    / H1 K. v* b1 c2 h4 B6 u. q
56. }
    
57. HAL_Delay(3000); //延时 3s. 单位为 SysTick 定时中断周期
      u# K. c, w% [8 |! y( F
58. 
    5 [  k% p2 i7 h$ e$ B9 N( a3 W
59. /***** 写使能操作（需要在块擦除之前，使外扩存储器处于写使能状态） *****/
    
60. sCommand.Instruction = 0x06; //写使能 命令码
    
61. sCommand.InstructionMode = QSPI_INSTRUCTION_1_LINE; //命令线宽
    6 l, h+ s6 m! F! G" _& j
62. sCommand.AddressMode = QSPI_ADDRESS_NONE; //地址线宽。无地址阶段
    
63. sCommand.DataMode = QSPI_DATA_NONE; //数据线宽。无数据阶段
    
64. sCommand.AlternateByteMode = QSPI_ALTERNATE_BYTES_NONE; //无复用字节阶段
    : N6 u. a% F3 {" \
65. sCommand.DummyCycles = 0; //无 Dummy 阶段
    & }& \6 y' ^1 A
66. //配置发送命令
    
67. if (HAL_QSPI_Command(&hqspi, &sCommand, 5000) != HAL_OK)
    
68. {
    - l- j+ u: _$ R5 F& l
69. Error_Handler();
    * Z: W1 G. @1 V6 Q; {- `2 l  A: Y% h+ P
70. }
    
71. 
    
72. /***** 四线快速写操作 *****/
    3 i5 S$ g/ N) y* {
73. sCommand.Instruction = 0x32; //四线快速写 命令码
    " W, N4 r- W9 M% o5 E" D1 K
74. sCommand.InstructionMode = QSPI_INSTRUCTION_1_LINE; //命令线宽
    : _/ y0 g8 b1 ~) V
75. sCommand.AddressMode = QSPI_ADDRESS_1_LINE; //地址线宽
    
76. sCommand.AddressSize = QSPI_ADDRESS_24_BITS; //地址长度
    
77. sCommand.Address = 0; //写入起始地址
    
78. sCommand.DataMode = QSPI_DATA_4_LINES; //数据线宽
    # y" M, T! \" ^. I
79. sCommand.NbData = 10; //写入数据长度
    
80. sCommand.AlternateByteMode = QSPI_ALTERNATE_BYTES_NONE; //无复用字节阶段
    , q* V  v3 A9 t% \. B. V% B
81. sCommand.DummyCycles = 0; //无 Dummy 阶段
    
82. //配置命令（在有数据阶段时，命令在后续发送/接收 API 调用时发送）
    0 S/ o& e; y: l$ U2 ^. b( e
83. if (HAL_QSPI_Command(&hqspi, &sCommand, 5000) != HAL_OK)
    $ q/ M" q" H$ s1 A& }, }
84. {
    
85. Error_Handler();
    & U- m! k  c) T' f3 C
86. }
    
87. //执行 QSPI 接收
    - l) h( S* h7 J
88. if (HAL_QSPI_Transmit(&hqspi, TxBuf ,5000) != HAL_OK)
    ' j% G- I: O! \! P% E( @5 d/ {  g1 p
89. {
    
90. Error_Handler();
    2 n" ^. F& c& ~) P
91. }
    ! B: C  K  ~; K4 r. T; ^" j- J$ a
92. HAL_Delay(5); //延时 5ms. 单位为 SysTick 定时中断周期
    # N! o9 h' r% s8 b
93. 
    
94. /***** 四线快速读操作 *****/
    7 k0 u6 k' i+ X) Q% J( t5 M
95. sCommand.Instruction = 0x6B; //四线快速读 命令码
    
96. sCommand.InstructionMode = QSPI_INSTRUCTION_1_LINE; //命令线宽
    
97. sCommand.AddressMode = QSPI_ADDRESS_1_LINE; //地址线宽
    3 d% J- Z/ e) i! J
98. sCommand.AddressSize = QSPI_ADDRESS_24_BITS; //地址长度
    % {+ P6 a; u' v$ Q5 o$ M0 ~3 l" d. o
99. sCommand.Address = 0; //起始地址
    
100. sCommand.DataMode = QSPI_DATA_4_LINES; //数据线宽
     
101. sCommand.NbData = 10; //读取数据长度
     
102. sCommand.AlternateByteMode = QSPI_ALTERNATE_BYTES_NONE; //无复用字节阶段
     
103. sCommand.DummyCycles = 8; //Dummy 阶段。N25Q128A13EF840F
     ) F/ @5 [( d) C: ~1 B
104. Dummy cycles 默认为 15
     4 H# z; d: E7 N, l* [) ^
105. //配置命令（在有数据阶段时，命令在后续发送/接收 API 调用时发送）
     * o$ m* o6 x% \; u4 {4 J7 W
106. if (HAL_QSPI_Command(&hqspi, &sCommand, 5000) != HAL_OK)
     
107. {
     + T7 c6 ]- H- c" I# t0 \
108. Error_Handler();
     
109. }
     
110. //执行 QSPI 接收
     
111. if (HAL_QSPI_Receive(&hqspi, RxBuf,5000) != HAL_OK)
     8 x6 b4 s6 V* n/ \% h+ U6 x6 f  _
112. {
     
113. Error_Handler();
     
114. }
     
115. /* USER CODE END 2 */

复制代码

9 Z% f& i9 l. }  ^" M* C! ]
3 \( r3 O- d! f$ [/ o6 E# w) N' F四 小结
STM32 的 QuadSPI 接口灵活可配，对于命令阶段、地址阶段、复用字节阶段、Dummy 阶段和数据阶段都可以进行配置。基于这种灵活性，能够实现市面上 SPI、Dual IO、Quad IO 的串行 Flash 支持。但出于简化考虑，QSPI 支持的中断访问及DMA 访问等更多功能没有在本文进行介绍，更多实现可以参考 ST 提供的 Cube 软件包中的 QSPI 例程。另外，不同厂家的串行 Flash 命令及操作实现略有差异，具体以采用的 Flash 文档描述为准。

, P8 x) {( `/ W. ^8 Q/ f
8 v7 l  n/ V- Z5 {3 m4 c


+ t$ H- s2 A( t' b0 ?) Q2 J
; r/ V) }. E& k; e3 _4 x2 g) P1 o( u
4 {8 j$ x) x/ q7 q