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
|
/* IBM_PROLOG_BEGIN_TAG */
/* This is an automatically generated prolog. */
/* */
/* $Source: src/include/usr/diag/prdf/common/prdfMain_common.H $ */
/* */
/* IBM CONFIDENTIAL */
/* */
/* COPYRIGHT International Business Machines Corp. 2002,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 */
#ifndef __prdfMain_common_H
#define __prdfMain_common_H
/**
* @file prdfMain_common.H
* @brief PRD code used by external components.
*
* This file contains code that is strictly common between FSP and Hostboot. All
* platform specific code should be in the respective FSP only or Hostboot only
* files.
*/
#include <targeting/common/target.H>
namespace PRDF
{
// Move here from iipsdbug.h
/**
* @brief Enum specifying attention type
*/
// If changes are made to ATTENTION_VALUE_TYPE then subsequent changes need to be made to:
// /prdf/sim/prdsimAttentionParser.C and /prdf/sim/errl2tcd.C
enum ATTENTION_VALUE_TYPE
{
INVALID_ATTENTION_TYPE = 0,
MACHINE_CHECK = 1,
CHECK_STOP = MACHINE_CHECK,
UNIT_CS = 2,
PROC_CS = UNIT_CS,
RECOVERABLE = 3,
SPECIAL = 4,
END_ATTENTION_TYPE = 5
};
// Move here from xspprdsdbug.C
/**
* @brief Structure of target handle and its attention type
*/
struct AttnData
{
TARGETING::TargetHandle_t targetHndl;
ATTENTION_VALUE_TYPE attnType;
};
typedef std::vector<AttnData> AttnList;
//! @c prd_return_code_t : possible return values from PRD
enum prd_return_code_t
{
//! DD00: An assert statement failed in PRD
PRD_ASSERT = 0xDD00,
//! DD01: An attention of this type is not expected
PRD_INVALID_ATTENTION_TYPE = 0xDD01,
/*! DD02: A Scan Comm Register Read indicates no bits are set in the SCR
where active bits were expected */
PRD_SCAN_COMM_REGISTER_ZERO = 0xDD02,
/*! DD03: Attempted to cross a chip connection but could not resolve target
* chip */
PRD_UNRESOLVED_CHIP_CONNECTION = 0xDD03,
//! DD05: Error is internal to PRD code
PRD_INTERNAL_CODE_ERROR = 0xDD05,
//! DD09: Failure accessing attention data from Registry
PRD_ATTN_DATA_ACCESS_FAILED = 0xDD09,
//! DD11: SRC ACCESS FAILED
SCR_ACCESS_FAILED = 0xDD11,
//! DD20: System Analyze() is called with no domains in System (init failed?)
NO_DOMAINS_IN_SYSTEM = 0xDD20,
//! DD21: System Analyze() is called, but no domains in the system are at attention
NO_DOMAINS_AT_ATTENTION = 0xDD21,
//! DD23: PRD did not perform an analysis - Unknown chip raised attention
NO_PRD_ANALYSIS = 0xDD23,
//! DD24: prdMain() called before prdInitialize()
PRD_NOT_INITIALIZED = 0xDD24,
//! DD28: PrdStartScrub failure
PRD_RBS_START_SCRUB_ERROR = 0xDD28,
//! DD29: PrdResoreRbs failure
PRD_RBS_RESTORE_ERROR = 0xDD29,
//! DD81: Multiple bits on in Error Register
PRD_MULTIPLE_ERRORS = 0xDD81,
//! DD90: Scan comm access from Error Register failed
PRD_SCANCOM_FAILURE = 0xDD90,
//! DD91: Scan comm access from Error Register failed due to Power Fault
PRD_POWER_FAULT = 0xDD91,
//! DDFF: Special return code indicating Not to reset or mask FIR bits.
PRD_NO_CLEAR_FIR_BITS = 0xDDFF,
};
/** Indicates if PRD has been initialized. */
extern bool g_initialized;
/**
* @brief Initialize PRD system model and data
* @return Error log if error occurs
*/
extern errlHndl_t initialize();
/**
* @brief analyze attention errors
* @param[in] i_attnType - global attention type
* @param[in] i_attnList - list of chips at attention
* @return Error log if error occurs
*
* @note If the i_attnType is CHECK_STOP than an error log is returned
* containing the analysis; otherwise, for other attention types, PRD
* commits the error log itself and NULL is returned.
*/
extern errlHndl_t main( ATTENTION_VALUE_TYPE i_attnType,
const AttnList & i_attnList );
/**
* @brief Clean up pieces of PRD for fresh IPLs.
*
* Cleans up the PRD persistent storage areas in P1.
*/
extern void iplCleanup();
/**
* @brief Remove non-functional chips from PRD config model
*
* @return Error log if error occurs
*/
extern errlHndl_t refresh();
} // End namespace PRDF
#endif // __prdfMain_common_H
|
