RTC_SetTimeAsync


C Specification

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

Description

This function asynchronously writes time data to the real time clock. It sends 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.

Cautions

Do not define parameter values of nonexistent times. Values are set to the RTC as specified by the time argument asynchronously. Do not use this variable for anything else until a user callback function confirms the completion of this asynchronous operation.

Because applications cannot change the date, use this API only for debugging during development.

Arguments

time Target variable for the stored time information.
callback Pointer to specific RTCCallback function to be used.
arg The argument to be passed 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.

See Also

RTC_SetTime, RTC_GetTime, RTC_GetTimeAsync, RTCResult, RTCTime, RTCCallback

Revision History

07/01/2004 Changed the description due to standardize the time notation.
05/18/2004 Initial Version