stm32裸机开发下利用MultiTimer多任务时间片询
- 📌
MultiTimer
Github地址:https://github.com/0x1abin/MultiTimer
- ✨这是一个类似Arduino平台上的
Ticker
库,如需阅读懂源码,起码需要有链表知识的储备,如果仅仅只是拿来使用,那就忽略具体实现的方法。
📑MultiTimer简介
MultiTimer 是一个软件定时器扩展模块,可无限扩展你所需的定时器任务,取代传统的标志位判断方式, 更优雅更便捷地管理程序的时间触发时序。
⛳使用注意事项说明
- 定时器的时钟频率直接影响定时器的精确度,尽可能采用1ms/5ms/10ms这几个精度较高的tick;
- 定时器的回调函数内不应执行耗时操作,否则可能因占用过长的时间,导致其他定时器无法正常超时;
- 由于定时器的回调函数是在
MultiTimerYield()
内执行的,需要注意栈空间的使用不能过大,否则可能会导致栈溢出。
基于stm32f103,使用stm32cubemx配置的工程案例
- 🔖为了省事,直接将其驱动文件分别拷贝到项目
MultiTimer_Task\Core\Inc
和MultiTimer_Task\Core\Src
下。 - 🌿在所创建好的工程中添加源文件(
MultiTimer.c
),右键其文件属性-设置为c源文件
。
-
📓将系统的滴答定时器作为MultiTimer多任务时间片询的时基。
-
🌿main.c程序示例代码
/* USER CODE BEGIN Header */
/**
******************************************************************************
* @file : main.c
* @brief : Main program body
******************************************************************************
* @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 "main.h"
#include "usart.h"
#include "gpio.h"
/* Private includes ----------------------------------------------------------*/
/* USER CODE BEGIN Includes */
#include <stdio.h>
#include "MultiTimer.h"
/* USER CODE END Includes */
/* Private typedef -----------------------------------------------------------*/
/* USER CODE BEGIN PTD */
/* USER CODE END PTD */
/* Private define ------------------------------------------------------------*/
/* USER CODE BEGIN PD */
MultiTimer timer1;//创建任务对象
MultiTimer timer2;
MultiTimer timer3;
/* USER CODE END PD */
/* Private macro -------------------------------------------------------------*/
/* USER CODE BEGIN PM */
/* USER CODE END PM */
/* Private variables ---------------------------------------------------------*/
/* USER CODE BEGIN PV */
/* USER CODE END PV */
/* Private function prototypes -----------------------------------------------*/
void SystemClock_Config(void);
/* USER CODE BEGIN PFP */
uint64_t PlatformTicksGetFunc(void)
{
return (uint64_t)HAL_GetTick();
}
/* USER CODE END PFP */
/* Private user code ---------------------------------------------------------*/
/* USER CODE BEGIN 0 */
void exampleTimer1Callback(MultiTimer* timer, void* userData)
{
//回调函数1
printf("[TASK1] Timer:%p callback-> %s.\r\n", timer, (char*)userData);
MultiTimerStart(timer, 1000, exampleTimer1Callback, userData);
HAL_GPIO_TogglePin(GPIOE, GPIO_PIN_5);
}
void exampleTimer2Callback(MultiTimer* timer, void* userData)
{
//回调函数2
printf("[TASK2] Timer:%p callback-> %s.\r\n", timer, (char*)userData);
HAL_GPIO_TogglePin(GPIOB, GPIO_PIN_5);
}
void exampleTimer3Callback(MultiTimer* timer, void* userData)
{
//回调函数3
printf("[TASK3] Timer:%p callback-> %s.\r\n", timer, (char*)userData);
MultiTimerStart(timer, 4567, exampleTimer3Callback, userData);//初始化并启动Timer
HAL_GPIO_TogglePin(GPIOE, GPIO_PIN_6);
}
/* USER CODE END 0 */
/**
* @brief The application entry point.
* @retval int
*/
int main(void)
{
/* USER CODE BEGIN 1 */
/* USER CODE END 1 */
/* MCU Configuration--------------------------------------------------------*/
/* Reset of all peripherals, Initializes the Flash interface and the Systick. */
HAL_Init();
/* USER CODE BEGIN Init */
/* USER CODE END Init */
/* Configure the system clock */
SystemClock_Config();
/* USER CODE BEGIN SysInit */
/* USER CODE END SysInit */
/* Initialize all configured peripherals */
MX_GPIO_Init();
MX_USART1_UART_Init();
/* USER CODE BEGIN 2 */
MultiTimerInstall(PlatformTicksGetFunc);
MultiTimerStart(&timer1, 1000, exampleTimer1Callback, "1000ms CYCLE timer");
MultiTimerStart(&timer2, 5000, exampleTimer2Callback, "5000ms ONCE timer");
MultiTimerStart(&timer3, 3456, exampleTimer3Callback, "3456ms delay start, 4567ms CYCLE timer");
/* USER CODE END 2 */
/* Infinite loop */
/* USER CODE BEGIN WHILE */
while(1)
{
/* USER CODE END WHILE */
/* USER CODE BEGIN 3 */
MultiTimerYield();
}
/* USER CODE END 3 */
}
/**
* @brief System Clock Configuration
* @retval None
*/
void SystemClock_Config(void)
{
RCC_OscInitTypeDef RCC_OscInitStruct = {0};
RCC_ClkInitTypeDef RCC_ClkInitStruct = {0};
/** Initializes the RCC Oscillators according to the specified parameters
* in the RCC_OscInitTypeDef structure.
*/
RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSE;
RCC_OscInitStruct.HSEState = RCC_HSE_ON;
RCC_OscInitStruct.HSEPredivValue = RCC_HSE_PREDIV_DIV1;
RCC_OscInitStruct.HSIState = RCC_HSI_ON;
RCC_OscInitStruct.PLL.PLLState = RCC_PLL_ON;
RCC_OscInitStruct.PLL.PLLSource = RCC_PLLSOURCE_HSE;
RCC_OscInitStruct.PLL.PLLMUL = RCC_PLL_MUL9;
if(HAL_RCC_OscConfig(&RCC_OscInitStruct) != HAL_OK)
{
Error_Handler();
}
/** Initializes the CPU, AHB and APB buses clocks
*/
RCC_ClkInitStruct.ClockType = RCC_CLOCKTYPE_HCLK | RCC_CLOCKTYPE_SYSCLK
| RCC_CLOCKTYPE_PCLK1 | RCC_CLOCKTYPE_PCLK2;
RCC_ClkInitStruct.SYSCLKSource = RCC_SYSCLKSOURCE_PLLCLK;
RCC_ClkInitStruct.AHBCLKDivider = RCC_SYSCLK_DIV1;
RCC_ClkInitStruct.APB1CLKDivider = RCC_HCLK_DIV2;
RCC_ClkInitStruct.APB2CLKDivider = RCC_HCLK_DIV1;
if(HAL_RCC_ClockConfig(&RCC_ClkInitStruct, FLASH_LATENCY_2) != HAL_OK)
{
Error_Handler();
}
}
/* USER CODE BEGIN 4 */
/* USER CODE END 4 */
/**
* @brief This function is executed in case of error occurrence.
* @retval None
*/
void Error_Handler(void)
{
/* USER CODE BEGIN Error_Handler_Debug */
/* User can add his own implementation to report the HAL error return state */
__disable_irq();
while(1)
{
}
/* USER CODE END Error_Handler_Debug */
}
#ifdef USE_FULL_ASSERT
/**
* @brief Reports the name of the source file and the source line number
* where the assert_param error has occurred.
* @param file: pointer to the source file name
* @param line: assert_param error line source number
* @retval None
*/
void assert_failed(uint8_t* file, uint32_t line)
{
/* USER CODE BEGIN 6 */
/* User can add his own implementation to report the file name and line number,
ex: printf("Wrong parameters value: file %s on line %d\r\n", file, line) */
/* USER CODE END 6 */
}
#endif /* USE_FULL_ASSERT */
- 📜串口调试信息输出:
📚示例工程源码
- 🏳🌈基于STM32CubeMX配置的stm32f103vc工程示例代码
链接: https://pan.baidu.com/s/1KbhfdzvpuUklwqboo3bAZQ
提取码: bfkb
基于定时器自定义多任务实现框架
简单多任务
- 定义任务结构体
定义一个任务结构体,包含任务的状态、标志、执行函数指针、执行间隔和上次执行时间等信息。
typedef struct {
void (*TaskFunction)(void); // 任务函数指针
uint32_t Interval; // 任务执行间隔(ms)
uint32_t LastRun; // 上次执行时间
uint8_t State; // 任务状态(例如:0-未运行,1-运行中)
uint8_t Flag; // 任务标志(例如:0-未就绪,1-就绪)
} Task_t;
- 创建任务数组
创建一个任务数组,用于存储所有需要调度的任务。
#define MAX_TASKS 10
Task_t Tasks[MAX_TASKS]; // 任务数组
uint8_t TaskCount = 0; // 当前任务数量
- 添加任务函数
实现一个函数,用于向任务数组中添加任务。
void AddTask(void (*TaskFunction)(void), uint32_t Interval, uint8_t State, uint8_t Flag) {
if (TaskCount < MAX_TASKS) {
Tasks[TaskCount].TaskFunction = TaskFunction;
Tasks[TaskCount].Interval = Interval;
Tasks[TaskCount].LastRun = 0;
Tasks[TaskCount].State = State;
Tasks[TaskCount].Flag = Flag;
TaskCount++;
}
}
- 实现任务调度
在定时器中断服务程序(ISR)中,遍历任务数组,检查每个任务是否需要执行。根据任务的状态和标志决定是否执行任务。
void TIM2_IRQHandler(void) {
if (TIM_GetITStatus(TIM2, TIM_IT_Update) != RESET) {
TIM_ClearITPendingBit(TIM2, TIM_IT_Update);
static uint32_t Tick = 0;
Tick++;
for (uint8_t i = 0; i < TaskCount; i++) {
// 检查任务是否就绪且状态为运行中
if (Tasks[i].Flag == 1 && Tasks[i].State == 1) {
if (Tick - Tasks[i].LastRun >= Tasks[i].Interval) {
Tasks[i].TaskFunction(); // 执行任务
Tasks[i].LastRun = Tick; // 更新上次执行时间
}
}
}
}
}
- 添加任务
在主函数中,添加需要调度的任务,并初始化任务的状态和标志。
void Task1(void) {
// 任务1的代码
printf("Task1 is running...\n");
}
void Task2(void) {
// 任务2的代码
printf("Task2 is running...\n");
}
int main(void) {
TIM2_Init();
// 添加任务
AddTask(Task1, 100, 1, 1); // Task1,每100ms执行一次,状态为运行中,标志为就绪
AddTask(Task2, 500, 1, 1); // Task2,每500ms执行一次,状态为运行中,标志为就绪
while (1) {
// 主循环
}
}
- 动态修改任务状态和标志
可以通过函数动态修改任务的状态和标志,以控制任务的执行。
void SetTaskState(uint8_t TaskID, uint8_t State) {
if (TaskID < TaskCount) {
Tasks[TaskID].State = State;
}
}
void SetTaskFlag(uint8_t TaskID, uint8_t Flag) {
if (TaskID < TaskCount) {
Tasks[TaskID].Flag = Flag;
}
}
例如,在主循环中动态控制任务的执行:
int main(void) {
TIM2_Init();
// 添加任务
AddTask(Task1, 100, 1, 1); // Task1,每100ms执行一次,状态为运行中,标志为就绪
AddTask(Task2, 500, 1, 1); // Task2,每500ms执行一次,状态为运行中,标志为就绪
while (1) {
// 动态控制任务
if (some_condition) {
SetTaskState(0, 0); // 暂停Task1
SetTaskFlag(0, 0); // 取消Task1的就绪标志
} else {
SetTaskState(0, 1); // 恢复Task1
SetTaskFlag(0, 1); // 设置Task1的就绪标志
}
}
}
- 扩展功能
可以根据需要扩展任务结构体,例如:
- 添加任务优先级字段。
添加任务名称或ID字段。
添加任务超时机制。
扩展任务结构体
- 在任务结构体中增加超时相关的字段,例如:
typedef struct {
void (*TaskFunction)(void); // 任务函数指针
uint32_t Interval; // 任务执行间隔(ms)
uint32_t LastRun; // 上次执行时间
uint8_t State; // 任务状态(例如:0-未运行,1-运行中)
uint8_t Flag; // 任务标志(例如:0-未就绪,1-就绪)
uint32_t Timeout; // 任务超时时间(ms)
uint32_t StartTime; // 任务开始执行的时间戳
uint8_t TimeoutFlag; // 任务超时标志(例如:0-未超时,1-超时)
} Task_t;
- 在任务调度中检测超时
在定时器中断服务程序(ISR)或主循环中,检查任务的执行时间是否超过设定的超时时间。
- 方法 1:在定时器中断中检测
在定时器中断中,遍历任务数组,检查任务的执行时间是否超时。
void TIM2_IRQHandler(void) {
if (TIM_GetITStatus(TIM2, TIM_IT_Update) != RESET) {
TIM_ClearITPendingBit(TIM2, TIM_IT_Update);
static uint32_t Tick = 0;
Tick++;
for (uint8_t i = 0; i < TaskCount; i++) {
// 检查任务是否正在运行
if (Tasks[i].State == 1 && Tasks[i].Flag == 1) {
// 检查任务是否超时
if (Tick - Tasks[i].StartTime > Tasks[i].Timeout) {
Tasks[i].TimeoutFlag = 1; // 标记任务超时
Tasks[i].State = 0; // 停止任务
printf("Task %d timeout!\n", i);
}
}
// 正常调度任务
if (Tasks[i].Flag == 1 && Tasks[i].State == 1) {
if (Tick - Tasks[i].LastRun >= Tasks[i].Interval) {
Tasks[i].StartTime = Tick; // 记录任务开始时间
Tasks[i].TaskFunction(); // 执行任务
Tasks[i].LastRun = Tick; // 更新上次执行时间
}
}
}
}
}
- 方法 2:在主循环中检测
在主循环中,定期检查任务的执行时间是否超时.
int main(void) {
TIM2_Init();
// 添加任务
AddTask(Task1, 100, 1, 1, 500); // Task1,每100ms执行一次,超时时间为500ms
AddTask(Task2, 500, 1, 1, 1000); // Task2,每500ms执行一次,超时时间为1000ms
while (1) {
static uint32_t LastCheckTime = 0;
uint32_t CurrentTime = GetSystemTick(); // 获取当前系统时间
// 每隔一段时间检查任务超时
if (CurrentTime - LastCheckTime >= 100) { // 每100ms检查一次
LastCheckTime = CurrentTime;
for (uint8_t i = 0; i < TaskCount; i++) {
if (Tasks[i].State == 1 && Tasks[i].Flag == 1) {
if (CurrentTime - Tasks[i].StartTime > Tasks[i].Timeout) {
Tasks[i].TimeoutFlag = 1; // 标记任务超时
Tasks[i].State = 0; // 停止任务
printf("Task %d timeout!\n", i);
}
}
}
}
}
}
- 添加任务时初始化超时时间
在添加任务时,初始化任务的超时时间。
void AddTask(void (*TaskFunction)(void), uint32_t Interval, uint8_t State, uint8_t Flag, uint32_t Timeout) {
if (TaskCount < MAX_TASKS) {
Tasks[TaskCount].TaskFunction = TaskFunction;
Tasks[TaskCount].Interval = Interval;
Tasks[TaskCount].LastRun = 0;
Tasks[TaskCount].State = State;
Tasks[TaskCount].Flag = Flag;
Tasks[TaskCount].Timeout = Timeout;
Tasks[TaskCount].StartTime = 0;
Tasks[TaskCount].TimeoutFlag = 0;
TaskCount++;
}
}
- 处理超时任务
当检测到任务超时时,可以根据需求采取以下措施:
- 停止任务并记录错误日志。
重启任务。
触发系统复位或报警。
void HandleTimeoutTasks(void) {
for (uint8_t i = 0; i < TaskCount; i++) {
if (Tasks[i].TimeoutFlag == 1) {
printf("Task %d timeout! Taking corrective action...\n", i);
Tasks[i].TimeoutFlag = 0; // 清除超时标志
Tasks[i].State = 1; // 重启任务
Tasks[i].StartTime = GetSystemTick(); // 读取系统滴答定时器,重置任务开始时间
}
}
}
在主循环中调用该函数:
int main(void) {
TIM2_Init();
// 添加任务
AddTask(Task1, 100, 1, 1, 500); // Task1,每100ms执行一次,超时时间为500ms
AddTask(Task2, 500, 1, 1, 1000); // Task2,每500ms执行一次,超时时间为1000ms
while (1) {
HandleTimeoutTasks(); // 处理超时任务
}
}