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
|
/* IBM_PROLOG_BEGIN_TAG */
/* This is an automatically generated prolog. */
/* */
/* $Source: src/include/usr/hwas/common/hwas.H $ */
/* */
/* OpenPOWER HostBoot Project */
/* */
/* COPYRIGHT International Business Machines Corp. 2011,2014 */
/* */
/* 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 */
#ifndef __HWAS_HWAS_H
#define __HWAS_HWAS_H
/**
* @file hwas.H
*
* HardWare Availability Service prototypes.
* In trying to keep with C++ tradition, doxygen documentation for functions
* are here in the .H file.
*
* All of the following routines are "named isteps" - they are invoked as
* tasks by the @ref IStepDispatcher.
*
*/
/******************************************************************************/
// Includes
/******************************************************************************/
#include <stdint.h>
#include <targeting/common/commontargeting.H>
#include <hwas/common/deconfigGard.H>
#include <hwas/common/hwasError.H>
namespace HWAS
{
/**
* @brief initHardware Common HWAS function to setup the hardware
*
* It will call into the hwas platform-specific platInitHardware()
* function to init the FSI hardware.
*
* @param none
*
* @return errlHndl_t valid errlHndl_t handle if there was an error
* NULL if no errors;
*/
errlHndl_t initHardware();
/**
* @brief discoverTagets Common HWAS function to build targeting
*
* This routine will walk through all the targets and initialize HWAS STATE
* to a known default value (powered off, etc.)
*
* Then call into the hwas platform-specific platPresenceDetect() function
* to read the hardware information, and apply it to the target states,
* and call into the hwas platform-specific functions:
* platReadIDEC() to get and set the ChipID and EC values.
* platReadPartialGood() to get and set the partial good vector.
*
* @param none
*
* @return errlHndl_t valid errlHndl_t handle if there was an error
* NULL if no errors;
*/
errlHndl_t discoverTargets();
/**
* @brief restrictEXunits Internal HWAS function to restrict the EXs
*
* This routine will walk through the procs in the list, and turn EX
* units to not functional if the number of units is larger than the max
* given. This is used for PR keyword and Field Core Override (FCO)
* processing.
*
* @param[in] i_procRestrict vector of procRestrict entries
* @param[in] i_present boolean for 'present' HWAS value for restricted
* EX units
* @param[in] i_deconfigReason DECONFIGURED_BY_ enum or 0
*
* @return errlHndl_t valid errlHndl_t handle if there was an error
* NULL if no errors;
*/
// structure used to store proc information for EX restrict processing
typedef struct {
TARGETING::TargetHandle_t target; // proc target
uint32_t group; // uniq id for this group - ie: FRUID, node
uint32_t maxEXs; // max EX units for this group
uint8_t procs; // number of procs in the group
} procRestrict_t;
errlHndl_t restrictEXunits(
std::vector <procRestrict_t> &i_procRestrict,
const bool i_present,
const uint32_t i_deconfigReason);
/**
* @brief Verifies that the system has enough hardware to proceed through
* the IPL.
* This function contains checks that are COMMON between HWSV and HB.
* platform-specific checks will be called by platCheckMinimimHardware(),
* see hwasCommon.H .
* If it cannot find minimum hardware, an error will be created and returned.
* Error logs will also be created for each hardware module that is not
* running.
*
* @param[in] i_node node target to restrict hw check
*
* @return error log handle
*/
errlHndl_t checkMinimumHardware(
const TARGETING::ConstTargetHandle_t i_node = NULL);
/**
* @brief Struct representing a particular target. Used by
* invokePresentByAssoc to populate a vector of TargetInfo's for subsequent
* use by deconfigPresentByAssoc
*/
struct TargetInfo
{
TARGETING::ATTR_AFFINITY_PATH_type affinityPath;
TARGETING::Target * pThisTarget;
TARGETING::ATTR_HUID_type huid;
TARGETING::ATTR_TYPE_type type;
HWAS::DeconfigGard::DeconfiguredByReason reason;
bool functional;
};
// Structure populated in invokePresentByAssoc() for use in presentByAssoc()
typedef std::vector<TargetInfo> TargetInfoVector;
/**
* @brief Invokes presentByAssoc
*
* Called by discoverTargets(). This function queries the system and populates
* a vector of structs representing functional MCS, MEMBUFS, DIMMS.
* This vector is then passed to presentByAssoc() which systematically adds
* targets to another vector to be deconfigured based on their related targets
* Upon completion of presentByAssoc(), this function iterates
* through the returned vector and deconfigures any targets marked
* for deconfiguration.
*/
void invokePresentByAssoc();
/**
* @brief Algorithm to check if a MCS has a MEMBUF, a MEMBUF has a MCS and DIMM,
* and a DIMM has a MEMBUF.
*
* The vector o_funcTargets is sorted by affinity path to allow a single pass
* with some backtracking to check every scenario more efficiently.
* These checks are needed because of scenarios where targets are non-present
* and their related targets are not marked as deconfigured
*
* @param[in/out] o_funcTargets A vector of functional MCS, MEMBUFS, DIMMS
* @param[in/out] o_targToDeconfig A vector of targets to deconfigure, done
* this way to allow unit tests
*/
void presentByAssoc(TargetInfoVector& o_funcTargets,
TargetInfoVector& o_targToDeconfig);
}; // end namespace
#endif
|
