单片机与物联网 / 系统课时
创建与管理任务
创建与管理任务
本课完成一个可运行的双任务 FreeRTOS 工程:在 CubeMX 中创建两个任务,设置优先级与栈空间,再通过串口日志观察任务交替执行。完成后,你将能够独立新增任务并检查基本调度是否正常。
学习目标
- 在 CubeMX 中创建并配置 FreeRTOS 任务
- 根据任务职责设置优先级和栈空间
- 通过串口输出验证任务创建与切换结果
前置检查
准备一个已能正常下载和运行的 STM32CubeIDE 工程,并确认系统时钟、调试接口和一个串口已经配置完成。本例采用 CMSIS-RTOS v2 接口,任务分别负责周期输出和状态输出。
串口重定向方式因芯片和工程模板不同而异。开始前应先确认 printf 能从目标串口输出,否则任务运行正常时也看不到日志。
在 CubeMX 中创建任务
在 CubeMX 的 Middleware and Software Packs 中启用 FreeRTOS,接口选择 CMSIS_V2。随后进入 Tasks and Queues 页面,保留默认任务或删除后重新创建两个任务。
建议创建如下两个任务:
| 任务名 | 入口函数 | 优先级 | 栈空间 | 周期 |
|---|---|---|---|---|
LedTask |
StartLedTask |
Normal | 256 Words | 500 ms |
LogTask |
StartLogTask |
BelowNormal | 256 Words | 1000 ms |
栈空间单位通常是 Word,而不是 Byte。以 32 位 Cortex-M 为例,256 Words 约等于 1024 Bytes。包含较大局部数组、复杂格式化输出或多层函数调用的任务,需要预留更多栈空间。
编写任务函数
下面是片段示例,需要放入 CubeMX 生成工程的用户代码区域,并确保工程已经完成 HAL、系统时钟、串口和 FreeRTOS 初始化。不要把自定义代码写到生成器会覆盖的区域之外标记中。
#include "cmsis_os2.h"
#include <stdint.h>
#include <stdio.h>
static uint32_t MsToTicks(uint32_t milliseconds)
{
const uint32_t tick_freq = osKernelGetTickFreq();
return (milliseconds * tick_freq + 999U) / 1000U;
}
void StartLedTask(void *argument)
{
(void)argument;
for (;;)
{
printf("LedTask running\r\n");
osDelay(MsToTicks(500U));
}
}
void StartLogTask(void *argument)
{
(void)argument;
for (;;)
{
printf("LogTask running\r\n");
osDelay(MsToTicks(1000U));
}
}预期输出如下,实际行顺序可能因任务首次启动时刻不同而略有变化:
LedTask running
LogTask running
LedTask running
LedTask running
LogTask running两个任务每次输出后都调用 osDelay 进入阻塞态,使调度器可以运行其他就绪任务。MsToTicks 根据内核节拍频率换算毫秒,避免直接假设一个 Tick 等于 1 ms。这里没有使用空转延时,因为空转会持续占用 CPU。
生成、运行与观察切换
点击 Generate Code 生成工程,编译并下载到开发板,然后打开串口终端。串口参数应与工程配置一致,例如波特率 115200、8 位数据位、无校验和 1 位停止位。
若日志持续交替出现,说明两个任务均已创建并能在延时结束后重新进入就绪态。LedTask 周期更短,所以在相同时间内输出次数更多;它的优先级也高于 LogTask,两者同时就绪时会优先运行。
常见问题与调整方法
完全没有输出时,先验证串口重定向和波特率,再确认 osKernelStart 已执行。只看到一个任务输出时,检查另一个任务是否创建成功、是否进入死循环且没有阻塞,以及任务栈是否过小。
出现 HardFault、随机重启或日志异常时,应优先增大任务栈,并启用 FreeRTOS 的栈溢出检查。任务优先级不要全部设得很高,高优先级任务也必须通过 osDelay、队列或信号量适时阻塞。
修改任务配置后应重新生成代码并再次编译。若自定义代码被覆盖,说明它没有放在 CubeMX 保留的用户代码区域中。