1. 项目概述为什么Jetson AGX Xavier的驱动安装是个“技术活”如果你刚拿到这块沉甸甸的Jetson AGX Xavier H01套件准备大展拳脚那么第一道坎很可能就是驱动安装。这可不是给普通电脑装个显卡驱动那么简单。Jetson平台是一个高度集成的嵌入式AI计算平台它的软件栈特别是驱动是连接其强大硬件如GPU、NVDLA、VPI等AI加速器与上层应用如你的深度学习模型、计算机视觉程序的桥梁。驱动安装不成功或者版本不匹配这块昂贵的开发板在你手里可能就只是一块“高级砖头”。我接触过不少从x86平台转向Jetson的开发者包括我自己初期也踩过不少坑。最常见的问题就是按照官方文档一步步走却在某个环节卡住比如刷机后无法启动、摄像头无法识别、或者CUDA跑不起来。其根本原因往往在于对Jetson软件生态的“特殊性”理解不足。Jetson采用的不是我们熟悉的Ubuntu桌面版独立显卡驱动的模式而是一套名为“JetPack SDK”的捆绑式解决方案。驱动并非独立安装而是作为系统镜像Image的一部分通过刷机Flashing过程被整体写入设备的eMMC存储中。因此所谓的“驱动安装”在Jetson语境下核心是“准备正确的系统镜像并成功刷机”其次才是刷机后针对特定外设如某些USB摄像头、特定型号的网卡安装额外的内核模块。所以当你搜索“Jetson Xavier AGX H01 套件驱动安装”时你真正需要的是一个从零开始涵盖环境准备、镜像下载、刷机操作到后置驱动配置的完整指南。这个过程涉及主机你的电脑环境、目标板Jetson、连接方式以及版本选择任何一个环节的疏漏都可能导致失败。接下来我将结合多次实战经验为你拆解这个过程中的每一个关键步骤、常见陷阱以及排查技巧让你能一次搞定把时间花在更有价值的AI应用开发上。2. 核心概念与准备工作理解JetPack与L4T在动手之前我们必须先理清两个核心概念JetPack和L4T。这是理解整个安装流程的基础。JetPack SDK是NVIDIA为Jetson系列开发者套件提供的一站式软件解决方案。你可以把它想象成一个“大礼包”里面包含了Jetson设备运行所需的所有核心软件组件。它的主要组成部分包括L4T (Linux for Tegra) 这是基础是基于Ubuntu的定制操作系统包含了Linux内核、驱动、文件系统。驱动就在这里。CUDA Toolkit 用于GPU通用计算的核心库。cuDNN 深度神经网络加速库。TensorRT 用于高性能深度学习推理的SDK。VisionWorks, VPI等 计算机视觉和图像处理库。各种示例、文档和支持工具。而我们安装“驱动”的核心其实就是部署特定版本的L4T。对于AGX Xavier H01套件你需要确认其模块版本。H01通常对应的是32GB eMMC版本的AGX Xavier模组。在下载镜像时这一点至关重要。准备工作清单 在开始刷机前请确保你已准备好以下所有项目我将解释每一项的必要性一台x86_64架构的Linux主机强烈推荐Ubuntu 20.04或22.04 LTS 刷机工具jetson-disk-image-creator和BSP包需要在Linux环境下运行。Windows和macOS无法直接进行。虚拟机有时会因USB控制器穿透问题导致连接不稳定因此物理机安装的Linux是首选。我个人的主力机是Ubuntu 22.04兼容性很好。Jetson AGX Xavier开发套件 确保设备完好并准备好电源适配器。Micro-USB数据线 这是连接主机和Jetson设备进入强制恢复模式Force Recovery Mode的关键线缆。务必使用一条质量可靠、能传输数据的线很多充电线只有电源线没有数据线会导致电脑无法识别设备。主机上有足够的磁盘空间至少50GB 下载的镜像包、解压后的文件以及刷机过程产生的缓存会占用大量空间。稳定的网络连接 用于下载JetPack SDK和可能的更新包。一个空闲的USB端口 用于连接Micro-USB线。注意 在主机上你需要拥有sudo权限来执行安装命令。同时建议在开始前更新主机系统sudo apt update sudo apt upgrade -y。3. 实操流程详解从下载到刷机成功这是整个过程中最核心的部分我们将分步进行。请严格按照顺序操作并注意观察每一步的输出信息。3.1 步骤一在主机上安装SDK管理器NVIDIA提供了图形化的SDK Manager工具它极大地简化了版本选择和下载安装流程尤其适合新手。当然你也可以选择手动下载BSP包和根文件系统进行刷机但SDK Manager是官方推荐且更可靠的方式。访问NVIDIA官方网站在开发者板块找到Jetson下载页面下载适用于你主机Linux版本的SDK Manager.deb安装包。安装SDK Manager# 假设下载的文件是 sdkmanager_2.0.0-10884_amd64.deb sudo apt install ./sdkmanager_2.0.0-10884_amd64.deb安装过程中可能会提示安装一些依赖包如Java运行时环境按照提示同意安装即可。启动SDK Managersdkmanager首次启动会要求你用NVIDIA开发者账号登录。如果没有需要注册一个这是免费的。3.2 步骤二选择目标硬件与软件版本启动SDK Manager后你会看到图形界面。STEP 01: Select Target Hardware在Product Category中选择Jetson。在Target Hardware中选择Jetson AGX Xavier注意这里通常只有一个选项它兼容H01等子型号。在Target Operating System中选择你想要的JetPack版本。例如JetPack 5.1.2 (rev.3)。这里有个关键点请选择LTS长期支持版本如JetPack 5.x系列而不是最新的非LTS版本以获得更好的稳定性和社区支持。对于生产环境JetPack 4.6.3也是一个非常稳定的选择但CUDA等组件版本较旧。Host Machine保持默认你的Ubuntu主机。STEP 02: Select Target Operating System上一步选完后这里会自动勾选对应的Jetson Linux (L4T)版本。下方会列出该版本包含的所有组件如CUDA, cuDNN, TensorRT, VisionWorks等。重要 在Additional SDKs部分你可以勾选Jetson OS和Jetson SDK Components下的所有组件或者至少勾选你确定需要的。我通常建议全部勾选一次性安装完整避免后续麻烦。这会下载一个完整的系统镜像。同意许可条款然后点击右下角的CONTINUE。3.3 步骤三下载与安装配置进入下一个界面。下载路径 保持默认或选择一个空间充足的目录。SDK Manager会开始下载你选择的JetPack版本的所有组件。这是一个较大的文件约10GB下载时间取决于你的网速。安装配置Installation options 选择“Manual setup - Flash and install components manually”。这给了我们更多的控制权。Target device connection 选择“Manual - Connect device via recovery mode”。我们将手动让设备进入恢复模式。Log path 保持默认。点击CONTINUESDK Manager会开始验证和下载文件。请耐心等待直到所有组件旁边都出现绿色对勾。3.4 步骤四连接设备并进入强制恢复模式这是硬件操作的关键一步顺序不能错。确保Jetson AGX Xavier处于关机状态拔掉电源线。用Micro-USB线连接Jetson的Micro-USB口位于IO板上的USB Type-C口旁边有一个小图标和你的Linux主机。让设备进入强制恢复模式先按住Jetson板上的FORCE RECOVERY按钮一个很小的孔通常需要卡针或笔尖按压。保持按住不放然后插入电源线给设备上电。继续按住FORCE RECOVERY按钮大约2秒钟然后松开。在主机上验证设备是否被识别 打开终端输入lsusb在输出列表中你应该能看到一行包含NVIDIA Corp.字样的设备例如Bus 001 Device 006: ID 0955:7e19 NVIDIA Corp.。其中的0955:7e19就是Jetson设备在恢复模式下的USB ID。看到这个说明设备已被主机正确识别可以进入下一步。实操心得 很多人在这一步失败原因有三一是Micro-USB线不行换条线试试二是按FORCE RECOVERY键和上电的顺序或时长不对务必“先按住再上电保持2秒再松开”三是主机USB端口问题换个端口试试。lsusb命令是你的最佳诊断工具。3.5 步骤五执行刷机与组件安装设备进入恢复模式并被识别后回到SDK Manager界面。点击FLASH按钮。SDK Manager会开始将下载好的L4T系统镜像刷写到Jetson设备的eMMC存储中。这个过程会持续10到30分钟期间终端会有大量日志输出。千万不要中断这个过程拔线、断电、关闭窗口。你会看到进度条在前进。刷写Flash完成后设备会自动重启。此时SDK Manager界面会进入下一步提示你设置Jetson设备的用户名、密码、主机名等。按照提示输入即可。这个信息会被注入到即将启动的Jetson系统中。设置完成后SDK Manager会开始通过网络此时依赖Jetson设备启动后获得的IP地址安装你在第二步中选择的额外SDK组件CUDA, TensorRT等。确保你的主机和Jetson设备在同一个局域网内。Jetson首次启动会连接网络通过以太网或Wi-Fi建议首次使用有线以太网更稳定。等待所有组件安装完成直到出现“Installation finished successfully”的提示。至此核心的“驱动安装”即系统刷机已经完成。你的Jetson AGX Xavier已经拥有了一个完整的、包含所有必要驱动和基础AI栈的操作系统。4. 首次启动与基础验证刷机完成后Jetson设备会再次重启进入全新的系统。连接显示器和键鼠 通过HDMI或DP口连接显示器并接入USB键鼠。你将看到Ubuntu的登录界面。登录系统 使用你在SDK Manager中设置的用户名和密码登录。打开终端进行基础验证检查系统版本cat /etc/nv_tegra_release这会输出L4T的版本号应与你选择的JetPack版本中的L4T版本一致。检查GPU驱动与CUDAnvidia-smi这个命令应该能正常显示Jetson Xavier的GPU状态、驱动版本和CUDA版本。如果显示“Command ‘nvidia-smi’ not found”说明CUDA安装可能有问题需要回溯检查安装日志。nvcc --version检查CUDA编译器版本。检查TensorRTdpkg -l | grep tensorrt可以看到已安装的TensorRT相关包及其版本。5. 常见外设驱动与内核模块安装系统基础驱动已经就绪但如果你连接了某些特殊外设可能需要额外安装内核模块。5.1 USB摄像头驱动对于大多数UVCUSB Video Class兼容的摄像头如罗技C920Linux内核已经内置了驱动插上即用。可以使用cheese或guvcview测试。sudo apt install guvcview guvcview如果摄像头不被识别可能需要检查是否是UVC设备lsusb -v | grep -i uvc对于非UVC摄像头如某些工业相机你需要从厂商官网下载并编译对应的Linux驱动通常是.deb包或源码。5.2 无线网卡驱动如果使用非内置型号Jetson AGX Xavier载板通常已集成了有线网卡和Wi-Fi/蓝牙模块如Intel 8265。其驱动已包含在L4T内核中。如果你使用了USB无线网卡如某些Realtek芯片的可能需要手动安装驱动。确认网卡芯片型号lsusb查看设备ID。搜索驱动 对于Realtek 88x2bu芯片常见于某些USB 3.0 WiFi网卡可以尝试从GitHub等开源仓库获取驱动源码进行编译。sudo apt update sudo apt install git build-essential dkms git clone https://github.com/cilynx/rtl88x2bu.git cd rtl88x2bu # 根据仓库的README说明进行编译和安装通常流程是 sudo make sudo make install sudo modprobe 88x2bu编译内核模块的通用前提 确保已安装当前L4T版本对应的内核头文件。sudo apt install linux-headers-$(uname -r)5.3 CSI摄像头驱动如果你使用Jetson官方或兼容的CSI摄像头如Raspberry Pi Camera Module V2驱动也已集成。你需要使用nvgstcapture-1.0工具或GStreamer管道来测试。# 预览摄像头画面 nvgstcapture-1.0如果无法工作检查连接是否牢固并确认摄像头型号是否被支持。6. 深度问题排查与实战技巧即使按照指南操作也可能会遇到问题。这里记录了几个我亲身经历或高频被问到的难题及解决方案。6.1 刷机失败SDK Manager卡在“Flashing...”或报错现象 进度条长时间不动或提示“Command ‘xxxxxxxx’ failed”。排查检查USB连接 再次执行lsusb确认NVIDIA Corp.设备依然存在。如果消失了可能是线缆或接触问题需要重新进入恢复模式。查看详细日志 SDK Manager有日志窗口点击“View logs”查看具体错误信息。常见的错误是权限问题或依赖缺失。尝试手动刷机 如果SDK Manager始终失败可以退而求其次使用NVIDIA提供的命令行工具手动刷机。这需要你从NVIDIA开发者网站手动下载对应版本的BSPBoard Support Package释放包和根文件系统然后使用flash.sh脚本。这个过程更复杂但可控性更强也是解决疑难杂症的终极手段。具体步骤需要参考官方文档的“Flashing Support”部分。主机环境问题 确保主机是纯净的Ubuntu没有奇怪的软件冲突。我曾遇到过因为主机安装了旧版本libxml2导致刷机工具解析XML配置文件失败的情况。6.2 刷机成功但无法启动卡在开机Logo现象 设备通电后屏幕显示NVIDIA或Jetson Logo然后一直停留在此。排查连接串口控制台 这是嵌入式开发最强大的调试手段。Jetson AGX Xavier载板上有一个串口调试头通常是J17标注为UART。你需要一个USB转TTL串口模块如FT232RL连接该接口到主机。在主机上使用minicom或screen工具连接对应的串口如/dev/ttyUSB0波特率设置为115200。这样你就能看到内核启动的完整日志错误信息会直接打印出来例如文件系统损坏、设备树Device Tree加载失败等。镜像文件损坏 重新下载JetPack镜像并验证MD5或SHA256校验和。硬件问题 在极少数情况下可能是eMMC存储损坏。尝试刷写其他版本的JetPack如更旧的LTS版本测试。6.3nvidia-smi命令找不到或报错现象Command ‘nvidia-smi’ not found或NVIDIA-SMI has failed because it couldn‘t communicate with the NVIDIA driver。排查检查驱动是否加载lsmod | grep nvidia。如果没有输出说明NVIDIA内核模块没有加载。检查安装日志 回顾SDK Manager安装CUDA组件的日志看是否有错误。手动安装CUDA Toolkit 有时SDK Manager的网络安装会失败。你可以登录Jetson设备从NVIDIA官网下载对应架构aarch64的CUDA Toolkit runfile文件进行手动安装。但务必选择与JetPack版本匹配的CUDA版本。内核版本不匹配 如果你在刷机后自行升级了系统内核sudo apt upgrade可能导致可能会造成内核与NVIDIA驱动模块不兼容。强烈建议不要随意升级Jetson的Linux内核。如果已经升级可能需要重新刷机或寻找对应新内核的驱动包。6.4 性能调优与持久化配置驱动安装好只是开始要让Jetson发挥最大效能还需要进行一些配置。设置高性能模式 Jetson Xavier有多个功耗模式nvpmodel默认可能是中等功耗。# 查看当前模式 sudo nvpmodel -q # 设置为MAX-N模式最高性能风扇全速 sudo nvpmodel -m 0 # 设置风扇速度如果需要 sudo jetson_clocksjetson_clocks脚本会将CPU/GPU时钟锁定在最高频率并启用风扇。在持续高负载推理时使用。交换空间Swap 32GB的eMMC在安装大量库后可能空间紧张且内存16GB在运行大模型时也可能不足。添加交换文件可以缓解。sudo fallocate -l 8G /swapfile # 创建8GB交换文件 sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile # 为了永久生效将以下行添加到 /etc/fstab # /swapfile swap swap defaults 0 0Docker支持 如果你想使用容器需要安装NVIDIA Container Toolkit。# 设置仓库和安装 distribution$(. /etc/os-release;echo $ID$VERSION_ID) curl -s -L https://nvidia.github.io/nvidia-docker/gpgkey | sudo apt-key add - curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.list | sudo tee /etc/apt/sources.list.d/nvidia-docker.list sudo apt update sudo apt install -y nvidia-docker2 sudo systemctl restart docker # 测试 sudo docker run --rm --gpus all nvidia/cuda:11.4.0-base nvidia-smi驱动安装和基础配置是Jetson开发的基石虽然过程略显繁琐但一旦搭建好稳定可靠的环境后续的应用开发、模型部署就会顺畅得多。记住lsusb、串口日志、dmesg和SDK Manager的安装日志是你最好的朋友。遇到问题时多查官方论坛和GitHub Issues很多坑都已经有人踩过并提供了解决方案。
1. 项目概述为什么Jetson AGX Xavier的驱动安装是个“技术活”如果你刚拿到这块沉甸甸的Jetson AGX Xavier H01套件准备大展拳脚那么第一道坎很可能就是驱动安装。这可不是给普通电脑装个显卡驱动那么简单。Jetson平台是一个高度集成的嵌入式AI计算平台它的软件栈特别是驱动是连接其强大硬件如GPU、NVDLA、VPI等AI加速器与上层应用如你的深度学习模型、计算机视觉程序的桥梁。驱动安装不成功或者版本不匹配这块昂贵的开发板在你手里可能就只是一块“高级砖头”。我接触过不少从x86平台转向Jetson的开发者包括我自己初期也踩过不少坑。最常见的问题就是按照官方文档一步步走却在某个环节卡住比如刷机后无法启动、摄像头无法识别、或者CUDA跑不起来。其根本原因往往在于对Jetson软件生态的“特殊性”理解不足。Jetson采用的不是我们熟悉的Ubuntu桌面版独立显卡驱动的模式而是一套名为“JetPack SDK”的捆绑式解决方案。驱动并非独立安装而是作为系统镜像Image的一部分通过刷机Flashing过程被整体写入设备的eMMC存储中。因此所谓的“驱动安装”在Jetson语境下核心是“准备正确的系统镜像并成功刷机”其次才是刷机后针对特定外设如某些USB摄像头、特定型号的网卡安装额外的内核模块。所以当你搜索“Jetson Xavier AGX H01 套件驱动安装”时你真正需要的是一个从零开始涵盖环境准备、镜像下载、刷机操作到后置驱动配置的完整指南。这个过程涉及主机你的电脑环境、目标板Jetson、连接方式以及版本选择任何一个环节的疏漏都可能导致失败。接下来我将结合多次实战经验为你拆解这个过程中的每一个关键步骤、常见陷阱以及排查技巧让你能一次搞定把时间花在更有价值的AI应用开发上。2. 核心概念与准备工作理解JetPack与L4T在动手之前我们必须先理清两个核心概念JetPack和L4T。这是理解整个安装流程的基础。JetPack SDK是NVIDIA为Jetson系列开发者套件提供的一站式软件解决方案。你可以把它想象成一个“大礼包”里面包含了Jetson设备运行所需的所有核心软件组件。它的主要组成部分包括L4T (Linux for Tegra) 这是基础是基于Ubuntu的定制操作系统包含了Linux内核、驱动、文件系统。驱动就在这里。CUDA Toolkit 用于GPU通用计算的核心库。cuDNN 深度神经网络加速库。TensorRT 用于高性能深度学习推理的SDK。VisionWorks, VPI等 计算机视觉和图像处理库。各种示例、文档和支持工具。而我们安装“驱动”的核心其实就是部署特定版本的L4T。对于AGX Xavier H01套件你需要确认其模块版本。H01通常对应的是32GB eMMC版本的AGX Xavier模组。在下载镜像时这一点至关重要。准备工作清单 在开始刷机前请确保你已准备好以下所有项目我将解释每一项的必要性一台x86_64架构的Linux主机强烈推荐Ubuntu 20.04或22.04 LTS 刷机工具jetson-disk-image-creator和BSP包需要在Linux环境下运行。Windows和macOS无法直接进行。虚拟机有时会因USB控制器穿透问题导致连接不稳定因此物理机安装的Linux是首选。我个人的主力机是Ubuntu 22.04兼容性很好。Jetson AGX Xavier开发套件 确保设备完好并准备好电源适配器。Micro-USB数据线 这是连接主机和Jetson设备进入强制恢复模式Force Recovery Mode的关键线缆。务必使用一条质量可靠、能传输数据的线很多充电线只有电源线没有数据线会导致电脑无法识别设备。主机上有足够的磁盘空间至少50GB 下载的镜像包、解压后的文件以及刷机过程产生的缓存会占用大量空间。稳定的网络连接 用于下载JetPack SDK和可能的更新包。一个空闲的USB端口 用于连接Micro-USB线。注意 在主机上你需要拥有sudo权限来执行安装命令。同时建议在开始前更新主机系统sudo apt update sudo apt upgrade -y。3. 实操流程详解从下载到刷机成功这是整个过程中最核心的部分我们将分步进行。请严格按照顺序操作并注意观察每一步的输出信息。3.1 步骤一在主机上安装SDK管理器NVIDIA提供了图形化的SDK Manager工具它极大地简化了版本选择和下载安装流程尤其适合新手。当然你也可以选择手动下载BSP包和根文件系统进行刷机但SDK Manager是官方推荐且更可靠的方式。访问NVIDIA官方网站在开发者板块找到Jetson下载页面下载适用于你主机Linux版本的SDK Manager.deb安装包。安装SDK Manager# 假设下载的文件是 sdkmanager_2.0.0-10884_amd64.deb sudo apt install ./sdkmanager_2.0.0-10884_amd64.deb安装过程中可能会提示安装一些依赖包如Java运行时环境按照提示同意安装即可。启动SDK Managersdkmanager首次启动会要求你用NVIDIA开发者账号登录。如果没有需要注册一个这是免费的。3.2 步骤二选择目标硬件与软件版本启动SDK Manager后你会看到图形界面。STEP 01: Select Target Hardware在Product Category中选择Jetson。在Target Hardware中选择Jetson AGX Xavier注意这里通常只有一个选项它兼容H01等子型号。在Target Operating System中选择你想要的JetPack版本。例如JetPack 5.1.2 (rev.3)。这里有个关键点请选择LTS长期支持版本如JetPack 5.x系列而不是最新的非LTS版本以获得更好的稳定性和社区支持。对于生产环境JetPack 4.6.3也是一个非常稳定的选择但CUDA等组件版本较旧。Host Machine保持默认你的Ubuntu主机。STEP 02: Select Target Operating System上一步选完后这里会自动勾选对应的Jetson Linux (L4T)版本。下方会列出该版本包含的所有组件如CUDA, cuDNN, TensorRT, VisionWorks等。重要 在Additional SDKs部分你可以勾选Jetson OS和Jetson SDK Components下的所有组件或者至少勾选你确定需要的。我通常建议全部勾选一次性安装完整避免后续麻烦。这会下载一个完整的系统镜像。同意许可条款然后点击右下角的CONTINUE。3.3 步骤三下载与安装配置进入下一个界面。下载路径 保持默认或选择一个空间充足的目录。SDK Manager会开始下载你选择的JetPack版本的所有组件。这是一个较大的文件约10GB下载时间取决于你的网速。安装配置Installation options 选择“Manual setup - Flash and install components manually”。这给了我们更多的控制权。Target device connection 选择“Manual - Connect device via recovery mode”。我们将手动让设备进入恢复模式。Log path 保持默认。点击CONTINUESDK Manager会开始验证和下载文件。请耐心等待直到所有组件旁边都出现绿色对勾。3.4 步骤四连接设备并进入强制恢复模式这是硬件操作的关键一步顺序不能错。确保Jetson AGX Xavier处于关机状态拔掉电源线。用Micro-USB线连接Jetson的Micro-USB口位于IO板上的USB Type-C口旁边有一个小图标和你的Linux主机。让设备进入强制恢复模式先按住Jetson板上的FORCE RECOVERY按钮一个很小的孔通常需要卡针或笔尖按压。保持按住不放然后插入电源线给设备上电。继续按住FORCE RECOVERY按钮大约2秒钟然后松开。在主机上验证设备是否被识别 打开终端输入lsusb在输出列表中你应该能看到一行包含NVIDIA Corp.字样的设备例如Bus 001 Device 006: ID 0955:7e19 NVIDIA Corp.。其中的0955:7e19就是Jetson设备在恢复模式下的USB ID。看到这个说明设备已被主机正确识别可以进入下一步。实操心得 很多人在这一步失败原因有三一是Micro-USB线不行换条线试试二是按FORCE RECOVERY键和上电的顺序或时长不对务必“先按住再上电保持2秒再松开”三是主机USB端口问题换个端口试试。lsusb命令是你的最佳诊断工具。3.5 步骤五执行刷机与组件安装设备进入恢复模式并被识别后回到SDK Manager界面。点击FLASH按钮。SDK Manager会开始将下载好的L4T系统镜像刷写到Jetson设备的eMMC存储中。这个过程会持续10到30分钟期间终端会有大量日志输出。千万不要中断这个过程拔线、断电、关闭窗口。你会看到进度条在前进。刷写Flash完成后设备会自动重启。此时SDK Manager界面会进入下一步提示你设置Jetson设备的用户名、密码、主机名等。按照提示输入即可。这个信息会被注入到即将启动的Jetson系统中。设置完成后SDK Manager会开始通过网络此时依赖Jetson设备启动后获得的IP地址安装你在第二步中选择的额外SDK组件CUDA, TensorRT等。确保你的主机和Jetson设备在同一个局域网内。Jetson首次启动会连接网络通过以太网或Wi-Fi建议首次使用有线以太网更稳定。等待所有组件安装完成直到出现“Installation finished successfully”的提示。至此核心的“驱动安装”即系统刷机已经完成。你的Jetson AGX Xavier已经拥有了一个完整的、包含所有必要驱动和基础AI栈的操作系统。4. 首次启动与基础验证刷机完成后Jetson设备会再次重启进入全新的系统。连接显示器和键鼠 通过HDMI或DP口连接显示器并接入USB键鼠。你将看到Ubuntu的登录界面。登录系统 使用你在SDK Manager中设置的用户名和密码登录。打开终端进行基础验证检查系统版本cat /etc/nv_tegra_release这会输出L4T的版本号应与你选择的JetPack版本中的L4T版本一致。检查GPU驱动与CUDAnvidia-smi这个命令应该能正常显示Jetson Xavier的GPU状态、驱动版本和CUDA版本。如果显示“Command ‘nvidia-smi’ not found”说明CUDA安装可能有问题需要回溯检查安装日志。nvcc --version检查CUDA编译器版本。检查TensorRTdpkg -l | grep tensorrt可以看到已安装的TensorRT相关包及其版本。5. 常见外设驱动与内核模块安装系统基础驱动已经就绪但如果你连接了某些特殊外设可能需要额外安装内核模块。5.1 USB摄像头驱动对于大多数UVCUSB Video Class兼容的摄像头如罗技C920Linux内核已经内置了驱动插上即用。可以使用cheese或guvcview测试。sudo apt install guvcview guvcview如果摄像头不被识别可能需要检查是否是UVC设备lsusb -v | grep -i uvc对于非UVC摄像头如某些工业相机你需要从厂商官网下载并编译对应的Linux驱动通常是.deb包或源码。5.2 无线网卡驱动如果使用非内置型号Jetson AGX Xavier载板通常已集成了有线网卡和Wi-Fi/蓝牙模块如Intel 8265。其驱动已包含在L4T内核中。如果你使用了USB无线网卡如某些Realtek芯片的可能需要手动安装驱动。确认网卡芯片型号lsusb查看设备ID。搜索驱动 对于Realtek 88x2bu芯片常见于某些USB 3.0 WiFi网卡可以尝试从GitHub等开源仓库获取驱动源码进行编译。sudo apt update sudo apt install git build-essential dkms git clone https://github.com/cilynx/rtl88x2bu.git cd rtl88x2bu # 根据仓库的README说明进行编译和安装通常流程是 sudo make sudo make install sudo modprobe 88x2bu编译内核模块的通用前提 确保已安装当前L4T版本对应的内核头文件。sudo apt install linux-headers-$(uname -r)5.3 CSI摄像头驱动如果你使用Jetson官方或兼容的CSI摄像头如Raspberry Pi Camera Module V2驱动也已集成。你需要使用nvgstcapture-1.0工具或GStreamer管道来测试。# 预览摄像头画面 nvgstcapture-1.0如果无法工作检查连接是否牢固并确认摄像头型号是否被支持。6. 深度问题排查与实战技巧即使按照指南操作也可能会遇到问题。这里记录了几个我亲身经历或高频被问到的难题及解决方案。6.1 刷机失败SDK Manager卡在“Flashing...”或报错现象 进度条长时间不动或提示“Command ‘xxxxxxxx’ failed”。排查检查USB连接 再次执行lsusb确认NVIDIA Corp.设备依然存在。如果消失了可能是线缆或接触问题需要重新进入恢复模式。查看详细日志 SDK Manager有日志窗口点击“View logs”查看具体错误信息。常见的错误是权限问题或依赖缺失。尝试手动刷机 如果SDK Manager始终失败可以退而求其次使用NVIDIA提供的命令行工具手动刷机。这需要你从NVIDIA开发者网站手动下载对应版本的BSPBoard Support Package释放包和根文件系统然后使用flash.sh脚本。这个过程更复杂但可控性更强也是解决疑难杂症的终极手段。具体步骤需要参考官方文档的“Flashing Support”部分。主机环境问题 确保主机是纯净的Ubuntu没有奇怪的软件冲突。我曾遇到过因为主机安装了旧版本libxml2导致刷机工具解析XML配置文件失败的情况。6.2 刷机成功但无法启动卡在开机Logo现象 设备通电后屏幕显示NVIDIA或Jetson Logo然后一直停留在此。排查连接串口控制台 这是嵌入式开发最强大的调试手段。Jetson AGX Xavier载板上有一个串口调试头通常是J17标注为UART。你需要一个USB转TTL串口模块如FT232RL连接该接口到主机。在主机上使用minicom或screen工具连接对应的串口如/dev/ttyUSB0波特率设置为115200。这样你就能看到内核启动的完整日志错误信息会直接打印出来例如文件系统损坏、设备树Device Tree加载失败等。镜像文件损坏 重新下载JetPack镜像并验证MD5或SHA256校验和。硬件问题 在极少数情况下可能是eMMC存储损坏。尝试刷写其他版本的JetPack如更旧的LTS版本测试。6.3nvidia-smi命令找不到或报错现象Command ‘nvidia-smi’ not found或NVIDIA-SMI has failed because it couldn‘t communicate with the NVIDIA driver。排查检查驱动是否加载lsmod | grep nvidia。如果没有输出说明NVIDIA内核模块没有加载。检查安装日志 回顾SDK Manager安装CUDA组件的日志看是否有错误。手动安装CUDA Toolkit 有时SDK Manager的网络安装会失败。你可以登录Jetson设备从NVIDIA官网下载对应架构aarch64的CUDA Toolkit runfile文件进行手动安装。但务必选择与JetPack版本匹配的CUDA版本。内核版本不匹配 如果你在刷机后自行升级了系统内核sudo apt upgrade可能导致可能会造成内核与NVIDIA驱动模块不兼容。强烈建议不要随意升级Jetson的Linux内核。如果已经升级可能需要重新刷机或寻找对应新内核的驱动包。6.4 性能调优与持久化配置驱动安装好只是开始要让Jetson发挥最大效能还需要进行一些配置。设置高性能模式 Jetson Xavier有多个功耗模式nvpmodel默认可能是中等功耗。# 查看当前模式 sudo nvpmodel -q # 设置为MAX-N模式最高性能风扇全速 sudo nvpmodel -m 0 # 设置风扇速度如果需要 sudo jetson_clocksjetson_clocks脚本会将CPU/GPU时钟锁定在最高频率并启用风扇。在持续高负载推理时使用。交换空间Swap 32GB的eMMC在安装大量库后可能空间紧张且内存16GB在运行大模型时也可能不足。添加交换文件可以缓解。sudo fallocate -l 8G /swapfile # 创建8GB交换文件 sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile # 为了永久生效将以下行添加到 /etc/fstab # /swapfile swap swap defaults 0 0Docker支持 如果你想使用容器需要安装NVIDIA Container Toolkit。# 设置仓库和安装 distribution$(. /etc/os-release;echo $ID$VERSION_ID) curl -s -L https://nvidia.github.io/nvidia-docker/gpgkey | sudo apt-key add - curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.list | sudo tee /etc/apt/sources.list.d/nvidia-docker.list sudo apt update sudo apt install -y nvidia-docker2 sudo systemctl restart docker # 测试 sudo docker run --rm --gpus all nvidia/cuda:11.4.0-base nvidia-smi驱动安装和基础配置是Jetson开发的基石虽然过程略显繁琐但一旦搭建好稳定可靠的环境后续的应用开发、模型部署就会顺畅得多。记住lsusb、串口日志、dmesg和SDK Manager的安装日志是你最好的朋友。遇到问题时多查官方论坛和GitHub Issues很多坑都已经有人踩过并提供了解决方案。
)
