单个添加物模型,即单个添加属性、事件和服务。下面介绍如何在物联网平台控制台定义物模型。

背景信息

  • 物模型需要在模块中配置,每个产品中默认模块和自定义模块总个数不能超过10个。

操作步骤

  1. 登录物联网平台
  2. 点击设备管理,进入产品列表页,创建产品后,点击对应产品的查看按钮

image.png
image.png
3.点击功能定义
image.png
4.系统自动选择默认模块或者点击添加模块
5.可选:如果添加模块,填入参数,点击确定
image.png
6.添加标准功能,选择产品对应功能,点击确定
image.png
7.添加自定义功能,选择添加自定义功能。您可以为产品自定义属性、服务和事件。

  • 自定义属性:在自定义功能弹出框,功能类型选择属性,设置参数填写完,点击确定

image.png
属性参数设置说明如下:
功能名称:属性的名称,例如:用电量。同一产品下功能名称不能重复。
标识符:属性唯一标识符,在产品中具有唯一性。即Alink JSON格式中的identifier的值,作为设备上报该属性数据的Key,云端根据该标识符校验是否接收数据。支持英文、数字和下划线(_),不超过50个字符
数据类型

  • int:32位整型。需定义取值范围、步长和单位符号。
  • float:单精度浮点型。需定义取值范围、步长和单位符号。
  • double:双精度浮点型。需定义取值范围、步长和单位符号。
  • bool:布尔型。采用0或1来定义布尔值,例如:0表示关、1表示开。

取值范围:数据类型为int、float、double时,可设置属性值的取值范围,为bool,系统默认设置为 true-false
步长:属性值变化的最小粒度。数据类型为int、float、double时,可根据您的业务需要设置步长。例如:为温度计产品定义温度属性时,将数据类型设置为int32,步长为2,单位为℃,取值范围0~100。即温度每变化两度,设备上报温度值,例如:0℃、2℃、4℃、6℃、8℃等
读写类型

  • 读写:请求读写的方法支持GET(获取)和SET(设置)。
  • 只读:请求只读的方法仅支持GET(获取)。

描述:输入文字,对该功能进行说明或备注。长度限制为50个字符。

  • 自定义服务:在自定义功能弹出框,功能类型为服务。设置参数填写完,单击确定

image.png
服务参数设置说明如下:
功能名称:服务名称。支持中文、英文字母、日文、数字、短划线(-)、下划线()、正斜线(/)和英文句号(.),且必须以中文、英文、日文或数字开头,不超过30个字符。
标识符:服务唯一标识符,在产品下具有唯一性。即Alink JSON格式中该服务的identifier的值。支持英文、数字和下划线(
),不超过50个字符
调用方式

  • 异步:服务为异步调用时,云端执行调用后直接返回结果,不会等待设备的回复消息。
  • 同步:服务为同步调用时,云端会等待设备回复;若设备没有回复,则调用超时。

输入参数:设置该服务的入参,可选。单击增加参数,在弹窗对话框中添加服务入参。
输出参数:设置该服务的出参,可选。单击增加参数,在弹窗对话框中添加服务出参。
描述:输入文字,对该服务功能进行说明或备注。长度限制为50个字符

  • 自定义事件:自定义功能弹出框,功能类型为事件。设置参数填写完,单击确定

image.png
事件参数设置说明如下:
功能名称:事件的名称。支持中文、英文字母、日文、数字、短划线(-)、下划线()、正斜线(/)和英文句号(.),且必须以中文、英文、日文或数字开头,不超过30个字符
标识符:事件唯一标识符,在产品下具有唯一性。即Alink JSON格式中该事件的identifier的值,作为设备上报该事件数据的Key,例如:ErrorCode。 支持英文、数字和下划线(
),不超过50个字符。
事件类型

  • 信息:指设备上报的一般性通知,例如:完成某项任务。
  • 警告:设备运行过程中主动上报的突发或异常情况,告警类信息,优先级高。
  • 故障:设备运行过程中主动上报的突发或异常情况,故障类信息,优先级高。

输出参数:该事件的出参。单击增加参数,在弹窗对话框中添加一个服务出参。您可以使用某个属性作为出参,也可以自定义参数。例如:将已定义的属性电压作为出参,则设备上报该故障事件时,将携带当前设备的电压值,用于进一步判断故障原因。
描述:输入文字,对该事件功能进行说明或备注。长度限制为50个字符。

8.产品功能添加完成后,点击物模型TSL,可以查看产品JSON格式物模型数据
image.png