disable FB

hc

2024-01-04 1543e317f1da31b75942316931e8f491a8920811

 kernel/drivers/gpu/arm/bifrost/csf/mali_kbase_csf_tiler_heap.h
..
..
@@ -1,7 +1,7 @@
1
1
 /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
2
2
 /*
3
3
  *
4
- * (C) COPYRIGHT 2019-2021 ARM Limited. All rights reserved.
4
+ * (C) COPYRIGHT 2019-2022 ARM Limited. All rights reserved.
5
5
  *
6
6
  * This program is free software and is provided to you under the terms of the
7
7
  * GNU General Public License version 2 as published by the Free Software
..
..
@@ -23,7 +23,6 @@
23
23
 #define _KBASE_CSF_TILER_HEAP_H_
24
24
 
25
25
 #include <mali_kbase.h>
26
-
27
26
 /**
28
27
  * kbase_csf_tiler_heap_context_init - Initialize the tiler heaps context for a
29
28
  *                                     GPU address space
..
..
@@ -38,10 +37,10 @@
38
37
  * kbase_csf_tiler_heap_context_term - Terminate the tiler heaps context for a
39
38
  *                                     GPU address space
40
39
  *
40
+ * @kctx: Pointer to the kbase context being terminated.
41
+ *
41
42
  * This function deletes any chunked tiler heaps that weren't deleted before
42
43
  * context termination.
43
- *
44
- * @kctx: Pointer to the kbase context being terminated.
45
44
  */
46
45
 void kbase_csf_tiler_heap_context_term(struct kbase_context *kctx);
47
46
 
..
..
@@ -58,6 +57,12 @@
58
57
  * @target_in_flight: Number of render-passes that the driver should attempt to
59
58
  *                    keep in flight for which allocation of new chunks is
60
59
  *                    allowed. Must not be zero.
60
+ * @buf_desc_va: Buffer descriptor GPU virtual address. This is a hint for
61
+ *               indicating that the caller is intending to perform tiler heap
62
+ *               chunks reclaim for those that are hoarded with hardware while
63
+ *               the associated shader activites are suspended and the CSGs are
64
+ *               off slots. If the referred reclaiming is not desired, can
65
+ *               set it to 0.
61
66
  * @gpu_heap_va: Where to store the GPU virtual address of the context that was
62
67
  *               set up for the tiler heap.
63
68
  * @first_chunk_va: Where to store the GPU virtual address of the first chunk
..
..
@@ -66,22 +71,21 @@
66
71
  *
67
72
  * Return: 0 if successful or a negative error code on failure.
68
73
  */
69
-int kbase_csf_tiler_heap_init(struct kbase_context *kctx,
70
-	u32 chunk_size, u32 initial_chunks, u32 max_chunks,
71
-	u16 target_in_flight, u64 *gpu_heap_va,
72
-	u64 *first_chunk_va);
74
+int kbase_csf_tiler_heap_init(struct kbase_context *kctx, u32 chunk_size, u32 initial_chunks,
75
+			      u32 max_chunks, u16 target_in_flight, u64 const buf_desc_va,
76
+			      u64 *gpu_heap_va, u64 *first_chunk_va);
73
77
 
74
78
 /**
75
- * kbasep_cs_tiler_heap_term - Terminate a chunked tiler memory heap.
79
+ * kbase_csf_tiler_heap_term - Terminate a chunked tiler memory heap.
80
+ *
81
+ * @kctx: Pointer to the kbase context in which the tiler heap was initialized.
82
+ * @gpu_heap_va: The GPU virtual address of the context that was set up for the
83
+ *               tiler heap.
76
84
  *
77
85
  * This function will terminate a chunked tiler heap and cause all the chunks
78
86
  * (initial and those added during out-of-memory processing) to be freed.
79
87
  * It is the caller's responsibility to ensure no further operations on this
80
88
  * heap will happen before calling this function.
81
- *
82
- * @kctx: Pointer to the kbase context in which the tiler heap was initialized.
83
- * @gpu_heap_va: The GPU virtual address of the context that was set up for the
84
- *               tiler heap.
85
89
  *
86
90
  * Return: 0 if successful or a negative error code on failure.
87
91
  */
..
..
@@ -89,12 +93,6 @@
89
93
 
90
94
 /**
91
95
  * kbase_csf_tiler_heap_alloc_new_chunk - Allocate a new chunk for tiler heap.
92
- *
93
- * This function will allocate a new chunk for the chunked tiler heap depending
94
- * on the settings provided by userspace when the heap was created and the
95
- * heap's statistics (like number of render passes in-flight).
96
- * It would return an appropriate error code if a new chunk couldn't be
97
- * allocated.
98
96
  *
99
97
  * @kctx:               Pointer to the kbase context in which the tiler heap was initialized.
100
98
  * @gpu_heap_va:        GPU virtual address of the heap context.
..
..
@@ -105,6 +103,12 @@
105
103
  * @new_chunk_ptr:      Where to store the GPU virtual address & size of the new
106
104
  *                      chunk allocated for the heap.
107
105
  *
106
+ * This function will allocate a new chunk for the chunked tiler heap depending
107
+ * on the settings provided by userspace when the heap was created and the
108
+ * heap's statistics (like number of render passes in-flight).
109
+ * It would return an appropriate error code if a new chunk couldn't be
110
+ * allocated.
111
+ *
108
112
  * Return: 0 if a new chunk was allocated otherwise an appropriate negative
109
113
  *         error code (like -EBUSY when a free chunk is expected to be
110
114
  *         available upon completion of a render pass and -EINVAL when
..
..
@@ -112,4 +116,27 @@
112
116
  */
113
117
 int kbase_csf_tiler_heap_alloc_new_chunk(struct kbase_context *kctx,
114
118
 	u64 gpu_heap_va, u32 nr_in_flight, u32 pending_frag_count, u64 *new_chunk_ptr);
119
+
120
+/**
121
+ * kbase_csf_tiler_heap_scan_kctx_unused_pages - Performs the tiler heap shrinker calim's scan
122
+ *                                               functionality.
123
+ *
124
+ * @kctx:               Pointer to the kbase context for which the tiler heap recalim is to be
125
+ *                      operated with.
126
+ * @to_free:            Number of pages suggested for the reclaim scan (free) method to reach.
127
+ *
128
+ * Return: the actual number of pages the scan method has freed from the call.
129
+ */
130
+u32 kbase_csf_tiler_heap_scan_kctx_unused_pages(struct kbase_context *kctx, u32 to_free);
131
+
132
+/**
133
+ * kbase_csf_tiler_heap_count_kctx_unused_pages - Performs the tiler heap shrinker calim's count
134
+ *                                                functionality.
135
+ *
136
+ * @kctx:               Pointer to the kbase context for which the tiler heap recalim is to be
137
+ *                      operated with.
138
+ *
139
+ * Return: a number of pages that could likely be freed on the subsequent scan method call.
140
+ */
141
+u32 kbase_csf_tiler_heap_count_kctx_unused_pages(struct kbase_context *kctx);
115
142
 #endif