ESP8266-AT指令集

最新推荐文章于 2025-06-04 10:19:04 发布

原创最新推荐文章于 2025-06-04 10:19:04 发布 · 4.4k 阅读

17 ·

CC 4.0 BY-SA版权

本文档详细介绍了ESP8266的AT指令集，包括基础指令、WIFI功能指令和TCP/IP工具箱指令，如测试启动、连接AP、获取IP地址等，旨在帮助用户理解和使用ESP8266的网络功能。

AI助手已提取文章相关产品：

一、简介

描述 Espressif AT 指令集功能以及使用方法。

二、指令说明

1、测试命令 AT+=? 该命令用于查询设置命令或内部程序设置的参数以
及其取值范围。
2、查询命令 AT+? 该命令用于返回参数的当前值。
3、设置命令 AT+=<…> 该命令用于设置用户自定义的参数值。
4、执行命令 AT+ 该命令用于执行受模块内部程序控制的变参数不可
变的功能。
注意：1. 不是每条 AT 指令都具备上述 4 类命令
2. [ ]内数据为缺省值，不必填写或可能不显示
3. 使用双引号表示字符串数据.”string”
4. 波特率 115200
5. 输入已回车换行结尾”\r\n”

三、基础AT指令描述

1、测试AT启动

执行指令：AT 响应：OK

2、重启模块

执行指令：AT+RST 响应：OK

3、查看版本信息

执行指令：AT+GMR 响应：//八位版本号（017xxxxxx为AT版本）
OK

四、WIFI功能AT指令集

1、AT+CWMODE-选择 WIFI 应用模式

测试指令：AT+CWMODE=? 响应：+CWMODE:(取值列表)
OK
查询命令：AT+CWMODE? 响应：返回当前模块的模式
+CWMODE://1 Station 模式 2 AP 模式 3 AP 兼 Station 模式
OK
设置指令：AT+CWMODE= 响应： OK

2、AT+CWJAP-加入 AP

查询命令：AT+ CWJAP? 响应：返回当前选择的 AP
+ CWJAP:
OK
设置指令：AT+ CWJAP =,< pwd > 响应：OK
//字符串参数，接入点名称
字符串参数，密码最长 64 字节 ASCII ERROR

3、AT+CWLAP-列出当前可用 AP

设置指令：AT+ CWLAP =,< mac >, 响应：返回符合查询要求的 AP
+ CWLAP: ,,,//< ecn >0 OPEN
1 WEP
2 WPA_PSK
3 WPA2_PSK
4 WPA_WPA2_PSK
字符串参数，接入点名称
信号强度
字符串参数，mac 地址
OK
ERROR
执行指令：AT+CWLAP 响应：终端返回 AP 列表
+ CWLAP: ,,,
OK
ERROR

4、AT+CWQAP -退出与 AP 的连接

测试指令：AT+CWQAP=? 响应：OK
执行指令：AT+ CWQAP 响应：OK

5、AT+ CWSAP-设置 AP 模式下的参数

查询命令：AT+ CWSAP? 响应：返回当前 AP 参数
+ CWSAP:,,,//指令只有在 AP 模式开启后有效
字符串参数，接入点名称
字符串参数，密码最长 64 字节 ASCII
通道号
// < ecn >0 OPEN 2 WPA_PSK 3 WPA2_PSK 4 WPA_WPA2_PSK
//通道修改后需要+RST 重启模块
设置指令：AT+ CWSAP=,,, 响应：OK
ERROR

6、AT+ CWLIF-查看已接入设备的 IP

执行指令：AT+CWLIF 响应：// 已接入设备的 IP 地址
OK

五、TCP/IP 工具箱 AT 指令描述

1、AT+ CIPSTATUS 获得连接状态

测试指令：响应：OK
执行指令：AT+ CIPSTATUS 响应：返回当前模块的连接状态和连接参数
STATUS:
+ CIPSTATUS:,,,,// 2:获得 ip
3:建立连接
4:失去连接
连接的 id 号 0-4
字符串参数，类型 TCP 或 UDP
字符串参数，IP 地址
端口号
0: 本模块做 client 的连接
1: 本模块做 server 的连接
OK

2、AT+CIPSTART 建立 TCP 连接或注册 UDP 端口号

测试指令：AT+CIPSTART=? 响应：1) 设置 AT+CIPMUX=0
+CIPSTART:(取值列表),(范围),(范围)
+CIPSTART:(取值列表),(范围),(范围)
OK
2) 设置 AT+CIPMUX=1
+CIPSTART:(id),(取值列表),(范围),(范围)
+CIPSTART: (id), (取值列表),(范围),(范围)
设置命令：1)单路连接(+CIPMUX=0) 响应：如果格式正确且连接成功，返回
AT+CIPSTART=,, OK
2)多路连接(+CIPMUX=1) 否则返回
AT+CIPSTART=,, ERROR
如果连接已经存在，返回
ALREAY CONNECT

3、AT+CIPSEND 发送数据

测试指令：AT+CIPSEND=? 响应：OK
设置指令：1)单路连接时(+CIPMUX=0) 发送指定长度的数据。收到此命令后先换行返回”>”，然后开始接收串口数据，
AT+CIPSEND= 当数据长度满 length 时发送数据。
2)多路连接时(+CIPMUX=1) 如果未建立连接或连接被断开，返回
AT+CIPSEND=, ERROR
如果数据发送成功，返回
SEND OK
//需要用于传输连接的 id 号
数字参数，表明发送数据的长度，最大长度为2048
执行指令：AT+CIPSEND 响应：收到此命令后先换行返回”>”
然后就进入了透传模式，每包数据以 20ms 间隔区分，每包最大 2048 字节。
当输入单独一包”+++”返回指令模式。
该指令必须在开启透传模式以及单连接模式下使用

4、AT+CIPCLOSE 关闭 TCP 或 UDP

测试指令：AT+CIPCLOSE=?响应：OK
设置命令：多路连接时AT+CIPCLOSE= 响应：如果输入正确，返回
// 需要关闭的连接 id OK
当 id=5 时关闭所有连接（开启 server 后 id=5 无效）如果没有该连接则，返回
Link is not
执行指令：单路连接时AT+CIPCLOSE 响应：如果输入正确，返回
OK
如果没有连接则，返回
ERROR
当没有连接时返回状态打印 unlink

5、AT+CIFSR 获取本地 IP 地址

测试指令：AT+CIFSR=? 响应：OK
执行命令：AT+ CIFSR 响应：+ CIFSR:
+ CIFSR://本机目前的 IP 地址第一行为 AP 下的 IP，
第二行为 STA下的 IP
OK
ERROR

6、AT+CIPMUX 启动多连接

查询命令：AT+ CIPMUX? 响应：+ CIPMUX:
OK
设置指令：AT+ CIPMUX= 响应：OK
如果已经处于连接状态则，返回
Link is builded
//0单路连接模式
1 多路连接模式
//只有当连接都断开后才能更改，如果开启过 server 需要重启模块

7、AT+CIPSERVER 配置为服务器

设置指令：AT+ CIPSERVER=[,] 响应：OK
关闭 server 需要重启
//0 关闭 server 模式
1 开启 server 模式
端口号，缺省值为 333
//开启 server 后自动建立 server 监听
当有 client 接入会自动按顺序占用一个连接AT+ CIPMUX=1 时才能开启服务器