8.1.1 EnergyStandbyManagementType

The EnergyStandbyManagementType ObjectTypes provide access to the Standby Management functionality of one Standby Management Entity. Parallel access of Clients to the read only data shall be possible but write operations and Method invocation can be limited to one Client at a time with the Lock Object.

Table 12 – EnergyStandbyManagementType Definition
Attribute Value
BrowseNameEnergyStandbyManagementType
IsAbstractFalse
References Node Class BrowseName DataType TypeDefinition Other
Subtype of the BaseObjectType defined in [OPC 10000-5].
0:HasComponentVariableStandbyManagementStatusByte0:MultiStateDiscreteTypeM, RO
0:HasComponentObjectEnergySavingModeStatusEnergySavingModeStatusTypeM
0:HasComponentObjectEnergySavingModesEnergySavingModesContainerTypeO
0:HasComponentVariablePauseTime0:Duration0:BaseDataVariableTypeM, RW
0:HasComponentObject2:Lock2:LockingServicesTypeO
0:HasComponentMethodStartPauseO
0:HasComponentMethodEndPauseO
0:HasComponentMethodSwitchToEnergySavingModeO

The StandbyManagementStatus Variable shall contain the current state of the Standby Management. The value of this Variable shall be consistent with the content of the EnergySavingModeStatus Object.

The values of the 0:EnumStrings of the StandbyManagementStatus shall follow the definition of Table 13. Each instance shall have the values 0 to 8. Element numbers 9-15 are reserved for future use. If vendors add specific elements, the range 9-15 shall be filled with ‘null’-strings.

Table 13 – Defined elements of EnumStrings array of StandbyManagementStatus Variable
Element number (starting with 0) Message (for locale “en”)
0Energy saving disabled
1Power Off
2Ready to operate
3Moving to Energy Saving Mode
4Energy saving mode
5Moving to ready to operate
6Moving to Sleep mode WOL
7Sleep mode WOL
8Wake up WOL
9-15‘null’-String
16 – 255Vendor specific

The Variables of the EnergyStandbyManagementType have additional Attributes defined in Table 14

Table 14 – EnergyStandbyManagementType Attribute values for child Nodes
Source Path Value Attribute

Energy saving disabled

Power Off

Ready to operate

Moving to Energy Saving Mode

Energy saving mode

Moving to ready to operate

Moving to Sleep mode WOL

Sleep mode WOL

Wake up WOL

The EnergySavingModes container Object contains References to EnergySavingModeType Objects representing the supported Energy Saving Modes.

Writing the PauseTime Variable can be used to update the pause time alternatively to the StartPause Method. Setting the PauseTime Variable with a value not equal to 0 shall have the same effect as invoking the StartPause Method passing the PauseTime value. Setting the PauseTime Variable with a value equal to 0 shall have the same effect as invoking the EndPause Method. An additional benefit is that the Variable PauseTime can be used in a PubSub communication scenario where the PauseTime is distributed by a central time management client using a broadcast telegram to which every Standby Management Entity subscribes.

The Lock Object ensures exclusive write access and Method call for one client. Write access and Method calls from Clients shall be blocked unless the client has locked the Object by invoking the InitLock Method of the Lock Object.

The StartPause Method starts the transition to an Energy Saving Mode. The SwitchToEnergySavingMode allows the transition into a specific Energy Saving Mode. The EndPause Method ends the Energy Saving Mode.

A RepresentedBy Reference may connect the Object to the representing PROFIenergy service access point Object (see PeServiceAccessPointType). The BrowseName of the Reference shall be “PESAP”.

8.1.1.1 StartPause Method

This Method starts the transition into an Energy Saving Mode.

Signature

	StartPause (
		[in]  0:Duration	PauseTime
		[out] 0:Byte		ModeID
		[out] 0:Duration	CurrentTimeToDestination
		[out] 0:Duration	RegularTimeToOperate
		[out] 0:Duration	TimeMinLengthOfStay
		[out] 0:Byte		ReturnCode
		);
	
Argument Description
PauseTimeRequested pause time.
ModeIDID of the destination Energy Saving Mode if successful, otherwise 0.
CurrentTimeToDestinationTime needed to reach the Energy Saving Mode if successful, otherwise 0.
RegularTimeToOperateTime needed to reach “Ready to operate” again if the destination Energy Saving Mode will be regularly terminated if successful, otherwise 0.
TimeMinLengthOfStayTime of minimum stay in the destination Energy Saving Mode if successful, otherwise 0.
ReturnCodeReturn code. See Table 16.

The Method Result Codes (defined in Call Service) are defined in Table 15.

8.1.1.2 SwitchToEnergySavingMode Method

This Method initiates a switch to a certain Energy Saving Mode.

Signature

	SwitchToEnergySavingMode (
		[in]  0:Byte		ModeID
	[out] 0:Byte		EffectiveModeID
	[out] 0:Duration	CurrentTimeToDestination
		[out] 0:Duration	RegularTimeToOperate
		[out] 0:Duration	TimeMinLengthOfStay
		[out] 0:Byte		ReturnCode
		);
	
Argument Description
ModeIDID of the requested Energy Saving Mode.
EffectiveModeIDID of the effectively chosen Energy Saving Mode if successful, otherwise ID of current mode.
CurrentTimeToDestinationTime needed to reach the destination Energy Saving Mode if successful, otherwise 0.
RegularTimeToOperateTime needed to reach “Ready to operate” again if the destination Energy Saving Mode will be regularly terminated if successful, otherwise 0.
TimeMinLengthOfStayTime of minimum stay in the destination Energy Saving Mode if successful, otherwise 0.
ReturnCodeReturn code. See table Table 16.

The Method Result Codes (defined in Call Service) are defined in Table 15.

8.1.1.3 EndPause Method

This Method ends the current Energy Saving Mode.

Signature

	EndPause (
		[out] 0:Duration	CurrentTimeToOperate
		[out] 0:Byte		ReturnCode
		);
	
Argument Description
CurrentTimeToOperateTime needed to reach “Ready to operate” if successful, 0.
ReturnCodeReturn code. See table Table 16.

The Method Result Codes (defined in Call Service) are defined in Table 15.

Table 15 shows the possible values for the Method call result codes.

Table 15 – Possible Method result codes
Result Code Description
GoodThe Method execution was successful and the ReturnCode parameter has the value 0x00 (”Success”)
UncertainThe Method execution was successful, but the ReturnCode parameter indicates an error.
Bad_UserAccessDeniedThe user has not the right to execute the Method. The client shall not evaluate the ReturnCode parameter.
Bad_UnexpectedErrorThe server is not able to execute the function because an unexpected error occurred. The device might be temporarily unavailable or unreachable due to network failure. The client shall not evaluate the ReturnCode parameter.

Table 16 shows the possible values for the out parameter ReturnCode.

Table 16 – Possible ReturnCode parameter Values
ReturnCode Description
0x00Success.
0x50No suitable energy-saving mode available.
0x52No switch to requested energy-saving mode because of invalid mode ID.
0x53No switch to Energy Saving Mode because of state operate.
0x54Service or function not available due to internal device status.