¿Cómo puedo usar la ZED con Docker en un robot sin conexión a Internet?

Normalmente, solo se requiere una conexión a Internet la primera vez que abre una cámara ZED con una aplicación basada en ZED SDK, para descargar su archivo de calibración de fábrica, y la primera vez que utiliza un modelo de IA, para descargarlo.

Nota: las cámaras producidas después de mayo de 2026 (excepto la ZED Mini) también almacenan la calibración de fábrica en su EEPROM interna, que ZED SDK v5.3 o posterior lee sin conexión a Internet. Consulte ¿Cómo recalibro mi cámara estéreo ZED?

Cada vez que se inicia un contenedor, se comporta como si la cámara estuviera conectada por primera vez a un dispositivo nuevo: ZED SDK no encuentra el archivo de calibración ni los modelos de IA e intenta descargarlos de nuevo.

Archivos de calibración

Monte la carpeta del host /usr/local/zed/settings/ como un volumen, para que el contenedor utilice los archivos de calibración almacenados en la máquina host:

docker run --runtime nvidia -it --privileged \
  -v /usr/local/zed/settings/:/usr/local/zed/settings/ \
  <docker_image> sh

Reemplace <docker_image> por el nombre de su imagen. Si el host tampoco tiene conexión a Internet, descargue el archivo de calibración desde otro equipo, como se describe en este artículo, y cópielo en la carpeta de configuración del host.

Modelos de IA

Los robots que utilizan módulos de IA de ZED SDK (modos de profundidad NEURAL, Detección de objetos, Seguimiento del cuerpo) también necesitan los modelos de IA optimizados. Monte la carpeta del host /usr/local/zed/resources/ como un volumen:

docker run --runtime nvidia -it --privileged \
  -v /usr/local/zed/settings/:/usr/local/zed/settings/ \
  -v /usr/local/zed/resources/:/usr/local/zed/resources/ \
  <docker_image> sh

Los modelos deben optimizarse en el mismo modelo de GPU y con la misma versión de ZED SDK que se utiliza en el contenedor; consulte ¿Cómo puedo optimizar manualmente los modelos de IA de ZED SDK?

Para las cámaras GMSL2 (familia ZED X), el controlador ZED X requiere volúmenes y dispositivos adicionales; consulte la documentación de Docker.