RT Flash

English | 中文

1 软件概览

1.1 介绍

　　RT-Flash是一个专为基于NXP i.MX RT系列芯片的产品量产而设计的工具，其功能与官方MfgTool2工具类似，但是解决了MfgTool2工具在实际量产使用中的一些痛点：

　　借助于RT-Flash，你可以轻松实现批量生产。RT-Flash主要功能如下：

1.2 下载

　　RT-Flash完全基于Python语言开发，并且源代码全部开源，其具体开发环境为Python 2.7.15 (32bit)、wxPython 4.0.3、pySerial 3.4、pywinusb 0.4.2、PyInstaller 3.3.1（或更高）。

　　RT-Flash在发布时借助PyInstaller将所有的Python依赖全部打包进一个可执行文件（\RT-Flash\bin\RT-Flash.exe），因此如果不是对RT-Flash的二次开发，你不需要安装任何Python软件及相关库。

1.3 安装

　　RT-Flash是一个是纯绿色免安装的工具，下载了源代码包之后，直接双击\RT-Flash\bin\RT-Flash.exe即可使用。使用RT-Flash没有任何软件依赖，不需要额外安装任何软件。
　　在RT-Flash.exe图形界面显示之前，会首先弹出一个控制台窗口，该控制台会伴随着RT-Flash.exe图形界面一起工作，很多图形界面的操作都会在控制台窗口看到对应的底层命令执行，保留控制台主要是为了便于定位RT-Flash.exe的问题，目前RT-Flash尚处于早期阶段，等后期软件成熟会考虑移除控制台。

1.4 目录

　　RT-Flash软件目录组织如下：

\RT-Flash
\apps                 --放置NXP官方评估板示例.sb格式image文件
\bin                  --放置RT-Flash可执行文件
\env                  --放置用于安装RT-Flash开发环境以及打包脚本
\gui                  --放置开发RT-Flash UI构建工程文件
\img                  --放置RT-Flash使用过程中需加载的图片
\src                  --放置开发RT-Flash的所有Python源代码文件
\tools                --放置RT-Flash使用过程中需调用的外部程序
\blhost             --与Flashloader通信的上位机命令行工具
\sdphost            --与ROM通信的上位机命令行工具

1.5 界面

　　下图为RT-Flash工具的主界面，界面主要由四部分组成，各部分功能如下：

2 准备工作

　　在使用RT-Flash工具前主要有两个准备工作：一、准备好i.MXRT硬件板以及串行下载连接线（USB/UART）；二、准备好用于下载进Flash的.sb格式源文件。
　　关于串行下载线连接，需要查看i.MXRT参考手册System Boot章节，确保连接的UART/USB引脚是BootROM指定的。
　　关于.sb格式源文件准备，可借助NXP-MCUBootUtility工具（v1.2.0版本及以上），NXP-MCUBootUtility能够识别五种常见格式(elf/axf/srec/hex/bin)的源image，并且能够将源image文件转换成.sb格式文件。
　　如果只是为了快速验证RT-Flash工具，在RT-Flash\apps文件夹下默认存放了全系列恩智浦官方i.MXRT评估板的led_blinky应用的.sb格式文件。

3 软件使用

3.1 设置目标芯片

　　在使用RT-Flash时首先需要配置目标设备，目标设备即MCU Device。以NXP官方开发板EVK-MIMXRT1060为例，该开发板主芯片为i.MXRT1062DVL6A，所以【RT Device】应设为i.MXRT106x。

3.2 设置下载端口

　　设置好目标设备之后，下一步便是连接目标设备，以USB-HID接口连接为例，给EVK-MIMXRT1060板子供电，并用USB Cable将PC与J9口连接起来，如果一切正常，应该可以在设备管理器找到vid,pid为0x1fc9,0x0135的HID-compliant vendor-defined device设备被枚举。如果没有发现该HID设备，请仔细检查板子SW7拨码开关是否将Boot Mode设为2'b01即Serial Downloader模式。

　　确认HID设备存在之后，选中USB-HID即可。

3.3 点击一键下载

　　选中要下载的.sb文件，直接点击【Start】按钮便可将.sb文件下载进启动设备。如果成功下载，【Successful Boards】里数值会变成1，此外状态栏里会显示"Application image file (.sb) has been downloaded successfully!"。

3.4 批量下载

3.4.1 批量多文件

　　如果你想一次性下载多个.sb文件，你需要将这些文件放置于同一个文件夹，然后在工具里第二个【Browse】下选中这个文件夹（注意必须保证第一个【Browse】按钮里的路径是空），然后直接点击【Start】按钮便可。

3.4.2 批量多板卡

　　如果你想一次性下载程序进多个板卡，你需要在板卡设置栏【Connected】填入实际连接板卡数（填入数值后必须按键盘上的Enter键来确定），以USB接口为例，此时你会看到【Detected】里会显示实际识别板卡数，最终下载以实际识别板卡数为准。然后直接点击【Start】按钮便可。

　　如果选择的是UART接口，你必须在【RT Port Index】里逐一选中每个Port进行具体设置，并保证右侧状态均为"Already Set"。

3.5 在HAB Closed情况下

　　当芯片HAB状态处于Closed的情况下，此时需要将你生成的含签名的flashloader文件放置于RT-Flash指定目录下（此处以RT106x为例），并且文件必须命名为ivt_flashloader_signed.bin。

　　除此以外，还需确保bltargetconfig.py文件里的两个变量与你的含签名flashloader文件相匹配。