FreeRTOS 软件定时器的使用

        FreeRTOS中加入了软件定时器这个功能组件，是一个可选的、不属于freeRTOS内核的功能，由定时器服务任务（其实就是一个定时器任务）来提供。

软件定时器是当设定一个定时时间，当达到设定的时间之后就SEO靠我会执行指定的功能函数，而这个功能函数就叫做回调函数。也就是说回调函数的两次执行间隔叫做定时器的定时周期。

回调函数：回调函数就是一个通过函数指针调用的函数。如果你把函数的指针(地址)作为参数传递给另一个SEO靠我函数，当这个指针被用来调用其所指向的函数时，我们就说这是回调函数。警告：不能在回调函数中调用任何会阻塞任务的API函数 ！比如，定时器回调函数中不能调佣vTaskDelay()、vTaskDelayUSEO靠我nti()，还有一些访问队列或者信号量的非零阻塞时间的API函数。

        总之，软件定时器主要是用于定时触发或者是周期性执行的触发功能，从很多特种描述看，感觉是用软件模拟了一个定时中断ISR。软件定时器由FrSEO靠我ee RTOS内核实现并控制。 它们不需要硬件支持，也与硬件定时器或硬件计数器无关。

       说明：我使用的FreeRTOS版本为（FreeRTOS Kernel V10.4.3 LTS Patch 2）    

一、FSEO靠我reeRTOS启用软件定时器

        FreeRTOS软件定时器是一个可选的、不属于freeRTOS内核的功能，因此要在FreeRTOS中使用软件定时器的话，需要在配置文件freeRTOSConfig.h中添加SEO靠我如下所示的4个宏：

#define configUSE_TIMERS 1 //使能软件定时器 #define configTIMER_TASK_PRIORITY 7 //软件定时器的优先SEO靠我级 #define configTIMER_QUEUE_LENGTH 10 //软件定时器的队列长度 #define configTIMER_TASK_STACK_DESEO靠我PTH (configMINIMAL_STACK_SIZE * 5) //软件定时器的堆栈空间大小（单位是字）

二、FreeRTOS软件定时器的种类

FreeRTOS定时器有两种：单次定时器和周期定时器。SEO靠我

1、单次定时器

单次定时器定时时间到了，只执行一次回调函数，之后不会再执行。只有再次重新启动它，才会再执行一次。也就是说，定时器启动一次，开始计时，时间到了，执行一次回调函数。要想再次执行，必须重新启动SEO靠我它。

2、周期定时器

        周期定时器根据设定的时间周期的执行的。它一旦启动以后，每执行一次完一次回调函数以后定时器会自动重启，回调函数会周期性的执行。周期定时器相当于单片机硬件定时器中配置为自动重装定时器。

单SEO靠我次定时器和周期定时器的示意图如下所示：

三、FreeRTOS软件定时器API函数

FreeRTOS软件定时器API函数包含：1、创建软件定时器。2、启动软件定时器。3、停止定时器。4、复位定时器。5、查询SEO靠我定时器是否已经开始运行。

1、创建软件定时器

TimerHandle_t xTimerCreate( const char * const pcTimerName, /* 定时器名字 */const TiSEO靠我ckType_t xTimerPeriodInTicks, /* 定时器周期 */const UBaseType_t uxAutoReload, /* 单次定时器或者周期定时器式 */void * cSEO靠我onst pvTimerID, /* 定时器 ID */ TimerCallbackFunction_t pxCallbackFunction )/* 定时器回调函数 */

API函数 xTimerCrSEO靠我eate 用于创建软件定时器。

（1）、pcTimerName：定时器名字，一般用于调试，方便识别不同的定时器。

（2）、xTimerPeriodInTicks：定时器周期，单位是系统时钟节拍。

（3）、uSEO靠我xAutoReload：选择定时器是周期模式还是单次模式。若参数为 pdTRUE，则表示选择周期定时器，若参数为pdFALSE，则表示选择单次定时器。

（4）、pvTimerID：定时器的 ID。当创建SEO靠我多个不同的定时器，但又使用同一个回调函数时，在回调函数中就可以通过不同的ID 号来区分不同的定时器。

（5）、pxCallbackFunction：定时器的回调函数。

返回值：创建成功返回定时器的句柄，失SEO靠我败会返回 NULL。

        例子：创建一个单次触发的软件定时器示例如下：

                软件定时器的名字为singalTIMERS，定时器的ID号=1，定时周期=500毫秒。

/*创建单次定时器*/xTimers = xTimSEO靠我erCreate("singalTIMERS", //软件定时器的名字 500, //定时器周期(500毫秒),单位时钟节拍pdFALSE, //定时器模式，pdTRUE为周期定时器，pdFALSE为SEO靠我单次定时器(void*)1, //定时器的ID号=1vTimerCallback); //定时器回调函数

2、启动软件定时器

        启动软件定时器分为两种：1、在任务中启动定时器。2、在中断中启动定时器。

2.1SEO靠我、在任务中启动定时器

BaseType_t xTimerStart( TimerHandle_t xTimer, /* 定时器句柄 */TickType_t xBlockTime ); /* 成功启动定SEO靠我时器前的最大等待时间设置，单位系统时钟节拍 */

        API函数 xTimerStart 用于启动软件定时器。

（1）、xTimer：定时器句柄。

（2）、xBlockTime：成功启动定时器前的最大等待时间设SEO靠我置，单位系统时钟节拍。

返回值：返回 pdFAIL 表示此函数向消息队列发送消息失败，返回 pdPASS 表示此函数向消息队列发送消息成功。

注意：定时器组的大部分API函数不是调用后就会直接运行的，而是SEO靠我通过消息队列给定时器任务发消息来实现的，此参数设置的等待时间就是当消息队列已经满的情况下，等待消息队列有空间时的最大等待时间。注意：定时器任务实际执行消息队列发来的命令依赖于定时器任务的优先级，如果定SEO靠我时器任务是高优先级会及时得到执行，如果是低优先级，就要等待其余高优先级任务释放 CPU 权才可以得到执行。

        例子：在任务中启动软件定时器示例如下：

xTimerStart(xTimers, 200);

表示SEO靠我刚刚创建的单次周期定时器，定时周期=500毫秒，等待消息队列有空间时的最大等待时间为200毫秒。

2.2、在中断中启动定时器

BaseType_t xTimerStartFromISR(TimerHandSEO靠我le_t xTimerBaseType_t* pxHigherPriorityTaskWoken);

（1）、XTimer：软件定时器的句柄

（2）、pxHigherPriorityTaskWoken：退SEO靠我出此函数时是否要进行任务切换

返回值：

pdPASS：软件定时器开启成功。

pdFAIL：软件定时器开启失败。

        例子：在中断中启动软件定时器示例如下：

void USART2_IRQHandler(void) SEO靠我 {BaseType_t xHigherPriorityTaskWoken = pdFALSE; //不进行任务切换if (xTimerStartFromISR(xTimers , &xSEO靠我HigherPriorityTaskWoken) != pdPASS){//软件定时器开启失败} }

3、停止定时器

停止软件定时器分为两种：1、在任务中停止定时器。2、在中断中停止定时器SEO靠我。

3.1、在任务中停止定时器

BaseType_t xTimerStop(TimerHandle_t xTime,TickType_t xTicksToWait)

（1）、xTimer：软件定时器的句柄。SEO靠我

（2）、xTicksToWait：阻塞时间，即停止定时器最大的等待时间。

返回值：

pdPASS：软件定时器停止成功

pdFAIL：软件定时器停止失败

        例子：停止软件定时器示例如下： 

xTimerStop(xTSEO靠我imers, portMAX_DELAY);

3.2、在中断中停止软件定时器

xTimerStopFormISR（TimerHandle_t xTimer,BaseType_t pxHigherPriorSEO靠我ityTaskWoken）;

（1）、xTimer：软件定时器句柄

（2）、pxHigherPriorityTaskWoken：退出此函数时是否要进行任务切换

返回值：

pdPASS：软件定时器停止成功。

pdSEO靠我FAIL：软件定时器停止失败。

4、复位定时器

        复位软件定时器分为两种：1、在任务中复位定时器。2、在中断中复位定时器。

        警告：复位软件定时器，会重新计算定时周期到达的时间点，这个新的时间点是相对于复位定时SEO靠我器的那个时刻计算的，并不是第一次启动软件定时器的那个时间点！！！

假设：定时周期=5秒，调用xTimerStart后，定时器已经运行了3秒，此时调用xTimerReset复位定时器，定时器会从当前时刻（SEO靠我3秒）时刻，重新启动，当5秒后，执行一次回调函数。

4.1、在任务中复位定时器

BaseType_t xTimerReset(TimerHandle_t xTimer,TickType_t xTicksTSEO靠我oWait)

（1）、xTimer：软件定时器的句柄。

（2）、xTicksToWait：阻塞时间，即停止定时器最大的等待时间。

返回值：

pdPASS：软件定时器复位成功

pdFAIL：软件定时器复位失败

4.SEO靠我2、在中断中复位定时器

BaseType_t xTimerResetFromISR(TimerHandle_t xTimer, BaseType_t *pxHigherPriorityTSEO靠我askWoken);

（1）、xTimer：软件定时器句柄

（2）、pxHigherPriorityTaskWoken：退出此函数时是否要进行任务切换

返回值：

pdPASS：软件定时器复位成功。

pdFAILSEO靠我：软件定时器复位失败。

5、查询定时器是否已经开始运行

BaseType_t xTimerIsTimerActive( TimerHandle_t xTimer )

查询定时器以查看它是活动的还是休眠的。如SEO靠我果出现以下情况，计时器将处于休眠状态：

已创建但未启动。已过期的计时器尚未重新启动。

返回值：

pdFALSE，没有运行。其他值，运行。

四、实例

下面我们创建一个单次周期软件定时器，定时器的名字为singalSEO靠我TIMERS，定时器的ID号=1，定时周期=500毫秒。

1、配置文件freeRTOSConfig.h中添加如下所示的4个宏：

#define configUSE_TIMERS 1 //使能软件定时器 SEO靠我 #define configTIMER_TASK_PRIORITY 7 //软件定时器的优先级 #define configTIMER_QUEUE_LENGTH 10 /SEO靠我/软件定时器的队列长度 #define configTIMER_TASK_STACK_DEPTH (configMINIMAL_STACK_SIZE * 5) //软件定时器的堆栈空间SEO靠我大小（单位是字）

        注意：软件定时器的优先级为7，那么configMAX_PRIORITIES的优先级至少为8，我设置的configMAX_PRIORITIES优先级为8，参见下图

2、包含头文件

#inclSEO靠我ude "FreeRTOS.h" #include "task.h" #include "queue.h" #include "semphr.h" SEO靠我 #include "timers.h"

3、定义定时器句柄

TimerHandle_t xTimers = NULL; //单次定时器

4、定义回调函数

static void vTimerCalSEO靠我lback(xTimerHandle pxTimer); //单次定时器回调函数/* *************************************************SEO靠我************************************* * 函 数 名: vTimerCallback * 功能说明: 定时器回调函数 SEO靠我 * 形 参: 无 * 返 回 值: 无 **************************************************************SEO靠我************************ */ static void vTimerCallback(xTimerHandle pxTimer) SEO靠我 {configASSERT(pxTimer);//添加用户代码 }

5、动态创建定时器

/*创建单次定时器*/xTimers = xTimerCreate("singalTIMERS",SEO靠我 //软件定时器的名字 200, //定时器周期,单位时钟节拍pdFALSE, //定时器模式，pdTRUE为周期定时器，pdFALSE为单次定时器(void*)1, //定时器的ID号vTimerCSEO靠我allback); //定时器回调函数

        想要搞清楚【FreeRTOS 的软件定时器消息队列】的内核知识，请参阅以下文章：

(10条消息) FreeRTOS个人笔记-软件定时器_Couvrir洪荒猛兽的博客SEO靠我-CSDN博客_freertos 定时器