RT-thread内核之定时器管理

/**
 * clock & timer macros
 */
#define RT_TIMER_FLAG_DEACTIVATED       0x0             /**< 非激活，默认 */
#define RT_TIMER_FLAG_ACTIVATED         0x1             /**< 激活 */
#define RT_TIMER_FLAG_ONE_SHOT          0x0             /**< 单次定时，默认 */
#define RT_TIMER_FLAG_PERIODIC          0x2             /**< 周期性定时*/

#define RT_TIMER_FLAG_HARD_TIMER        0x0             /**< 硬件定时器中断模式，定时器超时检查及超时函数调用在MCU硬件定时器中断服务中执行，默认 */
#define RT_TIMER_FLAG_SOFT_TIMER        0x4             /**< 软件定时器线程模式，定时器超时检查及超时函数调用在定时器线程入口函数中执行 */

#define RT_TIMER_CTRL_SET_TIME          0x0             /**< set timer control command */
#define RT_TIMER_CTRL_GET_TIME          0x1             /**< get timer control command */
#define RT_TIMER_CTRL_SET_ONESHOT       0x2             /**< change timer to one shot */
#define RT_TIMER_CTRL_SET_PERIODIC      0x3             /**< change timer to periodic */

#ifndef RT_TIMER_SKIP_LIST_LEVEL
#define RT_TIMER_SKIP_LIST_LEVEL          1
#endif

/* 1 or 3 */
#ifndef RT_TIMER_SKIP_LIST_MASK
#define RT_TIMER_SKIP_LIST_MASK         0x3
#endif

/**
 * timer structure
 */
struct rt_timer
{
    struct rt_object parent;                       //内核对象

    rt_list_t        row[RT_TIMER_SKIP_LIST_LEVEL];//链表节点

    void (*timeout_func)(void *parameter);        //定时器超时函数
    void            *parameter;                   //定时器超时函数参数 

    rt_tick_t        init_tick;                   //定时器定时时间间隔,即每隔多长时间超时  
    rt_tick_t        timeout_tick;                //定时器超时时间点，即超时那一刻的时间点
};
typedef struct rt_timer *rt_timer_t;

软件定时器线程初始化：
void rt_system_timer_thread_init(void);
在该函数中初始化软件定时器线程模式下定时器链表数组，以及初始化软件定时器线程。

软件定时器线程入口函数：
/* system timer thread entry */                 //软件定时器线程入口函数
static void rt_thread_timer_entry(void *parameter)
{
    rt_tick_t next_timeout;

      while (1)//软件定时器优先级设置最高优先级0，且线程入口函数中为死循环，因此若函数中没有挂起自身线程和执行线程调度，则始终只运行这个线程
    {
        /* get the next timeout tick */         //得到软件定时器线程模式中定时器链表的下一个定时器的超时时间点
        next_timeout = rt_timer_list_next_timeout(rt_soft_timer_list);
        if (next_timeout == RT_TICK_MAX)        //定时器链表为空，即无定时器。RT_TICK_MAX is defined to be 0xffffffff in rtdef.h
        {
            /* no software timer exist, suspend self. */
            rt_thread_suspend(rt_thread_self());//若定时器链表为空，则挂起当前线程，继续线程调度 
            rt_schedule();
        }
        else
        {
            rt_tick_t current_tick;

            /* get current tick */
            current_tick = rt_tick_get();       //获取当前时间点  

            if ((next_timeout - current_tick) < RT_TICK_MAX/2)//离定时器超时时间点很近了，但是还差一段时间
            {
                /* get the delta timeout tick */
                next_timeout = next_timeout - current_tick;   //计算还差多长时间
                rt_thread_delay(next_timeout);                //休眠一段时间，delay函数将自身线程挂起并启动自身线程定时器后，执行线程调度运行其他就绪线程  
            }
        }

        /* check software timer */
        rt_soft_timer_check(); //预计的时间到了，检查是否该产生定时器超时事件。以前的版本中在这里添加了调度器锁（先进入临界区，检查完后再退出临界区）
    }
}

定时器超时检查函数：
void rt_soft_timer_check(void);
在该函数中扫描定时器链表rt_soft_timer_list中产生超时的定时器，将其移除定时器链表并执行定时器超时函数，若为周期性定时器则重新启动该定时器，即重新将其加入定时器链表中。

定时器超时检查函数：
void rt_timer_check(void);
该函数在MCU硬件定时器中断函数中调用，主要功能为扫描定时器链表rt_timer_list中产生超时的定时器，将其移除定时器链表并执行定时器超时函数，若为周期性定时器则重新启动该定时器，即重新将其加入定时器链表中。
此函数与rt_soft_timer_check基本大致相同，只不过一个是查找硬件定时器中断模式中定时器链表rt_timer_list，一个是查找软件定时器线程模式中定时器链表rt_soft_timer_list.

得到下一定时器超时时间点：
rt_tick_t rt_timer_next_timeout_tick(void)
{
    return rt_timer_list_next_timeout(rt_timer_list);//得到硬件定时器中断模式中定时器链表的下一个定时器的超时时间点
}

定时器创建：
rt_timer_t rt_timer_create(const char *name,//定时器名称
                           void (*timeout)(void *parameter),//定时器超时函数
                           void       *parameter,//定时器超时函数参数
                           rt_tick_t   time,//定时器定时时间间隔
                           rt_uint8_t  flag)//定时器内核对象标志

定时器初始化：
void rt_timer_init(rt_timer_t  timer,//定时器句柄
                   const char *name,//定时器名称
                   void (*timeout)(void *parameter),//定时器超时函数
                   void       *parameter,//定时器超时函数参数
                   rt_tick_t   time,//定时器定时时间间隔
                   rt_uint8_t  flag)//定时器内核对象标志

#define RT_TIMER_FLAG_DEACTIVATED 0x0 /* 默认为非激活态          */
#define RT_TIMER_FLAG_ACTIVATED   0x1 /* 激活状态               */
#define RT_TIMER_FLAG_ONE_SHOT    0x0 /* 默认为单次定时          */
#define RT_TIMER_FLAG_PERIODIC    0x2 /* 周期定时               */
#define RT_TIMER_FLAG_HARD_TIMER  0x0 /* 默认为硬件定时器中断模式 */
#define RT_TIMER_FLAG_SOFT_TIMER  0x4 /* 软件定时器线程模式      */

定时器删除：
rt_err_t rt_timer_delete(rt_timer_t timer);
调用这个函数接口后，系统会把这个定时器从rt_timer_list链表中删除，然后释放相应的定时器控制块占有的内存

定时器脱离：
rt_err_t rt_timer_detach(rt_timer_t timer);
脱离定时器时，系统会把定时器对象从系统容器的定时器链表中删除，但是定时器对象所占有的内存不会被释放。

定时器启动：
rt_err_t rt_timer_start(rt_timer_t timer);
当定时器被创建或者初始化以后，并不会被立即启动，必须在调用启动定时器函数接口后，才开始工作。
调用定时器启动函数接口后，定时器的状态将更改为激活状态（RT_TIMER_FLAG_ACTIVATED），并按照超时顺序插入到rt_timer_list队列链表中。

定时器停止：
rt_err_t rt_timer_stop(rt_timer_t timer);
调用定时器停止函数接口后，定时器状态将更改为停止状态，并从rt_timer_list链表中脱离出来不参与定时器超时检查。当一个（周期性）定时器超时时，也可以调用这个函数接口停止这个（周期性）定时器本身。

定时器控制：
rt_err_t rt_timer_control(rt_timer_t timer, rt_uint8_t cmd, void *arg);
#define RT_TIMER_CTRL_SET_TIME 0x0     /* 设置定时器定时时间间隔   */
#define RT_TIMER_CTRL_GET_TIME 0x1     /* 获得定时器定时时间间隔   */
#define RT_TIMER_CTRL_SET_ONESHOT 0x2  /* 设置定时器为单一超时型   */
#define RT_TIMER_CTRL_SET_PERIODIC 0x3 /* 设置定时器为周期型定时器 */