2. UHCI 主控制器寄存器模型详解

UHCI（Universal Host Controller Interface）主控制器通过一组 PCI 基地址寄存器（Base Address Register, BAR） 映射到系统内存或 I/O 空间。驱动开发者必须精确理解每个寄存器的位定义、访问时序和复位状态，才能正确初始化控制器、调度传输帧和处理中断。本节将逐一剖析 UHCI 寄存器布局中的关键寄存器。

2.1 寄存器整体布局与基地址

UHCI 主控制器占用 32 字节连续的 I/O 空间（或内存映射空间），起始地址由 PCI 配置空间中的 BAR0 提供。驱动在枚举 PCI 设备时读取 BAR0，获取基地址后即可通过 inl/outl（I/O 空间）或 ioread32/iowrite32（内存映射）访问所有寄存器。

2.2 USBCMD — USB 命令寄存器（偏移 0x00）

USBCMD 是驱动控制主机控制器的核心寄存器。驱动通过写入该寄存器启动/停止控制器、触发全局复位、配置帧列表大小。

2.3 USBSTS — USB 状态寄存器（偏移 0x02）

USBSTS 反映主机控制器的实时状态和中断事件。驱动在中断服务例程（ISR）中读取该寄存器判断中断原因，并在处理完成后写 1 清除对应位。

2.4 USBINTR — 中断使能寄存器（偏移 0x04）

USBINTR 控制哪些 USBSTS 状态位能够产生中断信号。驱动在初始化阶段根据需求使能对应中断源。

2.5 FRNUM — 帧号寄存器（偏移 0x06）

FRNUM 是一个 10 位计数器（Bit 0–9），每 1 ms 递增一次，值范围 0–1023。主机控制器使用帧号索引帧列表，决定当前帧要处理的传输描述符链表。

• 只读属性： 驱动只能读取 FRNUM，不能写入。写入操作被硬件忽略。
• 与帧列表的关系： 帧列表包含 1024 个表项，FRNUM 的低 10 位作为索引，选择当前帧对应的帧列表项。
• 调试用途： 驱动可通过轮询 FRNUM 判断帧是否推进，验证控制器是否正常运行。如果 FRNUM 长时间不变，说明控制器可能挂起或未启动。

2.6 FLBASEADD — 帧列表基地址寄存器（偏移 0x08）

FLBASEADD 存储帧列表在系统物理内存中的起始地址。帧列表必须 4 KB 对齐（即地址低 12 位为 0），因为帧列表包含 1024 个 4 字节的表项，正好占用 4 KB。

2.7 SOF — 起始帧修正寄存器（偏移 0x0C）

SOF 寄存器用于微调 SOF（Start of Frame）包的发送时机。UHCI 规范要求每帧开始时发送 SOF 包，但不同 USB 总线拓扑可能导致传播延迟差异。SOF 寄存器允许驱动调整 SOF 包的发送偏移量。

• 默认值： 0x40（64 位时间）对应约 2.67 µs（USB 全速 12 Mbps，每位 83.3 ns）。
• 调整场景： 当 USB 总线过长或级联集线器过多时，可适当增大 SOF 修正值，确保下游设备有足够时间准备接收数据。
• 调试建议： 在批量传输出现间歇性超时时，尝试调整 SOF 值（如 0x50 或 0x60）可能改善时序裕量。

2.8 PORTSC — 端口状态与控制寄存器（偏移 0x10–0x1F）

每个 UHCI 控制器最多支持 2 个端口，每个端口对应一个 PORTSC 寄存器，偏移地址分别为 0x10 和 0x12。PORTSC 是驱动与物理 USB 端口交互的主要接口。