APEX ORIN NANO 固件烧写#
进入烧写模式操作说明#
连接48PIN IO转接线
按住Recovery KEY，同时对设备进行断电/上电操作
使用USB 线，连接PC和设备烧写口。
在烧写用PC端，确认设备进入了recovery模式
#使用命令
lsusb
#如果设备处于recovery状态
Bus 001 Device 011: ID 0955:7023 NVidia Corp
请注意，Orin NX进入recovery 模式以后，如果60秒烧写口没有连接PC，会自动进行启动。因此，请确保60秒内连接了PC。
功能介绍#
米文刷机工具，适用于米文系列产品。米文刷机工具，是为了方便进行米文设备的烧写、克隆，小批量生产而提供的工具软件。
其核心功能有：
自动检测使用环境
自动检测最新镜像
内置镜像下载器，无需手动下载镜像
支持批量烧写
支持镜像克隆（但要注意Clone后再烧写需要使用同一bootloader版本）
准备工作#
硬件准备#
烧写主机#
硬件要求：需要将烧写主机与米文设备连接方能烧写镜像。
烧写主机推荐配置如下：
CPU Intel 酷睿系列处理器 , 4个核心，主频 1.7GHz或更高
Memory 8GB或更高
系统要求：
文件系统为EXT4
空余硬盘容量40G 及以上
系统为Ubuntu x64 LTS 20.04、LTS 22.04
米文设备及电源, USB 数据线（带有数据传输功能）#
软件准备#
在主机中下载安装miivii-ftool软件
sudo apt install python3 python2.7
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 05BE38FE8ADA7CD12E3281B52FC7A8453C3B8F24
sudo sh -c 'echo "deb http://upgrade.miivii.com/miiviitools/ mvtools main" > /etc/apt/sources.list.d/miivii-l4t-apt-source.list'
sudo apt update
sudo apt-get install miivii-ftool
开始刷机#
确认设备进入刷机模式#
（参考文档开始的图文操作介绍）
打开刷机软件#
在Ubuntu系统中你可以点击屏幕左下角 “活动”（Activities），显示你的软件页面，可以在上方检索栏搜索miivii-ftool ，发现如下软件
也可以在终端（Ctrl+Alt+T）输入：gtk-launch miivii-ftool 快速打开
点击打开软件 ，输入密码：您的sudo密码（PC主机开机密码）
若您之前已经下载过刷机工具，且有一段时间未更新，请点击右上角的Update更新至最新版本，以便您烧写米文最新的镜像
显示设备选择界面，如图，选择您的设备（注意区分不同内存版本）
在线模式镜像烧写（推荐，如有需要也可进行离线烧写）#
点击“在线模式”复选框，选择Jetpack版本及下载路径（在线模式在将镜像烧写到设备之前，会下载镜像至本地），
并点击下一步，开始下载选择版本当前最新的刷机环境及设备镜像。
这里需要选择下载完成后是否自动开始刷机，选择自动后，下载完成后会自动解压、校验、刷机
下载速度取决于所在环境的网速，一般可达5M/s 。
（由于镜像包较大，在线模式包含了下载压缩包的过程，下载按照一般网速需要30分钟左右）
而开始刷机后通常需要15分钟以上完成，请耐心等待。
刷机成功会出现如下页面：
问题排查#
如果遇到烧写问题，请先按照如下条目进行自检：
检查是否在烧写工具中输入了上位机开机密码
检查是否进入到Recovery模式（绿灯常亮+黄灯慢闪），可以通过lsusb命令鉴定
检查USB线缆质量是否达标，是否只是用于充电的双芯线
检查烧写主机自带的USB接口是否还具有数据传输功能（一般出现在老主机）
检查上位机，是否为X86-64架构台式机，笔记本。（服务器，嵌入式设备，虚拟机等其他设备暂不支持）
检查上位机系统是否为 Ubuntu x64 v20.04、v22.04
检查磁盘格式，烧写主机的磁盘格式推荐为EXT4
检查上位机容量是否足够
镜像和烧写工具存储路径中不能有中文或其他特殊字符
固件烧写问题排查#
现象1：硬件连接正常，但刷机工具无法识别设备#
解决办法：#
检查设备模式
打开电脑终端（如cmd或Linux终端），输入命令查看设备列表：
# 检查是否识别到设备
lsusb | grep -i "Recovery"
未显示设备 → 尝试以下操作进入恢复模式：
断开设备电源，按住特定功能键（如音量+）重新连接USB线；
使用设备原厂螺丝固定接口，避免松动。
验证线缆与接口
检查USB线是否插紧，更换其他线缆测试；
确认使用标准Micro USB或Type-A接口，避免使用特殊转接头。
核对USB设备ID
在终端输入命令查看USB设备ID：
# 显示所有连接的USB设备
lsusb
若设备ID与厂商要求的不符 → 更换线缆或检查设备驱动。
配置电脑网络
断开电脑其他网络，使用网线直连设备；
设置电脑静态IP地址（如192.168.1.100），确保与设备同网段。
验证刷机工具完整性
重新安装刷机工具，确保依赖环境（如Python 2.7/3.x）已正确安装：
sudo apt install python2.7 / python3
现象2：刷机工具提示“环境异常”或“Offline mode”#
解决办法：#
检查目录权限与路径
确认镜像存放目录的路径
无中文或空格（例如改为/home/user/images）；
检查目录所属用户组是否与当前用户一致：
# 查看权限
ls -ld /path/to/images
# 修改所属用户
sudo chown -R user:user /path/to/images
验证镜像文件完整性
检查镜像文件大小是否与官方提供的校验值一致；
重新下载镜像文件，避免文件损坏。
排查依赖环境
输入命令检查Python版本：
python3 --version
# 应为3.6+
若版本不兼容，安装指定版本：
sudo apt install python3.8
处理线缆与端口问题
更换USB端口或线缆，避免供电不足或信号干扰；
若日志提示“Offline mode”，重启刷机工具并重新登录。