第三章：IEEE2030.5文档

系列文章目录

第一章：2030.5、CSIP、Rule21简介 and 本项目内容介绍
第二章：IEEE2030.5官网相关资料介绍
第三章：IEEE2030.5文档
第四章：Common Smart Inverter Profile
第五章：SunSpecCSIPConformanceTestProceduresV1.2

编者注：本系列文章为编者开发过程的经验，如有错误欢迎提醒指正，谢谢。不构成权威指导。

前言

在上一个章节，编者简单介绍了IEEE 2030.5到底是什么，是怎么样的一套协议标准，来历是什么样的，也给出了IEEE官网网站资料下载网址。并且介绍了下载资料有哪些类容。本章节就详细讲解一下IEEE 2030.5 Model.docx文档的内容，告诉读者IEEE2030.5协议到底有哪些内容，这些字段都有什么作用。后续开发过程中需要重点关注哪些内容。感兴趣的读者可以阅读原版文件对比编者的理解提出不同见解，共同进步。

一、IEEE 2030.5 Model

如下图所示是该文档的目录。一级标题是IEEE 2030.5 Package。所描述的就是IEEE 2030.5 模型，该模型被组织成功能集，由子包表示。 但是，所有结构都在单个命名空间内定义。这里描述的就是限定条件，版本。

DeviceCapability Package

往下看就是具体子包的内容，DeviceCapability Package这个我们在通信时获取的的第一个包。

以DeviceCapability Package为例，看一下这个子包里都有什么字段，结合一下协议来看，这些字段内容是怎么下发到我们客户端的，要如何去解析。

<?xml version="1.0"?>
<DeviceCapability href="/dcap" xmlns="urn:ieee:std:2030.5:ns">
	<DemandResponseProgramListLink all="1" href="/drp"/>
	<MessagingProgramListLink all="2" href="/msg"/>
	<EndDeviceListLink all="1" href="/edev"/>
	<SelfDeviceLink href="/sdev"/>
</DeviceCapability>

pollRate:Uint32[0…1]=900：DeviceCapability资源的轮询周期是900s，数据类型是uint32。
这个包里面包含的资源有EndDeviceLink，对应字段内容是all=“1” href=“/edev”/。数量1，地址/edev。
其他的MessagingProgramListLink 和SelfDeviceLink 我们不需要关系，在CSIP开发中时用不上的，CSIP只需要IEEE2030.5协议的部分功能，超过CSIP的暂且不分析。

Common Package

此包包含在多个函数集中使用的对象 。如下图所示的Identification Package，包含定义对象类别共有的属性的超类。

在这个图中对比上门XML文件给出的资源进行分析：

<DemandResponseProgramListLink all="1" href="/drp"/>

all attribute 指定列表中“所有”项目的数字。 对 GET 的响应是必需的，否则被忽略。
href URI 引用。

responseRequired attribute (HexBinary8)  [0..1] «XSDattribute»

指示在接收、创建或更新此资源时是否需要响应。 响应应发布到“replyTo”中指定的集合。
比如：终端设备在接受调度时需要向服务器进行响应，并且将控制的状态切换响应给服务器：
0 - 终端设备应指示已收到消息
1 - 终端设备应指示特定响应。
2 - 需要最终用户/客户响应。
保留所有其他值。

数据格式

例如：
HexBinary8 编码为十六进制字符串（2 个十六进制字符）的 8 位字段。 在适用的情况下，位 0 或最低有效位位于右侧。 请注意，hexBinary 需要成对的十六进制字符，因此奇数个字符需要前导“0”。
String6最大长度的字符串 6. 为了限制内部存储，实现应使用多字节字符减少字符串的长度，以便可以在给定的编码中使用“maxLength”八位字节来存储字符串。

总结：这个公共包的字段是后面协议包一些字段的公共说明。无论是all属性，还是href，responseRequired 都会出现在不同的协议子包中，所以这个包带有解释说明的意味。诸如此类还有服务类型定义、单位定义、电力参数类型、坐标轴定义、坐标数据幂指数(小数)定义、数据格式的定义等等。

EndDevice Package

pollRate:Uint32[0…1]=900，轮询周期也是900s，即15分钟。
EndDeviceList包含1个或者多个EndDevice实例。每个实例包含对应的描述和功能资源列表。
deviceCategory：如果资源具有 deviceCategory设备类别字段，则与deviceCategory中指示的一种或多种设备类型相匹配的设备应根据下面列出的规则进行响应。 如果类别不匹配，则设备不应响应。 如果资源没有deviceCategory 字段，接收资源的设备应根据下面列出的规则进行响应。
lFDI: Long form of device identifier. 设备标识符的长格式。
sFDI: Short form of device identifier. 设备标识符的缩写形式，带有校验和数字。
功能资源列表：<FunctionSetAssignmentsListLink all="3" href="/edev/3/fsal"/>
Registration Object (Resource)
注册代表访问主机上资源的授权，用于匹配设备是否注册。

FunctionSetAssignments Package

FunctionSetAssignments：为特定设备提供可识别、可订阅的资源集合以供使用。
mRID：对象的全局标识符。
pollRate=900s

Response Package

响应子包，是客户的对服务器响应的协议包，A response to a DERControl。主要需要上传响应的类型和响应值。

Time Package

包含时间的表示，不断更新。时间子包是用来与服务对时的，服务器下发的控制曲线都说与时间相关的，在指定时间执行相应的控制。

LogEvents Package

设备检测到的重要事件的时间戳实例。 用于上传事件日志，也就是告警日志，产生告警和恢复告警进行上传。包含时间、告警代码、功能代码、企业私有ID、协议ID等内容。

Metering Package

创建测量数据对象，并实时上传测量数据。这段描述了哪些值需要上传、上传的类型、单位、小数位。是上传平均值还是瞬时值。

DER Package

1、DERList包含与允许分布式能源向电网提供能量相关的定义。
DERSettings：分布式能源资源设置；
DERAvailability ：指示当前备用发电状态；
DERCapability ：分布式能源类型和铭牌额定值；
DERStatus：设备告警状态、连接状态等状态值。

2、控制对象子包，轮询服务器的控制对象，包括默认控制和计划控制。
DERControlBase：分布式能源 (DER) 控制值。
DERControl：分布式能源资源 (DER) 基于时间/事件的控制。
DERCurve：DER 相关曲线，例如 Volt-Var 模式曲线。 自变量（X 轴）和因变量（Y 轴）之间的关系。
CurveData：用于定义曲线或时间表的数据点值。

具体可在文档中看到，因为后面会在程序设计中具体讲控制，篇幅会比较大，所以这里不对其进行展开说明。

其他子包

其他的IEEE2030.5协议的子包诸如：订阅和发布Pub-Sub Package、网络状态NetworkStatus Package、配置Configuration Package、电费Pricing Package、账单Billing Package等其他在前面未涉及的IEEE2030.5协议子包都与CSIP不相关，在CSIP认证过程中不需要深入了解。

总结

本章提到的IEEE2030.5协议是一套完整的电力系统的协议，不仅仅涉及到智能逆变器、储能设备互联互通协议内容。还有电费下发、账单上传等与逆变器相关性不大的内容，这些在CSIP认证、互联互通中不需要过于关注。《IEEE 2030.5 Model》文档里面就是对IEEE2030.5协议的所有内容字段进行解释说明，本章也针对性的对智能逆变器相关的内容提取出来简单说明一下，具体完整的相关内容可以查阅该文档。本章主要是提取几个示例来告诉读者怎么去查看《IEEE 2030.5 Model》文档，怎么去定位到智能逆变器相关的内容。