Pourquoi ne puis-je pas utiliser la caméra ZED X avec « ssh -X » en mode sans tête ?

Last updated: August 13, 2026

Le pilote de notre gamme de caméras ZED X (ZED X, ZED X Mini, ZED X One GS, ZED X One 4K) repose sur l'API NVIDIA Argus, qui utilise EGLStream pour des performances optimales. Cependant, elle est incompatible avec le transfert X11 (ssh -X) en mode headless (aucun écran connecté).

Remarque : Cette page d'assistance s'applique à toutes les méthodes de bureau à distance qui nécessitent la configuration d'un écran virtuel, telles que Remmina, VNC, NoMachine, RustDesk, TeamViewer, xrdp et autres.

Explication

Lorsqu'aucun écran n'est connecté, l'API Argus crée un contexte EGL NULL, permettant à EGLStream de fonctionner de manière transparente.

Lors de l'utilisation de ssh -X, EGLStream détecte l'écran du bureau distant et tente de créer un contexte EGL pour celui-ci. Cependant, comme la plupart des ordinateurs de bureau ne prennent pas en charge EGL (qui est exclusivement réservé aux appareils embarqués), cela crée un contexte non valide et empêche le pilote ZED X de s'initialiser.

SOLUTIONS

Matériel

Pour résoudre ce problème, vous pouvez connecter un adaptateur d'écran factice (HDMI ou DisplayPort) à votre appareil Jetson. Grâce à cet adaptateur, EGLStream peut fonctionner comme si un véritable écran était connecté au Jetson, ce qui lui permet de créer un contexte valide et de permettre au pilote ZED X de fonctionner correctement.

Remarque : Si la machine distante est un autre appareil Jetson, les adaptateurs factices sont généralement inutiles, car un EGLContext valide peut être établi puisqu'il prend en charge EGL.

Logiciel

Nous fournissons un guide étape par étape et un script prêt à l'emploi qui vous permet de désactiver la sortie physique de l'écran et d'activer à la place un écran virtuel logiciel.

Avec cette configuration, vous pouvez vous connecter à distance à un appareil NVIDIA® Jetson via SSH ou une application de bureau virtuel, sans avoir besoin d'un adaptateur d'écran factice.

Remarque : Le transfert X11 n'est pas pris en charge.

Vous pouvez trouver le guide complet dans la section ZED SDK de la Documentation Stereolabs.

Avertissement

Remarque : Ce guide ne s'applique pas aux outils du ZED SDK (c.-à-d., ZED Explorer, ZED Depth Viewer, ZEDfu, ZED Sensor Viewer), car ils restent incompatibles avec ssh -X, même lorsqu'ils utilisent un plug-in factice ou la solution logicielle.