物模型是阿里云物联网平台为产品定义的数据模型,用于描述产品的功能。本文介绍物模型相关概念和使用限制。

功能说明

物模型是物理空间中的实体(如传感器、车载装置、楼宇、工厂等)在云端的数字化表示,从属性、服务和事件三个维度,分别描述了该实体是什么、能做什么、可以对外提供哪些信息。定义了物模型的这三个维度,即完成了产品功能的定义。

功能类型 说明
属性(Property) 设备可读取和设置的能力。一般用于描述设备运行时的状态,如环境监测设备所读取的当前环境温度等。属性支持GET和SET请求方式。应用系统可发起对属性的读取和设置请求。
服务(Service) 设备可被外部调用的能力或方法,可设置输入参数和输出参数。产品提供了什么功能供云端调用。相比于属性,服务可通过一条指令实现更复杂的业务逻辑,如执行某项特定的任务。
事件(Event) 设备运行时,主动上报给云端的事件。事件一般包含需要被外部感知和处理的通知信息,可包含多个输出参数。例如,某项任务完成的信息,或者设备发生故障或告警时的温度等,事件可以被订阅和推送。

物联网平台支持为产品定义多组功能(属性、服务和事件)。一组功能定义的集合,就是一个物模型模块。多个物模型模块,彼此互不影响。

物模型模块功能,解决了工业场景中复杂的设备建模,便于在同一产品下,开发不同功能的设备。

例如,电暖扇产品的功能属性有电源开关档位(高、中、低)室内温度,您可以在一个模块添加前2个属性,在另一个模块添加3个属性,然后分别在不同设备端,针对不同物模型模块功能进行开发。此时,该产品下不同设备就可以实现不同功能。

物联网平台已提供默认模块,您可根据需要新增自定义模块,总模块数量不超过20个。

注意 2021年01月01日(不含当日)之前已定义的产品功能,归类于物模型默认模块。

使用说明

物联网平台通过定义一种物的描述语言来描述物模型模块和功能,称为TSL(Thing Specification Language)。

物模型TSL文件格式为JSON。您可在物联网平台控制台产品详情页面,单击功能定义页签,单击物模型TSL,查看或导出JSON格式的TSL。相关字段说明,请参见物模型TSL字段说明

物联网平台支持单个和批量添加物模型。批量导入时,您可自定义物模型TSL文件,编写要求,请参见下文限制说明

限制说明

物模型功能定义限制,请参见产品与设备的物模型功能定义。以下为批量导入物模型TSL文件时的使用限制。

使用方法 限制说明
单个物模型TSL文件 文件后缀名为.json;文件内容必须符合JSON格式;文件大小不能超过512 KB;文件中有效字符数量不能超过256 KB(256*1024个字符)。

有效字符,指JSON格式内容中,除换行和对齐字符之外的字符。

多个物模型TSL文件
  • 必须压缩为.zip格式文件,文件大小不能超过2.5 MB,且能够正常解压。解压后的每个文件,必须满足单个TSL文件的规范。
  • 压缩包文件中至少包含1个有效的物模型文件,最多包含1个默认模块物模型文件,9个自定义模块物模型文件。
    注意 多个自定义物模型文件内的functionBlockNamefunctionBlockId不可重复。

相关文档