我的 ZED 传感器已停止工作。如何下载诊断文件？

Last updated: August 13, 2026

如果您的 ZED 相机未按预期工作，ZED Diagnostics 工具可以生成诊断报告，帮助我们的支持团队分析您的系统配置并确定问题来源。

请按照以下步骤生成诊断文件，并将其发送至 support@stereolabs.com。

步骤 1：安装最新的 ZED SDK

从我们的开发者页面下载并安装最新的 ZED SDK。许多问题只需更新到最新的 SDK 版本即可解决。

安装完成后，请重启计算机，以重新加载环境变量，并确保没有任何因素干扰 ZED SDK。

将 ZED 相机连接到您的设备。如果您拥有多个相机，请一次连接并测试一个相机。

GMSL2 相机（ZED X、ZED X One）注意事项：硬件配置的任何修改，例如插拔相机或更改相机顺序，都需要重启 Jetson，或使用以下命令重启守护进程：

sudo systemctl restart zed_x_daemon

Windows：打开“开始”菜单，在 ZED SDK 文件夹中搜索“ZED Diagnostic”，或运行 C:\Program Files (x86)\ZED SDK\tools\ZED Diagnostic.exe（右键单击并选择“以管理员身份运行”）。
Linux / NVIDIA Jetson：打开终端并输入 ZED_Diagnostic，或从 ZED SDK 安装目录运行：/usr/local/zed/tools/ZED_Diagnostic。

按下开始按钮；该工具将自动检测已连接的相机并执行一系列检查：ZED SDK 和 CUDA 版本、处理器和主板信息、GPU 型号、AI 模型状态、相机硬件测试（型号和固件版本）以及连接状态。

诊断过程完成后，按保存按钮将诊断报告导出为 JSON 文件。

将文件发送至 support@stereolabs.com，并详细描述您遇到的问题：发生了什么、何时开始，以及确切的错误消息（如有）。您提供的上下文信息越多，我们就能越快为您提供帮助。

如果您使用的是 ZED X 或 ZED X One 相机，并搭配 ZED Link 采集卡、ZED 盒子或第三方载板，请同时附上内核/驱动日志，这些日志对于调试 GMSL2 连接问题至关重要。您可以通过专用的 ZED Diagnostics 选项获取这些日志：

sudo /usr/local/zed/tools/ZED_Diagnostic --dmesg

或手动运行：

sudo dmesg | grep zedx

有关常见 GMSL2 问题（未检测到相机、驱动程序升级、Xavier NX / Orin NX 上的 MIPI 通道速度、系统更新后图像模糊）的更多信息，请参阅我们的专用故障排除指南：

如果您的设备没有可用的图形用户界面，例如通过 SSH 访问的 Jetson，您可以在命令行模式下运行该工具：

ZED_Diagnostic -c

完整的命令行选项列表可通过 ZED_Diagnostic -h 获取，相关内容已记录在ZED Diagnostics 文档中。

ZED Diagnostics 工具还可以下载和优化 ZED SDK 使用的 AI 模型（神经深度模式、目标检测、身体追踪），并恢复序列号无效的 ZED 2 / ZED 2i MCU 模块。详情请参阅 ZED Diagnostics 文档。