@CHIP-RTOS C Library - RTOS API

RTX_Get_TimeDate_us

Get system time and date with high resolution.

int RTX_Get_TimeDate_us ( TimeDateFineS far *td );

Parameters

td

Output parameter, pointer to TimeDateFineS type allocated by user and filled by this function.

Return Value

0: Location at td contains system date and time

Comments

This function requires around 185 microseconds execution time. The time mark read occurs within 18 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 rather long execution time this may not be a good idea.

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_Set_TimeDate_us        RTX_Get_System_Ticks        RTX_Get_RTI_Ticks
RTX_GetFineTick        RTX_GetTick_us        RTX_GetTickCount
RTX_Get_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