Q／GDW 12185-2021 输变电设备物联网边缘计算应用软件接口技术规范

表1主题格式字段含义

MQTT主题发布订阅的数

6.3.2.1MQTT主题发布订阅的数据交换方式分

6.3.2.2、6.3.2.3、6.3.2.4所述的三类情况下螺栓标准，应采用MQTT主题发布订阅方式进行数据交换

6.3.2.2边缘计算应用间数据交换

边缘计算应用间数据交换方式如图2所示，具体要求如下： a）作为数据源的边缘计算应用应先发送到数据源主题； b）应由消息路由建立数据源主题到目的地主题的联系； c）其他应用应通过订阅目的地主题来获取该主题下的应用业务数据。

Q/GDW121852021

6.3.2.3边缘计算应用获取传感器当前感知数

边缘计算应用获取传感器当前感知数据方式如图3所示，具体要求如下： a）边缘计算框架应将传感器当前感知数据发送到数据源主题； b）应由消息路由建立数据源主题到目的地主题的联系； ）其他应用应通过订阅目的地主题来获取该主题下的传感器当前感知数据

图2应用间数据交互形

6.3.2.4边缘计算应用向上级平台上报数据

图3应用获取传感器当前感知数据交互形式

边缘计算应用向上级平台上报数据方式如图4所示，具体要求如下： a）需上报数据的数据源应用应先发送数据到数据源主题； b）应由消息路由建立数据源主题到目的地主题的联系； c）边缘计算框架应将目的地主题中的应用数据通过云边交互协议发往上级平台

7边缘计算应用软件接口

7.1数据交换内容总体要求

图4应用数据向上级平台上报数据交互形式

表2数据交换内容总体架构

7.1.2请求及返回结果报文格式

数据交换所需发送的请求报文及返回值采用JSON格式封装。JSON文件内容采用文本方式编写， 信息对为“关键词（keyword）”与“值（value）”，报文字段含义详见附录B，报文结构参见附录C。

7.2应用业务数据交换

应用业务数据交换的请求方法详 务数据交换、应用数据上报、创建规则 删除流： 共6个软件接口

表3应用业务数据交换的交互方法

1：当使用缺省边缘计算框架时端口号为6001，如果使用其他边缘计算框架需使用该框架约定的端口号，地址 中的"v1"可随接口升级改变为v2"、“v3"等。 2：该接口用于应用向边缘计算椎架发送需上报上级平台的数据，框架收到请求报文中数据源主题后，将其与柜 认的目的地主题连接。

Q/GDW121852021

7.3传感器感知数据获取

表4传感器感知数据获取的交互方法

当使用缺省边缘计算架时端口号为6001，如果使用其他边缘计算椎架需 使用该框架约定的端口号，地址字段 可随接口升级改变为"v2"、“v3"等。 该接口用于边缘计算应用软件获取不满足Q/GDW12079的传感器数据。

传感器参数设置的请求方法详见表5，包括传感器业务参数设置、传感器告警参数设置、传感器 数设置，共3个软件接口。

表5传感器参数设置的交互方法

7.5框架静态元数据获取

框架静态元数据获取的请求方法详见表6，包括传感器静态属性数据获取、传感器物模型编号获取 器列表数据获取、输变电设备静态属性数据获取、输变电设备列表数据获取，共5个软件接口。 传感器物模型编号为该传感器所用物模型在注册时分配的编码。

表6框架静态元数据获取的交互方法

Q/GDW12185202

Q/GDW121852021

边缘计集 边缘计算应用输入输出主题格式如下： /v1/Route/$(AppName)/Input，其中： vl：表示当前定义的主题版本为vl； Route：表示消息路由功能； AppName：表示应用名称； Input：表示消息动作“输入”

B.1应用业务数据交换

B.1.1应用间业务数据交换

B.1.1.1请求报文字段

Q/GDW12185202

附录B （规范性附录） 边缘计算应用软件接口数据交互格式

边缘计算应用业务数据请求包括数据请求报文字段、消息来源对象字段、消息目标对象字段，均采 用JSON格式，详见表B.1至表B.3。

表B.1应用业务数据请求报文字段说明

表B.2消息来源对象各字段含义格式

3消息目标对象各字段

B. 1. 1. 2返回结果

边缘计算应用获取应用业务数据的返回结果详见表B.4。

表B.4应用业务数据请求返回结果

注1：当请求成功时，请求状态返回true，当失败时返回false 注2：请求失败时，请求消息返回错误信息，请求成功时返回路由id。

B.1.2应用数据上报

Q/GDW12185202

B.1.2.1请求报文字段

表B.5应用数据上报请求报文字段说明

表B.6应用数据源对象各字段含义格式

B.1.2.2返回结果

架将应用数据上报到平台的返回结果报文详见表

表B.7应用数据上报平台返回结果说明

B.1.3创建规则引擎

B.1.3.1请求报文字段

表B.8规则引擎创建请求报文字段说明

B.1.3.2返回结果

缘计算应用软件获取规则引擎创建的返回结果详

Q/GDW12185202

表B.9规则引擎创建请求返回结果

B.1.4 删除规则引擎

B.1.4.1请求报文字目

十算应用软件删除规则引擎请求字段，详见表B.1

表B.10删除规则引擎请求报文字段说明

B.1.5创建流式计算规则

B.1.5.1请求报文字段

目软件创建流式计算规则包括规则创建报文字段

表B.11流式计算规则创建请求报文字段说明

B. 1. 5. 2 返回结果

边缘计算应用软件获取流式计算规则的返回结果详见表B.12。

表B.12流式计算规则请求返回结果

Q/GDW121852021

B.1.6删除流式计算规则

应用软件删除流式计算规则请求字段详见表B.1

表B.13删除流式计算规则请求报文字段说明

B.2传感器感知数据获取

B.2.1传感器当前感知数据获取

B.2.1.1请求报文字段

从边缘计算框架获取当前感知数据报文字段应包 括实施感知数据请求报文字段、消息来源对象字 器信息对象字段、消息目标对象字段，均采用JSON格式，详见表B.14至表B.17。

表B.14当前感知数据请求报文字段

注1：source字段内容为传感器代码及其属性信息列表 注2：如请求全部传感器数据，source参数为空。

表B.15消息来源对象各字段含义格式

表B.16传感器信息对象各字段含义格式

Q/GDW 121852021

表B.17消息目标对象各字段含义格式

B. 2. 1. 2返回结果

框架输出的当前感知数据应采用JSON格式，返

表B.18当前感知数据返回结果说明

B.2.2传感器历史感知数据获取

B.2.2.1请求报文字段

象计算框架请求传感器历史感知数据的报文字段

表B.19历史感知数据请求报文字段

B.2.2.2返回结果

历史感知数据查询结果使用JSON格式封装，返回结果详见表B.20。

表B.20历史感知数据返回结果

Q/GDW121852021

注1：对于请求状态，请求成功返回true，请求失败返回false。 注2：对于请求信息，请求失败时返回错误信息，请求成功时返回空。 注3：对于全量标志，1表示全量，0表示非全量。 注4：对于传感器历史数据，数据格式为JSON数组，满足物模型要求

B.2.3传感器当前状态数据获取

B.2.3.1请求报文字段

传感器当前状态获取请求报文字段详见表B.21

表B.21当前状态获取请求报文字段

B.2.3.2返回结果

传感器当前状态获取请求返回结 1格式封装，报文字段详见表B.22。

表B.22当前状态获取返回结果

B.2.4当前采集图像数据获取

B.2.4.1请求报文字段

当前采集图像请求报文字段详见表B.23。

表B.23当前采集图像请求报文字段

B. 2. 4. 2返回结果

图像查询结果使用JSON格式封装，详见表B.24

Q/GDW 121852021

表B.24当前采集图像请求返回结果

B.2.5传感器数据获取通用接口返回结果

传感器数据获取通用接口返回结果为字符串，详见表B.25。

传感器数据获取通用接

B.3.1.1请求报文字段

传感器业务参数设置包含传感器业务参数设置请求报文、传感器业务参数设置内容字段，详 26、表B.27。

表B.26传感器业务参数设置请求报文字段

表B.27传感器业务参数设置内容字段含义

B. 3.1.2返回结果

设置指令下发的返回结果使用JSON格式封装，详见表B.28

Q/GDW121852021

表B.28传感器业务参数设置返回结果

B.3.2传感器告警参数设置

B.3.2.1请求报文字段

传感器告警参数设置包含传感器告警参数设置请求报文字段、传感器告警参数设置内容字段，详 29、表B.30。

表B.29传感器告警参数设置请求报文字段

暖通空调设计、计算表B.30传感器告警参数设置内容字段含义

B.3.2.2返回结果

设置指令下发返回结果使用JSON格式封装，详见表B.31

表B.31传感器告警参数设置返回结果

B.3.3传感器通用参数设置

B.3.3.1请求报文字段

传感器通用参数设置指令下发的报文字段详见表B.32。

硅钢片标准Q/GDW 121852021