嵌入式 Linux 与 RTOS / 系统课时

用队列传递结构化消息

用队列传递结构化消息

FreeRTOS 队列可以让任务在不共享可变缓冲区的情况下交换结构化数据。本节会创建固定长度队列,完成结构体发送、接收和队列满处理,并据此判断什么时候适合按值传消息,什么时候应该改传句柄或指针。

学习目标

  • 创建固定长度队列并发送、接收结构体消息
  • 使用等待时间处理接收超时和队列已满情况
  • 根据消息大小和生命周期选择按值复制、句柄或指针

队列保存的是消息副本

调用 xQueueCreate() 时需要同时确定队列长度和单个元素大小。之后调用 xQueueSend(),FreeRTOS 会把指定大小的数据复制到队列存储区;xQueueReceive() 再把队首元素复制到接收方提供的缓冲区。

FreeRTOS 队列的按值复制数据流

这种按值复制让生产者和消费者各自拥有数据副本,任务之间不必围绕同一块消息内存加锁,也不会因为生产者随后修改局部变量而改变已经入队的数据。代价是每次发送和接收都需要复制 uxItemSize 字节,并且队列本身要为所有槽位预留存储空间。

创建队列并处理队列满

下面示例假设工程已经接入 FreeRTOS,并且 printf() 已重定向到串口或控制台。队列只有两个槽位,生产者优先级高于消费者,因此生产者连续以零等待时间发送三条消息时,第三条会稳定遇到队列已满。

c
#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 (;;) {
    }
}

预期输出

text
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 占用和复制时间。此时通常让队列传递一个较小的句柄或指针,再由内存池、静态缓冲区或其他明确的所有权机制管理真实数据。

使用指针后,队列只保证“指针值”的并发传递安全,并不会自动解决指针所指内存的生命周期。发送者不能在消费者使用前释放或复用那块缓冲区。选择方案时可以遵循一个简单原则:消息小且希望所有权简单时按值复制;数据大且复制成本不可接受时传引用,但必须先设计清楚谁分配、谁释放以及何时允许复用。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用队列传递结构化消息

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通