WiFi P2P

WiFi P2P（Wi-Fi Direct）实现设备间直连通信，无需 AP 中转。管理层发现（设备扫描/监听）、连接建立（GO/GC 角色协商）、设备信息交换和连接断开。

P2P 角色：GO（Group Owner，类似 SoftAP）和 GC（Group Client，类似 STA）。适用文件传输、设备配对等需直连的场景。

头文件清单

#include "include/middleware/services/wifi/wifi_p2p.h"
#include "include/middleware/services/wifi/wifi_p2p_config.h"

接口清单

接口名称功能简述

wifi_p2p_enable 开启P2P接口

wifi_p2p_disable 关闭P2P接口

wifi_p2p_is_enabled 获取P2P使能状态

wifi_p2p_find 触发P2P设备扫描搜索

wifi_p2p_stop_find 停止P2P设备扫描

wifi_p2p_connect_cancel 停止P2P设备连接

wifi_p2p_listen 设置P2P设备监听时间

wifi_p2p_get_peers_info 获取搜索到的P2P设备信息

wifi_p2p_connect P2P主动连接

wifi_p2p_connect_accept P2P接受或拒绝对端连接

wifi_p2p_disconnect P2P断连

wifi_p2p_go_get_gc_info GO获取已连接的GC信息

wifi_p2p_set_device_config 设置P2P设备信息

wifi_p2p_get_device_config 获取P2P设备信息

wifi_p2p_get_connect_info 获取P2P连接状态信息

Functions

wifi_p2p_enable

errcode_t wifi_p2p_enable(void)

头文件清单

#include "include/middleware/services/wifi/wifi_p2p.h"

功能说明

开启P2P接口，初始化P2P设备并创建P2P网络接口
P2P与SoftAP互斥，SoftAP已开启时无法使能P2P
P2P使能后默认设置为手动连接选择模式

前置条件

WiFi模块已初始化完成（wifi_is_wifi_inited()返回非0）
SoftAP未开启（SoftAP与P2P互斥）

返回值

返回类型：errcode_t

返回值文字含义触发场景

ERRCODE_SUCC(0x00) 执行成功 P2P接口开启成功

Other 其他错误码，参考[#enum_errcode_t] 执行失败

Kconfig配置

配置项宏类型说明默认值

CONFIG_P2P_SUPPORT 功能宏支持P2P接口功能 y

wifi_p2p_disable

errcode_t wifi_p2p_disable(void)

头文件清单

#include "include/middleware/services/wifi/wifi_p2p.h"

功能说明

关闭P2P接口，停止P2P设备并释放网络资源
GC模式下自动关闭DHCP，GO模式下自动关闭DHCPS
关闭后清空P2P接口名称

前置条件

WiFi模块已初始化完成
P2P已开启

返回值

返回类型：errcode_t

返回值文字含义触发场景

ERRCODE_SUCC(0x00) 执行成功 P2P接口关闭成功

Other 其他错误码，参考[#enum_errcode_t] 执行失败

Kconfig配置

配置项宏类型说明默认值

CONFIG_P2P_SUPPORT 功能宏支持P2P接口功能 y

wifi_p2p_is_enabled

int32_t wifi_p2p_is_enabled(void)

头文件清单

#include "include/middleware/services/wifi/wifi_p2p.h"

功能说明

获取P2P使能状态
用于查询P2P是否已初始化完成
返回值直接反映P2P全局使能标志

前置条件

WiFi模块已初始化完成

返回值

返回类型：int32_t

返回值文字含义触发场景

1 P2P已初始化 P2P已通过wifi_p2p_enable()成功开启

0 P2P未初始化 P2P未开启或已关闭

Kconfig配置

配置项宏类型说明默认值

CONFIG_P2P_SUPPORT 功能宏支持P2P接口功能 y

wifi_p2p_find

errcode_t wifi_p2p_find(int32_t sec)

头文件清单

#include "include/middleware/services/wifi/wifi_p2p.h"

功能说明

触发P2P设备扫描搜索，在指定时间内扫描周围P2P设备
当sec为0时，使用默认扫描时间120秒
扫描时间范围5~120秒，超出范围返回失败

前置条件

WiFi模块已初始化完成
P2P已开启

入参

名称参数类型详细说明约束取值范围

sec int32_t 扫描时间，单位秒 0：使用默认120秒；5~120：指定扫描时间

返回值

返回类型：errcode_t

返回值文字含义触发场景

ERRCODE_SUCC(0x00) 执行成功 P2P扫描启动成功

Other 其他错误码，参考[#enum_errcode_t] 执行失败

Kconfig配置

配置项宏类型说明默认值

CONFIG_P2P_SUPPORT 功能宏支持P2P接口功能 y

wifi_p2p_stop_find

errcode_t wifi_p2p_stop_find(void)

头文件清单

#include "include/middleware/services/wifi/wifi_p2p.h"

功能说明

停止P2P设备扫描
终止当前正在进行的P2P设备搜索过程
停止扫描后仍可获取已扫描到的设备信息

前置条件

WiFi模块已初始化完成
P2P已开启

返回值

返回类型：errcode_t

返回值文字含义触发场景

ERRCODE_SUCC(0x00) 执行成功 P2P扫描停止成功

Other 其他错误码，参考[#enum_errcode_t] 执行失败

Kconfig配置

配置项宏类型说明默认值

CONFIG_P2P_SUPPORT 功能宏支持P2P接口功能 y

wifi_p2p_connect_cancel

errcode_t wifi_p2p_connect_cancel(void)

头文件清单

#include "include/middleware/services/wifi/wifi_p2p.h"

功能说明

停止P2P设备连接，取消正在进行的P2P连接协商过程
取消连接不影响已建立的P2P组
连接取消后设备恢复到P2P_DEVICE_ONLY状态

前置条件

WiFi模块已初始化完成
P2P已开启

返回值

返回类型：errcode_t

返回值文字含义触发场景

ERRCODE_SUCC(0x00) 执行成功 P2P连接取消成功

Other 其他错误码，参考[#enum_errcode_t] 执行失败

Kconfig配置

配置项宏类型说明默认值

CONFIG_P2P_SUPPORT 功能宏支持P2P接口功能 y

wifi_p2p_listen

errcode_t wifi_p2p_listen(uint32_t period, uint32_t interval)

头文件清单

#include "include/middleware/services/wifi/wifi_p2p.h"

功能说明

设置P2P设备监听时间，使设备在指定周期内处于监听状态以响应探测请求
period表示监听持续时间，interval表示一个周期的总时间
period不能大于interval，两者不能同时为0且不能单独为0，取值范围0~65535

前置条件

WiFi模块已初始化完成
P2P已开启

入参

名称参数类型详细说明约束取值范围

period uint32_t 监听时间，单位毫秒 0~65535，不能大于interval

interval uint32_t 一个周期的总时间，单位毫秒 0~65535，不能小于period

返回值

返回类型：errcode_t

返回值文字含义触发场景

WIFI_SUCCESS(0x00) 执行成功 P2P监听设置成功

Other 其他错误码，参考[#enum_errcode_t] 执行失败

Kconfig配置

配置项宏类型说明默认值

CONFIG_P2P_SUPPORT 功能宏支持P2P接口功能 y

wifi_p2p_get_peers_info

errcode_t wifi_p2p_get_peers_info(p2p_device_stru *dev_list, uint32_t *dev_num)

头文件清单

#include "include/middleware/services/wifi/wifi_p2p.h"

功能说明

获取搜索到的P2P设备信息列表
返回支持WPS连接方式的设备，不支持WPS的设备不进行显示
dev_num为输入输出参数，输入时表示最大反馈设备数，输出时表示实际反馈设备数

前置条件

WiFi模块已初始化完成
P2P已开启
已执行过wifi_p2p_find()扫描

入参

名称参数类型详细说明约束取值范围

dev_list p2p_device_stru* 搜索到的P2P设备列表，出参载体非NULL，指向已申请的内存空间

dev_num uint32_t* 最大反馈与实际反馈的P2P设备数目非NULL，*dev_num不超过32

出参

名称数据类型输出说明

dev_list p2p_device_stru* 实际搜索到的P2P设备信息列表

dev_num uint32_t* 实际反馈的P2P设备数目

返回值

返回类型：errcode_t

返回值文字含义触发场景

ERRCODE_SUCC(0x00) 执行成功获取P2P设备信息成功

Other 其他错误码，参考[#enum_errcode_t] 执行失败

Kconfig配置

配置项宏类型说明默认值

CONFIG_P2P_SUPPORT 功能宏支持P2P接口功能 y

wifi_p2p_connect

errcode_t wifi_p2p_connect(const p2p_config_stru *p2p_config)

头文件清单

#include "include/middleware/services/wifi/wifi_p2p.h"

功能说明

P2P主动连接，根据当前P2P模式发起连接或邀请
GC/GO模式下发起邀请，DEVICE_ONLY模式下发起连接协商
连接时自动判断对端是否为GO设备，决定加入组或新建组

前置条件

WiFi模块已初始化完成
P2P已开启

入参

名称参数类型详细说明约束取值范围

p2p_config const p2p_config_stru* 待连接的P2P设备网络信息非NULL，go_intent范围0_{15，persistent范围0}1

返回值

返回类型：errcode_t

返回值文字含义触发场景

ERRCODE_SUCC(0x00) 执行成功 P2P连接发起成功

Other 其他错误码，参考[#enum_errcode_t] 执行失败

Kconfig配置

配置项宏类型说明默认值

CONFIG_P2P_SUPPORT 功能宏支持P2P接口功能 y

wifi_p2p_connect_accept

errcode_t wifi_p2p_connect_accept(const p2p_config_stru *p2p_config, int assoc)

头文件清单

#include "include/middleware/services/wifi/wifi_p2p.h"

功能说明

P2P接受或拒绝对端连接请求
assoc为1表示接受连接，0表示拒绝连接
调用前需校验WPS连接方式与当前配置是否匹配

前置条件

WiFi模块已初始化完成
P2P已开启
P2P当前处于DEVICE_ONLY模式

入参

名称参数类型详细说明约束取值范围

p2p_config const p2p_config_stru* 待连接的P2P设备网络信息非NULL，go_intent范围0_{15，persistent范围0}1

assoc int 接受或拒绝连接标志 0：拒绝连接；1：接受连接

返回值

返回类型：errcode_t

返回值文字含义触发场景

ERRCODE_SUCC(0x00) 执行成功 P2P连接接受/拒绝操作成功

Other 其他错误码，参考[#enum_errcode_t] 执行失败

Kconfig配置

配置项宏类型说明默认值

CONFIG_P2P_SUPPORT 功能宏支持P2P接口功能 y

wifi_p2p_disconnect

errcode_t wifi_p2p_disconnect(void)

头文件清单

#include "include/middleware/services/wifi/wifi_p2p.h"

功能说明

P2P断开连接，取消正在进行的连接协商并移除P2P组
同时执行取消连接和移除组操作
断连后设备恢复到P2P_DEVICE_ONLY状态

前置条件

WiFi模块已初始化完成
P2P已开启

返回值

返回类型：errcode_t

返回值文字含义触发场景

ERRCODE_SUCC(0x00) 执行成功 P2P断连成功

Other 其他错误码，参考[#enum_errcode_t] 执行失败

Kconfig配置

配置项宏类型说明默认值

CONFIG_P2P_SUPPORT 功能宏支持P2P接口功能 y

wifi_p2p_go_get_gc_info

errcode_t wifi_p2p_go_get_gc_info(p2p_client_info_stru *client_list, uint32_t *client_num)

头文件清单

#include "include/middleware/services/wifi/wifi_p2p.h"

功能说明

P2P GO获取已连接的GC（Client）信息列表
client_num为输入输出参数，输入时表示最大反馈GC数，输出时表示实际反馈GC数
最大支持查询4个GC信息

前置条件

WiFi模块已初始化完成
P2P已开启，且当前设备为GO模式

入参

名称参数类型详细说明约束取值范围

client_list p2p_client_info_stru* 反馈的GC信息列表非NULL，指向已申请的内存空间

client_num uint32_t* 最大反馈与实际反馈的GC数目非NULL，*client_num不超过4

出参

名称数据类型输出说明

client_list p2p_client_info_stru* 实际已连接的GC信息列表

client_num uint32_t* 实际反馈的GC数目

返回值

返回类型：errcode_t

返回值文字含义触发场景

ERRCODE_SUCC(0x00) 执行成功获取GC信息成功

Other 其他错误码，参考[#enum_errcode_t] 执行失败

Kconfig配置

配置项宏类型说明默认值

CONFIG_P2P_SUPPORT 功能宏支持P2P接口功能 y

wifi_p2p_set_device_config

errcode_t wifi_p2p_set_device_config(const p2p_device_config_stru *p2p_dev_set_info)

头文件清单

#include "include/middleware/services/wifi/wifi_p2p.h"

功能说明

设置P2P设备信息，包括设备名称、WPS连接方式、监听信道和工作信道
WPS连接方式仅支持PBC和PIN_DISPLAY两种模式
GO Intent使用默认值7

前置条件

WiFi模块已初始化完成
P2P已开启

入参

名称参数类型详细说明约束取值范围

p2p_dev_set_info const p2p_device_config_stru* P2P设置信息非NULL，wps_method仅支持WPS_PBC(0)或WPS_PIN_DISPLAY(1)

返回值

返回类型：errcode_t

返回值文字含义触发场景

ERRCODE_SUCC(0x00) 执行成功 P2P设备信息设置成功

Other 其他错误码，参考[#enum_errcode_t] 执行失败

Kconfig配置

配置项宏类型说明默认值

CONFIG_P2P_SUPPORT 功能宏支持P2P接口功能 y

wifi_p2p_get_device_config

errcode_t wifi_p2p_get_device_config(p2p_device_config_stru *p2p_dev_set_info)

头文件清单

#include "include/middleware/services/wifi/wifi_p2p.h"

功能说明

获取P2P设备信息，包括设备名称、WPS连接方式、监听信道和工作信道
返回当前P2P用户配置信息

前置条件

WiFi模块已初始化完成
P2P已开启

入参

名称参数类型详细说明约束取值范围

p2p_dev_set_info p2p_device_config_stru* P2P设置信息，出参载体非NULL

出参

名称数据类型输出说明

p2p_dev_set_info p2p_device_config_stru* 当前P2P设备配置信息

返回值

返回类型：errcode_t

返回值文字含义触发场景

ERRCODE_SUCC(0x00) 执行成功获取P2P设备信息成功

Other 其他错误码，参考[#enum_errcode_t] 执行失败

Kconfig配置

配置项宏类型说明默认值

CONFIG_P2P_SUPPORT 功能宏支持P2P接口功能 y

wifi_p2p_get_connect_info

errcode_t wifi_p2p_get_connect_info(p2p_status_info_stru *status)

头文件清单

#include "include/middleware/services/wifi/wifi_p2p.h"

功能说明

获取P2P连接状态信息，包括工作模式、关联状态、工作信道、Group SSID和Group BSSID
DEVICE_ONLY模式下仅返回mode信息
CONNECTED状态下operation_channel、group_ssid、group_bssid有效

前置条件

WiFi模块已初始化完成
P2P已开启

入参

名称参数类型详细说明约束取值范围

status p2p_status_info_stru* 待反馈的P2P连接状态信息非NULL

出参

名称数据类型输出说明

status p2p_status_info_stru* P2P连接状态信息，包括模式、关联状态、信道、Group SSID和Group BSSID

返回值

返回类型：errcode_t

返回值文字含义触发场景

ERRCODE_SUCC(0x00) 执行成功获取P2P连接状态成功

Other 其他错误码，参考[#enum_errcode_t] 执行失败

Kconfig配置

配置项宏类型说明默认值

CONFIG_P2P_SUPPORT 功能宏支持P2P接口功能 y

Enumerations

wps_method_enum

typedef enum {
    WPS_PBC,           /*!< PBC方式连接。  */
    WPS_PIN_DISPLAY,   /*!< PIN DISPLAY方式连接,92不支持。  */
    WPS_PIN_KEYPAD,    /*!< PIN KEYPAD方式连接,92不支持。  */
    WPS_PIN_LABEL,     /*!< PIN LABEL方式连接,92不支持。  */
    WPS_OTHER,         /*!< 其他方式连接,92不支持。  */
} wps_method_enum;

枚举成员取值描述

WPS_PBC 0 PBC方式连接

WPS_PIN_DISPLAY 1 PIN DISPLAY方式连接,92不支持

WPS_PIN_KEYPAD 2 PIN KEYPAD方式连接,92不支持

WPS_PIN_LABEL 3 PIN LABEL方式连接,92不支持

WPS_OTHER 4 其他方式连接,92不支持

p2p_mode_enum

typedef enum {
    P2P_MODE_GC,             /*!< P2P GC模式。  */
    P2P_MODE_GO,             /*!< P2P GO模式。  */
    P2P_MODE_DEVICE_ONLY,    /*!< P2P未协商GO。  */
    P2P_MODE_BUTT,
} p2p_mode_enum;

枚举成员取值描述

P2P_MODE_GC 0 P2P GC模式

P2P_MODE_GO 1 P2P GO模式

P2P_MODE_DEVICE_ONLY 2 P2P未协商GO

P2P_MODE_BUTT 3 枚举边界值

p2p_conn_state_enum

typedef enum {
    P2P_DISCONNECTED,   /*!< 断连。  */
    P2P_CONNECTED,      /*!< 已连接。  */
    P2P_CONNECTING,     /*!< 连接中。  */
    P2P_CONN_STATUS_BUTT,
} p2p_conn_state_enum;

枚举成员取值描述

P2P_DISCONNECTED 0 断连

P2P_CONNECTED 1 已连接

P2P_CONNECTING 2 连接中

P2P_CONN_STATUS_BUTT 3 枚举边界值

Structures

wfd_info_stru

typedef struct wfd_info_stru {
    int16_t device_info;    /*!< WFD设备类型。  */
    int16_t ctrl_port;      /*!< 控制端口号。  */
    int16_t max_throughput; /*!< 最大吞吐量。  */
    int8_t reserved[2];
} wfd_info_stru;

成员说明：

成员名称数据类型描述

device_info int16_t WFD设备类型

ctrl_port int16_t 控制端口号

max_throughput int16_t 最大吞吐量

reserved int8_t[2] 保留字段

p2p_device_stru

typedef struct p2p_device_stru {
    int8_t name[WPS_DEV_NAME_LEN];  /*!< 设备device名称。  */
    uint8_t bssid[WIFI_MAC_LEN];    /*!< 设备device MAC地址。  */
    uint8_t wps_method;             /*!< 支持的WPS连接方式，
                                                  - bit0表示PBC
                                                  - bit1表示PIN LABEL
                                                  - bit2表示PIN DISPLAY
                                                  - bit3表示PIN KEYPAD
                                                  - bit4表示其他方式。  */
    uint8_t is_go           : 1;    /*!< 扫描出来的设备是否是p2p go。  */
    uint8_t enable_add_group : 1;   /*!< 扫描出的go对应的group，是否允许添加gc。  */
    uint8_t reserved       : 6;
    int8_t reserved1[3];
    wfd_info_stru wfd_info;         /*!< 暂不使用。  */
} p2p_device_stru;

成员说明：

成员名称数据类型描述

name int8_t[33] 设备名称，最大长度33字节

bssid uint8_t[6] 设备MAC地址

wps_method uint8_t 支持的WPS连接方式位图：bit0-PBC，bit1-PIN LABEL，bit2-PIN DISPLAY，bit3-PIN KEYPAD，bit4-其他方式

is_go uint8_t:1 位域，扫描到的设备是否为P2P GO

enable_add_group uint8_t:1 位域，GO对应的group是否允许添加GC

reserved uint8_t:6 位域，保留

reserved1 int8_t[3] 保留字段

wfd_info wfd_info_stru WFD信息，暂不使用

p2p_config_stru

typedef struct p2p_config_stru {
    uint8_t bssid[WIFI_MAC_LEN];           /*!< peer的device MAC地址。  */
    int8_t pin[WIFI_WPS_PIN_MAX_LEN_NUM];  /*!< WPS的Pin码。  */
    uint8_t wps_method;                    /*!< WPS的连接方式。  */
    uint8_t go_intent;                     /*!< go intent，有效范围0~15。  */
    uint8_t persistent;                    /*!< 1:按照永久网络存储;0:不按照永久网络存储。  */
    int8_t reserved[2];
} p2p_config_stru;

成员说明：

成员名称数据类型描述

bssid uint8_t[6] 对端设备的MAC地址

pin int8_t[9] WPS的PIN码，最大长度9字节（含'\0'）

wps_method uint8_t WPS连接方式，参考wps_method_enum

go_intent uint8_t GO意图值，有效范围0~15

persistent uint8_t 永久网络存储标志：1-按永久网络存储，0-不按永久网络存储

reserved int8_t[2] 保留字段

p2p_status_info_stru

typedef struct p2p_status_info_stru {
    int32_t operation_channel;            /*!< GO/GC连接之后工作信道的中心频点，在wpa_state为CONNECTED时有效。  */
    uint8_t mode;                         /*!< P2P模式, 和P2pMode对应。  */
    uint8_t wpa_state;                    /*!< p2p关联状态，和P2pConnState对应.。  */
    int8_t group_ssid[WPS_DEV_NAME_LEN];  /*!< Group SSID，并且P2P的WPS关联成功（当前阶段组协商成功）时有效。  */
    uint8_t group_bssid[WIFI_MAC_LEN];    /*!< Group BSSID==go bssid，在wpa_state为CONNECTED，
                                                        并且P2P的WPS关联成功（当前阶段组协商成功）时有效。  */
    int8_t reserved[3];
} p2p_status_info_stru;

成员说明：

成员名称数据类型描述

operation_channel int32_t GO/GC连接后工作信道的中心频点，wpa_state为CONNECTED时有效

mode uint8_t P2P模式，参考p2p_mode_enum

wpa_state uint8_t P2P关联状态，参考p2p_conn_state_enum

group_ssid int8_t[33] Group SSID，wpa_state为CONNECTED且P2P WPS关联成功时有效

group_bssid uint8_t[6] Group BSSID（等于GO BSSID），wpa_state为CONNECTED且P2P WPS关联成功时有效

reserved int8_t[3] 保留字段

p2p_client_info_stru

typedef struct p2p_client_info_stru {
    uint8_t gc_bssid[WIFI_MAC_LEN];           /*!< 与go相连的client mac地址。  */
    uint8_t gc_device_bssid[WIFI_MAC_LEN];    /*!< 与go相连的client dev地址。  */
    int8_t gc_device_name[WPS_DEV_NAME_LEN];  /*!< client 设备名称。  */
    int8_t reserved[3];
} p2p_client_info_stru;

成员说明：

成员名称数据类型描述

gc_bssid uint8_t[6] 与GO相连的Client MAC地址

gc_device_bssid uint8_t[6] 与GO相连的Client设备地址

gc_device_name int8_t[33] Client设备名称，最大长度33字节

reserved int8_t[3] 保留字段

p2p_device_config_stru

typedef struct {
    int8_t dev_name[WPS_DEV_NAME_LEN];      /*!< 设备名称。  */
    uint8_t wps_method;                     /*!< 支持的WPS连接方式，可选项为WpsMethod,仅支持配置0/1/2/3。  */
    int32_t listen_channel;                 /*!< 回复probe response的信道。  */
    int32_t oper_channel;                   /*!< 建议的工作信道：0表示随机信道；非0有效值表示建议的信道。  */
} p2p_device_config_stru;

成员说明：

成员名称数据类型描述

dev_name int8_t[33] 设备名称，最大长度33字节

wps_method uint8_t WPS连接方式，参考wps_method_enum，仅支持配置0/½/3

listen_channel int32_t 回复probe response的信道

oper_channel int32_t 建议的工作信道：0表示随机信道，非0有效值表示建议的信道

接口名称	功能简述
wifi_p2p_enable	开启P2P接口
wifi_p2p_disable	关闭P2P接口
wifi_p2p_is_enabled	获取P2P使能状态
wifi_p2p_find	触发P2P设备扫描搜索
wifi_p2p_stop_find	停止P2P设备扫描
wifi_p2p_connect_cancel	停止P2P设备连接
wifi_p2p_listen	设置P2P设备监听时间
wifi_p2p_get_peers_info	获取搜索到的P2P设备信息
wifi_p2p_connect	P2P主动连接
wifi_p2p_connect_accept	P2P接受或拒绝对端连接
wifi_p2p_disconnect	P2P断连
wifi_p2p_go_get_gc_info	GO获取已连接的GC信息
wifi_p2p_set_device_config	设置P2P设备信息
wifi_p2p_get_device_config	获取P2P设备信息
wifi_p2p_get_connect_info	获取P2P连接状态信息

返回值	文字含义	触发场景
ERRCODE_SUCC(0x00)	执行成功	P2P接口开启成功
Other	其他错误码，参考[#enum_errcode_t]	执行失败

返回值	文字含义	触发场景
ERRCODE_SUCC(0x00)	执行成功	P2P接口关闭成功
Other	其他错误码，参考[#enum_errcode_t]	执行失败

返回值	文字含义	触发场景
1	P2P已初始化	P2P已通过wifi_p2p_enable()成功开启
0	P2P未初始化	P2P未开启或已关闭

返回值	文字含义	触发场景
ERRCODE_SUCC(0x00)	执行成功	P2P扫描启动成功
Other	其他错误码，参考[#enum_errcode_t]	执行失败

返回值	文字含义	触发场景
ERRCODE_SUCC(0x00)	执行成功	P2P扫描停止成功
Other	其他错误码，参考[#enum_errcode_t]	执行失败

返回值	文字含义	触发场景
ERRCODE_SUCC(0x00)	执行成功	P2P连接取消成功
Other	其他错误码，参考[#enum_errcode_t]	执行失败

名称	参数类型	详细说明	约束取值范围
period	uint32_t	监听时间，单位毫秒	0~65535，不能大于interval
interval	uint32_t	一个周期的总时间，单位毫秒	0~65535，不能小于period

返回值	文字含义	触发场景
WIFI_SUCCESS(0x00)	执行成功	P2P监听设置成功
Other	其他错误码，参考[#enum_errcode_t]	执行失败

名称	参数类型	详细说明	约束取值范围
dev_list	p2p_device_stru*	搜索到的P2P设备列表，出参载体	非NULL，指向已申请的内存空间
dev_num	uint32_t*	最大反馈与实际反馈的P2P设备数目	非NULL，*dev_num不超过32

名称	数据类型	输出说明
dev_list	p2p_device_stru*	实际搜索到的P2P设备信息列表
dev_num	uint32_t*	实际反馈的P2P设备数目

返回值	文字含义	触发场景
ERRCODE_SUCC(0x00)	执行成功	获取P2P设备信息成功
Other	其他错误码，参考[#enum_errcode_t]	执行失败

返回值	文字含义	触发场景
ERRCODE_SUCC(0x00)	执行成功	P2P连接发起成功
Other	其他错误码，参考[#enum_errcode_t]	执行失败

名称	参数类型	详细说明	约束取值范围
p2p_config	const p2p_config_stru*	待连接的P2P设备网络信息	非NULL，go_intent范围0_{15，persistent范围0}1
assoc	int	接受或拒绝连接标志	0：拒绝连接；1：接受连接

返回值	文字含义	触发场景
ERRCODE_SUCC(0x00)	执行成功	P2P连接接受/拒绝操作成功
Other	其他错误码，参考[#enum_errcode_t]	执行失败

返回值	文字含义	触发场景
ERRCODE_SUCC(0x00)	执行成功	P2P断连成功
Other	其他错误码，参考[#enum_errcode_t]	执行失败

名称	参数类型	详细说明	约束取值范围
client_list	p2p_client_info_stru*	反馈的GC信息列表	非NULL，指向已申请的内存空间
client_num	uint32_t*	最大反馈与实际反馈的GC数目	非NULL，*client_num不超过4

名称	数据类型	输出说明
client_list	p2p_client_info_stru*	实际已连接的GC信息列表
client_num	uint32_t*	实际反馈的GC数目

返回值	文字含义	触发场景
ERRCODE_SUCC(0x00)	执行成功	获取GC信息成功
Other	其他错误码，参考[#enum_errcode_t]	执行失败

返回值	文字含义	触发场景
ERRCODE_SUCC(0x00)	执行成功	P2P设备信息设置成功
Other	其他错误码，参考[#enum_errcode_t]	执行失败

返回值	文字含义	触发场景
ERRCODE_SUCC(0x00)	执行成功	获取P2P连接状态成功
Other	其他错误码，参考[#enum_errcode_t]	执行失败

枚举成员	取值	描述
WPS_PBC	0	PBC方式连接
WPS_PIN_DISPLAY	1	PIN DISPLAY方式连接,92不支持
WPS_PIN_KEYPAD	2	PIN KEYPAD方式连接,92不支持
WPS_PIN_LABEL	3	PIN LABEL方式连接,92不支持
WPS_OTHER	4	其他方式连接,92不支持

枚举成员	取值	描述
P2P_MODE_GC	0	P2P GC模式
P2P_MODE_GO	1	P2P GO模式
P2P_MODE_DEVICE_ONLY	2	P2P未协商GO
P2P_MODE_BUTT	3	枚举边界值

枚举成员	取值	描述
P2P_DISCONNECTED	0	断连
P2P_CONNECTED	1	已连接
P2P_CONNECTING	2	连接中
P2P_CONN_STATUS_BUTT	3	枚举边界值

成员名称	数据类型	描述
device_info	int16_t	WFD设备类型
ctrl_port	int16_t	控制端口号
max_throughput	int16_t	最大吞吐量
reserved	int8_t[2]	保留字段

成员名称	数据类型	描述
name	int8_t[33]	设备名称，最大长度33字节
bssid	uint8_t[6]	设备MAC地址
wps_method	uint8_t	支持的WPS连接方式位图：bit0-PBC，bit1-PIN LABEL，bit2-PIN DISPLAY，bit3-PIN KEYPAD，bit4-其他方式
is_go	uint8_t:1	位域，扫描到的设备是否为P2P GO
enable_add_group	uint8_t:1	位域，GO对应的group是否允许添加GC
reserved	uint8_t:6	位域，保留
reserved1	int8_t[3]	保留字段
wfd_info	wfd_info_stru	WFD信息，暂不使用

成员名称	数据类型	描述
bssid	uint8_t[6]	对端设备的MAC地址
pin	int8_t[9]	WPS的PIN码，最大长度9字节（含'\0'）
wps_method	uint8_t	WPS连接方式，参考wps_method_enum
go_intent	uint8_t	GO意图值，有效范围0~15
persistent	uint8_t	永久网络存储标志：1-按永久网络存储，0-不按永久网络存储
reserved	int8_t[2]	保留字段

成员名称	数据类型	描述
operation_channel	int32_t	GO/GC连接后工作信道的中心频点，wpa_state为CONNECTED时有效
mode	uint8_t	P2P模式，参考p2p_mode_enum
wpa_state	uint8_t	P2P关联状态，参考p2p_conn_state_enum
group_ssid	int8_t[33]	Group SSID，wpa_state为CONNECTED且P2P WPS关联成功时有效
group_bssid	uint8_t[6]	Group BSSID（等于GO BSSID），wpa_state为CONNECTED且P2P WPS关联成功时有效
reserved	int8_t[3]	保留字段

成员名称	数据类型	描述
gc_bssid	uint8_t[6]	与GO相连的Client MAC地址
gc_device_bssid	uint8_t[6]	与GO相连的Client设备地址
gc_device_name	int8_t[33]	Client设备名称，最大长度33字节
reserved	int8_t[3]	保留字段

成员名称	数据类型	描述
dev_name	int8_t[33]	设备名称，最大长度33字节
wps_method	uint8_t	WPS连接方式，参考wps_method_enum，仅支持配置0/½/3
listen_channel	int32_t	回复probe response的信道
oper_channel	int32_t	建议的工作信道：0表示随机信道，非0有效值表示建议的信道