UCOS訊息佇列的使用【轉+原創】
訊息佇列的使用
1、 需在以下檔案中配置如下內容
OS_CFG.H
OS_MAX_QS N 你需要的值
根據需要自己配置
#define OS_Q_EN 1 /* Enable (1) or Disable (0) code generation for QUEUES */
#define OS_Q_ACCEPT_EN 1 /* Include code for OSQAccept() */
#define OS_Q_DEL_EN 1 /* Include code for OSQDel() */
#define OS_Q_FLUSH_EN 1 /* Include code for OSQFlush() */
#define OS_Q_POST_EN 1 /* Include code for OSQPost() */
#define OS_Q_POST_FRONT_EN 1 /* Include code for OSQPostFront() */
#define OS_Q_POST_OPT_EN 1 /* Include code for OSQPostOpt() */
#define OS_Q_QUERY_EN 1 /* Include code for OSQQuery() */
2、 建立一個指向訊息陣列的指標和陣列的大小，該指標陣列必須申明為void型別，如下：
void *MyArrayOfMsg[SIZE];
3、 宣告一個OS_EVENT型別的指標指向生成的佇列，如下：
OS_EVENT *QSem；
4、 呼叫OSQcreate()函式建立訊息佇列，如下：
QSem = OSQcreate(&MyArrayOfMsg[0],SIZE);
5、 等待訊息佇列中的訊息，OSQPend()。
void *OSQPend (OS_EVENT *pevent, INT16U timeout, INT8U *err):
必須保證訊息佇列已經被建立。
timeout定義的是等待超時時間，如果為0則表示無期限的等待
err表示的是在等待訊息隊列出錯時的返回型別，有以下幾種：
OS_ERR_PEVENT_NULL //訊息佇列不存在
OS_ERR_EVENT_TYPE
OS_TIMEOUT //訊息佇列等待超時
OS_NO_ERR //訊息佇列接收到訊息
獲得訊息佇列示例
type *GETQ;
INT8U err;
GETQ = (type *)OSQPend(QSem, time, &err);
if(err == OS_NO_ERR){
無錯處理
}
else{
出錯處理
}
6.1 向訊息佇列傳送一則訊息(FIFO),OSQPost(); INT8U OSQPost (OS_EVENT *pevent, void *msg):
函式返回值有：
OS_ERR_PEVENT_NULL
OS_ERR_POST_NULL_PTR
OS_ERR_EVENT_TYPE
OS_Q_FULL
OS_NO_ERR
引數：pevent,*msg
6.2 向訊息佇列傳送一則訊息(LIFO) INT8U OSQPostFront (OS_EVENT *pevent, void *msg)
6.3 向訊息佇列傳送一則訊息(LIFO或者FIFO) INT8U OSQPostOpt (OS_EVENT *pevent, void *msg, INT8U opt)
引數： opt
如果經opt引數中的OS_POST_OPT_BROADCAST位置為1，則所有正在等待訊息的任務都能接收到這則訊息，並且被OS_EventTaskRdy()從等待列表中刪除
如果不是廣播方式，則只有等待訊息的任務中優先順序最高的任務能夠進入就緒態。然後，OS_EventTaskRdy()從等待列表中把等待訊息的任務中優先順序最高的任務刪除。
注: 如果此函式由ISR呼叫，則不會發生任務切換，直到中斷巢狀的最外層中斷服務子程式呼叫OSIntExit()函式時，才能進行任務切換
7、 無等待的從訊息佇列中獲得訊息，OSQAccept(); void *OSQAccept (OS_EVENT *pevent, INT8U *err)
err可能的返回值：
OS_ERR_PEVENT_NULL
OS_Q_EMPTY
OS_NO_ERR
函式的返回值:訊息，0
8、 清空訊息佇列 INT8U OSQFlush (OS_EVENT *pevent)
函式返回值：
OS_ERR_PEVENT_NULL
OS_ERR_EVENT_TYPE
OS_NO_ERR
9、 獲取訊息佇列的狀態，OSQQuery(); INT8U OSQQuery (OS_EVENT *pevent, OS_Q_DATA *p_q_data)
函式返回值：
OS_ERR_PEVENT_NULL
OS_ERR_EVENT_TYPE
OS_NO_ERR
OS_Q_DATA資料結構在ucos_ii.h中
==================================華麗的分割線===================================
現在來說一下這個訊息佇列所傳遞的資料型別和特性。
首先，這個訊息佇列不是真正意義上的“佇列”，它呢只會把每次存入的資料指標排隊，而不會儲存該資料。所以呼叫OSQPost時如果每次都是相同的指標，那就說明 白放了，因為讀取的時候讀到的是同一個指標，他總是最新的資料，老的沒了，何來佇列？
其次，該佇列可以儲存void*型別指標，即所有資料型別都適用，管他是整型還是結構體。
現在這個佇列不是真佇列，那怎麼解決？莫急，看下面：
我這裡提一種簡單的方法，複雜的各位資格解決吧。
1、定義一個存放資料的緩衝區陣列，這樣每次向對列新增時就可以用不同的地址。例如struct my_struct data_array[10]
2、然後就是怎麼變這個陣列下標的問題，直接定義一個變數來尋找，然後使用++，到最後再折回來就好了，例如：
int idx=0;
idx++;
idx %= BUF_SIZE;
3、對於速度能及時解決的任務，那下標這樣搞就可以，如果不行，那可能要重新考慮覆蓋的問題了。