R-Car/Boards/Yocto-Gen3/Azure IoT Edge/v5.5.0

Introduction
This page describes how to set up the Yocto environment to use the Azure IoT Hub with R-Car and run it.

Set up in the Azure

 * 1) Create an Azure account
 * Create an Azure account with reference to the following.
 * https://azure.microsoft.com/en-us/free/
 * 1) Create an Azure IoT Hub
 * Create an Azure IoT Hub with reference to the following.
 * https://docs.microsoft.com/ja-jp/azure/iot-hub/iot-hub-create-through-portal#create-an-iot-hub
 * 1) Register an Azure Device
 * https://portal.azure.com/
 * Access the URL above and select the IoT Hub you created in the previous step.
 * Select "IoT Edge" under "Device Management" in the side menu, and then press "+ Add IoT Edge Device".
 * Azure-device-1.png
 * Then, set an arbitrary name for "Device ID" and click "Save" without changing the other settings.
 * Finally, select "IoT Edge" among "Device Management" in the side menu, and press the device ID you created to check the "Primary Connection String".
 * The "Primary Connection String" is used in the "Procedure on the target board" section.
 * Azure-device-3.png
 * 1) Add the Azure module
 * Add the Simulated Temperature Sensor module with reference to the following.
 * https://docs.microsoft.com/ja-jp/azure/iot-edge/quickstart-linux?view=iotedge-2018-06#deploy-a-module

ビルド手順

 * 1) 事前準備(パッケージのインストール)
 * 2) gitの設定
 * 3) Build script(build.sh)
 * 4) ビルドスクリプトを実行
 * target_board_name は使用しているボードによって変える必要があるため、以下のように設定すること.
 * R-car-sk-target-board-name.png
 * 1) ビルド実行
 * イメージのビルドは、ホストシステムの性能によっては数時間かかることがある.
 * ビルドが正常に完了すると、以下のような出力が表示される.
 * 1) ビルド生成物
 * bitbake を実行して生成されたファイルは以下に格納される
 * /build/tmp/deploy/images//
 * 1) イメージを SD カードに書き込む
 * SDカードにイメージを書き込む方法は、Loading kernel and rootfs via eMMC/SD cardを参照.
 * 上記の例はイメージが"weston"のため、"minimal"に置き換えることに注意すること
 * 1) ビルド生成物
 * bitbake を実行して生成されたファイルは以下に格納される
 * /build/tmp/deploy/images//
 * 1) イメージを SD カードに書き込む
 * SDカードにイメージを書き込む方法は、Loading kernel and rootfs via eMMC/SD cardを参照.
 * 上記の例はイメージが"weston"のため、"minimal"に置き換えることに注意すること

How to run sample modules

 * 1) Procedure on the target board
 * 2) R-Car SK の起動
 * 3) R-Car SK に uSD カードを挿入して、LANケーブルを接続する.
 * 4) USB デバッグシリアルケーブルを PC と接続して、AC 電源を投入する.
 * 5) PC 側では、ターミナルソフトを起動して、シリアル接続を行う.
 * 6) 電源をONにする.
 * R-Car SK の POWER SW(SW8) を押下する.
 * CCPFが付いている場合は、CCPF基板のPOWER SW(SW4)を押下する.
 * 1) SD ブートを U-Boot で設定
 * SDブートの設定方法は、Configure U-Boot to boot from SD cardを参照.
 * 1) IoT Hub 接続設定
 * IoT Hub へ接続するための設定を追加する.
 * 1) 「/etc/iotedge/config.yaml」に書き込み権限を追加する.
 * 2) 「/etc/iotedge/config.yaml」内の「device_connection_string」の「」をプライマリ接続文字列に書き換える.
 * プライマリ接続文字列はRegister an Azure Deviceを参照.
 * 1) 「/etc/iotedge/config.yaml」の書き込み権限を削除する.
 * 2) 設定内容を反映させるため、デーモンを再起動する.
 * 3) IoT Edge Device の動作確認
 * 端末側でiotedge daemon Active となっていることを確認する.
 * Azure-status-no-page.png
 * 端末側でモジュールがデプロイされ running 状態になっていることを確認する.
 * デプロイされるまでには数分時間がかかるため、注意すること.
 * Azure-list.png
 * 1) Azure IoT Explorer での動作手順
 * Azure IoT Explorer で端末からメッセージが送信されていることを確認する.
 * 1) Azure IoT Explorer をダウンロード / インストール
 * 下記サイトからインストーラーをダウンロードする.
 * https://github.com/Azure/azure-iot-explorer/releases
 * 最新版のAzure.IoT.Explorer.preview.0.14.7 では、テレメトリが受信できなかったため、Azure.IoT.Explorer.preview.0.14.1 を使用
 * 1) Azure IoT Explorer を起動する
 * 2) IoT Hub の iothubowner 接続文字列を取得する.
 * Azure ポータルの「IoT Hub」→ 作成した IoT Hub を選択し、サイドメニューから「共有アクセスポリシー」→「iothubowner」→「プライマリ接続文字列」をコピーする.
 * Azure-iot-exp-1.png
 * 1) IoT Hub を IoT Explorer に登録する
 * Azure IoT Explorerのサイドメニューから「IoT hubs」を選択し、「+ Add connection」を押下する.
 * 「Connection string」に上記でコピーした「iothubowner 接続文字列」をペーストして、「Save」を押下する.
 * 1) テレメトリを確認する
 * サイドメニューの「Telemetry」を選択して、「Start」を押下する.
 * しばらくすると以下のようにテレメトリが表示される.
 * Azure-iot-exp-3.png
 * Azure IoT Explorerのサイドメニューから「IoT hubs」を選択し、「+ Add connection」を押下する.
 * 「Connection string」に上記でコピーした「iothubowner 接続文字列」をペーストして、「Save」を押下する.
 * 1) テレメトリを確認する
 * サイドメニューの「Telemetry」を選択して、「Start」を押下する.
 * しばらくすると以下のようにテレメトリが表示される.
 * Azure-iot-exp-3.png