xref: /qemu/include/hw/ppc/xive2_regs.h (revision 5fc9c717)
1 /*
2  * QEMU PowerPC XIVE2 internal structure definitions (POWER10)
3  *
4  * Copyright (c) 2019-2022, IBM Corporation.
5  *
6  * This code is licensed under the GPL version 2 or later. See the
7  * COPYING file in the top-level directory.
8  */
9 
10 #ifndef PPC_XIVE2_REGS_H
11 #define PPC_XIVE2_REGS_H
12 
13 #include "qemu/bswap.h"
14 
15 /*
16  * Thread Interrupt Management Area (TIMA)
17  *
18  * In Gen1 mode (P9 compat mode) word 2 is the same. However in Gen2
19  * mode (P10), the CAM line is slightly different as the VP space was
20  * increased.
21  */
22 #define   TM2_QW0W2_VU           PPC_BIT32(0)
23 #define   TM2_QW0W2_LOGIC_SERV   PPC_BITMASK32(4, 31)
24 #define   TM2_QW1W2_VO           PPC_BIT32(0)
25 #define   TM2_QW1W2_HO           PPC_BIT32(1)
26 #define   TM2_QW1W2_OS_CAM       PPC_BITMASK32(4, 31)
27 #define   TM2_QW2W2_VP           PPC_BIT32(0)
28 #define   TM2_QW2W2_HP           PPC_BIT32(1)
29 #define   TM2_QW2W2_POOL_CAM     PPC_BITMASK32(4, 31)
30 #define   TM2_QW3W2_VT           PPC_BIT32(0)
31 #define   TM2_QW3W2_HT           PPC_BIT32(1)
32 #define   TM2_QW3W2_LP           PPC_BIT32(6)
33 #define   TM2_QW3W2_LE           PPC_BIT32(7)
34 
35 /*
36  * Event Assignment Structure (EAS)
37  */
38 
39 typedef struct Xive2Eas {
40         uint64_t       w;
41 #define EAS2_VALID                 PPC_BIT(0)
42 #define EAS2_END_BLOCK             PPC_BITMASK(4, 7) /* Destination EQ block# */
43 #define EAS2_END_INDEX             PPC_BITMASK(8, 31) /* Destination EQ index */
44 #define EAS2_MASKED                PPC_BIT(32) /* Masked                 */
45 #define EAS2_END_DATA              PPC_BITMASK(33, 63) /* written to the EQ */
46 } Xive2Eas;
47 
48 #define xive2_eas_is_valid(eas)   (be64_to_cpu((eas)->w) & EAS2_VALID)
49 #define xive2_eas_is_masked(eas)  (be64_to_cpu((eas)->w) & EAS2_MASKED)
50 
51 void xive2_eas_pic_print_info(Xive2Eas *eas, uint32_t lisn, GString *buf);
52 
53 /*
54  * Event Notifification Descriptor (END)
55  */
56 
57 typedef struct Xive2End {
58         uint32_t       w0;
59 #define END2_W0_VALID              PPC_BIT32(0) /* "v" bit */
60 #define END2_W0_ENQUEUE            PPC_BIT32(5) /* "q" bit */
61 #define END2_W0_UCOND_NOTIFY       PPC_BIT32(6) /* "n" bit */
62 #define END2_W0_SILENT_ESCALATE    PPC_BIT32(7) /* "s" bit */
63 #define END2_W0_BACKLOG            PPC_BIT32(8) /* "b" bit */
64 #define END2_W0_PRECL_ESC_CTL      PPC_BIT32(9) /* "p" bit */
65 #define END2_W0_UNCOND_ESCALATE    PPC_BIT32(10) /* "u" bit */
66 #define END2_W0_ESCALATE_CTL       PPC_BIT32(11) /* "e" bit */
67 #define END2_W0_ADAPTIVE_ESC       PPC_BIT32(12) /* "a" bit */
68 #define END2_W0_ESCALATE_END       PPC_BIT32(13) /* "N" bit */
69 #define END2_W0_FIRMWARE1          PPC_BIT32(16) /* Owned by FW */
70 #define END2_W0_FIRMWARE2          PPC_BIT32(17) /* Owned by FW */
71 #define END2_W0_AEC_SIZE           PPC_BITMASK32(18, 19)
72 #define END2_W0_AEG_SIZE           PPC_BITMASK32(20, 23)
73 #define END2_W0_EQ_VG_PREDICT      PPC_BITMASK32(24, 31) /* Owned by HW */
74         uint32_t       w1;
75 #define END2_W1_ESn                PPC_BITMASK32(0, 1)
76 #define END2_W1_ESn_P              PPC_BIT32(0)
77 #define END2_W1_ESn_Q              PPC_BIT32(1)
78 #define END2_W1_ESe                PPC_BITMASK32(2, 3)
79 #define END2_W1_ESe_P              PPC_BIT32(2)
80 #define END2_W1_ESe_Q              PPC_BIT32(3)
81 #define END2_W1_GEN_FLIPPED        PPC_BIT32(8)
82 #define END2_W1_GENERATION         PPC_BIT32(9)
83 #define END2_W1_PAGE_OFF           PPC_BITMASK32(10, 31)
84         uint32_t       w2;
85 #define END2_W2_RESERVED           PPC_BITMASK32(4, 7)
86 #define END2_W2_EQ_ADDR_HI         PPC_BITMASK32(8, 31)
87         uint32_t       w3;
88 #define END2_W3_EQ_ADDR_LO         PPC_BITMASK32(0, 24)
89 #define END2_W3_QSIZE              PPC_BITMASK32(28, 31)
90         uint32_t       w4;
91 #define END2_W4_END_BLOCK          PPC_BITMASK32(4, 7)
92 #define END2_W4_ESC_END_INDEX      PPC_BITMASK32(8, 31)
93 #define END2_W4_ESB_BLOCK          PPC_BITMASK32(0, 3)
94 #define END2_W4_ESC_ESB_INDEX      PPC_BITMASK32(4, 31)
95         uint32_t       w5;
96 #define END2_W5_ESC_END_DATA       PPC_BITMASK32(1, 31)
97         uint32_t       w6;
98 #define END2_W6_FORMAT_BIT         PPC_BIT32(0)
99 #define END2_W6_IGNORE             PPC_BIT32(1)
100 #define END2_W6_CROWD              PPC_BIT32(2)
101 #define END2_W6_VP_BLOCK           PPC_BITMASK32(4, 7)
102 #define END2_W6_VP_OFFSET          PPC_BITMASK32(8, 31)
103 #define END2_W6_VP_OFFSET_GEN1     PPC_BITMASK32(13, 31)
104         uint32_t       w7;
105 #define END2_W7_TOPO               PPC_BITMASK32(0, 3) /* Owned by HW */
106 #define END2_W7_F0_PRIORITY        PPC_BITMASK32(8, 15)
107 #define END2_W7_F1_LOG_SERVER_ID   PPC_BITMASK32(4, 31)
108 } Xive2End;
109 
110 #define xive2_end_is_valid(end)    (be32_to_cpu((end)->w0) & END2_W0_VALID)
111 #define xive2_end_is_enqueue(end)  (be32_to_cpu((end)->w0) & END2_W0_ENQUEUE)
112 #define xive2_end_is_notify(end)                \
113     (be32_to_cpu((end)->w0) & END2_W0_UCOND_NOTIFY)
114 #define xive2_end_is_backlog(end)  (be32_to_cpu((end)->w0) & END2_W0_BACKLOG)
115 #define xive2_end_is_precluded_escalation(end)          \
116     (be32_to_cpu((end)->w0) & END2_W0_PRECL_ESC_CTL)
117 #define xive2_end_is_escalate(end)                      \
118     (be32_to_cpu((end)->w0) & END2_W0_ESCALATE_CTL)
119 #define xive2_end_is_uncond_escalation(end)              \
120     (be32_to_cpu((end)->w0) & END2_W0_UNCOND_ESCALATE)
121 #define xive2_end_is_silent_escalation(end)              \
122     (be32_to_cpu((end)->w0) & END2_W0_SILENT_ESCALATE)
123 #define xive2_end_is_escalate_end(end)              \
124     (be32_to_cpu((end)->w0) & END2_W0_ESCALATE_END)
125 #define xive2_end_is_firmware1(end)              \
126     (be32_to_cpu((end)->w0) & END2_W0_FIRMWARE1)
127 #define xive2_end_is_firmware2(end)              \
128     (be32_to_cpu((end)->w0) & END2_W0_FIRMWARE2)
129 #define xive2_end_is_ignore(end)                \
130     (be32_to_cpu((end)->w6) & END2_W6_IGNORE)
131 #define xive2_end_is_crowd(end)                 \
132     (be32_to_cpu((end)->w6) & END2_W6_CROWD)
133 
xive2_end_qaddr(Xive2End * end)134 static inline uint64_t xive2_end_qaddr(Xive2End *end)
135 {
136     return ((uint64_t) be32_to_cpu(end->w2) & END2_W2_EQ_ADDR_HI) << 32 |
137         (be32_to_cpu(end->w3) & END2_W3_EQ_ADDR_LO);
138 }
139 
140 void xive2_end_pic_print_info(Xive2End *end, uint32_t end_idx, GString *buf);
141 void xive2_end_queue_pic_print_info(Xive2End *end, uint32_t width,
142                                     GString *buf);
143 void xive2_end_eas_pic_print_info(Xive2End *end, uint32_t end_idx,
144                                   GString *buf);
145 
146 /*
147  * Notification Virtual Processor (NVP)
148  */
149 typedef struct Xive2Nvp {
150         uint32_t       w0;
151 #define NVP2_W0_VALID              PPC_BIT32(0)
152 #define NVP2_W0_HW                 PPC_BIT32(7)
153 #define NVP2_W0_ESC_END            PPC_BIT32(25) /* 'N' bit 0:ESB  1:END */
154         uint32_t       w1;
155 #define NVP2_W1_CO                 PPC_BIT32(13)
156 #define NVP2_W1_CO_PRIV            PPC_BITMASK32(14, 15)
157 #define NVP2_W1_CO_THRID_VALID     PPC_BIT32(16)
158 #define NVP2_W1_CO_THRID           PPC_BITMASK32(17, 31)
159         uint32_t       w2;
160 #define NVP2_W2_CPPR               PPC_BITMASK32(0, 7)
161 #define NVP2_W2_IPB                PPC_BITMASK32(8, 15)
162 #define NVP2_W2_LSMFB              PPC_BITMASK32(16, 23)
163         uint32_t       w3;
164         uint32_t       w4;
165 #define NVP2_W4_ESC_ESB_BLOCK      PPC_BITMASK32(0, 3)  /* N:0 */
166 #define NVP2_W4_ESC_ESB_INDEX      PPC_BITMASK32(4, 31) /* N:0 */
167 #define NVP2_W4_ESC_END_BLOCK      PPC_BITMASK32(4, 7)  /* N:1 */
168 #define NVP2_W4_ESC_END_INDEX      PPC_BITMASK32(8, 31) /* N:1 */
169         uint32_t       w5;
170 #define NVP2_W5_PSIZE              PPC_BITMASK32(0, 1)
171 #define NVP2_W5_VP_END_BLOCK       PPC_BITMASK32(4, 7)
172 #define NVP2_W5_VP_END_INDEX       PPC_BITMASK32(8, 31)
173         uint32_t       w6;
174         uint32_t       w7;
175 } Xive2Nvp;
176 
177 #define xive2_nvp_is_valid(nvp)    (be32_to_cpu((nvp)->w0) & NVP2_W0_VALID)
178 #define xive2_nvp_is_hw(nvp)       (be32_to_cpu((nvp)->w0) & NVP2_W0_HW)
179 #define xive2_nvp_is_co(nvp)       (be32_to_cpu((nvp)->w1) & NVP2_W1_CO)
180 
181 /*
182  * The VP number space in a block is defined by the END2_W6_VP_OFFSET
183  * field of the XIVE END. When running in Gen1 mode (P9 compat mode),
184  * the VP space is reduced to (1 << 19) VPs per block
185  */
186 #define XIVE2_NVP_SHIFT              24
187 #define XIVE2_NVP_COUNT              (1 << XIVE2_NVP_SHIFT)
188 
xive2_nvp_cam_line(uint8_t nvp_blk,uint32_t nvp_idx)189 static inline uint32_t xive2_nvp_cam_line(uint8_t nvp_blk, uint32_t nvp_idx)
190 {
191     return (nvp_blk << XIVE2_NVP_SHIFT) | nvp_idx;
192 }
193 
xive2_nvp_idx(uint32_t cam_line)194 static inline uint32_t xive2_nvp_idx(uint32_t cam_line)
195 {
196     return cam_line & ((1 << XIVE2_NVP_SHIFT) - 1);
197 }
198 
xive2_nvp_blk(uint32_t cam_line)199 static inline uint32_t xive2_nvp_blk(uint32_t cam_line)
200 {
201     return (cam_line >> XIVE2_NVP_SHIFT) & 0xf;
202 }
203 
204 void xive2_nvp_pic_print_info(Xive2Nvp *nvp, uint32_t nvp_idx, GString *buf);
205 
206 /*
207  * Notification Virtual Group or Crowd (NVG/NVC)
208  */
209 typedef struct Xive2Nvgc {
210         uint32_t        w0;
211 #define NVGC2_W0_VALID             PPC_BIT32(0)
212         uint32_t        w1;
213         uint32_t        w2;
214         uint32_t        w3;
215         uint32_t        w4;
216         uint32_t        w5;
217         uint32_t        w6;
218         uint32_t        w7;
219 } Xive2Nvgc;
220 
221 #endif /* PPC_XIVE2_REGS_H */
222