Class reference

Subclass of CIM_PowerSource

Capabilities and management of the Battery. This class applies to both batteries in Laptop Systems and other internal or external batteries, such as an uninterruptible power supply (UPS).

Local properties

uint16 BatteryStatus

Description of the charge status of the Battery. Values such as “Fully Charged” (value=3) or “Partially Charged” (value=11) can be specified. The value, 10, is not valid in the CIM Schema because in DMI it represents that no battery is installed. In this case, this object should not be instantiated. The valuemaps: 6(Charging), 7(Charging and High), 8(Charging and Low), and 9(Charing and Critical) has been deprecated in lieu of the ChargingStatus property. 10(Undefined) has been deprecated in lieu of 2(Unknown).

ValueMap Values
1 Other
2 Unknown
3 Fully Charged
4 Low
5 Critical
6 Charging
7 Charging and High
8 Charging and Low
9 Charging and Critical
10 Undefined
11 Partially Charged
12 Learning
13 Overcharged
DMTF Reserved
32768..65535 Vendor Specific

string OtherChemistryDescription

The description of the battery chemistry when the Chemistry property has value 1 (Other). The property shall be implemented if the Chemistry property has value 1(Other).

uint32 DesignCapacity

The design capacity of the battery in mWatt-hours. If this property is not supported, enter 0.

uint32 MaxRechargeTime

MaxRechargeTime indicates the maximum time, in minutes, to fully charge the Battery. This property represents the time to recharge a fully depleted Battery, not the current remaining charging time, which is indicated in the TimeToFullCharge property.

uint8 RemainingCapacityMaxError

The maximum error (as a percentage) in the mWatt-hour data reported by RemainingCapacity property.

uint16 PermanentErrorInfo

An enumeration that describes the error information in the event of permanent failure of the battery. This code will enable system administrators to troubleshoot the reason behind failed batteries. Unknown value means a permanent error has occured but the error type is unknown.

ValueMap Values
0 Unknown
2 No Failure
3 Fuse Blown
4 Cell imbalance
5 Over voltage
6 FET inoperative
7 Communication error
8 Incompatible battery type
DMTF Reserved
32768..65535 Vendor Reserved

uint32 TimeToFullCharge

The remaining time in minutes to charge the battery fully at the current charging rate and usage.

uint32 MaxRechargeCount

The maximum number of times the Battery can be recharged.

uint32 RemainingCapacity

The Battery’s remaining charge capacity in mWatt-hours.

uint16 ChargingStatus

ChargingStatus indicates whether the battery is charging. Charging - the battery is charging. Discharging - the battery is discharging. Idle - the batter is neither charging nor discharging.

ValueMap Values
0 Unknown
2 Charging
3 Discharging
4 Idle
DMTF Reserved
32768..65535 Vendor Specified

uint32 TimeOnBattery

TimeOnBattery indicates the elapsed time in seconds since the ComputerSystem, UPS, or so on, last switched to battery power, or the time since the System or UPS was last restarted, whichever is less. Zero is returned if the Battery is ‘on line’.

uint64 DesignVoltage

The design voltage of the battery in mVolts. If this attribute is not supported, enter 0.

uint16 EstimatedChargeRemaining

An estimate of the percentage of full charge remaining.

string SmartBatteryVersion

The Smart Battery Data Specification version number that is supported by this Battery. If the Battery does not support this function, the value should be left blank.

uint8 HealthPercent

An estimate of the percentage of the overall battery health. It indicates how much the battery has deteriorated over time. It can take values 0 to 100; 255 if it is unknown.

uint16 Chemistry

An enumeration that describes the chemistry of the Battery.

ValueMap Values
1 Other
2 Unknown
3 Lead Acid
4 Nickel Cadmium
5 Nickel Metal Hydride
6 Lithium-ion
7 Zinc air
8 Lithium Polymer
DMTF Reserved
32768..65535 Vendor Specified

uint32 ExpectedLife

Indicates the expected lifetime of the Battery in minutes, assuming that the Battery is fully charged. This property represents the total expected life of the Battery, not its current remaining life, which is indicated by the EstimatedRunTime property.

uint32 RechargeCount

The number of times the Battery has been recharged.

uint32 EstimatedRunTime

EstimatedRunTime is an estimate in minutes of the time that battery charge depletion will occur under the present load conditions if the utility power is off, or is lost and remains off, or a Laptop is disconnected from a power source.

uint32 FullChargeCapacity

The full charge capacity of the battery in mWatt-hours. Comparison of this value to the Battery DesignCapacity determines when the Battery requires replacement. The end of life of a Battery is typically when the FullCharge Capacity falls below 80% of the DesignCapacity. If this property is not supported, enter 0.

Local methods