IoT Hub 用のデバイス更新と IoT プラグ アンド プレイ

IoT Hub 用のデバイス更新では、無線更新対応のデバイスを検出して管理するために、IoT プラグ アンド プレイが使用されます。 デバイス更新サービスにより、IoT プラグ アンド プレイ インターフェイスを使用して、デバイスとの間でプロパティとメッセージが送受信されます。 IoT Hub 用のデバイス更新を使用するには、IoT デバイスで次のインターフェイスとモデル ID を実装する必要があります。

詳細情報:

• IoT プラグ アンド プレイ デバイス クライアントについて理解します。
• デバイス更新エージェントの実装方法を確認します。

デバイス更新コア インターフェイス

DeviceUpdateCore インターフェイスは、更新アクションとメタデータをデバイスに送信し、デバイスから更新状態を受信するために使用されます。 DeviceUpdateCore インターフェイスは、2 つのオブジェクト プロパティに分割されます。

このインターフェイスが実装される場合、モデルで予想されるコンポーネント名は "deviceUpdate" です。 Azure IoT プラグ アンド プレイ コンポーネントの詳細を確認してください。

エージェント メタデータ

デバイス更新エージェントではエージェント メタデータ フィールドを使用して、デバイス更新サービスに情報が送信されます。

デバイスのプロパティ

deviceProperties フィールドには、デバイスの製造元とモデルの情報が含まれています。

IoT Hub デバイス ツインのサンプル:

"deviceUpdate": {
                "__t": "c",
                "agent": {
                    "deviceProperties": {
                        "manufacturer": "contoso",
                        "model": "virtual-vacuum-v1",
                        "interfaceId": "dtmi:azure:iot:deviceUpdateModel;1",
                        "aduVer": "DU;agent/0.8.0-rc1-public-preview",
                        "doVer": "DU;lib/v0.6.0+20211001.174458.c8c4051,DU;agent/v0.6.0+20211001.174418.c8c4051"
                    },
                    "compatPropertyNames": "manufacturer,model",
                    "lastInstallResult": {
                        "resultCode": 700,
                        "extendedResultCode": 0,
                        "resultDetails": "",
                        "stepResults": {
                            "step_0": {
                                "resultCode": 700,
                                "extendedResultCode": 0,
                                "resultDetails": ""
                            }
                        }
                    },
                    "state": 0,
                    "workflow": {
                        "action": 3,
                        "id": "11b6a7c3-6956-4b33-b5a9-87fdd79d2f01",
                        "retryTimestamp": "2022-01-26T11:33:29.9680598Z"
                    },
                    "installedUpdateId": "{\"provider\":\"Contoso\",\"name\":\"Virtual-Vacuum\",\"version\":\"5.0\"}"
                },

State

state (状態) フィールドは、デバイス更新サービスからアクションを受け取った後に、デバイス更新 (DU) エージェントによって報告された状態です。 state は、 デバイス更新サービスからデバイス更新エージェントに送信された action (action セクションを参照) への応答で報告されます。 デバイス更新サービスとデバイス更新エージェントの間でやり取りされる要求については、ワークフローの概要に関する記事をご覧ください。

サービス メタデータ

サービス メタデータには、デバイス更新サービスによってアクションとデータをデバイス更新エージェントに伝えるために使用されるフィールドが含まれています。

アクション

action (アクション) フィールドは、デバイス更新サービスによって指示されてデバイス更新エージェントによって実行されるアクションを表します。 デバイス更新エージェントは、受信したアクションを処理するための状態を報告します。 デバイス更新サービスとデバイス更新エージェントの間でやり取りされる要求については、ワークフローの概要に関する記事をご覧ください。

デバイス情報インターフェイス

デバイス情報インターフェイスは、IoT プラグ アンド プレイ アーキテクチャで使用される概念です。 デバイスのハードウェアとオペレーティング システムに関する情報を提供する、デバイスからクラウドへのプロパティが含まれています。 IoT Hub 用のデバイス更新では、テレメトリと診断のための DeviceInformation.manufacturer および DeviceInformation.model プロパティが使用されます。 詳細については、デバイス情報インターフェイスのこちらの例をご覧ください。

このインターフェイスが実装される場合、モデルで予想されるコンポーネント名は deviceInformation です。 Azure IoT プラグ アンド プレイ コンポーネントについての詳細情報

モデル ID

モデル ID は、IoT プラグ アンド プレイによってスマート デバイスから Azure IoT アプリケーションに機能が公開される方法です。Azure IoT アプリケーションに機能を公開するようにスマート デバイスを構築する方法の詳細については、「IoT プラグ アンド プレイ デバイス開発者ガイド」をご覧ください。

IoT Hub 用のデバイス更新で、デバイス接続の一部として "dtmi:azure:iot:deviceUpdateModel;1" という値でモデル ID を通知するには、IoT プラグ アンド プレイ スマート デバイスが必要です。 モデル ID を通知する方法を確認する.