2 * ARM GICv3 support - internal interfaces
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
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.
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.
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/>.
24 #ifndef QEMU_ARM_GICV3_INTERNAL_H
25 #define QEMU_ARM_GICV3_INTERNAL_H
27 #include "hw/registerfields.h"
28 #include "hw/intc/arm_gicv3_common.h"
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
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)
71 #define GICD_TYPER_LPIS_SHIFT 17
74 #define GICD_TYPER_IDBITS 0xf
77 * Redistributor frame offsets from RD_base
79 #define GICR_SGI_OFFSET 0x10000
82 * Redistributor registers, offsets from RD_base
84 #define GICR_CTLR 0x0000
85 #define GICR_IIDR 0x0004
86 #define GICR_TYPER 0x0008
87 #define GICR_STATUSR 0x0010
88 #define GICR_WAKER 0x0014
89 #define GICR_SETLPIR 0x0040
90 #define GICR_CLRLPIR 0x0048
91 #define GICR_PROPBASER 0x0070
92 #define GICR_PENDBASER 0x0078
93 #define GICR_INVLPIR 0x00A0
94 #define GICR_INVALLR 0x00B0
95 #define GICR_SYNCR 0x00C0
96 #define GICR_IDREGS 0xFFD0
98 /* SGI and PPI Redistributor registers, offsets from RD_base */
99 #define GICR_IGROUPR0 (GICR_SGI_OFFSET + 0x0080)
100 #define GICR_ISENABLER0 (GICR_SGI_OFFSET + 0x0100)
101 #define GICR_ICENABLER0 (GICR_SGI_OFFSET + 0x0180)
102 #define GICR_ISPENDR0 (GICR_SGI_OFFSET + 0x0200)
103 #define GICR_ICPENDR0 (GICR_SGI_OFFSET + 0x0280)
104 #define GICR_ISACTIVER0 (GICR_SGI_OFFSET + 0x0300)
105 #define GICR_ICACTIVER0 (GICR_SGI_OFFSET + 0x0380)
106 #define GICR_IPRIORITYR (GICR_SGI_OFFSET + 0x0400)
107 #define GICR_ICFGR0 (GICR_SGI_OFFSET + 0x0C00)
108 #define GICR_ICFGR1 (GICR_SGI_OFFSET + 0x0C04)
109 #define GICR_IGRPMODR0 (GICR_SGI_OFFSET + 0x0D00)
110 #define GICR_NSACR (GICR_SGI_OFFSET + 0x0E00)
112 #define GICR_CTLR_ENABLE_LPIS (1U << 0)
113 #define GICR_CTLR_CES (1U << 1)
114 #define GICR_CTLR_RWP (1U << 3)
115 #define GICR_CTLR_DPG0 (1U << 24)
116 #define GICR_CTLR_DPG1NS (1U << 25)
117 #define GICR_CTLR_DPG1S (1U << 26)
118 #define GICR_CTLR_UWP (1U << 31)
120 #define GICR_TYPER_PLPIS (1U << 0)
121 #define GICR_TYPER_VLPIS (1U << 1)
122 #define GICR_TYPER_DIRECTLPI (1U << 3)
123 #define GICR_TYPER_LAST (1U << 4)
124 #define GICR_TYPER_DPGS (1U << 5)
125 #define GICR_TYPER_PROCNUM (0xFFFFU << 8)
126 #define GICR_TYPER_COMMONLPIAFF (0x3 << 24)
127 #define GICR_TYPER_AFFINITYVALUE (0xFFFFFFFFULL << 32)
129 #define GICR_WAKER_ProcessorSleep (1U << 1)
130 #define GICR_WAKER_ChildrenAsleep (1U << 2)
132 FIELD(GICR_PROPBASER
, IDBITS
, 0, 5)
133 FIELD(GICR_PROPBASER
, INNERCACHE
, 7, 3)
134 FIELD(GICR_PROPBASER
, SHAREABILITY
, 10, 2)
135 FIELD(GICR_PROPBASER
, PHYADDR
, 12, 40)
136 FIELD(GICR_PROPBASER
, OUTERCACHE
, 56, 3)
138 FIELD(GICR_PENDBASER
, INNERCACHE
, 7, 3)
139 FIELD(GICR_PENDBASER
, SHAREABILITY
, 10, 2)
140 FIELD(GICR_PENDBASER
, PHYADDR
, 16, 36)
141 FIELD(GICR_PENDBASER
, OUTERCACHE
, 56, 3)
142 FIELD(GICR_PENDBASER
, PTZ
, 62, 1)
144 #define GICR_PROPBASER_IDBITS_THRESHOLD 0xd
146 #define ICC_CTLR_EL1_CBPR (1U << 0)
147 #define ICC_CTLR_EL1_EOIMODE (1U << 1)
148 #define ICC_CTLR_EL1_PMHE (1U << 6)
149 #define ICC_CTLR_EL1_PRIBITS_SHIFT 8
150 #define ICC_CTLR_EL1_PRIBITS_MASK (7U << ICC_CTLR_EL1_PRIBITS_SHIFT)
151 #define ICC_CTLR_EL1_IDBITS_SHIFT 11
152 #define ICC_CTLR_EL1_SEIS (1U << 14)
153 #define ICC_CTLR_EL1_A3V (1U << 15)
155 #define ICC_PMR_PRIORITY_MASK 0xff
156 #define ICC_BPR_BINARYPOINT_MASK 0x07
157 #define ICC_IGRPEN_ENABLE 0x01
159 #define ICC_CTLR_EL3_CBPR_EL1S (1U << 0)
160 #define ICC_CTLR_EL3_CBPR_EL1NS (1U << 1)
161 #define ICC_CTLR_EL3_EOIMODE_EL3 (1U << 2)
162 #define ICC_CTLR_EL3_EOIMODE_EL1S (1U << 3)
163 #define ICC_CTLR_EL3_EOIMODE_EL1NS (1U << 4)
164 #define ICC_CTLR_EL3_RM (1U << 5)
165 #define ICC_CTLR_EL3_PMHE (1U << 6)
166 #define ICC_CTLR_EL3_PRIBITS_SHIFT 8
167 #define ICC_CTLR_EL3_IDBITS_SHIFT 11
168 #define ICC_CTLR_EL3_SEIS (1U << 14)
169 #define ICC_CTLR_EL3_A3V (1U << 15)
170 #define ICC_CTLR_EL3_NDS (1U << 17)
172 #define ICH_VMCR_EL2_VENG0_SHIFT 0
173 #define ICH_VMCR_EL2_VENG0 (1U << ICH_VMCR_EL2_VENG0_SHIFT)
174 #define ICH_VMCR_EL2_VENG1_SHIFT 1
175 #define ICH_VMCR_EL2_VENG1 (1U << ICH_VMCR_EL2_VENG1_SHIFT)
176 #define ICH_VMCR_EL2_VACKCTL (1U << 2)
177 #define ICH_VMCR_EL2_VFIQEN (1U << 3)
178 #define ICH_VMCR_EL2_VCBPR_SHIFT 4
179 #define ICH_VMCR_EL2_VCBPR (1U << ICH_VMCR_EL2_VCBPR_SHIFT)
180 #define ICH_VMCR_EL2_VEOIM_SHIFT 9
181 #define ICH_VMCR_EL2_VEOIM (1U << ICH_VMCR_EL2_VEOIM_SHIFT)
182 #define ICH_VMCR_EL2_VBPR1_SHIFT 18
183 #define ICH_VMCR_EL2_VBPR1_LENGTH 3
184 #define ICH_VMCR_EL2_VBPR1_MASK (0x7U << ICH_VMCR_EL2_VBPR1_SHIFT)
185 #define ICH_VMCR_EL2_VBPR0_SHIFT 21
186 #define ICH_VMCR_EL2_VBPR0_LENGTH 3
187 #define ICH_VMCR_EL2_VBPR0_MASK (0x7U << ICH_VMCR_EL2_VBPR0_SHIFT)
188 #define ICH_VMCR_EL2_VPMR_SHIFT 24
189 #define ICH_VMCR_EL2_VPMR_LENGTH 8
190 #define ICH_VMCR_EL2_VPMR_MASK (0xffU << ICH_VMCR_EL2_VPMR_SHIFT)
192 #define ICH_HCR_EL2_EN (1U << 0)
193 #define ICH_HCR_EL2_UIE (1U << 1)
194 #define ICH_HCR_EL2_LRENPIE (1U << 2)
195 #define ICH_HCR_EL2_NPIE (1U << 3)
196 #define ICH_HCR_EL2_VGRP0EIE (1U << 4)
197 #define ICH_HCR_EL2_VGRP0DIE (1U << 5)
198 #define ICH_HCR_EL2_VGRP1EIE (1U << 6)
199 #define ICH_HCR_EL2_VGRP1DIE (1U << 7)
200 #define ICH_HCR_EL2_TC (1U << 10)
201 #define ICH_HCR_EL2_TALL0 (1U << 11)
202 #define ICH_HCR_EL2_TALL1 (1U << 12)
203 #define ICH_HCR_EL2_TSEI (1U << 13)
204 #define ICH_HCR_EL2_TDIR (1U << 14)
205 #define ICH_HCR_EL2_EOICOUNT_SHIFT 27
206 #define ICH_HCR_EL2_EOICOUNT_LENGTH 5
207 #define ICH_HCR_EL2_EOICOUNT_MASK (0x1fU << ICH_HCR_EL2_EOICOUNT_SHIFT)
209 #define ICH_LR_EL2_VINTID_SHIFT 0
210 #define ICH_LR_EL2_VINTID_LENGTH 32
211 #define ICH_LR_EL2_VINTID_MASK (0xffffffffULL << ICH_LR_EL2_VINTID_SHIFT)
212 #define ICH_LR_EL2_PINTID_SHIFT 32
213 #define ICH_LR_EL2_PINTID_LENGTH 10
214 #define ICH_LR_EL2_PINTID_MASK (0x3ffULL << ICH_LR_EL2_PINTID_SHIFT)
215 /* Note that EOI shares with the top bit of the pINTID field */
216 #define ICH_LR_EL2_EOI (1ULL << 41)
217 #define ICH_LR_EL2_PRIORITY_SHIFT 48
218 #define ICH_LR_EL2_PRIORITY_LENGTH 8
219 #define ICH_LR_EL2_PRIORITY_MASK (0xffULL << ICH_LR_EL2_PRIORITY_SHIFT)
220 #define ICH_LR_EL2_GROUP (1ULL << 60)
221 #define ICH_LR_EL2_HW (1ULL << 61)
222 #define ICH_LR_EL2_STATE_SHIFT 62
223 #define ICH_LR_EL2_STATE_LENGTH 2
224 #define ICH_LR_EL2_STATE_MASK (3ULL << ICH_LR_EL2_STATE_SHIFT)
225 /* values for the state field: */
226 #define ICH_LR_EL2_STATE_INVALID 0
227 #define ICH_LR_EL2_STATE_PENDING 1
228 #define ICH_LR_EL2_STATE_ACTIVE 2
229 #define ICH_LR_EL2_STATE_ACTIVE_PENDING 3
230 #define ICH_LR_EL2_STATE_PENDING_BIT (1ULL << ICH_LR_EL2_STATE_SHIFT)
231 #define ICH_LR_EL2_STATE_ACTIVE_BIT (2ULL << ICH_LR_EL2_STATE_SHIFT)
233 #define ICH_MISR_EL2_EOI (1U << 0)
234 #define ICH_MISR_EL2_U (1U << 1)
235 #define ICH_MISR_EL2_LRENP (1U << 2)
236 #define ICH_MISR_EL2_NP (1U << 3)
237 #define ICH_MISR_EL2_VGRP0E (1U << 4)
238 #define ICH_MISR_EL2_VGRP0D (1U << 5)
239 #define ICH_MISR_EL2_VGRP1E (1U << 6)
240 #define ICH_MISR_EL2_VGRP1D (1U << 7)
242 #define ICH_VTR_EL2_LISTREGS_SHIFT 0
243 #define ICH_VTR_EL2_TDS (1U << 19)
244 #define ICH_VTR_EL2_NV4 (1U << 20)
245 #define ICH_VTR_EL2_A3V (1U << 21)
246 #define ICH_VTR_EL2_SEIS (1U << 22)
247 #define ICH_VTR_EL2_IDBITS_SHIFT 23
248 #define ICH_VTR_EL2_PREBITS_SHIFT 26
249 #define ICH_VTR_EL2_PRIBITS_SHIFT 29
253 FIELD(GITS_BASER
, SIZE
, 0, 8)
254 FIELD(GITS_BASER
, PAGESIZE
, 8, 2)
255 FIELD(GITS_BASER
, SHAREABILITY
, 10, 2)
256 FIELD(GITS_BASER
, PHYADDR
, 12, 36)
257 FIELD(GITS_BASER
, PHYADDRL_64K
, 16, 32)
258 FIELD(GITS_BASER
, PHYADDRH_64K
, 12, 4)
259 FIELD(GITS_BASER
, ENTRYSIZE
, 48, 5)
260 FIELD(GITS_BASER
, OUTERCACHE
, 53, 3)
261 FIELD(GITS_BASER
, TYPE
, 56, 3)
262 FIELD(GITS_BASER
, INNERCACHE
, 59, 3)
263 FIELD(GITS_BASER
, INDIRECT
, 62, 1)
264 FIELD(GITS_BASER
, VALID
, 63, 1)
266 FIELD(GITS_CBASER
, SIZE
, 0, 8)
267 FIELD(GITS_CBASER
, SHAREABILITY
, 10, 2)
268 FIELD(GITS_CBASER
, PHYADDR
, 12, 40)
269 FIELD(GITS_CBASER
, OUTERCACHE
, 53, 3)
270 FIELD(GITS_CBASER
, INNERCACHE
, 59, 3)
271 FIELD(GITS_CBASER
, VALID
, 63, 1)
273 FIELD(GITS_CREADR
, STALLED
, 0, 1)
274 FIELD(GITS_CREADR
, OFFSET
, 5, 15)
276 FIELD(GITS_CWRITER
, RETRY
, 0, 1)
277 FIELD(GITS_CWRITER
, OFFSET
, 5, 15)
279 FIELD(GITS_CTLR
, ENABLED
, 0, 1)
280 FIELD(GITS_CTLR
, QUIESCENT
, 31, 1)
282 FIELD(GITS_TYPER
, PHYSICAL
, 0, 1)
283 FIELD(GITS_TYPER
, VIRTUAL
, 1, 1)
284 FIELD(GITS_TYPER
, ITT_ENTRY_SIZE
, 4, 4)
285 FIELD(GITS_TYPER
, IDBITS
, 8, 5)
286 FIELD(GITS_TYPER
, DEVBITS
, 13, 5)
287 FIELD(GITS_TYPER
, SEIS
, 18, 1)
288 FIELD(GITS_TYPER
, PTA
, 19, 1)
289 FIELD(GITS_TYPER
, CIDBITS
, 32, 4)
290 FIELD(GITS_TYPER
, CIL
, 36, 1)
292 #define GITS_IDREGS 0xFFD0
294 #define GITS_BASER_RO_MASK (R_GITS_BASER_ENTRYSIZE_MASK | \
295 R_GITS_BASER_TYPE_MASK)
297 #define GITS_BASER_PAGESIZE_4K 0
298 #define GITS_BASER_PAGESIZE_16K 1
299 #define GITS_BASER_PAGESIZE_64K 2
301 #define GITS_BASER_TYPE_DEVICE 1ULL
302 #define GITS_BASER_TYPE_VPE 2ULL
303 #define GITS_BASER_TYPE_COLLECTION 4ULL
305 #define GITS_PAGE_SIZE_4K 0x1000
306 #define GITS_PAGE_SIZE_16K 0x4000
307 #define GITS_PAGE_SIZE_64K 0x10000
309 #define L1TABLE_ENTRY_SIZE 8
311 #define LPI_CTE_ENABLED TABLE_ENTRY_VALID_MASK
312 #define LPI_PRIORITY_MASK 0xfc
314 #define GITS_CMDQ_ENTRY_WORDS 4
315 #define GITS_CMDQ_ENTRY_SIZE (GITS_CMDQ_ENTRY_WORDS * sizeof(uint64_t))
317 #define CMD_MASK 0xff
320 #define GITS_CMD_MOVI 0x01
321 #define GITS_CMD_INT 0x03
322 #define GITS_CMD_CLEAR 0x04
323 #define GITS_CMD_SYNC 0x05
324 #define GITS_CMD_MAPD 0x08
325 #define GITS_CMD_MAPC 0x09
326 #define GITS_CMD_MAPTI 0x0A
327 #define GITS_CMD_MAPI 0x0B
328 #define GITS_CMD_INV 0x0C
329 #define GITS_CMD_INVALL 0x0D
330 #define GITS_CMD_MOVALL 0x0E
331 #define GITS_CMD_DISCARD 0x0F
332 #define GITS_CMD_VMAPP 0x29
333 #define GITS_CMD_VMAPTI 0x2A
334 #define GITS_CMD_VMAPI 0x2B
336 /* MAPC command fields */
337 #define ICID_LENGTH 16
338 #define ICID_MASK ((1U << ICID_LENGTH) - 1)
339 FIELD(MAPC
, RDBASE
, 16, 32)
341 #define RDBASE_PROCNUM_LENGTH 16
342 #define RDBASE_PROCNUM_MASK ((1ULL << RDBASE_PROCNUM_LENGTH) - 1)
344 /* MAPD command fields */
345 #define ITTADDR_LENGTH 44
346 #define ITTADDR_SHIFT 8
347 #define ITTADDR_MASK MAKE_64BIT_MASK(ITTADDR_SHIFT, ITTADDR_LENGTH)
348 #define SIZE_MASK 0x1f
350 /* MAPI command fields */
351 #define EVENTID_MASK ((1ULL << 32) - 1)
353 /* MAPTI command fields */
354 #define pINTID_SHIFT 32
355 #define pINTID_MASK MAKE_64BIT_MASK(32, 32)
357 #define DEVID_SHIFT 32
358 #define DEVID_MASK MAKE_64BIT_MASK(32, 32)
360 #define VALID_SHIFT 63
361 #define CMD_FIELD_VALID_MASK (1ULL << VALID_SHIFT)
362 #define L2_TABLE_VALID_MASK CMD_FIELD_VALID_MASK
363 #define TABLE_ENTRY_VALID_MASK (1ULL << 0)
365 /* MOVALL command fields */
366 FIELD(MOVALL_2
, RDBASE1
, 16, 36)
367 FIELD(MOVALL_3
, RDBASE2
, 16, 36)
369 /* MOVI command fields */
370 FIELD(MOVI_0
, DEVICEID
, 32, 32)
371 FIELD(MOVI_1
, EVENTID
, 0, 32)
372 FIELD(MOVI_2
, ICID
, 0, 16)
374 /* VMAPI, VMAPTI command fields */
375 FIELD(VMAPTI_0
, DEVICEID
, 32, 32)
376 FIELD(VMAPTI_1
, EVENTID
, 0, 32)
377 FIELD(VMAPTI_1
, VPEID
, 32, 16)
378 FIELD(VMAPTI_2
, VINTID
, 0, 32) /* VMAPTI only */
379 FIELD(VMAPTI_2
, DOORBELL
, 32, 32)
381 /* VMAPP command fields */
382 FIELD(VMAPP_0
, ALLOC
, 8, 1) /* GICv4.1 only */
383 FIELD(VMAPP_0
, PTZ
, 9, 1) /* GICv4.1 only */
384 FIELD(VMAPP_0
, VCONFADDR
, 16, 36) /* GICv4.1 only */
385 FIELD(VMAPP_1
, DEFAULT_DOORBELL
, 0, 32) /* GICv4.1 only */
386 FIELD(VMAPP_1
, VPEID
, 32, 16)
387 FIELD(VMAPP_2
, RDBASE
, 16, 36)
388 FIELD(VMAPP_2
, V
, 63, 1)
389 FIELD(VMAPP_3
, VPTSIZE
, 0, 8) /* For GICv4.0, bits [7:6] are RES0 */
390 FIELD(VMAPP_3
, VPTADDR
, 16, 36)
393 * 12 bytes Interrupt translation Table Entry size
394 * as per Table 5.3 in GICv3 spec
396 * Bits: | 63 ... 48 | 47 ... 32 | 31 ... 26 | 25 ... 2 | 1 | 0 |
397 * Values: | vPEID | ICID | unused | IntNum | IntType | Valid |
399 * Bits: | 31 ... 25 | 24 ... 0 |
400 * Values: | unused | Doorbell |
401 * (When Doorbell is unused, as it always is for INTYPE_PHYSICAL,
402 * the value of that field in memory cannot be relied upon -- older
403 * versions of QEMU did not correctly write to that memory.)
405 #define ITS_ITT_ENTRY_SIZE 0xC
407 FIELD(ITE_L
, VALID
, 0, 1)
408 FIELD(ITE_L
, INTTYPE
, 1, 1)
409 FIELD(ITE_L
, INTID
, 2, 24)
410 FIELD(ITE_L
, ICID
, 32, 16)
411 FIELD(ITE_L
, VPEID
, 48, 16)
412 FIELD(ITE_H
, DOORBELL
, 0, 24)
414 /* Possible values for ITE_L INTTYPE */
415 #define ITE_INTTYPE_VIRTUAL 0
416 #define ITE_INTTYPE_PHYSICAL 1
418 /* 16 bits EventId */
419 #define ITS_IDBITS GICD_TYPER_IDBITS
421 /* 16 bits DeviceId */
422 #define ITS_DEVBITS 0xF
424 /* 16 bits CollectionId */
425 #define ITS_CIDBITS 0xF
428 * 8 bytes Device Table Entry size
429 * Valid = 1 bit,ITTAddr = 44 bits,Size = 5 bits
431 #define GITS_DTE_SIZE (0x8ULL)
433 FIELD(DTE
, VALID
, 0, 1)
434 FIELD(DTE
, SIZE
, 1, 5)
435 FIELD(DTE
, ITTADDR
, 6, 44)
438 * 8 bytes Collection Table Entry size
439 * Valid = 1 bit, RDBase = 16 bits
441 #define GITS_CTE_SIZE (0x8ULL)
442 FIELD(CTE
, VALID
, 0, 1)
443 FIELD(CTE
, RDBASE
, 1, RDBASE_PROCNUM_LENGTH
)
446 * 8 bytes VPE table entry size:
447 * Valid = 1 bit, VPTsize = 5 bits, VPTaddr = 36 bits, RDbase = 16 bits
449 * Field sizes for Valid and size are mandated; field sizes for RDbase
450 * and VPT_addr are IMPDEF.
452 #define GITS_VPE_SIZE 0x8ULL
454 FIELD(VTE
, VALID
, 0, 1)
455 FIELD(VTE
, VPTSIZE
, 1, 5)
456 FIELD(VTE
, VPTADDR
, 6, 36)
457 FIELD(VTE
, RDBASE
, 42, RDBASE_PROCNUM_LENGTH
)
459 /* Special interrupt IDs */
460 #define INTID_SECURE 1020
461 #define INTID_NONSECURE 1021
462 #define INTID_SPURIOUS 1023
464 /* Functions internal to the emulated GICv3 */
467 * gicv3_intid_is_special:
468 * @intid: interrupt ID
470 * Return true if @intid is a special interrupt ID (1020 to
471 * 1023 inclusive). This corresponds to the GIC spec pseudocode
472 * IsSpecial() function.
474 static inline bool gicv3_intid_is_special(int intid
)
476 return intid
>= INTID_SECURE
&& intid
<= INTID_SPURIOUS
;
480 * gicv3_redist_update:
481 * @cs: GICv3CPUState for this redistributor
483 * Recalculate the highest priority pending interrupt after a
484 * change to redistributor state, and inform the CPU accordingly.
486 void gicv3_redist_update(GICv3CPUState
*cs
);
491 * @start: first interrupt whose state changed
492 * @len: length of the range of interrupts whose state changed
494 * Recalculate the highest priority pending interrupts after a
495 * change to the distributor state affecting @len interrupts
496 * starting at @start, and inform the CPUs accordingly.
498 void gicv3_update(GICv3State
*s
, int start
, int len
);
501 * gicv3_full_update_noirqset:
504 * Recalculate the cached information about highest priority
505 * pending interrupts, but don't inform the CPUs. This should be
506 * called after an incoming migration has loaded new state.
508 void gicv3_full_update_noirqset(GICv3State
*s
);
514 * Recalculate the highest priority pending interrupts after
515 * a change that could affect the status of all interrupts,
516 * and inform the CPUs accordingly.
518 void gicv3_full_update(GICv3State
*s
);
519 MemTxResult
gicv3_dist_read(void *opaque
, hwaddr offset
, uint64_t *data
,
520 unsigned size
, MemTxAttrs attrs
);
521 MemTxResult
gicv3_dist_write(void *opaque
, hwaddr addr
, uint64_t data
,
522 unsigned size
, MemTxAttrs attrs
);
523 MemTxResult
gicv3_redist_read(void *opaque
, hwaddr offset
, uint64_t *data
,
524 unsigned size
, MemTxAttrs attrs
);
525 MemTxResult
gicv3_redist_write(void *opaque
, hwaddr offset
, uint64_t data
,
526 unsigned size
, MemTxAttrs attrs
);
527 void gicv3_dist_set_irq(GICv3State
*s
, int irq
, int level
);
528 void gicv3_redist_set_irq(GICv3CPUState
*cs
, int irq
, int level
);
529 void gicv3_redist_process_lpi(GICv3CPUState
*cs
, int irq
, int level
);
531 * gicv3_redist_process_vlpi:
533 * @irq: (virtual) interrupt number
534 * @vptaddr: (guest) address of VLPI table
535 * @doorbell: doorbell (physical) interrupt number (1023 for "no doorbell")
536 * @level: level to set @irq to
538 * Process a virtual LPI being directly injected by the ITS. This function
539 * will update the VLPI table specified by @vptaddr and @vptsize. If the
540 * vCPU corresponding to that VLPI table is currently running on
541 * the CPU associated with this redistributor, directly inject the VLPI
542 * @irq. If the vCPU is not running on this CPU, raise the doorbell
545 void gicv3_redist_process_vlpi(GICv3CPUState
*cs
, int irq
, uint64_t vptaddr
,
546 int doorbell
, int level
);
547 void gicv3_redist_lpi_pending(GICv3CPUState
*cs
, int irq
, int level
);
549 * gicv3_redist_update_lpi:
552 * Scan the LPI pending table and recalculate the highest priority
553 * pending LPI and also the overall highest priority pending interrupt.
555 void gicv3_redist_update_lpi(GICv3CPUState
*cs
);
557 * gicv3_redist_update_lpi_only:
560 * Scan the LPI pending table and recalculate cs->hpplpi only,
561 * without calling gicv3_redist_update() to recalculate the overall
562 * highest priority pending interrupt. This should be called after
563 * an incoming migration has loaded new state.
565 void gicv3_redist_update_lpi_only(GICv3CPUState
*cs
);
567 * gicv3_redist_mov_lpi:
568 * @src: source redistributor
569 * @dest: destination redistributor
570 * @irq: LPI to update
572 * Move the pending state of the specified LPI from @src to @dest,
573 * as required by the ITS MOVI command.
575 void gicv3_redist_mov_lpi(GICv3CPUState
*src
, GICv3CPUState
*dest
, int irq
);
577 * gicv3_redist_movall_lpis:
578 * @src: source redistributor
579 * @dest: destination redistributor
581 * Scan the LPI pending table for @src, and for each pending LPI there
582 * mark it as not-pending for @src and pending for @dest, as required
583 * by the ITS MOVALL command.
585 void gicv3_redist_movall_lpis(GICv3CPUState
*src
, GICv3CPUState
*dest
);
587 void gicv3_redist_send_sgi(GICv3CPUState
*cs
, int grp
, int irq
, bool ns
);
588 void gicv3_init_cpuif(GICv3State
*s
);
591 * gicv3_cpuif_update:
592 * @cs: GICv3CPUState for the CPU to update
594 * Recalculate whether to assert the IRQ or FIQ lines after a change
595 * to the current highest priority pending interrupt, the CPU's
596 * current running priority or the CPU's current exception level or
599 void gicv3_cpuif_update(GICv3CPUState
*cs
);
601 static inline uint32_t gicv3_iidr(void)
603 /* Return the Implementer Identification Register value
604 * for the emulated GICv3, as reported in GICD_IIDR and GICR_IIDR.
606 * We claim to be an ARM r0p0 with a zero ProductID.
607 * This is the same as an r0p0 GIC-500.
612 /* CoreSight PIDR0 values for ARM GICv3 implementations */
613 #define GICV3_PIDR0_DIST 0x92
614 #define GICV3_PIDR0_REDIST 0x93
615 #define GICV3_PIDR0_ITS 0x94
617 static inline uint32_t gicv3_idreg(int regoffset
, uint8_t pidr0
)
619 /* Return the value of the CoreSight ID register at the specified
620 * offset from the first ID register (as found in the distributor
621 * and redistributor register banks).
622 * These values indicate an ARM implementation of a GICv3.
624 static const uint8_t gicd_ids
[] = {
625 0x44, 0x00, 0x00, 0x00, 0x92, 0xB4, 0x3B, 0x00, 0x0D, 0xF0, 0x05, 0xB1
630 if (regoffset
== 4) {
633 return gicd_ids
[regoffset
];
639 * Return the group which this interrupt is configured as (GICV3_G0,
640 * GICV3_G1 or GICV3_G1NS).
642 static inline int gicv3_irq_group(GICv3State
*s
, GICv3CPUState
*cs
, int irq
)
644 bool grpbit
, grpmodbit
;
646 if (irq
< GIC_INTERNAL
) {
647 grpbit
= extract32(cs
->gicr_igroupr0
, irq
, 1);
648 grpmodbit
= extract32(cs
->gicr_igrpmodr0
, irq
, 1);
650 grpbit
= gicv3_gicd_group_test(s
, irq
);
651 grpmodbit
= gicv3_gicd_grpmod_test(s
, irq
);
656 if (s
->gicd_ctlr
& GICD_CTLR_DS
) {
659 return grpmodbit
? GICV3_G1
: GICV3_G0
;
663 * gicv3_redist_affid:
665 * Return the 32-bit affinity ID of the CPU connected to this redistributor
667 static inline uint32_t gicv3_redist_affid(GICv3CPUState
*cs
)
669 return cs
->gicr_typer
>> 32;
673 * gicv3_cache_target_cpustate:
675 * Update the cached CPU state corresponding to the target for this interrupt
676 * (which is kept in s->gicd_irouter_target[]).
678 static inline void gicv3_cache_target_cpustate(GICv3State
*s
, int irq
)
680 GICv3CPUState
*cs
= NULL
;
682 uint32_t tgtaff
= extract64(s
->gicd_irouter
[irq
], 0, 24) |
683 extract64(s
->gicd_irouter
[irq
], 32, 8) << 24;
685 for (i
= 0; i
< s
->num_cpu
; i
++) {
686 if (s
->cpu
[i
].gicr_typer
>> 32 == tgtaff
) {
692 s
->gicd_irouter_target
[irq
] = cs
;
696 * gicv3_cache_all_target_cpustates:
698 * Populate the entire cache of CPU state pointers for interrupt targets
699 * (eg after inbound migration or CPU reset)
701 static inline void gicv3_cache_all_target_cpustates(GICv3State
*s
)
705 for (irq
= GIC_INTERNAL
; irq
< GICV3_MAXIRQ
; irq
++) {
706 gicv3_cache_target_cpustate(s
, irq
);
710 void gicv3_set_gicv3state(CPUState
*cpu
, GICv3CPUState
*s
);
712 #endif /* QEMU_ARM_GICV3_INTERNAL_H */