快速上手Mobile库：几行代码搞定移动通信

LuatOS提供了Mobile核心库，帮助开发者高效管理设备通信。

该库提供简洁易用的API接口，涵盖网络连接、状态监控与高级功能配置，兼容所有基于LuatOS的通信模组。支持设备入网、信号质量监测、小区信息获取等多种物联网场景，为设备提供稳定可靠的通信能力。

其核心功能包括：

联网配置：
管理SIM卡与APN设置，快速建立稳定网络连接。

状态监控：
实时获取网络注册状态、信号强度与质量指标。

信息管理：
查询基站小区信息、统计通信流量等。

本文将以合宙低功耗Cat.1模组Air780EPM系列核心板/开发板为例，分享Mobile核心库应用示例要点。

一、Mobile功能示例demo

Mobile功能是Air780EPM最核心的功能之一，掌握这些功能的使用方法，对于开发基于移动网络的通信应用至关重要。

示例功能测试：

SIM卡配置和管理功能；

基站数据查询（订阅式和轮询式）功能；

SIM卡状态订阅功能；

频段（Band）测试和修改功能；

移动网络信息获取（IMEI/IMSI/信号强度等）功能。

以下是Air780EPM移动网络各种功能的实现方法和核心代码逻辑，完整demo详见源码仓库。

1.1 SIM卡管理和选择

SIM卡管理功能用于选择和管理设备使用的SIM卡，支持自动选卡功能。

1）功能定义：
配置设备使用的SIM卡，支持手动选择和自动选择两种方式，适用于双卡设备的SIM卡管理。

2）代码示例：

3）烧录运行：
使用Luatools将相关代码烧录到Air780EPM核心板/开发板。

烧录完毕后，设备将按照代码中的配置选择SIM卡。如果启用了自动选卡功能，设备会优先尝试使用SIM0，如果SIM0不可用，则会尝试使用SIM1。

日志中会打印当前使用的SIM卡索引信息，如图下图所示，使用模式2自动选卡功能，此时会自动识别SIM卡所在卡槽，并且优先识别SIM0：

1.2 基站数据查询

基站数据查询功能用于获取设备当前连接的基站信息，支持订阅式和轮询式两种查询方式。

1）功能定义：
通过订阅事件或主动轮询的方式，获取设备当前连接的基站信息，包括主服务小区和临近小区的详细数据。

2）代码示例：

3）烧录运行：
使用Luatools将相关代码烧录到Air780EPM核心板/开发板。设备成功连接到网络后，会定期获取并打印基站信息。

订阅式会在基站信息更新时触发事件：

轮询式会按照设定的时间间隔主动查询：

1.3 SIM卡APN的设置

1）功能定义：
获取或设置SIM卡的APN功能。注意：APN必须在入网前就设置好；在国内公网卡基本上都不需要设置APN，专网卡才需要设置。

2）代码示例：

3）烧录运行：
使用Luatools将相关代码烧录到Air780EPM核心板/开发板。设备启动后，可以看到日志中打印APN相关信息：

1.4 频段（Band）测试和修改

频段配置功能用于查询和修改设备使用的网络频段，可根据实际需求调整支持的频段。

1）功能定义：
查询当前设备使用的网络频段，并演示如何修改频段配置，然后恢复默认配置。

2）代码示例：

3）烧录运行：
使用Luatools将相关代码烧录到Air780EPM核心板/开发板。设备启动后，日志中会清晰显示每个步骤的频段信息。

1.5 移动网络信息获取

移动网络信息获取功能用于获取设备的各种网络标识和信号质量参数，包括 IMEI、IMSI、信号强度等。

1）功能定义：
定期获取并打印设备的IMEI、IMSI、网络状态、SIM卡ICCID、信号强度（CSQ、RSSI、RSRQ、RSRP、SNR）等关键信息。

2）代码示例：

3）烧录运行：
使用Luatools将相关代码烧录到Air780EPM核心板/开发板。设备启动并连接到网络后，会按照设定的时间间隔（15秒）获取并打印各种网络信息。

1.6 SIM卡状态监控

SIM卡状态监控功能用于实时监控SIM卡的插入、识别和锁定状态等变化。

1）功能定义：
通过订阅SIM卡状态事件，实时获取SIM卡的状态变化，并在特定状态下执行相应操作。

2）代码示例：

3）烧录运行：
使用Luatools将相关代码烧录到Air780EPM核心板/开发板。当SIM卡状态发生变化时（如SIM卡已准备好、无SIM卡、SIM 卡的写入次数统计等），日志中会打印相应的状态信息。

1.7 SIM卡热插拔功能

1）功能定义：
实现SIM卡热插拔，通过GPIO中断通过上下边沿电平触发中断。

2）代码示例：

3）烧录运行：
使用Luatools将相关代码烧录到Air780EPM核心板/开发板。当把卡拔掉之后，日志中会提示“拔卡”；当把卡插入之后，日志中会提示“插卡”，并且进出飞行模式重新搜网。

二、常见问题及解决办法

2.1 设备无法识别SIM卡，日志中显示SIM卡错误。

此类问题可参考以下要点检测：

检查SIM卡是否正确安装；

确认SIM卡是否有效且未损坏；

检查设备的SIM卡槽接口是否正常。

2.2 设备网络连接不稳定，经常断开连接或信号质量差。

此类问题可参考以下要点检测：

检查天线连接是否良好；

确认使用的频段是否适合当前地区和运营商；

调整设备位置，避免信号屏蔽或干扰；

检查周围基站覆盖情况。

2.3 专网卡如何上网？

使用函数mobile.apn()，专网卡设置需要的name、user、password联系卡商获取。

2.4 专网卡访问白名单

用定向IP的物联网卡，需要把域名或IP加入白名单才能使用。

以下是相关应用中，合宙模组会访问的域名或IP服务器：

今天的内容就分享到这里了

审核编辑 黄宇