jetsonhacks / bootFromExternalStorage

Shell scripts to setup a NVIDIA Jetson AGX Xavier, Xavier NX, AGX Orin, or Orin Nano Developer Kit to boot from external storage.
MIT License
144 stars 69 forks source link

bootFromExternalStorage

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. You may prefer to use the SDK Manager instead of these scripts. To get started with SDK Manager: https://developer.nvidia.com/nvidia-sdk-manager

Shell scripts to setup a NVIDIA Jetson Xavier or Orin (AGX, NX, Nano models) to boot from external storage.

Support code for the video and article: Native Boot for Jetson Xaviers

JetPack 4.6+ releases are in the jetpack-4 branch

Please read the Issues section below before proceeding

Installs JetPack 5.1.2, L4T 35.4.1 on the Jetson Developer Kit

The NVIDIA Jetson Xavier and Orins can 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 18.04, 20.04 or 22.04. 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.

Warning for the Jetson Xavier NX and AGX Xavier: There is an issue with the USB stack. You cannot boot from USB on these systems.

Note for the Jetson Xavier NX: For a Jetson AGX Xavier system, the board must be initially flashed to eMMC before using this method.

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.

Note for the Jetson Orin Nano and Orin NX: There is flash memory onboard the Orin modules, QSPI-Nor. This script flashes the QSPI memory in addition to the disk image.

Around 40GB of free space is needed on the host for these scripts and Jetson disk image files. More is better.

WARNING

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:

  1. get_jetson_files.sh - Downloads the Jetson BSP and sample rootfs, copies NVIDA user space libraries to rootfs. Also installs dependencies needed to flash the Jetson.
  2. flash_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.

Scripts

get_jetson_files.sh

Downloads the Jetson BSP and rootfs for the Xavier/Orin Dev Kits. This script must be run on the host machine.

install_dependencies.sh

Install dependencies for flashing the Jetson. This script must be run on the host machine. This is done by get_jetson_files.sh, but is added here as legacy.

flash_jetson_external_storage.sh

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 the Orin and Xaviers have M.2 Key M slots which accept NVMe SSDs. The SSDs must be PCIE, SATA does not work. For the Xavier NX and Orin NX and Orin Nano, 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

install_jetson_default_packages.sh

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:

Issues

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.

Release Notes

September 2023

May 2023

February 2023

August 2021

Thanks!