此函數(shù)根據(jù)硬件版本返回充電IC的命令引腳。

6）出廠測(cè)試結(jié)果獲取及版本號(hào)管理：

提供了獲取當(dāng)前硬件版本號(hào)和出廠測(cè)試結(jié)果的方法，以及設(shè)置硬件版本號(hào)的功能。

2.2.2 總結(jié)說明

整段代碼的主要功能是提供對(duì)印刷電路板（PCB）相關(guān)硬件配置和狀態(tài)的管理。通過讀取OTP存儲(chǔ)區(qū)，程序能夠獲取設(shè)備的特定參數(shù)（如版本號(hào)和出廠測(cè)試結(jié)果）。

此外，它還實(shí)現(xiàn)對(duì)GNSS電源、ES8311音頻編解碼器以及充電IC的控制接口，根據(jù)不同的硬件版本提供不同的引腳控制方案。

2.3 batteryManage.lua源碼文件

這段代碼是一個(gè)電池管理模塊的實(shí)現(xiàn)，主要用于監(jiān)控和管理電池狀態(tài)，包括電壓檢測(cè)、充電狀態(tài)判斷、電量計(jì)算和自動(dòng)關(guān)機(jī)功能。

2.3.1 代碼解析

1）模塊定義：

創(chuàng)建一個(gè)名為M的模塊，定義模塊名稱為：

batteryManage

這段注釋用于指出代碼的主要功能，即處理充電IC相關(guān)的邏輯。

2）引入庫：

引入了sys和sysplus庫，這些庫提供了系統(tǒng)和附加功能的支持。

3）初始化狀態(tài)變量：

M.vbat：
當(dāng)前電池電壓；

M.batteryPercent：
電池電量百分比，初始為50；

M.isCharge：
標(biāo)識(shí)是否正在充電；

M.BATTERY_UPDATE_INTERVAL：
電池信息更新的時(shí)間間隔（秒）；

M.noChargeDuration：
記錄未插入電源的時(shí)間；

M.CHARGE_THRESHOLD_TIME：
未充電持續(xù)時(shí)間的閾值（2 分鐘）；

M.blueLed和M.redLed：
用于設(shè)置藍(lán)燈和紅燈的狀態(tài)，分別用GPIO接口進(jìn)行控制。

4）電池放電曲線：

定義一個(gè)電池放電曲線數(shù)組，該數(shù)組存儲(chǔ)對(duì)應(yīng)電量的電壓值，用于通過電壓推算電量百分比。

5）重置未充電時(shí)長：

重置未充電計(jì)時(shí)器的函數(shù)。

6）關(guān)機(jī)函數(shù)：

該函數(shù)用于發(fā)布關(guān)機(jī)信號(hào)，以請(qǐng)求系統(tǒng)關(guān)機(jī)。

7）充電狀態(tài)檢測(cè)：

使用GPIO中斷回調(diào)來檢測(cè)充電狀態(tài)，如果通過GPIO引腳檢測(cè)到充電狀態(tài)發(fā)生變化，將更新充電狀態(tài)并檢查電池狀態(tài)。

8）電量百分比計(jì)算：

根據(jù)當(dāng)前電壓M.vbat計(jì)算電池百分比。如果電壓在放電曲線數(shù)組的范圍內(nèi)，則返回相應(yīng)的電量百分比。

9）定期檢查電池狀態(tài)：

定期更新電池電量，讀取電壓并計(jì)算電量。如果電量低于 30%，且沒有插入電源的時(shí)間超過2分鐘，則調(diào)用關(guān)機(jī)函數(shù)。

10）長按電源鍵關(guān)機(jī)：

實(shí)現(xiàn)了長按電源鍵的關(guān)機(jī)邏輯，按下電源鍵3秒后進(jìn)行關(guān)機(jī)，松開時(shí)取消關(guān)機(jī)。

2.3.2 總結(jié)說明

整體而言，該模塊負(fù)責(zé)監(jiān)控電池的電壓和充電狀態(tài)。它能夠定期更新電量百分比，并在必要時(shí)自動(dòng)關(guān)機(jī)。此外，該模塊還允許用戶通過長按電源鍵來手動(dòng)關(guān)機(jī)。其主要功能是確保設(shè)備在電量過低時(shí)保護(hù)系統(tǒng)不受損壞，同時(shí)提供充電狀態(tài)的實(shí)時(shí)反饋。

2.4 main.lua源碼文件

該文件中的代碼使用Lua語言編寫，主要用于管理和監(jiān)控設(shè)備的電源和電池狀態(tài)。

2.4.1 代碼解析

1）項(xiàng)目和版本信息：

這部分定義了項(xiàng)目名稱和版本，并記錄日志信息，便于后續(xù)的調(diào)試和維護(hù)。

2）庫的引入：

在這里引入了多個(gè)必要的庫文件，包括系統(tǒng)管理庫sys、電路板庫pcb、充電邏輯庫和電池管理庫。通過這些庫，程序可以實(shí)現(xiàn)對(duì)系統(tǒng)的控制和管理。

特別說明：
主要功能代碼已經(jīng)模塊化到batteryManage庫文件中。

3）開機(jī)防抖：

這部分代碼用于防止開機(jī)時(shí)的抖動(dòng)，并點(diǎn)亮紅色指示燈，以表明設(shè)備正在啟動(dòng)。

4）GPIO設(shè)置：

通過gpio.setup配置了兩個(gè)引腳：一個(gè)用于監(jiān)測(cè)充電狀態(tài)，另一個(gè)用于電源鍵的回調(diào)。

5）關(guān)機(jī)處理：

這段代碼訂閱了系統(tǒng)關(guān)機(jī)事件，當(dāng)設(shè)備接收到關(guān)機(jī)信號(hào)時(shí)，會(huì)調(diào)用pm.shutdown()函數(shù)進(jìn)行安全關(guān)機(jī)。

6）啟動(dòng)初始檢查：

在系統(tǒng)啟動(dòng)時(shí)，首先進(jìn)行一次電池充電狀態(tài)檢查，并設(shè)置一個(gè)定時(shí)器，每60秒更新一次電池電量信息。

7）日志輸出：

此段代碼設(shè)置了一個(gè)定時(shí)器，每隔5秒輸出一次當(dāng)前電池狀態(tài)的日志信息，包括電壓、電池電量及充電狀態(tài)，便于監(jiān)控和調(diào)試。

8）程序運(yùn)行：

最后，sys.run()函數(shù)用于啟動(dòng)系統(tǒng)的主循環(huán)，讓程序保持運(yùn)行狀態(tài)。

2.4.2 總結(jié)說明

該代碼的主要功能是管理和監(jiān)控嵌入式設(shè)備的電源與電池狀態(tài)，具備開機(jī)防抖、充電狀態(tài)檢測(cè)、定時(shí)更新電池電量和記錄日志等功能。

2.5 完整源碼文件

此處只展示main.lua，其余完整代碼請(qǐng)下載源碼查看。

最新源碼下載：
https://gitee.com/openLuat/LuatOS-Air201/tree/master/demo/pm

2.6 運(yùn)行結(jié)果展示

可通過LuaTools工具查看運(yùn)行結(jié)果，如下圖所示：

3. 常見問題

設(shè)備無法開啟或頻繁自動(dòng)關(guān)機(jī)

檢查電池電量是否低于安全工作水平，確保設(shè)備充電。如果電量很低，請(qǐng)連接電源并充電一段時(shí)間再嘗試開機(jī)。

電池電量顯示不準(zhǔn)確

確保電池電壓監(jiān)測(cè)模塊正常工作，檢查ADC通道是否正確配置。如有必要，重新校準(zhǔn)電池電量百分比計(jì)算的映射表。

充電狀態(tài)無法正確識(shí)別

檢查充電檢測(cè)的GPIO引腳連接是否正常，確認(rèn)是否存在接觸不良或線路損壞的問題。此外，確保所用充電器和數(shù)據(jù)線與設(shè)備兼容。

系統(tǒng)在充電時(shí)無法正常運(yùn)行

檢查是否有其他程序或任務(wù)占用過多資源，導(dǎo)致系統(tǒng)不穩(wěn)定?？梢钥紤]優(yōu)化系統(tǒng)任務(wù)的優(yōu)先級(jí)或關(guān)閉不必要的功能模塊。

長按電源鍵無反應(yīng)

確認(rèn)電源鍵的GPIO引腳連接正常，確保其可被正常識(shí)別。如果仍然無效，請(qǐng)檢查相關(guān)代碼對(duì)電源鍵的事件處理是否正確。

設(shè)備發(fā)熱嚴(yán)重

設(shè)備發(fā)熱可能是由于充電速率過高或設(shè)備運(yùn)行負(fù)載過重引起的。建議降低負(fù)載、優(yōu)化代碼，或調(diào)整充電策略。

無法更新固件或腳本

檢查USB連接是否正常，確保LuaTools工具正確識(shí)別設(shè)備。注意遵循燒錄步驟，并確保所用的固件版本與硬件兼容。

今天的分享就到這里了

審核編輯 黃宇