Meu sensor ZED parou de funcionar. Como baixar o arquivo de diagnóstico?

Last updated: August 13, 2026

Se sua câmera ZED não estiver funcionando conforme esperado, a ferramenta Diagnóstico da ZED pode gerar um relatório de diagnóstico que permite que nossa equipe de suporte analise a configuração do seu sistema e identifique a origem do problema.

Siga o procedimento abaixo para gerar o arquivo de diagnóstico e enviá-lo para support@stereolabs.com.

Etapa 1: Instale o ZED SDK mais recente

Baixe e instale o ZED SDK mais recente em nossa página de Desenvolvedores. Muitos problemas são solucionados simplesmente atualizando para a versão mais recente do SDK.

Após a instalação, reinicie o computador para recarregar as variáveis de ambiente e garantir que nada esteja interferindo no ZED SDK.

Etapa 2: Conecte a câmera

Conecte a câmera ZED ao seu dispositivo. Se você tiver várias câmeras, conecte e teste uma câmera por vez.

Observação para câmeras GMSL2 (ZED X, ZED X One): qualquer modificação na configuração do hardware, como conectar ou desconectar uma câmera ou alterar a ordem das câmeras, exige reiniciar o Jetson ou reiniciar o daemon com:

sudo systemctl restart zed_x_daemon

Etapa 3: Execute a ferramenta Diagnóstico da ZED

  • Windows: abra o menu Iniciar e pesquise por "ZED Diagnostic" na pasta do ZED SDK ou execute C:\Program Files (x86)\ZED SDK\tools\ZED Diagnostic.exe (clique com o botão direito e selecione "Executar como administrador").
  • Linux / NVIDIA Jetson: abra um terminal e digite ZED_Diagnostic ou execute-o a partir do diretório de instalação do ZED SDK: /usr/local/zed/tools/ZED_Diagnostic.

Pressione o botão Iniciar; a ferramenta detectará automaticamente a câmera conectada e realizará uma série de verificações: versões do ZED SDK e do CUDA, informações do processador e da placa-mãe, modelo da GPU, status do modelo de IA, testes de hardware da câmera (modelo e versão do firmware) e status da conectividade.

Etapa 4: Salve e envie o arquivo de diagnóstico

Quando o processo de diagnóstico estiver concluído, pressione o botão Salvar para exportar o relatório de diagnóstico como um arquivo JSON.

Envie o arquivo para support@stereolabs.com, incluindo uma descrição detalhada do problema que você está enfrentando: o que acontece, quando começou e as mensagens de erro exatas, se houver. Quanto mais contexto você fornecer, mais rápido poderemos ajudar.

Câmeras GMSL2: inclua os logs do kernel

Se você estiver usando uma câmera ZED X ou ZED X One com uma placa de captura ZED Link, um ZED Box ou uma placa carrier de terceiros, anexe também os logs do kernel/driver, que são essenciais para depurar problemas de conexão GMSL2. Você pode recuperá-los com a opção dedicada do ZED Diagnostics:

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

ou manualmente com:

sudo dmesg | grep zedx

Para obter mais informações sobre problemas comuns do GMSL2 (câmera não detectada, atualização do driver, velocidade do lane MIPI no Xavier NX / Orin NX, imagens borradas após uma atualização do sistema), consulte nossos guias dedicados de solução de problemas:

Sistemas headless (sem monitor disponível)

Se o seu dispositivo não tiver uma interface gráfica disponível, por exemplo, um Jetson acessado via SSH, você pode executar a ferramenta no modo de linha de comando:

ZED_Diagnostic -c

A lista completa de opções de linha de comando está disponível com ZED_Diagnostic -h e está documentada na Documentação do ZED Diagnostics.

Informações adicionais

A ferramenta ZED Diagnostics também pode baixar e otimizar os modelos de IA usados pelo ZED SDK (modos de profundidade NEURAL, detecção de objetos, rastreamento corporal) e recuperar um módulo MCU do ZED 2 / ZED 2i com um número de série inválido. Consulte a Documentação do ZED Diagnostics para obter mais detalhes.