Wi-Fi Direct 真机实践:固定 GO、授权加入与稳定性排查

摘要:结合 X86 与 RK3568 真机实践,说明为何选择固定 GO 与动态 Group、宿主机脚本如何配合普通容器进程,以及 wpa_ctrl、wpa_cli 与长期稳定性测试的工程取舍。

在这里插入图片描述

[TOC]

Wi-Fi Direct(Wi-Fi Peer-to-Peer,P2P)让两台 Wi-Fi 设备不依赖现有无线路由器,直接组成无线网络。其中 Group Owner(GO)负责维护类似 AP 的 Group,P2P Client 加入这个 Group。Linux 上通常由 wpa_supplicant 负责发现、无线组网和安全连接;Group 建立后,业务仍通过普通 IP/TCP/UDP Socket 通信。

对于角色固定的两台设备,更推荐“GO 先建组并开放 WPS 授权,Client 发现后加入”,而不是每次都重新协商谁当 GO。 这一选择减少了需要双方配合的协商环节,但不意味着省略无线发现、WPS、关联或 WPA2 安全握手,也不意味着稳定性问题会自动消失。真正费时间的往往是操作系统、驱动、权限、时序和异常恢复的配合。

1. 实际部署:驱动在宿主机,控制程序在 Docker

这次实践的两端是 Linux X86 和 RK3568:X86 固定承担 GO,RK3568 作为 Client。两台机器各有自己的 Wi-Fi 设备、Linux 宿主机和 Docker 容器;容器中运行的是普通用户进程,不是拥有完整宿主机管理权限的特权进程。

环境项 X86 / GO 端 RK3568 / Client 端
硬件与架构 Intel Core i5-8500 / x86_64 RK3568 / aarch64
Wi-Fi 设备 对应 Linux Wi-Fi 网卡及驱动 测试使用 AIC8800 无线模组及驱动
宿主机发行版 Ubuntu 22.04.2 LTS(Jammy) Ubuntu 20.04.6 LTS(Focal)
宿主机内核 uname -r 5.15.0-67-generic 5.10.198
宿主机 wpa_supplicant -v v2.10 v2.9
Docker 用户态发行版 Ubuntu 16.04.7 LTS(Xenial) Ubuntu 16.04.7 LTS(Xenial)
Docker 内 uname -r 5.15.0-67-generic 5.10.198
Docker 内 wpa_supplicant -v v2.4 v2.4
Docker Engine(宿主机) 23.0.1 28.1.1
P2P 角色 固定 GO 加入已有 GO

2. 为什么不优先用 GO Negotiation

在需要动态决定 GO/Client 的场景中,双方可以发现彼此后通过 GO Negotiation 协商角色与工作信道。其核心管理帧是 GO Negotiation Request、Response、Confirm,共三类顺序消息;某些流程前面还会进行 Provision Discovery。随后仍要经历 WPS provisioning、802.11 关联和 WPA/RSN 安全连接。

这里容易把不同的“四次”混在一起:GO Negotiation 本身不是固定四帧握手;WPA2 的 4-Way Handshake 则是后续的 EAPOL-Key M1~M4 安全握手。现场看到“发现、授权/发现配对方式、协商、认证”等多轮交互,不应把它们全算成同一种协议报文。工程上的担忧仍然成立:每增加一次异步的无线交互,就多了一处可能等待、超时、重试或因两端状态不一致而失败的位置。

方案 建组路径 主要代价 适用条件
每次 GO 协商 双端发现 → 发起/响应 GO Negotiation → WPS/安全建链 要协调发起方、角色和协商结果;交互阶段更多 两端角色确实需要动态决定
固定 GO + 授权加入 GO 建组 → WPS_PBC → Client 发现并 join → WPS/安全建链 仍依赖 GO 和授权窗口就绪,仍可能发生握手失败 固定设备配对、角色可预先约定

固定 GO 的最小操作关系如下。命令是 wpa_cli 的控制语义示例,运行时应使用真实接口和 P2P Device MAC,而非照抄示例接口编号。

1
2
3
4
5
6
7
8
9
10
sequenceDiagram
participant GO as X86 / GO
participant CL as RK3568 / Client
GO->>GO: P2P_GROUP_ADD
GO->>GO: 等待实际 Group 接口和控制 Socket
GO->>GO: Group 控制接口 WPS_PBC
CL->>CL: P2P_FIND / 查询 GO 信息
CL->>CL: P2P_CONNECT GO_DEVICE_MAC pbc join
Note over GO,CL: 双向 WPS、802.11 关联及 WPA2 安全握手
Note over GO,CL: 两端分别等待 Group IPv4,再检查双向连通性

GO 先 P2P_GROUP_ADD 创建组,再在该组的控制接口启用 WPS_PBC;Client 使用 P2P_CONNECT ... pbc join 加入已有组。不要与 P2P_CONNECT ... pbc auth 混淆:后者只是为对端发起 GO Negotiation 做被动授权,并没有绕过协商。

固定 GO 减少的是“再次决定谁做 GO”这一阶段。它在这类固定角色设备上更容易组织启动与恢复,也有减少建链时延和失败分支的合理预期;但在没有同平台对比测量前,不能宣称已经量化降低了多少毫秒或将失败率降到多少。

3. 两端需要同步的其实是两件事

第一件是建链动作的时间窗口。GO 要先创建 Group,生成能被发现的 SSID/BSSID,并开放 WPS-PBC 授权;Client 必须在可发现、可授权的窗口里完成 Join。双端同时点击“连接”不等于同时准备就绪:GO 的动态接口、Group Socket、WPS 授权以及 Client 的扫描结果,都可能先后到达。更稳妥的顺序是 GO 准备好 → Client 等待并发现 GO → Join → 两端确认链路/IP。必要的重试应限制在本次连接预算内,避免一端超时后另一端仍继续建立过期连接。

第二件是系统时间同步。跨两台设备分析 WPA、驱动、空口和 Ping 日志时,墙上时钟不一致会使报文先后关系看起来颠倒。若有独立管理网络,可使用 NTP/chrony 对齐两端时间,再结合本端单调时钟记录超时与耗时。例如在两端查看 timedatectl status,安装 chrony 的环境还可查看 chronyc tracking。时钟对齐有助于诊断,却不是 Wi-Fi Direct 必须在同一时刻发起命令的协议条件;真正决定成败的是双方状态与授权窗口重叠。

4. 为什么这套 WPA 部署使用动态 Group

实际落地时还遇到一个不能靠 GO Intent 解决的限制:当前使用的 WPA 代码版本、配置与无线驱动组合,未能按项目预期提供预先固定、长期复用的静态 Group。 因而采用每轮按需 P2P_GROUP_ADD 的方式创建 GO,再使用 WPA 给出的实际动态接口名让 Client 加入。这属于当前设备与软件组合下的工程选择,并不是 Wi-Fi Direct 协议禁止静态 Group。

这里应结合上表区分具体版本:X86 宿主机查询到 wpa_supplicant v2.10,RK3568 宿主机为 v2.9;容器中的 v2.4 是容器自带同名程序,不应误当作宿主机实际建组所依赖的 WPA 版本。wpa_supplicant -v 本身也不足以证明“v2.9/v2.10 普遍无法使用 Persistent Group”。现场采用动态 Group 的事实已确定,但究竟是 WPA 版本能力、配置还是驱动接口导致期望的静态 Group 路径不可用,仍需对应操作的原始返回、事件和驱动日志才能进一步归因。

容易混在一起的其实是四件事:

概念 实际含义 本次选择
固定 GO 角色 X86 事先决定做 Group Owner,不再让两台设备每轮协商角色 固定
静态 Group 希望组本身长期预置/保持,不经历每次按需创建的生命周期 当前版本组合未能按要求落地
Persistent Group WPA 保存或复用组配置/凭据;persistent=<id> 是重用已有网络配置的协议栈功能 不能简单等同于常驻静态 Group 或固定接口名
动态 Group 网络接口 WPA 建组时创建 p2p-wlan0-N,断组后可能消失,再建组时 N 未必相同 实际采用

因此,P2P_GROUP_ADD 已经固定了 GO 角色,却没有固定接口名称、控制 Socket 的出现时间或 IP 配置完成时间。第一次可能得到 p2p-wlan0-0,下一轮也可能不是;把 p2p-wlan0-0 写死在应用、权限配置或 Ping 命令里,前几轮或许能工作,一次异常断开或残留接口便会暴露问题。与此相反,P2P_GROUP_ADD persistent=<id> 的“持久”是保存/重用 Group 信息,不能用来证明组接口必然长期存在或名称恒定。

这也解释了动态 Group 为什么需要 三方配合:

  1. wpa_supplicant 负责创建真正的 Group,并通过 P2P-GROUP-STARTED 告知实际接口名称和角色;GO 侧还要在这个新 Group 的控制 Socket上开启 WPS_PBC。
  2. udev 在内核新接口出现时启动一次宿主机后处理,修正这个动态 Socket的用户组权限,并在 Client 侧处理省电策略。
  3. systemd-networkd 以 p2p-wlan0-* 匹配新接口,为 X86/RK3568 分配各自预定的 IPv4;控制程序必须等待真实 IP 出现后才能宣称本机就绪。

组是动态创建的,组网角色和预期 IP 可以是固定的。 真正需要做动态适配的是接口生命周期、权限、异步状态和错误恢复,而不是让业务层每次重新选择 GO。对这一模式最值得回看的是已有源码系列中的 Group Runtime 与 Group Teardown。

5. 为什么需要这些宿主机脚本

既然应用在 Docker 的普通用户进程中运行,初始化无线设备、管理系统服务、给动态接口设置 IP 和修复 Socket 权限,就不能简单地留给应用进程。为此,实践中将一次性的宿主机准备、开机初始化、Group 出现后的处理拆开。

以下六个部署脚本及其配套配置已经整理成一个可独立阅读的公开脱敏示例目录:宿主机脚本与安装边界。正文只说明用途与缺失后果;各脚本可以点击相对路径查看完整内容。公开示例保留处理机制,但不包含现场账户、私有路径与原容器 Entrypoint 自动注入逻辑,因此不是可在任意设备直接执行的生产安装包。

脚本 主要职责,以及为什么要放在这一层 没有它时可能出现的情况
setup_networkmanager.sh 在宿主机使指定 Wi-Fi 物理接口和 P2P 接口不受 NetworkManager 管理,但保留有线网的管理职责 NM 可能抢占或重配 WLAN/P2P,表现为建组被打断、地址丢失;也可人工做等效配置
install_wfd_host.sh 按 X86/RK3568 角色集中安装 WPA 初始化、networkd、udev、systemd 配置;容器 preinit 钩子需由部署方另行配置 不是无线协议必需脚本,但手工部署容易漏掉权限、角色地址或开机启动依赖
setup_wpa.sh 复用宿主机已有 WPA 守护进程,注册/核对无线控制接口,设置控制 Socket 权限、基础省电状态与诊断配置 WPA 服务可能存在,但容器普通用户连不上控制 Socket;接口未注册时甚至无法发出 P2P 命令
wpa_debug.sh 调整并回读既有 WPA 的日志等级,便于分析发现、WPS 和握手失败;不会启动第二个守护进程 正常连接未必受影响,但现场失败时缺少足够日志,容易把控制权限问题误判成驱动故障
setup_wfd_tmp.sh 在容器的启动前置阶段,校验或兼容建立宿主机 /tmp 与容器 /tmp 的共享关系 若双方 /tmp 相互隔离,部分 wpa_ctrl 客户端回复 Socket 无法被宿主机 WPA 访问,出现控制命令超时;若创建容器时已正确挂载则无需重复 bind
configure_p2p_group.sh 由宿主机在动态 Group 出现后执行:先给 Group 控制 Socket 设置普通用户可访问的组权限,再等状态完成,并对 Client 组接口处理省电配置 GO 可能已经建组,却因 Group Socket 权限不足无法执行 WPS_PBC;Client 侧省电状态也可能影响时延与收发稳定性

这些脚本还需要系统配置一起工作。wfd-host-init.service 在宿主机开机时触发 WPA 初始化;udev 规则 + wfd-p2p-group@.service 在 p2p-wlan0-N 动态出现时调用 Group 处理脚本;两端的 systemd-networkd X86 / RK3568 .network 文件按接口名设置不同、同网段的静态 IPv4。动态 Group 由 WPA 创建,不是由 networkd 创建。Group 控制 Socket 的权限处理与 networkd 地址配置都是对新接口的异步响应,没有固定的执行先后顺序。

另有 WPA 配置文件 负责控制接口目录、WPS 设备信息等初始参数。注意:当宿主机 WPA 已经注册无线接口时,更新磁盘配置文件不代表运行中的接口已经重新加载配置。历史的 Docker /tmp watcher 服务属于兼容路径,不应与容器启动钩子同时重复挂载。

这个部署里的 /tmp 读写共享也会扩大容器可见的宿主机临时文件范围,应按实际用户/组权限和安全边界评估;它是当前客户端 Socket 选址带来的集成取舍,并非 Wi-Fi Direct 协议对 Docker 的统一要求。另外,部分 GO 网卡并不支持用 iw 的通用接口关闭省电,所以动态 Group 后处理只对确认是 P2P Client 的接口执行相关操作,不能照搬到 GO。

这里最容易漏的是三种 Socket/网络边界:

  1. p2p-dev-wlan0 对应 P2P Device 控制入口;GO/Client 形成后又会出现独立的 Group 控制 Socket。基础 Socket 可访问,不代表新 Group Socket 对普通用户也可访问。
  2. 一些 wpa_ctrl/wpa_cli 客户端会在 /tmp 创建本地 Unix datagram 回包端点。如果只把宿主机 /run/wpa_supplicant 暴露给容器,却不让服务端访问客户端回包路径,控制请求可能超时。此部署通过容器与宿主机共享 /tmp 解决;更换客户端 Socket 实现时应重新评估是否仍有这一要求。
  3. network_mode: host 让容器和宿主机使用同一网络命名空间,普通进程才会看到同一套动态 p2p-* 网络接口。但共享网络命名空间不等于获得 root 权限。宿主机脚本仍负责 NetworkManager、udev、networkd、Socket 所有权等操作。

部署示例中的 Group 地址可分别是 X86 192.168.49.2/24、RK3568 192.168.49.1/24;这只是本次网络规划,不是 Wi-Fi Direct 标准地址。上线前还要确认与现有网络不冲突,且不会破坏宿主机原有有线管理路由。

6. 为什么把控制入口、连接策略和 WPA 通道分离

做一次测试时,命令行直接敲 wpa_cli 就够了;要把 Wi-Fi Direct 接入长期运行的设备,问题就变成:怎样让业务调用、自动化测试和命令行调试使用同一套连接规则,而不重复写三份 Wi-Fi Direct 状态机?

这次实践采用的组织方式是把“谁发起控制”和“连接应该如何推进”分开,再把“通过什么方式联系 WPA”做成可替换的底层通道。下面描述的是通用化后的实际设计分层,代码片段也经过教学化简,不要求阅读私有工程源码。

1
2
3
4
5
6
7
8
9
10
flowchart TD
ROS["ROS Service / 状态 Topic"] --> F["入口适配层"]
CLI["Standalone CLI / Agent"] --> F
T["单端自动化 TEST"] --> F
F --> C["连接策略与异步状态管理"]
C --> I["统一 WPA 控制通道"]
I --> W["wpa_ctrl 客户端库"]
I --> P["wpa_cli 进程"]
W --> D["宿主机 wpa_supplicant"]
P --> D

这不是让 ROS 来完成 Wi-Fi Direct 协议。ROS 仅是可选的应用入口:用 Service 提交请求,用 Topic 发布最终状态;不使用 ROS 时,可以运行一个持有连接状态的独立 Agent,再由一个短命令行客户端向 Agent 提交 initialize、connect、disconnect、status。TEST 程序只是其中一个调用方,既可以通过上述公开入口测试,也可以直接使用原生 wpa_cli 做无线基线对照。这样即使未来换掉 ROS,发现、授权、超时、Group 清理等 Wi-Fi Direct 规则仍不需要被复制到新前端。

最关键的是将控制结果拆成三层:请求已经受理、WPA 已接受命令、无线和本机 IP 真正就绪。它们不属于同一个时间点。一个很典型的情况是 P2P_GROUP_ADD 返回 OK,但 Group 的实际 p2p-wlan0-N 接口与控制 Socket 稍后才出现;随后还要开启 GO 的 WPS_PBC,等待 Client 加入、地址配置和双向数据验证。若把第一层成功当成最终连接成功,应用会在错误的阶段启动 TCP/UDP 通信。

一个控制通道的代码组织示例

下面是根据实际工程分层抽象出的 C++11 教学片段,并非生产代码的原文。它只表现业务状态机与 WPA 传输的接口边界,onWpaEvent()、地址核验和超时调度由周边模块完成。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
class WpaChannel {
public:
virtual ~WpaChannel() {}
virtual bool request(const std::string& command,
std::string& reply) = 0;
virtual bool requestGroup(const std::string& group,
const std::string& command,
std::string& reply) = 0;
virtual int receiveEvent(std::string& event) = 0;
};

// 由本端角色策略选择命令,而不是由 wpa_ctrl / wpa_cli 后端决定角色。
void beginGroup(WpaChannel& wpa, bool local_is_go) {
std::string reply;
const std::string command = local_is_go ? "P2P_GROUP_ADD" : "P2P_FIND 60";
if (!wpa.request(command, reply) || reply.find("OK") != 0) {
// 报告命令失败;不能假设无线侧已经停止或清理完成。
return;
}
// 仅表示命令被接受;等待独立的 WPA event 和连接截止时间。
}

// 事件解析由单独的 monitor 通道完成,动态接口名来自 WPA 事件。
struct GroupStarted {
std::string ifname; // 例如 p2p-wlan0-3,不预设后缀
bool local_is_go;
};

void onGroupStarted(WpaChannel& wpa, const GroupStarted& group) {
if (group.local_is_go) {
std::string reply;
if (!wpa.requestGroup(group.ifname, "WPS_PBC", reply) ||
reply.find("OK") != 0) {
// 本轮授权尚未就绪;在连接截止时间内再判断如何处理。
return;
}
}
// 将 group.ifname 交给异步的 IPv4 就绪检查。
// 这里只记录建组进展,不把本机 IP 就绪误认为对端已经可达。
}

这种分层把变化限制在正确位置:要换 wpa_ctrl 为 wpa_cli,替换通道适配即可;要更换 GO/Client 组网策略,改动控制层即可;要替换 ROS/CLI 接口,只调整上层适配。需要强调的是:这只是分离职责,不表示各路径延迟和故障模式一样,尤其是下面两个 WPA 通道。

wpa_ctrl 与 wpa_cli 到底差在哪里

两个名称经常被误认为是两套 Wi-Fi Direct 实现,其实 wpa_cli 本身就是通过 WPA Control Interface 与 wpa_supplicant 通信的工具。二者最终给守护进程发送的仍是诸如 P2P_FIND、P2P_GROUP_ADD、P2P_CONNECT、WPS_PBC 等相同控制命令。wpa_ctrl 指直接在程序中使用 WPA 客户端 C 库的方式;wpa_cli 指通过现有命令行程序间接发送这些命令。

对比项 直接使用 wpa_ctrl 使用 wpa_cli 进程
控制命令 wpa_ctrl_request() 经 Unix datagram Control Socket 发送 创建 wpa_cli -p ... -i ... 子进程执行相同命令
异步事件 为监视通道单独 wpa_ctrl_open(),再 wpa_ctrl_attach();事件 FD 接入事件循环 常驻交互式 wpa_cli 进程输出事件;本次实践通过 PTY 把其输出送到事件循环
进程与资源 无需每条命令创建外部进程;需正确管理客户端 Socket、FD 与 ATTACH/DETACH 命令执行涉及进程创建、标准输出解析;还要管理监视进程、PTY、退出与超时
依赖 需要编译/链接 WPA 控制客户端库及相应头文件 需要目标系统安装 wpa_cli 可执行文件及其运行环境
调试便利性 事件、返回值更适合直接集成到 C/C++ worker 可直接复制命令到终端复现实验,便于与程序行为比较
故障边界 能区分 request 传输失败、WPA FAIL、异步无线失败 还需区分进程启动/退出异常、stdout 文本与 WPA 原始响应
Docker 前提 宿主机 WPA Socket 和客户端回包 Socket 必须相互可见 同样需要访问宿主机 WPA Socket;并不能借用 CLI 绕过 /tmp 等权限问题

直接 wpa_ctrl 的常见做法是准备两个独立客户端 Socket:一个只负责同步控制命令,一个执行 ATTACH 接收异步事件;事件 FD 可以交给 epoll 与 timerfd、eventfd 等统一等待。这样一个 worker 就能处理控制请求、WPA 事件和超时,而无需每个阶段启动单独线程。使用 CLI 后端时,也不能把“每秒执行一条 wpa_cli status”当成异步事件模型的等价替代;更合适的是保留一个事件监视进程,单次控制命令使用独立进程,并明确退出码、文本解析和超时边界。

如果主要目标是定位无线驱动、WPS/EAPOL 或 Group 生命周期问题,先用原生 wpa_cli 复现和记录基线,可以排除一部分应用状态处理因素;如果长期嵌入 C++ 程序且需要细粒度事件控制,直接 wpa_ctrl 通常更合适。两种模式均需真实网卡验证,不能把“换了 CLI 后偶然成功”直接归因为 wpa_ctrl 不稳定。注意区分 wpa_cli(WPA 官方命令行) 和 应用自己的 CLI/Agent 控制工具:前者直接联系 WPA,后者先联系本地业务控制进程,路径和故障域并不相同。

7. GO 和 Client 断链后,为什么 Group 表现不同

Client 离开,不代表 GO 的 Group 必须消失。 固定 GO 本来就可以先存在、等待 Client 加入;当唯一的 Client 断开时,GO 仍可能继续保留 Group,等待后续重新 Join。Client 侧在正常执行离组/删除本地 Group 时,其 p2p-* Group 接口应随本端离组被清理。这正是单侧反复重连需要验证的生命周期差别。

情况 预期观察 不能混淆的地方
Client 主动离组 Client 本机 Group 接口被移除;GO 仍可保留自己的 Group GO 存在不表示 Client 仍在线
GO 侧仅发现 Client 断开 GO Group 通常仍在,可继续等待新一轮授权/加入 P2P-CLIENT-DISCONNECTED 不等于 GO 已执行 P2P_GROUP_REMOVE
GO 主动执行 Group 删除 GO 的 Group 接口删除,Client 会失去该 Group 这是结束整组,不同于某个 Client 离线
控制进程异常退出或无线驱动异常 可能出现残留接口、迟到事件、控制 Socket 不可达,也可能由 WPA/驱动完成自动清理 不可无条件断言异常退出后所有设备都保留或删除 Group

尤其需要分清“驱动进程被杀死”的对象:Linux Wi-Fi 驱动主要位于内核或固件中,通常不是一个可直接 kill 的普通应用进程。容器内控制程序被 SIGKILL 时,宿主机 wpa_supplicant 可能仍持有刚刚创建的 Group;宿主机 WPA 守护进程退出 或驱动/固件崩溃,则是另一类故障,清理行为取决于具体版本与驱动。不能只因为控制程序重启就认为无线组网已经回到初始状态。

对异常残留的处理,应遵循“先识别,再决定是否删除,最后确认删除完成”:

  • 首先查询 iw dev、真实 p2p-* 接口,以及 WPA 当前可访问的控制入口,确认残留 Group 属于本次管理的物理网卡;动态接口后缀不能写死为 0。
  • 将查到的 Group 与本轮已知连接状态核对。仅根据名称前缀直接删除所有 Group,可能误删别的业务正在使用的组。示例命名 p2p-wlan0-N 中的 N 是十进制序号,p2p-dev-wlan0 不是 Group。
  • 对已确认无业务使用、且仍由 WPA 管理的残留 Group,向 WPA 发出针对准确接口名的 P2P_GROUP_REMOVE,然后再次检查接口与状态。OK 只表示删除指令被接受,不等于清理已完成。
  • 如果 WPA 控制入口已经失效,或接口仍异常存在,应保留故障信息并由宿主机维护流程处理驱动/守护进程恢复;不要在普通容器进程中盲目删除内核接口、重启网卡或破坏管理网络。

这一步不是为了每次连接都做“大扫除”。正常断组按当前 Group 生命周期处理;异常中断之后的新一轮建链前,才必须警惕“控制程序状态已经清空,宿主机上上一轮 Group 却还在”的不一致。

8. 稳定性不是只测“建链成功了一次”

这次实践将原生 wpa_cli 的建组/Join 流程与应用控制程序的流程分别压测,以区分无线协议本身的问题和应用控制链路的问题。测试由 X86 宿主机协调,通过 SSH 到 RK3568,再在两侧容器内执行普通用户可执行的 WPA/IP 命令;测试脚本本身不应为方便而强行删除未知业务 Group。

已有的三份脚本各有明确用途。以下保留脚本文件名以说明测试分工,并不表示这些应用侧脚本已在本源码学习仓库公开:

脚本 它检验什么 如果没有这类脚本,会漏掉什么
p2p_wpa_cli_x86_docker_stress.sh X86 端协调多轮原生 WPA:GO 建组、PBC 授权、RK Join、两端 IP、双向 Ping 和最终清理;逐轮记录失败阶段 容易把“应用接口失败”与“原生 WPA/无线握手失败”混为一谈,也难以比较各轮失败阶段
p2p_wpa_cli_rk_docker_helper.sh RK 端配合查询 GO、Join、核对状态、Ping 与移除本端 Group 仅靠 X86 一侧日志无法证明 Client 真正完成关联、拥有 IP 并正确离组
p2p_wfdctl_x86_docker_stress.sh 固定已有控制进程,反复双端断链/建链;交替先启动 X86 或 RK,并加入随机延迟;核对恢复后双方状态与 Group 清理 单次正常启动很难暴露两端起始顺序不同、异步状态滞后、上一轮 Group 残留等问题

现有原生脚本默认进行 100 轮,每方向默认发送 10 个 Ping;另一套控制程序脚本默认 10 轮,在启动顺序上覆盖 RK 先、X86 先,以及后续随机延迟,建链后等待 15 秒再向两个方向各发送 4 个 Ping。两者都包含建链后短时的双向 Ping,但这不等于已经完整覆盖下面所有长期场景。尤其要避免把脚本中的固定 15 s 等待解释成“每次建链必须等 15 秒才可使用”;可靠的判断应来自当下的 Group、IPv4 和真实数据通信状态。

在此基础上,稳定性测试至少应区分三种负载:

(1)两端一起断链、一起重新建链。 每轮分别确认旧 Group 已清理、两端控制入口可用、GO 重新建组和授权、Client Join、两端 IP 与双向 Ping。把“成功进入 CONNECTED”与“成功传输数据”分别记录;清理无法确认时停止下一轮,避免错误累积。

(2)建链后持续双向 Ping。 两端同时从自己的 Group IP 发往对端 Group IP,连续运行数小时或更长时间,记录丢包、最长中断、延迟分布、Group 是否突然移除及 WPA 日志。Linux iputils-ping 可分别在两端使用下面的持续探测命令(X86 示例地址仅用于说明;RK3568 执行时交换本机/对端地址,并按真实网络配置核对):

1
2
3
LOCAL_P2P_IP=192.168.49.2
PEER_P2P_IP=192.168.49.1
ping -n -D -i 0.2 -W 1 -I "$LOCAL_P2P_IP" "$PEER_P2P_IP" >> p2p-ping.log 2>&1

两端都应记录结果。现有短时 Ping 压测脚本不能替代这一项,需要单独持续运行并与无线日志关联。

(3)只在一端反复断链/建链,另一端保持运行。 重点先让 GO 持续保留 Group,反复让 Client 离组并重新 Join;每轮检查 Client Group 是否删除、GO Group 是否仍在、WPS 授权是否仍有效、能否恢复双向 Ping。还应单独测试 GO 删除整组后重新建组,确认 Client 能正确感知失联并恢复。这个单侧 churn 场景不是现有“双端每轮一起清理”脚本的同义替代,需单独编排。

最后再叠加异常退出场景:只终止容器控制进程、重启 WPA、模拟无线接口失联等应分别试验,观察是否残留 Group、是否错误地报告连接成功、能否安全恢复。强制终止守护进程、重启驱动等可能影响现场网络,应在独立测试环境且明确回退方案下进行。

评价结果不要只写“100 轮通过”。至少按轮次保留建链耗时、失败阶段、双向 Ping 结果、断链清理是否完成、重试/恢复时长,并区分预期断链窗口中的 Ping 丢包和已宣称正常在线期间的非预期丢包。对比 GO 协商与固定 GO 时,还需要相同的设备、驱动、信道和射频环境,才能比较真正的时延与稳定性。

9. 真实遇到过的异常:已知边界比猜测根因更重要

在一组历史双端测试记录里,曾遇到两次 RK3568 → X86 方向的 EAPOL 应答未推动对端状态机继续:一次发生在 WPS 的 EAP Identity 阶段,另一次发生在 WPA2 4-Way Handshake 的最后应答阶段。它们属于不同握手阶段,不能当作同一个已确认根因。现有记录表明 RK 端尝试发送应答,X86 端又重发此前请求;但仅有用户态 WPA 的“尝试发送”不等于驱动已发送、空口已经 ACK 或 X86 已上交给 WPA。

这类问题提醒了一个边界:固定 GO 可以绕开每次 GO 角色协商,但无法绕过后续 WPS/EAPOL 和驱动收发路径。 发现握手停滞时,应关联双端时间戳、WPA 事件、驱动 TX 完成/重试、空口帧以及接收端上交记录,定位应答究竟在哪一层丢失。目前缺少这样的完整闭环,因此不能把它直接归因于 RK 无线驱动,也不能声称更换组网模式已经修复了握手问题。

10. 写在最后

有的时候,看得懂源码跟实际使用是两回事。

理解 P2P_FIND、GO Negotiation、WPS 和 P2P-GROUP-STARTED,可以解释协议为什么这样推进;真实设备上还需要解决宿主机与 Docker 的权限边界、动态 Group 的生命周期、两端时间窗口、驱动收发的不确定性,以及异常退出后的状态恢复。

能够稳定交付的 Wi-Fi Direct,不是“控制命令返回 OK”,也不是“Group 接口出现了”,而是建得起来、真正双向可通信、长时间运行可观测、断开后可清理、异常后能有边界地恢复。这部分工作无法只靠读通源码完成。