UCOS-Ⅲ：软件定时器

一、定时器基本概念

​ 软件定时器是建立在硬件定时器的基础上，软件定时器只要设置一个硬件的定时器，通过软件分频和系统的管理即可得到多个软件定时器，理论上只要单片机内存足够，可以扩展到无限多个，不过精度会下降（原因：软件定时器的定时过程中是极有可能被其它中断所打断）

​ 他与硬件定时器的运行区别如下：硬件定时器时，每次在定时时间到达之后就会自动触发一个中断，用户在中断中处理信息；而使用软件定时器时，需要我们在创建软件定时器时指定时间到达后要调用的函数（也称超时函数/回调函数，为了统一，下文均用回调函数描述），在回调函数中处理信息

软件定时器回调函数的上下文是任务，其回调函数类似硬件的中断服务函数，所以回调函数要快进快出，而且回调函数中不能有任何阻塞任务运行的情况

​ 软件定时器的精度（ 分辨率） 决定于系统时基频率， 也就是变量OS_CFG_TMR_TASK_RATE_HZ 的值，而且定时器所定时的数值必须是这个定时器任务精度的整数倍，例如，定时器任务的频率为10HZ，那么上层软件定时器定时数值只能是100ms，200ms，1000ms 等，而不能取值为150ms

二、调用API

创建函数OSTmrCreate()

函数OSMutexCreate 用来创建mutex

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)          //返回错误类型

  

 

  
1
  
2
  
3
  
4
  
5
  
6
  
7
  
8
 

函数参数功能：

返回错误类型

使用实例：

  OS_TMR      my_tmr;   //声明软件定时器对象
  /* 创建软件定时器 */
  OSTmrCreate ((OS_TMR              *)&my_tmr,             //软件定时器对象
               (CPU_CHAR            *)"MySoftTimer",       //命名软件定时器
               (OS_TICK              )10,                  //定时器初始值，依10Hz时基计算，即为1s
               (OS_TICK              )10,                  //定时器周期重载值，依10Hz时基计算，即为1s
               (OS_OPT               )OS_OPT_TMR_PERIODIC, //周期性定时
               (OS_TMR_CALLBACK_PTR  )TmrCallback,         //回调函数
               (void                *)"Timer Over!",       //传递实参给回调函数
               (OS_ERR              *)err);                //返回错误类型

  

 

  
1
  
2
  
3
  
4
  
5
  
6
  
7
  
8
  
9
  
10
 

启动软件定时器函数OSTmrStart()

除了要创建定时器之外，还需要调用启动定时器的函数OSTmrStart，启动函数OSTmrStart 的使用只要输入创建的定时器的变量的指针就能启动

CPU_BOOLEAN  OSTmrStart (OS_TMR  *p_tmr,  //定时器控制块指针
                         OS_ERR  *p_err)  //返回错误类型

  

 

  
1
  
2
 

参数

返回错误类型

使用实例：

/* 启动软件定时器 */						 
OSTmrStart ((OS_TMR   *)&my_tmr, //软件定时器对象
            (OS_ERR   *)err);    //返回错误类型

  

 

  
1
  
2
  
3
 

停止定时器函数OSTmrStop()

OSTmrStop() 函数用于停止一个软件定时器。软件定时器被停掉之后可以调用OSTmrStart()函数重启，但是重启之后定时器是从头计时，而不是接着上次停止的时刻继续计时，函数入口如下：

CPU_BOOLEAN  OSTmrStop (OS_TMR  *p_tmr,          //定时器控制块指针
                        OS_OPT   opt,            //选项
                        void    *p_callback_arg, //传给回调函数的新参数
                        OS_ERR  *p_err)          //返回错误类型

  

 

  
1
  
2
  
3
  
4
 

参数

OPT配置

错误类型

使用实例

	OSTmrStop(&my_tmr,
              OS_OPT_TMR_CALLBACK_ARG ,
              0,
              &err);

  

 

  
1
  
2
  
3
  
4
 

删除软件定时器函数OSTmrDel()

OSTmrDel()用于删除一个已经被创建成功的软件定时器，删除之后就无法使用该定时
器，并且定时器相应的信息也会被系清空

CPU_BOOLEAN  OSTmrDel (OS_TMR  *p_tmr, //定时器控制块指针
                       OS_ERR  *p_err) //返回错误类型

  

 

  
1
  
2
 

参数

错误类型

使用实例

	OSTmrDel(&my_tmr,
             &err);

  

 

  
1
  
2
 

获得定时器的剩余期限值OSTmrRemainGet()

调用OSTmrRemainGet 这个函数来获取定时器剩下的定时时间

OS_TICK  OSTmrRemainGet (OS_TMR  *p_tmr,
                         OS_ERR  *p_err)

  

 

  
1
  
2
 

使用方式

OS_TICK time;
time= OSTmrRemainGet(&my_tmr
					 &err);

  

 

  
1
  
2
  
3
 

获得定时器当前的状态OSTmrStateGet()

获取定时器状态的函数OSTmrStateGet 同样是输入定时器变量指针和指向存放错误类型的指针就可以返回定时器的状态。

OS_STATE  OSTmrStateGet (OS_TMR  *p_tmr,
                         OS_ERR  *p_err)

  

 

  
1
  
2
 

定时器状态有如下几种

软件定时器任务

软件定时器的回调函数的上下文是在任务中，所有，系统中必须要一个任务来管理所有的软件定时器，等到定时时间到达后就调用定时器对应的回调函数，那么软件定时器任务就是系统提供的一个任务，它在系统初始化的时候，系统就帮我们创建的一个任务，用来管理定时器的回调函数，该任务在uC/OS初始化时就创建（前提是将定时器的裁剪宏定义打开），不需要我们自己进行创建，写在这用来提示一下他的运作流程，有兴趣可以扒源码研究

文章来源: blog.csdn.net，作者：JeckXu666，版权归原作者所有，如需转载，请联系作者。

原文链接：blog.csdn.net/qq_45396672/article/details/118371917