3. Linux内核USB核心数据结构详解

USB子系统在Linux内核中通过四个核心数据结构来抽象物理设备、逻辑功能、传输端点和I/O请求。理解usb_device、usb_interface、usb_host_endpoint和urb是编写USB驱动的基础，也是分析枚举流程的关键。

3.1 usb_device —— USB设备的软件抽象

usb_device是内核中代表一个物理USB设备的核心结构体，定义在include/linux/usb.h中。每个连接到USB总线上的设备（包括Hub）都会对应一个usb_device实例。

struct usb_device {
    int devnum;                     // 设备地址（1-127）
    enum usb_device_state state;    // 设备状态：ATTACHED/POWERED/DEFAULT/ADDRESS/CONFIGURED/SUSPENDED
    enum usb_device_speed speed;    // 速度：USB_SPEED_LOW/FULL/HIGH/SUPER/SUPER_PLUS
    unsigned int route;             // 拓扑路径位图（USB 3.0+）
    struct usb_device *parent;      // 父设备（Hub）
    struct usb_device **children;   // 子设备数组（Hub端口）
    struct usb_device_descriptor descriptor; // 设备描述符
    struct usb_host_config *config; // 当前激活的配置
    struct usb_host_config *rawdescriptors; // 原始配置描述符
    unsigned short bus_mA;          // 总线供电电流（mA）
    u8 portnum;                     // 父Hub上的端口号
    u8 level;                       // 拓扑深度
    struct device dev;              // 内核通用设备结构
    struct usb_bus *bus;            // 所属USB总线
};

3.2 usb_interface —— 逻辑功能单元

usb_interface是USB设备中一个独立功能的抽象。一个USB配置（Configuration）可以包含多个接口（Interface），每个接口对应一个逻辑功能，例如一个复合设备可能包含键盘接口和音频接口。

struct usb_interface {
    struct usb_host_interface *altsetting;    // 当前激活的备用设置
    struct usb_host_interface *cur_altsetting; // 当前备用设置指针
    unsigned num_altsetting;                  // 备用设置数量
    struct usb_interface_descriptor desc;     // 接口描述符
    struct device dev;                        // 内核通用设备结构
    struct usb_device *usb_dev;               // 所属usb_device
    int minor;                                // USB major号（用于usbfs）
};

3.3 usb_host_endpoint —— 传输端点描述

usb_host_endpoint封装了USB端点的硬件属性和内核管理信息。每个端点对应设备端的一个数据缓冲区，驱动通过端点进行数据收发。

struct usb_host_endpoint {
    struct usb_endpoint_descriptor desc;      // 端点描述符（地址、属性、最大包大小）
    struct list_head urb_list;                // 挂起的URB链表
    void *hcpriv;                             // Host Controller私有数据
    struct ep_device *ep_dev;                 // sysfs端点设备
    unsigned char *extra;                     // 额外描述符
    int enabled;                              // 端点使能标志
};

3.4 urb —— USB请求块

urb（USB Request Block）是USB数据传输的基本载体，类似于网络协议栈中的sk_buff。驱动通过构造并提交URB来发起一次USB传输。

struct urb {
    struct list_head urb_list;           // 链表节点
    struct usb_device *dev;              // 目标设备
    unsigned int pipe;                   // 管道信息（端点+方向+类型）
    int status;                          // 传输状态
    unsigned int transfer_flags;         // 传输标志
    void *transfer_buffer;               // 数据缓冲区
    dma_addr_t transfer_dma;             // DMA地址
    int transfer_buffer_length;          // 缓冲区长度
    int actual_length;                   // 实际传输长度
    int interval;                        // 中断/等时传输间隔
    int error_count;                     // 等时传输错误计数
    void *context;                       // 完成回调上下文
    usb_complete_t complete;             // 完成回调函数
    int number_of_packets;               // 等时传输包数量
    struct usb_iso_packet_descriptor iso_frame_desc[]; // 等时帧描述符
};

3.5 四者关系总结

四个核心数据结构在USB驱动栈中的层次关系如下：