こんな人向けの記事です。

Kinesis video streams を試してみたい
Jetson nanoにUSBカメラじゃなくてMIPI Cameraを繋いだけどなんかうまくいかなかった

構成はシンプルですがこんな感じです。

環境

NVIDIA Jetson Nano 開発者キット B01
- Ubuntu 18.04.5 LTS
- jet pack 5.1
- aws-cli/1.19.25 Python/3.6.9 Linux/4.9.201-tegra botocore/1.20.25
SainSmart IMX219カメラモジュール

こんなカメラ

シリアルケーブルでここに差してます

事前準備

AMAZON KINESIS VIDEO STREAMS ハンズオン
を参考にしました。ラズパイ版なので必要なところだけピックアップしています。

1. ライブラリのインストール

sudo apt update
sudo apt install -y automake build-essential cmake git pkg-config libgstreamer-plugins-base1.0-dev

2. v4l-utilsのインストール

　※なくてもいけます。カメラがつながっているか確認するためにあると便利

$ sudo apt-get install v4l-utils

3. GStreamer 用のPlugin　kvssink　のビルド

「GStreamer」は、多数のカメラやビデオソースで使用される一般的なメディアフレームワークです。モジュラープラグインを組み合わせてカスタムのメディアパイプラインを作成できます
例: Kinesis ビデオストリームプロデューサー SDK GStreamer プラグインより引用
gstreamer からkvssinkで送るイメージ

AMAZON KINESIS VIDEO STREAMS PRODUCER SDK C++　をダウンロードしてbuildします。

SDKのダウンロード

cd
git clone --recursive https://github.com/awslabs/amazon-kinesis-video-streams-producer-sdk-cpp.git

ハマりポイント
Ubuntu Desktop を設定していると、「ドキュメント」のようなディレクトリが作られますが、そこに落としてきた場合、cmakeがうまくいきませんでした。homeディレクトリでやるのがよさそうです。

cmake で依存ライブラリのダウンロードとMakefile作成

mkdir -p ~/amazon-kinesis-video-streams-producer-sdk-cpp/build
cd ~/amazon-kinesis-video-streams-producer-sdk-cpp/build
cmake -DBUILD_GSTREAMER_PLUGIN=ON ..

ビルド

make

4. 一時認証情報の取得

AWS CLI から AWS STS (AWS Security Token Service）で一時認証情報を取得します。3時間のTOKENです。
※aws cli のプロファイル設定は省略します。

aws sts get-session-token

このようなクレデンシャルが返ってきます。

{
    "Credentials": {
        "AccessKeyId": "...................................",
        "SecretAccessKey": "...................................",
        "SessionToken": "...................................",
        "Expiration": "2021-05-20T23:50:40Z"
    }
}

環境変数を設定します。

export AWS_DEFAULT_REGION=利用するリージョン (us-east-2 など)
export AWS_ACCESS_KEY_ID=AccessKeyId の値
export AWS_SECRET_ACCESS_KEY=SecretAccessKey の値
export AWS_SESSION_TOKEN=SessionToken の値

5. kinesis video streams でストリームの作成

Amazon Kinesis Video Streamsのコンソールを開きます

ビデオストリームの作成をクリックしてストリームを作成します。

今回はビデオストリーム名にkvs-stream-test　と入れ、後はデフォルトのまま行きます。

こんな感じでできます。

ビデオストリームを削除したい場合は、左メニューのビデオストリームから一覧を表示してチェックボックスを入れて削除。

ストリーム配信

Gstreamer を起動してストリーム配信します。
stream-nameにはビデオストリームの作成で作った名前を入れてください。

$gst-launch-1.0 nvarguscamerasrc sensor_mode=0 ! 'video/x-raw(memory:NVMM),width=640, height=480, framerate=21/1, format=NV12' ! nvvidconv flip-method=0 ! nvv4l2h264enc ! h264parse ! video/x-h264,stream-format=avc,alignment=au,profile=baseline ! kvssink stream-name=kvs-stream-test

ハマりポイント

例 6: Raspberry Pi のカメラからビデオをストリーミングする　のような例では

nvarguscamerasrc
ではなく
v4l2src
を使った例が載っています。これだとjetsonではうまくいきませんでした。

v4l2 に関する整理

v4l2（Video for Linux Two）とは、ビデオキャプチャデバイスを扱うAPIの仕様の名前
v4l2　が使えるかどうか　はカメラのデバイスドライバによる
USBカメラだとuvc（USB Video class）のドライバ、Driver name : uvcvideo　などで動いており、v4l2に対応している。uvcのドライバはLinuxで標準で入っている。
jetsonにシリアルケーブルで接続するカメラのドライバは、NVIDIAのtegra-videoであるが、これがv4l2に対応していない。
※ラズパイならMPI CSIカメラでもv4l2が動いているような記事を見ているので、JetsonのMIPI-CSIカメラだとうまくいかない　という問題だったと思われる。

配信動画を見るには

AWS コンソールの「メディア再生」を開くとこのようにJetsonカメラからのstreaming映像が表示されます。
デフォルトでは1日間保存されます。このプレイヤーでは時間指定で再生することもできます。

まとめ

jetson につないだMIPIカメラからgstreamer + kvssink （kinesis video streams Plug in)でカメラ映像を配信
v4l2 は標準のnvidiaカメラドライバは対応していないので、v4l2srcではない別のものを使う

Jetson NanoにつないだMIPIカメラからAWS kinesis video streamsに動画配信してみた

環境