通信信息(mobile)
一、mobile 概述
简介
Mobile(移动通信): 指所有移动通信技术的统称,包括2G、3G、4G和5G等。它涵盖了从基础的语音通话到数据传输的技术演进。这里将要介绍的是其中的4G Cat1技术。
4G Cat.1(LTE UE Category 1)是4G LTE网络中的一种用户设备类别,主要用于物联网(IoT)应用。与更高类别的4G设备相比,Cat.1设备具有较低的传输速率和功耗,适用于对数据速率要求不高但需要稳定连接的场景。
主要特点:
传输速率:Cat.1设备的下行峰值速率为10Mbps,上行峰值速率为5Mbps,满足中低速率数据传输需求。
功耗与成本:由于传输速率较低,Cat.1设备的功耗和成本相对更低,适合对成本和功耗敏感的物联网应用。
关于 4g Cat1 技术更详细的使用说明,请上网自行搜索。
二、演示功能概述
本 demo 演示了查找和设置 mobile 频段,和获取相关参数。
三、准备硬件环境
3.1 开发板准备
1. Air780E 核心板一个 2. 合宙 Air780E 核心板购买链接(https://item.taobao.com/item.htm?id=693774140934) 3. 此核心板的详细使用说明参考:Air780E 产品手册 中的 《开发板Core_Air780E使用说明VX.X.X.pdf》,写这篇文章时最新版本的使用说明为:《开发板Core_Air780E使用说明V1.0.5.pdf》 ;核心板使用过程中遇到任何问题,可以直接参考这份使用说明 pdf 文档。
3.2 SIM 卡
请准备一张可正常上网的 SIM 卡,该卡可以是物联网卡或您的个人手机卡。
特别提醒:请确保 SIM 卡未欠费且网络功能正常,以便顺利进行后续操作。
3.3 数据通信线
typec 接口 USB 数据线即可。
3.4 PC 电脑
WIN10以及以上版本的WINDOWS系统。
四、准备软件环境
4.1 基本的下载调试工具
使用说明参考:Luatools 下载和详细使用 ;
五、mobile 的使用软硬件资料
5.2 源码和工具
- 780E模块使用固件:SDK& Demo - 合宙文档中心,本 demo 使用的固件版本是:LuatOS-SoC_V1112_EC618_FULL.soc
- 本教程使用的 demo:https://gitee.com/openLuat/LuatOS-Air780E/tree/master/demo/mobile
- 将固件和脚本烧录到模块中,使用说明参考:Luatools 下载和详细使用
- mobile-全部api地址
六、代码示例介绍
6.1 查询和设置mobile信息。
6.1.1 查询、更改、和恢复 band 的设置
log.info("status", mobile.status())
local band = zbuff.create(40)
local band1 = zbuff.create(40)
mobile.getBand(band)
log.info("当前使用的band:")
for i=0,band:used()-1 do
log.info("band", band[i])
end
band1[0] = 38
band1[1] = 39
band1[2] = 40
mobile.setBand(band1, 3) --改成使用38,39,40
band1:clear()
mobile.getBand(band1)
log.info("修改后使用的band:")
for i=0,band1:used()-1 do
log.info("band", band1[i])
end
mobile.setBand(band, band:used()) --改回原先使用的band,也可以下载的时候选择清除fs
mobile.getBand(band1)
log.info("修改回默认使用的band:")
for i=0,band1:used()-1 do
log.info("band", band1[i])
end
6.1.2 查询 mobile 相关数据
log.info("imei", mobile.imei())
log.info("imsi", mobile.imsi())
local sn = mobile.sn()
if sn then
log.info("sn", sn:toHex())
end
log.info("status", mobile.status())
log.info("iccid", mobile.iccid())
log.info("csq", mobile.csq()) -- 4G模块的CSQ并不能完全代表强度
log.info("rssi", mobile.rssi()) -- 需要综合rssi/rsrq/rsrp/snr一起判断
log.info("rsrq", mobile.rsrq())
log.info("rsrp", mobile.rsrp())
log.info("snr", mobile.snr())
log.info("simid", mobile.simid()) -- 这里是获取当前SIM卡槽
log.info("apn", mobile.apn(0,1))
log.info("ip", socket.localIP())
log.info("lua", rtos.meminfo())
-- sys内存
log.info("sys", rtos.meminfo("sys"))
6.1.3 订阅查询的信息:
-- 订阅式, 模块本身会周期性查询基站信息,但通常不包含临近小区
sys.subscribe("SCELL_INFO", function()
log.info("cell", json.encode(mobile.scell()))
end)
-- 基站数据的查询
-- 订阅式, 模块本身会周期性查询基站信息,但通常不包含临近小区
sys.subscribe("CELL_INFO_UPDATE", function()
log.info("cell", json.encode(mobile.getCellInfo()))
end)
6.1.4 轮询搜索小区信息
-- 轮询式, 包含临近小区信息,这是手动搜索,和上面的自动搜索冲突,开启一个就行
sys.taskInit(function()
sys.wait(5000)
mobile.config(mobile.CONF_SIM_WC_MODE, 2)
while 1 do
mobile.reqCellInfo(10)
sys.wait(11000)
log.info("cell", json.encode(mobile.getCellInfo()))
mobile.config(mobile.CONF_SIM_WC_MODE, 2)
end
end)
6.1.5 获取 SIM 卡状态
-- 获取sim卡的状态
sys.subscribe("SIM_IND", function(status, value)
log.info("sim status", status)
if status == 'GET_NUMBER' then
-- 获取到电话号码
log.info("number", mobile.number(0))
end
if status == "SIM_WC" then
-- SIM卡写入次数统计,掉电归0
log.info("sim", "write counter", value)
end
end)
七、功能验证
实现了设置频率和查找到的 mobile 相关参数的功能。
八、总结
本 demo 实现了查找和设置 mobile 频段,和获取 imei、imsi、iccid、csq、rssi、rsrq、rsrp、snr 等相关参数。
常见问题
1、获取模块 SN
出厂未必有写 SN,一般用途的唯一 id, 可以用 mobile.imei()代替,如需要真正的唯一 ID, 使用 mcu.unique_id()。
2、专网卡如何上网
使用函数 mobile.apn()时,专网卡设置需要的name,user,password 联系卡商获取。
给读者的话
本篇文章由
Linden
开发;本篇文章描述的内容,如果有错误、细节缺失、细节不清晰或者其他任何问题,总之就是无法解决您遇到的问题;
请登录合宙技术交流论坛,点击文档找错赢奖金-Air780E-LuatOS-软件指南-4G通信-通信信息(mobile);
用截图标注+文字描述的方式跟帖回复,记录清楚您发现的问题;
我们会迅速核实并且修改文档;
同时也会为您累计找错积分,您还可能赢取月度找错奖金!