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/import/chips/p9/procedures/hwp/perv/p9_sbe_check_master_stop15.C $ */
/* */
/* OpenPOWER sbe Project */
/* */
/* Contributors Listed Below - COPYRIGHT 2016,2018 */
/* [+] 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 p9_sbe_check_master_stop15.H
/// @brief Check if the targeted core (master) is fully in STOP15
///
// *HWP HWP Owner : Greg Still <stillgsg@us.ibm.com>
// *HWP FW Owner : Prem S Jha <premjha2@in.ibm.com>
// *HWP Team : PM
// *HWP Level : 3
// *HWP Consumed by : SBE
///
/// High-level procedure flow:
/// @verbatim
/// - Read the STOP History Register from the target core
/// - Return SUCCESS if::
/// - STOP_GATED is set (indicating it is not running)
/// - STOP_TRANSITION is COMPLETE (indicating it is stable)
/// - ACT_STOP_LEVEL is at the appropriate value (either 11 (0xB) or
/// 15 (0xF)
/// - Return PENDING if
/// - STOP_GATED is RUNNING
/// or
/// - STOP_GATED is GATED (indicating it is not running)
/// - STOP_TRANSITION is not COMPLETE (indicating transtion is progress)
/// - Return ERROR if
/// - STOP_GATED is set, STOP_TRANSITION is COMPLETE and ACT_STOP_LEVEL
/// is not appropriate
/// - Hardware access errors
/// @endverbatim
// -----------------------------------------------------------------------------
// Includes
// -----------------------------------------------------------------------------
#include <p9_sbe_check_master_stop15.H>
#include <p9_pm_stop_history.H>
#include <p9_quad_scom_addresses.H>
// -----------------------------------------------------------------------------
// Function definitions
// -----------------------------------------------------------------------------
// See .H for documentation
fapi2::ReturnCode p9_sbe_check_master_stop15(
const fapi2::Target<fapi2::TARGET_TYPE_CORE>& i_target)
{
FAPI_IMP("> p9_sbe_check_master_stop15");
fapi2::buffer<uint64_t> l_data64;
uint32_t l_stop_gated = 0;
uint32_t l_stop_transition = p9ssh::SSH_UNDEFINED;
uint32_t l_stop_requested_level = 0; // Running Level
uint32_t l_stop_actual_level = 0; // Running Level
#ifndef __PPE__
auto l_chip = i_target.getParent<fapi2::TARGET_TYPE_PROC_CHIP>();
auto l_ex = i_target.getParent<fapi2::TARGET_TYPE_EX>();
auto l_eq = i_target.getParent<fapi2::TARGET_TYPE_EQ>();
#endif
// Read the "Other" STOP History Register
FAPI_TRY(fapi2::getScom(i_target, C_PPM_SSHOTR, l_data64));
// Extract the field values
l_data64.extractToRight<p9ssh::STOP_GATED_START,
p9ssh::STOP_GATED_LEN>(l_stop_gated);
l_data64.extractToRight<p9ssh::STOP_TRANSITION_START,
p9ssh::STOP_TRANSITION_LEN>(l_stop_transition);
// Testing showed the above operation was sign extending into
// the l_stop_transition variable.
l_stop_transition &= 0x3;
l_data64.extractToRight<p9ssh::STOP_REQUESTED_LEVEL_START,
p9ssh::STOP_REQUESTED_LEVEL_LEN>(l_stop_requested_level);
l_data64.extractToRight<p9ssh::STOP_ACTUAL_LEVEL_START,
p9ssh::STOP_ACTUAL_LEVEL_LEN>(l_stop_actual_level);
#ifndef __PPE__
FAPI_DBG("GATED = %d; TRANSITION = %d (0x%X); REQUESTED_LEVEL = %d; ACTUAL_LEVEL = %d",
l_stop_gated,
l_stop_transition, l_stop_transition,
l_stop_requested_level,
l_stop_actual_level);
FAPI_DBG("SSH_RUNNING = %d; SSH_GATED = %d; SSH_COMPLETE = %d",
p9ssh::SSH_RUNNING,
p9ssh::SSH_GATED,
p9ssh::SSH_COMPLETE);
#endif
if (l_stop_gated == p9ssh::SSH_RUNNING ||
(l_stop_gated == p9ssh::SSH_GATED &&
l_stop_transition != p9ssh::SSH_COMPLETE))
{
#ifndef __PPE__
/* On non-SBE platforms, the RC is handled via regular FAPI_ASSERT */
FAPI_ASSERT(false,
fapi2::CHECK_MASTER_STOP15_PENDING ()
.set_PU(l_chip)
.set_EQ(l_eq)
.set_EX(l_ex)
.set_EC(i_target),
"Core still transitioning to STOP 15 ..");
#else
/*
* Don't use FAPI_ASSERT() here as this is a "try again" return code
* used inside a polling loop. We don't want to spam logs with something
* that's not an error really.
*/
return fapi2::RC_CHECK_MASTER_STOP15_PENDING;
#endif
}
if (l_stop_gated == p9ssh::SSH_GATED &&
l_stop_transition == p9ssh::SSH_COMPLETE &&
(l_stop_requested_level == 11 || l_stop_requested_level == 15))
{
FAPI_INF("SUCCESS!! Valid STOP entry state has been achieved.");
}
else
{
#ifndef __PPE__
/* On non-SBE platforms, the RC is handled via regular FAPI_ASSERT */
FAPI_ASSERT(false,
fapi2::CHECK_MASTER_STOP15_INVALID_STATE ()
.set_PU(l_chip)
.set_EQ(l_eq)
.set_EX(l_ex)
.set_EC(i_target),
"Core Failed entering STOP 15!");
#else
/*
* This is a fail code,however, FFDC should be collected via a separate
* call to p9_collect_deadman_ffdc. Avoiding FAPI_ASSERT() as an
* optimization
*/
return fapi2::RC_CHECK_MASTER_STOP15_INVALID_STATE;
#endif
}
fapi_try_exit:
FAPI_INF("< p9_sbe_check_master_stop15");
return fapi2::current_err;
} // END p9_sbe_check_master_stop15
|
