3. Capability Registers 详解：HCCPARAMS、HCCSPARAMS、HCSPARAMS、DCIVERSION 的结构与位域含义

EHCI 主机控制器的寄存器空间分为两部分：Capability Registers（能力寄存器）和Operational Registers（操作寄存器）。Capability Registers 位于基地址偏移 0x00 处，用于描述控制器的硬件能力、版本信息、端口数量等静态属性。驱动在初始化阶段必须首先读取这些寄存器，以确定后续操作寄存器的基地址和可用资源。

本章聚焦于四个核心能力寄存器：HCCPARAMS、HCCSPARAMS、HCSPARAMS 和 DCIVERSION。理解它们的位域布局是编写正确 EHCI 驱动的第一步。

3.1 能力寄存器整体布局

EHCI 规范定义的能力寄存器从基地址偏移 0x00 开始，其布局如下表所示：

驱动通过读取 CAPLENGTH 寄存器（偏移 0x00）获取操作寄存器的起始偏移量，然后才能访问 USBCMD、USBSTS 等操作寄存器。

3.2 HCSPARAMS — 结构参数寄存器

HCSPARAMS（Host Controller Structural Parameters）位于偏移 0x04，32 位宽度。它描述了控制器的物理结构特性，包括端口数量、端口路由逻辑等。

端口路由机制（PORTROUTE 位）对于支持 USB 1.1/2.0 分频的控制器至关重要。当 EHCI 控制器将端口所有权交给 companion 控制器时，路由逻辑决定哪个 companion 接管该端口。

3.3 HCCPARAMS — 能力参数寄存器

HCCPARAMS（Host Controller Capability Parameters）位于偏移 0x08，32 位宽度。它描述了控制器的高级能力特性，如 64 位寻址支持、异步/周期性调度能力、调试端口等。

EECP 字段是 EHCI 扩展能力链的入口点。常见的扩展能力包括：

• USB Legacy Support（能力 ID = 0x01）：用于 BIOS 与操作系统之间的 EHCI 所有权切换。
• Port Indicator（能力 ID = 0x02）：提供端口指示灯控制。
• Debug Port（能力 ID = 0x0A）：提供调试端口功能。

3.4 DCIVERSION — 调试端口接口版本寄存器

DCIVERSION（Debug Control Interface Version）位于偏移 0x0C，16 位宽度。该寄存器为可选寄存器，仅当 HCCPARAMS[17]（DCP 位）为 1 时才有效。

调试端口允许通过 USB 进行内核调试。驱动在检测到 DCP=1 后，应读取 DCIVERSION 以确定调试接口的协议版本，然后通过扩展能力链中的 Debug Port 能力寄存器配置调试功能。

3.5 驱动初始化中的寄存器读取顺序

在 EHCI 驱动初始化阶段，读取 Capability Registers 的典型顺序如下：

1. 读取 CAPLENGTH（偏移 0x00）：获取操作寄存器基地址偏移量。
2. 读取 HCIVERSION（偏移 0x02）：验证接口版本是否为 1.0（0x0100）。
3. 读取 HCSPARAMS（偏移 0x04）：获取端口数量 N_PORTS 和 companion 控制器信息。
4. 读取 HCCPARAMS（偏移 0x08）：获取 64 位寻址能力、帧列表大小、中断阈值和扩展能力指针。
5. 如果 HCCPARAMS[17]=1，读取 DCIVERSION（偏移 0x0C）以获取调试端口版本。
6. 遍历扩展能力链：从 EECP 字段开始，处理 Legacy Support、Debug Port 等能力。

以下是一个简化的 C 代码示例，展示如何读取这些寄存器：

/* 假设 base 为能力寄存器基地址（MMIO 映射后的虚拟地址） */
u8 cap_length = ehci_readb(base, 0x00);
u16 hci_version = ehci_readw(base, 0x02);
u32 hcs_params = ehci_readl(base, 0x04);
u32 hcc_params = ehci_readl(base, 0x08);

/* 提取关键字段 */
int n_ports = hcs_params & 0xF;
int adc64 = (hcc_params >> 0) & 0x1;
int ist = (hcc_params >> 3) & 0x3;
int eecp = (hcc_params >> 8) & 0xFF;
int dcp = (hcc_params >> 17) & 0x1;

/* 操作寄存器基地址 */
void __iomem *op_regs = base + cap_length;

/* 如果支持调试端口，读取 DCIVERSION */
if (dcp) {
    u16 dci_version = ehci_readw(base, 0x0C);
    pr_info("EHCI Debug Port version: %x.%x\n",
            (dci_version >> 8) & 0xF, dci_version & 0xF);
}

/* 遍历扩展能力链 */
while (eecp != 0) {
    u32 ext_cap = ehci_readl(base, eecp);
    u8 cap_id = ext_cap & 0xFF;
    u8 next = (ext_cap >> 8) & 0xFF;
    /* 根据 cap_id 处理对应能力 */
    eecp = next;
}

3.6 常见问题与调试技巧