低功耗設(shè)計(jì)是Open開發(fā)的核心競(jìng)爭(zhēng)力之一，而電源管理API則是實(shí)現(xiàn)這一目標(biāo)的技術(shù)基石。通過靈活調(diào)用這些接口，開發(fā)者可精準(zhǔn)控制硬件資源使用、動(dòng)態(tài)調(diào)整系統(tǒng)能耗模式、優(yōu)化任務(wù)執(zhí)行時(shí)機(jī)，從而顯著延長(zhǎng)設(shè)備續(xù)航時(shí)間。本文將全面梳理核心API的功能與用法，并提供實(shí)戰(zhàn)案例，助你輕松掌握低功耗開發(fā)精髓。

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

在實(shí)際應(yīng)用中可靈活結(jié)合硬件設(shè)計(jì)，實(shí)現(xiàn)物聯(lián)網(wǎng)設(shè)備超低功耗待機(jī)?、?動(dòng)態(tài)性能優(yōu)化?、?電池保護(hù)及系統(tǒng)防崩潰?的完整電源管理方案。

一、Air780EPM低功耗模式

1.1 功耗模式定義及典型功耗

Air780EPM三種功耗模式的介紹，“常規(guī)模式”、“低功耗模式”、“PSM+模式”，以及典型實(shí)網(wǎng)環(huán)境條件下的功耗測(cè)試數(shù)據(jù)，如下表所示：

1.2 如何設(shè)置Air780EPM功耗模式

我知道你一定會(huì)問：為什么1和2都是低功耗模式？Why？

歷史原因，pm.WORK_MODE在LuatOS中定義了4個(gè)模式，但是，就Air780EPM這一特定型號(hào)來(lái)說，為了方便理解和簡(jiǎn)化設(shè)計(jì)，只定義了3種功耗模式，所以就出現(xiàn)了1和2都是低功耗模式的結(jié)果。

注意：1和2沒有任何區(qū)別，設(shè)置1和2都是同一個(gè)低功耗模式，請(qǐng)大家在設(shè)計(jì)時(shí)務(wù)必注意?。。?/p>

1.3 pm.power(id, int)

設(shè)置Air780EPM進(jìn)入常規(guī)模式、低功耗模式、PSM+模式的函數(shù)。

1）參數(shù)：

id：int型（功耗模式控制id，pm.WORK_MODE）；

int：int型（0，常規(guī)模式；1，低功耗模式；2，低功耗模式；3，PSM+模式； ）。

2）返回值：

返回值類型：boolean；

說明：處理結(jié)果true成功，false失敗。

3）例子：

二、與定時(shí)器喚醒相關(guān)的函數(shù)

2.1 pm.dtimerStart(id, timeout)

啟動(dòng)底層定時(shí)器，在常規(guī)模式/低功耗模式/PSM+模式下都可以生效，只觸發(fā)一次；注意，關(guān)機(jī)狀態(tài)下無(wú)效。

1）參數(shù)：

id：int型

定時(shí)器id；Air780EPM可以設(shè)置多個(gè)定時(shí)器，不同的定時(shí)器ID代表不同的定時(shí)器進(jìn)程；一般來(lái)說，定時(shí)器進(jìn)程不要超過6個(gè)。相應(yīng)的，定時(shí)器ID的取值范圍是0-5； 其中，0和1的最大休眠時(shí)長(zhǎng)是2.5小時(shí)，2到5的最大休眠時(shí)長(zhǎng)是740小時(shí)。

timeout：int型（定時(shí)時(shí)長(zhǎng)，單位毫秒）。

2）返回值：

返回值類型：boolean；

說明：處理結(jié)果。

3）例子：

2.2 pm.dtimerStop(id)

關(guān)閉底層定時(shí)器

1）參數(shù)：

id：int型（定時(shí)器id）；

2）返回值：無(wú)

3）例子：

2.3 pm.dtimerCheck(id)

檢查底層定時(shí)器是不是在運(yùn)行。

1）參數(shù)：

id：int型（定時(shí)器id）；

2）返回值：

返回值類型：boolean（處理結(jié)果，true還在運(yùn)行，false不在運(yùn)行）；

返回值類型：number（如果運(yùn)行，運(yùn)行剩余時(shí)間，單位毫秒）。

3）例子：

2.4 dtimerWkId()

檢查定時(shí)喚醒是哪一個(gè)定時(shí)器，如果不是定時(shí)喚醒的，返回-1。

1）參數(shù)：無(wú)

2）返回值：

int型（處理結(jié)果 >=0 是本次定時(shí)喚醒的定時(shí)器ID，其他錯(cuò)誤，說明不是定時(shí)喚醒的）。

3）例子：

三、開機(jī)、關(guān)機(jī)、重啟等相關(guān)函數(shù)

3.1 pm.lastReson()

Air780EPM共有如下幾種開機(jī)形式：

PSM+模式下，RAM掉電，PSM+模式前數(shù)據(jù)丟失，退出PSM+模式后代碼需要從頭開始運(yùn)行，這個(gè)過程，也被視為"開機(jī)"；

從PSM+模式到低功耗模式或常規(guī)模式，原因有 定時(shí)器喚醒、WAKEUP喚醒、開機(jī)鍵喚醒、UART1喚醒 四種喚醒方式，這四種喚醒方式，是Air780EPM的開機(jī)原因之一；

除從PSM+模式到低功耗模式或常規(guī)模式的開機(jī)之外，還有關(guān)機(jī)狀態(tài)下的PWRKEY開機(jī)、常規(guī)模式/低功耗模式/PSM+模式下的Reset重啟，鬧鐘開機(jī)、軟件重啟、LuaTools等工具控制重啟、內(nèi)部看門狗重啟、外部重啟以及程序跑飛下的異常開機(jī)等。

pm.lastReson()函數(shù)，就是用來(lái)識(shí)別和返回Air780EPM這些開機(jī)原因的函數(shù)。

1）參數(shù)：

id：int型

定時(shí)器id；Air780EPM可以設(shè)置多個(gè)定時(shí)器，不同的定時(shí)器ID代表不同的定時(shí)器進(jìn)程；一般來(lái)說，定時(shí)器進(jìn)程不要超過6個(gè)。相應(yīng)的，定時(shí)器ID的取值范圍是0-5； 其中，0和1的最大休眠時(shí)長(zhǎng)是2.5小時(shí)，2到5的最大休眠時(shí)長(zhǎng)是740小時(shí)。

timeout：int型（定時(shí)時(shí)長(zhǎng)，單位毫秒）。

2）返回值：

3）例子：

3.2 pm.shutdown()

用于關(guān)機(jī)。

1）參數(shù)：無(wú)

2）返回值：nil（無(wú)返回值）

3）例子：

3.3 pm.reboot()

用于重啟。

1）參數(shù)：無(wú)

2）返回值：nil（無(wú)返回值）

3）例子：

四、IO電平介紹及相關(guān)設(shè)置函數(shù)

pm.ioVol(id, val)

IO高電平電壓控制函數(shù)

Air780EPM的IO高電平，出廠默認(rèn)3.0V：

可以通過將Air780EPM的PIN100:IO_Volt_Set拉低到GND改變IO高電平，開機(jī)即設(shè)置為1.8V；

也可以通過此函數(shù)，將IO高電平設(shè)置為典型值1.8V/2.8V/3.0V/3.3V。注意！設(shè)置IO高電平，實(shí)際設(shè)置的是Air780EPM的PIN24:VDD_EXT的電壓，IO高電平與VDD_EXT電壓保持一致。

任何情況下，無(wú)論Air780EPM的PIN100:IO_Volt_Set是懸空還是下拉到GND，IO高電平都是以本函數(shù)的設(shè)置為優(yōu)先。

1）參數(shù)：

id：int型(電平id，目前只有pm.IOVOL_ALL_GPIO）；

val：int型（電平值，單位毫伏）。

2）返回值：

返回值類型：boolean（處理結(jié)果true成功，false失敗）。

3）例子：

五、相關(guān)補(bǔ)充說明

5.1 關(guān)于PSM+模式的補(bǔ)充說明

PSM+模式下，模組處于離線狀態(tài)，無(wú)法接收服務(wù)器下發(fā)信息；退出PSM+模式后，Air780EPM大概在3秒內(nèi)可以駐網(wǎng)成功。

5.2 關(guān)于低功耗模式的補(bǔ)充說明

給出的低功耗模式下的數(shù)據(jù)，是在特定條件下的測(cè)試數(shù)據(jù)，比如，DRX=2.56秒。

實(shí)際環(huán)境下，信號(hào)質(zhì)量、DRX間隔等都是由模組所處環(huán)境的基站決定，模組并不能自行設(shè)置。因此，功耗表現(xiàn)可能與測(cè)試數(shù)據(jù)有差異。

一般情況下，低功耗模式下，模組的功耗在1mA左右都可以被認(rèn)為是正常表現(xiàn)。

5.3 關(guān)于WAKEUP中斷喚醒的補(bǔ)充說明

模組在PSM+模式下有四種常見的喚醒方式：

定時(shí)器喚醒；

開機(jī)鍵PWRKEY；

串口UART1接收數(shù)據(jù)；

WAKEUP中斷；

其中，WAKEUP中斷的使用方式會(huì)在API庫(kù)GPIO中進(jìn)行介紹，開機(jī)鍵PWRKEY本質(zhì)上也是WAKEUP。

比如：WAKEUP0，則用gpio.WAKEUP0；pwrkey，則用常量 gpio.PWR_KEY。

5.4 關(guān)于PWRKEY開機(jī)和Reset復(fù)位的補(bǔ)充說明

Air780EPM默認(rèn)開啟了PWRKEY開機(jī)防抖；因?yàn)殚_啟了PWRKEY開機(jī)防抖，所以Reset復(fù)位功能就轉(zhuǎn)變成了關(guān)機(jī)，不能復(fù)位。

所以，Air780EPM的Reset是關(guān)機(jī)，不是復(fù)位！

Air780EPM最新開發(fā)資料詳見：

www.air780epm.cn

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

審核編輯 黃宇