1. USB Gadget 框架概述

USB Gadget 框架是 Linux 内核中用于实现 设备端（Device/Peripheral） USB 功能的软件基础设施。它允许嵌入式设备（如开发板、手机、IoT 网关）通过 USB 接口模拟成键盘、鼠标、U 盘、网卡、串口等标准外设，从而与主机（Host）进行通信。

1.1 Gadget 框架在 Linux 内核中的位置

Gadget 框架位于 Linux 内核的 drivers/usb/gadget/ 目录下，与 Host 端驱动栈并列，但运行在完全不同的角色模式中。下图展示了 Gadget 框架在整个 USB 软件栈中的层级关系：

1.2 Gadget 框架的核心作用

Gadget 框架解决了嵌入式设备“如何被主机识别并通信”的问题。其核心作用可归纳为以下四点：

1.3 Gadget 框架的基本架构

Gadget 框架采用 分层 + 模块化 设计，从上到下依次为：Function 驱动层 → Gadget 核心层 → UDC 驱动层。各层职责清晰，通过标准 API 进行交互。

1.4 各层职责详解

1.4.1 Function 驱动层

Function 驱动是 Gadget 框架中最接近应用逻辑的层次。每个 Function 驱动实现一种具体的 USB 外设功能，例如：

• g_ether：实现 USB 以太网卡（支持 ECM、RNDIS、EEM 等协议）
• g_serial：实现 USB 虚拟串口（ACM 类）
• g_mass_storage：实现 USB 大容量存储设备（U 盘）
• g_hid：实现 USB HID 设备（键盘、鼠标、游戏手柄）
• g_audio：实现 USB 音频设备（UAC）

Function 驱动需要完成：定义设备/配置/接口/端点描述符、注册端点、实现数据传输回调函数。

1.4.2 Gadget 核心层

核心层是框架的“中枢神经系统”，主要提供以下能力：

1.4.3 UDC 驱动层

UDC（USB Device Controller）驱动是直接操作硬件控制器的底层驱动。不同 SoC 厂商的 USB 控制器差异较大，因此 UDC 驱动需要针对具体硬件实现：

• 端点寄存器配置与 FIFO 管理
• 中断处理（连接/断开、端点传输完成、复位等）
• DMA 传输支持（如 DWC3 支持 Scatter-Gather DMA）
• 电源管理（挂起/恢复）

1.5 Gadget 框架的数据流

理解数据在 Gadget 框架中的流动路径，对后续开发虚拟网卡驱动至关重要。以 USB 虚拟网卡为例，数据流如下：

1.6 本章小结

USB Gadget 框架是 Linux 设备端 USB 功能的核心基础设施，其分层架构（Function 层 → 核心层 → UDC 层）实现了功能与硬件的解耦。在本课程后续章节中，我们将深入 g_ether 驱动的实现细节，从零开始构建一个完整的 USB 虚拟网卡驱动。