RT-Thread设备框架使用指南之二——硬件定时器设备

定时器简介

硬件定时器一般有 2 种工作模式，定时器模式和计数器模式。不管是工作在哪一种模式，实质都是通过内部计数器模块对脉冲信号进行计数。下面是定时器的一些重要概念。

计数器模式：对外部输入引脚的外部脉冲信号计数。

定时器模式：对内部脉冲信号计数。定时器常用作定时时钟，以实现定时检测，定时响应、定时控制。

计数器：计数器可以递增计数或者递减计数。16位计数器的最大计数值为65535，32位的最大值为4294967295。

计数频率：定时器模式时，计数器单位时间内的计数次数，由于系统时钟频率是定值，所以可以根据计数器的计数值计算出定时时间，定时时间 = 计数值 / 计数频率。例如计数频率为 1MHz，计数器计数一次的时间则为 1 / 1000000， 也就是每经过 1 微秒计数器加一（或减一），此时 16 位计数器的最大定时能力为 65535 微秒，即 65.535 毫秒。

访问硬件定时器设备

应用程序通过 RT-Thread 提供的 I/O 设备管理接口来访问硬件定时器设备，相关接口如下所示：

函数原型	功能简介
rt_device_find()	查找定时器设备
rt_device_open()	以读写方式打开定时器设备
rt_device_set_rx_indicate()	设置超时回调函数
rt_device_control()	控制定时器设备，可以设置定时模式（单次/周期）/计数频率，或者停止定时器
rt_device_write()	设置定时器超时值，定时器随即启动
rt_device_read()	获取定时器当前值
rt_device_close()	关闭定时器设备

查找定时器设备

应用程序根据硬件定时器设备名称获取设备句柄，进而可以操作硬件定时器设备，查找设备函数如下所示:

1rt_device_t rt_device_find(const char* name);

参数	描述
name	硬件定时器设备名称
返回	——
定时器设备句柄	查找到对应设备将返回相应的设备句柄
RT_NULL	没有找到设备

一般情况下，注册到系统的硬件定时器设备名称为 timer0，timer1等，使用示例如下所示：

1#define HWTIMER_DEV_NAME   "timer0"     /* 定时器名称 */
2rt_device_t hw_dev;                        /* 定时器设备句柄 */   
3/* 查找定时器设备 */
4hw_dev = rt_device_find(HWTIMER_DEV_NAME);

打开定时器设备

通过设备句柄，应用程序可以打开设备。打开设备时，会检测设备是否已经初始化，没有初始化则会默认调用初始化接口初始化设备。通过如下函数打开设备:

1rt_err_t rt_device_open(rt_device_t dev, rt_uint16_t oflags);

参数	描述
dev	硬件定时器设备句柄
oflags	设备打开模式，一般以读写方式打开，即取值：RT_DEVICE_OFLAG_RDWR
返回	——
RT_EOK	设备打开成功
其他错误码	设备打开失败