Il mio sensore ZED ha smesso di funzionare. Come scaricare il file diagnostico?

Last updated: October 23, 2026

Se la tua videocamera ZED non funziona come previsto, lo ZED Diagnostics strumento può generare un report diagnostico che consente al nostro team di supporto di analizzare la configurazione del sistema e identificare la fonte del problema.

Segui la procedura riportata di seguito per generare il file diagnostico e inviarlo a support@stereolabs.com.

Passaggio 1: installa la versione più recente di ZED SDK

Scarica e installa la versione più recente di ZED SDK dalla nostra pagina Sviluppatori. Molti problemi vengono risolti semplicemente aggiornando alla versione più recente di SDK.

Al termine dell'installazione, riavvia il computer per ricaricare le variabili d'ambiente e assicurarti che nulla interferisca con ZED SDK.

Passaggio 2: collega la videocamera

Collega la videocamera ZED al dispositivo. Se possiedi più videocamere, collegale e testale una alla volta.

Nota per le videocamere GMSL2 (Famiglia ZED X, ZED X Uno): qualsiasi modifica alla configurazione hardware, come il collegamento o lo scollegamento di una videocamera oppure la modifica dell'ordine delle videocamere, richiede il riavvio del Jetson o il riavvio del daemon con:

sudo systemctl restart zed_x_daemon

Passaggio 3: esegui lo strumento ZED Diagnostics

  • Windows: apri il menu Start e cerca "ZED Diagnostic" nella cartella ZED SDK oppure esegui C:\Program Files (x86)\ZED SDK\tools\ZED Diagnostic.exe (fai clic con il pulsante destro del mouse e seleziona "Esegui come amministratore").

  • Linux / NVIDIA Jetson: apri un terminale e digita ZED_Diagnostic, oppure eseguilo dalla directory di installazione di ZED SDK: /usr/local/zed/tools/ZED_Diagnostic.

Premi il pulsante Avvia ; lo strumento rileverà automaticamente la videocamera collegata ed eseguirà una serie di controlli: versioni di ZED SDK e CUDA, informazioni sul processore e sulla scheda madre, modello della GPU, stato del modello AI, test dell'hardware della videocamera (modello e versione del firmware) e stato della connettività.

Passaggio 4: salva e invia il file diagnostico

Al termine del processo diagnostico, premi il pulsante Salva per esportare il report diagnostico come file JSON.

Pulsante Salva di ZED Diagnostic

Invia il file a support@stereolabs.com, includendo una descrizione dettagliata del problema riscontrato: cosa succede, quando è iniziato e i messaggi di errore esatti, se presenti. Più contesto fornisci, più velocemente potremo aiutarti.

Videocamere USB 3: controlli rapidi

Se utilizzi una videocamera USB 3 (ZED 2i, ZED Mini, oppure le videocamere ZED e ZED 2 non più in produzione), prova anche i seguenti controlli:

  • Rimuovi eventuali cavi di prolunga USB o hub USB e collega la videocamera direttamente a una porta USB 3 del computer.

  • Prova la videocamera su un altro computer: potrebbe comportarsi diversamente e fornirci maggiori informazioni sul problema.

  • ZED Mini: il connettore USB Type-C sul lato della videocamera non è reversibile; allinea le frecce incise sul connettore del cavo con il lato ottico della videocamera. Prova entrambi i cavi USB forniti con la videocamera.

  • ZED 2i: il connettore USB Type-C è reversibile; assicurati che le viti del connettore siano ben serrate.

Videocamere GMSL2: includi i log del kernel

Se utilizzi una videocamera ZED X o ZED X Uno con una scheda di acquisizione ZED Link, una ZED Box o una scheda carrier di terze parti, allega anche i log del kernel/driver, essenziali per il debug dei problemi di connessione GMSL2. Puoi recuperarli con l'opzione dedicata di ZED Diagnostics:

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

oppure manualmente con:

sudo dmesg | grep zedx

Per ulteriori informazioni sui problemi GMSL2 comuni (videocamera non rilevata, aggiornamento del driver, velocità delle linee MIPI su Xavier NX / Orin NX, immagini sfocate dopo un aggiornamento del sistema), consulta le nostre guide dedicate alla risoluzione dei problemi:

Sistemi headless (nessun display disponibile)

Se il dispositivo non dispone di un'interfaccia grafica, ad esempio un Jetson a cui si accede tramite SSH, puoi eseguire lo strumento in modalità riga di comando:

ZED_Diagnostic -c

L'elenco completo delle opzioni della riga di comando è disponibile con ZED_Diagnostic -h ed è documentato nella documentazione di ZED Diagnostics.

Informazioni aggiuntive

Lo strumento ZED Diagnostics può anche scaricare e ottimizzare i modelli AI utilizzati da ZED SDK (modalità di profondità NEURALE, rilevamento oggetti, tracciamento del corpo) e recuperare il modulo MCU di ZED 2 / ZED 2i con un numero di serie non valido. Consulta la documentazione di ZED Diagnostics per ulteriori dettagli.