These scripts were written before there was official support in the NVIDIA SDK Manager for booting from external storage. The NVIDIA SDK Manager is a tool used to flash and configure the Jetson. Please use the SDK Manager to boot from external storage. To get started: https://developer.nvidia.com/nvidia-sdk-manager
The following is left for historical reasons:
Shell scripts to setup a NVIDIA Jetson AGX Xavier or Jetson Xavier NX Developer Kit to boot from external storage.
Support code for the video and article: Native Boot for Jetson Xaviers
Please read the Issues section below before proceeding
Installs JetPack 4.6, L4T 32.6.1 on the Jetson Developer Kit
With the advent of JetPack 4.6, The NVIDIA Jetson Xavier Developer Kits can now boot directly from external storage. There are four scripts here to help with this process.
The host machine here references a x86 based machine running Ubuntu distribution 16.04 or 18.04. Experimental support for 20.04 is provided. To flash a Jetson Developer Kit using this method, the host machine builds a disk image. The host then flashes the disk image to the Jetson.
Note for the Jetson Xavier NX: Remove the SD card for this process. Also, there is flash memory onboard the Xavier NX module, QSPI-Nor. This script flashes the QSPI memory in addition to the disk image.
Around 34GB of free space is needed on the host for these scripts and Jetson disk image files.
This process will format the external storage attached to the Jetson that you specify. Existing data on that drive will not be recoverable.
On the host machine, follow this sequence:
install_dependencies.sh
- Installs dependencies needed for running the flash scriptsget_jetson_files.sh
- Downloads the Jetson BSP and rootfsflash_jetson_external_storage.sh
- Flash the Jetson (make sure that the Jetson is connected via USB, external storage is attached to the Jetson and that the Jetson is in Force Recovery Mode)
Once the Jetson is flashed, switch to the Jetson. Go through the standard oem-config procedure. On the Jetson, from this repository run the script install_jetson_default_packages.sh
to install the standard JetPack packages. See below for a detailed list of packages that will be installed.
Downloads the Jetson BSP and rootfs for the Xavier Dev Kits. This script must be run on the host machine.
Install dependencies for flashing the Jetson. This script must be run on the host machine.
Flashes the Jetson attached to the host via a USB cable. This script must be run on the host machine. The Jetson must be in Force Recovery Mode. The script prepares external storage attached to the Jetson, either NVMe or USB. Default is NVMe as both the AGX Xavier and Xavier NX Developer Kits have M.2 Key M slots which accept NVMe SSDs. For the Xavier NX, this flashes the QSPI memory on the Jetson module.
Usage: ./flash_jetson_external_storage [OPTIONS]
No option flashes to nvme0n1p1 by default
-s | --storage - Specific storage media to flash; sda1 or nvme0n1p1
-h | --help - displays this message
Once the script flash_jetson_external_storage script completes, the Jetson is ready for setup. First, configure the Jetson through the standard oem-config process. Then you are ready to install the default JetPack packages using this script. You will need to either download the script or clone this repository on the Jetson itself. The Jetson must be connected to the Internet.
Executing the script will install the metapackage nvida-jetpack which in turn installs the following metapackages:
- nvidia-cuda
- nvidia-cudnn8
- nvidia-tensorrt
- nvidia-visionworks
- nvidia-vpi
- nvidia-l4t-jetson-multimedia-api
- nvidia-opencv
The script installs other packages, to match the default SD Card installation. These include:
- libtbb-dev
- uff-converter-tf
- python3-vpi1
- python3-libnvinfer-dev
- Various Python2.7 support files
- Currently this works for NVMe storage; USB is exhibiting issues on the Xavier NX
- The Jetson AGX Xavier can be flashed using this method. However there appears to be an issue with oem-config running on first boot.
If oem-config does not run on first boot, you can create a default user:
sudo ./tools/l4t_create_default_user.sh -u ubuntu -p ubuntu # this command create username ubuntu and password ubuntu
on the host in the Linux_for_Tegra folder and reflash.
- Initial Release
- JetPack 4.6
- L4T 32.6.1
- Tested on Xavier NX, NVMe SSD
- Initial Host Ubuntu 20.04 support;
- Thank you Ran @ranrubin for initial Ubuntu 20.04 support.
- Thank you Richard @RchGrav for pointing out the AGX typo in the flash script.
- Thank you Jack @jasilberman and Sergey @sskorol for pointing out a Python issue on Ubuntu 20.04
- Thank you Linh @anhmiuhv for guidance on issues encountered
- Thank you @diamandbarcode for testing