添加说明文档

This commit is contained in:
heyuanjie87 2015-09-07 13:27:05 +08:00
parent f8012b9000
commit efc1b058ac
1 changed files with 101 additions and 0 deletions

View File

@ -0,0 +1,101 @@
定时器设备
===
##功能
---
* 时间测量
* 周期或单次执行回调函数
##编译
---
1. 在rtconfig.h添加 `#define RT_USING_HWTIMER`
##使用流程
---
1. 以读写方式打开设备
2. 设置超时回调函数(如果需要)
3. 根据需要设置定时模式(单次/周期)
4. 设置计数频率(可选)
5. 写入超时值,定时器随即启动
6. 停止定时器(可选)
7. 关闭设备(如果需要)
应用参考 [hwtimer_test] (/examples/test/hwtimer\_test.c)
##驱动编写指南
---
###操作接口
```
struct rt_hwtimer_ops
{
void (*init)(struct rt_hwtimer_device *timer, rt_uint32_t state);
rt_err_t (*start)(struct rt_hwtimer_device *timer, rt_uint32_t cnt, rt_hwtimer_mode_t mode);
void (*stop)(struct rt_hwtimer_device *timer);
rt_uint32_t (*count_get)(struct rt_hwtimer_device *timer);
rt_err_t (*control)(struct rt_hwtimer_device *timer, rt_uint32_t cmd, void *args);
};
```
* init - state <1 打开设备 0 关闭设备>
* start - cnt <超时值> - mode <单次/周期>
* stop - <停止计数>
* count_get - <读取计数器值>
* control - <设置计数频率 >
###定时器特征信息
```
struct rt_hwtimer_info
{
rt_int32_t maxfreq;
rt_int32_t minfreq;
rt_uint32_t maxcnt;
rt_uint8_t cntmode;
};
```
* maxfreq <设备支持的最大计数频率>
* minfreq <设备支持的最小计数频率>
* maxcnt <计数器最大计数值>
* cntmode <递增计数/递减计数>
###注册设备
```
static rt_hwtimer_t _timer0;
int stm32_hwtimer_init(void)
{
_timer0.info = &_info;
_timer0.ops = &_ops;
rt_device_hwtimer_register(&_timer0, "timer0", TIM2);
return 0;
}
```
###定时器中断
```
void timer_irq_handler(void)
{
//其它操作
rt_device_hwtimer_isr(&_timer0);
}
```
##注意事项
---
<font color="#FF0000">可能出现定时误差</font>
误差原因:
假设计数器最大值0xFFFF计数频率1Mhz定时时间1秒又1微秒。
由于定时器一次最多只能计时到65535us对于1000001us的定时要求
就需分15次完成。误差时间: 1000001 - (65535*15) = 16976us。
这个误差太大,为了减小误差最理想的情况就是整除。实际中不可能
所有数都被整除(1不合适),所以就只有最大限度逼近理想情况。例如
上式中以 50000us定时20次即可将误差减小到1us(理论值,忽略指令时间)