AT模块 3: Wi-Fi 功能 AT 命令（Wi-Fi Function AT Commands）

来自Bouffalo Lab Docs
跳转到导航 跳转到搜索

Wi-Fi 功能 AT 命令

指令列表

指令 描述
AT+WIFISP 查询/设置启用/禁用 WLAN 射频
AT+CWMODE 设置 Wi-Fi 模式
AT+CWNETMODE 查询设备工作在 NCP/RCP 模式
AT+CWSTATE 查询 Wi-Fi 状态和 Wi-Fi 信息
AT+CWJAP 连接到 AP
AT+CWRECONNCFG 查询/设置 Wi-Fi 重连配置
AT+CWLAPOPT 设置 AT+CWLAP 命令扫描结果属性
AT+CWLAP 扫描附近的 AP
AT+CWQAP 断开 AP
AT+CWSAP 查询/设置 SoftAP 的配置
AT+CWLIF 获取连接到 SoftAP 的 station 的 IP 地址
AT+CWQIF 从 SoftAP 断开 station
AT+CWDHCP 启用/禁用 DHCP
AT+CWDHCPS 查询/设置 SoftAP DHCP 服务器分配的 IP 地址
AT+CWAUTOCONN 设置自动重连
AT+CIPSTAMAC 查询/设置 station 的 MAC 地址
AT+CIPAPMAC 查询/设置 SoftAP 的 MAC 地址
AT+CIPSTA 查询/设置 station 的 IP 地址
AT+CIPAP 查询/设置 SoftAP 的 IP 地址
AT+CWHOSTNAME 查询/设置 station 的主机名
AT+CWCOUNTRY 查询/设置 Wi-Fi 国家代码
AT+CWMONITOR 设置 Wi-Fi 进入监听模式
AT+CWSTAPROTO 查询/设置 Station 模式的 802.11 b/g/n/ax 协议标准
AT+CWAPPROTO 查询/设置 SoftAP 模式的 802.11 b/g/n/ax 协议标准
AT+WPS 启用 WPS 功能
AT+CWANTENABLE 启用/禁用天线分集功能
AT+CWANTNUM 获取当前设备的最大天线数量
AT+CWANT 设置/查询当前使用的天线

基本 AT 命令描述

AT+WIFISP

功能: 查询/设置启用/禁用 wlan 射频

查询命令

功能:

查询 wlan 射频启用状态

命令: 

AT+WIFISP?

响应: 

+WIFISP:<enable>

OK

设置命令

功能:

启用/禁用 wlan 射频

命令: 

AT+WIFISP=<enable>

响应: 

OK

参数

  • <enable>:
  • 0: 禁用 wlan 射频
  • 1: 启用 wlan 射频

AT+CWMODE

功能: 查询/设置 Wi-Fi 模式

查询命令

功能:

查询设备的 Wi-Fi 模式

命令: 

AT+CWMODE?

响应: 

+CWMODE:<mode>

OK

设置命令

功能:

设置设备的 Wi-Fi 模式

命令: 

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

响应: 

OK

参数

  • <mode>:
  • 0: 空模式。Wi-Fi RF 将被禁用
  • 1: Station 模式
  • 2: SoftAP 模式
  • 3: SoftAP+Station 模式
  • <auto_connect>: 当您将设备模式从 SoftAP 模式或空模式更改为 station 模式时,启用或禁用自动连接到 AP。默认值:1。如果省略该参数,将使用默认值,即自动连接到 AP。
  • 0: 设备不会自动连接到 AP
  • 1: 如果之前已在 flash 中保存连接到 AP 的配置,设备将自动连接到 AP

注意

  • 如果 AT+SYSSTORE=1,配置更改将保存在 easyflash 区域
  • SoftAP+Station 模式要求 AP 和 STA 必须在同一信道上

示例

AT+CWMODE=1

AT+CWNETMODE

功能: 查询设备工作在 NCP/RCP 模式

查询命令

功能:

查询设备是否工作在 NCP/RCP 模式

命令: 

AT+CWNETMODE?

响应: 

+CWNETMODE:<netmode>

OK

参数

  • <netmode>:
  • 0: RCP 模式
  • 1: NCP 模式

注意

  • 当设备处于 RCP 模式时,所有网络、HTTP 和 MQTT 相关的 AT 命令都将失效

AT+CWSTATE

功能: 查询 Wi-Fi 状态和 Wi-Fi 信息

查询命令

功能:

查询设备的 Wi-Fi 状态和 Wi-Fi 信息

命令: 

AT+CWSTATE?

响应: 

+CWSTATE:<state>,<"ssid">

OK

参数

  • <state>: 当前 Wi-Fi 状态
  • 0: station 尚未启动任何 Wi-Fi 连接
  • 1: station 已连接到 AP,但尚未获得 IPv4 地址
  • 2: station 已连接到 AP,并已获得 IPv4 地址
  • 3: station 处于 Wi-Fi 连接或重连状态
  • 4: station 处于 Wi-Fi 断开状态
  • <"ssid">: 目标 AP 的 SSID

注意

  • 当 station 未连接到 AP 时,建议使用此命令查询 Wi-Fi 信息;station 连接到 AP 后,建议使用 AT+CWJAP 查询 Wi-Fi 信息

AT+CWJAP

功能: 连接到 AP

查询命令

功能:

查询 Station 已连接的 AP

命令: 

AT+CWJAP?

响应: 

+CWJAP:<ssid>,<bssid>,<channel>,<rssi>,<wep_en>

OK

设置命令

功能:

将 station 连接到目标 AP

命令: 

AT+CWJAP=[<ssid>],[<pwd>][,<bssid>][,<wep_en>]

注意

  • 在这些参数中,'ssid' 和 'pwd' 是必填项,其他是可选项
  • +CW:GOTIP 之后的详细网络信息(IP、Gateway、Mask、DNS)仅在 AT+SYSLOG 设置为 1 时才会打印。当 AT+SYSLOG 设置为 0 时,只打印 +CW:GOTIP,不打印额外的网络详细信息

响应: 

+CW:CONNECTED
+CW:GOTIP
IP:<"ip">
Gateway:<"gateway">
Mask:<"netmask">
DNS:<"dns">

OK

或 

+CW:CONNECTING

OK

+CW:ERROR,<reason_code>

或 

+CWJAP:<error code>
ERROR

执行命令

功能:

使用最后的 Wi-Fi 配置将 station 连接到目标 AP

命令: 

AT+CWJAP

响应: 

+CW:CONNECTED
+CW:GOTIP
IP:<"ip">
Gateway:<"gateway">
Mask:<"netmask">
DNS:<"dns">

OK

或 

+CWJAP:<error code>
ERROR

参数

  • <ssid>: 目标 AP 的 SSID
  • 如果 SSID 或密码包含特殊字符(如 ,、" 或 \),则需要使用转义字符语法
  • <pwd>: 密码,最大长度:64 字节 ASCII
  • <bssid>: 目标 AP 的 MAC 地址。当多个 AP 具有相同的 SSID 时,不能省略此参数
  • <channel>: 信道
  • <rssi>: 信号强度
  • <wep_en>: 连接的 AP 是否使用 WEP 加密?
  • 0: 非 WEP 加密
  • 1: 是 WEP 加密
  • <error code>: (仅供参考)
  • 1: 连接超时
  • 2: 密码错误
  • 3: 找不到目标 AP
  • 4: 连接失败
  • 其他: 发生未知错误
  • <reason_code>:
  • 1: 无法为传输认证帧分配内存
  • 2: 认证过程失败
  • 3: 认证算法未被接受或失败
  • 4: 无法为传输关联帧分配内存
  • 5: 与访问点的关联过程失败
  • 6: 在未连接时发生访问点的去认证
  • 7: 在连接时发生访问点的去认证
  • 8: 四次握手期间发生超时,可能是由于 PSK(预共享密钥)问题
  • 9: 在四次握手期间无法传输去认证帧
  • 10: 在四次握手期间无法为去认证帧分配内存
  • 11: 等待认证或关联响应超时
  • 12: 扫描过程中未找到 BSSID 或信道
  • 13: 尝试加入网络时无法创建信道上下文
  • 14: 加入网络失败
  • 15: 无法将 station(STA)添加到网络
  • 16: 发生 Beacon 丢失,可能导致断开连接
  • 17: 网络安全设置不匹配
  • 18: 由于 WEP 密钥长度不正确而发生错误
  • 19: 用户发起的去认证断开连接
  • 20: 用户发起的断开连接,未发送去认证帧
  • 21: 由于固件未能发送省电空帧而发生断开连接
  • 22: 检测到流量丢失
  • 23: 切换到新信道失败
  • 24: 确认认证或关联响应失败
  • 25: 重新关联过程正在开始

注意

  • 如果 AT+SYSSTORE=1,配置更改将保存在 easyflash 区域
  • 此命令需要启用 Station 模式
  • 此命令的参数 <reconn_interval> 与命令 AT+CWRECONNCFG 的参数 <interval_second> 相同。因此,如果您在运行此命令时省略 <reconn_interval>,Wi-Fi 重连之间的间隔将使用默认值 1
  • 如果省略 <ssid> 和 <password> 参数,AT 将使用最后的配置
  • 执行命令与设置命令具有相同的最大超时时间。默认值为 15 秒,但您可以通过设置参数 <jap_timeout> 来更改它

示例

// 如果目标 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"

// 如果要求通过受保护的管理帧连接到 AP,命令应为:
AT+CWJAP="abc","0123456789",,,,,,,3

AT+CWRECONNCFG

功能: 查询/设置 Wi-Fi 重连配置

查询命令

功能:

查询 Wi-Fi 重连的配置

命令: 

AT+CWRECONNCFG?

响应: 

+CWRECONNCFG:<interval_second>,<repeat_count>

OK

设置命令

功能:

设置 Wi-Fi 重连的配置

命令: 

AT+CWRECONNCFG=<interval_second>,<repeat_count>

响应: 

OK

参数

  • <interval_second>: Wi-Fi 重连之间的间隔。单位:秒。默认值:0。最大值:7200
  • 0: 断开连接时 station 不会重新连接到 AP
  • [1,7200]: 断开连接时 station 将按指定间隔重新连接到 AP
  • <repeat_count>: 设备尝试重新连接到 AP 的次数。此参数仅在参数 <interval_second> 不为 0 时有效。默认值:0。最大值:1000
  • 0: station 将始终尝试重新连接到 AP
  • [1,1000]: station 将尝试重新连接到 AP 指定次数

示例

// station 以一秒的间隔尝试重新连接到 AP 100 次
AT+CWRECONNCFG=1,100

// station 断开连接时不会重新连接到 AP
AT+CWRECONNCFG=0,0

注意

  • 此命令的参数 <interval_second> 与命令 AT+CWJAP 的参数 [<reconn_interval>] 相同
  • 此命令适用于从 AP 被动断开连接、Wi-Fi 模式切换和开机后 Wi-Fi 自动连接

AT+CWLAPOPT

功能: 设置命令 AT+CWLAP 的配置

设置命令

命令: 

AT+CWLAPOPT=<sort_enable>,<print mask>[,<rssi filter>][,<authmode mask>][,<max_count>]

响应: 

OK

或 

ERROR

参数

  • <sort_enable>: 启用/禁用按 RSSI 排序扫描结果(默认排序)
  • <print mask>: 确定是否在 AT+CWLAP 的结果中显示以下参数。默认值:0x7FF。如果将其设置为 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>]: 确定是否根据 rssi filter 过滤命令 AT+CWLAP 的结果。换句话说,命令结果将不显示信号强度低于 rssi filter 的 AP。单位:dBm。默认值:-100。范围:[-100,40]
  • [<authmode mask>]: 确定是否在 AT+CWLAP 的结果中显示具有以下认证模式的 AP。默认值:0xFFFF。如果将 bit x 设置为 1,将显示具有相应认证模式的 AP。如果将 bit x 设置为 0,将不显示具有相应认证模式的 AP
  • 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
  • [<max_count>]: 扫描的 WiFi 网络的最大数量默认为 50,这意味着 CWLAP 命令响应可以包含最多 50 个扫描结果。范围:(0,50]

示例

// 第一个参数为 1,表示命令 AT+CWLAP 的结果将按 RSSI 排序;
// 第二个参数为 31,即 0x1F,表示 <print mask> 的相应位设置为 1。所有参数都将在 AT+CWLAP 的结果中显示
AT+CWLAPOPT=1,31
AT+CWLAP

// 仅显示认证模式为 OPEN 的 AP
AT+CWLAPOPT=1,31,-100,1
AT+CWLAP

AT+CWLAP

功能: 列出可用的 AP

设置命令

功能:

查询具有指定参数(如 SSID、MAC 地址或信道)的 AP

命令: 

AT+CWLAP=[<scan_type>,<ssid>,<mac>,<channel>,<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: WPAx_ENTERPRISE
  • 6: WPA3_PSK
  • 7: WPA2_WPA3_PSK
  • <scan_type>: Wi-Fi 扫描类型
  • 0: 主动扫描
  • 1: 被动扫描
  • <ssid>: 显示 AP 的 SSID 的字符串参数
  • <rssi>: 信号强度
  • <mac>: 显示 AP 的 MAC 地址的字符串参数
  • <channel>: 信道
  • <scan_time_min>: 每个信道的最小主动扫描时间。单位:毫秒。范围 [0,1500]。如果扫描类型为被动,则此参数无效
  • <scan_time_max>: 每个信道的最大主动扫描时间。单位:毫秒。范围 [0,1500]。如果此参数为 0,固件将使用默认时间:主动扫描 120 毫秒;被动扫描 360 毫秒
  • <freq_offset>: 频率偏移(保留项)
  • <freqcal_val>: 频率校准值(保留项)
  • <pairwise_cipher>: 成对密码类型
  • 0: None
  • 1: WEP40
  • 2: WEP104
  • 3: TKIP
  • 4: CCMP
  • 5: TKIP 和 CCMP
  • 6: AES-CMAC-128
  • 7: Unknown
  • <group_cipher>: 组密码类型,与 <pairwise_cipher> 的枚举值相同
  • <bgn>: 802.11 b/g/n。如果相应位为 1,则启用相应模式;如果相应位为 0,则禁用相应模式
  • bit 0: 识别是否启用 802.11b 模式的位
  • bit 1: 识别是否启用 802.11g 模式的位
  • bit 2: 识别是否启用 802.11n 模式的位
  • bit 3: 识别是否启用 802.11ax 模式的位
  • <wps>: wps 标志
  • 0: 禁用 WPS
  • 1: 启用 WPS

示例

AT+CWLAP=0,"Wi-Fi","ca:d7:19:d8:a6:44",6,0,400,1000

// 搜索具有指定 SSID 的 AP:
AT+CWLAP=0,"Wi-Fi"

AT+CWQAP

功能: 断开与 AP 的连接

执行命令

命令: 

AT+CWQAP=[<restore>]

响应: 

OK

命令: 

AT+CWQAP

响应: 

OK

参数

  • 可选的 <restore>: 擦除已保存的 SSID 和密码信息的标志
  • 0: 不擦除已保存的 SSID 和密码信息(默认)
  • 1: 擦除已保存的 SSID 和密码信息

AT+CWSAP

功能: 查询/设置 SoftAP 的配置

查询命令

功能:

查询 SoftAP 的配置参数

命令: 

AT+CWSAP?

响应: 

+CWSAP:<ssid>,<pwd>,<channel>,<ecn>,<max conn>,<ssid hidden>

OK

设置命令

功能:

设置 SoftAP 的配置

命令: 

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

响应: 

OK

参数

  • <ssid>: 显示 AP 的 SSID 的字符串参数
  • <pwd>: 显示密码的字符串参数。长度:8 ~ 64 字节 ASCII
  • <channel>: 信道 ID
  • <ecn>: 加密方法;不支持 WEP
  • 0: OPEN
  • 2: WPA_PSK
  • 3: WPA2_PSK
  • 4: WPA3_PSK
  • [<max conn>]: SoftAP 可以连接的最大 station 数。范围:[1,4]
  • [<ssid hidden>]:
  • 0: 广播 SSID(默认)
  • 1: 不广播 SSID

注意

  • 此命令仅在 AT+CWMODE=2 或 AT+CWMODE=3 时有效
  • 如果 AT+SYSSTORE=1,配置更改将保存在 easyflash 区域

AT+CWLIF

功能: 获取连接到 SoftAP 的 Station 的 IP 地址

执行命令

命令: 

AT+CWLIF

响应: 

+CWLIF:<ip addr>,<mac>

OK

参数

  • <ip addr>: 连接到 SoftAP 的 station 的 IP 地址
  • <mac>: 连接到 SoftAP 的 station 的 MAC 地址

注意

  • 此命令无法获取静态 IP。它仅在 SoftAP 和连接的 station 的 DHCP 都启用时有效

AT+CWQIF

功能: 从 SoftAP 断开 Station

执行命令

功能:

断开连接到 SoftAP 的所有 station

命令: 

AT+CWQIF

响应: 

OK

设置命令

功能:

从 SoftAP 断开特定的 station

命令: 

AT+CWQIF=<mac>

示例

AT+CWQIF="18:b9:05:ed:59:cc"

响应: 

OK

参数

  • <mac>: 要断开的 station 的 MAC 地址

AT+CWDHCP

功能: 启用/禁用 DHCP

查询命令

命令: 

AT+CWDHCP?

响应: 

<state>

设置命令

功能:

启用/禁用 DHCP

命令: 

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,配置更改将保存在 easyflash 区域
  • 此设置命令与设置静态 IP 的命令(如 AT+CIPSTA 和 AT+CIPAP)相关:
  • 如果启用 DHCP,静态 IP 地址将被禁用
  • 如果启用静态 IP 地址,DHCP 将被禁用
  • 最后的配置将覆盖以前的配置

示例

// 启用 Station DHCP。如果最后的 DHCP 模式为 2,则当前的 DHCP 模式将为 3
AT+CWDHCP=1,1

// 禁用 SoftAP DHCP。如果最后的 DHCP 模式为 3,则当前的 DHCP 模式将为 1
AT+CWDHCP=0,2

AT+CWDHCPS

功能: 查询/设置 SoftAP DHCP 服务器分配的 IP 地址

查询命令

命令: 

AT+CWDHCPS?

响应: 

+CWDHCPS=<lease time>,<start IP>,<end IP>

OK

设置命令

功能:

设置 SoftAP DHCP 服务器的 IP 地址范围

命令: 

AT+CWDHCPS=<enable>,<lease time>,<start IP>,<end IP>

响应: 

OK

参数

  • <enable>:
  • 1: 启用 DHCP 服务器设置。必须设置以下参数
  • 0: 禁用 DHCP 服务器设置并使用默认 IP 地址范围
  • <lease time>: 租约时间。单位:分钟。范围 [1,2880]
  • <start IP>: 可以从 SoftAP DHCP 服务器获取的 IP 地址范围的起始 IP 地址
  • <end IP>: 可以从 SoftAP DHCP 服务器获取的 IP 地址范围的结束 IP 地址

注意

  • 如果 AT+SYSSTORE=1,配置更改将保存在 easyflash 区域
  • 此 AT 命令仅在设备同时启用 SoftAP 和 DHCP 服务器时有效
  • IP 地址应与 SoftAP 的 IP 地址在同一网段

示例

AT+CWDHCPS=1,3,"192.168.4.10","192.168.4.15"

AT+CWDHCPS=0 // 禁用设置并使用默认 IP 地址范围

AT+CWAUTOCONN

功能: 开机时自动连接到 AP

设置命令

命令: 

AT+CWAUTOCONN=<enable>

响应: 

OK

参数

  • <enable>:
  • 1: 开机时启用自动连接到 AP(默认)
  • 0: 开机时禁用自动连接到 AP

注意

  • 配置更改将保存在 easyflash 区域

示例

AT+CWAUTOCONN=1

AT+CIPSTAMAC

功能: 查询/设置 BL61x Station 的 MAC 地址

查询命令

功能:

查询 Station 的 MAC 地址

命令: 

AT+CIPSTAMAC?

响应: 

+CIPSTAMAC:<mac>

OK

设置命令

功能:

设置 station 的 MAC 地址

命令: 

AT+CIPSTAMAC=<mac>

响应: 

OK

参数

  • <mac>: 显示 station 的 MAC 地址的字符串参数

注意

  • 如果 AT+SYSSTORE=1,配置更改将保存在 easyflash 区域
  • SoftAP 的 MAC 地址与 Station 相同,当设置 Station MAC 时,SoftAP 的 MAC 也将自动更新
  • MAC 地址的第 0 位不能为 1。例如,MAC 地址可以是 "1a:...",但不能是 "15:..."
  • FF:FF:FF:FF:FF:FF 和 00:00:00:00:00:00 是无效的 MAC 地址,无法设置

示例

AT+CIPSTAMAC="1a:fe:35:98:d3:7b"

AT+CIPAPMAC

功能: 查询/设置 SoftAP 的 MAC 地址

查询命令

功能:

查询 SoftAP 的 MAC 地址

命令: 

AT+CIPAPMAC?

响应: 

+CIPAPMAC:<mac>

OK

设置命令

功能:

设置 SoftAP 的 MAC 地址

命令: 

AT+CIPAPMAC=<mac>

响应: 

OK

参数

  • <mac>: 显示 SoftAP 的 MAC 地址的字符串参数

注意

  • 如果 AT+SYSSTORE=1,配置更改将保存在 easyflash 区域
  • SoftAP 的 MAC 地址与 Station 相同,当设置 SoftAP MAC 时,Station 的 MAC 也将自动更新
  • MAC 地址的第 0 位不能为 1。例如,MAC 地址可以是 "18:...",但不能是 "15:..."
  • FF:FF:FF:FF:FF:FF 和 00:00:00:00:00:00 是无效的 MAC,无法设置

==== 示例 ===- 

AT+CIPAPMAC="18:fe:35:98:d3:7b"

AT+CIPSTA

功能: 查询/设置 Station 的 IP 地址

查询命令

功能:

查询 Station 的 IP 地址

命令: 

AT+CIPSTA?

响应: 

+CIPSTA:ip:<"ip">
+CIPSTA:gateway:<"gateway">
+CIPSTA:netmask:<"netmask">
+CIPSTA:dns:<"dns">
+CIPSTA:ip6ll:<"ipv6 addr">
+CIPSTA:ip6gl:<"ipv6 addr">
OK

设置命令

功能:

设置 station 的 IPv4 地址

命令: 

AT+CIPSTA=<"ip">[,<"gateway">,<"netmask">,<"dns">]

响应: 

OK

参数

  • <"ip">: 显示 station 的 IPv4 地址的字符串参数
  • <"gateway">: 网关
  • <"netmask">: 子网掩码
  • <"ipv6 addr">: 显示 BFLB station 的 IPv6 地址的字符串参数

==== 注意 ===-

  • 对于查询命令,只有在 station 连接到 AP 或配置了静态 IP 地址时,才能查询其 IP 地址
  • 如果 AT+SYSSTORE=1,配置更改将保存在 easyflash 区域
  • 设置命令与设置 DHCP 的命令(如 AT+CWDHCP)相关:
  • 如果启用静态 IP 地址,DHCP 将被禁用
  • 如果启用 DHCP,静态 IP 地址将被禁用
  • 最后的配置将覆盖以前的配置

示例

AT+CIPSTA="192.168.6.100","192.168.6.1","255.255.255.0"

AT+CIPAP

功能: 查询/设置 SoftAP 的 IP 地址

查询命令

功能:

查询 SoftAP 的 IP 地址

命令: 

AT+CIPAP?

响应: 

+CIPAP:ip:<"ip">
+CIPAP:gateway:<"gateway">
+CIPAP:netmask:<"netmask">

OK

设置命令

功能:

设置 SoftAP 的 IPv4 地址

命令: 

AT+CIPAP=<"ip">[,<"gateway">,<"netmask">]

响应: 

OK

参数

  • <"ip">: 显示 SoftAP 的 IPv4 地址的字符串参数
  • <"gateway">: 网关
  • <"netmask">: 子网掩码

注意

  • 如果 AT+SYSSTORE=1,配置更改将保存在 easyflash 区域
  • 设置命令与设置 DHCP 的命令(如 AT+CWDHCP)相关:
  • 如果启用静态 IP 地址,DHCP 将被禁用
  • 如果启用 DHCP,静态 IP 地址将被禁用
  • 最后的配置将覆盖以前的配置

示例

AT+CIPAP="192.168.5.1","192.168.5.1","255.255.255.0"

AT+CWHOSTNAME

功能: 查询/设置 Station 的主机名

查询命令

功能:

查询 Station 的主机名

命令: 

AT+CWHOSTNAME?

响应: 

+CWHOSTNAME:<hostname>

OK

设置命令

功能:

设置 Station 的主机名

命令: 

AT+CWHOSTNAME=<hostname>

响应: 

OK

如果未启用 Station 模式,命令将返回: 

ERROR

参数

  • <hostname>: Station 的主机名。最大长度:32 字节

注意

  • 配置更改不会保存在 flash 中

示例

AT+CWMODE=3
AT+CWHOSTNAME="my_test"

AT+CWCOUNTRY

功能: 查询/设置 Wi-Fi 国家代码

查询命令

功能:

查询 Wi-Fi 国家代码信息

命令: 

AT+CWCOUNTRY?

响应: 

+CWCOUNTRY:<country_policy>,<country_code>

OK

设置命令

功能:

设置 Wi-Fi 国家代码信息

命令: 

AT+ CWCOUNTRY=<country_policy>,<country_code>

响应: 

OK

参数

  • <country_policy>:
  • 0: 将国家代码更改为设备连接的 AP 的国家代码
  • 1: 国家代码不会更改,始终是命令设置的国家代码
  • <country_code>: 国家代码。最大长度:3 个字符

注意

  • 配置更改不会保存在 flash 中

示例

AT+CWMODE=3
AT+CWCOUNTRY=1,"CN"

AT+CWMONITOR

功能: 设置 Wi-Fi 进入监听模式

设置命令

功能:

设置 Wi-Fi 进入监听模式

命令: 

AT+ CWMONITOR=<enable>,<channel>,[<min_pkg_len>],[<max_pkg_len>]

响应: 

OK

+CWMONITOR,<channel>,<pkg_len>:
...

参数

  • <enable>:
  • 0: 停止监听模式
  • 1: 设置 Wi-Fi 进入监听模式
  • <channel>: 需要监听的信道
  • <min_pkg_len>: 过滤并接收具有最小长度的数据包
  • <max_pkg_len>: 过滤并接收具有最大长度的数据包
  • <pkg_len>: 接收到的数据包长度
  • : 接收到的原始数据包,以十六进制格式显示

注意

  • 监听的信道需要在 AT+CWCOUNTRY 设置的信道范围内

示例

AT+CWMONITOR=1,6

OK

+CWMONITOR,6,177:xxxxxxxxxxxxxx
...

AT+CWSTAPROTO

功能: 查询/设置 Station 模式的 802.11 b/g/n/ax 协议标准

查询命令

功能:

查询 Station 模式的 802.11 b/g/n/ax 协议标准

命令: 

AT+CWSTAPROTO?

响应: 

+CWSTAPROTO:<protocol>

OK

设置命令

功能:

设置 Station 模式的 802.11 b/g/n/ax 协议标准

命令: 

AT+CWSTAPROTO=<protocol>

响应: 

OK

参数

  • <enable>:
  • bit0: 802.11b 协议标准
  • bit1: 802.11g 协议标准
  • bit2: 802.11n 协议标准
  • bit3: 802.11ax 协议标准

注意

  • 它将在下次连接时生效
  • 默认情况下,BFLB 的 PHY 模式为 802.11bgn/ax 模式

示例

AT+CWSTAPROTO=1

OK

AT+CWMODE=1

OK

AT+CWJAP="SSID","12345678"

...

AT+CWAPPROTO

功能: 查询/设置 SoftAP 模式的 802.11 b/g/n/ax 协议标准

查询命令

功能:

查询 SoftAP 模式的 802.11 b/g/n/ax 协议标准

命令: 

AT+CWAPPROTO?

响应: 

+CWAPPROTO:<protocol>

OK

设置命令

功能:

设置 SoftAP 模式的 802.11 b/g/n/ax 协议标准

命令: 

AT+CWAPPROTO=<protocol>

响应: 

OK

参数

  • <enable>:
  • bit0: 802.11b 协议标准
  • bit1: 802.11g 协议标准
  • bit2: 802.11n 协议标准
  • bit3: 802.11ax 协议标准

注意

  • 它将在下次连接时生效
  • 默认情况下,BFLB 的 PHY 模式为 802.11bgn/ax 模式

示例

AT+CWAPPROTO=1

OK

AT+CWMODE=2

OK

AT+CWSAP="AP_SSID","12345678",1,3,10,0

...

AT+WPS

功能: 启用 WPS 功能

设置命令

功能:

启用 WPS 功能

命令: 

AT+WPS=<enable>[,<auth floor>]

响应: 

OK

参数

  • <enable>:
  • 1: 启用使用 PBC(按钮配置)模式的 WPS(Wi-Fi 保护设置)
  • 0: 禁用使用 PBC 模式的 WPS
  • <auth floor>:
  • 0: 认证开放(默认)
  • 1: 认证 WEP
  • 2: 认证 WPA PSK
  • 3: 认证 WPA2 PSK
  • 4: 认证 WPA/WPA2 PSK

注意

  • WPS 仅在启用 BFLB station 时可用
  • WPS 不支持 WEP(有线等效隐私)加密

示例

AT+CWMODE=1

OK

AT+WPS=1

OK

...

AT+CWANTENABLE

功能: 启用/禁用天线分集功能

查询命令

功能:

查询是否启用了天线分集功能

命令: 

AT+CWANTENABLE?

响应: 

+CWANTENABLE:<dynamic_enable>,<static_enable>,<pin>

OK

设置命令

功能:

启用天线分集功能

命令: 

AT+CWANTENABLE=<dynamic_enable>,<static_enable>[,<pin>]

响应: 

OK

参数

  • <dynamic_enable>:
  • 1: 启用动态天线分集功能
  • 0: 禁用动态天线分集功能
  • <static_enable>:
  • 1: 启用静态天线分集功能
  • 0: 禁用静态天线分集功能
  • <pin>: 引脚编号

示例

AT+CWANTENABLE=1,1,0

OK

AT+RST

OK

AT+CWMODE=1

OK

AT+CWJAP="SSID","password"

OK

...

注意

  • 此参数在重启后生效

AT+CWANTNUM

功能: 获取当前设备的最大天线数量

查询命令

功能:

获取当前设备的最大天线数量

命令: 

AT+CWANTNUM?

响应: 

+CWANTNUM:<numbers>

OK

AT+CWANT

功能: 设置/查询当前使用的天线

查询命令

功能:

查询当前使用的天线

命令: 

AT+CWANT?

响应: 

+CWANT:<ant_id>

OK

设置命令

功能:

启用自动天线分集功能

命令: 

AT+CWANT=<ant_id>

响应: 

OK

参数

  • <ant_id>:
  • 天线编号 ID

示例

AT+CWANT=1

OK

AT+CWANT=0

OK
检索自“https://docs.bouffalolab.com/index.php?title=AT模块_3:_Wi-Fi_功能_AT_命令（Wi-Fi_Function_AT_Commands）&oldid=178”