RTC_SetTimeAsync

C Specification

#include <nitro/rtc.h>

RTCResult RTC_SetTimeAsync( 
            const RTCTime*    time, 
            RTCCallback       callback, 
            void*             arg );

Arguments

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 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. To get the result from the processor, you must use the result argument. If this function fails, no operation is performed and no user callback function is called.

Caution

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.