xref: /openbmc/qemu/hw/intc/gicv3_internal.h (revision c694cb4cada0cd6c646f704e868072bbd4f55798)
1 /*
2  * ARM GICv3 support - internal interfaces
3  *
4  * Copyright (c) 2012 Linaro Limited
5  * Copyright (c) 2015 Huawei.
6  * Copyright (c) 2015 Samsung Electronics Co., Ltd.
7  * Written by Peter Maydell
8  * Reworked for GICv3 by Shlomo Pongratz and Pavel Fedin
9  *
10  * This program is free software; you can redistribute it and/or modify
11  * it under the terms of the GNU General Public License as published by
12  * the Free Software Foundation, either version 2 of the License, or
13  * (at your option) any later version.
14  *
15  * This program is distributed in the hope that it will be useful,
16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
18  * GNU General Public License for more details.
19  *
20  * You should have received a copy of the GNU General Public License along
21  * with this program; if not, see <http://www.gnu.org/licenses/>.
22  */
23 
24 #ifndef QEMU_ARM_GICV3_INTERNAL_H
25 #define QEMU_ARM_GICV3_INTERNAL_H
26 
27 #include "hw/registerfields.h"
28 #include "hw/intc/arm_gicv3_common.h"
29 
30 /* Distributor registers, as offsets from the distributor base address */
31 #define GICD_CTLR            0x0000
32 #define GICD_TYPER           0x0004
33 #define GICD_IIDR            0x0008
34 #define GICD_STATUSR         0x0010
35 #define GICD_SETSPI_NSR      0x0040
36 #define GICD_CLRSPI_NSR      0x0048
37 #define GICD_SETSPI_SR       0x0050
38 #define GICD_CLRSPI_SR       0x0058
39 #define GICD_SEIR            0x0068
40 #define GICD_IGROUPR         0x0080
41 #define GICD_ISENABLER       0x0100
42 #define GICD_ICENABLER       0x0180
43 #define GICD_ISPENDR         0x0200
44 #define GICD_ICPENDR         0x0280
45 #define GICD_ISACTIVER       0x0300
46 #define GICD_ICACTIVER       0x0380
47 #define GICD_IPRIORITYR      0x0400
48 #define GICD_ITARGETSR       0x0800
49 #define GICD_ICFGR           0x0C00
50 #define GICD_IGRPMODR        0x0D00
51 #define GICD_NSACR           0x0E00
52 #define GICD_SGIR            0x0F00
53 #define GICD_CPENDSGIR       0x0F10
54 #define GICD_SPENDSGIR       0x0F20
55 #define GICD_IROUTER         0x6000
56 #define GICD_IDREGS          0xFFD0
57 
58 /* GICD_CTLR fields  */
59 #define GICD_CTLR_EN_GRP0           (1U << 0)
60 #define GICD_CTLR_EN_GRP1NS         (1U << 1) /* GICv3 5.3.20 */
61 #define GICD_CTLR_EN_GRP1S          (1U << 2)
62 #define GICD_CTLR_EN_GRP1_ALL       (GICD_CTLR_EN_GRP1NS | GICD_CTLR_EN_GRP1S)
63 /* Bit 4 is ARE if the system doesn't support TrustZone, ARE_S otherwise */
64 #define GICD_CTLR_ARE               (1U << 4)
65 #define GICD_CTLR_ARE_S             (1U << 4)
66 #define GICD_CTLR_ARE_NS            (1U << 5)
67 #define GICD_CTLR_DS                (1U << 6)
68 #define GICD_CTLR_E1NWF             (1U << 7)
69 #define GICD_CTLR_RWP               (1U << 31)
70 
71 /* 16 bits EventId */
72 #define GICD_TYPER_IDBITS            0xf
73 
74 /*
75  * Redistributor frame offsets from RD_base
76  */
77 #define GICR_SGI_OFFSET 0x10000
78 
79 /*
80  * Redistributor registers, offsets from RD_base
81  */
82 #define GICR_CTLR             0x0000
83 #define GICR_IIDR             0x0004
84 #define GICR_TYPER            0x0008
85 #define GICR_STATUSR          0x0010
86 #define GICR_WAKER            0x0014
87 #define GICR_SETLPIR          0x0040
88 #define GICR_CLRLPIR          0x0048
89 #define GICR_PROPBASER        0x0070
90 #define GICR_PENDBASER        0x0078
91 #define GICR_INVLPIR          0x00A0
92 #define GICR_INVALLR          0x00B0
93 #define GICR_SYNCR            0x00C0
94 #define GICR_IDREGS           0xFFD0
95 
96 /* SGI and PPI Redistributor registers, offsets from RD_base */
97 #define GICR_IGROUPR0         (GICR_SGI_OFFSET + 0x0080)
98 #define GICR_ISENABLER0       (GICR_SGI_OFFSET + 0x0100)
99 #define GICR_ICENABLER0       (GICR_SGI_OFFSET + 0x0180)
100 #define GICR_ISPENDR0         (GICR_SGI_OFFSET + 0x0200)
101 #define GICR_ICPENDR0         (GICR_SGI_OFFSET + 0x0280)
102 #define GICR_ISACTIVER0       (GICR_SGI_OFFSET + 0x0300)
103 #define GICR_ICACTIVER0       (GICR_SGI_OFFSET + 0x0380)
104 #define GICR_IPRIORITYR       (GICR_SGI_OFFSET + 0x0400)
105 #define GICR_ICFGR0           (GICR_SGI_OFFSET + 0x0C00)
106 #define GICR_ICFGR1           (GICR_SGI_OFFSET + 0x0C04)
107 #define GICR_IGRPMODR0        (GICR_SGI_OFFSET + 0x0D00)
108 #define GICR_NSACR            (GICR_SGI_OFFSET + 0x0E00)
109 
110 #define GICR_CTLR_ENABLE_LPIS        (1U << 0)
111 #define GICR_CTLR_RWP                (1U << 3)
112 #define GICR_CTLR_DPG0               (1U << 24)
113 #define GICR_CTLR_DPG1NS             (1U << 25)
114 #define GICR_CTLR_DPG1S              (1U << 26)
115 #define GICR_CTLR_UWP                (1U << 31)
116 
117 #define GICR_TYPER_PLPIS             (1U << 0)
118 #define GICR_TYPER_VLPIS             (1U << 1)
119 #define GICR_TYPER_DIRECTLPI         (1U << 3)
120 #define GICR_TYPER_LAST              (1U << 4)
121 #define GICR_TYPER_DPGS              (1U << 5)
122 #define GICR_TYPER_PROCNUM           (0xFFFFU << 8)
123 #define GICR_TYPER_COMMONLPIAFF      (0x3 << 24)
124 #define GICR_TYPER_AFFINITYVALUE     (0xFFFFFFFFULL << 32)
125 
126 #define GICR_WAKER_ProcessorSleep    (1U << 1)
127 #define GICR_WAKER_ChildrenAsleep    (1U << 2)
128 
129 FIELD(GICR_PROPBASER, IDBITS, 0, 5)
130 FIELD(GICR_PROPBASER, INNERCACHE, 7, 3)
131 FIELD(GICR_PROPBASER, SHAREABILITY, 10, 2)
132 FIELD(GICR_PROPBASER, PHYADDR, 12, 40)
133 FIELD(GICR_PROPBASER, OUTERCACHE, 56, 3)
134 
135 FIELD(GICR_PENDBASER, INNERCACHE, 7, 3)
136 FIELD(GICR_PENDBASER, SHAREABILITY, 10, 2)
137 FIELD(GICR_PENDBASER, PHYADDR, 16, 36)
138 FIELD(GICR_PENDBASER, OUTERCACHE, 56, 3)
139 FIELD(GICR_PENDBASER, PTZ, 62, 1)
140 
141 #define ICC_CTLR_EL1_CBPR           (1U << 0)
142 #define ICC_CTLR_EL1_EOIMODE        (1U << 1)
143 #define ICC_CTLR_EL1_PMHE           (1U << 6)
144 #define ICC_CTLR_EL1_PRIBITS_SHIFT 8
145 #define ICC_CTLR_EL1_PRIBITS_MASK   (7U << ICC_CTLR_EL1_PRIBITS_SHIFT)
146 #define ICC_CTLR_EL1_IDBITS_SHIFT 11
147 #define ICC_CTLR_EL1_SEIS           (1U << 14)
148 #define ICC_CTLR_EL1_A3V            (1U << 15)
149 
150 #define ICC_PMR_PRIORITY_MASK    0xff
151 #define ICC_BPR_BINARYPOINT_MASK 0x07
152 #define ICC_IGRPEN_ENABLE        0x01
153 
154 #define ICC_CTLR_EL3_CBPR_EL1S (1U << 0)
155 #define ICC_CTLR_EL3_CBPR_EL1NS (1U << 1)
156 #define ICC_CTLR_EL3_EOIMODE_EL3 (1U << 2)
157 #define ICC_CTLR_EL3_EOIMODE_EL1S (1U << 3)
158 #define ICC_CTLR_EL3_EOIMODE_EL1NS (1U << 4)
159 #define ICC_CTLR_EL3_RM (1U << 5)
160 #define ICC_CTLR_EL3_PMHE (1U << 6)
161 #define ICC_CTLR_EL3_PRIBITS_SHIFT 8
162 #define ICC_CTLR_EL3_IDBITS_SHIFT 11
163 #define ICC_CTLR_EL3_SEIS (1U << 14)
164 #define ICC_CTLR_EL3_A3V (1U << 15)
165 #define ICC_CTLR_EL3_NDS (1U << 17)
166 
167 #define ICH_VMCR_EL2_VENG0_SHIFT 0
168 #define ICH_VMCR_EL2_VENG0 (1U << ICH_VMCR_EL2_VENG0_SHIFT)
169 #define ICH_VMCR_EL2_VENG1_SHIFT 1
170 #define ICH_VMCR_EL2_VENG1 (1U << ICH_VMCR_EL2_VENG1_SHIFT)
171 #define ICH_VMCR_EL2_VACKCTL (1U << 2)
172 #define ICH_VMCR_EL2_VFIQEN (1U << 3)
173 #define ICH_VMCR_EL2_VCBPR_SHIFT 4
174 #define ICH_VMCR_EL2_VCBPR (1U << ICH_VMCR_EL2_VCBPR_SHIFT)
175 #define ICH_VMCR_EL2_VEOIM_SHIFT 9
176 #define ICH_VMCR_EL2_VEOIM (1U << ICH_VMCR_EL2_VEOIM_SHIFT)
177 #define ICH_VMCR_EL2_VBPR1_SHIFT 18
178 #define ICH_VMCR_EL2_VBPR1_LENGTH 3
179 #define ICH_VMCR_EL2_VBPR1_MASK (0x7U << ICH_VMCR_EL2_VBPR1_SHIFT)
180 #define ICH_VMCR_EL2_VBPR0_SHIFT 21
181 #define ICH_VMCR_EL2_VBPR0_LENGTH 3
182 #define ICH_VMCR_EL2_VBPR0_MASK (0x7U << ICH_VMCR_EL2_VBPR0_SHIFT)
183 #define ICH_VMCR_EL2_VPMR_SHIFT 24
184 #define ICH_VMCR_EL2_VPMR_LENGTH 8
185 #define ICH_VMCR_EL2_VPMR_MASK (0xffU << ICH_VMCR_EL2_VPMR_SHIFT)
186 
187 #define ICH_HCR_EL2_EN (1U << 0)
188 #define ICH_HCR_EL2_UIE (1U << 1)
189 #define ICH_HCR_EL2_LRENPIE (1U << 2)
190 #define ICH_HCR_EL2_NPIE (1U << 3)
191 #define ICH_HCR_EL2_VGRP0EIE (1U << 4)
192 #define ICH_HCR_EL2_VGRP0DIE (1U << 5)
193 #define ICH_HCR_EL2_VGRP1EIE (1U << 6)
194 #define ICH_HCR_EL2_VGRP1DIE (1U << 7)
195 #define ICH_HCR_EL2_TC (1U << 10)
196 #define ICH_HCR_EL2_TALL0 (1U << 11)
197 #define ICH_HCR_EL2_TALL1 (1U << 12)
198 #define ICH_HCR_EL2_TSEI (1U << 13)
199 #define ICH_HCR_EL2_TDIR (1U << 14)
200 #define ICH_HCR_EL2_EOICOUNT_SHIFT 27
201 #define ICH_HCR_EL2_EOICOUNT_LENGTH 5
202 #define ICH_HCR_EL2_EOICOUNT_MASK (0x1fU << ICH_HCR_EL2_EOICOUNT_SHIFT)
203 
204 #define ICH_LR_EL2_VINTID_SHIFT 0
205 #define ICH_LR_EL2_VINTID_LENGTH 32
206 #define ICH_LR_EL2_VINTID_MASK (0xffffffffULL << ICH_LR_EL2_VINTID_SHIFT)
207 #define ICH_LR_EL2_PINTID_SHIFT 32
208 #define ICH_LR_EL2_PINTID_LENGTH 10
209 #define ICH_LR_EL2_PINTID_MASK (0x3ffULL << ICH_LR_EL2_PINTID_SHIFT)
210 /* Note that EOI shares with the top bit of the pINTID field */
211 #define ICH_LR_EL2_EOI (1ULL << 41)
212 #define ICH_LR_EL2_PRIORITY_SHIFT 48
213 #define ICH_LR_EL2_PRIORITY_LENGTH 8
214 #define ICH_LR_EL2_PRIORITY_MASK (0xffULL << ICH_LR_EL2_PRIORITY_SHIFT)
215 #define ICH_LR_EL2_GROUP (1ULL << 60)
216 #define ICH_LR_EL2_HW (1ULL << 61)
217 #define ICH_LR_EL2_STATE_SHIFT 62
218 #define ICH_LR_EL2_STATE_LENGTH 2
219 #define ICH_LR_EL2_STATE_MASK (3ULL << ICH_LR_EL2_STATE_SHIFT)
220 /* values for the state field: */
221 #define ICH_LR_EL2_STATE_INVALID 0
222 #define ICH_LR_EL2_STATE_PENDING 1
223 #define ICH_LR_EL2_STATE_ACTIVE 2
224 #define ICH_LR_EL2_STATE_ACTIVE_PENDING 3
225 #define ICH_LR_EL2_STATE_PENDING_BIT (1ULL << ICH_LR_EL2_STATE_SHIFT)
226 #define ICH_LR_EL2_STATE_ACTIVE_BIT (2ULL << ICH_LR_EL2_STATE_SHIFT)
227 
228 #define ICH_MISR_EL2_EOI (1U << 0)
229 #define ICH_MISR_EL2_U (1U << 1)
230 #define ICH_MISR_EL2_LRENP (1U << 2)
231 #define ICH_MISR_EL2_NP (1U << 3)
232 #define ICH_MISR_EL2_VGRP0E (1U << 4)
233 #define ICH_MISR_EL2_VGRP0D (1U << 5)
234 #define ICH_MISR_EL2_VGRP1E (1U << 6)
235 #define ICH_MISR_EL2_VGRP1D (1U << 7)
236 
237 #define ICH_VTR_EL2_LISTREGS_SHIFT 0
238 #define ICH_VTR_EL2_TDS (1U << 19)
239 #define ICH_VTR_EL2_NV4 (1U << 20)
240 #define ICH_VTR_EL2_A3V (1U << 21)
241 #define ICH_VTR_EL2_SEIS (1U << 22)
242 #define ICH_VTR_EL2_IDBITS_SHIFT 23
243 #define ICH_VTR_EL2_PREBITS_SHIFT 26
244 #define ICH_VTR_EL2_PRIBITS_SHIFT 29
245 
246 /* ITS Registers */
247 
248 FIELD(GITS_BASER, SIZE, 0, 8)
249 FIELD(GITS_BASER, PAGESIZE, 8, 2)
250 FIELD(GITS_BASER, SHAREABILITY, 10, 2)
251 FIELD(GITS_BASER, PHYADDR, 12, 36)
252 FIELD(GITS_BASER, PHYADDRL_64K, 16, 32)
253 FIELD(GITS_BASER, PHYADDRH_64K, 12, 4)
254 FIELD(GITS_BASER, ENTRYSIZE, 48, 5)
255 FIELD(GITS_BASER, OUTERCACHE, 53, 3)
256 FIELD(GITS_BASER, TYPE, 56, 3)
257 FIELD(GITS_BASER, INNERCACHE, 59, 3)
258 FIELD(GITS_BASER, INDIRECT, 62, 1)
259 FIELD(GITS_BASER, VALID, 63, 1)
260 
261 FIELD(GITS_CBASER, SIZE, 0, 8)
262 FIELD(GITS_CBASER, SHAREABILITY, 10, 2)
263 FIELD(GITS_CBASER, PHYADDR, 12, 40)
264 FIELD(GITS_CBASER, OUTERCACHE, 53, 3)
265 FIELD(GITS_CBASER, INNERCACHE, 59, 3)
266 FIELD(GITS_CBASER, VALID, 63, 1)
267 
268 FIELD(GITS_CREADR, STALLED, 0, 1)
269 FIELD(GITS_CREADR, OFFSET, 5, 15)
270 
271 FIELD(GITS_CWRITER, RETRY, 0, 1)
272 FIELD(GITS_CWRITER, OFFSET, 5, 15)
273 
274 FIELD(GITS_CTLR, ENABLED, 0, 1)
275 FIELD(GITS_CTLR, QUIESCENT, 31, 1)
276 
277 FIELD(GITS_TYPER, PHYSICAL, 0, 1)
278 FIELD(GITS_TYPER, ITT_ENTRY_SIZE, 4, 4)
279 FIELD(GITS_TYPER, IDBITS, 8, 5)
280 FIELD(GITS_TYPER, DEVBITS, 13, 5)
281 FIELD(GITS_TYPER, SEIS, 18, 1)
282 FIELD(GITS_TYPER, PTA, 19, 1)
283 FIELD(GITS_TYPER, CIDBITS, 32, 4)
284 FIELD(GITS_TYPER, CIL, 36, 1)
285 
286 #define GITS_IDREGS           0xFFD0
287 
288 #define ITS_CTLR_ENABLED               (1U)  /* ITS Enabled */
289 
290 #define GITS_BASER_RO_MASK                  (R_GITS_BASER_ENTRYSIZE_MASK | \
291                                               R_GITS_BASER_TYPE_MASK)
292 
293 #define GITS_BASER_PAGESIZE_4K                0
294 #define GITS_BASER_PAGESIZE_16K               1
295 #define GITS_BASER_PAGESIZE_64K               2
296 
297 #define GITS_BASER_TYPE_DEVICE               1ULL
298 #define GITS_BASER_TYPE_COLLECTION           4ULL
299 
300 #define GITS_PAGE_SIZE_4K       0x1000
301 #define GITS_PAGE_SIZE_16K      0x4000
302 #define GITS_PAGE_SIZE_64K      0x10000
303 
304 #define L1TABLE_ENTRY_SIZE         8
305 
306 #define GITS_CMDQ_ENTRY_SIZE               32
307 #define NUM_BYTES_IN_DW                     8
308 
309 #define CMD_MASK                  0xff
310 
311 /* ITS Commands */
312 #define GITS_CMD_CLEAR            0x04
313 #define GITS_CMD_DISCARD          0x0F
314 #define GITS_CMD_INT              0x03
315 #define GITS_CMD_MAPC             0x09
316 #define GITS_CMD_MAPD             0x08
317 #define GITS_CMD_MAPI             0x0B
318 #define GITS_CMD_MAPTI            0x0A
319 #define GITS_CMD_INV              0x0C
320 #define GITS_CMD_INVALL           0x0D
321 #define GITS_CMD_SYNC             0x05
322 
323 /* MAPC command fields */
324 #define ICID_LENGTH                  16
325 #define ICID_MASK                 ((1U << ICID_LENGTH) - 1)
326 FIELD(MAPC, RDBASE, 16, 32)
327 
328 #define RDBASE_PROCNUM_LENGTH        16
329 #define RDBASE_PROCNUM_MASK       ((1ULL << RDBASE_PROCNUM_LENGTH) - 1)
330 
331 /* MAPD command fields */
332 #define ITTADDR_LENGTH               44
333 #define ITTADDR_SHIFT                 8
334 #define ITTADDR_MASK             MAKE_64BIT_MASK(ITTADDR_SHIFT, ITTADDR_LENGTH)
335 #define SIZE_MASK                 0x1f
336 
337 /* MAPI command fields */
338 #define EVENTID_MASK              ((1ULL << 32) - 1)
339 
340 /* MAPTI command fields */
341 #define pINTID_SHIFT                 32
342 #define pINTID_MASK               MAKE_64BIT_MASK(32, 32)
343 
344 #define DEVID_SHIFT                  32
345 #define DEVID_MASK                MAKE_64BIT_MASK(32, 32)
346 
347 #define VALID_SHIFT               63
348 #define CMD_FIELD_VALID_MASK      (1ULL << VALID_SHIFT)
349 #define L2_TABLE_VALID_MASK       CMD_FIELD_VALID_MASK
350 #define TABLE_ENTRY_VALID_MASK    (1ULL << 0)
351 
352 /**
353  * Default features advertised by this version of ITS
354  */
355 /* Physical LPIs supported */
356 #define GITS_TYPE_PHYSICAL           (1U << 0)
357 
358 /*
359  * 12 bytes Interrupt translation Table Entry size
360  * as per Table 5.3 in GICv3 spec
361  * ITE Lower 8 Bytes
362  *   Bits:    | 49 ... 26 | 25 ... 2 |   1     |   0    |
363  *   Values:  |    1023   |  IntNum  | IntType |  Valid |
364  * ITE Higher 4 Bytes
365  *   Bits:    | 31 ... 16 | 15 ...0 |
366  *   Values:  |  vPEID    |  ICID   |
367  */
368 #define ITS_ITT_ENTRY_SIZE            0xC
369 #define ITE_ENTRY_INTTYPE_SHIFT        1
370 #define ITE_ENTRY_INTID_SHIFT          2
371 #define ITE_ENTRY_INTID_MASK         MAKE_64BIT_MASK(2, 24)
372 #define ITE_ENTRY_INTSP_SHIFT          26
373 #define ITE_ENTRY_ICID_MASK          MAKE_64BIT_MASK(0, 16)
374 
375 /* 16 bits EventId */
376 #define ITS_IDBITS                   GICD_TYPER_IDBITS
377 
378 /* 16 bits DeviceId */
379 #define ITS_DEVBITS                   0xF
380 
381 /* 16 bits CollectionId */
382 #define ITS_CIDBITS                  0xF
383 
384 /*
385  * 8 bytes Device Table Entry size
386  * Valid = 1 bit,ITTAddr = 44 bits,Size = 5 bits
387  */
388 #define GITS_DTE_SIZE                 (0x8ULL)
389 #define GITS_DTE_ITTADDR_SHIFT           6
390 #define GITS_DTE_ITTADDR_MASK         MAKE_64BIT_MASK(GITS_DTE_ITTADDR_SHIFT, \
391                                                       ITTADDR_LENGTH)
392 
393 /*
394  * 8 bytes Collection Table Entry size
395  * Valid = 1 bit,RDBase = 36 bits(considering max RDBASE)
396  */
397 #define GITS_CTE_SIZE                 (0x8ULL)
398 
399 /* Special interrupt IDs */
400 #define INTID_SECURE 1020
401 #define INTID_NONSECURE 1021
402 #define INTID_SPURIOUS 1023
403 
404 /* Functions internal to the emulated GICv3 */
405 
406 /**
407  * gicv3_redist_update:
408  * @cs: GICv3CPUState for this redistributor
409  *
410  * Recalculate the highest priority pending interrupt after a
411  * change to redistributor state, and inform the CPU accordingly.
412  */
413 void gicv3_redist_update(GICv3CPUState *cs);
414 
415 /**
416  * gicv3_update:
417  * @s: GICv3State
418  * @start: first interrupt whose state changed
419  * @len: length of the range of interrupts whose state changed
420  *
421  * Recalculate the highest priority pending interrupts after a
422  * change to the distributor state affecting @len interrupts
423  * starting at @start, and inform the CPUs accordingly.
424  */
425 void gicv3_update(GICv3State *s, int start, int len);
426 
427 /**
428  * gicv3_full_update_noirqset:
429  * @s: GICv3State
430  *
431  * Recalculate the cached information about highest priority
432  * pending interrupts, but don't inform the CPUs. This should be
433  * called after an incoming migration has loaded new state.
434  */
435 void gicv3_full_update_noirqset(GICv3State *s);
436 
437 /**
438  * gicv3_full_update:
439  * @s: GICv3State
440  *
441  * Recalculate the highest priority pending interrupts after
442  * a change that could affect the status of all interrupts,
443  * and inform the CPUs accordingly.
444  */
445 void gicv3_full_update(GICv3State *s);
446 MemTxResult gicv3_dist_read(void *opaque, hwaddr offset, uint64_t *data,
447                             unsigned size, MemTxAttrs attrs);
448 MemTxResult gicv3_dist_write(void *opaque, hwaddr addr, uint64_t data,
449                              unsigned size, MemTxAttrs attrs);
450 MemTxResult gicv3_redist_read(void *opaque, hwaddr offset, uint64_t *data,
451                               unsigned size, MemTxAttrs attrs);
452 MemTxResult gicv3_redist_write(void *opaque, hwaddr offset, uint64_t data,
453                                unsigned size, MemTxAttrs attrs);
454 void gicv3_dist_set_irq(GICv3State *s, int irq, int level);
455 void gicv3_redist_set_irq(GICv3CPUState *cs, int irq, int level);
456 void gicv3_redist_send_sgi(GICv3CPUState *cs, int grp, int irq, bool ns);
457 void gicv3_init_cpuif(GICv3State *s);
458 
459 /**
460  * gicv3_cpuif_update:
461  * @cs: GICv3CPUState for the CPU to update
462  *
463  * Recalculate whether to assert the IRQ or FIQ lines after a change
464  * to the current highest priority pending interrupt, the CPU's
465  * current running priority or the CPU's current exception level or
466  * security state.
467  */
468 void gicv3_cpuif_update(GICv3CPUState *cs);
469 
470 static inline uint32_t gicv3_iidr(void)
471 {
472     /* Return the Implementer Identification Register value
473      * for the emulated GICv3, as reported in GICD_IIDR and GICR_IIDR.
474      *
475      * We claim to be an ARM r0p0 with a zero ProductID.
476      * This is the same as an r0p0 GIC-500.
477      */
478     return 0x43b;
479 }
480 
481 static inline uint32_t gicv3_idreg(int regoffset)
482 {
483     /* Return the value of the CoreSight ID register at the specified
484      * offset from the first ID register (as found in the distributor
485      * and redistributor register banks).
486      * These values indicate an ARM implementation of a GICv3.
487      */
488     static const uint8_t gicd_ids[] = {
489         0x44, 0x00, 0x00, 0x00, 0x92, 0xB4, 0x3B, 0x00, 0x0D, 0xF0, 0x05, 0xB1
490     };
491     return gicd_ids[regoffset / 4];
492 }
493 
494 /**
495  * gicv3_irq_group:
496  *
497  * Return the group which this interrupt is configured as (GICV3_G0,
498  * GICV3_G1 or GICV3_G1NS).
499  */
500 static inline int gicv3_irq_group(GICv3State *s, GICv3CPUState *cs, int irq)
501 {
502     bool grpbit, grpmodbit;
503 
504     if (irq < GIC_INTERNAL) {
505         grpbit = extract32(cs->gicr_igroupr0, irq, 1);
506         grpmodbit = extract32(cs->gicr_igrpmodr0, irq, 1);
507     } else {
508         grpbit = gicv3_gicd_group_test(s, irq);
509         grpmodbit = gicv3_gicd_grpmod_test(s, irq);
510     }
511     if (grpbit) {
512         return GICV3_G1NS;
513     }
514     if (s->gicd_ctlr & GICD_CTLR_DS) {
515         return GICV3_G0;
516     }
517     return grpmodbit ? GICV3_G1 : GICV3_G0;
518 }
519 
520 /**
521  * gicv3_redist_affid:
522  *
523  * Return the 32-bit affinity ID of the CPU connected to this redistributor
524  */
525 static inline uint32_t gicv3_redist_affid(GICv3CPUState *cs)
526 {
527     return cs->gicr_typer >> 32;
528 }
529 
530 /**
531  * gicv3_cache_target_cpustate:
532  *
533  * Update the cached CPU state corresponding to the target for this interrupt
534  * (which is kept in s->gicd_irouter_target[]).
535  */
536 static inline void gicv3_cache_target_cpustate(GICv3State *s, int irq)
537 {
538     GICv3CPUState *cs = NULL;
539     int i;
540     uint32_t tgtaff = extract64(s->gicd_irouter[irq], 0, 24) |
541         extract64(s->gicd_irouter[irq], 32, 8) << 24;
542 
543     for (i = 0; i < s->num_cpu; i++) {
544         if (s->cpu[i].gicr_typer >> 32 == tgtaff) {
545             cs = &s->cpu[i];
546             break;
547         }
548     }
549 
550     s->gicd_irouter_target[irq] = cs;
551 }
552 
553 /**
554  * gicv3_cache_all_target_cpustates:
555  *
556  * Populate the entire cache of CPU state pointers for interrupt targets
557  * (eg after inbound migration or CPU reset)
558  */
559 static inline void gicv3_cache_all_target_cpustates(GICv3State *s)
560 {
561     int irq;
562 
563     for (irq = GIC_INTERNAL; irq < GICV3_MAXIRQ; irq++) {
564         gicv3_cache_target_cpustate(s, irq);
565     }
566 }
567 
568 void gicv3_set_gicv3state(CPUState *cpu, GICv3CPUState *s);
569 
570 #endif /* QEMU_ARM_GICV3_INTERNAL_H */
571