10260c420SBen Widawsky /* 20260c420SBen Widawsky * Copyright © 2014 Intel Corporation 30260c420SBen Widawsky * 40260c420SBen Widawsky * Permission is hereby granted, free of charge, to any person obtaining a 50260c420SBen Widawsky * copy of this software and associated documentation files (the "Software"), 60260c420SBen Widawsky * to deal in the Software without restriction, including without limitation 70260c420SBen Widawsky * the rights to use, copy, modify, merge, publish, distribute, sublicense, 80260c420SBen Widawsky * and/or sell copies of the Software, and to permit persons to whom the 90260c420SBen Widawsky * Software is furnished to do so, subject to the following conditions: 100260c420SBen Widawsky * 110260c420SBen Widawsky * The above copyright notice and this permission notice (including the next 120260c420SBen Widawsky * paragraph) shall be included in all copies or substantial portions of the 130260c420SBen Widawsky * Software. 140260c420SBen Widawsky * 150260c420SBen Widawsky * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 160260c420SBen Widawsky * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 170260c420SBen Widawsky * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 180260c420SBen Widawsky * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 190260c420SBen Widawsky * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING 200260c420SBen Widawsky * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS 210260c420SBen Widawsky * IN THE SOFTWARE. 220260c420SBen Widawsky * 230260c420SBen Widawsky * Please try to maintain the following order within this file unless it makes 240260c420SBen Widawsky * sense to do otherwise. From top to bottom: 250260c420SBen Widawsky * 1. typedefs 260260c420SBen Widawsky * 2. #defines, and macros 270260c420SBen Widawsky * 3. structure definitions 280260c420SBen Widawsky * 4. function prototypes 290260c420SBen Widawsky * 300260c420SBen Widawsky * Within each section, please try to order by generation in ascending order, 310260c420SBen Widawsky * from top to bottom (ie. gen6 on the top, gen8 on the bottom). 320260c420SBen Widawsky */ 330260c420SBen Widawsky 340260c420SBen Widawsky #ifndef __I915_GEM_GTT_H__ 350260c420SBen Widawsky #define __I915_GEM_GTT_H__ 360260c420SBen Widawsky 378ef8561fSChris Wilson #include <linux/io-mapping.h> 38b42fe9caSJoonas Lahtinen #include <linux/mm.h> 398448661dSChris Wilson #include <linux/pagevec.h> 408ef8561fSChris Wilson 41b42fe9caSJoonas Lahtinen #include "i915_gem_timeline.h" 42b0decaf7SChris Wilson #include "i915_gem_request.h" 438448661dSChris Wilson #include "i915_selftest.h" 44b0decaf7SChris Wilson 45f51455d4SChris Wilson #define I915_GTT_PAGE_SIZE 4096UL 46f51455d4SChris Wilson #define I915_GTT_MIN_ALIGNMENT I915_GTT_PAGE_SIZE 47f51455d4SChris Wilson 4849ef5294SChris Wilson #define I915_FENCE_REG_NONE -1 4949ef5294SChris Wilson #define I915_MAX_NUM_FENCES 32 5049ef5294SChris Wilson /* 32 fences + sign bit for FENCE_REG_NONE */ 5149ef5294SChris Wilson #define I915_MAX_NUM_FENCE_BITS 6 5249ef5294SChris Wilson 534d884705SDaniel Vetter struct drm_i915_file_private; 5449ef5294SChris Wilson struct drm_i915_fence_reg; 554d884705SDaniel Vetter 5607749ef3SMichel Thierry typedef uint32_t gen6_pte_t; 5707749ef3SMichel Thierry typedef uint64_t gen8_pte_t; 5807749ef3SMichel Thierry typedef uint64_t gen8_pde_t; 59762d9936SMichel Thierry typedef uint64_t gen8_ppgtt_pdpe_t; 60762d9936SMichel Thierry typedef uint64_t gen8_ppgtt_pml4e_t; 610260c420SBen Widawsky 6272e96d64SJoonas Lahtinen #define ggtt_total_entries(ggtt) ((ggtt)->base.total >> PAGE_SHIFT) 630260c420SBen Widawsky 640260c420SBen Widawsky /* gen6-hsw has bit 11-4 for physical addr bit 39-32 */ 650260c420SBen Widawsky #define GEN6_GTT_ADDR_ENCODE(addr) ((addr) | (((addr) >> 28) & 0xff0)) 660260c420SBen Widawsky #define GEN6_PTE_ADDR_ENCODE(addr) GEN6_GTT_ADDR_ENCODE(addr) 670260c420SBen Widawsky #define GEN6_PDE_ADDR_ENCODE(addr) GEN6_GTT_ADDR_ENCODE(addr) 680260c420SBen Widawsky #define GEN6_PTE_CACHE_LLC (2 << 1) 690260c420SBen Widawsky #define GEN6_PTE_UNCACHED (1 << 1) 700260c420SBen Widawsky #define GEN6_PTE_VALID (1 << 0) 710260c420SBen Widawsky 7207749ef3SMichel Thierry #define I915_PTES(pte_len) (PAGE_SIZE / (pte_len)) 7307749ef3SMichel Thierry #define I915_PTE_MASK(pte_len) (I915_PTES(pte_len) - 1) 7407749ef3SMichel Thierry #define I915_PDES 512 7507749ef3SMichel Thierry #define I915_PDE_MASK (I915_PDES - 1) 76678d96fbSBen Widawsky #define NUM_PTE(pde_shift) (1 << (pde_shift - PAGE_SHIFT)) 7707749ef3SMichel Thierry 7807749ef3SMichel Thierry #define GEN6_PTES I915_PTES(sizeof(gen6_pte_t)) 7907749ef3SMichel Thierry #define GEN6_PD_SIZE (I915_PDES * PAGE_SIZE) 800260c420SBen Widawsky #define GEN6_PD_ALIGN (PAGE_SIZE * 16) 81678d96fbSBen Widawsky #define GEN6_PDE_SHIFT 22 820260c420SBen Widawsky #define GEN6_PDE_VALID (1 << 0) 830260c420SBen Widawsky 840260c420SBen Widawsky #define GEN7_PTE_CACHE_L3_LLC (3 << 1) 850260c420SBen Widawsky 860260c420SBen Widawsky #define BYT_PTE_SNOOPED_BY_CPU_CACHES (1 << 2) 870260c420SBen Widawsky #define BYT_PTE_WRITEABLE (1 << 1) 880260c420SBen Widawsky 890260c420SBen Widawsky /* Cacheability Control is a 4-bit value. The low three bits are stored in bits 900260c420SBen Widawsky * 3:1 of the PTE, while the fourth bit is stored in bit 11 of the PTE. 910260c420SBen Widawsky */ 920260c420SBen Widawsky #define HSW_CACHEABILITY_CONTROL(bits) ((((bits) & 0x7) << 1) | \ 930260c420SBen Widawsky (((bits) & 0x8) << (11 - 3))) 940260c420SBen Widawsky #define HSW_WB_LLC_AGE3 HSW_CACHEABILITY_CONTROL(0x2) 950260c420SBen Widawsky #define HSW_WB_LLC_AGE0 HSW_CACHEABILITY_CONTROL(0x3) 960260c420SBen Widawsky #define HSW_WB_ELLC_LLC_AGE3 HSW_CACHEABILITY_CONTROL(0x8) 970260c420SBen Widawsky #define HSW_WB_ELLC_LLC_AGE0 HSW_CACHEABILITY_CONTROL(0xb) 980260c420SBen Widawsky #define HSW_WT_ELLC_LLC_AGE3 HSW_CACHEABILITY_CONTROL(0x7) 990260c420SBen Widawsky #define HSW_WT_ELLC_LLC_AGE0 HSW_CACHEABILITY_CONTROL(0x6) 1000260c420SBen Widawsky #define HSW_PTE_UNCACHED (0) 1010260c420SBen Widawsky #define HSW_GTT_ADDR_ENCODE(addr) ((addr) | (((addr) >> 28) & 0x7f0)) 1020260c420SBen Widawsky #define HSW_PTE_ADDR_ENCODE(addr) HSW_GTT_ADDR_ENCODE(addr) 1030260c420SBen Widawsky 1040260c420SBen Widawsky /* GEN8 legacy style address is defined as a 3 level page table: 1050260c420SBen Widawsky * 31:30 | 29:21 | 20:12 | 11:0 1060260c420SBen Widawsky * PDPE | PDE | PTE | offset 1070260c420SBen Widawsky * The difference as compared to normal x86 3 level page table is the PDPEs are 1080260c420SBen Widawsky * programmed via register. 10981ba8aefSMichel Thierry * 11081ba8aefSMichel Thierry * GEN8 48b legacy style address is defined as a 4 level page table: 11181ba8aefSMichel Thierry * 47:39 | 38:30 | 29:21 | 20:12 | 11:0 11281ba8aefSMichel Thierry * PML4E | PDPE | PDE | PTE | offset 1130260c420SBen Widawsky */ 11481ba8aefSMichel Thierry #define GEN8_PML4ES_PER_PML4 512 11581ba8aefSMichel Thierry #define GEN8_PML4E_SHIFT 39 116762d9936SMichel Thierry #define GEN8_PML4E_MASK (GEN8_PML4ES_PER_PML4 - 1) 1170260c420SBen Widawsky #define GEN8_PDPE_SHIFT 30 11881ba8aefSMichel Thierry /* NB: GEN8_PDPE_MASK is untrue for 32b platforms, but it has no impact on 32b page 11981ba8aefSMichel Thierry * tables */ 12081ba8aefSMichel Thierry #define GEN8_PDPE_MASK 0x1ff 1210260c420SBen Widawsky #define GEN8_PDE_SHIFT 21 1220260c420SBen Widawsky #define GEN8_PDE_MASK 0x1ff 1230260c420SBen Widawsky #define GEN8_PTE_SHIFT 12 1240260c420SBen Widawsky #define GEN8_PTE_MASK 0x1ff 12576643600SBen Widawsky #define GEN8_LEGACY_PDPES 4 12607749ef3SMichel Thierry #define GEN8_PTES I915_PTES(sizeof(gen8_pte_t)) 1270260c420SBen Widawsky 128275a991cSTvrtko Ursulin #define I915_PDPES_PER_PDP(dev_priv) (USES_FULL_48BIT_PPGTT(dev_priv) ?\ 12981ba8aefSMichel Thierry GEN8_PML4ES_PER_PML4 : GEN8_LEGACY_PDPES) 1306ac18502SMichel Thierry 1310260c420SBen Widawsky #define PPAT_UNCACHED_INDEX (_PAGE_PWT | _PAGE_PCD) 1320260c420SBen Widawsky #define PPAT_CACHED_PDE_INDEX 0 /* WB LLC */ 1330260c420SBen Widawsky #define PPAT_CACHED_INDEX _PAGE_PAT /* WB LLCeLLC */ 1340260c420SBen Widawsky #define PPAT_DISPLAY_ELLC_INDEX _PAGE_PCD /* WT eLLC */ 1350260c420SBen Widawsky 136ee0ce478SVille Syrjälä #define CHV_PPAT_SNOOP (1<<6) 1370260c420SBen Widawsky #define GEN8_PPAT_AGE(x) (x<<4) 1380260c420SBen Widawsky #define GEN8_PPAT_LLCeLLC (3<<2) 1390260c420SBen Widawsky #define GEN8_PPAT_LLCELLC (2<<2) 1400260c420SBen Widawsky #define GEN8_PPAT_LLC (1<<2) 1410260c420SBen Widawsky #define GEN8_PPAT_WB (3<<0) 1420260c420SBen Widawsky #define GEN8_PPAT_WT (2<<0) 1430260c420SBen Widawsky #define GEN8_PPAT_WC (1<<0) 1440260c420SBen Widawsky #define GEN8_PPAT_UC (0<<0) 1450260c420SBen Widawsky #define GEN8_PPAT_ELLC_OVERRIDE (0<<2) 1460260c420SBen Widawsky #define GEN8_PPAT(i, x) ((uint64_t) (x) << ((i) * 8)) 1470260c420SBen Widawsky 148b42fe9caSJoonas Lahtinen struct sg_table; 149b42fe9caSJoonas Lahtinen 15050470bb0STvrtko Ursulin struct intel_rotation_info { 1517ff19c56SChris Wilson struct intel_rotation_plane_info { 1521663b9d6SVille Syrjälä /* tiles */ 1536687c906SVille Syrjälä unsigned int width, height, stride, offset; 1541663b9d6SVille Syrjälä } plane[2]; 1558d9046adSChris Wilson } __packed; 1568d9046adSChris Wilson 1578d9046adSChris Wilson static inline void assert_intel_rotation_info_is_packed(void) 1588d9046adSChris Wilson { 1598d9046adSChris Wilson BUILD_BUG_ON(sizeof(struct intel_rotation_info) != 8*sizeof(unsigned int)); 1608d9046adSChris Wilson } 161fe14d5f4STvrtko Ursulin 1627ff19c56SChris Wilson struct intel_partial_info { 1637ff19c56SChris Wilson u64 offset; 1647ff19c56SChris Wilson unsigned int size; 1658d9046adSChris Wilson } __packed; 1668d9046adSChris Wilson 1678d9046adSChris Wilson static inline void assert_intel_partial_info_is_packed(void) 1688d9046adSChris Wilson { 1698d9046adSChris Wilson BUILD_BUG_ON(sizeof(struct intel_partial_info) != sizeof(u64) + sizeof(unsigned int)); 1708d9046adSChris Wilson } 1717ff19c56SChris Wilson 172992e418dSChris Wilson enum i915_ggtt_view_type { 173992e418dSChris Wilson I915_GGTT_VIEW_NORMAL = 0, 174992e418dSChris Wilson I915_GGTT_VIEW_ROTATED = sizeof(struct intel_rotation_info), 175992e418dSChris Wilson I915_GGTT_VIEW_PARTIAL = sizeof(struct intel_partial_info), 176992e418dSChris Wilson }; 177992e418dSChris Wilson 178992e418dSChris Wilson static inline void assert_i915_ggtt_view_type_is_unique(void) 179992e418dSChris Wilson { 180992e418dSChris Wilson /* As we encode the size of each branch inside the union into its type, 181992e418dSChris Wilson * we have to be careful that each branch has a unique size. 182992e418dSChris Wilson */ 183992e418dSChris Wilson switch ((enum i915_ggtt_view_type)0) { 184992e418dSChris Wilson case I915_GGTT_VIEW_NORMAL: 185992e418dSChris Wilson case I915_GGTT_VIEW_PARTIAL: 186992e418dSChris Wilson case I915_GGTT_VIEW_ROTATED: 187992e418dSChris Wilson /* gcc complains if these are identical cases */ 188992e418dSChris Wilson break; 189992e418dSChris Wilson } 190992e418dSChris Wilson } 191992e418dSChris Wilson 192fe14d5f4STvrtko Ursulin struct i915_ggtt_view { 193fe14d5f4STvrtko Ursulin enum i915_ggtt_view_type type; 1948bd7ef16SJoonas Lahtinen union { 195992e418dSChris Wilson /* Members need to contain no holes/padding */ 1967ff19c56SChris Wilson struct intel_partial_info partial; 1977723f47dSVille Syrjälä struct intel_rotation_info rotated; 1988bab1193SChris Wilson }; 199fe14d5f4STvrtko Ursulin }; 200fe14d5f4STvrtko Ursulin 2010260c420SBen Widawsky enum i915_cache_level; 202fe14d5f4STvrtko Ursulin 203b42fe9caSJoonas Lahtinen struct i915_vma; 204bde13ebdSChris Wilson 20544159ddbSMika Kuoppala struct i915_page_dma { 206d7b3de91SBen Widawsky struct page *page; 20744159ddbSMika Kuoppala union { 2087324cc04SBen Widawsky dma_addr_t daddr; 209678d96fbSBen Widawsky 21044159ddbSMika Kuoppala /* For gen6/gen7 only. This is the offset in the GGTT 21144159ddbSMika Kuoppala * where the page directory entries for PPGTT begin 21244159ddbSMika Kuoppala */ 21344159ddbSMika Kuoppala uint32_t ggtt_offset; 21444159ddbSMika Kuoppala }; 21544159ddbSMika Kuoppala }; 21644159ddbSMika Kuoppala 217567047beSMika Kuoppala #define px_base(px) (&(px)->base) 218567047beSMika Kuoppala #define px_page(px) (px_base(px)->page) 219567047beSMika Kuoppala #define px_dma(px) (px_base(px)->daddr) 220567047beSMika Kuoppala 22144159ddbSMika Kuoppala struct i915_page_table { 22244159ddbSMika Kuoppala struct i915_page_dma base; 22344159ddbSMika Kuoppala 224678d96fbSBen Widawsky unsigned long *used_ptes; 225d7b3de91SBen Widawsky }; 226d7b3de91SBen Widawsky 227ec565b3cSMichel Thierry struct i915_page_directory { 22844159ddbSMika Kuoppala struct i915_page_dma base; 2297324cc04SBen Widawsky 23033c8819fSMichel Thierry unsigned long *used_pdes; 231ec565b3cSMichel Thierry struct i915_page_table *page_table[I915_PDES]; /* PDEs */ 232d7b3de91SBen Widawsky }; 233d7b3de91SBen Widawsky 234ec565b3cSMichel Thierry struct i915_page_directory_pointer { 2356ac18502SMichel Thierry struct i915_page_dma base; 2366ac18502SMichel Thierry 2376ac18502SMichel Thierry unsigned long *used_pdpes; 2386ac18502SMichel Thierry struct i915_page_directory **page_directory; 239d7b3de91SBen Widawsky }; 240d7b3de91SBen Widawsky 24181ba8aefSMichel Thierry struct i915_pml4 { 24281ba8aefSMichel Thierry struct i915_page_dma base; 24381ba8aefSMichel Thierry 24481ba8aefSMichel Thierry DECLARE_BITMAP(used_pml4es, GEN8_PML4ES_PER_PML4); 24581ba8aefSMichel Thierry struct i915_page_directory_pointer *pdps[GEN8_PML4ES_PER_PML4]; 24681ba8aefSMichel Thierry }; 24781ba8aefSMichel Thierry 2480260c420SBen Widawsky struct i915_address_space { 2490260c420SBen Widawsky struct drm_mm mm; 25080b204bcSChris Wilson struct i915_gem_timeline timeline; 25149d73912SChris Wilson struct drm_i915_private *i915; 2528448661dSChris Wilson struct device *dma; 2532bfa996eSChris Wilson /* Every address space belongs to a struct file - except for the global 2542bfa996eSChris Wilson * GTT that is owned by the driver (and so @file is set to NULL). In 2552bfa996eSChris Wilson * principle, no information should leak from one context to another 2562bfa996eSChris Wilson * (or between files/processes etc) unless explicitly shared by the 2572bfa996eSChris Wilson * owner. Tracking the owner is important in order to free up per-file 2582bfa996eSChris Wilson * objects along with the file, to aide resource tracking, and to 2592bfa996eSChris Wilson * assign blame. 2602bfa996eSChris Wilson */ 2612bfa996eSChris Wilson struct drm_i915_file_private *file; 2620260c420SBen Widawsky struct list_head global_link; 263c44ef60eSMika Kuoppala u64 start; /* Start offset always 0 for dri2 */ 264c44ef60eSMika Kuoppala u64 total; /* size addr space maps (ex. 2GB for ggtt) */ 2650260c420SBen Widawsky 26650e046b6SChris Wilson bool closed; 26750e046b6SChris Wilson 2688bcdd0f7SChris Wilson struct i915_page_dma scratch_page; 26979ab9370SMika Kuoppala struct i915_page_table *scratch_pt; 27079ab9370SMika Kuoppala struct i915_page_directory *scratch_pd; 27169ab76fdSMichel Thierry struct i915_page_directory_pointer *scratch_pdp; /* GEN8+ & 48b PPGTT */ 2720260c420SBen Widawsky 2730260c420SBen Widawsky /** 2740260c420SBen Widawsky * List of objects currently involved in rendering. 2750260c420SBen Widawsky * 2760260c420SBen Widawsky * Includes buffers having the contents of their GPU caches 27797b2a6a1SJohn Harrison * flushed, not necessarily primitives. last_read_req 2780260c420SBen Widawsky * represents when the rendering involved will be completed. 2790260c420SBen Widawsky * 2800260c420SBen Widawsky * A reference is held on the buffer while on this list. 2810260c420SBen Widawsky */ 2820260c420SBen Widawsky struct list_head active_list; 2830260c420SBen Widawsky 2840260c420SBen Widawsky /** 2850260c420SBen Widawsky * LRU list of objects which are not in the ringbuffer and 2860260c420SBen Widawsky * are ready to unbind, but are still in the GTT. 2870260c420SBen Widawsky * 28897b2a6a1SJohn Harrison * last_read_req is NULL while an object is in this list. 2890260c420SBen Widawsky * 2900260c420SBen Widawsky * A reference is not held on the buffer while on this list, 2910260c420SBen Widawsky * as merely being GTT-bound shouldn't prevent its being 2920260c420SBen Widawsky * freed, and we'll pull it off the list in the free path. 2930260c420SBen Widawsky */ 2940260c420SBen Widawsky struct list_head inactive_list; 2950260c420SBen Widawsky 29650e046b6SChris Wilson /** 29750e046b6SChris Wilson * List of vma that have been unbound. 29850e046b6SChris Wilson * 29950e046b6SChris Wilson * A reference is not held on the buffer while on this list. 30050e046b6SChris Wilson */ 30150e046b6SChris Wilson struct list_head unbound_list; 30250e046b6SChris Wilson 3038448661dSChris Wilson struct pagevec free_pages; 3048448661dSChris Wilson bool pt_kmap_wc; 3058448661dSChris Wilson 3060260c420SBen Widawsky /* FIXME: Need a more generic return type */ 30707749ef3SMichel Thierry gen6_pte_t (*pte_encode)(dma_addr_t addr, 3080260c420SBen Widawsky enum i915_cache_level level, 3094fb84d99SMichał Winiarski u32 flags); /* Create a valid PTE */ 310f329f5f6SDaniel Vetter /* flags for pte_encode */ 311f329f5f6SDaniel Vetter #define PTE_READ_ONLY (1<<0) 312678d96fbSBen Widawsky int (*allocate_va_range)(struct i915_address_space *vm, 313678d96fbSBen Widawsky uint64_t start, 314678d96fbSBen Widawsky uint64_t length); 3150260c420SBen Widawsky void (*clear_range)(struct i915_address_space *vm, 3160260c420SBen Widawsky uint64_t start, 3174fb84d99SMichał Winiarski uint64_t length); 318d6473f56SChris Wilson void (*insert_page)(struct i915_address_space *vm, 319d6473f56SChris Wilson dma_addr_t addr, 320d6473f56SChris Wilson uint64_t offset, 321d6473f56SChris Wilson enum i915_cache_level cache_level, 322d6473f56SChris Wilson u32 flags); 3230260c420SBen Widawsky void (*insert_entries)(struct i915_address_space *vm, 3240260c420SBen Widawsky struct sg_table *st, 3250260c420SBen Widawsky uint64_t start, 32624f3a8cfSAkash Goel enum i915_cache_level cache_level, u32 flags); 3270260c420SBen Widawsky void (*cleanup)(struct i915_address_space *vm); 328777dc5bbSDaniel Vetter /** Unmap an object from an address space. This usually consists of 329777dc5bbSDaniel Vetter * setting the valid PTE entries to a reserved scratch page. */ 330777dc5bbSDaniel Vetter void (*unbind_vma)(struct i915_vma *vma); 331777dc5bbSDaniel Vetter /* Map an object into an address space with the given cache flags. */ 33270b9f6f8SDaniel Vetter int (*bind_vma)(struct i915_vma *vma, 333777dc5bbSDaniel Vetter enum i915_cache_level cache_level, 334777dc5bbSDaniel Vetter u32 flags); 3358448661dSChris Wilson 3368448661dSChris Wilson I915_SELFTEST_DECLARE(struct fault_attr fault_attr); 3370260c420SBen Widawsky }; 3380260c420SBen Widawsky 3392bfa996eSChris Wilson #define i915_is_ggtt(V) (!(V)->file) 340596c5923SChris Wilson 3410260c420SBen Widawsky /* The Graphics Translation Table is the way in which GEN hardware translates a 3420260c420SBen Widawsky * Graphics Virtual Address into a Physical Address. In addition to the normal 3430260c420SBen Widawsky * collateral associated with any va->pa translations GEN hardware also has a 3440260c420SBen Widawsky * portion of the GTT which can be mapped by the CPU and remain both coherent 3450260c420SBen Widawsky * and correct (in cases like swizzling). That region is referred to as GMADR in 3460260c420SBen Widawsky * the spec. 3470260c420SBen Widawsky */ 34862106b4fSJoonas Lahtinen struct i915_ggtt { 3490260c420SBen Widawsky struct i915_address_space base; 350f7bbe788SChris Wilson struct io_mapping mappable; /* Mapping to our CPU mappable region */ 3510260c420SBen Widawsky 352edd1f2feSChris Wilson phys_addr_t mappable_base; /* PA of our GMADR */ 353edd1f2feSChris Wilson u64 mappable_end; /* End offset that we can CPU map */ 354edd1f2feSChris Wilson 3553c6b29b2SPaulo Zanoni /* Stolen memory is segmented in hardware with different portions 3563c6b29b2SPaulo Zanoni * offlimits to certain functions. 3573c6b29b2SPaulo Zanoni * 3583c6b29b2SPaulo Zanoni * The drm_mm is initialised to the total accessible range, as found 3593c6b29b2SPaulo Zanoni * from the PCI config. On Broadwell+, this is further restricted to 3603c6b29b2SPaulo Zanoni * avoid the first page! The upper end of stolen memory is reserved for 3613c6b29b2SPaulo Zanoni * hardware functions and similarly removed from the accessible range. 3623c6b29b2SPaulo Zanoni */ 363edd1f2feSChris Wilson u32 stolen_size; /* Total size of stolen memory */ 364edd1f2feSChris Wilson u32 stolen_usable_size; /* Total size minus reserved ranges */ 365edd1f2feSChris Wilson u32 stolen_reserved_base; 366edd1f2feSChris Wilson u32 stolen_reserved_size; 3670260c420SBen Widawsky 3680260c420SBen Widawsky /** "Graphics Stolen Memory" holds the global PTEs */ 3690260c420SBen Widawsky void __iomem *gsm; 3707c3f86b6SChris Wilson void (*invalidate)(struct drm_i915_private *dev_priv); 3710260c420SBen Widawsky 3720260c420SBen Widawsky bool do_idle_maps; 3730260c420SBen Widawsky 3740260c420SBen Widawsky int mtrr; 37595374d75SChris Wilson 37695374d75SChris Wilson struct drm_mm_node error_capture; 3770260c420SBen Widawsky }; 3780260c420SBen Widawsky 3790260c420SBen Widawsky struct i915_hw_ppgtt { 3800260c420SBen Widawsky struct i915_address_space base; 3810260c420SBen Widawsky struct kref ref; 3820260c420SBen Widawsky struct drm_mm_node node; 383563222a7SBen Widawsky unsigned long pd_dirty_rings; 3840260c420SBen Widawsky union { 38581ba8aefSMichel Thierry struct i915_pml4 pml4; /* GEN8+ & 48b PPGTT */ 38681ba8aefSMichel Thierry struct i915_page_directory_pointer pdp; /* GEN8+ */ 38781ba8aefSMichel Thierry struct i915_page_directory pd; /* GEN6-7 */ 388d7b3de91SBen Widawsky }; 3890260c420SBen Widawsky 390678d96fbSBen Widawsky gen6_pte_t __iomem *pd_addr; 391678d96fbSBen Widawsky 3920260c420SBen Widawsky int (*enable)(struct i915_hw_ppgtt *ppgtt); 3930260c420SBen Widawsky int (*switch_mm)(struct i915_hw_ppgtt *ppgtt, 394e85b26dcSJohn Harrison struct drm_i915_gem_request *req); 3950260c420SBen Widawsky void (*debug_dump)(struct i915_hw_ppgtt *ppgtt, struct seq_file *m); 3960260c420SBen Widawsky }; 3970260c420SBen Widawsky 398731f74c5SDave Gordon /* 399731f74c5SDave Gordon * gen6_for_each_pde() iterates over every pde from start until start+length. 400731f74c5SDave Gordon * If start and start+length are not perfectly divisible, the macro will round 401731f74c5SDave Gordon * down and up as needed. Start=0 and length=2G effectively iterates over 402731f74c5SDave Gordon * every PDE in the system. The macro modifies ALL its parameters except 'pd', 403731f74c5SDave Gordon * so each of the other parameters should preferably be a simple variable, or 404731f74c5SDave Gordon * at most an lvalue with no side-effects! 405678d96fbSBen Widawsky */ 406731f74c5SDave Gordon #define gen6_for_each_pde(pt, pd, start, length, iter) \ 407fdc454c1SMichel Thierry for (iter = gen6_pde_index(start); \ 408731f74c5SDave Gordon length > 0 && iter < I915_PDES && \ 409731f74c5SDave Gordon (pt = (pd)->page_table[iter], true); \ 410731f74c5SDave Gordon ({ u32 temp = ALIGN(start+1, 1 << GEN6_PDE_SHIFT); \ 411731f74c5SDave Gordon temp = min(temp - start, length); \ 412731f74c5SDave Gordon start += temp, length -= temp; }), ++iter) 413678d96fbSBen Widawsky 414731f74c5SDave Gordon #define gen6_for_all_pdes(pt, pd, iter) \ 41509942c65SMichel Thierry for (iter = 0; \ 416731f74c5SDave Gordon iter < I915_PDES && \ 417731f74c5SDave Gordon (pt = (pd)->page_table[iter], true); \ 418731f74c5SDave Gordon ++iter) 41909942c65SMichel Thierry 420678d96fbSBen Widawsky static inline uint32_t i915_pte_index(uint64_t address, uint32_t pde_shift) 421678d96fbSBen Widawsky { 422678d96fbSBen Widawsky const uint32_t mask = NUM_PTE(pde_shift) - 1; 423678d96fbSBen Widawsky 424678d96fbSBen Widawsky return (address >> PAGE_SHIFT) & mask; 425678d96fbSBen Widawsky } 426678d96fbSBen Widawsky 427678d96fbSBen Widawsky /* Helper to counts the number of PTEs within the given length. This count 428678d96fbSBen Widawsky * does not cross a page table boundary, so the max value would be 429678d96fbSBen Widawsky * GEN6_PTES for GEN6, and GEN8_PTES for GEN8. 430678d96fbSBen Widawsky */ 431678d96fbSBen Widawsky static inline uint32_t i915_pte_count(uint64_t addr, size_t length, 432678d96fbSBen Widawsky uint32_t pde_shift) 433678d96fbSBen Widawsky { 43469603dbbSAlan const uint64_t mask = ~((1ULL << pde_shift) - 1); 435678d96fbSBen Widawsky uint64_t end; 436678d96fbSBen Widawsky 437678d96fbSBen Widawsky WARN_ON(length == 0); 438678d96fbSBen Widawsky WARN_ON(offset_in_page(addr|length)); 439678d96fbSBen Widawsky 440678d96fbSBen Widawsky end = addr + length; 441678d96fbSBen Widawsky 442678d96fbSBen Widawsky if ((addr & mask) != (end & mask)) 443678d96fbSBen Widawsky return NUM_PTE(pde_shift) - i915_pte_index(addr, pde_shift); 444678d96fbSBen Widawsky 445678d96fbSBen Widawsky return i915_pte_index(end, pde_shift) - i915_pte_index(addr, pde_shift); 446678d96fbSBen Widawsky } 447678d96fbSBen Widawsky 448678d96fbSBen Widawsky static inline uint32_t i915_pde_index(uint64_t addr, uint32_t shift) 449678d96fbSBen Widawsky { 450678d96fbSBen Widawsky return (addr >> shift) & I915_PDE_MASK; 451678d96fbSBen Widawsky } 452678d96fbSBen Widawsky 453678d96fbSBen Widawsky static inline uint32_t gen6_pte_index(uint32_t addr) 454678d96fbSBen Widawsky { 455678d96fbSBen Widawsky return i915_pte_index(addr, GEN6_PDE_SHIFT); 456678d96fbSBen Widawsky } 457678d96fbSBen Widawsky 458678d96fbSBen Widawsky static inline size_t gen6_pte_count(uint32_t addr, uint32_t length) 459678d96fbSBen Widawsky { 460678d96fbSBen Widawsky return i915_pte_count(addr, length, GEN6_PDE_SHIFT); 461678d96fbSBen Widawsky } 462678d96fbSBen Widawsky 463678d96fbSBen Widawsky static inline uint32_t gen6_pde_index(uint32_t addr) 464678d96fbSBen Widawsky { 465678d96fbSBen Widawsky return i915_pde_index(addr, GEN6_PDE_SHIFT); 466678d96fbSBen Widawsky } 467678d96fbSBen Widawsky 4689271d959SMichel Thierry /* Equivalent to the gen6 version, For each pde iterates over every pde 4699271d959SMichel Thierry * between from start until start + length. On gen8+ it simply iterates 4709271d959SMichel Thierry * over every page directory entry in a page directory. 4719271d959SMichel Thierry */ 472e8ebd8e2SDave Gordon #define gen8_for_each_pde(pt, pd, start, length, iter) \ 4739271d959SMichel Thierry for (iter = gen8_pde_index(start); \ 474e8ebd8e2SDave Gordon length > 0 && iter < I915_PDES && \ 475e8ebd8e2SDave Gordon (pt = (pd)->page_table[iter], true); \ 476e8ebd8e2SDave Gordon ({ u64 temp = ALIGN(start+1, 1 << GEN8_PDE_SHIFT); \ 477e8ebd8e2SDave Gordon temp = min(temp - start, length); \ 478e8ebd8e2SDave Gordon start += temp, length -= temp; }), ++iter) 4799271d959SMichel Thierry 480e8ebd8e2SDave Gordon #define gen8_for_each_pdpe(pd, pdp, start, length, iter) \ 4819271d959SMichel Thierry for (iter = gen8_pdpe_index(start); \ 482e8ebd8e2SDave Gordon length > 0 && iter < I915_PDPES_PER_PDP(dev) && \ 483e8ebd8e2SDave Gordon (pd = (pdp)->page_directory[iter], true); \ 484e8ebd8e2SDave Gordon ({ u64 temp = ALIGN(start+1, 1 << GEN8_PDPE_SHIFT); \ 485e8ebd8e2SDave Gordon temp = min(temp - start, length); \ 486e8ebd8e2SDave Gordon start += temp, length -= temp; }), ++iter) 4879271d959SMichel Thierry 488e8ebd8e2SDave Gordon #define gen8_for_each_pml4e(pdp, pml4, start, length, iter) \ 489762d9936SMichel Thierry for (iter = gen8_pml4e_index(start); \ 490e8ebd8e2SDave Gordon length > 0 && iter < GEN8_PML4ES_PER_PML4 && \ 491e8ebd8e2SDave Gordon (pdp = (pml4)->pdps[iter], true); \ 492e8ebd8e2SDave Gordon ({ u64 temp = ALIGN(start+1, 1ULL << GEN8_PML4E_SHIFT); \ 493e8ebd8e2SDave Gordon temp = min(temp - start, length); \ 494e8ebd8e2SDave Gordon start += temp, length -= temp; }), ++iter) 495762d9936SMichel Thierry 4969271d959SMichel Thierry static inline uint32_t gen8_pte_index(uint64_t address) 4979271d959SMichel Thierry { 4989271d959SMichel Thierry return i915_pte_index(address, GEN8_PDE_SHIFT); 4999271d959SMichel Thierry } 5009271d959SMichel Thierry 5019271d959SMichel Thierry static inline uint32_t gen8_pde_index(uint64_t address) 5029271d959SMichel Thierry { 5039271d959SMichel Thierry return i915_pde_index(address, GEN8_PDE_SHIFT); 5049271d959SMichel Thierry } 5059271d959SMichel Thierry 5069271d959SMichel Thierry static inline uint32_t gen8_pdpe_index(uint64_t address) 5079271d959SMichel Thierry { 5089271d959SMichel Thierry return (address >> GEN8_PDPE_SHIFT) & GEN8_PDPE_MASK; 5099271d959SMichel Thierry } 5109271d959SMichel Thierry 5119271d959SMichel Thierry static inline uint32_t gen8_pml4e_index(uint64_t address) 5129271d959SMichel Thierry { 513762d9936SMichel Thierry return (address >> GEN8_PML4E_SHIFT) & GEN8_PML4E_MASK; 5149271d959SMichel Thierry } 5159271d959SMichel Thierry 51633c8819fSMichel Thierry static inline size_t gen8_pte_count(uint64_t address, uint64_t length) 51733c8819fSMichel Thierry { 51833c8819fSMichel Thierry return i915_pte_count(address, length, GEN8_PDE_SHIFT); 51933c8819fSMichel Thierry } 52033c8819fSMichel Thierry 521d852c7bfSMika Kuoppala static inline dma_addr_t 522d852c7bfSMika Kuoppala i915_page_dir_dma_addr(const struct i915_hw_ppgtt *ppgtt, const unsigned n) 523d852c7bfSMika Kuoppala { 524d852c7bfSMika Kuoppala return test_bit(n, ppgtt->pdp.used_pdpes) ? 525567047beSMika Kuoppala px_dma(ppgtt->pdp.page_directory[n]) : 52679ab9370SMika Kuoppala px_dma(ppgtt->base.scratch_pd); 527d852c7bfSMika Kuoppala } 528d852c7bfSMika Kuoppala 529b42fe9caSJoonas Lahtinen static inline struct i915_ggtt * 530b42fe9caSJoonas Lahtinen i915_vm_to_ggtt(struct i915_address_space *vm) 531b42fe9caSJoonas Lahtinen { 532b42fe9caSJoonas Lahtinen GEM_BUG_ON(!i915_is_ggtt(vm)); 533b42fe9caSJoonas Lahtinen return container_of(vm, struct i915_ggtt, base); 534b42fe9caSJoonas Lahtinen } 535b42fe9caSJoonas Lahtinen 536949e8ab3SChris Wilson static inline bool 537949e8ab3SChris Wilson i915_vm_is_48bit(const struct i915_address_space *vm) 538949e8ab3SChris Wilson { 539949e8ab3SChris Wilson return (vm->total - 1) >> 32; 540949e8ab3SChris Wilson } 541949e8ab3SChris Wilson 5426cde9a02SChris Wilson int i915_gem_init_aliasing_ppgtt(struct drm_i915_private *i915); 5436cde9a02SChris Wilson void i915_gem_fini_aliasing_ppgtt(struct drm_i915_private *i915); 5446cde9a02SChris Wilson 54597d6d7abSChris Wilson int i915_ggtt_probe_hw(struct drm_i915_private *dev_priv); 54697d6d7abSChris Wilson int i915_ggtt_init_hw(struct drm_i915_private *dev_priv); 54797d6d7abSChris Wilson int i915_ggtt_enable_hw(struct drm_i915_private *dev_priv); 5487c3f86b6SChris Wilson void i915_ggtt_enable_guc(struct drm_i915_private *i915); 5497c3f86b6SChris Wilson void i915_ggtt_disable_guc(struct drm_i915_private *i915); 550f6b9d5caSChris Wilson int i915_gem_init_ggtt(struct drm_i915_private *dev_priv); 55197d6d7abSChris Wilson void i915_ggtt_cleanup_hw(struct drm_i915_private *dev_priv); 552ee960be7SDaniel Vetter 553c6be607aSTvrtko Ursulin int i915_ppgtt_init_hw(struct drm_i915_private *dev_priv); 554ee960be7SDaniel Vetter void i915_ppgtt_release(struct kref *kref); 5552bfa996eSChris Wilson struct i915_hw_ppgtt *i915_ppgtt_create(struct drm_i915_private *dev_priv, 55680b204bcSChris Wilson struct drm_i915_file_private *fpriv, 55780b204bcSChris Wilson const char *name); 5580c7eeda1SChris Wilson void i915_ppgtt_close(struct i915_address_space *vm); 559ee960be7SDaniel Vetter static inline void i915_ppgtt_get(struct i915_hw_ppgtt *ppgtt) 560ee960be7SDaniel Vetter { 561ee960be7SDaniel Vetter if (ppgtt) 562ee960be7SDaniel Vetter kref_get(&ppgtt->ref); 563ee960be7SDaniel Vetter } 564ee960be7SDaniel Vetter static inline void i915_ppgtt_put(struct i915_hw_ppgtt *ppgtt) 565ee960be7SDaniel Vetter { 566ee960be7SDaniel Vetter if (ppgtt) 567ee960be7SDaniel Vetter kref_put(&ppgtt->ref, i915_ppgtt_release); 568ee960be7SDaniel Vetter } 5690260c420SBen Widawsky 570dc97997aSChris Wilson void i915_check_and_clear_faults(struct drm_i915_private *dev_priv); 571275a991cSTvrtko Ursulin void i915_gem_suspend_gtt_mappings(struct drm_i915_private *dev_priv); 572275a991cSTvrtko Ursulin void i915_gem_restore_gtt_mappings(struct drm_i915_private *dev_priv); 5730260c420SBen Widawsky 57403ac84f1SChris Wilson int __must_check i915_gem_gtt_prepare_pages(struct drm_i915_gem_object *obj, 57503ac84f1SChris Wilson struct sg_table *pages); 57603ac84f1SChris Wilson void i915_gem_gtt_finish_pages(struct drm_i915_gem_object *obj, 57703ac84f1SChris Wilson struct sg_table *pages); 5780260c420SBen Widawsky 579625d988aSChris Wilson int i915_gem_gtt_reserve(struct i915_address_space *vm, 580625d988aSChris Wilson struct drm_mm_node *node, 581625d988aSChris Wilson u64 size, u64 offset, unsigned long color, 582625d988aSChris Wilson unsigned int flags); 583625d988aSChris Wilson 584e007b19dSChris Wilson int i915_gem_gtt_insert(struct i915_address_space *vm, 585e007b19dSChris Wilson struct drm_mm_node *node, 586e007b19dSChris Wilson u64 size, u64 alignment, unsigned long color, 587e007b19dSChris Wilson u64 start, u64 end, unsigned int flags); 588e007b19dSChris Wilson 58959bfa124SChris Wilson /* Flags used by pin/bind&friends. */ 590305bc234SChris Wilson #define PIN_NONBLOCK BIT(0) 591305bc234SChris Wilson #define PIN_MAPPABLE BIT(1) 592305bc234SChris Wilson #define PIN_ZONE_4G BIT(2) 59382118877SChris Wilson #define PIN_NONFAULT BIT(3) 594305bc234SChris Wilson 595305bc234SChris Wilson #define PIN_MBZ BIT(5) /* I915_VMA_PIN_OVERFLOW */ 596305bc234SChris Wilson #define PIN_GLOBAL BIT(6) /* I915_VMA_GLOBAL_BIND */ 597305bc234SChris Wilson #define PIN_USER BIT(7) /* I915_VMA_LOCAL_BIND */ 598305bc234SChris Wilson #define PIN_UPDATE BIT(8) 599305bc234SChris Wilson 600305bc234SChris Wilson #define PIN_HIGH BIT(9) 601305bc234SChris Wilson #define PIN_OFFSET_BIAS BIT(10) 602305bc234SChris Wilson #define PIN_OFFSET_FIXED BIT(11) 603f51455d4SChris Wilson #define PIN_OFFSET_MASK (-I915_GTT_PAGE_SIZE) 60459bfa124SChris Wilson 6050260c420SBen Widawsky #endif 606