PwrTest Info Scenario

  • Article

The PwrTest Info Scenario captures and logs the current system power information from various categories.

Syntax

pwrtest /info:option [/p:{n|a|*}] [/w:n]  [/?]

/info:option

option Description

all

Displays all system information.

powercap

Displays SYSTEM_POWER_CAPABILITIES.

powerinfo

Displays SYSTEM_POWER_CAPABILITIES.

battery

Displays SYSTEM_BATTERY_STATE.

ppm

Displays all processor information.

ppmidle

Displays processor idle state information.

ppmperf

Displays processor performance state information.

ppmperfverbose

Displays processor performance state information in the verbose format .

/p:{n|a|\*}

Specifies the logical processor number for /info:ppm/info:ppmidle, or /info:ppmperf options.

a or \*
Specifies all the logical processor(s) (default).

/w:{y|n}
Specifies the time in seconds to wait for PPM rundown event (default is 10 seconds).

Examples

pwrtest /info:all

  pwrtest /info:battery

  pwrtest /info:ppm

  pwrtest /info:ppm /p:1

 pwrtest /info:ppmidle

  pwrtest /info:ppmperf /p:2

XML log file output

<PwrTestLog>
  <SystemInformation>
  </SystemInformation>
  <InfoScenario>
    <SYSTEM_POWER_CAPABILITIES> 
      <SystemS1StateSupported></SystemS1StateSupported>
      <SystemS2StateSupported></SystemS2StateSupported>
      <SystemS3StateSupported></SystemS3StateSupported>
      <SystemS4StateSupported></SystemS4StateSupported>
      <SystemS5StateSupported></SystemS5StateSupported>
      <RtcWakeSupported></RtcWakeSupported>
      <FastSystemS4></FastSystemS4>
    </SYSTEM_POWER_CAPABILITIES> 
    <SYSTEM_POWER_INFORMATION> 
      <MaxIdlenessAllowed></MaxIdlenessAllowed>
      <Idleness></Idleness>
      <TimeRemaining></TimeRemaining>
      <CoolingMode></CoolingMode>
    </SYSTEM_POWER_INFORMATION> 
    <SYSTEM_BATTERY_STATE> 
      <AcOnLine></AcOnLine>
      <BatteryPresent></BatteryPresent>
      <Charging></Charging>
      <Discharging></Discharging>
      <MaxCapacity></MaxCapacity>
      <RemainingCapacity></RemainingCapacity>
      <RateOfDrain></RateOfDrain>
      <EstimatedTime></EstimatedTime>
      <DefaultAlert1></DefaultAlert1>
      <DefaultAlert2></DefaultAlert2>
    </SYSTEM_BATTERY_STATE> 
    <PROCESSOR_POWER_INFORMATION> 
      <CPUNumber></CPUNumber>
      <MaxMhz></MaxMhz>
      <CurrentMhz></CurrentMhz>
      <MhzLimit></MhzLimit>
      <MaxIdleState></MaxIdleState>
      <CurrentIdleState></CurrentIdleState>
    </PROCESSOR_POWER_INFORMATION> 
    </InfoScenario>
</PwrTestLog>

The following table describes the XML elements that appear in the log file.

Element Description
<InfoScenario>

Contains information related to the info scenario. There is only one <InfoScenario> element in a PwrTest log file.
<SYSTEM_POWER_CAPABILITIES>

Contains information related to system power capabilities. This information is retrieved from the SYSTEM_POWER_CAPABILITIES structure.
<SystemSxStateSupported>

Indicates if a given system ACPI sleep state is supported on the system.
<RtcWakeSupported>

Indicates the lowest sleep state where RTC wake (wake on timer) is supported. The value is of the SYSTEM_POWER_STATE enumeration.
<FastSystemS4>

Indicates if hybrid sleep is available on the system.
<SYSTEM_POWER_INFORMATION>

Contains information related to the idleness of the system.
<MaxIdlenessAllowed>

Indicates the idleness (in percentage) when the system is considered idle and the idle timeout begins counting.
<Idleness>

Current idle level, expressed in percentage.
<TimeRemaining>

Indicates the time remaining in the system standby idle timer, in seconds.
<CoolingMode>

Indicates the current system cooling mode: (0) Active, (1), Passive, (2) Invalid.
<SYSTEM_BATTERY_STATE>

Contains information related to the current state of the system battery.
<AcOnLine>

Indicates whether the system is currently operating on AC power.
<BatteryPresent>

Indicates if at least one battery is present in the system.
<Charging>

Indicates whether at least one battery is currently charging.
<Discharging>

Indicates whether at least one battery is currently discharging.
<MaxCapacity>

Maximum capacity of the battery when new, in milliwatt hours (mW-h).
<RemainingCapacity>

Estimated remaining capacity of the battery, in milliwatt hours (mW-h).
<RateOfDrain>

Indicates the current rate of discharge of the battery in milliwatts (mW).
<EstimatedTime>

Estimated time remaining on the battery, in seconds.
<DefaultAlert1>

Indicates the battery manufacturer's suggested capacity when a low battery alert should occur.
<DefaultAlert2>

Indicates the battery manufacturer's suggested capacity when a warning battery alert should occur.
<PROCESSOR_POWER_INFORMATION>

Contains information related to the system processors and their power management capabilities.
<CPUNumber>

Indicates which processor the current <PROCESSOR_POWER_INFORMATION> element is describing.
<MaxMhz>

Indicates the maximum frequency of the processor.
<CurrentMhz>

Indicates the current frequency of the processor.
<MhzLimit>

Indicates the current limit on the processor clock frequency.
<MaxIdleState>

Indicates the maximum idle state of the processor.
<CurrentIdleState>

Indicates the current idle state of the processor.

PwrTest Syntax