Reset your ZED Box Orin NX
Should I flash my ZED Box? #
Performing a flash on your ZED Box should only be considered as a last resort, unless you have sufficient knowledge and expertise in the process. The ZED Box is shipped with pre-configured drivers that fulfill its requirements. This procedure is for advanced users that needs specific system configurations, or if you broke your installation.
Upgrade/Reset #
At the time of writing this tutorial, NVIDIA® SDK Manager does not support the automatic flashing of the Orin NX modules. Instead, you have to manually flash the board using NVIDIA’s BSP for the JetPack version you desire to install. The procedure is described here.
Force Recovery mode #
It is not required to open the ZED Box to force it into Recovery mode. Opening the box will void the warranty
Here is the procedure to automatically start the ZED Box in Force Recovery mode:
- power off the device.
- connect a micro USB cable to the host PC performing the upgrade/reset.
- connect the cable to the micro USB port of the device labeled as
OTG
. - power on the device.
If the above procedure does not work and your ZED Box is in working status, you can force the “Recovery Mode” with the command line below.
Please be careful with the syntax of the command.
$ sudo reboot --force forced-recovery
You can verify that the ZED Box correctly started in “Recovery Mode” by entering this command in a command line console of the host PC:
$ lsusb -d '0955:'
- If the model of the ZED Box is ORIN NX 16, then an NVIDIA®device with VID:PID
0955:7323
should be listed. - If the model of the ZED Box is ORIN NX 8, then an NVIDIA®device VID:PID
0955:7324
should be listed.
📌 Note: if an NVIDIA®device with VID:PID
0955:7020
is listed, then your ZED Box is not in Force Recovery mode. You must restart the procedure to boot it in Force Recovery mode.
📌 Note: If you serial number starts with GTW-ONX-, the Linux install is broken and you can’t enter recovery mode this way, please follow the instructions in Entering recovery mode with a live USB flashdrive below.
Flashing the ZED Box Orin NX model #
As of now, NVIDIA® SDK Manager does not support flashing Orin NX modules. You will need to complete the following procedure:
For flashing a Jetpack version <= 5.1.2, use a Ubuntu 18.04 or 20.04 host computer.
For flashing a Jetpack version >= 6.0, use a Ubuntu 20.04 or 22.04 host computer.
Open a terminal console, from an empty folder (beware of any hidden files).
Verify that the ZED Box is in “Force Recovery” mode
Download the flash script for the NVIDIA®Jetpack version you want to install:
Flash the ZED Box by using the following command:
$ BSP_ROOT=./stereolabs_bsp/ ./zedbox_onx_usb_flash_<jp_ver>.sh
- Replace
<jp_ver>
with the Jetpack version, e.g.zedbox_onx_usb_flash_5.1.2.sh
- You need 80GB of free space on your working hard drive, all necessary files will be downloaded in
$BSP_ROOT
. The script will create this folder and will ask you to log asroot
.
- Replace
Wait for the operation to complete. You will see the following output if the flash is successful:
📌 Note: The default credentials of your ZED Box are:
- username:
user
- password:
admin
If you encounter any problems during this procedure, you can contact the support team by sending an email to support@stereolabs.com.
Post-Flash operations #
After flashing your device, follow these steps to install the necessary NVIDIA®and Stereolabs packages to ensure your ZED camera works correctly.
Boot and Login:
- Power on the device and log in with your credentials.
Check the OS Version:
- Follow this support guide to determine the version of the operating system installed on your device.
Connect to the Internet:
- Connect your device to the internet using an Ethernet cable or WiFi.
Open a Terminal:
- Press
Ctrl+Alt+T
to open a terminal window.
- Press
Install NVIDIA®Jetpack Packages:
- Run the following command to install the NVIDIA®Jetpack packages, which include the required Jetson drivers, CUDA, and all necessary NVIDIA®libraries:
sudo apt install nvidia-jetpack
- Run the following command to install the NVIDIA®Jetpack packages, which include the required Jetson drivers, CUDA, and all necessary NVIDIA®libraries:
Download the ZED SDK:
- Visit the Stereolabs website and download the ZED SDK for Jetson that matches your installed Jetpack/L4T version.
Install the ZED SDK:
- Navigate to your Downloads directory and run the installer:
cd ~/Downloads chmod +x ZED_SDK_Tegra_L4T_vx.y.z.zstd.run ./ZED_SDK_Tegra_L4T_vx.y.z.zstd.run
- Navigate to your Downloads directory and run the installer:
Optional: Install ZED Link Drivers (for ZED X or ZED X One Cameras):
- If your device supports GMSL2 and you plan to use the ZED X or ZED X One cameras, download and install the appropriate drivers from the driver web page.
- 📌 Note:
- The ZED Box Orin NX 8 GB with GMSL2 integrates a ZED Link Mono GMSL2 capture card.
- The ZED Box Orin NX 16 GB with GMSL2 integrates a ZED Link Duo GMSL2 capture card.
- 📌 Note:
- If your device supports GMSL2 and you plan to use the ZED X or ZED X One cameras, download and install the appropriate drivers from the driver web page.
Reboot:
- Restart your device to apply all changes:
sudo reboot
- Restart your device to apply all changes:
Enjoy Your Device:
- Your device is now ready for use with the ZED cameras.
Entering recovery mode with a live USB flashdrive (Only ZED Box with S/N GTW-ONX-*) #
⚠️ If your serial number starts with GTW-ONX1- or GTW-ONX2-, do not do this. ⚠️ #
If your Linux install is broken, and you are using a first-gen ZED Box Orin NX, you will not be able to enter recovery mode automatically. This tutorial will help you recover from such a situation. To complete it, you will need an 8GB or larger USB 3.0 disk that will be flashed with JetPack 5.1.1 (L4T35.3).
Be careful, all the information stored in the USB disk will be wiped during the procedure.
Below are the step-by-step instructions to flash your USB disk.
Setting up the USB disk #
- Plug a USB disk to any linux host machine
- Download the flash script for the NVIDIA®Jetpack version you want to install:
- Install the necessary dependencies:
$ sudo apt install qemu-user-static abootimg libxml2-utils sshpass nfs-kernel-server
- Use
lsblk
to identify the USB disk you want to flash. In the caption below, we can identify that the USB disk ID issda
: - You need to specify the USB disk you want to install it on (e.g.
sda
), as well as the working directory you want to create for that matter (e.g../stereolabs_bsp
). - Please be careful and use the name of the drive and not the name of a partition. For instance, use
sda
instead ofsda1
. - Launch the script to flash your disk. The operation requires 80GB of free space. You need to specify the USB disk you want to install it on (e.g.
sda
) and the working directory you want to create (e.g../stereolabs_bsp
). It will ask you to log in as root several times. Replace the BSP_ROOT and SDX variables with yours in this command:Replace$ BSP_ROOT=./stereolabs_bsp SDX=sda ./zedbox_onx_usb_flash_<jp_ver>.sh
<jp_ver>
with the Jetpack version, e.g.zedbox_onx_usb_flash_5.1.2.sh
- Upon success, you will read the following message:
- The USB drive is now flashed. You will have to run almost the same command to flash the ZED Box later.
📌 Note: You can use the same
BSP_ROOT
directory to flash your ZED Box once it is in recovery mode. This allows you to skip the download and unpack sections of the script.
Booting from the USB disk #
- Shut down your ZED Box.
- Plug your USB disk into the single vertical USB type A port of the ZED Box Orin NX.
- Power the ZED Box and wait for it to boot from USB, it will take some time.
- You may now open a terminal and enter the following command to reboot into force recovery mode (please be careful with the syntax of the command):
$ sudo reboot --force forced-recovery
- From a host PC, you can now check that you are in recovery mode using the
lsusb
command:$ lsusb -d '0955:'
- If the model of the ZED Box is ORIN NX 16, then an NVIDIA®device with VID:PID
0955:7323
should be listed. - If the model of the ZED Box is ORIN NX 8, then an NVIDIA®device VID:PID
0955:7324
should be listed.
- If the model of the ZED Box is ORIN NX 16, then an NVIDIA®device with VID:PID
📌 Note: if an NVIDIA®device with VID:PID
0955:7020
is listed, then your ZED Box is not in Force Recovery mode. You must restart the procedure to boot it in Force Recovery mode.
- Remove the USB drive from the ZED Box.
- Follow the instructions in Manually flashing the ZED Box Orin NX model
If you encounter any problems during this procedure, you can contact the support team by sending an email to support@stereolabs.com.