/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */ /* * Copyright (C) 2019 Western Digital Corporation or its affiliates. * * Authors: * Anup Patel */ #ifndef __LINUX_KVM_RISCV_H #define __LINUX_KVM_RISCV_H #ifndef __ASSEMBLY__ #include #include #include #define __KVM_HAVE_IRQ_LINE #define KVM_COALESCED_MMIO_PAGE_OFFSET 1 #define KVM_INTERRUPT_SET -1U #define KVM_INTERRUPT_UNSET -2U /* for KVM_GET_REGS and KVM_SET_REGS */ struct kvm_regs { }; /* for KVM_GET_FPU and KVM_SET_FPU */ struct kvm_fpu { }; /* KVM Debug exit structure */ struct kvm_debug_exit_arch { }; /* for KVM_SET_GUEST_DEBUG */ struct kvm_guest_debug_arch { }; /* definition of registers in kvm_run */ struct kvm_sync_regs { }; /* for KVM_GET_SREGS and KVM_SET_SREGS */ struct kvm_sregs { }; /* CONFIG registers for KVM_GET_ONE_REG and KVM_SET_ONE_REG */ struct kvm_riscv_config { unsigned long isa; unsigned long zicbom_block_size; unsigned long mvendorid; unsigned long marchid; unsigned long mimpid; unsigned long zicboz_block_size; unsigned long satp_mode; }; /* CORE registers for KVM_GET_ONE_REG and KVM_SET_ONE_REG */ struct kvm_riscv_core { struct user_regs_struct regs; unsigned long mode; }; /* Possible privilege modes for kvm_riscv_core */ #define KVM_RISCV_MODE_S 1 #define KVM_RISCV_MODE_U 0 /* General CSR registers for KVM_GET_ONE_REG and KVM_SET_ONE_REG */ struct kvm_riscv_csr { unsigned long sstatus; unsigned long sie; unsigned long stvec; unsigned long sscratch; unsigned long sepc; unsigned long scause; unsigned long stval; unsigned long sip; unsigned long satp; unsigned long scounteren; unsigned long senvcfg; }; /* AIA CSR registers for KVM_GET_ONE_REG and KVM_SET_ONE_REG */ struct kvm_riscv_aia_csr { unsigned long siselect; unsigned long iprio1; unsigned long iprio2; unsigned long sieh; unsigned long siph; unsigned long iprio1h; unsigned long iprio2h; }; /* Smstateen CSR for KVM_GET_ONE_REG and KVM_SET_ONE_REG */ struct kvm_riscv_smstateen_csr { unsigned long sstateen0; }; /* TIMER registers for KVM_GET_ONE_REG and KVM_SET_ONE_REG */ struct kvm_riscv_timer { __u64 frequency; __u64 time; __u64 compare; __u64 state; }; /* * ISA extension IDs specific to KVM. This is not the same as the host ISA * extension IDs as that is internal to the host and should not be exposed * to the guest. This should always be contiguous to keep the mapping simple * in KVM implementation. */ enum KVM_RISCV_ISA_EXT_ID { KVM_RISCV_ISA_EXT_A = 0, KVM_RISCV_ISA_EXT_C, KVM_RISCV_ISA_EXT_D, KVM_RISCV_ISA_EXT_F, KVM_RISCV_ISA_EXT_H, KVM_RISCV_ISA_EXT_I, KVM_RISCV_ISA_EXT_M, KVM_RISCV_ISA_EXT_SVPBMT, KVM_RISCV_ISA_EXT_SSTC, KVM_RISCV_ISA_EXT_SVINVAL, KVM_RISCV_ISA_EXT_ZIHINTPAUSE, KVM_RISCV_ISA_EXT_ZICBOM, KVM_RISCV_ISA_EXT_ZICBOZ, KVM_RISCV_ISA_EXT_ZBB, KVM_RISCV_ISA_EXT_SSAIA, KVM_RISCV_ISA_EXT_V, KVM_RISCV_ISA_EXT_SVNAPOT, KVM_RISCV_ISA_EXT_ZBA, KVM_RISCV_ISA_EXT_ZBS, KVM_RISCV_ISA_EXT_ZICNTR, KVM_RISCV_ISA_EXT_ZICSR, KVM_RISCV_ISA_EXT_ZIFENCEI, KVM_RISCV_ISA_EXT_ZIHPM, KVM_RISCV_ISA_EXT_SMSTATEEN, KVM_RISCV_ISA_EXT_ZICOND, KVM_RISCV_ISA_EXT_ZBC, KVM_RISCV_ISA_EXT_ZBKB, KVM_RISCV_ISA_EXT_ZBKC, KVM_RISCV_ISA_EXT_ZBKX, KVM_RISCV_ISA_EXT_ZKND, KVM_RISCV_ISA_EXT_ZKNE, KVM_RISCV_ISA_EXT_ZKNH, KVM_RISCV_ISA_EXT_ZKR, KVM_RISCV_ISA_EXT_ZKSED, KVM_RISCV_ISA_EXT_ZKSH, KVM_RISCV_ISA_EXT_ZKT, KVM_RISCV_ISA_EXT_ZVBB, KVM_RISCV_ISA_EXT_ZVBC, KVM_RISCV_ISA_EXT_ZVKB, KVM_RISCV_ISA_EXT_ZVKG, KVM_RISCV_ISA_EXT_ZVKNED, KVM_RISCV_ISA_EXT_ZVKNHA, KVM_RISCV_ISA_EXT_ZVKNHB, KVM_RISCV_ISA_EXT_ZVKSED, KVM_RISCV_ISA_EXT_ZVKSH, KVM_RISCV_ISA_EXT_ZVKT, KVM_RISCV_ISA_EXT_ZFH, KVM_RISCV_ISA_EXT_ZFHMIN, KVM_RISCV_ISA_EXT_ZIHINTNTL, KVM_RISCV_ISA_EXT_ZVFH, KVM_RISCV_ISA_EXT_ZVFHMIN, KVM_RISCV_ISA_EXT_ZFA, KVM_RISCV_ISA_EXT_ZTSO, KVM_RISCV_ISA_EXT_ZACAS, KVM_RISCV_ISA_EXT_SSCOFPMF, KVM_RISCV_ISA_EXT_ZIMOP, KVM_RISCV_ISA_EXT_ZCA, KVM_RISCV_ISA_EXT_ZCB, KVM_RISCV_ISA_EXT_ZCD, KVM_RISCV_ISA_EXT_ZCF, KVM_RISCV_ISA_EXT_ZCMOP, KVM_RISCV_ISA_EXT_ZAWRS, KVM_RISCV_ISA_EXT_SMNPM, KVM_RISCV_ISA_EXT_SSNPM, KVM_RISCV_ISA_EXT_SVADE, KVM_RISCV_ISA_EXT_SVADU, KVM_RISCV_ISA_EXT_MAX, }; /* * SBI extension IDs specific to KVM. This is not the same as the SBI * extension IDs defined by the RISC-V SBI specification. */ enum KVM_RISCV_SBI_EXT_ID { KVM_RISCV_SBI_EXT_V01 = 0, KVM_RISCV_SBI_EXT_TIME, KVM_RISCV_SBI_EXT_IPI, KVM_RISCV_SBI_EXT_RFENCE, KVM_RISCV_SBI_EXT_SRST, KVM_RISCV_SBI_EXT_HSM, KVM_RISCV_SBI_EXT_PMU, KVM_RISCV_SBI_EXT_EXPERIMENTAL, KVM_RISCV_SBI_EXT_VENDOR, KVM_RISCV_SBI_EXT_DBCN, KVM_RISCV_SBI_EXT_STA, KVM_RISCV_SBI_EXT_MAX, }; /* SBI STA extension registers for KVM_GET_ONE_REG and KVM_SET_ONE_REG */ struct kvm_riscv_sbi_sta { unsigned long shmem_lo; unsigned long shmem_hi; }; /* Possible states for kvm_riscv_timer */ #define KVM_RISCV_TIMER_STATE_OFF 0 #define KVM_RISCV_TIMER_STATE_ON 1 #define KVM_REG_SIZE(id) \ (1U << (((id) & KVM_REG_SIZE_MASK) >> KVM_REG_SIZE_SHIFT)) /* If you need to interpret the index values, here is the key: */ #define KVM_REG_RISCV_TYPE_MASK 0x00000000FF000000 #define KVM_REG_RISCV_TYPE_SHIFT 24 #define KVM_REG_RISCV_SUBTYPE_MASK 0x0000000000FF0000 #define KVM_REG_RISCV_SUBTYPE_SHIFT 16 /* Config registers are mapped as type 1 */ #define KVM_REG_RISCV_CONFIG (0x01 << KVM_REG_RISCV_TYPE_SHIFT) #define KVM_REG_RISCV_CONFIG_REG(name) \ (offsetof(struct kvm_riscv_config, name) / sizeof(unsigned long)) /* Core registers are mapped as type 2 */ #define KVM_REG_RISCV_CORE (0x02 << KVM_REG_RISCV_TYPE_SHIFT) #define KVM_REG_RISCV_CORE_REG(name) \ (offsetof(struct kvm_riscv_core, name) / sizeof(unsigned long)) /* Control and status registers are mapped as type 3 */ #define KVM_REG_RISCV_CSR (0x03 << KVM_REG_RISCV_TYPE_SHIFT) #define KVM_REG_RISCV_CSR_GENERAL (0x0 << KVM_REG_RISCV_SUBTYPE_SHIFT) #define KVM_REG_RISCV_CSR_AIA (0x1 << KVM_REG_RISCV_SUBTYPE_SHIFT) #define KVM_REG_RISCV_CSR_SMSTATEEN (0x2 << KVM_REG_RISCV_SUBTYPE_SHIFT) #define KVM_REG_RISCV_CSR_REG(name) \ (offsetof(struct kvm_riscv_csr, name) / sizeof(unsigned long)) #define KVM_REG_RISCV_CSR_AIA_REG(name) \ (offsetof(struct kvm_riscv_aia_csr, name) / sizeof(unsigned long)) #define KVM_REG_RISCV_CSR_SMSTATEEN_REG(name) \ (offsetof(struct kvm_riscv_smstateen_csr, name) / sizeof(unsigned long)) /* Timer registers are mapped as type 4 */ #define KVM_REG_RISCV_TIMER (0x04 << KVM_REG_RISCV_TYPE_SHIFT) #define KVM_REG_RISCV_TIMER_REG(name) \ (offsetof(struct kvm_riscv_timer, name) / sizeof(__u64)) /* F extension registers are mapped as type 5 */ #define KVM_REG_RISCV_FP_F (0x05 << KVM_REG_RISCV_TYPE_SHIFT) #define KVM_REG_RISCV_FP_F_REG(name) \ (offsetof(struct __riscv_f_ext_state, name) / sizeof(__u32)) /* D extension registers are mapped as type 6 */ #define KVM_REG_RISCV_FP_D (0x06 << KVM_REG_RISCV_TYPE_SHIFT) #define KVM_REG_RISCV_FP_D_REG(name) \ (offsetof(struct __riscv_d_ext_state, name) / sizeof(__u64)) /* ISA Extension registers are mapped as type 7 */ #define KVM_REG_RISCV_ISA_EXT (0x07 << KVM_REG_RISCV_TYPE_SHIFT) #define KVM_REG_RISCV_ISA_SINGLE (0x0 << KVM_REG_RISCV_SUBTYPE_SHIFT) #define KVM_REG_RISCV_ISA_MULTI_EN (0x1 << KVM_REG_RISCV_SUBTYPE_SHIFT) #define KVM_REG_RISCV_ISA_MULTI_DIS (0x2 << KVM_REG_RISCV_SUBTYPE_SHIFT) #define KVM_REG_RISCV_ISA_MULTI_REG(__ext_id) \ ((__ext_id) / __BITS_PER_LONG) #define KVM_REG_RISCV_ISA_MULTI_MASK(__ext_id) \ (1UL << ((__ext_id) % __BITS_PER_LONG)) #define KVM_REG_RISCV_ISA_MULTI_REG_LAST \ KVM_REG_RISCV_ISA_MULTI_REG(KVM_RISCV_ISA_EXT_MAX - 1) /* SBI extension registers are mapped as type 8 */ #define KVM_REG_RISCV_SBI_EXT (0x08 << KVM_REG_RISCV_TYPE_SHIFT) #define KVM_REG_RISCV_SBI_SINGLE (0x0 << KVM_REG_RISCV_SUBTYPE_SHIFT) #define KVM_REG_RISCV_SBI_MULTI_EN (0x1 << KVM_REG_RISCV_SUBTYPE_SHIFT) #define KVM_REG_RISCV_SBI_MULTI_DIS (0x2 << KVM_REG_RISCV_SUBTYPE_SHIFT) #define KVM_REG_RISCV_SBI_MULTI_REG(__ext_id) \ ((__ext_id) / __BITS_PER_LONG) #define KVM_REG_RISCV_SBI_MULTI_MASK(__ext_id) \ (1UL << ((__ext_id) % __BITS_PER_LONG)) #define KVM_REG_RISCV_SBI_MULTI_REG_LAST \ KVM_REG_RISCV_SBI_MULTI_REG(KVM_RISCV_SBI_EXT_MAX - 1) /* V extension registers are mapped as type 9 */ #define KVM_REG_RISCV_VECTOR (0x09 << KVM_REG_RISCV_TYPE_SHIFT) #define KVM_REG_RISCV_VECTOR_CSR_REG(name) \ (offsetof(struct __riscv_v_ext_state, name) / sizeof(unsigned long)) #define KVM_REG_RISCV_VECTOR_REG(n) \ ((n) + sizeof(struct __riscv_v_ext_state) / sizeof(unsigned long)) /* Registers for specific SBI extensions are mapped as type 10 */ #define KVM_REG_RISCV_SBI_STATE (0x0a << KVM_REG_RISCV_TYPE_SHIFT) #define KVM_REG_RISCV_SBI_STA (0x0 << KVM_REG_RISCV_SUBTYPE_SHIFT) #define KVM_REG_RISCV_SBI_STA_REG(name) \ (offsetof(struct kvm_riscv_sbi_sta, name) / sizeof(unsigned long)) /* Device Control API: RISC-V AIA */ #define KVM_DEV_RISCV_APLIC_ALIGN 0x1000 #define KVM_DEV_RISCV_APLIC_SIZE 0x4000 #define KVM_DEV_RISCV_APLIC_MAX_HARTS 0x4000 #define KVM_DEV_RISCV_IMSIC_ALIGN 0x1000 #define KVM_DEV_RISCV_IMSIC_SIZE 0x1000 #define KVM_DEV_RISCV_AIA_GRP_CONFIG 0 #define KVM_DEV_RISCV_AIA_CONFIG_MODE 0 #define KVM_DEV_RISCV_AIA_CONFIG_IDS 1 #define KVM_DEV_RISCV_AIA_CONFIG_SRCS 2 #define KVM_DEV_RISCV_AIA_CONFIG_GROUP_BITS 3 #define KVM_DEV_RISCV_AIA_CONFIG_GROUP_SHIFT 4 #define KVM_DEV_RISCV_AIA_CONFIG_HART_BITS 5 #define KVM_DEV_RISCV_AIA_CONFIG_GUEST_BITS 6 /* * Modes of RISC-V AIA device: * 1) EMUL (aka Emulation): Trap-n-emulate IMSIC * 2) HWACCEL (aka HW Acceleration): Virtualize IMSIC using IMSIC guest files * 3) AUTO (aka Automatic): Virtualize IMSIC using IMSIC guest files whenever * available otherwise fallback to trap-n-emulation */ #define KVM_DEV_RISCV_AIA_MODE_EMUL 0 #define KVM_DEV_RISCV_AIA_MODE_HWACCEL 1 #define KVM_DEV_RISCV_AIA_MODE_AUTO 2 #define KVM_DEV_RISCV_AIA_IDS_MIN 63 #define KVM_DEV_RISCV_AIA_IDS_MAX 2048 #define KVM_DEV_RISCV_AIA_SRCS_MAX 1024 #define KVM_DEV_RISCV_AIA_GROUP_BITS_MAX 8 #define KVM_DEV_RISCV_AIA_GROUP_SHIFT_MIN 24 #define KVM_DEV_RISCV_AIA_GROUP_SHIFT_MAX 56 #define KVM_DEV_RISCV_AIA_HART_BITS_MAX 16 #define KVM_DEV_RISCV_AIA_GUEST_BITS_MAX 8 #define KVM_DEV_RISCV_AIA_GRP_ADDR 1 #define KVM_DEV_RISCV_AIA_ADDR_APLIC 0 #define KVM_DEV_RISCV_AIA_ADDR_IMSIC(__vcpu) (1 + (__vcpu)) #define KVM_DEV_RISCV_AIA_ADDR_MAX \ (1 + KVM_DEV_RISCV_APLIC_MAX_HARTS) #define KVM_DEV_RISCV_AIA_GRP_CTRL 2 #define KVM_DEV_RISCV_AIA_CTRL_INIT 0 /* * The device attribute type contains the memory mapped offset of the * APLIC register (range 0x0000-0x3FFF) and it must be 4-byte aligned. */ #define KVM_DEV_RISCV_AIA_GRP_APLIC 3 /* * The lower 12-bits of the device attribute type contains the iselect * value of the IMSIC register (range 0x70-0xFF) whereas the higher order * bits contains the VCPU id. */ #define KVM_DEV_RISCV_AIA_GRP_IMSIC 4 #define KVM_DEV_RISCV_AIA_IMSIC_ISEL_BITS 12 #define KVM_DEV_RISCV_AIA_IMSIC_ISEL_MASK \ ((1U << KVM_DEV_RISCV_AIA_IMSIC_ISEL_BITS) - 1) #define KVM_DEV_RISCV_AIA_IMSIC_MKATTR(__vcpu, __isel) \ (((__vcpu) << KVM_DEV_RISCV_AIA_IMSIC_ISEL_BITS) | \ ((__isel) & KVM_DEV_RISCV_AIA_IMSIC_ISEL_MASK)) #define KVM_DEV_RISCV_AIA_IMSIC_GET_ISEL(__attr) \ ((__attr) & KVM_DEV_RISCV_AIA_IMSIC_ISEL_MASK) #define KVM_DEV_RISCV_AIA_IMSIC_GET_VCPU(__attr) \ ((__attr) >> KVM_DEV_RISCV_AIA_IMSIC_ISEL_BITS) /* One single KVM irqchip, ie. the AIA */ #define KVM_NR_IRQCHIPS 1 #endif #endif /* __LINUX_KVM_RISCV_H */