Troubleshooting

Here are some common issues that you could face with your ZED Box Orin.

If you are unable to resolve your issue using the following suggestions, please reach out to us at support@stereolabs.com for further assistance.

ZED Box Orin not booting #

If your ZED Box Orin does not turn on after a shutdown, follow these steps to diagnose the issue.

1. Check Power Connection #

Try these steps to force a boot:

Unplug both the power cable and the Ethernet PoE+ cable.
Plug in only one of them (either the power cable or the PoE+ cable) and check if the device powers on.

📌 Note: The carrier board of the ZED Box Orin cannot reboot if one power cable is already connected when plugging in the other.

2. Check the Power LED Status #

Locate the power LED on the front panel and determine its status:

🟢 LED is ON #

This indicates a software issue.
The ZED Box software may have been corrupted due to an improper shutdown or the internal disk may be full.
Important: Always shut down the device properly by software before removing power to avoid file system corruption.
Solution:
- Try to follow the Recover a ZED Box Orin with full disk procedure to verify if the internal disk is full and fix it.
- If the issue persists, perform a hard reset.

⚫ LED is OFF #

If you have already tried the power cable procedure, this suggests a possible file system or hardware failure.
Solution:
- To identify a file system issue, you can try to boot the ZED Box Orin in Force Recovery mode. Read the procedure in the device flash guide.
- If your device does not boot into Force Recovery mode, it is likely due to a hardware failure. In this case, contact Stereolabs Support for further assistance.

ZED Box Orin not booting when the disk is full #

If your ZED Box Orin is not booting due to a full disk, you can try the following steps to recover it.

Requirements:

a host PC running Ubuntu 20.04 or Ubuntu 22.04.
an 8 GB or larger USB Key 3.0.

⚠️ ALL THE INFORMATION STORED IN THE USB KEY WILL BE WIPED DURING THE PROCEDURE ⚠️

📌 Note: If the USB Key contains multiple partitions, you must delete them all before proceeding. You can use the gparted tool to manage partitions.

Create a bootable recovery USB Key and use it to free up space on the internal disk of the ZED Box Orin by following these steps:

Connect the USB Key to the host PC.
- Open a terminal (Ctrl+Alt+T).
- Enter the command lsblk to identify the device name sdX of your USB Key (e.g., sda).
- Download the flash script to create a bootable recovery USB Key from our servers.
- Make the script executable:
```
chmod +x zedbox_all_usb_flash_6.2.sh
```
- Run the script, replacing <sdX> with your USB Key device name, e.g sda:
```
BSP_ROOT=./stereolabs_bsp SDX=<sdX> ./zedbox_all_usb_flash_6.2.sh
```
- Wait for the script to complete. This will erase all data on the USB Key and create a bootable recovery drive. This operation can take a while according to the USB Key read/write speed (ETA > 60 min ).
Unplug the USB Key from the host PC and plug it into one of the horizontal USB ports on the ZED Box Orin.
Plug the power cable or the Ethernet PoE+ cable to the ZED Box Orin, to turn it on and boot from the USB Key.
Connect a micro-USB cable to the OTG port of the ZED Box Orin and to the host PC.
On the host PC, open a terminal and start a serial terminal application to connect to the ZED Box Orin via the micro-USB cable.:
```
sudo gtkterm
```
then in the menu Configuration > Port, select /dev/ttyACM0.
Note: it can take quite a while before the device shows up because of the initialization process of the USB key (ETA 5 min)
When ttyACM0 is connected, press Enter a couple of times to force the display of the prompt, i.e. GTW-ONX16-ubuntu login:.
Enter the username and password of the ZED Box Orin (default: user / admin).
Once logged in, run the command lsblk to verify that nvme0n1 exists. You can use df -h to check the disk usage. If the root partition / is close to 100%, you need to free up some space to allow the ZED Box Orin to boot.
Mount the internal disk in read-write mode:
```
mkdir mnt
sudo mount nvme0n1p1 mnt/
```
The folder mnt now contains the file system of the ZED Box Orin. You can now delete some files to free up space. For example, you can delete old log files in /mnt/var/log/ or old user files in /mnt/home/user/. If you are using ROS 2, you can delete ROS 2 logs in /mnt/home/user/.ros/log/ to recover space.
You can use the command df -h to check the available space on the internal disk.
Once you have freed up enough space, unmount the internal disk:
```
sudo umount mnt
```
Enter the command sudo shutdown -h now to turn off the ZED Box Orin.
Unplug the USB Key and the micro-USB cable.
Plug the power cable or the Ethernet PoE+ cable to the ZED Box Orin.
The ZED Box Orin should now boot normally.

I cannot retrieve any GNSS data, whereas I’m in open air #

Please make sure that you plugged a male antenna into the port 5 on the side of ZED Box. Then reboot, and run cgps.

gpsd has known incompatibilities when working with systemd, which is the default behavior. For that reason, we strongly advise you NOT to use gpsd with systemd. Usual trouble are that your host will need to reboot every time you want to stop your application and run it again.

The easiest way to run gpsd is with

sudo gpsd -nG -P /run/gpsd.pid /dev/ttyACM0

You can run this in a CRON job :

@reboot sleep 10 && /usr/sbin/gpsd -nG -P /run/gpsd.pid /dev/ttyACM0

The WiFi does not work anymore after a system update #

After daily operating system updates, the WiFi module on the ZED Box Orin may stop working.

This issue occurs when the Ubuntu Software Updater or apt installs an incorrect WiFi driver.

Solution Follow these steps to remove the incorrect driver and reload the correct one:

Remove the incorrect driver file #

Run the following command to delete the problematic firmware file:

sudo rm /lib/firmware/iwlwifi-ty-a0-gf-a0-66.ucode

now you can reboot (sudo reboot) the device to automatically load the correct driver, or continue to do that manually without a reboot.

Unload the incorrect driver #

Unload the currently loaded (incorrect) WiFi driver:

sudo modprobe -r iwlwifi

Load the correct driver #

Reload the correct default WiFi driver:

sudo modprobe iwlwifi

After completing these steps, your WiFi module should function properly again.

I cannot flash the ZED Box Orin #

If you encounter issues while flashing your ZED Box Orin, follow these steps to troubleshoot the problem.

Force Recovery Mode #

If the flash procedure fails, it is likely because the ZED Box Orin is not in Recovery Mode before launching the flash script.

To verify that the ZED Box is in “Recovery Mode,” enter the following command in the host PC’s command line console:

lsusb -d '0955:'

If the device is correctly in Recovery Mode, the command should return:

NVIDIA® Jetson™ Orin Nano 8 GB: an NVIDIA® device with VID:PID 0955:7523 should be listed. e.g. Bus xxx Device yyy: ID 0955:7523 NVIDIA Corp. APX
NVIDIA® Jetson™ Orin NX 8 GB: an NVIDIA® device with VID:PID 0955:7423 should be listed. e.g. Bus xxx Device yyy: ID 0955:7423 NVIDIA Corp. APX
NVIDIA® Jetson™ 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

If the ZED Box Orin is not in Recovery Mode, follow again the Force the ZED Box in Recovery Mode guide accurately.

If the problem persists and you cannot force the device into Recovery Mode, follow the alternative guide to use a live USB flash drive.

If the issue continues after following both guides, contact Stereolabs Support for further assistance.

Bad Communication #

If the device is in Recovery Mode and the flash procedure fails, please verify the following conditions and retry:

Avoid using virtual machines.
Avoid using WSL2.
Use a shorter USB cable.
Use a different USB port, preferably one directly soldered to the motherboard.
Try using a different host Ubuntu PC.

Disable USB autosuspend with the following command:

sudo bash -c 'echo -1 > /sys/module/usbcore/parameters/autosuspend'

Error: “Package nvidia-l4t-kernel is not configured yet” while installing the ZED X Driver #

With the JetPack 6.2.1 (L4T 36.4.4), you may encounter the following error when trying to install the ZED X Driver on your ZED Box Orin:

dpkg: dependency problems prevent configuration of stereolabs-zedbox-duo:
 stereolabs-zedbox-duo depends on nvidia-l4t-rt-kernel (>= 5.15.148-rt-tegra-36.4.0-20240912212859) | nvidia-l4t-kernel (>= 5.15.148-tegra-36.4.0-20240912212859); however: 
  Package nvidia-l4t-rt-kernel is not installed.
  Package nvidia-l4t-kernel is not configured yet.
 stereolabs-zedbox-duo depends on nvidia-l4t-rt-kernel (<= 5.15.148-rt-tegra-36.4.4-20250616085344) | nvidia-l4t-kernel (<= 5.15.148-tegra-36.4.4-20250616085344); however: 
  Package nvidia-l4t-rt-kernel is not installed.
  Package nvidia-l4t-kernel is not configured yet.

dpkg: error processing package stereolabs-zedbox-duo (--install):
 dependency problems - leaving unconfigured
Errors were encountered while processing: 
 steorelabs-zedbox-duo

To resolve this issue, you can follow these steps:

sudo apt-get autoclean # Clean up the package cache
sudo mv /var/lib/dpkg/info/ /var/lib/dpkg/backup/ # Backup the info directory
sudo mkdir /var/lib/dpkg/info/ # Create a new info directory
sudo apt-get update # Update the package list
sudo apt-get -f install # Fix broken dependencies

This process will clean up the package cache, backup the existing package information, create a new directory for package information, update the package list, and fix any broken dependencies that may be causing the issue. After completing these steps, you should be able to install the ZED X Driver without encountering the “Package nvidia-l4t-kernel is not configured yet” error.

Chromium and FireFox browser issues with Jetson Linux (L4T) 36.4.4 - JP 6.2.1 #

Upgrading to Jetson Linux (L4T) 36.4.4 - JP 6.2.1 introduces Snapd 2.70, which breaks all Snap packages with the following error:

cannot set capabilities: Operation not permitted

for this reason, the Chromium and FireFox browsers, and other Snap-based applications fail to launch.

This occurs because Jetson Orin devices ship with a minimal kernel that lacks certain security features required by Snapd 2.70 and newer. As a result, Snap-based applications—including the Chromium browser—fail to launch.

To resolve this issue, you can either revert Snapd to an earlier working version:

snap download snapd --revision=24724
sudo snap ack snapd_24724.assert
sudo snap install snapd_24724.snap
sudo sudo snap refresh --hold snapd

For more information, refer to this page of the JetsonHacks website.

Contact Support #

If you are unable to resolve your issue, please reach out to us at support@stereolabs.com for further assistance.