EN 61970-301:2017

SLOVENSKI STANDARD
01-junij-2017
1DGRPHãþD
SIST EN 61970-301:2014
Aplikacijski programski vmesnik za sistem upravljanja z energijo (EMS-API) - 301.
del: Osnova skupnega informacijskega modela (CIM)
Energy management system application program interface (EMS-API) - Part 301:
Common information model (CIM) base
Schnittstelle für Anwendungsprogramme für Netzführungssysteme (EMS-API) - Teil 301:
Allgemeines Informationsmodell (CIM)
Interface de programmation d'application pour système de gestion d'énergie (EMS-API) -
Partie 301: Base de modèle d'information commun (CIM)
Ta slovenski standard je istoveten z: EN 61970-301:2017
ICS:
29.240.30 Krmilna oprema za Control equipment for electric
elektroenergetske sisteme power systems
35.200 Vmesniška in povezovalna Interface and interconnection
oprema equipment
2003-01.Slovenski inštitut za standardizacijo. Razmnoževanje celote ali delov tega standarda ni dovoljeno.

EUROPEAN STANDARD EN 61970-301

NORME EUROPÉENNE
EUROPÄISCHE NORM
March 2017
ICS 33.200 Supersedes EN 61970-301:2014
English Version
Energy management system application program interface
(EMS-API) - Part 301: Common information model (CIM) base
(IEC 61970-301:2016)
Interface de programmation d'application pour système de Schnittstelle für Anwendungsprogramme für
gestion d'énergie (EMS-API) - Partie 301: Base de modèle Netzführungssysteme (EMS-API) - Teil 301: Allgemeines
d'information commun (CIM) Informationsmodell (CIM), Basismodell
(IEC 61970-301:2016) (IEC 61970-301:2016)
This European Standard was approved by CENELEC on 2017-01-20. CENELEC members are bound to comply with the CEN/CENELEC
Internal Regulations which stipulate the conditions for giving this European Standard the status of a national standard without any alteration.
Up-to-date lists and bibliographical references concerning such national standards may be obtained on application to the CEN-CENELEC
Management Centre or to any CENELEC member.
This European Standard exists in three official versions (English, French, German). A version in any other language made by translation
under the responsibility of a CENELEC member into its own language and notified to the CEN-CENELEC Management Centre has the
same status as the official versions.
CENELEC members are the national electrotechnical committees of Austria, Belgium, Bulgaria, Croatia, Cyprus, the Czech Republic,
Denmark, Estonia, Finland, Former Yugoslav Republic of Macedonia, France, Germany, Greece, Hungary, Iceland, Ireland, Italy, Latvia,
Lithuania, Luxembourg, Malta, the Netherlands, Norway, Poland, Portugal, Romania, Serbia, Slovakia, Slovenia, Spain, Sweden,
Switzerland, Turkey and the United Kingdom.

European Committee for Electrotechnical Standardization
Comité Européen de Normalisation Electrotechnique
Europäisches Komitee für Elektrotechnische Normung
CEN-CENELEC Management Centre: Avenue Marnix 17, B-1000 Brussels
© 2017 CENELEC All rights of exploitation in any form and by any means reserved worldwide for CENELEC Members.
Ref. No. EN 61970-301:2017 E
European foreword
The text of document 57/1779/FDIS, future edition 6 of IEC 61970-301, prepared by
IEC/TC 57 "Power systems management and associated information exchange" was submitted to the
IEC-CENELEC parallel vote and approved by CENELEC as EN 61970-301:2017.

The following dates are fixed:
(dop) 2017-10-20
• latest date by which the document has to be
implemented at national level by
publication of an identical national
standard or by endorsement
• latest date by which the national (dow) 2020-01-20
standards conflicting with the
document have to be withdrawn
This document supersedes EN 61970-301:2014.

Attention is drawn to the possibility that some of the elements of this document may be the subject of
patent rights. CENELEC [and/or CEN] shall not be held responsible for identifying any or all such
patent rights.
This document has been prepared under a mandate given to CENELEC by the European Commission
and the European Free Trade Association.

Endorsement notice
The text of the International Standard IEC 61970-301:2016 was approved by CENELEC as a
European Standard without any modification.
In the official version, for Bibliography, the following notes have to be added for the standards indicated:

IEC 61850-7-3 NOTE Harmonized as EN 61850-7-3.
IEC 61968-11:2013 NOTE Harmonized as EN 61968-11:2013 (not modified).
IEC 61970-501 NOTE Harmonized as EN 61970-501.
IEC 62325 Series NOTE Harmonized as EN 62325 Series.
Annex ZA
(normative)
Normative references to international publications
with their corresponding European publications

The following documents, in whole or in part, are normatively referenced in this document and are
indispensable for its application. For dated references, only the edition cited applies. For undated
references, the latest edition of the referenced document (including any amendments) applies.

NOTE 1 When an International Publication has been modified by common modifications, indicated by (mod), the relevant
EN/HD applies.
NOTE 2 Up-to-date information on the latest versions of the European Standards listed in this annex is available here:
www.cenelec.eu
Publication Year Title EN/HD Year

IEC 60050 Series International electrotechnical vocabulary - -
(IEV)
IEC 61850 Series Communication networks and systems for EN 61850 Series
power utility automation
IEC 61850-7-4 2010 Communication networks and systems EN 61850-7-4 2010
for power utility automation -
Part 7-4: Basic communication structure -
Compatible logical node classes and data
object classes
IEC 61968 Series Application integration at electric utilities - EN 61968 Series
System interfaces for distribution
management
IEC/TS 61970-2 -  Energy management system application CLC/TS 61970-2 -
program interface (EMS-API) -
Part 2: Glossary
UML 2.0 - Object -  Object Management Group: UML 2.0 - -
Management group Specification

IEC 61970-301 ®
Edition 6.0 2016-12
INTERNATIONAL
STANDARD
NORME
INTERNATIONALE
colour
inside
Energy management system application program interface (EMS-API) –

Part 301: Common information model (CIM) base

Interface de programmation d'application pour système de gestion d'énergie

(EMS-API) –
Partie 301: Base de modèle d'information commun (CIM)

INTERNATIONAL
ELECTROTECHNICAL
COMMISSION
COMMISSION
ELECTROTECHNIQUE
INTERNATIONALE
ICS 33.200 ISBN 978-2-8322-3787-8

– 2 – IEC 61970-301:2016  IEC 2016
CONTENTS
FOREWORD . 32
INTRODUCTION . 34
1 Scope . 36
2 Normative references . 36
3 Terms and definitions . 37
4 CIM specification . 37
4.1 Overview. 37
4.2 CIM modeling notation . 38
4.3 CIM packages . 38
4.4 CIM classes and relationships . 40
4.4.1 Classes . 40
4.4.2 Generalization . 41
4.4.3 Simple association . 42
4.4.4 Aggregation . 43
4.5 CIM model concepts and examples . 43
4.5.1 Concepts . 43
4.5.2 Containment, equipment hierarchies and naming . 44
4.5.3 Names model . 45
4.5.4 Connectivity model . 46
4.5.5 Inheritance hierarchy . 49
4.5.6 Transformer model . 51
4.5.7 Transformer tap modeling . 53
4.5.8 Phase wire modeling . 66
4.5.9 Grounding devices modeling . 68
4.5.10 Cuts, clamps and jumpers model . 71
4.5.11 Measurements and controls . 75
4.5.12 Regulating control models . 80
4.5.13 DC model for CIM . 81
4.5.14 Static Var Compensator voltage regulation . 100
4.6 Modeling guidelines . 102
4.6.1 Modeling for change . 102
4.6.2 Process for amendments to the CIM . 102
4.6.3 Changes to the CIM UML model . 102
4.6.4 Changes to the CIM standards documents . 103
4.6.5 Deprecations . 103
4.6.6 CIM profiles . 103
4.7 Modeling tools . 103
4.8 User implementation conventions . 104
4.8.1 Conventions beyond UML . 104
4.8.2 Number of terminals for ConductingEquipment objects . 104
4.9 CIM modeling examples . 104
5 Detailed model . 105
5.1 Overview. 105
5.2 Context . 105
6 Package Base . 107
6.1 General . 107

IEC 61970-301:2016  IEC 2016 – 3 –
6.2 Package Faults . 107
6.2.1 General . 107
6.2.2 EquipmentFault . 107
6.2.3 Fault . 108
6.2.4 FaultCauseType . 109
6.2.5 FaultImpedance compound . 109
6.2.6 LineFault . 109
6.2.7 PhaseConnectedFaultKind enumeration . 110
6.3 Package DocIEC 61970 . 111
6.4 Package Domain . 112
6.4.1 General . 112
6.4.2 ActivePower datatype . 118
6.4.3 ActivePowerChangeRate datatype . 118
6.4.4 ActivePowerPerCurrentFlow datatype . 119
6.4.5 ActivePowerPerFrequency datatype . 119
6.4.6 Admittance datatype . 119
6.4.7 AngleDegrees datatype . 120
6.4.8 AngleRadians datatype . 120
6.4.9 ApparentPower datatype. 120
6.4.10 Area datatype . 120
6.4.11 Boolean primitive . 121
6.4.12 Capacitance datatype . 121
6.4.13 CapacitancePerLength datatype . 121
6.4.14 Conductance datatype . 121
6.4.15 ConductancePerLength datatype . 121
6.4.16 CostPerEnergyUnit datatype . 122
6.4.17 CostPerVolume datatype . 122
6.4.18 CostRate datatype . 122
6.4.19 Currency enumeration . 123
6.4.20 CurrentFlow datatype . 123
6.4.21 Damping datatype . 123
6.4.22 Date primitive . 124
6.4.23 DateInterval compound . 124
6.4.24 DateTime primitive . 124
6.4.25 DateTimeInterval compound . 124
6.4.26 Decimal primitive . 124
6.4.27 DecimalQuantity compound . 124
6.4.28 Displacement datatype . 125
6.4.29 Duration primitive . 125
6.4.30 Float primitive . 125
6.4.31 FloatQuantity compound . 125
6.4.32 Frequency datatype . 125
6.4.33 Hours datatype . 126
6.4.34 Impedance datatype . 126
6.4.35 Inductance datatype . 126
6.4.36 InductancePerLength datatype . 126
6.4.37 Integer primitive . 127
6.4.38 IntegerQuantity compound . 127
6.4.39 KiloActivePower datatype . 127

– 4 – IEC 61970-301:2016  IEC 2016
6.4.40 Length datatype . 127
6.4.41 Minutes datatype . 128
6.4.42 Money datatype . 128
6.4.43 MonthDay primitive . 128
6.4.44 MonthDayInterval compound . 128
6.4.45 PU datatype . 128
6.4.46 PerCent datatype . 129
6.4.47 Pressure datatype . 129
6.4.48 Reactance datatype . 129
6.4.49 ReactancePerLength datatype . 129
6.4.50 ReactivePower datatype . 130
6.4.51 RealEnergy datatype . 130
6.4.52 Resistance datatype . 130
6.4.53 ResistancePerLength datatype . 130
6.4.54 RotationSpeed datatype . 131
6.4.55 Seconds datatype . 131
6.4.56 Speed datatype . 131
6.4.57 String primitive . 132
6.4.58 StringQuantity compound. 132
6.4.59 Susceptance datatype . 132
6.4.60 SusceptancePerLength datatype . 132
6.4.61 Temperature datatype. 133
6.4.62 Time primitive . 133
6.4.63 TimeInterval compound . 133
6.4.64 UnitMultiplier enumeration . 133
6.4.65 UnitSymbol enumeration . 134
6.4.66 Voltage datatype. 135
6.4.67 VoltagePerReactivePower datatype . 135
6.4.68 Volume datatype . 135
6.4.69 VolumeFlowRate datatype . 136
6.4.70 WaterLevel datatype . 136
6.4.71 Weight datatype . 136
6.5 Package Core . 136
6.5.1 General . 136
6.5.2 ACDCTerminal . 140
6.5.3 BaseFrequency. 141
6.5.4 BasePower . 141
6.5.5 BaseVoltage . 142
6.5.6 BasicIntervalSchedule . 143
6.5.7 Bay . 143
6.5.8 BreakerConfiguration enumeration. 144
6.5.9 BusbarConfiguration enumeration . 144
6.5.10 ConductingEquipment . 144
6.5.11 ConnectivityNode . 145
6.5.12 ConnectivityNodeContainer . 146
6.5.13 Curve . 147
6.5.14 CurveData root class . 147
6.5.15 CurveStyle enumeration . 148
6.5.16 Equipment . 148

IEC 61970-301:2016  IEC 2016 – 5 –
6.5.17 EquipmentContainer . 149
6.5.18 GeographicalRegion . 150
6.5.19 IdentifiedObject root class . 150
6.5.20 IrregularIntervalSchedule . 151
6.5.21 IrregularTimePoint root class . 152
6.5.22 Name root class . 152
6.5.23 NameType root class . 153
6.5.24 NameTypeAuthority root class . 153
6.5.25 OperatingParticipant . 154
6.5.26 OperatingShare root class . 154
6.5.27 PSRType . 155
6.5.28 PhaseCode enumeration . 155
6.5.29 PowerSystemResource . 156
6.5.30 RegularIntervalSchedule . 157
6.5.31 RegularTimePoint root class . 158
6.5.32 ReportingSuperGroup . 158
6.5.33 SubGeographicalRegion . 159
6.5.34 Substation . 159
6.5.35 Terminal . 160
6.5.36 VoltageLevel . 161
6.6 Package DiagramLayout . 162
6.6.1 General . 162
6.6.2 DiagramStyle . 163
6.6.3 Diagram . 164
6.6.4 DiagramObject . 164
6.6.5 DiagramObjectGluePoint root class . 166
6.6.6 DiagramObjectPoint root class . 166
6.6.7 DiagramObjectStyle . 166
6.6.8 OrientationKind enumeration . 167
6.6.9 TextDiagramObject . 167
6.6.10 VisibilityLayer . 168
6.7 Package OperationalLimits . 169
6.7.1 General . 169
6.7.2 ActivePowerLimit . 170
6.7.3 ApparentPowerLimit . 171
6.7.4 BranchGroup . 171
6.7.5 BranchGroupTerminal root class . 172
6.7.6 CurrentLimit . 172
6.7.7 OperationalLimit . 173
6.7.8 OperationalLimitDirectionKind enumeration . 174
6.7.9 OperationalLimitSet . 174
6.7.10 OperationalLimitType . 175
6.7.11 VoltageLimit . 175
6.8 Package Topology . 176
6.8.1 General . 176
6.8.2 BusNameMarker . 178
6.8.3 DCTopologicalNode . 179
6.8.4 TopologicalIsland. 179
6.8.5 TopologicalNode . 180

– 6 – IEC 61970-301:2016  IEC 2016
6.9 Package Wires . 181
6.9.1 General . 181
6.9.2 PerLengthSequenceImpedance . 197
6.9.3 PerLengthPhaseImpedance . 198
6.9.4 ShuntCompensatorPhase . 199
6.9.5 RatioTapChanger . 200
6.9.6 BusbarSection . 201
6.9.7 SinglePhaseKind enumeration . 202
6.9.8 TransformerTank . 202
6.9.9 Disconnector . 203
6.9.10 Jumper . 204
6.9.11 TapSchedule . 205
6.9.12 TransformerCoreAdmittance . 205
6.9.13 SVCControlMode enumeration . 206
6.9.14 EnergyConsumerPhase . 206
6.9.15 SynchronousMachineOperatingMode enumeration . 207
6.9.16 TapChangerControl . 208
6.9.17 PhaseTapChangerTable . 209
6.9.18 TransformerStarImpedance . 209
6.9.19 Breaker. 210
6.9.20 GroundDisconnector . 211
6.9.21 SwitchSchedule . 212
6.9.22 PowerTransformer . 213
6.9.23 PhaseTapChangerAsymmetrical . 216
6.9.24 Ground . 217
6.9.25 Line . 218
6.9.26 PhaseTapChangerSymmetrical . 218
6.9.27 RegulationSchedule . 219
6.9.28 Fuse . 220
6.9.29 TransformerMeshImpedance . 221
6.9.30 SwitchPhase . 222
6.9.31 PowerTransformerEnd . 223
6.9.32 PetersenCoil . 225
6.9.33 RegulatingCondEq . 226
6.9.34 PhaseTapChangerNonLinear . 227
6.9.35 SeriesCompensator . 228
6.9.36 PhaseShuntConnectionKind enumeration . 229
6.9.37 GroundingImpedance . 229
6.9.38 TransformerControlMode enumeration . 230
6.9.39 RatioTapChangerTablePoint . 230
6.9.40 ACLineSegment . 231
6.9.41 Recloser . 232
6.9.42 CompositeSwitch . 234
6.9.43 TransformerEnd . 234
6.9.44 Sectionaliser . 236
6.9.45 VoltageControlZone . 237
6.9.46 EnergySource . 237
6.9.47 SynchronousMachine. 239
6.9.48 RegulatingControlModeKind enumeration . 241

IEC 61970-301:2016  IEC 2016 – 7 –
6.9.49 Clamp . 242
6.9.50 TransformerTankEnd . 243
6.9.51 PhaseTapChanger . 244
6.9.52 ACLineSegmentPhase . 244
6.9.53 RatioTapChangerTable . 245
6.9.54 RotatingMachine . 246
6.9.55 RegulatingControl . 247
6.9.56 PhaseImpedanceData root class . 248
6.9.57 ShuntCompensator . 249
6.9.58 EarthFaultCompensator . 250
6.9.59 MutualCoupling . 251
6.9.60 Cut . 252
6.9.61 ReactiveCapabilityCurve . 253
6.9.62 Switch . 254
6.9.63 StaticVarCompensator . 256
6.9.64 CoolantType enumeration . 257
6.9.65 ProtectedSwitch . 257
6.9.66 EnergyConsumer . 258
6.9.67 Junction . 260
6.9.68 PhaseTapChangerLinear . 261
6.9.69 Conductor . 262
6.9.70 PerLengthImpedance . 263
6.9.71 FrequencyConverter . 263
6.9.72 Plant . 264
6.9.73 PhaseTapChangerTablePoint . 265
6.9.74 LoadBreakSwitch . 266
6.9.75 PetersenCoilModeKind enumeration . 267
6.9.76 SynchronousMachineKind enumeration . 267
6.9.77 Connector . 267
6.9.78 AsynchronousMachine . 268
6.9.79 TapChanger. 270
6.9.80 ShortCircuitRotorKind enumeration . 271
6.9.81 WindingConnection enumeration . 272
6.9.82 ExternalNetworkInjection . 272
6.9.83 AsynchronousMachineKind enumeration . 274
6.9.84 LinearShuntCompensator . 274
6.9.85 NonlinearShuntCompensator . 276
6.9.86 NonlinearShuntCompensatorPoint root class . 277
6.9.87 LinearShuntCompensatorPhase . 277
6.9.88 NonlinearShuntCompensatorPhase . 278
6.9.89 NonlinearShuntCompensatorPhasePoint root class . 279
6.9.90 PerLengthLineParameter . 279
6.9.91 TapChangerTablePoint root class . 280
6.9.92 PhaseTapChangerTabular . 281
6.9.93 PowerElectronicsConnection . 282
6.10 Package Generation . 283
6.10.1 General . 283
6.10.2 Package GenerationTrainingSimulation . 284
6.10.3 Package Production . 299

– 8 – IEC 61970-301:2016  IEC 2016
6.11 Package DC . 346
6.11.1 General . 346
6.11.2 ACDCConverter . 351
6.11.3 ACDCConverterDCTerminal . 353
6.11.4 DCBaseTerminal . 354
6.11.5 DCConverterUnit . 355
6.11.6 DCLine . 356
6.11.7 DCSeriesDevice . 356
6.11.8 VsQpccControlKind enumeration . 357
6.11.9 CsPpccControlKind enumeration . 357
6.11.10 CsOperatingModeKind enumeration. 358
6.11.11 CsConverter . 358
6.11.12 DCBreaker . 360
6.11.13 DCEquipmentContainer . 360
6.11.14 DCBusbar . 361
6.11.15 DCConverterOperatingModeKind enumeration . 362
6.11.16 DCChopper . 362
6.11.17 DCDisconnector. 363
6.11.18 DCGround . 364
6.11.19 DCLineSegment . 364
6.11.20 DCShunt . 365
6.11.21 DCConductingEquipment . 366
6.11.22 DCSwitch .
...