使用USB线缆升级固件

前言

本文介绍了如何将主机上的固件，通过USB 数据线烧录到 ICORE-1126BQ38 开发板的存储器中。升级时，需要根据主机操作系统和固件类型来选择合适的升级方式。

准备工具

ICORE-1126BQ38 开发板
固件
主机
良好的USB 数据线

准备固件

固件可以通过编译SDK获得，也可以通过资源下载处下载公版固件（统一固件）。固件文件一般有两种：

单个统一固件

统一固件是由分区表、bootloader、uboot、kernel、system等所有文件打包合并成的单个文件。Firefly正式发布的固件都是采用统一固件格式，升级统一固件将会更新主板上所有分区的数据和分区表，并且擦除主板上所有数据。
多个分区镜像

即各个功能独立的文件，如分区表、bootloader、kernel等，在开发阶段生成。独立分区镜像可以只更新指定的分区，而保持其它分区数据不被破坏，在开发过程中会很方便调试。

通过统一固件解包/打包工具，可以把统一固件解包为多个分区镜像，也可以将多个分区镜像合并为一个统一固件。

安装烧写工具

Windows操作系统

安装RK USB驱动

下载 Release_DriverAssistant.zip，解压，然后运行里面的 DriverInstall.exe 。为了所有设备都使用更新的驱动，请先选择驱动卸载，然后再选择驱动安装。

运行AndroidTool的RKDevTool.exe

Linux操作系统

Linux 下无须安装设备驱动

Linux_Upgrade_Tool工具

下载 Linux_Upgrade_Tool, 并按以下方法安装到系统中，方便调用：

unzip Linux_Upgrade_Tool_xxxx.zip
cd Linux_UpgradeTool_xxxx
sudo mv upgrade_tool /usr/local/bin
sudo chown root:root /usr/local/bin/upgrade_tool
sudo chmod a+x /usr/local/bin/upgrade_tool

Linux_adb_fastboot工具

下载 Linux_adb_fastboot, 并按以下方法安装到系统中，方便调用：

sudo mv adb /usr/local/bin
sudo chown root:root /usr/local/bin/adb
sudo chmod a+x /usr/local/bin/adb

sudo mv fastboot /usr/local/bin
sudo chown root:root /usr/local/bin/fastboot
sudo chmod a+x /usr/local/bin/fastboot

进入升级模式

通常我们升级固件的模式有两种，分别是Loader模式和MaskRom模式。烧写固件前，我们需要连接好设备，并让板子进入到可升级模式。

Maskrom 模式

硬件方式进入 Maskrom 模式

连接设备并通过MASKROM按键进入 Maskrom 升级模式步骤如下：

先断开电源适配器连接
使用 USB 数据线一端连接主机，一端连接开发板

按住设备上的 MASKROM 键并保持
硬件版本不同，按键位置可能略有不同，请以实际丝印为准
接上电源
大约两秒钟后，松开 MASKROM 键

软件方式进入Loader模式

USB 数据线接好后在串口调试终端或adb shell给板子运行以下命令

reboot loader

查看Loader模式

如何确定板子是否进入Loader模式，我们可以通过工具去查看

Windows操作系统

通过AndroidTool工具可以看到下方提示Found One LOADER Device

如果有进行"进入Loader模式"的操作，仍旧没有看到烧写工具提示LOADER，此时可以可以看一下Windows主机是否有提示发现新硬件并配置驱动。打开设备管理器，会见到新设备 Rockusb Device 出现，如下图。如果没有，可返回上一步重新安装驱动。

Linux操作系统

运行upgrade_tool后可以看到连接设备中有个Loader的提示

firefly@T-chip:~/severdir/down_firmware$ sudo upgrade_tool
List of rockusb connected
DevNo=1 Vid=0x2207,Pid=0x330c,LocationID=106    Loader
Found 1 rockusb,Select input DevNo,Rescan press <R>,Quit press <Q>:q

MaskRom模式

进入MaskRom模式的方法，请参考《MaskRom模式》

烧写固件

windows操作系统

烧写统一固件 update.img

烧写统一固件 update.img 的步骤如下:

切换至Upgrade Firmware页。
按Firmware按钮，打开要升级的固件文件。升级工具会显示详细的固件信息。
按Upgrade按钮开始升级。
如果升级失败，可以尝试先按EraseFlash 按钮来擦除 Flash，然后再升级。

烧写分区映像

烧写分区映像的步骤如下：

切换至Upgrade Firmware页。
勾选需要烧录的分区，可以多选。
确保映像文件的路径正确，需要的话，点路径右边的空白表格单元格来重新选择。
点击Run按钮开始升级，升级结束后设备会自动重启。

烧写工具使用技巧：

获取设备分区表信息

使 rv1126 设备进入 loader 模式。然后点击图片的 Dev Partition 按钮即可获取到设备的分区信息。

点击更新即可获取到设备的分区信息如下：
导出设备分区表信息

点击鼠标右键弹出菜单，选择 export config 导出分区表配置：
加载设备分区表信息

点击鼠标右键弹出菜单，选择 load config 加载分区表配置：

Linux操作系统

烧写统一固件 update.img

sudo upgrade_tool uf update.img

如果升级失败，可以尝试先擦除后再升级。

# 擦除 flash 使用 ef 参数需要指定 loader 文件或者对应的 update.img
sudo upgrade_tool ef update.img   #update.img :你需要烧写的 update.img 固件
# 重新烧写
sudo upgrade_tool uf update.img

烧写分区镜像

查看 SDK 编译输出目录 output。可以看到这个目录下的 boot.img 是链接到 /path/to/sdk/kernel/boot.img 的。

lvsx@amd-epyc:~/project/rv1126b $ ll output/firmware/
total 12
drwxrwxr-x  2 lvsx lvsx 4096 Dec 25 17:40 ./
drwxrwxr-x 11 lvsx lvsx 4096 Dec 25 20:06 ../
lrwxrwxrwx  1 lvsx lvsx   25 Dec 25 17:35 boot.img -> ../../kernel-6.1/boot.img
lrwxrwxrwx  1 lvsx lvsx   45 Dec 25 15:51 MiniLoaderAll.bin -> ../../u-boot/rv1126b_spl_loader_v1.06.105.bin
lrwxrwxrwx  1 lvsx lvsx   11 Dec 25 15:50 misc.img -> ../misc.img
lrwxrwxrwx  1 lvsx lvsx   22 Dec 25 15:53 oem.img -> ../extra-parts/oem.img
lrwxrwxrwx  1 lvsx lvsx   61 Dec 25 15:53 parameter.txt -> ../../device/rockchip/.chips/rv1126b/parameter-debian-fit.txt
lrwxrwxrwx  1 lvsx lvsx   23 Dec 25 17:38 recovery.img -> ../recovery/ramboot.img
lrwxrwxrwx  1 lvsx lvsx   47 Dec 25 15:52 rootfs.img -> ../../prebuilt_rootfs/rv1126b_debian_rootfs.img
lrwxrwxrwx  1 lvsx lvsx   22 Dec 25 15:51 uboot.img -> ../../u-boot/uboot.img
lrwxrwxrwx  1 lvsx lvsx   26 Dec 25 17:40 update.img -> ../update/Image/update.img
lrwxrwxrwx  1 lvsx lvsx   27 Dec 25 15:53 userdata.img -> ../extra-parts/userdata.img

所以实际需要烧录的内核固件是 boot.img 。如果在 output/firmware/ 目录则执行以下命令烧录内核固件：

sudo upgrade_tool di -b /path/to/sdk/output/firmware/boot.img

如果是在 /path/to/sdk/kernel 目录则需要执行以下命令烧录内核固件：

sudo upgrade_tool di -b /path/to/sdk/kernel/boot.img

常用的烧写命令如下：

sudo upgrade_tool di -b /path/to/boot.img
sudo upgrade_tool di -r /path/to/recovery.img
sudo upgrade_tool di -m /path/to/misc.img
sudo upgrade_tool di -u /path/to/uboot.img
sudo upgrade_tool di -p paramater   #烧写 parameter
sudo upgrade_tool ul bootloader.bin # 烧写 bootloader

如果因 flash 问题导致升级时出错，可以尝试低级格式化、擦除 emmc：

sudo upgrade_tool lf update.img	# 低级格式化
sudo upgrade_tool ef update.img	# 擦除

fastboot 烧写动态分区

adb reboot fastboot # 进入bootloader
sudo fastboot flash vendor vendor.img
sudo fastboot flash system system.img
sudo fastboot reboot # 烧写成功后,重启

常见问题

如何强行进入 MaskRom 模式

如果板子进入不了 Loader 模式，此时可以尝试强行进入 MaskRom 模式。操作方法见《MaskRom模式》。

烧写失败分析

如果烧写过程中出现Download Boot Fail, 或者烧写过程中出错，如下图所示，通常是由于使用的USB线连接不良、劣质线材，或者电脑USB口驱动能力不足导致的，请更换USB线或者电脑USB端口排查。

本页目录