USB Function Driver Verification Tests (Compact 7)
3/12/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.
For additional platform specific issues, consult the CTK articles on the TechNet wiki.