Next: 5. Enhanced Features Up: 4. USBTester Command-Line Execution Previous: 4.1 USBTester Command-Line Options Contents

4.2 USBTester Command-Line Commands

The test application can be run from the command line with any of the following commands (note: the commands are mutually exclusive):

/Replace

USBTester.com /Replace /Inf|i:<INF-file>

Description:

Replace the standard Windows USB stack with the USBTester stack for your selected host controller card, as indicated by the /Inf argument.

Arguments:

/Inf:<INF-file> - INF file for the selected host controller card.
You can create such a file using the test application's GUI Host Controller Selection dialogue, as detailed in section 3.1 of the manual.

Examples:

USBTester.com /Replace /Inf:mydevice.inf

USBTester.com /Replace /i:testdev.inf

/Restore

USBTester.com /Restore

Description:

Restore the standard Windows USB stack.

/Execute

USBTester.com /Execute /TestDevice|d:<test-device> /TestProject|t:<test-project> [/LogOutput|o:<file-name>] [/LogFormat|l:<xml|html|csv>]

Description:

Execute a given test project (/TestProject) for the specified test device (/TestDevice).

Arguments:

/TestProject:<test-project> - the test project to execute.
<test-project> should point to a USBTester project file created in a previous run of the test application - see further information in section 3.2.
The test project file contains a list of the tests to be executed.
/TestDevice:<test-device> - the test device for which to execute the tests, indicated using an *.xdh file created from the test application's Device Tree form during a previous run of the application - see further details in section 3.3.
/LogOutput:<file-name> - create a tests log export file with the specified name (<file-name>).
This is an optional argument. If it is not used, the tests log will be displayed on the screen.
/LogFormat:<xml|html|csv> - tests log output format - XML (<xml>), HTML (<html>), or CSV (<csv>).
This is an optional argument. The default log format is CSV.

Examples:

USBTester.com /Execute /TestProject:myproj.xml /d:mydev.xdh

USBTester.com /Execute /l:xml /t:testproj.xml /TestDevice:testdev.xdh

USBTester.com /Execute /d:TestDevice.xdh t:myproj.xml /o:utlog.csv

USBTester.com /Execute /t:mytests.xml /d:testdev.xdh /LogFormat:html /LogOutput:mylog.html

/DeviceTree

USBTester.com /DeviceTree

Description:

Display a device selection tree for the currently loaded host controller card.

****************************************************************************************

NOTE

Before running USBTester.com with the /DeviceTree command, you must replace the standard Windows USB stack with the USBTester stack for your selected USB host host controller card. This can be done either from the test application's GUI Host Controller Selection dialogue [3.1], or by running the application from the command line with the /Replace command (see description above).

****************************************************************************************

/help

USBTester.com /help

Description:

Display the test application's usage instructions.

/version

USBTester.com /version

Description:

Display the version of the running test application.

	NOTE
	Before running USBTester.com with the `/DeviceTree` command, you must replace the standard Windows USB stack with the USBTester stack for your selected USB host host controller card. This can be done either from the test application's GUI Host Controller Selection dialogue [3.1], or by running the application from the command line with the `/Replace` command (see description above).