1 /* SPDX-License-Identifier: GPL-2.0 */ 2 /* Copyright 2019 Linaro, Ltd, Rob Herring <robh@kernel.org> */ 3 4 #ifndef __PANFROST_GEM_H__ 5 #define __PANFROST_GEM_H__ 6 7 #include <drm/drm_gem_shmem_helper.h> 8 #include <drm/drm_mm.h> 9 10 struct panfrost_mmu; 11 struct panfrost_device; 12 13 #define PANFROST_BO_LABEL_MAXLEN 4096 14 15 enum panfrost_debugfs_gem_state_flags { 16 /** @PANFROST_DEBUGFS_GEM_STATE_FLAG_IMPORTED: GEM BO is PRIME imported. */ 17 PANFROST_DEBUGFS_GEM_STATE_FLAG_IMPORTED = BIT(0), 18 19 /** @PANFROST_DEBUGFS_GEM_STATE_FLAG_EXPORTED: GEM BO is PRIME exported. */ 20 PANFROST_DEBUGFS_GEM_STATE_FLAG_EXPORTED = BIT(1), 21 22 /** @PANFROST_DEBUGFS_GEM_STATE_FLAG_PURGED: GEM BO was reclaimed by the shrinker. */ 23 PANFROST_DEBUGFS_GEM_STATE_FLAG_PURGED = BIT(2), 24 25 /** 26 * @PANFROST_DEBUGFS_GEM_STATE_FLAG_PURGEABLE: GEM BO pages were marked as no longer 27 * needed by UM and can be reclaimed by the shrinker. 28 */ 29 PANFROST_DEBUGFS_GEM_STATE_FLAG_PURGEABLE = BIT(3), 30 }; 31 32 /** 33 * struct panfrost_gem_debugfs - GEM object's DebugFS list information 34 */ 35 struct panfrost_gem_debugfs { 36 /** 37 * @node: Node used to insert the object in the device-wide list of 38 * GEM objects, to display information about it through a DebugFS file. 39 */ 40 struct list_head node; 41 42 /** @creator: Information about the UM process which created the GEM. */ 43 struct { 44 /** @creator.process_name: Group leader name in owning thread's process */ 45 char process_name[TASK_COMM_LEN]; 46 47 /** @creator.tgid: PID of the thread's group leader within its process */ 48 pid_t tgid; 49 } creator; 50 }; 51 52 struct panfrost_gem_object { 53 struct drm_gem_shmem_object base; 54 struct sg_table *sgts; 55 56 /* 57 * Use a list for now. If searching a mapping ever becomes the 58 * bottleneck, we should consider using an RB-tree, or even better, 59 * let the core store drm_gem_object_mapping entries (where we 60 * could place driver specific data) instead of drm_gem_object ones 61 * in its drm_file->object_idr table. 62 * 63 * struct drm_gem_object_mapping { 64 * struct drm_gem_object *obj; 65 * void *driver_priv; 66 * }; 67 */ 68 struct { 69 struct list_head list; 70 struct mutex lock; 71 } mappings; 72 73 /* 74 * Count the number of jobs referencing this BO so we don't let the 75 * shrinker reclaim this object prematurely. 76 */ 77 atomic_t gpu_usecount; 78 79 /* 80 * Object chunk size currently mapped onto physical memory 81 */ 82 size_t heap_rss_size; 83 84 /** 85 * @label: BO tagging fields. The label can be assigned within the 86 * driver itself or through a specific IOCTL. 87 */ 88 struct { 89 /** 90 * @label.str: Pointer to NULL-terminated string, 91 */ 92 const char *str; 93 94 /** @lock.str: Protects access to the @label.str field. */ 95 struct mutex lock; 96 } label; 97 98 bool noexec :1; 99 bool is_heap :1; 100 101 /* On coherent devices, this reflects the creation flags, not the true 102 * cacheability attribute of the mapping. 103 */ 104 bool wb_mmap :1; 105 106 #ifdef CONFIG_DEBUG_FS 107 struct panfrost_gem_debugfs debugfs; 108 #endif 109 }; 110 111 struct panfrost_gem_mapping { 112 struct list_head node; 113 struct kref refcount; 114 struct panfrost_gem_object *obj; 115 struct drm_mm_node mmnode; 116 struct panfrost_mmu *mmu; 117 bool active :1; 118 }; 119 120 static inline 121 struct panfrost_gem_object *to_panfrost_bo(struct drm_gem_object *obj) 122 { 123 return container_of(to_drm_gem_shmem_obj(obj), struct panfrost_gem_object, base); 124 } 125 126 static inline struct panfrost_gem_mapping * 127 drm_mm_node_to_panfrost_mapping(struct drm_mm_node *node) 128 { 129 return container_of(node, struct panfrost_gem_mapping, mmnode); 130 } 131 132 void panfrost_gem_init(struct panfrost_device *pfdev); 133 134 struct drm_gem_object *panfrost_gem_create_object(struct drm_device *dev, size_t size); 135 136 struct drm_gem_object * 137 panfrost_gem_prime_import_sg_table(struct drm_device *dev, 138 struct dma_buf_attachment *attach, 139 struct sg_table *sgt); 140 struct drm_gem_object * 141 panfrost_gem_prime_import(struct drm_device *dev, 142 struct dma_buf *dma_buf); 143 144 struct panfrost_gem_object * 145 panfrost_gem_create(struct drm_device *dev, size_t size, u32 flags); 146 147 int panfrost_gem_open(struct drm_gem_object *obj, struct drm_file *file_priv); 148 void panfrost_gem_close(struct drm_gem_object *obj, 149 struct drm_file *file_priv); 150 151 struct panfrost_gem_mapping * 152 panfrost_gem_mapping_get(struct panfrost_gem_object *bo, 153 struct panfrost_file_priv *priv); 154 void panfrost_gem_mapping_put(struct panfrost_gem_mapping *mapping); 155 void panfrost_gem_teardown_mappings_locked(struct panfrost_gem_object *bo); 156 157 int panfrost_gem_shrinker_init(struct drm_device *dev); 158 void panfrost_gem_shrinker_cleanup(struct drm_device *dev); 159 160 void panfrost_gem_set_label(struct drm_gem_object *obj, const char *label); 161 int panfrost_gem_sync(struct drm_gem_object *obj, u32 type, 162 u32 offset, u32 size); 163 void panfrost_gem_internal_set_label(struct drm_gem_object *obj, const char *label); 164 165 #ifdef CONFIG_DEBUG_FS 166 void panfrost_gem_debugfs_print_bos(struct panfrost_device *pfdev, 167 struct seq_file *m); 168 #endif 169 170 #endif /* __PANFROST_GEM_H__ */ 171