中移物联网有限公司
M5310-A 基本通信流程示例
NB-IoT 系列 M5310-A
v1.0
中移物联网有限公司
2018.7.12
1
中移物联网有限公司
重要声明
版权声明
本文档中的任何内容受《中华人民共和国著作权法》的保护,版权所有 © 2017, 中移物联网有
限公司,保留所有权利,但注明引用其他方的内容除外。
商标声明
中移物联网有限公司和中移物联网有限公司的产品是中移物联网有限公司专有。在提及其他公司
及其产品时将使用各自公司所拥有的商标,这种使用的目的仅限于引用。
不作保证声明
中移物联网有限公司不对此文档中的任何内容作任何明示或暗示的陈述或保证,而且不对特定目
的的适销性及适用性或者任何间接、特殊或连带的损失承担任何责任。
保密声明
本文档(包括任何附件)包含的信息是保密信息。接收人了解其获得的本文档是保密的,除用于
规定的目的外不得用于任何目的,也不得将本文档泄露给任何第三方。
2
中移物联网有限公司
关于文档
修订记录
版本
v1.0
日期
2018.7.12
作者
唐利翰
描述
首次创建
注:文档中涉及的相关指令参数意义详见中移物联网公司《M5310 AT Command》文档
文档中[#Send]标注的部分代表模组侧发送数据内容,[#Recv]标注的部分代表模组侧接收数据内容
3
中移物联网有限公司
目 录
关于文档 .......................................................................................................................................................... 3
一、模组初始化流程 ...................................................................................................................................... 5
1.1 模组上电初始化建议流程图 ................................................................................................................ 5
1.2 模组上电初始化建议 AT 流程 ............................................................................................................. 6
二、UDP 数据收发流程 ................................................................................................................................. 8
2.1 创建 UDP SOCKET ................................................................................................................................. 8
2.2 发送 UDP 数据 ..................................................................................................................................... 9
2.3 接收 UDP 数据 ................................................................................................................................... 10
2.4 关闭 UDP SOCKET ............................................................................................................................... 10
三、TCP 数据收发流程 ............................................................................................................................... 11
3.1 创建 TCP SOCKET ................................................................................................................................ 11
3.2 创建 TCP 连接 .................................................................................................................................... 11
3.3 发送 TCP 数据 .................................................................................................................................... 12
3.4 接收 TCP 数据 .................................................................................................................................... 12
3.5 关闭 TCP SOCKET ................................................................................................................................ 13
四、模组 ONENET 对接流程 ..................................................................................................................... 14
4
中移物联网有限公司
一、模组初始化流程
1.1 模组上电初始化建议流程图
模组上电初始化是模组进行正常数据通信业务之前的必要步骤,在初始化中,
模组将会完成网络搜索、驻网、附着等流程。
5
模组开机ATAT+CIMIAT+CEREG?AT+CGATT?ERRORERRORAT+CSQ数据业务开机:M5310-A VBAT引脚上电自动开机关机:M5310-A VBAT引脚下电自动关机注意供电需要500mA峰值电流开机建议等待20-25s再进行操作执行AT,监测模组是否回复OK,确认模组开机成功及串口功能正常循环发送AT直到返回OK,如果发送10次都未返回OK,建议重启,或检查硬件电路检查SIM卡初始化是否成功返回ERROR或者IMSI号如果多次存在问题,建议检查SIM卡电路查询无线信号质量建议CSQ大于12时,进行数据业务若CSQ返回99,99表示未搜索到信号查询NB网络附着状态默认状态下,第二位数据返回1或5指示PS域网络附着成功查询模组PDP上下文状态返回CGATT:1,表示PDP状态正常返回CGATT:0,表示PDP状态异常上述的初始化流程执行成功并通过检查后,方可进行数据业务;执行数据业务过程中,可使用 AT+NUESTATS 指令周期性监控信号质量
中移物联网有限公司
对于 M5310-A 模组,初始化流程由模组自动完成,使用时,只需要按照上述流
程,对各初始化 AT 指令查询结果进行判断即可。
目前 M5310-A 已支持 Band3/Band5/Band8/Band20/Band28 频段。模组本身支持
自适应工作频段功能,也支持锁定频段功能;
频段锁定操作如下:
[#Send] AT+NBAND=5,8
[#Recv] OK
//锁定为 Band5 和 Band8
//锁定频段成功
注:
M5310-A 目前支持 Band3/5/8/20/28,用户可根据实际业务选择使用。推荐使用
中锁定频段,可以提高驻网速度。
1.2 模组上电初始化建议 AT 流程
[#Recv] ��S
//模组上电串口初始化打印乱码
Boot: Unsigned
Security B.. Verfied
Protocol A.. Verfied
Apps A...... Verfied
REBOOT_CAUSE_SECURITY_PMU_POWER_ON_RESET
//模组开机自动打印
M5310A
OK
[#Send] AT
[#Recv] OK
[#Send] AT+CIMI
[#Recv] 460042695003799
[#Recv] OK
[#Send] AT+CSQ
[#Recv] +CSQ:31,99
[#Recv] OK
//发送 AT,判断模组开机上电成功
//读取 IMSI,判断 SIM 卡初始化是否成功
//查询当前信号质量
//信号质量查询结果,建议 12 以上方可进行数据业务
6
中移物联网有限公司
[#Send] AT+NUESTATS
[#Recv] Signal power:-538
Total power:-466
TX power:-180
TX time:372
RX time:18750
Cell ID:232460221
ECL:0
SNR:200
EARFCN:3736
PCI:192
RSRQ:-108
OPERATOR MODE:4
OK
[#Send] AT+CEREG?
[#Recv] +CEREG:0,1
[#Recv] OK
[#Send] AT+CGATT?
[#Recv] +CGATT:1
[#Recv] OK
注:
//查询当前驻留小区相关信息
//信号电平
//信噪比,推荐 50 以上进行数据业务
//频点信息
//物理小区编号
//查询网络附着情况
//附着状态为 1 或 5 表示附着成功
//查询模组网络激活状态
//返回 1 指示网络激活成功,可以进行后续数据业务
1. 需要确认入网状态为已注册才能进行后续数据收发操作,目前测试开机注册
时间范围为 20s-25s 左右,在极端网络情况下,可能最大延迟到 120s;
2. 每条 AT 命令之间应该留有 300ms 以上的时间间隔;与网络交互的 AT 指令
响应时间,视网络情况而定。
如果需要使用网络信号变更提示主动上报,可以使用如下 AT 指令:
[#Send] AT+CSCON=1
[#Recv] OK
[#Recv] +CSCON:1
//打开信号提示自动上报,此步骤可省略
//自动上报的网络信号提示——已连接
7
中移物联网有限公司
如果需要注册状态信息主动上报,可以使用如下 AT 指令:
[#Send] AT+CEREG=1
//打开注册信息自动上报,此步骤可省略
[#Recv] OK
[#Recv] +CEREG:1,19E6,94,7
//自动上报的网络注册信息
//1-本地网络已注册入网,5-漫游已注册,
//其它情况为注册异常,详细请参考 AT 命令手册
//用户亦可使用 AT+CEREG?主动查询注册状态
如果设备终端处于运动状态,可以开启注册状态主动上报功能,并周期性监控
CSQ 信号质量。
二、UDP 数据收发流程
2.1 创建 UDP Socket
创建 UDP Socket 后,将会在模组本端,按照给定的通信协议(UDP 协议标号
为 17),创建一个本地通信端口。
Socket 创建指令具体结构如下:
AT+NSOCR=
,,[,]
其中,listen prt 参数表示本地端口号,建议在设置中将本地端口号均设置为 0,
该模式下本地端口号为随机产生;在对接服务器时,服务器侧收到的 IP 均为网关
IP,所以模组本地 IP 和端口对与服务器进行数据通信没有影响。
具体 AT 指令创建 UDP Socket 用例如下:
[#Send] AT+NSOCR="DGRAM",17,0,1
[#Recv] 0
[#Recv] OK
//创建本地UDP监听端口,开启数据自动上报
//创建成功返回socket编号,范围0-6
//注意返回的Socket编号,后续收发数据使用的
Socket需要和返回的Socket编号一致
//创建UDP成功
关于 NSOCR 指令具体参数说明和用法,参见配套 M5310-A AT 指令手册。
8