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.