ESP32系列AT固件快速开发——Wi-Fi MQTT

目录

【烧录固件时硬件接线】

【烧录固件】

【AT指令WiFi部分】

设置 Wi-Fi 模式 (Station/SoftAP/Station+SoftAP)

查询 Wi-Fi 状态和 Wi-Fi 信息

【AT指令MQTT部分】

Demo:已验证的Wi-Fi连接+MQTT连接、发布与订阅

设置MQTT用户属性

设置MQTT连接属性（测试失败）

连接MQTT Broker

发布MQTT 消息（字符串）

发布长MQTT 消息

订阅 MQTT Topic

取消订阅MQTT Topic

断开MQTT 连接

MQTT AT说明

MQTTS相关资料位置

【注意事项】

【AT指令用户指南官方网页版】

---

        在一些物联网项目中，仅需使用ESP32系列芯片（包括但不限于ESP32-C3/C5/C6等）实现Wi-Fi连接和MQTT通信时，一般采用官方提供的AT固件方案，该方案通过主控MCU下发AT指令控制ESP32。官方的AT指令资料很详细，本文将带您快速掌握ESP32在Wi-Fi和MQTT通信中的核心AT指令使用。

【烧录固件时硬件接线】

补充说明：在该ESP32-C6开发板上，使用Type-C把设备连接到PC上时，会看到有2个COM口，其中一个用于LOG调试串口，另一个直连设备内部USB，如何区分哪个COM口用于串口调试？打开设备管理器看CH343对应的COM口即为用于串口调试的COM口

该开发板详细资料：ESP32-C6-DEV-KIT-N8 - Waveshare Wiki

【烧录固件】

打开flash_download_tool目录下的flash_download_tool_3.9.8_w1.exe

【AT指令WiFi部分】

设置 Wi-Fi 模式 (Station/SoftAP/Station+SoftAP)

命令        AT+CWMODE=<mode>[,<auto_connect>]

响应        OK

参数       

说明：在命令中，使用多个等级的括号来隔离多个参数，在实际使用中无需加任何括号，如AT+CWMODE=<mode>[,<auto_connect>]的一个示例：AT+CWMODE=1,1

补充：ESP32具有NVS掉电存储功能，当若 AT+SYSSTORE=1，本设置将保存在 NVS 分区，但是如果把掉电存储放在主控上实现，则该从机无需关心该功能。（可用AT+SYSSTORE?查询参数存储模式，0表示不存入flash，1表示存入flash，默认为1存入，若不使用建议在AT命令前使用AT+SYSSTORE=0关闭掉电存储）

注意：后续诸多AT命令的前提都是已设置ESP32为Station模式

查询 Wi-Fi 状态和 Wi-Fi 信息

命令        AT+CWSTATE?

响应        +CWSTATE:<state>,<"ssid">
                OK

参数       

连接AP（Access Point）

命令       

AT+CWJAP=[<"ssid">],[<"pwd">][,<"bssid">][,<pci_en>][,<reconn_interval>][,<listen_interval>][,<scan_mode>][,<jap_timeout>][,<pmf>]

响应        WIFI CONNECTED
                WIFI GOT IP

                OK
                [WIFI GOT IPv6 LL]
                [WIFI GOT IPv6 GL]

或者

                +CWJAP:<error code>
                ERROR

参数       

【AT指令MQTT部分】

Demo:已验证的Wi-Fi连接+MQTT连接、发布与订阅

AT+CWMODE=1                               // 设置为Station模式
AT+CWJAP="Lansitec-2.4G","lansi@126#163"  // 设置Wi-Fi的用户名和密码AT+MQTTUSERCFG=0,1,"ESP32-C6","espressif","1234567890",0,0,"" // 设置MQTT用户属性
// 参数:LinkID=0,TCP,"client_id","username","password",cert_key_ID,CA_ID,"path"
AT+MQTTCONN=0,"asset.lansitec.com",1883,1 // 连接MQTT Broker,LinkID=0,"服务器地址",端口,断连后自动重连
AT+MQTTPUB=0,"ZZQ/beacon","\"{\"timestamp\":\"2025\"}\"",1,0  
AT+MQTTPUB=0,"ZZQ/beacon","1001",1,0  // 发布MQTT消息,参数:LinkID=0,"topic","data",qos,retain,如有特殊字符需要转义
AT+MQTTPUBRAW=0,"ZZQ/beacon",3,1,0	  // 发布长MQTT消息,参数:LinkID=0,"topic",length,qos,retain,如有特殊字符需要转义
123		//发送长度为3的数据
AT+MQTTSUB=0,"lansitec/sub/404CCA55835C",1// 订阅MQTT Topic,参数:LinkID=0,"topic",qos

设置MQTT用户属性

命令       

AT+MQTTUSERCFG=<LinkID>,<scheme>,<"client_id">,<"username">,<"password">,<cert_key_ID>,<CA_ID>,<"path">

响应        OK

参数       

设置MQTT连接属性（测试失败）

命令       

AT+MQTTCONNCFG=<LinkID>,<keepalive>,<disable_clean_session>,<"lwt_topic">,<"lwt_msg">,<lwt_qos>,<lwt_retain>

响应        OK

参数       

说明：该命令实测失败，但不影响MQTT连接，可能是依赖关系、参数设置方面有问题

连接MQTT Broker

查询已连接的MQTT Broker

命令        AT+MQTTCONN?

响应        +MQTTCONN:<LinkID>,<state>,<scheme>,<"host">,<port>,<"path">,<reconnect>

               OK

设置连接MQTT Broker

命令        AT+MQTTCONN=<LinkID>,<"host">,<port>,<reconnect>

响应        OK

参数       

发布MQTT 消息（字符串）

命令        AT+MQTTPUB=<LinkID>,<"topic">,<"data">,<qos>,<retain>

响应        OK

参数       

说明        每条 AT 命令的总长度不能超过 256 字节，否则使用AT+MQTTPUBRAW命令
               本命令不能发送数据 \0，若需要发送该数据，请使用AT+MQTTPUBRAW 命令

补充：最后一个参数为retain，设置为1则发送的消息为保留消息，订阅该主题的设备上线后会收到这一条，如下图:

若想取消该保留消息，取消方法为：发送一条空保留消息

发布长MQTT 消息

命令     AT+MQTTPUBRAW=<LinkID>,<"topic">,<length>,<qos>,<retain>

响应     OK

             >

符号 > 表示 AT 准备好接收串口数据，此时您可以输入数据，当数据长度达到参数 <length> 的值时，数据传输开始。

若传输成功，则 AT 返回：+MQTTPUB:OK
若传输失败，则 AT 返回：+MQTTPUB:FAIL

参数       

 

订阅 MQTT Topic

查询已订阅的MQTT Topic

命令        AT+MQTTSUB?

响应        +MQTTSUB:<LinkID>,<state>,<"topic1">,<qos>
               +MQTTSUB:<LinkID>,<state>,<"topic2">,<qos>
               +MQTTSUB:<LinkID>,<state>,<"topic3">,<qos>
                ...

                OK

设置订阅MQTT Topic（最多订阅10个topic）

命令        AT+MQTTSUB=<LinkID>,<"topic">,<qos>

当 AT 接收到已订阅的 topic 的 MQTT 消息时，返回：       

+MQTTSUBRECV:<LinkID>,<"topic">,<data_length>,data

若已订阅过该 topic，则返回：ALREADY SUBSCRIBE

参数       

取消订阅MQTT Topic

命令        AT+MQTTUNSUB=<LinkID>,<"topic">

响应        OK

若未订阅过该 topic，则返回     NO UNSUBSCRIBE

                                                   OK

参数       

断开MQTT 连接

命令        AT+MQTTCLEAN=<LinkID>

响应        OK

参数        <LinkID>：当前仅支持 link ID 0。

MQTT AT说明

• 一般来说，AT MQTT 命令都会在 10 秒内响应，但 AT+MQTTCONN 命令除外。例如，如果路由器不能上网，命令 AT+MQTTPUB 会在 10 秒内响应，但 AT+MQTTCONN 命令在网络环境不好的情况下，可能需要更多的时间用来重传数据包。
• 如果 AT+MQTTCONN 是基于 TLS 连接，每个数据包的超时时间为 10 秒，则总超时时间会根据握手数据包的数量而变得更长。
• 当 MQTT 连接断开时，会提示+MQTTDISCONNECTED:<LinkID>消息。
• 当 MQTT 连接建立时，会提示
  +MQTTCONNECTED:<LinkID>,<scheme>,<"host">,port,<"path">,<reconnect>消息。

【注意事项】

ESP32 AT指令以“AT”开始，以换行符结束，其中换行符为CR LF

每条命令都会返回 OK 或 ERROR 的响应，应等待上一条命令执行完毕后，再发送下一条命令。如果上一条命令未执行完毕，又发送了新的命令，则会返回 busy p... 提示

【AT指令用户指南官方网页版】

        入门指南 - ESP32-C6 - — ESP-AT 用户指南 latest 文档
        场景问题汇总：AT FAQ - ESP32-C6 - — ESP-AT 用户指南 latest 文档