PwrTest Battery Scenario

The PwrTest Battery Scenario is designed to facilitate automated inspection of battery and power source information.

PwrTest is capable of logging battery capacity, voltage, rate of drain, and general state for as many batteries as are in the system. Battery data is logged at a specified interval for a specified number of cycles.

Syntax

pwrtest /battery [/c:n] [/i:n] [/?] 

/c:n
Specifies the number of cycles (100 is the default) to run.

/i:n
Specifies the polling interval in milliseconds (the default is 5000).

Examples

pwrtest /battery 

pwrtest /battery /c:4 /i:1000

XML log file output

<PwrTestLog>
  <SystemInformation>
  </SystemInformation>
  <BatteryScenario>
    <Batteries>
      <Battery id="" shortterm="" rechargeable="" >
        <Name></Name>
        <UniqueID></UniqueID>
        <Chemistry></Chemistry>
        <Manufacturer></Manufacturer>
        <DesignedCapacity></DesignedCapacity>
        <FullChargeCapacity></FullChargeCapacity>
        <CriticalBias></CriticalBias>
        <CycleCount></CycleCount>
        <ManufactureDate></ManufactureDate>
        <FullLifeTime Units=""></FullLifeTime>
      </Battery> 
    </Batteries>
    <BatteryTraces interval="">
      <Trace>
        <ElapsedT></ElapsedT>
        <ACStatus></ACStatus>
        <Capacity id=""></Capacity>
        <TimeRemaining></TimeRemaining>
        <Capacity id=""></Capacity>
        <RateOfDrain id=””></RateOfDrain>
        <Voltage id=””></Voltage>
        <Capacity id=""></Capacity>
        <RateOfDrain id=””></RateOfDrain>
        <Voltage id=””> </Voltage>
      </Trace>
    </BatteryTraces> 
  </BatteryScenario>
</PwrTestLog> 

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

Element	Description
<UniqueID>	Indicates the unique ID of the battery.
<Chemistry>	Indicates battery chemistry.
<Manufacturer>	Indicates the battery manufacturer.
<DesignedCapacity>	Indicates the designed capacity of the battery in milliwatt hours (mW-h).
<FullChargeCapacity>	Indicates the fully charged capacity of the battery in milliwatt hours (mW-h).
<CriticalBias>	Indicates a bias from zero, in mW-h, which is applied to the battery reporting.
<CycleCount>	Indicates the number of charge/discharge cycles the battery has experienced.
<ManufactureDate>	Indicates the manufacture date of the battery.
<FullLifeTime>	Indicates the battery full life time in seconds.
<BatteryTraces>	Contains a list of <Trace> elements. Has an attribute indicating the battery information polling interval.
<Trace>	Contains information about battery status such as voltage, capacity and rate of drain for a given interval.
<ElapsedT>	Indicates the elapsed time since PwrTest was started
<ACStatus>	Indicates if the system is running on AC (1) or battery (0) power.
<TimeRemaining>	Indicates the battery life time remaining from all system batteries, in seconds.
<Capacity>	Indicates the capacity of the battery in milliwatt hours (mW-h). Has an id attribute to indicate which battery the capacity is being reported for.
<RateOfDrain>	Indicates the rate of drain of the battery in milliwatts (mW). Has an ID attribute to indicate which battery the rate of drain is being reported for.
<Voltage>	Indicates the battery voltage in millivolts (mV). Has an ID attribute to indicate which battery the voltage is being reported for.

Related topics

PwrTest Syntax