概述
事件是AliOS Things內核提供的一種任務間通信方式,它不同于信號量和互斥量,可以使用事件組實現一個任務同時等待多個事件的發生,或者等待同一個事件的任務在事件發生時解除阻塞狀態。事件組是一個32位的數,每一位都對應一個事件標志,事件標志只有兩種狀態:
1 代表被設置,即當有事件發生時,該事件對應的事件標志位將被設置為1
0 代表被清除,即任務獲得事件后,將事件對應的事件標志位被清除為0。
應用程序可以使用事件的如下特性來實現任務間同步:
任務可以等待事件組中設置的所有事件都發生后,即“與”的方式,任務才解除阻塞進入就緒狀態;
任務可以等待事件組中設置的任意一個事件發生,即“或”的方式,任務就解除阻塞進入就緒狀態;
如果有多個任務等待同一事件,當事件發生時,若任務等待條件滿足均會解除阻塞。
超時時間
事件等待可設置超時時間,如果任務在超時時間到期后仍未等到事件發生,則任務解除阻塞進入就緒狀態。
事件功能函數
函數名 | 描述 |
aos_event_create() | 事件創建函數(推薦) |
aos_event_new() | 事件創建函數(兼容3.1) |
aos_event_free() | 事件刪除函數 |
aos_event_get() | 獲取事件函數 |
aos_event_set() | 設置事件函數 |
aos_event_is_valid() | 判斷事件具柄是否合法函數 |
常用配置
事件功能:默認使能,如需修改,在YAML中修改RHINO_CONFIG_EVENT_FLAG配置
def_config:
RHINO_CONFIG_EVENT_FLAG: 0
API說明
使用示例
示例代碼參考example/event_example.c,該示例使用事件機制實現任務間同步,具體場景為創建任務A和認為B,以及一事件。任務A以“與”的方式等待事件1和事件2;任務B以“或”的方式等待事件1和事件2。測試任務T設置事件1,則任務B因獲取事件得到運行,之后測試任務T設置事件2,則任務A因等到全部事件而得到運行。
示例說明如下:
t0時刻,任務T調用aos_event_create()創建一事件。任務T然后調用aos_task_create()創建任務A和任務B。任務A調用aos_event_get()以RHINO_AND為選項參數等待事件1和事件2的發生;任務B調用aos_event_get()以RHINO_OR為選項參數等待事件1或事件2的發生。
t1時刻,任務T調用aos_event_get()設置事件1,任務B因等到事件1得到運行。
t2時刻,任務T調用aos_event_get()設置事件2,任務A因等到了所有事件1和2而得到運行。
該示例可配置到helloworld_demo中運行,相關代碼的下載、編譯和固件燒錄均依賴AliOS Things配套的開發工具 ,所以首先需要參考《AliOS Things集成開發環境使用說明之搭建開發環境》,下載安裝 。 待開發環境搭建完成后,可以按照以下步驟進行示例的測試。
步驟1 創建或打開工程
打開已有工程
如果用于測試的案例工程已存在,可參考《AliOS Things集成開發環境使用說明之打開工程》打開已有工程。
創建新的工程
組件的示例代碼可以通過編譯鏈接到AliOS Things的任意案例(solution)來運行,這里選擇helloworld_demo案例。helloworld_demo案例相關的源代碼下載可參考《AliOS Things集成開發環境使用說明之創建工程》。
步驟2 添加組件
案例下載完成后,需要在helloworld_demo組件的package.yaml中添加對組件的依賴:
depends:
- osal_aos: dev_aos # helloworld_demo中引入osal_aos組件
步驟3 下載組件
在已安裝了的開發環境工具欄中,選擇Terminal -> New Terminal啟動終端,并且默認工作路徑為當前工程的workspace,此時在終端命令行中輸入:
aos install osal_aos
上述命令執行成功后,組件源碼則被下載到了./components/osal_aos路徑中。
步驟4 添加示例
在osal_aos組件的package.yaml中添加example示例代碼:
depends:
- rhino: dev_aos
- cli: dev_aos # 添加cli依賴
source_file:
- "*.c"
- "example/evnet_example.c" # 添加 evnet_example.c
步驟5 編譯固件
在示例代碼已經添加至組件的配置文件,并且helloworld_demo已添加了對該組件的依賴后,就可以編譯helloworld_demo案例來生成固件了,具體編譯方法可參考《AliOS Things集成開發環境使用說明之編譯固件》。
步驟6 燒錄固件
helloworld_demo案例的固件生成后,可參考《AliOS Things集成開發環境使用說明之燒錄固件》來燒錄固件。
步驟7 打開串口
固件燒錄完成后,可以通過串口查看示例的運行結果,打開串口的具體方法可參考《AliOS Things集成開發環境使用說明之查看日志》。
當串口終端打開成功后,可在串口中輸入help來查看已添加的測試命令。
步驟8 測試示例
CLI命令行輸入:
event_example
關鍵日志:
[aos_event_example]set event 1!
[aos_event_example][taskA]field1=0, field2=0, field3=0, field4=0
[aos_event_example]set event 2!
[aos_event_example][taskB]field1=1123961442, field2=1123961442, field3=1123961442, field4=1123961442
注意事項
在刪除事件時,如果有任務阻塞在該事件上,則將這些任務從此事件上脫離,這種任務行為像是事件發生導致的,但實際上并非如此。所以刪除事件時需要謹慎。
FAQ
Q1: 調用aos_event_get()接口無限期的等待事件,timeout參數怎么設置? 答:將timeout賦值為AOS_WAIT_FOREVER。