DMTF Change Request

DMTF Confidential

All changes to be submitted by the Working Group Chair (or designee) after approval by the working group.

The Change Request sample (http://www.dmtf.org/members/zdata/CRTemplateSample.html) contains more detailed information on how to complete the template.

DMTF Change Request Number
Originating Working Group CR Number	SMWG_CR
CR Owner Name, Email	Jon Hass, jon_hass@dell.com
Errata [Yes/No]	No.
Short Description	Add RechargeCount, MaxRechargeCount, RemaingCapacityMaxError, RemainingCapacity property to the CIM_Battery class.
Spec, Document or Model(s) Being Changed	Device Model
Spec, Document or Model Version Incorporating the Change	V2.11
Filename(s) Incorporating the Change	Device_CoolingAndPower.mof
Date Originated [mm/dd/yyyy]	04/04/2005
Date of Last Revision of the Change Request [mm/dd/yyyy]	04/04/2005
Dependencies	None.

Terminology

The key phrases and words MUST, MUST NOT, REQUIRED, SHALL, SHALL NOT, SHOULD, SHOULD NOT, RECOMMENDED, MAY and OPTIONAL in this document are to be interpreted as described in RFC 2119.

"Key words for use in RFCs to Indicate Requirement Levels", IETF RFC 2119, March 1997 (http://www.ietf.org/rfc/rfc2119.txt)

Background/Rationale

This CR addresses the need for additional properties to describe Battery. The Battery's life span can be determined by the number of recharges that the Battery is capable of, thus the need for RechargeCount and MaxRechargeCount properties. RemainingCapacity will provide the reading of the Battery's remaining charge in mWatt-per-hour and RemainingCapacityMaxError property will provide the maximum error in percentage of the RemainingCapacity property of the Battery.

Requested Change

In the Device_CoolingAndPower.mof:

Add new properties �RechargeCount", "MaxRechargeCount", "RemainingCapacityMaxError", and "RemainingCapacity" to the CIM_Battery class :

������� [Experimental, Description (

��������� "The number of times the Battery has been recharged. ")]

����� uint32 RechargeCount;

������� [Experimental, Description (

��������� "The maximum number of times the Battery "

��������� "can be recharged. ")]

����� uint32 MaxRechargeCount;

������� [Experimental, Description (

��������� "The Battery's remaining charge capacity "

��������� "in mWatt-hours. "),

������� Units ("MilliWattHours")]

����� uint32 RemainingCapacity;

������� [Experimental, Description (

��������� "The maximum error (as a percentage) in the mWatt-hour data "

    ����� "reported by RemainingCapacity property. "),

�������� Units ("Percentage")]

������ uint8 RemainingCapacityMaxError;

Discussion Points (Summary of decisions and discussions of the WG in creating this CR):

Issue: The units for RemainingCapacity are currently "MiliWatt per Hour". I believe the correct units should be "MilliWattHours".

Response: Changed per comment.

Issue: Uint32 for RemainingCapacityMaxError (defined a percentage) is overkill.

Response: Changed to Uint8.

Change History (Mandatory after submission to the TC, May be used by the WGs):

Version	Date	Short description of changes
000	04/04/2005	Initial Version

Note that this document is labeled as "DMTF Confidential". It is intended only for DMTF member companies and alliance partners. This Change Request may be withdrawn or modified by subsequent Change Requests.

All submissions MUST comply with the DMTF Patent and Technology policy (http://www.dmtf.org/about/policies/patent-10-18-01.pdf)