1 /* SPDX-License-Identifier: MIT */ 2 /* 3 * Copyright © 2021 Intel Corporation 4 */ 5 #ifndef _I915_GEM_TTM_H_ 6 #define _I915_GEM_TTM_H_ 7 8 #include <drm/ttm/ttm_placement.h> 9 10 #include "gem/i915_gem_object_types.h" 11 12 /** 13 * i915_gem_to_ttm - Convert a struct drm_i915_gem_object to a 14 * struct ttm_buffer_object. 15 * @obj: Pointer to the gem object. 16 * 17 * Return: Pointer to the embedded struct ttm_buffer_object. 18 */ 19 static inline struct ttm_buffer_object * 20 i915_gem_to_ttm(struct drm_i915_gem_object *obj) 21 { 22 return &obj->__do_not_access; 23 } 24 25 /* 26 * i915 ttm gem object destructor. Internal use only. 27 */ 28 void i915_ttm_bo_destroy(struct ttm_buffer_object *bo); 29 30 /** 31 * i915_ttm_is_ghost_object - Check if the ttm bo is a ghost object. 32 * @bo: Pointer to the ttm buffer object 33 * 34 * Return: True if the ttm bo is not a i915 object but a ghost ttm object, 35 * False otherwise. 36 */ 37 static inline bool i915_ttm_is_ghost_object(struct ttm_buffer_object *bo) 38 { 39 return bo->destroy != i915_ttm_bo_destroy; 40 } 41 42 /** 43 * i915_ttm_to_gem - Convert a struct ttm_buffer_object to an embedding 44 * struct drm_i915_gem_object. 45 * @bo: Pointer to the ttm buffer object 46 * 47 * Return: Pointer to the embedding struct drm_i915_gem_object. 48 */ 49 static inline struct drm_i915_gem_object * 50 i915_ttm_to_gem(struct ttm_buffer_object *bo) 51 { 52 return container_of(bo, struct drm_i915_gem_object, __do_not_access); 53 } 54 55 int __i915_gem_ttm_object_init(struct intel_memory_region *mem, 56 struct drm_i915_gem_object *obj, 57 resource_size_t offset, 58 resource_size_t size, 59 resource_size_t page_size, 60 unsigned int flags); 61 62 /* Internal I915 TTM declarations and definitions below. */ 63 64 #define I915_PL_LMEM0 TTM_PL_PRIV 65 #define I915_PL_SYSTEM TTM_PL_SYSTEM 66 #define I915_PL_STOLEN TTM_PL_VRAM 67 #define I915_PL_GGTT TTM_PL_TT 68 69 struct ttm_placement *i915_ttm_sys_placement(void); 70 71 void i915_ttm_free_cached_io_rsgt(struct drm_i915_gem_object *obj); 72 73 struct i915_refct_sgt * 74 i915_ttm_resource_get_st(struct drm_i915_gem_object *obj, 75 struct ttm_resource *res); 76 77 void i915_ttm_adjust_lru(struct drm_i915_gem_object *obj); 78 79 int i915_ttm_purge(struct drm_i915_gem_object *obj); 80 81 /** 82 * i915_ttm_gtt_binds_lmem - Should the memory be viewed as LMEM by the GTT? 83 * @mem: struct ttm_resource representing the memory. 84 * 85 * Return: true if memory should be viewed as LMEM for GTT binding purposes, 86 * false otherwise. 87 */ 88 static inline bool i915_ttm_gtt_binds_lmem(struct ttm_resource *mem) 89 { 90 return mem->mem_type != I915_PL_SYSTEM; 91 } 92 93 /** 94 * i915_ttm_cpu_maps_iomem - Should the memory be viewed as IOMEM by the CPU? 95 * @mem: struct ttm_resource representing the memory. 96 * 97 * Return: true if memory should be viewed as IOMEM for CPU mapping purposes. 98 */ 99 static inline bool i915_ttm_cpu_maps_iomem(struct ttm_resource *mem) 100 { 101 /* Once / if we support GGTT, this is also false for cached ttm_tts */ 102 return mem && mem->mem_type != I915_PL_SYSTEM; 103 } 104 105 bool i915_ttm_resource_mappable(struct ttm_resource *res); 106 107 #endif 108