내 ZED 센서가 작동을 멈췄습니다. 진단 파일을 다운로드하려면 어떻게 해야 하나요?

Last updated: August 13, 2026

ZED 카메라가 예상대로 작동하지 않는 경우, ZED Diagnostics 도구를 사용하여 지원팀이 시스템 구성을 분석하고 문제의 원인을 파악할 수 있는 진단 보고서를 생성할 수 있습니다.

아래 절차에 따라 진단 파일을 생성하고 support@stereolabs.com으로 보내 주세요.

1단계: 최신 ZED SDK 설치

개발자들 페이지에서 최신 ZED SDK를 다운로드하여 설치하세요. 최신 SDK 버전으로 업데이트하는 것만으로 많은 문제가 해결됩니다.

설치 후 컴퓨터를 다시 시작하여 환경 변수를 다시 로드하고 ZED SDK를 방해하는 요소가 없는지 확인하세요.

2단계: 카메라 연결

ZED 카메라를 장치에 연결하세요. 여러 대의 카메라를 소유하고 있는 경우 한 번에 한 대씩 연결하여 테스트하세요.

GMSL2 카메라(ZED X, ZED X One)에 대한 참고 사항: 카메라를 연결하거나 분리하거나 카메라 순서를 변경하는 등 하드웨어 구성에 변경 사항이 있는 경우 Jetson을 재부팅하거나 다음 명령을 사용하여 데몬을 다시 시작해야 합니다:

sudo systemctl restart zed_x_daemon

3단계: ZED Diagnostics 도구 실행

Windows: 시작 메뉴를 열고 ZED SDK 폴더에서 "ZED Diagnostic"을 검색하거나 C:\Program Files (x86)\ZED SDK\tools\ZED Diagnostic.exe를 실행하세요(마우스 오른쪽 버튼을 클릭하고 "관리자 권한으로 실행").
Linux / NVIDIA Jetson: 터미널을 열고 ZED_Diagnostic을 입력하거나 ZED SDK 설치 디렉터리에서 실행하세요: /usr/local/zed/tools/ZED_Diagnostic.

시작 버튼을 누르면 도구가 연결된 카메라를 자동으로 감지하고 다음과 같은 일련의 검사를 수행합니다: ZED SDK 및 CUDA 버전, 프로세서 및 마더보드 정보, GPU 모델, AI 모델 상태, 카메라 하드웨어 테스트(모델 및 펌웨어 버전), 연결 상태.

4단계: 진단 파일 저장 및 전송

진단 과정이 완료되면 저장 버튼을 눌러 진단 보고서를 JSON 파일로 내보냅니다.

문제가 발생한 상황에 대한 자세한 설명(무슨 일이 발생했는지, 언제 시작되었는지, 해당되는 경우 정확한 오류 메시지)을 포함하여 파일을 support@stereolabs.com으로 보내 주세요. 더 많은 맥락을 제공할수록 더 빠르게 도움을 드릴 수 있습니다.

GMSL2 카메라: 커널 로그 포함

ZED X 또는 ZED X One 카메라를 ZED Link 캡처 카드, ZED 박스 또는 타사 캐리어 보드와 함께 사용하는 경우, GMSL2 연결 문제를 디버깅하는 데 필수적인 커널/드라이버 로그도 첨부해 주세요. 전용 ZED 진단 옵션을 사용하여 로그를 가져올 수 있습니다:

sudo /usr/local/zed/tools/ZED_Diagnostic --dmesg

또는 다음 명령을 사용하여 수동으로 가져올 수 있습니다:

sudo dmesg | grep zedx

일반적인 GMSL2 문제(카메라가 감지되지 않음, 드라이버 업그레이드, Xavier NX / Orin NX의 MIPI 레인 속도, 시스템 업데이트 후 흐릿한 이미지)에 대한 자세한 내용은 전용 문제 해결 가이드를 참조하세요:

헤드리스 시스템(사용 가능한 디스플레이 없음)

예를 들어 SSH를 통해 액세스하는 Jetson처럼 장치에 GUI를 사용할 수 없는 경우 명령줄 모드로 도구를 실행할 수 있습니다:

ZED_Diagnostic -c

전체 명령줄 옵션 목록은 ZED_Diagnostic -h를 사용하면 확인할 수 있으며, ZED Diagnostics 문서에 설명되어 있습니다.

추가 정보

ZED Diagnostics 도구는 ZED SDK에서 사용하는 AI 모델(신경 깊이 모드, 객체 감지, 바디 트래킹)을 다운로드하고 최적화할 수 있으며, 잘못된 일련 번호가 있는 ZED 2 / ZED 2i MCU 모듈을 복구할 수도 있습니다. 자세한 내용은 ZED Diagnostics 문서를 참조하세요.