Wi-Fi AT命令集
Armino Wi-Fi AT命令集方便客户熟悉BEKEN Wi-Fi产品基本功能,能够快速了解Wi-Fi的基本使用方法,同时也为自动化脚本提供了标准接口
AT+WIFI=SCAN:扫描热点
AT+WIFI=STACONNECT:STA连接
AT+WIFI=APSTART:开启SoftAP
AT+WIFI=STATE:查看STA/SoftAP参数
AT+WIFI=STOP:关闭SoftAP/STA
AT+WIFI=PING:ping
AT+MAC:查看/修改设备MAC地址
AT+RST:重启设备
介绍
重要
Armino SDK默认支持上述所有的AT命令,未来还将支持更多的AT命令
AT+WIFI=SCAN:扫描热点
执行命令
功能:
扫描周边热点,并返回扫描结果
命令:
AT+WIFI=SCAN,<ssid>
响应:
CMDRSP:OK
或者
<error reason>
CMDRSP:ERROR
参数
<ssid>: 指定SSID扫描,参数为空表示执行全信道扫描
示例
//全信道扫描
AT+WIFI=SCAN
CMDRSP:OK
scan found 32 AP
SSID BSSID RSSI chan security
TP-Link_F49B 68:ff:7b:ae:f4:9b -40 6 WPA2-MIX
Xiaomi_1DBC d4:da:21:a4:1d:bd -36 6 WPA2-AES
Redmi_253C 24:cf:24:3a:25:3e -42 11 WPA2-AES
...
//指定SSID扫描
AT+WIFI=SCAN,aclsemi
CMDRSP:OK
scan found 3 AP
SSID BSSID RSSI chan security
aclsemi 58:c7:ac:7e:2d:f0 -50 11 WPA2-AES
aclsemi 58:c7:ac:7e:32:a0 -59 1 WPA2-AES
aclsemi 58:c7:ac:7e:2a:30 -65 6 WPA2-AES
AT+WIFI=STACONNECT:STA连接
执行命令
功能:
执行Wi-Fi Station连接目标AP操作
命令:
AT+WIFI=STACONNECT,<ssid>,<pwd>
响应:
CMDRSP:OK
或者
<error reason>
CMDRSP:ERROR
参数
- <ssid>:目标AP的SSID
如果 SSID 和密码中有
,
、"
、\\
等特殊字符,需转义支持连接SSID为中文的AP,但是某些路由器或者热点的中文SSID不是UTF-8编码格式。您可以先扫描SSID,然后使用扫描到的SSID进行连接
- <pwd>:目标AP的PASSWORD,如果热点不加密,则无需输入
密码最长63字节
示例
AT+WIFI=STACONNECT,aclsemi,ACL8semi
STA connected aclsemi
STA got ip
CMDRSP:OK
AT+WIFI=APSTART:开启SoftAP
执行命令
功能:
开启SoftAP,支持OPEN或者加密模式,支持指定信道
命令:
AT+WIFI=APSTART,<ssid>,<pwd>,<channel>
响应:
CMDRSP:OK
或者
<error reason>
CMDRSP:ERROR
参数
<ssid>:字符串参数,接入点名称
<pwd>:字符串参数,密码,范围8~63字节ASCII,为空表示不加密
<channel>:信道号,缺省为信道11
示例
AT+WIFI=APSTART,test321,12345678,10
chan_ctxt_add: CTXT1, freq=2457MHz, bw=20MHz, pwr=0dBm
beacon_int_set:100 TU
ap started
CMDRSP:OK
AT+WIFI=STATE:查看STA/SoftAP参数
执行命令
功能:
用于查看当前设备的模式状态,支持sta/ap查看ip地址、信道、ssid、bssid、rssi等信息
命令:
AT+WIFI=STATE,<mode>,<rssi>,<channel>,<bssid>,<ssid>,<ip>
响应:
CMDRSP:parameters
CMDRSP:OK
或者
bad parameters
CMDRSP:ERROR
参数
<mode>:STA/AP,支持查询STA/AP身份的参数
<rssi>:信号强度,一般为负数
<channel>:信道号,数值在1-14之间
<ssid>:接入点名称
<bssid>:接入点AP的MAC地址
<ip>:设备的IP地址,SoftAP的默认地址为192.168.0.1
示例
//查询SoftAP信道
AT+WIFI=STATE,AP,CHANNEL
CMDRSP::11
CMDRSP:OK
//查询STA连接的RSSI值
AT+WIFI=STATE,STA,RSSI
CMDRSP::-40
CMDRSP:OK
说明
STA支持查询:SSID、CHANNEL、IP、RSSI、BSSID
AP支持查询:SSID、CHANNEL、IP、SECURITY
AT+WIFI=STOP:关闭STA/SoftAP
执行命令
功能:
用于停止当前的SoftAP/STA身份
命令:
AT+WIFI=STOP,<mode>
响应:
CMDRSP:OK
或者
<error reason>
CMDRSP:ERROR
参数
<mode>:STA/AP
示例
//停止STA
AT+WIFI=STOP,STA
sta stopped
CMDRSP:OK
//停止SoftAP
AT+WIFI=STOP,AP
ap stopped
CMDRSP:OK
AT+WIFI=PING:Ping
执行命令
功能:
向目标主机发送ICMP Echo请求报文,测试目的站是否可达及了解其有关状态
命令:
AT+WIFI=PING,<host>,<num>,<bytes>
响应:
CMDRSP:OK
或者
<error reason>
CMDRSP:ERROR
参数
<host>:目的站点的IP地址,需在同一网段内
<num>:Ping包个数,默认为4
<bytes>:设置数据包大小,为空则为缺省值
示例
AT+WIFI=PING,192.168.1.1,10
ping: size:32 times:10
CMDRSP:OK
AT+MAC:查询/设置设备MAC地址
执行命令
功能:
用于查询/修改当前设备的MAC地址
命令:
AT+MAC //查询设备MAC地址
AT+MAC=<param> //修改设备MAC地址
响应:
CMDRSP:OK
或者
<error reason>
CMDRSP:ERROR
示例
//查询
AT+MAC
base mac: c8:47:8c:11:22:34
sta mac: c8:47:8c:11:22:34
ap mac: c8:47:8c:11:22:35
CMDRSP:OK
//设置
AT+MAC=c8478c334455
set base mac: c8:47:8c:33:44:55
CMDRSP:OK
AT+RST:重启设备
执行命令
功能:
重启设备
命令:
AT+RST
响应:
CMDRSP:OK
或者
<error reason>
CMDRSP:ERROR
示例
AT+RST
bk_reboot
CMDRSP:OK