Troubleshooting

ZED Box Mini not booting

If your ZED Box Mini 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
• Check with a voltmeter that the voltage value is 12V
• If the voltage is correct, replug the cable, otherwise contact the support team at support@stereolabs.com for further assistance.

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 requiring a hard reset of the device.
• The ZED Box software may have been corrupted due to an improper shutdown.
• Important: Always shut down the device properly by software before removing power to avoid software corruption.

⚫ LED is OFF

• If you have already tried the power cable procedure, this suggests a hardware failure.
• Contact StereoLabs Support for further assistance.

I cannot flash the ZED Box Mini

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

Force Recovery Mode

If the flash procedure fails, it is likely because the ZED Box Mini 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 4 GB: an NVIDIA® device with VID:PID 0955:7623 should be listed. e.g. Bus xxx Device yyy: ID 0955:7623 NVIDIA Corp. APX
• NVIDIA® Jetson™ Orin Nano 4 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 Mini is not in Recovery Mode, follow again the Force the ZED Box in Recovery Mode guide accurately.

If the issue persists 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 host PC 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'

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.

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

After upgrading the ZED Box Mini with sudo apt upgrade, reinstall the ZED X Driver to restore full compatibility.

In some cases, the reinstallation can fail with the dependency error shown below:

$
$ sudo dpkg -i stereolabs-zedbox-mini_1.3.1-SL-MAX9296-all-ZEDBOX-MINI-L4T36.4.0_arm64.deb
$
[sudo] password for user:
$
(Reading database ... 200368 files and directories currently installed.)
$
Preparing to unpack stereolabs-zedbox-mini_1.3.1-SL-MAX9296-all-ZEDBOX-MINI-L4T36.4.0_arm64.deb ...
$
Unpacking stereolabs-zedbox-mini (1.3.1-SL-MAX9296-all-ZEDBOX-MINI-L4T36.4.0) over (1.3.1-SL-MAX9296-all-ZEDBOX-MINI-L4T36.4.0) ...
$
dpkg: dependency problems prevent configuration of stereolabs-zedbox-mini:
$
stereolabs-zedbox-mini 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-mini 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-mini (--install):
$
dependency problems - leaving unconfigured
$
Errors were encountered while processing:
$
stereolabs-zedbox-mini

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.

Blurry images after system update

After a system update, if you experience blurry images from the GMSL2 camera, it may be caused by the overwriting of a patched library used by the ZED Link driver.

To fix this issue, please follow this procedure to manually restore the patched library:

1. Download the latest ZED Link driver package for your device from the ZED X Drivers download page.

2. Extract the downloaded .deb package and copy the patched library to the correct location:

   $
   ar x stereolabs-zed<model>_<version>-<deser>-<l4t_version>_arm64.deb
   $
   tar xvf data.tar.xz
   $
   sudo cp ./tmp/R<l4t_version>/libnvisppg.so /usr/lib/aarch64-linux-gnu/tegra/libnvisppg.so

   Replace stereolabs-zed<model>_<version>-<deser>-<l4t_version>_arm64.deb with the actual filename of the downloaded package.

   Replace <l4t_version> with your current L4T version (for example, R36.4.3).

3. Reboot the Jetson device:

   $
   sudo reboot

After following these steps, the GMSL2 camera should function correctly with clear images.

Contact Support

If you are unable to resolve your issue, please reach out to us for further assistance.