Reset your ZED Box Orin NX

Should I flash my ZED Box? #

The ZED Box Orin NX comes with pre-configured drivers that meet its requirements.

This procedure is intended for advanced users who need specific system configurations (i.e. a file system upgrade) or if the installation is broken and the ZED Box Orin NX is not functioning correctly or fails to boot.

Flashing your ZED Box Orin NX should be considered a last resort unless you have sufficient knowledge and expertise in the process.

Upgrade/Reset #

At the time of writing this tutorial, the NVIDIA® SDK Manager does not support automatic flashing of the Orin NX modules. Therefore, you must manually flash the board using NVIDIA’s BSP for the desired JetPack version.

Force the ZED Box in Recovery mode #

⚠️ It is not required to open the ZED Box to force it into Recovery mode. Opening the box will void the warranty ⚠️

• First method:

  To automatically start the ZED Box Orin NX in Force Recovery mode:

  1. Power off the device by removing both the barrel jack and any connected PoE+ Ethernet cable.
  2. Connect a Type-A to micro USB cable from the Ubuntu host PC to the micro USB port labeled OTG on the device.
  3. Power on the device by plugging in the barrel jack.

  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.

• Second method:

  Note: This is applicable only if your device can normally boot.

  Open a terminal console (Ctrl+Alt+t) and enter 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:'

• ZED Box Orin NX 16 GB: an NVIDIA® device with VID:PID 0955:7323 should be listed. e.g. Bus xxx Device yyy: ID 0955:7323 NVIDIA Corp. APX
• ZED Box Orin NX 8 GB: an NVIDIA® device VID:PID 0955:7423 should be listed. e.g. Bus xxx Device yyy: ID 0955:7423 NVIDIA Corp. APX

📌 Note: If an NVIDIA® device with VID:PID 0955:7020 and type NVIDIA Corp. L4T (Linux for Tegra) running on Tegra is listed, then your ZED Box Orin NX has not rebooted in Force Recovery mode. You must retry the procedure to boot it in Force Recovery mode.

📌 Note: There is a known issue with the first generation of ZED Box Orin NX with serial numbers starting with GTW-ONX- that prevents them from booting into Force Recovery Mode using the methods described above. Please use the method described in the section "Entering recovery mode with a live USB flashdrive" below to be able to flash the device.

Flashing the ZED Box Orin NX model #

📌 Note: The NVIDIA® SDK Manager does not support flashing ZED Box Orin NX devices. You must use the provided scripts instead.

Requirements:

• Jetpack version <= 5.1.2, use a host PC running Ubuntu 18.04 or Ubuntu 20.04.
• Jetpack version >= 6.0, use a host PC running Ubuntu 20.04 or Ubuntu 22.04.

⚠️ Warning: do not use virtual machines or WSL2 to run Ubuntu to flash the ZED Box Orin NX. If you do not have a ready PC running Ubuntu, please consider using a Live USBKey instead:

• Windows
• Ubuntu
• MacOS

On the host PC:

1. Open a terminal console from an move to an empty folder of your choice.

   • For example:

     mkdir -p ~/zedbox_flash
     cd ~/zedbox_flash
     

2. Ensure that you previously forced the ZED Box Orin NX in “Recovery mode”.

3. Download the Flash Script:

   • Download the flash script for the NVIDIA® Jetpack version you want to install:
     • NVIDIA® Jetpack 5.1.1 / L4T 35.3.1 - Jetpack details
     • NVIDIA® Jetpack 5.1.2 / L4T 35.4.1 - Jetpack details
     • NVIDIA® Jetpack 6.0 / L4T 36.3 - Jetpack details

4. Flash the ZED Box:

   • Ensure you have at least 80GB of free space on your working hard drive.

   • Use the following command to flash the ZED Box:

     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.
     • All necessary files will be downloaded in the folder $BSP_ROOT. The script will create this folder if it does not exist and will ask you to log in as root.

5. Wait for the operation to complete. You will see the following output if the flash is successful:

If you encounter any problems during this procedure, please consult the troubleshooting guide.

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.

1. Boot and Login:

   • Power on the device and log in with your credentials.

   The new default credentials of your ZED Box are:

   • username: user
   • password: admin

2. Check the OS Version:

   • Follow this support guide to determine the version of the operating system installed on your device.

3. Connect to the Internet:

   • Connect your device to the internet using an Ethernet cable or WiFi.
     • If WiFi is not detected or connecting, please follow this troubleshooting guide.

4. Open a Terminal:

   • Press Ctrl+Alt+T to open a terminal window.

5. 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
   

6. Download the ZED SDK:

   • Visit the Stereolabs website and download the ZED SDK for Jetson that matches your installed Jetpack/L4T version.

7. 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
     

8. 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.

9. Reboot:

   • Restart your device to apply all changes:

     sudo reboot
     

10. Enjoy Your Device:

    • Your device is now ready for use with the ZED cameras.

Entering recovery mode with a live USB flashdrive #

If your Linux install is broken, or you are using a first-gen ZED Box Orin NX (serial number biginning with ``), you will not be able to enter recovery mode automatically. This tutorial will help you recover from such a situation.

📌 If the serial number of your ZED Box Orin Nx begins with GTW-ONX1- or GTW-ONX2-, follow this guide only if you experienced problems while forcing the ZED Box Orin NX to Recovery mode using the standard methods. ⚠️

To complete the tutorial, you need an 8 GB or larger USB 3.0 disk.

⚠️ all the information stored in the USB disk will be wiped during the procedure. ⚠️

Setting up the USB disk #

• Plug the USB disk to any Linux host machine

• Download the flash script for the NVIDIA® Jetpack version you want to install:

  • NVIDIA® Jetpack 5.1.1 / L4T 35.3.1 - Jetpack details
  • NVIDIA® Jetpack 5.1.2 / L4T 35.4.1 - Jetpack details
  • NVIDIA® Jetpack 6.0 / L4T 36.3 - Jetpack details

• 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 is sda:

• 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 of sda1.

• 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:

  BSP_ROOT=./stereolabs_bsp SDX=sda ./zedbox_onx_usb_flash_<jp_ver>.sh
  

  Replace <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 can now open a terminal console (Ctrl+Alt+t) and enter the following command to reboot into force recovery mode:

  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:'

• ZED Box Orin NX 16 GB: an NVIDIA® device with VID:PID 0955:7323 should be listed. e.g. Bus xxx Device yyy: ID 0955:7323 NVIDIA Corp. APX

• ZED Box Orin NX 8 GB: an NVIDIA® device VID:PID 0955:7423 should be listed. e.g. Bus xxx Device yyy: ID 0955:7423 NVIDIA Corp. APX

• 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.