Qualcomm Atheros QCA9377 网卡驱动安装及WiFi连接教程（fnOS）
适用场景：fnOS 系统，网卡型号为 Qualcomm Atheros QCA9377 802.11ac Wireless Network Adapter（可通过 lspci | grep -i "network" 命令查看自身网卡型号）
前置说明：安装驱动前，需确保设备已通过有线网络联网（驱动安装需在线下载依赖），全程命令可直接复制粘贴执行，无需手动修改（除WiFi名称和密码外）。
一、查看自身网卡型号（确认适配本教程）
在终端中输入以下命令，查看网卡信息：
lspci | grep -i "network"
若输出结果为 01:00.0 Network controller: Qualcomm Atheros QCA9377 802.11ac Wireless Network Adapter (rev 31)，则说明你的网卡适配本教程，可继续下一步操作。
二、安装网卡驱动
驱动安装步骤简单，按顺序执行以下命令即可，执行过程中若提示输入密码，输入系统密码后回车即可（密码输入时不显示，正常输入即可）。
- 切换至root权限（简化后续命令操作）：
sudo -i
- 更新软件源（确保能下载到最新的驱动固件）：
apt update
- 安装Atheros网卡固件（QCA9377适配此固件）：
apt install firmware-atheros -y
- 加载驱动模块：
modprobe ath10k_pci
- 重启设备（使驱动生效）：
reboot
重启后，再次打开终端，输入以下命令验证驱动是否安装成功：
sudo -i
nmcli device wifi list
若能正常显示周围的WiFi信号列表，说明驱动安装成功；若未显示，可查看文末的常见问题排查。
三、连接WiFi（命令行操作）
驱动安装成功后，使用以下命令连接WiFi，替换命令中的“你的WiFi名称”和“你的WiFi密码”为实际信息即可：
nmcli device wifi connect "你的WiFi名称" password "你的WiFi密码"
示例：若WiFi名称为“Home-WiFi”，密码为“12345678”，则命令为：
nmcli device wifi connect "Home-WiFi" password "12345678"
执行命令后，若提示“successfully activated”，则说明WiFi连接成功，可正常上网。
四、WiFi常用操作命令（备用）
整理了日常常用的WiFi操作命令，方便后续管理WiFi连接：
- 关闭WiFi：
sudo nmcli radio wifi off
- 打开WiFi：
sudo nmcli radio wifi on
- 断开当前WiFi连接：
nmcli connection down "WiFi名称"（替换“WiFi名称”为实际连接的WiFi）
- 忘记已连接的WiFi（后续需重新输入密码连接）：
nmcli connection delete "WiFi名称"
- 重新查看WiFi列表：
nmcli device wifi list
五、常见问题排查（驱动安装/WiFi搜索失败）
若按以上步骤操作后，仍无法搜索到WiFi，可按以下顺序排查：
- 确认网卡类型：本教程仅适用于 PCIe内置网卡，若你的网卡是USB外接网卡，需安装对应USB网卡的驱动（QCA9377多为内置PCIe网卡）。
- 查看驱动加载日志：在终端输入
dmesg | grep ath10k，查看是否有“firmware missing”（固件缺失）相关的错误提示，若有，重新执行第二步的驱动安装命令，确保网络通畅，重新下载固件。
- 更换固件包：若反复安装失败，可尝试安装Ubuntu/Debian官方固件包，执行命令
apt install linux-firmware -y，安装完成后重启设备重试。
