4. 端点（Endpoint）概念详解：方向、类型与描述符

端点是 USB 通信中最基本的逻辑单元，也是主机与设备之间数据传输的终点。每个 USB 设备可以包含多个端点，每个端点都有唯一的方向、类型和传输特性。理解端点的完整概念是掌握 URB 编程与驱动开发的基础。

4.1 端点方向：IN 与 OUT

端点的方向是相对于主机而言的，这是 USB 协议中最重要的约定之一。方向由端点描述符中的 bEndpointAddress 字段的最高位（bit 7）标识：

• USB_DIR_IN（0x80）： 数据从设备传输到主机。主机通过 URB 读取设备数据。
• USB_DIR_OUT（0x00）： 数据从主机传输到设备。主机通过 URB 向设备写入数据。

4.2 端点类型：四种传输模式

USB 规范定义了四种端点类型，每种类型对应不同的传输特性、带宽保证和错误处理机制。端点类型由端点描述符中的 bmAttributes 字段的低 2 位决定。

4.3 端点描述符结构

端点描述符是 USB 描述符体系中的核心组成部分，它向主机报告端点的所有属性。在 Linux 内核中，端点描述符由结构体 struct usb_endpoint_descriptor 表示，定义在 <linux/usb/ch9.h> 中。

4.3.1 标准端点描述符字段

/* 从 usb_host_endpoint 中提取端点信息 */
struct usb_host_endpoint *ep = &interface->ep_desc[i];
struct usb_endpoint_descriptor *desc = &ep->desc;

/* 解析端点地址 */
unsigned int ep_num = desc->bEndpointAddress & USB_ENDPOINT_NUMBER_MASK;
unsigned int ep_dir = desc->bEndpointAddress & USB_ENDPOINT_DIR_MASK;

/* 解析端点类型 */
unsigned int ep_type = desc->bmAttributes & USB_ENDPOINT_XFERTYPE_MASK;

/* 获取最大包大小 */
unsigned int max_pkt = le16_to_cpu(desc->wMaxPacketSize);

/* 打印端点信息 */
printk(KERN_INFO "Endpoint: addr=0x%02x, num=%u, dir=%s, type=%s, max_pkt=%u\n",
       desc->bEndpointAddress,
       ep_num,
       ep_dir ? "IN" : "OUT",
       (ep_type == USB_ENDPOINT_XFER_CONTROL) ? "Control" :
       (ep_type == USB_ENDPOINT_XFER_BULK) ? "Bulk" :
       (ep_type == USB_ENDPOINT_XFER_INT) ? "Interrupt" : "Isochronous",
       max_pkt);

4.4 端点 0 的特殊性

每个 USB 设备必须包含一个默认的控制端点——端点 0。它是双向的，同时支持 IN 和 OUT 传输，用于设备枚举、标准请求（如 Get Descriptor、Set Configuration）以及类特定命令。

• 唯一性： 端点 0 是设备上唯一一个在未配置状态下就可用的端点。
• 双向性： 与普通端点不同，端点 0 不需要区分 IN/OUT 地址，它使用同一个端点号处理双向通信。
• 驱动接口： Linux 内核提供 usb_control_msg() 函数专门用于端点 0 的控制传输，驱动开发者无需手动构造 URB。

4.5 端点与 URB 的映射关系

在驱动开发中，每个 URB 必须绑定到一个具体的端点。URB 的 pipe 字段编码了端点号、方向和类型，内核通过 pipe 值找到对应的硬件端点进行数据传输。