1 /* 2 * Copyright (C) 2012 ARM Ltd. 3 * Author: Marc Zyngier <marc.zyngier@arm.com> 4 * 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. 8 * 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. 13 * 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 17 */ 18 19 #ifndef __ASM_ARM_KVM_VGIC_H 20 #define __ASM_ARM_KVM_VGIC_H 21 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> 27 #include <kvm/iodev.h> 28 #include <linux/irqchip/arm-gic-common.h> 29 30 #define VGIC_NR_IRQS_LEGACY 256 31 #define VGIC_NR_SGIS 16 32 #define VGIC_NR_PPIS 16 33 #define VGIC_NR_PRIVATE_IRQS (VGIC_NR_SGIS + VGIC_NR_PPIS) 34 35 #define VGIC_V2_MAX_LRS (1 << 6) 36 #define VGIC_V3_MAX_LRS 16 37 #define VGIC_MAX_IRQS 1024 38 #define VGIC_V2_MAX_CPUS 8 39 #define VGIC_V3_MAX_CPUS 255 40 41 #if (VGIC_NR_IRQS_LEGACY & 31) 42 #error "VGIC_NR_IRQS must be a multiple of 32" 43 #endif 44 45 #if (VGIC_NR_IRQS_LEGACY > VGIC_MAX_IRQS) 46 #error "VGIC_NR_IRQS must be <= 1024" 47 #endif 48 49 /* 50 * The GIC distributor registers describing interrupts have two parts: 51 * - 32 per-CPU interrupts (SGI + PPI) 52 * - a bunch of shared interrupts (SPI) 53 */ 54 struct vgic_bitmap { 55 /* 56 * - One UL per VCPU for private interrupts (assumes UL is at 57 * least 32 bits) 58 * - As many UL as necessary for shared interrupts. 59 * 60 * The private interrupts are accessed via the "private" 61 * field, one UL per vcpu (the state for vcpu n is in 62 * private[n]). The shared interrupts are accessed via the 63 * "shared" pointer (IRQn state is at bit n-32 in the bitmap). 64 */ 65 unsigned long *private; 66 unsigned long *shared; 67 }; 68 69 struct vgic_bytemap { 70 /* 71 * - 8 u32 per VCPU for private interrupts 72 * - As many u32 as necessary for shared interrupts. 73 * 74 * The private interrupts are accessed via the "private" 75 * field, (the state for vcpu n is in private[n*8] to 76 * private[n*8 + 7]). The shared interrupts are accessed via 77 * the "shared" pointer (IRQn state is at byte (n-32)%4 of the 78 * shared[(n-32)/4] word). 79 */ 80 u32 *private; 81 u32 *shared; 82 }; 83 84 struct kvm_vcpu; 85 86 enum vgic_type { 87 VGIC_V2, /* Good ol' GICv2 */ 88 VGIC_V3, /* New fancy GICv3 */ 89 }; 90 91 #define LR_STATE_PENDING (1 << 0) 92 #define LR_STATE_ACTIVE (1 << 1) 93 #define LR_STATE_MASK (3 << 0) 94 #define LR_EOI_INT (1 << 2) 95 #define LR_HW (1 << 3) 96 97 struct vgic_lr { 98 unsigned irq:10; 99 union { 100 unsigned hwirq:10; 101 unsigned source:3; 102 }; 103 unsigned state:4; 104 }; 105 106 struct vgic_vmcr { 107 u32 ctlr; 108 u32 abpr; 109 u32 bpr; 110 u32 pmr; 111 }; 112 113 struct vgic_ops { 114 struct vgic_lr (*get_lr)(const struct kvm_vcpu *, int); 115 void (*set_lr)(struct kvm_vcpu *, int, struct vgic_lr); 116 u64 (*get_elrsr)(const struct kvm_vcpu *vcpu); 117 u64 (*get_eisr)(const struct kvm_vcpu *vcpu); 118 void (*clear_eisr)(struct kvm_vcpu *vcpu); 119 u32 (*get_interrupt_status)(const struct kvm_vcpu *vcpu); 120 void (*enable_underflow)(struct kvm_vcpu *vcpu); 121 void (*disable_underflow)(struct kvm_vcpu *vcpu); 122 void (*get_vmcr)(struct kvm_vcpu *vcpu, struct vgic_vmcr *vmcr); 123 void (*set_vmcr)(struct kvm_vcpu *vcpu, struct vgic_vmcr *vmcr); 124 void (*enable)(struct kvm_vcpu *vcpu); 125 }; 126 127 struct vgic_params { 128 /* vgic type */ 129 enum vgic_type type; 130 /* Physical address of vgic virtual cpu interface */ 131 phys_addr_t vcpu_base; 132 /* Number of list registers */ 133 u32 nr_lr; 134 /* Interrupt number */ 135 unsigned int maint_irq; 136 /* Virtual control interface base address */ 137 void __iomem *vctrl_base; 138 int max_gic_vcpus; 139 /* Only needed for the legacy KVM_CREATE_IRQCHIP */ 140 bool can_emulate_gicv2; 141 }; 142 143 struct vgic_vm_ops { 144 bool (*queue_sgi)(struct kvm_vcpu *, int irq); 145 void (*add_sgi_source)(struct kvm_vcpu *, int irq, int source); 146 int (*init_model)(struct kvm *); 147 int (*map_resources)(struct kvm *, const struct vgic_params *); 148 }; 149 150 struct vgic_io_device { 151 gpa_t addr; 152 int len; 153 const struct vgic_io_range *reg_ranges; 154 struct kvm_vcpu *redist_vcpu; 155 struct kvm_io_device dev; 156 }; 157 158 struct irq_phys_map { 159 u32 virt_irq; 160 u32 phys_irq; 161 }; 162 163 struct irq_phys_map_entry { 164 struct list_head entry; 165 struct rcu_head rcu; 166 struct irq_phys_map map; 167 }; 168 169 struct vgic_dist { 170 spinlock_t lock; 171 bool in_kernel; 172 bool ready; 173 174 /* vGIC model the kernel emulates for the guest (GICv2 or GICv3) */ 175 u32 vgic_model; 176 177 int nr_cpus; 178 int nr_irqs; 179 180 /* Virtual control interface mapping */ 181 void __iomem *vctrl_base; 182 183 /* Distributor and vcpu interface mapping in the guest */ 184 phys_addr_t vgic_dist_base; 185 /* GICv2 and GICv3 use different mapped register blocks */ 186 union { 187 phys_addr_t vgic_cpu_base; 188 phys_addr_t vgic_redist_base; 189 }; 190 191 /* Distributor enabled */ 192 u32 enabled; 193 194 /* Interrupt enabled (one bit per IRQ) */ 195 struct vgic_bitmap irq_enabled; 196 197 /* Level-triggered interrupt external input is asserted */ 198 struct vgic_bitmap irq_level; 199 200 /* 201 * Interrupt state is pending on the distributor 202 */ 203 struct vgic_bitmap irq_pending; 204 205 /* 206 * Tracks writes to GICD_ISPENDRn and GICD_ICPENDRn for level-triggered 207 * interrupts. Essentially holds the state of the flip-flop in 208 * Figure 4-10 on page 4-101 in ARM IHI 0048B.b. 209 * Once set, it is only cleared for level-triggered interrupts on 210 * guest ACKs (when we queue it) or writes to GICD_ICPENDRn. 211 */ 212 struct vgic_bitmap irq_soft_pend; 213 214 /* Level-triggered interrupt queued on VCPU interface */ 215 struct vgic_bitmap irq_queued; 216 217 /* Interrupt was active when unqueue from VCPU interface */ 218 struct vgic_bitmap irq_active; 219 220 /* Interrupt priority. Not used yet. */ 221 struct vgic_bytemap irq_priority; 222 223 /* Level/edge triggered */ 224 struct vgic_bitmap irq_cfg; 225 226 /* 227 * Source CPU per SGI and target CPU: 228 * 229 * Each byte represent a SGI observable on a VCPU, each bit of 230 * this byte indicating if the corresponding VCPU has 231 * generated this interrupt. This is a GICv2 feature only. 232 * 233 * For VCPUn (n < 8), irq_sgi_sources[n*16] to [n*16 + 15] are 234 * the SGIs observable on VCPUn. 235 */ 236 u8 *irq_sgi_sources; 237 238 /* 239 * Target CPU for each SPI: 240 * 241 * Array of available SPI, each byte indicating the target 242 * VCPU for SPI. IRQn (n >=32) is at irq_spi_cpu[n-32]. 243 */ 244 u8 *irq_spi_cpu; 245 246 /* 247 * Reverse lookup of irq_spi_cpu for faster compute pending: 248 * 249 * Array of bitmaps, one per VCPU, describing if IRQn is 250 * routed to a particular VCPU. 251 */ 252 struct vgic_bitmap *irq_spi_target; 253 254 /* Target MPIDR for each IRQ (needed for GICv3 IROUTERn) only */ 255 u32 *irq_spi_mpidr; 256 257 /* Bitmap indicating which CPU has something pending */ 258 unsigned long *irq_pending_on_cpu; 259 260 /* Bitmap indicating which CPU has active IRQs */ 261 unsigned long *irq_active_on_cpu; 262 263 struct vgic_vm_ops vm_ops; 264 struct vgic_io_device dist_iodev; 265 struct vgic_io_device *redist_iodevs; 266 267 /* Virtual irq to hwirq mapping */ 268 spinlock_t irq_phys_map_lock; 269 struct list_head irq_phys_map_list; 270 }; 271 272 struct vgic_v2_cpu_if { 273 u32 vgic_hcr; 274 u32 vgic_vmcr; 275 u32 vgic_misr; /* Saved only */ 276 u64 vgic_eisr; /* Saved only */ 277 u64 vgic_elrsr; /* Saved only */ 278 u32 vgic_apr; 279 u32 vgic_lr[VGIC_V2_MAX_LRS]; 280 }; 281 282 struct vgic_v3_cpu_if { 283 #ifdef CONFIG_KVM_ARM_VGIC_V3 284 u32 vgic_hcr; 285 u32 vgic_vmcr; 286 u32 vgic_sre; /* Restored only, change ignored */ 287 u32 vgic_misr; /* Saved only */ 288 u32 vgic_eisr; /* Saved only */ 289 u32 vgic_elrsr; /* Saved only */ 290 u32 vgic_ap0r[4]; 291 u32 vgic_ap1r[4]; 292 u64 vgic_lr[VGIC_V3_MAX_LRS]; 293 #endif 294 }; 295 296 struct vgic_cpu { 297 /* Pending/active/both interrupts on this VCPU */ 298 DECLARE_BITMAP(pending_percpu, VGIC_NR_PRIVATE_IRQS); 299 DECLARE_BITMAP(active_percpu, VGIC_NR_PRIVATE_IRQS); 300 DECLARE_BITMAP(pend_act_percpu, VGIC_NR_PRIVATE_IRQS); 301 302 /* Pending/active/both shared interrupts, dynamically sized */ 303 unsigned long *pending_shared; 304 unsigned long *active_shared; 305 unsigned long *pend_act_shared; 306 307 /* CPU vif control registers for world switch */ 308 union { 309 struct vgic_v2_cpu_if vgic_v2; 310 struct vgic_v3_cpu_if vgic_v3; 311 }; 312 313 /* Protected by the distributor's irq_phys_map_lock */ 314 struct list_head irq_phys_map_list; 315 316 u64 live_lrs; 317 }; 318 319 #define LR_EMPTY 0xff 320 321 #define INT_STATUS_EOI (1 << 0) 322 #define INT_STATUS_UNDERFLOW (1 << 1) 323 324 struct kvm; 325 struct kvm_vcpu; 326 327 int kvm_vgic_addr(struct kvm *kvm, unsigned long type, u64 *addr, bool write); 328 int kvm_vgic_hyp_init(void); 329 int kvm_vgic_map_resources(struct kvm *kvm); 330 int kvm_vgic_get_max_vcpus(void); 331 void kvm_vgic_early_init(struct kvm *kvm); 332 int kvm_vgic_create(struct kvm *kvm, u32 type); 333 void kvm_vgic_destroy(struct kvm *kvm); 334 void kvm_vgic_vcpu_early_init(struct kvm_vcpu *vcpu); 335 void kvm_vgic_vcpu_destroy(struct kvm_vcpu *vcpu); 336 void kvm_vgic_flush_hwstate(struct kvm_vcpu *vcpu); 337 void kvm_vgic_sync_hwstate(struct kvm_vcpu *vcpu); 338 int kvm_vgic_inject_irq(struct kvm *kvm, int cpuid, unsigned int irq_num, 339 bool level); 340 int kvm_vgic_inject_mapped_irq(struct kvm *kvm, int cpuid, 341 unsigned int virt_irq, bool level); 342 void vgic_v3_dispatch_sgi(struct kvm_vcpu *vcpu, u64 reg); 343 int kvm_vgic_vcpu_pending_irq(struct kvm_vcpu *vcpu); 344 int kvm_vgic_map_phys_irq(struct kvm_vcpu *vcpu, int virt_irq, int phys_irq); 345 int kvm_vgic_unmap_phys_irq(struct kvm_vcpu *vcpu, unsigned int virt_irq); 346 bool kvm_vgic_map_is_active(struct kvm_vcpu *vcpu, unsigned int virt_irq); 347 348 #define irqchip_in_kernel(k) (!!((k)->arch.vgic.in_kernel)) 349 #define vgic_initialized(k) (!!((k)->arch.vgic.nr_cpus)) 350 #define vgic_ready(k) ((k)->arch.vgic.ready) 351 352 int vgic_v2_probe(const struct gic_kvm_info *gic_kvm_info, 353 const struct vgic_ops **ops, 354 const struct vgic_params **params); 355 #ifdef CONFIG_KVM_ARM_VGIC_V3 356 int vgic_v3_probe(const struct gic_kvm_info *gic_kvm_info, 357 const struct vgic_ops **ops, 358 const struct vgic_params **params); 359 #else 360 static inline int vgic_v3_probe(const struct gic_kvm_info *gic_kvm_info, 361 const struct vgic_ops **ops, 362 const struct vgic_params **params) 363 { 364 return -ENODEV; 365 } 366 #endif 367 368 #endif 369