なぜヘッドレスモードで「ssh -X」を使用して ZED X カメラを使えないのですか?
Last updated: October 23, 2026
GMSL2カメラ(ZED X、 ZED X Mini、 ZED X Nano、 ZED X One GS、 ZED X One S、およびZED X One 4K)のドライバーは NVIDIA Argus APIに依存しており、最適なパフォーマンスのためにEGLStreamを使用します。ただし、 X11 forwarding (ssh -X)とは互換性がありません(ディスプレイが接続されていないヘッドレスモードの場合)。
注: この記事は、Remmina、VNC、NoMachine、RustDesk、TeamViewer、xrdp、その他のように、仮想ディスプレイの設定が必要なすべてのリモートデスクトップ方式にも適用されます。
説明
ディスプレイが接続されていない場合、Argus APIはNULL EGLコンテキストを作成するため、EGLStreamは問題なく動作します。
使用すると、 ssh -XEGLStreamはリモートデスクトップの画面を検出し、その画面用のEGLコンテキストを作成しようとします。しかし、ほとんどのデスクトップPCはこの構成でEGLをサポートしていないため、無効なコンテキストが生成され、ZED Xドライバーの初期化が妨げられます。
解決策
ハードウェア
NVIDIA ダミーディスプレイプラグ (HDMIまたはDisplayPort)を® Jetson™ デバイスに接続します。ダミープラグを使用すると、EGLStreamは実際のディスプレイがJetsonに接続されているかのように動作するため、有効なコンテキストを作成でき、ZED Xドライバーが正常に動作します。

注: リモートマシンが別のJetsonデバイスの場合、通常はダミープラグは必要ありません。有効なEGLコンテキストを確立できるためです。
ソフトウェア
物理ディスプレイ出力を無効にし、代わりにソフトウェアベースの仮想ディスプレイを有効にするための、手順ごとのガイドとすぐに使えるスクリプトを提供しています。この設定により、ダミーディスプレイプラグなしで、SSHまたは仮想デスクトップアプリケーションを介してリモートのNVIDIA® Jetson™ デバイスに接続できます。
注: X11 forwardingはサポートされていません。
完全なガイドは 仮想ディスプレイ(ヘッドレスモード) ドキュメントにあります。
警告
これらの解決策はZED SDKツール(ZED Explorer、ZED Depth Viewer、ZEDfu、ZED Sensor Viewer)には適用されません。これらのツールは、ダミープラグまたはソフトウェアソリューションを使用した場合でも、 ssh -Xとは互換性がありません。