Perché non riesco a utilizzare la videocamera ZED X con "ssh -X" in modalità headless?
Last updated: October 23, 2026
Il driver delle nostre telecamere GMSL2 (ZED X, ZED X Mini, ZED X Nano, ZED X One GS, ZED X One S, e ZED X One 4K) si basa sull' NVIDIA Argus API, che utilizza EGLStream per ottenere prestazioni ottimali. Tuttavia, non è compatibile con X11 forwarding (ssh -X) in modalità headless (nessun display collegato).
Nota: questo articolo si applica anche 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'Argus API 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 in questa configurazione, il risultato è un contesto non valido che impedisce l'inizializzazione del driver ZED X.
SOLUZIONI
hardware
Collegare un dummy display plug (HDMI o DisplayPort) al dispositivo NVIDIA® Jetson™ dispositivo. Con un dummy plug, EGLStream funziona come se fosse collegato un display reale al Jetson, quindi può creare un contesto valido e il driver ZED X funziona correttamente.

Nota: se la macchina remota è un altro dispositivo Jetson, in genere non è necessario un dummy plug, perché è possibile stabilire un contesto EGL valido.
Software
Forniamo una guida passo passo e uno script pronto all'uso per 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™ tramite SSH o un'applicazione desktop virtuale, senza un dummy display plug.
Nota: X11 forwarding non è supportato.
La guida completa è disponibile nella documentazione Virtual Display (Headless Mode) .
Avvertenza
Queste soluzioni non si applicano agli strumenti di ZED SDK (ZED Explorer, ZED Depth Viewer, ZEDfu, ZED Sensor Viewer), che rimangono incompatibili con ssh -X, anche quando si utilizza un dummy plug o la soluzione software.