Mon capteur ZED a cessé de fonctionner. Comment télécharger le fichier de diagnostic ?
Last updated: October 23, 2026
Si votre caméra ZED ne fonctionne pas comme prévu, l’outil ZED Diagnostics peut générer un rapport de diagnostic qui permet à notre équipe d’assistance d’analyser la configuration de votre système et d’identifier la source du problème.
Veuillez suivre la procédure ci-dessous pour générer le fichier de diagnostic et l’envoyer à support@stereolabs.com.
Étape 1 : Installer la dernière version de ZED SDK
Téléchargez et installez la dernière version de ZED SDK depuis notre page Développeurs. De nombreux problèmes sont résolus par une simple mise à jour vers la version la plus récente du SDK.
Après l’installation, redémarrez votre ordinateur afin de recharger les variables d’environnement et de vous assurer que rien n’interfère avec ZED SDK.
Étape 2 : Connecter la caméra
Connectez la caméra ZED à votre appareil. Si vous possédez plusieurs caméras, veuillez connecter et tester une seule caméra à la fois.
Remarque concernant les caméras GMSL2 (famille ZED X, ZED X One) : toute modification de la configuration matérielle, telle que le branchement ou le débranchement d’une caméra, ou la modification de l’ordre des caméras, nécessite soit de redémarrer le Jetson, soit de redémarrer le démon avec :
sudo systemctl restart zed_x_daemonÉtape 3 : Exécuter l’outil ZED Diagnostics
Windows : ouvrez le menu Démarrer et recherchez « ZED Diagnostic » dans le dossier ZED SDK, ou exécutez
C:\Program Files (x86)\ZED SDK\tools\ZED Diagnostic.exe(clic droit, « Exécuter en tant qu’administrateur »).Linux / NVIDIA Jetson : ouvrez un terminal et saisissez
ZED_Diagnostic, ou exécutez-le depuis le répertoire d’installation de ZED SDK :/usr/local/zed/tools/ZED_Diagnostic.
Appuyez sur le bouton Démarrer ; l’outil détectera automatiquement la caméra connectée et effectuera une série de vérifications : versions de ZED SDK et de CUDA, informations sur le processeur et la carte mère, modèle du GPU, état du modèle d’IA, tests du matériel de la caméra (modèle et version du micrologiciel), ainsi que l’état de la connectivité.
Étape 4 : Enregistrer et envoyer le fichier de diagnostic
Une fois le processus de diagnostic terminé, appuyez sur le bouton Enregistrer pour exporter le rapport de diagnostic sous forme de fichier JSON.

Envoyez le fichier à support@stereolabs.com, en incluant une description détaillée du problème rencontré : ce qui se passe, quand le problème a commencé et les messages d’erreur exacts, le cas échéant. Plus vous fournissez de contexte, plus nous pourrons vous aider rapidement.
Caméras USB 3 : vérifications rapides
Si vous utilisez une caméra USB 3 (ZED 2i, ZED Mini, ou les modèles ZED et ZED 2 qui ne sont plus commercialisés), veuillez également effectuer les vérifications suivantes :
Retirez tout câble d’extension USB ou concentrateur USB, et connectez directement la caméra à un port USB 3 de l’ordinateur.
Testez la caméra sur un autre ordinateur : elle peut se comporter différemment et nous fournir davantage d’informations sur le problème.
ZED Mini : le connecteur USB Type-C situé du côté de la caméra n’est pas réversible; faites correspondre les flèches gravées sur le connecteur du câble avec le côté optique de la caméra. Testez les deux câbles USB fournis avec la caméra.
ZED 2i : le connecteur USB Type-C est réversible ; assurez-vous que les vis du connecteur sont bien serrées.
Caméras GMSL2 : inclure les journaux du noyau
Si vous utilisez une caméra ZED X ou ZED X One avec une carte d’acquisition ZED Link, une ZED Box ou une carte porteuse tierce, veuillez également joindre les journaux du noyau/pilote, qui sont essentiels pour déboguer les problèmes de connexion GMSL2. Vous pouvez les récupérer à l’aide de l’option dédiée de ZED Diagnostics :
sudo /usr/local/zed/tools/ZED_Diagnostic --dmesgou manuellement avec :
sudo dmesg | grep zedxPour plus d’informations sur les problèmes GMSL2 courants (caméra non détectée, mise à niveau du pilote, vitesse des voies MIPI sur Xavier NX / Orin NX, images floues après une mise à jour du système), veuillez consulter nos guides de dépannage dédiés :
Systèmes sans interface graphique (aucun affichage disponible)
Si votre appareil ne dispose d’aucune interface graphique, par exemple un Jetson accessible via SSH, vous pouvez exécuter l’outil en mode ligne de commande :
ZED_Diagnostic -cLa liste complète des options de ligne de commande est disponible avec ZED_Diagnostic -h et est documentée dans la documentation de ZED Diagnostics.
Informations supplémentaires
L’outil ZED Diagnostics peut également télécharger et optimiser les modèles d’IA utilisés par ZED SDK (modes de profondeur NEURAL, détection d’objets, suivi du corps), ainsi que récupérer un module MCU ZED 2 / ZED 2i dont le numéro de série est invalide. Consultez la documentation de ZED Diagnostics pour plus de détails.