2 * Copyright (C) 2012 ARM Ltd.
3 * Author: Marc Zyngier <marc.zyngier@arm.com>
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License version 2 as
7 * published by the Free Software Foundation.
9 * This program is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 * GNU General Public License for more details.
14 * You should have received a copy of the GNU General Public License
15 * along with this program; if not, write to the Free Software
16 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
19 #ifndef __ASM_ARM_KVM_VGIC_H
20 #define __ASM_ARM_KVM_VGIC_H
22 #include <linux/kernel.h>
23 #include <linux/kvm.h>
24 #include <linux/irqreturn.h>
25 #include <linux/spinlock.h>
26 #include <linux/types.h>
28 #define VGIC_NR_IRQS 256
29 #define VGIC_NR_SGIS 16
30 #define VGIC_NR_PPIS 16
31 #define VGIC_NR_PRIVATE_IRQS (VGIC_NR_SGIS + VGIC_NR_PPIS)
32 #define VGIC_NR_SHARED_IRQS (VGIC_NR_IRQS - VGIC_NR_PRIVATE_IRQS)
33 #define VGIC_MAX_CPUS KVM_MAX_VCPUS
35 #define VGIC_V2_MAX_LRS (1 << 6)
36 #define VGIC_V3_MAX_LRS 16
38 /* Sanity checks... */
39 #if (VGIC_MAX_CPUS > 8)
40 #error Invalid number of CPU interfaces
43 #if (VGIC_NR_IRQS & 31)
44 #error "VGIC_NR_IRQS must be a multiple of 32"
47 #if (VGIC_NR_IRQS > 1024)
48 #error "VGIC_NR_IRQS must be <= 1024"
52 * The GIC distributor registers describing interrupts have two parts:
53 * - 32 per-CPU interrupts (SGI + PPI)
54 * - a bunch of shared interrupts (SPI)
58 * - One UL per VCPU for private interrupts (assumes UL is at
60 * - As many UL as necessary for shared interrupts.
62 * The private interrupts are accessed via the "private"
63 * field, one UL per vcpu (the state for vcpu n is in
64 * private[n]). The shared interrupts are accessed via the
65 * "shared" pointer (IRQn state is at bit n-32 in the bitmap).
67 unsigned long *private;
68 unsigned long *shared
;
73 * - 8 u32 per VCPU for private interrupts
74 * - As many u32 as necessary for shared interrupts.
76 * The private interrupts are accessed via the "private"
77 * field, (the state for vcpu n is in private[n*8] to
78 * private[n*8 + 7]). The shared interrupts are accessed via
79 * the "shared" pointer (IRQn state is at byte (n-32)%4 of the
80 * shared[(n-32)/4] word).
89 VGIC_V2
, /* Good ol' GICv2 */
90 VGIC_V3
, /* New fancy GICv3 */
93 #define LR_STATE_PENDING (1 << 0)
94 #define LR_STATE_ACTIVE (1 << 1)
95 #define LR_STATE_MASK (3 << 0)
96 #define LR_EOI_INT (1 << 2)
112 struct vgic_lr (*get_lr
)(const struct kvm_vcpu
*, int);
113 void (*set_lr
)(struct kvm_vcpu
*, int, struct vgic_lr
);
114 void (*sync_lr_elrsr
)(struct kvm_vcpu
*, int, struct vgic_lr
);
115 u64 (*get_elrsr
)(const struct kvm_vcpu
*vcpu
);
116 u64 (*get_eisr
)(const struct kvm_vcpu
*vcpu
);
117 u32 (*get_interrupt_status
)(const struct kvm_vcpu
*vcpu
);
118 void (*enable_underflow
)(struct kvm_vcpu
*vcpu
);
119 void (*disable_underflow
)(struct kvm_vcpu
*vcpu
);
120 void (*get_vmcr
)(struct kvm_vcpu
*vcpu
, struct vgic_vmcr
*vmcr
);
121 void (*set_vmcr
)(struct kvm_vcpu
*vcpu
, struct vgic_vmcr
*vmcr
);
122 void (*enable
)(struct kvm_vcpu
*vcpu
);
128 /* Physical address of vgic virtual cpu interface */
129 phys_addr_t vcpu_base
;
130 /* Number of list registers */
132 /* Interrupt number */
133 unsigned int maint_irq
;
134 /* Virtual control interface base address */
135 void __iomem
*vctrl_base
;
139 #ifdef CONFIG_KVM_ARM_VGIC
147 /* Virtual control interface mapping */
148 void __iomem
*vctrl_base
;
150 /* Distributor and vcpu interface mapping in the guest */
151 phys_addr_t vgic_dist_base
;
152 phys_addr_t vgic_cpu_base
;
154 /* Distributor enabled */
157 /* Interrupt enabled (one bit per IRQ) */
158 struct vgic_bitmap irq_enabled
;
160 /* Level-triggered interrupt external input is asserted */
161 struct vgic_bitmap irq_level
;
164 * Interrupt state is pending on the distributor
166 struct vgic_bitmap irq_pending
;
169 * Tracks writes to GICD_ISPENDRn and GICD_ICPENDRn for level-triggered
170 * interrupts. Essentially holds the state of the flip-flop in
171 * Figure 4-10 on page 4-101 in ARM IHI 0048B.b.
172 * Once set, it is only cleared for level-triggered interrupts on
173 * guest ACKs (when we queue it) or writes to GICD_ICPENDRn.
175 struct vgic_bitmap irq_soft_pend
;
177 /* Level-triggered interrupt queued on VCPU interface */
178 struct vgic_bitmap irq_queued
;
180 /* Interrupt priority. Not used yet. */
181 struct vgic_bytemap irq_priority
;
183 /* Level/edge triggered */
184 struct vgic_bitmap irq_cfg
;
187 * Source CPU per SGI and target CPU:
189 * Each byte represent a SGI observable on a VCPU, each bit of
190 * this byte indicating if the corresponding VCPU has
191 * generated this interrupt. This is a GICv2 feature only.
193 * For VCPUn (n < 8), irq_sgi_sources[n*16] to [n*16 + 15] are
194 * the SGIs observable on VCPUn.
199 * Target CPU for each SPI:
201 * Array of available SPI, each byte indicating the target
202 * VCPU for SPI. IRQn (n >=32) is at irq_spi_cpu[n-32].
207 * Reverse lookup of irq_spi_cpu for faster compute pending:
209 * Array of bitmaps, one per VCPU, describing if IRQn is
210 * routed to a particular VCPU.
212 struct vgic_bitmap
*irq_spi_target
;
214 /* Bitmap indicating which CPU has something pending */
215 unsigned long *irq_pending_on_cpu
;
219 struct vgic_v2_cpu_if
{
222 u32 vgic_misr
; /* Saved only */
223 u32 vgic_eisr
[2]; /* Saved only */
224 u32 vgic_elrsr
[2]; /* Saved only */
226 u32 vgic_lr
[VGIC_V2_MAX_LRS
];
229 struct vgic_v3_cpu_if
{
230 #ifdef CONFIG_ARM_GIC_V3
233 u32 vgic_misr
; /* Saved only */
234 u32 vgic_eisr
; /* Saved only */
235 u32 vgic_elrsr
; /* Saved only */
238 u64 vgic_lr
[VGIC_V3_MAX_LRS
];
243 #ifdef CONFIG_KVM_ARM_VGIC
244 /* per IRQ to LR mapping */
247 /* Pending interrupts on this VCPU */
248 DECLARE_BITMAP( pending_percpu
, VGIC_NR_PRIVATE_IRQS
);
249 unsigned long *pending_shared
;
251 /* Bitmap of used/free list registers */
252 DECLARE_BITMAP( lr_used
, VGIC_V2_MAX_LRS
);
254 /* Number of list registers on this CPU */
257 /* CPU vif control registers for world switch */
259 struct vgic_v2_cpu_if vgic_v2
;
260 struct vgic_v3_cpu_if vgic_v3
;
265 #define LR_EMPTY 0xff
267 #define INT_STATUS_EOI (1 << 0)
268 #define INT_STATUS_UNDERFLOW (1 << 1)
273 struct kvm_exit_mmio
;
275 #ifdef CONFIG_KVM_ARM_VGIC
276 int kvm_vgic_addr(struct kvm
*kvm
, unsigned long type
, u64
*addr
, bool write
);
277 int kvm_vgic_hyp_init(void);
278 int kvm_vgic_init(struct kvm
*kvm
);
279 int kvm_vgic_create(struct kvm
*kvm
);
280 void kvm_vgic_destroy(struct kvm
*kvm
);
281 int kvm_vgic_vcpu_init(struct kvm_vcpu
*vcpu
);
282 void kvm_vgic_vcpu_destroy(struct kvm_vcpu
*vcpu
);
283 void kvm_vgic_flush_hwstate(struct kvm_vcpu
*vcpu
);
284 void kvm_vgic_sync_hwstate(struct kvm_vcpu
*vcpu
);
285 int kvm_vgic_inject_irq(struct kvm
*kvm
, int cpuid
, unsigned int irq_num
,
287 int kvm_vgic_vcpu_pending_irq(struct kvm_vcpu
*vcpu
);
288 bool vgic_handle_mmio(struct kvm_vcpu
*vcpu
, struct kvm_run
*run
,
289 struct kvm_exit_mmio
*mmio
);
291 #define irqchip_in_kernel(k) (!!((k)->arch.vgic.in_kernel))
292 #define vgic_initialized(k) ((k)->arch.vgic.ready)
294 int vgic_v2_probe(struct device_node
*vgic_node
,
295 const struct vgic_ops
**ops
,
296 const struct vgic_params
**params
);
297 #ifdef CONFIG_ARM_GIC_V3
298 int vgic_v3_probe(struct device_node
*vgic_node
,
299 const struct vgic_ops
**ops
,
300 const struct vgic_params
**params
);
302 static inline int vgic_v3_probe(struct device_node
*vgic_node
,
303 const struct vgic_ops
**ops
,
304 const struct vgic_params
**params
)
311 static inline int kvm_vgic_hyp_init(void)
316 static inline int kvm_vgic_set_addr(struct kvm
*kvm
, unsigned long type
, u64 addr
)
321 static inline int kvm_vgic_addr(struct kvm
*kvm
, unsigned long type
, u64
*addr
, bool write
)
326 static inline int kvm_vgic_init(struct kvm
*kvm
)
331 static inline int kvm_vgic_create(struct kvm
*kvm
)
336 static inline int kvm_vgic_vcpu_init(struct kvm_vcpu
*vcpu
)
341 static inline void kvm_vgic_flush_hwstate(struct kvm_vcpu
*vcpu
) {}
342 static inline void kvm_vgic_sync_hwstate(struct kvm_vcpu
*vcpu
) {}
344 static inline int kvm_vgic_inject_irq(struct kvm
*kvm
, int cpuid
,
345 unsigned int irq_num
, bool level
)
350 static inline int kvm_vgic_vcpu_pending_irq(struct kvm_vcpu
*vcpu
)
355 static inline bool vgic_handle_mmio(struct kvm_vcpu
*vcpu
, struct kvm_run
*run
,
356 struct kvm_exit_mmio
*mmio
)
361 static inline int irqchip_in_kernel(struct kvm
*kvm
)
366 static inline bool vgic_initialized(struct kvm
*kvm
)