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 已成功启用:
注意:
由于默认启用了可预测网络接口名称(Predictable Network Interface Names):
  • 对于非 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)

在 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 将连接切换为断开状态。或者,如果有多个使用相同 SSID 的连接,请使用 UUID。 注意 要连接到另一个已保存的连接,只需在 nmcli 命令行工具中传入 up 选项,运行以下命令。
      请确保指定你要连接的新网络的 SSID 或 UUID。 注意 要退出标准输入 shell,请按 CTRL+C。 有关 nmcli 的更多信息,请参阅 https://www.linux.org/docs/man1/nmcli.htmlhttps://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 开发套件上配置的 Wi-Fi SoftAP 工作信道与 Wi-Fi STA 工作信道相同(DFS 信道除外)。 注意 在使用 DFS 信道时,请仅使用 STA 或 SAP 之一,因为 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 开发套件上为 wlan1 设置 MAC 地址。设置 MAC 地址时可参考以下示例。
  4. 要设置 SoftAP,请在 ssh shell 中运行以下命令:
    以下输出表明 AP 已设置完成:
  5. 要在 Wi-Fi 热点接口上启动动态主机配置协议(DHCP)服务器,请运行以下命令:
  6. 要与 hostapd_cli 建立连接,请在 SSH 中运行以下命令:
    hostapd_cli 控制台上监控 Wi-Fi STA 连接通知,例如 AP-STA-CONNECTEDEAPOL-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 热点即成功停止。