1、需要下载的软件
USR-WIFI232-Setup-AT指令设置软件:http://www.usr.cn/Download/91.html
USR-TCP232-Test 串口网络二合一调试工具:
http://www.usr.cn/Download/27.html
2. 快速联网协议
模块工作在 AP 模式下时,会开启一个用于接收快速联网协议命令的 UDP 端口,端口号为 48899(与局域网搜索端口相同,可设置)。电脑或手机可与模块 Wi-Fi 网络直连,通过 UDP 协议下的指令,查询 SSID 信息列表和 设置路由器 SSID 及密码。设置完成后,模块会自动重启,连接至设定的路由器,此时工作在 STA 模式。
协议格式说明:
a. 查询指令
序号 |
名称 |
字节数 |
说明 |
1 |
包头 |
1 |
固定值 0xFF |
2 |
长度 |
2 |
长度之后(不包括长度),校验字之前(不包括校验字)的所有字节数。 |
3 |
命令字 |
1 |
命令类型,0x01 为查询指令 |
4 |
校验字 |
1 |
包头之后(不包括包头),校验字之前(不包括校验字)的所有字节的累加和。 |
回复指令
序号 |
名称 |
字节数 |
说明 |
1 |
包头 |
1 |
固定值 0xFF |
2 |
长度 |
2 |
长度之后(不包括长度),校验字之前(不包括校验字)的所有字节数。 |
3 |
命令字 |
1 |
命令类型,查询指令对应的回复指令为 0x81 |
4 |
AP 个数 |
1 |
当前搜索到的 AP 的个数 |
5 |
SSID1 |
不定长 |
路由器 1 的 SSID |
6 |
结束符 |
1 |
路由器 1 的 SSID 结束符,固定值 0x00 |
7 |
信号强度 1 |
1 |
路由器 1 网络的信号强度,范围 0~100,对应的实际值为 0%~100% |
8 |
结束符 |
2 |
信号强度 1 的结束符,0x0D,0x0A |
... |
... |
... |
.... |
M |
SSIDn |
不定长 |
路由器 n 的 SSID |
M+1 |
结束符 |
1 |
路由器 n 的 SSID 结束符,固定值 0x00 |
M+2 |
信号强度 n |
1 |
路由器 n 网络的信号强度,范围 0~100,对应的实际值为 0%~100% |
M+3 |
结束符 |
2 |
信号强度 n 的结束符,0x0D,0x0A |
M+4 |
校验字 |
1 |
包头之后(不包括包头),校验字之前(不包括校验字)的所有字节的累加和 |
例子:
手机发送给模块(十六进制数):FF 00 01 01 02
模块返回给手机(十六进制数):FF 00 14 81 02 54 45 53 54 31 00 40 0D 0A
54 45 53 54 32 00 37 0D 0A 1F
解释:手机向模块发送查询指令,查询路由器相关信息。模块返回给手机的信息是:有 2 个路由器,路由器 1 的 SSID 为“TEST1”,信号强度为 64%;路由器 2 的 SSID 为“TEST2”,信号强度为 55%。
注:模块回复的路由器信息是根据信号强度排序过的。
b. 设置命令
序号 |
名称 |
字节数 |
说明 |
1 |
包头 |
1 |
固定值 0xFF |
2 |
长度 |
2 |
长度之后(不包括长度),校验字之前(不包括校验字)的所有字节数。 |
3 |
命令字 |
1 |
命令类型,0x02 为设置指令。 |
4 |
保留字 |
1 |
默认为 0x00 |
5 |
SSID |
不定长 |
路由器的 SSID。 |
6 |
分隔符 |
2 |
SSID 结束符,固定值 0x0D,0x0A |
7 |
密码 |
不定长 |
路由器的密码。 |
8 |
校验字 |
1 |
包头之后(不包括包头),校验字之前(不包括校验字)的所有字节的累加和。 |
回复指令
序号 |
名称 |
字节数 |
说明 |
1 |
包头 |
1 |
固定值 0xFF |
2 |
长度 |
2 |
长度之后(不包括长度),校验字之前(不包括校验字)的所有字节数。 |
3 |
命令字 |
1 |
命令类型,0x82 为设置指令对应的回复指令。 |
4 |
校验值 |
1 |
SSID 的校验结果,如果可以查到此 SSID 对应的网络值为 0x01,如果查不到,值为 0x00。 |
5 |
校验值 |
1 |
密码的校验结果,如果密码的格式正确值为 0x01,如果不正确,值为 0x00。 |
6 |
校验字 |
2 |
包头之后(不包括包头),校验字之前(不包括校验字)的所有字节的累加和。 |
例子:
手机发送给模块(十六进制数):FF 00 11 02 00 54 45 53 54 31 0D 0A 31 32 33 34 35 36 37 38 3F
模块返回给手机(十六进制数):FF 00 03 82 01 01 87
解释:手机向模块发送设置指令,设置 SSID 为“TEST1”,密码为“12345678”。模块返回给手机的信息是:存在 SSID 为“TEST1”的网络,密码格式正确。
3. 测试举例
配置C210连接路由ssid为“TEST1”,密码为“12345678”的路由:
a. C210默认为AP模式,电脑连接C210的wifi。
b. 打开USR-TCP232-Test串口与网络调试助手,网络设置 - 协议类型:UDP,
本地ip为电脑连接C210获取到的ip,本地端口自定义设置。
设置完点击连接。
设置目标主机为210模块自身lan口IP,默认为10.10.100.254,端口:48899
(C21X、C322系列模块端口:48899, USR-WIFI232-A2\B2端口号为49000 )
c. 按十六进制发送 “FF 00 01 01 02”,查询周围路由wifi。
d. 配置要连接的路由“TEST1”、密码为“12345678”按十六进制发送“FF 00 11 02 00 54 45 53 54 31 0D 0A 31 32 33 34 35 36 37 38 3F”
e. 查询模块是否配置并连接路由wifi.
打开ATSetup软件,正确打开串口,点击“+++a”返回OK进入AT命令模式。
AT+WSTA :查询STA模式下连接wifi的ssid与密
AT+WSLK :查询STA链接状态
AT+WANN :查询获取到的IP
AT+ENTM :退出AT指令模式