> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.stereolabs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.stereolabs.com/_mcp/server.

# ZED Diagnostic

**ZED Diagnostic** is a tool designed to help you troubleshoot issues with your ZED camera. It provides detailed information about the camera's hardware and software status, allowing you to identify potential problems and ensure optimal performance.

## How to use ZED Diagnostic

Connect your ZED camera to your computer and launch the **ZED Diagnostic** tool from the ZED SDK installation directory or through the Start menu (Windows) or terminal (Linux).

* Under Windows, you can find **ZED Diagnostic** in the Start menu under the ZED SDK folder. You can also run it from the command line by navigating to the ZED SDK installation directory: `C:\Program Files (x86)\ZED SDK\tools\ZED Diagnostic.exe`
* Under Ubuntu, you can run **ZED Diagnostic** from the terminal by typing `ZED_Diagnostic` or by navigating to the ZED SDK installation directory: `/usr/local/zed/tools/ZED_Diagnostic`.

![image](/_fern-img/9a8f3f452e80fb104e3b3adfcf488032f70bd829c3b316e1ad84917e9943c571.webp)

After pressing the **Start** button, the tool will automatically detect the connected ZED camera and start gathering diagnostic information.

![image](/_fern-img/3ad2170fe7a82505da1c00319b3d8a54c628d67c283950ccdbd72d9abe384831.webp)

You can monitor the progress of the diagnostic tests in real-time. The tool will perform various checks, including:

* **ZED SDK**: SDK and CUDA versions.
* **PROCESSOR**: CPU processor model and motherboard information.
* **GRAPHIC CARD**: GPU model.
* **AI MODELS**: Available AI models and optimization status.
* **CAMERA TEST**: Camera hardware tests, including model and firmware version.
* **DEVICES**: Connectivity status.

Once the diagnostic process is complete, the tool will display a summary of the results, indicating whether the camera and system are functioning correctly.

![image](/_fern-img/54a756b094f9c9ae0091e0219203b224bda207872619b6404a2dfd8a8e3c593c.webp)

In case of any issues, the tool will display error messages and clear diagnostic information.

![image](/_fern-img/a4a0ac084dcf69787f268fff75b44a3da8ea8985a2f27768f0d154407fde364c.webp)

After the diagnostic process completes with failures, press the **Save** button to export the diagnostic report as a JSON file. You can share this file with the StereoLabs support team for further assistance. Please email it to [support@stereolabs.com](mailto:support@stereolabs.com) and include a detailed description of the issue you are experiencing.

## Optimize the AI models

The **ZED Diagnostic** tool can also help you optimize the AI models used by the ZED camera. This is particularly useful if you have recently updated the ZED SDK or if you want to ensure that the AI models are already optimized before using them with a ZED SDK application.

Click on the **AI MODELS** button to view the status of the AI models. The tool will display a list of available models and their optimization status.

> **Note**
>
> The **AI MODELS** button will only be enabled after completing a diagnostic test.

![image](/_fern-img/9a24e5278cfdf1c81d3f921e61b6e5ec5e8fcf24e9ab09519f68777f645ac9c6.webp)

Once you have selected the AI models you want to optimize, click on the **Optimize Selection** button. The tool will automatically download and optimize the selected models, ensuring that they are ready for use with the ZED SDK.

You can also click on **CLEAR ALL MODELS** to remove all downloaded and optimized AI models. This is useful if you want to free up space or reset the optimizations if something is not working properly.

## Advanced Features

The **ZED Diagnostic** tool provides several advanced features to help you diagnose and troubleshoot issues with your ZED camera.

Under Ubuntu, open a terminal and run the following command to obtain a list of advanced commands:

```bash
$ ZED_Diagnostic --help

Usage:
    -d | Auto start the diagnostic (only for GUI mode)
    -c | Start the application in command line (Useful when no GUI is available)
    -aid | Download all models for the AI module
    -aio | Optimize (and download if needed) all models for the AI module
    -aic | Clear all models for the AI module
    -ais X | Download and Optimize the associated sl::DETECTION_MODEL (int)
    -nrlo | Download and Optimize the NEURAL depth mode
    -nrlo_plus | Download and Optimize the NEURAL PLUS depth mode
    -nrlo_light | Download and Optimize the NEURAL LIGHT depth mode
    -nrlo_all | Download and Optimize all NEURAL depth modes
    -onnx <path> [WxH] | Optimize a custom object detection ONNX model
    -r | Recover an MCU module with not valid serial number
    -dmesg | Logs kernel/driver dmesg
    -h | Display this help
```

These commands allow you to perform various tasks without needing to interact with the GUI. Here’s a brief explanation of each command:

* `-d` allows you to autostart the diagnostic process without pushing any button in the GUI.
* `-c` starts the application in command line mode, which is useful when no display is available.
* `-aid` connects to our servers to download all the models for the AI module.
* `-aio` optimizes (and downloads if needed) all models for the AI module.
* `-aic` clears all the downloaded and optimized AI models. This is useful if you want to free up space, or reset all the optimizations if something is not working properly.
* `-ais X` downloads and optimizes the associated [`sl::DETECTION_MODEL`](https://www.stereolabs.com/docs/api/group__Object__group.html#ga49a841d66aed2ac1d506f8f0aaba2f8a) (where `X` is an integer representing the [model ID](https://www.stereolabs.com/docs/api/group__Object__group.html#ga49a841d66aed2ac1d506f8f0aaba2f8a)).
* `-nrlo` downloads and optimizes the `NEURAL` depth mode.
* `-nrlo_plus` downloads and optimizes the `NEURAL PLUS` depth mode.
* `-nrlo_light` downloads and optimizes the `NEURAL LIGHT` depth mode.
* `-nrlo_all` downloads and optimizes all AI-based depth modes.
* `-onnx <path> [WxH]` optimizes a custom object detection ONNX model ahead of time, so an application calling `enableObjectDetection()` with `OBJECT_DETECTION_MODEL::CUSTOM_YOLOLIKE_BOX_OBJECTS`, `CUSTOM_RFDETRLIKE_BOX_OBJECTS` or `CUSTOM_BOX_OBJECTS_AUTODETECT` starts instantly instead of optimizing the model on first use. The optional input size (default `512x512`) must match the `ObjectDetectionParameters::custom_onnx_dynamic_input_shape` used by the application. Available since ZED SDK 5.5.
* `-r` recovers an MCU module with an invalid serial number (to be used with `ZED Mini`, `ZED 2` or `ZED 2i` cameras).
* `-dmesg` retrieves the kernel/driver dmesg logs, for debugging [GMSL2](/docs/products/embedded/zed-link-capture-card/gmsl2#what-is-gmsl2) cameras. Read [here](/docs/products/embedded/zed-link-capture-card/gmsl2/troubleshooting/) for more information.