ERROR (ENUM) ¶ TYPE ERROR : This data structure describes errors which might occur when using the functions of the CAA_DtUtility library. Attributes: qualified_only InOut: Name Initial Comment NO_ERROR 0 No Error; function successfully executed FIRST_ERROR 5750 First library-specific error TIME_OUT 5751 Time limit exceeded NOT_AVAILABLE 5752 Not available INPUT_INVALID 5753 Invalid input values DTU_ERROR_UNKNOWN 5754 Unknown error DTU_WRONG_PARAMETER 5755 Wrong parameter DTU_TZI_NOT_SET 5756 Timezone information not initialized FIRST_MF 5770 First manufacturer-specific error LAST_ERROR 5799 Last library-specific error

Function Blocks ¶ Time Zone Information GetTimeZoneInformation (FunctionBlock) SetTimeZoneInformation (FunctionBlock) Time and Date GetDateAndTime (FunctionBlock) SetDateAndTime (FunctionBlock)

Time Zone Information ¶ The World is divided in time zones which are based on the degrees of longitude. The English town Greenwich is situated in their centre on the so-called prime meridian that defines the starting point for the count of the world’s degrees of longitude. By taking a closer look at a globe, one can distinguish the degrees of longitude and latitude which clasp the world like a grid. The degrees of longitude go from north to south and connect the two poles. The time being measured in the observatory in Greenwich is called GMT which is the abbreviation for Greenwich Mean Time . The GMT serves as a basis for calculating the respecting times in all countries of the world. However nowadays the term GMT is not used any more as it has been replaced by the expression Universal Time Coordinated (UTC). [CC BY-SA 4.0 ( Wikimedia Commons )] GetTimeZoneInformation (FunctionBlock) SetTimeZoneInformation (FunctionBlock)

GetTimeZoneInformation (FB) ¶ FUNCTION_BLOCK GetTimeZoneInformation This function block reads the specific information on the time zone (for further information see library CAA_RealTimeClock ). InOut: Scope Name Type Comment Input xExecute BOOL Rising edge: Action start Falling edge: Resets outputs. If a falling edge occurs before the function block has completed its action, the outputs operate in the usual manner and are only reset if either the action is completed or in the event of an error. In this case, the corresponding output values (xDone, xError, iError) are present at the outputs for exactly one cycle. Output xDone BOOL Action successfully completed xBusy BOOL Function block active xError BOOL TRUE : error occurred, function block aborts action FALSE : no error eError ERROR Error description for diagnosis tziInfo RTCLK.TIME_ZONE_INFO Information on the time zone

SetTimeZoneInformation (FB) ¶ FUNCTION_BLOCK SetTimeZoneInformation With this function block the specific information of the time zone can be modified. The time zone setting will be kept even after a Reset-Origin of the controller and can only be modified by being overwritten again. If no automatic switch is desired, all elements of tziInfo.stStandardDate and tziInfo.stDaylightDate must be set to 0. (for further information see library CAA_RealTimeClock ) InOut: Scope Name Type Comment Input xExecute BOOL Rising edge: Action start Falling edge: Resets outputs. If a falling edge occurs before the function block has completed its action, the outputs operate in the usual manner and are only reset if either the action is completed or in the event of an error. In this case, the corresponding output values (xDone, xError, iError) are present at the outputs for exactly one cycle. tziInfo RTCLK.TIME_ZONE_INFO Information on the time zone Output xDone BOOL Action successfully completed xBusy BOOL Function block active xError BOOL TRUE : error occurred, function block aborts action FALSE : no error eError ERROR Error description for diagnosis

IReconfigureProvider (ITF) ¶ INTERFACE IReconfigureProvider EXTENDS __SYSTEM.IQueryInterface Interface for reconfiguring Properties: ReconfigureActive SiblingIRP Methods: ReconfigureAsync RegisterIRPChild Structure: ReconfigureActive (Property) ReconfigureAsync (Method) RegisterIRPChild (Method) SiblingIRP (Property)

IReconfigureProvider.ReconfigureActive (PROP) ¶ PROPERTY ReconfigureActive : BOOL This property is TRUE if reconfiguration is currently active.

IReconfigureProvider.ReconfigureAsync (METH) ¶ METHOD ReconfigureAsync : PROC_STATE Reconfigure reads the configuration of the corresponding node and applies it. Afterwards it calls ReconfigureAsync for all child IReconfigureProvider . After Reconfiguring, all changed configuration values (Enable flag, Parameter changes,…) take effect. If the node doesn’t support reconfiguring, method returns PROC_STATE.ERROR and eError contains ERROR.NOT_SUPPORTED . InOut: Scope Name Type Comment Return ReconfigureAsync PROC_STATE Input eCmd PROC_CMD EXECUTE to start operation. itfSender INode Originator of reconfiguration. 0 or current node if this is the first reconfiguration call. Output eError ERROR Error code

IReconfigureProvider.RegisterIRPChild (METH) ¶ METHOD RegisterIRPChild : ERROR This method is used by IReconfigureProvider children to register at their parent. InOut: Scope Name Type Comment Return RegisterIRPChild ERROR Input itfChild IReconfigureProvider child to be registered

IReconfigureProvider.SiblingIRP (PROP) ¶ PROPERTY SiblingIRP : IReconfigureProvider Gets and sets the next sibling IReconfigureProvider .