@CHIP-RTOS C Library - RTOS API

RTX_Set_TimeDate_us

Set system time and date with high resolution.

int RTX_Set_TimeDate_us ( const TimeDateFineS far *td );

Parameters

td

Input parameter, pointer to TimeDateFineS type containing time/date information set by user.

Return Value

0:

Comments

The Day Of Week field (.dow ) in TimeDateFineS need not be set by caller.   This API function computes this field based on the other member data.

The microsecond resolution exceeds the accuracy with which this API can actually set the time and date due to the speed of the software. This function requires around 280 microseconds execution time. The time mark to which the specified time and date are assigned is read within 20 microseconds of the time at which this API was called, assuming that no interrupts were serviced in the meantime.

This API may be called from within any form of Interrupt Service routine, although due to its long execution time this may not be appropriate for your particular application.

Inside this API the interrupts are masked for short periods of time and then restored to the their masking state on entry.

See Also

RTX_Get_TimeDate_us        RTX_Get_System_Ticks        RTX_Get_RTI_Ticks
RTX_GetFineTick        RTX_GetTick_us        RTX_GetTickCount
RTX_Set_TimeDate                

RTOS API

This library function invokes a RTOS software interrupt to install a dynamic link into the RTOS. Refer to this RTOS API function's documentation for more details.

Related Topics

RTX API   Overview

Supported since or modified in @CHIP-RTOS version

SC12	SC13	SC11	SC1x3	SC2x
n/a	n/a	n/a	V1.35	V1.35