Initial commit of memory subsystem

Change-Id: Ia6375304adaa7e04dfa642e144341d7a5776673a
Original-Change-Id: I6b63d2c4eec5d77585c91d905a464962a6153a0a
Reviewed-on: http://gfw160.aus.stglabs.ibm.com:8080/gerrit/22978
Tested-by: Jenkins Server
Reviewed-by: Craig C. Hamilton <cchamilt@us.ibm.com>
Reviewed-by: Brian Silver <bsilver@us.ibm.com>
Reviewed-on: http://ralgit01.raleigh.ibm.com/gerrit1/22759
Tested-by: FSP CI Jenkins
Reviewed-by: Daniel M. Crowell <dcrowell@us.ibm.com>

1 files changed, 165 insertions, 0 deletions

diff --git a/src/import/chips/p9/procedures/hwp/memory/lib/dimm/rcd_load.C b/src/import/chips/p9/procedures/hwp/memory/lib/dimm/rcd_load.C
new file mode 100644
index 000000000..7598d4f27
--- /dev/null
+++ b/src/import/chips/p9/procedures/hwp/memory/lib/dimm/rcd_load.C
@@ -0,0 +1,165 @@
+/* IBM_PROLOG_BEGIN_TAG                                                   */
+/* This is an automatically generated prolog.                             */
+/*                                                                        */
+/* $Source: chips/p9/procedures/hwp/memory/lib/dimm/rcd_load.C $          */
+/*                                                                        */
+/* IBM CONFIDENTIAL                                                       */
+/*                                                                        */
+/* EKB Project                                                            */
+/*                                                                        */
+/* COPYRIGHT 2015                                                         */
+/* [+] International Business Machines Corp.                              */
+/*                                                                        */
+/*                                                                        */
+/* 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.                              */
+/*                                                                        */
+/* IBM_PROLOG_END_TAG                                                     */
+
+///
+/// @file rcd_load.C
+/// @brief Run and manage the RCD_LOAD engine
+///
+// *HWP HWP Owner: Brian Silver <bsilver@us.ibm.com>
+// *HWP HWP Backup: Andre Marin <aamarin@us.ibm.com>
+// *HWP Team: Memory
+// *HWP Level: 2
+// *HWP Consumed by: FSP:HB
+
+#include <fapi2.H>
+
+#include "../mss.H"
+#include "rcd_load.H"
+#include "rcd_load_ddr4.H"
+
+using fapi2::TARGET_TYPE_MCBIST;
+using fapi2::TARGET_TYPE_MCA;
+using fapi2::TARGET_TYPE_MCS;
+using fapi2::TARGET_TYPE_DIMM;
+
+using fapi2::FAPI2_RC_SUCCESS;
+
+namespace mss
+{
+///
+/// @brief Perform the rcd_load operations - TARGET_TYPE_MCBIST specialization
+/// @param[in] i_target, a fapi2::Target<TARGET_TYPE_MCBIST>
+/// @return FAPI2_RC_SUCCESS if and only if ok
+///
+template<>
+fapi2::ReturnCode rcd_load<TARGET_TYPE_MCBIST>( const fapi2::Target<TARGET_TYPE_MCBIST>& i_target )
+{
+    // A vector of CCS instructions. We'll ask the targets to fill it, and then we'll execute it
+    ccs::program<TARGET_TYPE_MCBIST> l_program;
+
+    for (auto c : i_target.getChildren<TARGET_TYPE_MCS>())
+    {
+        for (auto p : c.getChildren<TARGET_TYPE_MCA>())
+        {
+            for (auto d : p.getChildren<TARGET_TYPE_DIMM>())
+            {
+                FAPI_DBG("rcd load for %s", mss::c_str(d));
+                FAPI_TRY( perform_rcd_load(d, l_program.iv_instructions) );
+            }
+
+            // We have to configure the CCS engine to let it know which port these instructions are
+            // going out (or whether it's broadcast ...) so lets execute the instructions we presently
+            // have so that we kind of do this by port
+            FAPI_TRY( ccs::execute(i_target, l_program, p) );
+        }
+    }
+
+fapi_try_exit:
+    return fapi2::current_err;
+}
+
+///
+/// @brief Perform the rcd_load operations - unknown DIMM case
+/// @param[in] i_target, a fapi2::Target<TARGET_TYPE_DIMM>
+/// @param[in] a vector of CCS instructions we should add to (unused)
+/// @return FAPI2_RC_SUCCESS if and only if ok
+///
+template<>
+fapi2::ReturnCode perform_rcd_load<DEFAULT_KIND>( const fapi2::Target<TARGET_TYPE_DIMM>& i_target,
+        std::vector< ccs::instruction_t<TARGET_TYPE_MCBIST> >& i_inst)
+{
+    uint8_t l_type = 0;
+    uint8_t l_gen = 0;
+
+    FAPI_TRY( mss::eff_dimm_type(i_target, l_type) );
+    FAPI_TRY( mss::eff_dram_gen(i_target, l_gen) );
+
+    // If we're here, we have a problem. The DIMM kind (type and/or generation) wasn't know
+    // to our dispatcher. We have a DIMM plugged in we don't know how to deal with.
+    FAPI_ASSERT(false,
+                fapi2::MSS_UNKNOWN_DIMM()
+                .set_DIMM_TYPE(l_type)
+                .set_DRAM_GEN(l_gen)
+                .set_DIMM_IN_ERROR(i_target),
+                "Unable to perform rcd load on %s: unknown type (%d) or generation (%d)",
+                mss::c_str(i_target), l_type, l_gen);
+
+fapi_try_exit:
+    return fapi2::current_err;
+}
+
+///
+/// @brief Perform the rcd_load operations - RDIMM DDR4
+/// @param[in] i_target, a fapi2::Target<TARGET_TYPE_DIMM>
+/// @param[in] a vector of CCS instructions we should add to
+/// @return FAPI2_RC_SUCCESS if and only if ok
+///
+template<>
+fapi2::ReturnCode perform_rcd_load<KIND_RDIMM_DDR4>( const fapi2::Target<TARGET_TYPE_DIMM>& i_target,
+        std::vector< ccs::instruction_t<TARGET_TYPE_MCBIST> >& i_inst)
+{
+    FAPI_DBG("perform rcd_load for %s [expecting rdimm (ddr4)]", mss::c_str(i_target));
+    FAPI_TRY( rcd_load_ddr4(i_target, i_inst) );
+
+fapi_try_exit:
+    return fapi2::current_err;
+}
+
+///
+/// @brief Perform the rcd_load operations - LRDIMM DDR4
+/// @param[in] i_target, a fapi2::Target<TARGET_TYPE_DIMM>
+/// @param[in] a vector of CCS instructions we should add to
+/// @return FAPI2_RC_SUCCESS if and only if ok
+///
+template<>
+fapi2::ReturnCode perform_rcd_load<KIND_LRDIMM_DDR4>( const fapi2::Target<TARGET_TYPE_DIMM>& i_target,
+        std::vector< ccs::instruction_t<TARGET_TYPE_MCBIST> >& i_inst)
+{
+    FAPI_DBG("perform rcd_load for %s [expecting lrdimm (ddr4)]", mss::c_str(i_target));
+    FAPI_TRY( rcd_load_ddr4(i_target, i_inst) );
+
+fapi_try_exit:
+    return fapi2::current_err;
+}
+
+
+///
+/// @brief Perform the rcd_load operations - start the dispatcher
+/// @param[in] i_target, a fapi2::Target<TARGET_TYPE_DIMM>
+/// @param[in] a vector of CCS instructions we should add to
+/// @return FAPI2_RC_SUCCESS if and only if ok
+///
+template<>
+fapi2::ReturnCode perform_rcd_load<FORCE_DISPATCH>( const fapi2::Target<TARGET_TYPE_DIMM>& i_target,
+        std::vector< ccs::instruction_t<TARGET_TYPE_MCBIST> >& i_inst)
+{
+    uint8_t l_type = 0;
+    uint8_t l_gen = 0;
+
+    FAPI_TRY( mss::eff_dimm_type(i_target, l_type) );
+    FAPI_TRY( mss::eff_dram_gen(i_target, l_gen) );
+
+    return perform_rcd_load_dispatch<FORCE_DISPATCH>(dimm_kind( l_type, l_gen ), i_target, i_inst);
+
+fapi_try_exit:
+    FAPI_ERR("couldn't get dimm type, dram gen: %s", mss::c_str(i_target));
+    return fapi2::current_err;
+}
+
+} // namespace