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
|
/* 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 */
/* [+] 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 : Bilicon Patil <bilpatil@in.ibm.com>
// *HWP Team : PM
// *HWP Level : 2
// *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
// 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))
{
FAPI_ASSERT(false,
fapi2::CHECK_MASTER_STOP15_PENDING(),
"STOP 15 is still pending")
}
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
{
FAPI_ASSERT(false,
fapi2::CHECK_MASTER_STOP15_INVALID_STATE()
.set_STOP_HISTORY(l_data64),
"STOP 15 error");
}
// @todo RTC 162331 These should work but don't..... follow-up later
// // Check for valid pending condition (which includes running)
// FAPI_ASSERT((l_stop_gated == p9ssh::SSH_RUNNING ||
// (l_stop_gated == p9ssh::SSH_GATED &&
// l_stop_transition != p9ssh::SSH_COMPLETE)),
// fapi2::CHECK_MASTER_STOP15_PENDING(),
// "STOP 15 is still pending");
// // Assert gated, completion and the proper STOP actual level. If not, something is off.
// FAPI_ASSERT((l_stop_gated == p9ssh::SSH_GATED &&
// l_stop_transition == p9ssh::SSH_COMPLETE &&
// (l_stop_actual_level == 11 || l_stop_actual_level == 15)),
// fapi2::CHECK_MASTER_STOP15_INVALID_STATE()
// .set_STOP_HISTORY(l_data64),
// } "STOP 15 error");
fapi_try_exit:
FAPI_INF("< p9_sbe_check_master_stop15");
return fapi2::current_err;
} // END p9_sbe_check_master_stop15
|
