RTC 软件定时器#
RTC (Real-Time Clock) 驱动 | sample:
src/application/samples/peripheral/rtc/rtc_demo.c
学习目标#
使用
uapi_rtc_init()初始化 RTC 驱动使用
uapi_rtc_adapter()适配 RTC 硬件通道和中断使用
uapi_rtc_create()创建多个 RTC 软件定时器使用
uapi_rtc_start()启动一次性定时并接收超时回调使用
uapi_rtc_stop()、uapi_rtc_delete()和uapi_rtc_deinit()管理资源
基本概念#
RTC 硬件与软件定时器#
RTC 提供低功耗、长时间运行的硬件计时能力。驱动在指定 RTC 硬件通道之上创建软件定时器句柄,使多个一次性定时任务可以复用同一硬件计时资源。
flowchart LR
T1[软件定时器 1<br/>1000ms] --> R[RTC 硬件通道]
T2[软件定时器 2<br/>2000ms] --> R
T3[软件定时器 3<br/>3000ms] --> R
T4[软件定时器 4<br/>4000ms] --> R
R --> I[RTC 中断]
I --> C[超时回调]
回调上下文#
RTC 超时回调运行在中断上下文中,应只执行记录时间、更新标志等短操作,不能阻塞或进行复杂处理。本案例在回调中记录 TCXO 时间戳并增加完成计数,日志输出和资源回收由任务完成。
涉及 API#
API |
用途 |
头文件 |
|---|---|---|
|
初始化 RTC 驱动 |
|
|
适配 RTC 通道、中断号和优先级 |
|
|
创建 RTC 软件定时器并返回句柄 |
|
|
启动一次性定时器 |
|
|
停止 RTC 软件定时器 |
|
|
删除 RTC 软件定时器 |
|
|
去初始化 RTC 驱动 |
|
案例说明#
案例简介#
案例初始化并适配 RTC0,然后创建 4 个软件定时器,超时时间依次为 1000ms、2000ms、3000ms 和 4000ms。所有回调执行完成后,任务停止并删除定时器,打印每个定时器的实际耗时。
功能规格#
规格项 |
说明 |
|---|---|
RTC 通道 |
|
中断号 |
|
中断优先级 |
|
软件定时器数量 |
4 |
超时时间 |
1000ms、2000ms、3000ms、4000ms |
时间测量 |
使用 |
案例流程#
flowchart TD
A["<div style='width: 220px;'>uapi_rtc_deinit</div>"] --> B["<div style='width: 220px;'>uapi_rtc_init</div>"]
B --> C["<div style='width: 220px;'>uapi_rtc_adapter</div>"]
C --> D["<div style='width: 220px;'>创建 4 个软件定时器</div>"]
D --> E["<div style='width: 220px;'>记录开始时间并分别启动</div>"]
E --> F["<div style='width: 220px;'>RTC 中断回调记录结束时间</div>"]
F --> G{4 个回调全部完成?}
G -->|否| F
G -->|是| H["<div style='width: 220px;'>停止并删除 4 个定时器</div>"]
H --> I["<div style='width: 220px;'>打印实际耗时</div>"]
案例操作指导#
第一步:配置案例#
启用 ENABLE_PERIPHERAL_SAMPLE 和 SAMPLE_SUPPORT_RTC。一般保持 RTC_INDEX=0、RTC_IRQN=49 和 RTC_PRIO=1;只有在板级中断分配发生变化时才修改。
第二步:编译和烧录#
fbb build ws53_liteos_app
fbb flash ws53_liteos_app
第三步:验证#
4 个定时器全部到期后,串口输出类似:
real time[0] = 1000ms delay = 1000ms
real time[1] = 2000ms delay = 2000ms
real time[2] = 3000ms delay = 3000ms
real time[3] = 4000ms delay = 4000ms
实际时间可能有少量调度和中断延迟,但应接近配置值,并保持超时顺序一致。
关键配置#
配置项 |
默认值 |
说明 |
|---|---|---|
|
0 |
RTC 硬件通道编号 |
|
49 |
RTC 中断号 |
|
1 |
RTC 中断优先级 |
|
4 |
同时创建的软件定时器数量 |
|
1000 |
第一个定时器超时值 |
|
2000 |
第二个定时器超时值 |
|
3000 |
第三个定时器超时值 |
|
4000 |
第四个定时器超时值 |
代码详解#
1. 超时回调#
回调参数携带软件定时器序号,用于将结束时间写入对应记录:
static void rtc_timeout_callback(uintptr_t data)
{
uint32_t rtc_index = (uint32_t)data;
g_rtcs_info[rtc_index].end_time = uapi_tcxo_get_ms();
g_rtc_int_count++;
}
2. 初始化并启动多个定时器#
rtc_handle_t rtc_index[RTC_TIMERS_NUM] = { 0 };
uapi_rtc_deinit();
uapi_rtc_init();
uapi_rtc_adapter(CONFIG_RTC_INDEX, CONFIG_RTC_IRQN, CONFIG_RTC_PRIO);
for (uint32_t i = 0; i < RTC_TIMERS_NUM; i++) {
uapi_rtc_create(CONFIG_RTC_INDEX, &rtc_index[i]);
g_rtcs_info[i].start_time = uapi_tcxo_get_ms();
uapi_rtc_start(rtc_index[i], g_rtcs_info[i].delay_time,
rtc_timeout_callback, i);
}
3. 等待完成并释放资源#
while (g_rtc_int_count < RTC_TIMERS_NUM) {
osal_msleep(1);
}
for (uint32_t i = 0; i < RTC_TIMERS_NUM; i++) {
uapi_rtc_stop(rtc_index[i]);
uapi_rtc_delete(rtc_index[i]);
osal_printk("real time[%d] = %dms delay = %dms\r\n", i,
g_rtcs_info[i].end_time - g_rtcs_info[i].start_time,
g_rtcs_info[i].delay_time);
}
当前 Sample 在开始时调用一次 uapi_rtc_deinit() 清理已有状态,但结束前没有再次反初始化。源码没有说明省略结束反初始化的原因;应用在确认所有句柄已删除且不再使用 RTC 后,可以按自身资源生命周期调用 uapi_rtc_deinit()。