Copyright 2008 Sun Microsystems

1. Introduction
   1.1. Project/Component Working Name:
	Obsoleting of clock-frequency Openboot Device Tree Property

   1.2. Name of Document Author/Supplier:
	Stephen Ehring

   1.3. Date of This Document:
	02/11/2008

   1.4. Email Aliases:
    	1.5.1. Responsible Manager: chad.solomon@sun.com
    	1.5.2. Responsible Engineer: stephen.ehring@sun.com

2. Project Summary
   2.1. Project Description:
	The "clock-frequency" property originally defined by FWARC 2005/111 is 
        unneeded and unimplemented. This case removes it from the binding to 
        prevent future consumers from using this property.

3. Business Summary
   3.1. Problem Area:
	According to the sun4v bus binding [1], the root nexus node must contain
        a property with the name "clock-frequency". This was discussed at future
        FWARC meetings where it was decided that the property should be removed,
        but this never happened. As a result, CRs were filed (even though the
        property is unused (see CR 6602492)).


4. Technical Description:
    4.1. Details:
	This case simply removes the "clock-frequency" property from the sun4v
        bus binding. The updated binding is found in the case materials for this
        case.

        The removal of this property was already discussed and agreed upon (see
        issue 6 for the inception review of FWARC case 2005/115 [2] and [3]).

    4.2. Bug/RFE Number(s):
	
        6602492
    
    4.5. Interfaces:

Interfaces Exported
		
Interface Name			Classification   	Comment
                                      	 
------------------------------------------------------------------------

"clock-frequency" property      Sun Private Obsolete    Originally defined 
                                                        by [1], property is
                                                        being obsoleted by
                                                        this case.

5. Reference Documents:

        [1] Sun4v Bus Binding

        http://sac.eng/Archives/CaseLog/arc/FWARC/2005/111/final.materials/sun4v-binding.txt

        [2] FWARC 2005/115 (sun4v machine description) inception issues

        http://sac.sfbay/FWARC/2005/115/inception.materials/inception.issues

        [3] FWARC 2005/115 (sun4v machine description) inception review notes

        http://sac.sfbay/FWARC/2005/115/20050321.2005.115.inception