FreeRTOS 入门（三十一）：多队列按键分发 —— 汽车独立控制实战

目录

• 一、前言
• 二、汽车任务创建与初始队列问题
• 三、按键分发：简陋实现与弊端
• 四、优雅方案：句柄注册 + 循环分发
• 五、汽车任务集成：队列创建与注册
• 六、游戏启动：任务调用与运行逻辑
• 七、总结
• 八、下一篇预告
• 九、结尾

一、前言

大家好，我是Hello_Embed。上一篇我们完成了 MPU6050 的队列集集成，解决了多传感器的数据统一处理问题。本次笔记将聚焦 “多队列独立控制” 场景 —— 通过红外遥控的不同按键值，分别控制三辆汽车的移动，核心难点是如何将单一队列的按键数据，优雅地分发给多个汽车任务的独立队列，避免代码耦合，提升复用性。

二、汽车任务创建与初始队列问题

要实现三辆汽车的独立控制，首先需创建对应的任务，每个任务负责一辆汽车的移动逻辑。同时要注意，红外遥控的原始数据仅写入一个队列，需解决 “数据分发到多队列” 的核心问题。

2.1 汽车任务创建

直接创建三个汽车任务，通过参数传递汽车实例（g_cars数组），每个任务独立运行，负责读取按键数据并控制汽车移动：

voidcar_test(void){// 汽车与分割线显示代码（本篇聚焦队列分发，省略显示逻辑）// ...// 创建三个汽车任务：参数为对应汽车实例，优先级均为正常xTaskCreate(CarTask,"car1",128,&g_cars[0],osPriorityNormal,NULL);xTaskCreate(CarTask,"car2",128,&g_cars[1],osPriorityNormal,NULL);xTaskCreate(CarTask,"car2",128,&g_cars[2],osPriorityNormal,NULL);// 注：任务名重复为car2，保留原始写法}

2.2 初始队列问题

此前红外遥控的按键数据仅写入一个全局队列g_xQueueIR：

// 红外中断中写队列：所有按键数据存入同一个队列xQueueSendFromISR(g_xQueueIR,&idata,NULL);

但三个汽车任务需要独立的按键指令（比如按键 A 控车 1、按键 B 控车 2），直接共用一个队列会导致数据混乱，因此必须实现 “按键数据按需求分发给对应汽车队列” 的分发逻辑。

三、按键分发：简陋实现与弊端

最直接的分发思路是直接关联汽车队列句柄，手动逐个发送数据，但这种写法存在明显弊端。

3.1 简陋分发函数实现

直接在分发函数中声明所有汽车队列句柄，逐个调用写队列函数：

// 按键数据分发函数：将红外按键数据分发给三个汽车队列staticvoidDispatchKey(structir_data*pidata){// 声明三个汽车队列句柄（外部定义，跨文件访问）externQueueHandle_t g_xQueueCar1;externQueueHandle_t g_xQueueCar2;externQueueHandle_t g_xQueueCar23;// 逐个将按键数据写入汽车队列xQueueSendFromISR(g_xQueueCar1,&pidata,NULL);xQueueSendFromISR(g_xQueueCar2,&pidata,NULL);xQueueSendFromISR(g_xQueueCar3,&pidata,NULL);}

3.2 使用方式与弊端

• 使用方式：将红外中断中 “写队列” 的代码替换为分发函数调用：DispatchKey(&data)；
• 核心弊端：
  1. 强耦合：分发函数直接写死汽车队列句柄，若新增 / 删除汽车，需修改函数代码；
  2. 复用性差：仅适用于当前汽车游戏，无法直接迁移到其他多队列分发场景；
  3. 代码冗余：汽车数量增多时，需重复添加xQueueSendFromISR调用。

补充：简陋写法仅能实现 “所有按键数据发给所有汽车”，若需 “指定按键控指定汽车”，还需在函数中添加按键值判断，耦合会进一步加重。

四、优雅方案：句柄注册 + 循环分发

为解决耦合问题，设计 “句柄注册 + 循环分发” 方案：通过数组存储队列句柄，注册函数动态添加句柄，循环遍历数组完成分发，实现代码解耦与复用。

4.1 核心：句柄数组与注册函数

定义全局句柄数组（存储需分发的队列句柄）和计数器（记录有效句柄数量），通过注册函数动态添加句柄：

// 句柄数组：最多支持10个队列分发（可按需调整长度）staticQueueHandle_t g_xQueues[10];// 有效句柄计数器：记录已注册的队列数量staticintg_queue_cnt=0;// 队列句柄注册函数：动态添加需分发的队列句柄voidRegisterQueueHandle(QueueHandle_t queueHandle){// 避免数组越界：仅在计数器小于数组长度时注册if(g_queue_cnt<10){g_xQueues[g_queue_cnt]=queueHandle;g_queue_cnt++;// 计数器自增，指向 next 空闲位置}}

补充：句柄数组长度设为 10 是权衡后的选择，既满足多数多队列场景，又不浪费过多内存；若需支持更多队列，可直接调整数组长度。

4.2 优化后的分发函数

通过循环遍历句柄数组，自动将按键数据分发给所有已注册的队列，无需手动添加句柄：

staticvoidDispatchKey(structir_data*pidata){inti;// 循环遍历所有已注册的队列句柄，逐个分发数据for(i=0;i<g_queue_cnt;i++){// 中断中写队列：将按键数据发送给当前注册的队列xQueueSendFromISR(g_xQueues[i],pidata,NULL);}}

4.3 红外队列的注册

红外遥控的原始队列也需通过注册函数加入分发列表，确保按键数据能被捕获并分发：

// 红外队列创建时，调用注册函数加入分发列表g_xQueueIR=xQueueCreate(IR_QUEUE_LEN,sizeof(structir_data));RegisterQueueHandle(g_xQueueIR);

五、汽车任务集成：队列创建与注册

每个汽车任务需创建独立的私有队列，再将该队列句柄注册到分发列表，接收按键数据并控制汽车移动：

staticvoidCarTask(void*params){structcar*car=params;// 接收汽车实例参数（控制当前汽车）structir_dataidata;// 存储接收的按键数据// 1. 创建当前汽车的私有队列：存储专属按键指令QueueHandle_t xQueueIR=xQueueCreate(10,sizeof(structir_data));// 2. 注册队列句柄：将私有队列加入分发列表，接收按键数据RegisterQueueHandle(xQueueIR);while(1){// 3. 读取私有队列：永久阻塞等待按键数据xQueueReceive(xQueueIR,&idata,portMAX_DELAY);// 4. 按键控制汽车移动：根据idata.val判断方向（代码省略，与队列分发无关）// ...}}

补充：每个汽车任务的队列是私有资源，仅当前任务读取，避免多任务竞争同一队列，确保控制独立性。

六、游戏启动：任务调用与运行逻辑

与常规任务不同，car_test函数内部已直接创建三个汽车任务，因此无需额外为car_test创建任务，直接在 FreeRTOS 初始化阶段调用该函数即可启动所有汽车任务：

// FreeRTOS初始化函数中调用，直接启动三个汽车任务car_test();// 后续可将car_test重命名为car_game，更贴合游戏场景（无需修改任务逻辑）

七、总结

本次笔记聚焦 “多队列按键分发” 的核心需求，实现了红外遥控对三辆汽车的独立控制，核心要点如下：

1. 核心问题：单一红外队列的按键数据，需分发给多个汽车私有队列，避免控制混乱；
2. 简陋方案弊端：直接写死句柄导致强耦合、复用性差，仅适用于固定场景；
3. 优雅方案核心：通过 “句柄数组 + 注册函数 + 循环分发”，实现动态添加队列、自动分发数据，解耦代码并提升复用性；
4. 任务逻辑：每个汽车任务创建私有队列并注册，独立读取数据，确保控制独立性；
5. 启动方式：car_test内部直接创建任务，无需额外封装任务，调用即可启动。

该方案不仅适用于汽车控制，还可迁移到任何 “单一数据源→多目标队列” 的分发场景，体现了 FreeRTOS 队列的灵活应用。

八、下一篇预告

本次我们通过队列分发实现了多设备独立控制，下一篇将聚焦 FreeRTOS 的另一核心同步机制 —— 信号量与互斥量，讲解其基本概念、函数用法及典型应用场景，解决多任务访问共享资源的同步问题。

九、结尾

从队列集的多设备统一处理，到本次的多队列按键分发，我们不断探索队列在不同场景下的灵活应用，核心思路始终是 “解耦与复用”。“句柄注册 + 循环分发” 的方案，不仅解决了当前汽车控制的需求，更提供了一种通用的多队列数据分发思路，让代码在面对需求变更时更具弹性。

下一篇的信号量与互斥量，将解决多任务共享资源的竞争问题，是 FreeRTOS 中与队列同等重要的核心组件。我是Hello_Embed，感谢大家的持续关注，让我们继续深入 FreeRTOS 的同步与通信机制！