Eclipse ThreadX を使用した Device Update for Azure IoT Hub

[アーティクル]
06/01/2023

この記事では、Eclipse ThreadX NetX Duo で Device Update for Azure IoT Hub エージェントを作成する方法について説明します。また、アプリケーションに Device Update 機能を統合したいと考える開発者のために簡単な API を紹介します。主要な半導体評価ボードのサンプルをご覧ください。デバイスへの無線での更新を構成、構築、デプロイする方法が学べるファーストステップガイドが含まれています。

Azure サブスクリプションをお持ちでない場合は、開始する前に無料アカウントを作成してください。

前提条件

IoT Hub インスタンスへのアクセス。 S1 (Standard) レベル以上を使用することをお勧めします。
ご使用の IoT ハブにリンクされている Device Update インスタンスおよびアカウント。 Device Update アカウントの作成とリンクがまだ済んでいない場合は、ガイドに従って行ってください。

はじめに

ボード固有のサンプル Azure Real-Time Operating System (RTOS) プロジェクトにはそれぞれ、そのボードに Device Update for IoT Hub を使用する方法を紹介したコードとドキュメントが含まれています。次の処理を行います。

Eclipse ThreadX と Device Update サンプルのページから、ボード固有のサンプルファイルをダウンロードします。
ダウンロードしたサンプルの docs フォルダーを見つけます。
ドキュメントには、Azure のリソースとアカウントを準備し、そこに IoT デバイスを登録する方法が記載されているので、その手順に従います。
ドキュメントに従って新しいファームウェアイメージを作成し、ボードのマニフェストをインポートします。
ファームウェアイメージとマニフェストを Device Update for IoT Hub に発行します。
プロジェクトをデバイスにダウンロードして実行します。

Eclipse ThreadX の詳細を確認します。

デバイスにタグを付ける

前の手順で使用したデバイスアプリケーションは実行したままにします。
Azure portal にサインインし、IoT ハブに移動します。
左側のペインで、[デバイス] を選択します。お使いの IoT デバイスを見つけてデバイスツインに移動します。
デバイスツインで、Device Update の既存のタグ値を null に設定することで削除します。
次に示すように、ルート JSON オブジェクトに Device Update の新しいタグ値を追加します。
```
    "tags": {
            "ADUGroup": "<CustomTagValue>"
            }
```

デバイスグループを表示する

Device Update ではグループを使用してデバイスを整理します。割り当てられたタグと互換性プロパティに基づいて、Device Update で自動的にデバイスがグループに並べ替えられます。各デバイスは 1 つのグループにのみ属しますが、グループには複数のサブグループを含めることができ、さまざまなデバイスクラスを並べ替えることができます。

ページの上部にある [グループとデプロイ] タブに移動します。
グループの一覧と更新プログラムのコンプライアンスチャートを表示します。更新プログラムのコンプライアンスチャートには、さまざまなコンプライアンス対応状態 (最新の更新状態、利用可能な新しい更新プログラムがある、更新プログラムのインストールが進行中) にあるデバイスの数が表示されます。更新プログラムのコンプライアンスの詳細についてはこちらを参照してください。
このチュートリアルで設定したシミュレートされたデバイスを含むデバイスグループと、新しいグループ内のデバイスで使用できる更新プログラムが表示されます。グループのデバイスクラスの要件を満たしていないデバイスがある場合は、対応する無効なグループに表示されます。このビューから新しいユーザー定義グループに最適な利用可能な更新プログラムをデプロイするには、グループの横にある [デプロイ] を選択します。

タグとグループの詳細については、デバイスグループの管理に関する記事を参照してください。

新しいファームウェアをデプロイする

グループが作成された後、デバイスグループで利用可能な新しい更新プログラムが表示され、[最適な更新プログラム] の下にその更新プログラムへのリンクが表示されます。場合によっては、一度最新の情報に更新する必要があります。更新プログラムのコンプライアンスの詳細についてはこちらを参照してください。
グループ名を選択してターゲットグループを選択します。 [グループの基本] の下にグループの詳細が表示されます。
デプロイを開始するには、[現在のデプロイ] タブに移動します。[使用できる更新プログラム] セクションで、目的の更新プログラムの横にあるデプロイリンクを選択します。特定のグループに最適な使用可能な更新プログラムには、最適の強調表示が付けられます。
デプロイを直ちに開始するか、後で開始するようにスケジュールします。 [作成] を選択します。

ヒント

既定の開始日時は、現在の時刻から 24 時間後です。もっと早くデプロイしたい場合は、異なる日時を選択してください。
デプロイの詳細 で、状態が アクティブ に変わります。デプロイされた更新プログラムには (デプロイ中) のマークが付きます。
コンプライアンスチャートを表示して、更新が進行中であることを確認します。
デバイスが正常に更新されると、コンプライアンスチャートとデプロイの詳細が、同じ内容を反映するように更新されていることがわかります。