XHCI驱动枚举USB2设备时SET_CONFIGURATION请求触发Stall问题排查

定位问题的关键步骤 #

• 检查USB2端口重置的完整性
  确认端口重置后，XHCI PortStatus寄存器的PortEnabled位已置位、PortReset位已清除，且端口Speed字段识别为Full/Low Speed。USB2设备的标准重置时长需至少10ms，重置后需额外等待1ms让设备稳定，若重置不彻底，设备会处于异常状态，触发后续STALL。
• 验证设备地址的有效性
  通过控制传输发送GET_STATUS请求，读取设备实际地址，确认是否与AddressDevice命令中设置的地址一致。检查AddressDevice的输入上下文DeviceContext，确保DeviceAddress字段的5位掩码（XHCI规范定义设备地址为5位）配置正确，若地址未生效，SET_CONFIGURATION请求的目标设备无效，会返回STALL。
• 校验配置描述符的正确性
  核对读取到的配置描述符：
  • wTotalLength需覆盖所有关联的接口、端点描述符，确保描述符完整；
  • bConfigurationValue需与SET_CONFIGURATION请求的wValue参数完全匹配；
  • bmAttributes需符合设备实际能力（如误设远程唤醒但设备不支持，会触发STALL）。
• 排查上下文配置的一致性
  检查EvaluateContext和ConfigureEndpoint的上下文：
  • USB2端点的MaxPacketSize需严格匹配设备描述符/配置描述符（Full Speed批量端点最大64字节，Low Speed为8字节）；
  • EndpointType需与设备定义一致（如中断端点不能设为批量类型）；
  • 移除USB2端点上下文中的USB3专属字段（如Mult），避免控制器解析错误。
• 分析物理层传输流程
  用USB协议分析仪抓取SET_CONFIGURATION的完整传输：
  • 确认Setup Stage的数据包（请求类型、参数、长度）符合USB规范；
  • 检查Data Stage（若有）的数据传输是否正常；
  • 查看Status Stage的ACK是否被设备正确返回，若Setup包损坏，设备会返回STALL。
• 检查XHCI控制器的USB2兼容配置
  查看USBCMD、USBSTS寄存器，确认USB2 Legacy Support或EHCI Hand-off模式配置正确。部分XHCI控制器依赖EHCI兼容逻辑处理USB2设备，若配置错误会导致交互异常。

针对性修复建议 #

• 优化端口重置流程
  严格遵循USB规范：重置USB2端口后等待至少10ms，再等待PortStatus的PortReset位清除，最后额外等待1ms确保设备稳定。部分控制器需读取PortChangeStatus寄存器确认重置完成，避免提前执行后续命令。
• 修正地址与上下文同步逻辑
  确保AddressDevice命令的DeviceContext中DeviceAddress字段的掩码正确，命令执行后读取SlotStatus寄存器确认地址设置成功。更新输入上下文后，必须通过EvaluateContext命令同步控制器的上下文缓存，避免旧数据残留。
• 严格校验配置描述符
  读取配置描述符后，校验wTotalLength是否等于实际读取的字节数，若不匹配则重新读取完整描述符。SET_CONFIGURATION请求的wValue参数必须与配置描述符的bConfigurationValue完全一致，禁止使用0或无效值。
• 修正端点上下文配置
  针对USB2设备：
  • 端点MaxPacketSize严格按设备描述符设置；
  • 中断端点Interval字段符合USB2规范（Full Speed为1-255ms，Low Speed为10-255ms）；
  • 移除USB3专属字段，避免控制器解析错误。
• 调整XHCI控制器兼容设置
  若专有OS无需BIOS兼容，禁用XHCI的Legacy Support模式；确保EHCI控制器已被正确禁用，避免总线冲突。检查USB2PortStatus寄存器的LinkTrainingSuccess位，确认USB2端口链路训练完成。
• 隔离问题环节
  跳过ConfigureEndpoint命令，直接发送SET_CONFIGURATION请求（仅Setup+Status阶段）：
  • 若设备返回ACK，说明问题出在ConfigureEndpoint的上下文配置；
  • 若仍返回STALL，说明设备地址未生效或设备不支持该配置。

内容的提问来源于stack exchange，提问作者effendi