WiFi 修复记录

阿元

FnOS 硬件驱动修复报告
🔷 问题：Ralink RT5390 WiFi 不可用

现象：
- `nmcli device status` 显示 `wlp2s0 wifi unavailable`
- `ip link` 显示 `wlp2s0: ... state DOWN`
- 无线网卡物理存在但无法扫描任何网络

排查过程：

1. lspci → 确认网卡为 Ralink RT5390 (PCIe 802.11n, 设备ID 1814:5390)
2. modinfo rt2800pci → 驱动在内核中已编译，但依赖 firmware: rt2860.bin
3. ls /lib/firmware/ → 发现 rt2860.bin 不存在！
4. dmesg → 无任何 rt2800pci 相关日志（驱动静默加载成功，但缺固件无法初始化射频）
5. nmcli → wlp2s0 状态 "unavailable"
6. 从 linux-firmware 仓库下载 rt2860.bin：
   curl -sL "https://git.kernel.org/.../rt2860.bin" -o /tmp/rt2860.bin


根因：
> FnOS 系统中缺失 Ralink 无线网卡固件文件 `rt2860.bin`。
> `rt2800pci` 内核驱动模块依赖此固件来初始化射频芯片（RF initialization）。固件缺失时，驱动模块虽能加载，但无线射频始终处于未初始化状态，接口标记为 `unavailable`。

已修复措施：
| 操作 | 命令/步骤 | 状态 |
|------|-----------|------|
| ① 下载固件 | 从 linux-firmware git 仓库获取 `rt2860.bin` (8192字节) | ✅ |
| ② 安装固件 | `cp /tmp/rt2860.bin /lib/firmware/rt2860.bin` | ✅ |
| ③ 重载驱动 | `sudo modprobe -r rt2800pci && sudo modprobe rt2800pci` | ✅ |
| ④ 验证状态 | 接口从 `unavailable` 变为 `disconnected` | ✅ |
| ⑤ 扫描验证 | `iw scan` 成功扫描到周边 4 个 WiFi 信号（-31~-63dBm） | ✅ |
| ⑥ 开机自启 | 添加 `/etc/modules-load.d/rt2800pci.conf`，确保重启后自动加载 | ✅ |

验证结果：


设备: wlp2s0 (RT5390 802.11n)
状态: disconnected（正常，等待配置连接）
信号: CMCC-x3gb (-63dBm), hryf (-31dBm), DY-2.4G (-47dBm), damo (-53dBm)


后续：如需要连接 WiFi，在 FnOS Web 管理界面或命令行输入 `nmcli device wifi connect <SSID> password <密码>` 即可。

---

报告日期： 2026-07-17
系统环境：FnOS (Debian 12 Bookworm), 内核 6.18.18.c877-trim