嵌入式 Linux 与 RTOS / 系统课时
用队列传递结构化消息
用队列传递结构化消息
FreeRTOS 队列可以让任务在不共享可变缓冲区的情况下交换结构化数据。本节会创建固定长度队列,完成结构体发送、接收和队列满处理,并据此判断什么时候适合按值传消息,什么时候应该改传句柄或指针。
学习目标
- 创建固定长度队列并发送、接收结构体消息
- 使用等待时间处理接收超时和队列已满情况
- 根据消息大小和生命周期选择按值复制、句柄或指针
队列保存的是消息副本
调用 xQueueCreate() 时需要同时确定队列长度和单个元素大小。之后调用 xQueueSend(),FreeRTOS 会把指定大小的数据复制到队列存储区;xQueueReceive() 再把队首元素复制到接收方提供的缓冲区。

这种按值复制让生产者和消费者各自拥有数据副本,任务之间不必围绕同一块消息内存加锁,也不会因为生产者随后修改局部变量而改变已经入队的数据。代价是每次发送和接收都需要复制 uxItemSize 字节,并且队列本身要为所有槽位预留存储空间。
创建队列并处理队列满
下面示例假设工程已经接入 FreeRTOS,并且 printf() 已重定向到串口或控制台。队列只有两个槽位,生产者优先级高于消费者,因此生产者连续以零等待时间发送三条消息时,第三条会稳定遇到队列已满。
#include <stdio.h>
#include "FreeRTOS.h"
#include "task.h"
#include "queue.h"
typedef struct {
unsigned int id;
int temperature_x10;
} SensorMessage;
static QueueHandle_t sensorQueue;
static void ProducerTask(void *argument)
{
(void)argument;
for (unsigned int i = 1; i <= 3; ++i) {
SensorMessage message = {i, 250 + (int)i};
// 零等待时间用于明确演示队列满分支。
if (xQueueSend(sensorQueue, &message, 0) == pdPASS) {
printf("send id=%u ok\n", message.id);
} else {
printf("send id=%u queue-full\n", message.id);
}
}
vTaskDelete(NULL);
}
static void ConsumerTask(void *argument)
{
(void)argument;
SensorMessage message;
for (int i = 0; i < 2; ++i) {
if (xQueueReceive(sensorQueue, &message, pdMS_TO_TICKS(1000)) == pdPASS) {
printf("recv id=%u temp=%d\n", message.id, message.temperature_x10);
} else {
puts("receive timeout");
}
}
vTaskDelete(NULL);
}
int main(void)
{
sensorQueue = xQueueCreate(2, sizeof(SensorMessage));
if (sensorQueue == NULL) {
puts("queue create failed");
return 1;
}
xTaskCreate(ConsumerTask, "consumer", 256, NULL, 1, NULL);
xTaskCreate(ProducerTask, "producer", 256, NULL, 2, NULL);
vTaskStartScheduler();
for (;;) {
}
}预期输出
send id=1 ok
send id=2 ok
send id=3 queue-full
recv id=1 temp=251
recv id=2 temp=252这里 xQueueSend(..., 0) 不等待空闲槽位,因此队列满时立即返回失败。消费者则使用 pdMS_TO_TICKS(1000) 等待最多一秒;如果期限内仍没有消息,xQueueReceive() 返回失败,程序可以记录超时、执行降级逻辑或继续等待。
用等待时间表达实时策略
队列 API 的等待参数并不只是“防止报错”,它实际表达任务愿意为通信等待多久。零等待适合不能被通信拖住的采样或状态机任务;有限等待适合允许短暂背压的业务;portMAX_DELAY 在相应配置允许时可用于一直等待事件的消费者。
处理失败时不要忽略返回值。队列满意味着生产速度暂时超过消费速度,可能需要增加队列深度、降低生产速率、提高消费者处理能力,或者明确采用丢弃旧数据、丢弃新数据等业务策略。接收超时则常用于检测上游失联或触发周期性维护动作。
控制按值复制的成本
小型控制消息非常适合直接放进队列,例如状态码、传感器读数、事件编号和少量参数。它们复制成本低,而且消息生命周期完全由队列管理,发送者可以安全复用自己的局部变量。
如果消息包含数 KB 图像块、音频帧或大型协议缓冲区,直接把整个对象作为队列元素会增加 RAM 占用和复制时间。此时通常让队列传递一个较小的句柄或指针,再由内存池、静态缓冲区或其他明确的所有权机制管理真实数据。
使用指针后,队列只保证“指针值”的并发传递安全,并不会自动解决指针所指内存的生命周期。发送者不能在消费者使用前释放或复用那块缓冲区。选择方案时可以遵循一个简单原则:消息小且希望所有权简单时按值复制;数据大且复制成本不可接受时传引用,但必须先设计清楚谁分配、谁释放以及何时允许复用。