Skip to main content

启动 Wi-Fi 子系统

如果设备以 STA 模式启动,则 Wi-Fi 默认处于活动状态,即 Wi-Fi 主机驱动和 wpa_supplicant 在设备启动过程中启动。
  1. 通过执行 连接到 UART shell 中列出的步骤,确保设备通过 UART 连接到主机。
  2. 要确认是否已加载 Wi-Fi 主机驱动,请在调试 UART 控制台上运行以下命令:
  3. 在输出中搜索 wlan0 接口: 示例输出
  4. 要验证 wpa_supplicant 是否处于活动状态,请运行以下命令:
    以下输出表明 wpa_supplicant 已成功启用:
注意:
由于预测网络接口名称默认启用:
  • 对于非 PCIe 接口,WLAN 接口名称为 wlanX (RB3GEN2, Shikra)。
  • 对于 PCIe 接口,wlanX 被重命名为 wlpXsY,其中:
    • X = PCIe 端口索引 + 1
    • Y = 设备索引

扫描 Wi-Fi AP

Wi-Fi 扫描查找附近列出的 AP,必须通过 nmcli 命令行工具启动。 要使用 nmcli 启动 Wi-Fi 扫描,请运行以下命令:
示例输出
注意 要退出标准输入 shell,按 CTRL+C。

设置 Wi-Fi 站点

在 STA 模式下,设备作为客户端运行,可以连接到无线热点或路由器。 通过 nmcli 命令行工具建立无线连接。 要以 STA 模式设置 Wi-Fi,请执行以下步骤:
  1. 通过执行 连接到 UART shell 中列出的步骤,确保设备通过 UART 连接到主机。
  2. 要建立与 AP 的连接,请运行以下命令:
    例如,运行命令
    其中,Wi-Fi SSID 为 QualcommWiFi,Wi-Fi 密码为 1234567890。 示例输出
    注意 如果您在运行命令时看到网络错误消息,请运行以下命令之一以触发 Wi-Fi 扫描并验证目标 AP。
  3. 要验证连接状态,请运行以下命令:
    示例输出
  4. 要验证连接状态,请执行以下步骤:
    1. 要查看设备状态,请运行以下命令:
      示例输出
    2. 要查看其他连接信息,请运行以下命令:
      示例输出
    3. 通过在 UART 控制台中运行 ip addr show wlan0 命令,验证 wlan0 接口上是否已分配 IP 地址。
      示例输出
    4. 通过 ping 以下公共 DNS IP 验证 AP 或路由器是否已连接到互联网:
      示例输出
      注意 如果您已连接到一个网络,但想使用不同的连接,可以通过指定 SSID nmcli con down ssid/uuid 将连接切换为 down 来断开连接。或者,如果您有多个具有相同 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:
例如,如果设备的 IP 地址为 192.168.1.22,请运行以下命令:
注意 如果存在 WCN6750 芯片组,请确保在 Qualcomm Dragonwing RB3 Gen 2 Development Kit 上配置的 Wi-Fi SoftAP 工作通道与 Wi-Fi STA 工作通道相同(不包括 DFS 通道)。 注意 使用 STA 或 SAP 与 DFS 通道,因为 STA+SAP SCC DFS 并发目前不可用。 默认情况下,hostapd.conf 文件位于 /etc 位置。此文件将 RB3 Gen 2 设备配置为 Wi-Fi SoftAP 工作模式,SSID 为 QSoftAP,密码为 1234567890.
  1. 通过运行以下命令添加 Wi-Fi SoftAP 工作模式接口:
  2. 通过执行以下步骤重新配置 Wi-Fi SoftAP 工作模式:
    1. 打开新的命令提示符/终端。
    2. 通过运行以下命令从设备中拉取默认的 hostapd.conf 文件:
      要将文件拉取到当前文件路径,请在命令中输入 <destination_file_path> 为 .。 例如,设备的 IP 地址为 192.168.1.22,要从 /etc 拉取 hostapd.conf,请运行以下命令:
    3. 使用所需的 SSID、密码和相关的 hostapd 配置更新 hostapd.conf 文件。 注意 在修改 Wi-Fi 通道时,请准确更新 hw_mode。有关 hostapd 配置的更多信息,请参阅 https://w1.fi/cgit/hostap/plain/hostapd/README。
    4. 通过运行以下命令将文件推送到设备:
    5. 要验证配置参数已更新,请在设备中为 hostapd.conf 文件运行以下命令:
  3. 在具有 WCN6750 Wi-Fi 芯片组的 Qualcomm Dragonwing RB3 Gen 2 Development Kit 上为 wlan1 设置 MAC 地址。设置 MAC 地址时可以参考以下示例。
  4. 要设置 SoftAP,请在 ssh shell 中运行以下命令:
    以下输出表明 AP 已设置:
  5. 要在 Wi-Fi 热点接口上启动动态主机配置协议 (DHCP) 服务器,请运行以下命令:
  6. 要建立与 hostapd_cli 的连接,请在 SSH 中运行以下命令:
    监控 hostapd_cli 控制台以获取 Wi-Fi STA 连接通知,例如 AP-STA-CONNECTED、EAPOL-4WAY-HS-COMPLETED。 示例输出
  7. 要验证连接状态,从其他设备连接到 SoftAP。 例如,通过执行以下步骤从移动设备连接到 SoftAP:
    1. 在移动设备上,转到 Wi-Fi 设置。
    2. 等待 Wi-Fi STA 检测到 SoftAP(SSID 为 QSoftAP)。
    3. 选择 SoftAP 并输入在 RB3 Gen 2 设备上为 SoftAP 配置的相应 wpa_passphrase,然后连接。 示例输出
    4. 要验证连接,请在 ssh shell 中从 RB3 Gen 2 设备 ping 移动设备的 IP 地址。 以下输出表明 Wi-Fi 连接已成功建立,并且数据传输已开始:
      或者,您可以在已连接设备的 设置 中验证 Wi-Fi 连接状态。例如,要获取连接到 RB3 Gen 2 SoftAP 的移动设备的 IP 地址,请执行以下步骤:
      1. 转到 设置 > Wi-Fi。
      2. 验证 AP 的 SSID。

停止 Wi-Fi 热点

注意 确保已设置 Wi-Fi 热点。 要停止热点,请在 SSH 中执行以下操作:
  1. 通过执行以下步骤停止 hostapd:
    1. 要停止 hostapd 进程,请运行以下命令:
    2. 要禁用接口,请运行以下命令:
  2. 要删除 ctrl_interface,请运行以下命令:
    Wi-Fi 热点成功停止。