概述
epoll實現了Linux兼容的高效的IO多路復用機制epoll。
支持以下幾種場景:
socket fd事件通知;
VFS fd事件通知;
socket與VFS fd混合事件通知。
版權信息
Apache license v2.0
目錄結構
.
├── example # 示例程序
│ ├── epoll_example.c
│ └── test_device.c
├── include
│ ├── epoll.h # 對外頭文件
│ ├── poll.h # 系統中無poll功能時poll的數據結構定義,常用與驅動開發
│ └── private
│ ├── epoll_inner.h # epoll內部數據結構
│ └── rbtree_wrapper.h # 紅黑樹wrapper層
├── package.yaml # 編譯文件
├── README.md # 說明文檔
└── src
├── device.c # epoll設備節點實現
├── epoll.c # epoll接口實現
└── rbtree_wrapper.c # 紅黑樹適配層
依賴組件
osal_aos
vfs
常用配置
系統中相關配置已有默認值,如需修改配置,統一在YAML中def_config節點修改,具體如下:
配置是否支持LWIP:
def_config:
CONFIG_EPOLL_LWIP: 1
配置是否支持標準epoll接口:
def_config:
CONFIG_WITH_MUSL: 0 # 0 支持標準epoll接口,非零說明在musl庫中支持。
API說明
epoll接口定義與Linux的epoll兼容,可參考Linux相關文檔:https://man7.org/linux/man-pages/man7/epoll.7.html。
使用示例
組件使用示例相關的代碼下載、編譯和固件燒錄均依賴AliOS Things配套的開發工具,所以首先需要參考《AliOS Things集成開發環境使用說明之搭建開發環境》,下載安裝。待開發環境搭建完成后,可以按照以下步驟進行示例的測試。
步驟1 創建或打開工程
打開已有工程
如果用于測試的案例工程已存在,可參考《AliOS Things集成開發環境使用說明之打開工程》打開已有工程。
創建新的工程
組件的示例代碼可以通過編譯鏈接到AliOS Things的任意案例(solution)來運行,這里選擇helloworld_demo案例。helloworld_demo案例相關的源代碼下載可參考《AliOS Things集成開發環境使用說明之創建工程》。
步驟2 添加組件
案例下載完成后,需要在helloworld_demo組件的package.yaml中添加對epoll組件的依賴:
helloworld_demo組件的package.yaml中添加
depends:
- epoll: dev_aos # helloworld_demo中引入epoll組件
步驟3 下載組件
在已安裝了的開發環境工具欄中,選擇Terminal -> New Terminal啟動終端,并且默認工作路徑為當前工程的workspace,此時在終端命令行中輸入:
aos install epoll
上述命令執行成功后,組件源碼則被下載到了./components/epoll。
步驟4 添加示例
在epoll組件的package.yaml中添加example示例代碼:
source_file:
- "src/*.c"
- "example/*.c" # add example source
步驟5 編譯固件
在示例代碼已經添加至組件的配置文件,并且helloworld_demo已添加了對該組件的依賴后,就可以編譯helloworld_demo案例來生成固件了,具體編譯方法可參考《AliOS Things集成開發環境使用說明之編譯固件》。
步驟6 燒錄固件
helloworld_demo案例的固件生成后,可參考《AliOS Things集成開發環境使用說明之燒錄固件》來燒錄固件。
步驟7 打開串口
固件燒錄完成后,可以通過串口查看示例的運行結果,打開串口的具體方法可參考《AliOS Things集成開發環境使用說明之查看日志》。
當串口終端打開成功后,可在串口中輸入help來查看已添加的測試命令。
步驟8 測試示例
燒入固件后,輸入cli命令:
epoll_example
可看到如下打印:
epoll_example
epoll wait timeout:ret = 0
epoll_wait,ret = 1
epoll_wait,get event, fd = 513, event = 1
read fd =513, data = 2