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

1、ICS 35. 080Q/GDW国家电网有限公司企业标准Q/GDW 121852021输变电设备物联网边缘计算应用软件接口技术规范Technical standard for the interface of edge computing application software for theInternet of Things for power transmission and transformation equipment2021-12-06 实施2021-12-06 发布国家电网有限公司Q/GDW 121852021目 次tti Wii1 翻l2 规范性引用文件13 术i吾轍5C1

2、4鵬i吾15創本棚26边缘计算应用软件接口数据交换方式27 边缘计算应用软件接口技术要求4附录A （规范性附录）边缘计算应用输入输出主题格式8附录B （规范性附录）边缘计算应用软件接口请求报文字段以及返回结果9附录C （资料性附录）接口数据交换请求报文与返回值JS0N文件关键词及结构要求21附录D （资料性附录）边缘计算应用软件数据交换样例29綱側38IQ/GDW 121852021为规范输变电设备物联网边缘计算应用软件接口的数据交换方式和内容格式，提高边缘计算应用软 件与边缘计算框架、边缘计算应用软件相互之间的兼容性，制定本标准。本标准由国家电网有限公司设备管理部提出并解释。本标准由国家电网

3、有限公司科技部归口。本标准起草单位：国网江苏省电力有限公司电力科学研究院、国网江苏省电力有限公司、国网天津 市电力公司、国网河北省电力有限公司、国网安徽省电力有限公司、国网信息通信产业集团有限公司、 中国科学院上海微系统与信息技术研究所、南瑞集团有限公司、南京信息技术研究院。本标准主要起草人：胡成博、刘子全、秦剑华、付慧、姚楠、张国江、邵进、熊泽群、贾骏、冯笑、 路永玲、姚建光、程阳、朱雪琼、王真、李双伟、陶风波、钱宇骋、张克谦、冯军基、郑敏、周明拓、 赵兴楼、刘波、吕红志、王鹏。本标准首次发布。本标准在执行过程中的意见或建议反馈至国家电网有限公司科技部。IIQ/GDW 121852021输变

4、电设备物联网边缘计算应用软件接口技术规范1范围本标准规定了输变电设备物联网边缘计算应用软件与边缘计算框架、边缘计算应用软件相互之间的 数据交换方式和内容格式。本标准适用于输变电设备物联网窄带数据边缘计算应用软件数据交换和命令交互接口的使用和测 试。2规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。 凡是不注日期的引用文件，其最新版本(包括所有的修改单)适用于本文件。Q/GDW 616基于DL/T860标准的变电设备在线监测装置应用规范Q/GDW 1242架空输电线路状态监测装置通用技术规范Q/GDW 12021输变电设备物联网节点设备无线组

5、网协议Q/GDW 12079输变电设备物联网传感器数据规范Q/GDW 12120统一边缘计算框架技术规范3术语和定义Q/GDW616、Q/GDW 12021 > Q/GDW 1242> Q/GDW 12079和Q/GDW 12120界定的以及下列术语 和定义适用于本文件。3. 1边缘计算框架 edge computing frame支撑边缘计算的开放式平台软件，提供软件层面的数据接入、存储与共享、端设备管理、信息物模 型管理、应用管理、安全服务等基础功能。3. 2输变电设备物联网窄带边缘计算框架 narrowband data edge computing frame for th

6、e Internet of Things for power transmission and transformation equipment应用于输变电窄带数据业务场景的边缘计算框架，本规范涉及的边缘计算框架均指输变电设备物联 网窄带边缘计算框架。4缩略语下列缩略语适用于本文件。MQTT:消息队列遥测传输(Message Queuing Telemetry Transport)IoT：物联网(Internet of Things)REST：表述性状态转移(Representational State Transfer)5总体架构5. 1边缘计算框架概述5. 1. 1框架定位输变电设备物联网

7、边缘计算框架是一套适用于输变电场景的边缘侧基础平台软件，可运行在输变电 设备物联网边缘物联代理上，具体定位如图1所示。* +与平台数据交互专业应用APP边设备输变电设备物联网边缘计算框架输变电基础采集类及公共共享类APP统一边缘计算框架与终端数据交互图1输变电设备物联网边缘计算框架定位5. 1.2主要功能输变电设备物联网边缘计算框架功能要求如下：a）应具备与上级平台数据交互功能；b）应支持边缘操作系统管理，包括应用运行状态监视、管理；c）应支持输变电设备物联网终端当前和历史采集数据的存取；d）应支持输变电设备信息、输变电设备物联网终端与输变电设备连接关系信息的存取；e）应支持输变电设备物联网终

8、端的本地注册、接入；f）应支持输变电设备物联网终端信息模型的本地注册及管理；g）应满足输变电设备物联网终端的数据解析要求；h）宜支持输变电设备传感网管理，包括传感器采集参数配置、汇聚节点黑白名单配置等；i）宜支持其他输变电专业系统业务数据（流媒体数据除外）的接入。5.2接口结构边缘计算应用软件接口包括以下2种：a）边缘计算应用之间的接口，实现应用软件间的数据交互；b）边缘计算应用、边缘计算框架之间的接口，实现边缘计算应用与边缘计算框架之间的数据交互。6接口数据交换方式6. 1交换方式分类数据交换方式采用RESTfol命令方式及MQTT主题发布订阅方式两类。6. 2 RESTful命令方式6.

9、2. 1 RESTful命令格式RESTfiil命令应包含地址（Address）、方法（Method）、参数（Parameter）三个字段，地址格式应 遵循7.2至7.5节请求发送地址相关要求；方法字段可使用“GET”、“POST”、“DELETE”，分别表 示从指定的地址请求数据、向指定的地址提交待处理数据、删除资源；参数内容应为JSON格式数据包。 6. 2. 2采用RESTfu I命令的数据交换方式以下所述三类情况下应采用RESTful命令方式进行数据交换，具体要求如下：a）边缘计算应用向边缘计算框架发起获取框架静态元数据及传感器感知数据（除实时感知数据） 的请求，边缘计算框架收到该请求

10、后，应直接将数据返回给边缘计算应用；b）边缘计算应用向边缘计算框架发起传感器参数设置数据的请求，边缘计算框架收到该请求后， 应将指令下发并向边缘计算应用反馈是否下发成功；c）边缘计算应用向边缘计算框架发起建立数据源主题到目的地主题之间连接关系的请求，边缘计 算框架收到该请求后，应建立主题间连接关系，并向边缘计算应用反馈是否连接成功。6. 3 MQTT主题发布订阅方式6. 3. 1 MQTT主题格式边缘计算应用与框架使用的MQTT主题应包含主题版本（Version）、可用功能（Function）、边缘 计算应用名称（Appname）及消息动作（Action）四个字段，顺序为Version>

11、 Function> Appname> Action, 各字段间用7”隔开，具体格式和各字段含义及要求详见表1，格式样例详见附录A。表1主题格式字段含义字段含义要求Version主题版本主题版本取值为字母V加一个自然数，如vl、v2、v3Function可用功能接口规范内可用功能有且仅有“Route”，表示消息路由Appname边缘计算应用名称边缘计算应用名称为用户自定义，应全部由英文字母连贯组成， 长度不应超过20个字符Action消息动作取值“Input”或“Output”，若存在多个输入输出应拼接递增自然 数，如 “Input02” 或 “Output02”6. 3. 2采用

12、MQTT主题发布订阅的数据交换方式6. 3. 2. 1 MQTT主题发布订阅的数据交换方式分类、、所述的三类情况下，应采用MQTT主题发布订阅方式进行数据交换。6. 3. 2. 2边缘计算应用间数据交换边缘计算应用间数据交换方式如图2所示，具体要求如下：a）作为数据源的边缘计算应用应先发送到数据源主题；b）应由消息路由建立数据源主题到目的地主题的联系；c）其他应用应通过订阅目的地主题来获取该主题下的应用业务数据。数据源应用发送应用数据连接k 收取应用数据L-其他应用由消息路由数据源主题目的地主题（数据源应用订阅）（其他应用订阅）图2应用间数据交互形式6

13、. 3. 2. 3边缘计算应用获取传感器当前感知数据边缘计算应用获取传感器当前感知数据方式如图3所示，具体要求如下：a）边缘计算框架应将传感器当前感知数据发送到数据源主题；b）应由消息路由建立数据源主题到目的地主题的联系；数据源主题目的地主题（边缘计算框架订阅）（其他应用订阅）c）其他应用应通过订阅目的地主题来获取该主题下的传感器当前感知数据。11图3应用获取传感器当前感知数据交互形式6. 3. 2. 4边缘计算应用向上级平台上报数据边缘计算应用向上级平台上报数据方式如图4所示，具体要求如下：a）需上报数据的数据源应用应先发送数据到数据源主题；b）应由消息路由建立数据源主题到目的地主题的联系；

14、c）边缘计算框架应将目的地主题中的应用数据通过云边交互协议发往上级平台。数据源主题目的地主题图4应用数据向上级平台上报数据交互形式7边缘计算应用软件接口7. 1数据交换内容总体要求 7.1.1总体结构数据交换内容总体结构详见表2,包括应用业务数据交换、传感器感知数据获取、传感器参数设置、 框架静态元数据获取4类。表2数据交换内容总体架构序号接口类型接口名称说明1应用业务数据交换应用间业务数据交换用于实现不同应用间的数据交换2应用数据上报用于应用将数据发送给边缘计算框架的数据上报接口3创建规则引擎用于创建数据处理相关规则4删除规则引擎用于删除规则引擎5创建流式计算规则用于创建对流式数据的计算规则

15、6删除流式计算规则用于删除流式计算规则7传感器感知数据获取传感器当前感知数据获取用于获取传感器最近一次采集数据8传感器历史感知数据获取用于获取过去一段时间内所有传感器感知数据9传感器当前状态数据获取用于获得传感器在线情况、电池水平等状态数据10当前采集图像数据获取用于获取摄像头采集的图像数据11传感器数据获取通用接口用于边缘计算应用软件获取非标准化传感器数据12传感器参数设置传感器业务参数设置用于应用向传感器下发单值指令13传感器告警参数设置用于应用向传感器下发上下阈值设置指令14传感器通用参数设置用于边缘计算应用向边缘计算框架发送非标准传感器控制指令15框架静态元数据获取传感器静态属性数据获

16、取用于应用获取传感器挂载的设备、挂载位置、传感器类型等数据16传感器物模型编号获取用于获取传感器对应的模型编号17传感器列表数据获取用于获取同类型传感器的列表18输变电设备静态属性数据获取用于获取一次设备基础信息19输变电设备列表数据获取用于获取一次设备列表7.1.2请求及返回结果报文格式数据交换所需发送的请求报文及返回值采用JSON格式封装。JSON文件内容采用文本方式编写， 信息对为“关键词（keyword） ”与“值（value） ”，报文字段含义详见附录B，报文结构参见附录C。 7.2应用业务数据交换应用业务数据交换的请求方法详见表3,包括应用间业务数据交换、应用数据上报、创建规则引擎

17、、 删除规则引擎、创建流式计算规则、删除流式计算规则，共6个软件接口。表3应用业务数据交换的交互方法序号接口名称请求发送地址$请求方法1应用间业务数据交换http:/localhost:6001/ api/v 1 / app/router/appdataPOST2应用数据上报注2http:/localhost:6001/api/vl/app/upload/appdataPOST3创建规则引擎http :/localhost :6001/ api/v 1 /ruleEnginePOST4删除规则引擎http :/localhost :6001/ api/v 1 /ruleEngineDELETE

18、5创建流式计算规则http:/localhost:6001/api/vl/streamComputingPOST6删除流式计算规则http:/localhost:6001/api/vl/streamComputingDELETE注1 :当使用缺省边缘计算框架时端口号为6001，如果使用其他边缘计算框架需使用该框架约定的端口号，地址字 段中的"v1"可随接口升级改变为"v2"、"v3"等。注2 :该接口用于应用向边缘计算框架发送需上报上级平台的数据，框架收到请求报文中数据源主题后，将其与框架 默认的目的地主题连接。7.3传感器感知数据获

19、取传感器感知数据获取的交互方法详见表4,包括传感器当前感知数据获取、传感器历史感知数据获 取、传感器当前状态获取、当前采集图像数据获取、传感器数据获取通用接口，共5个软件接口。表4传感器感知数据获取的交互方法序号接口名称请求发送地址$请求方法1传感器当前感知数据获取http:/localhost:6001/api/vl/app/router/sensordataPOST2传感器历史感知数据获取http :/localhost:6001 /api/vl /sensordata/historyPOST3传感器当前状态数据获取http :/localhost: 6001/api/vl/sensord

20、ata/currentPOST4当前采集图像数据获取http:/localhost:6001/api/vl/camera/picPOST5传感器数据获取通用接口#http:/localhost:6001/api/v 1 /sensor/unstandard/topicGET注1 :当使用缺省边缘计算框架时端口号为6001 ,如果使用其他边缘计算框架需使用该框架约定的端口号，地址字段中 的"v1"可随接口升级改变为"v2"、“v3”等。注2 :该接口用于边缘计算应用软件获取不满足Q/GDW 12079的传感器数据。7.4传感器参数设置传感器参数设置的请求方

21、法详见表5,包括传感器业务参数设置、传感器告警参数设置、传感器通 用参数设置，共3个软件接口。表5传感器参数设置的交互方法序号接口名称请求发送地址请求方法1传感器业务参数设置http: /localhost:6001/api/vl /sensor/config/commonparamterPOST2传感器告警参数设置http :/localhost:6001 / api/v 1 / sensor/config/ alarmparamterPOST3传感器通用参数设置http:/localhost:6001/api/vl/sensor/config/paramterPOST注1 :当使用缺省边缘

22、计算框架时端口号为6001 ,如果使用其他边缘计算框架需使用该框架约定的端口号，地址字段中的"v1"可随接口升级改变为"v2"、"v3"等。注2 :传感器设置参数不满足Q/GDW 12079时，采用该接口设置下发。7.5框架静态元数据获取框架静态元数据获取的请求方法详见表6,包括传感器静态属性数据获取、传感器物模型编号获取、 传感器列表数据获取、输变电设备静态属性数据获取、输变电设备列表数据获取，共5个软件接口。其 中，传感器物模型编号为该传感器所用物模型在注册时分配的编码。表6框架静态元数据获取的交互方法序号接口名称请求发送地址a请

23、求方法1传感器静态属性数据获取http :/localhost:6001/api/v 1 /metadata/ sensorinfoPOST2传感器物模型编号获取http:/localhost: 6001 /api/v 1 /metadata/sensortypePOST3传感器列表数据获取http:/localhost:6001/ api/v 1 /sensor/config/paramterPOST表6（续）序号接口名称请求发送地址a请求方法4输变电设备静态属性数据获取http:/localhost:6001/api/vl/metadata/sensorcodePOST5输变电设备列表数据

24、获取http:/localhost:6001/api/v 1/metadata/ equipmentinfoPOST注：当使用缺省边缘计算框架时端口号为6001，如果使用其他边缘计算框架需使用该框架约定的端口号，地址字段中的“v1”可随接口升级改变为“v2”、"v3"等。附录A（规范性附录）边缘计算应用输入输出主题格式边缘计算应用输入输出主题格式如下:/v 1 /Route/$AppName/Input,其中：vl:表不当前定义的主题版本为vl;Route：表示消息路由功能；AppName： 表示应用名称；Input：表示消息动作“输入”。附录B（规范性附录）边缘计算应用软

25、件接口数据交互格式B. 1应用业务数据交换B. 1.1应用间业务数据交换B.1.1.1请求报文字段边缘计算应用业务数据请求包括数据请求报文字段、消息来源对象字段、消息目标对象字段，均采 用JSON格式，详见表B.1至表B.3。表B. 1应用业务数据请求报文字段说明字段类型是否必须含义sourceJSON是消息来源destinationJSON是消息目标表B.2消息来源对象各字段含义格式字段类型是否必须含义appnameString是边缘计算应用名称addressString是消息源地址表B.3消息目标对象各字段含义格式字段类型是否必须含义appnameString是边缘计算应用名称addres

26、sString是消息目标地址B. 1. 1.2返回结果边缘计算应用获取应用业务数据的返回结果详见表B.4。表B.4应用业务数据请求返回结果字段类型是否必须含义statusBoolean是请求状态!4 1messageString是请求消息8：2注1:当请求成功时，请求状态返回true，当失败时返回fhlse。 注2:请求失败时，请求消息返回错误信息，请求成功时返回路由id。B.1.2应用数据上报B. 1.2. 1请求报文字段应用数据上报到平台的请求包括上报平台请求报文字段、应用数据对象字段，均采用JSON格式， 报文字段详见表B.5、表B.6。表B.5应用数据上报请求报文字段说明字段类型是否必

27、须含义source 注JSON是应用数据源注：source为自定义的主题名称，框架收到该主题后，将其与框架默认的应用数据上报主题连接，默认应用数据上报 主题按照Q/GDW 12120附录A中数据上报主题要求执行。表B.6应用数据源对象各字段含义格式字段类型是否必须含义appnameString是边缘计算应用名称addressString是消息源主题地址B. 1.2. 2返回结果边缘计算框架将应用数据上报到平台的返回结果报文详见表B.7。表B.7应用数据上报平台返回结果说明字段类型是否必须含义statusBoolean是上报状态S1messageString是上报信息注1:对于上报状态，上报请求

28、成功时返回true，请求失败时返回felse。 注2:对于上报信息，请求失败时返回错误信息，请求成功时返回路由id。B.1.3创建规则引擎B. 1.3. 1请求报文字段边缘计算创建规则引擎包括规则创建报文字段详见表B.8。表B.8规则引擎创建请求报文字段说明字段类型是否必须含义nameString是规则名称descriptionString是规则描述sourceString是数据源主题destinationString是目的输出主题rulecontentString是规则内容（Base64编码）B. 1.3.2返回结果边缘计算应用软件获取规则引擎创建的返回结果详见表B.9。表B.9规则引擎创建

29、请求返回结果字段类型是否必须含义statusBoolean是请求状态ft 1messageString是请求消息;2注1:当请求成功时，请求状态返回true，当失败时返回folse。注2:请求失败时，请求消息返回错误信息，请求成功时返回被创建的规则引擎的id。B.1.4删除规则引擎B. 1.4. 1请求报文字段边缘计算应用软件删除规则引擎请求字段，详见表B.10。表B. 10删除规则引擎请求报文字段说明字段类型是否必须含义idString是规则引擎的idB. 1.5创建流式计算规则B. 1.5. 1请求报文字段边缘计算应用软件创建流式计算规则包括规则创建报文字段详见表B.11。表B. 11流式

30、计算规则创建请求报文字段说明字段类型是否必须含义nameString是规则名称descriptionString是规则描述sourceString是数据源主题destinationString是结果输出主题typeInt是支持编程语言类型algorithmcontentString是算法内容（Base64编码）B. 1.5.2返回结果边缘计算应用软件获取流式计算规则的返回结果详见表B.12。表B. 12流式计算规则请求返回结果字段类型是否必须含义statusBoolean是请求状态*£ 1Q/GDW 121852021字段类型是否必须含义messageString是请求消息it 2注

31、1：当请求成功时，请求状态返回true,当失败时返回fhlse。注2:请求失败时，请求消息返回错误信息，请求成功时返回流式计算规则的id。B.1.6删除流式计算规则边缘计算应用软件删除流式计算规则请求字段详见表B.13。表B. 13删除流式计算规则请求报文字段说明字段类型是否必须含义idString是流式计算规则的idB. 2传感器感知数据获取B. 2. 1传感器当前感知数据获取B. 2.1.1请求报文字段从边缘计算框架获取当前感知数据报文字段应包括实施感知数据请求报文字段、消息来源对象字段、 传感器信息对象字段、消息目标对象字段，均采用JSON格式，详见表B.14至表B.17。表B. 14当

32、前感知数据请求报文字段字段类型是否必须含义sourceJSONArray是消息来源1destinationJSON是消息目标S2注1： source字段内容为传感器代码及其属性信息列表。 注2:如请求全部传感器数据，source参数为空。表B. 15消息来源对象各字段含义格式字段类型是否必须含义sensorinfoJSONArray否传感器信息sensortypeStringArray否传感器物模型编号表B. 16传感器信息对象各字段含义格式字段类型是否必须含义sensorcodeString是传感器代码sensorattrArray是传感器属性表B. 17消息目标对象各字段含义格式字段类型是

33、否必须含义appnameString是边缘计算应用名称addressString是消息目标地址B. 2. 1.2返回结果边缘计算框架输出的当前感知数据应采用JSON格式，返回结果详见表B.18。 表B. 18当前感知数据返回结果说明字段类型是否必须含义statusBoolean是请求状态s 1messageString是请求返回消息注1:对于请求状态，请求成功时返回true，请求失败返回false。注2:对于请求返回消息，请求失败时返回错误信息，请求成功返回路由id。B. 2.2传感器历史感知数据获取B. 2. 2. 1请求报文字段边缘计算应用向边缘计算框架请求传感器历史感知数据的报文字段详见

34、表B.19。表B. 19历史感知数据请求报文字段字段类型是否必须含义idString是传感器idfromLong是开始时间（毫秒）注toLong是截止时间（毫秒）注：开始时间与截止时间的基准为世纪秒。B. 2. 2. 2返回结果历史感知数据查询结果使用JSON格式封装，返回结果详见表B.20。 表B.20历史感知数据返回结果字段类型是否必须含义statusBoolean是请求状态ft 1messageString是请求信息S2isfullNumber否全量标志S3dataArray否传感器历史数据13Q/GDW 121852021注1:对于请求状态，请求成功返回true，请求失败返回fhlse

35、。注2:对于请求信息，请求失败时返回错误信息，请求成功时返回空。 注3:对于全量标志，1表示全量，0表示非全量。注4:对于传感器历史数据，数据格式为JSON数组，满足物模型要求。B. 2.3传感器当前状态数据获取B. 2. 3. 1请求报文字段传感器当前状态获取请求报文字段详见表B.21。表B. 21当前状态获取请求报文字段字段类型是否必须含义idString是传感器idB. 2. 3. 2返回结果传感器当前状态获取请求返回结果使用JSON格式封装，报文字段详见表B.22。 表B.22当前状态获取返回结果字段类型是否必须含义statusBoolean是请求状态messageString是请求返

36、回信息dataArray否传感器当前数据注1:对请求状态，下发成功时返回true,下发失败时返回fhlse。注2:对请求返回消息，请求失败时返回错误信息，请求成功时返回为空，若请求成功，返回传感器当前数据，数据 格式为JSON数组，满足物模型要求，请求失败则返回空。B. 2.4当前采集图像数据获取B. 2. 4. 1请求报文字段当前采集图像请求报文字段详见表B.23。表B.23当前采集图像请求报文字段字段类型是否必须含义idString是摄像头编号B. 2. 4. 2返回结果表B.24当前采集图像请求返回结果字段类型是否必须含义statusBoolean是请求成功返回true,请求失败返回fa

37、lsemessageString是请求失败返回错误信息dataString是Base64编码的摄像头图片数据B. 2.5传感器数据获取通用接口返回结果传感器数据获取通用接口返回结果为字符串，详见表B.25。表B.25传感器数据获取通用接口返回结果字段类型是否必须含义-String是非标准传感器数据获取的主题注：接口直接返回字符串，默认采用“/vl/route/sensorAcquisition/output”作为非标准传感器数据获取的主题。B.3传感器参数设置B. 3.1传感器业务参数设置B. 3.1.1请求报文字段传感器业务参数设置包含传感器业务参数设置请求报文、传感器业务参数设置内容字段，

38、详见表 B.26、表B.27。表B. 26传感器业务参数设置请求报文字段字段类型是否必须含义codeString是传感器代码parameterJSON Array是业务参数设置内容表B.27传感器业务参数设置内容字段含义字段类型是否必须含义idString是业务参数物理量idvalueString是业务参数设置值B. 3. 1.2返回结果设置指令下发的返回结果使用JSON格式封装，详见表B.28。15Q/GDW 121852021表B.28传感器业务参数设置返回结果字段类型是否必须含义statusBoolean是下发状态81messageString是下发返回消息注1:对下发状态，下发成功时返

39、回true，下发失败时返回fhlse。注2:对下发返回消息，请求失败时返回错误信息，请求成功时返回为空。B. 3.2传感器告警参数设置B. 3. 2. 1请求报文字段传感器告警参数设置包含传感器告警参数设置请求报文字段、传感器告警参数设置内容字段，详见 表B.29、表B.30。表B. 29传感器告警参数设置请求报文字段字段类型是否必须含义codeString是传感器代码parameterJSONArray是告警参数设置内容表B. 30传感器告警参数设置内容字段含义字段类型是否必须含义idString是告警参数物理量idupperlimitString是告警参数上限值lowerlimitStri

40、ng是告警参数下限值B. 3. 2. 2返回结果设置指令下发返回结果使用JSON格式封装，详见表B.31。表B.31传感器告警参数设置返回结果字段类型是否必须含义statusBoolean是下发状态WmessageString是下发返回消息S2注1:对下发状态，下发成功时返回true,下发失败时返回felse。注2:对下发返回消息，请求失败时返回错误信息，请求成功时返回为空。B. 3.3传感器通用参数设置B. 3. 3. 1请求报文字段传感器通用参数设置指令下发的报文字段详见表B.32。#Q/GDW 121852021表B.32设置指令下发报文字段字段类型是否必须含义parameter 注St

41、ring是通用参数设置内容注：parameter是原始报文base64编码后内容，要求字段内容可以直接被感知设备解析和理解。B. 3. 3. 2返回结果参数设置指令下发返回结果使用JSON格式封装，详见表B.33。表B.33设置指令下发返回结果字段类型是否必须含义statusBoolean是下发状态messageString是下发返回消息注1:对下发状态，下发成功时返回true,下发失败时返回fhlse。注2:对下发返回消息，请求失败时返回错误信息，请求成功时返回为空。B.4框架静态元数据获取B. 4. 1传感器静态属性数据获取B. 4.1.1请求报文字段边缘计算应用请求传感器静态属性数据的报

42、文字段详见表B.34。表B. 34传感器静态属性数据请求报文字段字段类型是否必须含义codeArray是传感器代码B. 4. 1.2返回结果传感器静态属性查询结果使用JSON格式封装，详见表B.35。表B. 35传感器静态属性数据请求返回结果字段类型是否必须含义equipmentString是挂载输变电设备equipmentidString是挂载输变电设备idtypenameString是传感器类型名称typecodeString是传感器物模型编号locationString是安装位置sampletimeString是采样时间间隔，单位秒phaseString是安装相位，A、B、CB. 4.2

43、传感器物模型编号获取B. 4. 2. 1请求报文字段边缘计算应用请求传感器物模型编号的报文字详见表B.36。表B. 36传感器物模型编号请求报文字段字段类型是否必须含义codeArray是传感器物模型编号s注：传感器物模型编号应通过上级平台赋予。B. 4. 2. 2返回结果传感器物模型编号查询结果为JSON格式封装，详见表B.37。其中传感器属性、传感器事件、传感 器服务的报文字段详见表B.38至表B.40。表B.37传感器物模型编号请求返回结果字段类型是否必须含义codeString是传感器物模型编号nameString是传感器类型名称descriptionString是传感器类型描述man

44、ufacturerString是传感器厂商resourcesJSONArray是传感器属性eventJSONArray是传感器事件serviceJSONArray是传感器服务表B.38传感器属性各字段含义格式字段类型是否必须含义codeString是传感器属性代码nameString是传感器属性名称typeString是传感器属性类型unitString是传感器属性单位表B. 39传感器事件对象各字段含义格式字段类型是否必须含义codeString是传感器事件代码nameString是传感器事件名称typeString是传感器事件类型表B.40传感器服务各字段含义格式字段类型是否必须含义cod

45、eString是传感器服务代码nameString是传感器服务名称typeString是传感器服务调用方式commandString是传感器服务调用方法名称inputArray是传感器服务输入参数outputArray是传感器服务输出参数B. 4.3传感器列表数据获取B. 4. 3. 1请求报文字段传感器列表数据请求报文字段详见表B.41 o表B. 41传感器列表数据请求报文字段字段类型是否必须含义typeString是传感器代码的查询类型注valueArray是对应查询类型的值注：传感器代码的查询类型包括sensortypecode> bayname> equipmentname

46、 > 间隔单元名称、输变电设备名称和厂商名称。manufacturer,分别表示传感器类型代码、B. 4. 3. 2返回结果传感器列表数据查询结果使用JSON格式封装，详见B.42。表B.42传感器列表数据请求返回结果字段类型是否必须含义codeArray是传感器代码B. 4.4输变电设备静态属性数据获取B. 4. 4. 1请求报文字段输变电设备静态属性数据的请求报文字段详见表B.43。表B. 43输变电设备静态属性数据请求报文字段字段类型是否必须含义equipmentidArray是设备idB. 4. 4. 2返回结果输变电设备静态属性查询结果使用JSON格式封装，详见表B.44。表B

47、.44输变电设备静态属性数据请求返回结果字段类型是否必须含义stationString是变电站名称stationidString是变电站idbayString是间隔单元bayidString是间隔单元idequipmentString是设备名称equipmentidString是设备idequipmenttypeString是设备类型equipmenttypeidString是设备类型idvoltagelevelString是电压等级manufacturerString是设备厂商B. 4.5输变电设备列表数据获取B. 4. 5. 1请求报文字段输变电设备列表数据请求报文字段详见表B.45。表B

48、. 45输变电设备列表数据请求报文字段字段类型是否必须含义typeString是设备id的查询类型svalueArray是对应查询类型的值注：设备id的查询类型包括manufacturer、bayname> equipmenttypename,分别表示设备厂商名称、间隔单元名称和输变电设备类型B. 4. 5. 2返回结果输变电设备列表数据查询结果使用JSON格式封装，详见表B.46。表B.46输变电设备列表数据返回结果字段类型是否必须含义equipmentidArray是设备id附录C（资料性附录）JSON文件数据格式要求C. 1 JS0N数据内容组成方式JSON文件内容JSON文件内容

49、采用文本方式编写，信息对为“关键词（keyword） ”与“值（value） ”， 信息对内部对应方式如下：a）一个“关键词”对应一个“值”，一个完整的信息对以“广开始，以“广结束，“关键词”和“值”之间以 “:”相隔，多个信息对之间以“，”相隔；b）一个“关键词”对应多个“值”，一个完整的信息对以“广开始，以“厂结束，对应的多个“值”为一个 数组，数组以“”开始，以“”结束，多个“值”之间使用“，”分隔。C. 2报文及其结构要求C. 2.1传感器数据传感器采用的报文结构参照：a）按照Q/GDW 616中附录A在线监测逻辑节点定义以及Q/GDW 1242中附录C应用层数据传输 规约部分；b）参

50、照附录C.5-C.6提供的传感器相关报文结构。C. 2.2输变电设备静态属性数据输变电设备静态属性数据报文及其结构，参照附录C.6。C. 3 JSON数据信息对组合结构JSON内部信息对的组合，分为单层结构和多层嵌套结构两种方式，具体如下：a）单层结构，信息对中的“值”为简单的字符串或者字符数组；b）嵌套结构，分为外层信息对和内层信息对，外层信息对中的“值”为JSON格式的子对象，包含 内层的“关键词”和“值”。C. 4单层与多层嵌套结构使用要求JSON数据单层与多层嵌套结构使用范围如下：a）创建规则引擎、删除规则引擎、创建流式计算规则、删除流式计算规则、传感器历史感知数据 获取、传感器当前状

51、态数据获取、当前采集图像数据获取、传感器通用参数设置、传感器列表 数据获取、输变电设备列表数据获取的请求报文采用单层结构；b）应用间业务数据交互、应用数据上报、传感器当前感知数据获取、传感器业务参数设置、传感 器告警参数设置、传感器静态属性数据获取、传感器物模型编号获取、输变电设备静态属性数 据获取的请求报文采用多层嵌套结构；c）接口返回值均采用单层结构。C. 5接口请求报文关键词及结构要求各个接口所用请求报文关键词及结构详见表C.1至表C.18。表C. 1应用间业务数据交互请求报文JS0N字段结构第一层 Keyword第二层 Keywordsourceappnameaddressdestinationappnameaddress注：应用间业务数据交互采用的JSON格式为嵌套结构，总共分为两层，两层结构的组成方式均为方式一，source、 destination字段做为keyword位于第一层，对应的value值为JSON格式子对象，子对象中包含appname、address作 为第二