1 /* 2 * ARM SMMU Support 3 * 4 * Copyright (C) 2015-2016 Broadcom Corporation 5 * Copyright (c) 2017 Red Hat, Inc. 6 * Written by Prem Mallappa, Eric Auger 7 * 8 * This program is free software; you can redistribute it and/or modify 9 * it under the terms of the GNU General Public License version 2 as 10 * published by the Free Software Foundation. 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 */ 18 19 #ifndef HW_ARM_SMMU_COMMON_H 20 #define HW_ARM_SMMU_COMMON_H 21 22 #include "hw/sysbus.h" 23 #include "hw/pci/pci.h" 24 #include "qom/object.h" 25 26 #define SMMU_PCI_BUS_MAX 256 27 #define SMMU_PCI_DEVFN_MAX 256 28 #define SMMU_PCI_DEVFN(sid) (sid & 0xFF) 29 30 /* VMSAv8-64 Translation constants and functions */ 31 #define VMSA_LEVELS 4 32 #define VMSA_MAX_S2_CONCAT 16 33 34 #define VMSA_STRIDE(gran) ((gran) - VMSA_LEVELS + 1) 35 #define VMSA_BIT_LVL(isz, strd, lvl) ((isz) - (strd) * \ 36 (VMSA_LEVELS - (lvl))) 37 #define VMSA_IDXMSK(isz, strd, lvl) ((1ULL << \ 38 VMSA_BIT_LVL(isz, strd, lvl)) - 1) 39 40 #define CACHED_ENTRY_TO_ADDR(ent, addr) ((ent)->entry.translated_addr + \ 41 ((addr) & (ent)->entry.addr_mask)) 42 43 /* 44 * Page table walk error types 45 */ 46 typedef enum { 47 SMMU_PTW_ERR_NONE, 48 SMMU_PTW_ERR_WALK_EABT, /* Translation walk external abort */ 49 SMMU_PTW_ERR_TRANSLATION, /* Translation fault */ 50 SMMU_PTW_ERR_ADDR_SIZE, /* Address Size fault */ 51 SMMU_PTW_ERR_ACCESS, /* Access fault */ 52 SMMU_PTW_ERR_PERMISSION, /* Permission fault */ 53 } SMMUPTWEventType; 54 55 /* SMMU Stage */ 56 typedef enum { 57 SMMU_STAGE_1 = 1, 58 SMMU_STAGE_2, 59 SMMU_NESTED, 60 } SMMUStage; 61 62 typedef struct SMMUPTWEventInfo { 63 SMMUStage stage; 64 SMMUPTWEventType type; 65 dma_addr_t addr; /* fetched address that induced an abort, if any */ 66 } SMMUPTWEventInfo; 67 68 typedef struct SMMUTransTableInfo { 69 bool disabled; /* is the translation table disabled? */ 70 uint64_t ttb; /* TT base address */ 71 uint8_t tsz; /* input range, ie. 2^(64 -tsz)*/ 72 uint8_t granule_sz; /* granule page shift */ 73 bool had; /* hierarchical attribute disable */ 74 } SMMUTransTableInfo; 75 76 typedef struct SMMUTLBEntry { 77 IOMMUTLBEntry entry; 78 uint8_t level; 79 uint8_t granule; 80 IOMMUAccessFlags parent_perm; 81 } SMMUTLBEntry; 82 83 /* Stage-2 configuration. */ 84 typedef struct SMMUS2Cfg { 85 uint8_t tsz; /* Size of IPA input region (S2T0SZ) */ 86 uint8_t sl0; /* Start level of translation (S2SL0) */ 87 bool affd; /* AF Fault Disable (S2AFFD) */ 88 bool record_faults; /* Record fault events (S2R) */ 89 uint8_t granule_sz; /* Granule page shift (based on S2TG) */ 90 uint8_t eff_ps; /* Effective PA output range (based on S2PS) */ 91 int vmid; /* Virtual Machine ID (S2VMID) */ 92 uint64_t vttb; /* Address of translation table base (S2TTB) */ 93 } SMMUS2Cfg; 94 95 /* 96 * Generic structure populated by derived SMMU devices 97 * after decoding the configuration information and used as 98 * input to the page table walk 99 */ 100 typedef struct SMMUTransCfg { 101 /* Shared fields between stage-1 and stage-2. */ 102 SMMUStage stage; /* translation stage */ 103 bool disabled; /* smmu is disabled */ 104 bool bypassed; /* translation is bypassed */ 105 bool aborted; /* translation is aborted */ 106 bool affd; /* AF fault disable */ 107 uint32_t iotlb_hits; /* counts IOTLB hits */ 108 uint32_t iotlb_misses; /* counts IOTLB misses*/ 109 /* Used by stage-1 only. */ 110 bool aa64; /* arch64 or aarch32 translation table */ 111 bool record_faults; /* record fault events */ 112 uint64_t ttb; /* TT base address */ 113 uint8_t oas; /* output address width */ 114 uint8_t tbi; /* Top Byte Ignore */ 115 int asid; 116 SMMUTransTableInfo tt[2]; 117 /* Used by stage-2 only. */ 118 struct SMMUS2Cfg s2cfg; 119 } SMMUTransCfg; 120 121 typedef struct SMMUDevice { 122 void *smmu; 123 PCIBus *bus; 124 int devfn; 125 IOMMUMemoryRegion iommu; 126 AddressSpace as; 127 uint32_t cfg_cache_hits; 128 uint32_t cfg_cache_misses; 129 QLIST_ENTRY(SMMUDevice) next; 130 } SMMUDevice; 131 132 typedef struct SMMUPciBus { 133 PCIBus *bus; 134 SMMUDevice *pbdev[]; /* Parent array is sparse, so dynamically alloc */ 135 } SMMUPciBus; 136 137 typedef struct SMMUIOTLBKey { 138 uint64_t iova; 139 int asid; 140 int vmid; 141 uint8_t tg; 142 uint8_t level; 143 } SMMUIOTLBKey; 144 145 struct SMMUState { 146 /* <private> */ 147 SysBusDevice dev; 148 const char *mrtypename; 149 MemoryRegion iomem; 150 151 GHashTable *smmu_pcibus_by_busptr; 152 GHashTable *configs; /* cache for configuration data */ 153 GHashTable *iotlb; 154 SMMUPciBus *smmu_pcibus_by_bus_num[SMMU_PCI_BUS_MAX]; 155 PCIBus *pci_bus; 156 QLIST_HEAD(, SMMUDevice) devices_with_notifiers; 157 uint8_t bus_num; 158 PCIBus *primary_bus; 159 }; 160 161 struct SMMUBaseClass { 162 /* <private> */ 163 SysBusDeviceClass parent_class; 164 165 /*< public >*/ 166 167 DeviceRealize parent_realize; 168 169 }; 170 171 #define TYPE_ARM_SMMU "arm-smmu" 172 OBJECT_DECLARE_TYPE(SMMUState, SMMUBaseClass, ARM_SMMU) 173 174 /* Return the SMMUPciBus handle associated to a PCI bus number */ 175 SMMUPciBus *smmu_find_smmu_pcibus(SMMUState *s, uint8_t bus_num); 176 177 /* Return the stream ID of an SMMU device */ 178 static inline uint16_t smmu_get_sid(SMMUDevice *sdev) 179 { 180 return PCI_BUILD_BDF(pci_bus_num(sdev->bus), sdev->devfn); 181 } 182 183 /** 184 * smmu_ptw - Perform the page table walk for a given iova / access flags 185 * pair, according to @cfg translation config 186 */ 187 int smmu_ptw(SMMUTransCfg *cfg, dma_addr_t iova, IOMMUAccessFlags perm, 188 SMMUTLBEntry *tlbe, SMMUPTWEventInfo *info); 189 190 191 /* 192 * smmu_translate - Look for a translation in TLB, if not, do a PTW. 193 * Returns NULL on PTW error or incase of TLB permission errors. 194 */ 195 SMMUTLBEntry *smmu_translate(SMMUState *bs, SMMUTransCfg *cfg, dma_addr_t addr, 196 IOMMUAccessFlags flag, SMMUPTWEventInfo *info); 197 198 /** 199 * select_tt - compute which translation table shall be used according to 200 * the input iova and translation config and return the TT specific info 201 */ 202 SMMUTransTableInfo *select_tt(SMMUTransCfg *cfg, dma_addr_t iova); 203 204 /* Return the SMMUDevice associated to @sid, or NULL if none */ 205 SMMUDevice *smmu_find_sdev(SMMUState *s, uint32_t sid); 206 207 #define SMMU_IOTLB_MAX_SIZE 256 208 209 SMMUTLBEntry *smmu_iotlb_lookup(SMMUState *bs, SMMUTransCfg *cfg, 210 SMMUTransTableInfo *tt, hwaddr iova); 211 void smmu_iotlb_insert(SMMUState *bs, SMMUTransCfg *cfg, SMMUTLBEntry *entry); 212 SMMUIOTLBKey smmu_get_iotlb_key(int asid, int vmid, uint64_t iova, 213 uint8_t tg, uint8_t level); 214 void smmu_iotlb_inv_all(SMMUState *s); 215 void smmu_iotlb_inv_asid(SMMUState *s, int asid); 216 void smmu_iotlb_inv_vmid(SMMUState *s, int vmid); 217 void smmu_iotlb_inv_iova(SMMUState *s, int asid, int vmid, dma_addr_t iova, 218 uint8_t tg, uint64_t num_pages, uint8_t ttl); 219 220 /* Unmap the range of all the notifiers registered to any IOMMU mr */ 221 void smmu_inv_notifiers_all(SMMUState *s); 222 223 #endif /* HW_ARM_SMMU_COMMON_H */ 224