4.2 TSL モデルとプロファイル テンプレートの概要

目次

このトピックでは、TSL モデルとプロファイルテンプレートとは何か、その形式と構造について紹介します。

TSL モデル

はじめに
Thing Specification Language (TSL) モデルは、Milesight 開発プラットフォーム内でデバイスの特性、機能、および動作を定義する標準化されたデータモデルです。TSL モデルは、デバイスの ID、機能、データ提供など、デバイス情報を構造化して表現する方法を提供します。
フォーマット
TSL モデルファイルのフォーマット: JSON.
構造
Milesight 開発プラットフォーム用の TSL モデルには、以下の例に示すように、バージョン、プロパティ、イベント、およびサービスが含まれます

{
    "data": {
        "version": "v1.0",    // Version of the TSL model.
        "properties": [    // Status or information of this device.
            {
                "id": "",    
                "name": "",           
                "accessMode": "",     // The access mode of the property.
                "dataSpec": {}    // Detailed info (data definition) of this property.
            }
        ],
        "events": [    // Data that a device reports to Milesight Developement Platform.
            {
                "id": "",                
                "name": "",
                "type": "",
                "outputs": []    // The reported data when this event occurs.
            }
        ],
        "services": [    // Available services that can be invoked on this device.
            {
                "id": "",
                "name": "",
                "callType": "",    // The type of this service invocation:
                "inputs": [],    // The downlink data when this service is invoked.
                "outputs": []    // The reported data when this service is invoked.
            }
        ]
    }
}
説明
 
項目
説明
version
このTSLモデルのバージョン
properties
プロパティは、アクセスモードに応じて読み取りまたは書き込み可能なデバイスの特性または属性です。プロパティは以下のように分類されます:
  • 読み取り専用:変更できない静的なデータまたは値で、デバイスのステータスや情報を表します。例えば、デバイスの SN (シリアル番号) やファームウェアのバージョンなどです。
  • 書き込み専用:設定可能なパラメータで、デバイスの設定を表します。例えば、センサーのデータ報告間隔などです。注:書き込み専用プロパティの値は、API を使用して変更し、デバイスの設定を更新することができます。
  • 読み取り/書き込み:デバイス情報を記述するだけでなく、変更も可能なパラメータ。例えば、スマートソケットのオン/オフの状態など。注:読み取り/書き込みプロパティの値は、API を使用して変更し、デバイスの設定を更新することができます。
events
イベントとは、特定のイベントが発生したときにデバイスが Milesight 開発プラットフォームに報告するデータを指します。たとえば、人数カウントセンサーがライン越えを報告するように設定されている場合、センサーがラインを越える人を検出すると、関連データを Milesight 開発プラットフォームに報告します。
services
サービスとは、デバイスで実行できるアクションのことです。デバイスと対話するために呼び出すことができるメソッドや操作を表します。たとえば、デバイスの再起動、デバイスの履歴データの照会などです。

注:サービスは API 経由で呼び出すことができます。

プロファイルテンプレート

はじめに
プロファイルテンプレートは、Milesight 開発プラットフォームで設定できる、インターネットにアクセス可能なデバイスのすべての設定の概要です。デフォルトのプロファイルテンプレートを使用して、デバイスに標準設定を適用したり、カスタムプロファイルテンプレートを作成して必要に応じて設定を更新し、デバイスに適用したりすることができます。
フォーマット
プロファイルテンプレートのフォーマット: JSON.
構造
プロファイルテンプレートは、次の例に示すように、バージョンとキーと値のペアのリストで構成されています。
{
    "version": "v1.0",    // Version of the Profile template.
    "values": [    
        {
            "key": "********",    // The configurable setting.
            "value": 1     
        },
        {
            "key": "*********",
            "value": 0
        },
        ..........
    ]
}

関連記事

ソリューション / IoT サポート


Milesight製品

ウェーブクレスト株式会社が運営するMilesight製品特設サイトです

居住者の健康を確保

お知らせ

  1. 2025-4-3

    ピープル・センシング 駆動型スマートビルディング

    People Sensing Insights を通じてビルインテリジェンスに革命をもたらします。…
  2. 2023-7-21

    LoRaWANの説明: 理論から実践へのガイド

    この包括的なビデオでは、LoRaWANを深く掘り下げ、その仕組み、利点、アプリケーションについて説明…
  3. 2023-4-6

    センシング・インサイト Milesight リブランディングのお知らせ

    https://youtu.be/r40DK40DjIY …
ページ上部へ戻る