📌 一、基础指令
| 指令 | 参数示例 | 功能说明 | 响应示例 |
|---|---|---|---|
AT |
- | 测试模块是否就绪 | OK |
AT+RST |
- | 重启模块 | OK (重启提示) |
AT+GMR |
- | 查询固件版本 | AT version:x.x.x |
AT+UART |
=115200,8,1,0,0 |
设置串口参数（波特率、数据位等） | OK |
📡 二、WiFi模式与连接
| 指令 | 参数示例 | 功能说明 | 注意事项 |
|---|---|---|---|
AT+CWMODE |
=1 (STA)=2 (AP)=3 (混合) |
设置工作模式： 1: 终端模式 2: 热点模式 3: 双模式 |
模式切换后需重启生效 |
AT+CWLAP |
- | 扫描可用WiFi网络 (仅STA模式有效) | 返回SSID、加密类型、信号强度 |
AT+CWJAP |
="SSID","password" |
连接指定WiFi (STA模式) | 返回 WIFI CONNECTED |
AT+CWQAP |
- | 断开当前WiFi连接 | - |
AT+CWSAP |
="SSID","pwd",chl,ecn |
配置AP模式参数（热点名称、密码等） | ecn参数：0-OPEN, 3-WPA2_PSK |
🌐 三、网络连接与传输
| 指令 | 参数示例 | 功能说明 |
|---|---|---|
AT+CIPMUX |
=0 (单连接)=1 (多连接) |
设置连接模式（需在建立连接前配置） |
AT+CIPSTART |
="TCP","192.168.1.100",8080 |
建立TCP/UDP连接（单连接模式） |
AT+CIPSERVER |
=1,8080 |
启用TCP服务器（多连接模式需开启） |
AT+CIPSEND |
=<length> (单连接)=<id>,<length> (多连接) |
发送数据（需先指定数据长度） |
AT+CIFSR |
- | 获取ESP8266 的IP 和 MAC地址 |
AT+CIPCLOSE |
=<id> 或 =0 |
关闭指定连接 |
AT+CIPMODE |
=1 |
开启透传模式（数据直传，无需长度前缀） |
AT+CWLIF |
- | 获取已接入设备的IP地址 |
AT+CIPAP |
="192.168.1.100" |
设置ESP8266的AP IP |
AT+CIPSTA |
="192.168.1.100" |
设置ESP8266的STA IP |
AT+CWDHCP |
=1,1 |
开启DHCP动态获取IP |
🔔 四、MQTT协议指令
| 指令 | 参数示例 | 功能说明 |
|---|---|---|
AT+MQTTUSERCFG |
=0,1,"user","password",0,0 |
配置MQTT服务器用户名密码 |
AT+MQTTCONN |
="mqtt.server.com",1883 |
连接MQTT服务器 |
AT+MQTTSUB |
="topic",1 |
订阅主题 |
AT+MQTTPUB |
="topic","message",0,1 |
向主题发布消息 |
⚠️ 使用注意事项
- 指令格式：每条指令需以
AT开头，以\r\n结尾（部分串口工具自动添加）。 - 工作模式限制：扫描网络（
AT+CWLAP）仅支持STA模式；多连接需设置AT+CIPMUX=1。 - 透传模式：启用后需用
+++退出（不发送回车）才能返回AT指令模式。 - 错误处理：返回
ERROR时需检查参数格式、网络状态或模块工作模式是否匹配。