时间

时间 的协作图:

宏定义
#define	XWTM_TC_PER_S   XWOSDL_SKD_TC_PER_S

函数
static xwtm_t	xwtm_now (void)
	XWOS API：获取当前CPU的系统时间点
static xwtm_t	xwtm_ft (xwtm_t dur)
	XWOS API：获取当前CPU的未来 系统时间 点
static xwtm_t	xwtm_nowts (void)
	XWOS API：获取当前CPU的系统时间戳
static xwtm_t	xwtm_fts (xwtm_t dur)
	XWOS API：获取当前CPU的未来 系统时间戳
static xwtk_t	xwtm_nowtc (void)
	XWOS API：获取当前CPU的系统滴答计数

详细描述

XWOS的 时间 以 xwtm_t 表示。系统滴答定时器中断的次数用 xwtk_t 表示。 参考 XWOS的时间类型 。

• xwtk_t 是一个无符号的64位整数。
• xwtm_t 是一个有符号的64位整数，单位为 纳秒 。

获取当前的系统时间

• 通过 xwtm_now() 可以获取当前CPU的系统时间点；
• 通过 xwtm_nowts() 可以获取当前CPU的系统时间戳；
• 通过 xwtm_nowtc() 获取当前CPU的系统滴答计数。

获取未来的系统时间

• 通过 xwtm_ft() 可以计算出CPU的未来系统时间点；
• 通过 xwtm_fts() 可以计算出CPU的未来系统时间戳。

宏定义说明

XWTM_TC_PER_S

#define XWTM_TC_PER_S   XWOSDL_SKD_TC_PER_S

每秒滴答定时器中断的次数

在文件 time.h 第 41 行定义.

函数说明

xwtm_ft()

static xwtm_t xwtm_ft ( xwtm_t  dur )

inlinestatic

XWOS API：获取当前CPU的未来 系统时间 点

参数

[in]

dur

从现在开始到未来的时间

返回

未来时间点

注解

• 上下文：线程、中断、中断底半部、空闲任务

未来系统时间点 = 当前系统时间点 + dur

在文件 time.h 第 72 行定义.

{
        xwtm_t from;
        xwtm_t to;
 
        from = xwtm_now();
        to = xwtm_add_safely(from, dur);
        return to;
}

函数调用图:

这是这个函数的调用关系图:

xwtm_fts()

static xwtm_t xwtm_fts ( xwtm_t  dur )

inlinestatic

XWOS API：获取当前CPU的未来 系统时间戳

参数

[in]

dur

从现在开始到未来的时间

返回

未来时间

注解

• 上下文：线程、中断、中断底半部、空闲任务

未来时间戳 = 当前时间时间戳 + dur

在文件 time.h 第 114 行定义.

{
        xwtm_t from;
        xwtm_t to;
 
        from = xwtm_nowts();
        to = xwtm_add_safely(from, dur);
        return to;
}

函数调用图:

xwtm_now()

static xwtm_t xwtm_now ( void  )

inlinestatic

XWOS API：获取当前CPU的系统时间点

返回

当前时间点

注解

• 上下文：线程、中断、中断底半部、空闲任务

XWOS中，每个CPU都有一个私有的滴答定时器，产生周期性的定时中断。 系统时间 在每次中断时都会增加一次。

系统时间 是每CPU私有变量。代码运行在哪个CPU，访问的就是哪个私有变量。

XWOS的系统时间 = 滴答时间定时器中断的次数 * 中断的周期（以纳秒为单位）

在文件 time.h 第 57 行定义.

{
        return xwosdl_skd_get_time_lc();
}

这是这个函数的调用关系图:

xwtm_nowtc()

static xwtk_t xwtm_nowtc ( void  )

inlinestatic

XWOS API：获取当前CPU的系统滴答计数

返回

滴答计数

注解

• 上下文：线程、中断、中断底半部、空闲任务

系统滴答计数 是每CPU私有变量。代码运行在哪个CPU，访问的就是哪个私有变量。

XWOS的系统滴答计数 = 滴答时间定时器中断的次数

在文件 time.h 第 135 行定义.

{
        return xwosdl_skd_get_tick_lc();
}

xwtm_nowts()

static xwtm_t xwtm_nowts ( void  )

inlinestatic

XWOS API：获取当前CPU的系统时间戳

返回

当前系统时间戳

注解

• 上下文：线程、中断、中断底半部、空闲任务

系统时间戳 类似于 系统时间 。但是 系统时间 只会在滴答定时器的 每次中断时才增加一次，两次中断之间不会发生变化。

通过获取滴答定时器的计数器的值，计算出上一次中断后经过了多少时间， 再累加到 系统时间 上，即为 系统时间戳 。

系统时间戳 是每CPU私有变量。代码运行在哪个CPU，访问的就是哪个私有变量。

XWOS的系统时间戳 = XWOS的系统时间 + 滴答定时器距离下一次中断还有多少时间

在文件 time.h 第 99 行定义.

{
        return xwosdl_skd_get_timestamp_lc();
}

这是这个函数的调用关系图: