Memory buffer vpd accessor functions

    Patch set 1 is fapi1 version for comparison

Change-Id: I533ad241a5baa4c13b5b6db9207cf7016761370b
Reviewed-on: http://ralgit01.raleigh.ibm.com/gerrit1/41627
Dev-Ready: Steven B. Janssen <janssens@us.ibm.com>
Tested-by: FSP CI Jenkins <fsp-CI-jenkins+hostboot@us.ibm.com>
Tested-by: Jenkins Server <pfd-jenkins+hostboot@us.ibm.com>
Tested-by: Hostboot CI <hostboot-ci+hostboot@us.ibm.com>
Reviewed-by: Brent Wieman <bwieman@us.ibm.com>
Reviewed-by: ANDRE A. MARIN <aamarin@us.ibm.com>
Reviewed-by: Steven B. Janssen <janssens@us.ibm.com>
Reviewed-by: Jennifer A. Stofer <stofer@us.ibm.com>
Reviewed-on: http://ralgit01.raleigh.ibm.com/gerrit1/44824
Reviewed-by: Hostboot Team <hostboot@us.ibm.com>
Tested-by: Jenkins OP Build CI <op-jenkins+hostboot@us.ibm.com>
Reviewed-by: Daniel M. Crowell <dcrowell@us.ibm.com>

2 files changed, 484 insertions, 0 deletions

diff --git a/src/import/chips/centaur/procedures/xml/attribute_info/dimm_attributes.xml b/src/import/chips/centaur/procedures/xml/attribute_info/dimm_attributes.xml
index 63e46abe4..a14cff354 100644
--- a/src/import/chips/centaur/procedures/xml/attribute_info/dimm_attributes.xml
+++ b/src/import/chips/centaur/procedures/xml/attribute_info/dimm_attributes.xml
@@ -109,5 +109,16 @@
     <array>2 2 4</array>
     <platInit/>
 </attribute>
+<attribute>
+    <id>ATTR_CEN_MBVPD_VERSION</id>
+    <targetType>TARGET_TYPE_MEMBUF_CHIP</targetType>
+    <description>
+       Memory Buffer VPD version, written and consumed by the MB vpd
+       accessor functions (see getMBvpdAttr.C).
+    </description>
+    <valueType>uint32</valueType>
+    <writeable/>
+    <initToZero/>
+</attribute>
 
 </attributes>
diff --git a/src/import/chips/centaur/procedures/xml/error_info/mbvpd_errors.xml b/src/import/chips/centaur/procedures/xml/error_info/mbvpd_errors.xml
new file mode 100644
index 000000000..61c6c20b5
--- /dev/null
+++ b/src/import/chips/centaur/procedures/xml/error_info/mbvpd_errors.xml
@@ -0,0 +1,473 @@
+<!-- IBM_PROLOG_BEGIN_TAG                                                   -->
+<!-- This is an automatically generated prolog.                             -->
+<!--                                                                        -->
+<!-- $Source: src/import/chips/centaur/procedures/xml/error_info/mbvpd_errors.xml $ -->
+<!--                                                                        -->
+<!-- OpenPOWER HostBoot Project                                             -->
+<!--                                                                        -->
+<!-- Contributors Listed Below - COPYRIGHT 2017                             -->
+<!-- [+] International Business Machines Corp.                              -->
+<!--                                                                        -->
+<!--                                                                        -->
+<!-- Licensed under the Apache License, Version 2.0 (the "License");        -->
+<!-- you may not use this file except in compliance with the License.       -->
+<!-- You may obtain a copy of the License at                                -->
+<!--                                                                        -->
+<!--     http://www.apache.org/licenses/LICENSE-2.0                         -->
+<!--                                                                        -->
+<!-- Unless required by applicable law or agreed to in writing, software    -->
+<!-- distributed under the License is distributed on an "AS IS" BASIS,      -->
+<!-- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or        -->
+<!-- implied. See the License for the specific language governing           -->
+<!-- permissions and limitations under the License.                         -->
+<!--                                                                        -->
+<!-- IBM_PROLOG_END_TAG                                                     -->
+
+<!-- -->
+<!-- @file mbvpd_errors.xml -->
+<!-- @brief Error xml for buffer vpd accessor functions -->
+<!-- -->
+<!-- *HWP HWP Owner: Luke Mulkey <lwmulkey@us.ibm.com> -->
+<!-- *HWP HWP Backup: Andre Marin <aamarin@us.ibm.com> -->
+<!-- *HWP FW Owner: Dan Crowell <dcrowell@us.ibm.com> -->
+<!-- *HWP Team: Memory -->
+<!-- *HWP Level: 1 -->
+<!-- *HWP Consumed by: FSP:HB -->
+<!-- -->
+
+
+<hwpErrors>
+  <!-- ********************************************************************* -->
+  <hwpError>
+    <rc>RC_CEN_REPAIR_RING_INVALID_RINGBUF_PTR</rc>
+    <description>
+        Invalid input parameter:  pointer to ringbuffer was NULL
+    </description>
+    <callout>
+      <procedure>CODE</procedure>
+      <priority>HIGH</priority>
+    </callout>
+  </hwpError>
+  <!-- ********************************************************************* -->
+  <hwpError>
+    <rc>RC_CEN_REPAIR_RING_ALLOC_FAIL</rc>
+    <description>
+        Failed to allocate buffer space for repair ring data
+    </description>
+    <callout>
+      <procedure>CODE</procedure>
+      <priority>HIGH</priority>
+    </callout>
+  </hwpError>
+  <!-- ********************************************************************* -->
+  <hwpError>
+    <rc>RC_CEN_REPAIR_RING_INVALID_SIZE</rc>
+    <description>
+        Invalid input parameter: buffer too small to copy repair ring data
+    </description>
+    <callout>
+      <procedure>CODE</procedure>
+      <priority>HIGH</priority>
+    </callout>
+  </hwpError>
+  <!-- ********************************************************************* -->
+  <hwpError>
+    <rc>RC_CEN_REPAIR_RING_NOT_FOUND</rc>
+    <description>
+        The repair ring specified was not found.
+        Most likely reason is bad VPD
+    </description>
+    <ffdc>RING_MODIFIER</ffdc>
+    <ffdc>CHIPLET_ID</ffdc>
+    <callout>
+      <target>CHIP_TARGET</target>
+      <priority>HIGH</priority>
+    </callout>
+    <deconfigure>
+      <target>CHIP_TARGET</target>
+    </deconfigure>
+  </hwpError>
+  <!-- ********************************************************************* -->
+  <hwpError>
+    <rc>RC_CEN_MVPD_RING_FUNC_INVALID_PARAMETER</rc>
+    <description>
+        An invalid parameter was passed to a mvpd ring function.
+    </description>
+    <callout>
+      <procedure>CODE</procedure>
+      <priority>HIGH</priority>
+    </callout>
+  </hwpError>
+  <!-- ********************************************************************* -->
+  <hwpError>
+    <rc>RC_CEN_MVPD_RING_FUNC_INSUFFICIENT_RECORD_SPACE</rc>
+    <description>
+        Insufficient room in the record to set the requested ring.
+    </description>
+    <callout>
+      <procedure>CODE</procedure>
+      <priority>HIGH</priority>
+    </callout>
+  </hwpError>
+  <!-- ********************************************************************* -->
+  <hwpError>
+    <rc>RC_CEN_MVPD_EX_L2_SINGLE_MEMBER_ENABLE_BAD_FIELD_SIZE</rc>
+    <description>
+        VPD Field size too small to contain the EX_L2_SINGLE_MEMBER_ENABLE data
+    </description>
+    <ffdc>FIELD_SIZE</ffdc>
+    <callout>
+      <procedure>CODE</procedure>
+      <priority>HIGH</priority>
+    </callout>
+  </hwpError>
+  <!-- ********************************************************************* -->
+  <hwpError>
+    <rc>RC_CEN_MBVPD_INVALID_ATTRIBUTE_ID</rc>
+    <description>
+        Invalid attribute ID
+    </description>
+    <ffdc>ATTR_ID</ffdc>
+    <callout>
+      <procedure>CODE</procedure>
+      <priority>HIGH</priority>
+    </callout>
+  </hwpError>
+  <!-- ********************************************************************* -->
+  <hwpError>
+    <rc>RC_CEN_MBVPD_INVALID_OUTPUT_VARIABLE_SIZE</rc>
+    <description>
+        Output variable size must match size of expected output type.
+    </description>
+    <ffdc>ATTR_ID</ffdc>
+    <ffdc>EXPECTED_SIZE</ffdc>
+    <ffdc>PASSED_SIZE</ffdc>
+    <callout>
+      <procedure>CODE</procedure>
+      <priority>HIGH</priority>
+    </callout>
+  </hwpError>
+  <!-- ********************************************************************* -->
+  <hwpError>
+    <rc>RC_CEN_MBVPD_INSUFFICIENT_VPD_RETURNED</rc>
+    <description>
+        VPD keyword record returned is smaller than expected.
+        Probably a firmware bug, but could be bad VPD
+    </description>
+    <ffdc>KEYWORD</ffdc>
+    <ffdc>RETURNED_SIZE</ffdc>
+    <callout>
+      <procedure>CODE</procedure>
+      <priority>HIGH</priority>
+    </callout>
+    <callout>
+      <target>CHIP_TARGET</target>
+      <priority>MEDIUM</priority>
+    </callout>
+  </hwpError>
+  <!-- ********************************************************************* -->
+  <hwpError>
+    <rc>RC_CEN_MBVPD_INVALID_VM_DATA_RETURNED</rc>
+    <description>
+        VM keyword data returned is out of range of supported version values.
+        Probably a firmware bug, but could be bad VPD
+    </description>
+    <ffdc>KEYWORD</ffdc>
+    <ffdc>RETURNED_VALUE</ffdc>
+    <ffdc>RECORD_NAME</ffdc>
+    <ffdc>DIMM_TYPE</ffdc>
+    <callout>
+      <procedure>CODE</procedure>
+      <priority>HIGH</priority>
+    </callout>
+    <callout>
+      <target>CHIP_TARGET</target>
+      <priority>MEDIUM</priority>
+    </callout>
+  </hwpError>
+  <!-- ********************************************************************* -->
+  <hwpError>
+    <rc>RC_CEN_MBVPD_INVALID_VM_VERSION_RETURNED</rc>
+    <description>
+        VM version returned is out of range of supported version values.
+        Probably a firmware bug, but could be bad VPD
+    </description>
+    <ffdc>KEYWORD</ffdc>
+    <ffdc>RETURNED_VALUE</ffdc>
+    <ffdc>RECORD_NAME</ffdc>
+    <ffdc>DIMM_TYPE</ffdc>
+    <callout>
+      <procedure>CODE</procedure>
+      <priority>HIGH</priority>
+    </callout>
+    <callout>
+      <target>CHIP_TARGET</target>
+      <priority>MEDIUM</priority>
+    </callout>
+  </hwpError>
+  <!-- ********************************************************************* -->
+  <hwpError>
+    <rc>RC_CEN_MBVPD_UNEXPECTED_KEYWORD</rc>
+    <description>
+        Unexpected VPD keyword defined for the attribute in
+        attribute look up table , which doesn't have any layout properties.
+    </description>
+    <ffdc>ATTR_ID</ffdc>
+    <ffdc>KEYWORD</ffdc>
+    <ffdc>VERSION</ffdc>
+    <ffdc>DIMM_TYPE</ffdc>
+    <callout>
+      <procedure>CODE</procedure>
+      <priority>HIGH</priority>
+    </callout>
+  </hwpError>
+  <!-- ********************************************************************* -->
+  <hwpError>
+    <rc>RC_CEN_MBVPD_SUPPLIER_ID_NOT_IN_MV_VPD</rc>
+    <description>
+        The Module ID in the #I keyword is not in the list of supplier provided entries in the MV keyword.
+        Bad C-DIMM VPD.
+    </description>
+    <ffdc>MODULE_ID</ffdc>
+    <callout>
+      <target>MEMBUF_TARGET</target>
+      <priority>HIGH</priority>
+    </callout>
+    <deconfigure>
+      <target>MEMBUF_TARGET</target>
+    </deconfigure>
+    <gard>
+      <target>MEMBUF_TARGET</target>
+    </gard>
+  </hwpError>
+  <!-- ********************************************************************* -->
+  <hwpError>
+    <rc>RC_CEN_MBVPD_RING_FUNC_INVALID_PARAMETER</rc>
+    <description>
+        An invalid parameter was passed to a mbvpd ring function.
+    </description>
+    <callout>
+      <procedure>CODE</procedure>
+      <priority>HIGH</priority>
+    </callout>
+  </hwpError>
+  <!-- ********************************************************************* -->
+  <hwpError>
+    <rc>RC_CEN_MBVPD_TERM_DATA_UNSUPPORTED_VPD_ENCODE</rc>
+    <description>
+        The requested vpd value does not have a translation value.
+    </description>
+    <ffdc>ATTR_ID</ffdc>
+    <ffdc>VPD_VALUE</ffdc>
+    <callout>
+      <procedure>CODE</procedure>
+      <priority>HIGH</priority>
+    </callout>
+  </hwpError>
+  <!-- ********************************************************************* -->
+  <hwpError>
+    <rc>RC_CEN_MBVPD_DRAM_2N_MODE_NOT_EQUAL</rc>
+    <description>
+        The 2 ports of DRAM 2N MODE should be equal in VPD.
+        Bad C-DIMM VPD.
+    </description>
+    <ffdc>PORT0</ffdc>
+    <ffdc>PORT1</ffdc>
+    <callout>
+      <target>MBA_TARGET</target>
+      <priority>HIGH</priority>
+    </callout>
+    <deconfigure>
+      <target>MBA_TARGET</target>
+    </deconfigure>
+    <gard>
+      <target>MBA_TARGET</target>
+    </gard>
+  </hwpError>
+  <!-- ********************************************************************* -->
+  <hwpError>
+    <rc>RC_CEN_MBVPD_INVALID_MODE_PARAMETER</rc>
+    <description>
+        Mode must be Get or Set.
+    </description>
+    <ffdc>MODE</ffdc>
+    <callout>
+      <procedure>CODE</procedure>
+      <priority>HIGH</priority>
+    </callout>
+  </hwpError>
+  <!-- ********************************************************************* -->
+  <hwpError>
+    <rc>RC_CEN_MBVPD_UNEXPECTED_MEM_TYPE</rc>
+    <description>
+        Memory type in VSPD keyword #I not DDR3 or DDR4
+        Unsupported C-DIMM VPD.
+    </description>
+    <ffdc>MEM_TYPE</ffdc>
+    <callout>
+      <target>MEMBUF_TARGET</target>
+      <priority>HIGH</priority>
+    </callout>
+    <deconfigure>
+      <target>MEMBUF_TARGET</target>
+    </deconfigure>
+    <gard>
+      <target>MEMBUF_TARGET</target>
+    </gard>
+  </hwpError>
+  <hwpError>
+    <rc>RC_CEN_MBVPD_INVALID_MT_DATA</rc>
+    <description>
+        To get the proper MT data, we need a valid
+        dimm rank combination.
+    </description>
+    <ffdc>RANK_NUM</ffdc>
+    <callout>
+      <procedure>CODE</procedure>
+      <priority>HIGH</priority>
+    </callout>
+  </hwpError>
+  <hwpError>
+    <rc>RC_CEN_MBVPD_INVALID_DQ_DATA</rc>
+    <description>
+        To get the proper DQ data, we have to be given
+        a valid copy to collect.
+    </description>
+    <ffdc>DQ_COPY</ffdc>
+    <callout>
+      <procedure>CODE</procedure>
+      <priority>HIGH</priority>
+    </callout>
+  </hwpError>
+  <hwpError>
+    <rc>RC_CEN_MBVPD_DIMMS_NOT_FOUND</rc>
+    <description>
+        To get the proper MT data, we need to find the
+        dimm's to get a valid dimm rank combination
+    </description>
+    <ffdc>DIMM_P0S0</ffdc>
+    <ffdc>DIMM_P0S1</ffdc>
+    <ffdc>DIMM_P1S0</ffdc>
+    <ffdc>DIMM_P1S1</ffdc>
+    <callout>
+      <procedure>CODE</procedure>
+      <priority>HIGH</priority>
+    </callout>
+  </hwpError>
+  <hwpError>
+    <rc>RC_CEN_MBVPD_INVALID_DIMM_FOUND</rc>
+    <description>
+        Something went very wrong in the dimm's and
+        the combination received is not valid
+    </description>
+    <ffdc>INVALID_DIMM_P0S0</ffdc>
+    <ffdc>INVALID_DIMM_P0S1</ffdc>
+    <ffdc>INVALID_DIMM_P1S0</ffdc>
+    <ffdc>INVALID_DIMM_P1S1</ffdc>
+    <callout>
+      <procedure>MEMORY_PLUGGING_ERROR</procedure>
+      <priority>HIGH</priority>
+    </callout>
+    <callout>
+      <target>MBA</target>
+      <priority>MEDIUM</priority>
+    </callout>
+    <deconfigure>
+      <target>MBA</target>
+    </deconfigure>
+  </hwpError>
+  <hwpError>
+    <rc>RC_CEN_MBVPD_INVALID_M0_DATA</rc>
+    <description>
+         To get the proper MR data, we need to have the
+         correct M0 data.
+    </description>
+    <ffdc>M0_DATA</ffdc>
+    <callout>
+      <procedure>CODE</procedure>
+      <priority>HIGH</priority>
+    </callout>
+  </hwpError>
+  <hwpError>
+    <rc>RC_CEN_MBVPD_INVALID_DQS_DATA</rc>
+    <description>
+        To get the proper DQS data, we have to be given
+        a valid copy to collect.
+    </description>
+    <ffdc>DQS_COPY</ffdc>
+    <callout>
+      <procedure>CODE</procedure>
+      <priority>HIGH</priority>
+    </callout>
+  </hwpError>
+  <!-- ********************************************************************* -->
+  <hwpError>
+    <rc>RC_CEN_MBVPD_UNEXPECTED_ISDIMM_KEYWORD</rc>
+    <description>
+         ISDIMM Attribute definition has unexpected keyword value.
+    </description>
+    <ffdc>ATTR_ID</ffdc>
+    <ffdc>KEYWORD</ffdc>
+    <callout>
+      <procedure>CODE</procedure>
+      <priority>HIGH</priority>
+    </callout>
+  </hwpError>
+  <!-- ********************************************************************* -->
+  <hwpError>
+    <rc>RC_CEN_MBVPD_DEFAULT_UNEXPECTED_OUTPUT_TYPE</rc>
+    <description>
+         Default attribute definition has unexpected output type.
+    </description>
+    <ffdc>ATTR_ID</ffdc>
+    <ffdc>DIMM_TYPE</ffdc>
+    <ffdc>OUTPUT_TYPE</ffdc>
+    <callout>
+      <procedure>CODE</procedure>
+      <priority>HIGH</priority>
+    </callout>
+  </hwpError>
+  <!-- ********************************************************************* -->
+  <hwpError>
+    <rc>RC_CEN_MBVPD_UINT64_UNEXPECTED_OUTPUT_TYPE</rc>
+    <description>
+         Uint64_t attribute definition has unexpected output type.
+    </description>
+    <ffdc>ATTR_ID</ffdc>
+    <ffdc>DIMM_TYPE</ffdc>
+    <ffdc>OUTPUT_TYPE</ffdc>
+    <callout>
+      <procedure>CODE</procedure>
+      <priority>HIGH</priority>
+    </callout>
+  </hwpError>
+  <!-- ********************************************************************* -->
+  <hwpError>
+    <rc>RC_CEN_MBVPD_UNEXPECTED_OUTPUT_TYPE</rc>
+    <description>
+         Attribute definition has unexpected output type.
+    </description>
+    <ffdc>ATTR_ID</ffdc>
+    <ffdc>DIMM_TYPE</ffdc>
+    <ffdc>OUTPUT_TYPE</ffdc>
+    <callout>
+      <procedure>CODE</procedure>
+      <priority>HIGH</priority>
+    </callout>
+  </hwpError>
+  <!-- ********************************************************************* -->
+  <hwpError>
+    <rc>RC_CEN_MBVPD_ATTRIBUTE_NOT_FOUND</rc>
+    <description>
+        Attribute not found in attribute look up table
+    </description>
+    <ffdc>ATTR_ID</ffdc>
+    <ffdc>DIMM_TYPE</ffdc>
+    <ffdc>VERSION</ffdc>
+    <callout>
+      <procedure>CODE</procedure>
+      <priority>HIGH</priority>
+    </callout>
+  </hwpError>
+  <!-- ********************************************************************* -->
+</hwpErrors>