summaryrefslogtreecommitdiffstats
path: root/src/import/chips/p9a/procedures/hwp/memory/lib/eff_config/axone_mss_voltage.C
blob: 27a8154212c48b8b1d319612c9e3c398ed357fd6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
/* IBM_PROLOG_BEGIN_TAG                                                   */
/* This is an automatically generated prolog.                             */
/*                                                                        */
/* $Source: src/import/chips/p9a/procedures/hwp/memory/lib/eff_config/axone_mss_voltage.C $ */
/*                                                                        */
/* OpenPOWER HostBoot Project                                             */
/*                                                                        */
/* Contributors Listed Below - COPYRIGHT 2018                             */
/* [+] 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 axone_mss_voltage.C
/// @brief Axone specializations for voltage library
///
// *HWP HWP Owner: Louis Stermole <stermole@us.ibm.com>
// *HWP HWP Backup: Stephen Glancy <sglancy@us.ibm.com>
// *HWP Team: Memory
// *HWP Level: 3
// *HWP Consumed by: HB:FSP

#include <fapi2.H>
#include <vector>

// Memory libraries
#include <exp_attribute_accessors_manual.H>

// Generic libraries
#include <generic/memory/lib/utils/shared/mss_generic_consts.H>
#include <generic/memory/lib/utils/find.H>
#include <generic/memory/lib/spd/spd_facade.H>
#include <generic/memory/lib/utils/voltage/gen_mss_voltage_traits.H>
#include <generic/memory/lib/utils/voltage/gen_mss_volt.H>

namespace mss
{

using TT = mss::voltage_traits<mss::mc_type::EXPLORER, mss::spd::device_type::DDR4>;

// List of attribute setter functions for setting voltage rail values
const std::vector<fapi2::ReturnCode (*)(const fapi2::Target<TT::VOLTAGE_TARGET_TYPE>&, uint32_t)>
TT::voltage_setters =
{
    &set_volt_vddr,
    &set_volt_vpp,
};

///
/// @brief Determine what voltages are supported for the given memory controller and DRAM generation
/// @param[in] i_target the target for setting voltage attributes
/// @param[out] o_supported_dram_voltages vector of supported rail voltages in millivolts to be used in set_voltage_attributes
/// @return FAPI2_RC_SUCCESS iff ok
/// @note AXONE, DDR4 specialization
///
template<>
fapi2::ReturnCode get_supported_voltages<mss::mc_type::EXPLORER, mss::spd::device_type::DDR4>
(const fapi2::Target<TT::SPD_TARGET_TYPE>& i_target,
 std::vector<uint32_t>& o_supported_dram_voltages)
{
    o_supported_dram_voltages.clear();

    FAPI_INF("Populating decoder cache for %s", mss::c_str(i_target));

    // Factory cache is per port
    std::vector< mss::spd::facade > l_spd_facades;
    FAPI_TRY( get_spd_decoder_list(i_target, l_spd_facades), "%s Failed to get SPD decoder list", mss::c_str(i_target) );

    // Get DIMM for each port
    for ( const auto& l_cache : l_spd_facades )
    {
        const auto l_dimm = l_cache.get_dimm_target();
        uint8_t l_dimm_nominal = 0;
        uint8_t l_dimm_endurant = 0;

        // Read nominal and endurant bits from SPD, 0 = 1.2V is not operable and endurant, 1 = 1.2 is valid
        FAPI_TRY( l_cache.operable_nominal_voltage(l_dimm_nominal) );
        FAPI_TRY( l_cache.endurant_nominal_voltage(l_dimm_endurant) );

        //Check to make sure 1.2 V is both operable and endurant, fail if it is not
        FAPI_ASSERT ( (l_dimm_nominal == mss::spd::OPERABLE) && (l_dimm_endurant == mss::spd::ENDURANT),
                      fapi2::MSS_VOLT_DDR_TYPE_REQUIRED_VOLTAGE().
                      set_ACTUAL_OPERABLE(l_dimm_nominal).
                      set_ACTUAL_ENDURANT(l_dimm_endurant).
                      set_EXPECTED_OPERABLE(mss::spd::OPERABLE).
                      set_EXPECTED_ENDURANT(mss::spd::ENDURANT).
                      set_DIMM_TARGET(l_dimm),
                      "%s: DIMM is not operable (%d) expected (%d)"
                      " and/or endurant (%d) expected (%d) at 1.2V",
                      mss::c_str(l_dimm),
                      l_dimm_nominal,
                      mss::spd::OPERABLE,
                      l_dimm_endurant,
                      mss::spd::ENDURANT);
    } // l_dimm

    // Set the attributes for this port, values are in mss_const.H
    // The ordering of voltages is specified in the selected voltage_traits specialization
    o_supported_dram_voltages.push_back(TT::DDR4_NOMINAL_VOLTAGE);
    o_supported_dram_voltages.push_back(TT::DDR4_VPP_VOLTAGE);

fapi_try_exit:
    return fapi2::current_err;
}

} // ns mss
OpenPOWER on IntegriCloud