概述
物模型是ThingsKit物联网平台为产品定义的数据模型,用于描述产品的功能。本文介绍物模型相关概念和使用限制。
功能说明
物模型是物理空间中的实体(如传感器、车载装置、楼宇、工厂等)在云端的数字化表示,从属性、服务和事件三个维度,分别描述了该实体是什么、能做什么、可以对外提供哪些信息。定义了物模型的这三个维度,即完成了产品功能的定义。
功能类型 | 描述 |
---|---|
属性 | 用于描述设备运行时具体信息和状态。 |
例如,环境监测设备所读取的当前环境温度、智能灯开关状态、电风扇风力等级等。 | |
属性可分为读写和只读两种类型。读写类型支持读取和设置属性值,只读类型仅支持读取属性值。 | |
服务 | 指设备可供外部调用的指令或方法。服务调用中可设置输入和输出参数。输入参数是服务执行时的参数,输出参数是服务执行后的结果。 |
相比于属性,服务可通过一条指令实现更复杂的业务逻辑,例如执行某项特定的任务。 | |
服务分为异步和同步两种调用方式。 | |
事件 | 设备运行时,主动上报给云端的信息,一般包含需要被外部感知和处理的信息、告警和故障。事件中可包含多个输出参数。 |
例如,某项任务完成后的通知信息;设备发生故障时的温度、时间信息;设备告警时的运行状态等。 | |
事件可以被订阅和推送。 |
物模型数据格式说明
产品里面新增物模型时,选择不同的功能(属性、服务、事件),属性对应不同的数据格式。
属性数据格式 | 数据格式说明 |
---|---|
int32(整数型) |
- 物模型属性显示为整数类型(可定义范围)
|
| double(双精度浮点型) | - 物模型属性显示为double 如:12.16(可定义范围)
|
| bool(布尔型) | - 适用于开关,定义为0和1
|
| text(字符串) | - 字符串数据格式(可定义范围)
|
| struct(结构体) | - 结构体里面还有json对象 数据格式如:{"jiegou":{"json":126}}
|
物模型导出
点击物模型TSL,选择属性、服务、事件,进行单独导出,也可选择导出全部(属性、服务、事件)物模型。
:::info