功能定义说明
更新时间:2018-04-08 14:45:22
ICA数据标准平台对物的功能定义包含“属性”、“服务”和“事件”三部分,下面将分别说明各功能点在平台上的具体实现。
属性
属性,指设备运行时可持续存在的状态,例如电源开关,空调的目标温度,灯的亮度等,是一个可以持续存在的状态。通常由以下几部分组成:
- 属性名称:属性的中文名称。
- 标识符:属性的英文标识符。
- 数据类型及相关补充信息:该属性对应的数据类型以及相关信息,详情参见“数据类型详解”。
- 读写类型:分为“只读”和“读写”类型。
- 描述:对属性功能的文字描述。
服务
服务,是设备能够被远程调用而去执行的动作、指令,通常需要花费一定时间执行,例如设备复位、重启,修改密码等,包含"输入参数"和"输出参数"。通常由以下几部分组成:
- 服务名称:服务的中文名称。
- 标识符:服务的英文标识符。
- 输入参数:执行某一动作时需要的指令信息,可以为空。添加输入参数基本和添加属性相同,但区别是需要指定该参数对于服务来说是否为必选项。
- 输出参数:完成某一动作后需要反馈的状态信息,可以为空。添加输出参数同添加输入参数,也需要指定该参数对于服务来说是否为必选项。
- 描述:对属性功能的文字描述。
事件
事件,指在某种情况下物主动上报的信息,这类信息是无法通过查询物的属性而获知的。相比于属性状态,事件一般而言包含设备需要及时被外部感知和处理的通知信息,可包含多个输出参数,如某项任务完成的信息或者设备发生故障/告警时的温度等,事件可以被订阅和推送。通常由以下几部分组成:
- 事件名称:事件的中文名称。
- 标识符:事件的英文标识符。
- 事件类型:分为“信息”、“告警”和“故障”。
- 输出参数:需要及时被外部感知和处理的通知信息,可以为空。添加输出参数基本和添加属性相同,但区别是需要指定该参数对于服务来说是否为必选项。
- 描述:对属性功能的文字描述。