wifi指令集

AT+CWMODE:设置/查询wifi工作模式

查询命令

命令:

AT+CCWMODE?

返回:

+CWMODE: <mode>,<auto_connect>
OK

执行命令

命令:

AT+CWMODE=<mode>[,<auto_connect>]

返回:

OK

参数

  • <mode>:模式

    • 0: 无 Wi-Fi 模式,并且关闭 Wi-Fi RF

    • 1: Station 模式

    • 2: SoftAP 模式

    • 3: SoftAP+Station 模式

  • <auto_connect>:

    • 0: 禁用自动连接 AP 的功能

    • 1: 启用自动连接 AP 的功能,若之前已经将自动连接 AP 的配置保存到 flash 中,重启会自动连接

AT+CIPSTAMAC:设置/查询当前WIFI MAC地址

查询命令

命令:

AT+CIPSTAMAC?

返回:

+WLMAC:<mac>
OK

执行命令

命令:

AT+CIPSTAMAC=<"mac">

返回:

OK

参数

  • <”mac”>:支持”MM:MM:MM:MM:MM:MM”和”MM-MM-MM-MM-MM-MM”两种格式

AT+CWSAP:SoftAP配置参数

执行命令

命令:

AT+CWSAP=<"ssid">,<"pwd">,<channel>,<ecn>[,max conn>][,<hidden>]

返回:

OK

参数

  • <SSID>:字符串参数,接入点名称

  • <PWD>:字符串参数,密码,范围:8 ~ 64 字节 ASCII

  • <CHANNELl>:信道号

  • <proto>:

    • 0: 802.11bgn 协议标准

    • 1: 802.11bg 协议标准

    • 2: 802.11b 协议标准

  • <ECN>:加密方式,不支持 WEP

    • 0 OPEN

    • 1 WEP

    • 2 WPA_TKIP

    • 3 WPA_AES

    • 4 WPA2_TKIP

    • 5 WPA2_AES

    • 6 AES_TKIP_WPA2_MIXED

    • 7 WPA3_SAE

    • 8 WPA3_WPA2 (默认)

    • 9 EAP

    • 10 OWE

    • 11 AUTO

  • [<max conn>]:允许连入 SoftAP 的最多 station 数目,取值范围:[1,3]

  • [<ssid hidden>]:

    • 0: 广播 SSID(默认)

    • 1: 不广播 SSID

说明

  • SoftAP 与WLMODE配置相关,只有当WLMODE中的mode参数配置为2,3时SoftAP才开启,默认SSID为bk7238。

AT+CWQIF:停止SoftAP

执行命令

命令:

AT+CWQIF

返回:

OK

AT+CIPAP:配置SoftAP静态IP及网关

查询命令

命令:

AT+CIPAP?

返回:

+CIPAP: <”ip”>,<”netmask”>,<”gateway”>
OK

执行命令

命令:

AT+CIPAP=<”ip”>,<”netmask”>,<”gateway”>

返回:

OK

参数

  • <”ip”>:字符串参数,表示IPv4地址

  • <”gateway”>:网关

  • <”netmask”>:子网掩码

AT+ CWLIF:查询连接到softap 上设备信息

查询命令

命令:

AT+CWLIF

返回:

+CWLIF:<index>,<ip>,<mac>,<rssi>
OK

参数

  • <index>:连接SoftAP序号

  • <ip>:网关

  • <mac>:子网掩码

  • <rssi>:dns地址

AT+WSCAN:扫描可用的AP

执行命令

命令:

AT+WSCAN

返回:

-CMDRSP: +WSCAN <ssid>,<bssid>,<channel>,<enc>,<rssi>

参数

  • <ssid>:字符串参数,AP的SSID

  • <mac>:字符串参数,AP的MAC地址

  • <channel>:子网掩码

  • <ecn>:加密方式

    • 0 OPEN

    • 1 WEP

    • 2 WPA_TKIP

    • 3 WPA_AES

    • 4 WPA2_TKIP

    • 5 WPA2_AES

    • 6 AES_TKIP_WPA2_MIXED

    • 7 WPA3_SAE

    • 8 WPA3_WPA2(默认)

    • 9 EAP

    • 10 OWE

    • 11 AUTO

  • <rssi>:信号强度

AT+CWDHCP:启用/禁用 DHCP

查询命令

命令:

AT+CWDHCP?

返回:

<state>

执行命令

命令:

AT+CWDHCP=<operate>,<mode>

返回:

OK

参数

  • <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

说明

  • 若AT+SYSSTORE=1,配置更改将保存到NVS分区

示例

启用:

AT+CWDHCP=1,1           //启用sta的DHCP
AT+CWDHCP=1,2           //启用ap的DHCP
AT+CWDHCP=1,3           //启用sta+ap的DHCP

禁用:

AT+CWDHCP=0,1           //禁用sta的DHCP
AT+CWDHCP=0,2           //禁用ap的DHCP
AT+CWDHCP=0,3           //禁用sta+ap的DHCP

AT+CWJAP:Station连接AP

执行命令

命令:

AT+CWJAP=[<ssid>],[<pwd>][,<bssid>][,<pci_en>][,<reconn_interval>][,<listen_interval>][,<scan_mode>][,<jap_timeout>][,<pmf>]

返回:

OK
WIFI CONNECTED
WIFI GOT IP

说明

  • 若AT+SYSSTORE=1,配置更改将保存到NVS分区。

AT+CWQAP:断开与 AP 的连接

执行命令

命令:

AT+CWQAP

返回:

OK

AT+CIPSTA:查询/设置 Station 的 IP 信息

查询命令

命令:

AT+CIPSTA?

返回:

+CIPSTA:<ip>,<netmask>,<gateway>

执行命令

命令:

AT+STASTATIC=<ip>,<netmask>,<gateway>

返回:

OK

参数

  • <ip>:字符串参数,表示 IPv4 地址

  • <gateway>:网关

  • <netmask>:子网掩码