第三十二篇:Windbg中USB2.0调试环境的搭建

2011年的时候，为了开发USB Mass storage -- UASP (USB attached SCSI Protocol)的设备驱动程序，从米国买了两个USB2.0的调试小设备（如下图，每个似乎80美刀，贼贵的东西）。

主要是用来替代串口115200波特率的响应速度慢，以便解决调试效率的问题。

当时，根据WINDBG的HELP文档，而且也GOOGLE了一些网上的相关参考内容，硬是没有把USB2.0的调试环境搭建起来。

后来有一段时间，朋友要开发驱动程序，他原来一直用一台配有PCI转1394卡来调试，但现在要用笔记本，却又不带1394接口，所以，问我借了这个USB2.0调试设备一用，但这个驱动高手，搞了半天，也硬是没把USB2.0调试环境搭建起来。

于是，这个小玩意儿，就一直躺在实验室的角落里，我还是照旧，在Win7上用串口调试，在Win8上用NET调试。

最近在开发显示相关的DLL时，也一直在Win8/8.1/10系统上用NET调试。

为了将Win7的调试环境搭起来，加上这个平台没有串口，所以，又想到了这个USB2.0调试设备。

根据WDK8.1 Windbg的帮助文档，先在第一类平台上试着搭建。

但是没有成功，原因很简单，该USB2.0调试设备只能直连HOST与TARGET上的EHCI HOST。

而第一类平台的调调试机，任何一个EHCI HOST的PORT1, 都嵌入了一个GENERIC USB HUB。

既然这个ROOT HUB下面的PORT1被占用了，不符合环境搭建的要求，那自然连接不起来了。

USB debugging does not work over a hub or docking station. (from help documents)

PCI to USB host controller      

<span style="white-space:pre">	</span>Root Hub            

<span style="white-space:pre">		</span>Port1: Generic usb hub                     

<span style="white-space:pre">			</span>Port 1 --plug physical port of the debug cable                     

<span style="white-space:pre">			</span>Port 2            

<span style="white-space:pre">		</span>Port2

之后，就换了一台被测试机，根据帮助文档，前后花了不到十分钟，就把调试环境搭建成功了。

下面，就是几个主要步骤：

在被调试机上：

1. bcdedit /debug off

2. 重启

3. 通过USBView找到ROOT HUB PORT1

4. 找到后， 通过Device Manager记录这个EHCI HOST的PCI bus, device, and function numbers

5. 

1. Windows 7系统上设置

1. bcdedit /debug on bcdedit /dbgsettings usb targetname: someName bcdedit /set "{dbgsettings}" busparams x.y.z

   where x, y, and z are the bus, device, and function numbers for the host controller. The bus, device, and function numbers must be in decimal format (for example, busparams 0.29.7).

6. 重启

在调试主机上：

只要将该设备接到EHCI HOST下，同时安装驱动就可以了。

建立调试会话：

File－－>Kernel Debug-->usb2.0 tab-->enter the target name-->ok

或者是在COMMAND PROMPT WINDOWS中：

windbg /k usb2:targetname=TargName

事实上，并不是每一台PC都能作为USB2.0的调试方式的调试机的：

• The target computer must have a USB 2.0 controller that is compatible with the EHCI specification and that supports kernel debugging. Not all EHCI-compatible controllers have this support.