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.