xref: /openbmc/qemu/hw/intc/gicv3_internal.h (revision ce187c3c15f4bda579c9833cd78092fb73e651aa)
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/intc/arm_gicv3_common.h"
28 
29 /* Distributor registers, as offsets from the distributor base address */
30 #define GICD_CTLR            0x0000
31 #define GICD_TYPER           0x0004
32 #define GICD_IIDR            0x0008
33 #define GICD_STATUSR         0x0010
34 #define GICD_SETSPI_NSR      0x0040
35 #define GICD_CLRSPI_NSR      0x0048
36 #define GICD_SETSPI_SR       0x0050
37 #define GICD_CLRSPI_SR       0x0058
38 #define GICD_SEIR            0x0068
39 #define GICD_IGROUPR         0x0080
40 #define GICD_ISENABLER       0x0100
41 #define GICD_ICENABLER       0x0180
42 #define GICD_ISPENDR         0x0200
43 #define GICD_ICPENDR         0x0280
44 #define GICD_ISACTIVER       0x0300
45 #define GICD_ICACTIVER       0x0380
46 #define GICD_IPRIORITYR      0x0400
47 #define GICD_ITARGETSR       0x0800
48 #define GICD_ICFGR           0x0C00
49 #define GICD_IGRPMODR        0x0D00
50 #define GICD_NSACR           0x0E00
51 #define GICD_SGIR            0x0F00
52 #define GICD_CPENDSGIR       0x0F10
53 #define GICD_SPENDSGIR       0x0F20
54 #define GICD_IROUTER         0x6000
55 #define GICD_IDREGS          0xFFD0
56 
57 /* GICD_CTLR fields  */
58 #define GICD_CTLR_EN_GRP0           (1U << 0)
59 #define GICD_CTLR_EN_GRP1NS         (1U << 1) /* GICv3 5.3.20 */
60 #define GICD_CTLR_EN_GRP1S          (1U << 2)
61 #define GICD_CTLR_EN_GRP1_ALL       (GICD_CTLR_EN_GRP1NS | GICD_CTLR_EN_GRP1S)
62 /* Bit 4 is ARE if the system doesn't support TrustZone, ARE_S otherwise */
63 #define GICD_CTLR_ARE               (1U << 4)
64 #define GICD_CTLR_ARE_S             (1U << 4)
65 #define GICD_CTLR_ARE_NS            (1U << 5)
66 #define GICD_CTLR_DS                (1U << 6)
67 #define GICD_CTLR_E1NWF             (1U << 7)
68 #define GICD_CTLR_RWP               (1U << 31)
69 
70 /*
71  * Redistributor frame offsets from RD_base
72  */
73 #define GICR_SGI_OFFSET 0x10000
74 
75 /*
76  * Redistributor registers, offsets from RD_base
77  */
78 #define GICR_CTLR             0x0000
79 #define GICR_IIDR             0x0004
80 #define GICR_TYPER            0x0008
81 #define GICR_STATUSR          0x0010
82 #define GICR_WAKER            0x0014
83 #define GICR_SETLPIR          0x0040
84 #define GICR_CLRLPIR          0x0048
85 #define GICR_PROPBASER        0x0070
86 #define GICR_PENDBASER        0x0078
87 #define GICR_INVLPIR          0x00A0
88 #define GICR_INVALLR          0x00B0
89 #define GICR_SYNCR            0x00C0
90 #define GICR_IDREGS           0xFFD0
91 
92 /* SGI and PPI Redistributor registers, offsets from RD_base */
93 #define GICR_IGROUPR0         (GICR_SGI_OFFSET + 0x0080)
94 #define GICR_ISENABLER0       (GICR_SGI_OFFSET + 0x0100)
95 #define GICR_ICENABLER0       (GICR_SGI_OFFSET + 0x0180)
96 #define GICR_ISPENDR0         (GICR_SGI_OFFSET + 0x0200)
97 #define GICR_ICPENDR0         (GICR_SGI_OFFSET + 0x0280)
98 #define GICR_ISACTIVER0       (GICR_SGI_OFFSET + 0x0300)
99 #define GICR_ICACTIVER0       (GICR_SGI_OFFSET + 0x0380)
100 #define GICR_IPRIORITYR       (GICR_SGI_OFFSET + 0x0400)
101 #define GICR_ICFGR0           (GICR_SGI_OFFSET + 0x0C00)
102 #define GICR_ICFGR1           (GICR_SGI_OFFSET + 0x0C04)
103 #define GICR_IGRPMODR0        (GICR_SGI_OFFSET + 0x0D00)
104 #define GICR_NSACR            (GICR_SGI_OFFSET + 0x0E00)
105 
106 #define GICR_CTLR_ENABLE_LPIS        (1U << 0)
107 #define GICR_CTLR_RWP                (1U << 3)
108 #define GICR_CTLR_DPG0               (1U << 24)
109 #define GICR_CTLR_DPG1NS             (1U << 25)
110 #define GICR_CTLR_DPG1S              (1U << 26)
111 #define GICR_CTLR_UWP                (1U << 31)
112 
113 #define GICR_TYPER_PLPIS             (1U << 0)
114 #define GICR_TYPER_VLPIS             (1U << 1)
115 #define GICR_TYPER_DIRECTLPI         (1U << 3)
116 #define GICR_TYPER_LAST              (1U << 4)
117 #define GICR_TYPER_DPGS              (1U << 5)
118 #define GICR_TYPER_PROCNUM           (0xFFFFU << 8)
119 #define GICR_TYPER_COMMONLPIAFF      (0x3 << 24)
120 #define GICR_TYPER_AFFINITYVALUE     (0xFFFFFFFFULL << 32)
121 
122 #define GICR_WAKER_ProcessorSleep    (1U << 1)
123 #define GICR_WAKER_ChildrenAsleep    (1U << 2)
124 
125 #define GICR_PROPBASER_OUTER_CACHEABILITY_MASK (7ULL << 56)
126 #define GICR_PROPBASER_ADDR_MASK               (0xfffffffffULL << 12)
127 #define GICR_PROPBASER_SHAREABILITY_MASK       (3U << 10)
128 #define GICR_PROPBASER_CACHEABILITY_MASK       (7U << 7)
129 #define GICR_PROPBASER_IDBITS_MASK             (0x1f)
130 
131 #define GICR_PENDBASER_PTZ                     (1ULL << 62)
132 #define GICR_PENDBASER_OUTER_CACHEABILITY_MASK (7ULL << 56)
133 #define GICR_PENDBASER_ADDR_MASK               (0xffffffffULL << 16)
134 #define GICR_PENDBASER_SHAREABILITY_MASK       (3U << 10)
135 #define GICR_PENDBASER_CACHEABILITY_MASK       (7U << 7)
136 
137 #define ICC_CTLR_EL1_CBPR           (1U << 0)
138 #define ICC_CTLR_EL1_EOIMODE        (1U << 1)
139 #define ICC_CTLR_EL1_PMHE           (1U << 6)
140 #define ICC_CTLR_EL1_PRIBITS_SHIFT 8
141 #define ICC_CTLR_EL1_IDBITS_SHIFT 11
142 #define ICC_CTLR_EL1_SEIS           (1U << 14)
143 #define ICC_CTLR_EL1_A3V            (1U << 15)
144 
145 #define ICC_PMR_PRIORITY_MASK    0xff
146 #define ICC_BPR_BINARYPOINT_MASK 0x07
147 #define ICC_IGRPEN_ENABLE        0x01
148 
149 #define ICC_CTLR_EL3_CBPR_EL1S (1U << 0)
150 #define ICC_CTLR_EL3_CBPR_EL1NS (1U << 1)
151 #define ICC_CTLR_EL3_EOIMODE_EL3 (1U << 2)
152 #define ICC_CTLR_EL3_EOIMODE_EL1S (1U << 3)
153 #define ICC_CTLR_EL3_EOIMODE_EL1NS (1U << 4)
154 #define ICC_CTLR_EL3_RM (1U << 5)
155 #define ICC_CTLR_EL3_PMHE (1U << 6)
156 #define ICC_CTLR_EL3_PRIBITS_SHIFT 8
157 #define ICC_CTLR_EL3_IDBITS_SHIFT 11
158 #define ICC_CTLR_EL3_SEIS (1U << 14)
159 #define ICC_CTLR_EL3_A3V (1U << 15)
160 #define ICC_CTLR_EL3_NDS (1U << 17)
161 
162 /* Functions internal to the emulated GICv3 */
163 
164 /**
165  * gicv3_redist_update:
166  * @cs: GICv3CPUState for this redistributor
167  *
168  * Recalculate the highest priority pending interrupt after a
169  * change to redistributor state, and inform the CPU accordingly.
170  */
171 void gicv3_redist_update(GICv3CPUState *cs);
172 
173 /**
174  * gicv3_update:
175  * @s: GICv3State
176  * @start: first interrupt whose state changed
177  * @len: length of the range of interrupts whose state changed
178  *
179  * Recalculate the highest priority pending interrupts after a
180  * change to the distributor state affecting @len interrupts
181  * starting at @start, and inform the CPUs accordingly.
182  */
183 void gicv3_update(GICv3State *s, int start, int len);
184 
185 /**
186  * gicv3_full_update_noirqset:
187  * @s: GICv3State
188  *
189  * Recalculate the cached information about highest priority
190  * pending interrupts, but don't inform the CPUs. This should be
191  * called after an incoming migration has loaded new state.
192  */
193 void gicv3_full_update_noirqset(GICv3State *s);
194 
195 /**
196  * gicv3_full_update:
197  * @s: GICv3State
198  *
199  * Recalculate the highest priority pending interrupts after
200  * a change that could affect the status of all interrupts,
201  * and inform the CPUs accordingly.
202  */
203 void gicv3_full_update(GICv3State *s);
204 
205 /**
206  * gicv3_cpuif_update:
207  * @cs: GICv3CPUState for the CPU to update
208  *
209  * Recalculate whether to assert the IRQ or FIQ lines after a change
210  * to the current highest priority pending interrupt, the CPU's
211  * current running priority or the CPU's current exception level or
212  * security state.
213  */
214 static inline void gicv3_cpuif_update(GICv3CPUState *cs)
215 {
216     /* This will be implemented in a later commit. */
217 }
218 
219 static inline uint32_t gicv3_iidr(void)
220 {
221     /* Return the Implementer Identification Register value
222      * for the emulated GICv3, as reported in GICD_IIDR and GICR_IIDR.
223      *
224      * We claim to be an ARM r0p0 with a zero ProductID.
225      * This is the same as an r0p0 GIC-500.
226      */
227     return 0x43b;
228 }
229 
230 static inline uint32_t gicv3_idreg(int regoffset)
231 {
232     /* Return the value of the CoreSight ID register at the specified
233      * offset from the first ID register (as found in the distributor
234      * and redistributor register banks).
235      * These values indicate an ARM implementation of a GICv3.
236      */
237     static const uint8_t gicd_ids[] = {
238         0x44, 0x00, 0x00, 0x00, 0x92, 0xB4, 0x3B, 0x00, 0x0D, 0xF0, 0x05, 0xB1
239     };
240     return gicd_ids[regoffset / 4];
241 }
242 
243 /**
244  * gicv3_irq_group:
245  *
246  * Return the group which this interrupt is configured as (GICV3_G0,
247  * GICV3_G1 or GICV3_G1NS).
248  */
249 static inline int gicv3_irq_group(GICv3State *s, GICv3CPUState *cs, int irq)
250 {
251     bool grpbit, grpmodbit;
252 
253     if (irq < GIC_INTERNAL) {
254         grpbit = extract32(cs->gicr_igroupr0, irq, 1);
255         grpmodbit = extract32(cs->gicr_igrpmodr0, irq, 1);
256     } else {
257         grpbit = gicv3_gicd_group_test(s, irq);
258         grpmodbit = gicv3_gicd_grpmod_test(s, irq);
259     }
260     if (grpbit) {
261         return GICV3_G1NS;
262     }
263     if (s->gicd_ctlr & GICD_CTLR_DS) {
264         return GICV3_G0;
265     }
266     return grpmodbit ? GICV3_G1 : GICV3_G0;
267 }
268 
269 /**
270  * gicv3_redist_affid:
271  *
272  * Return the 32-bit affinity ID of the CPU connected to this redistributor
273  */
274 static inline uint32_t gicv3_redist_affid(GICv3CPUState *cs)
275 {
276     return cs->gicr_typer >> 32;
277 }
278 
279 /**
280  * gicv3_cache_target_cpustate:
281  *
282  * Update the cached CPU state corresponding to the target for this interrupt
283  * (which is kept in s->gicd_irouter_target[]).
284  */
285 static inline void gicv3_cache_target_cpustate(GICv3State *s, int irq)
286 {
287     GICv3CPUState *cs = NULL;
288     int i;
289     uint32_t tgtaff = extract64(s->gicd_irouter[irq], 0, 24) |
290         extract64(s->gicd_irouter[irq], 32, 8) << 24;
291 
292     for (i = 0; i < s->num_cpu; i++) {
293         if (s->cpu[i].gicr_typer >> 32 == tgtaff) {
294             cs = &s->cpu[i];
295             break;
296         }
297     }
298 
299     s->gicd_irouter_target[irq] = cs;
300 }
301 
302 /**
303  * gicv3_cache_all_target_cpustates:
304  *
305  * Populate the entire cache of CPU state pointers for interrupt targets
306  * (eg after inbound migration or CPU reset)
307  */
308 static inline void gicv3_cache_all_target_cpustates(GICv3State *s)
309 {
310     int irq;
311 
312     for (irq = GIC_INTERNAL; irq < GICV3_MAXIRQ; irq++) {
313         gicv3_cache_target_cpustate(s, irq);
314     }
315 }
316 
317 #endif /* !QEMU_ARM_GIC_INTERNAL_H */
318