CIM_Battery¶
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).
Key properties¶
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¶
None