1. Introduction
   1.1. Project/Component Working Name:

	Glendale Platform Name Binding
	
   1.2. Name of Document Author/Supplier:

	Eduardo Horvath
	
   1.3. Date of This Document:

	08/28/2007

   1.4. Name of Major Document Customer(s)/Consumer(s):
    1.4.1. The PAC or CPT you expect to review your project:
        HEES PAC
    1.4.2. The ARC(s) you expect to review your project:
        FWARC
    1.4.3. The Director/VP who is "Sponsoring" this project:
        N/A
    1.4.4. The name of your business unit:
        Software

   1.5. Email Aliases:
        1.5.1. Responsible Manager: gary.hethcoat@sun.com
        1.5.2. Responsible Engineer: eduardo.horvath@sun.com

2. Project Summary
   2.1. Project Description:
   
	This project registers the "banner-name" and root node "name" property
        values used on the Glendale platforms. OpenBoot extracts these values
	from the guest MDs and creates the properties for Solaris to use.

	Changes are required to the vBSC/POST interface to allow POST to return
	information relevent to I/O devices found on Glendale.

	A new "hot-swappable-phy" property needs to be provided in the NIU
	machine descriptor device node to indicate the PHY can be hot swapped
	and must be probed by the device driver.

3. Business Summary
   3.1. Problem Area:

        Although marketing (and not engineering) dictates these property values,
        they constitute a cross-consolidation software/firmware interface, and
        therefore must be registered with an ARC body.


4. Technical Description:
    4.1. Details:
       

     4.1.1  OBP properties
	Glendale will have the following
        root node "name" and "banner-name" properties.

        "name"                                               S
           Type: Prop-encoded-string
           Contents: Root node name property for Glendale
           Value: "SUNW,Sun-Blade-T6320"

        "banner-name"                                        S
           Type: Prop-encoded-string
           Contents: Banner name for Glendale
           Value: "Sun Blade T6320 Server Module"

	Glendale will have the following new property in the NIU and Neptune
	NIU "network" device node.

	"hot-swappable-phy"
	   Type:	Boolean Property
	   Contents:	Sun private property to indicate the phy can
	   		be swapped without notice
	   Value:	Presence of this property indicates the PHY device
	   		may change without warning and must be probed 
			properly by the driver.


    4.1.2  vBSC/POST interface

	FWARC/2007/180 defines the interface between vBSC and POST for Huron
	platform. POST returns the status of each component, that it tested,
	in  io_device_results  field.

	This case imports that interface and modifies the io_device_results
	bit format as per Glendale platform hardware configuration.

	io_device_results for Glendale :

	These words contain a "0" in each bit for an io device that failed POST.
	Bits corresponding to devices which are untested must be set to 1.
	Unused bits must be set to 1.
	This word is only valid when post_exit_reason == 0.

	Bit definitions are as follows:

	   device		bit

	   XAUI_PORT0		0
	   XAUI_PORT1		1
	   PCISWITCH		2
	   GBE			6
	   PCI-BRIDGE		8
	   REM			9
	   USB0			10
	   USB1			11
	   DISPLAY		12
	   unused		[3..5,7,12..63]


     4.1.3  "hot-swappable-phy" MD Node Property

       The following property is allowed for the machine descriptor
       node for Neptune or NIU network port nodes:

    Name              Tag        Req'd? Description
   ----------------------------------------------------------------------
   hot-swappable-phy  PROP_VAL   No   The presence of this property means 
				      PHY device may change without warning
				      and must be probed properly by the 
				      driver.


    4.2. Interfaces:

        Imported Interfaces :

        Interface            Classification	Comments

        "name"                  Standard	FWARC/1998/392
						(Standard IEEE 1275 property)

        "banner-name"           Stable		FWARC/1998/392
					   	(Legacy property)

	io_device_results	Uncommitted	FWARC/2007/180

	NIU MD node		Evolving	FWARC/2006/556


       Exported Interfaces :

        "SUNW,Sun-Blade-T6320"	
                                Uncommitted	"name" property value

        "Sun Blade T6320 Server Module"		
				Uncommitted	"banner-name" property value

	io_device_results
				Uncommitted	Post results bitmask values

	"hot-swappable-phy"	Uncommitted	Property in NIU and Neptune 
						MD device node.

	"hot-swappable-phy"	Uncommitted	Property in NIU and Neptune 
						device node.