STM32 +WIFI ESP8266学习指令集二

前言：
本⽂文描述 ESP8266 AT 指令集功能以及使⽤用方法。
指令集主要分为：基础 AT 指令、Wi-Fi 功能 AT 指令、TCP/IP 相关的 AT 指令。

基础Wi-Fi AT 指令
AT+CWMODE 设置 Wi-Fi 模式 (STA/AP/STA+AP)

参数说明
：
‣ 1：Station 模式
‣ 2：SoftAP 模式
‣ 3：SoftAP+Station 模式

注意本设置将保存在 Flash 的系统参数区。
示例例AT+CWMODE=3

AT+CWMODE_CUR 设置 Wi-Fi 模式 (STA/AP/STA+AP)，不保存到 Flash

参数说明
：
‣ 1：Station 模式
‣ 2：SoftAP 模式
‣ 3：SoftAP+Station 模式
注意本设置不不保存到 Flash。
示例例AT+CWMODE_CUR=3

AT+CWMODE_DEF 设置 Wi-Fi 模式 (STA/AP/STA+AP)，保存到 Flash

参数说明
：
‣ 1：Station 模式
‣ 2：SoftAP 模式
‣ 3：SoftAP+Station 模式
注意本设置保存到 Flash system parameter 区域。
示例例AT+CWMODE_DEF=3

AT+CWJAP 连接 AP
参数说明
• ：字符串串参数，AP 的 SSID
• ：AP 的 MAC 地址
• ：信道号
• ：信号强度
注意本设置将保存在 Flash system parameter 区域。
示例例
AT+CWJAP=“abc”,“0123456789”
例例如，⽬目标 AP 的 SSID 为 “ab,c”，password 为 “0123456789"”，则指令如下：
AT+CWJAP=“ab\,c”,“0123456789”\"
如果有多个 AP 的 SSID 均为 “abc”，可通过 BSSID 确定⽬目标 AP：
AT+CWJAP=“abc”,“0123456789”,“ca:d7:19:d8:a6:44”

AT+CWJAP_CUR 连接 AP，不保存到 Flash

参数说明
• ：字符串串参数，AP 的 SSID
• ：AP 的 MAC 地址
• ：信道号
• ：信号强度
注意本设置不不保存到 Flash。
示例例
AT+CWJAP_CUR=“abc”,“0123456789”
例例如，⽬目标 AP 的 SSID 为 “ab,c”，password 为 “0123456789"”，则指令如下：
AT+CWJAP_CUR=“ab\,c”,“0123456789”\"
如果有多个 AP 的 SSID 均为 “abc”，可通过 BSSID 确定⽬目标 AP：
AT+CWJAP_CUR=“abc”,“0123456789”,“ca:d7:19:d8:a6:44”

AT+CWJAP_DEF 连接 AP，保存到 Flash
参数说明
• ：字符串串参数，AP 的 SSID
• ：AP 的 MAC 地址
• ：信道号
• ：信号强度
注意本设置不保存到 Flash。
示例例
AT+CWJAP_DEF=“abc”,“0123456789”
例如，目标 AP 的 SSID 为 “ab,c”，password 为 “0123456789"”，则指令如下：
AT+CWJAP_DEF=“ab\,c”,“0123456789”\"
如果有多个 AP 的 SSID 均为 “abc”，可通过 BSSID 确定⽬目标 AP：AT+CWJAP_DEF=“abc”,“0123456789”,“ca:d7:19:d8:a6:44”

AT+CWLAPOPT 设置 AT+CWLAP 指令扫描结果的属性
示例
AT+CWLAPOPT=1,2047
第一个参数为 1，表示后续如果使⽤用 AT+CWLAP 指令，扫描结果将按照信号强度 RSSI 值排序；
第二个参数为 2047，即 0x7FF，表示 的相关 bit 全部置为 1，后续如果使⽤用 AT+CWLAP 指
令，扫描结果将显示所有参数。

AT+CWLAP 扫描附近的 AP 信息
注意
• scan_time_min 不不能⼤大于 scan_time_max，即要求 scan_time_max >= scan_time_min。
• 若 scan_time_min 和 scan_time_max 设置均为 0，则采⽤用默认值，默认值具体如下：
‣ 对于 active scan，每个信道的最⼩小扫描时间是 0，最⼤大扫描时间是 120ms
‣ 对于 passive scan，每个信道扫描的时间是 360ms
示例例
AT+CWLAP=“WiFi”,“ca:d7:19:d8:a6:44”,6,0,50,120,
或者查找指定 SSID 的 AP：
AT+CWLAP=“WiFi”
或者使能 passive scan 模式：
AT+CWLAP=,1,

AT+CWQAP 与 AP 断开连接

AT+CWSAP 设置 ESP8266 SoftAP 配置
注意本设置保存到 Flash 系统参数区。
示例AT+CWSAP=“ESP8266”,“1234567890”,5,3

AT+CWSAP_CUR 设置 ESP8266 SoftAP 配置，不保存到 Flash
注意本设置不不保存到 Flash。
示例AT+CWSAP_CUR=“ESP8266”,“1234567890”,5,3
AT+CWSAP_DEF 设置 ESP8266 SoftAP 配置，保存到 Flash

AT+CWLIF 获取连接到 ESP8266 SoftAP 的 station 的信息
参数说明
• ：连接到 ESP8266 SoftAP 的 Station IP 地址
• ：连接到 ESP8266 SoftAP 的 Station MAC 地址
注意本指令⽆无法查询静态 IP，仅⽀支持在 ESP8266 SoftAP 和连⼊入的 Station DHCP 均使能的情况下有
效。

AT+CWDHCP 设置 DHCP
注意
• 本设置保存到 Flash ⽤用户参数区。
• 本设置指令与设置静态 IP 的指令（AT+CIPSTA 系列列和 AT+CIPAP 系列列）互相影响：
‣ 设置使能 DHCP，则静态 IP ⽆无效；
‣ 设置静态 IP，则 DHCP 关闭；
‣ 以最后的设置为准。

AT+CWDHCP_CUR 设置 DHCP，不保存到 Flash
注意
• 本设置不不保存到 Flash。
• 本设置指令与设置静态 IP 的指令（AT+CIPSTA 系列列和 AT+CIPAP 系列列）互相影响：
‣ 设置使能 DHCP，则静态 IP ⽆无效；
‣ 设置静态 IP，则 DHCP 关闭；
‣ 以最后的设置为准。
示例例AT+CWDHCP_CUR=0,1

AT+CWDHCP_DEF 设置 DHCP，保存到 Flash
注意
• 本设置保存到 Flash ⽤用户参数区。
• 本设置指令与设置静态 IP 的指令（AT+CIPSTA 系列列和 AT+CIPAP 系列列）互相影响：
‣ 设置使能 DHCP，则静态 IP ⽆无效；
‣ 设置静态 IP，则 DHCP 关闭；
‣ 以最后的设置为准。
示例例AT+CWDHCP_DEF=0,1

AT+CWDHCPS_CUR 设置 ESP8266 SoftAP DHCP 分配的 IP 范围，不保存到 Flash
注意
• 本设置不不保存到 Flash。
• 本指令必须在 ESP8266 SoftAP 模式使能，且开启 DHCP 的情况下使⽤用，设置的 IP 范围必须与 ESP8266
SoftAP 在同⼀一⽹网段。
示例例
AT+CWDHCPS_CUR=1,3,“192.168.4.10”,“192.168.4.15”
或者
AT+CWDHCPS_CUR=0 //清除设置，恢复默认值
AT+CWDHCPS_DEF 设置 ESP8266 SoftAP DHCP 分配的 IP 范围，保存到 Flash

AT+CWAUTOCONN 设置上电时是否⾃自动连接 AP
参数
说明
• ：
‣ 0：清除设置 IP 范围，恢复默认值，后续参数⽆无需填写
‣ 1：使能设置 IP 范围，后续参数必须填写
• ：租约时间，单位：分钟，取值范围 [1, 2880]
• ：DHCP 服务器器 IP 池的起始 IP
• ：DHCP 服务器器 IP 池的结束 IP
注意
• 本设置保存到 Flash ⽤用户参数区。
• 本指令必须在 ESP8266 SoftAP 模式使能，且开启 DHCP 的情况下使⽤用，设置的 IP 范围必须与 ESP8266
SoftAP 在同⼀一⽹网段。

AT+CIPSTAMAC 设置 ESP8266 Station 的 MAC 地址
注意
• 本设置保存到 Flash ⽤用户参数区。
• ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同，请勿将其设置为同⼀一 MAC 地址。
• ESP8266 MAC 地址第⼀一个字节的 bit 0 不不能为 1，例例如，MAC 地址可以为 “18:…” 但不不能为 “15:…”。
示例例AT+CIPSTAMAC=“18:fe:35:98:d3:7b”

AT+CIPSTAMAC_CUR 设置 ESP8266 Station 的 MAC 地址，不不保存到 Flash
注意
• 本设置不不保存到 Flash。
• ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同，请勿将其设置为同⼀一 MAC 地址。
• ESP8266 MAC 地址第⼀一个字节的 bit 0 不不能为 1，例例如，MAC 地址可以为 “18:…” 但不不能为 “15:…”。
示例AT+CIPSTAMAC_CUR=“18:fe:35:98:d3:7b”

AT+CIPSTAMAC_DEF 设置 ESP8266 Station 的 MAC 地址，保存到 Flash
注意
• 本设置保存到 Flash ⽤用户参数区。
• ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同，请勿将其设置为同⼀一 MAC 地址。
• ESP8266 MAC 地址第⼀一个字节的 bit 0 不不能为 1，例例如，MAC 地址可以为 “18:…” 但不不能为 “15:…”。
示例AT+CIPSTAMAC_DEF=“18:fe:35:98:d3:7b”

AT+CIPAPMAC 设置 ESP8266 SoftAP 的 MAC 地址
注意
• 本设置保存到 Flash ⽤用户参数区。
• ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同，请勿将其设置为同⼀一 MAC 地址。
• ESP8266 MAC 地址第⼀一个字节的 bit 0 不不能为 1，例例如，MAC 地址可以为 “18:…” 但不不能为 “15:…”。
示例例AT+CIPAPMAC=“1a:fe:36:97:d5:7b”

AT+CIPAPMAC_CUR 设置 ESP8266 SoftAP 的 MAC 地址，不保存到 Flash

AT+CIPAPMAC_DEF 设置 ESP8266 SoftAP 的 MAC 地址，保存到 Flash

注意
• 本设置不不保存到 Flash。
• ESP8266 SoftAP 和 Station 的 MAC 地址并不不相同，请勿将其设置为同⼀一 MAC 地址。
• ESP8266 MAC 地址第⼀一个字节的 bit 0 不不能为 1，例例如，MAC 地址可以为 “18:…” 但不不能为 “15:…”。
示例例AT+CIPAPMAC_CUR=“1a:fe:36:97:d5:7b”

AT+CIPSTA 设置 ESP8266 Station 的 IP 地址
注意
• 本设置保存到 Flash s⽤用户参数区。
• 本设置指令与设置 DHCP 的指令（AT+CWDHCP 系列列）互相影响：
‣ 设置静态 IP，则 DHCP 关闭；
‣ 设置使能 DHCP，则静态 IP ⽆无效；
‣ 以最后的设置为准。
示例例AT+CIPSTA=“192.168.6.100”,“192.168.6.1”,“255.255.255.0”
AT+CIPSTA_CUR 设置 ESP8266 Station 的 IP 地址，不保存到 Flash

AT+CIPSTA_DEF 设置 ESP8266 Station 的 IP 地址，保存到 Flash

注意
• 本设置保存到 Flash ⽤用户参数区。
• 本设置指令与设置 DHCP 的指令（AT+CWDHCP 系列列）互相影响：
‣ 设置静态 IP，则 DHCP 关闭；
‣ 设置使能 DHCP，则静态 IP ⽆无效；
‣ 以最后的设置为准。
示例例AT+CIPSTA_DEF=“192.168.6.100”,“192.168.6.1”,“255.255.255.0”

AT+CIPAP 设置 ESP8266 SoftAP 的 IP 地址
注意
• 本设置保存到 Flash ⽤用户参数区。
• ⽬目前仅⽀支持 C 类 IP 地址。
• 本设置指令与设置 DHCP 的指令（AT+CWDHCP 系列列）互相影响：
‣ 设置静态 IP，则 DHCP 关闭；
‣ 设置使能 DHCP，则静态 IP ⽆无效；
‣ 以最后的设置为准。
示例例AT+CIPAP=“192.168.5.1”,“192.168.5.1”,“255.255.255.0”

AT+CIPAP_CUR 设置 ESP8266 SoftAP 的 IP 地址，不保存到 Flash
注意
• 本设置不不保存到 Flash。
• ⽬目前仅⽀支持 C 类 IP 地址。
• 本设置指令与设置 DHCP 的指令（AT+CWDHCP 系列列）互相影响：
‣ 设置静态 IP，则 DHCP 关闭；
‣ 设置使能 DHCP，则静态 IP ⽆无效；
‣ 以最后的设置为准。
示例AT+CIPAP_CUR=“192.168.5.1”,“192.168.5.1”,“255.255.255.0”

AT+CIPAP_DEF 设置 ESP8266 SoftAP 的 IP 地址，保存到 Flash
注意
• 本设置保存到 Flash ⽤用户参数区。
• ⽬目前仅⽀支持 C 类 IP 地址。
• 本设置指令与设置 DHCP 的指令（AT+CWDHCP 系列列）互相影响：
‣ 设置静态 IP，则 DHCP 关闭；
‣ 设置使能 DHCP，则静态 IP ⽆无效；
‣ 以最后的设置为准。
示例例AT+CIPAP_DEF=“192.168.5.1”,“192.168.5.1”,“255.255.255.0”

AT+CWSTARTSMART 开始 SmartConfig
注意
• ⽤用户可以参考 ESP-TOUCH ⽤用户指南 来了了解 SmartConfig 的详细介绍。
• 仅⽀支持在 ESP8266 单 Station 模式下调⽤用。
• 消息 smart get wifi info 表示 SmartConfig 成功获取到 AP 信息，之后 ESP8266 尝试连接 AP，
打印连接过程。
• 消息 smartconfig connected wifi 表示成功连接到 AP，此时可以调⽤用 AT+CWSTOPSMART 停⽌止
SmartConfig 再执⾏行行其他指令。注意，在 SmartConfig 过程中请勿执⾏行行其他指令。
• 从 AT_v1.0 开始，SmartConfig 可以⾃自动获取协议类型，AirKiss 或者 ESP-TOUCH。
示例例
AT+CWMODE=1
AT+CWSTARTSMART
AT+CWSTOPSMART 停⽌止 SmartConfig

AT+CWSTARTDISCOVER 开启可被局域⽹网内的微信探测的模式
注意⽆无论 SmartConfig 成功与否，都请调⽤用 AT+CWSTOPSMART 释放快连占⽤用的内存。
示例例AT+CWSTOPSMART

AT+CWSTOPDISCOVER 关闭可被局域⽹网内的微信探测的模式
注意
• 可参考微信官⽹网内⽹网发现功能的介绍 http://iot.weixin.qq.com。
• 本指令需在 ESP8266 Station 连⼊入局域⽹网，获得 IP 地址后⽣生效。
示例例AT+CWSTARTDISCOVER=“gh_9e2cff3dfa51”,“122475”,10

AT+WPS 设置 WPS 功能
注意
• WPS 功能必须在 ESP8266 Station 使能的情况下调⽤用。
• WPS 不不⽀支持 WEP 加密⽅方式。
示例例
AT+CWMODE=1
AT+WPS=1

AT+MDNS 设置 MDNS 功能
注意
• 和 <server_name> 不不能包含特殊字符（例例如 . 符号），或者设置为协议名称（例例如不不
能定义为 http）。
• ESP8266 SoftAP 模式暂时不不⽀支持 MDNS 功能。
示例例AT+MDNS=1,“espressif”,“iot”,8080
AT+CWHOSTNAME 设置 ESP8266 Station 的主机名称

AT+CWCOUNTRY_CUR 设置 ESP8266 当前 WiFi 国家码

注意• 本设置不不保存到 Flash，重启后将恢复默认值。
示例例
AT+CWMODE=3
AT+CWCOUNTRY_CUR=1,“CN”,1,5

AT+CWCOUNTRY_DEF 设置 ESP8266 默认 WiFi 国家码
参数说明
<country_policy>:
• 0：根据 AP ⾃自动切换国家信息；
• 1：使⽤用设置的国家信息
<country_code>: 国家码字符串串，⻓长度最多⽀支持三个字符；第三个为特殊字符，在查询时不不显示。
<start_channel> : 起始信道号
<total_channel_number> : 总信道个数
注意• 本设置将保存到 Flash ⽤用户参数区。
示例例
AT+CWMODE=3
AT+CWCOUNTRY_DEF=1,“CN”,1,5