rt-thread操作系统下timer使用

rt-thread 是通过 I/O 设备模型来管理 soc 上的外设，从上到下分为三层：I/O 设备管理层、设备驱动框架层和设备驱动层。stm32 的 HAL 库就属于设备驱动层，比如熟知的 i2c、spi 的外设驱动在用 cubemx 生成代码的时候就已经准备好。中科蓝讯的 ab32vg1 的设备驱动已经在sdk 中由蓝讯的工程师实现。而在设备驱动层之上的设备驱动框架层和设备 I/O 管理层要说明一下：设备驱动框架层提供了一些接口留给设备驱动开发者去实现，只在做驱动移植的时候需要，作为普通用户，只需要关心 I/O 管理层即可，rt-thread 的 I/O 管理层提供了类似于 linux中文件 IO 的 ap，常用的有 rt_device_find、rt_device_open、rt_device_read、rt_device_close等。下面列举了 hwtimer 的 api，结合示例去理解如何将这些 api 用起来实现定时器的功能。

//查找设备
/*
name：设备名称
*/
rt_device_t rt_device_find(const char* name)
//打开定时器设备
/*
dev：定时器设备句柄
oflags：打开模式，一般取 RT_DEVICE_OFLAG_RDWR
*/
rt_err_t rt_device_open(rt_device_t dev, rt_uint16_t oflags);
//设置超时回调
/*
dev：定时器设备句柄
rx_ind：超时回调函数
*/
rt_err_t rt_device_set_rx_indicate(rt_device_t dev, rt_err_t (*rx_ind)(rt_device_t dev,rt_size_t size))
//控制定时器
/*
dev：定时器设备句柄
cmd：控制命令，可取
HWTIMER_CTRL_FREQ_SET 设置计数频率
HWTIMER_CTRL_STOP 停止定时器
HWTIMER_CTRL_INFO_GET 获取定时器特征信息
HWTIMER_CTRL_MODE_SET 设置定时器模式
arg：控制命令参数
设置定时器模式时，可取
HWTIMER_MODE_ONESHOT 单 次 定 时
HWTIMER_MODE_PERIOD 周 期 性 定 时
*/
rt_err_t rt_device_control(rt_device_t dev, rt_uint8_t cmd, void* arg);
//设置定时器超时值
/*
dev：定时器设备句柄
pos：偏移值，未使用，可取 0 值
buffer：指向超时时间结构体
size：超时时间结构体大小
*/
rt_size_t rt_device_write(rt_device_t dev, 
rt_off_t pos, 
const void* buffer,
rt_size_t size);
//获取定时器当前值
/*
dev：定时器句柄
pos：偏移值，未使用，可取 0 值
buffer：超时时间结构体
size：超时时间结构体大小
*/
rt_size_t rt_device_read(rt_device_t dev, 
rt_off_t pos, 
void* buffer, 
rt_size_t size
);
//关闭定时器
/*
dev：定时器句柄
*/
rt_err_t rt_device_close(rt_device_t dev);

使用 rt-thread studio 进行 sdk 的开发是一件非常有效率的事情，新建 bsp 工程后只需要在rt-thread setting 配置需要的硬件功能就可以使用 rt-thread 提供的设备 I/O 管理接口对底层的 soc 的外设进行控制。从示例中可以定时器的流程：先用 rt_device_find 根据设备名称查找到定时器句柄、使用定时器句柄打开定时器、接着设置定时器的回调函数、配置完定时器后设置定时器的定时值后定时器启动，之后每当定时器的计数器溢出就会执行一次定时器的回调函数。

审核编辑：汤梓红