--- PRI_Specification_110.txt 2009-09-17 10:10:37.735367000 -0700 +++ PRI_Specification_111.txt 2009-09-28 13:10:55.939300076 -0700 @@ -1,7 +1,7 @@ -Version 1.10 -Date : 07/11/2009 +Version 1.11 +Date : 09/22/2009 Revision History : 1.0 Approved by FWARC/2006/700. 1.1 Added memory segment nodes and updates to component node. @@ -33,10 +33,12 @@ 1.10 Added 'sp' as an acceptable value to the component type property. Merged in the change for FWARC case 2009/169 which was inadvertently dropped by case 2009/281. Added 'chassis' and 'product' type nodes. (FWARC/2009/390) +1.11 Added requirements on topo-skip, topo-hc-name, and path properties + for io nodes describing XAUI cards or internal hard disks. Physical Resource Inventory (PRI) Specification =============================================== 1.0 Introduction @@ -239,16 +241,20 @@ required for strand, mem-board, and cpu-board nodes. Any type of node may have a nac property. nac is required for component nodes that are FRUs (fru property = 0x1) -An io type node may have a path property, as described below. +An io type node may have a path property, as described below. For io nodes +describing XAUI cards, the path property is required. -Any type of node may set the topo-hc-name property. This property is -required for nodes that do *not* set the topo-skip property. +Any type of node may set the topo-hc-name property. This property is +required for nodes that do *not* set the topo-skip property. The property +is also required, irrespective of the topo-skip setting, for io nodes that +describe XAUI cards. -Any type of node may set the topo-skip property. +Any type of node may set the topo-skip property. For io nodes describing +XAUI cards, this property *must* be set to a non-zero value. Nodes representing a root complex must use a topo-hc-name of "hostbridge" and set the path property. Previous requirements for setting the cfg-handle property for a node representing a root complex is now deprecated. @@ -276,12 +282,17 @@ provided in the components node: chip/memory-buffer *OR* memory-controller/memory-buffer. No intervening nodes are allowed. Node hierarchy above or below is arbitrary per platform. For platforms wishing to employ diagnosis of a faulted service processor, -a component node of type sp *must* be present. It must use a -topo-hc-name of "sp" and be a FRU. +a topo-hc-name hierarchy of chassis/sp *must* be provided in the components +node. Furthermore, the node describing the 'sp' must be tagged as a FRU. + +For platforms wishing to employ diagnosis of internal hard disks, io nodes +describing hard drive bays (e.g. nac = "HDD#") must specify a topo-hc-name +of "bay" and the id property. The 'id' property must match the physical +identification (i.e. HDD0 is id 0, HDD1 is id 1, etc.). 1.3.2 nac Property Name Tag Required ---- --- -------- @@ -375,11 +386,11 @@ Description ----------- This property contains the canonical path of an io device, composed of its full device path with device names removed. It is required on nodes where -the topo-hc-name property is set to "hostbridge" or "pciexrc". +the topo-hc-name property is set to "hostbridge", "pciexrc", "bay" or "xaui". It is possible to find the FRU parent of an io device by doing a search beginning with its parent and continuing through its ancestry until reaching a component node with a fru property with value of 1. @@ -523,26 +534,28 @@ topo-hc-name PROP_STR yes Description ----------- This property contains the FM libtopo hc canonical name string for a node. -It is used by Solaris enumerators when instantiating a topology. It is -required for all nodes *except* if those that set topo-skip to a non-zero -value. The value of topo-hc-name must be an approved name per FMA's hc scheme. +It is used by Solaris enumerators when instantiating a topology. The value +of topo-hc-name must be an approved name per FMA's hc scheme [8]. It is +required for all nodes that do not use/set topo-skip. It is also required +on io nodes describing XAUI cards, irrespective of that node's topo-skip value. 1.3.19 topo-skip Name Tag Required ---- --- -------- -topo-skip PROP_VAL no +topo-skip PROP_VAL no * Description ----------- When this property is present and has a non-zero integer value, the sun4v platform independent enumerator will *not* create FM topology nodes for this node or any of it's children. This property can be used on -any type of node. +any type of node. This property *is required* and must be a non-zero value +for io nodes describing XAUI cards. 1.4 Firmware Node Name Category Required subordinates Optional subordinates ---- -------- --------------------- --------------------- @@ -1307,6 +1320,7 @@ http://playground.sun.com/1275/practice/imap/imap0_9d.pdf [7] MSI properties list http://sac.sfbay/FWARC/2005/030/materials/msi-props.txt - + [8] Solaris FMA hc scheme names + http://src.opensolaris.org/source/xref/onnv/onnv-gate/usr/src/lib/fm/topo/libtopo/common/topo_hc.h