Linux开发—— USB 虚拟网口配置
一、内核编译配置
1. 必需的内核选项
# USB Gadget 支持（核心）Device Drivers --->[*]USB support ---><M>USB Gadget Support ---><M>USB Gadget Drivers# USB 网络功能（关键）Device Drivers --->[*]USB support ---><M>USB Gadget Support ---><M>Ethernet Gadget(with CDC Ethernet support)<M>RNDIS support<M>ECM support2. 具体配置项
| 配置项 | 说明 | 为什么需要 |
|---|---|---|
CONFIG_USB_GADGET=y/m | USB Gadget 框架 | 使 Linux 设备作为 USB 从设备 |
CONFIG_USB_CONFIGFS=y/m | ConfigFS 支持 | 允许通过文件系统动态配置 USB |
CONFIG_USB_ETH=m | USB Ethernet Gadget | 提供基础以太网功能 |
CONFIG_USB_ETH_RNDIS=y | RNDIS 协议 | Windows 兼容性（必需） |
CONFIG_USB_ETH_EEM=y | EEM 协议 | 高性能以太网模拟 |
CONFIG_USB_G_ETHER=m | Ethernet Gadget 驱动 | 实际的网络驱动程序 |
3. 推荐的额外选项
CONFIG_USB_LIBCOMPOSITE=m# 组合 USB 设备支持CONFIG_USB_F_ECM=m# ECM 功能（Mac/Linux）CONFIG_USB_F_RNDIS=m# RNDIS 功能（Windows）CONFIG_USB_F_EEM=m# EEM 功能二、为什么需要这些配置？
1.USB Gadget 框架原理
硬件层 (USB Controller) ↓ USB Gadget 驱动层 (内核模块) ↓ USB 功能层 (RNDIS/ECM/EEM) ↓ 网络协议栈 (usb0 虚拟网卡)- Gadget 模式：让 Linux 设备充当 USB 从设备（而非主机）
- 功能复用：同一个 USB 接口可以模拟多种设备（网卡、串口、存储等）
2.RNDIS 的必要性
- Windows 兼容：Windows 原生支持 RNDIS 协议
- 无需驱动：Windows 自动识别为网络适配器
- 即插即用：连接后自动创建网络连接
3.ECM/EEM 的作用
- ECM：Linux/macOS 的标准协议，性能好
- EEM：最新协议，效率最高，开销最小
- 跨平台：配置多种协议确保兼容性
三、运行时配置（两种方法）
方法 1：使用 g_ether 模块（简单）
# 加载模块modprobe g_ether# 配置 IP 地址ifconfigusb0192.168.7.2 netmask255.255.255.0 up# 启用路由转发（可选）echo1>/proc/sys/net/ipv4/ip_forward方法 2：使用 ConfigFS（灵活，推荐）
#!/bin/bash# 挂载 configfsmount-t configfs none /sys/kernel/configcd/sys/kernel/config/usb_gadget/# 创建 gadgetmkdirg1cdg1# 设置 USB 描述符echo"0x1d6b">idVendor# Linux Foundationecho"0x0104">idProduct# Multifunction Composite Gadgetecho"0x0100">bcdDevice# v1.0.0echo"0x0200">bcdUSB# USB 2.0# 创建字符串描述符mkdirstrings/0x409echo"0123456789">strings/0x409/serialnumberecho"MyCompany">strings/0x409/manufacturerecho"USB-Ethernet">strings/0x409/product# 创建配置mkdirconfigs/c.1mkdirconfigs/c.1/strings/0x409echo"Config 1: RNDIS network">configs/c.1/strings/0x409/configurationecho250>configs/c.1/MaxPower# 创建 RNDIS 功能mkdirfunctions/rndis.usb0# 设置 MAC 地址（可选）echo"02:00:00:00:00:01">functions/rndis.usb0/dev_addrecho"02:00:00:00:00:02">functions/rndis.usb0/host_addr# 链接功能到配置ln-s functions/rndis.usb0 configs/c.1/# 绑定到 UDC（USB Device Controller）ls/sys/class/udc>UDC# 配置网络接口sleep2ifconfigusb0192.168.7.2 netmask255.255.255.0 up四、验证配置
# 1. 检查内核模块lsmod|grepusb# 2. 查看网络接口ipaddr show usb0# 3. 查看 USB 设备状态cat/sys/kernel/config/usb_gadget/g1/UDC# 4. 测试连接（从 PC 端）ping192.168.7.2五、常见问题排查
| 问题 | 原因 | 解决方法 |
|---|---|---|
| usb0 不出现 | 内核选项未启用 | 检查CONFIG_USB_G_ETHER |
| Windows 无法识别 | 缺少 RNDIS 支持 | 确保CONFIG_USB_ETH_RNDIS=y |
| 连接后无法通信 | IP 地址冲突 | PC 和板子使用不同 IP |
| 无法加载模块 | UDC 驱动未加载 | 检查 USB 控制器驱动 |
六、开机自动配置
创建 systemd 服务或在/etc/rc.local中添加：
#!/bin/sh# USB 网络初始化modprobe g_etherifconfigusb0192.168.7.2 netmask255.255.255.0 upexit0总结
核心要点：
- 内核支持：编译时启用 USB Gadget + RNDIS/ECM 功能
- 运行时配置：加载模块并配置 IP 地址
- 协议选择：RNDIS（Windows）、ECM（Linux/Mac）
- IP 规划：确保 PC 和开发板 IP 在同一网段但不冲突