单个添加物模型,即单个添加属性、事件和服务。下面介绍如何在物联网平台控制台定义物模型。
背景信息
- 物模型需要在模块中配置,每个产品中默认模块和自定义模块总个数不能超过10个。
操作步骤
- 登录物联网平台
- 点击设备管理,进入产品列表页,创建产品后,点击对应产品的查看按钮
3.点击功能定义
4.系统自动选择默认模块或者点击添加模块
5.可选:如果添加模块,填入参数,点击确定
6.添加标准功能,选择产品对应功能,点击确定
7.添加自定义功能,选择添加自定义功能。您可以为产品自定义属性、服务和事件。
- 自定义属性:在自定义功能弹出框,功能类型选择属性,设置参数填写完,点击确定
属性参数设置说明如下:
功能名称:属性的名称,例如:用电量。同一产品下功能名称不能重复。
标识符:属性唯一标识符,在产品中具有唯一性。即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个字符。
- 自定义服务:在自定义功能弹出框,功能类型为服务。设置参数填写完,单击确定
服务参数设置说明如下:
功能名称:服务名称。支持中文、英文字母、日文、数字、短划线(-)、下划线()、正斜线(/)和英文句号(.),且必须以中文、英文、日文或数字开头,不超过30个字符。
标识符:服务唯一标识符,在产品下具有唯一性。即Alink JSON格式中该服务的identifier的值。支持英文、数字和下划线(),不超过50个字符
调用方式:
- 异步:服务为异步调用时,云端执行调用后直接返回结果,不会等待设备的回复消息。
- 同步:服务为同步调用时,云端会等待设备回复;若设备没有回复,则调用超时。
输入参数:设置该服务的入参,可选。单击增加参数,在弹窗对话框中添加服务入参。
输出参数:设置该服务的出参,可选。单击增加参数,在弹窗对话框中添加服务出参。
描述:输入文字,对该服务功能进行说明或备注。长度限制为50个字符
- 自定义事件:自定义功能弹出框,功能类型为事件。设置参数填写完,单击确定
事件参数设置说明如下:
功能名称:事件的名称。支持中文、英文字母、日文、数字、短划线(-)、下划线()、正斜线(/)和英文句号(.),且必须以中文、英文、日文或数字开头,不超过30个字符
标识符:事件唯一标识符,在产品下具有唯一性。即Alink JSON格式中该事件的identifier的值,作为设备上报该事件数据的Key,例如:ErrorCode。 支持英文、数字和下划线(),不超过50个字符。
事件类型:
- 信息:指设备上报的一般性通知,例如:完成某项任务。
- 警告:设备运行过程中主动上报的突发或异常情况,告警类信息,优先级高。
- 故障:设备运行过程中主动上报的突发或异常情况,故障类信息,优先级高。
输出参数:该事件的出参。单击增加参数,在弹窗对话框中添加一个服务出参。您可以使用某个属性作为出参,也可以自定义参数。例如:将已定义的属性电压作为出参,则设备上报该故障事件时,将携带当前设备的电压值,用于进一步判断故障原因。
描述:输入文字,对该事件功能进行说明或备注。长度限制为50个字符。
8.产品功能添加完成后,点击物模型TSL,可以查看产品JSON格式物模型数据