MQTT AT 指令使用说明 #
命令列表 #
- AT+MQTTUSERCFG – 配置 MQTT 用户属性
- AT+MQTTCONNCFG – 配置 MQTT 连接属性
- AT+MQTTCLIENTID – 配置 MQTT 客户端 ID
- AT+MQTTUSERNAME – 配置 MQTT 登录用户名
- AT+MQTTPASSWORD – 配置 MQTT 登录密码
- AT+MQTTCONN – 连接/查询 MQTT Broker
- AT+MQTTPUB – 发布字符串消息
- AT+MQTTPUBRAW – 发布二进制消息
- AT+MQTTSUB – 订阅/查询主题
- AT+MQTTUNSUB – 取消订阅主题
- AT+MQTTCLEAN – 关闭连接, 释放资源
AT+MQTTUSERCFG – 配置 MQTT 用户属性
设置命令 #
AT+MQTTUSERCFG=<LinkID>,<scheme>,<"client_id">,<"username">,<"password">,<cert_key_ID>,<CA_ID>,<"path"> ok
参数说明 #
LinkID: 当前只支持 0
scheme:
1: MQTT over TCP
2: MQTT over TLS(no certificate verify)
3: MQTT over TLS(verify server certificate)
4: MQTT over TLS(provide client certificate)
5: MQTT over TLS(verify server certificate and provide client certificate)
6: MQTT over WebSocket(based on TCP)
7: MQTT over WebSocket Secure(based on TLS, no certificate verify)
8: MQTT over WebSocket Secure(based on TLS, verify server certificate)
9: MQTT over WebSocket Secure(based on TLS, provide client certificate)
10: MQTT over WebSocket Secure(based on TLS, verify server certificate and provide client certificate)
client_id: 对应 MQTT client ID, 用于标志 client 身份, 最长 256 字节
username: 用于登录 MQTT broker 的 username, 最长 64 字节
password: 用于登录 MQTT broker 的 password, 最长 64 字节
cert_key_ID: 证书 ID, 目前支持一套 cert 证书, 参数为 0
CA_ID: CA ID, 目前支持一套 CA 证书, 参数为 0
path: 资源路径, 最长 32 字节
AT+MQTTCLIENTID – 配置 MQTT 客户端 ID #
设置指令 #
AT+MQTTCLIENTID=<LinkID><"client_id"> ok
参数说明 #
- LinkID: 当前只支持 0
- client_id: 对应 MQTT client ID, 用于标志 client 身份, 最长 256 字节
AT+MQTTUSERNAME – 配置 MQTT 登录用户名 #
设置指令 #
AT+MQTTUSERNAME=<LinkID><"username"> ok
参数说明 #
- LinkID: 当前只支持 0
- username: 对应 MQTT username, 用于登录 MQTT broker, 最长 256 字节
AT+MQTTPASSWORD – 配置 MQTT 登录密码 #
设置指令 #
AT+MQTTPASSWORD=<LinkID><"password"> ok
参数说明 #
设置 MQTT 登录密码, 将会覆盖 AT+MQTTUSERCFG 中 password 参数,
用户可通过 AT+MQTTPASSWORD 设置较长的密码.
AT+MQTTCONNCFG – 配置 MQTT 连接属性 #
设置指令 #
AT+MQTTCONNCFG=<LinkID>,<keepalive>,<disable_clean_session>,<"lwt_topic">,<"lwt_msg">,<lwt_qos>,<lwt_retain> ok
参数说明 #
LinkID: 当前只支持 0
keepalive: MQTT PING 超时时间,范围为 [60, 7200], 单位为秒. 默认 120
disable_clean_session: MQTT 清理会话标志, 参数为 0 或 1, 默认为 0
lwt_topic: 遗嘱 topic, 最长 64 字节
lwt_msg: 遗嘱 message, 最长 64 字节
lwt_qos: 遗嘱 QoS, 参数可选 0, 1, 2, 默认为 0
lwt_retain: 遗嘱 retain, 参数可选 0, 1, 默认为 0
AT+MQTTUSERCFG=0,1,"4QR8TZ9ThuL4G","ceshi","123456",0,0,"" AT+MQTTCONN=0,"iot.modbus.cn",1883,0 AT+MQTTSUB=0,"topic",1 AT+MQTTPUB=0,"topic","test",1,0 AT+MQTTCLEAN=0
client_id: 对应 MQTT client ID, 用于标志 client 身份, 最长 256 字节
username: 用于登录 MQTT broker 的 username, 最长 64 字节
password: 用于登录 MQTT broker 的 password, 最长 64 字节