ESP8266常用指令
📌 一、基础指令
| 指令 | 参数示例 | 功能说明 | 响应示例 |
|---|---|---|---|
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时需检查参数格式、网络状态或模块工作模式是否匹配。