#include <nitro/rtc.h>
RTCResult RTC_SetDateAsync(
const RTCDate* date,
RTCCallback callback,
void* arg );
date |
Pointer to the buffer storing date data. |
callback |
Pointer to the callback function. This callback is called from within the interrupt handler. |
arg |
Argument to pass to the callback function. |
If the request succeeds, it returns 0. If the request fails, it returns some numeric value other than 0.
This function asynchronously writes date data to the real time clock. It sends date 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.
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. Values are written to the variable specified by the date
argument asynchronously with respect to the function. 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.
RTC_SetDate, RTC_GetDate, RTC_GetDateAsync, RTCResult, RTCDate, RTCCallback
06/27/2005 Added additional text indicating that the callback is called from the interrupt handler.
05/18/2004 Initial version