blob: 5d276f870d3f3d86d08814042503fffdbe4542ae (
plain)
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
|
/* IBM_PROLOG_BEGIN_TAG */
/* This is an automatically generated prolog. */
/* */
/* $Source: chips/p9/procedures/utils/stopreg/p9_stop_util.H $ */
/* */
/* IBM CONFIDENTIAL */
/* */
/* EKB Project */
/* */
/* COPYRIGHT 2015 */
/* [+] International Business Machines Corp. */
/* */
/* */
/* The source code for this program is not published or otherwise */
/* divested of its trade secrets, irrespective of what has been */
/* deposited with the U.S. Copyright Office. */
/* */
/* 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
#include "p9_stop_api.H"
#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
namespace stopImageSection
{
/**
* @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 start section of chip's HOMER image.
*/
typedef struct
{
uint64_t attnOpcodes;
uint64_t homerMagicNumber;
uint32_t buildDate;
uint32_t version;
uint8_t reserve[7];
uint8_t fuseModeStatus;
uint32_t cmeHcodeOffset;
uint32_t cmeHcodeLength;
uint32_t cmeCommonRingOffset;
uint32_t cmeCommonRingLength;
uint32_t cmePstateOffset;
uint32_t cmePstateLength;
} 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
};
/**
* @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 core id obtained from PIR.
* @param o_threadId thread id 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
|