OPC UA DataTypes – OPC UA for Energy Consumption Management

9 OPC UA DataTypes

9.1 StandbyModeTransitionDataType

The StandbyModeTransitionDataType holds information which might change when the device is in a transition state to an Energy Saving Mode.

Table 41 – StandbyModeTransitionDataType Structure

Name	Type	Description
StandbyModeTransitionDataType	Structure
IDDestination	0:Byte	Mode ID of destination Energy Saving Mode.
CurrentTimeToDestination	0:Duration	Time needed to reach the mode IDDestination. Shall be a “Worst case” value if ongoing (dynamic) time value is not supported. Shall be 0 if destination Energy Saving Mode is reached.
CurrentTimeToOperate	0:Duration	Time needed to reach “Ready to operate” if the Energy Saving Mode is not regularly terminated. The server might update the value after reaching the destination state as long as the TimeMinLengthOfStay of the destination state is not reached.
EnergyConsumptionToDestination	0:Float	Energy consumption for actual transition. Shall be 0 if not in a transition state.

Its representation in the AddressSpace is defined in Table 42.

Table 42 – StandbyModeTransitionDataType Definition

Attribute		Value
BrowseName		StandbyModeTransitionDataType
IsAbstract		False

References	NodeClass		BrowseName	DataType	TypeDefinition	Other
Subtype of the 0:Structure

Conformance Units
ECM Standby Management

Figure 16 shows how CurrentTimeToOperate varies in dependence of TimeToPause and TimeMinLengthOfStay of the destination Energy Saving Mode during and immediately after the transition.

The relationship of RegularTimeToOperate and CurrentTimeToOperate during a mode transition shall follow Figure 16. A more comprehensive explanation may be found in PE 3802.

Figure 16 – RegularTimeToOperate vs. CurrentTimeToOperate

9.2 EnergyStateInformationDataType

The EnergyStateInformationDataType holds information specific to a certain state which also does not change if the device is in transition state. The members shall have the values characterizing the current state and shall be changed only in case of a transition to a different state.

Table 43 – EnergyStateInformationDataType Structure

Name	Type	Description
EnergyStateInformationDataType	Structure
IDSource	0:Byte	Mode ID of current Energy Saving Mode.
IDDestination	0:Byte	Mode ID of destination Energy Saving Mode.
RegularTimeToOperate	0:Duration	Time needed to reach “Ready to operate” if the Energy Saving Mode is regularly terminated. Shall be 0 if IDSource is equal to 0xFF (The StandbyManagementStatus Variable has the value “Ready to operate”).
ModePowerConsumption	0:Float	Power consumption in actual state.

Table 44 – EnergyStateInformationDataType Definition

Attribute		Value
BrowseName		EnergyStateInformationDataType
IsAbstract		False

References	NodeClass		BrowseName	DataType	TypeDefinition	Other
Subtype of the 0:Structure

Conformance Units
ECM Standby Management

If the StandbyManagementStatus Variable of the EnergyStandbyManagementType Object has the value 2 (“Ready to operate”), IDSource and IDDestination shall be equal and have the value 0xFF.

If this StandbyManagementStatus Variable has the value 0 (“Energy saving disabled”), IDSource and IDDestination shall be equal and have the value 0xF0.

If this StandbyManagementStatus Variable has the value 4 (“Energy saving mode”), IDSource and IDDestination shall be equal and have the value of the ID Property of the EnergySavingModeType Object representing the current Energy Saving Mode.

If this StandbyManagementStatus Variable has the value 3 (“Moving to energy saving mode”) and if the previous value was 2 (“Ready to operate”), IDSource shall have the value 0xFF and IDDestination shall have the value of the ID Property of the EnergySavingModeType Object representing the destination Energy Saving Mode.

If this StandbyManagementStatus Variable has the value 3 (“Moving to energy saving mode”) and if the previous value was 4 (“Energy saving mode”, the state transition takes place between two Energy Saving Modes), IDSource shall be the value of the ID Property of the EnergySavingModeType Object representing the source Energy Saving Mode. IDDestination shall have the value of the ID Property of the EnergySavingModeType Object representing the destination Energy Saving Mode.

If this StandbyManagementStatus Variable has the value 5 (“Moving to ready to operate”), IDDestination shall have the value 0xFF. IDSource shall have the value of the ID Property of the EnergySavingModeType Object representing the source Energy Saving Mode.

9.3 AcPeDataType

This structure represents the measurement values of phases relative to neutral, for example for current or voltage.

Phase names L1, L2, L3 can also be seen as A, B, C according to IEC 61557-12 [4].

AcPeDataType corresponds to the magnitude values for phsA, phsB, phsC data objects within a WYE Common Data Class as defined by IEC 61850-7-3 [7].

Table 45 – AcPeDataType Structure

Name	Type	Description
AcPeDataType	Structure
L1	0:Float	Phase L1-N (or phase a-n)
L2	0:Float	Phase L2-N (or phase b-n)
L3	0:Float	Phase L3-N (or phase c-n)

Table 46 – AcPeDataType Definition

Attribute		Value
BrowseName		AcPeDataType
IsAbstract		False

References	NodeClass		BrowseName	DataType	TypeDefinition	Other
Subtype of the 0:Structure

Conformance Units
ECM EnergyProfile E0
ECM EnergyProfile E3
ECM Energy Measurement Common DataTypes

9.4 AcPpDataType

This structure represents the measurement values of phases relative to each other, for example for current or voltage.

Phase names L1L2, L2L3, L3L1 can also be seen as A_b, B_c, C_a according to IEC 61557-12 [4].

AcPpDataType corresponds to the magnitude values for phsAB, phsBC, phsCA data objects within a DEL Common Data Class as defined by IEC 61850-7-3 [7].

Table 47 – AcPpDataType Structure

Name	Type	Description
AcPpDataType	Structure
L1L2	0:Float	Phase L1-L2 (or phase a-b)
L2L3	0:Float	Phase L2-L3 (or phase b-c)
L3L1	0:Float	Phase L3-L1 (or phase c-a)

Table 48 – AcPpDataType Definition

Attribute		Value
BrowseName		AcPpDataType
IsAbstract		False

References	NodeClass		BrowseName	DataType	TypeDefinition	Other
Subtype of the 0:Structure

Conformance Units
ECM EnergyProfile E3
ECM Energy Measurement Common DataTypes

9.5 MeasurementPeriodEnum

This enumeration MeasurementPeriodEnum defines how a measurement period is to be interpreted. The enumeration is defined in Table 49.

Table 49 – MeasurementPeriodEnum Items

Name	Value	Description
SlidingDemand	0	The measurement period is interpreted to consider the last measurement period.
FixedBlockCompleted	1	The measurement period is interpreted to take the last completed measurement period aligned to the full hour.
FixedBlockInstantaneous	2	The measurement period is interpreted to take the current measurement period aligned to the full hour. That means, if for example only have of the measurement period has passed, only that half is considered.
FixedBlockPredicted	3	The measurement period is interpreted to take the current measurement period aligned to the full hour and predicts the duration that has not been passed. That means, if for example only have of the measurement period has passed, the first half of the considered values is based on real measurements while the second half takes predicted values.

Its representation in the AddressSpace is defined in Table 50.

Table 50 – MeasurementPeriodEnum Definition

Attribute	Value
BrowseName	MeasurementPeriodEnum
IsAbstract	False

References	Node Class	BrowseName	DataType	TypeDefinition	Other
Subtype of the Enumeration type defined in OPC 10000-5
0:HasProperty	Variable	0:EnumValues	0:EnumValueType[]	0:PropertyType

Conformance Units
ECM Energy Measurement

9.6 MeasurementPeriodDataType

This structure contains information about the measurement period. The structure is defined in Table 51.

Table 51 – MeasurementPeriodDataType Structure

Name	Type	Description
MeasurementPeriodDataType	structure
Duration	0:Duration	The duration of the measurement period in ms.
Definition	MeasurementPeriodEnum	Defines how to interpret the duration of the measurement period.

Its representation in the AddressSpace is defined in Table 52.

Table 52 – MeasurementPeriodDataType Definition

Attribute	Value
BrowseName	MeasurementPeriodDataType
IsAbstract	False

References	Node Class	BrowseName	DataType	TypeDefinition	Other
Subtype of 0:Structure

Conformance Units
ECM Energy Measurement