1 /*
2  * Copyright 2017 Advanced Micro Devices, Inc.
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 shall be included in
12  * all copies or substantial portions of the Software.
13  *
14  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
17  * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
18  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
19  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
20  * OTHER DEALINGS IN THE SOFTWARE.
21  *
22  */
23 
24 #ifndef __AMDGPU_GART_H__
25 #define __AMDGPU_GART_H__
26 
27 #include <linux/types.h>
28 
29 /*
30  * GART structures, functions & helpers
31  */
32 struct amdgpu_device;
33 struct amdgpu_bo;
34 struct amdgpu_gart_funcs;
35 
36 #define AMDGPU_GPU_PAGE_SIZE 4096
37 #define AMDGPU_GPU_PAGE_MASK (AMDGPU_GPU_PAGE_SIZE - 1)
38 #define AMDGPU_GPU_PAGE_SHIFT 12
39 #define AMDGPU_GPU_PAGE_ALIGN(a) (((a) + AMDGPU_GPU_PAGE_MASK) & ~AMDGPU_GPU_PAGE_MASK)
40 
41 struct amdgpu_gart {
42 	dma_addr_t			table_addr;
43 	struct amdgpu_bo		*robj;
44 	void				*ptr;
45 	unsigned			num_gpu_pages;
46 	unsigned			num_cpu_pages;
47 	unsigned			table_size;
48 #ifdef CONFIG_DRM_AMDGPU_GART_DEBUGFS
49 	struct page			**pages;
50 #endif
51 	bool				ready;
52 
53 	/* Asic default pte flags */
54 	uint64_t			gart_pte_flags;
55 
56 	const struct amdgpu_gart_funcs *gart_funcs;
57 };
58 
59 int amdgpu_gart_table_ram_alloc(struct amdgpu_device *adev);
60 void amdgpu_gart_table_ram_free(struct amdgpu_device *adev);
61 int amdgpu_gart_table_vram_alloc(struct amdgpu_device *adev);
62 void amdgpu_gart_table_vram_free(struct amdgpu_device *adev);
63 int amdgpu_gart_table_vram_pin(struct amdgpu_device *adev);
64 void amdgpu_gart_table_vram_unpin(struct amdgpu_device *adev);
65 int amdgpu_gart_init(struct amdgpu_device *adev);
66 void amdgpu_gart_fini(struct amdgpu_device *adev);
67 int amdgpu_gart_unbind(struct amdgpu_device *adev, uint64_t offset,
68 		       int pages);
69 int amdgpu_gart_map(struct amdgpu_device *adev, uint64_t offset,
70 		    int pages, dma_addr_t *dma_addr, uint64_t flags,
71 		    void *dst);
72 int amdgpu_gart_bind(struct amdgpu_device *adev, uint64_t offset,
73 		     int pages, struct page **pagelist,
74 		     dma_addr_t *dma_addr, uint64_t flags);
75 
76 #endif
77