1. Introduction
   1.1. Project/Component Working Name:

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

	Mir Jamal Hyder
	
   1.3. Date of This Document:

	09/11/07

   1.4. Name of Major Document Customer(s)/Consumer(s):
	1.4.1. The PAC or CPT you expect to review your project:
		HS 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:
		Mike.Sanfratello@Sun.com
		
	1.4.4. The name of your business unit:
		Systems Group

   1.5. Email Aliases:
    	1.5.1. Responsible Manager:	chad.solomon@sun.com
    	1.5.2. Responsible Engineer:	mir.j.hyder@sun.com
        1.5.3 Marketing manager:        Pocheng.Shyu@sun.com
        1.5.4 Hardware manager:         Tom.Giles@sun.com
        1.5.5 Interest list:            monza_eteam@sun.com

2. Project Summary
   2.1. Project Description:

	This project registers the "banner-name" and root node "name" property
        values used on the Monza platform. 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 relevant to I/O devices found on Monza.

        A new "CP3260-uPD720101" property needs to be provided in the USB 
        machine descriptor device node to indicate to the fcode driver that 
        the external clock speed for USB 2.0 host controller uPD720101 is 48Mhz 
	and so that the driver will program the device specific config register 
	EXT2 at offset 0xe4 appropriately. The device supports 2 different clock
	speeds for the external oscillator i.e 30 Mhz and 48 Mhz, 30 Mhz being 
	the default setting in EXT2 register. 

3. Business Summary
   3.1. Problem Area:

        The one pager provides information about properties and interfaces
	provided by Monza at the system firmware level, which must be registered
	with FWARC.

4. Technical Description:
    4.1. Details:
       
     4.1.1  OBP properties
	Monza will have the following root node "name" and 
	"banner-name" properties.

        "name"                                               S
           Type: Prop-encoded-string
           Contents: Root node name property for Monza
           Value: "SUNW,Netra-CP3260"

        "banner-name"                                        S
           Type: Prop-encoded-string
           Contents: Banner name for Monza
           Value: "Netra CP3260"

    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 Monza platform hardware configuration.

	io_device_results for Monza :

	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
	   GBE0			6
	   GBE1			7
	   PCI-BRIDGE		8
           GBE2			13
           USB   		14
	   RTM			15
	   unused		[16..63]

     4.1.3  "CP3260-uPD720101" MD Node Property

        The NEC USB 2.0 controller uPD720101 on Monza uses a external clock 
	speed of 48 Mhz which is non-default value for the controller.
	The default setting being 30 Mhz external clock. This is a eeprom 
	configurable option. But due to monza hardware implementation, there is 
	no eeprom present for the NEC USB 2.0 controller.  Hence OpenBoot
	must have some mechanism of determining that it should be using
	the non-default value and hence the "CP3260-uPD720101" MD node 
	property is provided in the USB MD node.
	
    Name            Tag        Req'd?     Description
   ----------------------------------------------------------------------
   CP3260-uPD720101 PROP_VAL   Optional   The presence of this property 
					  indicates to the fcode driver
					  to program EXT2 register in NEC 
                                          uPD720101 USB 2.0 for a external
                                          clock speed of 48 Mhz.
							

    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

	USB MD node		Evolving	FWARC/2006/556

       Exported Interfaces :

        "SUNW,Netra-CP3260"	Uncommitted	"name" property value

        "Netra CP3260"		Uncommitted	"banner-name" property value

	io_device_results	Uncommitted	Post results bitmask values

	"CP3260-uPD720101" 	Uncommitted	Property in USB MD device node.

5. Reference Documents:

	[1] Huron VBSC to POST Interface FWARC/2007/180
            http://sac.sfbay/Archives/CaseLog/arc/FWARC/2007/180
        [2] Niagara2 Network Interface Unit Binding FWARC/2006/556
            http://sac.sfbay/Archives/CaseLog/arc/FWARC/2006/556 
        [3] Standard IEEE 1275 Property FWARC/1998/392
            http://sac.sfbay/Archives/CaseLog/arc/FWARC/1998/392
        [4] Host Types for Sun4v platforms 
	    http://sac.eng.sun.com/arc/FWARC/Registries/Host_Type_Registry.txt