Troubleshooting

Open in ClaudeOpen in ChatGPT

This troubleshooting guide provides solutions to common issues that may arise when using the ZED X One camera. If you encounter any problems, please refer to the sections below for potential fixes.

The camera is not detected

GMSL2 cameras have lower flexibility compared to USB cameras. Any modification in the hardware configuration, such as plugging or unplugging a camera, or changing the camera order, requires either rebooting the Jetson, or restarting the installed daemon with the following command:

$sudo systemctl restart zed_x_daemon

If you are using a custom carrier board, or a partner’s ECU, please make sure that the custom driver provides the zed_x_daemon service. If not, every hardware modification will require a reboot of the Jetson device.


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.