2 * Copyright 2008 Advanced Micro Devices, Inc.
3 * Copyright 2008 Red Hat Inc.
4 * Copyright 2009 Jerome Glisse.
6 * Permission is hereby granted, free of charge, to any person obtaining a
7 * copy of this software and associated documentation files (the "Software"),
8 * to deal in the Software without restriction, including without limitation
9 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
10 * and/or sell copies of the Software, and to permit persons to whom the
11 * Software is furnished to do so, subject to the following conditions:
13 * The above copyright notice and this permission notice shall be included in
14 * all copies or substantial portions of the Software.
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 COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
20 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
21 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
22 * OTHER DEALINGS IN THE SOFTWARE.
24 * Authors: Dave Airlie
34 * Most engines on the GPU are fed via ring buffers. Ring
35 * buffers are areas of GPU accessible memory that the host
36 * writes commands into and the GPU reads commands out of.
37 * There is a rptr (read pointer) that determines where the
38 * GPU is currently reading, and a wptr (write pointer)
39 * which determines where the host has written. When the
40 * pointers are equal, the ring is idle. When the host
41 * writes commands to the ring buffer, it increments the
42 * wptr. The GPU then starts fetching commands and executes
43 * them until the pointers are equal again.
45 static int radeon_debugfs_ring_init(struct radeon_device
*rdev
, struct radeon_ring
*ring
);
48 * radeon_ring_supports_scratch_reg - check if the ring supports
49 * writing to scratch registers
51 * @rdev: radeon_device pointer
52 * @ring: radeon_ring structure holding ring information
54 * Check if a specific ring supports writing to scratch registers (all asics).
55 * Returns true if the ring supports writing to scratch regs, false if not.
57 bool radeon_ring_supports_scratch_reg(struct radeon_device
*rdev
,
58 struct radeon_ring
*ring
)
61 case RADEON_RING_TYPE_GFX_INDEX
:
62 case CAYMAN_RING_TYPE_CP1_INDEX
:
63 case CAYMAN_RING_TYPE_CP2_INDEX
:
71 * radeon_ring_free_size - update the free size
73 * @rdev: radeon_device pointer
74 * @ring: radeon_ring structure holding ring information
76 * Update the free dw slots in the ring buffer (all asics).
78 void radeon_ring_free_size(struct radeon_device
*rdev
, struct radeon_ring
*ring
)
80 uint32_t rptr
= radeon_ring_get_rptr(rdev
, ring
);
82 /* This works because ring_size is a power of 2 */
83 ring
->ring_free_dw
= rptr
+ (ring
->ring_size
/ 4);
84 ring
->ring_free_dw
-= ring
->wptr
;
85 ring
->ring_free_dw
&= ring
->ptr_mask
;
86 if (!ring
->ring_free_dw
) {
87 /* this is an empty ring */
88 ring
->ring_free_dw
= ring
->ring_size
/ 4;
89 /* update lockup info to avoid false positive */
90 radeon_ring_lockup_update(rdev
, ring
);
95 * radeon_ring_alloc - allocate space on the ring buffer
97 * @rdev: radeon_device pointer
98 * @ring: radeon_ring structure holding ring information
99 * @ndw: number of dwords to allocate in the ring buffer
101 * Allocate @ndw dwords in the ring buffer (all asics).
102 * Returns 0 on success, error on failure.
104 int radeon_ring_alloc(struct radeon_device
*rdev
, struct radeon_ring
*ring
, unsigned ndw
)
108 /* make sure we aren't trying to allocate more space than there is on the ring */
109 if (ndw
> (ring
->ring_size
/ 4))
111 /* Align requested size with padding so unlock_commit can
113 radeon_ring_free_size(rdev
, ring
);
114 ndw
= (ndw
+ ring
->align_mask
) & ~ring
->align_mask
;
115 while (ndw
> (ring
->ring_free_dw
- 1)) {
116 radeon_ring_free_size(rdev
, ring
);
117 if (ndw
< ring
->ring_free_dw
) {
120 r
= radeon_fence_wait_next(rdev
, ring
->idx
);
124 ring
->count_dw
= ndw
;
125 ring
->wptr_old
= ring
->wptr
;
130 * radeon_ring_lock - lock the ring and allocate space on it
132 * @rdev: radeon_device pointer
133 * @ring: radeon_ring structure holding ring information
134 * @ndw: number of dwords to allocate in the ring buffer
136 * Lock the ring and allocate @ndw dwords in the ring buffer
138 * Returns 0 on success, error on failure.
140 int radeon_ring_lock(struct radeon_device
*rdev
, struct radeon_ring
*ring
, unsigned ndw
)
144 mutex_lock(&rdev
->ring_lock
);
145 r
= radeon_ring_alloc(rdev
, ring
, ndw
);
147 mutex_unlock(&rdev
->ring_lock
);
154 * radeon_ring_commit - tell the GPU to execute the new
155 * commands on the ring buffer
157 * @rdev: radeon_device pointer
158 * @ring: radeon_ring structure holding ring information
159 * @hdp_flush: Whether or not to perform an HDP cache flush
161 * Update the wptr (write pointer) to tell the GPU to
162 * execute new commands on the ring buffer (all asics).
164 void radeon_ring_commit(struct radeon_device
*rdev
, struct radeon_ring
*ring
,
167 /* If we are emitting the HDP flush via the ring buffer, we need to
168 * do it before padding.
170 if (hdp_flush
&& rdev
->asic
->ring
[ring
->idx
]->hdp_flush
)
171 rdev
->asic
->ring
[ring
->idx
]->hdp_flush(rdev
, ring
);
172 /* We pad to match fetch size */
173 while (ring
->wptr
& ring
->align_mask
) {
174 radeon_ring_write(ring
, ring
->nop
);
177 /* If we are emitting the HDP flush via MMIO, we need to do it after
178 * all CPU writes to VRAM finished.
180 if (hdp_flush
&& rdev
->asic
->mmio_hdp_flush
)
181 rdev
->asic
->mmio_hdp_flush(rdev
);
182 radeon_ring_set_wptr(rdev
, ring
);
186 * radeon_ring_unlock_commit - tell the GPU to execute the new
187 * commands on the ring buffer and unlock it
189 * @rdev: radeon_device pointer
190 * @ring: radeon_ring structure holding ring information
191 * @hdp_flush: Whether or not to perform an HDP cache flush
193 * Call radeon_ring_commit() then unlock the ring (all asics).
195 void radeon_ring_unlock_commit(struct radeon_device
*rdev
, struct radeon_ring
*ring
,
198 radeon_ring_commit(rdev
, ring
, hdp_flush
);
199 mutex_unlock(&rdev
->ring_lock
);
203 * radeon_ring_undo - reset the wptr
205 * @ring: radeon_ring structure holding ring information
207 * Reset the driver's copy of the wptr (all asics).
209 void radeon_ring_undo(struct radeon_ring
*ring
)
211 ring
->wptr
= ring
->wptr_old
;
215 * radeon_ring_unlock_undo - reset the wptr and unlock the ring
217 * @ring: radeon_ring structure holding ring information
219 * Call radeon_ring_undo() then unlock the ring (all asics).
221 void radeon_ring_unlock_undo(struct radeon_device
*rdev
, struct radeon_ring
*ring
)
223 radeon_ring_undo(ring
);
224 mutex_unlock(&rdev
->ring_lock
);
228 * radeon_ring_lockup_update - update lockup variables
230 * @ring: radeon_ring structure holding ring information
232 * Update the last rptr value and timestamp (all asics).
234 void radeon_ring_lockup_update(struct radeon_device
*rdev
,
235 struct radeon_ring
*ring
)
237 atomic_set(&ring
->last_rptr
, radeon_ring_get_rptr(rdev
, ring
));
238 atomic64_set(&ring
->last_activity
, jiffies_64
);
242 * radeon_ring_test_lockup() - check if ring is lockedup by recording information
243 * @rdev: radeon device structure
244 * @ring: radeon_ring structure holding ring information
247 bool radeon_ring_test_lockup(struct radeon_device
*rdev
, struct radeon_ring
*ring
)
249 uint32_t rptr
= radeon_ring_get_rptr(rdev
, ring
);
250 uint64_t last
= atomic64_read(&ring
->last_activity
);
253 if (rptr
!= atomic_read(&ring
->last_rptr
)) {
254 /* ring is still working, no lockup */
255 radeon_ring_lockup_update(rdev
, ring
);
259 elapsed
= jiffies_to_msecs(jiffies_64
- last
);
260 if (radeon_lockup_timeout
&& elapsed
>= radeon_lockup_timeout
) {
261 dev_err(rdev
->dev
, "ring %d stalled for more than %llumsec\n",
265 /* give a chance to the GPU ... */
270 * radeon_ring_backup - Back up the content of a ring
272 * @rdev: radeon_device pointer
273 * @ring: the ring we want to back up
275 * Saves all unprocessed commits from a ring, returns the number of dwords saved.
277 unsigned radeon_ring_backup(struct radeon_device
*rdev
, struct radeon_ring
*ring
,
280 unsigned size
, ptr
, i
;
282 /* just in case lock the ring */
283 mutex_lock(&rdev
->ring_lock
);
286 if (ring
->ring_obj
== NULL
) {
287 mutex_unlock(&rdev
->ring_lock
);
291 /* it doesn't make sense to save anything if all fences are signaled */
292 if (!radeon_fence_count_emitted(rdev
, ring
->idx
)) {
293 mutex_unlock(&rdev
->ring_lock
);
297 /* calculate the number of dw on the ring */
298 if (ring
->rptr_save_reg
)
299 ptr
= RREG32(ring
->rptr_save_reg
);
300 else if (rdev
->wb
.enabled
)
301 ptr
= le32_to_cpu(*ring
->next_rptr_cpu_addr
);
303 /* no way to read back the next rptr */
304 mutex_unlock(&rdev
->ring_lock
);
308 size
= ring
->wptr
+ (ring
->ring_size
/ 4);
310 size
&= ring
->ptr_mask
;
312 mutex_unlock(&rdev
->ring_lock
);
316 /* and then save the content of the ring */
317 *data
= kvmalloc_array(size
, sizeof(uint32_t), GFP_KERNEL
);
319 mutex_unlock(&rdev
->ring_lock
);
322 for (i
= 0; i
< size
; ++i
) {
323 (*data
)[i
] = ring
->ring
[ptr
++];
324 ptr
&= ring
->ptr_mask
;
327 mutex_unlock(&rdev
->ring_lock
);
332 * radeon_ring_restore - append saved commands to the ring again
334 * @rdev: radeon_device pointer
335 * @ring: ring to append commands to
336 * @size: number of dwords we want to write
337 * @data: saved commands
339 * Allocates space on the ring and restore the previously saved commands.
341 int radeon_ring_restore(struct radeon_device
*rdev
, struct radeon_ring
*ring
,
342 unsigned size
, uint32_t *data
)
349 /* restore the saved ring content */
350 r
= radeon_ring_lock(rdev
, ring
, size
);
354 for (i
= 0; i
< size
; ++i
) {
355 radeon_ring_write(ring
, data
[i
]);
358 radeon_ring_unlock_commit(rdev
, ring
, false);
364 * radeon_ring_init - init driver ring struct.
366 * @rdev: radeon_device pointer
367 * @ring: radeon_ring structure holding ring information
368 * @ring_size: size of the ring
369 * @rptr_offs: offset of the rptr writeback location in the WB buffer
370 * @nop: nop packet for this ring
372 * Initialize the driver information for the selected ring (all asics).
373 * Returns 0 on success, error on failure.
375 int radeon_ring_init(struct radeon_device
*rdev
, struct radeon_ring
*ring
, unsigned ring_size
,
376 unsigned rptr_offs
, u32 nop
)
380 ring
->ring_size
= ring_size
;
381 ring
->rptr_offs
= rptr_offs
;
383 /* Allocate ring buffer */
384 if (ring
->ring_obj
== NULL
) {
385 r
= radeon_bo_create(rdev
, ring
->ring_size
, PAGE_SIZE
, true,
386 RADEON_GEM_DOMAIN_GTT
, 0, NULL
,
387 NULL
, &ring
->ring_obj
);
389 dev_err(rdev
->dev
, "(%d) ring create failed\n", r
);
392 r
= radeon_bo_reserve(ring
->ring_obj
, false);
393 if (unlikely(r
!= 0))
395 r
= radeon_bo_pin(ring
->ring_obj
, RADEON_GEM_DOMAIN_GTT
,
398 radeon_bo_unreserve(ring
->ring_obj
);
399 dev_err(rdev
->dev
, "(%d) ring pin failed\n", r
);
402 r
= radeon_bo_kmap(ring
->ring_obj
,
403 (void **)&ring
->ring
);
404 radeon_bo_unreserve(ring
->ring_obj
);
406 dev_err(rdev
->dev
, "(%d) ring map failed\n", r
);
410 ring
->ptr_mask
= (ring
->ring_size
/ 4) - 1;
411 ring
->ring_free_dw
= ring
->ring_size
/ 4;
412 if (rdev
->wb
.enabled
) {
413 u32 index
= RADEON_WB_RING0_NEXT_RPTR
+ (ring
->idx
* 4);
414 ring
->next_rptr_gpu_addr
= rdev
->wb
.gpu_addr
+ index
;
415 ring
->next_rptr_cpu_addr
= &rdev
->wb
.wb
[index
/4];
417 if (radeon_debugfs_ring_init(rdev
, ring
)) {
418 DRM_ERROR("Failed to register debugfs file for rings !\n");
420 radeon_ring_lockup_update(rdev
, ring
);
425 * radeon_ring_fini - tear down the driver ring struct.
427 * @rdev: radeon_device pointer
428 * @ring: radeon_ring structure holding ring information
430 * Tear down the driver information for the selected ring (all asics).
432 void radeon_ring_fini(struct radeon_device
*rdev
, struct radeon_ring
*ring
)
435 struct radeon_bo
*ring_obj
;
437 mutex_lock(&rdev
->ring_lock
);
438 ring_obj
= ring
->ring_obj
;
441 ring
->ring_obj
= NULL
;
442 mutex_unlock(&rdev
->ring_lock
);
445 r
= radeon_bo_reserve(ring_obj
, false);
446 if (likely(r
== 0)) {
447 radeon_bo_kunmap(ring_obj
);
448 radeon_bo_unpin(ring_obj
);
449 radeon_bo_unreserve(ring_obj
);
451 radeon_bo_unref(&ring_obj
);
458 #if defined(CONFIG_DEBUG_FS)
460 static int radeon_debugfs_ring_info(struct seq_file
*m
, void *data
)
462 struct drm_info_node
*node
= (struct drm_info_node
*) m
->private;
463 struct drm_device
*dev
= node
->minor
->dev
;
464 struct radeon_device
*rdev
= dev
->dev_private
;
465 int ridx
= *(int*)node
->info_ent
->data
;
466 struct radeon_ring
*ring
= &rdev
->ring
[ridx
];
468 uint32_t rptr
, wptr
, rptr_next
;
469 unsigned count
, i
, j
;
471 radeon_ring_free_size(rdev
, ring
);
472 count
= (ring
->ring_size
/ 4) - ring
->ring_free_dw
;
474 wptr
= radeon_ring_get_wptr(rdev
, ring
);
475 seq_printf(m
, "wptr: 0x%08x [%5d]\n",
478 rptr
= radeon_ring_get_rptr(rdev
, ring
);
479 seq_printf(m
, "rptr: 0x%08x [%5d]\n",
482 if (ring
->rptr_save_reg
) {
483 rptr_next
= RREG32(ring
->rptr_save_reg
);
484 seq_printf(m
, "rptr next(0x%04x): 0x%08x [%5d]\n",
485 ring
->rptr_save_reg
, rptr_next
, rptr_next
);
489 seq_printf(m
, "driver's copy of the wptr: 0x%08x [%5d]\n",
490 ring
->wptr
, ring
->wptr
);
491 seq_printf(m
, "last semaphore signal addr : 0x%016llx\n",
492 ring
->last_semaphore_signal_addr
);
493 seq_printf(m
, "last semaphore wait addr : 0x%016llx\n",
494 ring
->last_semaphore_wait_addr
);
495 seq_printf(m
, "%u free dwords in ring\n", ring
->ring_free_dw
);
496 seq_printf(m
, "%u dwords in ring\n", count
);
501 /* print 8 dw before current rptr as often it's the last executed
502 * packet that is the root issue
504 i
= (rptr
+ ring
->ptr_mask
+ 1 - 32) & ring
->ptr_mask
;
505 for (j
= 0; j
<= (count
+ 32); j
++) {
506 seq_printf(m
, "r[%5d]=0x%08x", i
, ring
->ring
[i
]);
512 i
= (i
+ 1) & ring
->ptr_mask
;
517 static int radeon_gfx_index
= RADEON_RING_TYPE_GFX_INDEX
;
518 static int cayman_cp1_index
= CAYMAN_RING_TYPE_CP1_INDEX
;
519 static int cayman_cp2_index
= CAYMAN_RING_TYPE_CP2_INDEX
;
520 static int radeon_dma1_index
= R600_RING_TYPE_DMA_INDEX
;
521 static int radeon_dma2_index
= CAYMAN_RING_TYPE_DMA1_INDEX
;
522 static int r600_uvd_index
= R600_RING_TYPE_UVD_INDEX
;
523 static int si_vce1_index
= TN_RING_TYPE_VCE1_INDEX
;
524 static int si_vce2_index
= TN_RING_TYPE_VCE2_INDEX
;
526 static struct drm_info_list radeon_debugfs_ring_info_list
[] = {
527 {"radeon_ring_gfx", radeon_debugfs_ring_info
, 0, &radeon_gfx_index
},
528 {"radeon_ring_cp1", radeon_debugfs_ring_info
, 0, &cayman_cp1_index
},
529 {"radeon_ring_cp2", radeon_debugfs_ring_info
, 0, &cayman_cp2_index
},
530 {"radeon_ring_dma1", radeon_debugfs_ring_info
, 0, &radeon_dma1_index
},
531 {"radeon_ring_dma2", radeon_debugfs_ring_info
, 0, &radeon_dma2_index
},
532 {"radeon_ring_uvd", radeon_debugfs_ring_info
, 0, &r600_uvd_index
},
533 {"radeon_ring_vce1", radeon_debugfs_ring_info
, 0, &si_vce1_index
},
534 {"radeon_ring_vce2", radeon_debugfs_ring_info
, 0, &si_vce2_index
},
539 static int radeon_debugfs_ring_init(struct radeon_device
*rdev
, struct radeon_ring
*ring
)
541 #if defined(CONFIG_DEBUG_FS)
543 for (i
= 0; i
< ARRAY_SIZE(radeon_debugfs_ring_info_list
); ++i
) {
544 struct drm_info_list
*info
= &radeon_debugfs_ring_info_list
[i
];
545 int ridx
= *(int*)radeon_debugfs_ring_info_list
[i
].data
;
548 if (&rdev
->ring
[ridx
] != ring
)
551 r
= radeon_debugfs_add_files(rdev
, info
, 1);