linux usb gadget驱动

Linux中的USB Gadget驱动是用于实现设备充当USB从设备（Peripheral）功能的软件框架。它允许基于Linux系统的设备（如嵌入式开发板、树莓派、手机等）模拟成各种USB设备角色，例如：

U盘 (Mass Storage Gadget)
USB网卡 (Ethernet Gadget, ECM/NCM/RNDIS)
USB串口 (Serial Gadget, ACM/CDC)
USB键盘/鼠标 (HID Gadget)
USB MIDI设备
USB摄像头 (UVC Gadget)
USB音频设备 (UAC1/UAC2 Gadget)
USB FunctionFS (用于实现用户空间驱动的自定义功能)

核心概念与工作机制

与主机驱动相反：
- 主机端驱动（如 ehci-hcd, xhci-hcd) 让Linux控制USB端口作为主机 (Host)，连接打印机、U盘等外设。
- Gadget驱动让Linux控制USB端口作为从设备 (Peripheral)，被另一台主机（如PC、手机）识别和使用。
内核框架：
- UDC驱动 (USB Device Controller Driver): 这是底层硬件驱动，直接控制SoC或外接芯片上的USB Device控制器硬件（如DWC2, DWC3, Chipidea等）。它提供了与Gadget框架交互的接口。
- Gadget Function驱动： 这些驱动实现了具体的USB设备功能（如存储、网络、串口）。它们构建符合USB规范的设备描述符、配置描述符、接口描述符、端点描述符，并通过UDC驱动与硬件交互处理数据传输。
- Gadget核心层: 提供基础API和结构体，协调UDC驱动和Function驱动的交互。
关键组件：
- configfs: （强烈推荐，现代方式）一个虚拟文件系统 (/sys/kernel/config/usb_gadget/)，允许完全在用户空间动态配置Gadget设备：创建Gadget、选择功能(Function)、设置USB属性（厂商ID、产品ID、字符串描述符）、绑定UDC、激活设备等。无需重新编译内核或加载模块（除了底层UDC和Function驱动本身）。
- Legacy GadgetFS: （较旧方式）另一个用户空间接口，通过挂载一个特殊的文件系统节点 (/dev/gadget) 来配置和控制Gadget。比configfs繁琐，渐少使用。
- FunctionFS (ffs): 一种特殊的Function驱动，允许在用户空间程序中实现USB接口逻辑（协议处理）。内核只处理标准描述符和端点通信，应用层通过libusbgadget或直接操作ep文件读写数据。非常灵活，用于实现自定义协议或复杂功能（如Android ADB、MTP）。
配置流程 (典型使用 configfs)
1. 挂载configfs (通常系统已挂载)。
2. 在 /sys/kernel/config/usb_gadget/ 下创建一个目录（如 g1），即创建了一个Gadget实例。
3. 在该目录下设置USB属性 (idVendor, idProduct, bcdDevice, strings/* 等)。
4. 创建所需的功能(Function) 目录 (如 mass_storage.usb0, ecm.usb0, ffs.adb)。这些目录通常链接到相应Function驱动的配置节点。
5. 配置具体的Function参数（如在 mass_storage.usb0 里设置 lun.0/file=/path/to/backing-file）。
6. 创建一个配置(Configuration) 目录 (如 configs/c.1)，并在其中创建指向所需Function的符号链接（如 ln -s ../../functions/mass_storage.usb0 configs/c.1/）。一个Gadget可以有多个配置（但主机通常只激活一个）。
7. 绑定UDC: 将Gadget关联到一个可用的USB Device控制器 (如 echo dwc3.0.auto > UDC)。这一步通常会自动启用USB连接。
8. 对于FunctionFS，通常在创建 ffs.[name] Function后，还需要挂载FunctionFS (mount -t functionfs [name] /mount/point) 并启动处理通信的用户空间程序。

启用USB Gadget支持

内核配置: 在内核源码中启用：
- CONFIG_USB_CONFIGFS (必需 - 支持configfs接口)
- CONFIG_USB_LIBCOMPOSITE (必需 - 基础库)
- 所需的UDC驱动 (如 CONFIG_USB_DWC2, CONFIG_USB_DWC3, CONFIG_USB_MUSB_HDRC)
- 所需的Function驱动 (如 CONFIG_USB_F_MASS_STORAGE, CONFIG_USB_F_ECM, CONFIG_USB_F_SERIAL, CONFIG_USB_F_HID, CONFIG_USB_F_FS)
加载模块: 如果未编译进内核，需要加载相应模块 (udc_core, libcomposite, usb_f_mass_storage, usb_f_acm, 具体的UDC驱动模块如 dwc3, dwc2 等)。

实用工具

lsusb (在主机端运行): 主机连接后，在主机上运行此命令查看识别到的USB设备信息和描述符。
usbhid-dump (主机端): 调试HID Gadget通信。
tcpdump/wireshark (主机端或设备端): 抓取和分析USB数据包（需要特定USB嗅探硬件支持或设备端网络Gadget）。
libconfig:
- libusbg / libusbgx / gt: 用户空间库和工具（如 gt），用于通过程序或脚本更方便地配置configfs Gadget。

典型应用场景

嵌入式设备通过USB提供虚拟串口调试接口。
开发板模拟U盘，方便加载文件系统或更新固件。
树莓派/嵌入式设备通过USB连接共享网络（USB以太网）。
实现自定义USB HID设备（键盘、鼠标、游戏手柄）。
手机通过USB连接电脑启用ADB调试或MTP文件传输（内部使用FunctionFS）。
创建USB测试设备或协议分析工具。

总结

Linux USB Gadget驱动框架（特别是结合configfs和FunctionFS）提供了强大的灵活性，使Linux设备能够轻松扮演各种USB从设备的角色。开发者可以通过内核配置和用户空间脚本/程序动态创建和配置复杂的复合USB设备，极大地简化了USB从设备功能的开发。理解UDC、Function驱动、configfs和FunctionFS是掌握该技术的关键。