?今天我們一起來學(xué)習(xí)查找和設(shè)置mobile頻段，并獲取相關(guān)參數(shù)。

一、mobile概述

1.1 簡介

“4G mobile”指的是第四代移動通信技術(shù)，常用于描述通過4G網(wǎng)絡(luò)進(jìn)行的高速無線數(shù)據(jù)傳輸和通信。4G網(wǎng)絡(luò)最顯著的特征是其高速數(shù)據(jù)傳輸能力。理論上，4G可以提供下行速率高達(dá)100Mbps（移動環(huán)境下）和上行速率達(dá)50Mbps（靜止或低速移動環(huán)境下）。

1.2 架構(gòu)

4G網(wǎng)絡(luò)采用了全I(xiàn)P網(wǎng)絡(luò)架構(gòu)，所有數(shù)據(jù)和語音通信都是通過IP（InternetProtocol）傳輸?shù)摹Ｏ啾戎暗囊苿油ㄐ偶夹g(shù)（如2G和3G），4G能夠更有效地處理數(shù)據(jù)流量，尤其是用于互聯(lián)網(wǎng)服務(wù)和多媒體應(yīng)用。

1.3 采用技術(shù)

4g主要采用正交頻分復(fù)用技術(shù)（OFDM）和多輸入多輸出技術(shù)（MIMO）。OFDM將寬頻帶劃分為多個窄頻帶，從而提高了頻譜的利用效率，并減少了信號間的干擾。它使得4G能夠在同樣的頻譜下傳輸更多的數(shù)據(jù)，并具有更強的抗干擾能力。多輸入多輸出（MIMO）技術(shù)也廣泛應(yīng)用于4G網(wǎng)絡(luò)中。MIMO使用多個天線來同時發(fā)送和接收數(shù)據(jù)，增加了信號的容量和覆蓋范圍，顯著提高了數(shù)據(jù)傳輸速率。

關(guān)于4gmobile技術(shù)更詳細(xì)的使用說明，請參考：https://zh.wikipedia.org/wiki/4G

二、演示功能概述

本demo演示了查找和設(shè)置mobile頻段，和獲取相關(guān)參數(shù)。

三、準(zhǔn)備硬件環(huán)境

3.1 開發(fā)板準(zhǔn)備

1）Air780E核心板一個：

https://item.taobao.com/item.htm?id=693774140934

2）此核心板的詳細(xì)使用說明參考：

https://docs.openluat.com/air780e/product/

Air780E產(chǎn)品手冊中的《開發(fā)板Core_Air780E使用說明V1.0.5.pdf》，核心板使用過程中遇到任何問題，可以直接參考這份使用說明pdf文檔。

3.2 SIM卡

請準(zhǔn)備一張可正常上網(wǎng)的SIM卡，該卡可以是物聯(lián)網(wǎng)卡或您的個人手機(jī)卡。

特別提醒：

請確保SIM卡未欠費且網(wǎng)絡(luò)功能正常，以便順利進(jìn)行后續(xù)操作。

3.3 數(shù)據(jù)通信線

typec接口USB數(shù)據(jù)線即可。

3.4 PC電腦

WINDOWS系統(tǒng)。

四、準(zhǔn)備軟件環(huán)境

4.1 基本的下載調(diào)試工具

使用說明參考：

Luatools下載和詳細(xì)使用：

https://docs.openluat.com/Luatools/

五、mobile的使用軟硬件資料

5.1 源碼和工具

• 780E模塊使用固件：SDK&Demo-合宙文檔中心，本demo使用的固件版本是：
  LuatOS-SoC_V1112_EC618_FULL.soc
• 本教程使用的demo：
  https://gitee.com/openLuat/LuatOS-Air780E/tree/master/demo/mobile
• 將固件和腳本燒錄到模塊中，使用說明參考：Luatools下載和詳細(xì)使用
• 源碼和固件已打包，如下所示：點我,下載完整壓縮文件包

5.2 常量消息

這里是發(fā)布的消息，可以使用sys.waitUntil()或者sys.subscribe()函數(shù)來獲取消息是否發(fā)布。

5.3 本demo使用api簡介

mobile.status()

作用：獲取網(wǎng)絡(luò)狀態(tài)。

參數(shù)：

無

返回值：

mobile.getBand(band,is_default)

作用：獲取當(dāng)前使用/支持的band

參數(shù)：

返回值：

mobile.setBand(band,num)

作用：設(shè)置使用的band

參數(shù)：

返回值：

mobile.flymode(index,enable)

作用：進(jìn)出飛行模式

參數(shù)：

返回值：

mobile.vsimOnOff(enable)

作用：切換內(nèi)置虛擬卡和外置實體卡，2024年8月13日啟用，虛擬卡需要固件支持，否則切換后無網(wǎng)絡(luò)，需要在飛行模式下切換，或者切換后重啟協(xié)議棧。

參數(shù)：

返回值：

返回值類型

解釋

返回值：

mobile.rtime(time,auto_reset_stack,data_first)

作用：設(shè)置RRC自動釋放時間間隔，當(dāng)開啟時后，遇到極弱信號+頻繁數(shù)據(jù)操作可能會引起網(wǎng)絡(luò)嚴(yán)重故障，因此需要額外設(shè)置自動重啟協(xié)議棧。

參數(shù)：

返回值：

mobile.setAuto(check_sim_period,get_cell_period,search_cell_time,auto_reset_stack,network_check_period)

作用：設(shè)置一些輔助周期性或者自動功能，目前支持SIM卡暫時脫離后恢復(fù)，周期性獲取小區(qū)信息，網(wǎng)絡(luò)遇到嚴(yán)重故障時嘗試自動恢復(fù)。

參數(shù)：

返回值：

mobile.imei(index)

獲取：獲取IMEI。

參數(shù)：

返回值：

mobile.imsi(index)

作用：獲取IMSI。

參數(shù)：

返回值：

mobile.iccid(id)

作用：獲取或設(shè)置ICCID。

參數(shù)：

返回值：

mobile.csq()

作用：獲取csq。

參數(shù)：

無

返回值：

mobile.rssi()

作用：獲取rssi。

參數(shù)：

無

返回值：

mobile.rsrp()

作用：獲取rsrp,參考信號接收功率。

參數(shù)：

無

返回值：

mobile.rsrq()

作用：獲取rsrq,參考信號發(fā)送功率。

參數(shù)：

無

返回值：

mobile.scell()

作用：獲取當(dāng)前服務(wù)小區(qū)更詳細(xì)的信息。

參數(shù)：

無

返回值：

mobile.getCellInfo()

作用：獲取基站信息。

參數(shù)：

無

返回值：

mobile.config(item,value)

作用：網(wǎng)絡(luò)特殊配置。

參數(shù)：

返回值：

mobile.reqCellInfo(timeout)

作用：發(fā)起基站信息查詢,含臨近小區(qū)。

參數(shù)：

返回值：

mobile.number(id)

作用：獲取手機(jī)卡號，注意，只有寫入了手機(jī)號才能讀出，因此有可能讀出來是空的。

參數(shù)：

返回值：

mobile.snr()

作用：獲取snr,信噪比。

參數(shù)：

無

返回值：

mobile.simid(id)

作用：獲取當(dāng)前SIM卡槽,或者切換卡槽。

參數(shù)：

填入的參數(shù)以表格中的為準(zhǔn)。

返回值：

mobile.apn(index,cid,new_apn_name,user_name,password,ip_type,protocol)

作用：獲取或設(shè)置APN，設(shè)置APN必須在入網(wǎng)前就設(shè)置好，比如在SIM卡識別完成前就設(shè)置好。

參數(shù)：

填入的參數(shù)以表格中的為準(zhǔn)。

返回值：

6.1查詢mobile的band和iccid和csq等信息。六、代碼示例介紹

6.1.1查詢、更改、和恢復(fù)band的設(shè)置

?

6.1.2查詢mobile相關(guān)數(shù)據(jù)

?

![]("點擊并拖拽以移動"

6.1.3訂閱查詢的信息：

?

6.1.5獲取SIM卡狀態(tài)

?

七、功能驗證

實現(xiàn)了設(shè)置頻率和查找到的mobile相關(guān)參數(shù)的功能。

?

?

八、常見問題

8.1 獲取模塊SN

出廠未必有寫SN，一般用途的唯一id,可以用mobile.imei()代替，如需要真正的唯一ID,使用mcu.unique_id()。

8.2 專網(wǎng)卡如何上網(wǎng)

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

?審核編輯 黃宇