4. xHCI调试能力寄存器

xHCI 的调试能力（Debug Capability）是专为 USB 2.0 高速事务捕获与性能分析设计的硬件扩展。它通过一组独立的寄存器集合，提供了对 USB 总线的非侵入式监控能力。本章将深入解析四个核心调试寄存器：DCCTRL（调试控制）、DCST（调试状态）、DCPORTSC（调试端口状态与控制）和 DCCP（调试上下文指针）。

4.1 DCCTRL（Debug Capability Control Register）

DCCTRL 是调试能力的“总开关”，控制调试端口的使能、复位以及调试模式选择。其位宽为 32 位，偏移地址相对于调试能力基地址为 0x00。

4.2 DCST（Debug Capability Status Register）

DCST 寄存器反映调试端口的当前状态，包括连接状态、错误标志和缓冲区状态。偏移地址为 0x04。

4.3 DCPORTSC（Debug Capability Port Status and Control Register）

DCPORTSC 是调试端口的状态与控制寄存器，直接映射到 USB 2.0 高速物理层信号。偏移地址为 0x08。它提供了比标准 PORTSC 更细粒度的调试信息，包括高速信号质量、数据线状态和事务计时。

4.4 DCCP（Debug Capability Context Pointer Register）

DCCP 寄存器指向调试上下文数据结构（Debug Context Data Structure），该结构定义了捕获缓冲区的基地址、大小和当前读写指针。偏移地址为 0x0C。DCCP 是调试能力实现 DMA 传输的核心。

调试上下文数据结构包含以下关键字段：

• BufferBase[63:0]：捕获缓冲区的物理基地址，必须 4KB 对齐。
• BufferSize[31:0]：缓冲区大小（字节），最大支持 4GB。
• WritePointer[63:0]：硬件写入指针，指向下一个可写入位置。
• ReadPointer[63:0]：软件读取指针，指向下一个可读取位置。
• Control[31:0]：控制字段，包括中断使能、循环模式等。

4.5 寄存器操作示例代码

以下代码展示了如何通过 MMIO 访问 xHCI 调试能力寄存器，初始化调试端口并启动捕获：

// 假设 xHCI 基地址为 xhci_base，调试能力偏移为 debug_cap_offset
uint32_t *dcctrl = (uint32_t *)(xhci_base + debug_cap_offset + 0x00);
uint32_t *dcst   = (uint32_t *)(xhci_base + debug_cap_offset + 0x04);
uint32_t *dcportsc = (uint32_t *)(xhci_base + debug_cap_offset + 0x08);
uint64_t *dccp  = (uint64_t *)(xhci_base + debug_cap_offset + 0x0C);

// 1. 复位调试能力
*dcctrl |= (1 << 2);  // 置位 DCR
while (*dcctrl & (1 << 2));  // 等待硬件清零

// 2. 配置调试上下文（假设已分配 64KB 缓冲区）
debug_context_t *ctx = (debug_context_t *)alloc_dma_mem(64 * 1024);
ctx->buffer_base = (uint64_t)ctx + sizeof(debug_context_t);
ctx->buffer_size = 64 * 1024 - sizeof(debug_context_t);
ctx->write_ptr = 0;
ctx->read_ptr = 0;
ctx->control = 0x01;  // 使能循环模式

*dccp = (uint64_t)ctx;  // 设置上下文指针

// 3. 设置捕获模式为“仅捕获”
*dcctrl = (*dcctrl & ~0x03) | 0x01;  // DCM = 01b

// 4. 使能调试端口
*dcctrl |= (1 << 3);  // DCE = 1

// 5. 检查状态
if (*dcst & (1 << 4)) {
    printf("端口错误，请检查连接\n");
    *dcst |= (1 << 4);  // 清除错误标志
}

// 6. 等待端口就绪
while ((*dcst & 0x0F) != 0x08);  // PortStatus == 就绪

printf("调试端口已就绪，开始捕获...\n");

4.6 寄存器对比总结