跳转至

通信信息(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 源码和工具

六、代码示例介绍

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)

用截图标注+文字描述的方式跟帖回复,记录清楚您发现的问题;

我们会迅速核实并且修改文档;

同时也会为您累计找错积分,您还可能赢取月度找错奖金!