Test Device Power Levels (Compact 7)
3/12/2014
The Test Device Power Levels Test verifies the functionality of the Power Manager as it applies to power manageable device drivers. The Power Manager requests device power-state changes and verifies the resulting state based on expected behavior and configured ceiling and floor power-state values.
Test Prerequisites
Your device must meet the following requirements before you run this test.
The following prerequisites are required for this test.
Hardware Prerequisites:
In order to run the test, the platform and/or device drivers should have power management capabilities.
Software Prerequisites:
Having the SYSGEN_PM sysgen variable set when building your OS image will include the Power Manager.
The following table shows the software requirements for this test.
| Requirement | Description |
|---|---|
Tux.exe |
Tux test harness that executes the test. |
Kato.dll |
Logging engine that logs test data. |
testutildrv.dll |
Utility driver to handle setting RTC wake source for suspend/resume |
pwrdrvr.dll |
Sample power managed device driver used during test |
pwrfunc.dll |
Test library. |
Subtests
The table below lists the subtests included in this test.
| SubTest ID | Description |
|---|---|
1001 |
Sets every possible floor/ceiling combination. |
1002 |
Calls SetDevicePower() for every power state for each floor/ceiling. |
1003 |
Calls SetDevicePower() for every power state for each request/floor/ceiling. |
1004 |
Raises ceiling from D4 to D0 (passive driver). |
1005 |
Raises ceiling from D4 to D0 and requests D0 through D4. |
1006 |
Lowers floor from D0 to D4 (passive driver). |
1007 |
Lowers floor from D0 to D4 and requests D0 through D4. |
1008 |
Requests all unsupported states. |
Setting Up the Test
This test has no additional requirements, beyond the standard test environment setup.
Running the Test
The Test Device Power Levels Test executes the tux -n -o -d pwrfunc.dll command line on default execution.
This test library can have one or more optional command line entries to change the behavior of the test. To specify one or more command line entries to the test library, you must use the -c command-line option. This option forces Tux to pass the specified string into the test library.
The following table shows the optional command line parameters for this test.
| Command Line Parameter | Description |
|---|---|
PdaVersion |
Informs the tests that this is a PDA-type device which tests a separate set of system power states. |
Verifying the Test
When the test completes running, verify that "PASS" appears in the test log for all subtests.
Troubleshooting the Test
* The platform must have power managment capabilities.
* The platform must support the standard power states used in this test which target the DEFAULT and PDA versions of the Power Manager.
Some device drivers may fail to change power states if they have not been made power-aware. All device drivers that are running in the system should be enabled to handle power state transitions.
For additional platform specific issues, consult the CTK articles on the TechNet wiki.