xref: /linux/drivers/gpu/drm/xe/xe_ggtt.h (revision 1fd1dc41724319406b0aff221a352a400b0ddfc5)
1 /* SPDX-License-Identifier: MIT */
2 /*
3  * Copyright © 2021 Intel Corporation
4  */
5 
6 #ifndef _XE_GGTT_H_
7 #define _XE_GGTT_H_
8 
9 #include "xe_ggtt_types.h"
10 
11 struct drm_printer;
12 struct xe_tile;
13 struct drm_exec;
14 
15 struct xe_ggtt *xe_ggtt_alloc(struct xe_tile *tile);
16 int xe_ggtt_init_early(struct xe_ggtt *ggtt);
17 int xe_ggtt_init_kunit(struct xe_ggtt *ggtt, u32 reserved, u32 size);
18 int xe_ggtt_init(struct xe_ggtt *ggtt);
19 
20 struct xe_ggtt_node *xe_ggtt_node_init(struct xe_ggtt *ggtt);
21 void xe_ggtt_node_fini(struct xe_ggtt_node *node);
22 int xe_ggtt_node_insert_balloon_locked(struct xe_ggtt_node *node,
23 				       u64 start, u64 size);
24 void xe_ggtt_node_remove_balloon_locked(struct xe_ggtt_node *node);
25 void xe_ggtt_shift_nodes_locked(struct xe_ggtt *ggtt, s64 shift);
26 u64 xe_ggtt_start(struct xe_ggtt *ggtt);
27 u64 xe_ggtt_size(struct xe_ggtt *ggtt);
28 
29 int xe_ggtt_node_insert(struct xe_ggtt_node *node, u32 size, u32 align);
30 struct xe_ggtt_node *
31 xe_ggtt_node_insert_transform(struct xe_ggtt *ggtt,
32 			      struct xe_bo *bo, u64 pte,
33 			      u64 size, u32 align,
34 			      xe_ggtt_transform_cb transform, void *arg);
35 void xe_ggtt_node_remove(struct xe_ggtt_node *node, bool invalidate);
36 bool xe_ggtt_node_allocated(const struct xe_ggtt_node *node);
37 size_t xe_ggtt_node_pt_size(const struct xe_ggtt_node *node);
38 void xe_ggtt_map_bo_unlocked(struct xe_ggtt *ggtt, struct xe_bo *bo);
39 int xe_ggtt_insert_bo(struct xe_ggtt *ggtt, struct xe_bo *bo, struct drm_exec *exec);
40 int xe_ggtt_insert_bo_at(struct xe_ggtt *ggtt, struct xe_bo *bo,
41 			 u64 start, u64 end, struct drm_exec *exec);
42 void xe_ggtt_remove_bo(struct xe_ggtt *ggtt, struct xe_bo *bo);
43 u64 xe_ggtt_largest_hole(struct xe_ggtt *ggtt, u64 alignment, u64 *spare);
44 
45 int xe_ggtt_dump(struct xe_ggtt *ggtt, struct drm_printer *p);
46 u64 xe_ggtt_print_holes(struct xe_ggtt *ggtt, u64 alignment, struct drm_printer *p);
47 
48 #ifdef CONFIG_PCI_IOV
49 void xe_ggtt_assign(const struct xe_ggtt_node *node, u16 vfid);
50 int xe_ggtt_node_save(struct xe_ggtt_node *node, void *dst, size_t size, u16 vfid);
51 int xe_ggtt_node_load(struct xe_ggtt_node *node, const void *src, size_t size, u16 vfid);
52 #endif
53 
54 #ifndef CONFIG_LOCKDEP
55 static inline void xe_ggtt_might_lock(struct xe_ggtt *ggtt)
56 { }
57 #else
58 void xe_ggtt_might_lock(struct xe_ggtt *ggtt);
59 #endif
60 
61 u64 xe_ggtt_encode_pte_flags(struct xe_ggtt *ggtt, struct xe_bo *bo, u16 pat_index);
62 u64 xe_ggtt_read_pte(struct xe_ggtt *ggtt, u64 offset);
63 
64 u64 xe_ggtt_node_addr(const struct xe_ggtt_node *node);
65 u64 xe_ggtt_node_size(const struct xe_ggtt_node *node);
66 
67 #endif
68