UCOSIII软件定时器

1、UCOSIII软件定时器简介

1.1、软件定时器简介：

定时器本质是递减计数器，当计数器减到零时可以触发某种动作的执行，这个动作通过回调函数实现。当定时器计时完成时，定义的回调函数就会被立即调用，应用程序可以有任意数量的定时器，UCOSIII中定时器的时间分辨率有一个 OS_CFG_TMR_TASK_RATE_HZ，单位为HZ，默认为100HZ

注意！一定要避免在回调函数中使用阻塞调用或者可以阻塞或删除定时器任务的函数。

回调函数就是一个通过函数指针调用的函数。如果你把函数的指针（地址）作为参数传递给另一个函数，当这个指针被用来调用其所指向的函数时，我们就说这是回调函数。回调函数不是由该函数的实现方法直接调用，而是在特定的事件或条件发生时由另外的一方调用的，用来对该事件或条件进行响应。

---

1.2、软件定时器API函数：

函数名	作用
OSTmrcreate()	创建定时器并制定运行模式
OSTmrDel()	删除定时器
OSTmrRemainGet()	获取定时器的剩余时间
OSTmrStart()	启动定时器计数
OSTmrStateGet()	获取当前定时器状态
OSTmrStop()	停止计数器倒计时

---

2、UCOSIII软件定时器工作模式

2.1、创建定时器：

创建软件定时器使用函数OSTmrCreate()

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)

软件定时器（定义）：

struct  os_tmr {
    OS_OBJ_TYPE          Type;
    CPU_CHAR            *NamePtr;                           /* Name to give the timer                                 */
    OS_TMR_CALLBACK_PTR  CallbackPtr;                       /* Function to call when timer expires                    */
    void                *CallbackPtrArg;                    /* Argument to pass to function when timer expires        */
    OS_TMR              *NextPtr;                           /* Double link list pointers                              */
    OS_TMR              *PrevPtr;
    OS_TICK              Match;                             /* Timer expires when OSTmrTickCtr matches this value     */
    OS_TICK              Remain;                            /* Amount of time remaining before timer expires          */
    OS_TICK              Dly;                               /* Delay before start of repeat                           */
    OS_TICK              Period;                            /* Period to repeat timer                                 */
    OS_OPT               Opt;                               /* Options (see OS_OPT_TMR_xxx)                           */
    OS_STATE             State;
#if OS_CFG_DBG_EN > 0u
    OS_TMR              *DbgPrevPtr;
    OS_TMR              *DbgNextPtr;
#endif
};

停止定时器：

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

2.2、单次定时器：

单次定时器初始值（ 也就是OSTmrCreate()函数中的参数dly ）开始倒计数，直到为0调用回调并停止。单次定时器的定时器只执行一次。

2.2、周期模式（无初始化延迟）：

创建定时器的时候我们可以设定为周期模式，当倒计时完成后，定时器调用回调函数，并重置计数器重新开始计时，一直循环性下去。如果在调用函数 OSTmrCreate() 创建周期定时器时让参数dly为0，那么定时器每个周期就是 period。

2.3、周期模式（有初始延迟）：

周期定时器也可以设定为带初始化延迟时间的运行模式，使用函数 OSTmrCreate() 参数dly来确定第一个周期，以后的每个周期开始时将计数器值重置为 period