目录
什么是定时器?
简单可以理解为闹钟,到达指定一段时间后,就会响铃。
STM32
芯片自带硬件定时器,精度较高,达到定时时间后会触发中断,也可以生成
PWM
、输入
捕获、输出比较,等等,功能强大,但是由于硬件的限制,个数有限。
软件定时器也可以实现定时功能,达到定时时间后可调用回调函数,可以在回调函数里处理信
息。
软件定时器优缺点
优点:
1.
简单、成本低;
2.
只要内存足够,可创建多个;
缺点:
精度较低,容易受中断影响。在大多数情况下够用,但对于精度要求比较高的场合不建议使用。
软件定时器原理
定时器是一个可选的、不属于
FreeRTOS
内核的功能,它是由定时器服务任务来提供的。
在调用函数
vTaskStartScheduler()
开启任务调度器的时候,会创建一个用于管理软件定时器的任
务,这个任务就叫做软件定时器服务任务。
1.
负责软件定时器超时的逻辑判断
2.
调用超时软件定时器的超时回调函数
3.
处理软件定时器命令队列
FreeRTOS
提供了很多定时器有关的
API
函数,这些
API
函数大多都使用
FreeRTOS
的队列发送命令给
定时器服务任务。
这个队列叫做定时器命令队列
。定时器命令队列是提供给
FreeRTOS
的软件定时
器使用的,
用户不能直接访问
!

软件定时器相关配置
软件定时器有一个定时器服务任务和定时器命令队列,这两个东西肯定是要配置的,相关的配置
也是放到文件
FreeRTOSConfig.h
中的,涉及到的配置如下:
1
、
configUSE_TIMERS
如果要使用软件定时器的话宏
configUSE_TIMERS
一定要设置为
1
,当设置为
1
的话定时器服务任务就会在启动FreeRTOS
调度器的时候自动创建。
2
、
configTIMER_TASK_PRIORITY
设置软件定时器服务任务的任务优先级,可以为
0~(configMAX_PRIORITIES-1)
。优先级一定要根
据实际的应用要求来设置。如果定时器服务任务的优先级设置的高的话,定时器命令队列中的命 令和定时器回调函数就会及时的得到处理。
3
、
configTIMER_QUEUE_LENGTH
此宏用来设置定时器命令队列的队列长度。
4
、
configTIMER_TASK_STACK_DEPTH
此宏用来设置定时器服务任务的任务堆栈大小。
单次定时器和周期定时器
单次定时器:
只超时一次,调用一次回调函数。可手动再开启定时器;
周期定时器:
多次超时,多次调用回调函数。
软件定时器相关 API 函数
函数
|
描述
|
xTimerCreate()
|
动态方式创建软件定时
|
xTimerCreateStatic()
|
静态方式创建软件定时器
|
xTimerStart()
|
开启软件定时器定时
|
xTimerStop()
|
停止软件定时器定时
|
xTimerReset()
|
复位软件定时器定时
|
xTimerChangePeriod()
|
更改软件定时器的定时超时时间
|
xTimerStartFromISR()
|
在中断中开启软件定时器定时
|
xTimerStopFromISR()
|
在中断中停止软件定时器定时
|
xTimerResetFromISR()
|
在中断中复位软件定时器定时
|
xTimerChangePeriodFromISR()
|
在中断中更改定时超时时间
|
1. 创建软件定时器
TimerHandle_t xTimerCreate( const char * const pcTimerName ,const TickType_t xTimerPeriod ,const UBaseType_t uxAutoReload ,void * const pvTimerID ,TimerCallbackFunction_t pxCallbackFunction );
参数:
pcTimerName
:软件定时器名称
xTimerPeriodInTicks
:定时超时时间,单位:系统时钟节拍。宏
pdMS_TO_TICKS()
可用于将以毫秒为单位指定的时间转换为以
tick
为单位指定的时间。
uxAutoReload
:定时器模式,
pdTRUE
:周期定时器,
pdFALSE
:单次定时器
pvTimerID
:软件
定时器
ID
,用于多个软件定时器公用一个超时回调函数
pxCallbackFunction
:软件定时器超时回
调函数
返回值:
成功:定时器句柄
失败:
NULL
2. 开启软件定时器
BaseType_t xTimerStart ( TimerHandle_t xTimer ,TickType_t xBlockTime );
参数:
xTimer
:待开启的软件定时器的句柄
xTickToWait
:发送命令到软件定时器命令队列的最大等待时
间
返回值:
pdPASS
:开启成功
pdFAIL
:开启失败
3. 停止软件定时器
BaseType_t xTimerStop ( TimerHandle_t xTimer ,TickType_t xBlockTime );
参数与返回值同上。
4. 复位软件定时器
BaseType_t xTimerReset ( TimerHandle_t xTimer ,TickType_t xBlockTime );
参数与返回值同上。
该功能将使软件定时器的重新开启定时,复位后的软件定时器以复位时的时刻作为开启时刻重新
定时。
5. 更改软件定时器定时时间
BaseType_t xTimerChangePeriod ( TimerHandle_t xTimer ,TickType_t xNewPeriod ,TickType_t xBlockTime );
xNewPeriod
:新的定时超时时间,单位:系统时钟节拍。
其余参数与返回值同上。
实操
实验需求
创建两个定时器:
定时器
1
,周期定时器,每
1
秒打印一次
CHL shuai
定时器
2
,单次定时器,启动后
2
秒打印一次
laochen shuai
cubeMX配置
代码实现
/* USER CODE BEGIN Header */
/**
******************************************************************************
* File Name : freertos.c
* Description : Code for freertos applications
******************************************************************************
* @attention
*
* Copyright (c) 2023 STMicroelectronics.
* All rights reserved.
*
* This software is licensed under terms that can be found in the LICENSE file
* in the root directory of this software component.
* If no LICENSE file comes with this software, it is provided AS-IS.
*
******************************************************************************
*/
/* USER CODE END Header */
/* Includes ------------------------------------------------------------------*/
#include "FreeRTOS.h"
#include "task.h"
#include "main.h"
#include "cmsis_os.h"
/* Private includes ----------------------------------------------------------*/
/* USER CODE BEGIN Includes */
#include "stdio.h"
/* USER CODE END Includes */
/* Private typedef -----------------------------------------------------------*/
/* USER CODE BEGIN PTD */
/* USER CODE END PTD */
/* Private define ------------------------------------------------------------*/
/* USER CODE BEGIN PD */
/* USER CODE END PD */
/* Private macro -------------------------------------------------------------*/
/* USER CODE BEGIN PM */
/* USER CODE END PM */
/* Private variables ---------------------------------------------------------*/
/* USER CODE BEGIN Variables */
/* USER CODE END Variables */
osThreadId defaultTaskHandle;
osTimerId myTimer01Handle;
osTimerId myTimer02Handle;
/* Private function prototypes -----------------------------------------------*/
/* USER CODE BEGIN FunctionPrototypes */
/* USER CODE END FunctionPrototypes */
void StartDefaultTask(void const * argument);
void Callback01(void const * argument);
void Callback02(void const * argument);
void MX_FREERTOS_Init(void); /* (MISRA C 2004 rule 8.1) */
/* GetIdleTaskMemory prototype (linked to static allocation support) */
void vApplicationGetIdleTaskMemory( StaticTask_t **ppxIdleTaskTCBBuffer, StackType_t **ppxIdleTaskStackBuffer, uint32_t *pulIdleTaskStackSize );
/* GetTimerTaskMemory prototype (linked to static allocation support) */
void vApplicationGetTimerTaskMemory( StaticTask_t **ppxTimerTaskTCBBuffer, StackType_t **ppxTimerTaskStackBuffer, uint32_t *pulTimerTaskStackSize );
/* USER CODE BEGIN GET_IDLE_TASK_MEMORY */
static StaticTask_t xIdleTaskTCBBuffer;
static StackType_t xIdleStack[configMINIMAL_STACK_SIZE];
void vApplicationGetIdleTaskMemory( StaticTask_t **ppxIdleTaskTCBBuffer, StackType_t **ppxIdleTaskStackBuffer, uint32_t *pulIdleTaskStackSize )
{
*ppxIdleTaskTCBBuffer = &xIdleTaskTCBBuffer;
*ppxIdleTaskStackBuffer = &xIdleStack[0];
*pulIdleTaskStackSize = configMINIMAL_STACK_SIZE;
/* place for user code */
}
/* USER CODE END GET_IDLE_TASK_MEMORY */
/* USER CODE BEGIN GET_TIMER_TASK_MEMORY */
static StaticTask_t xTimerTaskTCBBuffer;
static StackType_t xTimerStack[configTIMER_TASK_STACK_DEPTH];
void vApplicationGetTimerTaskMemory( StaticTask_t **ppxTimerTaskTCBBuffer, StackType_t **ppxTimerTaskStackBuffer, uint32_t *pulTimerTaskStackSize )
{
*ppxTimerTaskTCBBuffer = &xTimerTaskTCBBuffer;
*ppxTimerTaskStackBuffer = &xTimerStack[0];
*pulTimerTaskStackSize = configTIMER_TASK_STACK_DEPTH;
/* place for user code */
}
/* USER CODE END GET_TIMER_TASK_MEMORY */
/**
* @brief FreeRTOS initialization
* @param None
* @retval None
*/
void MX_FREERTOS_Init(void) {
/* USER CODE BEGIN Init */
/* USER CODE END Init */
/* USER CODE BEGIN RTOS_MUTEX */
/* add mutexes, ... */
/* USER CODE END RTOS_MUTEX */
/* USER CODE BEGIN RTOS_SEMAPHORES */
/* add semaphores, ... */
/* USER CODE END RTOS_SEMAPHORES */
/* Create the timer(s) */
/* definition and creation of myTimer01 */
osTimerDef(myTimer01, Callback01);
myTimer01Handle = osTimerCreate(osTimer(myTimer01), osTimerPeriodic, NULL);
/* definition and creation of myTimer02 */
osTimerDef(myTimer02, Callback02);
myTimer02Handle = osTimerCreate(osTimer(myTimer02), osTimerOnce, NULL);
/* USER CODE BEGIN RTOS_TIMERS */
/* start timers, add new ones, ... */
/* USER CODE END RTOS_TIMERS */
/* USER CODE BEGIN RTOS_QUEUES */
/* add queues, ... */
/* USER CODE END RTOS_QUEUES */
/* Create the thread(s) */
/* definition and creation of defaultTask */
osThreadDef(defaultTask, StartDefaultTask, osPriorityNormal, 0, 128);
defaultTaskHandle = osThreadCreate(osThread(defaultTask), NULL);
/* USER CODE BEGIN RTOS_THREADS */
/* add threads, ... */
/* USER CODE END RTOS_THREADS */
}
/* USER CODE BEGIN Header_StartDefaultTask */
/**
* @brief Function implementing the defaultTask thread.
* @param argument: Not used
* @retval None
*/
/* USER CODE END Header_StartDefaultTask */
void StartDefaultTask(void const * argument)
{
/* USER CODE BEGIN StartDefaultTask */
//osTimerStart(myTimer01Handle, 1000);
xTimerChangePeriod(myTimer01Handle, pdMS_TO_TICKS(1000), 0);
osTimerStart(myTimer02Handle, 2000);
/* Infinite loop */
for(;;)
{
osDelay(1);
}
/* USER CODE END StartDefaultTask */
}
/* Callback01 function */
void Callback01(void const * argument)
{
/* USER CODE BEGIN Callback01 */
printf("liangxu shuai\r\n");
/* USER CODE END Callback01 */
}
/* Callback02 function */
void Callback02(void const * argument)
{
/* USER CODE BEGIN Callback02 */
printf("laochen shuai\r\n");
/* USER CODE END Callback02 */
}
/* Private application code --------------------------------------------------*/
/* USER CODE BEGIN Application */
/* USER CODE END Application */