服务定义

服务介绍

设备的服务是用来描述一款设备是什么、能做什么以及如何控制该设备的文件。一个服务文件的内容主要包括设备的服务信息,这一部分定义了设备的业务数据,包括设备上报的上行数据和厂商服务器下发给设备的下行数据。每款设备都需要一个数据集文件。

对于T-Link协议,紧凑二进制及json格式数据均需在“服务定义”标签页内添加属性定义及服务定义。

属性列表

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

属性标识符唯一代表某一属性,产品下具有唯一性,其格式要求须符合规范,且需认真填写,一经生成不允许修改。

对于紧凑二进制类型的产品,属性定义主要包括10种数据类型。

对于json类型的产品,属性定义主要包括7种数据类型。

服务列表

在服务列表中,点击“新增服务”添加设备服务,主要用于定义设备某一具体的服务。服务ID唯一标识某一产品下的具体服务,在做具体的业务数据操作时,必须携带或选择服务ID。

服务种类主要分为数据上报、事件上报、数据获取、参数查询、参数配置、指令下发及指令下发响应等七种,用户根据实际业务场景进行选择。服务标识符唯一代表某一服务,产品内不允许重复,且需按照要求规范填写,一经生成不允许修改。

定义服务时,参数的顺序按照实际报文的payload字段顺序进行添加,全部添加完成后点击页面下方的“确认”方可生成一条服务。对于数据上报类型,参数仅允许从属性列表中选择添加。其他类型服务可由用户选择新建参数或从属性中选择。

说明:

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

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

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

数据类型

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

11、布尔值 bool

12、时间 date

说明:

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

样例:

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

2、对于定长Binary、变长Binary字段。平台经解析后会进行base64编码,字段的最终数据会以base64字符串形式展示。

搜索结果 ""

    没有搜索结果 ""