OpenWrt识别不到USB网卡怎么办？

Question

问题：在OpenWrt系统中插入USB网卡后，设备无法被识别，`lsusb`命令无输出或网卡未出现在网络接口列表中。可能原因为驱动缺失、供电不足或硬件兼容性问题。部分USB网卡（如基于ASIX、RTL8153芯片的型号）需手动安装对应kmod-usb-net系列驱动。如何确认USB网卡是否被系统识别并正确加载驱动？

Answer 1

一、初步现象确认与基础排查

当在OpenWrt系统中插入USB网卡后，若lsusb命令无输出或网络接口未出现，首先应确认物理连接是否正常。检查USB端口是否有供电、网卡指示灯是否亮起，并尝试更换USB端口或使用带外接电源的USB HUB以排除供电不足问题。

执行以下命令查看USB设备枚举情况：

lsusb

若无任何输出，可能表示内核未正确识别USB控制器或存在硬件兼容性问题。进一步可运行：

dmesg | tail -20

观察内核日志中是否有关于USB设备插入的日志信息，如“new high-speed USB device”或“unable to enumerate”等提示。

二、深入分析：驱动加载状态检测

即使lsusb有输出，也不代表驱动已成功加载。需结合usb-devices命令（需安装usbutils包）获取更详细的设备属性：

opkg install usbutils
usb-devices

查找对应Vendor ID和Product ID，判断其使用的芯片组型号（如ASIX AX88179对应ID为0b95:1790，RTL8153为0bda:8153）。

确认所需驱动模块：

• ASIX芯片 → kmod-usb-net-asix
• Realtek RTL8153 → kmod-usb-net-rtl8152
• SMC/SMS网络适配器 → kmod-usb-net-smsc
• MCS7830芯片 → kmod-usb-net-mcs7830

使用以下命令检查模块是否已加载：

lsmod | grep usbnet

三、驱动安装与依赖管理流程图

部分OpenWrt镜像默认不包含所有USB网卡驱动，需手动安装对应kmod包。以下为标准处理流程：

graph TD A[插入USB网卡] --> B{lsusb是否有输出?} B -- 否 --> C[检查供电/硬件兼容性] B -- 是 --> D[解析VID/PID确定芯片类型] D --> E[查找对应kmod-usb-net驱动] E --> F[通过opkg安装驱动模块] F --> G[验证modprobe是否成功] G --> H[检查网络接口是否生成] H --> I[/etc/config/network配置新接口]

四、驱动缺失场景下的解决方案

若确认芯片为ASIX AX88179但系统未自动加载驱动，执行：

opkg update
opkg install kmod-usb-net-asix

对于RTL8153网卡：

opkg install kmod-usb-net-rtl8152

注意：kmod-usb-net-rtl8152同时支持RTL8152和RTL8153芯片。

安装完成后重启模块：

insmod asix
# 或
modprobe rtl8152

再次运行dmesg查看是否输出类似“asix 1-1:1.0 eth1: register 'asix' at usb”信息。

五、高级诊断：硬件兼容性与固件限制

某些USB转千兆网卡需要额外固件文件（firmware），例如AX88179需ax88179_178a.hex。可通过以下方式确认：

dmesg | grep firmware

若出现“request_firmware failed”，则需手动上传固件至/lib/firmware目录。

常见USB网卡芯片与驱动对应表：

芯片厂商	典型型号	Vendor:Product ID	所需kmod包	是否需额外固件
ASIX	AX88179	0b95:1790	kmod-usb-net-asix	是
Realtek	RTL8153	0bda:8153	kmod-usb-net-rtl8152	否
Microchip	LAN7800	0424:7800	kmod-usb-net-lan78xx	否
SMSC	LAN9500A	0424:9500	kmod-usb-net-smsc	否
MCS	MCS7830	0db0:6832	kmod-usb-net-mcs7830	否
Cherry	CH347	1a86:8010	kmod-usb-serial-ch341	否
ASIX	AX88772B	0b95:772b	kmod-usb-net-asix-ums	否
Realtek	RTL8152	0bda:8152	kmod-usb-net-rtl8152	否
ITE	IT5707	048d:5707	kmod-usb-net-ipheth	否
Silicon Labs	CP210x	10c4:ea60	kmod-usb-serial-cp210x	否