|
|
该文件是中国移动物联网公司M5310-A芯片的MQTT使用指导2 ]2 Q$ M& i! G w+ Z3 M9 o1 T
中国移动9 u* `* V) ~7 O' f
China Mobie, v6 ?- s9 J: j- o
M531MQT使用指导4 r% m0 r1 x$ f$ G: y: ?# ^
关于文档/ l5 B. ]7 }; v7 p7 ^' L4 V& Q
文档中; B8 }! j2 f6 Z0 s
系列产品特指" [* ?: S# I3 c. h5 s
模组
1 v B2 k( A" W2 X9 R更新记录# S# T1 R# [& P9 \7 I S- _
Version! R* [4 q: ?' l2 W1 c' x! ], M
Date
- G4 P3 H7 e, p( P$ v9 j0 J8 l7 OAuthor
0 w- \& [5 }3 Q7 o4 s, z) H+ o$ JDescription
5 U& x0 C4 k# }9 G6 o1.0
( m3 o$ C' |' o3 H3 H2 @9 n% w2018-6-11
' J4 G% F+ T4 B- k杯紫微
; i4 E, |; }- X) a1 ^4 P' B$ R: B7 s8 Q首次创建
+ {. |8 ?$ E) k b" H$ Q, ~1.1
8 a8 Q8 @2 h9 ]/ d1 S# W( _2018-820
+ @. U) S7 d1 E+ K+ ?% |1 G0 S杯紫微, K0 r6 x6 ?+ D
增加声明页,+ MQTTPUBLISH末尾增加rn4 j2 F8 T! x5 n. N0 `
1.2& n/ l8 m4 m3 u
20189-12" i8 g* O7 k2 I
杯紫微修正UR上报中的参数误
+ V, |$ }$ ]3 E! @' k1.3
4 B3 z5 l7 R+ l2018-9-195 q2 d8 A: k& B
杯紫微3 l4 N9 O7 W+ c2 o
增加M531X系列描述;更改+ MQTTSUB返回值错误描述;更
7 Z, V$ Z3 r# h6 g5 W/ U- ~正+ MQTTPUB一处参数描述错误
* V3 `: f8 s4 p; {0 }/ H中国移动8 J8 i3 M* v' i
hina mobile9 b5 U7 b: \2 z7 \% R
2 w. o& ]- R& v0 g
中国移动0 U% `! \7 A+ R; k- ~ o! H* r
China Mobie
, o) p/ }) j$ b8 l: ~6 s- wM531MQT使用指导# a) t4 t- _2 K. P$ U/ G8 k
Content
: x3 o, Z+ f7 d7 v0 T2 P1M531X系列 MQTT AT命令……
* R; W0 O8 ~. L3 n* E) r1 A+ h:::::::::::::::·16 }; z; m) c- {* ^1 X+ ?
1.1 AT+MQTTCFG..* u, G/ o( u( ^2 a1 |# x. ^3 b* c
1.2 AT+MQTTOPEN..
6 |( G+ i2 i2 f8 A5 [! r1.3 AT+MQTTSTAT.., z6 t9 f# b% t; T/ X" o
1.4 AT+MQTTSUB....
+ A1 b0 Q9 v2 N! _9 D+ t2 x1.5 AT+MQTTPUB
- n, E+ _$ s% T- |1.6 AT+MQTTUNSUB) L2 l4 N* g5 N6 z/ d" O
1.7AT+ MQTTD|SC……1 m& `+ ^5 n4 _) @
1.8 AT+MQTTDEL............! m( m2 M8 H2 n# D7 v q; D
·::.:.:a::::::::a::a" C; h) h/ Z ?" M- A& ?
1.9 AT+MQTTTO6 H Q7 h/ M+ a! B" Y3 x
1.10 AT+MQTTPING5 v+ q" O- }- Y0 }! ]
111 MQTT URC上报7 D! S3 A( y" W. o% F" I5 ]
6
}3 i! u: j6 n2MQT使用例程
+ l8 K& w+ A4 N, T1 q21 MaTT client参数配置
% M/ T& ]( E9 R( @5 g1 W" _6 }& E22连接-订阅-推送取消订阅.
3 X- Y; h( G$ S/ r1 s! I3 p23断开连接-销毁参数配置3 w5 o& U2 W) [' Y2 j8 _7 C1 c& g
2.4关于连接断开问题的说明.+ ], ?1 _) U4 H$ @) v% Z: J
8" `. Y. R2 H5 s
$ ]0 Y; C/ ]; r
中国移动
@% W/ T W+ |! X3 E2 F \China Mobie
7 }& D! O' C6 I" GM531MQT使用指导
: b5 U% R; b+ H3 p1M531X系列 MQTT AT命令
% }5 Y9 E# z3 k2 m! R1.1
3 p' L8 c( V% q( H作用该命令配置MTT连接参数
# U' C3 e4 A! W) {- n设置命AT+ QTTCFG=host,port),,,cle
; ]0 K7 q2 r5 X# N- S' Qan>[,< encrypt冫]
# V. L% Y/ b9 L4 H返回|05 I5 y8 m2 V0 F, M# ]& W" p
读取命令AT+ QTTCFG?& o; e$ w" a+ Z- B# V
AT+MQTTCFG: , port,, id,, keepAlive,, user>,x**xkk clea& ^+ g. d5 P' h" `% j7 z
返回
$ s1 V7 P0 C8 R5 w" s8 mn), encrypt>
6 \" O; Y$ @4 |6 v% Z" ^host- e3 \9 l# D% o
qtt服务器IP或域名地址
0 h4 ^9 O: [. o+ yport
* W2 W6 c; k! i' b. w( O: `" rmqtt服务器端口
0 {: N# Q! X" M) N. ]6 ?客户端ID
. [. U5 k& F; L+ M. k7 i& r5 |& deepAlive keepalive时间5 f* E' p* }% k! ^, k: C
参数说明- A6 ` q( o# ^$ [
user
% }6 P$ F& s( W d用户名# I" X5 h3 \4 S1 N8 g* e0 k
密码% T4 \" n4 o% Q+ i+ X* a1 H- U$ Y
clean$ s+ x4 x( R) q: G) S% {1 C E
是否删除 session.1:删除;0:不删除- E8 ~% J8 e' z5 R; O
encrypt是否开启TLS加密(M5310-A暂不支持该参数): y* b" ^5 s) K8 E/ ]7 Y* S8 A
举例4 |$ Z8 Q W$ l& ]- q- ]
AT+ MQTTCFG-"183.230.40.39”,6002,"4069959”,60,"75829","IIOu0 oFUglguk20 ornTK1 uzAcoM",1$ P% o+ H& w1 u% [4 r. n
OK) P! J- P/ x# L" B; n+ ]
+ MQTTCFG:"183.230.40.s9”,6002,"4069959",60,”75
/ ~2 X/ S6 k: ^. }) \. h/ [0 L0 fK/ A' M( {1 w1 I* Y! t; ?8 z
注意4 F+ X8 e% y$ _! ^% w
如果 keepAlive时间小于服务器ACK响应检测时间(通过AT+MQTT0设置),会出现 PINGREQ O/ u! `) C; x) t. l
检测不到断网的情况* f3 M: h) A6 d" I* p: J7 o, e
作用连接MQTT服务器
& d$ s) |0 } P9 u7 F( oAT+MQTTOPENESusrFlag,pwdFlag, wil flag>, wilIRetain,, willQ
* l5 J$ u! _0 D/ Q4 F2 ^& o- m设置命令
$ S* \ g( X' vOS e7 M! ^6 y- m0 T" r- h
W1; Z# Y6 I9 k/ r, P
返回|OK
- q% l9 g% ?6 TusrF1ag该标志位被设置表示一个客户端需使用用户名
/ V% b, _* I* C4 O6 q参数说明 pwd Iag该标志位被设置表示一个客户端需使用密码+ U0 h' B) s# y3 h6 J' a
willflag被设置为1后,当服务器与客户端通信遇到1/0错误或
! X9 {& D2 I" W. [( L3 a9 e$ a: ]2 O$ |3 i
中国移动
4 R3 X; G7 ?5 \ G% ?China Mobie; g' p4 r, p$ [% m4 R* s7 H; w: z
M531MQT使用指导
3 M7 L0 N' n2 P) a6 H/ E* O客户端没冇在一定时间计划内保持连接时,会发布一个
6 ~; b& P9 S, Zmessage。服务器从客户端接收到 DISCONNECT消息时,/ @" s8 w. M* y' \+ c0 r
并不会触发服务器发送一条Wi1 message
) R/ U* O( w& z" i0 T, z" }willRetain当客户端意外的断开连接时,服务器是否应该保留被服
6 K, X* v& L' ?$ Q% b9 }务器发布的Wi1l
. P8 I/ S- u, j. {; r/ G" g7 XwillQos指定要发布的消息使用的QoS级别
! @: k$ k- O- T1 @3 B& Awill- topic Will message的主题名称6 e% Z4 D' B& {* D
11消息体
! A, i0 f. x. N3 |3 X; P5 c举例
% {2 [ T: C: t; d8 mAT+ MQTTOPEⅤ-1,1,0,0,0,","//需要用户名密码(FG配置合令中设置),wi1不设置
0 o4 p/ m$ ~$ h% K! L+MQTTOPEN: OK
7 d$ I9 V3 L E: ~* m% m注意4 C. d+ T1 m6 t
相关命令参数请参照QTTv3.1协议。当连接服务器失败(非密码验证错误)/ACK超付/数据$ l! {* L% K# R5 q$ @& K' c7 n Y
发送失败/PING超时时会引起终端重连,重连数次失败后停止重连并会上报+ QTTDISC消息,+ {: g' g( `# }! U' Q- q
之后是否重连由客户自行处理;( u. |8 i/ m5 V6 C: w: a3 K& j
作用该命令查询QT连接状态
, r- q9 [( M" k# {) c: T查询命令A+ MQTTSTAT? n4 @6 j% O8 y( d Q
MQTTSTAT: stat: d0 I1 u8 H( g; n
返回
5 X% A/ l7 k$ g Y8 l, O1 r0 ^Stat
2 a7 D8 _' B# N- ]; @2 ]当前连接状态
* d2 W c' m8 m& H, V$ J9 ^& \# [未初始化0 A& k+ G ~/ l. k
L初始化
$ e1 m$ J4 v" K2 H4 _( L8 U; c2 x已断开
- a R8 R+ A4 s# F/ Y# D! H参数说明
1 Q5 f+ _2 p# p- ]8 g( d1 k0 v0 R发送 Connect包) ^1 v* K6 g0 k: F. r
4/ c* e [4 R* q9 K' y$ s
正在重连服务器% o t! q# x# Y* a& T
已连接: H' y4 N* S: ^/ _6 R. i
62 v* A8 _! ?( r! @- O
t连接服务器中
% B! E. L5 ~- k* G! g8 i9 {1.4% Z+ Z! \5 d/ T2 X2 c
作用该命令订阅消息9 _$ h) E9 z) i
设置命令AT+ MQTTSUB=< topIc>,qos>[,< index
; S7 n H# O! p, b" ~$ z返回|如果收到服务器订阅ACK信息,会收到LR k) Y* E* d' N! Y
MQTTSUBACK! q& {4 }+ t, w% v' w
t
! H1 m8 `' G! t; N$ f1 B( |( o6 j1 P$ `4 |# J6 W
中国移动/ {0 N* F' m8 b0 ^ l: v z# z
China Mobie
7 n$ k" r1 T5 V0 n1 |M531MQT使用指导
/ i2 L' |# ]$ a, V读取命令AT+ MQTTSUB?
* H2 G M U: T$ j* WIQTTSUB
8 o5 `/ n. f/ Y ^& s; e返回# f0 W, r) r( R2 p A2 w
- D- t1 C8 j% g0 {5 x. X
topic
; E. f0 U# Q4 ~2 T& g& W: D$ Z* [订阅的主题 k* u* `9 [4 j# I' ~- @4 X1 h
订阅的消息交付质量等级,0-2
0 ] p; P; E% g5 J* c2 \5 a9 {packEd
% h$ ~1 [+ L" ^7 p: h数据包Id a v1 R% V* `* U4 D
index
+ o) \+ N# n4 K+ h8 C+ H: H% ^1 Q r接收到 topic发布信息时的操作索引,日前仅支持0,从4 S" G0 }1 \% Y/ X9 v
AT口输出发布信息3 \. h& T2 [2 U6 g) a
参数说明code
* T- p) b: \. a! N; |* {% ~: ~, }服务器反馈码" E! S$ V, Z, N# j% Q: C/ l% R' T
Maximum Qoso Success$ h6 M' p: T: g% I7 |$ D1 ^
Maximum QoS1 Success% V6 f7 G: l: K( r2 Y2 t5 {7 X2 o
0x02
2 M$ ]5 M+ t ~3 V) wLx imum QoS2 Success# d$ n8 P/ d% J& O9 P
0x80
. X( e* I- D- x9 |; ?' X7 PFailure& n7 Z+ c0 d8 k" r/ M
subscribe list
' i& u1 I5 y7 p) k4 t, B# [' x已订阅列表
$ g9 ?; N9 S4 ~, n7 R$ V举例" V2 X4 S( M- F+ X. q; J
AT+MQTtSUB-"dev/gsm/u, 2
' `! Z9 Y6 Y# k9 E8 b5 y$ l: U% h8 y+MQTTSUBACK: 2, 2, dev/gsm/u
! ] S+ R$ s! Z a* [" ?- ~T+MQTTSIB?- M7 N) x. F; f0 `$ D- {
+MQTTSUB
0 R: H* j2 Q3 m1 v( j6 s5 Edev/gsm/u
& Y z, N$ T2 j4 L* N0 u: {) F0 D: [中国移动1 c' G6 T6 I, A& U
①注意:1 Q' M b' {" d7 F
订阅消息,订阅成功后存入订阅列表,目前只支持一次增加一个订闶
- q6 i2 @2 v: K5 C. a4 c' A1.5+ U7 n u$ l+ [: E( y- c
作用该命令发布消息
/ K2 T3 ]1 i4 e5 P设置命令AT+ MQTTPUB= topic>,qos>)< retain>,],< message
5 V7 v& Z" l/ J/ T返回|00 `/ j* T( W& ~3 y
topic
+ A0 `" x1 Q( x8 r8 `& f) h u6 g订阅的主题
4 o0 m& }$ o+ M1 D5 L( A" ~2 f7 D( uqos
) k6 ^8 u2 I F4 j8 Z订阅的消息的QoS等级,支持0-2
& {, G% Z: @/ e, ^3 P3 }" Sretain
: S9 R6 k0 F) @0 h服务器是否储存该消息,并问新订阅者发送最新订阅消
6 _( @& |1 _# H7 f9 u% n5 P2 ?参数说明
G0 D4 f5 i# }( k重发标志,0-1
) W( N. m! f: s$ Fmsg len _& d3 m2 c* e9 |. w
输入消息类型,O-字符串输入,1-16进制串输入,缺省时6 e |& P5 U9 p h1 D& W( E
为 mcssagc解析为字符串输入
& `4 U! U5 S V4 z' o) l% z% emessage
( m6 s2 U Y1 X' l% {) P5 e消息内容
8 p1 u8 ~& F f0 V
: r0 D4 \, {% o0 J; z2 y8 @6 {6 q/ |中国移动
2 N. L$ T& J8 R. e8 H4 J) `. BChina Mobie* |* G/ p5 x/ ~. P" i$ |! ^/ y+ |" t
M531MQT使用指导& t3 `. ~. N% s
举例5 z9 d Z$ z. [/ s6 ?, j
AT+MQTTPUB-"dev/gsm/u", 2, 1, 0, 0, update message
, R# b% O0 E* n j+MQTTPUbrEC: 10.01 s2 x: s: O4 b2 f* a0 v+ F
+M1 QTTPUBCOMP:⊥0,0
! P6 l, m/ E& w& \2 T' O% F3 iAT+MQTTPUB= dev/gsm/u, 2, 1, 0, 2, 1890
# j1 {6 ]" L2 w: ?8 m) S+MQITPUBREC: 11, 0
' ]( x) d/ x9 _/ I- B7 K: a( S/ z+MQTTPUBCOMP: 11, 0
) p, n- P9 ~- j- g注意8 y( A; F7 k: N% T
川标志将被内部设置为0
/ v# i! x' t8 k8 v5 t1.61 q; ]) q" g% k
作用该命令取消订阅( X- K# l3 L5 {/ n1 S! m$ J
设置命令AT+ MQTTUNSUB-< topic; n' U5 f/ w% m" r+ d% h. U5 \* g
返回当收到服务器取消订阅ACE时,返回2 t1 d) \; g) `1 w$ N( h. c
+MQTTUNSUBACK: packed>, topic>3 e7 W+ ~3 k& E& V7 O. D3 A
topic, O( t0 V' ^$ s. r6 D& u; L
已订阅的主题1 p6 V, A u7 u
参数说明
0 {' X5 Y1 g m; w3 C- k8 |8 u& Q+ MpackⅠ
) a/ i# ^( t- p5 o! GId
/ g1 S: x5 \5 v( a9 G数据包Id- R1 W; ` t% U4 d) B! T8 c
举例: Q" e* g' W( V" D% |" v
AT+MQTTLNSUB=dev/gsm/u
2 T3 B" u' |! ?3 @# _- Z( x+MQTTUNSUBACK:8, dev/gsm/u
, A3 }0 T, I+ _# Q4 @2 [hina mobile! D" }# ?' Y6 Y9 `
注意:9 C7 G2 Q6 `* r
>目前只支持一次取消一个订阅
' |; V& q5 h* H# f2 \/ D作用该命令主动断开连接,并发送 DISCONNECT包8 t4 p3 A. J; R% F& k# y
执行命令AT+ MQTTDISC
5 k& ~( y5 h+ J9 m7 J: z返回当连接断开后,返回+QTDc:表明连接已经断开7 H' v4 P5 x7 {* l
当前连接未建立时使用该命令返回+ CME ERROR:3
. x$ R: z6 w0 {& A- j5 U% l7 j5 x举例- R$ A' }5 u/ I L9 e/ }2 w* t; W
AT+MQTTDISC0 K' y' \/ g+ J! g/ ~6 ^% Y" C
+MQtTDISC: OK) D6 U! }4 H: ~" A4 S) k
0 A6 ]5 b( _0 O2 ~. I, y( [. [2 O! {中国移动
& L+ H( n5 m7 o* e p2 v3 L1 tChina Mobie
; r$ k' A: H/ DM531MQT使用指导
3 O+ c2 \% F4 q, h, \% K' P6 d5 E作用该命令刖除MQT客户端实例,并释放资源7 o: p! r2 W. @/ z) j% C% e3 c
执行命令AT+ MQTTDET0 N1 r7 ?& D7 a: z. p1 L
返回|0k
9 K a8 r6 i# l. ~举例
9 \# @4 Z9 g# C, n- g3 e5 LAT+MOTTDEL
X: Q% b2 s& z0 J' jOK
1 K" L, _8 v+ m* U7 A0 t) i作用该命令设置ACK超时时间,应配置小于 keepalive时间
. a$ V, ^( z. \0 a设置命令AT+MQmT0< timeout
; y8 \, s4 ^3 H: @- k9 U" b, \返回0K
% w/ D+ P' L( f4 r; J$ e. w自动上报+QTT:type- B0 z+ i' e8 S' h& m+ C' u2 I" P
timeout) [$ A* v+ L7 ~5 a) J
超时时间,如果终端在超时时间内未收到服务器ACK,则; f; |+ m% t- C* g# j! u
会上报+ MQTTTO,默认10s( ?) i- v- ` j6 o. w- Q
typc2 s; G$ E- c4 O; @2 I$ X4 P6 |$ W
超时类型" K( ^& E" I2 W$ G
连接超时' d4 l0 R9 m4 I3 C: p/ z; D
参数说明2 T2 Y4 }: E, N+ m( F
23456. S( s; z# X) A) G' |
PHR a mobile
/ G0 G- E# D4 g发布
. L- \' X! m1 R# h6 ?订阅响& g6 F( M4 O" g0 t0 k0 D
取消订阅响应超时
' n" E. K# v9 Jping超时! \1 D( p% W! l# v* P3 }* ^. N
未知类型
9 v5 W7 y: e Z1 j( L9 i0 K作用该命令设置运行心跳包ACK显示,当未检测到服务器ACK时会引起重连9 X @) o; V: F1 h
设置命令AT+ MQTTPING=< pecHo+ y+ c" W' N8 @. V+ e6 h
返回OK
+ L, c% H7 q: g2 y' u3 j$ H" f5 F参数说明 reecho是否回显+ IQTTPINGRSP消息,默认为0; Y2 C! C# K& J% w* D
举例:8 b3 C; w' C. F% F+ z
+MQTTPI\GRSP: OK
- u* J; l+ w; d. u" U开启回显时如果收到png包响应结果
$ s' O- I5 P; b% n6 c9 SMQTTPI\GRSP: OK
# k& \9 U; F" [$ ^' H2 e6 Y% o
7 [. r+ Q T) {+ l" A中国移动1 _( w$ r1 E* i( I& ]
China Mobie
+ e* j, q3 B: m( Z6 tM531MQT使用指导
, v7 I' C3 h2 m上报% P6 g7 v7 I3 _0 U
描述MQTT相关命令LRC自动上报; r/ _7 t5 p; o
e +MQTTPUBLISH: dup,, gos>,retained>,, topic>, msg4 k9 G$ x7 p# l3 a! z4 N
len>,
+ B# F- O) G; \2 p,(topic)9 D. R T4 K2 D! `1 T% m
code响应值如下 o% ^( \& R+ w
0x00
4 Q) ~ R; m/ J5 m/ T0 iMaximum QoSo subscribe Success/ K4 F9 y0 P* x: @$ f; |% K( ^
OxO
, F6 R) |2 \ D3 v+ DMaximum QoSI subscribe Success
% y& ^: c6 \% |3 M0x02/ S3 U$ E& x( B
Maximum Qos2 subscribe Success
: R. g9 t! i8 x: S/ t$ D消息订阅时的服务器ACK消息上报
6 m# y. ?1 |! _' T! a0 +MQTTPUBACK: packEd>, 3 | B, j+ Q% C
QoS1模式下消息发布响应ACK上报, packEd为包序号
4 {0 P- I3 h0 [& t# t5 K* eO +MQTTPLBREC: packEd>,
% x! |* D3 V. j$ xQos2模式下的发布响应2: ~& [0 a$ b1 f! E" W0 ]7 R
返回
6 n5 R: s; N O' D0 +MQTTPUBREL: packEd), - h6 ]) I3 {/ o
Qos2模式下的发布响应3! _: F: `& ~6 D+ \/ R5 `
移多
$ ?) m* v+ P8 M& O; T# X r0 +MQTTPLBCOMP: < packld>, (dup)
# W5 Z0 n+ y3 k5 w ~0 cQos2模式下的发布响应4(1ast), V5 V8 c+ j7 D2 C% `; z8 n) S) h
●+ MQTTPINGRSP:0K
& G ^: e: K* S T. J3 ], \客户端ping包ACK,可以通过AT- MOTTPING命令设置是否主动上9 f8 m" R& k4 i( Z/ N7 |$ E1 V
报3 G. y6 d; A: R Q" b% M7 J
MQTTUNSUBACK: < packld>,
7 F0 ?+ O# X+ T9 t" N取消订阅ACK主动上报
$ Y8 \% G$ J, ]* L●+ MQTTT0: |
|
[复制链接]
发表于 2022-7-17 17:48:01
