RK3399 Armbian 上 RTL8188EUS / RTL8710BU USB 网卡驱动安装记录

约 753 字大约 3 分钟

2025-10-02

在 RK3399 + Armbian 上用 USB 无线网卡，没反应通常就是驱动问题。水星网卡一般用的是 Realtek 芯片，Armbian 内核里很多并没有预装对应驱动。

系统环境：Armbian 6.1.114-ophub（RK3399 开发板）芯片：Realtek RTL8188EUS / RTL8710BU 问题：板载 Wi-Fi 信号弱，插入 USB 网卡无法识别，尝试 DKMS 驱动编译失败。

检查 USB 网卡是否被识别

lsusb
nmcli dev wifi list

输出示例：

Bus 002 Device 003: ID 0bda:1a2b Realtek Semiconductor Corp. RTL8188GU 802.11n WLAN Adapter

状态：ID 为 0bda:1a2b，处于“Driver CDROM Mode”，需要 usb-modeswitch。

切换 USB 网卡模式（如果设备支持模式切换）

sudo apt update
sudo apt install usb-modeswitch usb-modeswitch-data
sudo usb_modeswitch -v 0bda -p 1a2b -R
sudo usb_modeswitch -c /etc/usb_modeswitch.d/0bda:1a2b

切换完成后用 lsusb 确认：

Bus 002 Device 005: ID 0bda:b711 Realtek Semiconductor Corp. RTL8188GU 802.11n WLAN Adapter (After Modeswitch)

尝试 DKMS 驱动（可选，但在定制 kernel 上可能失败）

# 克隆 / 下载 RTL8188EUS 驱动源码
git clone https://github.com/aircrack-ng/rtl8188eus.git
cd rtl8188eus

# 尝试 DKMS 安装
sudo chmod +x dkms-install.sh
sudo ./dkms-install.sh

注意：

定制 kernel 缺少 headers 或使用不同编译器，会导致 DKMS 编译失败。
错误示例：

fatal error: rtw_byteorder.h: No existe el fichero o directorio

结论：在 RK3399 定制 Armbian 上，直接使用内核自带的 rtl8xxxu 模块更可靠。

加载 RTL8XXXU 内核驱动

sudo modprobe rtl8xxxu
dmesg | tail -n 20

问题：

rtl8xxxu: Loading firmware rtlwifi/rtl8710bufw_SMIC.bin failed

原因：缺少固件文件

下载缺失固件并放置到 `/lib/firmware/rtlwifi/`

wget https://git.kernel.org/pub/scm/linux/kernel/git/firmware/linux-firmware.git/plain/rtlwifi/rtl8710bufw_SMIC.bin
sudo mkdir -p /lib/firmware/rtlwifi
sudo cp rtl8710bufw_SMIC.bin /lib/firmware/rtlwifi/

重新加载驱动

sudo rmmod rtl8xxxu
sudo modprobe rtl8xxxu
dmesg | tail -n 20

确认输出示例：

rtl8xxxu: Loading firmware rtlwifi/rtl8710bufw_SMIC.bin
Firmware revision 16.0 (signature 0x10b1)

表示固件加载成功，USB 网卡可用。

检查无线接口

ip link show

示例：

5: wlan1: <NO-CARRIER,BROADCAST,MULTICAST,UP> mtu 1500 ...

扫描 Wi-Fi

nmcli dev wifi list

成功扫描到周围 Wi-Fi，网卡工作正常。

总结

RK3399 定制 Armbian 的 kernel 不一定能用 DKMS 编译 RTL8188EUS 驱动，直接使用 rtl8xxxu 更可靠。

必须下载缺失固件 rtl8710bufw_SMIC.bin 放入 /lib/firmware/rtlwifi/。

USB 网卡识别完成后，可用 nmcli 或 iw 扫描连接 Wi-Fi。

注意

之后插拔后都能正常工作吗？

已经把 rtl8710bufw_SMIC.bin 放在 /lib/firmware/rtlwifi/。

效果：内核 rtl8xxxu 模块每次插入网卡都会自动加载固件，不需要重复操作。
前提：固件文件不能被删除或移动。

插上 USB 网卡时，内核会自动识别并加载 rtl8xxxu。

拔掉 USB 网卡时，驱动会自动释放资源。

插拔多次不会损坏驱动，但 热插拔可能会短暂显示 NO-CARRIER，属于正常现象。

如果你同时加载过 8188eu DKMS 驱动，可能会和 rtl8xxxu 冲突。

建议卸载 DKMS 驱动：

sudo dkms remove 8188eu/5.3.9 --all

使用 nmcli 或 iwconfig 时，如果网卡状态显示 DOWN，手动启用：

sudo ip link set wlan1 up

如果系统重启，网卡依然可用，因为固件和驱动都在系统里。