Skip to content

Latest commit

 

History

History
152 lines (96 loc) · 6.22 KB

jetson-xavier-nx-devkit-emmc.md

File metadata and controls

152 lines (96 loc) · 6.22 KB
Raw

Instructions for the Jetson Xavier NX Devkit eMMC

These are the flashing instructions for the Jetson Xavier NX Devkit eMMC. For the list of other balena-supported Jetson devices See here.

L4T/balenaOS/jetson-flash compatibility

Use the version of jetson-flash that corresponds to the version of balenaOS that you would like to provision per the table below.

(Each version of jetson-flash uses a specific version of NVIDIA's L4T BSP to properly partition the Jetson's boot media. This BSP version must also match the BSP used in the version of balenaOS you're flashing)

balenaOS version BSP version Jetpack version Use this version of jetson-flash
2.108.9+rev1 or later 32.7.3 4.6.3 You are on the correct version. (v0.5.54 or later)
2.101.1 - 2.108.9 32.7.2 4.6.2 v0.5.53
2.95.15+rev1 - 2.101.0 32.7.1 4.6.1 v0.5.33
2.87.1+rev1 - 2.95.14 32.6.1 4.6 v0.5.23
2.82.11+rev2 - 2.85.2+rev5 32.5.1 4.5.1 v0.5.17
2.67.2+rev1 - 2.82.11+rev1 32.4.4 4.4.1 v0.5.3

Requirements

Jetson Flash requires an x86 Linux-based host (or virtual machine) and has been tested on Ubuntu 22.04 (Focal).

You can either install all the prerequisites listed below or run the provided Docker image (using Docker, not balenaOS) on the host.

non-Docker

Prerequisites:

  • Sudo privileges (required by Tegra Flash and to delete intermediate steps created by the tool in /tmp/${pid_of_process})
  • NodeJS
  • Make sure you have python2 installed and that the python binary points to python2.
  • Dependencies required for the the L4T package, including: lbzip2, e2fsprogs, dosfstools, libxml2-utils, lz4

Installation:

Make sure the prerequesites listed above are installed.

Clone this repository:

$ git clone https://github.com/balena-os/jetson-flash.git

Install Node.js dependencies by issuing the following command in the jetson-flash directory:

$ npm install

Docker

Prerequisites:

  • the Docker image should be run as privileged
  • /dev/bus/usb needs to be bind-mounted for the Tegra BSP tools to communicate with the device

Installation:

Clone this repository:

$ git clone https://github.com/balena-os/jetson-flash.git

How to use

Follow the steps below to flash your Jetson board

Recovery mode

Make sure that the Jetson board is plugged into your host via USB and is in recovery mode before issuing the flashing command.

We only test jetson-flash on the reference NVIDIA carrier board. If your carrier board varies significantly from the Developer Kit you may need to contact the manufacturer for the proper recovery mode steps.

  1. Ensure the device is powered off and the power adapter disconnected.
  2. Place a jumper across the Force Recovery Mode pins. These are pins 9 ("GND") and 10 ("FC REC") of the Button Header (J14).
  3. Connect your host computer to the device's USB Micro-B connector.
  4. Connect the power adapter to the Power Jack [J16].
  5. The device will automatically power on in Force Recovery Mode.

Confirmation

You can confirm your device is running in recovery mode by issuing the command lsusb | grep NVIDIA and examining the output.

You should see something similar to the below, depending on your board:

Bus 003 Device 005: ID 0955:7023 NVIDIA Corp. APX

(The APX is crucial to confirming recovery mode.)

Or

Bus 001 Device 019: ID 0955:7c18 NVIDIA Corp. T186 [TX2 Tegra Parker] recovery mode

Run the tool

For non - Docker, run the tool by specifying the path to the unzipped image (in place of "<balena.img>") and the device type as shown below:

$ ./bin/cmd.js -f <balena.img> -m jetson-xavier-nx-devkit-emmc

For Docker, issue the following commands in the folder that has the Dockerfile to build the container (building may take a while and appear to hang, so be patient.) Create a folder named images in your home directory and place your balena image file there so it's available inside the container.

./build.sh [-m jetson-xavier-nx-devkit-emmc]

You can then enter the container using:

docker container run --rm -it --privileged -v /dev/bus/usb:/dev/bus/usb -v ~/images:/data/images jetson-flash-image /bin/bash

Alternatively, run the provided docker-compose file with docker-compose up and ssh into the container with docker exec -it <container name> /bin/bash

Once in the container, you can run jetson-flash by specifying the balena image in your host's ~/images/ folder (in place of "<balena.img>"):

./bin/cmd.js -f /data/images/<balena.img> -m jetson-xavier-nx-devkit-emmc --accept-license=yes -c /tmp/Linux_for_Tegra

You can alternatively just run the jetson-flash tool in a single command by running the container with this command:

docker container run --rm -it --privileged -v /dev/bus/usb:/dev/bus/usb -v ~/images:/data/images jetson-flash-image ./bin/cmd.js -f /data/images/<balena.img> -m jetson-xavier-nx-devkit-emmc --accept-license=yes -c /tmp/Linux_for_Tegra

It will exit upon completion.

The flashing process may take 5 - 15 minutes or longer during which a lot of log output will appear. If all goes well, you'll see something similar to the following upon completion:

*** The target t186ref has been flashed successfully. ***
Reset the board to boot from internal eMMC.

Support

If you're having any problems, please raise an issue on GitHub or ask a question in our forums and the balena.io team will be happy to help.

License

The project is licensed under the Apache 2.0 license.