Edit

Share via

PwrTest PPM Scenario

  • Article

The PwrTest PPM Scenario logs processor power management (PPM) information and periodic statistics totals.

Syntax

pwrtest /ppm [/n:n] [/i:n] [/c:[y|n]] [/p:{y|n}] [/u:{y|n}] [/live] [/t:n] [/?]

/n:n
Specifies the number of cycles (100 is the default). Press q to quit).

/i:n
Specifies the polling interval in milliseconds (ms) for C-state and processor utilization (5000 ms is default).

/c:{y|n}
Specifies whether C-state information should be captured. The options are yes (y) or no (n). The default is yes (y).

/p:{y|n}
Specifies whether performance or throttle state information should be captured. The options are yes (y) or no (n). Yes (y) is the default.

/u:{y|n}
Specifies whether CPU utilization information should be captured. The options are yes (y) or no (n). Yes (y) is the default.

/live
Displays processor power management events in real-time (other options are not available).

/t:n
Specifies the indicates the total runtime, in minutes, for the /live option (default is 30).

Examples

pwrtest /ppm /c:y /p:y /u:y /n:60 /i:1000

  pwrtest /ppm /c:n /p:n /u:y /n:3600 /i:1000

  pwrtest /ppm /live

  pwrtest /ppm /live /t:60

XML log file output

<PwrTestLog>
  <SystemInformation>
  </SystemInformation>
  <PPMScenario> 
    <ProcessorInformation> 
      <PerformanceStates> 
        <PerformanceState  
            number="0" 
            frequency="" 
            percentofmaxfrequency="" 
            type="" /> 
      </PerformanceStates> 
      <ProcessorName> </ProcessorName> 
      <InterfaceType> </InterfaceType> 
      <TransitionLatency units=""></TransitionLatency> 
    </ProcessorInformation> 
    <ProcessorTraces interval=""> 
      <Trace> 
        <CpuId></CpuId> 
        <ElapsedT></ElapsedT> 
        <CPUIdle></CPUIdle> 
        <PState></PState> 
        <Frequency></Frequency> 
        <PercentOfMax></PercentOfMax> 
        <PStateType></PStateType> 
        <COne></COne> 
        <CTwo></COne> 
        <CThree></CThree> 
      </Trace> 
    </ProcessorTraces> 
  </PPMScenario> 
</PwrTestLog>

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

Element Description
<PPMScenario>

Contains information related to the PPM scenario. There is only one <SleepScenario> element in a PwrTest log file.
<ProcessorInformation>

Contains information related to the static attributes of the processor, such as performance and throttle state capabilities.
<PerformanceStates>

Contains a list of <PerformanceState> elements.
<ProcessorName>

Indicates the friendly name of the processor.
<InterfaceType>

Indicates the mechanism used to interface between Windows and platform processor power management features.
<TransitionLatency>

Indicates the latency when switching performance states. Includes a units attribute, typically microseconds (µs)
<ProcessorTraces>

Contains a list of <Trace> elements. Includes an interval attribute indicating the interval of each <Trace> element.
<Trace>

Contains trace information, which will vary depending on the command options you use with PwrTest.
<CpuId>

Identifies the processor.
<ElapsedT>

Indicates the elapsed time since the start of PwrTest in milliseconds.
<CPUIdle>

Indicates the percentage of processor idle time.
<PState>

Indicates the current processor performance state.
<Frequency>

Indicates the actual frequency of the current processor performance state in Megahertz.
<PercentOfMax>

Indicates the percentage of maximum frequency for the current performance state.
<PStateType>

Indicates whether the performance state is a performance state (1) or a throttle state (0).
<COne>

Indicates the percentage of CPU idle time spent in the C1 CPU idle state.
<CTwo>

Indicates the percentage of CPU idle time spent in the C2 CPU idle state.
<CThree>

Indicates the percentage of CPU idle time spent in the C3 CPU idle state.

PwrTest Syntax