单片机与物联网 / 系统课时
使用队列传递数据
使用队列传递数据
多个 FreeRTOS 任务不能靠随意读写同一个全局变量来传递连续数据。这里用队列把“采集”和“显示”解耦:采集任务发送一份数据快照,显示任务阻塞等待并按顺序接收,从而避免轮询和大部分共享数据竞争。
学习目标
- 使用
xQueueCreate()创建固定长度的 FreeRTOS 队列 - 使用
xQueueSend()和xQueueReceive()在两个任务之间传递结构体数据 - 根据队列为空、已满和数据大小选择合适的等待策略
队列为什么比共享变量更适合任务通信
如果采集任务不断覆盖一个全局结构体,显示任务可能在字段尚未全部更新时读到数据,还需要额外的互斥保护。FreeRTOS 队列把“同步”和“传值”合并到同一套 API:发送成功时,队列会复制一份固定大小的数据;接收任务可以在队列为空时阻塞,不需要持续轮询。

队列创建时必须确定两个值:最多容纳多少个元素,以及每个元素占多少字节。本例使用长度为 5 的队列保存 SensorSample。因为队列按值复制结构体,发送函数返回后,采集任务可以继续复用自己的局部变量。
建立采集任务和显示任务
下面的 Arduino 草图不依赖真实传感器,而是生成递增的模拟温度,便于直接验证队列行为。采集任务每 500 ms 发送一次,显示任务通过 portMAX_DELAY 阻塞等待,不会空转占用 CPU。
#include <Arduino.h>
struct SensorSample {
uint32_t sequence;
float temperature;
};
QueueHandle_t sampleQueue = nullptr;
void samplingTask(void* parameter) {
uint32_t sequence = 0;
for (;;) {
++sequence;
SensorSample sample{
sequence,
24.0f + static_cast<float>(sequence) * 0.1f
};
// 队列会复制整个 SensorSample;满队列时最多等待 100 ms。
if (xQueueSend(sampleQueue, &sample, pdMS_TO_TICKS(100)) != pdPASS) {
Serial.println("queue full: sample dropped");
}
vTaskDelay(pdMS_TO_TICKS(500));
}
}
void displayTask(void* parameter) {
SensorSample sample{};
for (;;) {
// 队列为空时阻塞,直到下一条样本到达。
if (xQueueReceive(sampleQueue, &sample, portMAX_DELAY) == pdPASS) {
Serial.printf(
"display seq=%lu temp=%.1f C\n",
static_cast<unsigned long>(sample.sequence),
sample.temperature
);
}
}
}
void setup() {
Serial.begin(115200);
delay(1000);
// 固定长度队列由 FreeRTOS 负责发送与接收操作的同步。
sampleQueue = xQueueCreate(5, sizeof(SensorSample));
if (sampleQueue == nullptr) {
Serial.println("queue creation failed");
return;
}
BaseType_t samplingResult = xTaskCreate(
samplingTask, "samplingTask", 2048, nullptr, 2, nullptr
);
BaseType_t displayResult = xTaskCreate(
displayTask, "displayTask", 2048, nullptr, 1, nullptr
);
if (samplingResult != pdPASS || displayResult != pdPASS) {
Serial.println("task creation failed");
}
}
void loop() {
delay(1000);
}预期输出:
display seq=1 temp=24.1 C
display seq=2 temp=24.2 C
display seq=3 temp=24.3 C
display seq=4 temp=24.4 C序号持续递增且没有重复读取旧值,说明显示任务收到的是队列中的独立样本,而不是某个不断被采集任务覆盖的共享变量。
空队列和满队列怎么处理
xQueueReceive() 的等待时间决定“没数据时怎么办”。使用 portMAX_DELAY 时,接收任务会休眠直到有数据到达,适合必须消费每条消息的后台任务;如果任务还要定期处理其他工作,可以改成有限的 pdMS_TO_TICKS(<TIME>),超时后再执行别的逻辑。
xQueueSend() 的等待时间决定“队列满了怎么办”。等待时间为 0 表示立即失败,有限超时可以吸收短暂拥塞,长时间阻塞则会反向拖慢生产者。队列长度也不是越大越好:长度过大会占用更多 RAM,并可能把真正的消费瓶颈隐藏成越来越大的延迟。
传大数据和指针时的边界
队列每发送一次都会复制一个元素,因此几十字节的传感器结构体很合适;如果元素是几 KB 的图像块或网络缓冲区,复制成本会明显增加。这时可以传指针,但队列只复制“指针值”,不会替你管理指针所指内存。
对“采集任务产生小型数据记录、显示或网络任务顺序消费”的场景,结构体按值入队通常最简单可靠:任务之间没有共享可变样本,阻塞规则明确,数据顺序也由队列直接维护。