Setting up the ZED X One Monocular

Setting up the driver #

The ZED X One is compatible with NVIDIA® Jetson platforms and has similar compatibility to the ZED X. You can refer to the hardware and driver setup of the ZED X One guides according to your hardware.

Install the ZED X One driver #

The ZED X series requires installing a driver to operate correctly. It is responsible for configuring the GMSL2 device and is dependent on the hardware used, such as the Jetson carrier board, the deserializer card, and other configurations related to GMSL2 cameras.

The drivers can can be downloaded from the ZED X Driver download page.

Note: Please make sure to check the version of the driver available on the ZED X Driver download page. If the website features an updated version, we recommend installing the latest one.

Select the driver corresponding to your configuration and run:

sudo dpkg -i stereolabs-zedx_X.X.X-YYYYYYYY-L4TZZ.Z_arm64.deb

Where:

  • X.X.X is the driver version
  • YYYYYYY is the deserializer
  • L4TZZ.Z is the Jetson Linux version

For example, for L4T 35.1 (JetPack 5.0) with the Stereolabs GMSL2 Capture Card, run:

sudo dpkg -i stereolabs-zedx_0.5.1-MAX96712-L4T35.1_arm64.deb

Note: You might need to install libqt5core5a if not already installed. Use the following command:

sudo apt install libqt5core5a

Now, reboot the NVIDIA® Jetson.

You can use the following command to check that the driver is correctly loaded:

sudo dmesg | grep zedx

Please note that 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
Updating the driver

If you want to upgrade the driver from a version older than v0.5.x it is required to uninstall the previously installed version:

sudo dpkg -r stereolabs-zedx_X.X.X-YYYYYYYY-L4TZZ.Z_arm64.deb

to retrieve the correct name of the package to remove you can use the command

sudo dpkg -l | grep stereolabs-zedx

Using Nvargus #

The camera can then be opened using Nvargus, the tools provided by NVIDIA on Jetson to open cameras connected in GMSL2 and CSI.

Make sure the multimedia API is installed;

sudo apt install nvidia-l4t-jetson-multimedia-api

Then compile the camera sample

cp -r /usr/src/jetson_multimedia_api/* ./
sudo apt install libgtk-3-dev
cd argus
mkdir build && cd build && cmake .. && make
cp apps/camera/ui/camera/argus_camera ./
./argus_camera

Using GStreamer #

Using the Stereolabs zedxonesrc source element #

Please refer to the ZED GStreamer plugin documentation to leverage the full capabilities of the ZED X One camera.

Using NVIDIA nvarguscamerasrc source element #

To open the camera using the nvarguscamera gstreamer plugin, run:

gst-launch-1.0 nvarguscamerasrc sensor-id=0 ! 'video/x-raw(memory:NVMM), width=(int)1920, height=(int)1200, framerate=30/1' ! nvvidconv flip-method=0 ! 'video/x-raw, format=(string)I420' ! xvimagesink -e

Please refer to the NVIDIA documentation for more information

Using ZED X Open Capture #

To use the ZED X One capture open source API, go to https://github.com/stereolabs/zedx-one-capture.

Compile the library, then modify the sample to fit your application.

The library is based on the multimedia API from Nvidia. Support for retrieving IMU data will be available in a further release.