• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*
2  * Copyright (C) 2019 Alyssa Rosenzweig
3  * Copyright (C) 2014-2017 Broadcom
4  *
5  * Permission is hereby granted, free of charge, to any person obtaining a
6  * copy of this software and associated documentation files (the "Software"),
7  * to deal in the Software without restriction, including without limitation
8  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
9  * and/or sell copies of the Software, and to permit persons to whom the
10  * Software is furnished to do so, subject to the following conditions:
11  *
12  * The above copyright notice and this permission notice (including the next
13  * paragraph) shall be included in all copies or substantial portions of the
14  * Software.
15  *
16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
19  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22  * SOFTWARE.
23  *
24  */
25 
26 #ifndef __PAN_JOB_H__
27 #define __PAN_JOB_H__
28 
29 #include "util/u_dynarray.h"
30 #include "pipe/p_state.h"
31 #include "pan_pool.h"
32 #include "pan_resource.h"
33 #include "pan_scoreboard.h"
34 
35 /* panfrost_batch_fence is the out fence of a batch that users or other batches
36  * might want to wait on. The batch fence lifetime is different from the batch
37  * one as want will certainly want to wait upon the fence after the batch has
38  * been submitted (which is when panfrost_batch objects are freed).
39  */
40 struct panfrost_batch_fence {
41         /* Refcounting object for the fence. */
42         struct pipe_reference reference;
43 
44         /* Batch that created this fence object. Will become NULL at batch
45          * submission time. This field is mainly here to know whether the
46          * batch has been flushed or not.
47          */
48         struct panfrost_batch *batch;
49 };
50 
51 #define PAN_REQ_MSAA            (1 << 0)
52 #define PAN_REQ_DEPTH_WRITE     (1 << 1)
53 
54 /* A panfrost_batch corresponds to a bound FBO we're rendering to,
55  * collecting over multiple draws. */
56 
57 struct panfrost_batch {
58         struct panfrost_context *ctx;
59         struct pipe_framebuffer_state key;
60 
61         /* Buffers cleared (PIPE_CLEAR_* bitmask) */
62         unsigned clear;
63 
64         /* Buffers drawn */
65         unsigned draws;
66 
67         /* Packed clear values, indexed by both render target as well as word.
68          * Essentially, a single pixel is packed, with some padding to bring it
69          * up to a 32-bit interval; that pixel is then duplicated over to fill
70          * all 16-bytes */
71 
72         uint32_t clear_color[PIPE_MAX_COLOR_BUFS][4];
73         float clear_depth;
74         unsigned clear_stencil;
75 
76         /* Amount of thread local storage required per thread */
77         unsigned stack_size;
78 
79         /* Amount of shared memory needed per workgroup (for compute) */
80         unsigned shared_size;
81 
82         /* Whether this job uses the corresponding requirement (PAN_REQ_*
83          * bitmask) */
84         unsigned requirements;
85 
86         /* The bounding box covered by this job, taking scissors into account.
87          * Basically, the bounding box we have to run fragment shaders for */
88 
89         unsigned minx, miny;
90         unsigned maxx, maxy;
91 
92         /* BOs referenced not in the pool */
93         struct hash_table *bos;
94 
95         /* Pool owned by this batch (released when the batch is released) used for temporary descriptors */
96         struct pan_pool pool;
97 
98         /* Pool also owned by this batch that is not CPU mapped (created as
99          * INVISIBLE) used for private GPU-internal structures, particularly
100          * varyings */
101         struct pan_pool invisible_pool;
102 
103         /* Job scoreboarding state */
104         struct pan_scoreboard scoreboard;
105 
106         /* Polygon list bound to the batch, or NULL if none bound yet */
107         struct panfrost_bo *polygon_list;
108 
109         /* Scratchpad BO bound to the batch, or NULL if none bound yet */
110         struct panfrost_bo *scratchpad;
111 
112         /* Shared memory BO bound to the batch, or NULL if none bound yet */
113         struct panfrost_bo *shared_memory;
114 
115         /* Tiler heap BO bound to the batch, or NULL if none bound yet */
116         struct panfrost_bo *tiler_heap;
117 
118         /* Dummy tiler BO bound to the batch, or NULL if none bound yet */
119         struct panfrost_bo *tiler_dummy;
120 
121         /* Framebuffer descriptor. */
122         struct panfrost_ptr framebuffer;
123 
124         /* Bifrost tiler meta descriptor. */
125         mali_ptr tiler_meta;
126 
127         /* Output sync object. Only valid when submitted is true. */
128         struct panfrost_batch_fence *out_sync;
129 
130         /* Batch dependencies */
131         struct util_dynarray dependencies;
132 };
133 
134 /* Functions for managing the above */
135 
136 void
137 panfrost_batch_fence_unreference(struct panfrost_batch_fence *fence);
138 
139 void
140 panfrost_batch_fence_reference(struct panfrost_batch_fence *batch);
141 
142 struct panfrost_batch *
143 panfrost_get_batch_for_fbo(struct panfrost_context *ctx);
144 
145 struct panfrost_batch *
146 panfrost_get_fresh_batch_for_fbo(struct panfrost_context *ctx);
147 
148 void
149 panfrost_batch_init(struct panfrost_context *ctx);
150 
151 void
152 panfrost_batch_add_bo(struct panfrost_batch *batch, struct panfrost_bo *bo,
153                       uint32_t flags);
154 
155 struct panfrost_bo *
156 panfrost_batch_create_bo(struct panfrost_batch *batch, size_t size,
157                          uint32_t create_flags, uint32_t access_flags);
158 
159 void
160 panfrost_flush_all_batches(struct panfrost_context *ctx);
161 
162 bool
163 panfrost_pending_batches_access_bo(struct panfrost_context *ctx,
164                                    const struct panfrost_bo *bo);
165 
166 void
167 panfrost_flush_batches_accessing_bo(struct panfrost_context *ctx,
168                                     struct panfrost_bo *bo, bool flush_readers);
169 
170 void
171 panfrost_batch_set_requirements(struct panfrost_batch *batch);
172 
173 void
174 panfrost_batch_adjust_stack_size(struct panfrost_batch *batch);
175 
176 struct panfrost_bo *
177 panfrost_batch_get_scratchpad(struct panfrost_batch *batch, unsigned size, unsigned thread_tls_alloc, unsigned core_count);
178 
179 struct panfrost_bo *
180 panfrost_batch_get_shared_memory(struct panfrost_batch *batch, unsigned size, unsigned workgroup_count);
181 
182 mali_ptr
183 panfrost_batch_get_polygon_list(struct panfrost_batch *batch, unsigned size);
184 
185 struct panfrost_bo *
186 panfrost_batch_get_tiler_dummy(struct panfrost_batch *batch);
187 
188 void
189 panfrost_batch_clear(struct panfrost_batch *batch,
190                      unsigned buffers,
191                      const union pipe_color_union *color,
192                      double depth, unsigned stencil);
193 
194 void
195 panfrost_batch_union_scissor(struct panfrost_batch *batch,
196                              unsigned minx, unsigned miny,
197                              unsigned maxx, unsigned maxy);
198 
199 void
200 panfrost_batch_intersection_scissor(struct panfrost_batch *batch,
201                                     unsigned minx, unsigned miny,
202                                     unsigned maxx, unsigned maxy);
203 
204 bool
205 panfrost_batch_is_scanout(struct panfrost_batch *batch);
206 
207 mali_ptr
208 panfrost_batch_get_bifrost_tiler(struct panfrost_batch *batch, unsigned vertex_count);
209 
210 mali_ptr
211 panfrost_batch_reserve_framebuffer(struct panfrost_batch *batch);
212 
213 #endif
214