Periodic Or One-Shot Stopwatch Event; Once Only Alarm Event; Each Day Alarm Event - Analog Devices VisualDSP++ 5.0 Service Manual

Periodic or One-Shot Stopwatch Event

The application may set up a stopwatch event to interrupt when a specified
time duration has elapsed. The same stopwatch event can be either peri-
odic or one shot. The event becomes enabled when the application passes
the argument
ADI_RTC_EVENT_STOPWATCH
adi_rtc_InstallCallback()
of the stopwatch time duration. The stopwatch event occurs only once by
default, as a "one-shot" stopwatch event. The callback function may then
either disable the event by passing the argument
ADI_RTC_EVENT_STOPWATCH
it may re-enable the stopwatch event by calling the API function
adi_rtc_ResetStopwatch()
odic event.

Once Only Alarm Event

The application may enable an alarm event that interrupts once on a given
day at a specific time. This interrupting event becomes enabled when the
application passes the argument
adi_rtc_InstallCallback()
ing the date and time of the alarm. After the alarm event occurs, the
callback may be removed by passing the argument
ADI_RTC_EVENT_ONCE_ALM
Then, another such event can be scheduled by installing the callback
again. After this event has been scheduled, and before it occurs, it may be
canceled by removing the callback.

Each Day Alarm Event

The application may enable an alarm that interrupts at a specific time each
day as long as the alarm is enabled. This interrupting event becomes
enabled when the application passes the argument
ADI_RTC_EVENT_EACH_DAY_ALM
tion, also passing a
VisualDSP++ 5.0 Device Drivers and System
Services Manual for Blackfin Processors
function, also passing the number of seconds
to the
adi_rtc_RemoveCallback()
. If re-enabled, the stopwatch becomes a peri-
ADI_RTC_EVENT_ONCE_ALM
function, also passing a
to the
adi_rtc_RemoveCallback()
to the
adi_rtc_InstallCallback()
structure containing the time of day that the alarm
tm
Real-Time Clock Service
to the
to the
structure contain-
tm
function, or
function.
func-
11-7