qemu/hw/i386/amd_iommu.h
<<
>>
Prefs
   1/*
   2 * QEMU emulation of an AMD IOMMU (AMD-Vi)
   3 *
   4 * Copyright (C) 2011 Eduard - Gabriel Munteanu
   5 * Copyright (C) 2015, 2016 David Kiarie Kahurani
   6 *
   7 * This program is free software; you can redistribute it and/or modify
   8 * it under the terms of the GNU General Public License as published by
   9 * the Free Software Foundation; either version 2 of the License, or
  10 * (at your option) any later version.
  11
  12 * This program is distributed in the hope that it will be useful,
  13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15 * GNU General Public License for more details.
  16
  17 * You should have received a copy of the GNU General Public License along
  18 * with this program; if not, see <http://www.gnu.org/licenses/>.
  19 */
  20
  21#ifndef AMD_IOMMU_H
  22#define AMD_IOMMU_H
  23
  24#include "hw/pci/pci.h"
  25#include "hw/i386/x86-iommu.h"
  26
  27/* Capability registers */
  28#define AMDVI_CAPAB_BAR_LOW           0x04
  29#define AMDVI_CAPAB_BAR_HIGH          0x08
  30#define AMDVI_CAPAB_RANGE             0x0C
  31#define AMDVI_CAPAB_MISC              0x10
  32
  33#define AMDVI_CAPAB_SIZE              0x18
  34#define AMDVI_CAPAB_REG_SIZE          0x04
  35
  36/* Capability header data */
  37#define AMDVI_CAPAB_ID_SEC            0xf
  38#define AMDVI_CAPAB_FLAT_EXT          (1 << 28)
  39#define AMDVI_CAPAB_EFR_SUP           (1 << 27)
  40#define AMDVI_CAPAB_FLAG_NPCACHE      (1 << 26)
  41#define AMDVI_CAPAB_FLAG_HTTUNNEL     (1 << 25)
  42#define AMDVI_CAPAB_FLAG_IOTLBSUP     (1 << 24)
  43#define AMDVI_CAPAB_INIT_TYPE         (3 << 16)
  44
  45/* No. of used MMIO registers */
  46#define AMDVI_MMIO_REGS_HIGH  7
  47#define AMDVI_MMIO_REGS_LOW   8
  48
  49/* MMIO registers */
  50#define AMDVI_MMIO_DEVICE_TABLE       0x0000
  51#define AMDVI_MMIO_COMMAND_BASE       0x0008
  52#define AMDVI_MMIO_EVENT_BASE         0x0010
  53#define AMDVI_MMIO_CONTROL            0x0018
  54#define AMDVI_MMIO_EXCL_BASE          0x0020
  55#define AMDVI_MMIO_EXCL_LIMIT         0x0028
  56#define AMDVI_MMIO_EXT_FEATURES       0x0030
  57#define AMDVI_MMIO_COMMAND_HEAD       0x2000
  58#define AMDVI_MMIO_COMMAND_TAIL       0x2008
  59#define AMDVI_MMIO_EVENT_HEAD         0x2010
  60#define AMDVI_MMIO_EVENT_TAIL         0x2018
  61#define AMDVI_MMIO_STATUS             0x2020
  62#define AMDVI_MMIO_PPR_BASE           0x0038
  63#define AMDVI_MMIO_PPR_HEAD           0x2030
  64#define AMDVI_MMIO_PPR_TAIL           0x2038
  65
  66#define AMDVI_MMIO_SIZE               0x4000
  67
  68#define AMDVI_MMIO_DEVTAB_SIZE_MASK   ((1ULL << 12) - 1)
  69#define AMDVI_MMIO_DEVTAB_BASE_MASK   (((1ULL << 52) - 1) & ~ \
  70                                       AMDVI_MMIO_DEVTAB_SIZE_MASK)
  71#define AMDVI_MMIO_DEVTAB_ENTRY_SIZE  32
  72#define AMDVI_MMIO_DEVTAB_SIZE_UNIT   4096
  73
  74/* some of this are similar but just for readability */
  75#define AMDVI_MMIO_CMDBUF_SIZE_BYTE       (AMDVI_MMIO_COMMAND_BASE + 7)
  76#define AMDVI_MMIO_CMDBUF_SIZE_MASK       0x0f
  77#define AMDVI_MMIO_CMDBUF_BASE_MASK       AMDVI_MMIO_DEVTAB_BASE_MASK
  78#define AMDVI_MMIO_CMDBUF_HEAD_MASK       (((1ULL << 19) - 1) & ~0x0f)
  79#define AMDVI_MMIO_CMDBUF_TAIL_MASK       AMDVI_MMIO_EVTLOG_HEAD_MASK
  80
  81#define AMDVI_MMIO_EVTLOG_SIZE_BYTE       (AMDVI_MMIO_EVENT_BASE + 7)
  82#define AMDVI_MMIO_EVTLOG_SIZE_MASK       AMDVI_MMIO_CMDBUF_SIZE_MASK
  83#define AMDVI_MMIO_EVTLOG_BASE_MASK       AMDVI_MMIO_CMDBUF_BASE_MASK
  84#define AMDVI_MMIO_EVTLOG_HEAD_MASK       (((1ULL << 19) - 1) & ~0x0f)
  85#define AMDVI_MMIO_EVTLOG_TAIL_MASK       AMDVI_MMIO_EVTLOG_HEAD_MASK
  86
  87#define AMDVI_MMIO_PPRLOG_SIZE_BYTE       (AMDVI_MMIO_EVENT_BASE + 7)
  88#define AMDVI_MMIO_PPRLOG_HEAD_MASK       AMDVI_MMIO_EVTLOG_HEAD_MASK
  89#define AMDVI_MMIO_PPRLOG_TAIL_MASK       AMDVI_MMIO_EVTLOG_HEAD_MASK
  90#define AMDVI_MMIO_PPRLOG_BASE_MASK       AMDVI_MMIO_EVTLOG_BASE_MASK
  91#define AMDVI_MMIO_PPRLOG_SIZE_MASK       AMDVI_MMIO_EVTLOG_SIZE_MASK
  92
  93#define AMDVI_MMIO_EXCL_ENABLED_MASK      (1ULL << 0)
  94#define AMDVI_MMIO_EXCL_ALLOW_MASK        (1ULL << 1)
  95#define AMDVI_MMIO_EXCL_LIMIT_MASK        AMDVI_MMIO_DEVTAB_BASE_MASK
  96#define AMDVI_MMIO_EXCL_LIMIT_LOW         0xfff
  97
  98/* mmio control register flags */
  99#define AMDVI_MMIO_CONTROL_AMDVIEN        (1ULL << 0)
 100#define AMDVI_MMIO_CONTROL_HTTUNEN        (1ULL << 1)
 101#define AMDVI_MMIO_CONTROL_EVENTLOGEN     (1ULL << 2)
 102#define AMDVI_MMIO_CONTROL_EVENTINTEN     (1ULL << 3)
 103#define AMDVI_MMIO_CONTROL_COMWAITINTEN   (1ULL << 4)
 104#define AMDVI_MMIO_CONTROL_CMDBUFLEN      (1ULL << 12)
 105#define AMDVI_MMIO_CONTROL_GAEN           (1ULL << 17)
 106
 107/* MMIO status register bits */
 108#define AMDVI_MMIO_STATUS_CMDBUF_RUN  (1 << 4)
 109#define AMDVI_MMIO_STATUS_EVT_RUN     (1 << 3)
 110#define AMDVI_MMIO_STATUS_COMP_INT    (1 << 2)
 111#define AMDVI_MMIO_STATUS_EVT_OVF     (1 << 0)
 112
 113#define AMDVI_CMDBUF_ID_BYTE              0x07
 114#define AMDVI_CMDBUF_ID_RSHIFT            4
 115
 116#define AMDVI_CMD_COMPLETION_WAIT         0x01
 117#define AMDVI_CMD_INVAL_DEVTAB_ENTRY      0x02
 118#define AMDVI_CMD_INVAL_AMDVI_PAGES       0x03
 119#define AMDVI_CMD_INVAL_IOTLB_PAGES       0x04
 120#define AMDVI_CMD_INVAL_INTR_TABLE        0x05
 121#define AMDVI_CMD_PREFETCH_AMDVI_PAGES    0x06
 122#define AMDVI_CMD_COMPLETE_PPR_REQUEST    0x07
 123#define AMDVI_CMD_INVAL_AMDVI_ALL         0x08
 124
 125#define AMDVI_DEVTAB_ENTRY_SIZE           32
 126
 127/* Device table entry bits 0:63 */
 128#define AMDVI_DEV_VALID                   (1ULL << 0)
 129#define AMDVI_DEV_TRANSLATION_VALID       (1ULL << 1)
 130#define AMDVI_DEV_MODE_MASK               0x7
 131#define AMDVI_DEV_MODE_RSHIFT             9
 132#define AMDVI_DEV_PT_ROOT_MASK            0xffffffffff000
 133#define AMDVI_DEV_PT_ROOT_RSHIFT          12
 134#define AMDVI_DEV_PERM_SHIFT              61
 135#define AMDVI_DEV_PERM_READ               (1ULL << 61)
 136#define AMDVI_DEV_PERM_WRITE              (1ULL << 62)
 137
 138/* Device table entry bits 64:127 */
 139#define AMDVI_DEV_DOMID_ID_MASK          ((1ULL << 16) - 1)
 140
 141/* Event codes and flags, as stored in the info field */
 142#define AMDVI_EVENT_ILLEGAL_DEVTAB_ENTRY  (0x1U << 12)
 143#define AMDVI_EVENT_IOPF                  (0x2U << 12)
 144#define   AMDVI_EVENT_IOPF_I              (1U << 3)
 145#define AMDVI_EVENT_DEV_TAB_HW_ERROR      (0x3U << 12)
 146#define AMDVI_EVENT_PAGE_TAB_HW_ERROR     (0x4U << 12)
 147#define AMDVI_EVENT_ILLEGAL_COMMAND_ERROR (0x5U << 12)
 148#define AMDVI_EVENT_COMMAND_HW_ERROR      (0x6U << 12)
 149
 150#define AMDVI_EVENT_LEN                  16
 151#define AMDVI_PERM_READ             (1 << 0)
 152#define AMDVI_PERM_WRITE            (1 << 1)
 153
 154#define AMDVI_FEATURE_PREFETCH            (1ULL << 0) /* page prefetch       */
 155#define AMDVI_FEATURE_PPR                 (1ULL << 1) /* PPR Support         */
 156#define AMDVI_FEATURE_GT                  (1ULL << 4) /* Guest Translation   */
 157#define AMDVI_FEATURE_IA                  (1ULL << 6) /* inval all support   */
 158#define AMDVI_FEATURE_GA                  (1ULL << 7) /* guest VAPIC support */
 159#define AMDVI_FEATURE_HE                  (1ULL << 8) /* hardware error regs */
 160#define AMDVI_FEATURE_PC                  (1ULL << 9) /* Perf counters       */
 161
 162/* reserved DTE bits */
 163#define AMDVI_DTE_LOWER_QUAD_RESERVED  0x80300000000000fc
 164#define AMDVI_DTE_MIDDLE_QUAD_RESERVED 0x0000000000000100
 165#define AMDVI_DTE_UPPER_QUAD_RESERVED  0x08f0000000000000
 166
 167/* AMDVI paging mode */
 168#define AMDVI_GATS_MODE                 (2ULL <<  12)
 169#define AMDVI_HATS_MODE                 (2ULL <<  10)
 170
 171/* IOTLB */
 172#define AMDVI_IOTLB_MAX_SIZE 1024
 173#define AMDVI_DEVID_SHIFT    36
 174
 175/* extended feature support */
 176#define AMDVI_EXT_FEATURES (AMDVI_FEATURE_PREFETCH | AMDVI_FEATURE_PPR | \
 177        AMDVI_FEATURE_IA | AMDVI_FEATURE_GT | AMDVI_FEATURE_HE | \
 178        AMDVI_GATS_MODE | AMDVI_HATS_MODE | AMDVI_FEATURE_GA)
 179
 180/* capabilities header */
 181#define AMDVI_CAPAB_FEATURES (AMDVI_CAPAB_FLAT_EXT | \
 182        AMDVI_CAPAB_FLAG_NPCACHE | AMDVI_CAPAB_FLAG_IOTLBSUP \
 183        | AMDVI_CAPAB_ID_SEC | AMDVI_CAPAB_INIT_TYPE | \
 184        AMDVI_CAPAB_FLAG_HTTUNNEL |  AMDVI_CAPAB_EFR_SUP)
 185
 186/* AMDVI default address */
 187#define AMDVI_BASE_ADDR 0xfed80000
 188
 189/* page management constants */
 190#define AMDVI_PAGE_SHIFT 12
 191#define AMDVI_PAGE_SIZE  (1ULL << AMDVI_PAGE_SHIFT)
 192
 193#define AMDVI_PAGE_SHIFT_4K 12
 194#define AMDVI_PAGE_MASK_4K  (~((1ULL << AMDVI_PAGE_SHIFT_4K) - 1))
 195
 196#define AMDVI_MAX_VA_ADDR          (48UL << 5)
 197#define AMDVI_MAX_PH_ADDR          (40UL << 8)
 198#define AMDVI_MAX_GVA_ADDR         (48UL << 15)
 199
 200/* Completion Wait data size */
 201#define AMDVI_COMPLETION_DATA_SIZE    8
 202
 203#define AMDVI_COMMAND_SIZE   16
 204/* Completion Wait data size */
 205#define AMDVI_COMPLETION_DATA_SIZE    8
 206
 207#define AMDVI_COMMAND_SIZE   16
 208
 209#define AMDVI_INT_ADDR_FIRST    0xfee00000
 210#define AMDVI_INT_ADDR_LAST     0xfeefffff
 211#define AMDVI_INT_ADDR_SIZE     (AMDVI_INT_ADDR_LAST - AMDVI_INT_ADDR_FIRST + 1)
 212#define AMDVI_MSI_ADDR_HI_MASK  (0xffffffff00000000ULL)
 213#define AMDVI_MSI_ADDR_LO_MASK  (0x00000000ffffffffULL)
 214
 215/* SB IOAPIC is always on this device in AMD systems */
 216#define AMDVI_IOAPIC_SB_DEVID   PCI_BUILD_BDF(0, PCI_DEVFN(0x14, 0))
 217
 218/* Interrupt remapping errors */
 219#define AMDVI_IR_ERR            0x1
 220#define AMDVI_IR_GET_IRTE       0x2
 221#define AMDVI_IR_TARGET_ABORT   0x3
 222
 223/* Interrupt remapping */
 224#define AMDVI_IR_REMAP_ENABLE           1ULL
 225#define AMDVI_IR_INTCTL_SHIFT           60
 226#define AMDVI_IR_INTCTL_ABORT           0
 227#define AMDVI_IR_INTCTL_PASS            1
 228#define AMDVI_IR_INTCTL_REMAP           2
 229
 230#define AMDVI_IR_PHYS_ADDR_MASK         (((1ULL << 45) - 1) << 6)
 231
 232/* MSI data 10:0 bits (section 2.2.5.1 Fig 14) */
 233#define AMDVI_IRTE_OFFSET               0x7ff
 234
 235/* Delivery mode of MSI data (same as IOAPIC deilver mode encoding) */
 236#define AMDVI_IOAPIC_INT_TYPE_FIXED          0x0
 237#define AMDVI_IOAPIC_INT_TYPE_ARBITRATED     0x1
 238#define AMDVI_IOAPIC_INT_TYPE_SMI            0x2
 239#define AMDVI_IOAPIC_INT_TYPE_NMI            0x4
 240#define AMDVI_IOAPIC_INT_TYPE_INIT           0x5
 241#define AMDVI_IOAPIC_INT_TYPE_EINT           0x7
 242
 243/* Pass through interrupt */
 244#define AMDVI_DEV_INT_PASS_MASK         (1ULL << 56)
 245#define AMDVI_DEV_EINT_PASS_MASK        (1ULL << 57)
 246#define AMDVI_DEV_NMI_PASS_MASK         (1ULL << 58)
 247#define AMDVI_DEV_LINT0_PASS_MASK       (1ULL << 62)
 248#define AMDVI_DEV_LINT1_PASS_MASK       (1ULL << 63)
 249
 250/* Interrupt remapping table fields (Guest VAPIC not enabled) */
 251union irte {
 252    uint32_t val;
 253    struct {
 254        uint32_t valid:1,
 255                 no_fault:1,
 256                 int_type:3,
 257                 rq_eoi:1,
 258                 dm:1,
 259                 guest_mode:1,
 260                 destination:8,
 261                 vector:8,
 262                 rsvd:8;
 263    } fields;
 264};
 265
 266/* Interrupt remapping table fields (Guest VAPIC is enabled) */
 267union irte_ga_lo {
 268  uint64_t val;
 269
 270  /* For int remapping */
 271  struct {
 272      uint64_t  valid:1,
 273                no_fault:1,
 274                /* ------ */
 275                int_type:3,
 276                rq_eoi:1,
 277                dm:1,
 278                /* ------ */
 279                guest_mode:1,
 280                destination:8,
 281                rsvd_1:48;
 282  } fields_remap;
 283};
 284
 285union irte_ga_hi {
 286  uint64_t val;
 287  struct {
 288      uint64_t  vector:8,
 289                rsvd_2:56;
 290  } fields;
 291};
 292
 293struct irte_ga {
 294  union irte_ga_lo lo;
 295  union irte_ga_hi hi;
 296};
 297
 298#define TYPE_AMD_IOMMU_DEVICE "amd-iommu"
 299#define AMD_IOMMU_DEVICE(obj)\
 300    OBJECT_CHECK(AMDVIState, (obj), TYPE_AMD_IOMMU_DEVICE)
 301
 302#define TYPE_AMD_IOMMU_PCI "AMDVI-PCI"
 303
 304#define TYPE_AMD_IOMMU_MEMORY_REGION "amd-iommu-iommu-memory-region"
 305
 306typedef struct AMDVIAddressSpace AMDVIAddressSpace;
 307
 308/* functions to steal PCI config space */
 309typedef struct AMDVIPCIState {
 310    PCIDevice dev;               /* The PCI device itself        */
 311} AMDVIPCIState;
 312
 313typedef struct AMDVIState {
 314    X86IOMMUState iommu;        /* IOMMU bus device             */
 315    AMDVIPCIState pci;          /* IOMMU PCI device             */
 316
 317    uint32_t version;
 318    uint32_t capab_offset;       /* capability offset pointer    */
 319
 320    uint64_t mmio_addr;
 321
 322    uint32_t devid;              /* auto-assigned devid          */
 323
 324    bool enabled;                /* IOMMU enabled                */
 325    bool ats_enabled;            /* address translation enabled  */
 326    bool cmdbuf_enabled;         /* command buffer enabled       */
 327    bool evtlog_enabled;         /* event log enabled            */
 328    bool excl_enabled;
 329
 330    hwaddr devtab;               /* base address device table    */
 331    size_t devtab_len;           /* device table length          */
 332
 333    hwaddr cmdbuf;               /* command buffer base address  */
 334    uint64_t cmdbuf_len;         /* command buffer length        */
 335    uint32_t cmdbuf_head;        /* current IOMMU read position  */
 336    uint32_t cmdbuf_tail;        /* next Software write position */
 337    bool completion_wait_intr;
 338
 339    hwaddr evtlog;               /* base address event log       */
 340    bool evtlog_intr;
 341    uint32_t evtlog_len;         /* event log length             */
 342    uint32_t evtlog_head;        /* current IOMMU write position */
 343    uint32_t evtlog_tail;        /* current Software read position */
 344
 345    /* unused for now */
 346    hwaddr excl_base;            /* base DVA - IOMMU exclusion range */
 347    hwaddr excl_limit;           /* limit of IOMMU exclusion range   */
 348    bool excl_allow;             /* translate accesses to the exclusion range */
 349    bool excl_enable;            /* exclusion range enabled          */
 350
 351    hwaddr ppr_log;              /* base address ppr log */
 352    uint32_t pprlog_len;         /* ppr log len  */
 353    uint32_t pprlog_head;        /* ppr log head */
 354    uint32_t pprlog_tail;        /* ppr log tail */
 355
 356    MemoryRegion mmio;                 /* MMIO region                  */
 357    uint8_t mmior[AMDVI_MMIO_SIZE];    /* read/write MMIO              */
 358    uint8_t w1cmask[AMDVI_MMIO_SIZE];  /* read/write 1 clear mask      */
 359    uint8_t romask[AMDVI_MMIO_SIZE];   /* MMIO read/only mask          */
 360    bool mmio_enabled;
 361
 362    /* for each served device */
 363    AMDVIAddressSpace **address_spaces[PCI_BUS_MAX];
 364
 365    /* IOTLB */
 366    GHashTable *iotlb;
 367
 368    /* Interrupt remapping */
 369    bool ga_enabled;
 370} AMDVIState;
 371
 372#endif
 373