LuatOS提供了Mobile核心庫，幫助開發(fā)者高效管理設(shè)備通信。

該庫提供簡潔易用的API接口，涵蓋網(wǎng)絡(luò)連接、狀態(tài)監(jiān)控與高級功能配置，兼容所有基于LuatOS的通信模組。支持設(shè)備入網(wǎng)、信號質(zhì)量監(jiān)測、小區(qū)信息獲取等多種物聯(lián)網(wǎng)場景，為設(shè)備提供穩(wěn)定可靠的通信能力。

其核心功能包括：

聯(lián)網(wǎng)配置：
管理SIM卡與APN設(shè)置，快速建立穩(wěn)定網(wǎng)絡(luò)連接。

狀態(tài)監(jiān)控：
實時獲取網(wǎng)絡(luò)注冊狀態(tài)、信號強度與質(zhì)量指標。

信息管理：
查詢基站小區(qū)信息、統(tǒng)計通信流量等。

本文將以合宙低功耗Cat.1模組Air780EPM系列核心板/開發(fā)板為例，分享Mobile核心庫應(yīng)用示例要點。

一、Mobile功能示例demo

Mobile功能是Air780EPM最核心的功能之一，掌握這些功能的使用方法，對于開發(fā)基于移動網(wǎng)絡(luò)的通信應(yīng)用至關(guān)重要。

示例功能測試：

SIM卡配置和管理功能；

基站數(shù)據(jù)查詢（訂閱式和輪詢式）功能；

SIM卡狀態(tài)訂閱功能；

頻段（Band）測試和修改功能；

移動網(wǎng)絡(luò)信息獲取（IMEI/IMSI/信號強度等）功能。

以下是Air780EPM移動網(wǎng)絡(luò)各種功能的實現(xiàn)方法和核心代碼邏輯，完整demo詳見源碼倉庫。

1.1 SIM卡管理和選擇

SIM卡管理功能用于選擇和管理設(shè)備使用的SIM卡，支持自動選卡功能。

1）功能定義：
配置設(shè)備使用的SIM卡，支持手動選擇和自動選擇兩種方式，適用于雙卡設(shè)備的SIM卡管理。

2）代碼示例：

3）燒錄運行：
使用Luatools將相關(guān)代碼燒錄到Air780EPM核心板/開發(fā)板。

燒錄完畢后，設(shè)備將按照代碼中的配置選擇SIM卡。如果啟用了自動選卡功能，設(shè)備會優(yōu)先嘗試使用SIM0，如果SIM0不可用，則會嘗試使用SIM1。

日志中會打印當前使用的SIM卡索引信息，如圖下圖所示，使用模式2自動選卡功能，此時會自動識別SIM卡所在卡槽，并且優(yōu)先識別SIM0：

1.2 基站數(shù)據(jù)查詢

基站數(shù)據(jù)查詢功能用于獲取設(shè)備當前連接的基站信息，支持訂閱式和輪詢式兩種查詢方式。

1）功能定義：
通過訂閱事件或主動輪詢的方式，獲取設(shè)備當前連接的基站信息，包括主服務(wù)小區(qū)和臨近小區(qū)的詳細數(shù)據(jù)。

2）代碼示例：

3）燒錄運行：
使用Luatools將相關(guān)代碼燒錄到Air780EPM核心板/開發(fā)板。設(shè)備成功連接到網(wǎng)絡(luò)后，會定期獲取并打印基站信息。

訂閱式會在基站信息更新時觸發(fā)事件：

輪詢式會按照設(shè)定的時間間隔主動查詢：

1.3 SIM卡APN的設(shè)置

1）功能定義：
獲取或設(shè)置SIM卡的APN功能。注意：APN必須在入網(wǎng)前就設(shè)置好；在國內(nèi)公網(wǎng)卡基本上都不需要設(shè)置APN，專網(wǎng)卡才需要設(shè)置。

2）代碼示例：

3）燒錄運行：
使用Luatools將相關(guān)代碼燒錄到Air780EPM核心板/開發(fā)板。設(shè)備啟動后，可以看到日志中打印APN相關(guān)信息：

1.4 頻段（Band）測試和修改

頻段配置功能用于查詢和修改設(shè)備使用的網(wǎng)絡(luò)頻段，可根據(jù)實際需求調(diào)整支持的頻段。

1）功能定義：
查詢當前設(shè)備使用的網(wǎng)絡(luò)頻段，并演示如何修改頻段配置，然后恢復(fù)默認配置。

2）代碼示例：

3）燒錄運行：
使用Luatools將相關(guān)代碼燒錄到Air780EPM核心板/開發(fā)板。設(shè)備啟動后，日志中會清晰顯示每個步驟的頻段信息。

1.5 移動網(wǎng)絡(luò)信息獲取

移動網(wǎng)絡(luò)信息獲取功能用于獲取設(shè)備的各種網(wǎng)絡(luò)標識和信號質(zhì)量參數(shù)，包括 IMEI、IMSI、信號強度等。

1）功能定義：
定期獲取并打印設(shè)備的IMEI、IMSI、網(wǎng)絡(luò)狀態(tài)、SIM卡ICCID、信號強度（CSQ、RSSI、RSRQ、RSRP、SNR）等關(guān)鍵信息。

2）代碼示例：

3）燒錄運行：
使用Luatools將相關(guān)代碼燒錄到Air780EPM核心板/開發(fā)板。設(shè)備啟動并連接到網(wǎng)絡(luò)后，會按照設(shè)定的時間間隔（15秒）獲取并打印各種網(wǎng)絡(luò)信息。

1.6 SIM卡狀態(tài)監(jiān)控

SIM卡狀態(tài)監(jiān)控功能用于實時監(jiān)控SIM卡的插入、識別和鎖定狀態(tài)等變化。

1）功能定義：
通過訂閱SIM卡狀態(tài)事件，實時獲取SIM卡的狀態(tài)變化，并在特定狀態(tài)下執(zhí)行相應(yīng)操作。

2）代碼示例：

3）燒錄運行：
使用Luatools將相關(guān)代碼燒錄到Air780EPM核心板/開發(fā)板。當SIM卡狀態(tài)發(fā)生變化時（如SIM卡已準備好、無SIM卡、SIM 卡的寫入次數(shù)統(tǒng)計等），日志中會打印相應(yīng)的狀態(tài)信息。

1.7 SIM卡熱插拔功能

1）功能定義：
實現(xiàn)SIM卡熱插拔，通過GPIO中斷通過上下邊沿電平觸發(fā)中斷。

2）代碼示例：

3）燒錄運行：
使用Luatools將相關(guān)代碼燒錄到Air780EPM核心板/開發(fā)板。當把卡拔掉之后，日志中會提示“拔卡”；當把卡插入之后，日志中會提示“插卡”，并且進出飛行模式重新搜網(wǎng)。

二、常見問題及解決辦法

2.1 設(shè)備無法識別SIM卡，日志中顯示SIM卡錯誤。

此類問題可參考以下要點檢測：

檢查SIM卡是否正確安裝；

確認SIM卡是否有效且未損壞；

檢查設(shè)備的SIM卡槽接口是否正常。

2.2 設(shè)備網(wǎng)絡(luò)連接不穩(wěn)定，經(jīng)常斷開連接或信號質(zhì)量差。

此類問題可參考以下要點檢測：

檢查天線連接是否良好；

確認使用的頻段是否適合當前地區(qū)和運營商；

調(diào)整設(shè)備位置，避免信號屏蔽或干擾；

檢查周圍基站覆蓋情況。

2.3 專網(wǎng)卡如何上網(wǎng)？

使用函數(shù)mobile.apn()，專網(wǎng)卡設(shè)置需要的name、user、password聯(lián)系卡商獲取。

2.4 專網(wǎng)卡訪問白名單

用定向IP的物聯(lián)網(wǎng)卡，需要把域名或IP加入白名單才能使用。

以下是相關(guān)應(yīng)用中，合宙模組會訪問的域名或IP服務(wù)器：

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

審核編輯 黃宇