1 /**************************************************************************
3 * Copyright © 2012 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_drv.h"
31 * If we set up the screen target otable, screen objects stop working.
34 #define VMW_OTABLE_SETUP_SUB ((VMWGFX_ENABLE_SCREEN_TARGET_OTABLE) ? 0 : 1)
37 #define VMW_PPN_SIZE 8
38 #define VMW_MOBFMT_PTDEPTH_0 SVGA3D_MOBFMT_PTDEPTH64_0
39 #define VMW_MOBFMT_PTDEPTH_1 SVGA3D_MOBFMT_PTDEPTH64_1
40 #define VMW_MOBFMT_PTDEPTH_2 SVGA3D_MOBFMT_PTDEPTH64_2
42 #define VMW_PPN_SIZE 4
43 #define VMW_MOBFMT_PTDEPTH_0 SVGA3D_MOBFMT_PTDEPTH_0
44 #define VMW_MOBFMT_PTDEPTH_1 SVGA3D_MOBFMT_PTDEPTH_1
45 #define VMW_MOBFMT_PTDEPTH_2 SVGA3D_MOBFMT_PTDEPTH_2
49 * struct vmw_mob - Structure containing page table and metadata for a
50 * Guest Memory OBject.
52 * @num_pages Number of pages that make up the page table.
53 * @pt_level The indirection level of the page table. 0-2.
54 * @pt_root_page DMA address of the level 0 page of the page table.
57 struct ttm_buffer_object
*pt_bo
;
58 unsigned long num_pages
;
60 dma_addr_t pt_root_page
;
65 * struct vmw_otable - Guest Memory OBject table metadata
67 * @size: Size of the table (page-aligned).
68 * @page_table: Pointer to a struct vmw_mob holding the page table.
72 struct vmw_mob
*page_table
;
75 static int vmw_mob_pt_populate(struct vmw_private
*dev_priv
,
77 static void vmw_mob_pt_setup(struct vmw_mob
*mob
,
78 struct vmw_piter data_iter
,
79 unsigned long num_data_pages
);
82 * vmw_setup_otable_base - Issue an object table base setup command to
85 * @dev_priv: Pointer to a device private structure
86 * @type: Type of object table base
87 * @offset Start of table offset into dev_priv::otable_bo
88 * @otable Pointer to otable metadata;
90 * This function returns -ENOMEM if it fails to reserve fifo space,
91 * and may block waiting for fifo space.
93 static int vmw_setup_otable_base(struct vmw_private
*dev_priv
,
96 struct vmw_otable
*otable
)
99 SVGA3dCmdHeader header
;
100 SVGA3dCmdSetOTableBase64 body
;
103 const struct vmw_sg_table
*vsgt
;
104 struct vmw_piter iter
;
107 BUG_ON(otable
->page_table
!= NULL
);
109 vsgt
= vmw_bo_sg_table(dev_priv
->otable_bo
);
110 vmw_piter_start(&iter
, vsgt
, offset
>> PAGE_SHIFT
);
111 WARN_ON(!vmw_piter_next(&iter
));
113 mob
= vmw_mob_create(otable
->size
>> PAGE_SHIFT
);
114 if (unlikely(mob
== NULL
)) {
115 DRM_ERROR("Failed creating OTable page table.\n");
119 if (otable
->size
<= PAGE_SIZE
) {
120 mob
->pt_level
= VMW_MOBFMT_PTDEPTH_0
;
121 mob
->pt_root_page
= vmw_piter_dma_addr(&iter
);
122 } else if (vsgt
->num_regions
== 1) {
123 mob
->pt_level
= SVGA3D_MOBFMT_RANGE
;
124 mob
->pt_root_page
= vmw_piter_dma_addr(&iter
);
126 ret
= vmw_mob_pt_populate(dev_priv
, mob
);
127 if (unlikely(ret
!= 0))
128 goto out_no_populate
;
130 vmw_mob_pt_setup(mob
, iter
, otable
->size
>> PAGE_SHIFT
);
131 mob
->pt_level
+= VMW_MOBFMT_PTDEPTH_1
- SVGA3D_MOBFMT_PTDEPTH_1
;
134 cmd
= vmw_fifo_reserve(dev_priv
, sizeof(*cmd
));
135 if (unlikely(cmd
== NULL
)) {
136 DRM_ERROR("Failed reserving FIFO space for OTable setup.\n");
141 memset(cmd
, 0, sizeof(*cmd
));
142 cmd
->header
.id
= SVGA_3D_CMD_SET_OTABLE_BASE64
;
143 cmd
->header
.size
= sizeof(cmd
->body
);
144 cmd
->body
.type
= type
;
145 cmd
->body
.baseAddress
= cpu_to_le64(mob
->pt_root_page
>> PAGE_SHIFT
);
146 cmd
->body
.sizeInBytes
= otable
->size
;
147 cmd
->body
.validSizeInBytes
= 0;
148 cmd
->body
.ptDepth
= mob
->pt_level
;
151 * The device doesn't support this, But the otable size is
152 * determined at compile-time, so this BUG shouldn't trigger
155 BUG_ON(mob
->pt_level
== VMW_MOBFMT_PTDEPTH_2
);
157 vmw_fifo_commit(dev_priv
, sizeof(*cmd
));
158 otable
->page_table
= mob
;
164 vmw_mob_destroy(mob
);
169 * vmw_takedown_otable_base - Issue an object table base takedown command
172 * @dev_priv: Pointer to a device private structure
173 * @type: Type of object table base
176 static void vmw_takedown_otable_base(struct vmw_private
*dev_priv
,
178 struct vmw_otable
*otable
)
181 SVGA3dCmdHeader header
;
182 SVGA3dCmdSetOTableBase body
;
184 struct ttm_buffer_object
*bo
;
186 if (otable
->page_table
== NULL
)
189 bo
= otable
->page_table
->pt_bo
;
190 cmd
= vmw_fifo_reserve(dev_priv
, sizeof(*cmd
));
191 if (unlikely(cmd
== NULL
))
192 DRM_ERROR("Failed reserving FIFO space for OTable setup.\n");
194 memset(cmd
, 0, sizeof(*cmd
));
195 cmd
->header
.id
= SVGA_3D_CMD_SET_OTABLE_BASE
;
196 cmd
->header
.size
= sizeof(cmd
->body
);
197 cmd
->body
.type
= type
;
198 cmd
->body
.baseAddress
= 0;
199 cmd
->body
.sizeInBytes
= 0;
200 cmd
->body
.validSizeInBytes
= 0;
201 cmd
->body
.ptDepth
= SVGA3D_MOBFMT_INVALID
;
202 vmw_fifo_commit(dev_priv
, sizeof(*cmd
));
207 ret
= ttm_bo_reserve(bo
, false, true, false, NULL
);
210 vmw_fence_single_bo(bo
, NULL
);
211 ttm_bo_unreserve(bo
);
214 vmw_mob_destroy(otable
->page_table
);
215 otable
->page_table
= NULL
;
219 * vmw_otables_setup - Set up guest backed memory object tables
221 * @dev_priv: Pointer to a device private structure
223 * Takes care of the device guest backed surface
224 * initialization, by setting up the guest backed memory object tables.
225 * Returns 0 on success and various error codes on failure. A succesful return
226 * means the object tables can be taken down using the vmw_otables_takedown
229 int vmw_otables_setup(struct vmw_private
*dev_priv
)
231 unsigned long offset
;
232 unsigned long bo_size
;
233 struct vmw_otable
*otables
;
237 otables
= kzalloc(SVGA_OTABLE_DX9_MAX
* sizeof(*otables
),
239 if (unlikely(otables
== NULL
)) {
240 DRM_ERROR("Failed to allocate space for otable "
245 otables
[SVGA_OTABLE_MOB
].size
=
246 VMWGFX_NUM_MOB
* SVGA3D_OTABLE_MOB_ENTRY_SIZE
;
247 otables
[SVGA_OTABLE_SURFACE
].size
=
248 VMWGFX_NUM_GB_SURFACE
* SVGA3D_OTABLE_SURFACE_ENTRY_SIZE
;
249 otables
[SVGA_OTABLE_CONTEXT
].size
=
250 VMWGFX_NUM_GB_CONTEXT
* SVGA3D_OTABLE_CONTEXT_ENTRY_SIZE
;
251 otables
[SVGA_OTABLE_SHADER
].size
=
252 VMWGFX_NUM_GB_SHADER
* SVGA3D_OTABLE_SHADER_ENTRY_SIZE
;
253 otables
[SVGA_OTABLE_SCREEN_TARGET
].size
=
254 VMWGFX_NUM_GB_SCREEN_TARGET
*
255 SVGA3D_OTABLE_SCREEN_TARGET_ENTRY_SIZE
;
258 for (i
= 0; i
< SVGA_OTABLE_DX9_MAX
; ++i
) {
260 (otables
[i
].size
+ PAGE_SIZE
- 1) & PAGE_MASK
;
261 bo_size
+= otables
[i
].size
;
264 ret
= ttm_bo_create(&dev_priv
->bdev
, bo_size
,
266 &vmw_sys_ne_placement
,
268 &dev_priv
->otable_bo
);
270 if (unlikely(ret
!= 0))
273 ret
= ttm_bo_reserve(dev_priv
->otable_bo
, false, true, false, NULL
);
275 ret
= vmw_bo_driver
.ttm_tt_populate(dev_priv
->otable_bo
->ttm
);
276 if (unlikely(ret
!= 0))
278 ret
= vmw_bo_map_dma(dev_priv
->otable_bo
);
279 if (unlikely(ret
!= 0))
282 ttm_bo_unreserve(dev_priv
->otable_bo
);
285 for (i
= 0; i
< SVGA_OTABLE_DX9_MAX
- VMW_OTABLE_SETUP_SUB
; ++i
) {
286 ret
= vmw_setup_otable_base(dev_priv
, i
, offset
,
288 if (unlikely(ret
!= 0))
290 offset
+= otables
[i
].size
;
293 dev_priv
->otables
= otables
;
297 ttm_bo_unreserve(dev_priv
->otable_bo
);
299 for (i
= 0; i
< SVGA_OTABLE_DX9_MAX
- VMW_OTABLE_SETUP_SUB
; ++i
)
300 vmw_takedown_otable_base(dev_priv
, i
, &otables
[i
]);
302 ttm_bo_unref(&dev_priv
->otable_bo
);
310 * vmw_otables_takedown - Take down guest backed memory object tables
312 * @dev_priv: Pointer to a device private structure
314 * Take down the Guest Memory Object tables.
316 void vmw_otables_takedown(struct vmw_private
*dev_priv
)
319 struct ttm_buffer_object
*bo
= dev_priv
->otable_bo
;
322 for (i
= 0; i
< SVGA_OTABLE_DX9_MAX
- VMW_OTABLE_SETUP_SUB
; ++i
)
323 vmw_takedown_otable_base(dev_priv
, i
,
324 &dev_priv
->otables
[i
]);
326 ret
= ttm_bo_reserve(bo
, false, true, false, NULL
);
329 vmw_fence_single_bo(bo
, NULL
);
330 ttm_bo_unreserve(bo
);
332 ttm_bo_unref(&dev_priv
->otable_bo
);
333 kfree(dev_priv
->otables
);
334 dev_priv
->otables
= NULL
;
339 * vmw_mob_calculate_pt_pages - Calculate the number of page table pages
340 * needed for a guest backed memory object.
342 * @data_pages: Number of data pages in the memory object buffer.
344 static unsigned long vmw_mob_calculate_pt_pages(unsigned long data_pages
)
346 unsigned long data_size
= data_pages
* PAGE_SIZE
;
347 unsigned long tot_size
= 0;
349 while (likely(data_size
> PAGE_SIZE
)) {
350 data_size
= DIV_ROUND_UP(data_size
, PAGE_SIZE
);
351 data_size
*= VMW_PPN_SIZE
;
352 tot_size
+= (data_size
+ PAGE_SIZE
- 1) & PAGE_MASK
;
355 return tot_size
>> PAGE_SHIFT
;
359 * vmw_mob_create - Create a mob, but don't populate it.
361 * @data_pages: Number of data pages of the underlying buffer object.
363 struct vmw_mob
*vmw_mob_create(unsigned long data_pages
)
365 struct vmw_mob
*mob
= kzalloc(sizeof(*mob
), GFP_KERNEL
);
367 if (unlikely(mob
== NULL
))
370 mob
->num_pages
= vmw_mob_calculate_pt_pages(data_pages
);
376 * vmw_mob_pt_populate - Populate the mob pagetable
378 * @mob: Pointer to the mob the pagetable of which we want to
381 * This function allocates memory to be used for the pagetable, and
382 * adjusts TTM memory accounting accordingly. Returns ENOMEM if
383 * memory resources aren't sufficient and may cause TTM buffer objects
384 * to be swapped out by using the TTM memory accounting function.
386 static int vmw_mob_pt_populate(struct vmw_private
*dev_priv
,
390 BUG_ON(mob
->pt_bo
!= NULL
);
392 ret
= ttm_bo_create(&dev_priv
->bdev
, mob
->num_pages
* PAGE_SIZE
,
394 &vmw_sys_ne_placement
,
395 0, false, NULL
, &mob
->pt_bo
);
396 if (unlikely(ret
!= 0))
399 ret
= ttm_bo_reserve(mob
->pt_bo
, false, true, false, NULL
);
402 ret
= vmw_bo_driver
.ttm_tt_populate(mob
->pt_bo
->ttm
);
403 if (unlikely(ret
!= 0))
405 ret
= vmw_bo_map_dma(mob
->pt_bo
);
406 if (unlikely(ret
!= 0))
409 ttm_bo_unreserve(mob
->pt_bo
);
414 ttm_bo_unreserve(mob
->pt_bo
);
415 ttm_bo_unref(&mob
->pt_bo
);
421 * vmw_mob_assign_ppn - Assign a value to a page table entry
423 * @addr: Pointer to pointer to page table entry.
424 * @val: The page table entry
426 * Assigns a value to a page table entry pointed to by *@addr and increments
427 * *@addr according to the page table entry size.
429 #if (VMW_PPN_SIZE == 8)
430 static void vmw_mob_assign_ppn(__le32
**addr
, dma_addr_t val
)
432 *((__le64
*) *addr
) = cpu_to_le64(val
>> PAGE_SHIFT
);
436 static void vmw_mob_assign_ppn(__le32
**addr
, dma_addr_t val
)
438 *(*addr
)++ = cpu_to_le32(val
>> PAGE_SHIFT
);
443 * vmw_mob_build_pt - Build a pagetable
445 * @data_addr: Array of DMA addresses to the underlying buffer
446 * object's data pages.
447 * @num_data_pages: Number of buffer object data pages.
448 * @pt_pages: Array of page pointers to the page table pages.
450 * Returns the number of page table pages actually used.
451 * Uses atomic kmaps of highmem pages to avoid TLB thrashing.
453 static unsigned long vmw_mob_build_pt(struct vmw_piter
*data_iter
,
454 unsigned long num_data_pages
,
455 struct vmw_piter
*pt_iter
)
457 unsigned long pt_size
= num_data_pages
* VMW_PPN_SIZE
;
458 unsigned long num_pt_pages
= DIV_ROUND_UP(pt_size
, PAGE_SIZE
);
459 unsigned long pt_page
;
460 __le32
*addr
, *save_addr
;
464 for (pt_page
= 0; pt_page
< num_pt_pages
; ++pt_page
) {
465 page
= vmw_piter_page(pt_iter
);
467 save_addr
= addr
= kmap_atomic(page
);
469 for (i
= 0; i
< PAGE_SIZE
/ VMW_PPN_SIZE
; ++i
) {
470 vmw_mob_assign_ppn(&addr
,
471 vmw_piter_dma_addr(data_iter
));
472 if (unlikely(--num_data_pages
== 0))
474 WARN_ON(!vmw_piter_next(data_iter
));
476 kunmap_atomic(save_addr
);
477 vmw_piter_next(pt_iter
);
484 * vmw_mob_build_pt - Set up a multilevel mob pagetable
486 * @mob: Pointer to a mob whose page table needs setting up.
487 * @data_addr Array of DMA addresses to the buffer object's data
489 * @num_data_pages: Number of buffer object data pages.
491 * Uses tail recursion to set up a multilevel mob page table.
493 static void vmw_mob_pt_setup(struct vmw_mob
*mob
,
494 struct vmw_piter data_iter
,
495 unsigned long num_data_pages
)
497 unsigned long num_pt_pages
= 0;
498 struct ttm_buffer_object
*bo
= mob
->pt_bo
;
499 struct vmw_piter save_pt_iter
;
500 struct vmw_piter pt_iter
;
501 const struct vmw_sg_table
*vsgt
;
504 ret
= ttm_bo_reserve(bo
, false, true, false, NULL
);
507 vsgt
= vmw_bo_sg_table(bo
);
508 vmw_piter_start(&pt_iter
, vsgt
, 0);
509 BUG_ON(!vmw_piter_next(&pt_iter
));
511 while (likely(num_data_pages
> 1)) {
513 BUG_ON(mob
->pt_level
> 2);
514 save_pt_iter
= pt_iter
;
515 num_pt_pages
= vmw_mob_build_pt(&data_iter
, num_data_pages
,
517 data_iter
= save_pt_iter
;
518 num_data_pages
= num_pt_pages
;
521 mob
->pt_root_page
= vmw_piter_dma_addr(&save_pt_iter
);
522 ttm_bo_unreserve(bo
);
526 * vmw_mob_destroy - Destroy a mob, unpopulating first if necessary.
528 * @mob: Pointer to a mob to destroy.
530 void vmw_mob_destroy(struct vmw_mob
*mob
)
533 ttm_bo_unref(&mob
->pt_bo
);
538 * vmw_mob_unbind - Hide a mob from the device.
540 * @dev_priv: Pointer to a device private.
541 * @mob_id: Device id of the mob to unbind.
543 void vmw_mob_unbind(struct vmw_private
*dev_priv
,
547 SVGA3dCmdHeader header
;
548 SVGA3dCmdDestroyGBMob body
;
551 struct ttm_buffer_object
*bo
= mob
->pt_bo
;
554 ret
= ttm_bo_reserve(bo
, false, true, false, NULL
);
556 * Noone else should be using this buffer.
561 cmd
= vmw_fifo_reserve(dev_priv
, sizeof(*cmd
));
562 if (unlikely(cmd
== NULL
)) {
563 DRM_ERROR("Failed reserving FIFO space for Memory "
564 "Object unbinding.\n");
566 cmd
->header
.id
= SVGA_3D_CMD_DESTROY_GB_MOB
;
567 cmd
->header
.size
= sizeof(cmd
->body
);
568 cmd
->body
.mobid
= mob
->id
;
569 vmw_fifo_commit(dev_priv
, sizeof(*cmd
));
571 vmw_fence_single_bo(bo
, NULL
);
572 ttm_bo_unreserve(bo
);
574 vmw_3d_resource_dec(dev_priv
, false);
578 * vmw_mob_bind - Make a mob visible to the device after first
579 * populating it if necessary.
581 * @dev_priv: Pointer to a device private.
582 * @mob: Pointer to the mob we're making visible.
583 * @data_addr: Array of DMA addresses to the data pages of the underlying
585 * @num_data_pages: Number of data pages of the underlying buffer
587 * @mob_id: Device id of the mob to bind
589 * This function is intended to be interfaced with the ttm_tt backend
592 int vmw_mob_bind(struct vmw_private
*dev_priv
,
594 const struct vmw_sg_table
*vsgt
,
595 unsigned long num_data_pages
,
599 bool pt_set_up
= false;
600 struct vmw_piter data_iter
;
602 SVGA3dCmdHeader header
;
603 SVGA3dCmdDefineGBMob64 body
;
607 vmw_piter_start(&data_iter
, vsgt
, 0);
608 if (unlikely(!vmw_piter_next(&data_iter
)))
611 if (likely(num_data_pages
== 1)) {
612 mob
->pt_level
= VMW_MOBFMT_PTDEPTH_0
;
613 mob
->pt_root_page
= vmw_piter_dma_addr(&data_iter
);
614 } else if (vsgt
->num_regions
== 1) {
615 mob
->pt_level
= SVGA3D_MOBFMT_RANGE
;
616 mob
->pt_root_page
= vmw_piter_dma_addr(&data_iter
);
617 } else if (unlikely(mob
->pt_bo
== NULL
)) {
618 ret
= vmw_mob_pt_populate(dev_priv
, mob
);
619 if (unlikely(ret
!= 0))
622 vmw_mob_pt_setup(mob
, data_iter
, num_data_pages
);
624 mob
->pt_level
+= VMW_MOBFMT_PTDEPTH_1
- SVGA3D_MOBFMT_PTDEPTH_1
;
627 (void) vmw_3d_resource_inc(dev_priv
, false);
629 cmd
= vmw_fifo_reserve(dev_priv
, sizeof(*cmd
));
630 if (unlikely(cmd
== NULL
)) {
631 DRM_ERROR("Failed reserving FIFO space for Memory "
632 "Object binding.\n");
633 goto out_no_cmd_space
;
636 cmd
->header
.id
= SVGA_3D_CMD_DEFINE_GB_MOB64
;
637 cmd
->header
.size
= sizeof(cmd
->body
);
638 cmd
->body
.mobid
= mob_id
;
639 cmd
->body
.ptDepth
= mob
->pt_level
;
640 cmd
->body
.base
= cpu_to_le64(mob
->pt_root_page
>> PAGE_SHIFT
);
641 cmd
->body
.sizeInBytes
= num_data_pages
* PAGE_SIZE
;
643 vmw_fifo_commit(dev_priv
, sizeof(*cmd
));
648 vmw_3d_resource_dec(dev_priv
, false);
650 ttm_bo_unref(&mob
->pt_bo
);