单片机与物联网 / 系统课时
队列传递数据
队列传递数据
本课使用 FreeRTOS 队列在任务之间传递传感器数据,并通过阻塞等待避免轮询占用 CPU。完成示例后,你将能够创建队列、发送结构体消息、接收数据,并正确处理队列已满或暂时为空的情况。
学习目标
- 理解队列复制消息和先进先出的工作方式
- 使用
xQueueSend与xQueueReceive传递结构体数据 - 根据实时性要求设置阻塞等待时间
队列如何连接多个任务
FreeRTOS 队列是内核管理的消息缓冲区。发送任务把数据复制到队列,接收任务再从队列取出副本,因此双方不需要同时执行,也不必共享同一块可变内存。

创建队列时必须同时确定消息数量和单条消息大小。例如,一个长度为 5 的传感器队列最多保存 5 个 SensorData_t 对象。队列中保存的是数据副本,不是局部变量地址。
创建并使用传感器队列
以下为片段示例,依赖 STM32CubeMX 已生成 HAL、串口和 FreeRTOS 基础工程,并在启动调度器前调用 AppTaskCreate()。示例中的 printf 还需要完成串口重定向。
#include "FreeRTOS.h"
#include "task.h"
#include "queue.h"
#include <stdint.h>
#include <stdio.h>
typedef struct {
uint32_t sequence;
int16_t temperature_x10;
uint16_t humidity_x10;
} SensorData_t;
static QueueHandle_t sensorQueue;
static void SensorTask(void *argument)
{
SensorData_t data = {0};
for (;;) {
data.sequence++;
data.temperature_x10 = 253;
data.humidity_x10 = 618;
/* 最多等待 20 ms,避免队列长期满时永久卡住采集任务。 */
if (xQueueSend(sensorQueue, &data, pdMS_TO_TICKS(20)) != pdPASS) {
printf("queue full, sequence=%lu\r\n",
(unsigned long)data.sequence);
}
vTaskDelay(pdMS_TO_TICKS(1000));
}
}
static void ProcessTask(void *argument)
{
SensorData_t received;
for (;;) {
/* 队列为空时阻塞,不使用循环查询消耗 CPU。 */
if (xQueueReceive(sensorQueue, &received, portMAX_DELAY) == pdPASS) {
printf("seq=%lu, temperature=%d.%d C, humidity=%u.%u%%\r\n",
(unsigned long)received.sequence,
received.temperature_x10 / 10,
received.temperature_x10 % 10,
received.humidity_x10 / 10,
received.humidity_x10 % 10);
}
}
}
void AppTaskCreate(void)
{
sensorQueue = xQueueCreate(5, sizeof(SensorData_t));
configASSERT(sensorQueue != NULL);
xTaskCreate(SensorTask, "sensor", 256, NULL, 2, NULL);
xTaskCreate(ProcessTask, "process", 256, NULL, 2, NULL);
}预期输出
seq=1, temperature=25.3 C, humidity=61.8%
seq=2, temperature=25.3 C, humidity=61.8%
seq=3, temperature=25.3 C, humidity=61.8%序号会持续增加,实际输出间隔还会受系统节拍和串口发送时间影响。若处理任务长期来不及接收,发送端可能输出 queue full。
阻塞时间如何选择
xQueueSend 和 xQueueReceive 的最后一个参数都是最大等待节拍数。传入 0 表示立即返回,传入 pdMS_TO_TICKS(20) 表示最多等待约 20 毫秒,传入 portMAX_DELAY 通常表示一直等待到条件满足。
接收任务没有其他工作时,可以使用 portMAX_DELAY。周期采集、通信应答等不能无限停顿的任务,应设置有限超时,并在失败分支中记录、丢弃或重试。
队列会复制整个消息。消息结构体过大或发送频率很高时,会增加内存占用和复制开销。大块数据通常改为传递缓冲区指针,但必须额外设计内存所有权和释放时机。
常见错误与检查方法
不要在发送后继续修改并误以为队列中的内容会同步变化;队列已经保存了发送瞬间的副本。也不要把 sizeof(pointer) 当成结构体大小,否则队列槽位会小于实际消息。
调试时先检查队列句柄是否创建成功,再观察 xQueueSend 和 xQueueReceive 的返回值。还可以使用 uxQueueMessagesWaiting() 查看当前积压消息数量,判断生产速度是否长期高于消费速度。