인터넷 연결이 없는 로봇에서 Docker와 함께 ZED를 어떻게 사용할 수 있나요?

ZED SDK를 기반으로 하는 애플리케이션에서 ZED 카메라를 처음 열 때 공장 보정 파일을 다운로드하고, AI 모델을 처음 사용할 때 해당 모델을 다운로드하려면 일반적으로 인터넷 연결이 필요합니다.

참고: 2026년 5월 이후에 생산된 카메라(ZED 미니 제외)는 공장 보정 정보를 내부 EEPROM에도 저장하며, ZED SDK v5.3 이상에서는 인터넷 연결 없이 이 정보를 읽습니다. ZED 스테레오 카메라를 어떻게 재보정하나요?를 참조하세요.

컨테이너가 실행될 때마다 카메라가 새 장치에 처음 연결된 것처럼 동작합니다. ZED SDK가 보정 파일과 AI 모델을 찾지 못하고 다시 다운로드를 시도합니다.

보정 파일

호스트 폴더 /usr/local/zed/settings/를 볼륨으로 마운트하여 컨테이너가 호스트 컴퓨터에 저장된 보정 파일을 사용하도록 하세요.

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

<docker_image>를 이미지 이름으로 바꾸세요. 호스트에도 인터넷 연결이 없는 경우 이 기사에 설명된 대로 다른 컴퓨터에서 보정 파일을 다운로드한 다음 호스트 설정 폴더에 복사하세요.

AI 모델

ZED SDK의 AI 모듈(신경 깊이 모드, 객체 감지, 바디 트래킹)을 사용하는 로봇에는 최적화된 AI 모델도 필요합니다. 호스트 폴더 /usr/local/zed/resources/를 볼륨으로 마운트하세요.

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

모델은 컨테이너에서 사용하는 것과 동일한 GPU 모델 및 동일한 ZED SDK 버전에서 최적화해야 합니다. ZED SDK AI 모델을 수동으로 최적화하려면 어떻게 해야 하나요?를 참조하세요.

GMSL2 카메라(ZED X 제품군)의 경우 ZED X 드라이버에 추가 볼륨과 장치가 필요합니다. Docker 문서를 참조하세요.