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
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
|
/* IBM_PROLOG_BEGIN_TAG */
/* This is an automatically generated prolog. */
/* */
/* $Source: src/import/chips/p9/procedures/hwp/memory/lib/dimm/kind.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 dimm.H
/// @brief Encapsulation for dimms of all types
///
// *HWP HWP Owner: Brian Silver <bsilver@us.ibm.com>
// *HWP HWP Backup: Andre Marin <aamarin@us.ibm.com>
// *HWP Team: Memory
// *HWP Level: 2
// *HWP Consumed by: HB:FSP
#ifndef _MSS_DIMM_H_
#define _MSS_DIMM_H_
#include <fapi2.H>
#include <lib/mss_attribute_accessors.H>
#include <c_str.H>
namespace mss
{
namespace dimm
{
///
/// @class mss::dimm::kind
/// @brief A class containing information about a dimm like ranks, density, configuration - what kind of dimm is it?
///
class kind
{
public:
///
/// @brief Generate a vector of DIMM kind from a vector of DIMM
/// @param[in] i_dimm a vector of DIMM
/// @return std::vector of dimm::kind relating to the DIMM passed in
///
static std::vector<kind> vector(const std::vector<fapi2::Target<fapi2::TARGET_TYPE_DIMM>>& i_dimm)
{
std::vector<kind> l_kinds;
for (const auto& d : i_dimm)
{
l_kinds.push_back( kind(d) );
}
return l_kinds;
}
///
/// @brief operator=() - assign kinds (needed to sort vectors of kinds)
/// @param[in] i_rhs the right hand side of the assignment statement
/// @return reference to this
///
inline kind& operator=(const kind& i_rhs)
{
iv_target = i_rhs.iv_target;
iv_master_ranks = i_rhs.iv_master_ranks;
iv_total_ranks = i_rhs.iv_total_ranks;
iv_dram_density = i_rhs.iv_dram_density;
iv_dram_width = i_rhs.iv_dram_width;
iv_dram_generation = i_rhs.iv_dram_generation;
iv_dimm_type = i_rhs.iv_dimm_type;
iv_rows = i_rhs.iv_rows;
iv_size = i_rhs.iv_size;
iv_mfgid = i_rhs.iv_mfgid;
iv_stack_type = i_rhs.iv_stack_type;
return *this;
}
///
/// @brief operator==() - are two kinds the same?
/// @param[in] i_rhs the right hand side of the comparison statement
/// @return bool true iff the two kind are of the same kind
/// @warning this does not compare the targets (iv_target,) just the values
///
inline bool operator==(const kind& i_rhs) const
{
return ((iv_master_ranks == i_rhs.iv_master_ranks) &&
(iv_total_ranks == i_rhs.iv_total_ranks) &&
(iv_dram_density == i_rhs.iv_dram_density) &&
(iv_dram_width == i_rhs.iv_dram_width) &&
(iv_dram_generation == i_rhs.iv_dram_generation) &&
(iv_dimm_type == i_rhs.iv_dimm_type) &&
(iv_rows == i_rhs.iv_rows) &&
(iv_size == i_rhs.iv_size));
}
///
/// @brief Construct a dimm::kind data structure - information about the kind of DIMM this is
/// @param[in] i_target a DIMM target
///
kind(const fapi2::Target<fapi2::TARGET_TYPE_DIMM>& i_target):
iv_target(i_target)
{
FAPI_TRY( mss::eff_dram_gen(i_target, iv_dram_generation) );
FAPI_TRY( mss::eff_dimm_type(i_target, iv_dimm_type) );
FAPI_TRY( mss::eff_dram_density(i_target, iv_dram_density) );
FAPI_TRY( mss::eff_dram_width(i_target, iv_dram_width) );
FAPI_TRY( mss::eff_num_master_ranks_per_dimm(i_target, iv_master_ranks) );
FAPI_TRY( mss::eff_num_ranks_per_dimm(i_target, iv_total_ranks) );
FAPI_TRY( mss::eff_dram_row_bits(i_target, iv_rows) );
FAPI_TRY( mss::eff_dimm_size(i_target, iv_size) );
FAPI_TRY( mss::eff_dram_mfg_id(i_target, iv_mfgid) );
FAPI_TRY( mss::eff_prim_stack_type( i_target, iv_stack_type) );
return;
fapi_try_exit:
// Not 100% sure what to do here ...
FAPI_ERR("error initializing DIMM structure: %s 0x%016lx", mss::c_str(i_target), uint64_t(fapi2::current_err));
fapi2::Assert(false);
}
///
/// @brief Construct a DIMM kind used to identify this DIMM for tables.
/// @param[in] i_master_ranks number of master ranks on the DIMM
/// @param[in] i_total_ranks total number of ranks on the DIMM
/// @param[in] i_dram_density density of the DRAM
/// @param[in] i_dram_width width of the DRAM
/// @param[in] i_dram_generation DRAM generation
/// @param[in] i_dimm_type DIMM type (e.g. RDIMM)
/// @param[in] i_rows number of rows in the DRAM
/// @param[in] i_size the overal size of the DIMM in GB
/// @param[in] i_mfgid the dram manufacturer id of the dimm, defaulted to 0
/// @param[in] i_stack_type dram die type, single die package or 3DS
/// @note can't be constexpr as fapi2::Target doesn't have a constexpr ctor.
///
kind( const uint8_t i_master_ranks,
const uint8_t i_total_ranks,
const uint8_t i_dram_density,
const uint8_t i_dram_width,
const uint8_t i_dram_generation,
const uint8_t i_dimm_type,
const uint8_t i_rows,
const uint32_t i_size,
const uint16_t i_mfgid = 0,
const uint8_t i_stack_type = fapi2::ENUM_ATTR_EFF_PRIM_STACK_TYPE_SDP):
iv_target(0),
iv_master_ranks(i_master_ranks),
iv_total_ranks(i_total_ranks),
iv_dram_density(i_dram_density),
iv_dram_width(i_dram_width),
iv_dram_generation(i_dram_generation),
iv_dimm_type(i_dimm_type),
iv_rows(i_rows),
// TK consider calculating size rather than requiring it be set.
iv_size(i_size),
iv_mfgid(i_mfgid),
iv_stack_type(i_stack_type)
{
// Bit of an idiot-check to be sure a hand-crafted dimm::kind make sense wrt slaves, masters, packages, etc.
if (iv_master_ranks > iv_total_ranks)
{
FAPI_ERR("Not enough total ranks? master: %d total: %d", iv_master_ranks, iv_total_ranks);
fapi2::Assert(false);
}
if ((iv_total_ranks % iv_master_ranks) != 0)
{
FAPI_ERR("total or master ranks seems incorrect. master: %d total: %d", iv_master_ranks, iv_total_ranks);
fapi2::Assert(false);
}
}
fapi2::Target<fapi2::TARGET_TYPE_DIMM> iv_target;
uint8_t iv_master_ranks;
uint8_t iv_total_ranks;
uint8_t iv_dram_density;
uint8_t iv_dram_width;
uint8_t iv_dram_generation;
uint8_t iv_dimm_type;
uint8_t iv_rows;
uint32_t iv_size;
uint16_t iv_mfgid;
uint8_t iv_stack_type;
};
}
}
#endif
|
