功能定义(生成物的模型TSL)
更新时间:2018-06-21 11:10:30
产品功能
在每个产品中,都需要定义一套物的模型,具体可以查看 物的模型TSL 。
每个产品有两类功能:
功能类型 | 描述 |
---|---|
标准功能 | 根据ICA数据标准,平台为每个品类创建了默认的标准功能,分为可选和必选 |
自定义功能 | 如果标准功能不符合您的设备特征,您也可以自定义功能 |
功能审核
由于平台目前遵循ICA数据标准,所以自定义的部分需要平台审核,处理周期为1个工作日内,一般不会阻塞您的开发进展。在审核完成之前,平台暂无法使用未通过审核的自定义功能。审核期间,状态如下:
功能介绍
标准功能(无需审核):
平台默认创建的“必选功能”,会在打开这个页面时,默认展示如下:
点击“新增”,可以查看和选择“可选功能”。以灯为例,可以选择灯的功能,也可以搜索跨品类的功能:
自定义功能(需要审核)
当标准功能不够用时,开发者可以自定义功能。
自定义属性
数据类型包括:整型、浮点、枚举、布尔、字符串、时间型(string类型的UTC格式)、JSON对象(结构体)。
自定义服务
服务适用于较复杂的设备功能,比如需要带入参和出参。点击“新增输入参数”,在弹窗中添加服务的输入/输出参数,您可以选择将产品下的某个属性直接作为参数,也可以完全自定义一个新的参数。单个服务最多可分别添加10个入参或10个出参。
自定义事件
事件分为三种类型:“信息”、“告警”和“故障”,“信息”是设备上报的一般性通知,如完成某项任务等,“告警”和“故障”是设备运行过程中主动上报的突发或异常情况,优先级更高。事件由设备主动上报,设备可以携带该事件的相关参数进行输出,如设备上报了一个“过热”的告警事件,并携带了设备的当前温度。
添加事件的输出参数时可以选择将当前已有的属性直接作为参数上报,也可以自定义参数。请注意,单个事件最多可以添加10个输出参数。
自动生成物的模型 TSL
功能定义完成后,平台能够根据“标准功能” 和(通过审核后)“自定义功能”,自动生成一份Json格式的TSL。