IEC 61131-3 C Tools User Manual

IEC 61131-3 C Tools Function Specifications

installRTCHandler

Install User Defined Real-Time-Clock Handler

Syntax

#include <ctools.h> void installRTCHandler( void (* rtchandler)(TIME *now,

TIME *new)

);

Description

The installRTCHandler function allows an application program to override

Modbus protocol and DNP protocol commands to set the real time clock. This function specifies a function to be called when a Modbus or DNP message is received for the station. The installed handler function is called only if the message is for setting the real time clock.

The function has one parameter: a pointer to a function to handle the messages.

See the section RTCHandler Function for a description of the function and its parameters. If the pointer is NULL, no function is called for set the real time clock commands, and the default method is used set the real time clock.

The function has no return value.

Notes

Call this function with the NULL pointer to disable processing of Set Real Time

Clock messages. This needs to be done when the application program is ended with an exit handler. Use the installExitHandler function to install the exit handler.

If the RTC handler is not disabled within an exit handler, it will remain installed and continue to operate until the controller power is cycled. Changing the protocol type or Erasing the C Program from the Telepace Initialize dialog will not remove the handler. If the handler is located in a RAM-based application and left enabled while a different C application is downloaded, the original handler will be corrupted.

See Also

RTCHandler Function, installExitHandler

Document (Version 2.50) 5/12/2011 254 254