1. GMSL2-USB 3.0変換キット ユーザーマニュアル#

このマニュアルは、TIER IV の GMSL2-USB3.0 変換キットのユーザーを対象としています。本マニュアルで解決できないご質問や問題がございましたら、お買い上げの販売店にご連絡ください。

USBキット

1.1. リリースノート#

日付

説明

2023 年 2 月 7 日。

初版の発行

1.2. はじめに#

GMSL2-USB3.0 変換キットを使用すると、TIER IV 車載 HDR カメラ C1/C2 (以下、C1 および C2 カメラと呼びます) カメラを USB Type-C (3.0) ポートに接続し、UVC (USB ビデオ クラス) 経由でビデオをキャプチャできるようになります。 ）。 GMSL インターフェイスを持たないコンピュータ上のアプリケーションで C1 カメラと C2 カメラを使用できます。

1.3. インターフェースの説明#

製品概要

1.3.1. カメラインターフェース#

カメラとキット間の接続インターフェースは、Fakra プラグ (C コード ブルー) が取り付けられた 50 Ω 同軸ケーブルです。

1.3.2. USB Type-Cインターフェース#

キットとホスト間の接続インターフェイスは、USB Type-C で USB 3.0 Super Speed をサポートします。また、業界標準のネジロック式または非ネジロック式 USB Type-C ケーブルも使用できます。

1.3.3. IO ポート (組み込み RITS 4P コネクタ)#

FSYNC信号(フレーム同期)と外部DC電源入力用です。このポートは 4-P RITS ボード マウント ヘッダー (TE Connectivity 156994-4) を使用します。対応するプラグ コネクタの部品番号は x-1473562-4 です。このポートを使用する必要がある場合は、上記のプラグを使用してケーブルをご自身でご用意ください。

各ピンの説明は次のとおりです。

ext_io_port

ポート

名前

説明

1

外部電源

供給電圧範囲: 9V ~ 12V (C1/C2 カメラ用)、必要な供給電流: > 1A 注: これは、USB ホストが十分な電力を供給できない場合に、外部からカメラに電力を供給するための代替手段です。

2

GND

3

GND

4

外部FSYNC信号入力（カメラトリガーモードのみ）

FSYNCはプッシュプルまたはオープンドレインの外部出力駆動タイプをサポートします。

FSYNC がプッシュプル タイプの外部出力駆動とペアの場合: 入力信号電圧: ハイ レベル: 1.8 V ～ 24 V、ロー レベル: < 0.2 V。

FSYNC がオープンドレイン タイプの外部出力駆動とペアの場合: FSYNC 内部にプルアップ レジスタが内蔵されているため、外部オープンドレイン駆動にプルアップは必要ありません。外部デバイス駆動の要件: 駆動低シンク電流: > 1mA、および低レベル: < 0.2V。

FSYNC 周波数: カメラ モジュールのフレーム レートのサポートに依存します。

FSYNC信号ハイレベルパルス幅(Tパルス): 1ms < Tパルス < 30ms

1.3.4. リセットボタン#

ボタンを押して離すことで変換キットをリセットします。

1.3.5. 動作モード切り替えスイッチ#

動作モードを選択するスライドスイッチです。通常操作の場合は左にスライドさせ、ファームウェアのアップデートの場合は右にスライドさせます。

モードSW

1.4. 使用方法#

注意

キット購入時はC1フリーランモード(フリーラン、30fps)に設定されています。

本キットと C2 カメラを使用するには、ファームウェアをアップデートする必要があります。詳細については、カメラモードを変更するを参照してください。

また、C2カメラの場合、USB3.0の帯域制限により最大フレームレートが10fpsに制限され、イメージセンサーからの読み出し速度がGMSL接続の場合より遅くなります。これにより、ローリング シャッター効果（歪み）が発生する可能性があります。

キット購入時はC1フリーランモード(フリーラン、30fps)に設定されています。このモードで使用する場合はそのままお使いいただけます。別のモードへの切り替えが必要な場合は、ファームウェア一覧およびカメラモードを変更するを参照してください。

1.4.1. ファームウェアリスト#

カメラモード

説明

画像ファイル

C1 フリーランモード（デフォルトモード）

C1カメラ用 フリーラン 10,20,30FPS

C1_フリーラン_v1.10a.img

C1 ハードウェアトリガーモード

C1 カメラの場合、IO ポートからの FSYNC トリガー

C1_トリガー_v1.00b.img

C2 フリーランモード

C2カメラ用 フリーラン 10FPS

C2_フリーラン_v1.00c.img

C2 ハードウェアトリガーモード

C2 カメラの場合、IO ポートからの FSYNC トリガー

C2_トリガー_v1.00d.img

注釈

これらのイメージ ファイルは、CX3Update パッケージに含まれています。

1.4.2. フリーランモード#

次の図と手順に示すようにPC、カメラ、変換キットを接続して下さい 接続する

Fakra ケーブルでカメラを変換キットに接続し、USB ケーブルを使用してホストに接続してください。順序が逆の場合 (カメラを接続する前に、最初に USB ケーブルでホストに接続した場合)、リセット ボタンを押す必要があります。このキットは、USB 経由で接続すると UVC カメラ デバイスとして認識されます。デバイスを UVC カメラとして使用するために別途ドライバをインストールする必要はありません。接続後、アプリを使用してカメラから「GMSL2-USB3.0変換キット」を選択し、使用を開始してください。

カメラデバイスが見つからない場合、または画像が正常でない場合は、トラブルシューティングセクションで詳細を確認してください。

1.4.3. トリガーモード#

RITSコネクタをケーブルで接続し、フリーランモードと同様に信号を送信します。コネクタ形状と伝送する信号についてはIOポート組み込みRITS 4Pコネクタの項を参照してください。また、事前にファームウェアのアップデートによるモード変更が必要となりますのでご注意ください。

接続

For C1 cameras, the exposure will start when the signal is transmitted and stops after the exposure time. For C2 cameras, the readout will start when the signal is transmitted and the exposure will starts before the time of exposure setting.

カメラの使い方に関しては、シャッタータイミングの送信以外はフリーランモードと同じです。

1.5. アプリケーションでの使用例#

1.5.1. GStreamer#

このセクションでは、GStreamer を使用したビデオ取得について説明します。この項目で説明する手順は、Ubuntu20.04 を対象としています。

まず、以下のコマンドで GStreamer と v4l-utils をインストールします。すでにインストールされている場合は、本項目を実行する必要はありません。

$ sudo apt install libgstreamer1.0-0 gstreamer1.0-tools
$ sudo apt install v4l-utils

次に、使用する環境におけるデバイス名を確認します。次のコマンドは、接続されているデバイスを表示します。デバイス名が分かっている場合は、本項目を実行する必要はありません。

v4l2-ctl  --list-devices

以下は出力の例です。

Integrated IR Camera: Integrate (usb-0000:00:14.0-12):
	/dev/video2
	/dev/video3

GMSL2-USB3.0 Conversion Kit (usb-0000:00:14.0-2):
	/dev/video4
	/dev/video5

Integrated Camera: Integrated C (usb-0000:00:14.0-8):
	/dev/video0
	/dev/video1

ご利用の環境によって結果が異なりますので、「GMSL2-USB3.0変換キット」と表示されている項目とその上にあるデバイス「/dev/video4」を探してください。次に、次のコマンドで GStreamer を実行します。

gst-launch-1.0 v4l2src io-mode=0 device=/dev/video4 do-timestamp=true ! 'video/x-raw, width=1920, height=1280, framerate=30/1, format=UYVY' ! videoscale ! xvimagesink sync=false

なお、この際のフレームレートは10/20/30fpsの3パターンで設定可能です。フレームレートを10fpsに設定するには、次のように実行します。

gst-launch-1.0 v4l2src io-mode=0 device=/dev/video4 do-timestamp=true ! 'video/x-raw, width=1920, height=1280, framerate=10/1, format=UYVY' ! videoscale ! xvimagesink sync=false

1.5.2. ROS2#

ROS2 Galatic ディストリビューションをターゲットとする 2 種類のノード、「usb_cam」ノードと「v4l2 カメラ」ノードの使用方法を説明します。ただし、ノードが UYVY カラーの UVC 形式をサポートしている場合は、ビデオを取得できます。公式サイトなどを参照して、事前にROS2 Gaopticをインストールしてください。

1.5.2.1. usb_cam ノード#

次のリポジトリから usb_cam ノードをcloneしてビルドして下さい。ビルド手順についてはリポジトリの README を参照してください。

usb_cam ノード リポジトリ: https://github.com/tier4/usb_cam

ビルドが完了したら以下のコマンドを実行してください。

ros2 run usb_cam usb_cam_node_exe --ros-args \
  -p video_device:=/dev/video0 \
  -p framerate:=30.0 \
  -p pixel_format:=uyvy \
  -p image_width:=1920 \
  -p image_height:=1280

1.5.2.2. v4l2_カメラ#

次のリポジトリから「v4l2_camera」ノードをcloneしてビルドして下さい。ビルド手順についてはリポジトリの README を参照してください。

v4l2_camera ノード リポジトリ: https://github.com/tier4/ros2_v4l2_camera

ビルドが完了したら以下のコマンドを実行してください。

ros2 run v4l2_camera v4l2_camera_node --ros-args \
  -p video_device:=/dev/video0 \
  -p pixel_format:=UYVY \
  -p image_size:=[1920,1280]

1.6. トラブルシューティング#

画像が取得できない場合は、以下を参考にしてください。問題を解決できない場合は、購入代理店またはTIER IV サポートまでご連絡下さい。

1.6.1. アプリケーション内でデバイスが見つからない場合#

  • ModeSwitchが左にスライドしているか確認してください。

  • リセットボタンを押してデバイスが表示されるか確認してください。

  • USBケーブルの接続先ポートを変更し、デバイスが表示されるかご確認ください。

  • USB ケーブルが USB 3.0 Super Speed 以上と互換性があることを確認してください。ケーブルの相性の問題も考えられますので、仕様を満たすケーブルでも問題が解決しない場合は、別のケーブルをお試しください。

1.6.2. デバイスを選択しても画像が表示されない場合#

  • リセットボタンを押して画像を表示してみてください。

  • Fakra ケーブルが正しく接続されていることを確認してください。

  • ご使用のアプリケーションがUYVYカラーフォーマットに対応しているかご確認ください。

  • 書き込まれたファームウェアが現在接続されているカメラと互換性があることを確認してください。

  • 書き込まれたファームウェアが意図したモードであることを確認してください。C1カメラのフリーランモードではカメラは内部生成された同期信号に従って動作しますが、トリガーモードではIOポートに指定された信号が入力されないと画像が出力されません。

1.7. カメラモードを変更する#

警告

このセクションではキットのファームウェアを書き換えます。現在使用中のモードで操作したい場合は、この手順を実行しないでください。

本手順でカメラの動作モードを変更できます。一度変更したモードは電源を切っても戻りません。元の状態に戻すには、再度ファームウェアを書き換える必要があります。

本手順には Windows 環境が必要です。以下の手順は、Windows 10 におけるセットアップ手順を使用して説明します。

1.7.1. Cypressドライバーのインストール#

注釈

  • Driverのインストールは初期のみ必要です。

  • インストール中に.NET frameworkのインストールを求められる場合があります。インストールを求められた場合はインストールして下さい。

以下のリンクからドライバーファイルをダウンロードしてください。

CX3Update

1.7.1.1. ステップ 1: FW アップデートモードの選択#

モードスイッチを右側に倒し「FWアップデートモード」に切り替えます

モードSW

1.7.1.2. ステップ 2: デバイスを接続する#

キットを USB 端子に接続し、デバイス マネージャーを開いて、「WestBridge」という名前のデバイスが表示されていることを確認してください。

cx3_dev_1

1.7.1.3. ステップ 3: 「ドライバーの更新(P)」を選択します。#

WestBridge を選択し、右クリックして「ドライバーの更新(P)」を選択してください。 cx3_dev_1

1.7.1.4. ステップ 4: コンピューターでドライバーを参照する#

「コンピューターを参照してドライバー ソフトウェアを検索する」を選択します。次に、使用しているオペレーティング システムに対応するドライバー ファイルを選択します。 「ドライバーは正常に更新されました」と表示されればインストールは完了です。

cx3_dev_3 cx3_dev_3 cx3_dev_3 ![cx3_dev_3] ](./images/usbkit/cx3_dev_5.png)

1.7.1.5. ステップ 5: 変換キットをリセットする#

リセットボタンを押すか、USBを抜き差ししてリセットしてください。次に、「ユニバーサル シリアル バス コントローラー」の下に「Cypress FX3 USB BootLoader Device」が表示されていることを確認します。表示されれば準備完了です。

cx3_dev_3

1.7.2. ファームウェアの書き込み#

1.7.2.1. ステップ 1: FW アップデートモードの選択#

モードスイッチを右側に倒し「FWアップデートモード」に切り替えます

1.7.2.2. ステップ 2: デバイスを接続する#

USB ポートに端子を挿入すると、デバイス マネージャーのリストに新しいデバイス「Cypress FX3 USB BootLoader」が表示されます。

ファームウェア_1

1.7.2.3. ステップ 3: 「UpdateProgram」ディレクトリを開き、FW アップデート ツールを起動します。#

「UpdateProgram」を解凍し、Update Program ディレクトリを開きます。次に、「CyControl.exe」を実行します。

ファームウェア_1

1.7.2.4. ステップ 4: SPI フラッシュを選択する#

メニューで SPI_Flash を選択します (プログラム > FX3 > SPI_FLASH)。

ファームウェア_1

1.7.2.5. ステップ 5: 画像ファイルを選択する#

使用したいモードに対応するファイルを選択してくださいファームウェア_1

1.7.2.6. ステップ 6: プログラミングが成功するまで待ちます#

表示が「Programming of SPI_FLASH in Progress...」から「Programming of SPI_FLASH Succeeded.」に変わるまでお待ちください。

警告

書き込み中はケーブルを抜いたり、電源を切ったりしないでください。

ファームウェア_1 ファームウェア_1

1.7.2.7. ステップ 7: 変換キットをリセットする#

USB変換キットのモードスイッチを左（通常動作）にスライドさせ、リセットスイッチを押します。

1.7.2.8. ステップ 8: ファームウェアのバージョンを確認する#

デバイスマネージャーの「カメラ」に「GMSL2-USB3.0変換キット」があることを確認してください。また、デバイスのプロパティからもモードが変更されたことが確認できます。これでモード変更は完了です。

ファームウェア_1 ファームウェア_1

1.8. 参照文書#

参考

Raspberry piとGMSL2-USB3.0変換器を用いて TIER IV カメラから画像取得できますか？