当前位置：首页 > backend >正文

uC/OS-III 队列相关接口

backend 2025/8/28 5:26:04

在 uC/OS（Micro-Controller Operating System）中，队列（Queue）是任务间通信的核心机制之一，用于实现数据缓冲和异步消息传递。uC/OS 的队列设计兼顾了实时性和内存效率，以下从代码结构、核心接口和实现特点进行分析：

一、uC/OS 队列的核心数据结构

uC/OS 中队列的控制块（OS_Q）定义了队列的全部状态信息，关键成员如下（以 uC/OS-III 为例）：

typedef struct os_q {CPU_CHAR          Name[OS_OBJ_NAME_LEN];  // 队列名称（调试用）OS_MSG_Q          MsgQ;                   // 消息队列容器OS_OBJ_QTY        MaxMsg;                 // 最大消息数OS_MSG_SIZE       MaxMsgSize;             // 单条消息最大字节数OS_OBJ_TYPE       Type;                   // 对象类型（标识为队列）// 等待队列（任务阻塞时的等待链表）OS_PEND_LIST      PendList;// 其他状态变量（如是否使用动态内存、计数器等）OS_FLAGS          Flags;CPU_INT32U        MsgQty;                 // 当前消息数量// ...
} OS_Q;

OS_MSG_Q：实际存储消息的缓冲区，通常为环形队列结构
PendList：记录等待该队列的任务（用于阻塞机制）

二、核心接口及实现分析

uC/OS 的队列操作接口封装在os_q.c文件中，核心功能如下：

1. 队列创建（`OSQCreate()`）

功能：初始化队列控制块，分配消息缓冲区。
关键代码逻辑：

OS_Q *OSQCreate(OS_Q        *p_q,CPU_CHAR    *p_name,OS_OBJ_QTY   max_msg,OS_MSG_SIZE  max_msg_size,OS_ERR      *p_err)
{// 参数校验（空指针、长度合法性）if (p_q == (OS_Q *)0) {*p_err = OS_ERR_OBJ_PTR_NULL;return ((OS_Q *)0);}// 初始化队列控制块成员p_q->MaxMsg      = max_msg;p_q->MaxMsgSize  = max_msg_size;p_q->MsgQty      = 0u;// 初始化等待链表（无任务等待）OS_PendListInit(&p_q->PendList);// 初始化消息缓冲区（环形队列）OS_MsgQInit(&p_q->MsgQ, max_msg, max_msg_size, p_err);// ...return (p_q);
}

特点：

支持静态创建（用户提供OS_Q结构体）和动态创建（内部调用malloc）
需指定最大消息数和单条消息长度，避免内存溢出

2. 发送消息（`OSQPost()`）

功能：向队列尾部发送消息，支持阻塞 / 非阻塞模式。
核心逻辑：

OS_OBJ_QTY OSQPost(OS_Q        *p_q,void        *p_msg,OS_MSG_SIZE  msg_size,OS_FLAGS     opt,OS_ERR      *p_err)
{CPU_SR_ALLOC();  // 用于临界区保护CPU_CRITICAL_ENTER();  // 关中断（确保操作原子性）// 检查队列是否已满if (p_q->MsgQty >= p_q->MaxMsg) {CPU_CRITICAL_EXIT();*p_err = OS_ERR_Q_FULL;return (0u);}// 复制消息到队列缓冲区（支持指针传递或数据拷贝）OS_MsgQPut(&p_q->MsgQ, p_msg, msg_size, opt, p_err);p_q->MsgQty++;// 唤醒等待该队列的任务（如有）if (OS_PendListIsEmpty(&p_q->PendList) == DEF_NO) {OS_PendListPost(&p_q->PendList, p_msg, msg_size, opt, p_err);}CPU_CRITICAL_EXIT();  // 开中断// ...return (1u);
}

关键特性：

支持OS_OPT_POST_FIFO（先进先出）和OS_OPT_POST_LIFO（后进先出）模式
消息可通过指针传递（零拷贝，适合大数据）或拷贝（内存独立，安全但耗时）

3. 接收消息（`OSQPend()`）

功能：从队列头部获取消息，队列为空时可阻塞等待。
核心逻辑：

void *OSQPend(OS_Q         *p_q,OS_TICK       timeout,OS_OPT        opt,OS_MSG_SIZE  *p_msg_size,CPU_TS       *p_ts,OS_ERR       *p_err)
{void        *p_msg;CPU_SR_ALLOC();CPU_CRITICAL_ENTER();// 队列有消息：直接取消息if (p_q->MsgQty > 0u) {p_msg = OS_MsgQGet(&p_q->MsgQ, p_msg_size, p_err);p_q->MsgQty--;CPU_CRITICAL_EXIT();return (p_msg);}// 队列空：任务进入阻塞状态else {// 将当前任务加入等待链表OS_PendListWait(&p_q->PendList, (OS_PEND_OBJ *)p_q, OS_TASK_PEND_ON_Q,timeout,opt,p_err);CPU_CRITICAL_EXIT();// 任务调度（切换到其他就绪任务）OSSched();// 被唤醒后获取消息p_msg = OSTCBCur->MsgPtr;*p_msg_size = OSTCBCur->MsgSize;// ...return (p_msg);}
}

阻塞机制：