1 /*
2 * Copyright (C) 2012-2018 Rob Clark <robclark@freedesktop.org>
3 *
4 * Permission is hereby granted, free of charge, to any person obtaining a
5 * copy of this software and associated documentation files (the "Software"),
6 * to deal in the Software without restriction, including without limitation
7 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8 * and/or sell copies of the Software, and to permit persons to whom the
9 * Software is furnished to do so, subject to the following conditions:
10 *
11 * The above copyright notice and this permission notice (including the next
12 * paragraph) shall be included in all copies or substantial portions of the
13 * Software.
14 *
15 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
18 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 * SOFTWARE.
22 *
23 * Authors:
24 * Rob Clark <robclark@freedesktop.org>
25 */
26
27 #ifndef FREEDRENO_DRMIF_H_
28 #define FREEDRENO_DRMIF_H_
29
30 #include <stdint.h>
31
32 #include "util/u_debug.h"
33
34 struct fd_bo;
35 struct fd_pipe;
36 struct fd_device;
37
38 enum fd_pipe_id {
39 FD_PIPE_3D = 1,
40 FD_PIPE_2D = 2,
41 /* some devices have two 2d blocks.. not really sure how to
42 * use that yet, so just ignoring the 2nd 2d pipe for now
43 */
44 FD_PIPE_MAX
45 };
46
47 enum fd_param_id {
48 FD_DEVICE_ID,
49 FD_GMEM_SIZE,
50 FD_GMEM_BASE,
51 FD_GPU_ID,
52 FD_CHIP_ID,
53 FD_MAX_FREQ,
54 FD_TIMESTAMP,
55 FD_NR_RINGS, /* # of rings == # of distinct priority levels */
56 FD_PP_PGTABLE, /* are per-process pagetables used for the pipe/ctx */
57 FD_CTX_FAULTS, /* # of per context faults */
58 FD_GLOBAL_FAULTS, /* # of global (all context) faults */
59 };
60
61 /* bo flags: */
62 #define DRM_FREEDRENO_GEM_TYPE_SMI 0x00000001
63 #define DRM_FREEDRENO_GEM_TYPE_KMEM 0x00000002
64 #define DRM_FREEDRENO_GEM_TYPE_MEM_MASK 0x0000000f
65 #define DRM_FREEDRENO_GEM_CACHE_NONE 0x00000000
66 #define DRM_FREEDRENO_GEM_CACHE_WCOMBINE 0x00100000
67 #define DRM_FREEDRENO_GEM_CACHE_WTHROUGH 0x00200000
68 #define DRM_FREEDRENO_GEM_CACHE_WBACK 0x00400000
69 #define DRM_FREEDRENO_GEM_CACHE_WBACKWA 0x00800000
70 #define DRM_FREEDRENO_GEM_CACHE_MASK 0x00f00000
71 #define DRM_FREEDRENO_GEM_GPUREADONLY 0x01000000
72 #define DRM_FREEDRENO_GEM_SCANOUT 0x02000000
73
74 /* bo access flags: (keep aligned to MSM_PREP_x) */
75 #define DRM_FREEDRENO_PREP_READ 0x01
76 #define DRM_FREEDRENO_PREP_WRITE 0x02
77 #define DRM_FREEDRENO_PREP_NOSYNC 0x04
78
79 /* device functions:
80 */
81
82 struct fd_device * fd_device_new(int fd);
83 struct fd_device * fd_device_new_dup(int fd);
84 struct fd_device * fd_device_ref(struct fd_device *dev);
85 void fd_device_del(struct fd_device *dev);
86 int fd_device_fd(struct fd_device *dev);
87
88 enum fd_version {
89 FD_VERSION_MADVISE = 1, /* kernel supports madvise */
90 FD_VERSION_UNLIMITED_CMDS = 1, /* submits w/ >4 cmd buffers (growable ringbuffer) */
91 FD_VERSION_FENCE_FD = 2, /* submit command supports in/out fences */
92 FD_VERSION_GMEM_BASE = 3, /* supports querying GMEM base address */
93 FD_VERSION_SUBMIT_QUEUES = 3, /* submit queues and multiple priority levels */
94 FD_VERSION_BO_IOVA = 3, /* supports fd_bo_get/put_iova() */
95 FD_VERSION_SOFTPIN = 4, /* adds softpin, bo name, and dump flag */
96 FD_VERSION_ROBUSTNESS = 5, /* adds FD_NR_FAULTS and FD_PP_PGTABLE */
97 FD_VERSION_MEMORY_FD = 2, /* supports shared memory objects */
98 };
99 enum fd_version fd_device_version(struct fd_device *dev);
100
101 bool fd_has_syncobj(struct fd_device *dev);
102
103 /* pipe functions:
104 */
105
106 struct fd_pipe * fd_pipe_new(struct fd_device *dev, enum fd_pipe_id id);
107 struct fd_pipe * fd_pipe_new2(struct fd_device *dev, enum fd_pipe_id id, uint32_t prio);
108 struct fd_pipe * fd_pipe_ref(struct fd_pipe *pipe);
109 void fd_pipe_del(struct fd_pipe *pipe);
110 int fd_pipe_get_param(struct fd_pipe *pipe, enum fd_param_id param,
111 uint64_t *value);
112 int fd_pipe_wait(struct fd_pipe *pipe, uint32_t timestamp);
113 /* timeout in nanosec */
114 int fd_pipe_wait_timeout(struct fd_pipe *pipe, uint32_t timestamp,
115 uint64_t timeout);
116
117
118 /* buffer-object functions:
119 */
120
121 struct fd_bo * _fd_bo_new(struct fd_device *dev,
122 uint32_t size, uint32_t flags);
123 void _fd_bo_set_name(struct fd_bo *bo, const char *fmt, va_list ap);
124
125 static inline void
126 fd_bo_set_name(struct fd_bo *bo, const char *fmt, ...) _util_printf_format(2, 3);
127
128 static inline void
fd_bo_set_name(struct fd_bo * bo,const char * fmt,...)129 fd_bo_set_name(struct fd_bo *bo, const char *fmt, ...)
130 {
131 #ifndef NDEBUG
132 va_list ap;
133 va_start(ap, fmt);
134 _fd_bo_set_name(bo, fmt, ap);
135 va_end(ap);
136 #endif
137 }
138
139 static inline struct fd_bo *
140 fd_bo_new(struct fd_device *dev, uint32_t size, uint32_t flags,
141 const char *fmt, ...) _util_printf_format(4, 5);
142
143 static inline struct fd_bo *
fd_bo_new(struct fd_device * dev,uint32_t size,uint32_t flags,const char * fmt,...)144 fd_bo_new(struct fd_device *dev, uint32_t size, uint32_t flags,
145 const char *fmt, ...)
146 {
147 struct fd_bo *bo = _fd_bo_new(dev, size, flags);
148 #ifndef NDEBUG
149 if (fmt) {
150 va_list ap;
151 va_start(ap, fmt);
152 _fd_bo_set_name(bo, fmt, ap);
153 va_end(ap);
154 }
155 #endif
156 return bo;
157 }
158
159 struct fd_bo *fd_bo_from_handle(struct fd_device *dev,
160 uint32_t handle, uint32_t size);
161 struct fd_bo * fd_bo_from_name(struct fd_device *dev, uint32_t name);
162 struct fd_bo * fd_bo_from_dmabuf(struct fd_device *dev, int fd);
163 void fd_bo_mark_for_dump(struct fd_bo *bo);
164 uint64_t fd_bo_get_iova(struct fd_bo *bo);
165 struct fd_bo * fd_bo_ref(struct fd_bo *bo);
166 void fd_bo_del(struct fd_bo *bo);
167 int fd_bo_get_name(struct fd_bo *bo, uint32_t *name);
168 uint32_t fd_bo_handle(struct fd_bo *bo);
169 int fd_bo_dmabuf(struct fd_bo *bo);
170 uint32_t fd_bo_size(struct fd_bo *bo);
171 void * fd_bo_map(struct fd_bo *bo);
172 int fd_bo_cpu_prep(struct fd_bo *bo, struct fd_pipe *pipe, uint32_t op);
173 void fd_bo_cpu_fini(struct fd_bo *bo);
174
175 #endif /* FREEDRENO_DRMIF_H_ */
176