📐 统一物模型 (TSL) 规范

物模型（Thing Specification Language, TSL）是对物理世界设备数字化表述的标准语言。无论底层采用哪种传输协议，MzMedia 均将设备抽象为标准的三大维度要素：

1. 物模型三大核心要素

text

 ┌────────────────────────────────────────────────────────┐
 │                   统一物模型 (TSL)                     │
 ├────────────────────────┬───────────────────────────────┤
 │ 1. 属性 (Property)     │ 设备运行状态 (如温度、压力、电量)│
 ├────────────────────────┼───────────────────────────────┤
 │ 2. 服务 (Service)      │ 平台对设备下发的指令 (重启、开阀)│
 ├────────────────────────┼───────────────────────────────┤
 │ 3. 事件 (Event)        │ 设备突发主动上报 (故障、低电告警)│
 └────────────────────────┴───────────────────────────────┘

要素一：属性 (Property)

表示设备当前的测量值或静态参数；
包含只读（r）与读写（rw）权限；
支持丰富的数据类型：int, float, double, string, bool, enum, array, struct；
支持定义数值上下限、单位（如 ℃, MPa, V, A）以及步长。

要素二：服务 (Service)

平台向设备下发的控制指令，包含入参（Input Parameters）与出参（Output Parameters）；
支持同步执行模式（等待设备返回结果）与异步执行模式（下发后通过设备事件异步回调确认）。

要素三：事件 (Event)

设备运行过程中主动向平台上报的特定事件；
分为三个事件等级：
- 信息 (Info)：常规事件（如“定时自检正常”、“固件升级开始”）；
- 告警 (Warn)：阈值告警（如“液位偏高”、“滤波网即将到期”）；
- 故障 (Error)：严重事件（如“电机堵转”、“主板过温停机”）。

2. 在线物模型解析与语法校验器

您可以通过下方交互器切换预置工业设备模板，或直接粘贴业务 JSON 进行实时规范性验证：

📐 统一物模型 (TSL) 在线解析与规范校验器物模型引擎

TSL 模型 JSON 结构定义:✓ 语法格式正确

{
  "profile": {
    "version": "2.0.0",
    "productKey": "pm_meter_001"
  },
  "properties": [
    {
      "identifier": "voltage_a",
      "name": "A相电压",
      "accessMode": "r",
      "desc": "电表A相有效电压",
      "dataType": {
        "type": "float",
        "specs": {
          "min": 0,
          "max": 500,
          "unit": "V"
        }
      }
    },
    {
      "identifier": "current_a",
      "name": "A相电流",
      "accessMode": "r",
      "desc": "电表A相电流",
      "dataType": {
        "type": "float",
        "specs": {
          "min": 0,
          "max": 100,
          "unit": "A"
        }
      }
    },
    {
      "identifier": "active_power",
      "name": "总有功功率",
      "accessMode": "r",
      "desc": "全负荷有功功率",
      "dataType": {
        "type": "float",
        "specs": {
          "min": 0,
          "max": 50000,
          "unit": "kW"
        }
      }
    },
    {
      "identifier": "relay_state",
      "name": "内置继电器分闸",
      "accessMode": "rw",
      "desc": "远程拉闸与合闸",
      "dataType": {
        "type": "bool",
        "specs": {
          "0": "合闸",
          "1": "分闸"
        }
      }
    }
  ],
  "services": [
    {
      "identifier": "remote_trip",
      "name": "远程分合闸控制",
      "callType": "async",
      "inputData": [
        {
          "identifier": "action",
          "name": "动作指令",
          "type": "bool"
        }
      ],
      "outputData": [
        {
          "identifier": "result",
          "name": "执行状态",
          "type": "int"
        }
      ]
    },
    {
      "identifier": "reset_energy",
      "name": "电度清零校准",
      "callType": "sync",
      "inputData": [
        {
          "identifier": "auth_key",
          "name": "操作密钥",
          "type": "string"
        }
      ],
      "outputData": []
    }
  ],
  "events": [
    {
      "identifier": "voltage_sag",
      "name": "瞬时欠压告警",
      "type": "warn",
      "outputData": [
        {
          "identifier": "curr_v",
          "name": "当前欠压值"
        }
      ]
    },
    {
      "identifier": "over_load_trip",
      "name": "超负荷短路跳闸",
      "type": "error",
      "outputData": [
        {
          "identifier": "fault_code",
          "name": "故障代码"
        }
      ]
    }
  ]
}

A相电压voltage_afloat只读

单位: V | 范围: [0 ~ 500] | 描述: 电表A相有效电压

A相电流current_afloat只读

单位: A | 范围: [0 ~ 100] | 描述: 电表A相电流

总有功功率active_powerfloat只读

单位: kW | 范围: [0 ~ 50000] | 描述: 全负荷有功功率

内置继电器分闸relay_statebool读写

描述: 远程拉闸与合闸

3. 设备影子 (Device Shadow)

在弱网或移动应用场景中，设备并不总是在线。MzMedia 提供了设备影子机制：

缓存设备最新的物理属性值（Reported 状态）；
缓存平台期望下发但设备尚未联机确认的控制值（Desired 状态）；
设备重新上线时，网关自动将差量变更推送到设备端并清空影子指令。

📐 统一物模型 (TSL) 规范 ​

1. 物模型三大核心要素 ​

要素一：属性 (Property) ​

要素二：服务 (Service) ​

要素三：事件 (Event) ​

2. 在线物模型解析与语法校验器 ​

3. 设备影子 (Device Shadow) ​

开发者互动与技术支持