IoT Platform では、プロダクトのモノの仕様言語 (TSL) モデルを定義できます。TSL モデルは、物理的なプロダクトをプロパティ、サービス、イベントで構成されるデータモデルに抽象化します。このモデルにより、IoT Platform はデバイスを管理し、対話することができます。プロダクトを作成した後、その TSL モデルを定義できます。そのプロダクトに属するデバイスは、TSL モデルを自動的に継承します。
前提条件
プロダクトが作成済みであること。詳細については、「プロダクトとデバイスの作成」をご参照ください。
背景情報
このトピックでは、街灯を例に、プロダクトの 2 つのプロパティ (メインライトスイッチと電流) を定義する方法を説明します。TSL モデルを定義すると、複数の街灯デバイスをプロダクトに接続できます。各デバイスは、定義された TSL モデルを自動的に継承します。TSL モデルの詳細については、「TSL モデルとは」をご参照ください。
操作手順
-
IoT Platform コンソールにログインします。
-
[概要] タブで、[パブリックインスタンス] をクリックします。
-
左側のナビゲーションウィンドウで、 を選択します。[プロダクト] ページで、作成した街灯プロダクトを見つけ、[操作] 列の [表示] をクリックします。
-
[プロダクト詳細] ページで、[機能定義] タブをクリックし、[ドラフトを編集] をクリックします。
-
[ドラフトを編集] ページの [デフォルトモジュール] セクションで、[カスタム機能を追加] をクリックして TSL モデルを設定し、[OK] をクリックします。
街灯プロダクトの メインライトスイッチ と 電流 のプロパティを設定します。
-
メインライトスイッチ プロパティの設定:[機能タイプ] を [プロパティ] に設定し、[機能名] に「メインライトスイッチ」と入力し、[識別子] に
LightSwitchと入力し、[データ型] で bool (0 はオフ、1 はオン) を選択し、[読み書きタイプ] で [読み書き] を選択します。 -
電流 プロパティの設定:[機能タイプ] を [プロパティ] に設定し、[機能名] に「電流」と入力し、[識別子] に
LightCurrentと入力し、[データ型] で [float] を選択し、値の範囲を [0~9] に設定し、ステップを [0.1] に設定し、単位として [アンペア / A] を選択し、[読み書きタイプ] で [読み取り専用] を選択し、[説明] に「電気的パラメーターは 4 バイトの浮動小数点データを使用します」と入力します。
-
-
(任意) [TSL モデル] をクリックします。[TSL 全文] タブでは、プロダクトの完全な TSL モデルを JSON 形式で表示できます。
JSON ファイルには、スキーマ、プロファイル、プロパティ配列が含まれます。例えば、LightSwitch (メインライトスイッチ) プロパティは、bool データ型と rw (読み書き) アクセスモードを使用します。値 0 はオフ、1 はオンを示します。右下隅の [モデルファイルをエクスポート] をクリックして、TSL モデルをローカルファイルにエクスポートします。
-
TSL モデルを公開します。
重要TSL モデルは、公開しないと有効になりません。
-
[機能定義] の [ドラフトを編集] ページの左下隅にある [公開] をクリックします。[TSL モデルを公開しますか?] ダイアログボックスが表示されます。
-
[リリースノートを追加] をクリックし、バージョン番号とバージョン説明を入力します。
パラメーター
説明
バージョン番号
現在の TSL モデルのバージョン番号を設定します。後でバージョン番号に基づいて TSL モデルを管理できます。
バージョン番号には、英字、数字、ピリオド (.) を使用できます。長さは 1~16 文字です。
バージョン説明
現在の TSL モデルのバージョンを説明します。中国語、英字、日本語、数字、特殊記号をサポートしています。説明は最大 100 文字です。中国語または日本語の文字は 1 文字としてカウントされます。
-
バージョンがすでに公開されている場合は、ドラフトと公開済みバージョンを比較して変更点を確認する必要があります。
[比較結果] をクリックして、[比較結果] ダイアログボックスで変更点を確認します。変更点を確認した後、[確認して表示] をクリックします。[TSL モデルを公開] ダイアログボックスに戻り、「現在のバージョンとオンラインバージョンの比較を確認しました」チェックボックスが自動的にオンになります。
バージョンを比較する必要がない場合は、「現在のバージョンとオンラインバージョンの比較を確認しました」チェックボックスを手動でオンにすることができます。
-
[OK] をクリックして TSL モデルを公開します。
-