痞子衡嵌入式：飞思卡尔i.MX RTyyyy系列MCU启动那些事（13）- 从Serial(1-bit SPI) EEPROM/NOR恢复启动

---

　　你们好，我是痞子衡，是正经搞技术的痞子。今天痞子衡给你们介绍的是飞思卡尔i.MX RTyyyy系列MCU的Serial EEPROM/NOR恢复启动。

　　在前几篇里痞子衡介绍的Boot Device都属于主动启动的Primary Boot Device（Serial NOR/NAND, Parallel NOR/NAND， SD/eMMC），试想一下若是遇到这样的状况，你选择启动的某个Primary Boot Device正常工做一段时间后某次开机忽然由于某种未知缘由没法启动了，此时系统没法正常工做，但若是你但愿系统可以有必定的容错/鲁棒能力，即便这种场合下也可以保证基本工做，那应该怎么作？别担忧，i.MXRTyyyy BootROM提供了一种解决方案，即Recovery Boot机制，BootROM支持Serial EEPROM/NOR做为Recovery Boot Device，你只须要将备份application事先放进Recovery Boot Device便可，任何主动启动的Primary Boot Device启动失败，BootROM会自动启动Recovery Boot Device中的备份application保证系统能正常工做，是否是以为recovery boot很贴心？今天痞子衡就为你们介绍Recovery Boot：

1、支持的Serial EEPROM/NOR

　　i.MXRT支持加载恢复启动的主要是1-bit SPI接口的EEPROM，除此之外市面上有些Serial(QSPI) NOR也兼容EEPROM命令集（即1bit read/normal read模式），因此这些QSPI NOR也能被i.MXRT用做恢复启动。关于Serial EEPROM基本知识请先看一下痞子衡的另外一篇文章 EEPROM接口事实标准及Serial EEPROM简介。
　　Serial EEPROM/NOR厂商很是多，对应Serial EEPROM/NOR芯片型号也不少，若是你在选型时不肯定到底该为i.MXRT选择哪一款Serial EEPROM/NOR时，可选用下面三款芯片，痞子衡均实测过：

Onsemi CAT25512HU5I-GT3         （EEPROM,    1-bit SPI,    20MHz,      128B Page/512Kb Device）
Micron MT25QL128ABA1ESE-OSIT    （NOR Flash, Multiple I/O, 133MHz-STR, 64B Page/4-32-64KB Sector/128Mb Device）
Spansion S25FL129P              （NOR Flash, Multiple I/O, 80MHz,      256B Page/4-8-64-256KB Sector/128Mb Device）

Note1: BootROM固定使用SPI Mode(0,0)（即CPOL=0, CPHA=0）去访问外部EEPROM/NOR。
Note2: BootROM主要支持2bytes（存储范围为4Kb - 512Kb） / 3bytes（存储范围为1Mb - 128Mb）地址的外部EEPROM/NOR。

2、Serial EEPROM/NOR硬件链接

　　肯定了Serial EEPROM/NOR芯片选型后，底下便进入Serial EEPROM/NOR硬件电路设计及与i.MXRT的信号链接环节：

　　i.MXRT对于Serial EEPROM/NOR的底层接口支持是经过内部LPSPI这个IP实现的，i.MXRT内部一共有4个LPSPI，BootROM对这4组LPSPI都支持，具体pinmux以下：

　　以下是典型的SPI EEPROM硬件链接设计，示例EEPROM芯片是CAT25512HU5I-GT3，标准1-bit SPI，直接链接便可:

　　以下是典型的QSPI NOR硬件链接设计，示例NOR芯片是MT25QL128ABA1ESE-OSIT，该NOR芯片为Multiple I/O，数据线为DQ[3:0]，当用做1-bit SPI模式时，仅需链接DQ[1:0]：

3、Serial EEPROM/NOR加载启动过程

　　确保Serial EEPROM/NOR硬件相关设计无误以后，底下即是下载更新Bootable Image进Serial EEPROM/NOR以供BootROM加载启动了，在下载Bootable image以前有必要先了解Serial EEPROM/NOR的加载启动过程：

　　痞子衡在启动系列文章的第六篇 Bootable image格式与加载(elftosb/.bd) 里的最后已经介绍过non-XIP image加载启动过程，这个过程其实已经充分地描述了Serial EEPROM/NOR的加载启动过程。
　　有了non-XIP image加载启动的背景知识，Serial EEPROM/NOR的加载启动过程即是上电以后，在主动选择的Primary Boot Device启动失败以后，BootROM会从Serial EEPROM/NOR起始地址处加载initial image数据（4KB），再根据initial image里的IVT,Boot Data获取Application起始地址以及总长度，而后再将Application所有拷贝到相应SRAM里去启动，其过程以下图所示：

4、下载Application进Serial EEPROM/NOR

　　理解了Serial EEPROM/NOR加载启动过程，咱们即可以开始使用Flashloader下载Application进Serial EEPROM/NOR芯片中：

　　痞子衡在启动系列文章的第四篇 Flashloader初体验(blhost) 和第六篇 Bootable image格式与加载(elftosb/.bd) 里分别介绍了Flashloader的基本使用以及如何将你的Application制做成Bootable image，后续内容假定你已经制做好一个Bootable image而且使用blhost工具与Flashloader创建了基本通讯，正要开始将Bootable image下载进Serial EEPROM/NOR。

　　Serial EEPROM/NOR也支持configuration block，只不过configuration block对于BootROM恢复启动而言不是必需的，configuration block结构原型是下面的spi_nor_eeprom_config_t，在本文里暂不使能configuration block。

//! @brief Serial NOR/EEPROM peripheral Config block structure
typedef struct __spi_nor_eeprom_peripheral_config
{
    uint8_t spiIndex;     //!< Index of SPI module
    uint8_t spiPcsx;      //!< PCS instance of SPI module
    uint8_t reserved0[2]; //!< Reserved0
    uint32_t spiSpeed_Hz; //!< SPI transfer speed to connected NOR/EEPROM
} spi_nor_eeprom_peripheral_config_t;

//! @brief Serial NOR/EEPROM Config block structure
typedef struct __serial_nor_eeprom_config
{
    uint8_t memoryType;                            //!< Determines the connected memory type
    uint8_t addressLengthInBits;                   //!< Nor/Eeprom address length
    uint8_t waitTime;                              //!< Wait time before read
    uint8_t reserved0;                             //!< Reserved0
    uint32_t memorySizeInBytes;                    //!< Nor/Eeprom memory size
    uint32_t pageSizeInBytes;                      //!< Nor/Eeprom page size
    uint32_t sectorSizeInBytes;                    //!< Nor/Eeprom sector size
    serial_nor_eeprom_command_set commandSet;      //!< Nor/Eeprom command set
} serial_nor_eeprom_config_t;

//! @brief Serial NOR/EEPROM Config block structure
typedef struct __spi_nor_eeprom_config
{
    uint32_t tag;                                 //!< [0x000-0x003]
    uint32_t version;                             //!< [0x004-0x007]
    spi_nor_eeprom_peripheral_config_t spiConfig; //!< [0x008-0x00f]
    serial_nor_eeprom_config_t memoryConfig;      //!< [0x010-0x02b]
} spi_nor_eeprom_config_t;

　　前面扯了些没用的，那么到底怎么样将Bootable image数据下载进Serial EEPROM/NOR中呢？固然仍是靠Flashloader工具，咱们只须要提供简化的8byte配置数据便可。下面是一种Application下载更新示例（该示例适用于 Serial NOR芯片MT25QL128ABA1ESE-OSIT）：

// 在SRAM里临时存储Serial EEPROM/NOR配置数据
blhost -p COMx -- fill-memory 0x2000 0x4 0xC1100500 // SPI1, PCS0, NOR Flash, 256B Page, 4KB Sector, 16MB Device
blhost -p COMx -- fill-memory 0x2004 0x4 0x00000000 // 20MHz SPI Speed

// 使用Serial EEPROM/NOR配置数据去配置SPI接口
blhost -p COMx -- configure-memory 0x110 0x2000

　　在上述示例里痞子衡首先使用了fill-memory命令在0x2000地址处暂存了8byte配置数据，而后经过config-memory将这8byte数据里的信息配置到Flashloader的Serial EEPROM/NOR接口中，实际上这2个命令成功执行后，你就能够开始使用Flashloader下载Bootable image了。那么这8byte配置数据究竟是怎么组织的？详见下表：

　　从上表咱们能够知道，其实这8byte数据提供的配置信息主要是SPI链接以及EEPROM/NOR Device属性配置。configure-memory命令执行成功以后，底下image的下载很简单，只须要将Bootable image从Serial EEPROM/NOR起始地址开始下载便可，具体步骤以下：

// 擦除Serial EEPROM/NOR并将image下载进Serial EEPROM/NOR
blhost -p COMx -- flash-erase-region 0x0 0x20000 0x110
blhost -p COMx -- write-memory 0x0 ivt_image.bin 0x110

　　Bootable image下载成功以后，咱们能够试着用read-memory从Serial EEPROM/NOR芯片里读回IVT,BootData,Application确认一下，Bootable image起始地址在0x0，那么IVT,BootData应该在0x400，Application应该在0x2000：

　　至此，Application的下载工做便结束了。

5、进入Serial EEPROM/NOR备份启动模式

　　Application已经被成功下载进Serial EEPROM/NOR芯片以后，此时咱们即可以开始设置芯片从Serial EEPROM/NOR启动：

　　在进入Boot Device选择以前，你首先须要设置BOOT_MODE[1:0]=2'b10，即芯片处于Internal Boot模式，而且确认BT_FUSE_SEL（eFUSE偏移0x460处的32bit配置数据的bit4）为1'b0，或者也能够设置BOOT_MODE[1:0]=2'b00，即芯片处于Boot From Fuses模式，而且将BT_FUSE_SEL（eFUSE偏移0x460处的32bit配置数据的bit4）烧写为1'b1，这里看不懂的朋友请温习痞子衡前面的文章 Boot配置(BOOT Pin/eFUSE)。
　　设置好正确Boot模式后，再来选择Boot Device，Serial EEPROM/NOR属于Recovery Boot Device，并非能够主动选择启动的Boot device，因此并无BOOT_CFG pin或者eFUSE来配置选择直接从Serial EEPROM/NOR启动，若是想验证从Seril EEPROM/NOR启动是否能成功，你须要确保当前BOOT_CFG/eFUSE决定的Primary Boot Device中没有Bootable image。

6、配置eFUSE启动Serial EEPROM/NOR

　　设置好芯片启动模式是从Serial EEPROM/NOR启动以后，咱们还须要最后关注一下与Serial EEPROM/NOR相关的具体特性配置：

　　Serial EEPROM/NOR的配置相对仍是比较简单的，只有4部分：Recovery Boot Enable、SPI Speed、SPI addressing、SPI Port，其中Recovery Boot Enable是必定要开启的，SPI Port要根据板级线路设计而定，SPI addressing根据选用的Serial EEPROM/NOR型号而定，SPI Speed是惟一的能够自由配置的选项（固然不能超过所选Serial EEPROM/NOR的最高速度）。

7、几个注意事项

1. 市面上基本大于64KB的QSPI NOR均兼容EEPROM命令集（即1bit read/normal read模式）。
2. 虽然从Serial EEPROM/NOR启动的设计目的是用于recovery boot，但若是你硬要将Serial EEPROM/NOR做为系统里的惟一Boot Device，也并非不能够，你须要在板级设计时考虑与Primary Boot Device链接的i.MXRT相关引脚在上电时的电平转换（BootROM老是会尝试先启动Primary Boot Device）的影响。

　　上述全部步骤所有完成以后，复位芯片你就应该能看到你放在Serial EEPROM/NOR里的Application已经正常地启动了。

　　至此，飞思卡尔i.MX RTyyyy系列MCU的Serial EEPROM/NOR恢复启动痞子衡便介绍完毕了，掌声在哪里~~~