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
|
/* IBM_PROLOG_BEGIN_TAG */
/* This is an automatically generated prolog. */
/* */
/* $Source: src/usr/diag/prdf/plat/mem/prdfMemTps.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 prdfMemTps.H */
#ifndef __prdfMemTps_H
#define __prdfMemTps_H
// Platform includes
#include <prdfMemTdQueue.H>
#include <prdfMemUtils.H>
namespace PRDF
{
struct CeCount
{
MemUtils::MaintSymbols symList;
uint32_t count = 0;
};
/** @brief Two-Phase Scrub procedure. */
template <TARGETING::TYPE T>
class TpsEvent : public TdEntry
{
public: // functions
/**
* @brief Constructor
* @param i_chip MCA or MBA.
* @param i_rank Target rank.
* @param i_ban True to ban all subsequent requests for TPS on this rank.
*/
TpsEvent<T>( ExtensibleChip * i_chip, MemRank i_rank, bool i_ban = false ) :
TdEntry(TPS_EVENT, i_chip, i_rank)
{
PRDF_ASSERT( nullptr != i_chip );
PRDF_ASSERT( T == i_chip->getType() );
}
public: // overloaded functions from parent class
uint32_t nextStep( STEP_CODE_DATA_STRUCT & io_sc, bool & o_done );
uint32_t getKey() const { return iv_rank.getKey(); } // Master and slave
private: // functions
#ifdef __HOSTBOOT_RUNTIME
/**
* @brief Starts phase 1 of the procedure.
* @param io_sc The step code data struct.
* @return Non-SUCCESS if an internal function fails, SUCCESS otherwise.
*/
uint32_t startTpsPhase1_rt( STEP_CODE_DATA_STRUCT & io_sc );
/**
* @brief Analyzes phase 1 of the procedure.
* @param io_sc The step code data struct.
* @param o_done True if the procedure is complete or has aborted.
* @return Non-SUCCESS if an internal function fails, SUCCESS otherwise.
*/
uint32_t analyzeTpsPhase1_rt(STEP_CODE_DATA_STRUCT & io_sc, bool & o_done);
/**
* @brief Does isolation for ECC attentions.
* @param i_eccAttns Mask of all currently active maintenance attentions.
* See enum MaintEccAttns for values.
* @param io_sc The step code data struct.
* @param o_done True if the procedure is complete or has aborted.
* @return Non-SUCCESS if an internal function fails, SUCCESS otherwise.
*/
uint32_t analyzeEcc( const uint32_t & i_eccAttns,
STEP_CODE_DATA_STRUCT & io_sc,
bool & o_done );
/**
* @brief Analyzes the counts that summarize the symbol CE counts.
* @param i_badDqCount Number of nibbles with a bad DQ
* @param i_badChipCount Number of nibbles with a bad Chip
* @param i_sumAboveOneCount Number of nibbles under threshold with a
* sum greater than 1
* @param i_singleSymCount Number of nibbles under threshold with only
* a single symbol with a non-zero count, and
* that count is > 1
* @param io_sc The step code data struct.
* @return Non-SUCCESS if an internal function fails, SUCCESS otherwise.
*/
uint32_t analyzeCeSymbolCounts( CeCount i_badDqCount,
CeCount i_badChipCount, CeCount i_sumAboveOneCount,
CeCount i_singleSymCount, STEP_CODE_DATA_STRUCT & io_sc );
/**
* @brief Gets the counts that summarize the symbol CE counts.
* @param io_badDqCount Number of nibbles with a bad DQ
* @param io_badChipCount Number of nibbles with a bad Chip
* @param io_sumAboveOneCount Number of nibbles under threshold with a
* sum greater than 1
* @param io_singleSymCount Number of nibbles under threshold with only
* a single symbol with a non-zero count, and
* that count is > 1
* @param io_sc The step code data struct.
* @return Non-SUCCESS if an internal function fails, SUCCESS otherwise.
*/
uint32_t getSymbolCeCounts( CeCount & io_badDqCount,
CeCount & io_badChipCount, CeCount & io_sumAboveOneCount,
CeCount & io_singleSymCount, STEP_CODE_DATA_STRUCT & io_sc );
/**
* @brief Does isolation for CE attentions.
* @param io_sc The step code data struct.
* @return Non-SUCCESS if an internal function fails, SUCCESS otherwise.
*/
uint32_t analyzeCe( STEP_CODE_DATA_STRUCT & io_sc );
#endif // __HOSTBOOT_RUNTIME
};
} // end namespace PRDF
#endif // __prdfMemTps_H
|
