剛?cè)腴T充電管理的新手也能變高手！exchg擴(kuò)展庫(kù)內(nèi)置智能充電邏輯，自動(dòng)適配設(shè)備需求，從充電順序到能耗優(yōu)化全程托管，續(xù)航更持久，管理更省心，快速掌握核心技巧！

本文主要分享exchg擴(kuò)展庫(kù)的相關(guān)函數(shù)說(shuō)明及代碼示例，實(shí)際開發(fā)中可結(jié)合LuatOS生態(tài)靈活運(yùn)用。

注意：開啟充電exchg.start()和關(guān)閉充電exchg.stop()默認(rèn)自動(dòng)執(zhí)行，可以不用操作；當(dāng)碰到某些需要手動(dòng)關(guān)閉或開啟充電功能的場(chǎng)景時(shí)，大家可以自行控制，當(dāng)前僅為預(yù)留。

擴(kuò)展庫(kù)最新資料詳見：

https://docs.openluat.com/osapi/ext/exchg/

一、exchg.start()

1.1 函數(shù)功能

用于開啟充電；

必須在task中運(yùn)行，最大阻塞時(shí)間大概為700ms，阻塞主要由sys.waitUntil("YHM27XX_REG", 500)和sys.wait(200)產(chǎn)生。

1.2 參數(shù)說(shuō)明

參數(shù)：無(wú)；

返回值：boolean：true=成功，false=失敗。

1.3 代碼示例

二、exchg.stop()

2.1 函數(shù)功能

用于關(guān)閉充電；

必須在task中運(yùn)行，最大阻塞時(shí)間大概為700ms，阻塞主要由sys.waitUntil("YHM27XX_REG", 500)和sys.wait(200)產(chǎn)生。

2.2 參數(shù)說(shuō)明

參數(shù)：無(wú)；

返回值：boolean：true=成功，false=失敗。

2.3 代碼示例

三、exchg.setup(v_battery, cap_battery, i_charge)

3.1 函數(shù)功能

用于設(shè)置電池的充電截止電壓/電池容量/充電電流；

必須在task中運(yùn)行，最大阻塞時(shí)間大概為700ms，阻塞主要由sys.waitUntil("YHM27XX_REG", 500)和sys.wait(200)產(chǎn)生。

3.2 參數(shù)說(shuō)明

v_battery:number，電池充電截止電壓(單位：mV)；取值范圍：4200或4350可選, 必須傳入。

cap_battery:number，電池容量(單位：mAh)；取值范圍：>= 100，必須傳入。

i_charge:string，充電電流；

取值范圍：exchg.CCMIN(最小電流)exchg.CCDEFAULT(默認(rèn)電流)exchg.CCMAX(最大電流)三個(gè)可選參數(shù)，不傳入時(shí)默認(rèn)值為exchg.CCDEFAULT。

返回值：boolean：true=成功，false=失敗。

3.3 代碼示例

四、exchg.status()

4.1 函數(shù)功能

獲取充電系統(tǒng)狀態(tài)信息，必須在task中運(yùn)行，最大阻塞時(shí)間（包括超時(shí)重試時(shí)間）大概為20s。

該函數(shù)用于獲取當(dāng)前充電系統(tǒng)的完整狀態(tài)，包括電池電壓、充電階段、充電狀態(tài)、電池在位狀態(tài)、充電器在位狀態(tài)以及IC過(guò)熱狀態(tài)等信息。

其中充電器是否在位，中斷觸發(fā)，觸發(fā)回調(diào)事件為：

CHARGER_STATE_EVENT，附帶的參數(shù)true表示充電器在位，false表示充電器不在位。

4.2 參數(shù)說(shuō)明

參數(shù)：無(wú)；

返回值：table，狀態(tài)信息表。

4.3 狀態(tài)信息表

五、exchg.on(func)

5.1 函數(shù)功能

該函數(shù)用于注冊(cè)exchg事件回調(diào)。

5.2 參數(shù)說(shuō)明

參數(shù)：function，回調(diào)方法；

回調(diào)時(shí)傳入?yún)?shù)有：exchg.OVERHEATexchg.CHARGER_INexchg.CHARGER_OUT

返回值：nil，無(wú)返回值。

5.3 代碼示例

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

審核編輯 黃宇