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