arch/arm64/include/asm/kvm_arm.h

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