Task任務(wù)作為LuatOS的核心組成部分，通過智能化的任務(wù)管理機(jī)制，實(shí)現(xiàn)任務(wù)的創(chuàng)建、調(diào)度與協(xié)同運(yùn)行，讓復(fù)雜應(yīng)用得以高效并行處理，滿足實(shí)時場景下的嚴(yán)苛需求。

sys核心庫是LuatOS運(yùn)行框架庫，也是LuatOS應(yīng)用程序運(yùn)行的核心大腦——所有LuatOS應(yīng)用項目都會使用到sys核心庫。

sys核心庫提供了四大類功能：

Task任務(wù)

Message消息

Timer定時器

Run調(diào)度器

本文將分享sys核心庫Task任務(wù)相關(guān)函數(shù)及其簡要示例，幫助你更好地理解LuatOS開發(fā)基礎(chǔ)。

一、Task：LuatOS任務(wù)功能

Task分為基礎(chǔ)task和高級task兩種，二者主要區(qū)別如下：

從設(shè)計原理的角度來看：

所有的基礎(chǔ)task共享一個全局消息隊列；

每個高級task都有自己獨(dú)立的消息隊列，同時又能使用全局消息隊列。

從用戶使用的角度來看：

基礎(chǔ)task如果阻塞功能使用不當(dāng)，可能會丟失自己應(yīng)該處理的消息；

高級task如果阻塞功能使用不當(dāng)，不會丟失自己應(yīng)該處理的消息。

雖然從設(shè)計原理來看，高級task比基礎(chǔ)task使用起來不容易犯錯；但由于基礎(chǔ)task使用起來簡潔，基礎(chǔ)task還是需要掌握，一旦掌握之后，也不容易犯錯。

sys核心庫提供的task管理功能有以下幾種：

基礎(chǔ)task的創(chuàng)建和啟動運(yùn)行：sys.taskInit(task_func, ...)

高級task的創(chuàng)建和啟動運(yùn)行：sys.taskInitEx(task_func, task_name, non_targeted_msg_cbfunc, ...)

高級task管理表資源的釋放：sys.taskDel(task_name)

二、Task函數(shù)詳解

2.1 sys.taskInit(task_func, ...)

1）函數(shù)功能：

創(chuàng)建并且啟動運(yùn)行一個基礎(chǔ)task。

2）注意事項：

可以在能夠執(zhí)行到的任意代碼位置使用此函數(shù)；在LuatOS中，對創(chuàng)建的task數(shù)量沒有特別限制，只要ram夠用，可以一直創(chuàng)建。

3）參數(shù)說明：

▼ task_func ▼

參數(shù)含義：task的處理函數(shù)；

數(shù)據(jù)類型：function；

取值范圍：任意有效的函數(shù)名都行；

是否必選：必須傳入此參數(shù)。

注意事項：

特別需要注意傳入的函數(shù)名的作用域，如果使用不當(dāng)，很可能會使用一個無效的函數(shù)名。

如下代碼就是一個典型的錯誤示例：

正確參數(shù)示例：

如下所示，定義了一個函數(shù)led_task_func，led_task_func就可以做為此參數(shù)傳入。

4）返回值：

local task_object = sys.taskInit(task_func, ...)有一個返回值task_object

5）函數(shù)示例：

2.2 sys.taskInitEx(task_func, task_name, non_targeted_msg_cbfunc, ...)

1）函數(shù)功能：

創(chuàng)建并且啟動運(yùn)行一個高級task。

2）注意事項：

可以在能夠執(zhí)行到的任意代碼位置使用此函數(shù)；高級task的定義，參考本文第一章節(jié)的描述；在LuatOS中，對創(chuàng)建的task數(shù)量沒有特別限制，只要ram夠用，可以一直創(chuàng)建。

3）參數(shù)說明：

▼ task_func ▼

參數(shù)含義：task的處理函數(shù)；

數(shù)據(jù)類型：function；

取值范圍：任意有效的函數(shù)名都行；

是否必選：必須傳入此參數(shù)。

注意事項：

特別需要注意傳入的函數(shù)名的作用域，如果使用不當(dāng)，很可能會使用一個無效的函數(shù)名。

如下代碼就是一個典型的錯誤示例：

正確參數(shù)示例：

如下所示，定義了一個函數(shù)led_task_func，led_task_func就可以做為此參數(shù)傳入。

▼ non_targeted_msg_cbfunc ▼

參數(shù)含義：task的處理函數(shù)中使用：sys.waitMsg(task_name, msg, timeout)接口阻塞等待msg消息時，接收到msg之外的其他消息時的回調(diào)函數(shù)。

回調(diào)函數(shù)的格式為：

回調(diào)函數(shù)是在task之外的業(yè)務(wù)邏輯中被執(zhí)行的；

在回調(diào)函數(shù)內(nèi)部無法使用sys.wait(timeout)、sys.waitUntil(msg, timeout)、sys.waitMsg(task_name, msg, timeout)等必須用在task中的函數(shù)。

數(shù)據(jù)類型：function或者nil；

取值范圍：無特別限制；

是否必選：可選傳入此參數(shù)。

注意事項：

特別需要注意傳入的函數(shù)名的作用域，如果使用不當(dāng)，很可能會使用一個無效的函數(shù)名。

如下代碼就是一個典型的錯誤示例：

正確參數(shù)示例：

如下所示，定義了一個函數(shù)led_task_cbfunc，led_task_cbfunc就可以作為此參數(shù)傳入。

4）返回值：

local task_object = sys.taskInitEx(task_func, task_name, non_targeted_msg_cbfunc, ...)

有一個返回值task_object。

5）函數(shù)示例：

2.3 sys.taskDel(task_name)

1）函數(shù)功能：

刪除一個高級task對應(yīng)的管理表資源。

2）注意事項：

可以在能夠執(zhí)行到的任意代碼位置使用此函數(shù)；高級task的定義，參考本文第一章節(jié)的描述。

此函數(shù)僅僅刪除一個高級task對應(yīng)的管理表資源，并不能刪除一個高級task。

一般來說，只有如下一個場景需要用到這個函數(shù)：

在高級task的任務(wù)處理函數(shù)中，如果函數(shù)執(zhí)行結(jié)束，需要退出，在退出前執(zhí)行sys.taskDel(task_name)；

高級task的任務(wù)處理函數(shù)執(zhí)行結(jié)束退出后，這個task就消亡了，消亡后這個task_name綁定的資源也沒用處了。

所以在退出之前執(zhí)行sys.taskDel(task_name)，釋放資源，防止出現(xiàn)內(nèi)存泄漏。

3）參數(shù)說明：

4）返回值：nil

5）函數(shù)示例：

以下代碼片段演示一個task的處理函數(shù)在函數(shù)末尾退出前，執(zhí)行sys.taskDel函數(shù)的場景：

以下代碼片段演示一個task的處理函數(shù)在兩種場景下，執(zhí)行sys.taskDel函數(shù)：

在中途的一個分支執(zhí)行return語句，退出處理函數(shù)前，執(zhí)行sys.taskDel函數(shù)；

處理函數(shù)末尾退出前，執(zhí)行sys.taskDel函數(shù)。

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

更多開發(fā)資料，詳見資料中心：

—— docs.openluat.com


審核編輯 黃宇