通信信息(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 频段，和获取相关参数。

三、准备硬件环境

参考：硬件环境清单第二章节内容，准备以及组装好硬件环境。

四、软件环境

“凡事预则立，不预则废。”在详细阐述本功能示例之前，我们需先精心筹备好以下软件环境。

1. Luatools工具；

2. 内核固件文件（底层core固件文件）：LuatOS-SoC_V2002_Air780EP；参考项目使用的内核固件；

3. luatos需要的脚本和资源文件

脚本和资源文件点击此处查看与下载

lib脚本文件：使用Luatools烧录时，勾选添加默认lib 选项，使用默认lib脚本文件；

准备好软件环境之后，接下来查看如何烧录项目文件到Air780EP核心板，将本篇文章中演示使用的项目文件烧录到Air780EP核心板中。

五、代码示例介绍

5.1 查询和设置mobile信息。

5.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

5.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"))

5.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)

5.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)

5.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开发；

本篇文章描述的内容，如果有错误、细节缺失、细节不清晰或者其他任何问题，总之就是无法解决您遇到的问题；

请登录合宙技术交流论坛，点击文档找错赢奖金-Air780EP-LuatOS-软件指南-4G通信-通信信息(mobile)；

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

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

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