第六章软件定时器

爱被打了一巴掌 2024-04-17 16:28 14阅读 0赞

简介：
    官网：https://www.freertos.org/RTOS-software-timer.html
    软件定时器的精度没有硬件定时器那么高。
    当定时器的定时周期到了以后就会执行回调函数。回调函数在定时器服务任务中执行，所以回调函数中不能调用阻塞任务的API函数。
    
    配置参数：
    /*                                FreeRTOS与软件定时器有关的配置选项                                            */
    #define configUSE_TIMERS                                    1                                                        //为1时启用软件定时器
    #define configTIMER_TASK_PRIORITY                    (configMAX_PRIORITIES-1)               //软件定时器优先级
    #define configTIMER_QUEUE_LENGTH                    5                                                       //软件定时器队列长度
    #define configTIMER_TASK_STACK_DEPTH            (configMINIMAL_STACK_SIZE*2)      //软件定时器任务堆栈大小
    
    
    函数：
    创建：    
    
    TimerHandle_t xTimerCreate
    （const char * const pcTimerName，
    const TickType_t xTimerPeriod，
    const UBaseType_t uxAutoReload，
    void * const pvTimerID，
    TimerCallbackFunction_t pxCallbackFunction）;
    创建一个新的软件计时器实例并返回一个句柄，通过该句柄可以引用计时器。
    查询状态：
    
    BaseType_t xTimerIsTimerActive（TimerHandle_t xTimer）;
    查询软件计时器以查看它是处于活动状态还是处于休眠状态。
    
    定时器在休眠状态下创建的。所述xTimerStart（） ， xTimerReset（） ， xTimerStartFromISR（） ，xTimerResetFromISR（） ， xTimerChangePeriod（）和 xTimerChangePeriodFromISR（） API函数都可以被用于转换的定时器成为激活状态。
    
    开启、停止
    
    BaseType_t xTimerStart（TimerHandle_t xTimer，
                                TickType_t xBlockTime）;
    BaseType_t xTimerStop（TimerHandle_t xTimer，
                               TickType_t xBlockTime）;
    
    
    删除
    
    BaseType_t xTimerDelete（TimerHandle_t xTimer，
                                 TickType_t xBlockTime）;
    
    复位
    
    BaseType_t xTimerReset（TimerHandle_t xTimer，
                                TickType_t xBlockTime）;
    
    获取软件定时器ID
    
    void * pvTimerGetTimerID（TimerHandle_t xTimer）;
    返回分配给软件计时器的ID 。
    如果为多个计时器分配了相同的回调函数，则可以在回调函数内检查计时器标识符，以确定哪个计时器实际到期。
    
    设置软件定时器ID
    
    void vTimerSetTimerID（TimerHandle_t xTimer，void * pvNewID）;
    创建计时器时， 标识符（ID）被分配给软件计时器，并且可以使用vTimerSetTimerID（）API函数随时更改。
    
    设置软件定时器位自动重载或者单次定时器
    
    void vTimerSetReloadMode（TimerHandle_t xTimer，
                               const UBaseType_t uxAutoReload）;
    
    获取定时器的名字
    
    const char * pcTimerGetName（TimerHandle_t xTimer）;
    返回软件计时器的可读文本名称。
    
    获取软件定时器的周期
    
    TickType_t xTimerGetPeriod（TimerHandle_t xTimer）;
    返回软件计时器的周期。期间以刻度指定。
    最初使用用于创建计时器的xTimerCreate（）调用的xTimerPeriod参数来设置计时器的周期 。然后可以使用xTimerChangePeriod（） 和xTimerChangePeriodFromISR（） API函数更改它 。
    
    
    设置软件定时器的周期
    
    BaseType_t xTimerChangePeriod（TimerHandle_t xTimer，
                                       TickType_t xNewPeriod，
                                       TickType_t xBlockTime）;
    
    获取软件定时器到期的时间
    
    TickType_t xTimerGetExpiryTime（TimerHandle_t xTimer）;
    返回软件计时器到期的时间，即计时器的回调函数执行的时间。
    
    主要讲pvTimerGetTimerID函数：
    
    
    static void AppObjCreate (void)
    {
        uint8_t i;
        
        /*使用软件定时器，1000ms一次实现led反转，1000ms一次Beep翻转*/
        const TickType_t  xTimerPer[2] = {1000, 1000};    
        
        /*
          1. 创建定时器，如果在RTOS调度开始前初始化定时器，那么系统启动后才会执行。
          2. 统一初始化两个定时器，他们使用共同的回调函数，在回调函数中通过定时器ID来区分
             是那个定时器的时间到。当然，使用不同的回调函数也是没问题的。
        */
        for(i = 0; i < 2; i++)
        {
            xTimers[i] = xTimerCreate("Timer",          /* 定时器名字 */
                                                                xTimerPer[i],    /* 定时器周期,单位时钟节拍 */
                                                                pdTRUE,          /* 周期性 */
                                                                (void *)i,      /* 定时器ID */
                                                                vTimerCallback); /* 定时器回调函数 */
            if(xTimers[i] == NULL)
            {
                /* 没有创建成功，用户可以在这里加入创建失败的处理机制 */
            }
            else
            {
                 /* 启动定时器，系统启动后才开始工作 */
                 if(xTimerStart(xTimers[i], 100) != pdPASS)　　//等待延时100ms，其实设置成0在简单任务下也是可以的，这个数值根据项目需求更改
                 {
                     /* 定时器还没有进入激活状态 */
                 }
            }
        }
    }
    
    static void vTimerCallback(xTimerHandle pxTimer)
    {
        uint8_t ulTimerID;
    
    
        configASSERT(pxTimer);
    
    
        /* 获取那个定时器时间到 */
    //    ulTimerID = *(uint8_t *)pvTimerGetTimerID(pxTimer);
            ulTimerID = (uint8_t )pvTimerGetTimerID(pxTimer);
        
        /* 处理定时器0任务 */
        if(ulTimerID == 0)
        {
            LED1_TOGGLE;
        }
        
        /* 处理定时器1任务 */
        if(ulTimerID == 1)
        {
            BEEP_TOGGLE;        
        }
    }