1 /* SPDX-License-Identifier: GPL-2.0-only */ 2 /* 3 * Copyright (C) 2012,2013 - ARM Ltd 4 * Author: Marc Zyngier <marc.zyngier@arm.com> 5 */ 6 7 #ifndef __ARM64_KVM_ARM_H__ 8 #define __ARM64_KVM_ARM_H__ 9 10 #include <asm/esr.h> 11 #include <asm/memory.h> 12 #include <asm/types.h> 13 14 /* Hyp Configuration Register (HCR) bits */ 15 #define HCR_ATA (UL(1) << 56) 16 #define HCR_FWB (UL(1) << 46) 17 #define HCR_API (UL(1) << 41) 18 #define HCR_APK (UL(1) << 40) 19 #define HCR_TEA (UL(1) << 37) 20 #define HCR_TERR (UL(1) << 36) 21 #define HCR_TLOR (UL(1) << 35) 22 #define HCR_E2H (UL(1) << 34) 23 #define HCR_ID (UL(1) << 33) 24 #define HCR_CD (UL(1) << 32) 25 #define HCR_RW_SHIFT 31 26 #define HCR_RW (UL(1) << HCR_RW_SHIFT) 27 #define HCR_TRVM (UL(1) << 30) 28 #define HCR_HCD (UL(1) << 29) 29 #define HCR_TDZ (UL(1) << 28) 30 #define HCR_TGE (UL(1) << 27) 31 #define HCR_TVM (UL(1) << 26) 32 #define HCR_TTLB (UL(1) << 25) 33 #define HCR_TPU (UL(1) << 24) 34 #define HCR_TPC (UL(1) << 23) 35 #define HCR_TSW (UL(1) << 22) 36 #define HCR_TAC (UL(1) << 21) 37 #define HCR_TIDCP (UL(1) << 20) 38 #define HCR_TSC (UL(1) << 19) 39 #define HCR_TID3 (UL(1) << 18) 40 #define HCR_TID2 (UL(1) << 17) 41 #define HCR_TID1 (UL(1) << 16) 42 #define HCR_TID0 (UL(1) << 15) 43 #define HCR_TWE (UL(1) << 14) 44 #define HCR_TWI (UL(1) << 13) 45 #define HCR_DC (UL(1) << 12) 46 #define HCR_BSU (3 << 10) 47 #define HCR_BSU_IS (UL(1) << 10) 48 #define HCR_FB (UL(1) << 9) 49 #define HCR_VSE (UL(1) << 8) 50 #define HCR_VI (UL(1) << 7) 51 #define HCR_VF (UL(1) << 6) 52 #define HCR_AMO (UL(1) << 5) 53 #define HCR_IMO (UL(1) << 4) 54 #define HCR_FMO (UL(1) << 3) 55 #define HCR_PTW (UL(1) << 2) 56 #define HCR_SWIO (UL(1) << 1) 57 #define HCR_VM (UL(1) << 0) 58 59 /* 60 * The bits we set in HCR: 61 * TLOR: Trap LORegion register accesses 62 * RW: 64bit by default, can be overridden for 32bit VMs 63 * TAC: Trap ACTLR 64 * TSC: Trap SMC 65 * TSW: Trap cache operations by set/way 66 * TWE: Trap WFE 67 * TWI: Trap WFI 68 * TIDCP: Trap L2CTLR/L2ECTLR 69 * BSU_IS: Upgrade barriers to the inner shareable domain 70 * FB: Force broadcast of all maintenance operations 71 * AMO: Override CPSR.A and enable signaling with VA 72 * IMO: Override CPSR.I and enable signaling with VI 73 * FMO: Override CPSR.F and enable signaling with VF 74 * SWIO: Turn set/way invalidates into set/way clean+invalidate 75 * PTW: Take a stage2 fault if a stage1 walk steps in device memory 76 */ 77 #define HCR_GUEST_FLAGS (HCR_TSC | HCR_TSW | HCR_TWE | HCR_TWI | HCR_VM | \ 78 HCR_BSU_IS | HCR_FB | HCR_TAC | \ 79 HCR_AMO | HCR_SWIO | HCR_TIDCP | HCR_RW | HCR_TLOR | \ 80 HCR_FMO | HCR_IMO | HCR_PTW ) 81 #define HCR_VIRT_EXCP_MASK (HCR_VSE | HCR_VI | HCR_VF) 82 #define HCR_HOST_NVHE_FLAGS (HCR_RW | HCR_API | HCR_APK | HCR_ATA) 83 #define HCR_HOST_NVHE_PROTECTED_FLAGS (HCR_HOST_NVHE_FLAGS | HCR_TSC) 84 #define HCR_HOST_VHE_FLAGS (HCR_RW | HCR_TGE | HCR_E2H) 85 86 /* TCR_EL2 Registers bits */ 87 #define TCR_EL2_RES1 ((1 << 31) | (1 << 23)) 88 #define TCR_EL2_TBI (1 << 20) 89 #define TCR_EL2_PS_SHIFT 16 90 #define TCR_EL2_PS_MASK (7 << TCR_EL2_PS_SHIFT) 91 #define TCR_EL2_PS_40B (2 << TCR_EL2_PS_SHIFT) 92 #define TCR_EL2_TG0_MASK TCR_TG0_MASK 93 #define TCR_EL2_SH0_MASK TCR_SH0_MASK 94 #define TCR_EL2_ORGN0_MASK TCR_ORGN0_MASK 95 #define TCR_EL2_IRGN0_MASK TCR_IRGN0_MASK 96 #define TCR_EL2_T0SZ_MASK 0x3f 97 #define TCR_EL2_MASK (TCR_EL2_TG0_MASK | TCR_EL2_SH0_MASK | \ 98 TCR_EL2_ORGN0_MASK | TCR_EL2_IRGN0_MASK | TCR_EL2_T0SZ_MASK) 99 100 /* VTCR_EL2 Registers bits */ 101 #define VTCR_EL2_RES1 (1U << 31) 102 #define VTCR_EL2_HD (1 << 22) 103 #define VTCR_EL2_HA (1 << 21) 104 #define VTCR_EL2_PS_SHIFT TCR_EL2_PS_SHIFT 105 #define VTCR_EL2_PS_MASK TCR_EL2_PS_MASK 106 #define VTCR_EL2_TG0_MASK TCR_TG0_MASK 107 #define VTCR_EL2_TG0_4K TCR_TG0_4K 108 #define VTCR_EL2_TG0_16K TCR_TG0_16K 109 #define VTCR_EL2_TG0_64K TCR_TG0_64K 110 #define VTCR_EL2_SH0_MASK TCR_SH0_MASK 111 #define VTCR_EL2_SH0_INNER TCR_SH0_INNER 112 #define VTCR_EL2_ORGN0_MASK TCR_ORGN0_MASK 113 #define VTCR_EL2_ORGN0_WBWA TCR_ORGN0_WBWA 114 #define VTCR_EL2_IRGN0_MASK TCR_IRGN0_MASK 115 #define VTCR_EL2_IRGN0_WBWA TCR_IRGN0_WBWA 116 #define VTCR_EL2_SL0_SHIFT 6 117 #define VTCR_EL2_SL0_MASK (3 << VTCR_EL2_SL0_SHIFT) 118 #define VTCR_EL2_T0SZ_MASK 0x3f 119 #define VTCR_EL2_VS_SHIFT 19 120 #define VTCR_EL2_VS_8BIT (0 << VTCR_EL2_VS_SHIFT) 121 #define VTCR_EL2_VS_16BIT (1 << VTCR_EL2_VS_SHIFT) 122 123 #define VTCR_EL2_T0SZ(x) TCR_T0SZ(x) 124 125 /* 126 * We configure the Stage-2 page tables to always restrict the IPA space to be 127 * 40 bits wide (T0SZ = 24). Systems with a PARange smaller than 40 bits are 128 * not known to exist and will break with this configuration. 129 * 130 * The VTCR_EL2 is configured per VM and is initialised in kvm_arm_setup_stage2(). 131 * 132 * Note that when using 4K pages, we concatenate two first level page tables 133 * together. With 16K pages, we concatenate 16 first level page tables. 134 * 135 */ 136 137 #define VTCR_EL2_COMMON_BITS (VTCR_EL2_SH0_INNER | VTCR_EL2_ORGN0_WBWA | \ 138 VTCR_EL2_IRGN0_WBWA | VTCR_EL2_RES1) 139 140 /* 141 * VTCR_EL2:SL0 indicates the entry level for Stage2 translation. 142 * Interestingly, it depends on the page size. 143 * See D.10.2.121, VTCR_EL2, in ARM DDI 0487C.a 144 * 145 * ----------------------------------------- 146 * | Entry level | 4K | 16K/64K | 147 * ------------------------------------------ 148 * | Level: 0 | 2 | - | 149 * ------------------------------------------ 150 * | Level: 1 | 1 | 2 | 151 * ------------------------------------------ 152 * | Level: 2 | 0 | 1 | 153 * ------------------------------------------ 154 * | Level: 3 | - | 0 | 155 * ------------------------------------------ 156 * 157 * The table roughly translates to : 158 * 159 * SL0(PAGE_SIZE, Entry_level) = TGRAN_SL0_BASE - Entry_Level 160 * 161 * Where TGRAN_SL0_BASE is a magic number depending on the page size: 162 * TGRAN_SL0_BASE(4K) = 2 163 * TGRAN_SL0_BASE(16K) = 3 164 * TGRAN_SL0_BASE(64K) = 3 165 * provided we take care of ruling out the unsupported cases and 166 * Entry_Level = 4 - Number_of_levels. 167 * 168 */ 169 #ifdef CONFIG_ARM64_64K_PAGES 170 171 #define VTCR_EL2_TGRAN VTCR_EL2_TG0_64K 172 #define VTCR_EL2_TGRAN_SL0_BASE 3UL 173 174 #elif defined(CONFIG_ARM64_16K_PAGES) 175 176 #define VTCR_EL2_TGRAN VTCR_EL2_TG0_16K 177 #define VTCR_EL2_TGRAN_SL0_BASE 3UL 178 179 #else /* 4K */ 180 181 #define VTCR_EL2_TGRAN VTCR_EL2_TG0_4K 182 #define VTCR_EL2_TGRAN_SL0_BASE 2UL 183 184 #endif 185 186 #define VTCR_EL2_LVLS_TO_SL0(levels) \ 187 ((VTCR_EL2_TGRAN_SL0_BASE - (4 - (levels))) << VTCR_EL2_SL0_SHIFT) 188 #define VTCR_EL2_SL0_TO_LVLS(sl0) \ 189 ((sl0) + 4 - VTCR_EL2_TGRAN_SL0_BASE) 190 #define VTCR_EL2_LVLS(vtcr) \ 191 VTCR_EL2_SL0_TO_LVLS(((vtcr) & VTCR_EL2_SL0_MASK) >> VTCR_EL2_SL0_SHIFT) 192 193 #define VTCR_EL2_FLAGS (VTCR_EL2_COMMON_BITS | VTCR_EL2_TGRAN) 194 #define VTCR_EL2_IPA(vtcr) (64 - ((vtcr) & VTCR_EL2_T0SZ_MASK)) 195 196 /* 197 * ARM VMSAv8-64 defines an algorithm for finding the translation table 198 * descriptors in section D4.2.8 in ARM DDI 0487C.a. 199 * 200 * The algorithm defines the expectations on the translation table 201 * addresses for each level, based on PAGE_SIZE, entry level 202 * and the translation table size (T0SZ). The variable "x" in the 203 * algorithm determines the alignment of a table base address at a given 204 * level and thus determines the alignment of VTTBR:BADDR for stage2 205 * page table entry level. 206 * Since the number of bits resolved at the entry level could vary 207 * depending on the T0SZ, the value of "x" is defined based on a 208 * Magic constant for a given PAGE_SIZE and Entry Level. The 209 * intermediate levels must be always aligned to the PAGE_SIZE (i.e, 210 * x = PAGE_SHIFT). 211 * 212 * The value of "x" for entry level is calculated as : 213 * x = Magic_N - T0SZ 214 * 215 * where Magic_N is an integer depending on the page size and the entry 216 * level of the page table as below: 217 * 218 * -------------------------------------------- 219 * | Entry level | 4K 16K 64K | 220 * -------------------------------------------- 221 * | Level: 0 (4 levels) | 28 | - | - | 222 * -------------------------------------------- 223 * | Level: 1 (3 levels) | 37 | 31 | 25 | 224 * -------------------------------------------- 225 * | Level: 2 (2 levels) | 46 | 42 | 38 | 226 * -------------------------------------------- 227 * | Level: 3 (1 level) | - | 53 | 51 | 228 * -------------------------------------------- 229 * 230 * We have a magic formula for the Magic_N below: 231 * 232 * Magic_N(PAGE_SIZE, Level) = 64 - ((PAGE_SHIFT - 3) * Number_of_levels) 233 * 234 * where Number_of_levels = (4 - Level). We are only interested in the 235 * value for Entry_Level for the stage2 page table. 236 * 237 * So, given that T0SZ = (64 - IPA_SHIFT), we can compute 'x' as follows: 238 * 239 * x = (64 - ((PAGE_SHIFT - 3) * Number_of_levels)) - (64 - IPA_SHIFT) 240 * = IPA_SHIFT - ((PAGE_SHIFT - 3) * Number of levels) 241 * 242 * Here is one way to explain the Magic Formula: 243 * 244 * x = log2(Size_of_Entry_Level_Table) 245 * 246 * Since, we can resolve (PAGE_SHIFT - 3) bits at each level, and another 247 * PAGE_SHIFT bits in the PTE, we have : 248 * 249 * Bits_Entry_level = IPA_SHIFT - ((PAGE_SHIFT - 3) * (n - 1) + PAGE_SHIFT) 250 * = IPA_SHIFT - (PAGE_SHIFT - 3) * n - 3 251 * where n = number of levels, and since each pointer is 8bytes, we have: 252 * 253 * x = Bits_Entry_Level + 3 254 * = IPA_SHIFT - (PAGE_SHIFT - 3) * n 255 * 256 * The only constraint here is that, we have to find the number of page table 257 * levels for a given IPA size (which we do, see stage2_pt_levels()) 258 */ 259 #define ARM64_VTTBR_X(ipa, levels) ((ipa) - ((levels) * (PAGE_SHIFT - 3))) 260 261 #define VTTBR_CNP_BIT (UL(1)) 262 #define VTTBR_VMID_SHIFT (UL(48)) 263 #define VTTBR_VMID_MASK(size) (_AT(u64, (1 << size) - 1) << VTTBR_VMID_SHIFT) 264 265 /* Hyp System Trap Register */ 266 #define HSTR_EL2_T(x) (1 << x) 267 268 /* Hyp Coprocessor Trap Register Shifts */ 269 #define CPTR_EL2_TFP_SHIFT 10 270 271 /* Hyp Coprocessor Trap Register */ 272 #define CPTR_EL2_TCPAC (1 << 31) 273 #define CPTR_EL2_TAM (1 << 30) 274 #define CPTR_EL2_TTA (1 << 20) 275 #define CPTR_EL2_TFP (1 << CPTR_EL2_TFP_SHIFT) 276 #define CPTR_EL2_TZ (1 << 8) 277 #define CPTR_EL2_RES1 0x000032ff /* known RES1 bits in CPTR_EL2 */ 278 #define CPTR_EL2_DEFAULT CPTR_EL2_RES1 279 280 /* Hyp Debug Configuration Register bits */ 281 #define MDCR_EL2_E2TB_MASK (UL(0x3)) 282 #define MDCR_EL2_E2TB_SHIFT (UL(24)) 283 #define MDCR_EL2_TTRF (1 << 19) 284 #define MDCR_EL2_TPMS (1 << 14) 285 #define MDCR_EL2_E2PB_MASK (UL(0x3)) 286 #define MDCR_EL2_E2PB_SHIFT (UL(12)) 287 #define MDCR_EL2_TDRA (1 << 11) 288 #define MDCR_EL2_TDOSA (1 << 10) 289 #define MDCR_EL2_TDA (1 << 9) 290 #define MDCR_EL2_TDE (1 << 8) 291 #define MDCR_EL2_HPME (1 << 7) 292 #define MDCR_EL2_TPM (1 << 6) 293 #define MDCR_EL2_TPMCR (1 << 5) 294 #define MDCR_EL2_HPMN_MASK (0x1F) 295 296 /* For compatibility with fault code shared with 32-bit */ 297 #define FSC_FAULT ESR_ELx_FSC_FAULT 298 #define FSC_ACCESS ESR_ELx_FSC_ACCESS 299 #define FSC_PERM ESR_ELx_FSC_PERM 300 #define FSC_SEA ESR_ELx_FSC_EXTABT 301 #define FSC_SEA_TTW0 (0x14) 302 #define FSC_SEA_TTW1 (0x15) 303 #define FSC_SEA_TTW2 (0x16) 304 #define FSC_SEA_TTW3 (0x17) 305 #define FSC_SECC (0x18) 306 #define FSC_SECC_TTW0 (0x1c) 307 #define FSC_SECC_TTW1 (0x1d) 308 #define FSC_SECC_TTW2 (0x1e) 309 #define FSC_SECC_TTW3 (0x1f) 310 311 /* Hyp Prefetch Fault Address Register (HPFAR/HDFAR) */ 312 #define HPFAR_MASK (~UL(0xf)) 313 /* 314 * We have 315 * PAR [PA_Shift - 1 : 12] = PA [PA_Shift - 1 : 12] 316 * HPFAR [PA_Shift - 9 : 4] = FIPA [PA_Shift - 1 : 12] 317 */ 318 #define PAR_TO_HPFAR(par) \ 319 (((par) & GENMASK_ULL(PHYS_MASK_SHIFT - 1, 12)) >> 8) 320 321 #define ECN(x) { ESR_ELx_EC_##x, #x } 322 323 #define kvm_arm_exception_class \ 324 ECN(UNKNOWN), ECN(WFx), ECN(CP15_32), ECN(CP15_64), ECN(CP14_MR), \ 325 ECN(CP14_LS), ECN(FP_ASIMD), ECN(CP10_ID), ECN(PAC), ECN(CP14_64), \ 326 ECN(SVC64), ECN(HVC64), ECN(SMC64), ECN(SYS64), ECN(SVE), \ 327 ECN(IMP_DEF), ECN(IABT_LOW), ECN(IABT_CUR), \ 328 ECN(PC_ALIGN), ECN(DABT_LOW), ECN(DABT_CUR), \ 329 ECN(SP_ALIGN), ECN(FP_EXC32), ECN(FP_EXC64), ECN(SERROR), \ 330 ECN(BREAKPT_LOW), ECN(BREAKPT_CUR), ECN(SOFTSTP_LOW), \ 331 ECN(SOFTSTP_CUR), ECN(WATCHPT_LOW), ECN(WATCHPT_CUR), \ 332 ECN(BKPT32), ECN(VECTOR32), ECN(BRK64) 333 334 #define CPACR_EL1_FPEN (3 << 20) 335 #define CPACR_EL1_TTA (1 << 28) 336 #define CPACR_EL1_DEFAULT (CPACR_EL1_FPEN | CPACR_EL1_ZEN_EL1EN) 337 338 #endif /* __ARM64_KVM_ARM_H__ */ 339