diff options
author | Brian Silver <bsilver@us.ibm.com> | 2016-01-07 14:35:20 -0600 |
---|---|---|
committer | Daniel M. Crowell <dcrowell@us.ibm.com> | 2016-04-01 21:23:41 -0400 |
commit | 3a11ab737feeb6695f949f355f41081e64dec2f5 (patch) | |
tree | 4f1e16a5ac0351f8b8eb236322916ea587159db0 /src/import/chips/p9/procedures/hwp/memory/lib/mcbist/mcbist.C | |
parent | dba9ee6be396b29a072d9c5fc87ff346542c396e (diff) | |
download | talos-hostboot-3a11ab737feeb6695f949f355f41081e64dec2f5.tar.gz talos-hostboot-3a11ab737feeb6695f949f355f41081e64dec2f5.zip |
Add mcbist L2 function
Change-Id: Ie902a404323fe781aca99af2c20ca6ba564a06da
Original-Change-Id: I8b98c188d6a642eb49d89deffcbd697d9cf7afdc
Reviewed-on: http://gfw160.aus.stglabs.ibm.com:8080/gerrit/23895
Tested-by: Jenkins Server
Reviewed-by: Craig C. Hamilton <cchamilt@us.ibm.com>
Reviewed-by: Andre A. Marin <aamarin@us.ibm.com>
Reviewed-by: Jennifer A. Stofer <stofer@us.ibm.com>
Reviewed-on: http://ralgit01.raleigh.ibm.com/gerrit1/22768
Tested-by: FSP CI Jenkins
Reviewed-by: Daniel M. Crowell <dcrowell@us.ibm.com>
Diffstat (limited to 'src/import/chips/p9/procedures/hwp/memory/lib/mcbist/mcbist.C')
-rw-r--r-- | src/import/chips/p9/procedures/hwp/memory/lib/mcbist/mcbist.C | 171 |
1 files changed, 170 insertions, 1 deletions
diff --git a/src/import/chips/p9/procedures/hwp/memory/lib/mcbist/mcbist.C b/src/import/chips/p9/procedures/hwp/memory/lib/mcbist/mcbist.C index f2184f89b..c06df116a 100644 --- a/src/import/chips/p9/procedures/hwp/memory/lib/mcbist/mcbist.C +++ b/src/import/chips/p9/procedures/hwp/memory/lib/mcbist/mcbist.C @@ -7,7 +7,7 @@ /* */ /* EKB Project */ /* */ -/* COPYRIGHT 2015 */ +/* COPYRIGHT 2015,2016 */ /* [+] International Business Machines Corp. */ /* */ /* */ @@ -29,13 +29,182 @@ #include <fapi2.H> #include "mcbist.H" +#include "../utils/dump_regs.H" using fapi2::TARGET_TYPE_MCBIST; +using fapi2::TARGET_TYPE_MCA; namespace mss { namespace mcbist { +/// +/// @brief Load a set of MCBIST subtests in to the MCBIST registers +/// @tparam T, the fapi2::TargetType - derived +/// @tparam TT, the mcbistTraits associated with T - derived +/// @param[in] the target to effect +/// @param[in] the mcbist::program +/// @return FAPI2_RC_SUCCSS iff ok +/// @note assumes the MCBIST engine has been configured. +/// +template<> +fapi2::ReturnCode load_mcbmr( const fapi2::Target<TARGET_TYPE_MCBIST>& i_target, + const mcbist::program<TARGET_TYPE_MCBIST>& i_program ) +{ + + // Leave if there are no subtests. + if (0 == i_program.iv_subtests.size()) + { + FAPI_DBG("no subtests, noting to do"); + return fapi2::current_err; + } + + // List of the 8 MCBIST registers - each holds 4 subtests. + static const std::vector< uint64_t > l_memory_registers = + { + MCBIST_MCBMR0Q, MCBIST_MCBMR1Q, MCBIST_MCBMR2Q, MCBIST_MCBMR3Q, + MCBIST_MCBMR4Q, MCBIST_MCBMR5Q, MCBIST_MCBMR6Q, MCBIST_MCBMR7Q, + }; + + std::vector< uint64_t > l_memory_register_buffers = + { + 0, 0, 0, 0, 0, 0, 0, 0, + }; + + static const size_t SUBTEST_PER_REG = 4; + static const size_t SUBTEST_PER_PROGRAM = 32; + + static const auto BITS_IN_SUBTEST = sizeof(mcbist::subtest_t<TARGET_TYPE_MCBIST>().iv_mcbmr) * 8; + static const auto LEFT_SHIFT = (sizeof(uint64_t) * 8) - BITS_IN_SUBTEST; + + ssize_t l_bin = -1; + size_t l_register_shift = 0; + + // We'll shift this in to position to indicate which subtest is the last + static const uint64_t l_done_bit( 0x8000000000000000 >> MCBIST_MCBMR0Q_MCBIST_CFG_TEST00_DONE ); + + // TK: For now limit MCBIST programs to 32 subtests. + const auto l_program_size = i_program.iv_subtests.size(); + FAPI_ASSERT( l_program_size <= SUBTEST_PER_PROGRAM, + fapi2::MSS_MCBIST_PROGRAM_TOO_BIG().set_PROGRAM_LENGTH(l_program_size), + "mcbist program of length %d exceeds arbitrary maximum of %d", l_program_size, SUBTEST_PER_PROGRAM ); + + // Distribute the program over the 8 MCBIST subtest registers + // We need the index, so increment thru i_program.iv_subtests.size() + for (size_t l_index = 0; l_index < l_program_size; ++l_index) + { + l_bin = (l_index % SUBTEST_PER_REG) == 0 ? l_bin + 1 : l_bin; + l_register_shift = (l_index % SUBTEST_PER_REG) * BITS_IN_SUBTEST; + + l_memory_register_buffers[l_bin] |= + (uint64_t(i_program.iv_subtests[l_index].iv_mcbmr) << LEFT_SHIFT) >> l_register_shift; + + FAPI_DBG("putting subtest %d (0x%x) in MCBMR%dQ shifted %d 0x%016llx", + l_index, i_program.iv_subtests[l_index].iv_mcbmr, l_bin, + l_register_shift, l_memory_register_buffers[l_bin]); + } + + // l_bin and l_register_shift are the values for the last subtest we'll tell the MCBIST about. + // We need to set that subtest's done-bit so the MCBIST knows it's the end of the line + l_memory_register_buffers[l_bin] |= l_done_bit >> l_register_shift; + FAPI_DBG("setting MCBMR%dQ subtest %llu as the last subtest 0x%016llx", + l_bin, l_register_shift, l_memory_register_buffers[l_bin]); + + // ... and slam the values in to the registers. + // Could just decrement l_bin, but that scoms the subtests in backwards and is confusing + for (auto l_index = 0; l_index <= l_bin; ++l_index) + { + FAPI_TRY( mss::putScom(i_target, l_memory_registers[l_index], l_memory_register_buffers[l_index]) ); + } + +fapi_try_exit: + return fapi2::current_err; +} + +/// +/// @brief Execute the mcbist program +/// @param[in] i_target the target to effect +/// @param[in] i_program, the mcbist program to execute +/// @return fapi2::ReturnCode, FAPI2_RC_SUCCESS iff OK +/// +template<> +fapi2::ReturnCode execute( const fapi2::Target<TARGET_TYPE_MCBIST>& i_target, + const program<TARGET_TYPE_MCBIST>& i_program ) +{ + typedef mcbistTraits<TARGET_TYPE_MCBIST> TT; + + static const uint64_t l_done = fapi2::buffer<uint64_t>().setBit<TT::MCBIST_DONE>(); + static const uint64_t l_fail = fapi2::buffer<uint64_t>().setBit<TT::MCBIST_FAIL>(); + + fapi2::buffer<uint64_t> l_status; + + // Slam the subtests in to the mcbist registers + FAPI_TRY( load_mcbmr(i_target, i_program) ); + + // Slam the parameters in to the mcbist parameter register + FAPI_TRY( load_mcbparm(i_target, i_program) ); + + // Slam the address generator config + FAPI_TRY( load_addr_gen(i_target, i_program) ); + + // Slam the configured address maps down + FAPI_TRY( load_mcbamr( i_target, i_program) ); + + // Slam the config register down + FAPI_TRY( load_config( i_target, i_program) ); + + // Slam the control register down + FAPI_TRY( load_control( i_target, i_program) ); + + // Start the engine, and then poll for completion + // Note: We need to have a bit in the program for 'async' mode where an attention + // bit is set and we can fire-and-forget BRS + FAPI_TRY(start_stop(i_target, mss::START)); + + mss::poll(i_target, TT::STATQ_REG, i_program.iv_poll, + [&l_status](const size_t poll_remaining, const fapi2::buffer<uint64_t>& stat_reg) -> bool + { + FAPI_DBG("mcbist statq 0x%llx, remaining: %d", stat_reg, poll_remaining); + l_status = stat_reg; + return l_status.getBit<TT::MCBIST_IN_PROGRESS>() != 1; + }); + + // The control register has a bit for done-and-happy and a bit for done-and-unhappy + if ((l_status & l_done) == l_done) + { + FAPI_DBG("MCBIST executed successfully."); + return fapi2::current_err; + } + + if ((l_status & l_fail) == l_fail) + { + FAPI_DBG("MCBIST failed execution."); + return fapi2::FAPI2_RC_FALSE; + } + + // So something set more than one bit in the control register? + FAPI_DBG("MCBIST executed <shrug>. Something's not good 0x%016llx", l_status); + return fapi2::FAPI2_RC_FALSE; + +fapi_try_exit: + return fapi2::current_err; +} + } // namespace + +// Note: outside of the mcbist namespace + +/// +/// @brief Dump the registers of an mcbist +/// @param[in] i_target, the mcbist in question +/// @return fapi2::FAPI2_RC_SUCCESS if ok +/// +template<> +fapi2::ReturnCode dump_regs( const fapi2::Target<TARGET_TYPE_MCBIST>& i_target ) +{ + return fapi2::current_err; +} + + } // namespace |