IEC 61970-301:2009

IEC 61970-301
®
Edition 2.0 2009-04
INTERNATIONAL
STANDARD


Energy management system application program interface (EMS-API) –
Part 301: Common information model (CIM) base



IEC 61970-301:2009(E)

---------------------- Page: 1 ----------------------
THIS PUBLICATION IS COPYRIGHT PROTECTED
Copyright © 2009 IEC, Geneva, Switzerland

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.

IEC Central Office
3, rue de Varembé
CH-1211 Geneva 20
Switzerland
Email: inmail@iec.ch
Web: www.iec.ch

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 corrigenda or an amendment might have been published.
ƒ Catalogue of IEC publications: www.iec.ch/searchpub
The IEC on-line Catalogue enables you to search by a variety of criteria (reference number, text, technical committee,…).
It also gives information on projects, withdrawn and replaced publications.
ƒ IEC Just Published: www.iec.ch/online_news/justpub
Stay up to date on all new IEC publications. Just Published details twice a month all new publications released. Available
on-line and also by email.
ƒ Electropedia: www.electropedia.org
The world's leading online dictionary of electronic and electrical terms containing more than 20 000 terms and definitions
in English and French, with equivalent terms in additional languages. Also known as the International Electrotechnical
Vocabulary online.
ƒ Customer Service Centre: www.iec.ch/webstore/custserv
If you wish to give us your feedback on this publication or need further assistance, please visit the Customer Service
Centre FAQ or contact us:
Email: csc@iec.ch
Tel.: +41 22 919 02 11
Fax: +41 22 919 03 00

---------------------- Page: 2 ----------------------
IEC 61970-301
®
Edition 2.0 2009-04
INTERNATIONAL
STANDARD


Energy management system application program interface (EMS-API) –
Part 301: Common information model (CIM) base


INTERNATIONAL
ELECTROTECHNICAL
COMMISSION
PRICE CODE
XH
ICS 33.200 ISBN 978-2-88910-593-9
® Registered trademark of the International Electrotechnical Commission

---------------------- Page: 3 ----------------------
– 2 – 61970-301 © IEC:2009(E)
CONTENTS
FOREWORD.11
INTRODUCTION.13
1 Scope.15
2 Normative references .15
3 Terms, definitions and abbreviations .16
4 CIM specification.16
4.1 CIM modeling notation.16
4.2 CIM packages .16
4.2.1 Core .18
4.2.2 Topology .18
4.2.3 Wires.18
4.2.4 Outage .18
4.2.5 Protection.18
4.2.6 Meas .18
4.2.7 LoadModel.18
4.2.8 Generation .18
4.2.9 SCADA.19
4.2.10 Domain.19
4.3 CIM classes and relationships .19
4.3.1 Generalization .20
4.3.2 Simple association .20
4.3.3 Aggregation.21
4.4 CIM Model concepts and examples .21
4.4.1 Containment, equipment hierarchies and naming.21
4.4.2 Connectivity model .24
4.4.3 Inheritance hierarchy.26
4.4.4 Transformer model .28
4.4.5 Measurements and controls.29
4.5 Modeling guidelines.33
4.5.1 Amendments to the CIM .33
4.5.2 CIM profiles.34
4.6 Modeling tools .34
4.7 User implementation conventions .34
4.7.1 Number of terminals for ConductingEquipment objects .34
4.8 CIM modeling examples .34
5 Detailed model (normative).35
5.1 Overview .35
5.2 Context .35
6 Package architecture (normative) .37
6.1 IEC 61970.37
6.1.1 IEC 61970CIMVersion .37
6.2 Core.38
6.2.1 BasePower .40
6.2.2 BaseVoltage .40
6.2.3 BasicIntervalSchedule .40
6.2.4 Bay.41

---------------------- Page: 4 ----------------------
61970-301 © IEC:2009(E) – 3 –
6.2.5 Company.41
6.2.6 ConductingEquipment.42
6.2.7 ControlHouseEquipment .43
6.2.8 CoreVersion .43
6.2.9 Curve .43
6.2.10 CurveData .44
6.2.11 Equipment .44
6.2.12 EquipmentContainer .44
6.2.13 GeographicalRegion .45
6.2.14 IdentifiedObject .45
6.2.15 IrregularIntervalSchedule.46
6.2.16 IrregularTimePoint .46
6.2.17 ModelingAuthority.47
6.2.18 ModelingAuthoritySet .47
6.2.19 PowerSystemResource.47
6.2.20 PSRType .48
6.2.21 RegularIntervalSchedule .48
6.2.22 RegularTimePoint.49
6.2.23 SubControlArea .49
6.2.24 SubGeographicalRegion .50
6.2.25 Substation .50
6.2.26 Terminal .51
6.2.27 Unit .51
6.2.28 VoltageLevel .52
6.3 Domain.52
6.3.1 AbsoluteDateTimePrimitive .57
6.3.2 ActivePowerPrimitive.57
6.3.3 AdmittancePrimitive .57
6.3.4 AngleDegreesPrimitive .57
6.3.5 AngleRadiansPrimitive .57
6.3.6 ApparentPowerPrimitive .57
6.3.7 AreaControlModeEnumeration.58
6.3.8 BoilerControlModeEnumeration .58
6.3.9 BooleanPrimitive .58
6.3.10 BreakerConfigurationEnumeration.58
6.3.11 BusbarConfigurationEnumeration .58
6.3.12 ClassificationPrimitive .58
6.3.13 ClearanceTagTypeEnumeration .59
6.3.14 CompanyTypeEnumeration .59
6.3.15 ComplexPrimitive .59
6.3.16 CompositeSwitchTypePrimitive .59
6.3.17 ConductancePrimitive.59
6.3.18 ControlHouseEquipmentTypeEnumeration .59
6.3.19 ControlModePrimitive .59
6.3.20 CoolantTypeEnumeration .60
6.3.21 CostPerEnergyUnitPrimitive .60
6.3.22 CostPerHeatUnitPrimitive.60
6.3.23 CostPerHourPrimitive.60
6.3.24 CounterPrimitive.60

---------------------- Page: 5 ----------------------
– 4 – 61970-301 © IEC:2009(E)
6.3.25 CurrentFlowPrimitive .60
6.3.26 CurveStyleEnumeration.61
6.3.27 DampingPrimitive .61
6.3.28 DayTypeNameEnumeration .61
6.3.29 DomainVersion.61
6.3.30 EmissionPrimitive.61
6.3.31 EmissionTypeEnumeration .62
6.3.32 EmissionValueSourceEnumeration.62
6.3.33 EnergyAsMWhPrimitive .62
6.3.34 ExcitingCurrentPrimitive .62
6.3.35 ExponentPrimitive .62
6.3.36 FloatPrimitive .62
6.3.37 FractionPrimitive .63
6.3.38 FreqBiasFactorPrimitive .63
6.3.39 FrequencyPrimitive.63
6.3.40 FuelTypeEnumeration .63
6.3.41 GeneratorControlModeEnumeration .63
6.3.42 GeneratorControlSourceEnumeration .63
6.3.43 GeneratorOperatingModeEnumeration .64
6.3.44 HeatPerHourPrimitive.64
6.3.45 HoursPrimitive.64
6.3.46 HydroPlantTypeEnumeration.64
6.3.47 ImpedancePrimitive.64
6.3.48 InductancePrimitive.65
6.3.49 InertiaPrimitive .65
6.3.50 IntegerPrimitive .65
6.3.51 LoadPrimitive .65
6.3.52 LoadLossPrimitive.65
6.3.53 LongDoublePrimitive .65
6.3.54 LongLengthPrimitive.65
6.3.55 LongLongPrimitive.66
6.3.56 MoneyPrimitive.66
6.3.57 NoLoadLossPrimitive.66
6.3.58 NumericUnion .66
6.3.59 NumericTypeEnumeration .67
6.3.60 OctetPrimitive.67
6.3.61 OperatingModePrimitive .67
6.3.62 ParticipationFactorPrimitive.67
6.3.63 PenaltyFactorPrimitive .67
6.3.64 PenstockTypeEnumeration.67
6.3.65 PerCentPrimitive .67
6.3.66 PhaseCodePrimitive .68
6.3.67 PowerFactorPrimitive .68
6.3.68 PowerROCPerMinPrimitive.68
6.3.69 PowerROCPerSecPrimitive .68
6.3.70 PowerVersusFrequencyPrimitive .68
6.3.71 PowerVersusVoltagePrimitive.69
6.3.72 PressurePrimitive .69
6.3.73 PriorityPrimitive.69

---------------------- Page: 6 ----------------------
61970-301 © IEC:2009(E) – 5 –
6.3.74 PUPrimitive .69
6.3.75 PUkVPerMVArPrimitive .69
6.3.76 QuantityEnumeration.70
6.3.77 RampMethodEnumeration .70
6.3.78 RampStartMethodEnumeration.70
6.3.79 RampUnitsEnumeration.70
6.3.80 RateOfChangePrimitive .70
6.3.81 RatioPrimitive.71
6.3.82 ReactancePrimitive .71
6.3.83 ReactivePowerPrimitive.71
6.3.84 ReferencePrimitive.71
6.3.85 RemoteUnitTypeEnumeration.71
6.3.86 ResistancePrimitive.71
6.3.87 SeasonNameEnumeration .72
6.3.88 SecondsPrimitive .72
6.3.89 ShortPrimitive.72
6.3.90 ShortLengthPrimitive .72
6.3.91 SourceEnumeration.72
6.3.92 SpillwayGateTypeEnumeration.72
6.3.93 StringPrimitive.72
6.3.94 SurgeTankCodeEnumeration.73
6.3.95 SusceptancePrimitive.73
6.3.96 SwitchStateEnumeration .73
6.3.97 SynchronousMachineOperatingModeEnumeration.73
6.3.98 SynchronousMachineTypeEnumeration .73
6.3.99 TapStepPrimitive.73
6.3.100 TemperaturePrimitive .73
6.3.101 TemperatureUnitsEnumeration .74
6.3.102 TerminalCountPrimitive .74
6.3.103 TerminalTypePrimitive.74
6.3.104 TimeStampPrimitive .74
6.3.105 TransformerControlModeEnumeration .74
6.3.106 TransformerCoolingTypeEnumeration .74
6.3.107 TransformerTypeEnumeration .74
6.3.108 TurbineTypeEnumeration .75
6.3.109 ULongPrimitive.75
6.3.110 ULongLongPrimitive .75
6.3.111 ValidityEnumeration .75
6.3.112 WaterLevelPrimitive .76
6.3.113 WindingConnectionEnumeration.76
6.3.114 WindingTypeEnumeration.76
6.3.115 VoltagePrimitive .76
6.3.116 VoltagePerReactivePowerPrimitive .76
6.3.117 VolumePrimitive .76
6.3.118 YAxisTypeEnumeration .77
6.4 LoadModel .77
6.4.1 AreaLoadCurve .78
6.4.2 AreaLossCurve.78
6.4.3 CustomerLoad .79

---------------------- Page: 7 ----------------------
– 6 – 61970-301 © IEC:2009(E)
6.4.4 DayType.80
6.4.5 EquivalentLoad.80
6.4.6 InductionMotorLoad.82
6.4.7 LoadArea.83
6.4.8 LoadDemandModel.83
6.4.9 LoadModelVersion.84
6.4.10 NonConformLoadSchedule .84
6.4.11 PowerCutZone.85
6.4.12 Season.85
6.4.13 StationSupply .86
6.5 Meas .87
6.5.1 Accumulator .90
6.5.2 AccumulatorLimit .91
6.5.3 AccumulatorLimitSet.91
6.5.4 AccumulatorValue .92
6.5.5 Analog.92
6.5.6 AnalogLimit .93
6.5.7 AnalogLimitSet .93
6.5.8 AnalogValue .94
6.5.9 Command.94
6.5.10 Control .95
6.5.11 ControlType.95
6.5.12 Discrete.96
6.5.13 DiscreteValue .96
6.5.14 Limit .97
6.5.15 LimitSet .97
6.5.16 Measurement.97
6.5.17 MeasurementType .99
6.5.18 MeasurementValue.99
6.5.19 MeasurementValueQuality.100
6.5.20 MeasurementValueSource.100
6.5.21 MeasVersion .101
6.5.22 Quality61850 .101
6.5.23 SetPoint .102
6.5.24 StringMeasurement .103
6.5.25 StringMeasurementValue.103
6.5.26 ValueAliasSet .104
6.5.27 ValueToAlias .104
6.6 Outage .105
6.6.1 ClearanceTag.105
6.6.2 OutageSchedule.106
6.6.3 OutageVersion .107
6.6.4 SwitchingOperation .107
6.7 Topology .107
6.7.1 ConnectivityNode .
...