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.

Dummy display plug HDMI

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.