對于剛接觸移動開發(fā)的程序員來說，通信功能往往是一道門檻。而Mobile庫的出現(xiàn)，讓這一切變得簡單。無需掌握復(fù)雜的系統(tǒng)機(jī)制，只需引入庫并調(diào)用幾個方法，即可實現(xiàn)短信、電話、網(wǎng)絡(luò)等常見功能。本文專為新手設(shè)計，手把手教你用最簡方式快速上手。

在面向物聯(lián)網(wǎng)的移動通信技術(shù)中，4G-Cat.1憑借其在性能、功耗與成本之間的優(yōu)異平衡，已成為中低速連接場景的主流選擇。

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)、信號強(qiáng)度與質(zhì)量指標(biāo)。

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

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

一、Mobile功能示例demo

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

示例功能測試：

SIM卡配置和管理功能；

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

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

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

移動網(wǎng)絡(luò)信息獲?。↖MEI/IMSI/信號強(qiáng)度等）功能。

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

1.1 SIM卡管理和選擇

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

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

2）代碼示例：

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

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

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

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

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

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

2）代碼示例：

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

1.4 頻段（Band）測試和修改

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

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

2）代碼示例：

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

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

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

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

2）代碼示例：

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

1.7 SIM卡熱插拔功能

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

2）代碼示例：

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

二、常見問題及解決辦法

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

此類問題可參考以下要點(diǎn)檢測：

檢查SIM卡是否正確安裝；

確認(rèn)SIM卡是否有效且未損壞；

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

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

此類問題可參考以下要點(diǎn)檢測：

檢查天線連接是否良好；

確認(rèn)使用的頻段是否適合當(dāng)前地區(qū)和運(yùn)營商；

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

檢查周圍基站覆蓋情況。

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

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

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

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

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

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

審核編輯 黃宇