Azure IoT エクスプローラーをインストールして使用する

Azure IoT エクスプローラーは、IoT ハブに接続されたデバイスと対話するためのグラフィカル ツールです。 この記事は、IoTプラグアンドプレイデバイスをテストするためにツールを使用することに焦点を当てています。 ローカルマシンにツールをインストールした後、それを使用してハブに接続することができます。 ツールを使用して、デバイスが送信しているテレメトリーを表示したり、デバイスのプロパティを操作したり、コマンドを呼び出したりできます。

この記事では、次の方法について説明します。

• Azure IoT Explorer ツールをインストールして構成します。
• ツールを使用して、IoT Plug and Play デバイスと対話し、テストしてください。

ツールの使用に関する一般的な情報については、GitHubのreadmeをご覧ください。

Azure IoT エクスプローラー ツールを使用するには、次のものが必要です。

• Azure IoT Hub。 お使いの Azure サブスクリプションに IoT ハブを追加する方法にはさまざまなものがあります。一例を挙げると、Azure CLI を使用して IoT ハブを作成するという方法があります。 Azure IoT Explorerツールを実行するには、IoTハブの接続文字列が必要です。 Azure サブスクリプションをお持ちでない場合は、開始する前に 無料アカウント を作成してください。
• お使いのIoTハブに登録されているデバイス。 IoT ハブでデバイス登録を作成および管理するには、IoT エクスプローラーを使用できます。

Azure IoT Explorerをインストールする

最新のリリースの資産リストを展開するために、Azure IoT Explorer リリースにアクセスしてください。 最新バージョンのアプリケーションをダウンロードしてインストールしてください。 インストールパッケージは、あなたがプラットフォーム上でアプリケーションを起動するための方法を設定します。 たとえば、Windows では、[スタート] メニューからアプリケーションを起動できます。

Azure IoT エクスプローラーを使用する

デバイスについては、自分のデバイスを接続するか、サンプルのシミュレーションデバイスのいずれかを使用することができます。

ハブに接続する

Azure IoT エクスプローラーを初めて実行するときは、お使いの IoT ハブの接続文字列を入力するように求められます。 接続文字列を追加した後、接続 を選択してください。 ツールの設定を使用して、接続文字列を更新することで、別のIoTハブに切り替えることができます。

IoT Plug and Playデバイスのモデル定義は、パブリックリポジトリ、接続されたデバイス、またはローカルフォルダーのいずれかに保存されています。 既定では、このツールはパブリック リポジトリとお使いの接続されているデバイス内でモデル定義を検索します。 ソースの追加と削除、またはソースの優先順位の構成は [設定] で行うことができます。

ソースを追加するには：

1. Home/IoTプラグアンドプレイ設定に移動します
2. 「追加」を選択し、リポジトリまたはローカルフォルダーからソースを選んでください。

ソースを削除するには:

1. Home/IoTプラグアンドプレイ設定に移動します
2. 削除するソースを見つけます。
3. X を選択して削除します。

ソースの優先順位を変更するには:

モデル定義ソースの1つをドラッグして、リスト内の異なるランクに配置することができます。

デバイスの表示

ツールがあなたのIoTハブに接続されると、IoTハブに登録されたデバイスIDを一覧表示するデバイスリストページが表示されます。 一覧のエントリを選択すると、詳細情報が表示されます。

デバイス リストページでは、次のことができます。

• New を選択して、新しいデバイスをハブに登録します。 その後、デバイスIDを入力してください。 デフォルト設定を使用して認証キーを自動生成し、ハブへの接続を有効にします。
• デバイスを選択し、次に削除を選択してデバイス識別情報を削除します。 この操作を完了する前に、デバイスの詳細を確認して、削除しようとしているデバイス ID が正しいことを確認してください。

デバイスと対話する

デバイスリストページで、デバイスID列の値を選択し、登録されたデバイスの詳細ページを表示します。 各デバイスには、「デバイス」と「デジタルツイン」の2つのセクションがあります。

デバイス

このセクションには、デバイスのアイデンティティ、デバイス ツイン、テレメトリー、直接メソッド、クラウドからデバイスへのメッセージ、モジュールのアイデンティティ タブが含まれています。

• デバイスID情報は、デバイスIDタブで表示および更新できます。
• デバイスツインの情報はデバイスツインタブでアクセスできます。
• デバイスが接続されていて、データを送信している場合、telemetry は Telemetry タブで表示できます。
• [ダイレクト メソッド] タブで、デバイス上でダイレクト メソッドを呼び出すことができます。
• [cloud-to-device メッセージ] タブで cloud-to-device メッセージを送信できます。
• モジュール ツイン情報にアクセスできます。

IoTプラグアンドプレイ部品

デバイスがモデル ID を使用してハブに接続されている場合、ツールに [IoT Plug and Play components]\(IoT プラグ アンド プレイ コンポーネント\) タブが表示され、モデル ID を確認できます。

設定されたソースのいずれか、つまり Public Repo または Local Folder にModel IDがある場合、コンポーネントのリストが表示されます。 コンポーネントを選択すると、利用可能なプロパティ、コマンド、およびテレメトリが表示されます。

コンポーネントページでは、読み取り専用のプロパティを表示したり、書き込み可能なプロパティを更新したり、コマンドを呼び出したり、このコンポーネントから生成されたテレメトリメッセージを確認することができます。

特性

インターフェイスで定義された読み取り専用のプロパティは、Properties (read-only) タブで確認できます。インターフェイスで定義された書き込み可能なプロパティは、Properties (writable) タブで更新できます。

1. プロパティ（書き込み可能） タブに移動します。
2. 更新するプロパティを選択します。
3. プロパティの新しい値を入力してください。
4. デバイスに送信されるペイロードをプレビューします。
5. 変更を送信する

変更を送信した後、更新の状態 (同期、成功、またはエラー) を追跡できます。 同期が完了すると、[ 報告された 値] 列にプロパティの新しい値が表示されます。 同期が完了する前に他のページに移動しても、更新が完了したときにツールから通知が表示されます。 ツールの通知センターを使用して、通知履歴を確認することもできます。

コマンド

デバイスにコマンドを送信するには、コマンド タブに移動してください。

1. コマンドのリストから実行したいコマンドを展開してください。
2. コマンドに必要な値を入力します。
3. デバイスに送信されるペイロードをプレビューします。
4. コマンドを送信してください。

テレメトリ

選択したインターフェースのテレメトリを表示するには、そのテレメトリタブに移動してください。テレメトリの受信を開始するには、開始を選択してください。

既知の問題

最新バージョンのツールでサポートされているIoT機能の一覧については、Feature listをご覧ください。