Por que não consigo usar a câmera ZED X com "ssh -X" no modo sem interface gráfica?

Last updated: August 13, 2026

O driver da nossa linha de câmeras ZED X (ZED X, ZED X Mini, ZED X One GS, ZED X One 4K) depende da API NVIDIA Argus, que utiliza o EGLStream para obter o desempenho ideal. No entanto, ela é incompatível com o encaminhamento X11 (ssh -X) no modo headless (sem um monitor conectado).

Observação: Esta página de suporte se aplica a todos os métodos de área de trabalho remota que exigem a configuração de um monitor virtual, como Remmina, VNC, NoMachine, RustDesk, TeamViewer, xrdp e outros.

Explicação

Quando nenhum monitor está conectado, a API Argus cria um contexto EGL NULL, permitindo que o EGLStream opere perfeitamente.
Ao usar ssh -X, o EGLStream detecta a tela da área de trabalho remota e tenta criar um contexto EGL para ela. No entanto, como a maioria dos PCs de mesa não oferece suporte a EGL (que é exclusivo de dispositivos embarcados), isso resulta em um contexto inválido e impede a inicialização do ZED X Driver.

Soluções

Hardware

Para resolver isso, você pode conectar um plugue de monitor fictício (HDMI ou DisplayPort) ao seu dispositivo Jetson. Ao usar um plugue fictício, o EGLStream pode funcionar como se um monitor real estivesse conectado ao Jetson, permitindo a criação de um contexto válido e possibilitando o funcionamento adequado do ZED X Driver.

Observação: Se a máquina remota for outro dispositivo Jetson, os plugues fictícios geralmente são desnecessários, pois um EGLContext válido pode ser estabelecido porque ele oferece suporte a EGL.

Software

Fornecemos um guia passo a passo e um script pronto para uso que permite desativar a saída física do monitor e ativar um monitor virtual baseado em software.

Com essa configuração, você pode se conectar a um dispositivo NVIDIA® Jetson remoto via SSH ou por meio de um aplicativo de área de trabalho virtual, sem precisar de um plugue de monitor fictício.

Observação: O encaminhamento X11 não é compatível.

Você pode encontrar o guia completo na seção do ZED SDK da documentação da Stereolabs.

Aviso

Nota: Este guia não se aplica às ferramentas do ZED SDK (ou seja, ZED Explorer, ZED Depth Viewer, ZEDfu, ZED Sensor Viewer), pois elas permanecem incompatíveis com ssh -X, mesmo quando se utiliza um plugue dummy ou a solução de software.