デバイスを開発した後、IoT Platform コンソールのオンラインデバッグ機能を使用して、デバイスにコマンドを送信し、その TSL モデルの関数をテストできます。 このトピックでは、TSL モデルの関数のデバッグについて説明します。
前提条件
-
デバイスのプロダクトには、定義済みの TSL モデルが必要です。詳細については、「TSL モデルの追加」をご参照ください。
-
デバイスは IoT Platform に接続済みで、アクティブ化され、オンラインである必要があります。デバイスの開発および接続方法については、「Link SDK を使用したデバイスの接続」をご参照ください。
説明IoT Platform のデバイスシミュレーターまたは MQTT.fx などのツールを使用して、オンラインデバイスをシミュレートすることもできます。その後、オンラインデバッグ機能を使用して、シミュレートされたデバイスの関数をテストできます。詳細については、「デバイスシミュレーターの使用」または「MQTT.fx を使用した IoT Platform へのデバイス接続」をご参照ください。
シミュレートされたデバイスがオンラインになると、デバイス Topic が生成されます。Topic のサブスクライブおよび使用方法の詳細については、「デバイス Topic の生成」をご参照ください。
制限事項
TSL モデルの関数のデバッグは、MQTT 経由で接続されたデバイスに対してのみ実行できます。
操作手順
-
IoT Platform コンソールにログインします。
概要ページで、管理対象のインスタンスを見つけ、インスタンス ID またはインスタンス名をクリックします。
-
左側のナビゲーションウィンドウで、を選択します。
-
オンラインデバッグページで、デバッグ対象のデバイスを選択します。
-
プロパティデバッグ、サービス呼び出し、タブを選択してデバッグを開始します。
プロパティデバッグ
-
プロパティデバッグタブで、モジュールドロップダウンリストからモジュールを選択します。
-
プロパティのデバッグを行うには、次の操作を実行します。
重要セットまたは期待値の設定操作を使用するには、プロパティに読み取りおよび書き込みの権限が必要です。
機能
操作
説明
取得
プロパティフィールドの右側で、[デバッグ] をクリックして、[取得] を選択します。
デバイスから最新のプロパティデータが入力フィールドに表示されます。デバイスに該当プロパティのデータがない場合は、フィールドは空になります。
セット
プロパティフィールドに値を入力し、右側のデバッグをクリックして、セットを選択します。
IoT Platform はデバイスにプロパティ値を設定するコマンドを送信します。オンラインデバイスがこのコマンドを受信すると、TSL モデルの実装に基づいて値を処理します。たとえば、デバイスは最新のプロパティ値を IoT Platform にレポートします。
期待値の設定
プロパティフィールドに値を入力し、右側のデバッグをクリックして、期待値の設定を選択します。
IoT Platform はデバイスに期待されるプロパティ値を設定するコマンドを送信します。
コマンド送信時：
-
デバイスがオンラインの場合、すぐにコマンドを受信し、プロパティ値を更新して新しい値を IoT Platform にレポートします。
-
デバイスがオフラインの場合、オンラインになった後に期待値を自ら取得し、プロパティを更新して新しい値をレポートします。
ページ下部の取得、セット、または期待値の設定をクリックして、複数のプロパティを一括でデバッグすることもできます。
-
サービス呼び出し
-
サービス呼び出しタブで、デバッグ機能ドロップダウンリストからデバッグ対象のモジュールおよびサービスを選択します。
-
入力フィールドにサービス呼び出しのパラメーターを入力し、コマンド送信をクリックします。
入力パラメーターは有効な JSON フォーマットである必要があります（例：
{"Switch":0}）。
デバッグログの確認
コマンドを送信した後、ページ右側のリアルタイムログセクションで操作ログを確認できます。また、デバイス詳細ページのTSL データタブでデバッグ結果を確認することも可能です。
オンラインデバッグ中、IoT Platform は同期型 RRPC メカニズムを使用してデバイスにコマンドを送信します。そのため、MQTT.fx を使用して接続されたものなど、シミュレートされたオンラインデバイスは、デバイス Topic をサブスクライブしていなくても関連ログを受信できます。詳細なログは、メンテナンス > デバイスログページで確認できます。
-
プロパティデバッグ：プロパティ値を入力し、セットをクリックします。
ページ左側にはプロパティの一覧と現在の値が表示されます。右側のリアルタイムログセクションには、デバイスステータスおよび操作ログが表示されます。ログ内容において、操作フィールドの値はthing.service.property.setとなり、プラットフォームがプロパティ設定コマンドを送信したことを示します。
-
サービス呼び出し：サービスを選択し、入力パラメーターを入力して、コマンド送信をクリックします。
ページ左側にはデバッグ機能ドロップダウンリストと入力パラメーター用の JSON エディターが表示され、下部にコマンド送信およびリセットボタンがあります。右側のリアルタイムログセクションには、サービス呼び出しのリクエストログ（操作フィールドがサービス識別子）およびデバイスからの応答が表示されます。
