FreeRTOS: 队列（Queues）与任务间通信 — API 深入与实战-深圳市維司達科技有限公司

队列（Queues）与任务间通信 — API 深入与实战

在嵌入式实时系统里，队列并不是一个抽象的学术概念，它就是你在任务之间传递消息、转移轻量事件、把 ISR 做不了的事情交给任务处理的那根“绳子”。我下面把队列的要点、常用 API、设计建议和实战代码都写成一篇通俗的博客风格文章，力求少用列点，讲清楚为什么这么做，以及实际开发中常踩的坑。

队列到底是什么，什么时候用它

把队列想成一个线程安全的消息缓冲区：任务 A 往里丢数据，任务 B 从里头拿数据。它最常见的用途有三类：生产者/消费者模型（比如传感器采样到处理线程）、把 ISR 中发生的“轻量事件”丢给任务处理（避免在中断里做耗时工作），以及任务间的命令或事件传递（例如 UI 事件、数据包、控制命令）。队列保证 FIFO，支持阻塞或带超时的发送/接收，并提供专门的 FromISR 接口以便在中断上下文安全地发送数据。

在设计上，优先考虑两点：一是你要传的是小数据（比如一个uint32_t）还是一大块内存（比如一帧图像）；二是内存够不够。小数据直接拷贝进队列最简单，但如果每次都拷贝大块数据，开销会很明显——这时候通常改成传指针或使用内存池。

你会用到的基本 API

创建队列的接口很直接：

QueueHandle_txQueueCreate(UBaseType_t uxQueueLength,UBaseType_t uxItemSize);

第一个参数是槽位数量，第二个参数是每项的字节大小。记住：队列会为uxQueueLength * uxItemSize分配缓冲区（外加一些控制结构），所以在内存紧张的 MCU 上要小心。

发送和接收分别是：

BaseType_txQueueSend(QueueHandle_t xQueue,constvoid*pvItemToQueue,TickType_t xTicksToWait);BaseType_txQueueReceive(QueueHandle_t xQueue,void*pvBuffer,TickType_t xTicksToWait);

发送会把用户传入的数据拷贝到队列中。xTicksToWait控制当队列满（或空）时是否阻塞以及超时时间。对中断上下文，FreeRTOS 提供FromISR版本：

BaseType_txQueueSendFromISR(QueueHandle_t xQueue,constvoid*pvItemToQueue,BaseType_t*pxHigherPriorityTaskWoken);

注意pxHigherPriorityTaskWoken这个参数：如果发送唤醒了一个比当前运行任务优先级还高的任务，FromISR 会把这一信息返回给你，调用处通常需要执行portYIELD_FROM_ISR()或portEND_SWITCHING_ISR()，以便立即做任务切换。

阻塞还是非阻塞？该怎么选

在任务里使用阻塞（传入一个合理的超时）是最常见也是最稳妥的模式。这样生产者在队列满时可以等待，消费者在队列空时可以睡眠，系统不会白转 CPU。相反，ISR 必须尽量非阻塞：中断里只能做最小量的工作，把事件快速放到队列里然后返回。

非阻塞模式（xTicksToWait == 0）适合对实时性要求非常高的路径，或者当你准备好处理“发送失败”的逻辑（比如丢弃、计数统计或备用路径）时使用。

内存与性能的常见考量

如果队列元素很小（例如 4 字节），拷贝代价低，使用队列非常方便。但若元素很大，千万别每次都把整块数据复制进队列，那会吞光 RAM 并拖慢系统。常见的两种优化是：传指针（队列里保存指针，生产者把内存地址丢进去）或使用内存池（预先分配 N 个缓冲块，生产者从池中拿块填充后发送指针，消费者处理完后把块归还）。

还有一个细节是内存分配方式：普通的xQueueCreate会用pvPortMalloc动态分配缓冲区。如果你必须保证内存布局或不能在运行时分配，FreeRTOS 支持静态队列xQueueCreateStatic()，让你把缓冲区放在静态内存。

典型模式：生产者/消费者

这是队列最常见的用法。生产者采样、采集或在中断里记录事件；消费者负责解析、处理或上传。下面给出一个最基本的任务级示例（注意这只是演示拷贝语义）：

typedefstruct{uint32_tid;uint32_tvalue;}Msg_t;staticQueueHandle_t xQueue=NULL;// 生产者voidProducerTask(void*arg){Msg_t m={0};for(;;){m.id++;m.value=read_sensor();if(xQueueSend(xQueue,&m,pdMS_TO_TICKS(100))!=pdPASS){// 队列满，计数或丢弃}vTaskDelay(pdMS_TO_TICKS(10));}}// 消费者voidConsumerTask(void*arg){Msg_t m;for(;;){if(xQueueReceive(xQueue,&m,portMAX_DELAY)==pdPASS){process(m);}}}

如果Msg_t很大，就把Msg_t *放到队列里（传指针），并设计好内存归属：谁分配谁释放或者使用池管理。

实战：按钮中断产生事件，任务去抖并处理

这是一个非常典型的工程范例：中断检测到按键变化，但去抖需要等待一段时间，这不能在 ISR 做。正确的做法是在 ISR 里把事件记录（或者把一个小结构体发送到队列），然后由任务来做去抖和后续处理。

ISR 里使用xQueueSendFromISR，并利用pxHigherPriorityTaskWoken来决定是否需要立即切换任务。任务里用portMAX_DELAY或超时等待队列，拿到事件后做去抖（例如 50ms）并执行业务处理。把去抖放在任务里还有一个好处：逻辑更灵活，可以统计按压持续时间、区分长按短按等。

下面是一个能在 host 模拟环境直接跑的完整示例（把硬中断用一个“模拟任务”替代）：

#include<stdio.h>#include"FreeRTOS.h"#include"task.h"#include"queue.h"typedefenum{BUTTON_PRESS,BUTTON_RELEASE}ButtonEventType_t;typedefstruct{ButtonEventType_t type;TickType_t timestamp;}ButtonEvent_t;staticQueueHandle_t xButtonQueue=NULL;voidvButtonConsumer(void*arg){ButtonEvent_t ev;TickType_t lastPress=0;constTickType_t debounce=pdMS_TO_TICKS(50);for(;;){if(xQueueReceive(xButtonQueue,&ev,portMAX_DELAY)==pdPASS){if(ev.type==BUTTON_PRESS){TickType_t now=xTaskGetTickCount();if((now-lastPress)>debounce){lastPress=now;printf("[Consumer] Valid press at %lu\n",(unsignedlong)now);}else{printf("[Consumer] Ignored bounce at %lu\n",(unsignedlong)now);}}}}}voidvButtonSimulator(void*arg){ButtonEvent_t ev;for(;;){// 模拟一次按键：抖动 3 次for(inti=0;i<3;++i){ev.type=BUTTON_PRESS;ev.timestamp=xTaskGetTickCount();if(xQueueSend(xButtonQueue,&ev,0)!=pdPASS){printf("[Sim] Queue full, drop event\n");}vTaskDelay(pdMS_TO_TICKS(10));}vTaskDelay(pdMS_TO_TICKS(1000));}}intmain(void){xButtonQueue=xQueueCreate(10,sizeof(ButtonEvent_t));if(xButtonQueue==NULL){printf("Failed to create queue\n");return-1;}xTaskCreate(vButtonConsumer,"BtnCons",256,NULL,tskIDLE_PRIORITY+2,NULL);xTaskCreate(vButtonSimulator,"BtnSim",256,NULL,tskIDLE_PRIORITY+1,NULL);vTaskStartScheduler();for(;;);}