¿Por qué no puedo usar la cámara ZED X con "ssh -X" en modo sin interfaz gráfica?

Last updated: October 23, 2026

El controlador de nuestras cámaras GMSL2 (ZED X, ZED X Mini, ZED X Nano, ZED X One GS, ZED X One S, y ZED X One 4K) depende de la API NVIDIA Argus, que utiliza EGLStream para un rendimiento óptimo. Sin embargo, es incompatible con el reenvío de X11 (ssh -X) en modo sin pantalla (sin ninguna pantalla conectada).

Nota: este artículo también se aplica a todos los métodos de escritorio remoto que requieren configurar una pantalla virtual, como Remmina, VNC, NoMachine, RustDesk, TeamViewer, xrdp y otros.

Explicación

Cuando no hay ninguna pantalla conectada, la API Argus crea un contexto EGL NULL, lo que permite que EGLStream funcione sin problemas.

Al utilizar ssh -X, EGLStream detecta la pantalla del escritorio remoto e intenta crear un contexto EGL para ella. Sin embargo, como la mayoría de los PC de escritorio no admiten EGL en esta configuración, el resultado es un contexto no válido que impide que el controlador ZED X se inicialice.

SOLUCIONES

Hardware

Conecte un adaptador de pantalla ficticia (HDMI o DisplayPort) a su dispositivo NVIDIA® Jetson™ . Con un adaptador ficticio, EGLStream funciona como si hubiera una pantalla real conectada al Jetson, por lo que puede crear un contexto válido y el controlador ZED X funciona correctamente.

Adaptador de pantalla ficticia HDMI

Nota: si la máquina remota es otro dispositivo Jetson, normalmente no es necesario utilizar un adaptador ficticio, ya que se puede establecer un contexto EGL válido.

Software

Proporcionamos una guía paso a paso y un script listo para usar para desactivar la salida de pantalla física y activar una pantalla virtual basada en software. Con esta configuración, puede conectarse a un dispositivo NVIDIA® Jetson™ remoto mediante SSH o una aplicación de escritorio virtual, sin necesidad de un adaptador de pantalla ficticia.

Nota: el reenvío de X11 no es compatible.

Puede encontrar la guía completa en la documentación Pantalla virtual (modo sin pantalla) .

Advertencia

Estas soluciones no se aplican a las herramientas de ZED SDK (ZED Explorer, ZED Depth Viewer, ZEDfu, ZED Sensor Viewer), que siguen siendo incompatibles con el ssh -X, incluso cuando se utiliza un adaptador ficticio o la solución de software.