すべてのプロダクト
Search
ドキュメントセンター

IoT Platform:TSL モデルの定義

最終更新日:Jun 22, 2026

IoT Platform では、プロダクトのモノの仕様言語 (TSL) モデルを定義できます。TSL モデルは、物理的なプロダクトをプロパティ、サービス、イベントで構成されるデータモデルに抽象化します。このモデルにより、IoT Platform はデバイスを管理し、対話することができます。プロダクトを作成した後、その TSL モデルを定義できます。そのプロダクトに属するデバイスは、TSL モデルを自動的に継承します。

前提条件

プロダクトが作成済みであること。詳細については、「プロダクトとデバイスの作成」をご参照ください。

背景情報

このトピックでは、街灯を例に、プロダクトの 2 つのプロパティ (メインライトスイッチと電流) を定義する方法を説明します。TSL モデルを定義すると、複数の街灯デバイスをプロダクトに接続できます。各デバイスは、定義された TSL モデルを自動的に継承します。TSL モデルの詳細については、「TSL モデルとは」をご参照ください。

操作手順

  1. IoT Platform コンソールにログインします。

  2. [概要] タブで、[パブリックインスタンス] をクリックします。

  3. 左側のナビゲーションウィンドウで、[デバイス] > [プロダクト] を選択します。[プロダクト] ページで、作成した街灯プロダクトを見つけ、[操作] 列の [表示] をクリックします。

  4. [プロダクト詳細] ページで、[機能定義] タブをクリックし、[ドラフトを編集] をクリックします。

  5. [ドラフトを編集] ページの [デフォルトモジュール] セクションで、[カスタム機能を追加] をクリックして TSL モデルを設定し、[OK] をクリックします。

    街灯プロダクトの メインライトスイッチ電流 のプロパティを設定します。

    • メインライトスイッチ プロパティの設定:[機能タイプ][プロパティ] に設定し、[機能名] に「メインライトスイッチ」と入力し、[識別子]LightSwitch と入力し、[データ型] で bool (0 はオフ、1 はオン) を選択し、[読み書きタイプ][読み書き] を選択します。

    • 電流 プロパティの設定:[機能タイプ][プロパティ] に設定し、[機能名] に「電流」と入力し、[識別子]LightCurrent と入力し、[データ型][float] を選択し、値の範囲を [0~9] に設定し、ステップを [0.1] に設定し、単位として [アンペア / A] を選択し、[読み書きタイプ][読み取り専用] を選択し、[説明] に「電気的パラメーターは 4 バイトの浮動小数点データを使用します」と入力します。

  6. (任意) [TSL モデル] をクリックします。[TSL 全文] タブでは、プロダクトの完全な TSL モデルを JSON 形式で表示できます。

    JSON ファイルには、スキーマ、プロファイル、プロパティ配列が含まれます。例えば、LightSwitch (メインライトスイッチ) プロパティは、bool データ型と rw (読み書き) アクセスモードを使用します。値 0 はオフ、1 はオンを示します。右下隅の [モデルファイルをエクスポート] をクリックして、TSL モデルをローカルファイルにエクスポートします。

  7. TSL モデルを公開します。

    重要

    TSL モデルは、公開しないと有効になりません。

    1. [機能定義][ドラフトを編集] ページの左下隅にある [公開] をクリックします。[TSL モデルを公開しますか?] ダイアログボックスが表示されます。

    2. [リリースノートを追加] をクリックし、バージョン番号とバージョン説明を入力します。

      パラメーター

      説明

      バージョン番号

      現在の TSL モデルのバージョン番号を設定します。後でバージョン番号に基づいて TSL モデルを管理できます。

      バージョン番号には、英字、数字、ピリオド (.) を使用できます。長さは 1~16 文字です。

      バージョン説明

      現在の TSL モデルのバージョンを説明します。中国語、英字、日本語、数字、特殊記号をサポートしています。説明は最大 100 文字です。中国語または日本語の文字は 1 文字としてカウントされます。

    3. バージョンがすでに公開されている場合は、ドラフトと公開済みバージョンを比較して変更点を確認する必要があります。

      [比較結果] をクリックして、[比較結果] ダイアログボックスで変更点を確認します。変更点を確認した後、[確認して表示] をクリックします。[TSL モデルを公開] ダイアログボックスに戻り、「現在のバージョンとオンラインバージョンの比較を確認しました」チェックボックスが自動的にオンになります。

      バージョンを比較する必要がない場合は、「現在のバージョンとオンラインバージョンの比較を確認しました」チェックボックスを手動でオンにすることができます。

    4. [OK] をクリックして TSL モデルを公開します。

次のステップ

デバイスを IoT Platform に接続する