SIST EN IEC 61970-301:2020/A1:2022
(Amendment)Energy management system application program interface (EMS-API) - Part 301: Common information model (CIM) base
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), Basismodell
Interface de programmation d'application pour système de gestion d'énergie (EMS-API) - Partie 301: Base de modèle d'information commun (CIM)
Aplikacijski programski vmesnik za sistem upravljanja z energijo (EMS-API) - 301. del: Osnova skupnega informacijskega modela (CIM) - Dopolnilo A1
General Information
Relations
Standards Content (Sample)
SLOVENSKI STANDARD
SIST EN IEC 61970-301:2020/A1:2022
01-julij-2022
Aplikacijski programski vmesnik za sistem upravljanja z energijo (EMS-API) - 301.
del: Osnova skupnega informacijskega modela (CIM) - Dopolnilo A1
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), Basismodell
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 IEC 61970-301:2020/A1:2022
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
SIST EN IEC 61970-301:2020/A1:2022 en
2003-01.Slovenski inštitut za standardizacijo. Razmnoževanje celote ali delov tega standarda ni dovoljeno.
---------------------- Page: 1 ----------------------
SIST EN IEC 61970-301:2020/A1:2022
---------------------- Page: 2 ----------------------
SIST EN IEC 61970-301:2020/A1:2022
EUROPEAN STANDARD EN IEC 61970-301:2020/A1
NORME EUROPÉENNE
EUROPÄISCHE NORM April 2022
ICS 33.200
English Version
Energy management system application program interface
(EMS-API) - Part 301: Common information model (CIM) base
(IEC 61970-301:2020/AMD1:2022)
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:2020/AMD1:2022) (IEC 61970-301:2020/AMD1:2022)
This amendment A1 modifies the European Standard EN IEC 61970-301:2020; it was approved by CENELEC on 2022-03-29. CENELEC
members are bound to comply with the CEN/CENELEC Internal Regulations which stipulate the conditions for giving this amendment 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 amendment 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, France, Germany, Greece, Hungary, Iceland, Ireland, Italy, Latvia, Lithuania, Luxembourg, Malta, the
Netherlands, Norway, Poland, Portugal, Republic of North Macedonia, 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: Rue de la Science 23, B-1040 Brussels
© 2022 CENELEC All rights of exploitation in any form and by any means reserved worldwide for CENELEC Members.
Ref. No. EN IEC 61970-301:2020/A1:2022 E
---------------------- Page: 3 ----------------------
SIST EN IEC 61970-301:2020/A1:2022
EN IEC 61970-301:2020/A1:2022 (E)
European foreword
The text of document 57/2439/FDIS, future IEC 61970-301/AMD1, 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 IEC 61970-301:2020/A1:2022.
The following dates are fixed:
• latest date by which the document has to be implemented at national (dop) 2022-12-29
level by publication of an identical national standard or by endorsement
• latest date by which the national standards conflicting with the (dow) 2025-03-29
document have to be withdrawn
Attention is drawn to the possibility that some of the elements of this document may be the subject of
patent rights. CENELEC shall not be held responsible for identifying any or all such patent rights.
This document has been prepared under a Standardization Request given to CENELEC by the
European Commission and the European Free Trade Association.
Any feedback and questions on this document should be directed to the users’ national committee. A
complete listing of these bodies can be found on the CENELEC website.
Endorsement notice
The text of the International Standard IEC 61970-301:2020/AMD1:2022 was approved by CENELEC
as a European Standard without any modification.
2
---------------------- Page: 4 ----------------------
SIST EN IEC 61970-301:2020/A1:2022
IEC 61970-301
®
Edition 7.0 2022-02
INTERNATIONAL
STANDARD
NORME
INTERNATIONALE
colour
inside
A MENDMENT 1
AM ENDEMENT 1
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-1064-9
Warning! Make sure that you obtained this publication from an authorized distributor.
Attention! Veuillez vous assurer que vous avez obtenu cette publication via un distributeur agréé.
® Registered trademark of the International Electrotechnical Commission
Marque déposée de la Commission Electrotechnique Internationale
---------------------- Page: 5 ----------------------
SIST EN IEC 61970-301:2020/A1:2022
– 2 – IEC 61970-301:2020/AMD1:2022
© IEC 2022
INTERNATIONAL ELECTROTECHNICAL COMMISSION
____________
ENERGY MANAGEMENT SYSTEM APPLICATION
PROGRAM INTERFACE (EMS-API) –
Part 301: Common information model (CIM) base
AMENDMENT 1
FOREWORD
1) The International Electrotechnical Commission (IEC) is a worldwide organization for standardization comprising
all national electrotechnical committees (IEC National Committees). The object of IEC is to promote international
co-operation on all questions concerning standardization in the electrical and electronic fields. To this end and
in addition to other activities, IEC publishes International Standards, Technical Specifications, Technical Reports,
Publicly Available Specifications (PAS) and Guides (hereafter referred to as “IEC Publication(s)”). Their
preparation is entrusted to technical committees; any IEC National Committee interested in the subject dealt with
may participate in this preparatory work. International, governmental and non-governmental organizations liaising
with the IEC also participate in this preparation. IEC collaborates closely with the International Organization for
Standardization (ISO) in accordance with conditions determined by agreement between the two organizations.
2) The formal decisions or agreements of IEC on technical matters express, as nearly as possible, an international
consensus of opinion on the relevant subjects since each technical committee has representation from all
interested IEC National Committees.
3) IEC Publications have the form of recommendations for international use and are accepted by IEC National
Committees in that sense. While all reasonable efforts are made to ensure that the technical content of IEC
Publications is accurate, IEC cannot be held responsible for the way in which they are used or for any
misinterpretation by any end user.
4) In order to promote international uniformity, IEC National Committees undertake to apply IEC Publications
transparently to the maximum extent possible in their national and regional publications. Any divergence between
any IEC Publication and the corresponding national or regional publ
...
SLOVENSKI STANDARD
SIST EN IEC 61970-301:2020/oprA1:2021
01-julij-2021
Aplikacijski programski vmesnik za sistem upravljanja z energijo (EMS-API) - 301.
del: Osnova skupnega informacijskega modela (CIM) - Dopolnilo A1
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), Basismodell
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 IEC 61970-301:2020/prA1:2021
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
SIST EN IEC 61970- en
301:2020/oprA1:2021
2003-01.Slovenski inštitut za standardizacijo. Razmnoževanje celote ali delov tega standarda ni dovoljeno.
---------------------- Page: 1 ----------------------
SIST EN IEC 61970-301:2020/oprA1:2021
---------------------- Page: 2 ----------------------
SIST EN IEC 61970-301:2020/oprA1:2021
57/2368/CDV
COMMITTEE DRAFT FOR VOTE (CDV)
PROJECT NUMBER:
IEC 61970-301/AMD1 ED7
DATE OF CIRCULATION: CLOSING DATE FOR VOTING:
2021-04-30 2021-07-23
SUPERSEDES DOCUMENTS:
57/2363/RR
IEC TC 57 : POWER SYSTEMS MANAGEMENT AND ASSOCIATED INFORMATION EXCHANGE
SECRETARIAT: SECRETARY:
Germany Mr Heiko Englert
OF INTEREST TO THE FOLLOWING COMMITTEES: PROPOSED HORIZONTAL STANDARD:
Other TC/SCs are requested to indicate their interest, if any, in
this CDV to the secretary.
FUNCTIONS CONCERNED:
EMC ENVIRONMENT QUALITY ASSURANCE SAFETY
SUBMITTED FOR CENELEC PARALLEL VOTING NOT SUBMITTED FOR CENELEC PARALLEL VOTING
Attention IEC-CENELEC parallel voting
The attention of IEC National Committees, members of
CENELEC, is drawn to the fact that this Committee Draft for Vote
(CDV) is submitted for parallel voting.
The CENELEC members are invited to vote through the
CENELEC online voting system.
This document is still under study and subject to change. It should not be used for reference purposes.
Recipients of this document are invited to submit, with their comments, notification of any relevant patent rights of which they are
aware and to provide supporting documentation.
TITLE:
Amendment 1 - Energy management system application program interface (EMS-API) – Part 301: Common
information model (CIM) base
PROPOSED STABILITY DATE: 2024
NOTE FROM TC/SC OFFICERS:
Copyright © 2021 International Electrotechnical Commission, IEC. All rights reserved. It is permitted to download this
electronic file, to make a copy and to print out the content for the sole purpose of preparing National Committee positions.
You may not copy or "mirror" the file or printed version of the document, or any part of it, for any other purpose without
permission in writing from IEC.
---------------------- Page: 3 ----------------------
SIST EN IEC 61970-301:2020/oprA1:2021
– 2 – IEC CDV 61970-301:2020/
AMD1 IEC 2021
CONTENTS
FOREWORD . 35
INTRODUCTION . 37
1 Scope . 40
2 Normative references . 40
3 Terms and definitions . 41
3.1 energy management system . 41
3.2 application program interface . 41
3.3 unified modelling language . 41
3.4 profile . 41
4 CIM specification . 41
4.1 Overview. 41
4.2 CIM modelling notation . 41
4.3 CIM packages . 42
4.4 CIM classes and relationships . 44
4.4.1 Classes . 44
4.4.2 Generalization . 45
4.4.3 Simple association . 46
4.4.4 Aggregation . 47
4.5 CIM model concepts and examples . 47
4.5.1 Concepts . 47
4.5.2 Containment, equipment hierarchies and naming . 47
4.5.3 Names model . 49
4.5.4 Connectivity model . 50
4.5.5 Inheritance hierarchy . 53
4.5.6 Transformer model . 55
4.5.7 Transformer tap modelling . 57
4.5.8 Phase wire modelling . 69
4.5.9 Grounding devices modelling . 71
4.5.10 Cuts, clamps and jumpers model . 75
4.5.11 Measurements and controls . 79
4.5.12 Regulating control models . 83
4.5.13 DC model for CIM . 84
4.5.14 Static Var Compensator Voltage Regulation . 104
4.5.15 ICCP Configuration Model . 106
4.5.16 Feeder Model . 112
4.5.17 Control area modelling . 112
4.6 Modelling guidelines . 114
4.6.1 Modelling for change . 114
4.6.2 Process for amendments to the CIM . 114
4.6.3 Changes to the CIM UML model . 115
4.6.4 Changes to the CIM standards documents . 115
4.6.5 Deprecations . 115
4.6.6 CIM profiles . 115
4.7 Modelling tools . 116
4.8 User implementation conventions . 116
4.8.1 Conventions beyond UML . 116
---------------------- Page: 4 ----------------------
SIST EN IEC 61970-301:2020/oprA1:2021
IEC CDV 61970-301:2020/ – 3 –
AMD1 IEC 2021
4.8.2 Number of terminals for ConductingEquipment objects . 116
4.8.3 Nominal quantities . 116
4.8.4 Datatypes . 117
4.9 CIM modelling examples . 117
5 Detailed model . 117
5.1 Overview. 117
5.2 Context . 117
6 Package Base . 119
6.1 General . 119
6.2 Package Domain . 119
6.2.1 General . 119
6.2.2 ActivePower datatype . 125
6.2.3 ActivePowerChangeRate datatype . 125
6.2.4 ActivePowerPerCurrentFlow datatype . 126
6.2.5 ActivePowerPerFrequency datatype . 126
6.2.6 Admittance datatype . 126
6.2.7 AngleDegrees datatype . 126
6.2.8 AngleRadians datatype . 127
6.2.9 ApparentPower datatype. 127
6.2.10 Area datatype . 127
6.2.11 Boolean primitive . 127
6.2.12 Capacitance datatype . 127
6.2.13 CapacitancePerLength datatype . 128
6.2.14 Classification datatype . 128
6.2.15 Conductance datatype . 128
6.2.16 ConductancePerLength datatype . 128
6.2.17 CostPerEnergyUnit datatype . 129
6.2.18 CostPerHeatUnit datatype . 129
6.2.19 CostPerVolume datatype . 129
6.2.20 CostRate datatype . 129
6.2.21 Currency enumeration . 130
6.2.22 CurrentFlow datatype . 134
6.2.23 Damping datatype . 134
6.2.24 Date primitive . 134
6.2.25 DateInterval compound . 134
6.2.26 DateTime primitive . 134
6.2.27 DateTimeInterval compound . 134
6.2.28 Decimal primitive . 135
6.2.29 DecimalQuantity compound . 135
6.2.30 Displacement datatype . 135
6.2.31 Duration primitive . 135
6.2.32 Emission datatype . 135
6.2.33 Float primitive . 136
6.2.34 FloatQuantity compound . 136
6.2.35 Frequency datatype . 136
6.2.36 HeatRate datatype . 136
6.2.37 Hours datatype . 136
6.2.38 Impedance datatype . 137
6.2.39 Inductance datatype . 137
---------------------- Page: 5 ----------------------
SIST EN IEC 61970-301:2020/oprA1:2021
– 4 – IEC CDV 61970-301:2020/
AMD1 IEC 2021
6.2.40 InductancePerLength datatype . 137
6.2.41 Integer primitive . 137
6.2.42 IntegerQuantity compound . 137
6.2.43 KiloActivePower datatype . 138
6.2.44 Length datatype . 138
6.2.45 Mass datatype . 138
6.2.46 Minutes datatype . 138
6.2.47 Money datatype . 139
6.2.48 MonthDay primitive . 139
6.2.49 MonthDayInterval compound . 139
6.2.50 PU datatype . 139
6.2.51 PerCent datatype . 139
6.2.52 Pressure datatype . 140
6.2.53 Reactance datatype . 140
6.2.54 ReactancePerLength datatype . 140
6.2.55 ReactivePower datatype . 140
6.2.56 RealEnergy datatype . 141
6.2.57 Resistance datatype . 141
6.2.58 ResistancePerLength datatype . 141
6.2.59 RotationSpeed datatype . 141
6.2.60 Seconds datatype . 142
6.2.61 Speed datatype . 142
6.2.62 String primitive . 142
6.2.63 StringQuantity compound. 142
6.2.64 Susceptance datatype . 142
6.2.65 SusceptancePerLength datatype . 143
6.2.66 Temperature datatype. 143
6.2.67 Time primitive . 143
6.2.68 TimeInterval compound . 143
6.2.69 UnitMultiplier enumeration . 144
6.2.70 UnitSymbol enumeration . 144
6.2.71 Voltage datatype. 150
6.2.72 VoltagePerReactivePower datatype . 150
6.2.73 Volume datatype . 150
6.2.74 VolumeFlowRate datatype . 150
6.2.75 WaterLevel datatype . 151
6.3 Package Core . 151
6.3.1 General . 151
6.3.2 ACDCTerminal . 156
6.3.3 BaseFrequency. 157
6.3.4 BasePower . 157
6.3.5 BaseVoltage . 158
6.3.6 BasicIntervalSchedule . 159
6.3.7 Bay . 159
6.3.8 BreakerConfiguration enumeration. 160
6.3.9 BusbarConfiguration enumeration . 160
6.3.10 ConductingEquipment . 161
6.3.11 ConnectivityNode . 162
6.3.12 ConnectivityNodeContainer . 162
---------------------- Page: 6 ----------------------
SIST EN IEC 61970-301:2020/oprA1:2021
IEC CDV 61970-301:2020/ – 5 –
AMD1 IEC 2021
6.3.13 Curve . 163
6.3.14 CurveData root class . 164
6.3.15 CurveStyle enumeration . 164
6.3.16 Equipment . 164
6.3.17 EquipmentContainer . 166
6.3.18 Feeder . 166
6.3.19 GeographicalRegion . 167
6.3.20 IdentifiedObject root class . 168
6.3.21 IrregularIntervalSchedule . 169
6.3.22 IrregularTimePoint root class . 169
6.3.23 Name root class . 170
6.3.24 NameType root class . 170
6.3.25 NameTypeAuthority root class . 171
6.3.26 OperatingParticipant . 171
6.3.27 OperatingShare root class . 172
6.3.28 PSRType . 172
6.3.29 PhaseCode enumeration . 173
6.3.30 PowerSystemResource . 174
6.3.31 RegularIntervalSchedule . 174
6.3.32 RegularTimePoint root class . 175
6.3.33 ReportingGroup . 176
6.3.34 ReportingSuperGroup . 176
6.3.35 SubGeographicalRegion . 177
6.3.36 Substation . 177
6.3.37 Terminal . 178
6.3.38 VoltageLevel . 180
6.4 Package Wires . 181
6.4.1 General . 181
6.4.2 AsynchronousMachineKind enumeration . 195
6.4.3 ACLineSegment . 196
6.4.4 ACLineSegmentPhase . 197
6.4.5 AsynchronousMachine . 198
6.4.6 Breaker. 200
6.4.7 BusbarSection . 201
6.4.8 Clamp . 202
6.4.9 CompositeSwitch . 203
6.4.10 Conductor . 204
6.4.11 Connector . 205
6.4.12 CoolantType enumeration . 206
6.4.13 Cut . 206
6.4.14 Disconnector . 208
6.4.15 DisconnectingCircuitBreaker . 209
6.4.16 EarthFaultCompensator . 210
6.4.17 EnergyConnection . 211
6.4.18 EnergyConsumer . 212
6.4.19 EnergyConsumerPhase . 214
6.4.20 EnergySchedulingType . 215
6.4.21 EnergySource . 215
6.4.22 EnergySourcePhase . 217
---------------------- Page: 7 ----------------------
SIST EN IEC 61970-301:2020/oprA1:2021
– 6 – IEC CDV 61970-301:2020/
AMD1 IEC 2021
6.4.23 ExternalNetworkInjection . 218
6.4.24 FrequencyConverter . 220
6.4.25 Fuse . 221
6.4.26 Ground . 222
6.4.27 GroundingImpedance . 223
6.4.28 GroundDisconnector . 224
6.4.29 Jumper . 225
6.4.30 Junction . 226
6.4.31 Line . 227
6.4.32 LinearShuntCompensator . 228
6.4.33 LinearShuntCompensatorPhase . 229
6.4.34 LoadBreakSwitch . 230
6.4.35 MutualCoupling . 231
6.4.36 NonlinearShuntCompensator . 232
6.4.37 NonlinearShuntCompensatorPhase . 233
6.4.38 NonlinearShuntCompensatorPhasePoint root class . 234
6.4.39 NonlinearShuntCompensatorPoint root class . 235
6.4.40 PerLengthImpedance . 235
6.4.41 PerLengthLineParameter . 236
6.4.42 PerLengthPhaseImpedance . 236
6.4.43 PerLengthSequenceImpedance . 237
6.4.44 PetersenCoil . 238
6.4.45 PetersenCoilModeKind enumeration . 239
6.4.46 PhaseImpedanceData root class . 239
6.4.47 PhaseShuntConnectionKind enumeration . 240
6.4.48 PhaseTapChanger . 240
6.4.49 PhaseTapChangerAsymmetrical . 241
6.4.50 PhaseTapChangerLinear . 243
6.4.51 PhaseTapChangerNonLinear . 244
6.4.52 PhaseTapChangerSymmetrical . 245
6.4.53 PhaseTapChangerTable . 246
6.4.54 PhaseTapChangerTablePoint .
...
Questions, Comments and Discussion
Ask us and Technical Secretary will try to provide an answer. You can facilitate discussion about the standard in here.