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

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

其核心功能包括：

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

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

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

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

一、Mobile功能示例demo

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

示例功能測(cè)試：

SIM卡配置和管理功能；

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

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

頻段（Band）測(cè)試和修改功能；

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

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

1.1 SIM卡管理和選擇

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

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

2）代碼示例：

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

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

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

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

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

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

2）代碼示例：

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

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

輪詢(xún)式會(huì)按照設(shè)定的時(shí)間間隔主動(dòng)查詢(xún)：

1.3 SIM卡APN的設(shè)置

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

2）代碼示例：

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

1.4 頻段（Band）測(cè)試和修改

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

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

2）代碼示例：

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

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

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

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

2）代碼示例：

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

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

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

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

2）代碼示例：

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

1.7 SIM卡熱插拔功能

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

2）代碼示例：

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

二、常見(jiàn)問(wèn)題及解決辦法

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

此類(lèi)問(wèn)題可參考以下要點(diǎn)檢測(cè)：

檢查SIM卡是否正確安裝；

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

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

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

此類(lèi)問(wèn)題可參考以下要點(diǎn)檢測(cè)：

檢查天線連接是否良好；

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

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

檢查周?chē)靖采w情況。

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

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

2.4 專(zhuān)網(wǎng)卡訪問(wèn)白名單

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

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

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

審核編輯 黃宇