基于Android 10系统的瑞芯微RK3399K烧写镜像实录

1. 前言

作为Firefly新一代的顶级开源平台，Firefly-RK3399采用了六核64位“服务器级”处理器Rockchip RK3399，拥有2GB/4GB DDR3和16G/32GB eMMC, 并新增DP 1.2、PCIe 2.1 M.2、Type-C、USB3.0 HOST等高性能数据传输和显示接口。Firefly-RK3399强大的性能配置将给VR、全景拍摄、视觉识别、服务器、3D等前沿技术带来里程碑的变革。目前已支持Ubuntu（Debian）、Linux buildRoot、Android，因此使用场景非常广，医疗、车载、机器人、智能家居、人脸识别考勤机、门禁、游戏外设、POS机、安防机、卡拉OK机等等都可以使用，而且算是国产芯片应用推广的一大步。

2. 官网及相关资料

这个是GitHub地址：

https://github.com/rockchip-linux

这个是官网：

https://www.rock-chips.com/

资料较多的Wiki：

https://wiki.t-firefly.com/zh_CN/Firefly-RK3399/index.html

3. 烧写固件所需软件

可参考这里:

https://wiki.t-firefly.com/zh_CN/Firefly-RK3399/03-upgrade_firmware.html

进行下载。

AndroidTool_Release_v2.6.1

DriverAssitant_v4.5

版本可能有变动，但一个是驱动工具，一个是固件烧写工具，通过usb/type-C或者双usb头的线直接进行烧写（这类较大的系统一般都不通过串口直接烧写，速度会比较慢）。

4. 直接烧写单一固件步骤

如果有完整的单一固件文件可以直接升级固件，不需要单独烧写部分分区，所以步骤也会相对简单，直接搜索找到设备->进入升级模式->载入固件->一键升级即可。

5. 固件文件

固件文件一般有两种：

单个统一固件

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

多个分区镜像

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

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

6. Windows下烧写准备

工具: Androidtool_xxx(版本号)

注意:不同固件使用的工具版本可能不同,请根据《使用USB线烧写须知(重要)》下载对应的版本

6.1 安装 RK USB 驱动

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

6.2 连接设备

如下是我们目前测试的板子，已经通过结构和硬件工程师针对需求做了整体设计调整，直接使用的三个usb口，没有type-c等，显示接口使用的HDMI，主要是方便大屏和人脸机以及机器人开发使用，增加了USB3.0的接口，更像是一块PC板，可以接鼠标、键盘和高清显示器，板子上没有标识recovery和reset按键，我这里做下标识，一般来说需要使设备进入升级模式需要这两个按键，所以你不知道的时候需要问硬件工程师或者自己看图纸。

设备进入升级模式的方式如下（推荐第二种，更方便一些，像我们是使用双USB头，所以没有Type-C数据线，这个不影响，在烧写前需要看一下你们的板子是双USB线还是Type-C，没有特殊需求大多是Type-C，比较通用）：

一种方法是设备先断开电源适配器和 Type-C 数据线的连接：（如果是双usb口的使用对应连接线即可）
    USB 一端连接主机，Type-C 一端连接开发板 Type-C 母口
    按住设备上的 RECOVERY （恢复）键并保持
    接上电源
    大约两秒钟后，松开 RECOVERY 键
另一种方法，无需断开电源适配器和 Type-C 数据线的连接：
    USB 一端连接主机，Type-C 一端连接开发板 Type-C 母口
    按住设备上的 RECOVERY （恢复）键并保持
    短按一下 RESET（复位）键
    大约两秒钟后，松开 RECOVERY 键

主机应该会提示发现新硬件并配置驱动。打开设备管理器，会见到新设备 Rockusb Device 出现，如下图。如果没有，则需要返回上一步重新安装驱动。

7. 烧写固件

下载 AndroidTool(若系统是 Android8.1 则需要 2.54 以上版本)，解压，运行 AndroidTool_Release_v2.38 目录里面的 AndroidTool.exe（注意，如果是 Windows 7/8,需要按鼠标右键，选择以管理员身份运行），如下图：

7.1 烧写统一固件 update.img

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

切换至升级固件页。
按固件按钮，打开要升级的固件文件。升级工具会显示详细的固件信息。
按升级按钮开始升级。
如果升级失败，可以尝试先按’擦除 Flash’按钮来擦除 Flash，然后再升级。一定要根据《使用USB线烧写须知(重要)》进行擦除烧写

注意：如果你烧写的固件 laoder 版本与原来的机器的不一致，请在升级固件前先执行’擦除 Flash’。

汉化版的：

7.2 烧写分区映像

每个固件的分区可能不相同,请注意以下两点:

使用 Androidtool_2.38 烧写 ubuntu(MBR) 和 Android7.1 固件时使用默认配置即可;
使用 Androidtool_2.58 烧写 ubuntu(GPT) 使用默认配置即可，烧写 Android8.1 固件请先执行以下操作: 切换至下载镜像页面; 右键点击表格，选择导入配置; 选择rk3399-Android81.cfg
使用Androidtool_2.71烧写Android10或Android9固件时使用默认配置即可;

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

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

8. Linux下烧写

Linux 下无须安装设备驱动，参照 Windows 章节连接设备则可。

工具:Linux_Upgrade_Tool

注意:不同固件使用的工具版本可能不同,请根据[烧写须知]下载对应的版本

8.1 upgrade_tool

下载 Linux_Upgrade_Tool (系统是 Android8.1则需要 Linux_Upgrde_Tool_for_android8.1), 并按以下方法安装到系统中，方便调用：

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

烧写统一固件 update.img：

sudo upgrade_tool uf update.img

如果升级失败，可以尝试先擦除后再升级。一定要根据《使用USB线烧写须知(重要)》的表格进行擦除烧写

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

8.2 烧写分区镜像

Android7.1、Android8.1使用以下方式:

sudo upgrade_tool di -b boot.img
sudo upgrade_tool di -k kernel.img
sudo upgrade_tool di -s system.img
sudo upgrade_tool di -r recovery.img
sudo upgrade_tool di -m misc.img
sudo upgrade_tool di -re resource.img
sudo upgrade_tool di -p paramater  
sudo upgrade_tool ul bootloader.bin 

Android9.0、Android10.0使用以下方式:

sudo upgrade_tool di -b boot.img
sudo upgrade_tool di -dtbo dtbo.img  
sudo upgrade_tool di -misc misc.img
sudo upgrade_tool di -parameter parameter.txt
sudo upgrade_tool di -r recovery.img
sudo upgrade_tool di -super super.img
sudo upgrade_tool di -trust trust.img
sudo upgrade_tool di -uboot uboot.img
sudo upgrade_tool di -vbmeta vbmeta.img

Ubuntu(GPT)使用以下方式:

sudo upgrade_tool ul $LOADER
sudo upgrade_tool di -p $PARAMETER
sudo upgrade_tool di -uboot $UBOOT
sudo upgrade_tool di -trust $TRUST
sudo upgrade_tool di -boot $BOOT
sudo upgrade_tool di -recovery $RECOVERY
sudo upgrade_tool di -misc $MISC
sudo upgrade_tool di -oem $OEM
sudo upgrade_tool di -userdata $USERDATA
sudo upgrade_tool di -rootfs $ROOTFS

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

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

9. 常见问题

9.1 如何强行进入 MaskRom 模式

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

9.2 烧写失败分析

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

10. 最后

一般来说，我们在一块板子上搭建好环境后，会提取出统一固件用于生产环境，这个也可以借助于上面的工具进行固件镜像提取。