8、软件定时器（software timer）

运行（Running、 Active）

休眠（Dormant）

优先级&nbsp; &nbsp;<b>configTIMER_TASK_PRIORITY</b>

定时器命令队列长度&nbsp; &nbsp;<b>configTIMER_QUEUE_LENGTH</b><br>

处理命令：从命令队列里取出命令、处理<br>

执行定时器的回调函数

void <b><font color="#64b5f6">ATimerCallback</font></b>( TimerHandle_t <b>xTimer </b>)

TimerHandle_t <b><font color="#64b5f6">xTimerCreate</font></b>( const char * const <b>pcTimerName</b>,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; // 定时器名字<br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; const TickType_t <b>xTimerPeriodInTicks</b>,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;// 周期, 以Tick为单位<br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; const UBaseType_t <b>uxAutoReload</b>,&nbsp; &nbsp; &nbsp;//类型, <b>pdTRUE&nbsp;</b>--&gt; 自动加载, <b>pdFALSE&nbsp;</b>--&gt; 一次性<br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;void * const <b>pvTimerID</b>, // 回调函数可以使用此参数, 比如分辨是哪个定时器<br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; TimerCallbackFunction_t <b>pxCallbackFunction </b>);&nbsp; //回调函数<br>

TimerHandle_t <b><font color="#64b5f6">xTimerCreateStatic</font></b>(const char * const <b>pcTimerName</b>,&nbsp;&nbsp;<br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;TickType_t <b>xTimerPeriodInTicks</b>,<br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;UBaseType_t <b>uxAutoReload</b>,<br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;void * <b>pvTimerID</b>,<br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;TimerCallbackFunction_t <b>pxCallbackFunction</b>,<br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;StaticTimer_t *<b>pxTimerBuffer </b>);<br>

回调函数类型&nbsp; &nbsp; &nbsp;void <b><font color="#64b5f6">ATimerCallback</font></b>( TimerHandle_t <b>xTimer </b>);&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp;typedef void (* TimerCallbackFunction_t)( TimerHandle_t xTimer );

BaseType_t <b><font color="#64b5f6">xTimerDelete</font></b>( TimerHandle_t <b>xTimer</b>,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; //&nbsp; 要删除哪个定时器&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; TickType_t <b>xTicksToWait</b> );&nbsp; &nbsp; //&nbsp; 超时时间

启动

停止

参数&nbsp; &nbsp;<b><font color="#7b1fa2">pxHigherPriorityTaskWoken</font></b>: 向队列发出命令使得守护任务被唤醒,<br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;如果守护任务的优先级比当前任务的高,<br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 则"<b>*pxHigherPriorityTaskWoken = pdTRUE",</b><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;表示需要进行任务调度<br>

BaseType_t <b><font color="#64b5f6">xTimerReset</font></b>( TimerHandle_t <b>xTimer</b>,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; TickType_t <b>xTicksToWait </b>);

BaseType_t <b><font color="#64b5f6">xTimerResetFromISR</font></b>( TimerHandle_t <b>xTimer</b>,<br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; BaseType_t *<b>pxHigherPriorityTaskWoken </b>);

BaseType_t <b><font color="#64b5f6">xTimerChangePeriod</font></b>( TimerHandle_t <b>xTimer</b>,<br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;TickType_t <b>xNewPeriod</b>,<br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; TickType_t <b>xTicksToWait </b>);

BaseType_t <b><font color="#64b5f6">xTimerChangePeriodFromISR</font></b>( TimerHandle_t <b>xTimer</b>,<br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; TickType_t <b>xNewPeriod</b>,<br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; BaseType_t *<b>pxHigherPriorityTaskWoken </b>);

void *<b><font color="#64b5f6">pvTimerGetTimerID</font></b>( TimerHandle_t <b>xTimer </b>);&nbsp; &nbsp; （获得定时器的ID）

void <b><font color="#64b5f6">vTimerSetTimerID</font></b>( TimerHandle_t <b>xTimer</b>,&nbsp; &nbsp; &nbsp; &nbsp;（设置定时器的ID）&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;void *<b>pvNewID </b>)&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; //新ID

/*&nbsp;1.&nbsp;工程中&nbsp;*/<br>添加&nbsp;timer.c<br><br>/*&nbsp;2.&nbsp;配置文件FreeRTOSConfig.h中&nbsp;*/<br><span class="tag">##define</span>&nbsp;configUSE_TIMERS&nbsp;1&nbsp;/*&nbsp;使能定时器&nbsp;*/<br><span class="tag">##define</span>&nbsp;configTIMER_TASK_PRIORITY&nbsp;31&nbsp;/*&nbsp;守护任务的优先级,&nbsp;尽可能高一些&nbsp;*/<br><span class="tag">##define</span>&nbsp;configTIMER_QUEUE_LENGTH&nbsp;5&nbsp;/*&nbsp;命令队列长度&nbsp;*/<br><span class="tag">##define</span>&nbsp;configTIMER_TASK_STACK_DEPTH&nbsp;32&nbsp;/*&nbsp;守护任务的栈大小&nbsp;*/<br><br>/*&nbsp;3.&nbsp;源码中&nbsp;*/<br><span class="tag">##include</span>&nbsp;"timers.h"