TCXO#
TCXO (Temperature Compensated Crystal Oscillator) 驱动 | sample:
src/application/samples/peripheral/tcxo/tcxo_demo.c
学习目标#
了解 WS53 TCXO 驱动提供的时间戳和阻塞延时能力
掌握 TCXO 初始化(
uapi_tcxo_init)、延时(uapi_tcxo_delay_ms/us)和时间戳获取(uapi_tcxo_get_ms/us)的用法能够使用延时前后的时间戳检查计数是否单调递增
基本概念#
本案例验证的能力#
TCXO 是 Temperature Compensated Crystal Oscillator(温度补偿晶体振荡器)的缩写。WS53 驱动向应用提供初始化、计数、毫秒/微秒时间戳和阻塞延时接口;本案例只验证这些接口的基本可用性。
flowchart LR
I[uapi_tcxo_init] --> C[TCXO 计数基准]
C --> M["<div style='width:180px'>uapi_tcxo_get_ms</div>"]
C --> U["<div style='width:180px'>uapi_tcxo_get_us</div>"]
C --> D["<div style='width:180px'>uapi_tcxo_delay_ms/us</div>"]
TCXO 时钟 vs SysTick 时钟#
对比项 |
TCXO API |
SysTick API |
|---|---|---|
时间戳接口 |
|
|
延时接口 |
|
|
本页面验证范围 |
TCXO 接口的计数递增和延时基本功能 |
不在本案例中验证 |
两组 API 的精度、时钟源和功耗差异需要结合 WS53 芯片资料和具体系统配置评估,不能只从 Sample 名称推断。
涉及 API#
API |
用途 |
头文件 |
|---|---|---|
|
初始化 TCXO 模块(启动计数) |
|
|
获取 TCXO 毫秒时间戳(uint64) |
|
|
获取 TCXO 微秒时间戳(uint64) |
|
|
基于 TCXO 计数的阻塞延时,单位毫秒 |
|
|
基于 TCXO 计数的阻塞延时,单位微秒 |
|
案例说明#
案例简介#
本 Sample 演示 TCXO 时钟的毫秒/微秒级延时与时间戳功能:
uapi_tcxo_init()初始化 TCXO在循环中执行毫秒级延时 1000ms 和微秒级延时 20000us,并在每轮开始时喂看门狗
每种延时前后分别调用
get_ms/get_us获取时间戳;源码以after > before作为接口正常的判定条件
功能规格#
规格项 |
说明 |
|---|---|
毫秒级测试 |
延时 1000ms( |
微秒级测试 |
延时 20000us( |
循环维护 |
每轮调用 |
时间戳类型 |
|
当前成功条件 |
|
案例流程#
sequenceDiagram
participant T as tcxo_task
participant X as TCXO 时钟
T->>X: uapi_tcxo_init (启动计数)
loop 持续执行
T->>T: uapi_watchdog_kick
T->>X: before = uapi_tcxo_get_ms
T->>X: uapi_tcxo_delay_ms(1000)
T->>X: after = uapi_tcxo_get_ms
T->>T: 打印 count_ms = after-before
T->>X: before = uapi_tcxo_get_us
T->>X: uapi_tcxo_delay_us(20000)
T->>X: after = uapi_tcxo_get_us
T->>T: 打印 count_us = after-before
end
案例操作指导#
编译:
fbb build ws53_liteos_app
烧录固件,串口观察输出:
tcxo delay 1000ms!后打印实际count_ms;只要延时后的时间戳大于延时前,就输出tcxo get ms work normall.tcxo delay 20000us!后打印实际count_us;只要延时后的时间戳大于延时前,就输出tcxo get us work normall.
程序持续循环输出测试结果
关键配置#
配置项 |
推荐值 |
说明 |
|---|---|---|
TCXO 初始化时机 |
使用计时 API 之前 |
|
延时参数 |
按接口定义和实际需求设置 |
极短延时会受到函数调用和中断等开销影响,误差需在目标系统实测 |
代码详解#
1. TCXO 初始化#
在使用本案例中的 TCXO 时间戳和延时接口前先调用 uapi_tcxo_init():
uapi_tcxo_init();
2. 毫秒级延时与时间戳检查#
记录延时前后的毫秒时间戳并打印差值。当前代码只检查后一个时间戳是否更大:
uint64_t count_before_get_ms;
uint64_t count_after_get_ms;
count_before_get_ms = uapi_tcxo_get_ms();
uapi_tcxo_delay_ms(TCXO_DELAY_MS); /* 阻塞 1000ms */
count_after_get_ms = uapi_tcxo_get_ms();
osal_printk("count_after_get_ms = %llu, count_before_get_ms = %llu\r\n",
count_after_get_ms, count_before_get_ms);
osal_printk("count_ms = %llu\r\n", count_after_get_ms - count_before_get_ms);
if (count_after_get_ms > count_before_get_ms) {
osal_printk("tcxo get ms work normall.\r\n");
}
3. 微秒级延时与时间戳检查#
记录延时前后的微秒时间戳并打印差值。当前代码同样只检查后一个时间戳是否更大:
uint64_t count_before_get_us;
uint64_t count_after_get_us;
count_before_get_us = uapi_tcxo_get_us();
uapi_tcxo_delay_us(TCXO_DELAY_US); /* 阻塞 20000us = 20ms */
count_after_get_us = uapi_tcxo_get_us();
osal_printk("count_after_get_us = %llu, count_before_get_us = %llu\r\n",
count_after_get_us, count_before_get_us);
osal_printk("count_us = %llu\r\n", count_after_get_us - count_before_get_us);
if (count_after_get_us > count_before_get_us) {
osal_printk("tcxo get us work normall.\r\n");
}