如何写好QSPI驱动

1. 摘要

本篇笔记主要介绍，如何开发稳定可靠，功能齐全的QSPI驱动。

2. 准备工作

1， IAR 8.32.1

2， STM32Cube_FW_H7_V1.6.0

3. QSPI简介

4. QSPI驱动

在项目的开发中，我们经常会使用外挂Flash在做一些应用，而STM32H743带QSPI接口，可以用来外挂QSPI Flash，在之前的推送中我们以winbond华邦的W25Q256为例给大家说明了下QSPI的操作，借助ST的HAL库例程可以快速验证，不同型号的QSPI Flash会有一些参数和命令区别，大家应用时候要注意，例如美光和华邦的有的命令码就不同。ST的驱动里STM32H743的评估板是以美光的MT25T_QLKT_L_01G为例。如果你使用不同的型号，请注意区分，既然是评估板，那么就只是给大家参考，在正式的项目中，还需要考虑一些其他的问题。

5. 驱动架构

驱动的架构可以参考STM32Cube_FW_H7中对QSPI Flash驱动架构，也可以自己做架构，尽量简单明了，易用且稳定。对具体型号Flash的驱动可以放在一个文件下建立一个.c和.h. 如我们以华邦的W25Q系列为例，

还可以建立一个文本文档，用来记录驱动的一些变更，发布笔记等。

BSP层可以在BSP文件夹下建立QSPI的驱动，名字可以参考ST库，也可以按照自己的命名规则来定，或者企业的软件文件命名规则来定。

建立好这些文件后，接下来可以动手开发了。开发的时候可以先画一些图，除过正常的初始化，去初始化，外，考虑都包含那些功能，那些模式，那些命令，那些安全管理。那些中断，是否可以用DMA操作等。还要考虑数据结构类型，配置信息，错误码等。这些一定要结合数据手册来考虑和分析。

5.1 初始化和去初始化

这部分相对比较简单，可以参考例程，市面上的开发板，编码风格和良莠不齐，大家尽量参考官方的资料和文档，要考虑检查返回值，初始化有没有成功。跟硬件相关的管脚，时钟等大家根据自己的应用去定，H743我一般跑400M. 官方的大部分例程也都是跑在400M.

5.2 驱动模式

从手册可以知道分为间接模式，状态轮询模式，内存映射模式，那么我们的驱动就要能够分别支持这三种模式。在stm32h743i_eval_qspi.h里面定义这些模式和其他数据类型。这些可以参考官方的定义

在w25q256.h中定义跟flash相关的数据类型，结构体，宏定义等。如QSPI的操作模式，这里要明白1-1-1，1-1-2，1-1-4，1-4-4等的含义，因为QSPI包含这四种，指令单线，地址单线/4线，数据单线/两线/四线，这些在flash的数据手册指令表里都会标出，支持那种操作，而我们在驱动中要综合考虑这四种。

命令表的定义，这个要注意不同型号的FLASH，会稍有区别，即使同一家的不同型号的可能也有区别，如华邦256M和1G的指令就有一些个别的不同。恰好这两款我都用过，在这里给大家提一下。由于指令比较多，这里就不一一列举了，只截取其中一部分，具体指令表的定义可以参考flash手册，

但是建议大家在做驱动的时候对所有指令做支持，这样在用的时候就很方便，而不是用的时候发现少，在去填补。可以分别做成子函数，例如读取ID，可以做一些校验

很多指令的内容官网的驱动里都没有，需要我们自己去做。

5.3 状态寄存器读写

W25Q系列一般有三个状态寄存器，用来表示一些状态，如状态寄存器1就可以通过读取来判断flash的状态，有没有忙，写使能有没有打开，以及保护位保护了那些地址，这些都要自己去实现，市面上包括官方的例程驱动里都没有，假如你不判断的话，如果要写的地址被保护，是写不进去的，还有可能出现异常，这些都可以通过读取状态寄存器1和2来判断和处理。以及结合WP脚。

这些功能在正式的产品中我们一定要考虑，否则你的驱动就不稳定，不安全，因为工业现场各种干扰，以及其他异常情况。可能你在实验室跑的好好的代码，到现场就不行了

5.4 读写擦驱动

擦除操作比较耗时，所以如果你是用查询模式的话，要不断去查询状态，而不能死等，从手册可以看除时间量级，擦除正片最大需要1000s，还是比较耗时，即使最小的擦除单元4k擦除，最坏情况也需要400ms。用中断或者DMA方式操作的话不涉及，但DMA的话中断需要好几个，有命令，完成，状态匹配，收发完成等。要熟悉这些大概时间量级。方便参考。基于不同模式的驱动我们在公众号里都给大家介绍过。