单片机与物联网 / 系统课时

队列传递数据

队列传递数据

本课使用 FreeRTOS 队列在任务之间传递传感器数据,并通过阻塞等待避免轮询占用 CPU。完成示例后,你将能够创建队列、发送结构体消息、接收数据,并正确处理队列已满或暂时为空的情况。

学习目标

  • 理解队列复制消息和先进先出的工作方式
  • 使用 xQueueSend 与 xQueueReceive 传递结构体数据
  • 根据实时性要求设置阻塞等待时间

队列如何连接多个任务

FreeRTOS 队列是内核管理的消息缓冲区。发送任务把数据复制到队列,接收任务再从队列取出副本,因此双方不需要同时执行,也不必共享同一块可变内存。

传感器任务通过队列向处理任务传递数据

创建队列时必须同时确定消息数量和单条消息大小。例如,一个长度为 5 的传感器队列最多保存 5 个 SensorData_t 对象。队列中保存的是数据副本,不是局部变量地址。

创建并使用传感器队列

以下为片段示例,依赖 STM32CubeMX 已生成 HAL、串口和 FreeRTOS 基础工程,并在启动调度器前调用 AppTaskCreate()。示例中的 printf 还需要完成串口重定向。

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

预期输出

text
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() 查看当前积压消息数量,判断生产速度是否长期高于消费速度。

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

目录与阅读设置

阅读设置

17

记录一个想法

队列传递数据

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

登录哪都通