标准规范下载简介
Q／GDW 12185-2021 输变电设备物联网边缘计算应用软件接口技术规范.pdf表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
表B.32设置指令下发报文字段
B.3.3.2返回结果
数设置指令下发返回结果使用JSON格式封装，
表B.33设置指令下发返回结果
注l：对下发状态，下发成功时返回true，下发失败时返回false。 注2：对下发返回消息，请求失败时返回错误信息，请求成功时返回为空。
B.4框架静态元数据获取
B.4.1传感器静态属性数据获取
B.4.1.1请求报文字段
十算应用请求传感器静态属性数据的报文字段详
传感器静态属性数据请
B. 4. 1. 2返回结果
传感器静态属性查询结果使用JSON格式封装，详见表B.35.
表B.35传感器静态属性数据请求返回结果
B.4.2传感器物模型编号获取
Q/GDW12185202
B.4.2.1请求报文字段
应用请求传感器物模型编号的报文字详见表B.3
表B.36传感器物模型编号请求报文字段
B. 4. 2. 2返回结果
表B.37传感器物模型编号请求返回结果
表B.38传感器属性各字段含义格式
Q/GDW 121852021
表B.40传感器服务各字段含义格式
B.4.3传感器列表数据获取
B.4.3.1请求报文字段
传感器列表数据请求报文字段详见表B.41。
41传感器列表数据请
B. 4. 3. 2返回结果
传感器列表数据查询结果使用JSON格式封装，详见B.42.
表B.42传感器列表数据请求返回结果
B.4.4输变电设备静态属性数据获取
B.4.4.1请求报文字段
愉变电设备静态属性数据的请求报文字段详见表B.43
表B.43输变电设备静态属性数据请求报文字段
B.4.4.2返回结果
B.4.4.2返回结果
Q/GDW121852021
输变电设备静态属性查询结果使用JSON格式封装，详见表B.44。
表B.44输变电设备静态属性数据请求返回结果
B.4.5输变电设备列表数据获取
B.4.5.1请求报文字段
表B.45输变电设备列表数据请求报文字段
B.4.5.2返回结果
表数据查询结果使用JSON格式封装，详见表B
表B.46输变电设备列表数据返回结果
C.1JSON数据内容组成方式
Q/GDW12185202
JSON文件内容JSON文件内容采用文本方式编写，信息对为“关键词（keyword）"与“值（value）”， 信息对内部对应方式如下： a）一个“关键词”"对应一个“值”，一个完整的信息对以“{"开始，以“"结束，“关键词"和“值”之间以 “："相隔，多个信息对之间以“”相隔； b）一个“关键词"对应多个“值”，一个完整的信息对以“{"开始，以“"结束，对应的多个“值”为一个 数组，数组以“”开始，以“"结束，多个“值”之间使用“”"分隔
C.2报文及其结构要求
C.2. 1 传感器数据
传感器采用的报文结构参照： a）按照Q/GDW616中附录A在线监测逻辑节点定义以及Q/GDW1242中附录C应用层数据传输 规约部分； b）参照附录C.5~C.6提供的传感器相关报文结构
2.2输变电设备静态属
设备静态属性数据报文及其结构，参照附录C.6
C.3JSON数据信息对组合结构
JSON内部信息对的组合，分为单层结构和多层嵌套结构两种方式，具体如下： a）单层结构，信息对中的“值”为简单的字符串或者字符数组； b）嵌套结构，分为外层信息对和内层信息对，外层信息对中的“值”为JSON格式的子对象，包含 内层的“关键词”和“值”。
C.4单层与多层嵌套结构使用要求
JSON数据单层与多层嵌套结构使用范围如下： a）创建规则引擎、删除规则引擎、创建流式计算规则、删除流式计算规则、传感器历史感知数据 获取、传感器当前状态数据获取、当前采集图像数据获取、传感器通用参数设置、传感器列表 数据获取、输变电设备列表数据获取的请求报文采用单层结构； b）应用间业务数据交互、应用数据上报、传感器当前感知数据获取、传感器业务参数设置、传感 器告警参数设置、传感器静态属性数据获取、传感器物模型编号获取、输变电设备静态属性数 据获取的请求报文采用多层嵌套结构； c）接口返回值均采用单层结构。
C.5接口请求报文关键词及结构要求
各个接口所用请求报文关键词及结构详见表C.1至表C.18
Q/GDW121852021
表C.1应用间业务数据交互请求报文JSON字段结构
表C.2应用数据上报请求报文JSON字段结构
表C.3创建规则引擎请求报文JSON字段结构
表C.4删除规则引擎请求报文JSON字段结构
C.5创建流式计算规则请求报文JSON字段结
Q/GDW 121852021
表C.6删除流式计算规则请求报文JSON字段结构
传感器历史感知数据获取请求报文JSON字段结
表C.9传感器当前状态数据获取请求报文JSON字段结构
Q/GDW121852021
表C.10当前采集图像数据获取请求报文JSON字段结构
1传感器业务参数设置请求报文JSON字段结构
2传感器告警参数设置请求报文JSON字段结构
表C.13传感器通用参数设置请求报文JSON字段结构
传感器静态属性数据获取请求报文JSON字段结
传感器物模型编号获取请求报文JSON字段结机
Q/GDW121852021注：传感器物模型编号获取请求报文为字符串数组。表C.16传感器列表数据获取请求报文JSON字段结构第一层Keyword第二层Keywordcode无value无注：传感器列表数据获取请求报文为单层形式、方式一结构，type，value字段为第一层的keyword。表C.17输变电设备静态属性数据获取请求报文JSON字段结构第一层Keyword第二层Keywordequipmentid无注：输变电设备静态属性数据获取请求报文为单层形式、方式二结构，equipmentid作为key，value是设备id组成的数据。表C.18：输变电设备列表数据获取请求报文JSON字段结构第一层Keyword第二层Keywordcode无value无注：输变电设备列表数据获取请求报文为单层形式、方式一结构，type，value字段为第一层的keyword。C. 6返回结果关键词及结构要求各个接口返回结果关键词及结构详见表C.19至表C.26表C.19接口默认返回数据报文JSON字段结构第一层Keyword第二层Keywordstatus无message无注：接口默认返回数据格式采用单层结构，status和message字段做为keyword构建json。买采用该结构的返回字段有包括：应用业务数据获取、边缘计算应用数据上报、规则引擎创建、流式计算规则创建、当前感知数据获取、传感器业务参数设置、传感器告警参数设置、传感器通用参数设置。表C.20获取传感器历史感知数据返回结果报文JSON字段结构第一层Keyword第二层Keywordstatus无message无isfull无data无注：获取传感器历史感知数据返回结果采用单层结构，status、message、isfull、data字段为keyword构建json。25
Q/GDW121852021
表C.21传感器当前状态数据及当前采集图像数据获取的返回结果报文JSON字段结构
表C.22获取传感器静态属性数据返回结果报文JSON字段结构
双传感器物模型编号返回结果报文JSON字段结构
Q/GDW 121852021
表 C.23 (续)
表C.24传感器列表数据返回结果报文JSON字段结构
获取输变电设备列表数据返回结果报文JSONE
Q/GDW121852021
D.1应用业务数据请求
D.2应用业务数据上报
D.3传感器当前感知数据获取
Q/GDW12185202
温度传感器数据样例如下：
Q/GDW121852021
表D.1温度传感器数据格式
温湿度传感器数据样例如下：
湿度传感器数据样例如
表D.2温湿度传感器数据格式
D.5历史感知数据获取
或 1 "status":"false" "'message":"fail reason" "data".""
D.6传感器当前状态获取
Q/GDW 12185202
D.7当前采集图像获取
D.8传感器通用参数设置
D.9传感器业务参数设置
Q/GDW12185202
"status":true, "message"." ）或 "status":false, "message""
D.10传感器告警参数设置
传感器告警参数设置请求接口样例如下：
Q/GDW12185202
"code":"19033a030010015", "parameter":[ "id"："8"，//物理量38对应设备温度告警阅值（仅作为示例，不同物理量对应 id见电科院《输变电设备物联网传感器数据通信规约》） "upperlimit":"6o", "lowerlimit":"1o" 1 传感器告警参数设置指令下发返回结果格式样例如下： "status":true, "message":"" 或 "status":false,
essage"："errormessage"//依据不同原因返回不同错
D.11传感器静态属性数据获取
"phase":"", "templimit"："30", "humlimit":"50"
Q/GDW12185202
D.12传感器物模型编号数据获取
D.13传感器列表数据
传感器列表数据请求接口样例如下
D.14输变电设备静态属性获取
D.15输变电设备列表数据获取
表数据请求接口样例如
Q/GDW12185202
Q/GDW 121852021
变电设备物联网边缘计算应用软件接口技术
Q/GDW12185202
编制主要原则 与其他标准文件的关系. 主要工作过程.. 41 标准结构和内容. 2 条文说明. 42
主要原则， 也标准文件的关系. 工作过程. 结构和内容. 兑明..
JSH 2014-1025 远海区域疏浚工程船舶艘班费用参考定额Q/GDW12185202
本标准依据《国家电网有限公司关于下达2019年第二批技术标准制修订计划的通知》（国家电网科 （2019）807号文）的要求编制。 输变电设备边缘计算应用软件接口提供各类输变电边缘计算应用进行数据交换和指令交互的方法， 应对应用开发厂商开放，具备易开发、易使用、易检测的特性，支持不同类型应用相互之间、应用与上 级平台或下级终端交互的业务功能实现。自2019年以来，编写团队基于本规范规定的应用软件接口，开 展了接口一致性检测工作，目前已有10个厂家的15款应用经过接口检测，能够在现场正常实现应用功能， 验证了接口规范的有效性。因此，为了加快推进输变电边缘计算应用体系建设，制定本标准。 本标准的主要目的为规范输变电设备物联网边缘计算应用软件接口，保证边缘计算平台对业务应用 开发者的开放性，
本标准根据以下原则编制： a）坚持先进性与实用性相结合、统一性与灵活性相结合、可靠性与经济性相结合的原则，以标准 化为引领，服务公司科学发展； b）参考借鉴现有电力行业标准和企业标准，使标准具有科学性和规范性。 c）本标准规范了输变电设备物联网边缘计算应用软件与边缘计算框架之间、边缘计算应用软件相 互之间的数据交换方式和内容格式。 d）本标准项目计划名称为“输变电物联网技术规范第1部分：边缘计算应用软件接口”，因专家 评审时建议，经编写组与专家商定，更名为“输变电设备物联网边缘计算应用软件接口技术规 范”
3与其他标准文件的关系
本标准与相关技术领域的国家现行法律、 法规和政策保持一致。 本标准不涉及专利、软件著作权等知识产权使用问题，
2019年8月，成立标准编写组，制定工作方案和工作计划，确定了标准编写的总体思路。 2019年8月，在南京组织召开标准编制研讨会，明确修编思路，完成标准大纲编写。 2019年9月，完成标准集中编制，并对标准编制草案进行内部评审，形成初稿。 2020年4月，组织召开初稿审查会，提出修改意见。 2020年6月，公司专业工作组在线上组织第二次审查会，提出修改意见。 2020年6月，根据专家最终审查意见修改形成标准征求意见稿。 2020年8月，根据征求意见结果修改形成标准送审稿。 2020年11月，公司设备管理技术标准专业工作组（TC04）组织召开标准审查会，审查组的审查结 论为：修改后以技术标准形式报批。 2020年11月，修改形成标准报批稿
Q/GDW 12185202
本标准按照《国家电网公司技术标准管理办法》（国家电网企管（2018）222号文）的要求编写。 本标准的主要结构和内容如下： 本标准主题章分为3章，由总体架构、接口数据交换方式、边缘计算应用软件接口组成。第5章对输 变电设备边缘计算应用软件接口的总体架构进行介绍，给出软件接口分类。第6章详细介绍输变电边缘 计算应用软件使用的2种数据交换方式。第7章为边缘计算应用软件接口技术要求的主要章节，给出了边 像计算应用间及与边缘计算框架进行命令交互和数据交换的技术要求。规范中第5、6、7章是总分结构， 第5章为第6、7章的总体组织情况描述，第6章与第7章并列SL234-99 泵站施工规范及条文说明，分别描述软件接口数据交换方式和数据交 换内容两个方面