Install guide

ZED SDK v5.4

HDI 的 Windows ZED 运行环境安装说明。优先安装 CUDA 13 版本；只有显卡或驱动不支持 CUDA 13 时，才选择 CUDA 12 版本。

官方要求

HDI 当前只支持 Windows 版 ZED 环境。完整要求见 Stereolabs 官方规格要求。

  • 系统 Windows 10 / 11
  • 内存 16 GB
  • 显卡 NVIDIA RTX GPU，推荐显存大于 6 GB。
  • 连接 USB 3.0

安装前检查

  1. 如果已安装旧版 ZED SDK，先在 Windows“应用和功能”里卸载旧版。
  2. 更新 NVIDIA 显卡驱动。CUDA 支持范围取决于显卡型号和驱动版本。
  3. 在 PowerShell 或命令提示符中运行 nvidia-smi，查看 Driver Version 和 CUDA Version。这里的 CUDA Version 是当前驱动支持的最高 CUDA 版本，不表示已经安装了 CUDA Toolkit。
  4. 优先在 Stereolabs 下载页选择 ZED SDK v5.4 - CUDA 13 / TensorRT 10。只有 nvidia-smi 显示最高支持 CUDA 12.x 时，才选择 CUDA 12 / TensorRT 10。
nvidia-smi

安装步骤

  1. 按上一步结果下载 ZED SDK v5.4 安装包。默认选择 CUDA 13 / TensorRT 10。
  2. 安装匹配的 CUDA Toolkit。选择 CUDA 13 安装包时，推荐安装 CUDA Toolkit 13.3。
  3. 安装 ZED SDK。如果安装器提示缺少 CUDA，按提示安装对应版本的 CUDA Toolkit。
  4. 安装完成后重启电脑，用于更新 Windows 环境变量；这也是 官方 Windows 安装说明的要求。
  5. 打开 ZED Diagnostic，确认 Graphics Card、CUDA Operations、Camera Test 通过。

环境变量

CUDA_PATH 应指向实际安装的 CUDA Toolkit 目录，例如：

C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v13.3

系统 Path 应包含：

C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\<CUDA_VERSION>\bin
C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\<CUDA_VERSION>\bin\x64

默认应为 v13.3；如果因显卡或驱动限制选择 CUDA 12，再替换为实际安装的 CUDA 12 目录。

命令行检查

nvidia-smi
where cudart64_13.dll
where nvcc
nvcc --version

正常情况下，nvidia-smi 显示的 CUDA Version 不低于所选 ZED SDK 安装包的 CUDA 大版本；where cudart64_13.dll 应显示 CUDA 13 路径。如果安装的是 CUDA 12 版本，把命令改为 where cudart64_12.dll。

AI Models

ZED Diagnostic 跑完检测后，进入 AI Models。最简单的做法是直接点击 Optimize All；如果手动选择，按下面三类处理。

  1. 基础人体跟踪

    HUMAN BODY FAST DETECTION、HUMAN BODY MEDIUM DETECTION、HUMAN BODY ACCURATE DETECTION、REID ASSOCIATION。

  2. 如果使用 BODY_38

    HUMAN BODY 38 FAST DETECTION、HUMAN BODY 38 MEDIUM DETECTION、HUMAN BODY 38 ACCURATE DETECTION。

  3. 如果使用 AI Depth optional

    只有在 HDI 里选择 NEURAL 或 NEURAL_PLUS 深度模式时，才需要 NEURAL DEPTH 或 NEURAL PLUS DEPTH。