USR-C210快速联网协议基本测试-济南通博TBET物联网技术有限公司官网

通博TBET

USR-C210 快速联网协议基本测试

2020-01-16

1、需要下载的软件

USR-WIFI232-Setup-AT指令设置软件：http://www.ybljg.com/Download/91.html

USR-TCP232-Test 串口网络二合一调试工具：

http://www.ybljg.com/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	包头之后（不包括包头），校验字之前（不包括校验字）的所有字节的累加和。