2 * Copyright (C) 2018 Rob Clark <robclark@freedesktop.org>
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:
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
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
24 * Rob Clark <robclark@freedesktop.org>
30 #include "util/hash_table.h"
31 #include "util/slab.h"
33 #include "drm/freedreno_ringbuffer.h"
36 /* A "softpin" implementation of submit/ringbuffer, which lowers CPU overhead
37 * by avoiding the additional tracking necessary to build cmds/relocs tables
38 * (but still builds a bos table)
42 #define INIT_SIZE 0x1000
45 struct msm_submit_sp
{
46 struct fd_submit base
;
48 DECLARE_ARRAY(struct drm_msm_gem_submit_bo
, submit_bos
);
49 DECLARE_ARRAY(struct fd_bo
*, bos
);
51 /* maps fd_bo to idx in bos table: */
52 struct hash_table
*bo_table
;
54 struct slab_child_pool ring_pool
;
56 struct fd_ringbuffer
*primary
;
58 /* Allow for sub-allocation of stateobj ring buffers (ie. sharing
59 * the same underlying bo)..
61 * We also rely on previous stateobj having been fully constructed
62 * so we can reclaim extra space at it's end.
64 struct fd_ringbuffer
*suballoc_ring
;
66 FD_DEFINE_CAST(fd_submit
, msm_submit_sp
);
68 /* for FD_RINGBUFFER_GROWABLE rb's, tracks the 'finalized' cmdstream buffers
69 * and sizes. Ie. a finalized buffer can have no more commands appended to
73 struct fd_bo
*ring_bo
;
77 /* for _FD_RINGBUFFER_OBJECT rb's we need to track the bo's and flags to
78 * later copy into the submit when the stateobj rb is later referenced by
81 struct msm_reloc_bo_sp
{
86 struct msm_ringbuffer_sp
{
87 struct fd_ringbuffer base
;
89 /* for FD_RINGBUFFER_STREAMING rb's which are sub-allocated */
92 // TODO check disasm.. hopefully compilers CSE can realize that
93 // reloc_bos and cmds are at the same offsets and optimize some
94 // divergent cases into single case
96 /* for _FD_RINGBUFFER_OBJECT case: */
99 DECLARE_ARRAY(struct msm_reloc_bo_sp
, reloc_bos
);
101 /* for other cases: */
103 struct fd_submit
*submit
;
104 DECLARE_ARRAY(struct msm_cmd_sp
, cmds
);
108 struct fd_bo
*ring_bo
;
110 FD_DEFINE_CAST(fd_ringbuffer
, msm_ringbuffer_sp
);
112 static void finalize_current_cmd(struct fd_ringbuffer
*ring
);
113 static struct fd_ringbuffer
* msm_ringbuffer_sp_init(
114 struct msm_ringbuffer_sp
*msm_ring
,
115 uint32_t size
, enum fd_ringbuffer_flags flags
);
117 /* add (if needed) bo to submit and return index: */
119 msm_submit_append_bo(struct msm_submit_sp
*submit
, struct fd_bo
*bo
, uint32_t flags
)
121 struct msm_bo
*msm_bo
= to_msm_bo(bo
);
124 /* NOTE: it is legal to use the same bo on different threads for
125 * different submits. But it is not legal to use the same submit
126 * from given threads.
128 idx
= READ_ONCE(msm_bo
->idx
);
130 if (unlikely((idx
>= submit
->nr_submit_bos
) ||
131 (submit
->submit_bos
[idx
].handle
!= bo
->handle
))) {
132 uint32_t hash
= _mesa_hash_pointer(bo
);
133 struct hash_entry
*entry
;
135 entry
= _mesa_hash_table_search_pre_hashed(submit
->bo_table
, hash
, bo
);
138 idx
= (uint32_t)(uintptr_t)entry
->data
;
140 idx
= APPEND(submit
, submit_bos
);
141 idx
= APPEND(submit
, bos
);
143 submit
->submit_bos
[idx
].flags
= bo
->flags
;
144 submit
->submit_bos
[idx
].handle
= bo
->handle
;
145 submit
->submit_bos
[idx
].presumed
= 0;
147 submit
->bos
[idx
] = fd_bo_ref(bo
);
149 _mesa_hash_table_insert_pre_hashed(submit
->bo_table
, hash
, bo
,
150 (void *)(uintptr_t)idx
);
155 STATIC_ASSERT(FD_RELOC_READ
== MSM_SUBMIT_BO_READ
);
156 STATIC_ASSERT(FD_RELOC_WRITE
== MSM_SUBMIT_BO_WRITE
);
157 STATIC_ASSERT(FD_RELOC_DUMP
== MSM_SUBMIT_BO_DUMP
);
158 submit
->submit_bos
[idx
].flags
|=
159 flags
& (MSM_SUBMIT_BO_READ
| MSM_SUBMIT_BO_WRITE
| MSM_SUBMIT_BO_DUMP
);
165 msm_submit_suballoc_ring_bo(struct fd_submit
*submit
,
166 struct msm_ringbuffer_sp
*msm_ring
, uint32_t size
)
168 struct msm_submit_sp
*msm_submit
= to_msm_submit_sp(submit
);
169 unsigned suballoc_offset
= 0;
170 struct fd_bo
*suballoc_bo
= NULL
;
172 if (msm_submit
->suballoc_ring
) {
173 struct msm_ringbuffer_sp
*suballoc_ring
=
174 to_msm_ringbuffer_sp(msm_submit
->suballoc_ring
);
176 suballoc_bo
= suballoc_ring
->ring_bo
;
177 suballoc_offset
= fd_ringbuffer_size(msm_submit
->suballoc_ring
) +
178 suballoc_ring
->offset
;
180 suballoc_offset
= align(suballoc_offset
, 0x10);
182 if ((size
+ suballoc_offset
) > suballoc_bo
->size
) {
188 // TODO possibly larger size for streaming bo?
189 msm_ring
->ring_bo
= fd_bo_new_ring(submit
->pipe
->dev
, 0x8000);
190 msm_ring
->offset
= 0;
192 msm_ring
->ring_bo
= fd_bo_ref(suballoc_bo
);
193 msm_ring
->offset
= suballoc_offset
;
196 struct fd_ringbuffer
*old_suballoc_ring
= msm_submit
->suballoc_ring
;
198 msm_submit
->suballoc_ring
= fd_ringbuffer_ref(&msm_ring
->base
);
200 if (old_suballoc_ring
)
201 fd_ringbuffer_del(old_suballoc_ring
);
204 static struct fd_ringbuffer
*
205 msm_submit_sp_new_ringbuffer(struct fd_submit
*submit
, uint32_t size
,
206 enum fd_ringbuffer_flags flags
)
208 struct msm_submit_sp
*msm_submit
= to_msm_submit_sp(submit
);
209 struct msm_ringbuffer_sp
*msm_ring
;
211 msm_ring
= slab_alloc(&msm_submit
->ring_pool
);
213 msm_ring
->u
.submit
= submit
;
215 /* NOTE: needs to be before _suballoc_ring_bo() since it could
216 * increment the refcnt of the current ring
218 msm_ring
->base
.refcnt
= 1;
220 if (flags
& FD_RINGBUFFER_STREAMING
) {
221 msm_submit_suballoc_ring_bo(submit
, msm_ring
, size
);
223 if (flags
& FD_RINGBUFFER_GROWABLE
)
226 msm_ring
->offset
= 0;
227 msm_ring
->ring_bo
= fd_bo_new_ring(submit
->pipe
->dev
, size
);
230 if (!msm_ringbuffer_sp_init(msm_ring
, size
, flags
))
233 if (flags
& FD_RINGBUFFER_PRIMARY
) {
234 debug_assert(!msm_submit
->primary
);
235 msm_submit
->primary
= fd_ringbuffer_ref(&msm_ring
->base
);
238 return &msm_ring
->base
;
242 msm_submit_sp_flush(struct fd_submit
*submit
, int in_fence_fd
,
243 int *out_fence_fd
, uint32_t *out_fence
)
245 struct msm_submit_sp
*msm_submit
= to_msm_submit_sp(submit
);
246 struct msm_pipe
*msm_pipe
= to_msm_pipe(submit
->pipe
);
247 struct drm_msm_gem_submit req
= {
248 .flags
= msm_pipe
->pipe
,
249 .queueid
= msm_pipe
->queue_id
,
253 debug_assert(msm_submit
->primary
);
254 finalize_current_cmd(msm_submit
->primary
);
256 struct msm_ringbuffer_sp
*primary
= to_msm_ringbuffer_sp(msm_submit
->primary
);
257 struct drm_msm_gem_submit_cmd cmds
[primary
->u
.nr_cmds
];
259 for (unsigned i
= 0; i
< primary
->u
.nr_cmds
; i
++) {
260 cmds
[i
].type
= MSM_SUBMIT_CMD_BUF
;
261 cmds
[i
].submit_idx
= msm_submit_append_bo(msm_submit
,
262 primary
->u
.cmds
[i
].ring_bo
, 0);
263 cmds
[i
].submit_offset
= primary
->offset
;
264 cmds
[i
].size
= primary
->u
.cmds
[i
].size
;
266 cmds
[i
].nr_relocs
= 0;
269 if (in_fence_fd
!= -1) {
270 req
.flags
|= MSM_SUBMIT_FENCE_FD_IN
| MSM_SUBMIT_NO_IMPLICIT
;
271 req
.fence_fd
= in_fence_fd
;
275 req
.flags
|= MSM_SUBMIT_FENCE_FD_OUT
;
278 /* needs to be after get_cmd() as that could create bos/cmds table: */
279 req
.bos
= VOID2U64(msm_submit
->submit_bos
),
280 req
.nr_bos
= msm_submit
->nr_submit_bos
;
281 req
.cmds
= VOID2U64(cmds
),
282 req
.nr_cmds
= primary
->u
.nr_cmds
;
284 DEBUG_MSG("nr_cmds=%u, nr_bos=%u", req
.nr_cmds
, req
.nr_bos
);
286 ret
= drmCommandWriteRead(submit
->pipe
->dev
->fd
, DRM_MSM_GEM_SUBMIT
,
289 ERROR_MSG("submit failed: %d (%s)", ret
, strerror(errno
));
290 msm_dump_submit(&req
);
293 *out_fence
= req
.fence
;
296 *out_fence_fd
= req
.fence_fd
;
303 msm_submit_sp_destroy(struct fd_submit
*submit
)
305 struct msm_submit_sp
*msm_submit
= to_msm_submit_sp(submit
);
307 if (msm_submit
->primary
)
308 fd_ringbuffer_del(msm_submit
->primary
);
309 if (msm_submit
->suballoc_ring
)
310 fd_ringbuffer_del(msm_submit
->suballoc_ring
);
312 _mesa_hash_table_destroy(msm_submit
->bo_table
, NULL
);
314 // TODO it would be nice to have a way to debug_assert() if all
315 // rb's haven't been free'd back to the slab, because that is
316 // an indication that we are leaking bo's
317 slab_destroy_child(&msm_submit
->ring_pool
);
319 for (unsigned i
= 0; i
< msm_submit
->nr_bos
; i
++)
320 fd_bo_del(msm_submit
->bos
[i
]);
322 free(msm_submit
->submit_bos
);
323 free(msm_submit
->bos
);
327 static const struct fd_submit_funcs submit_funcs
= {
328 .new_ringbuffer
= msm_submit_sp_new_ringbuffer
,
329 .flush
= msm_submit_sp_flush
,
330 .destroy
= msm_submit_sp_destroy
,
334 msm_submit_sp_new(struct fd_pipe
*pipe
)
336 struct msm_submit_sp
*msm_submit
= calloc(1, sizeof(*msm_submit
));
337 struct fd_submit
*submit
;
339 msm_submit
->bo_table
= _mesa_hash_table_create(NULL
,
340 _mesa_hash_pointer
, _mesa_key_pointer_equal
);
342 slab_create_child(&msm_submit
->ring_pool
, &to_msm_pipe(pipe
)->ring_pool
);
344 submit
= &msm_submit
->base
;
346 submit
->funcs
= &submit_funcs
;
352 msm_pipe_sp_ringpool_init(struct msm_pipe
*msm_pipe
)
355 slab_create_parent(&msm_pipe
->ring_pool
, sizeof(struct msm_ringbuffer_sp
), 16);
359 msm_pipe_sp_ringpool_fini(struct msm_pipe
*msm_pipe
)
361 if (msm_pipe
->ring_pool
.num_elements
)
362 slab_destroy_parent(&msm_pipe
->ring_pool
);
366 finalize_current_cmd(struct fd_ringbuffer
*ring
)
368 debug_assert(!(ring
->flags
& _FD_RINGBUFFER_OBJECT
));
370 struct msm_ringbuffer_sp
*msm_ring
= to_msm_ringbuffer_sp(ring
);
371 unsigned idx
= APPEND(&msm_ring
->u
, cmds
);
373 msm_ring
->u
.cmds
[idx
].ring_bo
= fd_bo_ref(msm_ring
->ring_bo
);
374 msm_ring
->u
.cmds
[idx
].size
= offset_bytes(ring
->cur
, ring
->start
);
378 msm_ringbuffer_sp_grow(struct fd_ringbuffer
*ring
, uint32_t size
)
380 struct msm_ringbuffer_sp
*msm_ring
= to_msm_ringbuffer_sp(ring
);
381 struct fd_pipe
*pipe
= msm_ring
->u
.submit
->pipe
;
383 debug_assert(ring
->flags
& FD_RINGBUFFER_GROWABLE
);
385 finalize_current_cmd(ring
);
387 fd_bo_del(msm_ring
->ring_bo
);
388 msm_ring
->ring_bo
= fd_bo_new_ring(pipe
->dev
, size
);
390 ring
->start
= fd_bo_map(msm_ring
->ring_bo
);
391 ring
->end
= &(ring
->start
[size
/4]);
392 ring
->cur
= ring
->start
;
397 msm_ringbuffer_sp_emit_reloc(struct fd_ringbuffer
*ring
,
398 const struct fd_reloc
*reloc
)
400 struct msm_ringbuffer_sp
*msm_ring
= to_msm_ringbuffer_sp(ring
);
401 struct fd_pipe
*pipe
;
403 if (ring
->flags
& _FD_RINGBUFFER_OBJECT
) {
404 unsigned idx
= APPEND(&msm_ring
->u
, reloc_bos
);
406 msm_ring
->u
.reloc_bos
[idx
].bo
= fd_bo_ref(reloc
->bo
);
407 msm_ring
->u
.reloc_bos
[idx
].flags
= reloc
->flags
;
409 pipe
= msm_ring
->u
.pipe
;
411 struct msm_submit_sp
*msm_submit
=
412 to_msm_submit_sp(msm_ring
->u
.submit
);
414 msm_submit_append_bo(msm_submit
, reloc
->bo
, reloc
->flags
);
416 pipe
= msm_ring
->u
.submit
->pipe
;
419 uint64_t iova
= reloc
->bo
->iova
+ reloc
->offset
;
420 int shift
= reloc
->shift
;
427 uint32_t dword
= iova
;
429 (*ring
->cur
++) = dword
| reloc
->or;
431 if (pipe
->gpu_id
>= 500) {
433 (*ring
->cur
++) = dword
| reloc
->orhi
;
438 msm_ringbuffer_sp_emit_reloc_ring(struct fd_ringbuffer
*ring
,
439 struct fd_ringbuffer
*target
, uint32_t cmd_idx
)
441 struct msm_ringbuffer_sp
*msm_target
= to_msm_ringbuffer_sp(target
);
445 if ((target
->flags
& FD_RINGBUFFER_GROWABLE
) &&
446 (cmd_idx
< msm_target
->u
.nr_cmds
)) {
447 bo
= msm_target
->u
.cmds
[cmd_idx
].ring_bo
;
448 size
= msm_target
->u
.cmds
[cmd_idx
].size
;
450 bo
= msm_target
->ring_bo
;
451 size
= offset_bytes(target
->cur
, target
->start
);
454 msm_ringbuffer_sp_emit_reloc(ring
, &(struct fd_reloc
){
456 .offset
= msm_target
->offset
,
459 if (!(target
->flags
& _FD_RINGBUFFER_OBJECT
))
462 struct msm_ringbuffer_sp
*msm_ring
= to_msm_ringbuffer_sp(ring
);
464 if (ring
->flags
& _FD_RINGBUFFER_OBJECT
) {
465 for (unsigned i
= 0; i
< msm_target
->u
.nr_reloc_bos
; i
++) {
466 unsigned idx
= APPEND(&msm_ring
->u
, reloc_bos
);
468 msm_ring
->u
.reloc_bos
[idx
].bo
=
469 fd_bo_ref(msm_target
->u
.reloc_bos
[i
].bo
);
470 msm_ring
->u
.reloc_bos
[idx
].flags
=
471 msm_target
->u
.reloc_bos
[i
].flags
;
474 // TODO it would be nice to know whether we have already
475 // seen this target before. But hopefully we hit the
476 // append_bo() fast path enough for this to not matter:
477 struct msm_submit_sp
*msm_submit
= to_msm_submit_sp(msm_ring
->u
.submit
);
479 for (unsigned i
= 0; i
< msm_target
->u
.nr_reloc_bos
; i
++) {
480 msm_submit_append_bo(msm_submit
, msm_target
->u
.reloc_bos
[i
].bo
,
481 msm_target
->u
.reloc_bos
[i
].flags
);
489 msm_ringbuffer_sp_cmd_count(struct fd_ringbuffer
*ring
)
491 if (ring
->flags
& FD_RINGBUFFER_GROWABLE
)
492 return to_msm_ringbuffer_sp(ring
)->u
.nr_cmds
+ 1;
497 msm_ringbuffer_sp_destroy(struct fd_ringbuffer
*ring
)
499 struct msm_ringbuffer_sp
*msm_ring
= to_msm_ringbuffer_sp(ring
);
501 fd_bo_del(msm_ring
->ring_bo
);
503 if (ring
->flags
& _FD_RINGBUFFER_OBJECT
) {
504 for (unsigned i
= 0; i
< msm_ring
->u
.nr_reloc_bos
; i
++) {
505 fd_bo_del(msm_ring
->u
.reloc_bos
[i
].bo
);
507 free(msm_ring
->u
.reloc_bos
);
511 struct fd_submit
*submit
= msm_ring
->u
.submit
;
513 for (unsigned i
= 0; i
< msm_ring
->u
.nr_cmds
; i
++) {
514 fd_bo_del(msm_ring
->u
.cmds
[i
].ring_bo
);
516 free(msm_ring
->u
.cmds
);
518 slab_free(&to_msm_submit_sp(submit
)->ring_pool
, msm_ring
);
522 static const struct fd_ringbuffer_funcs ring_funcs
= {
523 .grow
= msm_ringbuffer_sp_grow
,
524 .emit_reloc
= msm_ringbuffer_sp_emit_reloc
,
525 .emit_reloc_ring
= msm_ringbuffer_sp_emit_reloc_ring
,
526 .cmd_count
= msm_ringbuffer_sp_cmd_count
,
527 .destroy
= msm_ringbuffer_sp_destroy
,
530 static inline struct fd_ringbuffer
*
531 msm_ringbuffer_sp_init(struct msm_ringbuffer_sp
*msm_ring
, uint32_t size
,
532 enum fd_ringbuffer_flags flags
)
534 struct fd_ringbuffer
*ring
= &msm_ring
->base
;
536 debug_assert(msm_ring
->ring_bo
);
538 uint8_t *base
= fd_bo_map(msm_ring
->ring_bo
);
539 ring
->start
= (void *)(base
+ msm_ring
->offset
);
540 ring
->end
= &(ring
->start
[size
/4]);
541 ring
->cur
= ring
->start
;
546 ring
->funcs
= &ring_funcs
;
548 // TODO initializing these could probably be conditional on flags
549 // since unneed for FD_RINGBUFFER_STAGING case..
550 msm_ring
->u
.cmds
= NULL
;
551 msm_ring
->u
.nr_cmds
= msm_ring
->u
.max_cmds
= 0;
553 msm_ring
->u
.reloc_bos
= NULL
;
554 msm_ring
->u
.nr_reloc_bos
= msm_ring
->u
.max_reloc_bos
= 0;
559 struct fd_ringbuffer
*
560 msm_ringbuffer_sp_new_object(struct fd_pipe
*pipe
, uint32_t size
)
562 struct msm_ringbuffer_sp
*msm_ring
= malloc(sizeof(*msm_ring
));
564 msm_ring
->u
.pipe
= pipe
;
565 msm_ring
->offset
= 0;
566 msm_ring
->ring_bo
= fd_bo_new_ring(pipe
->dev
, size
);
567 msm_ring
->base
.refcnt
= 1;
569 return msm_ringbuffer_sp_init(msm_ring
, size
, _FD_RINGBUFFER_OBJECT
);