Come posso usare ZED con Docker su un robot senza connessione Internet?

Una connessione Internet è normalmente richiesta solo la prima volta che si apre una telecamera ZED con un'applicazione basata sullo ZED SDK, per scaricare il relativo file di calibrazione di fabbrica, e la prima volta che si utilizza un modello di IA, per scaricarlo.

Nota: le telecamere prodotte dopo maggio 2026 (eccetto ZED Mini) memorizzano la calibrazione di fabbrica anche nella loro EEPROM interna, che viene letta da ZED SDK v5.3 o versioni successive senza una connessione Internet. Consulta Come posso ricalibrare la mia telecamera stereo ZED?

Ogni volta che viene avviato un container, si comporta come se la telecamera fosse stata collegata per la prima volta a un nuovo dispositivo: lo ZED SDK non trova il file di calibrazione e i modelli di IA e prova a scaricarli nuovamente.

File di calibrazione

Monta la cartella dell'host /usr/local/zed/settings/ come volume, in modo che il container utilizzi i file di calibrazione memorizzati sulla macchina host:

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

Sostituisci <docker_image> con il nome della tua immagine. Se anche l'host non dispone di una connessione Internet, scarica il file di calibrazione da un altro computer, come descritto in questo articolo, e copialo nella cartella settings dell'host.

Modelli di IA

I robot che utilizzano i moduli di IA dello ZED SDK (modalità di profondità NEURALE, Rilevamento oggetti, Tracciamento del corpo) necessitano anche dei modelli di IA ottimizzati. Monta la cartella dell'host /usr/local/zed/resources/ come volume:

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

I modelli devono essere ottimizzati sullo stesso modello di GPU e con la stessa versione dello ZED SDK utilizzati nel container; consulta Come posso ottimizzare manualmente i modelli di IA dello ZED SDK?

Per le telecamere GMSL2 (Famiglia ZED X) il driver ZED X richiede volumi e dispositivi aggiuntivi; consulta la Documentazione Docker.