什么是物模型？物模型功能说明和使用说明

最新推荐文章于 2025-10-25 11:14:04 发布

转载最新推荐文章于 2025-10-25 11:14:04 发布 · 2.7k 阅读

CC 4.0 BY-SA版权

文章标签：

5 篇文章

订阅专栏

物模型是阿里云物联网平台用于描述产品功能的数据模型，包括属性（描述设备状态）、服务（设备可执行的操作）和事件（设备主动上报的信息）。平台支持自定义模块，最大20个，且提供了TSL（ThingSpecificationLanguage）来描述物模型。批量导入TSL文件时有特定的格式和大小限制。

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

阿里云物联网技术开发文档:

物联网平台技术开发文产品简介_物联网平台-阿里云帮助中心物联网平台技术开发文阿里物联网技术官网文档全面权威，资料更全面。

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


功能类型	说明
属性（Property）	用于描述设备运行时具体信息和状态。例如，环境监测设备所读取的当前环境温度、智能灯开关状态、电风扇风力等级等。属性可分为读写和只读两种类型。读写类型支持读取和设置属性值，只读类型仅支持读取属性值。
服务（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个自定义模块物模型文件。重要多个自定义物模型文件内的functionBlockName和functionBlockId不可重复。