RTC_SetDateTimeAsync

C Specification

#include <nitro/rtc.h>
RTCResult RTC_SetDateTimeAsync( 
const RTCDate*    date, 
const RTCTime*    time, 
RTCCallback		callback, 
void*            arg ); 

Arguments

date Pointer to the buffer storing date data.
time Pointer to the buffer storing time data.
callback Pointer to the callback function. This callback is called from within the interrupt handler.
arg Argument to pass to the callback function.

Return Values

If the request succeeds, it returns 0. If the request fails, it returns some numeric value other than 0.

Description

This function asynchronously writes date and time data to the real time clock. It sends date and time data to ARM7 and returns the process result without waiting for a response from the processor.  If this function fails, no operation is performed and no user callback function is called.

Caution

Do not define parameter values of nonexistent dates or times. However, you may specify a day of the week that does not match the actual calendar. This function requires a PXI interrupt for synchronization. Values are written to the variables specified by the date and time arguments asynchronously with respect to the function.Because applications cannot change the date, use this API only for debugging during development.

See Also

RTC_SetDateTime, RTC_GetDateTime, RTC_GetDateTimeAsync, RTCResult, RTCDate, RTCTime, RTCCallback

Revision History

06/27/2005 Added additional text indicating that callback is called from interrupt handler
07/01/2004 Updated description due to unification of time representation
05/18/2004 Initial version