大家好,我是痞子衡,是正经搞技术的痞子。今天痞子衡给大家介绍的是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-MIMXRT1060boardsevkmimxrt1060xipevkmimxrt1060_flexspi_nor_config.c 中定义了常量 qspiflash_config,我们可以参考这个常量定义。
qspiflash_config 适用于四线、100MHz、8MB 的 Flash,如果你的 QSPI Flash 在大小和速度上与它不同,可以做相应调整。不过这个 qspiflash_config 主要是给 ROM 启动用的,而 ROM 启动仅需要读 Flash,因此这个配置中 LUT 仅有 Read,而我们需要的 API 一般都要实现擦除和编程,因此要修改其 lookupTable 如下:
至此,i.MXRT1050/1020/1015 系列 ROM 中的 FlexSPI 驱动 API 使用痞子衡便介绍完毕了,掌声在哪里~~~