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

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

sys核心庫(kù)提供了四大類(lèi)功能：

Task任務(wù)

Message消息

Timer定時(shí)器

Run調(diào)度器

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

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

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

從設(shè)計(jì)原理的角度來(lái)看：

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

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

從用戶(hù)使用的角度來(lái)看：

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

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

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

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

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

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

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

二、Task函數(shù)詳解

2.1 sys.taskInit(task_func, ...)

1）函數(shù)功能：

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

2）注意事項(xiàng)：

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

3）參數(shù)說(shuō)明：

▼ task_func ▼

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

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

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

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

注意事項(xiàng)：

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

如下代碼就是一個(gè)典型的錯(cuò)誤示例：

正確參數(shù)示例：

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

4）返回值：

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

5）函數(shù)示例：

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

1）函數(shù)功能：

創(chuàng)建并且啟動(dòng)運(yùn)行一個(gè)高級(jí)task。

2）注意事項(xiàng)：

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

3）參數(shù)說(shuō)明：

▼ task_func ▼

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

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

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

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

注意事項(xiàng)：

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

如下代碼就是一個(gè)典型的錯(cuò)誤示例：

正確參數(shù)示例：

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

▼ non_targeted_msg_cbfunc ▼

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

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

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

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

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

取值范圍：無(wú)特別限制；

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

注意事項(xiàng)：

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

如下代碼就是一個(gè)典型的錯(cuò)誤示例：

正確參數(shù)示例：

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

4）返回值：

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

有一個(gè)返回值task_object。

5）函數(shù)示例：

2.3 sys.taskDel(task_name)

1）函數(shù)功能：

刪除一個(gè)高級(jí)task對(duì)應(yīng)的管理表資源。

2）注意事項(xiàng)：

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

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

一般來(lái)說(shuō)，只有如下一個(gè)場(chǎng)景需要用到這個(gè)函數(shù)：

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

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

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

3）參數(shù)說(shuō)明：

4）返回值：nil

5）函數(shù)示例：

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

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

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

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

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

更多開(kāi)發(fā)資料，詳見(jiàn)資料中心：

—— docs.openluat.com


審核編輯 黃宇