Wi-Fi AT 命令集¶
- AT+CWMODE：查询/设置 Wi-Fi 模式 (Station/SoftAP/Station+SoftAP)
- AT+CWJAP：连接 AP
- AT+CWRECONNCFG：查询/设置 Wi-Fi 重连配置
- AT+CWLAPOPT：设置 AT+CWLAP 命令扫描结果的属性
- AT+CWLAP：扫描当前可用的 AP
- AT+CWQAP：断开与 AP 的连接
- AT+CWSAP：配置 ESP32 SoftAP 参数
- AT+CWLIF：查询连接到 ESP SoftAP 的 station 信息
- AT+CWQIF：断开 station 与 ESP SoftAP 的连接
- AT+CWDHCP：启用/禁用 DHCP
- AT+CWDHCPS：查询/设置 ESP SoftAP DHCP 分配的 IP 地址范围
- AT+CWAUTOCONN：上电是否自动连接 AP
- AT+CWAPPROTO：查询/设置 SoftAP 模式下 802.11 b/g/n 协议标准
- AT+CWSTAPROTO：设置 Station 模式下 802.11 b/g/n 协议标准
- AT+CIPSTAMAC：查询/设置 ESP Station 的 MAC 地址
- AT+CIPAPMAC：查询/设置 ESP SoftAP 的 MAC 地址
- AT+CIPSTA：查询/设置 ESP Station 的 IP 地址
- AT+CIPAP：查询/设置 ESP SoftAP 的 IP 地址
- AT+CWSTARTSMART：开启 SmartConfig
- AT+CWSTOPSMART：停止 SmartConfig
- AT+WPS：设置 WPS 功能
- AT+MDNS：设置 mDNS 功能
- [ESP32 Only] AT+CWJEAP：连接 WPA2 企业版 AP
- AT+CWHOSTNAME：查询/设置 ESP Station 的主机名称
- AT+CWCOUNTRY：查询/设置 Wi-Fi 国家代码
AT+CWMODE：查询/设置 Wi-Fi 模式 (Station/SoftAP/Station+SoftAP)¶
参数¶
- <mode>：模式
- 0: 无 Wi-Fi 模式，并且关闭 Wi-Fi RF
- 1: Station 模式
- 2: SoftAP 模式
- 3: SoftAP+Station 模式
- <auto_connect>：切换 ESP 设备的 Wi-Fi 模式时（例如，从 SoftAP 或无 Wi-Fi 模式切换为 Station 模式或 SoftAP+Station 模式），是否启用自动连接 AP 的功能，默认值：1。参数缺省时，使用默认值，也就是能自动连接。
- 0: 禁用自动连接 AP 的功能
- 1: 启用自动连接 AP 的功能，若之前已经将自动连接 AP 的配置保存到 flash 中，则 ESP 设备将自动连接 AP
说明¶
- 若 AT+SYSSTORE=1，本设置将保存在 NVS 分区
示例¶
AT+CWMODE=3
AT+CWJAP：连接 AP¶
查询命令¶
功能：
查询与 ESP Station 连接的 AP 信息
命令：
AT+CWJAP?
响应：
+CWJAP:<ssid>,<bssid>,<channel>,<rssi>,<pci_en>,<reconn_interval>,<listen_interval>,<scan_mode>,<pmf>
OK
设置命令¶
功能：
设置 ESP Station 需连接的 AP
命令：
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
执行命令¶
功能：
将 ESP station 连接至上次 Wi-Fi 配置中的 AP
命令：
AT+CWJAP
响应：
WIFI CONNECTED
WIFI GOT IP
OK
[WIFI GOT IPv6 LL]
[WIFI GOT IPv6 GL]
或
+CWJAP:<error code>
ERROR
参数¶
<ssid>：目标 AP 的 SSID
- 如果 SSID 和密码中有
,、"、\\等特殊字符，需转义
- 如果 SSID 和密码中有
<pwd>：密码最长 64 字节 ASCII
<bssid>：目标 AP 的 MAC 地址，当多个 AP 有相同的 SSID 时，该参数不可省略
<channel>：信道号
<rssi>：信号强度
<pci_en>：PCI 认证
- 0: ESP station 可与任何一种加密方式的 AP 连接，包括 OPEN 和 WEP
- 1: ESP station 可与除 OPEN 和 WEP 之外的任何一种加密方式的 AP 连接
<reconn_interval>：Wi-Fi 重连间隔，单位：秒，默认值：1，最大值：7200
- 0: 断开连接后，ESP station 不重连 AP
- [1,7200]: 断开连接后，ESP station 每隔指定的时间与 AP 重连
<listen_interval>：监听 AP beacon 的间隔，单位为 AP beacon 间隔，默认值：3，范围：[1,100]
<scan_mode>：扫描模式
- 0: 快速扫描，找到目标 AP 后终止扫描，ESP station 与第一个扫描到的 AP 连接
- 1: 全信道扫描，所有信道都扫描后才终止扫描，ESP station 与扫描到的信号最强的 AP 连接
<jap_timeout>：AT+CWJAP 命令超时的最大值，单位：秒，默认值：15，范围：[3,600]
<pmf>：PMF（Protected Management Frames，受保护的管理帧），默认值 0
- 0 表示禁用 PMF
- bit 0: 具有 PMF 功能，提示支持 PMF，如果其他设备具有 PMF 功能，则 ESP 设备将优先选择以 PMF 模式连接
- bit 1: 需要 PMF，提示需要 PMF，设备将不会关联不支持 PMF 功能的设备
<error code>：错误码，仅供参考
- 1: 连接超时
- 2: 密码错误
- 3: 无法找到目标 AP
- 4: 连接失败
- 其它值: 发生未知错误
说明¶
- 如果 AT+SYSSTORE=1，配置更改将保存到 NVS 分区
- 使用本命令需要开启 station 模式
- 本命令中的
<reconn_interval>参数与 AT+CWRECONNCFG 命令中的<interval_second>参数相同。如果运行本命令时不设置<reconn_interval>参数，Wi-Fi 重连间隔时间将采用默认值 1 - 如果同时省略
<ssid>和<password>参数，将使用上一次设置的值 - 执行命令与设置命令的超时时间相同，默认为 15 秒，可通过参数
<jap_timeout>设置 - 想要获取 IPv6 地址，需要先设置 AT+CIPV6=1
- 回复
OK代表 IPv4 网络已经准备就绪，而不代表 IPv6 网络准备就绪。当前 ESP-AT 以 IPv4 网络为主，IPv6 网络为辅。 WIFI GOT IPv6 LL代表已经获取到本地链路 IPv6 地址，这个地址是通过 EUI-64 本地计算出来的，不需要路由器参与。由于并行时序，这个打印可能在OK之前，也可能在OK之后。WIFI GOT IPv6 GL代表已经获取到全局 IPv6 地址，该地址是由 AP 下发的前缀加上内部计算出来的后缀进行组合而来的，需要路由器参与。由于并行时序，这个打印可能在OK之前，也可能在OK之后；也可能由于 AP 不支持 IPv6 而不打印。
示例¶
// 如果目标 AP 的 SSID 是 "abc"，密码是 "0123456789"，则命令是：
AT+CWJAP="abc","0123456789"
// 如果目标 AP 的 SSID 是 "ab\,c"，密码是 "0123456789"\"，则命令是：
AT+CWJAP="ab\\\,c","0123456789\"\\"
// 如果多个 AP 有相同的 SSID "abc"，可通过 BSSID 找到目标 AP：
AT+CWJAP="abc","0123456789","ca:d7:19:d8:a6:44"
// 如果 ESP-AT 要求通过 PMF 连接 AP，则命令是：
AT+CWJAP="abc","0123456789",,,,,,,3
AT+CWRECONNCFG：查询/设置 Wi-Fi 重连配置¶
参数¶
- <interval_second>：Wi-Fi 重连间隔，单位：秒，默认值：0，最大值 7200
- 0: 断开连接后，ESP station 不重连 AP
- [1,7200]: 断开连接后，ESP station 每隔指定的时间与 AP 重连
- <repeat_count>：ESP 设备尝试重连 AP 的次数，本参数在
<interval_second>不为 0 时有效，默认值：0，最大值：1000- 0: ESP station 始终尝试连接 AP
- [1,1000]: ESP station 按照本参数指定的次数重连 AP
示例¶
// ESP station 每隔 1 秒尝试重连 AP，共尝试 100 次
AT+CWRECONNCFG=1,100
// ESP station 在断开连接后不重连 AP
AT+CWRECONNCFG=0,0
AT+CWLAPOPT：设置 AT+CWLAP 命令扫描结果的属性¶
参数¶
- <reserved>：保留项
- <print mask>：AT+CWLAP 的扫描结果是否显示以下参数，默认值：0x7FF，若 bit 设为 1，则显示对应参数，若设为 0，则不显示对应参数
- bit 0: 是否显示 <ecn>
- bit 1: 是否显示 <ssid>
- bit 2: 是否显示 <rssi>
- bit 3: 是否显示 <mac>
- bit 4: 是否显示 <channel>
- bit 5: 是否显示 <freq_offset>
- bit 6: 是否显示 <freqcal_val>
- bit 7: 是否显示 <pairwise_cipher>
- bit 8: 是否显示 <group_cipher>
- bit 9: 是否显示 <bgn>
- bit 10: 是否显示 <wps>
- [<rssi filter>]：AT+CWLAP 的扫描结果是否按照本参数过滤，也即，是否过滤掉信号强度低于
rssi filter参数值的 AP，单位：dBm，默认值：–100，范围：[–100,40] - [<authmode mask>]：AT+CWLAP 的扫描结果是否显示以下认证方式的 AP，默认值：0xFFFF，如果
bit x设为 1，则显示对应认证方式的 AP，若设为 0，则不显示- bit 0: 是否显示
OPEN认证方式的 AP - bit 1: 是否显示
WEP认证方式的 AP - bit 2: 是否显示
WPA_PSK认证方式的 AP - bit 3: 是否显示
WPA2_PSK认证方式的 AP - bit 4: 是否显示
WPA_WPA2_PSK认证方式的 AP - bit 5: 是否显示
WPA2_ENTERPRISE认证方式的 AP - bit 6: 是否显示
WPA3_PSK认证方式的 AP - bit 7: 是否显示
WPA2_WPA3_PSK认证方式的 AP - [ESP32-C3 Only] bit 8: 是否显示
WAPI_PSK认证方式的 AP
- bit 0: 是否显示
示例¶
// 第一个参数为 1，表示 AT+CWLAP 命令扫描结果按照信号强度 RSSI 值排序
// 第二个参数为 31，即 0x1F，表示所有值为 1 的 bit 对应的参数都会显示出来
AT+CWLAPOPT=1,31
AT+CWLAP
// 只显示认证方式为 OPEN 的 AP
AT+CWLAPOPT=1,31,-100,1
AT+CWLAP
AT+CWLAP：扫描当前可用的 AP¶
设置命令¶
功能：
列出符合特定条件的 AP，如指定 SSID、MAC 地址或信道号
命令：
AT+CWLAP=[<ssid>,<mac>,<channel>,<scan_type>,<scan_time_min>,<scan_time_max>]
执行命令¶
功能：
列出当前可用的 AP
命令：
AT+CWLAP
响应：
+CWLAP:<ecn>,<ssid>,<rssi>,<mac>,<channel>,<freq_offset>,<freqcal_val>,<pairwise_cipher>,<group_cipher>,<bgn>,<wps>
OK
参数¶
- <ecn>：加密方式
- 0: OPEN
- 1: WEP
- 2: WPA_PSK
- 3: WPA2_PSK
- 4: WPA_WPA2_PSK
- 5: WPA2_ENTERPRISE
- 6: WPA3_PSK
- 7: WPA2_WPA3_PSK
- [ESP32-C3 Only] 8: WAPI_PSK
- <ssid>：字符串参数，AP 的 SSID
- <rssi>：信号强度
- <mac>：字符串参数，AP 的 MAC 地址
- <channel>：信道号
- <scan_type>：Wi-Fi 扫描类型
- 0: 主动扫描
- 1: 被动扫描
- <scan_time_min>：每个信道最短扫描时间，单位：毫秒，范围：[0,1500]，如果扫描类型为被动扫描，本参数无效
- <scan_time_max>：每个信道最长扫描时间，单位：毫秒，范围：[0,1500]，如果设为 0，固件采用参数默认值，主动扫描为 120 ms，被动扫描为 360 ms
- <freq_offset>：频偏（保留项目）
- <freqcal_val>：频率校准值（保留项目）
- <pairwise_cipher>：成对加密类型
- 0: None
- 1: WEP40
- 2: WEP104
- 3: TKIP
- 4: CCMP
- 5: TKIP and CCMP
- 6: AES-CMAC-128
- 7: 未知
- <group_cipher>：组加密类型，与
<pairwise_cipher>参数的枚举值相同 - <bgn>：802.11 b/g/n，若 bit 设为 1，则表示使能对应模式，若设为 0，则表示禁用对应模式
- bit 0: 是否使能 802.11b 模式
- bit 1: 是否使能 802.11g 模式
- bit 2: 是否使能 802.11n 模式
- <wps>：wps flag
- 0: 不支持 WPS
- 1: 支持 WPS
示例¶
AT+CWLAP="Wi-Fi","ca:d7:19:d8:a6:44",6,0,400,1000
// 寻找指定 SSID 的 AP
AT+CWLAP="Wi-Fi"
AT+CWSAP：配置 ESP SoftAP 参数¶
查询命令¶
功能：
查询 ESP SoftAP 的配置参数
命令：
AT+CWSAP?
响应：
+CWSAP:<ssid>,<pwd>,<channel>,<ecn>,<max conn>,<ssid hidden>
OK
设置命令¶
功能：
设置 ESP SoftAP 的配置参数
命令：
AT+CWSAP=<ssid>,<pwd>,<chl>,<ecn>[,<max conn>][,<ssid hidden>]
响应：
OK
参数¶
- <ssid>：字符串参数，接入点名称
- <pwd>：字符串参数，密码，范围：8 ~ 64 字节 ASCII
- <channel>：信道号
- <ecn>：加密方式，不支持 WEP
- 0: OPEN
- 2: WPA_PSK
- 3: WPA2_PSK
- 4: WPA_WPA2_PSK
- [<max conn>]：允许连入 ESP SoftAP 的最多 station 数目，取值范围：[1,10]
- [<ssid hidden>]：
- 0: 广播 SSID（默认）
- 1: 不广播 SSID
说明¶
- 本指令只有当 AT+CWMODE=2 或者 AT+CWMODE=3 时才有效
- 若 AT+SYSSTORE=1，配置更改将保存在 NVS 分区
示例¶
AT+CWSAP="ESP","1234567890",5,3
AT+CWLIF：查询连接到 ESP SoftAP 的 station 信息¶
参数¶
- <ip addr>：连接到 ESP SoftAP 的 station 的 IP 地址
- <mac>：连接到 ESP SoftAP 的 station 的 MAC 地址
说明¶
- 本指令无法查询静态 IP，仅支持在 ESP SoftAP 和连入的 station DHCP 均使能的情况下有效
AT+CWDHCP：启用/禁用 DHCP¶
参数¶
- <operate>：
- 0: 禁用
- 1: 启用
- <mode>：
- Bit0: Station 的 DHCP
- Bit1: SoftAP 的 DHCP
- <state>：DHCP 的状态
- Bit0:
- 0: 禁用 Station 的 DHCP
- 1: 启用 Station 的 DHCP
- Bit1:
- 0: 禁用 SoftAP 的 DHCP
- 1: 启用 SoftAP 的 DHCP
- Bit2 (ESP32 only):
- 0: 禁用 Ethernet 的 DHCP
- 1: 启用 Ethernet 的 DHCP
- Bit0:
说明¶
- 若 AT+SYSSTORE=1，配置更改将保存到 NVS 分区
- 本设置命令与设置静态 IP 地址的命令会相互影响，如 AT+CIPSTA 和 AT+CIPAP
- 若启用 DHCP，则静态 IP 地址会被禁用
- 若启用静态 IP，则 DHCP 会被禁用
- 最后一次配置会覆盖上一次配置
示例¶
// 启用 Station DHCP，如果原 DHCP mode 为 2，则现 DHCP mode 为 3
AT+CWDHCP=1,1
// 禁用 SoftAP DHCP，如果原 DHCP mode 为 3，则现 DHCP mode 为 1
AT+CWDHCP=0,2
AT+CWDHCPS：查询/设置 ESP SoftAP DHCP 分配的 IP 地址范围¶
设置命令¶
功能：
设置 ESP SoftAP DHCP 服务器分配的 IP 地址范围
命令：
AT+CWDHCPS=<enable>,<lease time>,<start IP>,<end IP>
响应：
OK
参数¶
- <enable>：
- 1: 设置 DHCP server 信息，后续参数必须填写
- 0: 清除 DHCP server 信息，恢复默认值，后续参数无需填写
- <lease time>：租约时间，单位：分钟，取值范围：[1,2880]
- <start IP>：ESP SoftAP DHCP 服务器 IP 地址池的起始 IP
- <end IP>：ESP SoftAP DHCP 服务器 IP 地址池的结束 IP
说明¶
- 若 AT+SYSSTORE=1，配置更改将保存到 NVS 分区
- 本命令必须在 ESP SoftAP 模式使能，且开启 DHCP server 的情况下使用
- 设置的 IP 地址范围必须与 ESP SoftAP 在同一网段
示例¶
AT+CWDHCPS=1,3,"192.168.4.10","192.168.4.15"
AT+CWDHCPS=0 // 清除设置，恢复默认值
AT+CWAUTOCONN：上电是否自动连接 AP¶
参数¶
- <enable>：
- 1: 上电自动连接 AP（默认）
- 0: 上电不自动连接 AP
说明¶
- 本设置保存到 NVS 区域
示例¶
AT+CWAUTOCONN=1
AT+CWAPPROTO：查询/设置 SoftAP 模式下 802.11 b/g/n 协议标准¶
参数¶
- <protocol>：
- bit0: 802.11b 协议标准
- bit1: 802.11g 协议标准
- bit2: 802.11n 协议标准
说明¶
- 当前，ESP 设备只支持 802.11b、802.11bg 或 802.11bgn 协议标准
- 默认情况下，ESP8266 设备的 PHY mode 是 802.11bg 模式，非 ESP8266 设备的 PHY mode 是 802.11bgn 模式
AT+CWSTAPROTO：设置 Station 模式下 802.11 b/g/n 协议标准¶
参数¶
- <protocol>：
- bit0: 802.11b 协议标准
- bit1: 802.11g 协议标准
- bit2: 802.11n 协议标准
说明¶
- 当前，ESP 设备只支持 802.11b、802.11bg 或 802.11bgn 协议标准
- 默认情况下，ESP8266 设备的 PHY mode 是 802.11bg 模式，非 ESP8266 设备的 PHY mode 是 802.11bgn 模式
AT+CIPSTAMAC：查询/设置 ESP Station 的 MAC 地址¶
参数¶
- <mac>：字符串参数，表示 ESP Station 的 MAC 地址
说明¶
- 若 AT+SYSSTORE=1，配置更改将保存到 NVS 分区
- ESP SoftAP 的 MAC 地址与 ESP Station 不同，不要为二者设置同样的 MAC 地址
- MAC 地址的 Bit 0 不能为 1，例如，MAC 地址可以是 “1a:…”，但不可以是 “15:…”
- FF:FF:FF:FF:FF:FF 和 00:00:00:00:00:00 是无效地址，不能设置
示例¶
AT+CIPSTAMAC="1a:fe:35:98:d3:7b"
AT+CIPAPMAC：查询/设置 ESP SoftAP 的 MAC 地址¶
参数¶
- <mac>：字符串参数，表示 ESP SoftAP 的 MAC 地址
说明¶
- 若 AT+SYSSTORE=1，配置更改将保存到 NVS 分区
- ESP SoftAP 的 MAC 地址与 ESP Station 不同，不要为二者设置同样的 MAC 地址
- MAC 地址的 Bit 0 不能为 1，例如，MAC 地址可以是 “18:…”，但不可以是 “15:…”
- FF:FF:FF:FF:FF:FF 和 00:00:00:00:00:00 是无效地址，不能设置
示例¶
AT+CIPAPMAC="18:fe:35:98:d3:7b"
AT+CIPSTA：查询/设置 ESP Station 的 IP 地址¶
查询命令¶
功能：
查询 ESP Station 的 IP 地址
命令：
AT+CIPSTA?
响应：
+CIPSTA:ip:<"ip">
+CIPSTA:gateway:<"gateway">
+CIPSTA:netmask:<"netmask">
+CIPSTA:ip6ll:<"ipv6 addr">
+CIPSTA:ip6gl:<"ipv6 addr">
OK
参数¶
- <”ip”>：字符串参数，表示 ESP station 的 IPv4 地址
- <”gateway”>：网关
- <”netmask”>：子网掩码
- <”ipv6 addr”>：ESP station 的 IPv6 地址
说明¶
- 使用查询命令时，只有当 ESP station 连入 AP 或者配置过静态 IP 地址后，才能查询到它的 IP 地址
- 若 AT+SYSSTORE=1，配置更改将保存到 NVS 分区
- 本设置命令与设置 DHCP 的命令相互影响，如 AT+CWDHCP
- 若启用静态 IP 地址，则禁用 DHCP
- 若启用 DHCP，则禁用静态 IP 地址
- 最后一次配置会覆盖上一次配置
示例¶
AT+CIPSTA="192.168.6.100","192.168.6.1","255.255.255.0"
AT+CIPAP：查询/设置 ESP SoftAP 的 IP 地址¶
查询命令¶
功能：
查询 ESP SoftAP 的 IP 地址
命令：
AT+CIPAP?
响应：
+CIPAP:ip:<"ip">
+CIPAP:gateway:<"gateway">
+CIPAP:netmask:<"netmask">
+CIPAP:ip6ll:<"ipv6 addr">
+CIPAP:ip6gl:<"ipv6 addr">
OK
参数¶
- <”ip”>：字符串参数，表示 ESP SoftAP 的 IPv4 地址
- <”gateway”>：网关
- <”netmask”>：子网掩码
- <”ipv6 addr”>：ESP SoftAP 的 IPv6 地址
说明¶
- 若 AT+SYSSTORE=1，配置更改将保存到 NVS 分区
- 本设置命令与设置 DHCP 的命令相互影响，如 AT+CWDHCP
- 若启用静态 IP 地址，则禁用 DHCP
- 若启用 DHCP，则禁用静态 IP 地址
- 最后一次配置会覆盖上一次配置
示例¶
AT+CIPAP="192.168.5.1","192.168.5.1","255.255.255.0"
AT+CWSTARTSMART：开启 SmartConfig¶
参数¶
- <type>：类型
- 1: ESP-TOUCH
- 2: AirKiss
- 3: ESP-TOUCH+AirKiss
- <auth floor>: Wi-Fi 认证模式阈值，ESP-AT 不会连接到 authmode 低于此阈值的 AP
- 0: OPEN（默认）
- 1: WEP
- 2: WPA_PSK
- 3: WPA2_PSK
- 4: WPA_WPA2_PSK
- 5: WPA2_ENTERPRISE
- 6: WPA3_PSK
- 7: WPA2_WPA3_PSK
说明¶
- 更多有关 SmartConfig 的信息，请参考 ESP-TOUCH 使用指南；
- SmartConfig 仅支持在 ESP Station 模式下调用；
- 消息
Smart get Wi-Fi info表示 SmartConfig 成功获取到 AP 信息，之后 ESP 尝试连接 AP； - 消息
Smartconfig connected Wi-Fi表示成功连接到 AP； - 因为 ESP 设备需要将 SmartConfig 配网结果同步给手机端，所以建议在消息
Smartconfig connected Wi-Fi输出后延迟超过6秒再调用 AT+CWSTOPSMART； - 可调用 AT+CWSTOPSMART 停止 SmartConfig，然后再执行其他命令。注意，在 SmartConfig 过程中请勿执行其他命令。
示例¶
AT+CWMODE=1
AT+CWSTARTSMART
AT+CWSTOPSMART：停止 SmartConfig¶
说明¶
- 无论 SmartConfig 成功与否，都请在执行其他命令之前调用 AT+CWSTOPSMART 释放 SmartConfig 占用的内存
示例¶
AT+CWMODE=1
AT+CWSTARTSMART
AT+CWSTOPSMART
AT+WPS：设置 WPS 功能¶
参数¶
- <enable>：
- 1: 开启 PBC 类型的 WPS
- 0: 关闭 PBC 类型的 WPS
- <auth floor>: Wi-Fi 认证模式阈值，ESP-AT 不会连接到 authmode 低于此阈值的 AP
- 0: OPEN（默认）
- 1: WEP
- 2: WPA_PSK
- 3: WPA2_PSK
- 4: WPA_WPA2_PSK
- 5: WPA2_ENTERPRISE
- 6: WPA3_PSK
- 7: WPA2_WPA3_PSK
说明¶
- WPS 功能必须在 ESP Station 使能的情况下调用
- WPS 不支持 WEP 加密方式
示例¶
AT+CWMODE=1
AT+WPS=1
AT+MDNS：设置 mDNS 功能¶
参数¶
- <enable>：
- 1: 开启 mDNS 功能，后续参数需要填写
- 0: 关闭 mDNS 功能，后续参数无需填写
- <hostname>：mDNS 主机名称
- <service_name>：mDNS 服务名称
- <port>：mDNS 端口
示例¶
AT+MDNS=1,"espressif","_iot",8080
AT+MDNS=0
[ESP32 Only] AT+CWJEAP：连接 WPA2 企业版 AP¶
查询命令¶
功能：
查询 ESP station 连入的企业版 AP 的配置信息
命令：
AT+CWJEAP?
响应：
+CWJEAP:<ssid>,<method>,<identity>,<username>,<password>,<security>
OK
设置命令¶
功能：
连接到目标企业版 AP
命令：
AT+CWJEAP=<ssid>,<method>,<identity>,<username>,<password>,<security>[,<jeap_timeout>]
响应：
OK
或
+CWJEAP:Timeout
ERROR
参数¶
- <ssid>：企业版 AP 的 SSID
- 如果 SSID 或密码中包含
,、"、\\等特殊字符，需转义
- 如果 SSID 或密码中包含
- <method>：WPA2 企业版认证方式
- 0: EAP-TLS
- 1: EAP-PEAP
- 2: EAP-TTLS
- <identity>：阶段 1 的身份，字符串限制为 1 ~ 32
- <username>：阶段 2 的用户名，范围：1 ~ 32 字节，EAP-PEAP、EAP-TTLS 两种认证方式需设置本参数，EAP-TLS 方式无需设置本参数
- <password>：阶段 2 的密码，范围：1 ~ 32 字节，EAP-PEAP、EAP-TTLS 两种认证方式需设置本参数，EAP-TLS 方式无需设置本参数
- <security>：
- Bit0: 客户端证书
- Bit1: 服务器证书
- [<jeap_timeout>]：AT+CWJEAP 命令的最大超时时间，单位：秒，默认值：15，范围：[3,600]
示例¶
// 连接至 EAP-TLS 认证方式的企业版 AP，设置身份，验证服务器证书，加载客户端证书
AT+CWJEAP="dlink11111",0,"[email protected]",,,3
// 连接至 EAP-PEAP 认证方式的企业版 AP，设置身份、用户名、密码，不验证服务器证书，不加载客户端证书
AT+CWJEAP="dlink11111",1,"[email protected]","espressif","test11",0
错误代码:
WPA2 企业版错误码以 ERR CODE:0x<%08x> 格式打印：
| AT_EAP_MALLOC_FAILED | 0x8001 |
|---|---|
| AT_EAP_GET_NVS_CONFIG_FAILED | 0x8002 |
| AT_EAP_CONN_FAILED | 0x8003 |
| AT_EAP_SET_WIFI_CONFIG_FAILED | 0x8004 |
| AT_EAP_SET_IDENTITY_FAILED | 0x8005 |
| AT_EAP_SET_USERNAME_FAILED | 0x8006 |
| AT_EAP_SET_PASSWORD_FAILED | 0x8007 |
| AT_EAP_GET_CA_LEN_FAILED | 0x8008 |
| AT_EAP_READ_CA_FAILED | 0x8009 |
| AT_EAP_SET_CA_FAILED | 0x800A |
| AT_EAP_GET_CERT_LEN_FAILED | 0x800B |
| AT_EAP_READ_CERT_FAILED | 0x800C |
| AT_EAP_GET_KEY_LEN_FAILED | 0x800D |
| AT_EAP_READ_KEY_FAILED | 0x800E |
| AT_EAP_SET_CERT_KEY_FAILED | 0x800F |
| AT_EAP_ENABLE_FAILED | 0x8010 |
| AT_EAP_ALREADY_CONNECTED | 0x8011 |
| AT_EAP_GET_SSID_FAILED | 0x8012 |
| AT_EAP_SSID_NULL | 0x8013 |
| AT_EAP_SSID_LEN_ERROR | 0x8014 |
| AT_EAP_GET_METHOD_FAILED | 0x8015 |
| AT_EAP_CONN_TIMEOUT | 0x8016 |
| AT_EAP_GET_IDENTITY_FAILED | 0x8017 |
| AT_EAP_IDENTITY_LEN_ERROR | 0x8018 |
| AT_EAP_GET_USERNAME_FAILED | 0x8019 |
| AT_EAP_USERNAME_LEN_ERROR | 0x801A |
| AT_EAP_GET_PASSWORD_FAILED | 0x801B |
| AT_EAP_PASSWORD_LEN_ERROR | 0x801C |
| AT_EAP_GET_SECURITY_FAILED | 0x801D |
| AT_EAP_SECURITY_ERROR | 0x801E |
| AT_EAP_METHOD_SECURITY_UNMATCHED | 0x801F |
| AT_EAP_PARAMETER_COUNTS_ERROR | 0x8020 |
| AT_EAP_GET_WIFI_MODE_ERROR | 0x8021 |
| AT_EAP_WIFI_MODE_NOT_STA | 0x8022 |
| AT_EAP_SET_CONFIG_FAILED | 0x8023 |
| AT_EAP_METHOD_ERROR | 0x8024 |
说明¶
- 若 AT+SYSSTORE=1，配置更改将保存到 NVS 分区
- 使用本命令需开启 Station 模式
- 使用 TLS 认证方式需使能客户端证书
AT+CWHOSTNAME：查询/设置 ESP Station 的主机名称¶
参数¶
- <hostname>：ESP Station 的主机名称，最大长度：32 字节
说明¶
- 配置更改不保存到 flash
示例¶
AT+CWMODE=3
AT+CWHOSTNAME="my_test"
AT+CWCOUNTRY：查询/设置 Wi-Fi 国家代码¶
查询命令¶
功能：
查询 Wi-Fi 国家代码
命令：
AT+CWCOUNTRY?
响应：
+CWCOUNTRY:<country_policy>,<country_code>,<start_channel>,<total_channel_count>
OK
设置命令¶
功能：
设置 Wi-Fi 国家代码
命令：
AT+CWCOUNTRY=<country_policy>,<country_code>,<start_channel>,<total_channel_count>
响应：
OK
参数¶
- <country_policy>：
- 0: 将国家代码改为 ESP 设备连入的 AP 的国家代码
- 1: 不改变国家代码，始终保持本命令设置的国家代码
- <country_code>：国家代码，最大长度：3 个字符
- <start_channel>：起始信号道，范围：[1,14]
- <total_channel_count>：信道总个数
说明¶
- 配置更改不保存到 flash
示例¶
AT+CWMODE=3
AT+CWCOUNTRY=1,"CN",1,13