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

一、mobile概述

1.1 簡(jiǎn)介

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

1.2 架構(gòu)

4G網(wǎng)絡(luò)采用了全I(xiàn)P網(wǎng)絡(luò)架構(gòu)，所有數(shù)據(jù)和語音通信都是通過IP（InternetProtocol）傳輸?shù)?。相比之前的移?dòng)通信技術(shù)（如2G和3G），4G能夠更有效地處理數(shù)據(jù)流量，尤其是用于互聯(lián)網(wǎng)服務(wù)和多媒體應(yīng)用。

1.3 采用技術(shù)

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

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

二、演示功能概述

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

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

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

1）Air780E核心板一個(gè)：

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

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

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

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

3.2 SIM卡

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

特別提醒：

請(qǐng)確保SIM卡未欠費(fèi)且網(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ì)使用
• 源碼和固件已打包，如下所示：點(diǎn)我,下載完整壓縮文件包

5.2 常量消息

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

5.3 本demo使用api簡(jiǎn)介

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)置虛擬卡和外置實(shí)體卡，2024年8月13日啟用，虛擬卡需要固件支持，否則切換后無網(wǎng)絡(luò)，需要在飛行模式下切換，或者切換后重啟協(xié)議棧。

參數(shù)：

返回值：

返回值類型

解釋

返回值：

mobile.rtime(time,auto_reset_stack,data_first)

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

參數(shù)：

返回值：

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

作用：設(shè)置一些輔助周期性或者自動(dòng)功能，目前支持SIM卡暫時(shí)脫離后恢復(fù)，周期性獲取小區(qū)信息，網(wǎng)絡(luò)遇到嚴(yán)重故障時(shí)嘗試自動(dòng)恢復(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,參考信號(hào)接收功率。

參數(shù)：

無

返回值：

mobile.rsrq()

作用：獲取rsrq,參考信號(hào)發(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ī)卡號(hào)，注意，只有寫入了手機(jī)號(hào)才能讀出，因此有可能讀出來是空的。

參數(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ù)：

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

返回值：

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

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

?

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

?

![]("點(diǎn)擊并拖拽以移動(dòng)"

6.1.3訂閱查詢的信息：

?

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

?

七、功能驗(yàn)證

實(shí)現(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()時(shí)，專網(wǎng)卡設(shè)置的demo，name，user，password聯(lián)系卡商獲取。

?審核編輯 黃宇