RTC_SetTime

C Specification

#include <nitro/rtc.h>
RTCResult RTC_SetTime( const RTCTime* time );

Arguments

time Pointer to RTCTime containing time information to set.

Return Values

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

Description

This function writes time data to the real time clock. It sends time data to ARM7 and returns the process result once it is received. This is a synchronous version of RTC_SetTimeAsync.

Caution

Do not define parameter values of nonexistent times.
This function requires a PXI interrupt for synchronization. Do not call this function when PXI interrupts are prohibited.

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

See Also

RTC_SetTimeAsync, RTC_GetTime, RTC_GetTimeAsync, RTCResult, RTCTime

Revision History

03/08/2005 Standardized the Japanese term for "interrupt".
07/01/2004 Changed the description to standardize the time notation.
05/18/2004 Initial version

CONFIDENTIAL