Edit

USBTCD package

  • Article

USBTCD is the combination of a user-mode application and kernel-mode driver. The tool performs read and write operations. It initiates control, bulk, isochronous, data transfers of various transfer lengths to and from the test device. For a SuperMUTT device, USBTCD transfers data to streams supported by a bulk endpoint. It can also send the transfer buffer as chained MDLs. In that case, you can specify the number of segments in the transfer buffer.

The USBTCD files are included in the MUTT Software Package.

USBTCD

To use these commands, the USBTCD driver (USBTCD.sys) must be loaded as the function driver for the device. To load the driver for the device, run MUTTUtil and specify USBTCD.inf. This tool loads USBTCD.sys for all attached USB devices.

c:\Program Files (x86)\USBTest\x64>MuttUtil.exe -UpdateDriver usbtcd.inf
Return value: 0


c:\Program Files (x86)\USBTest\x64>MuttUtil.exe -list
       :    : HARDWARE ID                    :  PROBLEM CODE  : DRIVER
DEVICE :  0 : USB\VID_045E&PID_078E&REV_8011 :             0  : USBTCD
Return value: 1

You can use the following commands to measure performance for transfers to and from the bulk endpoints of a SuperMUTT device.

Usbtcd –perf –read 1 100 2 10240000 0

Usbtcd –perf –write 1 100 0 10240000 0

In the preceding command, USBTCD reads 10240000 bytes from pipe 2. In the second command, USBTCD starts a write operation where 10240000 bytes are sent to the pipe 0. For both commands, the tool performs the operation 100 times and does not specify a timeout value.

These commands are used to measure performance of bulk endpoints of the MUTT device. Notice that the transfer sizes are reduced in this case.

Usbtcd –perf –read 1 100 2 512000 0

Usbtcd –perf –write 1 100 0 512000 0

These commands measure the performance of data transfers to streams of bulk endpoints of the SuperMUTT device. Currently, the device firmware tries to switch streams every millisecond be sending an ERDY together with the new stream number to the host. That is implemented with a timer inside the device.

Usbtcd –sread 1 100 7 1 1024 0

Usbtcd –swrite 1 100 6 1 1024 0

In the preceding command, USBTCD reads and writes to a particular stream in the bulk endpoint of a SuperMUTT device. In the first command, the tool starts a worker thread that reads 1024 bytes from stream 1 associated with pipe 7. Similarly, the second command writes 1024 bytes to stream 1 associated with pipe 6. For both commands, the tool performs the operation 100 times and does not specify a timeout value.

To view help on USBTCD, run the following command:

usbtcd -?

The command shows information on the command-line options. Transfer sizes, verbosity, transfer timeouts, and more can be specified on the command line.