Perché non riesco a utilizzare la videocamera ZED X con "ssh -X" in modalità headless?

Last updated: August 13, 2026

Il driver della nostra linea di fotocamere ZED X (ZED X, ZED X Mini, ZED X Uno GS, ZED X Uno 4K) si basa sull'API Argus di NVIDIA, che utilizza EGLStream per prestazioni ottimali. Tuttavia, non è compatibile con l'inoltro X11 (ssh -X) in modalità headless (senza display collegato).

Nota: questa pagina di supporto si applica a tutti i metodi di desktop remoto che richiedono la configurazione di un display virtuale, come Remmina, VNC, NoMachine, RustDesk, TeamViewer, xrdp e altri.

Spiegazione

Quando non è collegato alcun display, l'API Argus crea un contesto EGL NULL, consentendo a EGLStream di funzionare senza problemi.
Quando si utilizza ssh -X, EGLStream rileva lo schermo del desktop remoto e tenta di creare un contesto EGL per esso. Tuttavia, poiché la maggior parte dei PC desktop non supporta EGL (che è esclusivo dei dispositivi embedded), ciò produce un contesto non valido e impedisce l'inizializzazione del driver ZED X.

Soluzioni

Hardware

Per risolvere il problema, è possibile collegare un connettore dummy per display (HDMI o DisplayPort) al dispositivo Jetson. Utilizzando un connettore dummy, EGLStream può funzionare come se fosse collegato un display reale al Jetson, consentendogli di creare un contesto valido e permettendo al driver ZED X di funzionare correttamente.

Nota: Se la macchina remota è un altro dispositivo Jetson, i connettori dummy sono generalmente superflui, poiché è possibile stabilire un EGLContext valido grazie al supporto EGL.

Software

Forniamo una guida dettagliata e uno script pronto all'uso che consente di disabilitare l'uscita del display fisico e abilitare invece un display virtuale basato su software.

Con questa configurazione, è possibile connettersi a un dispositivo NVIDIA® Jetson remoto tramite SSH o un'applicazione desktop virtuale, senza richiedere un connettore dummy.

Nota: l'inoltro X11 non è supportato.

Puoi trovare la guida completa nella sezione ZED SDK della Documentazione di Stereolabs.

Avviso

Nota: Questa guida non si applica agli strumenti ZED SDK (ovvero ZED Explorer, ZED Depth Viewer, ZEDfu, ZED Sensor Viewer), poiché rimangono incompatibili con ssh -X, anche quando si utilizza un dummy plug o la soluzione software.