xref: /third_party/mesa3d/src/panfrost/lib/pan_bo.h (revision bf215546)
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
71typedef uint8_t pan_bo_access;
72
73struct panfrost_device;
74
75struct panfrost_ptr {
76        /* CPU address */
77        void *cpu;
78
79        /* GPU address */
80        mali_ptr gpu;
81};
82
83struct 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
120bool
121panfrost_bo_wait(struct panfrost_bo *bo, int64_t timeout_ns, bool wait_readers);
122void
123panfrost_bo_reference(struct panfrost_bo *bo);
124void
125panfrost_bo_unreference(struct panfrost_bo *bo);
126struct panfrost_bo *
127panfrost_bo_create(struct panfrost_device *dev, size_t size,
128                   uint32_t flags, const char *label);
129void
130panfrost_bo_mmap(struct panfrost_bo *bo);
131struct panfrost_bo *
132panfrost_bo_import(struct panfrost_device *dev, int fd);
133int
134panfrost_bo_export(struct panfrost_bo *bo);
135void
136panfrost_bo_cache_evict_all(struct panfrost_device *dev);
137
138#endif /* __PAN_BO_H__ */
139