1 // SPDX-License-Identifier: GPL-2.0 OR MIT
2 /**************************************************************************
4 * Copyright 2009-2023 VMware, Inc., Palo Alto, CA., USA
6 * Permission is hereby granted, free of charge, to any person obtaining a
7 * copy of this software and associated documentation files (the
8 * "Software"), to deal in the Software without restriction, including
9 * without limitation the rights to use, copy, modify, merge, publish,
10 * distribute, sub license, and/or sell copies of the Software, and to
11 * permit persons to whom the Software is furnished to do so, subject to
12 * the following conditions:
14 * The above copyright notice and this permission notice (including the
15 * next paragraph) shall be included in all copies or substantial portions
18 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
19 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
20 * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL
21 * THE COPYRIGHT HOLDERS, AUTHORS AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM,
22 * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
23 * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
24 * USE OR OTHER DEALINGS IN THE SOFTWARE.
26 **************************************************************************/
28 #include "vmwgfx_bo.h"
29 #include "vmwgfx_drv.h"
30 #include <drm/ttm/ttm_placement.h>
32 static const struct ttm_place vram_placement_flags = {
35 .mem_type = TTM_PL_VRAM,
39 static const struct ttm_place sys_placement_flags = {
42 .mem_type = TTM_PL_SYSTEM,
46 struct ttm_placement vmw_vram_placement = {
48 .placement = &vram_placement_flags,
51 struct ttm_placement vmw_sys_placement = {
53 .placement = &sys_placement_flags,
56 const size_t vmw_tt_size = sizeof(struct vmw_ttm_tt);
59 * __vmw_piter_non_sg_next: Helper functions to advance
60 * a struct vmw_piter iterator.
62 * @viter: Pointer to the iterator.
64 * These functions return false if past the end of the list,
65 * true otherwise. Functions are selected depending on the current
68 static bool __vmw_piter_non_sg_next(struct vmw_piter *viter)
70 return ++(viter->i) < viter->num_pages;
73 static bool __vmw_piter_sg_next(struct vmw_piter *viter)
75 bool ret = __vmw_piter_non_sg_next(viter);
77 return __sg_page_iter_dma_next(&viter->iter) && ret;
81 static dma_addr_t __vmw_piter_dma_addr(struct vmw_piter *viter)
83 return viter->addrs[viter->i];
86 static dma_addr_t __vmw_piter_sg_addr(struct vmw_piter *viter)
88 return sg_page_iter_dma_address(&viter->iter);
93 * vmw_piter_start - Initialize a struct vmw_piter.
95 * @viter: Pointer to the iterator to initialize
96 * @vsgt: Pointer to a struct vmw_sg_table to initialize from
97 * @p_offset: Pointer offset used to update current array position
99 * Note that we're following the convention of __sg_page_iter_start, so that
100 * the iterator doesn't point to a valid page after initialization; it has
101 * to be advanced one step first.
103 void vmw_piter_start(struct vmw_piter *viter, const struct vmw_sg_table *vsgt,
104 unsigned long p_offset)
106 viter->i = p_offset - 1;
107 viter->num_pages = vsgt->num_pages;
108 viter->pages = vsgt->pages;
109 switch (vsgt->mode) {
110 case vmw_dma_alloc_coherent:
111 viter->next = &__vmw_piter_non_sg_next;
112 viter->dma_address = &__vmw_piter_dma_addr;
113 viter->addrs = vsgt->addrs;
115 case vmw_dma_map_populate:
116 case vmw_dma_map_bind:
117 viter->next = &__vmw_piter_sg_next;
118 viter->dma_address = &__vmw_piter_sg_addr;
119 __sg_page_iter_start(&viter->iter.base, vsgt->sgt->sgl,
120 vsgt->sgt->orig_nents, p_offset);
128 * vmw_ttm_unmap_from_dma - unmap device addresses previsouly mapped for
131 * @vmw_tt: Pointer to a struct vmw_ttm_backend
133 * Used to free dma mappings previously mapped by vmw_ttm_map_for_dma.
135 static void vmw_ttm_unmap_from_dma(struct vmw_ttm_tt *vmw_tt)
137 struct device *dev = vmw_tt->dev_priv->drm.dev;
139 dma_unmap_sgtable(dev, &vmw_tt->sgt, DMA_BIDIRECTIONAL, 0);
140 vmw_tt->sgt.nents = vmw_tt->sgt.orig_nents;
144 * vmw_ttm_map_for_dma - map TTM pages to get device addresses
146 * @vmw_tt: Pointer to a struct vmw_ttm_backend
148 * This function is used to get device addresses from the kernel DMA layer.
149 * However, it's violating the DMA API in that when this operation has been
150 * performed, it's illegal for the CPU to write to the pages without first
151 * unmapping the DMA mappings, or calling dma_sync_sg_for_cpu(). It is
152 * therefore only legal to call this function if we know that the function
153 * dma_sync_sg_for_cpu() is a NOP, and dma_sync_sg_for_device() is at most
154 * a CPU write buffer flush.
156 static int vmw_ttm_map_for_dma(struct vmw_ttm_tt *vmw_tt)
158 struct device *dev = vmw_tt->dev_priv->drm.dev;
160 return dma_map_sgtable(dev, &vmw_tt->sgt, DMA_BIDIRECTIONAL, 0);
164 * vmw_ttm_map_dma - Make sure TTM pages are visible to the device
166 * @vmw_tt: Pointer to a struct vmw_ttm_tt
168 * Select the correct function for and make sure the TTM pages are
169 * visible to the device. Allocate storage for the device mappings.
170 * If a mapping has already been performed, indicated by the storage
171 * pointer being non NULL, the function returns success.
173 static int vmw_ttm_map_dma(struct vmw_ttm_tt *vmw_tt)
175 struct vmw_private *dev_priv = vmw_tt->dev_priv;
176 struct vmw_sg_table *vsgt = &vmw_tt->vsgt;
182 vsgt->mode = dev_priv->map_mode;
183 vsgt->pages = vmw_tt->dma_ttm.pages;
184 vsgt->num_pages = vmw_tt->dma_ttm.num_pages;
185 vsgt->addrs = vmw_tt->dma_ttm.dma_address;
188 switch (dev_priv->map_mode) {
189 case vmw_dma_map_bind:
190 case vmw_dma_map_populate:
191 vsgt->sgt = &vmw_tt->sgt;
192 ret = sg_alloc_table_from_pages_segment(
193 &vmw_tt->sgt, vsgt->pages, vsgt->num_pages, 0,
194 (unsigned long)vsgt->num_pages << PAGE_SHIFT,
195 dma_get_max_seg_size(dev_priv->drm.dev), GFP_KERNEL);
197 goto out_sg_alloc_fail;
199 ret = vmw_ttm_map_for_dma(vmw_tt);
200 if (unlikely(ret != 0))
208 vmw_tt->mapped = true;
212 sg_free_table(vmw_tt->vsgt.sgt);
213 vmw_tt->vsgt.sgt = NULL;
219 * vmw_ttm_unmap_dma - Tear down any TTM page device mappings
221 * @vmw_tt: Pointer to a struct vmw_ttm_tt
223 * Tear down any previously set up device DMA mappings and free
224 * any storage space allocated for them. If there are no mappings set up,
225 * this function is a NOP.
227 static void vmw_ttm_unmap_dma(struct vmw_ttm_tt *vmw_tt)
229 struct vmw_private *dev_priv = vmw_tt->dev_priv;
231 if (!vmw_tt->vsgt.sgt)
234 switch (dev_priv->map_mode) {
235 case vmw_dma_map_bind:
236 case vmw_dma_map_populate:
237 vmw_ttm_unmap_from_dma(vmw_tt);
238 sg_free_table(vmw_tt->vsgt.sgt);
239 vmw_tt->vsgt.sgt = NULL;
244 vmw_tt->mapped = false;
248 * vmw_bo_sg_table - Return a struct vmw_sg_table object for a
251 * @bo: Pointer to a struct ttm_buffer_object
253 * Returns a pointer to a struct vmw_sg_table object. The object should
254 * not be freed after use.
255 * Note that for the device addresses to be valid, the buffer object must
256 * either be reserved or pinned.
258 const struct vmw_sg_table *vmw_bo_sg_table(struct ttm_buffer_object *bo)
260 struct vmw_ttm_tt *vmw_tt =
261 container_of(bo->ttm, struct vmw_ttm_tt, dma_ttm);
263 return &vmw_tt->vsgt;
267 static int vmw_ttm_bind(struct ttm_device *bdev,
268 struct ttm_tt *ttm, struct ttm_resource *bo_mem)
270 struct vmw_ttm_tt *vmw_be =
271 container_of(ttm, struct vmw_ttm_tt, dma_ttm);
280 ret = vmw_ttm_map_dma(vmw_be);
281 if (unlikely(ret != 0))
284 vmw_be->gmr_id = bo_mem->start;
285 vmw_be->mem_type = bo_mem->mem_type;
287 switch (bo_mem->mem_type) {
289 ret = vmw_gmr_bind(vmw_be->dev_priv, &vmw_be->vsgt,
290 ttm->num_pages, vmw_be->gmr_id);
293 if (unlikely(vmw_be->mob == NULL)) {
295 vmw_mob_create(ttm->num_pages);
296 if (unlikely(vmw_be->mob == NULL))
300 ret = vmw_mob_bind(vmw_be->dev_priv, vmw_be->mob,
301 &vmw_be->vsgt, ttm->num_pages,
305 /* Nothing to be done for a system bind */
310 vmw_be->bound = true;
314 static void vmw_ttm_unbind(struct ttm_device *bdev,
317 struct vmw_ttm_tt *vmw_be =
318 container_of(ttm, struct vmw_ttm_tt, dma_ttm);
323 switch (vmw_be->mem_type) {
325 vmw_gmr_unbind(vmw_be->dev_priv, vmw_be->gmr_id);
328 vmw_mob_unbind(vmw_be->dev_priv, vmw_be->mob);
336 if (vmw_be->dev_priv->map_mode == vmw_dma_map_bind)
337 vmw_ttm_unmap_dma(vmw_be);
338 vmw_be->bound = false;
342 static void vmw_ttm_destroy(struct ttm_device *bdev, struct ttm_tt *ttm)
344 struct vmw_ttm_tt *vmw_be =
345 container_of(ttm, struct vmw_ttm_tt, dma_ttm);
347 vmw_ttm_unmap_dma(vmw_be);
350 vmw_mob_destroy(vmw_be->mob);
356 static int vmw_ttm_populate(struct ttm_device *bdev,
357 struct ttm_tt *ttm, struct ttm_operation_ctx *ctx)
361 /* TODO: maybe completely drop this ? */
362 if (ttm_tt_is_populated(ttm))
365 ret = ttm_pool_alloc(&bdev->pool, ttm, ctx);
370 static void vmw_ttm_unpopulate(struct ttm_device *bdev,
373 struct vmw_ttm_tt *vmw_tt = container_of(ttm, struct vmw_ttm_tt,
376 vmw_ttm_unbind(bdev, ttm);
379 vmw_mob_destroy(vmw_tt->mob);
383 vmw_ttm_unmap_dma(vmw_tt);
385 ttm_pool_free(&bdev->pool, ttm);
388 static struct ttm_tt *vmw_ttm_tt_create(struct ttm_buffer_object *bo,
391 struct vmw_ttm_tt *vmw_be;
394 vmw_be = kzalloc(sizeof(*vmw_be), GFP_KERNEL);
398 vmw_be->dev_priv = vmw_priv_from_ttm(bo->bdev);
401 if (vmw_be->dev_priv->map_mode == vmw_dma_alloc_coherent)
402 ret = ttm_sg_tt_init(&vmw_be->dma_ttm, bo, page_flags,
405 ret = ttm_tt_init(&vmw_be->dma_ttm, bo, page_flags,
407 if (unlikely(ret != 0))
410 return &vmw_be->dma_ttm;
416 static void vmw_evict_flags(struct ttm_buffer_object *bo,
417 struct ttm_placement *placement)
419 *placement = vmw_sys_placement;
422 static int vmw_ttm_io_mem_reserve(struct ttm_device *bdev, struct ttm_resource *mem)
424 struct vmw_private *dev_priv = vmw_priv_from_ttm(bdev);
426 switch (mem->mem_type) {
433 mem->bus.offset = (mem->start << PAGE_SHIFT) +
434 dev_priv->vram_start;
435 mem->bus.is_iomem = true;
436 mem->bus.caching = ttm_cached;
445 * vmw_move_notify - TTM move_notify_callback
447 * @bo: The TTM buffer object about to move.
448 * @old_mem: The old memory where we move from
449 * @new_mem: The struct ttm_resource indicating to what memory
450 * region the move is taking place.
452 * Calls move_notify for all subsystems needing it.
453 * (currently only resources).
455 static void vmw_move_notify(struct ttm_buffer_object *bo,
456 struct ttm_resource *old_mem,
457 struct ttm_resource *new_mem)
459 vmw_bo_move_notify(bo, new_mem);
460 vmw_query_move_notify(bo, old_mem, new_mem);
465 * vmw_swap_notify - TTM move_notify_callback
467 * @bo: The TTM buffer object about to be swapped out.
469 static void vmw_swap_notify(struct ttm_buffer_object *bo)
471 vmw_bo_swap_notify(bo);
472 (void) ttm_bo_wait(bo, false, false);
475 static bool vmw_memtype_is_system(uint32_t mem_type)
477 return mem_type == TTM_PL_SYSTEM || mem_type == VMW_PL_SYSTEM;
480 static int vmw_move(struct ttm_buffer_object *bo,
482 struct ttm_operation_ctx *ctx,
483 struct ttm_resource *new_mem,
484 struct ttm_place *hop)
486 struct ttm_resource_manager *new_man;
487 struct ttm_resource_manager *old_man = NULL;
490 new_man = ttm_manager_type(bo->bdev, new_mem->mem_type);
492 old_man = ttm_manager_type(bo->bdev, bo->resource->mem_type);
494 if (new_man->use_tt && !vmw_memtype_is_system(new_mem->mem_type)) {
495 ret = vmw_ttm_bind(bo->bdev, bo->ttm, new_mem);
500 if (!bo->resource || (bo->resource->mem_type == TTM_PL_SYSTEM &&
502 ttm_bo_move_null(bo, new_mem);
506 vmw_move_notify(bo, bo->resource, new_mem);
508 if (old_man && old_man->use_tt && new_man->use_tt) {
509 if (vmw_memtype_is_system(bo->resource->mem_type)) {
510 ttm_bo_move_null(bo, new_mem);
513 ret = ttm_bo_wait_ctx(bo, ctx);
517 vmw_ttm_unbind(bo->bdev, bo->ttm);
518 ttm_resource_free(bo, &bo->resource);
519 ttm_bo_assign_mem(bo, new_mem);
522 ret = ttm_bo_move_memcpy(bo, ctx, new_mem);
528 vmw_move_notify(bo, new_mem, bo->resource);
532 struct ttm_device_funcs vmw_bo_driver = {
533 .ttm_tt_create = &vmw_ttm_tt_create,
534 .ttm_tt_populate = &vmw_ttm_populate,
535 .ttm_tt_unpopulate = &vmw_ttm_unpopulate,
536 .ttm_tt_destroy = &vmw_ttm_destroy,
537 .eviction_valuable = ttm_bo_eviction_valuable,
538 .evict_flags = vmw_evict_flags,
540 .swap_notify = vmw_swap_notify,
541 .io_mem_reserve = &vmw_ttm_io_mem_reserve,
544 int vmw_bo_create_and_populate(struct vmw_private *dev_priv,
545 size_t bo_size, u32 domain,
546 struct vmw_bo **bo_p)
548 struct ttm_operation_ctx ctx = {
549 .interruptible = false,
554 struct vmw_bo_params bo_params = {
556 .busy_domain = domain,
557 .bo_type = ttm_bo_type_kernel,
562 ret = vmw_bo_create(dev_priv, &bo_params, &vbo);
563 if (unlikely(ret != 0))
566 ret = ttm_bo_reserve(&vbo->tbo, false, true, NULL);
568 ret = vmw_ttm_populate(vbo->tbo.bdev, vbo->tbo.ttm, &ctx);
569 if (likely(ret == 0)) {
570 struct vmw_ttm_tt *vmw_tt =
571 container_of(vbo->tbo.ttm, struct vmw_ttm_tt, dma_ttm);
572 ret = vmw_ttm_map_dma(vmw_tt);
575 ttm_bo_unreserve(&vbo->tbo);
577 if (likely(ret == 0))