Jetson Orin Nano离线烧写踩坑实录：从‘sudo fdisk -l’到成功启动的完整排错手册

Jetson Orin Nano离线烧写排错实战：从设备识别到系统配置的完整指南

当你第一次拿到Jetson Orin Nano模块时，那种兴奋感我至今记忆犹新。但随之而来的烧写系统过程，却让不少开发者踩了不少坑。特别是离线烧写这种方式，虽然官方文档提供了基本流程，但实际操作中总会遇到各种"意外状况"。本文将带你走过我亲自踩过的那些坑，分享如何从存储设备识别到最终系统配置的完整解决方案。

1. 存储设备连接与识别问题

"为什么我的NVMe硬盘盒连接后什么都看不到？"这是大多数人在第一步就会遇到的困惑。记得我第一次尝试时，信心满满地插上硬盘盒，输入lsblk命令后却只看到主机自带的存储设备，那种挫败感至今难忘。

1.1 设备未显示的常见原因

经过多次测试，我发现NVMe硬盘盒不被识别通常有以下几个原因：

• 供电不足：特别是使用USB-A接口时，电流可能无法满足NVMe硬盘需求
• 硬盘盒兼容性问题：某些廉价硬盘盒主控芯片与Linux驱动不兼容
• USB控制器限制：老旧主机可能不支持USB3.0协议

验证步骤：

# 查看USB设备连接状态 lsusb # 查看内核日志中的存储设备信息 dmesg | grep -i nvme

如果lsusb能看到硬盘盒但dmesg没有NVMe相关日志，很可能是供电或兼容性问题。

1.2 解决方案与替代方案

我测试过三种可行的解决方案：

1. 更换供电方式：

   • 使用带外接电源的USB Hub
   • 直接连接到主机的USB3.0 Type-C接口

2. 更换硬盘盒品牌：

   • 推荐使用ASMedia或Realtek主控的硬盘盒
   • 避免使用JMicron主控的低价产品

3. 替代方案：

   • 使用SATA SSD+USB转接盒（兼容性更好但速度较慢）
   • 通过M.2转USB适配器直接连接（需主机有足够供电）

提示：在购买NVMe硬盘盒前，建议查阅Linux硬件兼容性列表。我个人的经验是，ORICO的透明款硬盘盒在多种主机上表现稳定。

2. 存储分区与格式化陷阱

好不容易识别到设备后，下一步就是准备存储空间。这里最常见的错误是直接使用fdisk进行分区，却忽略了Orin Nano的特殊要求。

2.1 分区表类型选择

Jetson Orin Nano对分区表有特定要求：

正确操作流程：

# 确保设备未挂载 sudo umount /dev/sdX* # 创建GPT分区表 sudo parted /dev/sdX mklabel gpt # 创建单个分区占用全部空间 sudo parted -a opt /dev/sdX mkpart primary ext4 0% 100% # 格式化分区 sudo mkfs.ext4 -L jetson-root /dev/sdX1

2.2 常见错误处理

错误现象：mkfs.ext4执行时报错"Device or resource busy"

原因分析：系统可能自动挂载了新创建的分区

解决方案：

# 查看哪些进程占用了设备 sudo lsof /dev/sdX1 # 终止占用进程 sudo kill -9 <PID> # 或者直接卸载 sudo umount /dev/sdX1

错误现象：烧写过程中提示"Invalid partition table"

原因分析：可能使用了MBR分区表或分区未对齐

解决方案：

# 完全擦除磁盘前512字节 sudo dd if=/dev/zero of=/dev/sdX bs=512 count=1 # 重新创建GPT分区表 sudo parted /dev/sdX mklabel gpt

3. 离线烧写命令详解与排错

到了最关键的烧写步骤，官方文档提供的命令看起来简单，但实际执行时总会遇到各种报错。下面是我整理的最常见问题及解决方案。

3.1 基础烧写命令解析

标准离线烧写命令包含多个关键参数：

sudo BOARDID=3767 BOARDSKU=0003 ./tools/kernel_flash/l4t_initrd_flash.sh \ -c tools/kernel_flash/flash_l4t_external.xml \ --external-device sda1 \ --direct sdb \ jetson-orin-nano-devkit \ external

参数说明表：

3.2 典型错误与解决方案

错误1："ERROR: cannot find configuration file"

解决方案：

# 确保在正确目录执行 cd ~/O100/O100_JetPack_5.1.1_Linux_JETSON_ORIN_NANO_TARGETS/Linux_for_Tegra # 检查文件是否存在 ls -l tools/kernel_flash/flash_l4t_external.xml

错误2："Failed to execute nvflash"

原因分析：可能是权限问题或依赖缺失

解决方案：

# 安装缺失依赖 sudo apt install libxml2-utils # 添加当前用户到dialout组 sudo usermod -a -G dialout $USER # 重新登录使组变更生效

错误3：烧写过程卡在某个百分比

可能原因：

• USB连接不稳定
• 存储设备有坏块
• 主机资源不足

排查步骤：

1. 检查dmesg输出是否有I/O错误
2. 尝试更换USB接口或线缆
3. 使用badblocks检查存储设备

4. 首次启动与系统配置问题

成功烧写后，将存储设备安装到Orin Nano模块上首次启动时，又会遇到一系列新问题。最常见的就是卡在oem-config界面或无法完成初始化。

4.1 绕过oem-config的两种方法

有时我们可能需要跳过初始配置界面，特别是在批量部署时。

方法1：预创建配置文件

在烧写前准备oem-config.conf文件：

[oem-config] skip=true username=jetson password=jetson hostname=jetson-orin

然后将文件放入存储设备的/var/lib/oem-config/目录。

方法2：内核参数修改

在U-Boot启动时添加参数：

setenv extra_bootargs "oem-config/enable=false" saveenv boot

4.2 常见启动问题处理

问题1：卡在"Ubuntu setup"界面无法继续

解决方案：

1. 确保使用英文界面（中文输入法可能导致问题）
2. 连接有线网络（某些WiFi驱动需要额外配置）
3. 尝试使用外接显示器（某些情况下内置显示输出有问题）

问题2：首次登录后桌面环境异常

典型表现：

• 任务栏消失
• 壁纸显示异常
• 无法启动终端

解决方案：

# 重置GNOME配置 dconf reset -f /org/gnome/ # 重新安装桌面环境 sudo apt install --reinstall ubuntu-desktop

5. 性能优化与后续配置

系统正常运行后，还需要进行一些优化配置才能发挥Orin Nano的全部性能。这部分常被忽略，但却直接影响使用体验。

5.1 必须进行的性能调整

SWAP空间配置：

# 创建4GB的swap文件 sudo fallocate -l 4G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile # 添加到fstab echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

电源管理模式设置：

# 查看当前模式 sudo nvpmodel -q # 设置为最大性能模式 sudo nvpmodel -m 0 sudo jetson_clocks

5.2 推荐安装的开发工具

• CUDA工具包：sudo apt install cuda-toolkit-11-4
• TensorRT示例：sudo apt install tensorrt-samples
• Jetson监控工具：sudo pip3 install jetson-stats

系统监控仪表板安装：

# 安装Jtop sudo -H pip install -U jetson-stats # 启动监控 sudo jtop

6. 高级技巧与经验分享

经过多次实践，我总结出一些文档中没有提到的实用技巧，能大幅提升工作效率。

6.1 快速烧写技巧

并行烧写多个设备：

# 为每个设备创建烧写脚本 for dev in /dev/sd{b..d}; do cat > flash_${dev##*/}.sh <<EOF #!/bin/bash sudo BOARDID=3767 BOARDSKU=0003 ./l4t_initrd_flash.sh \\ -c flash_l4t_external.xml \\ --external-device ${dev##*/}1 \\ --direct ${dev##*/} \\ jetson-orin-nano-devkit \\ external EOF chmod +x flash_${dev##*/}.sh done # 使用parallel并行执行 parallel -j 3 ./flash_{}.sh ::: sdb sdc sdd

烧写进度监控：

# 在另一个终端窗口执行 watch -n 1 'sudo pkill -USR1 nvflash 2>/dev/null; sudo tail -n 20 /var/log/syslog | grep -i nvflash'

6.2 自定义镜像制作

创建最小化镜像：

# 挂载原始镜像 sudo mount /dev/sdX1 /mnt # 创建精简副本 sudo mkdir /opt/jetson-image sudo rsync -aAXv /mnt/ /opt/jetson-image/ # 清理不需要的文件 sudo rm -rf /opt/jetson-image/var/cache/apt/archives/* sudo rm -rf /opt/jetson-image/usr/src/*

制作可烧写的镜像文件：

# 计算所需空间 size=$(sudo du -s /opt/jetson-image | awk '{print $1}') # 创建空镜像文件 dd if=/dev/zero of=jetson-custom.img bs=1K count=$((size + 102400)) # 格式化并复制内容 mkfs.ext4 -F jetson-custom.img sudo mount -o loop jetson-custom.img /media/image sudo cp -a /opt/jetson-image/* /media/image/ sudo umount /media/image