IEC 61970-302:2024

IEC 61970-302 ®
Edition 2.0 2024-01
INTERNATIONAL
STANDARD
NORME
INTERNATIONALE
colour
inside
Energy management system application program interface (EMS-API) –
Part 302: Common information model (CIM) dynamics

Interface de programmation d'application pour système de gestion d'énergie
(EMS-API) –
Partie 302: Régimes dynamiques de modèle d'information commun (CIM)
All rights reserved. Unless otherwise specified, no part of this publication may be reproduced or utilized in any form
or by any means, electronic or mechanical, including photocopying and microfilm, without permission in writing from
either IEC or IEC's member National Committee in the country of the requester. If you have any questions about IEC
copyright or have an enquiry about obtaining additional rights to this publication, please contact the address below or
your local IEC member National Committee for further information.

Droits de reproduction réservés. Sauf indication contraire, aucune partie de cette publication ne peut être reproduite ni
utilisée sous quelque forme que ce soit et par aucun procédé, électronique ou mécanique, y compris la photocopie et
les microfilms, sans l'accord écrit de l'IEC ou du Comité national de l'IEC du pays du demandeur. Si vous avez des
questions sur le copyright de l'IEC ou si vous désirez obtenir des droits supplémentaires sur cette publication, utilisez
les coordonnées ci-après ou contactez le Comité national de l'IEC de votre pays de résidence.

IEC Secretariat Tel.: +41 22 919 02 11
3, rue de Varembé info@iec.ch
CH-1211 Geneva 20 www.iec.ch
Switzerland
About the IEC
The International Electrotechnical Commission (IEC) is the leading global organization that prepares and publishes
International Standards for all electrical, electronic and related technologies.

About IEC publications
The technical content of IEC publications is kept under constant review by the IEC. Please make sure that you have the
latest edition, a corrigendum or an amendment might have been published.

IEC publications search - webstore.iec.ch/advsearchform IEC Products & Services Portal - products.iec.ch
The advanced search enables to find IEC publications by a Discover our powerful search engine and read freely all the
variety of criteria (reference number, text, technical publications previews, graphical symbols and the glossary.
committee, …). It also gives information on projects, replaced With a subscription you will always have access to up to date
and withdrawn publications. content tailored to your needs.

IEC Just Published - webstore.iec.ch/justpublished
Electropedia - www.electropedia.org
Stay up to date on all new IEC publications. Just Published
The world's leading online dictionary on electrotechnology,
details all new publications released. Available online and once
containing more than 22 500 terminological entries in English
a month by email.
and French, with equivalent terms in 25 additional languages.

Also known as the International Electrotechnical Vocabulary
IEC Customer Service Centre - webstore.iec.ch/csc
(IEV) online.
If you wish to give us your feedback on this publication or need

further assistance, please contact the Customer Service
Centre: sales@iec.ch.
A propos de l'IEC
La Commission Electrotechnique Internationale (IEC) est la première organisation mondiale qui élabore et publie des
Normes internationales pour tout ce qui a trait à l'électricité, à l'électronique et aux technologies apparentées.

A propos des publications IEC
Le contenu technique des publications IEC est constamment revu. Veuillez vous assurer que vous possédez l’édition la
plus récente, un corrigendum ou amendement peut avoir été publié.

Recherche de publications IEC -  IEC Products & Services Portal - products.iec.ch
webstore.iec.ch/advsearchform Découvrez notre puissant moteur de recherche et consultez
La recherche avancée permet de trouver des publications IEC gratuitement tous les aperçus des publications, symboles
en utilisant différents critères (numéro de référence, texte, graphiques et le glossaire. Avec un abonnement, vous aurez
comité d’études, …). Elle donne aussi des informations sur les toujours accès à un contenu à jour adapté à vos besoins.
projets et les publications remplacées ou retirées.

Electropedia - www.electropedia.org
IEC Just Published - webstore.iec.ch/justpublished
Le premier dictionnaire d'électrotechnologie en ligne au monde,
Restez informé sur les nouvelles publications IEC. Just
avec plus de 22 500 articles terminologiques en anglais et en
Published détaille les nouvelles publications parues.
français, ainsi que les termes équivalents dans 25 langues
Disponible en ligne et une fois par mois par email.
additionnelles. Egalement appelé Vocabulaire

Electrotechnique International (IEV) en ligne.
Service Clients - webstore.iec.ch/csc

Si vous désirez nous donner des commentaires sur cette
publication ou si vous avez des questions contactez-nous:
sales@iec.ch.
IEC 61970-302 ®
Edition 2.0 2024-01
INTERNATIONAL
STANDARD
NORME
INTERNATIONALE
colour
inside
Energy management system application program interface (EMS-API) –

Part 302: Common information model (CIM) dynamics

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

(EMS-API) –
Partie 302: Régimes dynamiques de modèle d'information commun (CIM)

INTERNATIONAL
ELECTROTECHNICAL
COMMISSION
COMMISSION
ELECTROTECHNIQUE
INTERNATIONALE
ICS 33.200  ISBN 978-2-8322-4270-4

– 2 – IEC 61970-302:2024 © IEC 2024
CONTENTS
FOREWORD . 36
INTRODUCTION . 38
1 Scope . 39
2 Normative references . 40
3 Terms and definitions . 40
4 CIM Dynamics specification . 41
4.1 General . 41
4.2 Document structure . 43
5 Common Information Model Dynamics package . 43
5.1 General . 43
5.2 Package StandardInterconnections . 43
5.2.1 General . 43
5.2.2 RemoteInputSignal . 53
5.2.3 RemoteSignalKind enumeration . 54
5.2.4 Package WindModels . 55
5.3 Package StandardModels . 64
5.3.1 General . 64
5.3.2 DynamicsFunctionBlock . 64
5.3.3 RotatingMachineDynamics . 65
5.3.4 Package SynchronousMachineDynamics . 66
5.3.5 Package AsynchronousMachineDynamics . 99
5.3.6 Package TurbineGovernorDynamics . 108
5.3.7 Package TurbineLoadControllerDynamics . 255
5.3.8 Package MechanicalLoadDynamics . 260
5.3.9 Package ExcitationSystemDynamics. 264
5.3.10 Package OverexcitationLimiterDynamics . 458
5.3.11 Package UnderexcitationLimiterDynamics . 475
5.3.12 Package PowerSystemStabilizerDynamics. 489
5.3.13 Package DiscontinuousExcitationControlDynamics . 544
5.3.14 Package PFVArControllerType1Dynamics . 551
5.3.15 Package PFVArControllerType2Dynamics . 558
5.3.16 Package VoltageAdjusterDynamics . 567
5.3.17 Package VoltageCompensatorDynamics . 571
5.3.18 Package WindDynamics . 577
5.3.19 Package WindDynamicsEd2 . 627
5.3.20 Package LoadDynamics. 686
5.3.21 Package HVDCDynamics . 709
5.3.22 Package RelayDynamics . 713
5.3.23 Package StatorCurrentLimiterDynamics . 718
5.3.24 Package StaticVarCompensatorDynamics . 726
5.3.25 Package ShuntCompensatorDynamics . 741
5.3.26 Package StatcomDynamics . 743
5.3.27 Package WECCDynamics . 747
5.3.28 Package IEEE1547Dynamics . 797
5.4 Package UserDefinedModels . 817
5.4.1 General . 817

5.4.2 SynchronousMachineUserDefined . 818
5.4.3 AsynchronousMachineUserDefined . 820
5.4.4 TurbineGovernorUserDefined . 821
5.4.5 TurbineLoadControllerUserDefined . 822
5.4.6 MechanicalLoadUserDefined . 823
5.4.7 ExcitationSystemUserDefined . 825
5.4.8 OverexcitationLimiterUserDefined . 826
5.4.9 UnderexcitationLimiterUserDefined . 827
5.4.10 PowerSystemStabilizerUserDefined . 828
5.4.11 DiscontinuousExcitationControlUserDefined . 829
5.4.12 PFVArControllerType1UserDefined . 831
5.4.13 VoltageAdjusterUserDefined . 832
5.4.14 PFVArControllerType2UserDefined . 833
5.4.15 VoltageCompensatorUserDefined . 834
5.4.16 LoadUserDefined . 835
5.4.17 WindType1or2UserDefined . 836
5.4.18 WindType3or4UserDefined . 837
5.4.19 WindPlantUserDefined . 838
5.4.20 CSCUserDefined . 840
5.4.21 VSCUserDefined . 841
5.4.22 SVCUserDefined . 842
5.4.23 StatorCurrentLimiterUserDefined . 843
5.4.24 ShuntCompensatorUserDefined . 844
5.4.25 ProprietaryParameterDynamics root class . 845
5.4.26 StatcomUserDefined . 846
5.4.27 HVDCInterconnectionUserDefined . 847
5.4.28 RelayUserDefined . 849
5.5 Package DetailedModelDescription . 850
5.5.1 General . 850
5.5.2 DetailedModelTypeDynamics . 851
5.5.3 DetailedModelDescriptorArtifact . 851
5.5.4 DetailedModelDocumentationArtifact . 852
5.5.5 FunctionDescriptor . 853
5.5.6 InputOutputDescriptor . 854
5.5.7 LimiterDescriptor . 855
5.5.8 OperatorDescriptor . 856
5.5.9 ParameterDescriptor . 857
5.5.10 ParameterValue root class . 859
5.5.11 SignalDescriptor . 859
5.5.12 DetailedModelDescriptor . 860
5.5.13 DetailedModelDynamics . 861
5.5.14 ConstraintKind enumeration . 862
5.5.15 LogicalKind enumeration . 862
5.5.16 EquationLanguageKind enumeration. 863
5.5.17 OperatorDescriptorKind enumeration . 863
5.5.18 ParameterKind enumeration . 864
5.5.19 XSDDatatypeKind enumeration . 864
5.5.20 IRI primitive . 865
5.6 Package SimulationResult . 865

– 4 – IEC 61970-302:2024 © IEC 2024
5.6.1 General . 865
5.6.2 ParameterChangeKind enumeration . 866
5.6.3 ClearSimulationEvent . 866
5.6.4 ParameterEvent . 867
5.6.5 PowerFlowSettings . 868
5.6.6 PowerFlowAlgorithmKind enumeration . 871
5.6.7 PowerShiftKind enumeration . 871
5.6.8 SimulationResultCharacteristic . 871
5.6.9 SignalRecorder . 872
5.6.10 SignalConfiguration . 873
5.6.11 SimulationEvents . 874
5.6.12 SlackDistributionKind enumeration . 875
5.6.13 SimulationResult. 875
5.6.14 SimulationSettings . 876
5.6.15 SignalKind enumeration . 878
5.7 Package Examples . 878
Annex A (informative) Dynamics package symbol representation conventions . 882
Annex B (informative) Use of per unit. 884
Annex C (informative) Updates to CIM dynamics standard models . 886
Bibliography . 891

Figure 1 – StandardInterconnectionSynchronousMachine . 44
Figure 2 – StandardInterconnectionSynchronousGeneratorCrossCompound . 45
Figure 3 – StandardInterconnectionAsynchronousMachine . 46
Figure 4 – StandardInterconnectionSingleLoad . 47
Figure 5 – Class diagram StandardInterconnections::
StandardSynchronousMachineInterconnection . 48
Figure 6 – Class diagram StandardInterconnections::
StandardAsynchronousMachineInterconnection . 49
Figure 7 – Class diagram StandardInterconnections::StandardLoadInterconnection . 50
Figure 8 – Class diagram StandardInterconnections::StandardHVDCInterconnection . 51
Figure 9 – Class diagram StandardInterconnections::
StandardStaticVarCompensatorInterconnection . 52
Figure 10 – Class diagram StandardInterconnections::
StandardShuntCompensatorInterconnection . 53
Figure 11 – StandardInterconnectionWindTurbineType1Aand1B . 56
Figure 12 – StandardInterconnectionWindTurbineType2 . 57
Figure 13 – StandardInterconnectionWindTurbineType3 . 58
Figure 14 – StandardInterconnectionWindTurbineType4Aand4B . 59
Figure 15 – Class diagram WindModels::StandardWindType1and2Interconnection . 61
Figure 16 – Class diagram WindModels::StandardWindType3and4Interconnection . 63
Figure 17 – SynchronousGeneratorInterconnectionAndVariables . 67
Figure 18 – SynchronousMotorInterconnectionAndVariables . 68
Figure 19 – Class diagram SynchronousMachineDynamics::
SynchronousMachineDynamics . 69
Figure 20 – SynchronousMachineSaturationParameters . 70
Figure 21 – SynchronousGeneratorMechanicalEquation . 71

Figure 22 – SynchronousMotorMechanicalEquation . 72
Figure 23 – SynchronousGeneratorPhasor . 73
Figure 24 – SynchronousMotorPhasor . 74
Figure 25 – Simplified . 76
Figure 26 – SubtransientRoundRotor . 81
Figure 27 – SubtransientSalientPole . 82
Figure 28 – SubtransientTypeF . 83
Figure 29 – SubtransientTypeJ . 84
Figure 30 – SubtransientRoundRotorSimplified . 85
Figure 31 – SubtransientSalientPoleSimplified . 87
Figure 32 – SubtransientRoundRotorSimplifiedDirectAxis . 89
Figure 33 – SubtransientSalientPoleSimplifiedDirectAxis . 91
Figure 34 – SynchronousEquivalentCircuit . 95
Figure 35 – AsynchronousGeneratorInterconnectionAndVariables . 99
Figure 36 – AsynchronousMotorInterconnectionAndVariables . 100
Figure 37 – Class diagram AsynchronousMachineDynamics::
AsynchronousMachineDynamics . 101
Figure 38 – AsynchronousGeneratorMechanicalEquation . 102
Figure 39 – AsynchronousMotorMechanicalEquation . 102
Figure 40 – AsynchronousEquivalentCircuit . 107
Figure 41 – TurbineGovernorInterconnectionAndVariables . 109
Figure 42 – Class diagram TurbineGovernorDynamics::GasTurbineGovernorDynamics . 110
Figure 43 – Class diagram
TurbineGovernorDynamics::HydroTurbineGovernorDynamics . 110
Figure 44 – Class diagram
TurbineGovernorDynamics::SteamTurbineGovernorDynamics . 111
Figure 45 – GovHydroIEEE0 . 149
Figure 46 – GovHydroIEEE2 . 151
Figure 47 – GovSteamIEEE1 . 154
Figure 48 – GovCT1 . 157
Figure 49 – GovCT2 . 161
Figure 50 – GovGAST . 166
Figure 51 – GovGAST1 . 168
Figure 52 – GovGAST2 . 171
Figure 53 – GovGAST3 . 174
Figure 54 – GovGAST3ExhaustTemperature . 174
Figure 55 – GovGAST4 . 177
Figure 56 – GovGASTWD . 179
Figure 57 – GovHydro1 . 182
Figure 58 – GovHydro2 . 184
Figure 59 – GovHydro3 . 188
Figure 60 – GovHydro4 . 191
Figure 61 – GovHydro4SimpleHydroTurbine . 192
Figure 62 – GovHydro4FrancisPeltonTurbine . 193

– 6 – IEC 61970-302:2024 © IEC 2024
Figure 63 – GovHydro4KaplanTurbine . 194
Figure 64 – GovHydroDD . 198
Figure 65 – GovHydroFrancis . 201
Figure 66 – GovHydroFrancisNonLinearGainAndEfficiency . 202
Figure 67 – DetailedHydroModelHydraulicSystem . 203
Figure 68 – GovHydroPelton . 206
Figure 69 – GovHydroPeltonNonLinearGainAndEfficiency . 207
Figure 70 – GovHydroPID . 210
Figure 71 – GovHydroPID2 . 213
Figure 72 – GovHydroR . 216
Figure 73 – GovHydroWEH . 220
Figure 74 – GovHydroWPID . 225
Figure 75 – GovSteam0 . 227
Figure 76 – GovSteam1 . 229
Figure 77 – GovSteam1BacklashHysteresis . 230
Figure 78 – GovSteam1InputSpeedDeadband . 231
Figure 79 – GovSteam2 . 234
Figure 80 – GovSteamBB . 236
Figure 81 – GovSteamCC . 238
Figure 82 – GovSteamEU . 241
Figure 83 – GovSteamFV2 . 244
Figure 84 – GovSteamFV3 . 246
Figure 85 – GovSteamFV4 . 249
Figure 86 – GovSteamSGO. 253
Figure 87 – Class diagram TurbineLoadControllerDynamics::
TurbineLoadControllerDynamics . 256
Figure 88 – TurbLCFB1 . 258
Figure 89 – MechanicalLoadInterconnectionAndVariables . 261
Figure 90 – MechanicalLoadEquations . 261
Figure 91 – Class diagram MechanicalLoadDynamics::MechanicalLoadDynamics . 262
Figure 92 – ExcitationSystemInterconnectionAndVariables . 265
Figure 93 – Class diagram ExcitationSystemDynamics::ExcitationSystemDynamics . 266
Figure 94 – ExcAC1A . 268
Figure 95 – ExcAC2A . 271
Figure 96 – ExcAC3A . 274
Figure 97 – ExcAC4A . 277
Figure 98 – ExcAC5A . 279
Figure 99 – ExcAC6A . 281
Figure 100 – ExcAC8B . 284
Figure 101 – ExcANS . 287
Figure 102 – ExcAVR1 . 290
Figure 103 – ExcAVR2 . 292
Figure 104 – ExcAVR3 . 294

Figure 105 – ExcAVR4 . 296
Figure 106 – ExcAVR5 . 298
Figure 107 – ExcAVR7 . 300
Figure 108 – ExcBBC . 302
Figure 109 – ExcCZ . 305
Figure 110 – ExcDC1A . 307
Figure 111 – ExcDC2A . 310
Figure 112 – ExcDC3A . 313
Figure 113 – ExcDC3A1 . 315
Figure 114 – ExcELIN1 . 318
Figure 115 – ExcELIN2 . 320
Figure 116 – ExcHU . 323
Figure 117 – ExcNI . 325
Figure 118 – ExcOEX3T . 327
Figure 119 – ExcPIC . 329
Figure 120 – ExcREXS . 332
Figure 121 – ExcRQB . 336
Figure 122 – ExcSCRX . 338
Figure 123 – ExcSEXS . 340
Figure 124 – ExcSK . 342
Figure 125 – ExcST1A . 345
Figure 126 – ExcST2A . 348
Figure 127 – ExcST3A . 350
Figure 128 – ExcST4B . 353
Figure 129 – ExcST6B . 355
Figure 130 – ExcST7B . 358
Figure 131 – Class diagram IEEE4215from2016::IEEE4215from2016 . 362
Figure 132 – Class diagram IEEE4215from2005::IEEE4215from2005 . 418
Figure 133 – Class diagram
OverexcitationLimiterDynamics::OverexcitationLimiterDynamics . 458
Figure 134 – OverexcLim2 . 468
Figure 135 – OverexcLimX1 . 470
Figure 136 – OverexcLimX1TimeCharacteristic . 470
Figure 137 – OverexcLimX2 . 472
Figure 138 – OverexcLimX2TimeCharacteristic . 473
Figure 139 – Class diagram UnderexcitationLimiterDynamics::
UnderexcitationLimiterDynamics . 475
Figure 140 – UnderexcLim2Simplified . 484
Figure 141 – UnderexcLimX1 . 486
Figure 142 – UnderexcLimX2 . 488
Figure 143 – PowerSystemStabilizerInterconnectionAndVariables . 490
Figure 144 – Class diagram PowerSystemStabilizerDynamics::
PowerSystemStabilizerDynamics . 491
Figure 145 – Pss1 . 516

– 8 – IEC 61970-302:2024 © IEC 2024
Figure 146 – Pss1A . 518
Figure 147 – Pss2B . 520
Figure 148 – Pss2ST . 522
Figure 149 – Pss5 . 524
Figure 150 – PssELIN2 . 527
Figure 151 – PssPTIST1 . 528
Figure 152 – PssPTIST3 . 530
Figure 153 – PssRQB . 533
Figure 154 – PssSB4 . 535
Figure 155 – PssSH . 536
Figure 156 – PssSK . 538
Figure 157 – PssSTAB2A . 540
Figure 158 – PssWECC . 542
Figure 159 – DiscontinuousExcitationControlInterconnectionAndVariables . 545
Figure 160 – Class diagram DiscontinuousExcitationControlDynamics::
DiscontinuousExcitationControlDynamics . 546
Figure 161 – Class diagram
PFVArControllerType1Dynamics::PFVArControllerType1Dynamics . 552
Figure 162 – Class diagram PFVArControllerType2Dynamics::
PFVArControllerType2Dynamics . 559
Figure 163 – PFVArType2Common1 . 560
Figure 164 – Class diagram VoltageAdjusterDynamics::VoltageAdjusterDynamics . 567
Figure 165 – VoltageCompensatorInterconnectionAndVariables . 572
Figure 166 – Class diagram
VoltageCompensatorDynamics::VoltageCompensatorDynamics . 573
Figure 167 – Class diagram WindDynamics::WindDynamicsType1or2 . 578
Figure 168 – Class diagram WindDynamics::WindDynamicsType3 . 579
Figure 169 – Class diagram WindDynamics::WindDynamicsType4 . 580
Figure 170 – Class diagram WindDynamics::WindDynamicsPlant . 581
Figure 171 – Class diagram WindDynamicsEd2::WindDynamicsType1or2 . 629
Figure 172 – Class diagram WindDynamicsEd2::WindDynamicsType3 . 630
Figure 173 – Class diagram WindDynamicsEd2::WindDynamicsType4 . 631
Figure 174 – Class diagram WindDynamicsEd2::WindDynamicsPlant . 632
Figure 175 – LoadInterconnectionAndVariables . 687
Figure 176 – Class diagram LoadDynamics::LoadDynamics . 688
Figure 177 – LoadCompositeEquations . 689
Figure 178 – LoadGenericNonLinearTypeEquations. 691
Figure 179 – LoadStaticTypeEquations . 695
Figure 180 – LoadMotor . 698
Figure 181 – Class diagram LoadCompositeWECC::LoadCompositeWECC . 701
Figure 182 – Class diagram HVDCDynamics::HVDCDynamics . 709
Figure 183 – Class diagram RelayDynamics::RelayDynamics . 714
Figure 184 – Class diagram StatorCurrentLimiterDynamics::
StatorCurrentLimiterDynamics . 719

Figure 185 – Class diagram StaticVarCompensatorDynamics::
StaticVarCompensatorDynamics . 726
Figure 186 – Class diagram
ShuntCompensatorDynamics::ShuntCompensatorDynamics . 741
Figure 187 – Class diagram StatcomDynamics::StatcomIEC . 743
Figure 188 – Class diagram StatcomDynamics::StatcomDynamics . 744
Figure 189 – Class diagram WECCDynamics::WeccDynamics . 747
Figure 190 – Class diagram WECCDynamics::WeccBESS . 748
Figure 191 – Class diagram IEEE1547Dynamics::IEEE1547Dynamics . 797
Figure 192 – Class diagram UserDefinedModels::ProprietaryUserDefinedModels . 818
Figure 193 – Class diagram DetailedModelDescription::DetailedModelDescription . 850
Figure 194 – Class diagram SimulationResult::SimulationResult . 865
Figure 195 – Object diagram Examples::ExampleStandardModel . 879
Figure 196 – Object diagram Examples::ExampleFunctionBlockProprietaryModel . 880
Figure 197 – Object diagram Examples::ExampleCompleteProprietaryModel . 881

Table 1 – Attributes of StandardInterconnections::RemoteInputSignal . 53
Table 2 – Association ends of StandardInterconnections:: RemoteInputSignal with
other classes . 54
Table 3 – Literals of StandardInterconnections::RemoteSignalKind . 55
Table 4 – Attributes of StandardMode
...