2. UHCI 寄存器架构基础

UHCI（Universal Host Controller Interface）寄存器的正确理解是调试端口性能调优的基石。本章将深入解析 UHCI 寄存器的 I/O 映射机制、访问方式以及关键寄存器的分类与功能，帮助你在故障排查中快速定位寄存器级问题。

2.1 UHCI 寄存器映射与 I/O 空间访问机制

UHCI 控制器通过 PCI 配置空间向系统报告其 I/O 基地址（Base Address Register, BAR）。所有控制与状态寄存器均映射到该 I/O 空间，CPU 通过 in/out 指令进行访问。与内存映射（MMIO）不同，I/O 空间访问具有严格顺序性，适合实时控制场景。

2.2 关键寄存器分类与功能详解

UHCI 寄存器按功能可分为 4 大类：控制类、状态类、帧管理类和中断类。下表列出了每个分类的核心寄存器及其偏移地址、宽度和用途。

2.3 控制与状态寄存器深度解析

USBCMD（命令寄存器） 是 UHCI 的“总开关”。其关键位域如下：

• Bit 0 (Run/Stop)： 1 = 运行，0 = 停止。调试时可通过写 0 暂停控制器，安全读取寄存器状态。
• Bit 1 (Host Controller Reset, HCRESET)： 软件复位，复位后所有寄存器恢复默认值。
• Bit 2 (Global Reset, GRESET)： 复位 USB 总线，影响所有下游设备。
• Bit 4 (Configured Flag, CF)： 由系统软件置位，表示帧列表已配置完成。
• Bit 7-6 (Frame List Size)： 00 = 1024 帧，01 = 256 帧，10 = 128 帧，11 = 64 帧。调试时建议使用 64 帧以降低内存占用。

USBSTS（状态寄存器） 提供实时状态反馈：

• Bit 0 (HCHalted)： 只读，1 表示控制器已停止。写 USBCMD 的 Run/Stop 位可改变此状态。
• Bit 1 (Host Controller Process Error, HCPE)： 致命错误，通常由帧列表或 TD 损坏引起。
• Bit 2 (Host Controller System Error, HCSE)： PCI 总线错误，需检查硬件连接。
• Bit 3 (Resume Detect, RD)： 检测到远程唤醒信号。
• Bit 4 (USB Error Interrupt, UEI)： USB 协议错误，如 CRC 校验失败。
• Bit 5 (Interrupt on Complete, IOC)： 传输完成中断标志。
• Bit 6 (Short Packet Interrupt, SPI)： 短包中断，用于批量/中断传输调试。

2.4 帧管理寄存器与端口状态寄存器

FLBASEADD（帧列表基地址寄存器） 指向内存中的帧列表，每个帧列表项（Frame List Pointer, FLP）指向一个传输描述符（TD）链。调试时需确认该地址是否 4 KB 对齐，且指向的内存区域可读写。

FRNUM（帧号寄存器） 每 1 ms 递增一次，用于索引帧列表。调试时可通过写 FRNUM 强制跳转到指定帧，实现“帧级单步调试”。

PORTSC（端口状态与控制寄存器） 每个端口对应一个 16 位寄存器，关键位域包括：

• Bit 0 (Current Connect Status, CCS)： 只读，1 表示设备已连接。
• Bit 1 (Connect Status Change, CSC)： 连接状态变化标志，写 1 清除。
• Bit 2 (Port Enabled/Disabled, PED)： 端口使能位，由硬件或软件控制。
• Bit 3 (Port Enable Change, PEC)： 使能状态变化标志。
• Bit 4 (Line Status, LS)： 差分线状态，用于低速/全速检测。
• Bit 5 (Port Reset, PR)： 写 1 复位端口，复位后自动清零。
• Bit 8 (Suspend, SUSP)： 挂起端口，进入低功耗模式。
• Bit 12 (Over Current Change, OCC)： 过流状态变化标志。

2.5 寄存器访问性能优化原则

在故障排查中，频繁读取寄存器可能引入延迟。以下优化原则可提升调试效率：

1. 批量读取： 使用 32 位 I/O 读取指令一次读取相邻寄存器（如 USBCMD + USBSTS + USBINTR 位于连续 6 字节内），减少 I/O 总线事务。
2. 缓存状态快照： 在中断服务程序中一次性读取所有关键寄存器到内存变量，避免多次 I/O 访问。
3. 避免轮询空转： 使用中断驱动方式替代忙等待轮询 USBSTS 的 IOC 位，降低 CPU 占用。
4. 帧列表大小选择： 调试阶段使用 64 帧（USBCMD 的 Bit 7-6 = 11），减少内存遍历时间。

// 示例：批量读取 UHCI 关键寄存器（32 位 I/O 访问）
// 假设基地址为 0xE000
uint16_t usbcmd, usbsts, usbintr;
uint32_t flbaseadd;

// 一次 32 位读取获取 USBCMD + USBSTS（偏移 0x00-0x03）
uint32_t cmd_status = _inpd(0xE000);
usbcmd  = (uint16_t)(cmd_status & 0xFFFF);
usbsts  = (uint16_t)((cmd_status >> 16) & 0xFFFF);

// 单独读取 USBINTR（偏移 0x04）
usbintr = _inpw(0xE004);

// 读取 FLBASEADD（偏移 0x08，32 位）
flbaseadd = _inpd(0xE008);

// 调试输出
printf("USBCMD=0x%04X, USBSTS=0x%04X, USBINTR=0x%04X, FLBASE=0x%08X\n",
       usbcmd, usbsts, usbintr, flbaseadd);