summaryrefslogtreecommitdiffstats
path: root/src/import/generic/memory/lib/spd/lrdimm/ddr4
diff options
context:
space:
mode:
authorAndre Marin <aamarin@us.ibm.com>2017-03-22 23:04:12 -0500
committerDaniel M. Crowell <dcrowell@us.ibm.com>2017-03-27 12:29:28 -0400
commitaae922c1132fa71bd4ffb711296420755c7c0098 (patch)
treeea757503109d8918cb54105405a81438439797ff /src/import/generic/memory/lib/spd/lrdimm/ddr4
parenta8edc5a1152e91170728d19ae5d0839223803bef (diff)
downloadtalos-hostboot-aae922c1132fa71bd4ffb711296420755c7c0098.tar.gz
talos-hostboot-aae922c1132fa71bd4ffb711296420755c7c0098.zip
Add base spd decoder to share among controllers
Reorganized files and names to make room for DDR3 SPD decoder to be used for Cumulus. Change-Id: Id3e7a8f4bb60fd0ae0cdf36b8298a1d00257205a Reviewed-on: http://ralgit01.raleigh.ibm.com/gerrit1/36319 Tested-by: Jenkins Server <pfd-jenkins+hostboot@us.ibm.com> Tested-by: Hostboot CI <hostboot-ci+hostboot@us.ibm.com> Reviewed-by: Brian R. Silver <bsilver@us.ibm.com> Reviewed-by: STEPHEN GLANCY <sglancy@us.ibm.com> Reviewed-by: Louis Stermole <stermole@us.ibm.com> Reviewed-by: Jennifer A. Stofer <stofer@us.ibm.com> Reviewed-on: http://ralgit01.raleigh.ibm.com/gerrit1/36326 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>
Diffstat (limited to 'src/import/generic/memory/lib/spd/lrdimm/ddr4')
-rw-r--r--src/import/generic/memory/lib/spd/lrdimm/ddr4/lrdimm_decoder_ddr4.H670
-rw-r--r--src/import/generic/memory/lib/spd/lrdimm/ddr4/lrdimm_decoder_ddr4_v1_0.C1367
-rw-r--r--src/import/generic/memory/lib/spd/lrdimm/ddr4/lrdimm_decoder_ddr4_v1_1.C273
-rw-r--r--src/import/generic/memory/lib/spd/lrdimm/ddr4/lrdimm_decoder_ddr4_v1_2.C306
-rw-r--r--src/import/generic/memory/lib/spd/lrdimm/ddr4/lrdimm_raw_cards.C84
-rw-r--r--src/import/generic/memory/lib/spd/lrdimm/ddr4/lrdimm_raw_cards.H68
6 files changed, 2768 insertions, 0 deletions
diff --git a/src/import/generic/memory/lib/spd/lrdimm/ddr4/lrdimm_decoder_ddr4.H b/src/import/generic/memory/lib/spd/lrdimm/ddr4/lrdimm_decoder_ddr4.H
new file mode 100644
index 000000000..32d4c6245
--- /dev/null
+++ b/src/import/generic/memory/lib/spd/lrdimm/ddr4/lrdimm_decoder_ddr4.H
@@ -0,0 +1,670 @@
+/* IBM_PROLOG_BEGIN_TAG */
+/* This is an automatically generated prolog. */
+/* */
+/* $Source: src/import/generic/memory/lib/spd/lrdimm/ddr4/lrdimm_decoder_ddr4.H $ */
+/* */
+/* OpenPOWER HostBoot Project */
+/* */
+/* Contributors Listed Below - COPYRIGHT 2016,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 lrdimm_decoder.H
+/// @brief LRDIMM module SPD decoder declarations
+///
+// *HWP HWP Owner: Andre Marin <aamarin@us.ibm.com>
+// *HWP HWP Backup: Brian Silver <bsilver@us.ibm.com>
+// *HWP Team: Memory
+// *HWP Level: 2
+// *HWP Consumed by: HB:FSP
+
+
+#ifndef _MSS_LRDIMM_DECODER_H_
+#define _MSS_LRDIMM_DECODER_H_
+
+#include <fapi2.H>
+#include <vector>
+#include <generic/memory/lib/spd/common/dimm_module_decoder.H>
+
+namespace mss
+{
+namespace spd
+{
+namespace lrdimm
+{
+
+///
+/// @brief LRDIMM module decoder for revision 1.0
+///
+class decoder_v1_0 : public dimm_module_decoder
+{
+ protected:
+
+ const fapi2::Target<fapi2::TARGET_TYPE_DIMM> iv_target;
+
+ constexpr static field_t MODULE_NOMINAL_HEIGHT{128, 3, 5};
+ constexpr static field_t RAW_CARD_EXTENSION{128, 0, 3};
+
+ constexpr static field_t FRONT_MODULE_THICKNESS{129, 4, 4};
+ constexpr static field_t BACK_MODULE_THICKNESS{129, 0, 4};
+
+ constexpr static field_t NUM_REGISTERS_USED{131, 6, 2};
+ constexpr static field_t NUM_ROWS_OF_DRAMS{131, 4, 2};
+ constexpr static field_t REGISTER_TYPE{131, 0, 4};
+
+ constexpr static field_t HEAT_SPREADER_THERM_CHAR{132, 1, 7};
+ constexpr static field_t HEAT_SPREADER_SOLUTION{132, 0, 1};
+
+ constexpr static field_t CONTINUATION_CODES{133, 1, 7};
+ constexpr static field_t ADDR_MAPPING{136, 7, 1};
+
+ constexpr static field_t CKE_DRIVE_STRENGTH{137, 6, 2};
+ constexpr static field_t ODT_DRIVE_STRENGTH{137, 4, 2};
+ constexpr static field_t CA_DRIVE_STRENGTH{137, 2, 2};
+ constexpr static field_t CS_DRIVE_STRENGTH{137, 0, 2};
+
+ constexpr static field_t B_SIDE_DRIVE_STRENGTH{138, 6, 2};
+ constexpr static field_t A_SIDE_DRIVE_STRENGTH{138, 4, 2};
+ constexpr static field_t BCOM_BODT_BCKE_DRIVE_STRENGTH{138, 3, 1};
+ constexpr static field_t BCK_DRIVE_STRENGTH{138, 2, 1};
+ constexpr static field_t RCD_SLEW_CNTRL{138, 1, 1 };
+
+ constexpr static field_t VREF_DQ_RANK0{140, 2, 6};
+ constexpr static field_t VREF_DQ_RANK1{141, 2, 6};
+ constexpr static field_t VREF_DQ_RANK2{142, 2, 6};
+ constexpr static field_t VREF_DQ_RANK3{143, 2, 6};
+
+ constexpr static field_t DATA_BUFFER_MDQ{145, 1, 3};
+
+ constexpr static field_t DRAM_VREF_DQ_RANGE{155, 4, 4};
+ constexpr static field_t DATA_BUFFER_VREF_DQ{155, 3, 1};
+
+ constexpr static field_t DATA_BUFFER_GAIN_ADJUST{156, 7, 1};
+ constexpr static field_t DATA_BUFFER_DFE{156, 6, 1};
+
+ public:
+ // Allows injection of errors for testing
+ // TK - Consider API change to use setter/getters
+ // for this instance variable, RDIMM decoder
+ // uses this interface so they have to match - AAM
+ std::vector<uint8_t> iv_spd_data;
+
+ // deleted default ctor
+ decoder_v1_0() = delete;
+
+ ///
+ /// @brief ctor
+ /// @param[in] i_target dimm target
+ /// @param[in] i_spd_data vector DIMM SPD data
+ ///
+ decoder_v1_0(const fapi2::Target<fapi2::TARGET_TYPE_DIMM>& i_target,
+ const std::vector<uint8_t>& i_spd_data)
+ : iv_target(i_target), iv_spd_data(i_spd_data)
+ {}
+
+ ///
+ /// @brief default dtor
+ ///
+ virtual ~decoder_v1_0() = default;
+
+ ///
+ /// @brief Decodes module nominal height max
+ /// @param[out] o_output height range encoding from SPD
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note SPD Byte 128 (Bits 4~0)
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 2
+ /// @note Page 4.1.2.12.2 - 55
+ ///
+ virtual fapi2::ReturnCode max_module_nominal_height(uint8_t& o_output) override;
+
+ ///
+ /// @brief Decodes raw card extension
+ /// @param[out] o_output raw card rev. encoding from SPD
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note SPD Byte 128 (Bits 7~5)
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 2
+ /// @note Page 4.1.2.12.2 - 55
+ ///
+ virtual fapi2::ReturnCode raw_card_extension(uint8_t& o_output) override;
+
+ ///
+ /// @brief Decodes front module maximum thickness max
+ /// @param[out] o_output encoding from SPD
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note SPD Byte 129 (Bits 3~0)
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 2
+ /// @note Page 4.1.2.12.2 - 55
+ ///
+ virtual fapi2::ReturnCode front_module_max_thickness(uint8_t& o_output) override;
+
+ ///
+ /// @brief Decodes back module maximum thickness max
+ /// @param[out] o_output encoding from SPD
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note SPD Byte 129 (Bits 7~4)
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 2
+ /// @note Page 4.1.2.12.2 - 55
+ ///
+ virtual fapi2::ReturnCode back_module_max_thickness(uint8_t& o_output) override;
+
+ ///
+ /// @brief Decodes number of registers used on LRDIMM
+ /// @param[out] o_output encoding from SPD
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note SPD Byte 131 (Bits 1~0)
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 2
+ /// @note Page 4.1.2.12.2 - 57
+ ///
+ virtual fapi2::ReturnCode num_registers_used(uint8_t& o_output) override;
+
+ ///
+ /// @brief Decodes number of rows of DRAMs on LRDIMM
+ /// @param[out] o_output encoding from SPD
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note SPD Byte 131 (Bits 3~2)
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 2
+ /// @note Page 4.1.2.12.2 - 57
+ ///
+ virtual fapi2::ReturnCode num_rows_of_drams(uint8_t& o_output) override;
+
+ ///
+ /// @brief Decodes heat spreader solution
+ /// @param[out] o_output drive strength encoding from SPD
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note SPD Byte 132 (Bit 7)
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 2
+ /// @note Page 4.1.2.12.2 - 58
+ ///
+ virtual fapi2::ReturnCode heat_spreader_solution(uint8_t& o_output) override;
+
+ ///
+ /// @brief Decodes number of continuation codes
+ /// @param[out] o_output drive strength encoding from SPD
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note SPD Byte 133 (Bits 6~0)
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 2
+ /// @note Page 4.1.2.12.2 - 58
+ ///
+ virtual fapi2::ReturnCode num_continuation_codes(uint8_t& o_output) override;
+
+ ///
+ /// @brief Decodes register manufacturer ID code
+ /// @param[out] o_output drive strength encoding from SPD
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note SPD Byte 134 (Bits 7~0)
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 2
+ /// @note Page 4.1.2.12.2 - 58
+ ///
+ virtual fapi2::ReturnCode reg_manufacturer_id_code(uint8_t& o_output) override;
+
+ ///
+ /// @brief Decodes register revision number
+ /// @param[out] o_output drive strength encoding from SPD
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note SPD Byte 135 (Bits 7~0)
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 2
+ /// @note Page 4.1.2.12.2 - 58
+ ///
+ virtual fapi2::ReturnCode register_rev_num(uint8_t& o_output) override;
+
+ ///
+ /// @brief Decodes address mapping from register to dram
+ /// @param[out] o_output drive strength encoding from SPD
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note SPD Byte 136 (Bit 0)
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 2
+ /// @note Page 4.1.2.12.2 - 59
+ ///
+ virtual fapi2::ReturnCode register_to_dram_addr_mapping(uint8_t& o_output) override;
+
+ ///
+ /// @brief Decodes register output drive strength for CKE signal
+ /// @param[out] o_output encoding from SPD
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 2
+ /// @note Page 4.1.2.12.2 - 60
+ ///
+ virtual fapi2::ReturnCode cke_signal_output_driver(uint8_t& o_output) override;
+
+ ///
+ /// @brief Decodes register output drive strength for ODT signal
+ /// @param[out] o_output encoding from SPD
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note SPD Byte 137 (Bits 3~2)
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 2
+ /// @note Page 4.1.2.12.2 - 60
+ ///
+ virtual fapi2::ReturnCode odt_signal_output_driver(uint8_t& o_output) override;
+
+ ///
+ /// @brief Decodes register output drive strength for command/address (CA) signal
+ /// @param[out] o_output drive strength encoding from SPD
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note SPD Byte 137 (Bits 5~4)
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 2
+ /// @note Page 4.1.2.12.2 - 60
+ ///
+ virtual fapi2::ReturnCode ca_signal_output_driver(uint8_t& o_output) override;
+
+ ///
+ /// @brief Decodes register output drive strength for control signal (CS) signal
+ /// @param[out] o_output encoding from SPD
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note SPD Byte 137 (Bits 6~7)
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 2
+ /// @note Page 4.1.2.12.2 - 60
+ ///
+ virtual fapi2::ReturnCode cs_signal_output_driver(uint8_t& o_output) override;
+
+ ///
+ /// @brief Decodes register output drive strength for clock (B side)
+ /// @param[out] o_output drive strength encoding from SPD
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note SPD Byte 138 (Bits 1~0)
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 2
+ /// @note Page 4.1.2.12.2 - 60
+ ///
+ virtual fapi2::ReturnCode b_side_clk_output_driver(uint8_t& o_output) override;
+
+ ///
+ /// @brief Decodes register output drive strength for clock (A side)
+ /// @param[out] o_output drive strength encoding from SPD
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note SPD Byte 138 (Bits 3~2)
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 2
+ /// @note Page 4.1.2.12.2 - 60
+ ///
+ virtual fapi2::ReturnCode a_side_clk_output_driver(uint8_t& o_output) override;
+
+ ///
+ /// @brief Decodes data buffer revision number
+ /// @param[out] o_output revision number
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note SPD Byte 139 (Bits 7~0)
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 2
+ /// @note Page 4.1.2.12.2 - 60
+ ///
+ virtual fapi2::ReturnCode data_buffer_rev(uint8_t& o_output) override;
+
+ ///
+ /// @brief Decodes DRAM VrefDQ for Package Rank 0
+ /// @param[out] o_output encoding of MR6 A5:A0 in JESD790-4 spec
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note SPD Byte 140 (Bits 5~0)
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 2
+ /// @note Page 4.1.2.12.2 - 61
+ ///
+ virtual fapi2::ReturnCode dram_vref_dq_rank0(uint8_t& o_output) override;
+
+ ///
+ /// @brief Decodes DRAM VrefDQ for Package Rank 1
+ /// @param[out] o_output encoding of MR6 A5:A0 in JESD790-4 spec
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note SPD Byte 141 (Bits 5~0)
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 2
+ /// @note Page 4.1.2.12.2 - 61
+ ///
+ virtual fapi2::ReturnCode dram_vref_dq_rank1(uint8_t& o_output) override;
+
+ ///
+ /// @brief Decodes DRAM VrefDQ for Package Rank 2
+ /// @param[out] o_output encoding of MR6 A5:A0 in JESD790-4 spec
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note SPD Byte 142 (Bits 5~0)
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 2
+ /// @note Page 4.1.2.12.2 - 61
+ ///
+ virtual fapi2::ReturnCode dram_vref_dq_rank2(uint8_t& o_output) override;
+
+ ///
+ /// @brief Decodes DRAM VrefDQ for Package Rank 3
+ /// @param[out] o_output encoding of MR6 A5:A0 in JESD790-4 spec
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note SPD Byte 143 (Bits 5~0)
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 2
+ /// @note Page 4.1.2.12.2 - 61
+ ///
+ virtual fapi2::ReturnCode dram_vref_dq_rank3(uint8_t& o_output) override;
+
+ ///
+ /// @brief Decodes data buffer VrefDQ for DRAM interface
+ /// @param[out] o_output encoding of F5BC6x in DDR4DB01 spec
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note SPD Byte 144 (Bits 5~0)
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 2
+ /// @note Page 4.1.2.12.2 - 61
+ ///
+ virtual fapi2::ReturnCode data_buffer_vref_dq(uint8_t& o_output) override;
+
+ ///
+ /// @brief Decodes DRAM interface MDQ Drive Strenth
+ /// of the data buffer component for a particular dimm speed
+ /// @param[in] i_dimm_speed the dimm speed in MT/s
+ /// @param[out] o_output encoding of F5BC6x in
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note SPD Byte 145 - 147 (Bits 6~4)
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 2
+ /// @note Page 4.1.2.12.2 - 62
+ ///
+ virtual fapi2::ReturnCode data_buffer_mdq_drive_strength(const uint64_t i_dimm_speed,
+ uint8_t& o_output) override;
+
+ ///
+ /// @brief Decodes DRAM interface MDQ read termination strength
+ /// of the data buffer component for a particular dimm speed
+ /// @param[in] i_dimm_speed the dimm speed in MT/s
+ /// @param[out] o_output encoding of F5BC6x in
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note SPD Byte 145 - 147 (Bits 2~0)
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 2
+ /// @note Page 4.1.2.12.2 - 62
+ ///
+ virtual fapi2::ReturnCode data_buffer_mdq_rtt(const uint64_t i_dimm_speed, uint8_t& o_output) override;
+
+ ///
+ /// @brief Decodes DRAM drive strenth
+ /// for a particular dimm speed
+ /// @param[in] i_dimm_speed the dimm speed in MT/s
+ /// @param[out] o_output DRAM drive strength (in ohms)
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note SPD Byte 148 (Bits 5~0)
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 2
+ /// @note Page 4.1.2.12.2 - 63
+ ///
+ virtual fapi2::ReturnCode dram_drive_strength(const uint64_t i_dimm_speed, uint8_t& o_output) override;
+
+ ///
+ /// @brief Decodes DRAM ODT for RTT_NOM
+ /// for a particular dimm speed
+ /// @param[in] i_dimm_speed the dimm speed in MT/s
+ /// @param[out] o_output ODT termination strength (in ohms)
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note SPD Byte 149 - 151 (Bits 2~0)
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 2
+ /// @note Page 4.1.2.12.2 - (64 - 65)
+ ///
+ virtual fapi2::ReturnCode dram_rtt_nom(const uint64_t i_dimm_speed, uint8_t& o_output) override;
+
+ ///
+ /// @brief Decodes DRAM ODT for RTT_WR
+ /// for a particular dimm speed
+ /// @param[in] i_dimm_speed the dimm speed in MT/s
+ /// @param[out] o_output ODT termination strength (in ohms)
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note SPD Byte 149 - 151 (Bits 5~3)
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 2
+ /// @note Page 4.1.2.12.2 - (64 - 65)
+ ///
+ virtual fapi2::ReturnCode dram_rtt_wr(const uint64_t i_dimm_speed, uint8_t& o_output) override;
+
+ ///
+ /// @brief Decodes DRAM ODT for RTT_PARK, package ranks 0 & 1
+ /// for a particular dimm speed
+ /// @param[in] i_dimm_speed the dimm speed in MT/s
+ /// @param[out] o_output ODT termination strength (in ohms)
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note SPD Byte 152 - 154 (Bits 2~0)
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 2
+ /// @note Page 4.1.2.12.2 - 65
+ ///
+ virtual fapi2::ReturnCode dram_rtt_park_ranks0_1(const uint64_t i_dimm_speed, uint8_t& o_output) override;
+
+ ///
+ /// @brief Decodes DRAM ODT for RTT_PARK, package ranks 2 & 3
+ /// for a particular dimm speed
+ /// @param[in] i_dimm_speed the dimm speed in MT/s
+ /// @param[out] o_output ODT termination strength (in ohms)
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note SPD Byte 152 - 154 (Bits 5~3)
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 2
+ /// @note Page 4.1.2.12.2 - 65
+ ///
+ virtual fapi2::ReturnCode dram_rtt_park_ranks2_3(const uint64_t i_dimm_speed, uint8_t& o_output) override;
+
+};//decoder
+
+///
+/// @brief LRDIMM module decoder for revision 1.1
+///
+class decoder_v1_1 : public decoder_v1_0
+{
+ public:
+
+ // deleted default ctor
+ decoder_v1_1() = delete;
+
+ ///
+ /// @brief ctor
+ /// @param[in] i_target dimm target
+ /// @param[in] i_spd_data vector DIMM SPD data
+ ///
+ decoder_v1_1(const fapi2::Target<fapi2::TARGET_TYPE_DIMM>& i_target,
+ const std::vector<uint8_t>& i_spd_data)
+ : decoder_v1_0(i_target, i_spd_data)
+ {}
+
+ ///
+ /// @brief default dtor
+ ///
+ virtual ~decoder_v1_1() = default;
+
+ ///
+ /// @brief Decodes register and data buffer types
+ /// @param[out] o_output encoding from SPD
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note SPD Byte 131 (Bits 7~4)
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 3
+ /// @note Page 4.1.2.12.3 - 63
+ ///
+ virtual fapi2::ReturnCode register_and_buffer_type(uint8_t& o_output) override;
+
+ ///
+ /// @brief Decodes register output drive strength for CKE signal
+ /// @param[out] o_output encoding from SPD
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note SPD Byte 137 (Bits 1~0)
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 3
+ /// @note Page 4.1.2.12.3 - 65
+ ///
+ virtual fapi2::ReturnCode cke_signal_output_driver(uint8_t& o_output) override;
+
+ ///
+ /// @brief Decodes register output drive strength for ODT signal
+ /// @param[out] o_output encoding from SPD
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note SPD Byte 137 (Bits 3~2)
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 3
+ /// @note Page 4.1.2.12.3 - 65
+ ///
+ virtual fapi2::ReturnCode odt_signal_output_driver(uint8_t& o_output) override;
+
+ ///
+ /// @brief Decodes register output drive strength for control signal (CS) signal
+ /// @param[out] o_output encoding from SPD
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note SPD Byte 137 (Bits 6~7)
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 3
+ /// @note Page 4.1.2.12.3 - 65
+ ///
+ virtual fapi2::ReturnCode cs_signal_output_driver(uint8_t& o_output) override;
+
+ ///
+ /// @brief Decodes register output drive strength for clock (B side)
+ /// @param[out] o_output drive strength encoding from SPD
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note SPD Byte 138 (Bits 1~0)
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 3
+ /// @note Page 4.1.2.12.3 - 66
+ ///
+ virtual fapi2::ReturnCode b_side_clk_output_driver(uint8_t& o_output) override;
+
+ ///
+ /// @brief Decodes register output drive strength for clock (A side)
+ /// @param[out] o_output drive strength encoding from SPD
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note SPD Byte 138 (Bits 3~2)
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 3
+ /// @note Page 4.1.2.12.3 - 66
+ ///
+ virtual fapi2::ReturnCode a_side_clk_output_driver(uint8_t& o_output) override;
+};
+
+///
+/// @brief LRDIMM module decoder for revision 1.2
+///
+class decoder_v1_2 : public decoder_v1_1
+{
+ public:
+
+ // deleted default ctor
+ decoder_v1_2() = delete;
+
+ ///
+ /// @brief ctor
+ /// @param[in] i_target dimm target
+ /// @param[in] i_spd_data vector DIMM SPD data
+ ///
+ decoder_v1_2(const fapi2::Target<fapi2::TARGET_TYPE_DIMM>& i_target,
+ const std::vector<uint8_t>& i_spd_data)
+ : decoder_v1_1(i_target, i_spd_data)
+ {}
+
+ ///
+ /// @brief default dtor
+ ///
+ virtual ~decoder_v1_2() = default;
+
+ ///
+ /// @brief Decodes register output drive strength for data buffer control (BCOM, BODT, BKCE)
+ /// @param[out] o_output encoded drive strength
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note SPD Byte 138 (Bit 4)
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 3
+ /// @note Page 4.1.2.12.3 - 66
+ ///
+ virtual fapi2::ReturnCode bcom_bcke_bodt_drive_strength(uint8_t& o_output) override;
+
+ ///
+ /// @brief Decodes register output drive strength for data buffer control (BCK)
+ /// @param[out] o_output encoded drive strength
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note SPD Byte 138 (Bit 5)
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 3
+ /// @note Page 4.1.2.12.3 - 66
+ ///
+ virtual fapi2::ReturnCode bck_output_drive_strength(uint8_t& o_output) override;
+
+ ///
+ /// @brief Decodes RCD output slew rate control
+ /// @param[out] o_output encoded drive strength
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note SPD Byte 138 (Bit 6)
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 4
+ /// @note Page 4.1.2.L-4 - 70
+ ///
+ virtual fapi2::ReturnCode slew_rate_control(uint8_t& o_output) override;
+
+ ///
+ /// @brief Decodes VrefDQ range for DRAM interface range
+ /// @param[out] o_output spd encoding
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note SPD Byte 155 (Bits 3~0)
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 4
+ /// @note Page 4.1.2.L-4 - 76
+ ///
+ virtual fapi2::ReturnCode dram_vref_dq_range(uint8_t& o_output) override;
+
+ ///
+ /// @brief Decodes data buffer VrefDQ range for DRAM interface range
+ /// @param[out] o_output spd encoding
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note SPD Byte 155 (Bit 4)
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 4
+ /// @note Page 4.1.2.L-4 - 76
+ ///
+ virtual fapi2::ReturnCode data_buffer_vref_dq_range(uint8_t& o_output) override;
+
+ ///
+ /// @brief Decodes data buffer gain adjustment
+ /// @param[out] o_output spd encoding
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note SPD Byte 156 (Bit 0)
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 4
+ /// @note Page 4.1.2.L-4 - 77
+ ///
+ virtual fapi2::ReturnCode data_buffer_gain_adjustment(uint8_t& o_output) override;
+
+ ///
+ /// @brief Decodes data buffer Decision Feedback Equalization (DFE)
+ /// @param[out] o_output spd encoding
+ /// @return FAPI2_RC_SUCCESS if okay
+ /// @note SPD Byte 156 (Bit 1)
+ /// @note Item JEDEC Standard No. 21-C
+ /// @note DDR4 SPD Document Release 4
+ /// @note Page 4.1.2.L-4 - 77
+ ///
+ virtual fapi2::ReturnCode data_buffer_dfe(uint8_t& o_output) override;
+};
+
+}// lrdimm
+}// spd
+}// mss
+
+#endif //_MSS_LRDIMM_DECODER_H_
diff --git a/src/import/generic/memory/lib/spd/lrdimm/ddr4/lrdimm_decoder_ddr4_v1_0.C b/src/import/generic/memory/lib/spd/lrdimm/ddr4/lrdimm_decoder_ddr4_v1_0.C
new file mode 100644
index 000000000..00192a229
--- /dev/null
+++ b/src/import/generic/memory/lib/spd/lrdimm/ddr4/lrdimm_decoder_ddr4_v1_0.C
@@ -0,0 +1,1367 @@
+/* IBM_PROLOG_BEGIN_TAG */
+/* This is an automatically generated prolog. */
+/* */
+/* $Source: src/import/generic/memory/lib/spd/lrdimm/ddr4/lrdimm_decoder_ddr4_v1_0.C $ */
+/* */
+/* OpenPOWER HostBoot Project */
+/* */
+/* Contributors Listed Below - COPYRIGHT 2016,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 lrdimm_decoder_v1_0.C
+/// @brief LRDIMM module SPD decoder definitions for revision 1.0
+///
+// *HWP HWP Owner: Andre Marin <aamarin@us.ibm.com>
+// *HWP HWP Backup: Brian Silver <bsilver@us.ibm.com>
+// *HWP Team: Memory
+// *HWP Level: 2
+// *HWP Consumed by: HB:FSP
+
+// std lib
+#include <vector>
+
+// fapi2
+#include <fapi2.H>
+
+// mss lib
+#include <generic/memory/lib/spd/lrdimm/ddr4/lrdimm_decoder_ddr4.H>
+#include <generic/memory/lib/spd/common/ddr4/spd_decoder_ddr4.H>
+#include <generic/memory/lib/spd/spd_checker.H>
+#include <generic/memory/lib/utils/c_str.H>
+#include <generic/memory/lib/utils/find.H>
+
+using fapi2::TARGET_TYPE_MCA;
+using fapi2::TARGET_TYPE_MCS;
+using fapi2::TARGET_TYPE_DIMM;
+
+
+namespace mss
+{
+namespace spd
+{
+namespace lrdimm
+{
+
+/////////////////////////
+// Non-member helper functions
+// For LRDIMM module rev 1.0
+/////////////////////////
+
+/// @brief Helper function to find SPD byte based on freq
+/// @param[in] i_dimm_speed DIMM speed in MT/s
+/// @param[out] o_byte byte to extract spd from
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD spec sets encoding based on freq ranges such as, 1866 < data rate <= 2400,
+/// But for Nimbus we can only be 1866, 2133, 2400, and 2666. No intermediate values
+/// so we use a simple case statement to get our results.
+static fapi2::ReturnCode mdq_helper(const uint64_t i_dimm_speed, uint8_t& o_byte)
+{
+ switch(i_dimm_speed)
+ {
+ case fapi2::ENUM_ATTR_MSS_FREQ_MT1866:
+ o_byte = 145;
+ break;
+
+ case fapi2::ENUM_ATTR_MSS_FREQ_MT2133:
+ case fapi2::ENUM_ATTR_MSS_FREQ_MT2400:
+ o_byte = 146;
+ break;
+
+ case fapi2::ENUM_ATTR_MSS_FREQ_MT2666:
+ o_byte = 147;
+ break;
+
+ default:
+ FAPI_ERR("Invalid dimm speed received: %d", i_dimm_speed);
+ return fapi2::FAPI2_RC_INVALID_PARAMETER;
+ break;
+ }
+
+ return fapi2::FAPI2_RC_SUCCESS;
+};
+
+/// @brief Helper function to find start bit based on freq
+/// @param[in] i_dimm_speed DIMM speed in MT/s
+/// @param[out] o_start_bit start bit to extract SPD from
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD spec sets encoding based on freq ranges such as, 1866 < data rate <= 2400,
+/// But for Nimbus we can only be 1866, 2133, 2400, and 2666. No intermediate values
+/// so we use a simple case statement to get our results.
+static fapi2::ReturnCode drive_strength_start_bit_finder(const uint64_t i_dimm_speed, size_t& o_start_bit)
+{
+ switch(i_dimm_speed)
+ {
+ case fapi2::ENUM_ATTR_MSS_FREQ_MT1866:
+ o_start_bit = 6;
+ break;
+
+ case fapi2::ENUM_ATTR_MSS_FREQ_MT2133:
+ case fapi2::ENUM_ATTR_MSS_FREQ_MT2400:
+ o_start_bit = 4;
+ break;
+
+ case fapi2::ENUM_ATTR_MSS_FREQ_MT2666:
+ o_start_bit = 2;
+ break;
+
+ default:
+ FAPI_ERR("Invalid dimm speed received: %d", i_dimm_speed);
+ return fapi2::FAPI2_RC_INVALID_PARAMETER;
+ break;
+ }
+
+ return fapi2::FAPI2_RC_SUCCESS;
+}
+
+/// @brief Helper function to find SPD byte based on freq
+/// @param[in] i_dimm_speed DIMM speed in MT/s
+/// @param[out] o_byte byte to extract spd from
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD spec sets encoding based on freq ranges such as, 1866 < data rate <= 2400,
+/// But for Nimbus we can only be 1866, 2133, 2400, and 2666. No intermediate values
+/// so we use a simple case statement to get our results.
+static fapi2::ReturnCode rtt_wr_and_nom_byte_finder(const uint64_t i_dimm_speed, size_t& o_byte)
+{
+ switch(i_dimm_speed)
+ {
+ case fapi2::ENUM_ATTR_MSS_FREQ_MT1866:
+ o_byte = 149;
+ break;
+
+ case fapi2::ENUM_ATTR_MSS_FREQ_MT2133:
+ case fapi2::ENUM_ATTR_MSS_FREQ_MT2400:
+ o_byte = 150;
+ break;
+
+ case fapi2::ENUM_ATTR_MSS_FREQ_MT2666:
+ o_byte = 151;
+ break;
+
+ default:
+ FAPI_ERR("Invalid dimm speed received: %d", i_dimm_speed);
+ return fapi2::FAPI2_RC_INVALID_PARAMETER;
+ break;
+ }
+
+ return fapi2::FAPI2_RC_SUCCESS;
+}
+
+/// @brief Helper function to find SPD byte based on freq
+/// @param[in] i_dimm_speed DIMM speed in MT/s
+/// @param[out] o_byte byte to extract spd from
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD spec sets encoding based on freq ranges such as, 1866 < data rate <= 2400,
+/// But for Nimbus we can only be 1866, 2133, 2400, and 2666. No intermediate values
+/// so we use a simple case statement to get our results.
+static fapi2::ReturnCode rtt_park_byte_finder(const uint64_t i_dimm_speed, size_t& o_byte)
+{
+ switch(i_dimm_speed)
+ {
+ case fapi2::ENUM_ATTR_MSS_FREQ_MT1866:
+ o_byte = 152;
+ break;
+
+ case fapi2::ENUM_ATTR_MSS_FREQ_MT2133:
+ case fapi2::ENUM_ATTR_MSS_FREQ_MT2400:
+ o_byte = 153;
+ break;
+
+ case fapi2::ENUM_ATTR_MSS_FREQ_MT2666:
+ o_byte = 154;
+ break;
+
+ default:
+ FAPI_ERR("Invalid dimm speed received: %d", i_dimm_speed);
+ return fapi2::FAPI2_RC_INVALID_PARAMETER;
+ break;
+ }
+
+ return fapi2::FAPI2_RC_SUCCESS;
+}
+
+/////////////////////////
+// Member Method implementation
+// For LRDIMM module rev 1.0
+/////////////////////////
+
+///
+/// @brief Decodes module nominal height max
+/// @param[out] o_output height range encoding from SPD
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 128 (Bits 4~0)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 2
+/// @note Page 4.1.2.12.2 - 55
+///
+fapi2::ReturnCode decoder_v1_0::max_module_nominal_height(uint8_t& o_output)
+{
+ uint8_t l_field_bits = extract_spd_field< MODULE_NOMINAL_HEIGHT >(iv_target, iv_spd_data);
+ FAPI_INF("Field Bits value: %d", l_field_bits);
+
+ // This checks my extracting params returns a value within bound
+ constexpr size_t MAX_VALID_VALUE = 0b11111;
+
+ FAPI_TRY( mss::check::spd::fail_for_invalid_value(iv_target,
+ l_field_bits <= MAX_VALID_VALUE,
+ MODULE_NOMINAL_HEIGHT.iv_byte,
+ l_field_bits,
+ "Failed bound check for module nominal height max") );
+
+ // Update output only if check passes
+ o_output = l_field_bits;
+
+ FAPI_INF("%s. Max module nominal height: %d",
+ mss::c_str(iv_target),
+ o_output);
+
+fapi_try_exit:
+ return fapi2::current_err;
+}
+
+///
+/// @brief Decodes raw card extension
+/// @param[out] o_output raw card rev. encoding from SPD
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 128 (Bits 7~5)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 2
+/// @note Page 4.1.2.12.2 - 55
+///
+fapi2::ReturnCode decoder_v1_0::raw_card_extension(uint8_t& o_output)
+{
+ uint8_t l_field_bits = extract_spd_field< RAW_CARD_EXTENSION >(iv_target, iv_spd_data);
+ FAPI_INF("Field Bits value: %d", l_field_bits);
+
+ // This checks my extracting params returns a value within bound
+ constexpr size_t MAX_VALID_VALUE = 0b111;
+
+ FAPI_TRY( mss::check::spd::fail_for_invalid_value(iv_target,
+ l_field_bits <= MAX_VALID_VALUE,
+ RAW_CARD_EXTENSION.iv_byte,
+ l_field_bits,
+ "Failed bound check for raw card extension") );
+
+ // Update output only if check passes
+ o_output = l_field_bits;
+
+ FAPI_INF("%s. Raw card extension: %d",
+ mss::c_str(iv_target),
+ o_output);
+
+fapi_try_exit:
+ return fapi2::current_err;
+}
+
+///
+/// @brief Decodes front module maximum thickness max
+/// @param[out] o_output encoding from SPD
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 129 (Bits 3~0)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 2
+/// @note Page 4.1.2.12.2 - 55
+///
+fapi2::ReturnCode decoder_v1_0::front_module_max_thickness(uint8_t& o_output)
+{
+ // Extracting desired bits
+ uint8_t l_field_bits = extract_spd_field< FRONT_MODULE_THICKNESS >(iv_target, iv_spd_data);
+
+ FAPI_INF("Field Bits value: %d", l_field_bits);
+
+ // This checks my extracting params returns a value within bound
+ constexpr size_t MAX_VALID_VALUE = 0b1111;
+
+ FAPI_TRY( mss::check::spd::fail_for_invalid_value(iv_target,
+ l_field_bits <= MAX_VALID_VALUE,
+ FRONT_MODULE_THICKNESS.iv_byte,
+ l_field_bits,
+ "Failed bound check for front module max thickness") );
+
+ // Update output only if check passes
+ o_output = l_field_bits;
+
+ FAPI_INF("%s. Front module max thickness: %d",
+ mss::c_str(iv_target),
+ o_output);
+
+fapi_try_exit:
+ return fapi2::current_err;
+
+}
+
+///
+/// @brief Decodes back module maximum thickness max
+/// @param[out] o_output encoding from SPD
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 129 (Bits 7~4)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 2
+/// @note Page 4.1.2.12.2 - 55
+///
+fapi2::ReturnCode decoder_v1_0::back_module_max_thickness(uint8_t& o_output)
+{
+ // Extracting desired bits
+ uint8_t l_field_bits = extract_spd_field< BACK_MODULE_THICKNESS >(iv_target, iv_spd_data);
+ FAPI_INF("Field Bits value: %d", l_field_bits);
+
+ // This checks my extracting params returns a value within bound
+ constexpr size_t MAX_VALID_VALUE = 0b1111;
+
+ FAPI_TRY( mss::check::spd::fail_for_invalid_value(iv_target,
+ l_field_bits <= MAX_VALID_VALUE,
+ BACK_MODULE_THICKNESS.iv_byte,
+ l_field_bits,
+ "Failed bound check for back module max thickness") );
+
+ // Update output only if check passes
+ o_output = l_field_bits;
+
+ FAPI_INF("%s. Back module max thickness: %d",
+ mss::c_str(iv_target),
+ o_output);
+
+fapi_try_exit:
+ return fapi2::current_err;
+
+}
+
+///
+/// @brief Decodes number of registers used on LRDIMM
+/// @param[out] o_output encoding from SPD
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 131 (Bits 1~0)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 2
+/// @note Page 4.1.2.12.2 - 57
+///
+fapi2::ReturnCode decoder_v1_0::num_registers_used(uint8_t& o_output)
+{
+ // Extracting desired bits
+ uint8_t l_field_bits = extract_spd_field< NUM_REGISTERS_USED >(iv_target, iv_spd_data);
+ FAPI_INF("Field Bits value: %d", l_field_bits);
+
+ // This checks my extracting params returns a value within bound
+ constexpr size_t RESERVED = 0b10;
+
+ FAPI_TRY( mss::check::spd::fail_for_invalid_value(iv_target,
+ l_field_bits < RESERVED,
+ NUM_REGISTERS_USED.iv_byte,
+ l_field_bits,
+ "Failed bound check for number of registers used on RDIMM ") );
+
+ // Update output only if check passes
+ o_output = l_field_bits;
+
+ FAPI_INF("%s. Number of registers used on LRDIMM : %d",
+ mss::c_str(iv_target),
+ o_output);
+
+fapi_try_exit:
+ return fapi2::current_err;
+}
+
+///
+/// @brief Decodes number of rows of DRAMs on LRDIMM
+/// @param[out] o_output encoding from SPD
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 131 (Bits 3~2)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 2
+/// @note Page 4.1.2.12.2 - 57
+///
+fapi2::ReturnCode decoder_v1_0::num_rows_of_drams(uint8_t& o_output)
+{
+ // Extracting desired bits
+ uint8_t l_field_bits = extract_spd_field< NUM_ROWS_OF_DRAMS >(iv_target, iv_spd_data);
+ FAPI_INF("Field Bits value: %d", l_field_bits);
+
+ // This checks my extracting params returns a value within bound
+ constexpr size_t RESERVED = 0b11;
+
+ FAPI_TRY( mss::check::spd::fail_for_invalid_value(iv_target,
+ l_field_bits < RESERVED,
+ NUM_REGISTERS_USED.iv_byte,
+ l_field_bits,
+ "Failed bound check for number of rows of DRAMs on LRDIMM ") );
+
+ // Update output only if check passes
+ o_output = l_field_bits;
+
+ FAPI_INF("%s. Number of rows of DRAMs on LRDIMM : %d",
+ mss::c_str(iv_target),
+ o_output);
+
+fapi_try_exit:
+ return fapi2::current_err;
+
+}
+
+///
+/// @brief Decodes heat spreader solution
+/// @param[out] o_output drive strength encoding from SPD
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 132 (Bit 7)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 2
+/// @note Page 4.1.2.12.2 - 58
+///
+fapi2::ReturnCode decoder_v1_0::heat_spreader_solution(uint8_t& o_output)
+{
+ // Extracting desired bits
+ uint8_t l_field_bits = extract_spd_field< HEAT_SPREADER_SOLUTION >(iv_target, iv_spd_data);
+ FAPI_INF("Field Bits value: %d", l_field_bits);
+
+ // This checks my extracting params returns a value within bound
+ constexpr size_t MAX_VALID_VALUE = 1;
+
+ FAPI_TRY( mss::check::spd::fail_for_invalid_value(iv_target,
+ l_field_bits <= MAX_VALID_VALUE,
+ HEAT_SPREADER_SOLUTION.iv_byte,
+ l_field_bits,
+ "Failed bound check for heat spreader solution") );
+
+ // Update output only if check passes
+ o_output = l_field_bits;
+
+ FAPI_INF("%s. Heat spreader solution: %d",
+ mss::c_str(iv_target),
+ o_output);
+
+fapi_try_exit:
+ return fapi2::current_err;
+}
+
+///
+/// @brief Decodes number of continuation codes
+/// @param[out] o_output encoding from SPD
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 133 (bit 6~0)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 2
+/// @note Page 4.1.2.12.2 - 58
+///
+fapi2::ReturnCode decoder_v1_0::num_continuation_codes(uint8_t& o_output)
+{
+ // Extracting desired bits
+ uint8_t l_field_bits = extract_spd_field< CONTINUATION_CODES >(iv_target, iv_spd_data);
+ FAPI_INF("Field Bits value: %d", l_field_bits);
+
+ // This checks my extracting params returns a value within bound
+ constexpr size_t MAX_VALID_VALUE = 10; // JEP106AS spec
+
+ FAPI_TRY( mss::check::spd::fail_for_invalid_value(iv_target,
+ l_field_bits <= MAX_VALID_VALUE,
+ CONTINUATION_CODES.iv_byte,
+ l_field_bits,
+ "Failed bound check for number of continuation codes") );
+
+ // Update output only if check passes
+ o_output = l_field_bits;
+
+ FAPI_INF("%s. Number of continuation codes: %d",
+ mss::c_str(iv_target),
+ o_output);
+
+fapi_try_exit:
+ return fapi2::current_err;
+}
+
+///
+/// @brief Decodes register manufacturer ID code
+/// @param[out] o_output drive strength encoding from SPD
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 134 (bit 7~0)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 2
+/// @note Page 4.1.2.12.2 - 58
+///
+fapi2::ReturnCode decoder_v1_0::reg_manufacturer_id_code(uint8_t& o_output)
+{
+ constexpr size_t BYTE_INDEX = 134;
+ uint8_t l_raw_byte = iv_spd_data[BYTE_INDEX];
+
+ // Trace in the front assists w/ debug
+ FAPI_INF("%s SPD data at Byte %d: 0x%llX.",
+ mss::c_str(iv_target),
+ BYTE_INDEX,
+ l_raw_byte);
+
+ // All bits used for encoding, no bounds to check
+ o_output = l_raw_byte;
+
+ FAPI_INF("%s. Register revision number: %d",
+ mss::c_str(iv_target),
+ o_output);
+
+ return fapi2::FAPI2_RC_SUCCESS;
+}
+
+///
+/// @brief Decodes register revision number
+/// @param[out] o_output drive strength encoding from SPD
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 135 (bit 7~0)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 2
+/// @note Page 4.1.2.12.2 - 58
+///
+fapi2::ReturnCode decoder_v1_0::register_rev_num(uint8_t& o_output)
+{
+ constexpr size_t BYTE_INDEX = 135;
+ uint8_t l_raw_byte = iv_spd_data[BYTE_INDEX];
+
+ // Trace in the front assists w/ debug
+ FAPI_INF("%s SPD data at Byte %d: 0x%llX.",
+ mss::c_str(iv_target),
+ BYTE_INDEX,
+ l_raw_byte);
+
+ // All bits used for encoding, no bounds to check
+ o_output = l_raw_byte;
+
+ FAPI_INF("%s. Register revision number: %d",
+ mss::c_str(iv_target),
+ o_output);
+
+ return fapi2::FAPI2_RC_SUCCESS;
+}
+
+///
+/// @brief Decodes address mapping from register to dram
+/// @param[out] o_output drive strength encoding from SPD
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 136 (bit 0)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 2
+/// @note Page 4.1.2.12.2 - 59
+///
+fapi2::ReturnCode decoder_v1_0::register_to_dram_addr_mapping(uint8_t& o_output)
+{
+ // Extracting desired bits
+ uint8_t l_field_bits = extract_spd_field< ADDR_MAPPING >(iv_target, iv_spd_data);
+ FAPI_INF("Field Bits value: %d", l_field_bits);
+
+ // This checks my extracting params returns a value within bound
+ constexpr size_t MAX_VALID_VAL = 1;
+
+ FAPI_TRY( mss::check::spd::fail_for_invalid_value(iv_target,
+ l_field_bits <= MAX_VALID_VAL, // extract sanity check
+ ADDR_MAPPING.iv_byte,
+ l_field_bits,
+ "Failed bound check for to register to dram addr mapping") );
+
+ // Update output only if check passes
+ o_output = l_field_bits;
+
+ FAPI_INF("%s. Address mapping from register to dram: %d",
+ mss::c_str(iv_target),
+ o_output);
+
+fapi_try_exit:
+ return fapi2::current_err;
+}
+
+///
+/// @brief Decodes register output drive strength for CKE signal
+/// @param[out] o_output drive strength encoding from SPD
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 137 (bit 1~0)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 2
+/// @note Page 4.1.2.12.2 - 60
+///
+fapi2::ReturnCode decoder_v1_0::cke_signal_output_driver(uint8_t& o_output)
+{
+ // Extracting desired bits
+ uint8_t l_field_bits = extract_spd_field< CKE_DRIVE_STRENGTH >(iv_target, iv_spd_data);
+ FAPI_INF("Field Bits value: %d", l_field_bits);
+
+ // This checks my extracting params returns a value within bound
+ constexpr size_t RESERVED = 3;
+
+ FAPI_TRY( mss::check::spd::fail_for_invalid_value(iv_target,
+ l_field_bits < RESERVED, // extract sanity check
+ CKE_DRIVE_STRENGTH.iv_byte,
+ l_field_bits,
+ "Failed bounds check for Register Output Driver for CKE") );
+
+ // Update output only if check passes
+ o_output = l_field_bits;
+
+ FAPI_INF("%s. Register Output Driver for CKE: %d",
+ mss::c_str(iv_target),
+ o_output);
+
+fapi_try_exit:
+ return fapi2::current_err;
+}
+
+///
+/// @brief Decodes register output drive strength for ODT signal
+/// @param[out] o_output drive strength encoding from SPD
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 137 (bit 3~2)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 2
+/// @note Page 4.1.2.12.2 - 60
+///
+fapi2::ReturnCode decoder_v1_0::odt_signal_output_driver(uint8_t& o_output)
+{
+ // Extracting desired bits
+ uint8_t l_field_bits = extract_spd_field< ODT_DRIVE_STRENGTH >(iv_target, iv_spd_data);
+ FAPI_INF("Field Bits value: %d", l_field_bits);
+
+ // This checks my extracting params returns a value within bound
+ constexpr size_t RESERVED = 3;
+
+ FAPI_TRY( mss::check::spd::fail_for_invalid_value(iv_target,
+ l_field_bits < RESERVED, // extract sanity check
+ ODT_DRIVE_STRENGTH.iv_byte,
+ l_field_bits,
+ "Failed bounds check for Register Output Driver for ODT") );
+
+ // Update output only if check passes
+ o_output = l_field_bits;
+
+ FAPI_INF("%s. Register Output Driver for ODT: %d",
+ mss::c_str(iv_target),
+ o_output);
+
+fapi_try_exit:
+ return fapi2::current_err;
+}
+
+///
+/// @brief Decodes register output drive strength for command/address (CA) signal
+/// @param[out] o_output drive strength encoding from SPD
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 137 (bit 5~4)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 2
+/// @note Page 4.1.2.12.2 - 60
+///
+fapi2::ReturnCode decoder_v1_0::ca_signal_output_driver(uint8_t& o_output)
+{
+ // Extracting desired bits
+ uint8_t l_field_bits = extract_spd_field< CA_DRIVE_STRENGTH >(iv_target, iv_spd_data);
+ FAPI_INF("Field Bits value: %d", l_field_bits);
+
+ // This checks my extracting params returns a value within bound
+ constexpr size_t INVALID_VAL = 4;
+
+ FAPI_TRY( mss::check::spd::fail_for_invalid_value(iv_target,
+ l_field_bits < INVALID_VAL, // extract sanity check
+ CA_DRIVE_STRENGTH.iv_byte,
+ l_field_bits,
+ "Failed bounds check for Register Output Driver for CA") );
+
+ // Update output only if check passes
+ o_output = l_field_bits;
+
+ FAPI_INF("%s. Register Output Driver for CA: %d",
+ mss::c_str(iv_target),
+ o_output);
+
+fapi_try_exit:
+ return fapi2::current_err;
+}
+
+///
+/// @brief Decodes register output drive strength for control signal (CS) signal
+/// @param[out] o_output drive strength encoding from SPD
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 137 (bit 6~7)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 2
+/// @note Page 4.1.2.12.2 - 60
+///
+fapi2::ReturnCode decoder_v1_0::cs_signal_output_driver(uint8_t& o_output)
+{
+ // Extracting desired bits
+ uint8_t l_field_bits = extract_spd_field< CS_DRIVE_STRENGTH >(iv_target, iv_spd_data);
+ FAPI_INF("Field Bits value: %d", l_field_bits);
+
+ // This checks my extracting params returns a value within bound
+ constexpr size_t RESERVED = 3;
+
+ FAPI_TRY( mss::check::spd::fail_for_invalid_value(iv_target,
+ l_field_bits < RESERVED, // extract sanity check
+ CS_DRIVE_STRENGTH.iv_byte,
+ l_field_bits,
+ "Failed bounds check for Register Output Driver for CS") );
+
+ // Update output only if check passes
+ o_output = l_field_bits;
+
+ FAPI_INF("%s. Register Output Driver for CS: %d",
+ mss::c_str(iv_target),
+ o_output);
+
+fapi_try_exit:
+ return fapi2::current_err;
+}
+
+///
+/// @brief Decodes register output drive strength for clock (B side)
+/// @param[out] o_output drive strength encoding from SPD
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 138 (bit 1~0)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 2
+/// @note Page 4.1.2.12.2 - 60
+///
+fapi2::ReturnCode decoder_v1_0::b_side_clk_output_driver(uint8_t& o_output)
+{
+ // Extracting desired bits
+ uint8_t l_field_bits = extract_spd_field< B_SIDE_DRIVE_STRENGTH >(iv_target, iv_spd_data);
+ FAPI_INF("Field Bits value: %d", l_field_bits);
+
+ // This checks my extracting params returns a value within bound
+ constexpr size_t RESERVED = 3;
+
+ FAPI_TRY( mss::check::spd::fail_for_invalid_value(iv_target,
+ l_field_bits < RESERVED, // extract sanity check
+ B_SIDE_DRIVE_STRENGTH.iv_byte,
+ l_field_bits,
+ "Failed bounds check for Register Output Driver for clock (Y0,Y2)") );
+
+ // Update output only if check passes
+ o_output = l_field_bits;
+
+ FAPI_INF("%s. Register Output Driver for clock (Y0,Y2): %d",
+ mss::c_str(iv_target),
+ o_output);
+
+fapi_try_exit:
+ return fapi2::current_err;
+}
+
+///
+/// @brief Decodes register output drive strength for clock (A side)
+/// @param[out] o_output drive strength encoding from SPD
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 138 (bit 3~2)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 2
+/// @note Page 4.1.2.12.2 - 60
+///
+fapi2::ReturnCode decoder_v1_0::a_side_clk_output_driver(uint8_t& o_output)
+{
+ // Extracting desired bits
+ uint8_t l_field_bits = extract_spd_field< A_SIDE_DRIVE_STRENGTH >(iv_target, iv_spd_data);
+ FAPI_INF("Field Bits value: %d", l_field_bits);
+
+ // This checks my extracting params returns a value within bound
+ constexpr size_t RESERVED = 3;
+
+ FAPI_TRY( mss::check::spd::fail_for_invalid_value(iv_target,
+ l_field_bits < RESERVED,
+ A_SIDE_DRIVE_STRENGTH.iv_byte,
+ l_field_bits,
+ "Failed bounds check for Register Output Driver for clock (Y1,Y3)") );
+
+ // Update output only if check passes
+ o_output = l_field_bits;
+
+ FAPI_INF("%s. Register Output Driver for clock (Y1,Y3): %d",
+ mss::c_str(iv_target),
+ o_output);
+
+fapi_try_exit:
+ return fapi2::current_err;
+}
+
+///
+/// @brief Decodes data buffer revision number
+/// @param[out] o_output revision number
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 139 (Bits 7~0)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 2
+/// @note Page 4.1.2.12.2 - 60
+///
+fapi2::ReturnCode decoder_v1_0::data_buffer_rev(uint8_t& o_output)
+{
+ // Extracting desired bits
+ constexpr size_t BYTE_INDEX = 139;
+ const uint8_t l_raw_byte = iv_spd_data[BYTE_INDEX];
+
+ // Trace in the front assists w/ debug
+ FAPI_INF("%s SPD data at Byte %d: 0x%llX.",
+ mss::c_str(iv_target),
+ BYTE_INDEX,
+ l_raw_byte);
+
+ // This checks JEDEC range is met
+ constexpr size_t UNDEFINED = 0xFF;
+
+ FAPI_TRY( mss::check::spd::fail_for_invalid_value(iv_target,
+ l_raw_byte != UNDEFINED,
+ BYTE_INDEX,
+ l_raw_byte,
+ "Failed bounds check for data buffer revision number") );
+
+ // Update output only if check passes
+ o_output = l_raw_byte;
+
+ FAPI_INF("%s. Data buffer rev: %d",
+ mss::c_str(iv_target),
+ o_output);
+
+fapi_try_exit:
+ return fapi2::current_err;
+
+}
+
+///
+/// @brief Decodes DRAM VrefDQ for Package Rank 0
+/// @param[out] o_output encoding of MR6 A5:A0 in JESD790-4 spec
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 140 (Bits 5~0)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 2
+/// @note Page 4.1.2.12.2 - 61
+///
+fapi2::ReturnCode decoder_v1_0::dram_vref_dq_rank0(uint8_t& o_output)
+{
+ // Extracting desired bits
+ uint8_t l_field_bits = extract_spd_field< VREF_DQ_RANK0 >(iv_target, iv_spd_data);
+ FAPI_INF("Field Bits value: %d", l_field_bits);
+
+ // JESD79-4 specification
+ constexpr size_t RESERVED = 0b110011;
+
+ FAPI_TRY( mss::check::spd::fail_for_invalid_value(iv_target,
+ l_field_bits < RESERVED,
+ VREF_DQ_RANK0.iv_byte,
+ l_field_bits,
+ "Failed bounds check for DRAM VrefDQ for Package Rank 0") );
+
+ // Update output only if check passes
+ o_output = l_field_bits;
+
+ FAPI_INF("%s. DRAM VrefDQ for Package Rank 0: %d",
+ mss::c_str(iv_target),
+ o_output);
+
+fapi_try_exit:
+ return fapi2::current_err;
+}
+
+///
+/// @brief Decodes DRAM VrefDQ for Package Rank 1
+/// @param[out] o_output encoding of MR6 A5:A0 in JESD790-4 spec
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 141 (Bits 5~0)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 2
+/// @note Page 4.1.2.12.2 - 61
+///
+fapi2::ReturnCode decoder_v1_0::dram_vref_dq_rank1(uint8_t& o_output)
+{
+ // Extracting desired bits
+ uint8_t l_field_bits = extract_spd_field< VREF_DQ_RANK1 >(iv_target, iv_spd_data);
+ FAPI_INF("Field Bits value: %d", l_field_bits);
+
+ // JESD79-4 specification
+ constexpr size_t RESERVED = 0b110011;
+
+ FAPI_TRY( mss::check::spd::fail_for_invalid_value(iv_target,
+ l_field_bits < RESERVED,
+ VREF_DQ_RANK1.iv_byte,
+ l_field_bits,
+ "Failed bounds check for DRAM VrefDQ for Package Rank 1") );
+
+ // Update output only if check passes
+ o_output = l_field_bits;
+
+ FAPI_INF("%s. DRAM VrefDQ for Package Rank 1: %d",
+ mss::c_str(iv_target),
+ o_output);
+
+fapi_try_exit:
+ return fapi2::current_err;
+}
+
+///
+/// @brief Decodes DRAM VrefDQ for Package Rank 2
+/// @param[out] o_output encoding of MR6 A5:A0 in JESD790-4 spec
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 142 (Bits 5~0)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 2
+/// @note Page 4.1.2.12.2 - 61
+///
+fapi2::ReturnCode decoder_v1_0::dram_vref_dq_rank2(uint8_t& o_output)
+{
+ // Extracting desired bits
+ uint8_t l_field_bits = extract_spd_field< VREF_DQ_RANK2 >(iv_target, iv_spd_data);
+ FAPI_INF("Field Bits value: %d", l_field_bits);
+
+ // JESD79-4 specification
+ constexpr size_t RESERVED = 0b110011;
+
+ FAPI_TRY( mss::check::spd::fail_for_invalid_value(iv_target,
+ l_field_bits < RESERVED,
+ VREF_DQ_RANK2.iv_byte,
+ l_field_bits,
+ "Failed bounds check for DRAM VrefDQ for Package Rank 2") );
+
+ // Update output only if check passes
+ o_output = l_field_bits;
+
+ FAPI_INF("%s. DRAM VrefDQ for Package Rank 2: %d",
+ mss::c_str(iv_target),
+ o_output);
+
+fapi_try_exit:
+ return fapi2::current_err;
+}
+
+///
+/// @brief Decodes DRAM VrefDQ for Package Rank 3
+/// @param[out] o_output encoding of MR6 A5:A0 in JESD790-4 spec
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 143 (Bits 5~0)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 4
+/// @note Page 4.1.2.12.2 - 61
+///
+fapi2::ReturnCode decoder_v1_0::dram_vref_dq_rank3(uint8_t& o_output)
+{
+ // Extracting desired bits
+ uint8_t l_field_bits = extract_spd_field< VREF_DQ_RANK3 >(iv_target, iv_spd_data);
+ FAPI_INF("Field Bits value: %d", l_field_bits);
+
+ // JESD79-4 specification
+ constexpr size_t RESERVED = 0b110011;
+
+ FAPI_TRY( mss::check::spd::fail_for_invalid_value(iv_target,
+ l_field_bits < RESERVED,
+ VREF_DQ_RANK3.iv_byte,
+ l_field_bits,
+ "Failed bounds check for DRAM VrefDQ for Package Rank 3") );
+
+ // Update output only if check passes
+ o_output = l_field_bits;
+
+ FAPI_INF("%s. DRAM VrefDQ for Package Rank 3: %d",
+ mss::c_str(iv_target),
+ o_output);
+
+fapi_try_exit:
+ return fapi2::current_err;
+}
+
+///
+/// @brief Decodes data buffer VrefDQ for DRAM interface
+/// @param[out] o_output encoding of F5BC6x in DDR4DB01 spec
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 144 (Bits 5~0)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 2
+/// @note Page 4.1.2.12.2 - 61
+///
+fapi2::ReturnCode decoder_v1_0::data_buffer_vref_dq(uint8_t& o_output)
+{
+ constexpr size_t BYTE_INDEX = 144;
+ uint8_t l_raw_data = iv_spd_data[BYTE_INDEX];
+
+ // Trace in the front assists w/ debug
+ FAPI_INF("%s SPD data at Byte %d: 0x%llX.",
+ mss::c_str(iv_target),
+ BYTE_INDEX,
+ l_raw_data);
+
+ // DDR4DB01 spec
+ constexpr size_t RESERVED = 0b00110011;
+
+ FAPI_TRY( mss::check::spd::fail_for_invalid_value(iv_target,
+ l_raw_data < RESERVED,
+ BYTE_INDEX,
+ l_raw_data,
+ "Failed bounds check for data buffer VrefDQ for DRAM interface") );
+
+ // Update output only if check passes
+ o_output = l_raw_data;
+
+ FAPI_INF("%s. Data buffer VrefDQ for DRAM interface: %d",
+ mss::c_str(iv_target),
+ o_output);
+
+fapi_try_exit:
+ return fapi2::current_err;
+}
+
+///
+/// @brief Decodes DRAM interface MDQ Drive Strenth
+/// of the data buffer component for a particular dimm speed
+/// @param[in] i_dimm_speed the dimm speed in MT/s
+/// @param[out] o_output encoding of F5BC6x in
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 145 - 147 (Bits 6~4)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 2
+/// @note Page 4.1.2.12.2 - 62
+///
+fapi2::ReturnCode decoder_v1_0::data_buffer_mdq_drive_strength(const uint64_t i_dimm_speed, uint8_t& o_output)
+{
+ uint8_t l_byte = 0;
+ uint8_t l_field_bits = 0;
+
+ FAPI_TRY( mdq_helper(i_dimm_speed, l_byte) );
+
+ {
+ constexpr size_t START = 1;
+ constexpr size_t LEN = 3;
+ const field_t MDQ_DRIVE_STRENGTH(l_byte, START, LEN);
+
+ l_field_bits = extract_spd_field( iv_target, MDQ_DRIVE_STRENGTH, iv_spd_data );
+ FAPI_INF("Field Bits value: %d", l_field_bits);
+
+ // Lets make sure we aren't being set to a reserved field
+ bool is_reserved_bit = false;
+
+ switch(l_field_bits)
+ {
+ case 0b011:
+ case 0b100:
+ case 0b110:
+ case 0b111:
+ is_reserved_bit = true;
+ break;
+
+ default:
+ is_reserved_bit = false;
+ break;
+ }
+
+ // This checks my extracting params returns a value within bound
+ constexpr size_t MAX_VALID_VALUE = 7;
+
+ FAPI_TRY( mss::check::spd::fail_for_invalid_value(iv_target,
+ (l_field_bits <= MAX_VALID_VALUE) &&
+ (is_reserved_bit != true),
+ l_byte,
+ l_field_bits,
+ "Failed bounds check for DRAM interface MDQ Drive Strenth") );
+
+ // Update output only if check passes
+ o_output = l_field_bits;
+
+ FAPI_INF("%s. DRAM interface MDQ Drive Strenth: %d",
+ mss::c_str(iv_target),
+ o_output);
+ }
+
+fapi_try_exit:
+ return fapi2::current_err;
+}
+
+///
+/// @brief Decodes DRAM interface MDQ read termination strength
+/// of the data buffer component for a particular dimm speed
+/// @param[in] i_dimm_speed the dimm speed in MT/s
+/// @param[out] o_output encoding of F5BC6x in
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 145 - 147 (Bits 2~0)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 2
+/// @note Page 4.1.2.12.2 - 62
+///
+fapi2::ReturnCode decoder_v1_0::data_buffer_mdq_rtt(const uint64_t i_dimm_speed, uint8_t& o_output)
+{
+ uint8_t l_byte = 0;
+ uint8_t l_field_bits = 0;
+
+ FAPI_TRY( mdq_helper(i_dimm_speed, l_byte) );
+
+ {
+ constexpr size_t START = 1;
+ constexpr size_t LEN = 3;
+ const field_t DATA_BUFFER_MDQ_RTT(l_byte, START, LEN);
+
+ l_field_bits = extract_spd_field( iv_target, DATA_BUFFER_MDQ_RTT, iv_spd_data );
+ FAPI_INF("Field Bits value: %d", l_field_bits);
+
+ // This checks my extracting params returns a value within bound
+ constexpr size_t MAX_VALID_VALUE = 7;
+
+ FAPI_TRY( mss::check::spd::fail_for_invalid_value(iv_target,
+ l_field_bits <= MAX_VALID_VALUE,
+ l_byte,
+ l_field_bits,
+ "Failed bounds check for DRAM interface MDQ RTT:") );
+
+ // Update output only if check passes
+ o_output = l_field_bits;
+
+ FAPI_INF("%s. DRAM interface MDQ RTT: %d",
+ mss::c_str(iv_target),
+ o_output);
+ }
+fapi_try_exit:
+ return fapi2::current_err;
+}
+
+///
+/// @brief Decodes DRAM drive strenth
+/// for a particular dimm speed
+/// @param[in] i_dimm_speed the dimm speed in MT/s
+/// @param[out] o_output DRAM drive strength (encoding)
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 148 (Bits 5~0)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 2
+/// @note Page 4.1.2.12.2 - 63
+///
+fapi2::ReturnCode decoder_v1_0::dram_drive_strength(const uint64_t i_dimm_speed, uint8_t& o_output)
+{
+ size_t l_start = 0;
+ FAPI_TRY( drive_strength_start_bit_finder(i_dimm_speed, l_start) );
+
+ {
+ constexpr size_t BYTE_INDEX = 148;
+ constexpr size_t LEN = 2;
+ const field_t DRAM_DRIVE_STRENGTH(BYTE_INDEX, l_start, LEN);
+
+ uint8_t l_field_bits = extract_spd_field( iv_target, DRAM_DRIVE_STRENGTH, iv_spd_data );
+ FAPI_INF("Field Bits value: %d", l_field_bits);
+
+ // SPD JEDEC specification
+ constexpr size_t RESERVED = 0b11;
+
+ FAPI_TRY( mss::check::spd::fail_for_invalid_value(iv_target,
+ l_field_bits < RESERVED,
+ BYTE_INDEX,
+ l_field_bits,
+ "Failed bounds check for DRAM VrefDQ for Package Rank 3") );
+
+ // Update output only if check passes
+ o_output = l_field_bits;
+
+ FAPI_INF("%s. DRAM drive strenth: %d",
+ mss::c_str(iv_target),
+ o_output);
+ }
+
+fapi_try_exit:
+ return fapi2::current_err;
+}
+
+///
+/// @brief Decodes DRAM ODT for RTT_NOM
+/// for a particular dimm speed
+/// @param[in] i_dimm_speed the dimm speed in MT/s
+/// @param[out] o_output ODT termination strength (encoding)
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 149 - 151 (Bits 2~0)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 2
+/// @note Page 4.1.2.12.2 - (64 - 65)
+///
+fapi2::ReturnCode decoder_v1_0::dram_rtt_nom(const uint64_t i_dimm_speed, uint8_t& o_output)
+{
+ size_t l_byte = 0;
+ FAPI_TRY( rtt_wr_and_nom_byte_finder(i_dimm_speed, l_byte) );
+
+ {
+ constexpr size_t START = 5;
+ constexpr size_t LEN = 3;
+ const field_t DRAM_RTT_NOM(l_byte, START, LEN);
+
+ uint8_t l_field_bits = extract_spd_field(iv_target, DRAM_RTT_NOM, iv_spd_data);
+ FAPI_INF("Field Bits value: %d", l_field_bits);
+
+ // This checks my extracting params returns a value within bound
+ constexpr size_t MAX_VALID_VALUE = 7;
+
+ FAPI_TRY( mss::check::spd::fail_for_invalid_value(iv_target,
+ l_field_bits <= MAX_VALID_VALUE,
+ l_byte,
+ l_field_bits,
+ "Failed bounds check for DRAM RTT_NOM") );
+
+ // Update output only if check passes
+ o_output = l_field_bits;
+
+ FAPI_INF("%s. DRAM RTT_NOM: %d",
+ mss::c_str(iv_target),
+ o_output);
+ }
+
+fapi_try_exit:
+ return fapi2::current_err;
+}
+
+///
+/// @brief Decodes DRAM ODT for RTT_WR
+/// for a particular dimm speed
+/// @param[in] i_dimm_speed the dimm speed in MT/s
+/// @param[out] o_output ODT termination strength (encoding)
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 149 - 151 (Bits 5~3)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 2
+/// @note Page 4.1.2.12.2 - (64 - 65)
+///
+fapi2::ReturnCode decoder_v1_0::dram_rtt_wr(const uint64_t i_dimm_speed, uint8_t& o_output)
+{
+ size_t l_byte = 0;
+ FAPI_TRY( rtt_wr_and_nom_byte_finder(i_dimm_speed, l_byte) );
+
+ {
+ constexpr size_t START = 2;
+ constexpr size_t LEN = 3;
+ const field_t DRAM_RTT_WR(l_byte, START, LEN);
+
+ uint8_t l_field_bits = extract_spd_field(iv_target, DRAM_RTT_WR, iv_spd_data);
+ FAPI_INF("Field Bits value: %d", l_field_bits);
+
+ // Lets make sure we aren't being set to a reserved field
+ bool is_reserved_bit = false;
+
+ switch(l_field_bits)
+ {
+ case 0b101:
+ case 0b110:
+ case 0b111:
+ is_reserved_bit = true;
+ break;
+
+ default:
+ is_reserved_bit = false;
+ break;
+ }
+
+ // This checks my extracting params returns a value within bound
+ constexpr size_t MAX_VALID_VALUE = 7;
+
+ FAPI_TRY( mss::check::spd::fail_for_invalid_value(iv_target,
+ (l_field_bits <= MAX_VALID_VALUE) &&
+ (is_reserved_bit != true),
+ l_byte,
+ l_field_bits,
+ "Failed bounds check for DRAM RTT_WR") );
+
+ // Update output only if check passes
+ o_output = l_field_bits;
+
+ FAPI_INF("%s. DRAM_RTT_WR: %d",
+ mss::c_str(iv_target),
+ o_output);
+ }
+
+fapi_try_exit:
+ return fapi2::current_err;
+}
+
+///
+/// @brief Decodes DRAM ODT for RTT_PARK, package ranks 0 & 1
+/// for a particular dimm speed
+/// @param[in] i_dimm_speed the dimm speed in MT/s
+/// @param[out] o_output ODT termination strength (encoding)
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 152 - 154 (Bits 2~0)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 2
+/// @note Page 4.1.2.12.2 - 65
+///
+fapi2::ReturnCode decoder_v1_0::dram_rtt_park_ranks0_1(const uint64_t i_dimm_speed, uint8_t& o_output)
+{
+ size_t l_byte = 0;
+ FAPI_TRY( rtt_park_byte_finder(i_dimm_speed, l_byte) );
+
+ {
+ constexpr size_t START = 5;
+ constexpr size_t LEN = 3;
+ const field_t DRAM_RTT_PARK(l_byte, START, LEN);
+
+ uint8_t l_field_bits = extract_spd_field(iv_target, DRAM_RTT_PARK, iv_spd_data);
+ FAPI_INF("Field Bits value: %d", l_field_bits);
+
+ // This checks my extracting params returns a value within bound
+ constexpr size_t MAX_VALID_VALUE = 7;
+
+ FAPI_TRY( mss::check::spd::fail_for_invalid_value(iv_target,
+ l_field_bits <= MAX_VALID_VALUE,
+ l_byte,
+ l_field_bits,
+ "Failed bounds check for DRAM RTT_PARK (package ranks 0,1)") );
+
+ // Update output only if check passes
+ o_output = l_field_bits;
+
+ FAPI_INF("%s. DRAM RTT_PARK (package ranks 0,1): %d",
+ mss::c_str(iv_target),
+ o_output);
+ }
+
+fapi_try_exit:
+ return fapi2::current_err;
+}
+
+///
+/// @brief Decodes DRAM ODT for RTT_PARK, package ranks 2 & 3
+/// for a particular dimm speed
+/// @param[in] i_dimm_speed the dimm speed in MT/s
+/// @param[out] o_output ODT termination strength (encoding)
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 152 - 154 (Bits 5~3)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 2
+/// @note Page 4.1.2.12.2 - 65
+///
+fapi2::ReturnCode decoder_v1_0::dram_rtt_park_ranks2_3(const uint64_t i_dimm_speed, uint8_t& o_output)
+{
+ size_t l_byte = 0;
+ FAPI_TRY( rtt_park_byte_finder(i_dimm_speed, l_byte) );
+
+ {
+ constexpr size_t START = 2;
+ constexpr size_t LEN = 3;
+ const field_t DRAM_RTT_PARK(l_byte, START, LEN);
+
+ uint8_t l_field_bits = extract_spd_field(iv_target, DRAM_RTT_PARK, iv_spd_data);
+ FAPI_INF("Field Bits value: %d", l_field_bits);
+
+ // This checks my extracting params returns a value within bound
+ constexpr size_t MAX_VALID_VALUE = 7;
+
+ FAPI_TRY( mss::check::spd::fail_for_invalid_value(iv_target,
+ l_field_bits <= MAX_VALID_VALUE,
+ l_byte,
+ l_field_bits,
+ "Failed bounds check for DRAM RTT_PARK (package ranks 2,3)") );
+
+ // Update output only if check passes
+ o_output = l_field_bits;
+
+ FAPI_INF("%s. DRAM RTT_PARK (package ranks 2,3): %d",
+ mss::c_str(iv_target),
+ o_output);
+ }
+
+fapi_try_exit:
+ return fapi2::current_err;
+}
+
+}// lrdimm
+}//spd
+}// mss
diff --git a/src/import/generic/memory/lib/spd/lrdimm/ddr4/lrdimm_decoder_ddr4_v1_1.C b/src/import/generic/memory/lib/spd/lrdimm/ddr4/lrdimm_decoder_ddr4_v1_1.C
new file mode 100644
index 000000000..32bc97940
--- /dev/null
+++ b/src/import/generic/memory/lib/spd/lrdimm/ddr4/lrdimm_decoder_ddr4_v1_1.C
@@ -0,0 +1,273 @@
+/* IBM_PROLOG_BEGIN_TAG */
+/* This is an automatically generated prolog. */
+/* */
+/* $Source: src/import/generic/memory/lib/spd/lrdimm/ddr4/lrdimm_decoder_ddr4_v1_1.C $ */
+/* */
+/* OpenPOWER HostBoot Project */
+/* */
+/* Contributors Listed Below - COPYRIGHT 2016,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 lrdimm_decoder_v1_1.C
+/// @brief LRDIMM module SPD decoder definitions for revision 1.1
+///
+// *HWP HWP Owner: Andre Marin <aamarin@us.ibm.com>
+// *HWP HWP Backup: Brian Silver <bsilver@us.ibm.com>
+// *HWP Team: Memory
+// *HWP Level: 2
+// *HWP Consumed by: HB:FSP
+
+// std lib
+#include <vector>
+
+// fapi2
+#include <fapi2.H>
+
+// mss lib
+#include <generic/memory/lib/spd/lrdimm/ddr4/lrdimm_decoder_ddr4.H>
+#include <generic/memory/lib/spd/common/ddr4/spd_decoder_ddr4.H>
+#include <generic/memory/lib/spd/spd_checker.H>
+#include <generic/memory/lib/utils/c_str.H>
+#include <generic/memory/lib/utils/find.H>
+
+using fapi2::TARGET_TYPE_MCA;
+using fapi2::TARGET_TYPE_MCS;
+using fapi2::TARGET_TYPE_DIMM;
+
+namespace mss
+{
+namespace spd
+{
+namespace lrdimm
+{
+
+///
+/// @brief Decodes register and data buffer types
+/// @param[out] o_output encoding from SPD
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 131 (Bits 7~4)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 3
+/// @note Page 4.1.2.12.3 - 63
+///
+fapi2::ReturnCode decoder_v1_1::register_and_buffer_type(uint8_t& o_output)
+{
+ // Extracting desired bits
+ uint8_t l_field_bits = extract_spd_field< REGISTER_TYPE >(iv_target, iv_spd_data);
+ FAPI_INF("Field Bits value: %d", l_field_bits);
+
+ // This checks my extracting params returns a value within bound
+ constexpr size_t RESERVED = 2;
+
+ FAPI_TRY( mss::check::spd::fail_for_invalid_value(iv_target,
+ l_field_bits < RESERVED, // extract sanity check
+ REGISTER_TYPE.iv_byte,
+ l_field_bits,
+ "Failed bounds check for Register and Data Buffer Types") );
+
+ // Update output only if check passes
+ o_output = l_field_bits;
+
+ FAPI_INF("%s. Register and Data Buffer Types: %d",
+ mss::c_str(iv_target),
+ o_output);
+
+fapi_try_exit:
+ return fapi2::current_err;
+
+}
+
+///
+/// @brief Decodes register output drive strength for CKE signal
+/// @param[out] o_output encoding from SPD
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 137 (Bits 1~0)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 3
+/// @note Page 4.1.2.12.3 - 65
+///
+fapi2::ReturnCode decoder_v1_1::cke_signal_output_driver(uint8_t& o_output)
+{
+ // Extracting desired bits
+ uint8_t l_field_bits = extract_spd_field< CKE_DRIVE_STRENGTH >(iv_target, iv_spd_data);
+ FAPI_INF("Field Bits value: %d", l_field_bits);
+
+ // This checks my extracting params returns a value within bound
+ constexpr size_t MAX_VALID_VAL = 3;
+
+ FAPI_TRY( mss::check::spd::fail_for_invalid_value(iv_target,
+ l_field_bits <= MAX_VALID_VAL, // extract sanity check
+ CKE_DRIVE_STRENGTH.iv_byte,
+ l_field_bits,
+ "Failed bounds check for Register Output Driver for CKE") );
+
+ // Update output only if check passes
+ o_output = l_field_bits;
+
+ FAPI_INF("%s. Register Output Driver for CKE: %d",
+ mss::c_str(iv_target),
+ o_output);
+
+fapi_try_exit:
+ return fapi2::current_err;
+}
+
+///
+/// @brief Decodes register output drive strength for ODT signal
+/// @param[out] o_output encoding from SPD
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 137 (Bits 3~2)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 3
+/// @note Page 4.1.2.12.3 - 65
+///
+fapi2::ReturnCode decoder_v1_1::odt_signal_output_driver(uint8_t& o_output)
+{
+ // Extracting desired bits
+ uint8_t l_field_bits = extract_spd_field< ODT_DRIVE_STRENGTH >(iv_target, iv_spd_data);
+ FAPI_INF("Field Bits value: %d", l_field_bits);
+
+ // This checks my extracting params returns a value within bound
+ constexpr size_t MAX_VALID_VAL = 3;
+
+ FAPI_TRY( mss::check::spd::fail_for_invalid_value(iv_target,
+ l_field_bits <= MAX_VALID_VAL, // extract sanity check
+ ODT_DRIVE_STRENGTH.iv_byte,
+ l_field_bits,
+ "Failed bounds check for Register Output Driver for ODT") );
+
+ // Update output only if check passes
+ o_output = l_field_bits;
+
+ FAPI_INF("%s. Register Output Driver for ODT: %d",
+ mss::c_str(iv_target),
+ o_output);
+
+fapi_try_exit:
+ return fapi2::current_err;
+}
+
+///
+/// @brief Decodes register output drive strength for control signal (CS) signal
+/// @param[out] o_output encoding from SPD
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 137 (Bits 6~7)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 3
+/// @note Page 4.1.2.12.3 - 65
+///
+fapi2::ReturnCode decoder_v1_1::cs_signal_output_driver(uint8_t& o_output)
+{
+ // Extracting desired bits
+ uint8_t l_field_bits = extract_spd_field< CS_DRIVE_STRENGTH >(iv_target, iv_spd_data);
+ FAPI_INF("Field Bits value: %d", l_field_bits);
+
+ // This checks my extracting params returns a value within bound
+ constexpr size_t MAX_VALID_VAL = 3;
+
+ FAPI_TRY( mss::check::spd::fail_for_invalid_value(iv_target,
+ l_field_bits <= MAX_VALID_VAL, // extract sanity check
+ CS_DRIVE_STRENGTH.iv_byte,
+ l_field_bits,
+ "Failed bounds check for Register Output Driver for CS") );
+
+ // Update output only if check passes
+ o_output = l_field_bits;
+
+ FAPI_INF("%s. Register Output Driver for CS: %d",
+ mss::c_str(iv_target),
+ o_output);
+
+fapi_try_exit:
+ return fapi2::current_err;
+}
+
+///
+/// @brief Decodes register output drive strength for clock (B side)
+/// @param[out] o_output drive strength encoding from SPD
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 138 (Bits 1~0)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 3
+/// @note Page 4.1.2.12.3 - 66
+///
+fapi2::ReturnCode decoder_v1_1::b_side_clk_output_driver(uint8_t& o_output)
+{
+ // Extracting desired bits
+ uint8_t l_field_bits = extract_spd_field< B_SIDE_DRIVE_STRENGTH >(iv_target, iv_spd_data);
+ FAPI_INF("Field Bits value: %d", l_field_bits);
+
+ // This checks my extracting params returns a value within bound
+ constexpr size_t MAX_VALID_VAL = 3;
+
+ FAPI_TRY( mss::check::spd::fail_for_invalid_value(iv_target,
+ l_field_bits <= MAX_VALID_VAL, // extract sanity check
+ B_SIDE_DRIVE_STRENGTH.iv_byte,
+ l_field_bits,
+ "Failed bounds check for Register Output Driver for clock (Y0,Y2)") );
+
+ // Update output only if check passes
+ o_output = l_field_bits;
+
+ FAPI_INF("%s. Register Output Driver for clock (Y0,Y2): %d",
+ mss::c_str(iv_target),
+ o_output);
+
+fapi_try_exit:
+ return fapi2::current_err;
+}
+
+///
+/// @brief Decodes register output drive strength for clock (A side)
+/// @param[out] o_output drive strength encoding from SPD
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 138 (Bits 3~2)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 3
+/// @note Page 4.1.2.12.3 - 66
+///
+fapi2::ReturnCode decoder_v1_1::a_side_clk_output_driver(uint8_t& o_output)
+{
+ // Extracting desired bits
+ uint8_t l_field_bits = extract_spd_field< A_SIDE_DRIVE_STRENGTH >(iv_target, iv_spd_data);
+ FAPI_INF("Field Bits value: %d", l_field_bits);
+
+ // This checks my extracting params returns a value within bound
+ constexpr size_t MAX_VALID_VAL = 3;
+
+ FAPI_TRY( mss::check::spd::fail_for_invalid_value(iv_target,
+ l_field_bits <= MAX_VALID_VAL,
+ A_SIDE_DRIVE_STRENGTH.iv_byte,
+ l_field_bits,
+ "Failed bounds check for Register Output Driver for clock (Y1,Y3)") );
+
+ // Update output only if check passes
+ o_output = l_field_bits;
+
+ FAPI_INF("%s. Register Output Driver for clock (Y1,Y3): %d",
+ mss::c_str(iv_target),
+ o_output);
+
+fapi_try_exit:
+ return fapi2::current_err;
+}
+
+}// lrdimm
+}// spd
+}// mss
diff --git a/src/import/generic/memory/lib/spd/lrdimm/ddr4/lrdimm_decoder_ddr4_v1_2.C b/src/import/generic/memory/lib/spd/lrdimm/ddr4/lrdimm_decoder_ddr4_v1_2.C
new file mode 100644
index 000000000..4e223cb19
--- /dev/null
+++ b/src/import/generic/memory/lib/spd/lrdimm/ddr4/lrdimm_decoder_ddr4_v1_2.C
@@ -0,0 +1,306 @@
+/* IBM_PROLOG_BEGIN_TAG */
+/* This is an automatically generated prolog. */
+/* */
+/* $Source: src/import/generic/memory/lib/spd/lrdimm/ddr4/lrdimm_decoder_ddr4_v1_2.C $ */
+/* */
+/* OpenPOWER HostBoot Project */
+/* */
+/* Contributors Listed Below - COPYRIGHT 2016,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 lrdimm_decoder_v1_2.C
+/// @brief LRDIMM module SPD decoder definitions for revision 1.2
+///
+// *HWP HWP Owner: Andre Marin <aamarin@us.ibm.com>
+// *HWP HWP Backup: Brian Silver <bsilver@us.ibm.com>
+// *HWP Team: Memory
+// *HWP Level: 2
+// *HWP Consumed by: HB:FSP
+
+// std lib
+#include <vector>
+
+// fapi2
+#include <fapi2.H>
+
+// mss lib
+#include <generic/memory/lib/spd/lrdimm/ddr4/lrdimm_decoder_ddr4.H>
+#include <generic/memory/lib/spd/common/ddr4/spd_decoder_ddr4.H>
+#include <generic/memory/lib/spd/spd_checker.H>
+#include <generic/memory/lib/utils/c_str.H>
+#include <generic/memory/lib/utils/find.H>
+
+using fapi2::TARGET_TYPE_MCA;
+using fapi2::TARGET_TYPE_MCS;
+using fapi2::TARGET_TYPE_DIMM;
+
+namespace mss
+{
+namespace spd
+{
+namespace lrdimm
+{
+///
+/// @brief Decodes register output drive strength for data buffer control (BCOM, BODT, BKCE)
+/// @param[out] o_output encoded drive strength
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 138 (Bit 4)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 4
+/// @note Page 4.1.2.12.3 - 76
+///
+fapi2::ReturnCode decoder_v1_2::bcom_bcke_bodt_drive_strength(uint8_t& o_output)
+{
+ // Extracting desired bits
+ uint8_t l_field_bits = extract_spd_field< BCOM_BODT_BCKE_DRIVE_STRENGTH >(iv_target, iv_spd_data);
+ FAPI_INF("Field Bits value: %d", l_field_bits);
+
+ // This checks my extracting params returns a value within bound
+ constexpr size_t MAX_VALID_VAL = 1;
+
+ FAPI_TRY( mss::check::spd::fail_for_invalid_value(iv_target,
+ l_field_bits <= MAX_VALID_VAL,
+ BCOM_BODT_BCKE_DRIVE_STRENGTH.iv_byte,
+ l_field_bits,
+ "Failed bounds check for Register Output Driver for data buffer control (BCOM, BODT, BCKE)") );
+
+ // Update output only if check passes
+ o_output = l_field_bits;
+
+ FAPI_INF("%s. Register Output Driver for data buffer control (BCOM, BODT, BCKE): %d",
+ mss::c_str(iv_target),
+ o_output);
+
+fapi_try_exit:
+ return fapi2::current_err;
+}
+
+///
+/// @brief Decodes register output drive strength for data buffer control (BCK)
+/// @param[out] o_output encoded drive strength
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 138 (Bit 5)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 4
+/// @note Page 4.1.2.12.3 - 76
+///
+fapi2::ReturnCode decoder_v1_2::bck_output_drive_strength(uint8_t& o_output)
+{
+ // Extracting desired bits
+ uint8_t l_field_bits = extract_spd_field< BCK_DRIVE_STRENGTH >(iv_target, iv_spd_data);
+ FAPI_INF("Field Bits value: %d", l_field_bits);
+
+ // This checks my extracting params returns a value within bound
+ constexpr size_t MAX_VALID_VAL = 1;
+
+ FAPI_TRY( mss::check::spd::fail_for_invalid_value(iv_target,
+ l_field_bits <= MAX_VALID_VAL,
+ BCK_DRIVE_STRENGTH.iv_byte,
+ l_field_bits,
+ "Failed bounds check for Register Output Driver for data buffer control (BCK)") );
+
+ // Update output only if check passes
+ o_output = l_field_bits;
+
+ FAPI_INF("%s. Register Output Driver for data buffer control (BCK): %d",
+ mss::c_str(iv_target),
+ o_output);
+
+fapi_try_exit:
+ return fapi2::current_err;
+}
+
+///
+/// @brief Decodes RCD output slew rate control
+/// @param[out] o_output encoded drive strength
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 138 (Bit 6)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 4
+/// @note Page 4.1.2.L-4 - 76
+///
+fapi2::ReturnCode decoder_v1_2::slew_rate_control(uint8_t& o_output)
+{
+ // Extracting desired bits
+ uint8_t l_field_bits = extract_spd_field< RCD_SLEW_CNTRL >(iv_target, iv_spd_data);
+ FAPI_INF("Field Bits value: %d", l_field_bits);
+
+ // This checks my extracting params returns a value within bound
+ constexpr size_t MAX_VALID_VAL = 0b1;
+
+ FAPI_TRY( mss::check::spd::fail_for_invalid_value(iv_target,
+ l_field_bits <= MAX_VALID_VAL, // extract sanity check
+ RCD_SLEW_CNTRL.iv_byte,
+ l_field_bits,
+ "Failed bound check for RCD output slew rate control") );
+
+ // Update output only if check passes
+ o_output = l_field_bits;
+
+ FAPI_INF("%s. RCD output slew rate control: %d",
+ mss::c_str(iv_target),
+ o_output);
+
+fapi_try_exit:
+ return fapi2::current_err;
+}
+
+///
+/// @brief Decodes VrefDQ range for DRAM interface range
+/// @param[out] o_output spd encoding
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 155 (Bits 3~0)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 4
+/// @note Page 4.1.2.L-4 - 76
+///
+fapi2::ReturnCode decoder_v1_2::dram_vref_dq_range(uint8_t& o_output)
+{
+ // Extracting desired bits
+ uint8_t l_field_bits = extract_spd_field< DRAM_VREF_DQ_RANGE >(iv_target, iv_spd_data);
+ FAPI_INF("Field Bits value: %d", l_field_bits);
+
+ // This checks my extracting params returns a value within bound
+ constexpr size_t MAX_VALID_VAL = 0b1111;
+
+ FAPI_TRY( mss::check::spd::fail_for_invalid_value(iv_target,
+ l_field_bits <= MAX_VALID_VAL, // extract sanity check
+ DRAM_VREF_DQ_RANGE.iv_byte,
+ l_field_bits,
+ "Failed bound check for VrefDQ range for DRAM interface range ") );
+
+ // Update output only if check passes
+ o_output = l_field_bits;
+
+ FAPI_INF("%s. VrefDQ range for DRAM interface range: %d",
+ mss::c_str(iv_target),
+ o_output);
+
+fapi_try_exit:
+ return fapi2::current_err;
+}
+
+///
+/// @brief Decodes data buffer VrefDQ range for DRAM interface range
+/// @param[out] o_output spd encoding
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 155 (Bit 4)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 4
+/// @note Page 4.1.2.L-4 - 76
+///
+fapi2::ReturnCode decoder_v1_2::data_buffer_vref_dq_range(uint8_t& o_output)
+{
+ // Extracting desired bits
+ uint8_t l_field_bits = extract_spd_field< DATA_BUFFER_VREF_DQ >(iv_target, iv_spd_data);
+ FAPI_INF("Field Bits value: %d", l_field_bits);
+
+ // This checks my extracting params returns a value within bound
+ constexpr size_t MAX_VALID_VAL = 1;
+
+ FAPI_TRY( mss::check::spd::fail_for_invalid_value(iv_target,
+ l_field_bits <= MAX_VALID_VAL, // extract sanity check
+ DATA_BUFFER_VREF_DQ.iv_byte,
+ l_field_bits,
+ "Failed bound check for data buffer VrefDQ range for DRAM interface range") );
+
+ // Update output only if check passes
+ o_output = l_field_bits;
+
+ FAPI_INF("%s. Data buffer VrefDQ range for DRAM interface range: %d",
+ mss::c_str(iv_target),
+ o_output);
+
+fapi_try_exit:
+ return fapi2::current_err;
+}
+
+///
+/// @brief Decodes data buffer gain adjustment
+/// @param[out] o_output spd encoding
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 156 (Bit 0)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 4
+/// @note Page 4.1.2.L-4 - 77
+///
+fapi2::ReturnCode decoder_v1_2::data_buffer_gain_adjustment(uint8_t& o_output)
+{
+ // Extracting desired bits
+ uint8_t l_field_bits = extract_spd_field< DATA_BUFFER_GAIN_ADJUST >(iv_target, iv_spd_data);
+ FAPI_INF("Field Bits value: %d", l_field_bits);
+
+ // This checks my extracting params returns a value within bound
+ constexpr size_t MAX_VALID_VAL = 1;
+
+ FAPI_TRY( mss::check::spd::fail_for_invalid_value(iv_target,
+ l_field_bits <= MAX_VALID_VAL, // extract sanity check
+ DATA_BUFFER_GAIN_ADJUST.iv_byte,
+ l_field_bits,
+ "Failed bound check for data buffer gain adjustment") );
+
+ // Update output only if check passes
+ o_output = l_field_bits;
+
+ FAPI_INF("%s. Data buffer gain adjustment: %d",
+ mss::c_str(iv_target),
+ o_output);
+
+fapi_try_exit:
+ return fapi2::current_err;
+}
+
+///
+/// @brief Decodes data buffer Decision Feedback Equalization (DFE)
+/// @param[out] o_output spd encoding
+/// @return FAPI2_RC_SUCCESS if okay
+/// @note SPD Byte 156 (Bit 1)
+/// @note Item JEDEC Standard No. 21-C
+/// @note DDR4 SPD Document Release 4
+/// @note Page 4.1.2.L-4 - 77
+///
+fapi2::ReturnCode decoder_v1_2::data_buffer_dfe(uint8_t& o_output)
+{
+ // Extracting desired bits
+ uint8_t l_field_bits = extract_spd_field< DATA_BUFFER_DFE >(iv_target, iv_spd_data);
+ FAPI_INF("Field Bits value: %d", l_field_bits);
+
+ // This checks my extracting params returns a value within bound
+ constexpr size_t MAX_VALID_VAL = 1;
+
+ FAPI_TRY( mss::check::spd::fail_for_invalid_value(iv_target,
+ l_field_bits <= MAX_VALID_VAL, // extract sanity check
+ DATA_BUFFER_DFE.iv_byte,
+ l_field_bits,
+ "Failed bound check for data buffer Decision Feedback Equalization (DFE)") );
+
+ // Update output only if check passes
+ o_output = l_field_bits;
+
+ FAPI_INF("%s. Data buffer Decision Feedback Equalization (DFE): %d",
+ mss::c_str(iv_target),
+ o_output);
+
+fapi_try_exit:
+ return fapi2::current_err;
+}
+
+}// lrdimm
+}// spd
+}// mss
diff --git a/src/import/generic/memory/lib/spd/lrdimm/ddr4/lrdimm_raw_cards.C b/src/import/generic/memory/lib/spd/lrdimm/ddr4/lrdimm_raw_cards.C
new file mode 100644
index 000000000..f4b943b2c
--- /dev/null
+++ b/src/import/generic/memory/lib/spd/lrdimm/ddr4/lrdimm_raw_cards.C
@@ -0,0 +1,84 @@
+/* IBM_PROLOG_BEGIN_TAG */
+/* This is an automatically generated prolog. */
+/* */
+/* $Source: src/import/generic/memory/lib/spd/lrdimm/ddr4/lrdimm_raw_cards.C $ */
+/* */
+/* OpenPOWER HostBoot Project */
+/* */
+/* Contributors Listed Below - COPYRIGHT 2016,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 raw_cards.C
+/// @brief LRDIMM raw card data structure
+/// Contains RCW settings per raw card rev
+///
+// *HWP HWP Owner: Andre Marin <aamarin@us.ibm.com>
+// *HWP HWP Backup: Brian Silver <bsilver@us.ibm.com>
+// *HWP Team: Memory
+// *HWP Level: 2
+// *HWP Consumed by: FSP:HB
+
+// std lib
+#include <vector>
+
+// fapi2
+#include <fapi2.H>
+
+// mss lib
+#include <generic/memory/lib/spd/lrdimm/ddr4/lrdimm_raw_cards.H>
+
+namespace mss
+{
+
+///
+/// @brief raw card B0 settings
+///
+// TODO RTC:160116 Fill in valid RCD data for LRDIMM
+rcw_settings lrdimm_rc_b0( 0x00, // RC00
+ 0x00, // RC01 (C might be the right answer)
+ 0x00, // RC02
+ 0x1F, // RC06_7
+ 0x00, // RC09
+ 0x0E, // RC0B
+ 0x00, // RC0C
+ 0x00, // RC0F
+ 0x00, // RC1X
+ 0x00, // RC2X
+ 0x00, // RC4X
+ 0x00, // RC5X
+ 0x00, // RC6C
+ 0x00, // RC8X
+ 0x00, // RC9X
+ 0x00, // RCAx
+ 0x07);// RCBX
+
+namespace lrdimm
+{
+
+// TODO - RTC:160121 Catch all for adding raw card data for DIMMs
+const std::vector< std::pair< uint8_t , rcw_settings> > RAW_CARDS =
+{
+ // I expect this to grow as Warren M. expects us to have
+ // settings for every raw card that JEDEC puts out. Openpower
+ // can't break due to a missing raw card...
+ {raw_card_rev::B0, lrdimm_rc_b0},
+};
+
+}// lrdimm
+}// mss
diff --git a/src/import/generic/memory/lib/spd/lrdimm/ddr4/lrdimm_raw_cards.H b/src/import/generic/memory/lib/spd/lrdimm/ddr4/lrdimm_raw_cards.H
new file mode 100644
index 000000000..e3a99698d
--- /dev/null
+++ b/src/import/generic/memory/lib/spd/lrdimm/ddr4/lrdimm_raw_cards.H
@@ -0,0 +1,68 @@
+/* IBM_PROLOG_BEGIN_TAG */
+/* This is an automatically generated prolog. */
+/* */
+/* $Source: src/import/generic/memory/lib/spd/lrdimm/ddr4/lrdimm_raw_cards.H $ */
+/* */
+/* OpenPOWER HostBoot Project */
+/* */
+/* Contributors Listed Below - COPYRIGHT 2016,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 raw_cards.H
+/// @brief Raw card data structure
+///
+// *HWP HWP Owner: Andre Marin <aamarin@us.ibm.com>
+// *HWP HWP Backup: Brian Silver <bsilver@us.ibm.com>
+// *HWP Team: Memory
+// *HWP Level: 2
+// *HWP Consumed by: HB:FSP
+
+#ifndef _MSS_LRDIMM_RAW_CARDS_H_
+#define _MSS_LRDIMM_RAW_CARDS_H_
+
+#include <fapi2.H>
+#include <cstdint>
+#include <vector>
+#include <generic/memory/lib/spd/common/rcw_settings.H>
+
+namespace mss
+{
+namespace lrdimm
+{
+
+// In the order of the vector below which needs to be sorted by enum value
+enum raw_card_rev : uint8_t
+{
+ // TODO RTC:160116 Fill in valid RCD data for LRDIMM
+ B0 = 0x01,
+};
+
+// Raw cards can share the same raw card # between RDIMM and LRDIMMs so
+// we track them independently. Since all of these don't come from SPD for DDR4,
+// we have to set some RCWs (we want limit these and derive as many as possible)
+extern const std::vector< std::pair< uint8_t, rcw_settings> > RAW_CARDS;
+
+}// lrdimm
+
+// Exposed so we can test them.
+extern rcw_settings lrdimm_rc_b0;
+
+}// mss
+
+#endif //_MSS_LRDIMM_RAW_CARDS_H_
OpenPOWER on IntegriCloud