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
|
/* IBM_PROLOG_BEGIN_TAG */
/* This is an automatically generated prolog. */
/* */
/* $Source: src/import/chips/p9/procedures/hwp/lib/p9_stop_util.H $ */
/* */
/* OpenPOWER HostBoot 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 */
#ifndef __P9_STOP_UTIL_
#define __P9_STOP_UTIL_
#ifdef __HOS_AIX__
#define __BYTE_ORDER __BIG_ENDIAN
#else
#include <endian.h>
#endif
#ifndef __PPE_PLAT
#include "p9_stop_api.H"
#endif
#ifdef FAPI_2
#include <fapi2.H>
#endif
///
/// @file p9_stop_util.H
/// @brief describes some utilty functions for STOP API.
///
// *HWP HW Owner : Greg Still <stillgs@us.ibm.com>
// *HWP FW Owner : Prem Shanker Jha <premjha2@in.ibm.com>
// *HWP Team : PM
// *HWP Level : 2
// *HWP Consumed by : HB:HYP
#ifndef __PPE_PLAT
namespace stopImageSection
{
#endif //__PPE_PLAT
/**
* @brief helper function to swizzle given input data
* @note swizles bytes to handle endianess issue.
*/
#if( __BYTE_ORDER == __BIG_ENDIAN )
// NOP if it is a big endian system
#define SWIZZLE_2_BYTE(WORD) WORD
#define SWIZZLE_4_BYTE(WORD) WORD
#define SWIZZLE_8_BYTE(WORD) WORD
#else
#define SWIZZLE_2_BYTE(WORD) \
( (((WORD) >> 8) & 0x00FF) | (((WORD) << 8) & 0xFF00) )
#define SWIZZLE_4_BYTE(WORD) \
( (((WORD) >> 24) & 0x000000FF) | (((WORD) >> 8) & 0x0000FF00) | \
(((WORD) << 8) & 0x00FF0000) | (((WORD) << 24) & 0xFF000000) )
#define SWIZZLE_8_BYTE(WORD) \
( (((WORD) >> 56) & 0x00000000000000FF) | \
(((WORD) >> 40) & 0x000000000000FF00)| \
(((WORD) >> 24) & 0x0000000000FF0000) | \
(((WORD) >> 8) & 0x00000000FF000000) | \
(((WORD) << 8) & 0x000000FF00000000) | \
(((WORD) << 24) & 0x0000FF0000000000) | \
(((WORD) << 40) & 0x00FF000000000000) | \
(((WORD) << 56) & 0xFF00000000000000) )
#endif
/**
* @brief describes details of CPMR header in HOMER.
*/
typedef struct
{
uint64_t attnOpcodes;
uint64_t homerMagicNumber;
uint32_t buildDate;
uint32_t version;
uint8_t reserve1[7];
uint8_t fuseModeStatus;
uint32_t cmeImgOffset;
uint32_t cmeImgLength;
uint32_t cmeCommonRingOffset;
uint32_t cmeCommonRingLength;
uint32_t cmePstateOffset;
uint32_t cmePstateLength;
uint32_t coreSpecRingOffset;
uint32_t coreSpecRingLen;
uint32_t coreScomOffset;
uint32_t coreScomLength;
uint32_t reserve2[184];
} HomerImgDesc_t;
/**
* @brief enumerates bit(s) positions of interest for PIR.
*/
enum
{
FUSE_BIT0 = 0x08,
FUSE_BIT1 = 0x04,
FUSE_BIT2 = 0x02,
FUSE_BIT3 = 0x01,
QUAD_BITS = 0x70
};
#ifndef __PPE_PLAT
/**
* @brief returns core id and thread id by parsing a given PIR.
* @param i_pStopImage points to STOP image associated with a proc chip.
* @param i_pir PIR associated with a core's thread.
* @param o_coreId points to core id value obtained from PIR.
* @param o_threadId points to thread id value obtained from PIR.
* @return SUCCESS if function suceeds, error code otherwise.
*/
StopReturnCode_t getCoreAndThread( void* const i_pStopImage,
const uint64_t i_pir,
uint32_t* o_coreId,
uint32_t* o_threadId );
} // namespace stopImageSection ends
#endif //__PPE_PLAT
#endif
|
