3. 调试端口寄存器详解：DBCTL 与 DBSTATUS 位定义

UHCI 调试端口通过两个核心寄存器——调试端口控制寄存器 (DBCTL) 和 调试端口状态寄存器 (DBSTATUS)——实现主机与调试设备之间的带外通信。理解每一位的硬件行为是编写高效调试固件、定位 USB 总线故障的前提。本章逐位解析这两个寄存器的布局、功能及典型应用场景。

3.1 调试端口控制寄存器 (DBCTL)

DBCTL 位于 I/O 空间偏移 0x04，宽度 8 位。主机通过写该寄存器发起调试操作、复位调试端口或控制数据流方向。

位	名称	访问	默认值	功能描述
7	Rsvd	RO	0	保留位，必须写 0
6	DB_GO	R/W	0	启动调试事务：写 1 触发一次调试读/写序列
5	DB_RD	R/W	0	读/写方向选择：1=读（设备→主机），0=写（主机→设备）
4	Rsvd	RO	0	保留位，必须写 0
3:0	DB_DATA[3:0]	R/W	0h	调试数据/地址字段：写事务时携带 4 位数据；读事务时指定寄存器地址

3.1.1 DBCTL 操作流程

1. 写事务：设置 DB_RD=0，将 4 位数据写入 DB_DATA[3:0]，置位 DB_GO=1。
2. 读事务：设置 DB_RD=1，将目标寄存器地址写入 DB_DATA[3:0]，置位 DB_GO=1。
3. 等待完成：轮询 DB_GO 直到硬件自动清 0（典型延迟 2–10 µs）。
4. 读结果：读 DBSTATUS 获取返回数据或错误标志。

3.2 调试端口状态寄存器 (DBSTATUS)

DBSTATUS 位于 I/O 空间偏移 0x05，宽度 8 位。主机通过读该寄存器获取调试事务的返回数据、错误标志和端口状态。

位	名称	访问	默认值	功能描述
7	DB_ERR	RO	0	调试事务错误标志：1=发生超时、位填充错或 CRC 错
6	DB_DONE	RO	0	调试事务完成标志：1=当前事务已结束，数据有效
5	Rsvd	RO	0	保留位
4	DB_PID_ERR	RO	0	PID 校验错误：调试设备返回的 PID 字节校验失败
3:0	DB_DATA[3:0]	RO	0h	读事务返回的 4 位数据；写事务返回 0h

3.3 寄存器交互流程与状态机

下图展示了主机通过 DBCTL 发起事务、硬件自动执行 USB 调试序列、最终更新 DBSTATUS 的完整状态机。理解该流程有助于定位轮询超时、数据错位等常见故障。

3.4 典型故障排查场景

故障现象	DBSTATUS 特征	根因分析	优化措施
轮询 DB_GO 永不归零	DB_DONE=0, DB_ERR=0	调试设备未响应；USB 总线挂起	增加超时机制（建议 50 ms），超时后复位调试端口
读回数据全为 0	DB_DONE=1, DB_ERR=0, DB_DATA=0h	读地址错误或设备未就绪	验证 DB_DATA 写入的地址；先写一次空事务唤醒设备
频繁 DB_ERR=1	DB_DONE=1, DB_ERR=1	电气噪声；时钟偏差；线缆过长	降低调试速率；增加重试次数；检查 USB 信号完整性
DB_PID_ERR 间歇置位	DB_PID_ERR=1, DB_DATA 随机	调试设备固件 PID 处理异常	升级设备固件；在主机侧增加 PID 重校验

3.5 寄存器编程示例

以下代码演示了使用 DBCTL/DBSTATUS 实现调试读事务的标准流程，包含超时保护和错误处理。

/* 调试端口 I/O 基地址 */
#define UHCI_DBCTL    0x04
#define UHCI_DBSTATUS 0x05

/* DBCTL 位掩码 */
#define DB_GO   (1 << 6)
#define DB_RD   (1 << 5)

/* DBSTATUS 位掩码 */
#define DB_ERR      (1 << 7)
#define DB_DONE     (1 << 6)
#define DB_PID_ERR  (1 << 4)

/* 超时计数（约 50 ms @ 1 µs 循环） */
#define DB_TIMEOUT  50000

/**
 * @brief 通过调试端口读取 4 位数据
 * @param base   UHCI 寄存器基地址
 * @param addr   目标寄存器地址（0-15）
 * @param data   输出数据指针
 * @return 0=成功, -1=超时, -2=协议错误
 */
int db_read(uint32_t base, uint8_t addr, uint8_t *data)
{
    uint32_t timeout;
    uint8_t  status;

    /* 步骤1：写 DBCTL，发起读事务 */
    outb(base + UHCI_DBCTL, DB_GO | DB_RD | (addr & 0x0F));

    /* 步骤2：轮询 DB_GO 清 0（或 DB_DONE 置位） */
    timeout = DB_TIMEOUT;
    while ((inb(base + UHCI_DBCTL) & DB_GO) && timeout) {
        timeout--;
    }
    if (timeout == 0) {
        return -1;  /* 超时 */
    }

    /* 步骤3：读 DBSTATUS，先检查错误 */
    status = inb(base + UHCI_DBSTATUS);
    if (status & DB_ERR) {
        return -2;  /* 协议错误 */
    }
    if (status & DB_PID_ERR) {
        return -2;  /* PID 校验错误 */
    }

    /* 步骤4：提取有效数据 */
    *data = status & 0x0F;
    return 0;
}

3.6 寄存器位定义速查表

下表汇总了 DBCTL 和 DBSTATUS 所有位的访问属性、复位值及用途，方便调试时快速参考。

寄存器	位域	位号	访问	复位值	用途分类
DBCTL	DB_GO	6	R/W	0	事务触发
	DB_RD	5	R/W	0	方向控制
	DB_DATA[3:0]	3:0	R/W	0h	数据/地址
DBSTATUS	DB_ERR	7	RO	0	错误指示
	DB_DONE	6	RO	0	完成指示
	DB_PID_ERR	4	RO	0	PID 错误
	DB_DATA[3:0]	3:0	RO	0h	返回数据