IEC 61131-3 C Tools User Manual

IEC 61131-3 C Tools Function Specifications

resetClockAlarm

Acknowledge and Reset Real Time Clock Alarm

Syntax

#include <ctools.h> void resetClockAlarm(void);

Description

Real time clock alarms occur once after being set. The alarm setting remains in the real time clock. The alarm must be acknowledged before it can occur again.

The resetClockAlarm function acknowledges the last real time clock alarm and re-enables the alarm. Calling the function after waking up from an alarm will reset the alarm for 24 hours after the current alarm.

Notes

This function should be called after a real time clock alarm occurs. This includes after returning from the sleep function with a return code of

WS_REAL_TIME_CLOCK.

The alarm time is not changed by this function.

The IO_SYSTEM resource needs to be requested before calling this function.

See Also

setClockAlarm, getClockAlarm, alarmIn

Example

See the example for the installClockHandler function.

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