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 .

IStack (ITF) ¶ INTERFACE IStack EXTENDS IDevice Interface for a communicaton stack. Properties: ChildNodeCount , inherited from INode Enable , inherited from INode FirstChildNode , inherited from INode IsRootNode , inherited from INode NextSiblingNode , inherited from INode ParentNode , inherited from INode SiblingNodeCount , inherited from INode Methods: GetBusScanAsync GetLogger GetDeviceDiagnosisInfo , inherited from IDevice GetDeviceErrorAsync , inherited from IDevice GetDeviceInfo , inherited from IDevice GetDeviceState , inherited from IDevice GetSpecificDeviceErrorAsync , inherited from IDevice GetSpecificDeviceState , inherited from IDevice SetCommunicationState , inherited from IDevice Structure: GetBusScanAsync (Method) GetLogger (Method)