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

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

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

一、Air780EPM低功耗模式

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

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

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

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

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

注意：1和2沒有任何區(qū)別，設(shè)置1和2都是同一個低功耗模式，請大家在設(shè)計時務必注意?。?！

1.3 pm.power(id, int)

設(shè)置Air780EPM進入常規(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）例子：

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

2.1 pm.dtimerStart(id, timeout)

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

1）參數(shù)：

id：int型

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

timeout：int型（定時時長，單位毫秒）。

2）返回值：

返回值類型：boolean；

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

3）例子：

2.2 pm.dtimerStop(id)

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

1）參數(shù)：

id：int型（定時器id）；

2）返回值：無

3）例子：

2.3 pm.dtimerCheck(id)

檢查底層定時器是不是在運行。

1）參數(shù)：

id：int型（定時器id）；

2）返回值：

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

返回值類型：number（如果運行，運行剩余時間，單位毫秒）。

3）例子：

2.4 dtimerWkId()

檢查定時喚醒是哪一個定時器，如果不是定時喚醒的，返回-1。

1）參數(shù)：無

2）返回值：

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

3）例子：

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

3.1 pm.lastReson()

Air780EPM共有如下幾種開機形式：

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

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

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

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

1）參數(shù)：

id：int型

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

timeout：int型（定時時長，單位毫秒）。

2）返回值：

3）例子：

3.2 pm.shutdown()

用于關(guān)機。

1）參數(shù)：無

2）返回值：nil（無返回值）

3）例子：

3.3 pm.reboot()

用于重啟。

1）參數(shù)：無

2）返回值：nil（無返回值）

3）例子：

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

pm.ioVol(id, val)

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

Air780EPM的IO高電平，出廠默認3.0V：

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

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

任何情況下，無論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)補充說明

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

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

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

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

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

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

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

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

定時器喚醒；

開機鍵PWRKEY；

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

WAKEUP中斷；

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

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

5.4 關(guān)于PWRKEY開機和Reset復位的補充說明

Air780EPM默認開啟了PWRKEY開機防抖；因為開啟了PWRKEY開機防抖，所以Reset復位功能就轉(zhuǎn)變成了關(guān)機，不能復位。

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

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

www.air780epm.cn

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

審核編輯 黃宇