前言:本文参考,韦东山开发文档,连接放在最后

基本概念理解

        软件定时器(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);//更改定时器周期为400

xTimerStart( 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 );//复位软件定时器,等待时间为0

xTimerStart( 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);	
}

                                欢迎指正,希望对你,有所帮助!!!

点赞(0) 打赏

评论列表 共有 0 条评论

暂无评论

微信公众账号

微信扫一扫加关注

发表
评论
返回
顶部