调试功能测试(徽标)

此测试衡量测试计算机支持使用 xHCI 控制器、EHCI 控制器、串行端口、1394 控制器或网络适配器调试操作的能力。 此测试验证是否至少有一个调试端口可用。

测试详细信息

   
规范
  • System.Fundamentals.DebugPort.SystemExposesDebugInterface
平台
  • Windows 10,客户端版本 (x86)
  • Windows 10,客户端版本 (x64)
  • Windows Server 2016 (x64)
  • Windows 10,客户端版本 (Arm64)
支持的版本
  • Windows 10
  • Windows 10 版本 1511
  • Windows 10 版本 1607
  • Windows 10 版本 1703
  • Windows 10 版本 1709
  • Windows 10 版本 1803
  • Windows 10 版本 1809
  • Windows 10 版本 1903
  • Windows 10 的下一次更新
预计运行时间(以分钟为单位) 20
类别 开发
超时(以分钟为单位) 1200
需要重启 false
需要特殊配置
类型 automatic

其他文档

此功能区域中的测试可能会有其他文档,包括先决条件、设置和故障排除信息,这些内容可在以下主题中找到:

运行测试

要完成此调试测试,必须配置两台计算机。 要尝试认证的计算机是受测系统 (SUT)。 第二台计算机是将运行 Windows 调试程序的主机。 这些计算机必须满足 Windows HLK 先决条件,并且必须包含在同一计算机池中。 有关详细信息,请参阅 Windows HLK 先决条件。 如果要测试的设备是 XHCI 控制器,则两台计算机中都必须包含 XHCI 控制器。 如果 SUT 中的 XHCI 控制器具有任何用户可访问的端口,则该控制器必须具有调试功能。

重要

必须有适合要验证的调试传输的电缆。

故障排除

有关 HLK 测试失败的常规故障排除,请参阅排查 Windows HLK 测试失败问题

有关故障排除信息,请参阅排查 Windows HLK 环境问题

此测试返回“通过”或“失败”。 要查看测试详细信息,请查看 HLK Studio 中的测试日志。

更多信息

命令语法

在“参数”窗口的“传输”字段中,输入一种传输类型(net、1394、usb 或 serial)。 根据输入的传输类型,必须提供以下附加参数。

传输类型 必需的参数 注释

NET

NetHostIP

必须指定主机 IP。 如果 SUT 计算机上有多个控制器,则必须指定 BusParams 值。 以“b.d.f”的形式输入“Busparams”,其中 b、d 和 f 分别为设备管理器中设备的“属性”窗口中显示的总线编号、设备编号和函数编号。

1394

1394Channel

默认值为 1。 如果 SUT 计算机上有多个控制器,则必须指定 BusParams 值。 以“b.d.f”的形式输入“Busparams”,其中 b、d 和 f 分别为设备管理器中设备的“属性”窗口中显示的总线编号、设备编号和函数编号。

USB

UsbTargetName

默认值为“default”。 如果 SUT 计算机上存在多个 USB 主机控制器,则必须指定 BusParams 值。 以“b.d.f”的形式输入“Busparams”,其中 b、d 和 f 分别为用于调试的 USB 主机控制器的总线编号、设备编号和函数编号。 这些编号将显示在设备管理器中 USB 主机控制器的“属性”窗口中。

重要说明

如果在 SUT 计算机上使用 EHCI 主机控制器,则必须将电缆连接到控制器的端口 1。 可以使用 USBView 工具来识别端口 1。 USBView 包含在 WDK 中。

串行

不是必需

使用默认值即可。 根据需要调整任何串行参数(带有前缀 Serial_)。

参数

参数名称 参数说明
Transport 有效值为:net、usb、1394 或 serial
NetHostIP 主机的 IP 地址
NetPort 用于内核调试的端口号。 建议使用端口 50000。
NetKey 用于内核调试的加密密钥。 建议使用默认密钥。
BusParams 以太网、1394、USB:仅当受测系统中存在多个控制器时才使用。 以“b.d.f”的形式输入总线参数,其中 b、d 和 f 分别为相关设备管理器属性页中显示的总线编号、设备编号和函数编号。
SerialTargetPort 受测系统上的 COM 端口号
SerialHostPort 主机上的 COM 端口号
SerialBaudRate 串行通信的波特率
UsbTargetName 任何字符串都是可接受的。 建议使用默认值。
1394Channel 将在要主机和受测系统上使用的通用 1394 通道。