1 /* 2 * © Copyright 2019 Alyssa Rosenzweig 3 * © Copyright 2019 Collabora, Ltd. 4 * 5 * Permission is hereby granted, free of charge, to any person obtaining a 6 * copy of this software and associated documentation files (the "Software"), 7 * to deal in the Software without restriction, including without limitation 8 * the rights to use, copy, modify, merge, publish, distribute, sublicense, 9 * and/or sell copies of the Software, and to permit persons to whom the 10 * Software is furnished to do so, subject to the following conditions: 11 * 12 * The above copyright notice and this permission notice (including the next 13 * paragraph) shall be included in all copies or substantial portions of the 14 * Software. 15 * 16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 19 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 21 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 22 * SOFTWARE. 23 * 24 */ 25 26 #ifndef __PAN_BO_H__ 27 #define __PAN_BO_H__ 28 29 #include "util/list.h" 30 #include "panfrost-job.h" 31 #include <time.h> 32 33 /* Flags for allocated memory */ 34 35 /* This memory region is executable */ 36 #define PAN_BO_EXECUTE (1 << 0) 37 38 /* This memory region should be lazily allocated and grow-on-page-fault. Must 39 * be used in conjunction with INVISIBLE */ 40 #define PAN_BO_GROWABLE (1 << 1) 41 42 /* This memory region should not be mapped to the CPU */ 43 #define PAN_BO_INVISIBLE (1 << 2) 44 45 /* This region may not be used immediately and will not mmap on allocate 46 * (semantically distinct from INVISIBLE, which cannot never be mmaped) */ 47 #define PAN_BO_DELAY_MMAP (1 << 3) 48 49 /* BO is shared across processes (imported or exported) and therefore cannot be 50 * cached locally */ 51 #define PAN_BO_SHARED (1 << 4) 52 53 /* GPU access flags */ 54 55 /* BO is either shared (can be accessed by more than one GPU batch) or private 56 * (reserved by a specific GPU job). */ 57 #define PAN_BO_ACCESS_PRIVATE (0 << 0) 58 #define PAN_BO_ACCESS_SHARED (1 << 0) 59 60 /* BO is being read/written by the GPU */ 61 #define PAN_BO_ACCESS_READ (1 << 1) 62 #define PAN_BO_ACCESS_WRITE (1 << 2) 63 #define PAN_BO_ACCESS_RW (PAN_BO_ACCESS_READ | PAN_BO_ACCESS_WRITE) 64 65 /* BO is accessed by the vertex/tiler job. */ 66 #define PAN_BO_ACCESS_VERTEX_TILER (1 << 3) 67 68 /* BO is accessed by the fragment job. */ 69 #define PAN_BO_ACCESS_FRAGMENT (1 << 4) 70 71 typedef uint8_t pan_bo_access; 72 73 struct panfrost_device; 74 75 struct panfrost_ptr { 76 /* CPU address */ 77 void *cpu; 78 79 /* GPU address */ 80 mali_ptr gpu; 81 }; 82 83 struct panfrost_bo { 84 /* Must be first for casting */ 85 struct list_head bucket_link; 86 87 /* Used to link the BO to the BO cache LRU list. */ 88 struct list_head lru_link; 89 90 /* Store the time this BO was use last, so the BO cache logic can evict 91 * stale BOs. 92 */ 93 time_t last_used; 94 95 /* Atomic reference count */ 96 int32_t refcnt; 97 98 struct panfrost_device *dev; 99 100 /* Mapping for the entire object (all levels) */ 101 struct panfrost_ptr ptr; 102 103 /* Size of all entire trees */ 104 size_t size; 105 106 int gem_handle; 107 108 uint32_t flags; 109 110 /* Combination of PAN_BO_ACCESS_{READ,WRITE} flags encoding pending 111 * GPU accesses to this BO. Useful to avoid calling the WAIT_BO ioctl 112 * when the BO is idle. 113 */ 114 uint32_t gpu_access; 115 116 /* Human readable description of the BO for debugging. */ 117 const char *label; 118 }; 119 120 bool 121 panfrost_bo_wait(struct panfrost_bo *bo, int64_t timeout_ns, bool wait_readers); 122 void 123 panfrost_bo_reference(struct panfrost_bo *bo); 124 void 125 panfrost_bo_unreference(struct panfrost_bo *bo); 126 struct panfrost_bo * 127 panfrost_bo_create(struct panfrost_device *dev, size_t size, 128 uint32_t flags, const char *label); 129 void 130 panfrost_bo_mmap(struct panfrost_bo *bo); 131 struct panfrost_bo * 132 panfrost_bo_import(struct panfrost_device *dev, int fd); 133 int 134 panfrost_bo_export(struct panfrost_bo *bo); 135 void 136 panfrost_bo_cache_evict_all(struct panfrost_device *dev); 137 138 #endif /* __PAN_BO_H__ */ 139