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
|
/* IBM_PROLOG_BEGIN_TAG */
/* This is an automatically generated prolog. */
/* */
/* $Source: src/usr/hwpf/hwp/mvpd_accessors/getMBvpdSpareDramData.C $ */
/* */
/* IBM CONFIDENTIAL */
/* */
/* COPYRIGHT International Business Machines Corp. 2013 */
/* */
/* p1 */
/* */
/* Object Code Only (OCO) source materials */
/* Licensed Internal Code Source Materials */
/* IBM HostBoot Licensed Internal Code */
/* */
/* The source code for this program is not published or otherwise */
/* divested of its trade secrets, irrespective of what has been */
/* deposited with the U.S. Copyright Office. */
/* */
/* Origin: 30 */
/* */
/* IBM_PROLOG_END_TAG */
// $Id: getMBvpdSpareDramData.C,v 1.3 2013/09/12 14:12:39 mjjones Exp $
#include <stdint.h>
// fapi support
#include <fapi.H>
#include <dimmConsts.H>
#include <getMBvpdSpareDramData.H>
extern "C"
{
using namespace fapi;
fapi::ReturnCode getMBvpdSpareDramData(const fapi::Target &i_mba,
const fapi::Target &i_dimm,
uint8_t &o_data)
{
// AM keyword layout
const uint8_t NUM_MBAS = 2; // Two MBAs per Centaur
const uint8_t NUM_PORTS = 2; // Two ports per MBA
const uint8_t NUM_DIMMS = 2; // Two DIMMS per port
const uint8_t NUM_MIRR_BYTES = 4; // Size of address mirror data
// Struct for AM Keyword buffer
// Contains a simple array for the address mirror data and
// a 2D array for the spare DRAM data.
struct MirrorData
{
uint8_t iv_mirrorData[NUM_MIRR_BYTES];
};
struct DimmSpareData
{
// This contains information for all ranks and is returned in o_data
uint8_t iv_dimmSpareData;
};
struct PortSpareData
{
DimmSpareData iv_dimmSpareData[NUM_DIMMS];
};
struct MbaSpareData
{
PortSpareData iv_portSpareData[NUM_PORTS];
};
struct AmKeyword
{
MirrorData mirrorData;
MbaSpareData iv_mbaSpareData[NUM_MBAS];
};
// Current VPD AM keyword size
const uint32_t AM_KEYWORD_SIZE = sizeof(AmKeyword);
fapi::ReturnCode l_rc;
// Centaur target
fapi::Target l_mbTarget;
// MBvpd AM keyword buffer
AmKeyword * l_pAmBuffer = NULL;
uint32_t l_AmBufSize = sizeof(AmKeyword);
// For old VPD without spare DRAM data
// Store data for all 4 ranks of this DIMM
const uint8_t VPD_WITHOUT_SPARE_LOW_NIBBLE = 0x55;
const uint8_t VPD_WITHOUT_SPARE_FULL_BYTE = 0xFF;
do
{
// Check to see if IS-DIMM
uint8_t l_dimmType = 0;
l_rc = FAPI_ATTR_GET(ATTR_SPD_CUSTOM, &i_dimm, l_dimmType);
if (l_rc)
{
FAPI_ERR("getMBvpdSpareDramData: "
"Error getting ATTR_SPD_CUSTOM");
break;
}
if (fapi::ENUM_ATTR_SPD_CUSTOM_NO == l_dimmType)
{
//IS-DIMM, return NO_SPARE
o_data = fapi::ENUM_ATTR_VPD_DIMM_SPARE_NO_SPARE;
break;
}
// find the Centaur memory buffer from the passed MBA
l_rc = fapiGetParentChip (i_mba,l_mbTarget);
if (l_rc)
{
FAPI_ERR("getMBvpdSpareDramData: Finding the parent mb failed ");
break;
}
// Read AM keyword field
l_pAmBuffer = new AmKeyword;
l_rc = fapiGetMBvpdField(fapi::MBVPD_RECORD_VSPD,
fapi::MBVPD_KEYWORD_AM,
l_mbTarget,
reinterpret_cast<uint8_t *>(l_pAmBuffer),
l_AmBufSize);
// Check for error or incorrect amount of data returned
if (l_rc || (l_AmBufSize < AM_KEYWORD_SIZE))
{
// This handles two scenarios:
// 1. fapiGetMBvpdField has returned an error because
// the AM keyword is not present in this DIMM's
// VPD.
// 2. This DIMM does have the AM Keyword, however it
// is in an old version of VPD and does not contain
// any spare DRAM information.
// In both cases, the ATTR_SPD_DRAM_WIDTH
// attribute is used to determine spare DRAM availability.
// If x4 configuration, assume LOW_NIBBLE.
// Otherwise, FULL_BYTE.
// TODO RTC 84278: Undo the workaround for scenario 1 once the
// C-DIMM VPD is updated on all DIMMs to the current version.
uint8_t l_dramWidth = 0;
l_rc = FAPI_ATTR_GET(ATTR_SPD_DRAM_WIDTH, &i_dimm, l_dramWidth);
if (l_rc)
{
FAPI_ERR("getMBvpdSpareDramData: "
"Error getting DRAM spare data");
break;
}
// If x4 configuration, low nibble.
if (fapi::ENUM_ATTR_SPD_DRAM_WIDTH_W4 == l_dramWidth)
{
o_data = VPD_WITHOUT_SPARE_LOW_NIBBLE;
break;
}
// Else, full spare.
else
{
o_data = VPD_WITHOUT_SPARE_FULL_BYTE;
break;
}
}
// Return the spare DRAM availability for particular dimm
// Find the position of the passed mba on the centuar
uint8_t l_mba = 0;
l_rc = FAPI_ATTR_GET(ATTR_CHIP_UNIT_POS, &i_mba, l_mba);
if (l_rc)
{
FAPI_ERR("getMBvpdSpareDramData: Get MBA position failed ");
break;
}
// Find the mba port this dimm is connected to
uint8_t l_mbaPort = 0;
l_rc = FAPI_ATTR_GET(ATTR_MBA_PORT, &i_dimm, l_mbaPort);
if (l_rc)
{
FAPI_ERR("getMBvpdSpareDramData: "
"Error getting MBA port number");
break;
}
// Find the dimm number associated with this dimm
uint8_t l_dimm = 0;
l_rc = FAPI_ATTR_GET(ATTR_MBA_DIMM, &i_dimm, l_dimm);
if (l_rc)
{
FAPI_ERR("getMBvpdSpareDramData: "
"Error getting dimm number");
break;
}
o_data = l_pAmBuffer->iv_mbaSpareData[l_mba].\
iv_portSpareData[l_mbaPort].\
iv_dimmSpareData[l_dimm].iv_dimmSpareData;
}while(0);
delete l_pAmBuffer;
l_pAmBuffer = NULL;
return l_rc;
}
} // extern "C"
|
