服务定义

服务介绍

服务是用来描述一款设备是什么、能做什么以及如何控制该设备,即设备的上下行业务模型。服务由一系列属性组成,属性是对业务数据的描述,包括数据名称、数据类型、取值范围等信息。

非透传的产品需要定义属性列表和服务列表。

属性列表

在属性列表中,点击“新增属性”添加设备属性。属性值主要用于描述设备属性,并在数据上报时更新内部设备影子,为后续规则引擎模块提供参数。

属性标识符唯一代表某一属性,产品下具有唯一性,其格式要求须符合规范,且需认真填写,一经生成不允许修改。
对于紧凑二进制类型的产品,属性定义主要包括10种数据类型,如下图所示。

服务列表

选择“服务列表”,点击“新增服务”,可以添加四种类型的服务:数据上报、事件上报、指令下发、指令下发响应。

数据上报的参数只能从属性列表中选择,其余三种服务类型的参数可以从属性列表选择,也可以自定义参数。

输入的服务标识符必须产品下唯一,平台会为产品下的每个服务分配服务ID。

说明:

服务可以根据实际业务场景的变化进行增删改操作,且同一产品下的服务共用。

若某一属性已被服务征用,则不允许对其进行任何操作。

一个服务唯一对应一条报文,一个服务可包含多个属性或参数。

数据类型

portal上添加属性时,可以根据实际业务场景选择数据类型,目前AEP支持解析的数据类型包括以下9种:

1、无符号整型Unsigned Integer 1、2、4、8Byte 0 - 18446744073709551615

2、整型Integer 1、2、4Byte -2147483648 - 2147483647

3、定长Binary Fix-Binary 定长二进制码流 自定义字节长度 (UTF-8)

4、变长Binary Vary-Binary 变长二进制码流 (UTF-8)

5、定长字符串 Fix-String 定长字符串 自定义字节长度 (ASCII)

6、变长字符串 Vary-String 变长字符串 (ASCII)

7、单精度浮点型 Float 4Byte

8、双精度浮点型 Double 8Byte

9、时间戳TimeStamp 8Byte 表示从1970年1月1日0点到当前经过的时间长度(用户自定义以秒或毫秒为单位)

10、枚举值 enum 1byte 0~255

说明:

1、对于定长Binary、定长字符串字段,直接在门户设定其长度标识长度;变长Binary、变长字符串,可在报文中指定长度范围,按照如下定义进行编码:字段Length+字段Value (其中,字段 Length为2字节,表示后面的字段Value的长度)。

样例:

若需要上报的业务数据为字符串“TEST”,该字段定义的数据格式为变长字符串,则该字段编码结果为:000454455354。(其中,0004为实际业务数据TEST的长度,54455354为实际业务数据TEST的ASCII编码值)

2、对于定长Binary、变长Binary字段。上行数据,平台会解析后会进行base64编码,字段的最终数据会以base64字符串形式展示;下行指令,平台会直接将输入数据下发。

搜索结果 ""

    没有搜索结果 ""