ChibiOS/RT 时间与定时器

ChibiOS/RT 提供了一套完整的时间管理机制，包括系统时钟、虚拟定时器、阶梯定时器和时间测量工具，是实现周期任务、超时检测和性能分析的基础。

系统时间#

系统时间是 ChibiOS/RT 中所有时间相关操作的基础。内核维护一个全局系统计数器，在每次系统滴答（tick）时递增。

核心类型#

1
/* 系统时间戳，64位无符号整数，单位为 tick */
2
typedef uint64_t systime_t;
3

4
/* 系统时间间隔，32位无符号整数，用于表示相对时间 */
5
typedef uint32_t sysinterval_t;

systime_t 是绝对时间戳，从系统启动开始单调递增；sysinterval_t 表示相对时间间隔，两者用途不同，不可混用。

获取系统时间#

1
/* 获取当前系统时间（32位截断，适合短间隔测量） */
2
systime_t chSysGetRealtimeCounterX(void);
3

4
/* 获取系统滴答计数 */
5
systime_t chVTGetSystemTimeX(void);
6

7
/* 获取系统频率（ticks/秒） */
8
sysinterval_t chVTGetSystemFrequencyX(void);

线程休眠#

1
/* 休眠指定 tick 数 */
2
void chThdSleep(sysinterval_t interval);
3

4
/* 休眠到指定系统时间点 */
5
void chThdSleepUntil(systime_t time);
6

7
/* 示例：每 100ms 周期执行 */
8
static THD_WORKING_AREA(waWorker, 128);
9
static THD_FUNCTION(WorkerThread, arg) {
10
    (void)arg;
11
    systime_t prev = chVTGetSystemTimeX();
12

13
    while (!chThdShouldTerminateX()) {
14
        /* 执行周期任务 */
15
        do_periodic_work();
16

17
        /* 精确周期休眠，补偿任务执行耗时 */
18
        chThdSleepUntil(chTimeAddX(prev, TIME_MS2I(100)));
19
        prev = chVTGetSystemTimeX();
20
    }
21
}

chThdSleepUntil 相比 chThdSleep 的优势在于：它基于绝对时间点休眠，不会因为任务执行耗时而产生累积漂移，适合对时序精度要求高的场景。

虚拟定时器#

虚拟定时器是 ChibiOS/RT 最常用的时间管理机制，用于在指定时间后执行回调函数。

数据结构#

1
typedef struct {
2
    virtual_timer_t * volatile next;   /* 链表指针 */
3
    systime_t                  deadline; /* 触发时间点 */
4
    vtfunc_t                   callback; /* 回调函数 */
5
    void *                     par;      /* 回调参数 */
6
} virtual_timer_t;

基本操作#

1
/* 启动定时器，interval 后触发回调 */
2
void chVTSet(virtual_timer_t *vtp, sysinterval_t interval,
3
             vtfunc_t fn, void *par);
4

5
/* 重置定时器（取消 + 重新启动） */
6
void chVTReset(virtual_timer_t *vtp);
7

8
/* 检查定时器是否已启动（中断上下文） */
9
bool chVTIsArmedX(const virtual_timer_t *vtp);

单次定时器示例#

1
static virtual_timer_t led_timer;
2

3
/* LED 闪烁回调 */
4
static void led_blink_cb(void *par) {
5
    (void)par;
6
    palTogglePad(GPIOC, GPIOC_LED);
7

8
    /* 重新启动定时器，实现周期效果 */
9
    chVTSet(&led_timer, TIME_MS2I(500), led_blink_cb, NULL);
10
}
11

12
/* 启动 LED 闪烁 */
13
static void start_led_blink(void) {
14
    chVTSet(&led_timer, TIME_MS2I(500), led_blink_cb, NULL);
15
}

周期定时器#

ChibiOS/RT 的虚拟定时器本质上是单次触发的。要实现周期定时器，在回调中重新设置即可：

1
static virtual_timer_t periodic_timer;
2

3
static void periodic_cb(void *par) {
4
    uint32_t *count = (uint32_t *)par;
5
    (*count)++;
6

7
    do_periodic_task(*count);
8

9
    /* 重新启动定时器 */
10
    chVTSet(&periodic_timer, TIME_S2I(1), periodic_cb, par);
11
}
12

13
static uint32_t tick_count = 0;
14

15
static void start_periodic_timer(void) {
16
    chVTSet(&periodic_timer, TIME_S2I(1), periodic_cb, &tick_count);
17
}

注意事项#

虚拟定时器回调在中断上下文（系统 tick 中断）中执行，回调函数应尽量简短，避免阻塞操作。
定时器回调中不能调用任何会导致线程切换的 API。
定时器精度受限于系统 tick 频率，对于亚毫秒级精度需求应使用硬件定时器。

时间窗口#

时间窗口机制用于验证某个时间点是否落在指定的时间间隔内，常用于通信超时检测和周期任务调度。

时间间隔表示#

1
/* 时间间隔结构 */
2
typedef struct {
3
    sysinterval_t start;    /* 窗口起始点 */
4
    sysinterval_t end;      /* 窗口结束点 */
5
} time_window_t;
6

7
/* 无效时间窗口（已过期） */
8
#define TIME_WINDOW_NONE   ((sysinterval_t)0)

窗口检查#

1
/* 检查时间是否在窗口内 */
2
static inline bool chTimeIsInWindowX(sysinterval_t time,
3
                                     sysinterval_t start,
4
                                     sysinterval_t end) {
5
    return (time >= start) && (time < end);
6
}
7

8
/* 示例：超时检测 */
9
#define TIMEOUT_MS  TIME_MS2I(5000)  /* 5秒超时 */
10

11
static bool wait_with_timeout(virtual_timer_t *vt) {
12
    systime_t start = chVTGetSystemTimeX();
13
    systime_t deadline = chTimeAddX(start, TIMEOUT_MS);
14

15
    chVTSet(vt, TIMEOUT_MS, timeout_cb, NULL);
16

17
    /* 等待事件 */
18
    eventmask_t evt = chEvtWaitAnyTimeout(ALL_EVENTS, TIMEOUT_MS);
19

20
    if (evt == 0) {
21
        return false;  /* 超时 */
22
    }
23
    return true;  /* 收到事件 */
24
}

阶梯定时器#

阶梯定时器（Step Timer）提供一种轻量级的时间步进机制，适用于需要在固定时间间隔执行多个任务的场景，比虚拟定时器更节省资源。

数据结构与操作#

1
typedef struct {
2
    systime_t          next;        /* 下一步时间点 */
3
    sysinterval_t     step;        /* 步进间隔 */
4
    stfunc_t          callback;    /* 回调函数 */
5
    void *            par;         /* 回调参数 */
6
} step_timer_t;
7

8
/* 初始化阶梯定时器 */
9
void chSTimerSetup(step_timer_t *stp, sysinterval_t step,
10
                   stfunc_t fn, void *par);
11

12
/* 驱动阶梯定时器（在 tick 中断或主循环中调用） */
13
void chSTimerTick(step_timer_t *stp);

阶梯定时器示例#

1
static step_timer_t heartbeat_timer;
2

3
/* 心跳回调 */
4
static void heartbeat_cb(void *par) {
5
    (void)par;
6
    palTogglePad(GPIOB, GPIOB_HEARTBEAT);
7
}
8

9
/* 初始化并启动 */
10
static void heartbeat_init(void) {
11
    chSTimerSetup(&heartbeat_timer, TIME_MS2I(250),
12
                  heartbeat_cb, NULL);
13
}
14

15
/* 在主循环或周期任务中驱动 */
16
static THD_FUNCTION(HeartbeatThread, arg) {
17
    (void)arg;
18

19
    heartbeat_init();
20

21
    while (!chThdShouldTerminateX()) {
22
        chSTimerTick(&heartbeat_timer);
23
        chThdSleep(TIME_MS2I(50));
24
    }
25
}

阶梯定时器与虚拟定时器的区别：阶梯定时器需要显式调用 chSTimerTick 来驱动，适合在已有的周期任务中复用；虚拟定时器由内核自动驱动，适合独立的定时需求。

时间测量#

ChibiOS/RT 提供时间测量工具，用于精确测量代码段的执行时间，是性能分析和调试的重要手段。

数据结构#

1
typedef struct {
2
    systime_t   start;    /* 测量起始时间 */
3
    systime_t   end;      /* 测量结束时间 */
4
    systime_t   best;     /* 最短执行时间 */
5
    systime_t   worst;    /* 最长执行时间 */
6
    uint32_t    n;        /* 测量次数 */
7
} time_measurement_t;

测量操作#

1
/* 初始化测量对象 */
2
void chTMInitTimeMeasurementX(time_measurement_t *tmp);
3

4
/* 开始测量 */
5
void chTMStart(time_measurement_t *tmp);
6

7
/* 停止测量并更新统计 */
8
void chTMStop(time_measurement_t *tmp);
9

10
/* 获取测量结果（tick 数） */
11
systime_t chTMGetElapsedX(const time_measurement_t *tmp);

性能分析示例#

1
static time_measurement_t meas;
2

3
/* 测量中断服务程序执行时间 */
4
void irq_handler(void) {
5
    chTMStart(&meas);
6

7
    /* 执行 ISR 逻辑 */
8
    process_interrupt();
9

10
    chTMStop(&meas);
11
}
12

13
/* 定期打印测量结果 */
14
static THD_FUNCTION(MonitorThread, arg) {
15
    (void)arg;
16
    chTMInitTimeMeasurementX(&meas);
17

18
    while (!chThdShouldTerminateX()) {
19
        chThdSleep(TIME_S2I(5));
20

21
        /* 打印统计信息 */
22
        uart_printf("n=%lu, best=%lu, worst=%lu\r\n",
23
                    meas.n,
24
                    meas.best,
25
                    meas.worst);
26
    }
27
}

时间测量会自动记录最小值和最大值，便于发现最坏情况下的执行时间，对实时系统的响应时间分析非常有价值。

总结#

ChibiOS/RT 的时间管理机制层次分明：

机制	用途	精度	适用场景
系统时间	获取当前时间	tick 级	基础时间参考
虚拟定时器	延时回调	tick 级	超时、周期任务
阶梯定时器	步进式定时	调用精度	复用周期任务
时间窗口	间隔验证	tick 级	通信检测
时间测量	性能分析	tick 级	调试优化

合理选择时间管理机制，是编写高效、精确嵌入式程序的关键。在实际项目中，通常需要组合使用多种机制来满足不同的时间管理需求。

JJZBQA

系统时间#

核心类型#

获取系统时间#

线程休眠#

虚拟定时器#

数据结构#

基本操作#

单次定时器示例#

周期定时器#

注意事项#

时间窗口#

时间间隔表示#

窗口检查#

阶梯定时器#

数据结构与操作#

阶梯定时器示例#

时间测量#

数据结构#

测量操作#

性能分析示例#

总结#