blob: ac553f9171a635834263936b463df3447831d543 [file] [log] [blame]
b.liue9582032025-04-17 19:18:16 +08001/* SPDX-License-Identifier: GPL-2.0-only */
2/*
3 * Copyright (C) 2015, 2016 ARM Ltd.
4 */
5#ifndef __KVM_ARM_VGIC_NEW_H__
6#define __KVM_ARM_VGIC_NEW_H__
7
8#include <linux/irqchip/arm-gic-common.h>
9#include <asm/kvm_mmu.h>
10
11#define PRODUCT_ID_KVM 0x4b /* ASCII code K */
12#define IMPLEMENTER_ARM 0x43b
13
14#define VGIC_ADDR_UNDEF (-1)
15#define IS_VGIC_ADDR_UNDEF(_x) ((_x) == VGIC_ADDR_UNDEF)
16
17#define INTERRUPT_ID_BITS_SPIS 10
18#define INTERRUPT_ID_BITS_ITS 16
19#define VGIC_PRI_BITS 5
20
21#define vgic_irq_is_sgi(intid) ((intid) < VGIC_NR_SGIS)
22
23#define VGIC_AFFINITY_0_SHIFT 0
24#define VGIC_AFFINITY_0_MASK (0xffUL << VGIC_AFFINITY_0_SHIFT)
25#define VGIC_AFFINITY_1_SHIFT 8
26#define VGIC_AFFINITY_1_MASK (0xffUL << VGIC_AFFINITY_1_SHIFT)
27#define VGIC_AFFINITY_2_SHIFT 16
28#define VGIC_AFFINITY_2_MASK (0xffUL << VGIC_AFFINITY_2_SHIFT)
29#define VGIC_AFFINITY_3_SHIFT 24
30#define VGIC_AFFINITY_3_MASK (0xffUL << VGIC_AFFINITY_3_SHIFT)
31
32#define VGIC_AFFINITY_LEVEL(reg, level) \
33 ((((reg) & VGIC_AFFINITY_## level ##_MASK) \
34 >> VGIC_AFFINITY_## level ##_SHIFT) << MPIDR_LEVEL_SHIFT(level))
35
36/*
37 * The Userspace encodes the affinity differently from the MPIDR,
38 * Below macro converts vgic userspace format to MPIDR reg format.
39 */
40#define VGIC_TO_MPIDR(val) (VGIC_AFFINITY_LEVEL(val, 0) | \
41 VGIC_AFFINITY_LEVEL(val, 1) | \
42 VGIC_AFFINITY_LEVEL(val, 2) | \
43 VGIC_AFFINITY_LEVEL(val, 3))
44
45/*
46 * As per Documentation/virt/kvm/devices/arm-vgic-v3.txt,
47 * below macros are defined for CPUREG encoding.
48 */
49#define KVM_REG_ARM_VGIC_SYSREG_OP0_MASK 0x000000000000c000
50#define KVM_REG_ARM_VGIC_SYSREG_OP0_SHIFT 14
51#define KVM_REG_ARM_VGIC_SYSREG_OP1_MASK 0x0000000000003800
52#define KVM_REG_ARM_VGIC_SYSREG_OP1_SHIFT 11
53#define KVM_REG_ARM_VGIC_SYSREG_CRN_MASK 0x0000000000000780
54#define KVM_REG_ARM_VGIC_SYSREG_CRN_SHIFT 7
55#define KVM_REG_ARM_VGIC_SYSREG_CRM_MASK 0x0000000000000078
56#define KVM_REG_ARM_VGIC_SYSREG_CRM_SHIFT 3
57#define KVM_REG_ARM_VGIC_SYSREG_OP2_MASK 0x0000000000000007
58#define KVM_REG_ARM_VGIC_SYSREG_OP2_SHIFT 0
59
60#define KVM_DEV_ARM_VGIC_SYSREG_MASK (KVM_REG_ARM_VGIC_SYSREG_OP0_MASK | \
61 KVM_REG_ARM_VGIC_SYSREG_OP1_MASK | \
62 KVM_REG_ARM_VGIC_SYSREG_CRN_MASK | \
63 KVM_REG_ARM_VGIC_SYSREG_CRM_MASK | \
64 KVM_REG_ARM_VGIC_SYSREG_OP2_MASK)
65
66/*
67 * As per Documentation/virt/kvm/devices/arm-vgic-its.txt,
68 * below macros are defined for ITS table entry encoding.
69 */
70#define KVM_ITS_CTE_VALID_SHIFT 63
71#define KVM_ITS_CTE_VALID_MASK BIT_ULL(63)
72#define KVM_ITS_CTE_RDBASE_SHIFT 16
73#define KVM_ITS_CTE_ICID_MASK GENMASK_ULL(15, 0)
74#define KVM_ITS_ITE_NEXT_SHIFT 48
75#define KVM_ITS_ITE_PINTID_SHIFT 16
76#define KVM_ITS_ITE_PINTID_MASK GENMASK_ULL(47, 16)
77#define KVM_ITS_ITE_ICID_MASK GENMASK_ULL(15, 0)
78#define KVM_ITS_DTE_VALID_SHIFT 63
79#define KVM_ITS_DTE_VALID_MASK BIT_ULL(63)
80#define KVM_ITS_DTE_NEXT_SHIFT 49
81#define KVM_ITS_DTE_NEXT_MASK GENMASK_ULL(62, 49)
82#define KVM_ITS_DTE_ITTADDR_SHIFT 5
83#define KVM_ITS_DTE_ITTADDR_MASK GENMASK_ULL(48, 5)
84#define KVM_ITS_DTE_SIZE_MASK GENMASK_ULL(4, 0)
85#define KVM_ITS_L1E_VALID_MASK BIT_ULL(63)
86/* we only support 64 kB translation table page size */
87#define KVM_ITS_L1E_ADDR_MASK GENMASK_ULL(51, 16)
88
89#define KVM_VGIC_V3_RDIST_INDEX_MASK GENMASK_ULL(11, 0)
90#define KVM_VGIC_V3_RDIST_FLAGS_MASK GENMASK_ULL(15, 12)
91#define KVM_VGIC_V3_RDIST_FLAGS_SHIFT 12
92#define KVM_VGIC_V3_RDIST_BASE_MASK GENMASK_ULL(51, 16)
93#define KVM_VGIC_V3_RDIST_COUNT_MASK GENMASK_ULL(63, 52)
94#define KVM_VGIC_V3_RDIST_COUNT_SHIFT 52
95
96#ifdef CONFIG_DEBUG_SPINLOCK
97#define DEBUG_SPINLOCK_BUG_ON(p) BUG_ON(p)
98#else
99#define DEBUG_SPINLOCK_BUG_ON(p)
100#endif
101
102/* Requires the irq_lock to be held by the caller. */
103static inline bool irq_is_pending(struct vgic_irq *irq)
104{
105 if (irq->config == VGIC_CONFIG_EDGE)
106 return irq->pending_latch;
107 else
108 return irq->pending_latch || irq->line_level;
109}
110
111static inline bool vgic_irq_is_mapped_level(struct vgic_irq *irq)
112{
113 return irq->config == VGIC_CONFIG_LEVEL && irq->hw;
114}
115
116static inline int vgic_irq_get_lr_count(struct vgic_irq *irq)
117{
118 /* Account for the active state as an interrupt */
119 if (vgic_irq_is_sgi(irq->intid) && irq->source)
120 return hweight8(irq->source) + irq->active;
121
122 return irq_is_pending(irq) || irq->active;
123}
124
125static inline bool vgic_irq_is_multi_sgi(struct vgic_irq *irq)
126{
127 return vgic_irq_get_lr_count(irq) > 1;
128}
129
130static inline int vgic_its_read_entry_lock(struct vgic_its *its, gpa_t eaddr,
131 u64 *eval, unsigned long esize)
132{
133 struct kvm *kvm = its->dev->kvm;
134
135 if (KVM_BUG_ON(esize != sizeof(*eval), kvm))
136 return -EINVAL;
137
138 return kvm_read_guest_lock(kvm, eaddr, eval, esize);
139
140}
141
142static inline int vgic_its_write_entry_lock(struct vgic_its *its, gpa_t eaddr,
143 u64 eval, unsigned long esize)
144{
145 struct kvm *kvm = its->dev->kvm;
146
147 if (KVM_BUG_ON(esize != sizeof(eval), kvm))
148 return -EINVAL;
149
150 return kvm_write_guest_lock(kvm, eaddr, &eval, esize);
151}
152
153/*
154 * This struct provides an intermediate representation of the fields contained
155 * in the GICH_VMCR and ICH_VMCR registers, such that code exporting the GIC
156 * state to userspace can generate either GICv2 or GICv3 CPU interface
157 * registers regardless of the hardware backed GIC used.
158 */
159struct vgic_vmcr {
160 u32 grpen0;
161 u32 grpen1;
162
163 u32 ackctl;
164 u32 fiqen;
165 u32 cbpr;
166 u32 eoim;
167
168 u32 abpr;
169 u32 bpr;
170 u32 pmr; /* Priority mask field in the GICC_PMR and
171 * ICC_PMR_EL1 priority field format */
172};
173
174struct vgic_reg_attr {
175 struct kvm_vcpu *vcpu;
176 gpa_t addr;
177};
178
179int vgic_v3_parse_attr(struct kvm_device *dev, struct kvm_device_attr *attr,
180 struct vgic_reg_attr *reg_attr);
181int vgic_v2_parse_attr(struct kvm_device *dev, struct kvm_device_attr *attr,
182 struct vgic_reg_attr *reg_attr);
183const struct vgic_register_region *
184vgic_get_mmio_region(struct kvm_vcpu *vcpu, struct vgic_io_device *iodev,
185 gpa_t addr, int len);
186struct vgic_irq *vgic_get_irq(struct kvm *kvm, struct kvm_vcpu *vcpu,
187 u32 intid);
188void __vgic_put_lpi_locked(struct kvm *kvm, struct vgic_irq *irq);
189void vgic_put_irq(struct kvm *kvm, struct vgic_irq *irq);
190bool vgic_get_phys_line_level(struct vgic_irq *irq);
191void vgic_irq_set_phys_pending(struct vgic_irq *irq, bool pending);
192void vgic_irq_set_phys_active(struct vgic_irq *irq, bool active);
193bool vgic_queue_irq_unlock(struct kvm *kvm, struct vgic_irq *irq,
194 unsigned long flags);
195void vgic_kick_vcpus(struct kvm *kvm);
196
197int vgic_check_ioaddr(struct kvm *kvm, phys_addr_t *ioaddr,
198 phys_addr_t addr, phys_addr_t alignment);
199
200void vgic_v2_fold_lr_state(struct kvm_vcpu *vcpu);
201void vgic_v2_populate_lr(struct kvm_vcpu *vcpu, struct vgic_irq *irq, int lr);
202void vgic_v2_clear_lr(struct kvm_vcpu *vcpu, int lr);
203void vgic_v2_set_underflow(struct kvm_vcpu *vcpu);
204void vgic_v2_set_npie(struct kvm_vcpu *vcpu);
205int vgic_v2_has_attr_regs(struct kvm_device *dev, struct kvm_device_attr *attr);
206int vgic_v2_dist_uaccess(struct kvm_vcpu *vcpu, bool is_write,
207 int offset, u32 *val);
208int vgic_v2_cpuif_uaccess(struct kvm_vcpu *vcpu, bool is_write,
209 int offset, u32 *val);
210void vgic_v2_set_vmcr(struct kvm_vcpu *vcpu, struct vgic_vmcr *vmcr);
211void vgic_v2_get_vmcr(struct kvm_vcpu *vcpu, struct vgic_vmcr *vmcr);
212void vgic_v2_enable(struct kvm_vcpu *vcpu);
213int vgic_v2_probe(const struct gic_kvm_info *info);
214int vgic_v2_map_resources(struct kvm *kvm);
215int vgic_register_dist_iodev(struct kvm *kvm, gpa_t dist_base_address,
216 enum vgic_type);
217
218void vgic_v2_init_lrs(void);
219void vgic_v2_load(struct kvm_vcpu *vcpu);
220void vgic_v2_put(struct kvm_vcpu *vcpu);
221void vgic_v2_vmcr_sync(struct kvm_vcpu *vcpu);
222
223void vgic_v2_save_state(struct kvm_vcpu *vcpu);
224void vgic_v2_restore_state(struct kvm_vcpu *vcpu);
225
226static inline void vgic_get_irq_kref(struct vgic_irq *irq)
227{
228 if (irq->intid < VGIC_MIN_LPI)
229 return;
230
231 kref_get(&irq->refcount);
232}
233
234void vgic_v3_fold_lr_state(struct kvm_vcpu *vcpu);
235void vgic_v3_populate_lr(struct kvm_vcpu *vcpu, struct vgic_irq *irq, int lr);
236void vgic_v3_clear_lr(struct kvm_vcpu *vcpu, int lr);
237void vgic_v3_set_underflow(struct kvm_vcpu *vcpu);
238void vgic_v3_set_npie(struct kvm_vcpu *vcpu);
239void vgic_v3_set_vmcr(struct kvm_vcpu *vcpu, struct vgic_vmcr *vmcr);
240void vgic_v3_get_vmcr(struct kvm_vcpu *vcpu, struct vgic_vmcr *vmcr);
241void vgic_v3_enable(struct kvm_vcpu *vcpu);
242int vgic_v3_probe(const struct gic_kvm_info *info);
243int vgic_v3_map_resources(struct kvm *kvm);
244int vgic_v3_lpi_sync_pending_status(struct kvm *kvm, struct vgic_irq *irq);
245int vgic_v3_save_pending_tables(struct kvm *kvm);
246int vgic_v3_set_redist_base(struct kvm *kvm, u32 index, u64 addr, u32 count);
247int vgic_register_redist_iodev(struct kvm_vcpu *vcpu);
248bool vgic_v3_check_base(struct kvm *kvm);
249
250void vgic_v3_load(struct kvm_vcpu *vcpu);
251void vgic_v3_put(struct kvm_vcpu *vcpu);
252void vgic_v3_vmcr_sync(struct kvm_vcpu *vcpu);
253
254bool vgic_has_its(struct kvm *kvm);
255int kvm_vgic_register_its_device(void);
256void vgic_enable_lpis(struct kvm_vcpu *vcpu);
257void vgic_flush_pending_lpis(struct kvm_vcpu *vcpu);
258int vgic_its_inject_msi(struct kvm *kvm, struct kvm_msi *msi);
259int vgic_v3_has_attr_regs(struct kvm_device *dev, struct kvm_device_attr *attr);
260int vgic_v3_dist_uaccess(struct kvm_vcpu *vcpu, bool is_write,
261 int offset, u32 *val);
262int vgic_v3_redist_uaccess(struct kvm_vcpu *vcpu, bool is_write,
263 int offset, u32 *val);
264int vgic_v3_cpu_sysregs_uaccess(struct kvm_vcpu *vcpu, bool is_write,
265 u64 id, u64 *val);
266int vgic_v3_has_cpu_sysregs_attr(struct kvm_vcpu *vcpu, bool is_write, u64 id,
267 u64 *reg);
268int vgic_v3_line_level_info_uaccess(struct kvm_vcpu *vcpu, bool is_write,
269 u32 intid, u64 *val);
270int kvm_register_vgic_device(unsigned long type);
271void vgic_set_vmcr(struct kvm_vcpu *vcpu, struct vgic_vmcr *vmcr);
272void vgic_get_vmcr(struct kvm_vcpu *vcpu, struct vgic_vmcr *vmcr);
273int vgic_lazy_init(struct kvm *kvm);
274int vgic_init(struct kvm *kvm);
275
276void vgic_debug_init(struct kvm *kvm);
277void vgic_debug_destroy(struct kvm *kvm);
278
279bool lock_all_vcpus(struct kvm *kvm);
280void unlock_all_vcpus(struct kvm *kvm);
281
282static inline int vgic_v3_max_apr_idx(struct kvm_vcpu *vcpu)
283{
284 struct vgic_cpu *cpu_if = &vcpu->arch.vgic_cpu;
285
286 /*
287 * num_pri_bits are initialized with HW supported values.
288 * We can rely safely on num_pri_bits even if VM has not
289 * restored ICC_CTLR_EL1 before restoring APnR registers.
290 */
291 switch (cpu_if->num_pri_bits) {
292 case 7: return 3;
293 case 6: return 1;
294 default: return 0;
295 }
296}
297
298static inline bool
299vgic_v3_redist_region_full(struct vgic_redist_region *region)
300{
301 if (!region->count)
302 return false;
303
304 return (region->free_index >= region->count);
305}
306
307struct vgic_redist_region *vgic_v3_rdist_free_slot(struct list_head *rdregs);
308
309static inline size_t
310vgic_v3_rd_region_size(struct kvm *kvm, struct vgic_redist_region *rdreg)
311{
312 if (!rdreg->count)
313 return atomic_read(&kvm->online_vcpus) * KVM_VGIC_V3_REDIST_SIZE;
314 else
315 return rdreg->count * KVM_VGIC_V3_REDIST_SIZE;
316}
317
318struct vgic_redist_region *vgic_v3_rdist_region_from_index(struct kvm *kvm,
319 u32 index);
320
321bool vgic_v3_rdist_overlap(struct kvm *kvm, gpa_t base, size_t size);
322
323static inline bool vgic_dist_overlap(struct kvm *kvm, gpa_t base, size_t size)
324{
325 struct vgic_dist *d = &kvm->arch.vgic;
326
327 return (base + size > d->vgic_dist_base) &&
328 (base < d->vgic_dist_base + KVM_VGIC_V3_DIST_SIZE);
329}
330
331int vgic_copy_lpi_list(struct kvm *kvm, struct kvm_vcpu *vcpu, u32 **intid_ptr);
332int vgic_its_resolve_lpi(struct kvm *kvm, struct vgic_its *its,
333 u32 devid, u32 eventid, struct vgic_irq **irq);
334struct vgic_its *vgic_msi_to_its(struct kvm *kvm, struct kvm_msi *msi);
335int vgic_its_inject_cached_translation(struct kvm *kvm, struct kvm_msi *msi);
336void vgic_lpi_translation_cache_init(struct kvm *kvm);
337void vgic_lpi_translation_cache_destroy(struct kvm *kvm);
338void vgic_its_invalidate_cache(struct kvm *kvm);
339
340bool vgic_supports_direct_msis(struct kvm *kvm);
341int vgic_v4_init(struct kvm *kvm);
342void vgic_v4_teardown(struct kvm *kvm);
343int vgic_v4_sync_hwstate(struct kvm_vcpu *vcpu);
344int vgic_v4_flush_hwstate(struct kvm_vcpu *vcpu);
345
346#endif