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

在面向物聯網的移動通信技術中，4G-Cat.1憑借其在性能、功耗與成本之間的優異平衡，已成為中低速連接場景的主流選擇。

LuatOS提供了Mobile核心庫，幫助開發者高效管理設備通信。

該庫提供簡潔易用的API接口，涵蓋網絡連接、狀態監控與高級功能配置，兼容所有基于LuatOS的通信模組。支持設備入網、信號質量監測、小區信息獲取等多種物聯網場景，為設備提供穩定可靠的通信能力。

其核心功能包括：

聯網配置：管理SIM卡與APN設置，快速建立穩定網絡連接。

狀態監控：實時獲取網絡注冊狀態、信號強度與質量指標。

信息管理：查詢基站小區信息、統計通信流量等。

本文將以低功耗Cat.1模組Air780EPM系列核心板/開發板為例，分享Mobile核心庫應用示例要點。

一、Mobile功能示例demo

Mobile功能是Air780EPM最核心的功能之一，掌握這些功能的使用方法，對于開發基于移動網絡的通信應用至關重要。

示例功能測試：

SIM卡配置和管理功能；

基站數據查詢（訂閱式和輪詢式）功能；

SIM卡狀態訂閱功能；

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

移動網絡信息獲取（IMEI/IMSI/信號強度等）功能。

以下是Air780EPM移動網絡各種功能的實現方法和核心代碼邏輯，完整demo詳見源碼倉庫。

1.1 SIM卡管理和選擇

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

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

2）代碼示例：

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

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

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

1.2 基站數據查詢

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

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

2）代碼示例：

3）燒錄運行：使用Luatools將相關代碼燒錄到Air780EPM核心板/開發板。設備成功連接到網絡后，會定期獲取并打印基站信息。

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

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

1.3 SIM卡APN的設置

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

2）代碼示例：

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

1.4 頻段（Band）測試和修改

頻段配置功能用于查詢和修改設備使用的網絡頻段，可根據實際需求調整支持的頻段。

1）功能定義：查詢當前設備使用的網絡頻段，并演示如何修改頻段配置，然后恢復默認配置。

2）代碼示例：

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

1.5 移動網絡信息獲取

移動網絡信息獲取功能用于獲取設備的各種網絡標識和信號質量參數，包括 IMEI、IMSI、信號強度等。

1）功能定義：定期獲取并打印設備的IMEI、IMSI、網絡狀態、SIM卡ICCID、信號強度（CSQ、RSSI、RSRQ、RSRP、SNR）等關鍵信息。

2）代碼示例：

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

1.6 SIM卡狀態監控

SIM卡狀態監控功能用于實時監控SIM卡的插入、識別和鎖定狀態等變化。

1）功能定義：通過訂閱SIM卡狀態事件，實時獲取SIM卡的狀態變化，并在特定狀態下執行相應操作。

2）代碼示例：

3）燒錄運行：使用Luatools將相關代碼燒錄到Air780EPM核心板/開發板。當SIM卡狀態發生變化時（如SIM卡已準備好、無SIM卡、SIM 卡的寫入次數統計等），日志中會打印相應的狀態信息。

1.7 SIM卡熱插拔功能

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

2）代碼示例：

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

二、常見問題及解決辦法

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

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

檢查SIM卡是否正確安裝；

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

檢查設備的SIM卡槽接口是否正常。

2.2 設備網絡連接不穩定，經常斷開連接或信號質量差。

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

檢查天線連接是否良好；

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

調整設備位置，避免信號屏蔽或干擾；

檢查周圍基站覆蓋情況。

2.3 專網卡如何上網？

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

2.4 專網卡訪問白名單

用定向IP的物聯網卡，需要把域名或IP加入白名單才能使用。

以下是相關應用中，模組會訪問的域名或IP服務器：

今天的內容就分享到這里了~

審核編輯 黃宇