?今天我們一起來學習查找和設置mobile頻段，并獲取相關參數。

一、mobile概述

1.1 簡介

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

1.2 架構

4G網絡采用了全IP網絡架構，所有數據和語音通信都是通過IP（InternetProtocol）傳輸的。相比之前的移動通信技術（如2G和3G），4G能夠更有效地處理數據流量，尤其是用于互聯網服務和多媒體應用。

1.3 采用技術

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

關于4gmobile技術更詳細的使用說明，請參考：https://zh.wikipedia.org/wiki/4G

二、演示功能概述

本demo演示了查找和設置mobile頻段，和獲取相關參數。

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

3.1 開發(fā)板準備

1）Air780E核心板一個：

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

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

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

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

3.2 SIM卡

請準備一張可正常上網的SIM卡，該卡可以是物聯網卡或您的個人手機卡。

特別提醒：

請確保SIM卡未欠費且網絡功能正常，以便順利進行后續(xù)操作。

3.3 數據通信線

typec接口USB數據線即可。

3.4 PC電腦

WINDOWS系統。

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

4.1 基本的下載調試工具

使用說明參考：

Luatools下載和詳細使用：

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下載和詳細使用
• 源碼和固件已打包，如下所示：點我,下載完整壓縮文件包

5.2 常量消息

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

5.3 本demo使用api簡介

mobile.status()

作用：獲取網絡狀態(tài)。

參數：

無

返回值：

mobile.getBand(band,is_default)

作用：獲取當前使用/支持的band

參數：

返回值：

mobile.setBand(band,num)

作用：設置使用的band

參數：

返回值：

mobile.flymode(index,enable)

作用：進出飛行模式

參數：

返回值：

mobile.vsimOnOff(enable)

作用：切換內置虛擬卡和外置實體卡，2024年8月13日啟用，虛擬卡需要固件支持，否則切換后無網絡，需要在飛行模式下切換，或者切換后重啟協議棧。

參數：

返回值：

返回值類型

解釋

返回值：

mobile.rtime(time,auto_reset_stack,data_first)

作用：設置RRC自動釋放時間間隔，當開啟時后，遇到極弱信號+頻繁數據操作可能會引起網絡嚴重故障，因此需要額外設置自動重啟協議棧。

參數：

返回值：

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

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

參數：

返回值：

mobile.imei(index)

獲?。韩@取IMEI。

參數：

返回值：

mobile.imsi(index)

作用：獲取IMSI。

參數：

返回值：

mobile.iccid(id)

作用：獲取或設置ICCID。

參數：

返回值：

mobile.csq()

作用：獲取csq。

參數：

無

返回值：

mobile.rssi()

作用：獲取rssi。

參數：

無

返回值：

mobile.rsrp()

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

參數：

無

返回值：

mobile.rsrq()

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

參數：

無

返回值：

mobile.scell()

作用：獲取當前服務小區(qū)更詳細的信息。

參數：

無

返回值：

mobile.getCellInfo()

作用：獲取基站信息。

參數：

無

返回值：

mobile.config(item,value)

作用：網絡特殊配置。

參數：

返回值：

mobile.reqCellInfo(timeout)

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

參數：

返回值：

mobile.number(id)

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

參數：

返回值：

mobile.snr()

作用：獲取snr,信噪比。

參數：

無

返回值：

mobile.simid(id)

作用：獲取當前SIM卡槽,或者切換卡槽。

參數：

填入的參數以表格中的為準。

返回值：

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

作用：獲取或設置APN，設置APN必須在入網前就設置好，比如在SIM卡識別完成前就設置好。

參數：

填入的參數以表格中的為準。

返回值：

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

6.1.1查詢、更改、和恢復band的設置

?

6.1.2查詢mobile相關數據

?

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

6.1.3訂閱查詢的信息：

?

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

?

七、功能驗證

實現了設置頻率和查找到的mobile相關參數的功能。

?

?

八、常見問題

8.1 獲取模塊SN

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

8.2 專網卡如何上網

使用函數mobile.apn()時，專網卡設置的demo，name，user，password聯系卡商獲取。

?審核編輯 黃宇