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.

Issues flashing 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 #

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

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

Contact Support #

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