M531X MQTT 使用指导_v1.3.pdf
该文件是中国移动物联网公司M5310-A芯片的MQTT使用指导中国移动
China Mobie
M531MQT使用指导
关于文档
文档中
系列产品特指
模组
更新记录
Version
Date
Author
Description
1.0
2018-6-11
杯紫微
首次创建
1.1
2018-820
杯紫微
增加声明页,+ MQTTPUBLISH末尾增加rn
1.2
20189-12
杯紫微修正UR上报中的参数误
1.3
2018-9-19
杯紫微
增加M531X系列描述;更改+ MQTTSUB返回值错误描述;更
正+ MQTTPUB一处参数描述错误
中国移动
hina mobile
中国移动
China Mobie
M531MQT使用指导
Content
1M531X系列 MQTT AT命令……
:::::::::::::::·1
1.1 AT+MQTTCFG..
1.2 AT+MQTTOPEN..
1.3 AT+MQTTSTAT..
1.4 AT+MQTTSUB....
1.5 AT+MQTTPUB
1.6 AT+MQTTUNSUB
1.7AT+ MQTTD|SC……
1.8 AT+MQTTDEL............
·::.:.:a::::::::a::a
1.9 AT+MQTTTO
1.10 AT+MQTTPING
111 MQTT URC上报
6
2MQT使用例程
21 MaTT client参数配置
22连接-订阅-推送取消订阅.
23断开连接-销毁参数配置
2.4关于连接断开问题的说明.
8
中国移动
China Mobie
M531MQT使用指导
1M531X系列 MQTT AT命令
1.1
作用该命令配置MTT连接参数
设置命AT+ QTTCFG=host,port),<id),< keepAlive,user>,<pusd>,cle
an>[,< encrypt冫]
返回|0
读取命令AT+ QTTCFG?
AT+MQTTCFG: <host>, port,, id,, keepAlive,, user>,x**xkk clea
返回
n), encrypt>
host
qtt服务器IP或域名地址
port
mqtt服务器端口
客户端ID
eepAlive keepalive时间
参数说明
user
用户名
密码
clean
是否删除 session.1:删除;0:不删除
encrypt是否开启TLS加密(M5310-A暂不支持该参数)
举例
AT+ MQTTCFG-"183.230.40.39”,6002,"4069959”,60,"75829","IIOu0 oFUglguk20 ornTK1 uzAcoM",1
OK
+ MQTTCFG:"183.230.40.s9”,6002,"4069959",60,”75
K
注意
如果 keepAlive时间小于服务器ACK响应检测时间(通过AT+MQTT0设置),会出现 PINGREQ
检测不到断网的情况
作用连接MQTT服务器
AT+MQTTOPENESusrFlag,pwdFlag, wil flag>, wilIRetain,, willQ
设置命令
OS
W1
返回|OK
usrF1ag该标志位被设置表示一个客户端需使用用户名
参数说明 pwd Iag该标志位被设置表示一个客户端需使用密码
willflag被设置为1后,当服务器与客户端通信遇到1/0错误或
中国移动
China Mobie
M531MQT使用指导
客户端没冇在一定时间计划内保持连接时,会发布一个
message。服务器从客户端接收到 DISCONNECT消息时,
并不会触发服务器发送一条Wi1 message
willRetain当客户端意外的断开连接时,服务器是否应该保留被服
务器发布的Wi1l
willQos指定要发布的消息使用的QoS级别
will- topic Will message的主题名称
11消息体
举例
AT+ MQTTOPEⅤ-1,1,0,0,0,","//需要用户名密码(FG配置合令中设置),wi1不设置
+MQTTOPEN: OK
注意
相关命令参数请参照QTTv3.1协议。当连接服务器失败(非密码验证错误)/ACK超付/数据
发送失败/PING超时时会引起终端重连,重连数次失败后停止重连并会上报+ QTTDISC消息,
之后是否重连由客户自行处理;
作用该命令查询QT连接状态
查询命令A+ MQTTSTAT?
MQTTSTAT: stat
返回
Stat
当前连接状态
未初始化
L初始化
已断开
参数说明
发送 Connect包
4
正在重连服务器
已连接
6
t连接服务器中
1.4
作用该命令订阅消息
设置命令AT+ MQTTSUB=< topIc>,qos>[,< index
返回|如果收到服务器订阅ACK信息,会收到LR
MQTTSUBACK
t
中国移动
China Mobie
M531MQT使用指导
读取命令AT+ MQTTSUB?
IQTTSUB
返回
<subscribe list>
topic
订阅的主题
订阅的消息交付质量等级,0-2
packEd
数据包Id
index
接收到 topic发布信息时的操作索引,日前仅支持0,从
AT口输出发布信息
参数说明code
服务器反馈码
Maximum Qoso Success
Maximum QoS1 Success
0x02
Lx imum QoS2 Success
0x80
Failure
subscribe list
已订阅列表
举例
AT+MQTtSUB-"dev/gsm/u, 2
+MQTTSUBACK: 2, 2, dev/gsm/u
T+MQTTSIB?
+MQTTSUB
dev/gsm/u
中国移动
①注意:
订阅消息,订阅成功后存入订阅列表,目前只支持一次增加一个订闶
1.5
作用该命令发布消息
设置命令AT+ MQTTPUB= topic>,qos>)< retain>,<dup),[< msg len>],< message
返回|0
topic
订阅的主题
qos
订阅的消息的QoS等级,支持0-2
retain
服务器是否储存该消息,并问新订阅者发送最新订阅消
参数说明
重发标志,0-1
msg len
输入消息类型,O-字符串输入,1-16进制串输入,缺省时
为 mcssagc解析为字符串输入
message
消息内容
中国移动
China Mobie
M531MQT使用指导
举例
AT+MQTTPUB-"dev/gsm/u", 2, 1, 0, 0, update message
+MQTTPUbrEC: 10.0
+M1 QTTPUBCOMP:⊥0,0
AT+MQTTPUB= dev/gsm/u, 2, 1, 0, 2, 1890
+MQITPUBREC: 11, 0
+MQTTPUBCOMP: 11, 0
注意
川标志将被内部设置为0
1.6
作用该命令取消订阅
设置命令AT+ MQTTUNSUB-< topic
返回当收到服务器取消订阅ACE时,返回
+MQTTUNSUBACK: packed>, topic>
topic
已订阅的主题
参数说明
packⅠ
Id
数据包Id
举例
AT+MQTTLNSUB=dev/gsm/u
+MQTTUNSUBACK:8, dev/gsm/u
hina mobile
注意:
>目前只支持一次取消一个订阅
作用该命令主动断开连接,并发送 DISCONNECT包
执行命令AT+ MQTTDISC
返回当连接断开后,返回+QTDc:表明连接已经断开
当前连接未建立时使用该命令返回+ CME ERROR:3
举例
AT+MQTTDISC
+MQtTDISC: OK
中国移动
China Mobie
M531MQT使用指导
作用该命令刖除MQT客户端实例,并释放资源
执行命令AT+ MQTTDET
返回|0k
举例
AT+MOTTDEL
OK
作用该命令设置ACK超时时间,应配置小于 keepalive时间
设置命令AT+MQmT0< timeout
返回0K
自动上报+QTT:type
timeout
超时时间,如果终端在超时时间内未收到服务器ACK,则
会上报+ MQTTTO,默认10s
typc
超时类型
连接超时
参数说明
23456
PHR a mobile
发布
订阅响
取消订阅响应超时
ping超时
未知类型
作用该命令设置运行心跳包ACK显示,当未检测到服务器ACK时会引起重连
设置命令AT+ MQTTPING=< pecHo
返回OK
参数说明 reecho是否回显+ IQTTPINGRSP消息,默认为0
举例:
+MQTTPI\GRSP: OK
开启回显时如果收到png包响应结果
MQTTPI\GRSP: OK
中国移动
China Mobie
M531MQT使用指导
上报
描述MQTT相关命令LRC自动上报
e +MQTTPUBLISH: dup,, gos>,retained>,<packld>, topic>, msg
len>,<
如果订阅消息的 topIc有 publish推送,则会自动上报此消息
0 +MQTTSLBACK: <packId>,(code>,(topic)
code响应值如下
0x00
Maximum QoSo subscribe Success
OxO
Maximum QoSI subscribe Success
0x02
Maximum Qos2 subscribe Success
消息订阅时的服务器ACK消息上报
0 +MQTTPUBACK: packEd>, <dup>
QoS1模式下消息发布响应ACK上报, packEd为包序号
O +MQTTPLBREC: packEd>, <dup>
Qos2模式下的发布响应2
返回
0 +MQTTPUBREL: packEd), <dup>
Qos2模式下的发布响应3
移多
0 +MQTTPLBCOMP: < packld>, (dup)
Qos2模式下的发布响应4(1ast)
●+ MQTTPINGRSP:0K
客户端ping包ACK,可以通过AT- MOTTPING命令设置是否主动上
报
MQTTUNSUBACK: < packld>,<topic>
取消订阅ACK主动上报
●+ MQTTT0:<type
超时上报
+MQTTDISC
断开连接主动上报
举例
AT+MQTTSUB=dev/gsm/u, 2
+MQI'TSUBACK: 8, 2, dev/ gsm/u
AT+ IQTTPU="dev/gsm/u",2,1,0," update message"向dev/gsm/u主题发送数据**** Hidden Message *****
强烈支持楼主ing…… 强烈支持楼主ing…… 强烈支持楼主……………… 无回帖，不论坛，这才是人道。
页:
[1]