ZED X Setup Troubleshooting
This is a comprehensive guide that addresses the most common issues you may face while setting up your ZED X camera.
However, if you encounter a problem that the guide does not address, please contact us directly by emailing support@stereolabs.com. Our team will be happy to assist you.
Before contacting the support team by email, please run the command sudo ZED_Diagnostic --dmesg
, save the dmesg.log
report file that it generates, and add it to the email as an attachment. This will provide the team with useful information to debug the problem.
ZED X 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
Upgrading a ZED X driver #
If you want to upgrade the ZED X driver, 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
Troubleshooting commands #
The following commands will help troubleshoot your GMSL2 connection:
sudo dmesg | grep zedx
Use the ZED Diagnostic tool dmesg
option for quick debugging:
sudo ./ZED_Diagnostic --dmesg
A ZED X is made of 2 video sensors. Both must appear as “bound” in the dmesg
log
Each ZED X is linked to an i2c bus with 0x10
and 0x18
sub addresses, therefore the first ZED X detected will be under the devices :
30-0018
(left) and30-0010
(right)
The second ZED X will be under :
31-0018
(left) and31-0010
(right)
If your ZED X camera does not appear correctly in these logs, please restart the ZED X daemon using:
sudo systemctl restart zed_x_daemon
Or reboot your device to be able to use your camera.
Xavier NX / Orin NX MIPI Bandwidth #
The default configuration for the MIPI lanes may be too high depending on the quality and length of the flat cables used to connect the NX development kit carrier boards to the GMSL2 capture card.
In such cases, the dmesg
diagnostic report does not indicate any problems, but the ZED X cannot be detected correctly by the ZED SDK.
You can solve the problem by using shorter flat cables, the recommended maximum length is 7 cm, or by changing the settings for the speed of the MIPI lanes.
Set the speed of the MIPI lanes #
Try first with 2 Gbps per lane:
sudo i2cset -y -f 30 0x29 0x04 0x15 0x34 i
sudo i2cset -y -f 30 0x29 0x04 0x18 0x34 i
sudo i2cset -y -f 30 0x29 0x04 0x1B 0x34 i
sudo i2cset -y -f 30 0x29 0x04 0x1E 0x34 i
then with 1.6 Gbps per lane if 2 Gbps is still too high:
sudo i2cset -y -f 30 0x29 0x04 0x15 0x30 i
sudo i2cset -y -f 30 0x29 0x04 0x18 0x30 i
sudo i2cset -y -f 30 0x29 0x04 0x1B 0x30 i
sudo i2cset -y -f 30 0x29 0x04 0x1E 0x30 i
Note: This set of commands must be entered after each reboot, and after calling the reset command
sudo systemctl restart zed_x_daemon
.