2. USB核心数据结构：usb_device、usb_interface、usb_host_endpoint 结构体详解

在USB主机侧驱动开发中，理解内核如何描述USB设备是编写正确URB（USB Request Block）的前提。Linux USB核心使用三个层级分明的结构体来抽象物理设备：usb_device（设备级）、usb_interface（接口级）和usb_host_endpoint（端点级）。本章将逐一拆解这三个结构体的核心字段、层级关系以及它们在批量传输配置中的实际作用。

2.1 结构体层级关系总览

在深入每个结构体之前，先通过一张层级关系图建立整体认知。USB设备在枚举完成后，内核会构建如下数据结构链：

2.2 usb_device：设备级抽象

usb_device 是USB子系统中最顶层的结构体，代表一个物理USB设备。它在设备插入时由USB核心分配，并在设备断开时释放。驱动开发中通常通过 interface_to_usbdev() 宏从接口指针获取设备指针。

2.3 usb_interface：驱动绑定的核心单元

usb_interface 是USB驱动开发中最常接触的结构体。USB设备的一个接口对应一个逻辑功能（如键盘、鼠标、音频流），驱动通过 usb_driver 的 probe() 回调获得接口指针。批量传输端点通常属于某个接口的备用设置（alternate setting）。

获取当前接口的端点信息，通常通过 interface->cur_altsetting->endpoint 数组访问。下面的代码片段展示了如何在probe函数中遍历批量端点：

static int my_usb_probe(struct usb_interface *interface,
                        const struct usb_device_id *id)
{
    struct usb_host_interface *iface_desc;
    struct usb_endpoint_descriptor *endpoint;
    int i;

    // 获取当前激活的备用设置
    iface_desc = interface->cur_altsetting;

    // 遍历该接口下的所有端点
    for (i = 0; i < iface_desc->desc.bNumEndpoints; i++) {
        endpoint = &iface_desc->endpoint[i].desc;

        // 检查是否为批量传输端点
        if (usb_endpoint_is_bulk_in(endpoint)) {
            dev_info(&interface->dev, "Found bulk IN endpoint\n");
            // 保存端点地址和最大包长度
            bulk_in_ep = usb_endpoint_num(endpoint);
            bulk_in_maxp = usb_endpoint_maxp(endpoint);
        }
        if (usb_endpoint_is_bulk_out(endpoint)) {
            dev_info(&interface->dev, "Found bulk OUT endpoint\n");
            bulk_out_ep = usb_endpoint_num(endpoint);
            bulk_out_maxp = usb_endpoint_maxp(endpoint);
        }
    }
    return 0;
}

2.4 usb_host_endpoint：URB提交的目标

usb_host_endpoint 是USB端点在内核中的完整表示，包含了描述符信息、URB队列和调度状态。批量传输URB最终被提交到某个端点，由主机控制器调度执行。

端点描述符 usb_endpoint_descriptor 是硬件层面的描述，其关键字段解析如下：

内核提供了便捷的宏来解析端点描述符，避免手动位操作：

// 判断端点类型和方向
usb_endpoint_is_bulk_in(epd)    // 是否为批量IN端点
usb_endpoint_is_bulk_out(epd)   // 是否为批量OUT端点
usb_endpoint_is_int_in(epd)     // 是否为中断IN端点
usb_endpoint_xfer_bulk(epd)     // 是否为批量传输（不分方向）

// 获取端点号和最大包长度
usb_endpoint_num(epd)           // 返回端点号（0-15）
usb_endpoint_maxp(epd)          // 返回wMaxPacketSize值
usb_endpoint_type(epd)          // 返回传输类型枚举值

2.5 批量传输端点配置实战流程

结合上述三个结构体，配置批量传输端点的完整流程如下：

1. 获取接口指针： 在驱动的 probe() 回调中，参数 struct usb_interface *interface 即为当前接口。
2. 获取当前备用设置： 通过 interface->cur_altsetting 获取当前激活的接口描述符。
3. 遍历端点数组： 从 cur_altsetting->endpoint 数组（大小为 desc.bNumEndpoints）中逐个检查。
4. 识别批量端点： 使用 usb_endpoint_is_bulk_in/out() 宏判断端点类型。
5. 保存端点信息： 记录端点地址（用于URB的 pipe 构造）和最大包长度（用于缓冲区对齐）。
6. 构造URB并提交： 使用 usb_fill_bulk_urb() 填充URB，指定目标端点pipe。

下面的SVG图展示了从设备枚举到URB提交的完整数据流：

2.6 结构体关系总结

下表总结了三个核心结构体在批量传输配置中的角色分工：