什么？这三款i.MXRT型号也开放了IAP API？

大家好，我是痞子衡，是正经搞技术的痞子。今天痞子衡给大家介绍的是i.MXRT1050/1020/1015 系列 ROM 中的 FlexSPI 驱动 API 使用。

今天痞子衡去 4S 店给爱车做保养了，保养一次要等两小时，闲来无聊就写了这篇文章打发时间，正好痞子衡技术交流群里有朋友也在问这个主题，急人所急是痞子衡的一大特质（此处请允许我装一下）。

本篇是 《利用 i.MXRT1xxx 系列 ROM 提供的 FlexSPI driver API 可轻松 IAP》 的续集，上篇文章基本上把 ROM API 原理及使用讲得很透彻了，但文中卖了一个关子，即 i.MXRT1xxx 系列一共出了 7 款型号，但并不是每个型号都开放了 ROM API，最早诞生的三款型号（105x、1021、1015）就并没有开放 API（不是没有 API，而是没有严格测试），随着 ROM API 的优点逐渐被大家意识到，客户要求 API 开放的呼声也越来越高，因此恩智浦研发团队对未开放的 API 做了测试，明确功能一切正常后，终于官宣了。所以今天痞子衡着重讲这三款未开放 API 的 RT 型号在 API 使用上跟主流 RT 型号（如 i.MXRT1060）有什么区别。

一、ROM API 简介

1.1、API 设计实现

关于 i.MXRT1050/1020/1015 API 设计原理，这里就不予赘述了，因为跟 i.MXRT1060 中是一样的。咱们直接看它们的 API 原型 bootloader_api_entry_t，细心的朋友会发现在原型定义上跟 i.MXRT1060 是有区别的，结构体中前 3 个成员顺序上不一样，其实这是早期的原型定义，存在不合理的地方，显然 version 放第一个才符合 API 标准定义，因此这在 i.MXRT1060 中得到了改进。此外在后面 API 分组功能上也差异较大，不过我们最在意的 FlexSPI NOR 驱动 API 在就行。

下面是 i.MXRT1050 中的 g_bootloaderTree 实例，其实只真正提供了 HAB、FlexSPI NOR、NAND ECC 三类 API：

下面是 i.MXRT1020/1015 中的 g_bootloaderTree 实例，这里甚至只提供了 FlexSPI NOR API，没办法，BootROM 空间有限：

二、API 之 FlexSPI 驱动

2.1 FlexSPI 驱动原型

flexspi_nor_driver_interface_t 是 FlexSPI NOR 驱动的原型，原型中定义了全部的 API 函数，但具体在每个 RT 型号里并不是都有实例。

下面是 i.MXRT1050 中的 g_flexspiNorDriverInterface 实例，缺少了 get_config()函数实现：

下面是 i.MXRT1020/1015 中的 g_flexspiNorDriverInterface 实例，除了缺少 get_config()函数，还缺少 erase_all()函数实现：

2.2 FlexSPI 驱动使用示例

根据前面介绍，我们知道未开放的 API 主要缺少 get_config()函数，其他都是一样的，但是别小看这个 get_config()函数，它可是 API 简便易用的核心所在，现在没有了这个函数，我们只能根据板子上的 Flash 型号去手工提供 512bytes 的 flexspi_nor_config_t 变量。

2.3 FlexSPI 配置变量初始化

那么如何初始化这 512bytes 的 flexspi_nor_config_t 变量呢，这就说来话长了，痞子衡讲一个最常见的四线 QSPI Flash 的配置吧。

我们知道 i.MXRT1060-EVK 上默认连的是 ISSI 的 8MB QSPI Flash，SDK XIP 工程里默认使用了它的配置，在 \SDK_2.x.x_EVK-MIMXRT1060\boards\evkmimxrt1060\xip\evkmimxrt1060_flexspi_nor_config.c 中定义了常量 qspiflash_config，我们可以参考这个常量定义。

qspiflash_config 适用于四线、100MHz、8MB 的 Flash，如果你的 QSPI Flash 在大小和速度上与它不同，可以做相应调整。不过这个 qspiflash_config 主要是给 ROM 启动用的，而 ROM 启动仅需要读 Flash，因此这个配置中 LUT 仅有 Read，而我们需要的 API 一般都要实现擦除和编程，因此要修改其 lookupTable 如下：