Version 1.1
Date : December 10, 2008

4. Technical Description:
  4.1. Details:

  4.1.1. Supernova platform names
 
   Supernova platforms will have the following root node "name" and
   "banner-name" properties.

   "name"
      Type: Prop-encoded-string
      Contents: Root node name property for Supernova platforms
      Values:
      Value: "SUNW,SPARC-Enterprise-AT7480"    for Silver-II
      Value" "SUNW,SPARC-Enterprise-AT7880"    for Platinum-II

   "banner-name"
      Type: Prop-encoded-string
      Contents: Banner name for Supernova platforms
      Values:
      Value: "SPARC Enterprise AT7480"        for Silver-II
      Value: "SPARC Enterprise AT7880"        for Platinum-II


  4.1.2. Root-port Device Node
 
   Supernova RootComplex supports Root-port(s) which is implemented
   via p2p bridge(s).  The device tree representation of the root-port
   node is very similar to the PCI-Express bindings.
   
   Solaris needs the root-port device node from OpenBoot to attach a driver
   in Solaris (Solaris depends on OpenBoot device tree for IO).

   The root-port device node allows Solaris client to handle the PCIe
   fabric errors in hardware neutral manner. This is the direction
   future platform are taking. Without this node, a huge amount
   of redundant code will have to be delivered specifically for
   Supernova RootComplex and will not be usable for future RootComplex
   implementations.
   
   The root-port node described in below is expected to be created by
   future products.  Supernova is first to implement it.
  
  4.1.2.1. Root-port Support in Physical Resource Inventory (PRI)
 
   The Physical Resource Inventory is specified in FWARC 2006/700, and
   updated in FWARC 2007/138, then extended in FWARC 2008/467 (v1.4).
   The material in Section 1.11 (IO Device node) of 2008/467 is copied
   from the same context of Machine Description (MD) in FWARC/2007/070.

   This case proposes the following change:

   - Add a new io device node with generic device-type value = "pciex"
     or an optional value = "pcie-root-port" that indicates the node is
     a pci-express root-port.
     
     This node is directly underneath its sun4v host bridge node.
     
   - Typo correction, the "device-type" values "pci-switch-upstream" should
     be "pcie-switch-upstream", and "pci-switch-downstream" should be
     "pcie-switch-downstream".

   With these changes both a root nexus device (device-type="pciex") and
   a root port(device-type="pcie-root-port") node will exist in the
   device tree.

  4.1.2.2. Root-port Support in Machine Description (MD)
 
   The Machine Description IO device node is specified in FWARC 2007/070.
   This case proposes changes for Supernova RootComplex. It contains both
   a root nexus device and a root port

   This case proposes the following changes:
      
   - Add a new io device node with generic device-type value = "pciex"
     or an optional value = "pcie-root-port" that indicates the node is
     a pci-express root-port.
     

  4.1.2.3. Root-port Support in OpenBoot device tree

   The required properties are followed from the FWARC case 2003/637 and
   2005/565 (PCI Express Bus Binding) which is extended from PCI Binding to
   IEEE P1275 (under http://noho.eng/1275/home.html#OFDbussupps).

   This case makes the following changes:
   
   - The value of the compatible property for root-port node is
     "pciexclass,060400".
     

  4.1.3. Onboard Neptune on Platinum-II

   The FCode is derived from its FCode whose binding is specified in
   FWARC 2006/652.

   For this case proposes the following property changes:

   "compatible"
      Type:  Prop-encoded-array of prop-encoded-strings
      Contents: Standard property to define alternate "name" property 
                values
      Value: "SUNW,rock-pciex108e,abcd"
       which is derived from Machine Description pci-network node.


  4.2. Bug/RFE Number(s):

   N/A

  4.3. In Scope:

   N/A

  4.4. Out of Scope:

   N/A

  4.5. Interfaces:

   Imported Interfaces :

   Interface Name          Classification    Description
   ====================    ==============    ================================
   "name"                    Standard           FWARC/1998/392
                                                (Standard IEEE 1275 property)

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

   "compatible"              Evolving           Standard OpenBoot property
   
   PCI-E bindings            Evolving           FWARC/2003/637, 2005/565
   
   Machine Description       Committed          FWARC/2007/070
   
   Neptune FCode Driver      Uncommitted        FWARC/2006/652
   
   Platform Resource         Uncommitted        FWARC/2008/467
   Inventory (PRI)
   

   Exported Interfaces :

   Interface Name            Classification   Description
   ====================      ==============   ================================
   "SUNW,SPARC-Enterprise-AT7480"
                             Uncommitted        "name" property value

   "SPARC Enterprise AT7480" Uncommitted        "banner-name" property value

   "SUNW,SPARC-Enterprise-AT7880"
                             Uncommitted        "name" property value

   "SPARC Enterprise AT7880" Uncommitted        "banner-name" property value

   "pcie-root-port"          Uncommitted        "device-type" property value
                                                in PRI and in MD
                                                
   "SUNW,rock-pciex108e,abcd" Uncommitted       "compatible" property value in
                                                Onboard network device nodes



5. Reference Documents:

   Supernova Platinum-II System Specification

   Supernova Silver-II (or R10) System Specification