MQTT-AT 配置命令手册(ESP8266)
MQTT-AT 配置命令手册
1
6.5.2017
文档标题
版本号
日期
状态
MQTT-AT 配置命令手册
V1.4
2017-04-16
发布
文档受控号
MQTT-AT 配置命令手册_V1.4(ESP8266)
版权声明
本手册版权属于 SimKeim,任何人未经我公司书面同意复制、引用或者修改本手册都将承担法律责任。
MQTT-AT 配置命令手册
2
6.5.2017
版本历史
日期
版本
2017-03-01 V1.0
2017-03-04 V1.1
2017-03-07 V1.2
2017-03-17 V1.3
2017-03-23 V1.4
2017-04-16 V1.4
变更描述
初始版本
作者
修改本文档为适配 ESP8266 的 MQTT 命令
zzh
MQTT-AT 配置命令手册
3
6.5.2017
目录
版本历史.......................................................................................................................................................................3
目录...............................................................................................................................................................................4
1.1 通用参数配置 AT 命令说明:...........................................................................................................................5
1.2 AT+MQCLIENTID: 配置设备 ID........................................................................................................................ 5
1.3 AT+MQIPPORT: 配置 MQTT 服务器................................................................................................................. 5
1.4 AT+MQUSERPWD: 配置用户名密码.................................................................................................................6
1.5 AT+MQSTATUS: 查询 MQTT 当前状态............................................................................................................ 6
1.6 AT+MQSTART: 启动 MQTT................................................................................................................................6
1.7 AT+MQPUBLISH: 推送主题信息....................................................................................................................... 7
1.8 AT+MQSUBSCRIBE: 订阅主题.......................................................................................................................... 7
1.9 AT+MQUNSUBSCRIBE: 取消订阅.................................................................................................................... 7
1.10 AT+MQAUTOSUB: 默认订阅(仅支持一个主题)............................................................................................ 8
1.11 订阅信息上报格式..............................................................................................................................................8
1.12 AT+MQRST 恢复出产设置(AT+RST 不恢复 MQTT 相关配置)............................................................... 8
特别说明:...................................................................................................................................................................9
MQTT-AT 配置命令手册
4
6.5.2017
1.1 通用参数配置 AT 命令说明:
注意:
1) 建议以下 AT 命令都要大写。
2) 本地配置时,每条 AT 命令要以
作为结束。
3) 默认波特率为 115200
4)其他命令参见乐鑫官方手册。
本文部分重复使用的字符串含义介绍:
1、:主题,最大长度为 32
2、:推送或者已订阅主题接收到的数据,最大长度为 64
3、:服务质量等级:0-2
1.2 AT+MQCLIENTID: 配置设备 ID
AT+MQCLIENTID=
:唯一识别码
举例:
查询:AT+MQCLIENTID?
回应:+MQCLIENTID:"DVES_00041A6D"
OK
设置:AT+MQCLIENTID= "DVES_00041A6D"
回应:OK
1.3 AT+MQIPPORT: 配置 MQTT 服务器
AT+MQIPPORT=,
:可以为域名,也可以为 IP 地址
:端口号
MQTT-AT 配置命令手册
5
6.5.2017
举例:
查询:AT+MQIPPORT?
回应:+MQIPPORT: "iot.eclipse.org",1883
OK
设置:AT+MQIPPORT="iot.eclipse.org",1883
回应:OK
1.4 AT+MQUSERPWD: 配置用户名密码
AT+USERPWD=
,
:服务器账号
:服务器密码
举例:
查询:AT+MQUSERPWD?
回应:+MQUSERPWD:"DVES_USER","DVES_PASS"
OK
设置:AT+MQUSERPWD="DVES_USER","DVES_PASS"
回应:OK
1.5 AT+MQSTATUS: 查询 MQTT 当前状态
AT+MQSTATUS
举例:
执行:AT+STATUS
回应:+MQSTATUS: MQTT CONNECTED
OK
1.6 AT+MQSTART: 启动 MQTT
AT+MQSTART
举例:
执行:AT+MQSTART
回应:OK
MQTT-AT 配置命令手册
6
6.5.2017
1.7 AT+MQPUBLISH: 推送主题信息
AT+MQPUBLISH=,,
:主题
:数据内容长度
:服务质量等级:0-2
举例:
执行:AT+MQPUBLISH="/mqtt/topic/0","123456",0
回应:OK
1.8 AT+MQSUBSCRIBE: 订阅主题
AT+MQSUBSCRIBE=,
:主题
:服务质量等级:0-2
举例:
执行:AT+MQSUBSCRIBE="topic/002",1
回应:OK
1.9 AT+MQUNSUBSCRIBE: 取消订阅
AT+MQUNSUBSCRIBE=
:主题
举例:
执行:AT+MQUNSUBSCRIBE="topic/002"
回应:OK
MQTT-AT 配置命令手册
7
6.5.2017
1.10 AT+MQAUTOSUB: 默认订阅(仅支持一个主题)
AT+MQAUTOSUB=,,
:(0,1);0 代表禁止默认订阅,1 代表开启默认订阅
:主题
:服务质量等级:0-2
说明:此功能主要解决模块掉线但主控没有检查到掉线而导致的订阅信息无法接收,建议客户把最重
要的订阅信息写入该配置,当MODE为0时,后两个参数无效。
举例:
查询:AT+MQAUTOSUB?
回应:+MQAUTOSUB:1,"/mqtt/topic/0",0
OK
配置:AT+MQAUTOSUB=1,"/mqtt/topic/0",0
回应:OK
1.11 订阅信息上报格式
模块收到订阅信息后上报格式如下:
+MQD,,:
+MQD:提示符,代表收到的是MQTT服务器返回的数据,与默认的TCP数据提示符IPD区分开来
:数据内容的长度
:主题名称
:具体数据内容
举例:
+MQD,6,"/mqtt/topic/0":"123456"
代表收到主题/mqtt/topic/0的信息,内容长度为6,内容为123456
1.12 AT+MQRST 恢复出产设置(AT+RST 不恢复 MQTT 相关配置)
举例:
查询:AT+MQRST
回应: OK
MQTT-AT 配置命令手册
8
6.5.2017