2. USB中断端点描述符：关键字段解析

中断端点（Interrupt Endpoint）是USB设备向主机主动上报事件的核心通道，其描述符中的四个字段——bEndpointAddress、bmAttributes、wMaxPacketSize、bInterval——共同决定了中断传输的行为、带宽和实时性。本章逐字段拆解其位定义、取值规则及驱动开发中的常见陷阱。

2.1 字段总览与结构

中断端点描述符在USB规范中属于标准端点描述符（Standard Endpoint Descriptor），长度为7字节。下表列出所有字段及其在驱动开发中的核心作用：

2.2 bEndpointAddress：端点地址与方向

bEndpointAddress 是一个位掩码字段，低4位表示端点号，最高位（Bit 7）表示方向。驱动开发中必须严格区分IN和OUT端点：

• Bit 7 = 1：IN端点（设备→主机），用于读取中断数据。
• Bit 7 = 0：OUT端点（主机→设备），用于发送控制或数据。
• Bit 6–4：保留位，必须为0。
• Bit 3–0：端点号（0x00–0x0F），同一方向下端点号必须唯一。

/* Linux内核宏定义示例 */
#define USB_DIR_OUT         0
#define USB_DIR_IN          0x80

/* 解析bEndpointAddress */
unsigned int ep_addr = desc->bEndpointAddress;
unsigned int ep_num  = ep_addr & 0x0F;
unsigned int ep_dir  = ep_addr & USB_DIR_IN;

if (ep_dir) {
    printk("中断IN端点，端点号: %d\n", ep_num);
} else {
    printk("中断OUT端点，端点号: %d\n", ep_num);
}

2.3 bmAttributes：传输类型标识

bmAttributes 的低2位标识传输类型，中断端点的该字段值必须为 0x03。高6位在USB 2.0及之前版本中保留为0，USB 3.x中用于标识同步类型和用法。

2.4 wMaxPacketSize：最大包长与带宽预算

wMaxPacketSize 是2字节字段，定义了中断端点在单个微帧（或帧）中能够传输的最大字节数。其值直接影响中断传输的带宽占用和驱动中的缓冲区分配。

• USB 2.0 全速（12 Mbps）：最大包长 ≤ 64 字节。
• USB 2.0 高速（480 Mbps）：最大包长 ≤ 1024 字节，支持3次微帧事务（bInterval 配合使用）。
• USB 3.x 超高速（5 Gbps+）：最大包长 ≤ 1024 字节，支持突发传输（Burst）。

/* 驱动中获取wMaxPacketSize的推荐方式 */
unsigned int max_pkt = le16_to_cpu(desc->wMaxPacketSize);

/* 分配URB缓冲区 */
urb->transfer_buffer = kmalloc(max_pkt, GFP_KERNEL);
urb->transfer_buffer_length = max_pkt;

2.5 bInterval：轮询间隔与实时性

bInterval 定义了主机轮询中断端点的时间间隔，是决定中断响应延迟的关键参数。不同USB速度下，bInterval 的单位和取值范围不同：

/* 驱动中计算实际轮询间隔 */
unsigned int interval = desc->bInterval;
unsigned int actual_ms;

switch (udev->speed) {
case USB_SPEED_LOW:
    actual_ms = interval * 10;  /* 10ms per frame */
    break;
case USB_SPEED_FULL:
    actual_ms = interval;       /* 1ms per frame */
    break;
case USB_SPEED_HIGH:
case USB_SPEED_SUPER:
    actual_ms = interval * 125 / 1000; /* 125µs per microframe */
    break;
default:
    actual_ms = interval;
}

printk("中断端点轮询间隔: %d ms\n", actual_ms);

2.6 四个字段的协同关系

中断端点的实际行为由四个字段共同决定，驱动开发中必须整体考虑：

• bEndpointAddress 确定数据流向和端点标识。
• bmAttributes 确保传输类型为中断。
• wMaxPacketSize 限制单次传输的数据量，影响缓冲区设计。
• bInterval 控制轮询频率，决定中断延迟和CPU占用。

2.7 驱动开发中的故障排查清单

当中断端点工作异常时，按以下顺序检查描述符字段：

1. 验证 bEndpointAddress：确认方向正确（IN端点使用 usb_rcvintpipe），端点号未与其他端点冲突。
2. 验证 bmAttributes：低2位必须为0x03，否则主机拒绝中断传输。
3. 验证 wMaxPacketSize：不超过速度等级限制，驱动缓冲区大小 ≥ 该值。
4. 验证 bInterval：高速设备取值范围1–16，低速/全速设备1–255，单位与速度匹配。
5. 使用工具验证：lsusb -v 查看原始描述符，usbmon 跟踪URB提交状态。