ucos(八)软件定时器

一、概述

　　内核提供了一个模拟定时器的机制，类似于任务，但是占用资源少，只能做一些简单的定时控制，如可以定时的喂狗、控灯。在软件定时器，不能添加时间管理函数、阻塞等待函数（等待互斥锁/信号量/事件标志组/消息队列）。

1.创建软件定时器

?

1	void OSTmrCreate (OS_TMR *p_tmr, CPU_CHAR *p_name, OS_TICK dly, OS_TICK period, OS_OPT opt, OS_TMR_CALLBACK_PTR p_callback, void *p_callback_arg, OS_ERR *p_err)

 

参数：

• p_tmr：软件定时器对象

• p_name：软件定时器的名字

• dly：启动定时器后，延迟多长时间执行，默认隐含dly*10ms

• period：定时周期，默认隐含period*10ms

• opt：

　　　　OS_OPT_TMR_ONE_SHOT，软件定时器执行一遍

　　　　OS_OPT_TMR_PERIODIC，软件定时器周期性执行

 

• p_callback：软件定时器执行的回调函数    void MyCallback (OS_TMR *p_tmr, void *p_arg);

• p_callback_arg：传递参数给软件定时器的回调函数

• p_err：返回错误码，没有错误的就返回OS_ERR_NONE

 

• 单次触发

　　调用OSTmrCreate创建软件定时器，经过dly个节拍后，才真正启动软件定时器，即调用 OSTmrSrart()。定时器会递减被设置初始的定时值，当该值为 0 时就会调用回调函数并停止定时器，直到 OSTmrStart()被重新开启。通过调用 OSTmrStop()停止定时器。

 

• 重复单次触发

　　在定时值为 0 之前调用 OSTmrStart()后一次性定时器被再次触发。这个特性可以被用来模拟看门狗的功能。即OSTmrStart()为刷新计数值即喂狗，一旦计数值减到0，则触发调用软件定时器的回调函数，就可以知道负责刷新计数值的任务即定时调用OSTmrStart()的任务是否可靠执行。

 

• 周期性执行

 

定时器可以被设置为有初始定延周期模式。第一周期的递减值由 OSTmrCreate()中的参数"dly"设置，以后的重载值由"period"值确定。调用 OSTmrStart()重新开始。

 

2.启动软件定时器

 

?

1	CPU_BOOLEAN OSTmrStart (OS_TMR *p_tmr, OS_ERR *p_err)

 

参数：

• p_tmr：软件定时器对象
• p_err：返回错误码，没有错误的就返回OS_ERR_NONE

 

返回值：

• DEF_TRUE is the timer was started
• DEF_FALSE if not or upon an error

 

3.停止软件定时器

?

1	CPU_BOOLEAN OSTmrStop (OS_TMR *p_tmr, OS_OPT opt, void *p_callback_arg, OS_ERR *p_err)

参数：

• p_tmr：软件定时器对象
• os_opt：默认参数，OS_OPT_TMR_NONE
• p_callback_arg：填写OSTmrCreate创建时传递给软件定时器arg的参数
• p_err：返回错误码，没有错误的就返回OS_ERR_NONE

 

返回值：

• DEF_TRUE is the timer was started
• DEF_FALSE if not or upon an error

4.删除软件定时器

?

1	CPU_BOOLEAN OSTmrDel (OS_TMR *p_tmr, OS_ERR *p_err)

参数：

• p_tmr：软件定时器对象
• p_err:返回错误码，没有错误的就返回OS_ERR_NONE

 

返回值：

• DEF_TRUE is the timer was started
• DEF_FALSE if not or upon an error

二、示例

1、创建1个软件定时器。

?

1	OS_TMR g_tmr; void mytimer_Callback (OS_TMR *p_tmr, void *p_arg) { printf("mytimer_Callback\r\n"); } OSTmrCreate(&g_tmr,"g_tmr",0,100,OS_OPT_TMR_PERIODIC,(OS_TMR_CALLBACK_PTR)mytimer_Callback,NULL,&err);

2、创建2个软件定时器。

 

?

1 2 3 4 5 6 7 8 9 10 11 12 13

OS_TMR g_tmr1; OS_TMR g_tmr2; void mytimer_Callback (OS_TMR *p_tmr1, void *p_arg)  { 　　if(p_tmr1 == &g_tmr1) 　　　　printf("gtmr1 mytimer_Callback\r\n"); 　　if(p_tmr2 == &g_tmr2) 　　　　printf("gtmr2 mytimer_Callback\r\n"); }   OSTmrCreate(&g_tmr1,"g_tmr1",0,100,OS_OPT_TMR_PERIODIC,(OS_TMR_CALLBACK_PTR)mytimer_Callback,NULL,&err); OSTmrCreate(&g_tmr2,"g_tmr2",0,100,OS_OPT_TMR_PERIODIC,(OS_TMR_CALLBACK_PTR)mytimer_Callback,NULL,&err); OSTmrStart (&g_tmr1,&err); OSTmrStart (&g_tmr2,&err);

 

 

注意：

?

1 2 3 4 5 6 7 8

void timer_callback (OS_TMR *p_tmr, void *p_arg)  { 　　 OS_ERR err; 　　OS_FLAGS flags; 　　printf("timer_callback ...\r\n"); 　　OSFlagPend(&g_flag_grp, 0x03, 0, OS_OPT_PEND_FLAG_SET_ANY +OS_OPT_PEND_FLAG_CONSUME +OS_OPT_PEND_BLOCKING,NULL, &err); 　　delay_ms(2000); }

　　

当前timer_callback会1秒执行一遍，当调用睡眠2秒和等待事件标志组，该函数还是1秒被调用一次。

 

三、定时器状态

　　任务调用 OSTmrStateGet()获得定时器的状态。当然，也可以调用OSTmrRemainGet()获得剩余定时时间。定时值是以时基为单位的。如果时基定时器的频率率为 10Hz，那么定时值设置为 50 意味着延时 5 秒。如果定时器被停止，那其定时值也将被停止，直到定时器被恢复时，定时器值继续被定时器任务递减。

（1）"Unused"状态意味着定时器尚未被创建或已经被删除。换句话说，系统不知道该定时器的相关状态。

（2）当创建了定时器或调用了 OSTmrStop()，定时器会处于停止模式。

（3）当调用 OSTmrStart()后定时器处于运行状态。

（4）一次性定时模式的定时器延时期满后处于完成状态"Completed"。

注：

　　回调函数被执行时会锁调度器，所以必须让回调函数尽可能地短。

四、实例

设置定时器 2秒执行一次回调函数。

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93

#include "sys.h" #include "delay.h" #include "usart.h" #include "led.h" #include "includes.h"   //任务1控制块 OS_TCB Task1_TCB;   void task1(void *parg);   CPU_STK task1_stk[128];         //任务1的任务堆栈，大小为128字，也就是512字节   OS_TMR g_tmr;   //软件定时器的对象   void  MyCallback (OS_TMR *p_tmr, void *p_arg); //主函数 int main(void) {     OS_ERR err;       systick_init();                                                     //时钟初始化           NVIC_PriorityGroupConfig(NVIC_PriorityGroup_2);                     //中断分组配置           usart_init(9600);                                                   //串口初始化           LED_Init();                                                         //LED初始化            //OS初始化，它是第一个运行的函数,初始化各种的全局变量，例如中断嵌套计数器、优先级、存储器     OSInit(&err);         //创建任务1     OSTaskCreate(   (OS_TCB *)&Task1_TCB,                                   //任务控制块，等同于线程id                     (CPU_CHAR *)"Task1",                                    //任务的名字，名字可以自定义的                     (OS_TASK_PTR)task1,                                     //任务函数，等同于线程函数                     (void *)0,                                              //传递参数，等同于线程的传递参数                     (OS_PRIO)6,                                             //任务的优先级6                           (CPU_STK *)task1_stk,                                   //任务堆栈基地址                     (CPU_STK_SIZE)128/10,                                   //任务堆栈深度限位，用到这个位置，任务不能再继续使用                     (CPU_STK_SIZE)128,                                      //任务堆栈大小                                (OS_MSG_QTY)0,                                          //禁止任务消息队列                     (OS_TICK)0,                                             //默认时间片长度                                                                                   (void  *)0,                                             //不需要补充用户存储区                     (OS_OPT)OS_OPT_TASK_NONE,                               //没有任何选项                     &err                                                    //返回的错误码                 );                  if(err!=OS_ERR_NONE)     {         printf("task 1 create fail\r\n");                   while(1);           }       //创建软件定时器     //启动软件定时器再延时 10*10ms才真正开始运行     //定时触发周期时间 200*10ms=2S     //OS_OPT_TMR_PERIODIC：周期执行  OS_OPT_TMR_ONE_SHOT：只执行一次回调函数     //MyCallback  回调函数     //NULL  ，不传递参数给MyCallback     OSTmrCreate(&g_tmr,"g_tmr",10,200,OS_OPT_TMR_PERIODIC,(OS_TMR_CALLBACK_PTR)MyCallback,NULL,&err);     OSTmrStart(&g_tmr,&err);     //启动OS，进行任务调度     OSStart(&err);                                       printf(".......\r\n");                           while(1);       }       void task1(void *parg) {     uint32_t t=0;     printf("task1 is create ok\r\n");       while(1)     {         printf("task1 is running......\r\n");         delay_ms(1000);     } }   void  MyCallback (OS_TMR *p_tmr, void *p_arg)//回调函数  相当于你之前的定时器中断服务函数 {     printf("MyCallback OK\r\n");     delay_ms(6000);  //在回调函数中延时是没有作用的，和没延时一样。 }