HWPF: Add MVPD Accessor HWP to retrieve ATTR_EX_L2_SINGLE_MEMBER_ENABLE

The existing code supports ATTR_EX_L2_SINGLE_MEMBER_ENABLE with a zero-init
Targeting attribute, but this is just a temporary hack. This data is in MVPD
and each platform supports it by calling a common VPD accessor HWP.

Change-Id: Id9efbd762aafb3e80b5997024c09038297fe86a9
RTC: 64824
Reviewed-on: http://gfw160.austin.ibm.com:8080/gerrit/3989
Tested-by: Jenkins Server
Reviewed-by: William H. Schwartz <whs@us.ibm.com>
Reviewed-by: KUMAR V. CHALLA <kvchalla@us.ibm.com>
Reviewed-by: A. Patrick Williams III <iawillia@us.ibm.com>

2 files changed, 90 insertions, 0 deletions

diff --git a/src/include/usr/hwpf/hwp/mvpd_accessors/getMvpdExL2SingleMemberEnable.H b/src/include/usr/hwpf/hwp/mvpd_accessors/getMvpdExL2SingleMemberEnable.H
new file mode 100644
index 000000000..f3ba8df79
--- /dev/null
+++ b/src/include/usr/hwpf/hwp/mvpd_accessors/getMvpdExL2SingleMemberEnable.H
@@ -0,0 +1,72 @@
+/* IBM_PROLOG_BEGIN_TAG                                                   */
+/* This is an automatically generated prolog.                             */
+/*                                                                        */
+/* $Source: src/include/usr/hwpf/hwp/mvpd_accessors/getMvpdExL2SingleMemberEnable.H $ */
+/*                                                                        */
+/* IBM CONFIDENTIAL                                                       */
+/*                                                                        */
+/* COPYRIGHT International Business Machines Corp. 2013                   */
+/*                                                                        */
+/* p1                                                                     */
+/*                                                                        */
+/* Object Code Only (OCO) source materials                                */
+/* Licensed Internal Code Source Materials                                */
+/* IBM HostBoot Licensed Internal Code                                    */
+/*                                                                        */
+/* The source code for this program is not published or otherwise         */
+/* divested of its trade secrets, irrespective of what has been           */
+/* deposited with the U.S. Copyright Office.                              */
+/*                                                                        */
+/* Origin: 30                                                             */
+/*                                                                        */
+/* IBM_PROLOG_END_TAG                                                     */
+// $Id: getMvpdExL2SingleMemberEnable.H,v 1.1 2013/04/10 22:02:29 mjjones Exp $
+/**
+ *  @file getMvpdExL2SingleMemberEnable.H
+ *
+ *  @brief MVPD Accessor for providing the ATTR_EX_L2_SINGLE_MEMBER_ENABLE
+ *         attribute
+ */
+
+/*
+ * Change Log ******************************************************************
+ * Flag     Defect/Feature  User        Date        Description
+ * ------   --------------  ----------  ----------- ----------------------------
+ *                          mjjones     04/10/2013  Created.
+ */
+
+#ifndef _HWP_GETMVPDEXL2SINGLEMEMBERENABLE_
+#define _HWP_GETMVPDEXL2SINGLEMEMBERENABLE_
+
+#include <fapi.H>
+
+// function pointer typedef definition for HWP call support
+typedef fapi::ReturnCode (*getMvpdExL2SingleMemberEnable_FP_t)
+    (const fapi::Target &, uint32_t &);
+
+extern "C"
+{
+/**
+ * @brief Get the ATTR_EX_L2_SINGLE_MEMBER_ENABLE FAPI attribute
+ *
+ * This data in MVPD indicates which EX chiplets must be configured with the L2
+ * cache in single member mode. The data is used by the p8_xip_customize HWP. It
+ * is used by the FSP platform to build the IPL image, and the Hostboot platform
+ * to build the SLW image. The data is a bit-field.
+ *
+ * @param[in]  i_procTarget - Reference to Processor Chip FAPI Target
+ * @param[out] o_val        - Filled in with attribute value
+ *                            0x00008000 - EX00 single member enable
+ *                            0x00004000 - EX01 single member enable
+ *                            <snip>
+ *                            0x00000002 - EX14 single member enable
+ *                            0x00000001 - EX15 single member enable
+ *
+ * @return fapi::ReturnCode FAPI_RC_SUCCESS if success, else error code
+ */
+fapi::ReturnCode getMvpdExL2SingleMemberEnable(
+    const fapi::Target & i_procTarget,
+    uint32_t & o_val);
+}
+
+#endif
diff --git a/src/include/usr/hwpf/plat/fapiPlatAttributeService.H b/src/include/usr/hwpf/plat/fapiPlatAttributeService.H
index f9834bddd..9715626dc 100644
--- a/src/include/usr/hwpf/plat/fapiPlatAttributeService.H
+++ b/src/include/usr/hwpf/plat/fapiPlatAttributeService.H
@@ -412,6 +412,18 @@ fapi::ReturnCode fapiPlatGetProcPcieBarSize (
                                     const fapi::Target * i_pTarget,
                                     uint64_t    (&o_pcieBarSize) [3][3] );
 
+/**
+ * @brief This function is called by the FAPI_ATTR_GET macro when getting
+ * ATTR_EX_L2_SINGLE_MEMBER_ENABLE. It should not be called directly.
+ *
+ *  @param[in]  i_pTarget Target pointer
+ *  @param[out] o_val     ATTR_EX_L2_SINGLE_MEMBER_ENABLE value
+ *  @return     ReturnCode. Zero on success, else platform specified error
+ */
+fapi::ReturnCode fapiPlatGetSingleMemberEnableAttr(
+    const fapi::Target * i_pTarget,
+    uint32_t & o_val);
+
 } // namespace platAttrSvc
 
 } // namespace fapi
@@ -706,4 +718,10 @@ fapi::ReturnCode fapiPlatGetProcPcieBarSize (
     fapi::AttrOverrideSync::getAttrOverrideFunc(fapi::ID, PTARGET, &VAL) ? fapi::FAPI_RC_SUCCESS : \
     fapi::platAttrSvc::fapiPlatGetEnableAttr ( fapi::ID, PTARGET, VAL )
 
+//------------------------------------------------------------------------------
+//  MACROS to support MVPD attributes
+//------------------------------------------------------------------------------
+#define ATTR_EX_L2_SINGLE_MEMBER_ENABLE_GETMACRO( ID, PTARGET, VAL )   \
+    fapi::platAttrSvc::fapiPlatGetSingleMemberEnableAttr ( PTARGET, VAL )
+
 #endif // FAPIPLATATTRIBUTESERVICE_H_