You need to enable JavaScript to run this app.
导航
物模型概述
最近更新时间:2024.06.14 12:54:40首次发布时间:2024.06.14 12:54:40

物模型是物理空间中的实体(如传感器、车载装置、楼宇、工厂等)在云端的数字化表示,可以对同一类型的设备进行标准化定义,便于设备的接入和数据的打通。

基本概念

物模型是物联网平台为产品定义的数据模型,用于描述产品的功能,其从属性、服务和事件三个维度来描述设备是什么、能做什么以及可以对外提供什么信息。定义了物模型的这三个维度,即完成了设备模板功能的定义。

功能类型

说明

属性(Property)

用于描述设备运行时具体信息和状态。
例如,冷链运输设备的温度、照明灯开关的状态、电风扇的风力等级等。
属性可分为读写和只读两种类型,即支持读取和设置属性。

服务(Service)

指设备可供外部调用的指令或方法。服务调用中可设置输入和输出参数。输入参数是服务执行时的参数,输出参数是服务执行后的结果。
相比于属性,服务可通过一条指令实现更复杂的业务逻辑,例如执行某项特定的任务。
服务分为异步和同步两种调用方式。

事件(Event)

设备运行时,主动上报给云端的信息,一般包含需要被外部感知和处理的信息、告警和故障。事件中可包含多个输出参数。
例如任务完成后的通知;设备发生故障时的温度、时间信息;设备告警时的运行状态等。
事件可以被订阅和推送。

物模型模块

物联网平台将产品的一组功能(属性、服务和事件)定义的集合,定义在一个物模型模块下。模块是为了满足复杂产品特性的物模型描述,便于在同一产品下,开发不同功能的设备。
例如温湿控制器,会由温度传感器、湿度传感器、调湿器、调温器等多个部分组成。您可以分别在不同设备端,针对不同物模型模块进行开发。此时,该产品下不同设备就可以实现不同功能。多个物模型模块,彼此互不影响。
物联网平台已提供默认模块,您可根据需要新增自定义模块,总模块数量不超过20个。

物模型 TSL 语言

物模型是对设备在云端的功能描述,包括设备的属性、服务和事件。物联网平台通过定义一种物的描述语言来描述物模型模块和功能,称为 TSL(Thing Specification Language)。
物模型 TSL 采用 JSON 格式。您可在物联网平台控制台产品详情页面,单击 物模型定义 页签,单击 导出物模型,查看或导出 JSON 格式的 TSL。您可以根据不同平台和所需模块导出物模型,其中:

  • 完整物模型:用于云端应用开发。
  • 精简物模型:配合设备端 SDK 实现设备开发。精简物模型支持导出。

您可以根据 TSL 的模板文件组装并上报设备的数据,实现物模型的导入。但只支持 JSON 文件的上传,且 JSON 文件限制在 512 KB, 单个文件字符数量限制在 256 * 1024 个。