在嵌入式系統(tǒng)中，任務(wù)之間常常需要通過(guò)一種結(jié)構(gòu)化方式傳遞消息或數(shù)據(jù)，例如傳感器采集值上傳、串口數(shù)據(jù)解析、指令調(diào)度、事件響應(yīng)等。在這些場(chǎng)景下，“隊(duì)列（Queue）”是一種非常經(jīng)典且高效的數(shù)據(jù)組織形式。

通用隊(duì)列模塊以結(jié)構(gòu)體數(shù)組為核心，結(jié)合固定內(nèi)存與循環(huán)索引，實(shí)現(xiàn)了一個(gè)輕量、穩(wěn)定、適配性強(qiáng)的隊(duì)列管理器。該模塊適合用于裸機(jī)或 RTOS 系統(tǒng)，是構(gòu)建通信緩沖、消息隊(duì)列、任務(wù)分發(fā)機(jī)制的基礎(chǔ)組件。

核心結(jié)構(gòu)與概念隊(duì)列管理器 queue_t

隊(duì)列通過(guò) queue_t 結(jié)構(gòu)體進(jìn)行管理，內(nèi)部維護(hù)以下成員：

• base：隊(duì)列內(nèi)存起始地址；

• size：隊(duì)列最大容量（元素個(gè)數(shù)）；

• element_size：每個(gè)元素的字節(jié)數(shù)；

• front、rear：隊(duì)頭與隊(duì)尾索引，用于控制循環(huán)進(jìn)出。

隊(duì)列結(jié)構(gòu)采用 循環(huán)數(shù)組，即環(huán)形緩沖的方式，避免頻繁移動(dòng)內(nèi)存，入隊(duì)出隊(duì)僅需更新索引。

功能概覽

一、模塊功能概述

本隊(duì)列模塊支持以下基礎(chǔ)能力：

• 隊(duì)列的初始化與創(chuàng)建；

• 判斷隊(duì)列空滿狀態(tài)；

• 元素入隊(duì)與出隊(duì)；

• 隊(duì)列長(zhǎng)度查詢；

• 隊(duì)列內(nèi)容預(yù)讀?。ú怀鲫?duì)）；

• 隊(duì)列清空；

• 隊(duì)尾元素刪除。

該隊(duì)列采用循環(huán)數(shù)組結(jié)構(gòu)，不依賴動(dòng)態(tài)內(nèi)存分配，適合資源受限的嵌入式環(huán)境使用。支持自定義元素類型，通過(guò)配置元素大小與容器地址實(shí)現(xiàn)通用性管理。

二、使用方式簡(jiǎn)述

使用者在使用該模塊時(shí)需自行提供以下參數(shù)：

• 數(shù)據(jù)緩沖區(qū)指針；

• 緩沖區(qū)容量（元素個(gè)數(shù)）；

• 單個(gè)元素的大?。ㄗ止?jié)）；

• 隊(duì)列管理結(jié)構(gòu)體實(shí)例。

通過(guò)調(diào)用創(chuàng)建函數(shù)對(duì)隊(duì)列進(jìn)行初始化后，即可使用相關(guān)接口進(jìn)行操作，如入隊(duì)出隊(duì)等。

三、接口功能說(shuō)明1. 創(chuàng)建隊(duì)列

通過(guò) queue_create 函數(shù)傳入結(jié)構(gòu)體、容器地址、容器容量、元素大小，即可完成隊(duì)列初始化。

2. 狀態(tài)判斷

提供 queue_is_empty 和 queue_is_full 接口判斷當(dāng)前隊(duì)列狀態(tài)，便于進(jìn)行邊界處理。

3. 元素操作

• 使用 queue_put 向隊(duì)列尾部寫入一個(gè)元素；

• 使用 queue_get 從隊(duì)列頭部讀取一個(gè)元素并出隊(duì)；

• 使用 queue_peek 可在不出隊(duì)的情況下獲取隊(duì)頭元素地址；

• 使用 queue_del 可直接丟棄隊(duì)頭元素（刪除而不讀取）；

• 使用 queue_clr 可清空整個(gè)隊(duì)列內(nèi)容；

• 使用 queue_size 可獲取當(dāng)前隊(duì)列中元素?cái)?shù)量。

1. 串口接收命令緩存

串口中斷接收到數(shù)據(jù)幀后，將幀內(nèi)容通過(guò) queue_put 入隊(duì)，主循環(huán)中調(diào)用 queue_get 提取完整指令進(jìn)行解析，避免數(shù)據(jù)丟失或阻塞。

typedef struct {
    uint8_t data[8];
} uart_cmd_t;uart_cmd_t cmd_buf[16];queue_t cmd_queue;

queue_create(&cmd_queue, cmd_buf, 16, sizeof(uart_cmd_t));

2. 多任務(wù)消息傳遞（RTOS環(huán)境）

任務(wù) A 收集數(shù)據(jù)并通過(guò) queue_put 入隊(duì)，任務(wù) B 輪詢或通過(guò)事件驅(qū)動(dòng)使用 queue_get 獲取消息，完成跨任務(wù)通信。

3. 簡(jiǎn)易任務(wù)調(diào)度器

使用 queue_t 管理一個(gè)“函數(shù)指針 + 參數(shù)”結(jié)構(gòu)體列表，即可構(gòu)建輕量的調(diào)度任務(wù)表，實(shí)現(xiàn)軟中斷調(diào)度或定時(shí)任務(wù)執(zhí)行。

通用隊(duì)列管理模塊，是構(gòu)建嵌入式通信、緩存和調(diào)度功能的堅(jiān)實(shí)基礎(chǔ)。通過(guò)靈活封裝與高效實(shí)現(xiàn)，該模塊能夠幫助開發(fā)者快速構(gòu)建穩(wěn)定的數(shù)據(jù)流通路。在系統(tǒng)架構(gòu)設(shè)計(jì)中，清晰的數(shù)據(jù)組織方式往往是高質(zhì)量代碼的關(guān)鍵，隊(duì)列，正是連接數(shù)據(jù)與邏輯的橋梁。

開源代碼：

#include "queue.h"#include <stddef.h>#include <string.h>/* @brief      創(chuàng)建一個(gè)隊(duì)列
 * @param[in]  q    - 隊(duì)列管理器
 * @param[in]  base - 隊(duì)列容器基地址
 * @param[in]  size - 隊(duì)列容器可容納元素個(gè)數(shù)
 * @param[in]  element_size - 隊(duì)列元素大小(sizeof(type))
 * @return     true - 創(chuàng)建成功, false - 創(chuàng)建失敗
 */bool queue_create(queue_t *q, void *base, int size, int element_size)
{    if (q == NULL || base == NULL || size== 0 || element_size == 0)        return false;
    q->base         = base;
    q->size         = size;
    q->element_size = element_size;
    q->front        = q->rear = 0;    return true;
}/* @brief      判斷隊(duì)列是否為空
 * @return    true - 隊(duì)列為空, false - 隊(duì)列非空
 */bool queue_is_empty(queue_t *q)
{    return q->front == q->rear;
}/* @brief      判斷隊(duì)列是否滿
 * @return     true - 隊(duì)列非滿, false - 隊(duì)列未滿
 */bool queue_is_full(queue_t *q)
{    return (q->rear + 1) % q->size == q->front;
}/* @brief      入隊(duì)(添加元素至隊(duì)尾)
 * @param[in]  element  - 隊(duì)列元素
 * @return     true - 成功入隊(duì), false - 隊(duì)列滿
 */bool queue_put(queue_t *q,  void *element)
{    if (queue_is_full(q))        return false;
    memcpy((unsigned char *)q->base + q->rear * q->element_size, element, 
           q->element_size);
    q->rear = (q->rear + 1) % q->size;    return true;
}/* @brief      出隊(duì)(移除隊(duì)首元素)
 * @param[in]  element  - 指向隊(duì)首元素的地址
 * @return     true - 成功出隊(duì), false - 隊(duì)列為空
 */bool queue_get(queue_t *q,  void *element)
{    if (queue_is_empty(q))        return false;   
    memcpy(element, (unsigned char *)q->base + q->front * q->element_size,
          q->element_size);
    q->front = (q->front + 1) % q->size;    return true;
}/* @brief      獲取隊(duì)首元素地址(預(yù)讀取)
 * @param[in]  element  - 指向隊(duì)首元素的地址
 * @return     true - 獲取成功, false - 獲取失敗隊(duì)列為空
 */bool queue_peek(queue_t *q, void **element)
{    if (queue_is_empty(q))        return false;   
    *element = (void *)((unsigned char *)q->base + q->front * 
              q->element_size);    return true;
}/* @brief      刪除隊(duì)尾元素
 * @return     true - 成功移除, false -  隊(duì)列為空, 
 */bool queue_del(queue_t *q)
{    if (queue_is_empty(q))        return false;   
    q->front = (q->front + 1) % q->size;    return true;
}/* @brief      獲取隊(duì)列元素個(gè)數(shù)
 * @return    隊(duì)列元素個(gè)數(shù)
 */int queue_size(queue_t *q)
{    return (q->rear + q->size - q->front ) % q->size;
}/* @brief      清空隊(duì)列
 * @return    none
 */void queue_clr(queue_t *q)
{
    q->front = q->rear = 0;
}