从点灯到通信：基于STM32F103和FreeRTOS，手把手教你实现任务间消息队列与信号量
从点灯到通信：基于STM32F103和FreeRTOS构建多任务协作系统
在嵌入式开发中，裸机编程往往难以应对复杂的多任务需求。想象一下，当你的设备需要同时处理按键输入、LED显示、串口通信等多种功能时，传统的while(1)循环很快就会变得臃肿不堪。这正是实时操作系统(RTOS)大显身手的地方——它能让多个任务看似"同时"运行，而背后的任务调度、资源管理则由操作系统默默完成。
FreeRTOS作为一款轻量级RTOS，凭借其开源特性和丰富的功能组件，已成为STM32开发者的首选。本文将基于STM32F103和FreeRTOS，带你从简单的LED闪烁出发，逐步构建一个包含消息队列和信号量的多任务协作系统。不同于基础的移植教程，我们将重点探讨：
- 如何设计任务间的通信机制
- 共享资源的互斥访问实现
- 基于CubeMX的中间件配置技巧
- 实际工程中的内存管理注意事项
1. 环境搭建与基础任务创建
在开始之前，确保你已经准备好以下环境：
- STM32CubeMX 6.x或更高版本
- Keil MDK或IAR嵌入式工作台
- STM32F103C8T6开发板（蓝桥杯开发板或最小系统板均可）
- ST-Link调试器
1.1 CubeMX基础配置
启动CubeMX并新建工程，选择STM32F103C8系列芯片。关键配置步骤如下：
时钟配置：
RCC->HSE Enabled SYS->Debug Serial WireGPIO设置（用于LED和按键）：
PB0 -> GPIO_Output (LED1) PB1 -> GPIO_Output (LED2) PA0 -> GPIO_Input (按键KEY)FreeRTOS中间件启用：
- 在Middleware选项卡中选择FREERTOS
- 在Configuration选项卡中设置：
USE_PREEMPTIONEnabledTICK_RATE_HZ1000CHECK_FOR_STACK_OVERFLOW2
生成代码前的关键检查点：
- 确认系统时钟配置为72MHz
- FreeRTOS的时基源选择TIM2
- Heap大小至少设置为10240字节（后续消息队列需要）
提示：使用CubeMX生成代码后，建议立即编译一次确认基础环境无误，再开始添加自定义代码。
1.2 创建基础任务
我们先创建两个简单的LED闪烁任务作为基础：
void LED_Task1(void *argument) { for(;;) { HAL_GPIO_TogglePin(GPIOB, GPIO_PIN_0); osDelay(500); // 使用FreeRTOS的延时而非HAL_Delay } } void LED_Task2(void *argument) { for(;;) { HAL_GPIO_TogglePin(GPIOB, GPIO_PIN_1); osDelay(1000); } }在main.c的任务创建区域添加：
osThreadDef(LED1, LED_Task1, osPriorityNormal, 0, 128); osThreadDef(LED2, LED_Task2, osPriorityNormal, 0, 128); osThreadCreate(osThread(LED1), NULL); osThreadCreate(osThread(LED2), NULL);此时编译下载，应该能看到两个LED以不同频率独立闪烁，这验证了FreeRTOS的基本多任务功能已正常工作。
2. 消息队列实现任务通信
现在我们来升级系统——添加按键扫描任务，并通过消息队列将按键事件传递给LED控制任务。
2.1 消息队列创建与初始化
在FreeRTOSConfig.h中添加以下宏定义确保足够队列空间：
#define configQUEUE_REGISTRY_SIZE 8在main.c的全局变量区域创建消息队列：
osMessageQDef(key_queue, 5, uint8_t); // 队列深度5，存储uint8_t类型 osMessageQId key_queue_id;在main()函数初始化部分创建队列：
key_queue_id = osMessageCreate(osMessageQ(key_queue), NULL);2.2 按键扫描任务实现
创建按键扫描任务，将检测到的按键事件放入队列：
void Key_Scan_Task(void *argument) { uint8_t key_value = 0; for(;;) { if(HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_0) == GPIO_PIN_RESET) { osDelay(20); // 消抖 if(HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_0) == GPIO_PIN_RESET) { key_value = 1; // 按键按下事件 osMessagePut(key_queue_id, key_value, osWaitForever); while(HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_0) == GPIO_PIN_RESET); // 等待释放 } } osDelay(10); // 降低CPU占用 } }2.3 LED任务升级为事件驱动
修改LED任务，使其响应队列中的按键事件：
void LED_Task1(void *argument) { osEvent event; uint8_t led_pattern = 0; for(;;) { event = osMessageGet(key_queue_id, 100); // 100ms超时 if(event.status == osEventMessage) { led_pattern = (led_pattern + 1) % 4; // 切换4种显示模式 } switch(led_pattern) { case 0: // 模式0：正常闪烁 HAL_GPIO_TogglePin(GPIOB, GPIO_PIN_0); osDelay(500); break; case 1: // 模式1：快速闪烁 HAL_GPIO_TogglePin(GPIOB, GPIO_PIN_0); osDelay(200); break; // 其他模式... } } }2.4 消息队列的工程实践要点
在实际项目中使用消息队列时，有几个关键注意事项：
队列深度选择：
- 太浅会导致消息丢失
- 太深会浪费内存
- 经验公式：深度 ≥ (最大突发消息量 × 2)
消息超时处理：
- 发送/接收都应设置合理超时
- 避免任务永久阻塞
内存管理：
- 大消息建议传递指针而非拷贝
- 指针指向的内存需动态分配或全局变量
// 传递结构体指针的示例 typedef struct { uint8_t cmd; uint32_t param; } Message_t; osMessageQDef(msg_queue, 5, Message_t*); Message_t *msg = pvPortMalloc(sizeof(Message_t)); osMessagePut(msg_queue_id, (uint32_t)msg, osWaitForever);3. 信号量实现资源互斥
当多个任务需要访问共享资源（如串口）时，信号量是确保安全访问的关键机制。
3.1 二进制信号量创建
在main.c中创建串口访问信号量：
osSemaphoreDef(uart_sem); osSemaphoreId uart_sem_id; // 在main()中初始化 uart_sem_id = osSemaphoreCreate(osSemaphore(uart_sem), 1);3.2 串口打印任务示例
创建两个竞争使用串口的任务：
void Task_Print1(void *argument) { for(;;) { if(osSemaphoreWait(uart_sem_id, 100) == osOK) { printf("Task1 printing at %lu ms\r\n", osKernelSysTick()); osSemaphoreRelease(uart_sem_id); } osDelay(500); } } void Task_Print2(void *argument) { for(;;) { if(osSemaphoreWait(uart_sem_id, 100) == osOK) { printf("Task2 printing at %lu ms\r\n", osKernelSysTick()); osSemaphoreRelease(uart_sem_id); } osDelay(300); } }3.3 信号量使用的最佳实践
获取-释放对称：
- 每个
osSemaphoreWait必须对应一个osSemaphoreRelease - 建议使用RAII模式封装
- 每个
优先级反转问题：
- 高优先级任务等待低优先级任务持有的信号量
- 解决方案：优先级继承或天花板协议
// CubeMX中启用优先级继承 #define configUSE_MUTEXES 1 #define configUSE_PRIORITY_INHERITANCE 1- 死锁预防：
- 避免嵌套获取多个信号量
- 如果需要，确保所有任务以相同顺序获取
4. 系统调试与性能优化
一个健壮的RTOS应用离不开有效的调试手段和性能优化。
4.1 FreeRTOS调试技巧
任务状态监控：
// 在任意任务中打印任务列表 char buffer[512]; vTaskList(buffer); printf("Task List:\r\n%s", buffer);堆栈使用检查：
// 在FreeRTOSConfig.h中启用 #define configCHECK_FOR_STACK_OVERFLOW 2 // 实现溢出钩子函数 void vApplicationStackOverflowHook(TaskHandle_t xTask, char *pcTaskName) { printf("Stack overflow in task %s\r\n", pcTaskName); while(1); }4.2 性能优化关键指标
任务切换时间测量：
uint32_t start, end; start = osKernelSysTick(); // 执行任务切换���关操作 end = osKernelSysTick(); printf("Context switch time: %lu us\r\n", (end-start)*1000/osKernelSysTickFrequency);内存使用统计：
// 需要启用heap_3.c或heap_4.c size_t free_heap = xPortGetFreeHeapSize(); printf("Free heap: %u bytes\r\n", free_heap);4.3 常见问题排查表
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| 任务不运行 | 优先级设置过低 | 提高任务优先级 |
| 队列发送失败 | 队列已满 | 增加队列深度或检查接收端 |
| 系统卡死 | 堆栈溢出 | 增大任务堆栈大小 |
| 随机复位 | 内存访问冲突 | 检查指针使用和内存分配 |
4.4 实时性保障措施
合理设置任务优先级：
- 关键任务给予更高优先级
- 但避免过多高优先级任务
中断服务例程优化：
- ISR中只做最必要的操作
- 耗时操作通过任务通知延迟处理
// 示例：在HAL库中断回调中发送任务通知 void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin) { BaseType_t xHigherPriorityTaskWoken = pdFALSE; vTaskNotifyGiveFromISR(xTaskHandle, &xHigherPriorityTaskWoken); portYIELD_FROM_ISR(xHigherPriorityTaskWoken); }通过以上步骤，我们构建了一个包含任务通信和资源管理的完整FreeRTOS应用框架。在实际项目中，这种架构可以轻松扩展支持更复杂的业务逻辑，而不会陷入裸机编程中常见的事件处理混乱。