启动 Wi-Fi 子系统
如果设备以 STA 模式启动,Wi-Fi 默认处于激活状态,即 Wi-Fi 主机驱动和 wpa_supplicant 在设备启动过程中被启动。- 按照连接到 UART shell 中列出的步骤,确保设备已通过 UART 连接到主机。
- 要确认 Wi-Fi 主机驱动是否已加载,请在调试 UART 控制台上运行以下命令:
- 在输出中查找
wlan0接口: 示例输出 - 要验证 wpa_supplicant 是否处于活动状态,请运行以下命令:
以下输出表明 wpa_supplicant 已成功启用:
由于默认启用了可预测网络接口名称(Predictable Network Interface Names):
- 对于非 PCIe 接口,WLAN 接口名称为
wlanX(RB3GEN2、Shikra)。 - 对于 PCIe 接口,
wlanX被重命名为wlpXsY,其中:X= PCIe 端口索引 + 1Y= 设备索引
扫描 Wi-Fi AP
Wi-Fi 扫描会查找附近列出的 AP,必须通过nmcli 命令行工具发起。
要使用 nmcli 发起 Wi-Fi 扫描,请运行以下命令:
示例输出注意 要退出标准输入 shell,请按 CTRL+C。
设置 Wi-Fi 站点(STA)
在 STA 模式下,设备作为客户端运行,可以连接到无线热点或路由器。 通过nmcli 命令行工具建立无线连接。
要在 STA 模式下设置 Wi-Fi,请执行以下步骤:
- 按照连接到 UART shell 中列出的步骤,确保设备已通过 UART 连接到主机。
- 要建立与 AP 的连接,请运行以下命令:
例如,运行命令其中,Wi-Fi SSID 为
QualcommWiFi,Wi-Fi 密码为1234567890。 示例输出注意 如果在运行命令时看到网络错误消息,请运行以下命令之一以触发 Wi-Fi 扫描并确认目标 AP。 - 要验证连接状态,请运行以下命令:
示例输出
- 要验证连接状态,请执行以下步骤:
- 要查看设备状态,请运行以下命令:
示例输出
- 要查看其他连接信息,请运行以下命令:
示例输出
- 在 UART 控制台中运行
ip addr show wlan0命令,验证wlan0接口是否已分配 IP 地址。示例输出 - 通过 ping 以下公共 DNS IP,验证 AP 或路由器是否已连接到互联网:
示例输出注意 如果你已连接到某个网络,但想使用其他连接,可以通过指定 SSID
nmcli con down ssid/uuid将连接切换为断开状态。或者,如果有多个使用相同 SSID 的连接,请使用 UUID。 注意 要连接到另一个已保存的连接,只需在nmcli命令行工具中传入 up 选项,运行以下命令。请确保指定你要连接的新网络的 SSID 或 UUID。 注意 要退出标准输入 shell,请按 CTRL+C。 有关nmcli的更多信息,请参阅 https://www.linux.org/docs/man1/nmcli.html 和 https://networkmanager.dev/docs/api/latest/nmcli.html。
- 要查看设备状态,请运行以下命令:
设置 Wi-Fi 热点
请确保已按照使用 SSH 登录中列出的步骤启用 SSH。 通过执行以下步骤在 SoftAP 模式下设置 Wi-Fi 热点: 使用以下命令运行 SSH:192.168.1.22,运行以下命令:
hostapd.conf 文件位于 /etc 位置。该文件将 RB3 Gen 2 设备配置为 Wi-Fi SoftAP 工作模式,SSID 为 QSoftAP,密码为 1234567890.
- 通过运行以下命令添加 Wi-Fi SoftAP 工作模式接口:
- 通过执行以下步骤重新配置 Wi-Fi SoftAP 工作模式:
- 打开新的命令提示符/终端。
- 通过运行以下命令从设备拉取默认的
hostapd.conf文件:要将文件拉取到当前文件路径,请在命令中将<destination_file_path>填写为.。 例如,设备的 IP 地址为192.168.1.22,要从/etc拉取hostapd.conf,请运行以下命令: - 使用所需的 SSID、密码和相关 hostapd 配置更新
hostapd.conf文件。 注意 修改 Wi-Fi 信道时请准确更新hw_mode。有关 hostapd 配置的更多信息,请参阅 https://w1.fi/cgit/hostap/plain/hostapd/README。 - 通过运行以下命令将文件推送到设备:
- 要验证配置参数已更新,请在设备上针对
hostapd.conf文件运行以下命令:
- 在配备 WCN6750 Wi-Fi 芯片组的 Qualcomm Dragonwing RB3 Gen 2 开发套件上为
wlan1设置 MAC 地址。设置 MAC 地址时可参考以下示例。 - 要设置 SoftAP,请在
ssh shell中运行以下命令:以下输出表明 AP 已设置完成: - 要在 Wi-Fi 热点接口上启动动态主机配置协议(DHCP)服务器,请运行以下命令:
- 要与
hostapd_cli建立连接,请在 SSH 中运行以下命令:在hostapd_cli控制台上监控 Wi-Fi STA 连接通知,例如AP-STA-CONNECTED、EAPOL-4WAY-HS-COMPLETED。 示例输出 - 要验证连接状态,请从其他设备连接到 SoftAP。
例如,通过执行以下步骤从移动设备连接到 SoftAP:
- 在移动设备上,进入 Wi-Fi 设置。
- 等待 Wi-Fi STA 检测到 SoftAP(SSID 为 QSoftAP)。
- 选择 SoftAP,输入在 RB3 Gen 2 设备上为 SoftAP 配置的相应
wpa_passphrase,然后连接。 示例输出 - 要验证连接,请在
ssh shell中从 RB3 Gen 2 设备 ping 移动设备的 IP 地址。 以下输出表明 Wi-Fi 连接已成功建立,数据传输已开始:或者,你也可以在已连接设备的设置中验证 Wi-Fi 连接状态。例如,要获取连接到 RB3 Gen 2 SoftAP 的移动设备的 IP 地址,请执行以下步骤:- 进入设置 > Wi-Fi。
- 验证 AP 的 SSID。
停止 Wi-Fi 热点
注意 请确保 Wi-Fi 热点已设置完成。 要停止热点,请在 SSH 中执行以下操作:- 通过执行以下步骤停止 hostapd:
- 要停止 hostapd 进程,请运行以下命令:
- 要禁用接口,请运行以下命令:
- 要停止 hostapd 进程,请运行以下命令:
- 要删除
ctrl_interface,请运行以下命令:Wi-Fi 热点即成功停止。

