實時系統(tǒng)的開發(fā)挑戰(zhàn)在于平衡響應時間與系統(tǒng)開銷。LuatOS核心庫通過時間片輪轉(zhuǎn)與優(yōu)先級混合調(diào)度策略，既保證了高實時性任務的即時執(zhí)行，又為低優(yōu)先級任務提供了公平調(diào)度機會。其事件驅(qū)動架構(gòu)還支持異步處理，降低了系統(tǒng)阻塞風險。

在LuatOS開發(fā)中，用于實時操作系統(tǒng)（RTOS）相關(guān)功能的核心庫——提供了定時器管理、系統(tǒng)控制、內(nèi)存監(jiān)控、路徑配置等底層操作接口，為物聯(lián)網(wǎng)設備提供可靠的實時系統(tǒng)基礎(chǔ)支撐。

本文以Air780EPM模組為例，分享RTOS底層操作庫相關(guān)內(nèi)容。

最新資料詳見：https://docs.openluat.com/air780epm/luatos/api/core/rtos

- RTOS底層操作庫API函數(shù) -

1. 系統(tǒng)管理

1）重啟設備：rtos.reboot()

參數(shù)：無；

返回值：無。

示例：

2）獲取固件版本號：rtos.version()

參數(shù)：無；

返回值：字符串（如 "V0001"）。

示例：

3）獲取固件編譯日期：rtos.buildDate()

參數(shù)：無；

返回值：字符串（如 "2025-05-06"）。

示例：

4）獲取硬件BSP型號：rtos.bsp()

參數(shù)：無；

返回值：字符串（如 "Air780EPM"）。

示例：

5）返回底層描述信息：rtos.firmware()

參數(shù)：無；

返回值：字符串。

示例：

2. 內(nèi)存管理

1）獲取內(nèi)存使用信息：rtos.meminfo(type)

參數(shù)：

type：內(nèi)存類型（"sys" 系統(tǒng)內(nèi)存、"lua" Lua 虛擬機內(nèi)存、"psram" PSRAM 內(nèi)存）。默認為 "lua"。

返回值：

總內(nèi)存大?。ㄗ止?jié)）；

已使用內(nèi)存（字節(jié)）；

歷史最高使用內(nèi)存（字節(jié)）。

示例：

2）配置內(nèi)存自動收集策略（補充Lua自動垃圾回收機制）：

rtos.autoCollectMem(period,warning_level, force_level)

參數(shù)：

period：自動收集周期(毫秒)，等同于receive調(diào)用次數(shù)，0~60000。如果是0，則關(guān)閉自動收集功能，默認是100；

warning_level：內(nèi)存使用警戒水位線(百分比)，是總luavm內(nèi)存量的百分比，50~95，內(nèi)存達到(>=)警戒線時才會開始判斷是否要收集。默認是80；

force_level：內(nèi)存使用強制收集水位線(百分比)，是總luavm 內(nèi)存量的百分比，50~95，內(nèi)存達到(>=)強制收集線時會強制收集。默認是90，必須比警戒水位線warning_level大。

注意：內(nèi)存自動收集配置，是lua本身收集機制的一種補充，不是必要的，而且只在luavm空閑時觸發(fā)。

示例：

3. 路徑配置

1）設置自定義Lua腳本搜索路徑rtos.setPaths(pathA, pathB, pathC, pathD)

參數(shù)：

pathA~pathD：路徑模板字符串（支持%s占位符）。

返回值：無。

注意：每個路徑長度不超過23字節(jié)。

示例：

4. 其他底層交互

1）接收并處理底層消息隊列：rtos.receive(timeout)

參數(shù)：

timeout：超時時間，-1表示無限等待。

返回值：

消息ID（若為定時器消息則包含附加信息）。

注意：返回值格式由底層決定，Lua層不保證兼容性。

示例：

2）空操作函數(shù)：rtos.nop()

無參數(shù)、無返回值、無邏輯；

用途：性能測試或調(diào)試時使用。

示例：

今天的內(nèi)容就分享到這里了~

審核編輯 黃宇