前言：本文参考，韦东山开发文档，连接放在最后
基本概念理解
软件定时器(Software Timer)，类似于闹钟，当规定的时间到来时，提醒你，去完成某件事情，闹钟提醒我们的事情，可以是每天重复性的任务，也可以是只执行一次的任务。将功能带入到软件定时器，得到定义，软件定时器（Software Timer）是一个定时机制，允许任务或函数在特定时间间隔后被执行。软件定时器的核心功能是延时和周期性执行任务。
需要注意的是，软件定时器（Software Timer）是依靠FreeRtos操作系统的，系统滴答中断（Tick Interrupt）来运行的，这里系统滴答中断提供的是软件定时器（Software Timer）判断时间的标准。
同样的软件定时器（Software Timer）因为功能不同也被分为 一次性定时器 和周期性定时器概念如下所示。
一次性定时器：当达到设定时间时触发一次并停止
周期性定时器：当达到设定时间周期间隔，就会重复触发，知道手动停止定时器
在概念中最重要的一点是，因为FreeRtos是操作系统(RTOS)，要求任务的并发性，并发性也就是任务的同时执行是通过中断函数来切换的，这里也就是通过系统滴答中断（Tick Interrupt）的中断函数来切换的，这个函数中不能放入执行时间不确定的程序，回影响系统切换任务，也就是影响并发性，因此，软件定时器（Software Timer）的执行函数会系统内核中调用函数，通过函数来读写 RTOS command queue 在系统内核中通过去读队列的数值，来在普通任务上下文调用不同的函数， RTOS守护 任务(RTOS Damemon Task)在普通任务的上下文执行，从而避免在中断中执行时间不确定的操作。
RTOS守护 任务(RTOS Damemon Task)的调度和普通任务的调度，没有什么区别，同样需要遵守任务的优先级规则。这里需要注意的是，软件定时器在创建过后，并不会启动，需要调用函数来启动软件定时器。
如果软件定时器在创建之后，没用使用函数调用，这个时候本身的状态是 冬眠(Dormant) 状态，是不能够正常相应的。
函数原型
软件定时器（Software Timer）的创建也分为动态创建和静态创建，同时创建成功之后，返回控制句柄函数原型如下。
动态创建
TimerHandle_t xTimerCreate( const char * const pcTimerName,const TickType_t xTimerPeriodInTicks,const UBaseType_t uxAutoReload,void * const pvTimerID,TimerCallbackFunction_t pxCallbackFunction );静态创建
TimerHandle_t xTimerCreate( const char * const pcTimerName,const TickType_t xTimerPeriodInTicks,const UBaseType_t uxAutoReload,void * const pvTimerID,TimerCallbackFunction_t pxCallbackFunction,StaticTimer_t *pxTimerBuffer );
| const char * const pcTimerName | 填定时器的名字 |
| TickType_t xTimerPeriodInTicks, | 填软件定时器执行周期，以Tick为单位 |
| UBaseType_t uxAutoReload, | pdTRUE代表为周期性定时器 pdFALSE 一次性定时器 |
| void * pvTimerID | 回调函数可以使用此参数, 比如分辨是哪个定时器 |
| TimerCallbackFunction_t pxCallbackFunction, | 填软件定时器执行函数 |
| StaticTimer_t *pxTimerBuffer | 回调函数可以使用此参数, 比如分辨是哪个定时器 |
创建软件定时器
static TimerHandle_t g_TimerSound;
void GameSoundTimer_Func(void)
{
}
g_TimerSound = xTimerCreate("GameSound",200,pdFALSE,NULL,GameSoundTimer_Func);首先需要声明一个句柄，然后声明或者找到，软件定时器的执行函数，选择软件定时器为周期性定时器或者一次性定时器，这里200个Tick可以看成200ms，来对待，还有给软件定时器七一给名字，基本上创建函数需要填写的参数就这么多。
启动/停止软件定时器
启动软件定时器（Software Timer）就是将他的状态改变为 运行态(Running、Active)，而停止软件定时器（Software Timer）就是对应的将状态改为 冬眠(Dormant) ，在这个状态软件定时器不能运行。
启动软件定时器
BaseType_t xTimerStart( TimerHandle_t xTimer, TickType_t xTicksToWait );
BaseType_t xTimerStartFromISR( TimerHandle_t xTimer,BaseType_t *pxHigherPriorityTaskWoken );这个参数分为在普通任务上下文使用，和在中断任务上下文使用，参数有一位不同，具体参数填写见下表格。
| TimerHandle_t xTimer | 填写作用定时器的句柄 |
| TickType_t xTicksToWait | 如果 command queue队列已满等待的时间 |
| BaseType_t*pxHigherPriorityTaskWoken | pdFALSE当前没有更高优先级的任务需要运行。 pdTrue 有更高优先级的任务在ISR结束时需要切换任务 |
当调用启动函数的时候，软件定时器状态会从冬眠(Dormant)转变为 运行态(Running、Active)，从而去运行任务。
停止软件定时器
调用停止函数会使，软件定时器（Software Timer）从 运行态(Running、Active)停止转变为冬眠(Dormant)状态，从而停止定时器的功能。
BaseType_t xTimerStop( TimerHandle_t xTimer, TickType_t xTicksToWait );
BaseType_t xTimerStopFromISR( TimerHandle_t xTimer, BaseType_t *pxHigherPriorityTaskWoken );
| TimerHandle_t xTimer | 填写作用定时器的句柄 |
| TickType_t xTicksToWait | 如果 command queue队列已满等待的时间 |
| BaseType_t*pxHigherPriorityTaskWoken | pdFALSE当前没有更高优先级的任务需要运行。 pdTrue 有更高优先级的任务在ISR结束时需要切换任务 |
static TimerHandle_t g_TimerSound;void GameSoundTimer_Func(void)
{
}g_TimerSound = xTimerCreate("GameSound",200,pdFALSE,NULL,GameSoundTimer_Func);xTimerStart( g_TimerSound, 0);//开启软件定时器，如果阻塞就不等待xTimerStop( g_TimerSound, 0);//关闭软件定时器，如果 command queue 队列阻塞不等待改变软件定时器周期
这里软件定时器在创建的时候，需要声明定时器周期，如果在后续-程序中，需要改变软件定时器的周期可以通过这个函数来改变周期，也就是执行时间，同时这里需要注意的是，这个函数也可以让软件定时器从冬眠(Dormant)转变为 运行态(Running、Active)。
当在软件定时器工作时调用，假设此时时间为tX，调用修改新的周期时间为y，那么软件定时器调用函数去响应的时间就是，tX+y，调用函数之前的时间不会计入新的软件定时器周期内。
函数原型
BaseType_t xTimerChangePeriod( TimerHandle_t xTimer,TickType_t xNewPeriod,TickType_t xTicksToWait );| TimerHandle_t xTimer | 填写改变定时器周期的句柄 |
| TickType_t xNewPeriod | 填写新的定时器周期 |
| TickType_t xTicksToWait | 等待 command queue超时时间 |
static TimerHandle_t g_TimerSound;void GameSoundTimer_Func(void)
{
}g_TimerSound = xTimerCreate("GameSound",200,pdFALSE,NULL,GameSoundTimer_Func);xTimerChangePeriod(g_TimerSound,400,0);//更改定时器周期为400xTimerStart( g_TimerSound, 0);//开启软件定时器，如果阻塞就不等待xTimerStop( g_TimerSound, 0);//关闭软件定时器，如果 command queue 队列阻塞不等待软件定时器复位函数
当在软件定时器工作时调用，假设此时时间为tX，周期时间为n，那么软件定时器调用函数去响应的时间就是 tX+n， 这个函数也可以让软件定时器从冬眠(Dormant)转变为 运行态(Running、Active)。
函数原型
BaseType_t xTimerReset( TimerHandle_t xTimer, TickType_t xTicksToWait );
| TimerHandle_t xTimer | 填写改变定时器周期的句柄 |
| TickType_t xTicksToWait | 等待 command queue超时时间 |
static TimerHandle_t g_TimerSound;void GameSoundTimer_Func(void)
{
}g_TimerSound = xTimerCreate("GameSound",200,pdFALSE,NULL,GameSoundTimer_Func);xTimerChangePeriod(g_TimerSound,400,0);//更改定时器周期为400
xTimerReset( g_TimerSound,0 );//复位软件定时器，等待时间为0xTimerStart( g_TimerSound, 0);//开启软件定时器，如果阻塞就不等待xTimerStop( g_TimerSound, 0);//关闭软件定时器，如果 command queue 队列阻塞不等待程序实现调用
static TimerHandle_t g_TimerSound;void GameSoundTimer_Func(TimerHandle_t xTimer)
{PassiveBuzzer_Control(0);}int Buzzer_Init(void)
{//初始化蜂鸣器PassiveBuzzer_Init();//创建软件定时器g_TimerSound = xTimerCreate("GameSound",200,pdFALSE,NULL,GameSoundTimer_Func);
}
void Buzzer_buzz(int freq ,int time_ms)
{PassiveBuzzer_Set_Freq_Duty(freq, 50);//启动软件定时器停止声音xTimerChangePeriod(g_TimerSound,time_ms,0);
}欢迎指正，希望对你，有所帮助！！！
