OS_EVENT變數, MailBox OSMboxPend OSMboxPost

admin

OS_EVENT
在µC/OS-II操作系統中，OS_EVENT是一個數據結構，用於表示同步和通信原語，比如信號量（semaphores）、互斥量（mutexes）和郵件隊列（message queues）。這個數據結構用於管理和控制任務間的同步和通信。

每個OS_EVENT結構體包含了以下的字段：

• OSEventType：表示了事件的類型，例如信號量、互斥量或郵件隊列。
• OSEventCnt：這個值的含義取決於OSEventType。對於信號量，它表示了信號量的當前值；對於互斥量，它表示了鎖的狀態（鎖定或未鎖定）。
• OSEventPtr：這個指針的目的取決於OSEventType。對於信號量和互斥量，它指向了等待事件的任務列表；對於郵件隊列，它指向了郵件本身。
• OSEventGrp 和 OSEventTbl：這些字段用於快速查找等待事件的任務。
  

在µC/OS-II中，你可以使用例如OSSemCreate、OSMutexCreate或者OSQCreate等函數來創建一個新的OS_EVENT，並且返回指向這個結構體的指針。之後，這個指針可以被傳遞給其他µC/OS-II API函數，比如OSSemPend、OSSemPost等，來執行特定的操作。


MailBox OSMboxPend OSMboxPost
OSMboxPend和OSMboxPost都是µC/OS-II的API函數，用於操作郵件隊列（message box）。

OSMboxPend用於接收從郵件隊列中的消息。調用此函數的任務將阻塞，直到消息變為可用，或者超時發生。此函數的原型如下：

void* OSMboxPend(OS_EVENT* pevent, INT16U timeout, INT8U* err);
參數：

pevent：這是指向郵件隊列的指針，該郵件隊列是之前由OSMboxCreate創建的。
timeout：這是調用任務願意等待消息的最大刻度數（即係統時鐘的節拍數）。如果此參數為0，則任務將無限期地等待消息。
err：這是一個指向變量的指針，將返回錯誤代碼。
OSMboxPost用於發送消息到郵件隊列。如果有任務在等待消息，那麼這個任務將會被解除阻塞狀態，並且收到該消息。如果沒有任務在等待，那麼消息將存儲在郵件隊列中，直到有任務調用OSMboxPend並接收到它。此函數的原型如下：


INT8U OSMboxPost(OS_EVENT* pevent, void* msg);
參數：

pevent：這是指向郵件隊列的指針，該郵件隊列是之前由OSMboxCreate創建的。
msg：這是要發送的消息。
郵件隊列是一種實時操作系統中常見的通信機制，用於在任務之間傳遞消息或事件。每個郵件隊列只能容納一條消息，因此它們常常被用於通知任務發生了某個特定事件，而不是用來傳輸大量數據。