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

:TSLモデルとは何ですか?

最終更新日:Feb 06, 2024

Thing Specification Language (TSL) モデルは、IoT Platformの製品に対して定義されるデータモデルです。 TSLモデルは、製品の機能を記述するために使用されます。 このトピックでは、TSLモデルの概念と制限について説明します。

特徴

TSLモデルは、センサー、車載デバイス、建物、工場など、クラウド内の物理エンティティをデジタル化します。 TSLモデルには、エンティティのプロパティ、サービス、およびイベントが含まれます。 TSLモデルは、エンティティが何であるか、エンティティが何ができるか、およびエンティティが提供できる情報を記述する。 製品のTSL機能は、プロパティ、サービス、およびイベントのディメンションから定義できます。

機能タイプ説明
プロパティプロパティは、実行中のデバイスのステータスまたは情報を記述するTSL機能です。

例えば、特性は、環境監視デバイスによって収集される温度情報、スマートランプのオンまたはオフ状態、または電動ファンの風速であり得る。

プロパティは、読み取り /書き込みプロパティと読み取り専用プロパティに分類されます。 読み取り /書き込みプロパティの値を指定し、値を読み取ることができます。 読み取り専用プロパティの値のみを読み取ることができます。

サービスサービスは、外部呼び出しのためにデバイスによって提供されるコマンドまたはメソッドです。 呼び出すサービスの入出力パラメーターを設定できます。 サービスは、入力パラメータの値を読み取り、出力パラメータで結果を返します。

プロパティと比較して、複雑なビジネスロジックを実装するコマンドを使用してサービスを呼び出すことができます。 たとえば、サービスを呼び出して特定のタスクを実行できます。

サービスは、同期または非同期で呼び出すことができます。

Eventイベントには、アラートや障害など、デバイスの実行時に通知と処理のためにデバイスがIoT Platformに報告する情報が含まれます。 イベントには複数の出力パラメーターを含めることができます。

たとえば、イベントは、タスクが完了したときの通知、デバイス上で障害が発生したときのデバイスの温度および障害時間、ならびにデバイスに対してアラートがトリガされたときのデバイスの状態であり得る。

イベントをサブスクライブまたは配信できます。

IoT Platformでは、プロパティ、サービス、イベントなど、製品の複数の機能セットを定義できます。 TSLモジュールは、特徴のセットを示す。 異なるTSLモジュールは、互いに影響を与えない。

TSLモジュールを使用すると、産業シナリオにおける複雑なデバイスモデリングの問題を解決できます。 同じ製品を使用して、異なる機能のデバイスを開発できます。

たとえば、電動ファンヒーター製品の特性には、電源スイッチギア (高、中、低)室内温度などがあります。 最初の2つのプロパティを1つのモジュールに追加し、3つすべてのプロパティを別のモジュールに追加できます。 その後、TSLモジュールに基づいてデバイスを開発できます。 このように、同じ製品の異なるデバイスは異なる機能を持ちます。

IoT Platformはデフォルトモジュールを提供します。 ビジネス要件に基づいてカスタムモジュールを追加できます。 モジュールの総数は20を超えることはできません。

重要 2021年1月1日より前に定義された機能は、デフォルトモジュールに分類されます。

説明

IoT Platformは、モジュールと製品機能を記述するTSLを提供します。

ビジネスシナリオに基づいて、TSLモジュールでプロパティ、サービス、またはイベントを定義できます。

各TSLファイルはJSON形式です。 IoT PlatformコンソールでJSON形式のTSLモデルを表示またはエクスポートするには、次の手順を実行します。[製品の詳細] ページで、[機能の定義] をクリックします。 [機能の定義] タブで、[TSLモデル] をクリックします。 TSLフィールドの詳細については、「TSLパラメーター」をご参照ください。

IoT Platformに1つ以上のTSLモデルを追加できます。 複数のTSLモデルを同時にインポートする場合、カスタムTSLファイルを作成できます。 詳細については、「制限事項」をご参照ください。

制限事項

TSL機能の制限については、「制限」をご参照ください。 次の表に、TSLファイルをインポートするときに適用される制限を示します。

操作制限
単一のTSLファイルをインポートするファイルのサフィックスはです。json。 ファイルは JSON 形式でなければなりません。 ファイルサイズは512 KBを超えることはできません。 ファイル内の有効な文字のサイズは、256 KB (256 × 1024文字) を超えることはできません。

有効な文字には、改行および配置文字は含まれません。

複数のTSLファイルをインポートする
  • 複数のTSLファイルをに圧縮する必要があります。zipファイル。 ZIPファイルのサイズは2.5 MBを超えることはできません。 ZIPファイルは解凍できます。 1つ以上のTSLファイルを含むZIPファイルを解凍した後、各TSLファイルはrequireデータ形式に従う必要があります。
  • ZIPファイルには、少なくとも1つの有効なTSLファイルが含まれている必要があります。 ZIPファイルには、最大1つのデフォルトモジュールファイルと9つのカスタムモジュールファイルを含めることができます。
    重要 カスタムモジュールのfunctionBlockNameパラメーターとfunctionBlockIdパラメーターの値は、別のカスタムモジュールのパラメーターの値と異なる必要があります。

参考資料