RTC_SetDateTime

Syntax

#include <nitro/rtc.h>
RTCResult RTC_SetDateTime( const RTCDate* date , const RTCTime* time );

Arguments

date Pointer to the buffer storing date data.
time Pointer to the buffer storing time data.

Return Values

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

Description

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

Note

Do not define parameter values of nonexistent years, months, or days. However, you may specify a day of the week that does not match the actual calendar. This function requires a PXI interrupt for synchronization. This function requires a PXI interrupt for synchronization. It cannot be used in situations where PXI interrupts are prohibited.
Because applications cannot change the date, use this API only for debugging during development.

See Also

RTC_SetDateTimeAsync, RTC_GetDateTime, RTC_GetDateTimeAsync, RTCResult, RTCDate, RTCTime

Revision History

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


CONFIDENTIAL