痞子衡嵌入式：一种i.MXRT下从App中进入ROM串行下载模式的方法

---

　　你们好，我是痞子衡，是正经搞技术的痞子。今天痞子衡给你们介绍的是i.MXRT下在App中利用ROM API进ISP/SDP模式的方法。

　　咱们知道i.MXRT系列分为两大阵营：CM33内核的i.MXRTxxx系列和CM7内核的i.MXRT1xxx系列，可是这两个阵营都有一个共性，那就是都没有内部非易失性存储器（NVM）而且BootROM里都集成了串行下载功能。

　　串行下载功能即BootROM中实现了经过串行接口（UART/USB...）与上位机通信，将客户App数据烧录进外部启动设备中，这个功能主要用于量产，但在实际应用过程当中，经过首推的启动引脚（ISP[2:0] / BT_MODE[1:0]）配置进入串行下载模式的方式有时候不方便，由于引脚状态不方便切换，本文痞子衡将给你们介绍一种不须要切换启动引脚进入串行下载模式的方法。

1、配置启动引脚进串行下载模式

　　痞子衡很早前写过两篇文章，详细介绍了 《i.MXRTxxx的串行下载模式(ISP)》、《i.MXRT1xxx的串行下载模式(SDP)》，此处再简单回顾一下。

1.1 i.MXRTxxx之ISP

　　i.MXRTxxx系列用于配置进入串行下载模式的启动引脚有3个，即ISP[2:0]，这三个引脚在系统软复位后由BootROM直接进行软采样，BootROM根据ISP[2:0]值判断是否进入串行下载模式，串行接口支持UART/SPI/USB-HID三种，烧录算法是直接集成在BootROM中的，能够直接烧录App。

1.2 i.MXRT1xxx之SDP

　　i.MXRT1xxx系列用于配置进入串行下载模式的启动引脚有2个，即BT_MODE[2:0]，这两个引脚仅在系统POR复位时由系统硬采样保存到非易失性寄存器SRC->SBMR2中，BootROM从SRC->SBMR2寄存器中获取BT_MODE[2:0]值判断是否进入串行下载模式，串行接口支持UART/USB-HID两种，由于BootROM中没有集成烧录算法，因此须要加载一个专用的Flashloader来烧录App。

2、切换启动引脚带来的不便

　　在恩智浦官方i.MXRT开发板设计上，外部启动引脚是链接的拨码开关，所以咱们能够经过切换拨码开关并复位的方式来进入ROM串行下载模式，但实际应用场景下，客户板卡并不会留有拨码开关，更多的是用上下拉电阻的方式肯定启动模式，并且默认设置的启动模式是从Flash启动。

　　当客户板卡首次上电，且链接的启动Flash是空白时，即便启动模式设置的是从Flash启动，但因为Flash里并无App，所以BootROM在启动App失败后仍是会自动进入串行下载模式，这意味着至少能够进一次串行下载模式。当成功使用串行下载模式将App烧录进启动Flash以后，再次上电，此时板卡便会从ROM跳转到App执行，这种状况下，除非改变启动引脚输入状态，否则永远不会再次进入串行下载模式。而在客户板卡上改变启动引脚状态便意味着要从新焊接板子，改变启动引脚的上下拉电阻，这固然很不方便。

3、借助ROM API进入串行下载模式

　　那么有没有不改变启动引脚状态就进入ROM串行下载模式的方法呢？答案固然是有。痞子衡以前写过一篇文章 《了解i.MXRTxxx系列ROM API及其与i.MXRT1xxx系列的差别》，把i.MXRT全系列ROM API都捋了一遍。若是你足够细心会发现它们都有一个共同的API，名字叫runBootloader：

// 适用i.MXRT500/600/1015/1020/1050
typedef struct
{
    void (*runBootloader)(void *arg);
    uint32_t version;
    const char *copyright;
    // 省略
} bootloader_api_entry_t;


// 适用i.MXRT1010/1060/1064/1170
typedef struct
{
    const uint32_t version;
    const char *copyright;
    void (*runBootloader)(void *arg);
    // 省略
} bootloader_api_entry_t;

　　关于这个runBootloader API函数可在参考手册中找到相关解释，从文档中来看，这个函数的做用主要有两个：1、IAP后直接去启动新更新的App；2、从新进ROM串行下载模式去更新App。这第二个功能不正是咱们要的效果吗，让咱们试一试。

　　根据前面介绍的ROM API知识，让咱们在App中把runBootloader函数重定义一下，runBootloader函数原型与API中原型保持一致，其函数实现就直接调用API：

// 适用i.MXRT500
#define g_bootloaderTree ((bootloader_api_entry_t *)0x0302f000)
// 适用i.MXRT600
#define g_bootloaderTree ((bootloader_api_entry_t *)0x0303f000)
// 适用i.MXRT1010/1015/1020/1050/1060/1064/1170
#define g_bootloaderTree (*(bootloader_api_entry_t **)0x0020001c)

void runBootloader(void* arg)
{
    g_bootloaderTree->runBootloader(arg);
}

　　App中有了runBootloader函数，下一步就是传参调用。先说调用，其实这里就至关于切换启动引脚操做了，由于咱们不想切换启动引脚，因此咱们须要在App中插入一段runBootloader函数调用代码，而且须要为它设计一个专用的触发方式（好比能够是某个引脚中断，也能够是串口收到某个命令等等，这里客户自由发挥）。解决了调用问题，下一步就是传什么参数，参考手册里有详细的参数各bit定义，下面是进入USB下载模式的示例代码：

// 适用i.MXRTxxx
uint32_t arg = 0xeb130000;
// 适用i.MXRT1xxx
uint32_t arg = 0xeb100000;

// 进入ROM USB下载模式
runBootloader(&arg);

　　下图是i.MXRT500中arg位定义，进入USB下载模式参数值应是0xeb130000：

　　下图是i.MXRT1060中arg位定义，进入USB下载模式参数值应是0xeb100000或0xeb110000：

　　runBootloader(&arg)函数执行完以后，此时在USB OTG1口上插上USB线应该能够看到电脑设备上从新枚举了HID设备，而后就可使用配套上位机工具（好比MCUBootUtility）进行App更新下载了。

4、附录

　　附录收录了i.MXRT两大阵营表明型号的ROM API中runBootloader具体实现，其中i.MXRTxxx系列对应实例是bootloader_user_entry()函数，i.MXRT1xxx系列对应实例是run_bootloader()函数，这两个函数的核心思想都是在芯片某个非易失性（软复位不置位）的寄存器中将用户传入的参数值保存下来，而后调用NVIC软复位函数从新进入BootROM，由BootROM来处理用户传入的参数：

附一、i.MXRT500 BootROM中bootloader_user_entry()实现

#define SET_USER_APP_BOOT_OPTIONS(val) ((*(volatile uint32_t *)(SYSCTL0_BASE + 0x384)) = val)

void bootloader_user_entry(void *arg)
{
    SET_USER_APP_BOOT_OPTIONS(*(uint32_t *)arg);

    NVIC_SystemReset();
}

附二、i.MXRT1060 BootROM中run_bootloader()实现

enum
{
    kEnterBootloader_Tag = 0xEB,
    kEnterBootloader_Mode_Default = 0,
    kEnterBootloader_Mode_SerialDownloader = 1,

    kEnterBootloader_SerialInterface_Auto = 0,
    kEnterBootloader_SerialInterface_USB = 1,
    kEnterBootloader_SerialInterface_UART = 2,

    kEnterBootloader_ImageIndex_Max = 3,
};

typedef union
{
    struct
    {
        uint32_t imageIndex:4;
        uint32_t reserved:12;
        uint32_t serialBootInterface:4;
        uint32_t bootMode:4;
        uint32_t tag:8;
    }B;
    uint32_t U;
}run_bootloader_ctx_t;

void run_bootloader(void *arg)
{
    const run_bootloader_ctx_t *ctx = (const run_bootloader_ctx_t*)arg;
	if (ctx->B.tag != kEnterBootloader_Tag)
	{
		break;
	}
	if (ctx->B.bootMode > kEnterBootloader_Mode_SerialDownloader)
	{
		break;
	}
	if (ctx->B.imageIndex > kEnterBootloader_ImageIndex_Max)
	{
		break;
	}

	SRC->GPR[3] = ctx->U;

	__DSB();
	__ISB();

	NVIC_SystemReset();
}

　　至此，i.MXRT下在App中利用ROM API进ISP/SDP模式的方法痞子衡便介绍完毕了，掌声在哪里~~~

欢迎订阅

文章会同时发布到个人 博客园主页、CSDN主页、知乎主页、微信公众号 平台上。

微信搜索"痞子衡嵌入式"或者扫描下面二维码，就能够在手机上第一时间看了哦。