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

Last updated: August 13, 2026

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

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

Passaggio 1: installa l'ultima versione di ZED SDK

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

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

Passaggio 2: collega la fotocamera

Collega la fotocamera ZED al tuo dispositivo. Se possiedi più fotocamere, collegale e testale una alla volta.

Nota per le fotocamere GMSL2 (ZED X, ZED X Uno): qualsiasi modifica alla configurazione hardware, come collegare o scollegare una fotocamera o cambiare l'ordine delle fotocamere, richiede il riavvio del Jetson oppure il riavvio del demone 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 fotocamera 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 di intelligenza artificiale, test dell'hardware della fotocamera (modello e versione del firmware) e stato della connettività.

Passaggio 4: salva e invia il file diagnostico

Una volta completato il processo diagnostico, premi il pulsante Salva per esportare il report diagnostico come file JSON.

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

Fotocamere GMSL2: includi i log del kernel

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

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

o manualmente con:

sudo dmesg | grep zedx

Per ulteriori informazioni sui problemi GMSL2 più comuni (fotocamera non rilevata, aggiornamento del driver, velocità della corsia 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 tuo dispositivo non dispone di una GUI, ad esempio un Jetson a cui accedi 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 di IA utilizzati da ZED SDK (modalità di profondità NEURALE, rilevamento oggetti, tracciamento del corpo) e recuperare un modulo MCU di ZED 2 / ZED 2i con un numero di serie non valido. Consultare la documentazione di ZED Diagnostics per ulteriori dettagli.