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

Last updated: August 13, 2026

El controlador de nuestra línea de cámaras ZED X (ZED X, ZED X Mini, ZED X Uno GS, ZED X Uno 4K) depende de la API NVIDIA Argus, que utiliza EGLStream para obtener un rendimiento óptimo. Sin embargo, es incompatible con el reenvío X11 (ssh -X) en modo sin monitor (sin ninguna pantalla conectada).

Nota: Esta página de soporte 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, dado que la mayoría de los ordenadores de escritorio no son compatibles con EGL (que es exclusivo de los dispositivos integrados), esto da como resultado un contexto no válido e impide que el controlador ZED X se inicialice.

Soluciones

hardware

Para resolver esto, puede conectar un adaptador de pantalla ficticio (HDMI o DisplayPort) a su dispositivo Jetson. Al utilizar un adaptador ficticio, EGLStream puede ejecutarse como si hubiera una pantalla real conectada al Jetson, lo que le permite crear un contexto válido y habilita el funcionamiento correcto del controlador ZED X.

Nota: Si la máquina remota es otro dispositivo Jetson, normalmente no se necesitan adaptadores ficticios, ya que se puede establecer un EGLContext válido porque es compatible con EGL.

Software

Proporcionamos una guía paso a paso y un script listo para usar que permite deshabilitar la salida de pantalla física y habilitar en su lugar 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 ficticio.

Nota: El reenvío X11 no es compatible.

Puedes encontrar la guía completa en la sección del ZED SDK de la documentación de Stereolabs.

Advertencia

Nota: Esta guía no se aplica a las herramientas del ZED SDK (es decir, ZED Explorer, ZED Depth Viewer, ZEDfu, ZED Sensor Viewer), ya que siguen siendo incompatibles con ssh -X, incluso al utilizar un enchufe ficticio o la solución de software.