4. UHCI 基地址寄存器 (USBBase) 解析

USBBase 寄存器是 UHCI 控制器在 PCI 配置空间中暴露给软件的唯一“门牌号”。通过它，驱动程序才能将控制器的 MMIO 寄存器窗口映射到系统的内存地址空间，进而访问 Frame List Base Address Register (FLBASEADD) 等关键寄存器。本节将深入解析 USBBase 的位定义、对齐约束以及基地址的计算方法。

4.1 USBBase 寄存器位定义

USBBase 位于 PCI 配置空间的偏移 0x20 处，宽度为 32 位。其位字段定义如下表所示：

4.2 内存映射 I/O 基地址计算

从 USBBase 寄存器提取有效基地址的步骤非常直接：

1. 读取原始值： 从 PCI 配置空间偏移 0x20 处读取 32 位值。
2. 掩码低 12 位： 将读取的值与 0xFFFFF000 进行按位与运算，清除低 12 位。
3. 得到基地址： 结果即为 UHCI 寄存器组的 MMIO 基地址。

// C 语言示例：从 PCI 配置空间读取 USBBase 并计算基地址
uint32_t usb_base_raw = pci_config_read32(pci_bus, pci_dev, pci_func, 0x20);
uint32_t uhci_mmio_base = usb_base_raw & 0xFFFFF000;

// 此时 uhci_mmio_base 即为 UHCI 控制器的 MMIO 基地址
// 例如：FLBASEADD 寄存器的地址为 uhci_mmio_base + 0x08
volatile uint32_t *flbaseadd = (volatile uint32_t *)(uhci_mmio_base + 0x08);

4.3 地址对齐与区域大小验证

UHCI 控制器要求其 MMIO 区域必须 4KB 对齐，且大小固定为 32 字节。驱动程序在获取基地址后，应验证以下条件：

• 对齐检查： uhci_mmio_base % 4096 == 0，确保低 12 位为 0。
• 区域不重叠： 确保映射范围 [uhci_mmio_base, uhci_mmio_base + 32) 不与其它已映射设备冲突。
• 非零检查： 如果读取的原始值为 0xFFFFFFFF 或 0x00000000，说明设备未正确枚举或未分配资源。

4.4 USBBase 到寄存器窗口的映射关系

下图展示了从 USBBase 解析出的基地址如何映射到 UHCI 寄存器组的完整视图：

4.5 初始化阶段的编程优化策略

在 UHCI 控制器初始化阶段，针对 USBBase 的编程优化主要集中在减少 PCI 总线访问和提前验证地址有效性上：

// 优化后的初始化代码片段
typedef struct {
    uint32_t mmio_base;
    volatile uint32_t *regs;  // 指向映射后的虚拟地址
} uhci_controller_t;

int uhci_init(uhci_controller_t *hc, uint8_t bus, uint8_t dev, uint8_t func) {
    uint32_t raw = pci_config_read32(bus, dev, func, 0x20);
    
    // 快速失败：检查全 1 或全 0
    if (raw == 0xFFFFFFFF || raw == 0x00000000) {
        return -1; // 设备未分配资源
    }
    
    uint32_t base = raw & 0xFFFFF000;
    
    // 对齐检查
    if (base % 4096 != 0) {
        return -2; // 对齐错误
    }
    
    // 映射整个 32 字节 MMIO 窗口
    hc->mmio_base = base;
    hc->regs = (volatile uint32_t *)ioremap(base, 32);
    if (!hc->regs) {
        return -3; // 映射失败
    }
    
    // 现在可以通过 hc->regs[2] 访问 FLBASEADD (偏移 0x08 / 4)
    return 0;
}