Partager via


USB Function Driver Verification Tests (Compact 2013)

3/26/2014

The USB Function Driver Verification Tests verifies the basic functionality of the USB function driver.

Test Prerequisites

Your device must meet the following requirements before you run this test.

Hardware Requirements:

A USB function controller should be present on the platform device under test.

Software Requirements:

The following table shows the software that is required for this test.

Requirement

Description

Tux.exe

Test harness, required to execute the test.

ktux.dll

Test harness, required to execute kernel-mode tests.

Kato.dll

Logging engine, required for logging the test data.

usbfnbvt.dll

Library that contains the test code, loaded by the Tux test harness.

For this test to function correctly you must include SYSGEN_USB, SYSGEN_USBFN_<as per client> (ex. SYSGEN_USBFN_SERIAL) into your OS build.

Subtests

The table below lists the subtests included in this test.

SubTest ID

Description

101

Unload/Reload USB Function bus driver.

This test deactivates and reactivates the USB function controller driver.

102

Enumerate USB function client driver.

This tests enumeration of all available function clients.

103

Get/set USB function current client driver.

This test get/set's the current client and verifies the current client.

104

Get/set USB function default client driver.

This tests the get/set's of current default client.

105

Additional IOCTL Test

This test sends invalid parameters for IOCTL call. Function IOCTL Tests validates IOCTL's Exposed by the USB function MDD.

106

Enumerate All Clients

This test enumerates all clients and sets to the current client.

200

Test Current and Default Clients post Suspend/Resume

This is an optional test. If enabled, this test ensures Current and Default client are correct after a suspend/resume cycle.

If not enabled via the command line, it will simply skip.

Setting Up the Test

This test has no additional requirements, beyond the standard test environment setup.

Running the Test

The following table shows the command line parameter for the USB Function Driver Verification Test.

Command line parameter

Description

-c "-s"

Enables Suspend/Resume for USB Function Driver Verification tests. This command line parameter enables Test ID 200.

Verifying the Test

When the test completes running, verify that "PASSED" appears in the test log for all subtests.

Troubleshooting the Test

Typical failures are in the IOCTL implementation of USB Function Controller Driver.

See Also

Other Resources

USB - Function Tests