P2P AT 命令集

备注

P2P AT 命令集默认未启用。
参考配置工程（menuconfig）进入 CONFIG SHELL 配置，勾选 Enable P2P 来启用 P2P AT 命令集。

AT+WLP2PSTART

功能说明

初始化并启动 P2P 设备

命令格式

AT+WLP2PSTART=[<type>,<value>,<type>,<value>……]

响应格式

成功响应：

OK

错误响应： error_no 定义请参考 Wi-Fi AT 错误码。

ERROR: <error_no>

参数

<type>:

参数类型，后跟对应 <value>

listen_ch：后跟监听信道
op_ch：后跟操作信道
ssid_postfix：后跟 SSID 后缀字符串

<value>:

对应 <type> 的具体参数

<listen_ch>:

监听信道

应该是 2.4GHz 频段的 1、6、11 信道

<op_ch>:

操作信道

设备支持且受法规约束的任意允许 Wi‑Fi 运行的信道（2.4/5GHz）

<ssid_postfix>:

SSID 后缀字符串，默认是"-REALTEKDEV"

备注

如果不带 listen_ch 或 op_ch 参数，监听信道和操作信道从 ch 1,6,11 中随机选择。

AT+WLP2PSTOP

功能说明

停止 P2P 模式

命令格式

AT+WLP2PSTOP

响应格式

成功响应：

OK

错误响应： error_no 定义请参考 Wi-Fi AT 错误码。

ERROR: <error_no>

AT+WLP2PCONN

功能说明

P2P 设备连接，包括 GO 协商、群组组建和连线。

命令格式

AT+WLCONN=[<type>,<value>,<type>,<value>……]

响应格式

成功响应：

OK

错误响应： error_no 定义请参考 Wi-Fi AT 错误码。

ERROR: <error_no>

参数

<type>:

参数类型，后跟对应 <value>

peer：后跟对端 P2P 设备的 MAC 地址
pbc：后面不用跟对应<value>
pin_display：后面不用跟对应<value>
pin_keypad：后跟 8 位 PIN 码
go_intent：后跟成为 GO 的意愿值

<value>:

对应 <type> 的具体参数

<peer>:

对端 P2P 设备的 MAC 地址

格式：冒号分隔十六进制（例如：1a:2b:3c:4d:5e:6f）

<pin_keypad>:

PIN 码

8 位数字 PIN 码（例如：12345678）

<go_intent>:

成为 GO 的意愿值

有效范围：[0，15]。若不带 go_intent 参数，会随机生成 go_intent 值；若 go_intent=15，则此设备会固定成为 GO.

AT 消息

连线成功，GO 会显示：

[$]client connected:<client_mac_addr>
[$]assign client ip:<ip_addr>

连线成功，GC 会显示：

[$]wifi connected
[$]wifi got ip:<ip_addr>

AT+WLP2PDISCONN

功能说明

断线并删除 group

命令格式

AT+WLP2PDISCONN

响应格式

成功响应：

OK

错误响应： error_no 定义请参考 Wi-Fi AT 错误码。

ERROR: <error_no>

AT+WLP2PFIND

功能说明

P2P 设备发现

命令格式

AT+WLP2PFIND=[<timeout_sec>]

响应格式

成功响应：

OK

错误响应： error_no 定义请参考 Wi-Fi AT 错误码。

ERROR: <error_no>

参数

<timeout_sec>:: 设备发现的超时时间，单位为秒。如不设置，默认 30s.

AT 消息

当扫描到一个 P2P 设备，会显示这台设备的基本信息，包括 P2P Device Address, P2P 角色（GC,GO or DEVICE）, name 和 listen channel, 举例如下：
```
P2P-DEVICE-SCANNED 00:e0:4c:00:14:2d role=DEVICE name=DIRECT- listen_ch=6
```
当设备发现阶段结束，会提示如下消息：
```
P2P-FIND-STOPPED
```

AT+WLP2PPEERS

功能说明

显示已发现的 P2P 设备

命令格式

AT+WLP2PPEERS

响应格式

成功响应：

OK

参数

无

AT 消息

显示所有已发现设备的信息，包括 P2P Device Address, P2P 角色（GC,GO or DEVICE）, 和 listen channel, 举例如下：
```
Found p2p peers:
[0]:00:e0:4c:00:14:2d, P2P_DEV, listen_ch 6
[1]:00:e0:4c:00:14:2f, P2P_DEV, listen_ch 11
```

AT+WLP2PGO

功能说明

启动 auto GO

命令格式

AT+WLP2PGO=[<type>,<value>,<type>,<value>……]

响应格式

成功响应：

OK

错误响应： error_no 定义请参考 Wi-Fi AT 错误码。

ERROR: <error_no>

参数

<type>:

参数类型，后跟对应 <value>

ssid：后跟 SSID 名称
pw：后跟连接密码
ch：后跟操作信道

<value>:

对应 <type> 的具体参数

<ssid>:

SSID 名称

最大长度：32 字符。每个 SSID 都应以 ASCII 字符 “DIRECT-” 开头。在 “DIRECT-” 之后，SSID 应包含两个 ASCII 字符“xy”，这两个字符可以是大写字母、小写字母或数字。

<pw>:

连接密码

<ch>:

操作信道

备注

这个命令使得设备不通过 GO 协商，自己直接当 GO 并启动一个 P2P Group。当有 P2P 设备想要连接这个 GO，需要先发送 Provision Discovery Request 帧，GO 会回复 Provision Discovery Response 帧并准备开始 WPS 认证。