1 /* SPDX-License-Identifier: GPL-2.0 OR MIT */
2 /**************************************************************************
3  *
4  * Copyright 2015 VMware, Inc., Palo Alto, CA., USA
5  *
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:
13  *
14  * The above copyright notice and this permission notice (including the
15  * next paragraph) shall be included in all copies or substantial portions
16  * of the Software.
17  *
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.
25  *
26  **************************************************************************/
27 #ifndef _VMWGFX_BINDING_H_
28 #define _VMWGFX_BINDING_H_
29 
30 #include <linux/list.h>
31 
32 #include "device_include/svga3d_reg.h"
33 
34 #define VMW_MAX_VIEW_BINDINGS 128
35 
36 #define VMW_MAX_UAV_BIND_TYPE 2
37 
38 struct vmw_private;
39 struct vmw_ctx_binding_state;
40 
41 /*
42  * enum vmw_ctx_binding_type - abstract resource to context binding types
43  */
44 enum vmw_ctx_binding_type {
45 	vmw_ctx_binding_shader,
46 	vmw_ctx_binding_rt,
47 	vmw_ctx_binding_tex,
48 	vmw_ctx_binding_cb,
49 	vmw_ctx_binding_dx_shader,
50 	vmw_ctx_binding_dx_rt,
51 	vmw_ctx_binding_sr,
52 	vmw_ctx_binding_ds,
53 	vmw_ctx_binding_so_target,
54 	vmw_ctx_binding_vb,
55 	vmw_ctx_binding_ib,
56 	vmw_ctx_binding_uav,
57 	vmw_ctx_binding_cs_uav,
58 	vmw_ctx_binding_so,
59 	vmw_ctx_binding_max
60 };
61 
62 /**
63  * struct vmw_ctx_bindinfo - single binding metadata
64  *
65  * @ctx_list: List head for the context's list of bindings.
66  * @res_list: List head for a resource's list of bindings.
67  * @ctx: Non-refcounted pointer to the context that owns the binding. NULL
68  * indicates no binding present.
69  * @res: Non-refcounted pointer to the resource the binding points to. This
70  * is typically a surface or a view.
71  * @bt: Binding type.
72  * @scrubbed: Whether the binding has been scrubbed from the context.
73  */
74 struct vmw_ctx_bindinfo {
75 	struct list_head ctx_list;
76 	struct list_head res_list;
77 	struct vmw_resource *ctx;
78 	struct vmw_resource *res;
79 	enum vmw_ctx_binding_type bt;
80 	bool scrubbed;
81 };
82 
83 /**
84  * struct vmw_ctx_bindinfo_tex - texture stage binding metadata
85  *
86  * @bi: struct vmw_ctx_bindinfo we derive from.
87  * @texture_stage: Device data used to reconstruct binding command.
88  */
89 struct vmw_ctx_bindinfo_tex {
90 	struct vmw_ctx_bindinfo bi;
91 	uint32 texture_stage;
92 };
93 
94 /**
95  * struct vmw_ctx_bindinfo_shader - Shader binding metadata
96  *
97  * @bi: struct vmw_ctx_bindinfo we derive from.
98  * @shader_slot: Device data used to reconstruct binding command.
99  */
100 struct vmw_ctx_bindinfo_shader {
101 	struct vmw_ctx_bindinfo bi;
102 	SVGA3dShaderType shader_slot;
103 };
104 
105 /**
106  * struct vmw_ctx_bindinfo_cb - Constant buffer binding metadata
107  *
108  * @bi: struct vmw_ctx_bindinfo we derive from.
109  * @shader_slot: Device data used to reconstruct binding command.
110  * @offset: Device data used to reconstruct binding command.
111  * @size: Device data used to reconstruct binding command.
112  * @slot: Device data used to reconstruct binding command.
113  */
114 struct vmw_ctx_bindinfo_cb {
115 	struct vmw_ctx_bindinfo bi;
116 	SVGA3dShaderType shader_slot;
117 	uint32 offset;
118 	uint32 size;
119 	uint32 slot;
120 };
121 
122 /**
123  * struct vmw_ctx_bindinfo_view - View binding metadata
124  *
125  * @bi: struct vmw_ctx_bindinfo we derive from.
126  * @shader_slot: Device data used to reconstruct binding command.
127  * @slot: Device data used to reconstruct binding command.
128  */
129 struct vmw_ctx_bindinfo_view {
130 	struct vmw_ctx_bindinfo bi;
131 	SVGA3dShaderType shader_slot;
132 	uint32 slot;
133 };
134 
135 /**
136  * struct vmw_ctx_bindinfo_so_target - StreamOutput binding metadata
137  *
138  * @bi: struct vmw_ctx_bindinfo we derive from.
139  * @offset: Device data used to reconstruct binding command.
140  * @size: Device data used to reconstruct binding command.
141  * @slot: Device data used to reconstruct binding command.
142  */
143 struct vmw_ctx_bindinfo_so_target {
144 	struct vmw_ctx_bindinfo bi;
145 	uint32 offset;
146 	uint32 size;
147 	uint32 slot;
148 };
149 
150 /**
151  * struct vmw_ctx_bindinfo_vb - Vertex buffer binding metadata
152  *
153  * @bi: struct vmw_ctx_bindinfo we derive from.
154  * @offset: Device data used to reconstruct binding command.
155  * @stride: Device data used to reconstruct binding command.
156  * @slot: Device data used to reconstruct binding command.
157  */
158 struct vmw_ctx_bindinfo_vb {
159 	struct vmw_ctx_bindinfo bi;
160 	uint32 offset;
161 	uint32 stride;
162 	uint32 slot;
163 };
164 
165 /**
166  * struct vmw_ctx_bindinfo_ib - StreamOutput binding metadata
167  *
168  * @bi: struct vmw_ctx_bindinfo we derive from.
169  * @offset: Device data used to reconstruct binding command.
170  * @format: Device data used to reconstruct binding command.
171  */
172 struct vmw_ctx_bindinfo_ib {
173 	struct vmw_ctx_bindinfo bi;
174 	uint32 offset;
175 	uint32 format;
176 };
177 
178 /**
179  * struct vmw_dx_shader_bindings - per shader type context binding state
180  *
181  * @shader: The shader binding for this shader type
182  * @const_buffer: Const buffer bindings for this shader type.
183  * @shader_res: Shader resource view bindings for this shader type.
184  * @dirty_sr: Bitmap tracking individual shader resource bindings changes
185  * that have not yet been emitted to the device.
186  * @dirty: Bitmap tracking per-binding type binding changes that have not
187  * yet been emitted to the device.
188  */
189 struct vmw_dx_shader_bindings {
190 	struct vmw_ctx_bindinfo_shader shader;
191 	struct vmw_ctx_bindinfo_cb const_buffers[SVGA3D_DX_MAX_CONSTBUFFERS];
192 	struct vmw_ctx_bindinfo_view shader_res[SVGA3D_DX_MAX_SRVIEWS];
193 	DECLARE_BITMAP(dirty_sr, SVGA3D_DX_MAX_SRVIEWS);
194 	unsigned long dirty;
195 };
196 
197 /**
198  * struct vmw_ctx_bindinfo_uav - UAV context binding state.
199  * @views: UAV view bindings.
200  * @splice_index: The device splice index set by user-space.
201  */
202 struct vmw_ctx_bindinfo_uav {
203 	struct vmw_ctx_bindinfo_view views[SVGA3D_MAX_UAVIEWS];
204 	uint32 index;
205 };
206 
207 /**
208  * struct vmw_ctx_bindinfo_so - Stream output binding metadata.
209  * @bi: struct vmw_ctx_bindinfo we derive from.
210  * @slot: Device data used to reconstruct binding command.
211  */
212 struct vmw_ctx_bindinfo_so {
213 	struct vmw_ctx_bindinfo bi;
214 	uint32 slot;
215 };
216 
217 extern void vmw_binding_add(struct vmw_ctx_binding_state *cbs,
218 			    const struct vmw_ctx_bindinfo *ci,
219 			    u32 shader_slot, u32 slot);
220 extern void vmw_binding_add_uav_index(struct vmw_ctx_binding_state *cbs,
221 				      uint32 slot, uint32 splice_index);
222 extern void
223 vmw_binding_state_commit(struct vmw_ctx_binding_state *to,
224 			 struct vmw_ctx_binding_state *from);
225 extern void vmw_binding_res_list_kill(struct list_head *head);
226 extern void vmw_binding_res_list_scrub(struct list_head *head);
227 extern int vmw_binding_rebind_all(struct vmw_ctx_binding_state *cbs);
228 extern void vmw_binding_state_kill(struct vmw_ctx_binding_state *cbs);
229 extern void vmw_binding_state_scrub(struct vmw_ctx_binding_state *cbs);
230 extern struct vmw_ctx_binding_state *
231 vmw_binding_state_alloc(struct vmw_private *dev_priv);
232 extern void vmw_binding_state_free(struct vmw_ctx_binding_state *cbs);
233 extern struct list_head *
234 vmw_binding_state_list(struct vmw_ctx_binding_state *cbs);
235 extern void vmw_binding_state_reset(struct vmw_ctx_binding_state *cbs);
236 extern u32 vmw_binding_dirtying(enum vmw_ctx_binding_type binding_type);
237 
238 
239 #endif
240