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
|
/* IBM_PROLOG_BEGIN_TAG */
/* This is an automatically generated prolog. */
/* */
/* $Source: src/include/usr/isteps/pm/pm_common_ext.H $ */
/* */
/* OpenPOWER HostBoot Project */
/* */
/* Contributors Listed Below - COPYRIGHT 2016,2019 */
/* [+] 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 */
#ifndef PM_COMMON_EXT_H
#define PM_COMMON_EXT_H
#include <errl/errlentry.H>
namespace HBPM
{
/**
* @brief Host config data consumed by OCC
*/
struct occHostConfigDataArea_t
{
uint32_t version;
//For computation of timebase frequency
uint32_t nestFrequency;
// For determining the interrupt type to Host
// 0x00000000 = Use FSI2HOST Mailbox
// 0x00000001 = Use OCC interrupt line through PSIHB complex
uint32_t interruptType;
// For informing OCC if it is the FIR master:
// 0x00000000 = Default
// 0x00000001 = FIR Master
uint32_t firMaster;
// FIR collection configuration data needed by FIR Master
// OCC in the event of a checkstop
uint8_t firdataConfig[3072];
};
/**
* @brief Enumeration of the load PM complex mode
* LOAD
* - Call pm_reset first
* - Load OCC lid, write OCC config data, build Pstate
* Parameter Blocks, and load Hcode reference image lid
* RELOAD
* - Reload OCC lid, rewrite OCC config data, build Pstate
* Parameter Blocks, and rebuild Hcode
* UNKNOWN
* - Unknown PM load type, do not load OCC/HCODE
*/
enum loadPmMode
{
PM_LOAD = 0x0,
PM_RELOAD = 0x1,
PM_UNKNOWN = 0xFF,
};
/**
* @brief Enumeration of the HOMER_HCODE_LOADED attribute
*
*/
enum loadHCODE
{
HCODE_NOT_LOADED = 0x0,
HCODE_LOADED = 0x1,
};
/**
* @brief Enumeration of the attribute
*
*/
enum resetOptions_t
{
RESET_HW = 0x1,
CLEAR_ATTRIBUTES = 0x2,
RESET_AND_CLEAR_ATTRIBUTES = (RESET_HW | CLEAR_ATTRIBUTES),
};
/**
* @brief Convert HOMER physical address space to a vitual address
* @param[in] i_proc_target Processsor target
* @param[in] i_phys_addr Physical address
* @return NULL on error, else virtual address
*/
void *convertHomerPhysToVirt( TARGETING::Target* i_proc_target,
uint64_t i_phys_addr);
/**
* @brief Load and start PM Complex for all proc targets.
*
* @param[in] i_mode Load / Reload
* @param[out] o_failTarget Failing proc target
*
* @return errlHndl_t Error log of loadAndStartPMAll failed
*/
errlHndl_t loadAndStartPMAll( loadPmMode i_mode,
TARGETING::Target* & o_proc_target);
/**
* @brief Reset PM Complex for all proc targets.
*
* @param[in] i_opt Option to reset HW, attributes, or both
* @param[in] i_skip_fir_attr_reset optin to skip this attribute
* ATTR_PM_FIRINIT_DONE_ONCE_FLAG to reset the value to 0
*
* @return errlHndl_t Error log if resetPMAll failed
*/
errlHndl_t resetPMAll( resetOptions_t i_opt = RESET_HW ,uint8_t
i_skip_fir_attr_reset = 0);
/**
* @brief Verify all OCCs at checkpoint.
*
* @return errlHndl_t Error log if verifyOccChkptAll failed
*/
errlHndl_t verifyOccChkptAll();
/**
* @brief Fetch the ring overrides (if they exist)
*
* @param[inout] io_overrideImg NULL if image not in PNOR or is blank,
* else pointer to override data
*
* @return errlHndl_t Error log if resetPMAll failed
*/
errlHndl_t getRingOvd(void*& io_overrideImg);
} //namespace HBPM ends
#if __HOSTBOOT_RUNTIME
namespace RTPM
{
/**
* @brief Modify the SCOM restore section of the HCODE image with the
* given register data
* @param i_section Runtime section to update
* (passthru to pore_gen_scom)
* @param i_operation Type of operation to perform
* (passthru to pore_gen_scom)
* @param i_target Target owning the scom address
* @param i_rel_scom_addr Fully qualified scom address
* @param i_scom_data Data for operation
* @return errlHndl_t
*/
errlHndl_t hcode_update( uint32_t i_section,
uint32_t i_operation,
TARGETING::Target* i_target,
uint64_t i_rel_scom_addr,
uint64_t i_scom_data );
} //namespace RTPM ends
#endif
#endif
|