在这里插入代码片@TOC
1、使用USB线烧写须知(重要)
（1）、升级版本不同
AIO-3399J 出厂时默认安装Android系统，由于系统特性，已安装Android7.1 系统的主板烧写其它非此同一版本的固件时，需要做一些预处理，否则会导致烧写固件失败。
以下预操作处理之后，机器应该处于maskrom状态，如下图所示，否则预操作不成功。
如果机器当前已经处于maskrom状态，则不需要任何预处理，可以直接烧写任何版本的固件。
（2）、烧写工具(根据下表下载对应的升级工具版本)
下载地址：http://www.t-firefly.com/doc/download/page/id/31.html
（3）、固件
Ubuntu：
Firefly 发布的Ubuntu固件采用GPT分区格式管理启动介质，早期采用MBR分区格式的固件已经停止支持。
Android 7.1：
Android7.1 的固件分为 tvbox版本以及industry版本(主要维护)，两版固件均兼容AIO-3399J板型。
（4）、当主板上已经安装了Android7.1tvbox版本的固件后，如果需要再更新为其它非Android7.1tvbox版本的固件时，需要进行以下预处理
预处理方法1：
下载RK3399_Android7.1_EraseIDB.7z，
下载地址：http://www.t-firefly.com/doc/download/page/id/31.html#other_397
先单独升级一次uboot，升级完成后，重启主板，主板会自动擦除IDB，进入maskrom模式。然后再按照正常的升级流程更新固件。
预处理方法2：
请认真阅读下表，再进行烧写:
2、准备工作
- AIO-3399J 开发板
- 固件
- 主机
- 良好的双公头USB数据线数据线
3、固件文件
固件文件一般有两种：
（1）、单个统一固件
统一固件是由分区表、bootloader、uboot、kernel、system等所有文件打包合并成的单个文件。Firefly正式发布的固件都是采用统一固件格式，升级统一固件将会更新主板上所有分区的数据和分区表，并且擦除主板上所有数据。
（2）、多个分区镜像
即各个功能独立的文件，如分区表、bootloader、kernel等，在开发阶段生成。独立分区镜像可以只更新指定的分区，而保持其它分区数据不被破坏，在开发过程中会很方便调试。
通过统一固件解包/打包工具，可以把统一固件解包为多个分区镜像，也可以将多个分区镜像合并为一个统一固件。
4、windows下烧录
（1）、工具: Androidtool_xxx(版本号)
注意:不同固件使用的工具版本可能不同
安装 RK USB 驱动
下载 Release_DriverAssistant.zip，解压，然后运行里面的 DriverInstall.exe
为了所有设备都使用更新的驱动，请先选择驱动卸载，然后再选择驱动安装。
下载地址：
http://www.t-firefly.com/doc/download/page/id/31.html
5、连接设备
设备进入升级模式的方式如下：
（1）、一种方法是设备先断开电源适配器和双公头 USB 数据线的连接：
-
双公头 USB 数据线一端连接主机，一端连接开发板
-
按住设备上的 RECOVERY （恢复）键并保持
-
接上电源
-
大约两秒钟后，松开 RECOVERY 键
（2）、另一种方法，无需断开电源适配器和双公头 USB 数据线的连接：
- 双公头 USB 数据线一端连接主机，一端连接开发板
- 按住设备上的 RECOVERY （恢复）键并保持
- 短按一下 RESET（复位）键
- 大约两秒钟后，松开 RECOVERY 键
主机应该会提示发现新硬件并配置驱动。打开设备管理器，会见到新设备 Rockusb Device
出现，如下图。如果没有，则需要返回上一步重新安装驱动。
6、烧写固件
下载 AndroidTool(若系统是 Android8.1 则需要 2.54 以上版本)，解压，运行
AndroidTool_Release_v2.38 目录里面的 AndroidTool.exe（注意，如果是 Windows
7/8,需要按鼠标右键，选择以管理员身份运行），如下图：
7、烧写统一固件 update.img
烧写统一固件 update.img 的步骤如下:
- 切换至升级固件页。
- 按固件按钮，打开要升级的固件文件。升级工具会显示详细的固件信息。
- 按升级按钮开始升级。
- 如果升级失败，可以尝试先按擦除 Flash 按钮来擦除 Flash，然后再升级。一定要根据《使用USB线烧写须知(重要)》进行擦除烧写
注意：如果你烧写的固件 laoder 版本与原来的机器的不一致，请在升级固件前先执行擦除 Flash 。
8、烧写分区映像
每个固件的分区可能不相同,请注意以下两点:
- 使用 Androidtool_2.38 烧写 ubuntu(MBR) 和 Android7.1 固件时使用默认配置即可;
- 使用 Androidtool_2.58 烧写 ubuntu(GPT) 使用默认配置即可，烧写 Android8.1
固件请先执行以下操作: - 切换至下载镜像页面; 右键点击表格，选择导入配置; 选择rk3399-Android81.cfg
烧写分区映像的步骤如下：
- 切换至下载镜像页。
- 勾选需要烧录的分区，可以多选。
- 确保映像文件的路径正确，需要的话，点路径右边的空白表格单元格来重新选择。
- 点击执行按钮开始升级，升级结束后设备会自动重启。
9、Linux下烧录
Linux 下无须安装设备驱动，参照 Windows 章节连接设备则可。
（1）、工具下载
工具:Linux_Upgrade_Tool
下载地址：http://www.t-firefly.com/doc/download/page/id/31.html
注意:不同固件使用的工具版本可能不同,请根据[烧写须知]下载对应的版本
下载 Linux_Upgrade_Tool (系统是 Android8.1 则需要
Linux_Upgrde_Tool_for_android8.1), 并按以下方法安装到系统中，方便调用：
（2）、安装
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
（3）、烧写统一固件 update.img：
sudo upgrade_tool uf update.img
（4）、如果升级失败，可以尝试先擦除后再升级。
# 擦除 flash 使用 ef 参数需要指定 loader 文件或者对应的 update.img
sudo upgrade_tool ef update.img #update.img :你需要烧写的 Ubuntu 固件
# 重新烧写
sudo upgrade_tool uf update.img
（5）、烧写分区镜像： Ubuntu(MBR)、Android7.1、Android8.1,使用以下方式:
sudo upgrade_tool di -b /path/to/boot.img
sudo upgrade_tool di -k /path/to/kernel.img
sudo upgrade_tool di -s /path/to/system.img
sudo upgrade_tool di -r /path/to/recovery.img
sudo upgrade_tool di -m /path/to/misc.img
sudo upgrade_tool di -re /path/to/resource.img
sudo upgrade_tool di -p paramater #烧写 parameter
sudo upgrade_tool ul bootloader.bin # 烧写 bootloader
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 # 擦除
10、常见问题
-
如何强行进入 MaskRom 模式
如果板子进入不了 Loader 模式，此时可以尝试强行进入 MaskRom 模式。操作方法见《MaskRom模式》。 -
烧写失败分析
如果烧写过程中出现Download Boot Fail, 或者烧写过程中出错，如下图所示，通常是由于使用的USB线连接不良、劣质线材，或者电脑USB口驱动能力不足导致的，请更换USB线或者电脑USB端口排查。
