物模型是物理空间中的实体(如传感器、车载装置、楼宇、工厂等)在云端的数字化表示,可以对同一类型的设备进行标准化定义,便于设备的接入和数据的打通。
物模型是物联网平台为产品定义的数据模型,用于描述产品的功能,其从属性、服务和事件三个维度来描述设备是什么、能做什么以及可以对外提供什么信息。定义了物模型的这三个维度,即完成了设备模板功能的定义。
功能类型 | 说明 |
---|---|
属性(Property) | 用于描述设备运行时具体信息和状态。 |
服务(Service) | 指设备可供外部调用的指令或方法。服务调用中可设置输入和输出参数。输入参数是服务执行时的参数,输出参数是服务执行后的结果。 |
事件(Event) | 设备运行时,主动上报给云端的信息,一般包含需要被外部感知和处理的信息、告警和故障。事件中可包含多个输出参数。 |
物联网平台将产品的一组功能(属性、服务和事件)定义的集合,定义在一个物模型模块下。模块是为了满足复杂产品特性的物模型描述,便于在同一产品下,开发不同功能的设备。
例如温湿控制器,会由温度传感器、湿度传感器、调湿器、调温器等多个部分组成。您可以分别在不同设备端,针对不同物模型模块进行开发。此时,该产品下不同设备就可以实现不同功能。多个物模型模块,彼此互不影响。
物联网平台已提供默认模块,您可根据需要新增自定义模块,总模块数量不超过20个。
物模型是对设备在云端的功能描述,包括设备的属性、服务和事件。物联网平台通过定义一种物的描述语言来描述物模型模块和功能,称为 TSL(Thing Specification Language)。
物模型 TSL 采用 JSON 格式。您可在物联网平台控制台产品详情页面,单击 物模型定义 页签,单击 导出物模型,查看或导出 JSON 格式的 TSL。您可以根据不同平台和所需模块导出物模型,其中:
您可以根据 TSL 的模板文件组装并上报设备的数据,实现物模型的导入。但只支持 JSON 文件的上传,且 JSON 文件限制在 512 KB, 单个文件字符数量限制在 256 * 1024 个。