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
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.