Debian Codegraph @

src/freedreno/registers/adreno/adreno_pm4.xml

raw
1 <?xml version="1.0" encoding="UTF-8"?>
2 <database xmlns="http://nouveau.freedesktop.org/"
3 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
4 xsi:schemaLocation="https://gitlab.freedesktop.org/freedreno/ rules-fd.xsd">
5 <import file="freedreno_copyright.xml"/>
6 <import file="adreno/adreno_common.xml"/>
7
8 <enum name="vgt_event_type" varset="chip">
9 <value name="VS_DEALLOC" value="0x00" variants="A2XX-A5XX"/>
10 <value name="PS_DEALLOC" value="0x01" variants="A2XX-A5XX"/>
11 <value name="VS_DONE_TS" value="0x02" variants="A2XX-A5XX"/>
12 <value name="PS_DONE_TS" value="0x03" variants="A2XX-A5XX"/>
13 <doc>
14 Flushes dirty data from UCHE, and also writes a GPU timestamp to
15 the address if one is provided.
16 </doc>
17 <value name="CACHE_FLUSH_TS" value="0x04"/>
18 <value name="CONTEXT_DONE" value="0x05"/>
19 <value name="CACHE_FLUSH" value="0x06" variants="A2XX-A4XX"/>
20 <value name="VIZQUERY_START" value="0x07" variants="A2XX"/>
21 <value name="HLSQ_FLUSH" value="0x07" variants="A3XX-A4XX"/>
22 <value name="VIZQUERY_END" value="0x08" variants="A2XX"/>
23 <value name="SC_WAIT_WC" value="0x09" variants="A2XX"/>
24 <value name="WRITE_PRIMITIVE_COUNTS" value="0x09" variants="A6XX-"/>
25 <value name="START_PRIMITIVE_CTRS" value="0x0b" variants="A6XX-"/>
26 <value name="STOP_PRIMITIVE_CTRS" value="0x0c" variants="A6XX-"/>
27 <!-- Not sure that these 4 events don't have the same meaning as on A5XX+ -->
28 <value name="RST_PIX_CNT" value="0x0d" variants="A2XX-A4XX"/>
29 <value name="RST_VTX_CNT" value="0x0e" variants="A2XX-A4XX"/>
30 <value name="TILE_FLUSH" value="0x0f" variants="A2XX-A4XX"/>
31 <value name="STAT_EVENT" value="0x10" variants="A2XX-A4XX"/>
32 <value name="CACHE_FLUSH_AND_INV_TS_EVENT" value="0x14" variants="A2XX-A4XX"/>
33 <doc>
34 If A6XX_RB_SAMPLE_COUNTER_CNTL.copy is true, writes OQ Z passed
35 sample counts to RB_SAMPLE_COUNTER_BASE. This writes to main
36 memory, skipping UCHE.
37 </doc>
38 <value name="ZPASS_DONE" value="0x15"/>
39 <value name="CACHE_FLUSH_AND_INV_EVENT" value="0x16" variants="A2XX"/>
40
41 <doc>
42 Writes the GPU timestamp to the address that follows, once RB
43 access and flushes are complete.
44 </doc>
45 <value name="RB_DONE_TS" value="0x16" variants="A3XX-"/>
46
47 <value name="PERFCOUNTER_START" value="0x17" variants="A2XX-A4XX"/>
48 <value name="PERFCOUNTER_STOP" value="0x18" variants="A2XX-A4XX"/>
49 <value name="VS_FETCH_DONE" value="0x1b" variants="A2XX-A5XX"/>
50 <value name="FACENESS_FLUSH" value="0x1c" variants="A2XX-A4XX"/>
51
52 <!-- a5xx events -->
53 <value name="WT_DONE_TS" value="0x08" variants="A5XX-A6XX"/>
54 <value name="START_FRAGMENT_CTRS" value="0x0d" variants="A5XX-"/>
55 <value name="STOP_FRAGMENT_CTRS" value="0x0e" variants="A5XX-"/>
56 <value name="START_COMPUTE_CTRS" value="0x0f" variants="A5XX-"/>
57 <value name="STOP_COMPUTE_CTRS" value="0x10" variants="A5XX-"/>
58 <value name="FLUSH_SO_0" value="0x11" variants="A5XX-"/>
59 <value name="FLUSH_SO_1" value="0x12" variants="A5XX-"/>
60 <value name="FLUSH_SO_2" value="0x13" variants="A5XX-"/>
61 <value name="FLUSH_SO_3" value="0x14" variants="A5XX-"/>
62
63 <doc>
64 Invalidates depth attachment data from the CCU. We assume this
65 happens in the last stage.
66 </doc>
67 <value name="PC_CCU_INVALIDATE_DEPTH" value="0x18" variants="A5XX-A6XX"/>
68
69 <doc>
70 Invalidates color attachment data from the CCU. We assume this
71 happens in the last stage.
72 </doc>
73 <value name="PC_CCU_INVALIDATE_COLOR" value="0x19" variants="A5XX-A6XX"/>
74
75 <doc>
76 Flushes the small cache used by CP_EVENT_WRITE::BLIT (which,
77 along with its registers, would be better named RESOLVE).
78 </doc>
79 <value name="PC_CCU_RESOLVE_TS" value="0x1a" variants="A6XX"/>
80
81 <doc>
82 Flushes depth attachment data from the CCU. We assume this
83 happens in the last stage.
84 </doc>
85 <value name="PC_CCU_FLUSH_DEPTH_TS" value="0x1c" variants="A5XX-A6XX"/>
86
87 <doc>
88 Flushes color attachment data from the CCU. We assume this
89 happens in the last stage.
90 </doc>
91 <value name="PC_CCU_FLUSH_COLOR_TS" value="0x1d" variants="A5XX-A6XX"/>
92
93 <doc>
94 Triggers a resolve (GMEM to sysmem) or unresolve (sysmem to
95 GMEM) or clear blit, depending on CCU programming.
96 </doc>
97 <value name="CCU_RESOLVE" value="0x1e" variants="A5XX-"/>
98
99 <doc>
100 Flip between the primary and secondary LRZ buffers. This is used
101 for concurrent binning, so that BV can write to one buffer while
102 BR reads from the other.
103 </doc>
104 <value name="LRZ_FLIP_BUFFER" value="0x24" variants="A7XX-"/>
105
106 <doc>
107 Clears based on GRAS_LRZ_CNTL configuration, could clear
108 fast-clear buffer or LRZ direction.
109 LRZ direction is stored at lrz_fc_offset + 0x200, has 1 byte which
110 could be expressed by enum:
111 CUR_DIR_DISABLED = 0x0
112 CUR_DIR_GE = 0x1
113 CUR_DIR_LE = 0x2
114 CUR_DIR_UNSET = 0x3
115 Clear of direction means setting the direction to CUR_DIR_UNSET.
116 </doc>
117 <value name="LRZ_CLEAR" value="0x25" variants="A5XX-"/>
118
119 <value name="LRZ_FLUSH_INVALIDATE" value="0x26" variants="A5XX-A6XX"/>
120 <value name="LRZ_CACHE_FLUSH" value="0x26" variants="A7XX-"/>
121 <value name="BLIT_OP_FILL_2D" value="0x27" variants="A5XX-A6XX"/>
122 <value name="BLIT_OP_COPY_2D" value="0x28" variants="A5XX-A6XX"/>
123 <value name="LRZ_CACHE_INVALIDATE" value="0x28" variants="A7XX-"/>
124 <value name="LRZ_Q_CACHE_INVALIDATE" value="0x29" variants="A7XX-"/>
125 <value name="BLIT_OP_SCALE_2D" value="0x2a" variants="A5XX-"/>
126 <value name="CONTEXT_DONE_2D" value="0x2b" variants="A5XX-"/>
127 <value name="VSC_BINNING_START" value="0x2c" variants="A5XX-"/>
128 <value name="VSC_BINNING_END" value="0x2d" variants="A5XX-"/>
129
130 <!-- a6xx events -->
131 <doc>
132 Invalidates UCHE.
133 </doc>
134 <value name="CACHE_INVALIDATE" value="0x31" variants="A6XX"/>
135
136 <value name="DEBUG_LABEL" value="0x3f" variants="A6XX-"/>
137
138 <!-- note, some of these are the same as a6xx, just named differently -->
139
140 <doc> Doesn't seem to do anything </doc>
141 <value name="DUMMY_EVENT" value="0x01" variants="A7XX-"/>
142 <value name="CCU_INVALIDATE_DEPTH" value="0x18" variants="A7XX-"/>
143 <value name="CCU_INVALIDATE_COLOR" value="0x19" variants="A7XX-"/>
144 <value name="CCU_RESOLVE_CLEAN" value="0x1a" variants="A7XX-"/>
145 <value name="CCU_FLUSH_DEPTH" value="0x1c" variants="A7XX-"/>
146 <value name="CCU_FLUSH_COLOR" value="0x1d" variants="A7XX-"/>
147 <value name="CCU_END_RESOLVE_GROUP" value="0x1f" variants="A7XX-"/>
148 <value name="CCU_CLEAN_DEPTH" value="0x20" variants="A7XX-"/>
149 <value name="CCU_CLEAN_COLOR" value="0x21" variants="A7XX-"/>
150 <value name="CACHE_RESET" value="0x30" variants="A7XX-"/>
151 <value name="CACHE_CLEAN" value="0x31" variants="A7XX-"/>
152 <!-- TODO: deal with name conflicts with other gens -->
153 <value name="CACHE_FLUSH7" value="0x32" variants="A7XX-"/>
154 <value name="CACHE_INVALIDATE7" value="0x33" variants="A7XX-"/>
155 <value name="SUBPASS_FENCE" value="0x35" variants="A7XX-"/>
156 <value name="SUBPASS_SLICE_FENCE" value="0x36" variants="A8XX-"/>
157 <value name="DEPTH_BUFFER_FLIP" value="0x3d" variants="A8XX-"/>
158 <value name="CCH_FAST_CLEAR_CLEAN" value="0x1b" variants="A8XX-"/>
159 </enum>
160
161 <enum name="pc_di_primtype">
162 <value name="DI_PT_NONE" value="0"/>
163 <!-- POINTLIST_PSIZE is used on a3xx/a4xx when gl_PointSize is written: -->
164 <value name="DI_PT_POINTLIST_PSIZE" value="1"/>
165 <value name="DI_PT_LINELIST" value="2"/>
166 <value name="DI_PT_LINESTRIP" value="3"/>
167 <value name="DI_PT_TRILIST" value="4"/>
168 <value name="DI_PT_TRIFAN" value="5"/>
169 <value name="DI_PT_TRISTRIP" value="6"/>
170 <value name="DI_PT_LINELOOP" value="7"/> <!-- a22x, a3xx -->
171 <value name="DI_PT_RECTLIST" value="8"/>
172 <value name="DI_PT_POINTLIST" value="9"/>
173 <value name="DI_PT_LINE_ADJ" value="0xa"/>
174 <value name="DI_PT_LINESTRIP_ADJ" value="0xb"/>
175 <value name="DI_PT_TRI_ADJ" value="0xc"/>
176 <value name="DI_PT_TRISTRIP_ADJ" value="0xd"/>
177
178 <value name="DI_PT_PATCHES0" value="0x1f"/>
179 <value name="DI_PT_PATCHES1" value="0x20"/>
180 <value name="DI_PT_PATCHES2" value="0x21"/>
181 <value name="DI_PT_PATCHES3" value="0x22"/>
182 <value name="DI_PT_PATCHES4" value="0x23"/>
183 <value name="DI_PT_PATCHES5" value="0x24"/>
184 <value name="DI_PT_PATCHES6" value="0x25"/>
185 <value name="DI_PT_PATCHES7" value="0x26"/>
186 <value name="DI_PT_PATCHES8" value="0x27"/>
187 <value name="DI_PT_PATCHES9" value="0x28"/>
188 <value name="DI_PT_PATCHES10" value="0x29"/>
189 <value name="DI_PT_PATCHES11" value="0x2a"/>
190 <value name="DI_PT_PATCHES12" value="0x2b"/>
191 <value name="DI_PT_PATCHES13" value="0x2c"/>
192 <value name="DI_PT_PATCHES14" value="0x2d"/>
193 <value name="DI_PT_PATCHES15" value="0x2e"/>
194 <value name="DI_PT_PATCHES16" value="0x2f"/>
195 <value name="DI_PT_PATCHES17" value="0x30"/>
196 <value name="DI_PT_PATCHES18" value="0x31"/>
197 <value name="DI_PT_PATCHES19" value="0x32"/>
198 <value name="DI_PT_PATCHES20" value="0x33"/>
199 <value name="DI_PT_PATCHES21" value="0x34"/>
200 <value name="DI_PT_PATCHES22" value="0x35"/>
201 <value name="DI_PT_PATCHES23" value="0x36"/>
202 <value name="DI_PT_PATCHES24" value="0x37"/>
203 <value name="DI_PT_PATCHES25" value="0x38"/>
204 <value name="DI_PT_PATCHES26" value="0x39"/>
205 <value name="DI_PT_PATCHES27" value="0x3a"/>
206 <value name="DI_PT_PATCHES28" value="0x3b"/>
207 <value name="DI_PT_PATCHES29" value="0x3c"/>
208 <value name="DI_PT_PATCHES30" value="0x3d"/>
209 <value name="DI_PT_PATCHES31" value="0x3e"/>
210 </enum>
211
212 <enum name="pc_di_src_sel">
213 <value name="DI_SRC_SEL_DMA" value="0"/>
214 <value name="DI_SRC_SEL_IMMEDIATE" value="1"/>
215 <value name="DI_SRC_SEL_AUTO_INDEX" value="2"/>
216 <value name="DI_SRC_SEL_AUTO_XFB" value="3"/>
217 </enum>
218
219 <enum name="pc_di_face_cull_sel">
220 <value name="DI_FACE_CULL_NONE" value="0"/>
221 <value name="DI_FACE_CULL_FETCH" value="1"/>
222 <value name="DI_FACE_BACKFACE_CULL" value="2"/>
223 <value name="DI_FACE_FRONTFACE_CULL" value="3"/>
224 </enum>
225
226 <enum name="pc_di_index_size">
227 <value name="INDEX_SIZE_IGN" value="0"/>
228 <value name="INDEX_SIZE_16_BIT" value="0"/>
229 <value name="INDEX_SIZE_32_BIT" value="1"/>
230 <value name="INDEX_SIZE_8_BIT" value="2"/>
231 <value name="INDEX_SIZE_INVALID"/>
232 </enum>
233
234 <enum name="pc_di_vis_cull_mode">
235 <value name="IGNORE_VISIBILITY" value="0"/>
236 <value name="USE_VISIBILITY" value="1"/>
237 </enum>
238
239 <enum name="adreno_pm4_packet_type">
240 <value name="CP_TYPE0_PKT" value="0x00000000"/>
241 <value name="CP_TYPE1_PKT" value="0x40000000"/>
242 <value name="CP_TYPE2_PKT" value="0x80000000"/>
243 <value name="CP_TYPE3_PKT" value="0xc0000000"/>
244 <value name="CP_TYPE4_PKT" value="0x40000000"/>
245 <value name="CP_TYPE7_PKT" value="0x70000000"/>
246 </enum>
247
248 <!--
249 Note that in some cases, the same packet id is recycled on a later
250 generation, so variants attribute is used to distinguish. They
251 may not be completely accurate, we would probably have to analyze
252 the pfp and me/pm4 firmware to verify the packet is actually
253 handled on a particular generation. But it is at least enough to
254 disambiguate the packet-id's that were re-used for different
255 packets starting with a5xx.
256 -->
257 <enum name="adreno_pm4_type3_packets" varset="chip">
258 <doc>initialize CP's micro-engine</doc>
259 <value name="CP_ME_INIT" value="0x48"/>
260 <doc>skip N 32-bit words to get to the next packet</doc>
261 <value name="CP_NOP" value="0x10"/>
262 <doc>
263 indirect buffer dispatch. prefetch parser uses this packet
264 type to determine whether to pre-fetch the IB
265 </doc>
266 <value name="CP_PREEMPT_ENABLE" value="0x1c" variants="A5XX"/>
267 <value name="CP_PREEMPT_TOKEN" value="0x1e" variants="A5XX"/>
268 <value name="CP_INDIRECT_BUFFER" value="0x3f"/>
269 <doc>
270 Takes the same arguments as CP_INDIRECT_BUFFER, but jumps to
271 another buffer at the same level. Must be at the end of IB, and
272 doesn't work with draw state IB's.
273 </doc>
274 <value name="CP_INDIRECT_BUFFER_CHAIN" value="0x57" variants="A5XX-"/>
275 <doc>indirect buffer dispatch. same as IB, but init is pipelined</doc>
276 <value name="CP_INDIRECT_BUFFER_PFD" value="0x37"/>
277 <doc>
278 Waits for the IDLE state of the engine before further drawing.
279 This is pipelined, so the CP may continue.
280 </doc>
281 <value name="CP_WAIT_FOR_IDLE" value="0x26"/>
282 <doc>wait until a register or memory location is a specific value</doc>
283 <value name="CP_WAIT_REG_MEM" value="0x3c"/>
284 <doc>wait until a register location is equal to a specific value</doc>
285 <value name="CP_WAIT_REG_EQ" value="0x52"/>
286 <doc>wait until a register location is >= a specific value</doc>
287 <value name="CP_WAIT_REG_GTE" value="0x53" variants="A2XX-A4XX"/>
288 <doc>wait until a read completes</doc>
289 <value name="CP_WAIT_UNTIL_READ" value="0x5c" variants="A2XX-A4XX"/>
290 <doc>wait until all base/size writes from an IB_PFD packet have completed</doc>
291 <!--
292 NOTE: CP_WAIT_IB_PFD_COMPLETE unimplemented at least since a5xx fw, and
293 recycled for something new on a7xx
294 -->
295 <value name="CP_WAIT_IB_PFD_COMPLETE" value="0x5d" varset="chip" variants="A2XX-A4XX"/>
296 <doc>register read/modify/write</doc>
297 <value name="CP_REG_RMW" value="0x21"/>
298 <doc>Set binning configuration registers</doc>
299 <value name="CP_SET_BIN_DATA" value="0x2f" variants="A2XX-A4XX"/>
300 <value name="CP_SET_BIN_DATA5" value="0x2f" variants="A5XX-"/>
301 <doc>reads register in chip and writes to memory</doc>
302 <value name="CP_REG_TO_MEM" value="0x3e"/>
303 <doc>write N 32-bit words to memory</doc>
304 <value name="CP_MEM_WRITE" value="0x3d"/>
305 <doc>write CP_PROG_COUNTER value to memory</doc>
306 <value name="CP_MEM_WRITE_CNTR" value="0x4f"/>
307 <doc>conditional execution of a sequence of packets</doc>
308 <value name="CP_COND_EXEC" value="0x44"/>
309 <doc>conditional write to memory or register</doc>
310 <value name="CP_COND_WRITE" value="0x45" variants="A2XX-A4XX"/>
311 <value name="CP_COND_WRITE5" value="0x45" variants="A5XX-"/>
312 <doc>generate an event that creates a write to memory when completed</doc>
313 <value name="CP_EVENT_WRITE" value="0x46" variants="A2XX-A6XX"/>
314 <value name="CP_EVENT_WRITE7" value="0x46" variants="A7XX-"/>
315 <doc>generate a VS|PS_done event</doc>
316 <value name="CP_EVENT_WRITE_SHD" value="0x58" variants="A2XX"/>
317 <doc>generate a cache flush done event</doc>
318 <value name="CP_EVENT_WRITE_CFL" value="0x59" variants="A2XX"/>
319 <doc>generate a z_pass done event</doc>
320 <value name="CP_EVENT_WRITE_ZPD" value="0x5b" variants="A2XX"/>
321 <doc>
322 not sure the real name, but this seems to be what is used for
323 opencl, instead of CP_DRAW_INDX..
324 </doc>
325 <value name="CP_RUN_OPENCL" value="0x31"/>
326 <doc>initiate fetch of index buffer and draw</doc>
327 <value name="CP_DRAW_INDX" value="0x22"/>
328 <doc>draw using supplied indices in packet</doc>
329 <value name="CP_DRAW_INDX_2" value="0x36" variants="A2XX-A4XX"/> <!-- this is something different on a6xx and unused on a5xx -->
330 <doc>initiate fetch of index buffer and binIDs and draw</doc>
331 <value name="CP_DRAW_INDX_BIN" value="0x34" variants="A2XX-A4XX"/>
332 <doc>initiate fetch of bin IDs and draw using supplied indices</doc>
333 <value name="CP_DRAW_INDX_2_BIN" value="0x35" variants="A2XX-A4XX"/>
334 <doc>begin/end initiator for viz query extent processing</doc>
335 <value name="CP_VIZ_QUERY" value="0x23" variants="A2XX-A4XX"/>
336 <doc>fetch state sub-blocks and initiate shader code DMAs</doc>
337 <value name="CP_SET_STATE" value="0x25"/>
338 <doc>load constant into chip and to memory</doc>
339 <value name="CP_SET_CONSTANT" value="0x2d" variants="A2XX"/>
340 <doc>load sequencer instruction memory (pointer-based)</doc>
341 <value name="CP_IM_LOAD" value="0x27" variants="A2XX"/>
342 <doc>load sequencer instruction memory (code embedded in packet)</doc>
343 <value name="CP_IM_LOAD_IMMEDIATE" value="0x2b" variants="A2XX"/>
344 <doc>load constants from a location in memory</doc>
345 <value name="CP_LOAD_CONSTANT_CONTEXT" value="0x2e" variants="A2XX"/>
346 <doc>selective invalidation of state pointers</doc>
347 <value name="CP_INVALIDATE_STATE" value="0x3b"/>
348 <doc>dynamically changes shader instruction memory partition</doc>
349 <value name="CP_SET_SHADER_BASES" value="0x4a" variants="A2XX-A4XX"/>
350 <doc>sets the 64-bit BIN_MASK register in the PFP</doc>
351 <value name="CP_SET_BIN_MASK" value="0x50" variants="A2XX-A4XX"/>
352 <doc>sets the 64-bit BIN_SELECT register in the PFP</doc>
353 <value name="CP_SET_BIN_SELECT" value="0x51" variants="A2XX-A4XX"/>
354 <doc>updates the current context, if needed</doc>
355 <value name="CP_CONTEXT_UPDATE" value="0x5e"/>
356 <doc>generate interrupt from the command stream</doc>
357 <value name="CP_INTERRUPT" value="0x40"/>
358 <doc>copy sequencer instruction memory to system memory</doc>
359 <value name="CP_IM_STORE" value="0x2c" variants="A2XX"/>
360
361 <!-- For a20x -->
362 <!-- TODO handle variants..
363 <doc>
364 Program an offset that will added to the BIN_BASE value of
365 the 3D_DRAW_INDX_BIN packet
366 </doc>
367 <value name="CP_SET_BIN_BASE_OFFSET" value="0x4b"/>
368 -->
369
370 <!-- for a22x -->
371 <doc>
372 sets draw initiator flags register in PFP, gets bitwise-ORed into
373 every draw initiator
374 </doc>
375 <value name="CP_SET_DRAW_INIT_FLAGS" value="0x4b"/>
376 <doc>sets the register protection mode</doc>
377 <value name="CP_SET_PROTECTED_MODE" value="0x5f"/>
378
379 <value name="CP_BOOTSTRAP_UCODE" value="0x6f"/>
380
381 <!-- for a3xx -->
382 <doc>load high level sequencer command</doc>
383 <value name="CP_LOAD_STATE" value="0x30" variants="A3XX"/>
384 <value name="CP_LOAD_STATE4" value="0x30" variants="A4XX-A5XX"/>
385 <doc>Conditionally load a IB based on a flag, prefetch enabled</doc>
386 <value name="CP_COND_INDIRECT_BUFFER_PFE" value="0x3a" variants="A3XX-A5XX"/>
387 <doc>Conditionally load a IB based on a flag, prefetch disabled</doc>
388 <value name="CP_COND_INDIRECT_BUFFER_PFD" value="0x32" variants="A3XX"/>
389 <doc>Load a buffer with pre-fetch enabled</doc>
390 <value name="CP_INDIRECT_BUFFER_PFE" value="0x3f" variants="A5XX"/>
391 <doc>Set bin (?)</doc>
392 <value name="CP_SET_BIN" value="0x4c" variants="A2XX"/>
393
394 <doc>test 2 memory locations to dword values specified</doc>
395 <value name="CP_TEST_TWO_MEMS" value="0x71"/>
396
397 <doc>Write register, ignoring context state for context sensitive registers</doc>
398 <value name="CP_REG_WR_NO_CTXT" value="0x78"/>
399
400 <doc>Record the real-time when this packet is processed by PFP</doc>
401 <value name="CP_RECORD_PFP_TIMESTAMP" value="0x11"/>
402
403 <!-- Used to switch GPU between secure and non-secure modes -->
404 <value name="CP_SET_SECURE_MODE" value="0x66"/>
405
406 <doc>PFP waits until the FIFO between the PFP and the ME is empty</doc>
407 <value name="CP_WAIT_FOR_ME" value="0x13"/>
408
409 <!-- for a4xx -->
410 <doc>
411 Used a bit like CP_SET_CONSTANT on a2xx, but can write multiple
412 groups of registers. Looks like it can be used to create state
413 objects in GPU memory, and on state change only emit pointer
414 (via CP_SET_DRAW_STATE), which should be nice for reducing CPU
415 overhead:
416
417 (A4x) save PM4 stream pointers to execute upon a visible draw
418 </doc>
419 <value name="CP_SET_DRAW_STATE" value="0x43" variants="A4XX-"/>
420 <value name="CP_DRAW_INDX_OFFSET" value="0x38"/>
421 <value name="CP_DRAW_INDIRECT" value="0x28" variants="A4XX-"/>
422 <value name="CP_DRAW_INDX_INDIRECT" value="0x29" variants="A4XX-"/>
423 <value name="CP_DRAW_INDIRECT_MULTI" value="0x2a" variants="A6XX-"/>
424 <value name="CP_DRAW_AUTO" value="0x24"/>
425
426 <doc>
427 Enable or disable predication globally. Also resets the
428 predicate to "passing" and the local bit to enabled when
429 enabling global predication.
430 </doc>
431 <value name="CP_DRAW_PRED_ENABLE_GLOBAL" value="0x19"/>
432
433 <doc>
434 Enable or disable predication locally. Unlike globally enabling
435 predication, this packet doesn't touch any other state.
436 Predication only happens when enabled globally and locally and a
437 predicate has been set. This should be used for internal draws
438 which aren't supposed to use the predication state:
439
440 CP_DRAW_PRED_ENABLE_LOCAL(0)
441 ... do draw...
442 CP_DRAW_PRED_ENABLE_LOCAL(1)
443 </doc>
444 <value name="CP_DRAW_PRED_ENABLE_LOCAL" value="0x1a"/>
445
446 <doc>
447 Latch a draw predicate into the internal register.
448 </doc>
449 <value name="CP_DRAW_PRED_SET" value="0x4e"/>
450
451 <doc>
452 for A4xx
453 Write to register with address that does not fit into type-0 pkt
454 </doc>
455 <value name="CP_WIDE_REG_WRITE" value="0x74" variants="A4XX"/>
456
457 <doc>copy from ME scratch RAM to a register</doc>
458 <value name="CP_SCRATCH_TO_REG" value="0x4d"/>
459
460 <doc>Copy from REG to ME scratch RAM</doc>
461 <value name="CP_REG_TO_SCRATCH" value="0x4a"/>
462
463 <doc>Wait for memory writes to complete</doc>
464 <value name="CP_WAIT_MEM_WRITES" value="0x12"/>
465
466 <doc>Conditional execution based on register comparison</doc>
467 <value name="CP_COND_REG_EXEC" value="0x47"/>
468
469 <doc>Memory to REG copy</doc>
470 <value name="CP_MEM_TO_REG" value="0x42"/>
471
472 <value name="CP_EXEC_CS_INDIRECT" value="0x41" variants="A4XX-"/>
473 <value name="CP_EXEC_CS" value="0x33"/>
474
475 <doc>
476 for a5xx
477 </doc>
478 <value name="CP_PERFCOUNTER_ACTION" value="0x50" variants="A5XX"/>
479 <!-- switches SMMU pagetable, used on a5xx+ only -->
480 <value name="CP_SMMU_TABLE_UPDATE" value="0x53" variants="A5XX-"/>
481 <!-- for a6xx -->
482 <doc>Tells CP the current mode of GPU operation</doc>
483 <value name="CP_SET_MARKER" value="0x65" variants="A6XX-"/>
484 <doc>Instruct CP to set a few internal CP registers</doc>
485 <value name="CP_SET_PSEUDO_REG" value="0x56" variants="A6XX-"/>
486 <!--
487 pairs of regid and value.. seems to be used to program some TF
488 related regs:
489 -->
490 <value name="CP_CONTEXT_REG_BUNCH" value="0x5c" variants="A5XX-"/>
491 <!-- A5XX Enable yield in RB only -->
492 <value name="CP_YIELD_ENABLE" value="0x1c" variants="A5XX"/>
493 <doc>
494 Enables IB2 skipping. If both GLOBAL and LOCAL are 1 and
495 nothing is left in the visibility stream, then
496 CP_INDIRECT_BUFFER will be skipped, and draws will early return
497 from their IB.
498 </doc>
499 <value name="CP_SKIP_IB2_ENABLE_GLOBAL" value="0x1d" variants="A5XX-"/>
500 <value name="CP_SKIP_IB2_ENABLE_LOCAL" value="0x23" variants="A5XX-"/>
501 <value name="CP_SET_SUBDRAW_SIZE" value="0x35" variants="A5XX-"/>
502 <value name="CP_WHERE_AM_I" value="0x62" variants="A5XX-"/>
503 <value name="CP_SET_VISIBILITY_OVERRIDE" value="0x64" variants="A5XX-"/>
504 <!-- Enable/Disable/Defer A5x global preemption model -->
505 <value name="CP_PREEMPT_ENABLE_GLOBAL" value="0x69" variants="A5XX"/>
506 <!-- Enable/Disable A5x local preemption model -->
507 <value name="CP_PREEMPT_ENABLE_LOCAL" value="0x6a" variants="A5XX"/>
508 <!-- Yield token on a5xx similar to CP_PREEMPT on a4xx -->
509 <value name="CP_CONTEXT_SWITCH_YIELD" value="0x6b" variants="A5XX-"/>
510 <!-- Inform CP about current render mode (needed for a5xx preemption) -->
511 <value name="CP_SET_RENDER_MODE" value="0x6c" variants="A5XX"/>
512 <value name="CP_COMPUTE_CHECKPOINT" value="0x6e" variants="A5XX"/>
513 <!-- check if this works on earlier.. -->
514 <value name="CP_MEM_TO_MEM" value="0x73" variants="A5XX-"/>
515
516 <doc>
517 General purpose 2D blit engine for image transfers and mipmap
518 generation. Reads through UCHE, writes through the CCU cache in
519 the PS stage.
520 </doc>
521 <value name="CP_BLIT" value="0x2c" variants="A5XX-"/>
522
523 <!-- Test specified bit in specified register and set predicate -->
524 <value name="CP_REG_TEST" value="0x39" variants="A5XX-"/>
525
526 <!--
527 Seems to set the mode flags which control which CP_SET_DRAW_STATE
528 packets are executed, based on their ENABLE_MASK values
529
530 CP_SET_MODE w/ payload of 0x1 seems to cause CP_SET_DRAW_STATE
531 packets w/ ENABLE_MASK & 0x6 to execute immediately
532 -->
533 <value name="CP_SET_MODE" value="0x63" variants="A6XX-"/>
534
535 <!--
536 Seems like there are now separate blocks of state for VS vs FS/CS
537 (probably these amounts to geometry vs fragments so that geometry
538 stage of the pipeline for next draw can start while fragment stage
539 of current draw is still running. The format of the payload of the
540 packets is the same, the only difference is the offsets of the regs
541 the firmware code that handles the packet writes.
542
543 Note that for CL, starting with a6xx, the preferred # of local
544 threads is no longer the same as the max, implying that the shader
545 core can now run warps from unrelated shaders (ie.
546 CL_KERNEL_PREFERRED_WORK_GROUP_SIZE_MULTIPLE vs
547 CL_KERNEL_WORK_GROUP_SIZE)
548 -->
549 <value name="CP_LOAD_STATE6_GEOM" value="0x32" variants="A6XX-"/>
550 <value name="CP_LOAD_STATE6_FRAG" value="0x34" variants="A6XX-"/>
551 <!--
552 Note: For UAV state (Image/SSBOs) which have shared state across
553 shader stages, for 3d pipeline CP_LOAD_STATE6 is used. But for
554 compute shaders, CP_LOAD_STATE6_FRAG is used. Possibly they are
555 interchangable.
556 -->
557 <value name="CP_LOAD_STATE6" value="0x36" variants="A6XX-"/>
558
559 <!-- internal packets: -->
560 <value name="IN_IB_PREFETCH_END" value="0x17" variants="A2XX"/>
561 <value name="IN_SUBBLK_PREFETCH" value="0x1f" variants="A2XX"/>
562 <value name="IN_INSTR_PREFETCH" value="0x20" variants="A2XX"/>
563 <value name="IN_INSTR_MATCH" value="0x47" variants="A2XX"/>
564 <value name="IN_CONST_PREFETCH" value="0x49" variants="A2XX"/>
565 <value name="IN_INCR_UPDT_STATE" value="0x55" variants="A2XX"/>
566 <value name="IN_INCR_UPDT_CONST" value="0x56" variants="A2XX"/>
567 <value name="IN_INCR_UPDT_INSTR" value="0x57" variants="A2XX"/>
568
569 <!-- internal jumptable entries on a6xx+, possibly a5xx: -->
570
571 <!-- jmptable entry used to handle type4 packet on a5xx+: -->
572 <value name="PKT4" value="0x04" variants="A5XX-"/>
573 <!-- called when ROQ is empty, "returns" from an IB or merged sequence of IBs -->
574 <value name="IN_IB_END" value="0x0a" variants="A6XX-"/>
575 <!-- handles IFPC save/restore -->
576 <value name="IN_GMU_INTERRUPT" value="0x0b" variants="A6XX-"/>
577 <!-- preemption/context-swtich routine -->
578 <value name="IN_PREEMPT" value="0x0f" variants="A6XX-"/>
579
580 <!-- TODO do these exist on A5xx? -->
581 <value name="CP_SCRATCH_WRITE" value="0x4c" variants="A6XX-"/>
582 <value name="CP_REG_TO_MEM_OFFSET_MEM" value="0x74" variants="A6XX-"/>
583 <value name="CP_REG_TO_MEM_OFFSET_REG" value="0x72" variants="A6XX-"/>
584 <value name="CP_WAIT_MEM_GTE" value="0x14" variants="A6XX"/>
585 <value name="CP_WAIT_TWO_REGS" value="0x70" variants="A6XX"/>
586 <value name="CP_MEMCPY" value="0x75" variants="A6XX-"/>
587 <value name="CP_SET_BIN_DATA5_OFFSET" value="0x2e" variants="A6XX-"/>
588 <!-- A750+, set in place of CP_SET_BIN_DATA5_OFFSET but has different values -->
589 <value name="CP_SET_UNK_BIN_DATA" value="0x2d" variants="A7XX-"/>
590 <doc>
591 Write CP_CONTEXT_SWITCH_*_INFO from CP to the following dwords,
592 and forcibly switch to the indicated context.
593 </doc>
594 <value name="CP_CONTEXT_SWITCH" value="0x54" variants="A6XX"/>
595 <value name="CP_SET_AMBLE" value="0x55" variants="A6XX-"/>
596
597 <!--
598 Seems to always have the payload:
599 00000002 00008801 00004010
600 or:
601 00000002 00008801 00004090
602 or:
603 00000002 00008801 00000010
604 00000002 00008801 00010010
605 00000002 00008801 00d64010
606 ...
607 Note set for compute shaders..
608 Is 0x8801 a register offset?
609 This appears to be a special sort of register write packet
610 more or less, but the firmware has some special handling..
611 Seems like it intercepts/modifies certain register offsets,
612 but others are treated like a normal PKT4 reg write. I
613 guess there are some registers that the fw controls certain
614 bits.
615 -->
616 <value name="CP_REG_WRITE" value="0x6d" variants="A6XX"/>
617
618 <doc>
619 These first appear in a650_sqe.bin. They can in theory be used
620 to loop any sequence of IB1 commands, but in practice they are
621 used to loop over bins. There is a fixed-size per-iteration
622 prefix, used to set per-bin state, and then the following IB1
623 commands are executed until CP_END_BIN which are always the same
624 for each iteration and usually contain a list of
625 CP_INDIRECT_BUFFER calls to IB2 commands which setup state and
626 execute restore/draw/save commands. This replaces the previous
627 technique of just repeating the CP_INDIRECT_BUFFER calls and
628 "unrolling" the loop.
629 </doc>
630 <value name="CP_START_BIN" value="0x50" variants="A6XX-"/>
631 <value name="CP_END_BIN" value="0x51" variants="A6XX-"/>
632
633 <doc> Make next dword 1 to disable preemption, 0 to re-enable it. </doc>
634 <value name="CP_PREEMPT_DISABLE" value="0x6c" variants="A6XX"/>
635
636 <value name="CP_WAIT_TIMESTAMP" value="0x14" variants="A7XX-"/>
637 <value name="CP_GLOBAL_TIMESTAMP" value="0x15" variants="A7XX-"/> <!-- payload 1 dword -->
638 <value name="CP_LOCAL_TIMESTAMP" value="0x16" variants="A7XX-"/> <!-- payload 1 dword, follows 0x15 -->
639 <value name="CP_THREAD_CONTROL" value="0x17" variants="A7XX-"/>
640 <!-- payload 4 dwords, last two could be render target addr (one pkt per MRT), possibly used for GMEM save/restore?-->
641 <value name="CP_RESOURCE_LIST" value="0x18" variants="A7XX-"/>
642 <doc> Can clear BV/BR counters, or wait until one catches up to another </doc>
643 <value name="CP_BV_BR_COUNT_OPS" value="0x1b" variants="A7XX-"/>
644 <doc> Clears, adds to local, or adds to global timestamp </doc>
645 <value name="CP_MODIFY_TIMESTAMP" value="0x1c" variants="A7XX-"/>
646 <value name="CP_NON_CONTEXT_REG_BUNCH" value="0x5d" variants="A7XX-"/>
647 <doc>
648 Write to a scratch memory that is read by CP_REG_TEST with
649 SOURCE_SCRATCH_MEM set. It's not the same scratch as scratch registers.
650 However it uses the same memory space.
651 </doc>
652 <value name="CP_MEM_TO_SCRATCH_MEM" value="0x49" variants="A7XX-"/>
653
654 <doc>
655 Executes an array of fixed-size command buffers where each
656 buffer is assumed to have one draw call, skipping buffers with
657 non-visible draw calls.
658 </doc>
659 <value name="CP_FIXED_STRIDE_DRAW_TABLE" value="0x7f" variants="A7XX-"/>
660
661 <doc>Reset various on-chip state used for synchronization</doc>
662 <value name="CP_RESET_CONTEXT_STATE" value="0x1f" variants="A7XX-"/>
663
664 <doc>Invalidates the "CCHE" introduced on a740</doc>
665 <value name="CP_CCHE_INVALIDATE" value="0x3a" variants="A7XX-"/>
666
667 <value name="CP_SCOPE_CNTL" value="0x6c" variants="A7XX-"/>
668
669 <value name="CP_SKIP_IB_MODE" value="0x27" variants="A7XX-"/>
670
671 <value name="CP_MEMORY_MAP_UPDATE" value="0x58" variants="A8XX-"/>
672
673 <value name="CP_BARRIER" value="0x59" variants="A8XX-"/>
674 </enum>
675
676
677 <domain name="CP_LOAD_STATE" width="32">
678 <doc>Load state, a3xx (and later?)</doc>
679 <enum name="adreno_state_block">
680 <value name="SB_VERT_TEX" value="0"/>
681 <value name="SB_VERT_MIPADDR" value="1"/>
682 <value name="SB_FRAG_TEX" value="2"/>
683 <value name="SB_FRAG_MIPADDR" value="3"/>
684 <value name="SB_VERT_SHADER" value="4"/>
685 <value name="SB_GEOM_SHADER" value="5"/>
686 <value name="SB_FRAG_SHADER" value="6"/>
687 <value name="SB_COMPUTE_SHADER" value="7"/>
688 </enum>
689 <enum name="adreno_state_type">
690 <value name="ST_SHADER" value="0"/>
691 <value name="ST_CONSTANTS" value="1"/>
692 </enum>
693 <enum name="adreno_state_src">
694 <value name="SS_DIRECT" value="0">
695 <doc>inline with the CP_LOAD_STATE packet</doc>
696 </value>
697 <value name="SS_INVALID_ALL_IC" value="2"/>
698 <value name="SS_INVALID_PART_IC" value="3"/>
699 <value name="SS_INDIRECT" value="4">
700 <doc>in buffer pointed to by EXT_SRC_ADDR</doc>
701 </value>
702 <value name="SS_INDIRECT_TCM" value="5"/>
703 <value name="SS_INDIRECT_STM" value="6"/>
704 </enum>
705 <reg32 offset="0" name="0">
706 <bitfield name="DST_OFF" low="0" high="15" type="uint"/>
707 <bitfield name="STATE_SRC" low="16" high="18" type="adreno_state_src"/>
708 <bitfield name="STATE_BLOCK" low="19" high="21" type="adreno_state_block"/>
709 <bitfield name="NUM_UNIT" low="22" high="31" type="uint"/>
710 </reg32>
711 <reg32 offset="1" name="1">
712 <bitfield name="STATE_TYPE" low="0" high="1" type="adreno_state_type"/>
713 <bitfield name="EXT_SRC_ADDR" low="2" high="31" shr="2"/>
714 </reg32>
715 </domain>
716
717 <domain name="CP_LOAD_STATE4" width="32" varset="chip">
718 <doc>Load state, a4xx+</doc>
719 <enum name="a4xx_state_block">
720 <!--
721 unknown: 0x7 and 0xf <- seen in compute shader
722
723 STATE_BLOCK = 0x6, STATE_TYPE = 0x2 possibly used for preemption?
724 Seen in some GL shaders. Payload is NUM_UNIT dwords, and it contains
725 the gpuaddr of the following shader constants block. DST_OFF seems
726 to specify which shader stage:
727
728 16 -> vert
729 36 -> tcs
730 56 -> tes
731 76 -> geom
732 96 -> frag
733
734 Example:
735
736 opcode: CP_LOAD_STATE4 (30) (12 dwords)
737 { DST_OFF = 16 | STATE_SRC = SS4_DIRECT | STATE_BLOCK = 0x6 | NUM_UNIT = 4 }
738 { STATE_TYPE = 0x2 | EXT_SRC_ADDR = 0 }
739 { EXT_SRC_ADDR_HI = 0 }
740 0000: c0264100 00000000 00000000 00000000
741 0000: 70b0000b 01180010 00000002 00000000 c0264100 00000000 00000000 00000000
742
743 opcode: CP_LOAD_STATE4 (30) (4 dwords)
744 { DST_OFF = 16 | STATE_SRC = SS4_INDIRECT | STATE_BLOCK = SB4_VS_SHADER | NUM_UNIT = 4 }
745 { STATE_TYPE = ST4_CONSTANTS | EXT_SRC_ADDR = 0xc0264100 }
746 { EXT_SRC_ADDR_HI = 0 }
747 0.000000 0.000000 0.000000 0.000000 0.000000 0.000000 0.000000 0.000000
748 0.000000 0.000000 0.000000 0.000000 0.000000 0.000000 0.000000 0.000000
749 0000: 00000040 0000000c 00000000 00000000 00000000 00000000 00000000 00000000
750
751 STATE_BLOCK = 0x6, STATE_TYPE = 0x1, seen in compute shader. NUM_UNITS * 2 dwords.
752
753 -->
754 <value name="SB4_VS_TEX" value="0x0"/>
755 <value name="SB4_HS_TEX" value="0x1"/> <!-- aka. TCS -->
756 <value name="SB4_DS_TEX" value="0x2"/> <!-- aka. TES -->
757 <value name="SB4_GS_TEX" value="0x3"/>
758 <value name="SB4_FS_TEX" value="0x4"/>
759 <value name="SB4_CS_TEX" value="0x5"/>
760 <value name="SB4_VS_SHADER" value="0x8"/>
761 <value name="SB4_HS_SHADER" value="0x9"/>
762 <value name="SB4_DS_SHADER" value="0xa"/>
763 <value name="SB4_GS_SHADER" value="0xb"/>
764 <value name="SB4_FS_SHADER" value="0xc"/>
765 <value name="SB4_CS_SHADER" value="0xd"/>
766 <!--
767 for SSBO, STATE_TYPE=0 appears to be addresses (four dwords each),
768 STATE_TYPE=1 sizes, STATE_TYPE=2 addresses again (two dwords each)
769
770 Compute has it's own dedicated SSBO state, it seems, but the rest
771 of the stages share state
772 -->
773 <value name="SB4_SSBO" value="0xe"/>
774 <value name="SB4_CS_SSBO" value="0xf"/>
775 </enum>
776 <enum name="a4xx_state_type">
777 <value name="ST4_SHADER" value="0"/>
778 <value name="ST4_CONSTANTS" value="1"/>
779 <value name="ST4_UBO" value="2"/>
780 </enum>
781 <enum name="a4xx_state_src">
782 <value name="SS4_DIRECT" value="0"/>
783 <value name="SS4_INDIRECT" value="2"/>
784 </enum>
785 <reg32 offset="0" name="0">
786 <bitfield name="DST_OFF" low="0" high="13" type="uint"/>
787 <bitfield name="STATE_SRC" low="16" high="17" type="a4xx_state_src"/>
788 <bitfield name="STATE_BLOCK" low="18" high="21" type="a4xx_state_block"/>
789 <bitfield name="NUM_UNIT" low="22" high="31" type="uint"/>
790 </reg32>
791 <reg32 offset="1" name="1">
792 <bitfield name="STATE_TYPE" low="0" high="1" type="a4xx_state_type"/>
793 <bitfield name="EXT_SRC_ADDR" low="2" high="31" shr="2"/>
794 </reg32>
795 <reg32 offset="2" name="2" varset="chip" variants="A5XX-">
796 <bitfield name="EXT_SRC_ADDR_HI" low="0" high="31" shr="0"/>
797 </reg32>
798 </domain>
799
800 <!-- looks basically same CP_LOAD_STATE4 -->
801 <domain name="CP_LOAD_STATE6" width="32" varset="chip">
802 <doc>Load state, a6xx+</doc>
803 <enum name="a6xx_state_block">
804 <value name="SB6_VS_TEX" value="0x0"/>
805 <value name="SB6_HS_TEX" value="0x1"/> <!-- aka. TCS -->
806 <value name="SB6_DS_TEX" value="0x2"/> <!-- aka. TES -->
807 <value name="SB6_GS_TEX" value="0x3"/>
808 <value name="SB6_FS_TEX" value="0x4"/>
809 <value name="SB6_CS_TEX" value="0x5"/>
810 <value name="SB6_VS_SHADER" value="0x8"/>
811 <value name="SB6_HS_SHADER" value="0x9"/>
812 <value name="SB6_DS_SHADER" value="0xa"/>
813 <value name="SB6_GS_SHADER" value="0xb"/>
814 <value name="SB6_FS_SHADER" value="0xc"/>
815 <value name="SB6_CS_SHADER" value="0xd"/>
816 <value name="SB6_UAV" value="0xe"/>
817 <value name="SB6_CS_UAV" value="0xf"/>
818 </enum>
819 <enum name="a6xx_state_type">
820 <value name="ST6_SHADER" value="0"/>
821 <value name="ST6_CONSTANTS" value="1"/>
822 <value name="ST6_UBO" value="2"/>
823 <value name="ST6_UAV" value="3"/>
824 </enum>
825 <enum name="a6xx_state_src">
826 <value name="SS6_DIRECT" value="0"/>
827 <value name="SS6_BINDLESS" value="1"/> <!-- TODO does this exist on a4xx/a5xx? -->
828 <value name="SS6_INDIRECT" value="2"/>
829 <doc>
830 SS6_UBO used by the a6xx vulkan blob with tesselation constants
831 in this case, EXT_SRC_ADDR is (ubo_id shl 16 | offset)
832 to load constants from a UBO loaded with DST_OFF = 14 and offset 0,
833 EXT_SRC_ADDR = 0xe0000
834 (offset is a guess, should be in bytes given that maxUniformBufferRange=64k)
835 </doc>
836 <value name="SS6_UBO" value="3"/>
837 </enum>
838 <reg32 offset="0" name="0">
839 <bitfield name="DST_OFF" low="0" high="13" type="uint"/>
840 <bitfield name="STATE_TYPE" low="14" high="15" type="a6xx_state_type"/>
841 <bitfield name="STATE_SRC" low="16" high="17" type="a6xx_state_src"/>
842 <bitfield name="STATE_BLOCK" low="18" high="21" type="a6xx_state_block"/>
843 <bitfield name="NUM_UNIT" low="22" high="31" type="uint"/>
844 </reg32>
845 <reg32 offset="1" name="1">
846 <bitfield name="EXT_SRC_ADDR" low="2" high="31" shr="2"/>
847 </reg32>
848 <reg32 offset="2" name="2">
849 <bitfield name="EXT_SRC_ADDR_HI" low="0" high="31" shr="0"/>
850 </reg32>
851 <reg64 offset="1" name="EXT_SRC_ADDR" type="address"/>
852 </domain>
853
854 <bitset name="vgt_draw_initiator" inline="yes">
855 <bitfield name="PRIM_TYPE" low="0" high="5" type="pc_di_primtype"/>
856 <bitfield name="SOURCE_SELECT" low="6" high="7" type="pc_di_src_sel"/>
857 <bitfield name="VIS_CULL" low="9" high="10" type="pc_di_vis_cull_mode"/>
858 <bitfield name="INDEX_SIZE" pos="11" type="pc_di_index_size"/>
859 <bitfield name="NOT_EOP" pos="12" type="boolean"/>
860 <bitfield name="SMALL_INDEX" pos="13" type="boolean"/>
861 <bitfield name="PRE_DRAW_INITIATOR_ENABLE" pos="14" type="boolean"/>
862 <bitfield name="NUM_INSTANCES" low="24" high="31" type="uint"/>
863 </bitset>
864
865 <!-- changed on a4xx: -->
866 <enum name="a4xx_index_size">
867 <value name="INDEX4_SIZE_8_BIT" value="0"/>
868 <value name="INDEX4_SIZE_16_BIT" value="1"/>
869 <value name="INDEX4_SIZE_32_BIT" value="2"/>
870 </enum>
871
872 <enum name="a6xx_patch_type">
873 <value name="TESS_QUADS" value="0"/>
874 <value name="TESS_TRIANGLES" value="1"/>
875 <value name="TESS_ISOLINES" value="2"/>
876 </enum>
877
878 <bitset name="vgt_draw_initiator_a4xx" inline="yes">
879 <!-- When the 0x20 bit is set, it's the number of patch vertices - 1 -->
880 <bitfield name="PRIM_TYPE" low="0" high="5" type="pc_di_primtype"/>
881 <bitfield name="SOURCE_SELECT" low="6" high="7" type="pc_di_src_sel"/>
882 <bitfield name="VIS_CULL" low="8" high="9" type="pc_di_vis_cull_mode"/>
883 <bitfield name="INDEX_SIZE" low="10" high="11" type="a4xx_index_size"/>
884 <bitfield name="PATCH_TYPE" low="12" high="13" type="a6xx_patch_type"/>
885 <bitfield name="GS_ENABLE" pos="16" type="boolean"/>
886 <bitfield name="TESS_ENABLE" pos="17" type="boolean"/>
887 </bitset>
888
889 <domain name="CP_DRAW_INDX" width="32">
890 <reg32 offset="0" name="0">
891 <bitfield name="VIZ_QUERY" low="0" high="31"/>
892 </reg32>
893 <reg32 offset="1" name="1" type="vgt_draw_initiator"/>
894 <reg32 offset="2" name="2">
895 <bitfield name="NUM_INDICES" low="0" high="31" type="uint"/>
896 </reg32>
897 <reg32 offset="3" name="3">
898 <bitfield name="INDX_BASE" low="0" high="31"/>
899 </reg32>
900 <reg32 offset="4" name="4">
901 <bitfield name="INDX_SIZE" low="0" high="31"/>
902 </reg32>
903 </domain>
904
905 <domain name="CP_DRAW_INDX_2" width="32">
906 <reg32 offset="0" name="0">
907 <bitfield name="VIZ_QUERY" low="0" high="31"/>
908 </reg32>
909 <reg32 offset="1" name="1" type="vgt_draw_initiator"/>
910 <reg32 offset="2" name="2">
911 <bitfield name="NUM_INDICES" low="0" high="31" type="uint"/>
912 </reg32>
913 <!-- followed by NUM_INDICES indices.. -->
914 </domain>
915
916 <domain name="CP_DRAW_INDX_OFFSET" width="32">
917 <reg32 offset="0" name="0" type="vgt_draw_initiator_a4xx"/>
918 <reg32 offset="1" name="1">
919 <bitfield name="NUM_INSTANCES" low="0" high="31" type="uint"/>
920 </reg32>
921 <reg32 offset="2" name="2">
922 <bitfield name="NUM_INDICES" low="0" high="31" type="uint"/>
923 </reg32>
924 <reg32 offset="3" name="3">
925 <bitfield name="FIRST_INDX" low="0" high="31"/>
926 </reg32>
927
928 <stripe varset="chip" variants="A5XX-">
929 <reg64 offset="4" name="INDX_BASE" type="address"/>
930 <reg32 offset="6" name="6">
931 <!-- max # of elements in index buffer -->
932 <bitfield name="MAX_INDICES" low="0" high="31"/>
933 </reg32>
934 </stripe>
935
936 <reg32 offset="4" name="4">
937 <bitfield name="INDX_BASE" low="0" high="31" type="address"/>
938 </reg32>
939
940 <reg32 offset="5" name="5">
941 <bitfield name="INDX_SIZE" low="0" high="31" type="uint"/>
942 </reg32>
943 </domain>
944
945 <domain name="CP_DRAW_INDIRECT" width="32" varset="chip" prefix="chip" variants="A4XX-">
946 <reg32 offset="0" name="0" type="vgt_draw_initiator_a4xx"/>
947 <stripe varset="chip" variants="A4XX">
948 <reg32 offset="1" name="1">
949 <bitfield name="INDIRECT" low="0" high="31"/>
950 </reg32>
951 </stripe>
952 <stripe varset="chip" variants="A5XX-">
953 <reg32 offset="1" name="1">
954 <bitfield name="INDIRECT_LO" low="0" high="31"/>
955 </reg32>
956 <reg32 offset="2" name="2">
957 <bitfield name="INDIRECT_HI" low="0" high="31"/>
958 </reg32>
959 <reg64 offset="1" name="INDIRECT" type="address"/>
960 </stripe>
961 </domain>
962
963 <domain name="CP_DRAW_INDX_INDIRECT" width="32" varset="chip" prefix="chip" variants="A4XX-">
964 <reg32 offset="0" name="0" type="vgt_draw_initiator_a4xx"/>
965 <stripe varset="chip" variants="A4XX">
966 <reg32 offset="1" name="1">
967 <bitfield name="INDX_BASE" low="0" high="31"/>
968 </reg32>
969 <reg32 offset="2" name="2">
970 <!-- max # of bytes in index buffer -->
971 <bitfield name="INDX_SIZE" low="0" high="31" type="uint"/>
972 </reg32>
973 <reg32 offset="3" name="3">
974 <bitfield name="INDIRECT" low="0" high="31"/>
975 </reg32>
976 </stripe>
977 <stripe varset="chip" variants="A5XX-">
978 <reg32 offset="1" name="1">
979 <bitfield name="INDX_BASE_LO" low="0" high="31"/>
980 </reg32>
981 <reg32 offset="2" name="2">
982 <bitfield name="INDX_BASE_HI" low="0" high="31"/>
983 </reg32>
984 <reg64 offset="1" name="INDX_BASE" type="address"/>
985 <reg32 offset="3" name="3">
986 <!-- max # of elements in index buffer -->
987 <bitfield name="MAX_INDICES" low="0" high="31" type="uint"/>
988 </reg32>
989 <reg32 offset="4" name="4">
990 <bitfield name="INDIRECT_LO" low="0" high="31"/>
991 </reg32>
992 <reg32 offset="5" name="5">
993 <bitfield name="INDIRECT_HI" low="0" high="31"/>
994 </reg32>
995 <reg64 offset="4" name="INDIRECT" type="address"/>
996 </stripe>
997 </domain>
998
999 <domain name="CP_DRAW_INDIRECT_MULTI" width="32" varset="chip" prefix="chip" variants="A6XX-">
1000 <enum name="a6xx_draw_indirect_opcode">
1001 <value name="INDIRECT_OP_NORMAL" value="0x2"/>
1002 <value name="INDIRECT_OP_INDEXED" value="0x4"/>
1003 <value name="INDIRECT_OP_INDIRECT_COUNT" value="0x6"/>
1004 <value name="INDIRECT_OP_INDIRECT_COUNT_INDEXED" value="0x7"/>
1005 </enum>
1006 <reg32 offset="0" name="0" type="vgt_draw_initiator_a4xx"/>
1007 <reg32 offset="1" name="1">
1008 <bitfield name="OPCODE" low="0" high="3" type="a6xx_draw_indirect_opcode" addvariant="yes"/>
1009 <doc>
1010 DST_OFF same as in CP_LOAD_STATE6 - vec4 VS const at this offset will
1011 be updated for each draw to {draw_id, first_vertex, first_instance, 0}
1012 value of 0 disables it
1013 </doc>
1014 <bitfield name="DST_OFF" low="8" high="21" type="hex"/>
1015 </reg32>
1016 <reg32 offset="2" name="DRAW_COUNT" type="uint"/>
1017 <stripe varset="a6xx_draw_indirect_opcode" variants="INDIRECT_OP_NORMAL">
1018 <reg64 offset="3" name="INDIRECT" type="address"/>
1019 <reg32 offset="5" name="STRIDE" type="uint"/>
1020 </stripe>
1021 <stripe varset="a6xx_draw_indirect_opcode" variants="INDIRECT_OP_INDEXED" prefix="INDEXED">
1022 <reg64 offset="3" name="INDEX" type="address"/>
1023 <reg32 offset="5" name="MAX_INDICES" type="uint"/>
1024 <reg64 offset="6" name="INDIRECT" type="address"/>
1025 <reg32 offset="8" name="STRIDE" type="uint"/>
1026 </stripe>
1027 <stripe varset="a6xx_draw_indirect_opcode" variants="INDIRECT_OP_INDIRECT_COUNT" prefix="INDIRECT">
1028 <reg64 offset="3" name="INDIRECT" type="address"/>
1029 <reg64 offset="5" name="INDIRECT_COUNT" type="address"/>
1030 <reg32 offset="7" name="STRIDE" type="uint"/>
1031 </stripe>
1032 <stripe varset="a6xx_draw_indirect_opcode" variants="INDIRECT_OP_INDIRECT_COUNT_INDEXED" prefix="INDIRECT_INDEXED">
1033 <reg64 offset="3" name="INDEX" type="address"/>
1034 <reg32 offset="5" name="MAX_INDICES" type="uint"/>
1035 <reg64 offset="6" name="INDIRECT" type="address"/>
1036 <reg64 offset="8" name="INDIRECT_COUNT" type="address"/>
1037 <reg32 offset="10" name="STRIDE" type="uint"/>
1038 </stripe>
1039 </domain>
1040
1041 <domain name="CP_DRAW_AUTO" width="32">
1042 <reg32 offset="0" name="0" type="vgt_draw_initiator_a4xx"/>
1043 <reg32 offset="1" name="1">
1044 <bitfield name="NUM_INSTANCES" low="0" high="31" type="uint"/>
1045 </reg32>
1046 <reg64 offset="2" name="NUM_VERTICES_BASE" type="address"/>
1047 <reg32 offset="4" name="4">
1048 <bitfield name="NUM_VERTICES_OFFSET" low="0" high="31" type="uint"/>
1049 </reg32>
1050 <reg32 offset="5" name="5">
1051 <bitfield name="STRIDE" low="0" high="31" type="uint"/>
1052 </reg32>
1053 </domain>
1054
1055 <domain name="CP_DRAW_PRED_ENABLE_GLOBAL" width="32" varset="chip">
1056 <reg32 offset="0" name="0">
1057 <bitfield name="ENABLE" pos="0" type="boolean"/>
1058 </reg32>
1059 </domain>
1060
1061 <domain name="CP_DRAW_PRED_ENABLE_LOCAL" width="32" varset="chip">
1062 <reg32 offset="0" name="0">
1063 <bitfield name="ENABLE" pos="0" type="boolean"/>
1064 </reg32>
1065 </domain>
1066
1067 <domain name="CP_DRAW_PRED_SET" width="32" varset="chip">
1068 <enum name="cp_draw_pred_src">
1069 <!--
1070 Sources 1-4 seem to be about combining reading
1071 SO/primitive queries and setting the predicate, which is
1072 a DX11-specific optimization (since in DX11 you can only
1073 predicate on the result of queries).
1074 -->
1075 <value name="PRED_SRC_MEM" value="5">
1076 <doc>
1077 Read a 64-bit value at the given address and
1078 test if it equals/doesn't equal 0.
1079 </doc>
1080 </value>
1081 </enum>
1082 <enum name="cp_draw_pred_test">
1083 <value name="NE_0_PASS" value="0"/>
1084 <value name="EQ_0_PASS" value="1"/>
1085 </enum>
1086 <reg32 offset="0" name="0">
1087 <bitfield name="SRC" low="4" high="7" type="cp_draw_pred_src"/>
1088 <bitfield name="TEST" pos="8" type="cp_draw_pred_test"/>
1089 </reg32>
1090 <reg64 offset="1" name="MEM_ADDR" type="address"/>
1091 </domain>
1092
1093 <domain name="CP_SET_DRAW_STATE" width="32" varset="chip" variants="A4XX-">
1094 <array offset="0" stride="3" length="100">
1095 <reg32 offset="0" name="0">
1096 <bitfield name="COUNT" low="0" high="15" type="uint"/>
1097 <bitfield name="DIRTY" pos="16" type="boolean"/>
1098 <bitfield name="DISABLE" pos="17" type="boolean"/>
1099 <bitfield name="DISABLE_ALL_GROUPS" pos="18" type="boolean"/>
1100 <bitfield name="LOAD_IMMED" pos="19" type="boolean" variants="A5XX"/>
1101 <bitfield name="BINNING" pos="20" varset="chip" variants="A6XX-" type="boolean"/>
1102 <bitfield name="GMEM" pos="21" varset="chip" variants="A6XX-" type="boolean"/>
1103 <bitfield name="SYSMEM" pos="22" varset="chip" variants="A6XX-" type="boolean"/>
1104 <!-- high bit is 28 until a750: -->
1105 <bitfield name="GROUP_ID" low="24" high="29" type="uint"/>
1106 </reg32>
1107 <reg64 offset="1" name="ADDR" type="address"/>
1108 <reg32 offset="1" name="1">
1109 <bitfield name="ADDR_LO" low="0" high="31" type="hex"/>
1110 </reg32>
1111 <reg32 offset="2" name="2" varset="chip" variants="A5XX-">
1112 <bitfield name="ADDR_HI" low="0" high="31" type="hex"/>
1113 </reg32>
1114 </array>
1115 </domain>
1116
1117 <domain name="CP_SET_BIN" width="32">
1118 <doc>value at offset 0 always seems to be 0x00000000..</doc>
1119 <reg32 offset="0" name="0"/>
1120 <reg32 offset="1" name="1">
1121 <bitfield name="X1" low="0" high="15" type="uint"/>
1122 <bitfield name="Y1" low="16" high="31" type="uint"/>
1123 </reg32>
1124 <reg32 offset="2" name="2">
1125 <bitfield name="X2" low="0" high="15" type="uint"/>
1126 <bitfield name="Y2" low="16" high="31" type="uint"/>
1127 </reg32>
1128 </domain>
1129
1130 <domain name="CP_SET_BIN_DATA" width="32">
1131 <reg32 offset="0" name="0">
1132 <!-- corresponds to VSC_PIPE[n].DATA_ADDR -->
1133 <bitfield name="BIN_DATA_ADDR" low="0" high="31" type="hex"/>
1134 </reg32>
1135 <reg32 offset="1" name="1">
1136 <!-- seesm to correspond to VSC_SIZE_ADDRESS -->
1137 <bitfield name="BIN_SIZE_ADDRESS" low="0" high="31"/>
1138 </reg32>
1139 </domain>
1140
1141 <enum name="a7xx_abs_mask_mode">
1142 <value name="ABS_MASK" value="0x1"/>
1143 <value name="NO_ABS_MASK" value="0x0"/>
1144 </enum>
1145
1146 <domain name="CP_SET_BIN_DATA5" width="32">
1147 <reg32 offset="0" name="0">
1148 <bitfield name="VSC_MASK" low="0" high="15" type="hex">
1149 <doc>
1150 A mask of bins, starting at VSC_N, whose
1151 visibility is OR'd together. A value of 0 is
1152 interpreted as 1 (i.e. just use VSC_N for
1153 visbility) for backwards compatibility. Only
1154 exists on a7xx.
1155 </doc>
1156 </bitfield>
1157 <!-- equiv to PC_VSTREAM_CONTROL.SIZE on a3xx/a4xx: -->
1158 <bitfield name="VSC_SIZE" low="16" high="21" type="uint"/>
1159 <!-- equiv to PC_VSTREAM_CONTROL.N on a3xx/a4xx: -->
1160 <bitfield name="VSC_N" low="22" high="26" type="uint"/>
1161 <bitfield name="ABS_MASK" pos="28" type="a7xx_abs_mask_mode" addvariant="yes">
1162 <doc>
1163 If this field is 1, VSC_MASK and VSC_N are
1164 ignored and instead a new ordinal immediately
1165 after specifies the full 32-bit mask of bins
1166 to use. The mask is "absolute" instead of
1167 relative to VSC_N.
1168 </doc>
1169 </bitfield>
1170 </reg32>
1171 <stripe varset="a7xx_abs_mask_mode" variants="NO_ABS_MASK">
1172 <!-- BIN_DATA_ADDR -> VSC_PIPE[p].DATA_ADDRESS -->
1173 <reg64 offset="1" name="BIN_DATA_ADDR" type="address"/>
1174 <!-- BIN_SIZE_ADDRESS -> VSC_SIZE_ADDRESS + (p * 4)-->
1175 <reg64 offset="3" name="BIN_SIZE_ADDR" type="address"/>
1176 <!-- new on a6xx, where BIN_DATA_ADDR is the DRAW_STRM: -->
1177 <reg64 offset="5" name="BIN_PRIM_STRM" type="address"/>
1178 <!--
1179 a7xx adds a few more addresses to the end of the pkt
1180 -->
1181 <reg64 offset="7" name="7"/>
1182 <reg64 offset="9" name="9"/>
1183 </stripe>
1184 <stripe varset="a7xx_abs_mask_mode" variants="ABS_MASK">
1185 <reg32 offset="1" name="ABS_MASK"/>
1186 <!-- BIN_DATA_ADDR -> VSC_PIPE[p].DATA_ADDRESS -->
1187 <reg64 offset="2" name="BIN_DATA_ADDR" type="address"/>
1188 <!-- BIN_SIZE_ADDRESS -> VSC_SIZE_ADDRESS + (p * 4)-->
1189 <reg64 offset="4" name="BIN_SIZE_ADDR" type="address"/>
1190 <!-- new on a6xx, where BIN_DATA_ADDR is the DRAW_STRM: -->
1191 <reg64 offset="6" name="BIN_PRIM_STRM" type="address"/>
1192 <!--
1193 a7xx adds a few more addresses to the end of the pkt
1194 -->
1195 <reg64 offset="8" name="8"/>
1196 <reg64 offset="10" name="10"/>
1197 </stripe>
1198 </domain>
1199
1200 <domain name="CP_SET_BIN_DATA5_OFFSET" width="32">
1201 <doc>
1202 Like CP_SET_BIN_DATA5, but set the pointers as offsets from the
1203 pointers stored in VSC_PIPE_{DATA,DATA2,SIZE}_ADDRESS. Useful
1204 for Vulkan where these values aren't known when the command
1205 stream is recorded.
1206 </doc>
1207 <reg32 offset="0" name="0">
1208 <bitfield name="VSC_MASK" low="0" high="15" type="hex"/>
1209 <!-- equiv to PC_VSTREAM_CONTROL.SIZE on a3xx/a4xx: -->
1210 <bitfield name="VSC_SIZE" low="16" high="21" type="uint"/>
1211 <!-- equiv to PC_VSTREAM_CONTROL.N on a3xx/a4xx: -->
1212 <bitfield name="VSC_N" low="22" high="26" type="uint"/>
1213 <bitfield name="ABS_MASK" pos="28" type="a7xx_abs_mask_mode" addvariant="yes"/>
1214 </reg32>
1215 <stripe varset="a7xx_abs_mask_mode" variants="NO_ABS_MASK">
1216 <!-- BIN_DATA_ADDR -> VSC_PIPE[p].DATA_ADDRESS -->
1217 <reg32 offset="1" name="1">
1218 <bitfield name="BIN_DATA_OFFSET" low="0" high="31" type="uint"/>
1219 </reg32>
1220 <!-- BIN_SIZE_ADDRESS -> VSC_SIZE_ADDRESS + (p * 4)-->
1221 <reg32 offset="2" name="2">
1222 <bitfield name="BIN_SIZE_OFFSET" low="0" high="31" type="uint"/>
1223 </reg32>
1224 <!-- BIN_DATA2_ADDR -> VSC_PIPE[p].DATA2_ADDRESS -->
1225 <reg32 offset="3" name="3">
1226 <bitfield name="BIN_DATA2_OFFSET" low="0" high="31" type="uint"/>
1227 </reg32>
1228 </stripe>
1229 <stripe varset="a7xx_abs_mask_mode" variants="ABS_MASK">
1230 <reg32 offset="1" name="ABS_MASK"/>
1231 <!-- BIN_DATA_ADDR -> VSC_PIPE[p].DATA_ADDRESS -->
1232 <reg32 offset="2" name="2">
1233 <bitfield name="BIN_DATA_OFFSET" low="0" high="31" type="uint"/>
1234 </reg32>
1235 <!-- BIN_SIZE_ADDRESS -> VSC_SIZE_ADDRESS + (p * 4)-->
1236 <reg32 offset="3" name="3">
1237 <bitfield name="BIN_SIZE_OFFSET" low="0" high="31" type="uint"/>
1238 </reg32>
1239 <!-- BIN_DATA2_ADDR -> VSC_PIPE[p].DATA2_ADDRESS -->
1240 <reg32 offset="4" name="4">
1241 <bitfield name="BIN_DATA2_OFFSET" low="0" high="31" type="uint"/>
1242 </reg32>
1243 </stripe>
1244 </domain>
1245
1246 <domain name="CP_REG_RMW" width="32">
1247 <doc>
1248 Modifies DST_REG using two sources that can either be registers
1249 or immediates. If SRC1_ADD is set, then do the following:
1250
1251 $dst = (($dst &amp; $src0) rot $rotate) + $src1
1252
1253 Otherwise:
1254
1255 $dst = (($dst &amp; $src0) rot $rotate) | $src1
1256
1257 Here "rot" means rotate left.
1258 </doc>
1259 <reg32 offset="0" name="0">
1260 <bitfield name="DST_REG" low="0" high="17" type="hex"/>
1261 <bitfield name="DST_SCRATCH" pos="19" type="boolean" varset="chip" variants="A7XX-"/>
1262 <!-- skip implied CP_WAIT_FOR_IDLE + CP_WAIT_FOR_ME -->
1263 <bitfield name="SKIP_WAIT_FOR_ME" pos="23" type="boolean" varset="chip" variants="A7XX-"/>
1264 <bitfield name="ROTATE" low="24" high="28" type="uint"/>
1265 <bitfield name="SRC1_ADD" pos="29" type="boolean"/>
1266 <bitfield name="SRC1_IS_REG" pos="30" type="boolean"/>
1267 <bitfield name="SRC0_IS_REG" pos="31" type="boolean"/>
1268 </reg32>
1269 <reg32 offset="1" name="1">
1270 <bitfield name="SRC0" low="0" high="31" type="uint"/>
1271 </reg32>
1272 <reg32 offset="2" name="2">
1273 <bitfield name="SRC1" low="0" high="31" type="uint"/>
1274 </reg32>
1275 </domain>
1276
1277 <domain name="CP_REG_TO_MEM" width="32" prefix="chip">
1278 <reg32 offset="0" name="0">
1279 <bitfield name="REG" low="0" high="17" type="hex"/>
1280 <!--
1281 Number of registers/dwords copied is max(CNT, 1).
1282 With 64B it gets rounded to the next 64B boundary.
1283 -->
1284 <bitfield name="CNT" low="18" high="29" type="uint"/>
1285 <!--
1286 Treat things as 64B, allowing for a 64B atomic read of
1287 registers.
1288 -->
1289 <bitfield name="64B" pos="30" type="boolean"/>
1290 <bitfield name="ACCUMULATE" pos="31" type="boolean"/>
1291 </reg32>
1292 <stripe varset="chip" variants="A2XX-A4XX">
1293 <reg32 offset="1" name="DEST" type="address"/>
1294 </stripe>
1295 <stripe varset="chip" variants="A5XX-">
1296 <reg64 offset="1" name="DEST" type="address"/>
1297 </stripe>
1298 </domain>
1299
1300 <domain name="CP_REG_TO_MEM_OFFSET_REG" width="32">
1301 <doc>
1302 Like CP_REG_TO_MEM, but the memory address to write to can be
1303 offsetted using either one or two registers or scratch
1304 registers.
1305 </doc>
1306 <reg32 offset="0" name="0">
1307 <bitfield name="REG" low="0" high="17" type="hex"/>
1308 <!-- number of registers/dwords copied is max(CNT, 1). -->
1309 <bitfield name="CNT" low="18" high="29" type="uint"/>
1310 <bitfield name="64B" pos="30" type="boolean"/>
1311 <bitfield name="ACCUMULATE" pos="31" type="boolean"/>
1312 </reg32>
1313 <reg64 offset="1" name="DEST" type="waddress"/>
1314 <reg32 offset="3" name="3">
1315 <bitfield name="OFFSET0" low="0" high="17" type="hex"/>
1316 <bitfield name="OFFSET0_SCRATCH" pos="19" type="boolean"/>
1317 </reg32>
1318 <!-- followed by an optional identical OFFSET1 dword -->
1319 </domain>
1320
1321 <domain name="CP_REG_TO_MEM_OFFSET_MEM" width="32">
1322 <doc>
1323 Like CP_REG_TO_MEM, but the memory address to write to can be
1324 offsetted using a DWORD in memory.
1325 </doc>
1326 <reg32 offset="0" name="0">
1327 <bitfield name="REG" low="0" high="17" type="hex"/>
1328 <!-- number of registers/dwords copied is max(CNT, 1). -->
1329 <bitfield name="CNT" low="18" high="29" type="uint"/>
1330 <bitfield name="64B" pos="30" type="boolean"/>
1331 <bitfield name="ACCUMULATE" pos="31" type="boolean"/>
1332 </reg32>
1333 <reg64 offset="1" name="DEST" type="waddress"/>
1334 <reg64 offset="3" name="OFFSET" type="waddress"/>
1335 </domain>
1336
1337 <domain name="CP_MEM_TO_REG" width="32">
1338 <reg32 offset="0" name="0">
1339 <bitfield name="REG" low="0" high="17" type="hex"/>
1340 <!-- number of registers/dwords copied is max(CNT, 1). -->
1341 <bitfield name="CNT" low="19" high="29" type="uint"/>
1342 <!-- shift each DWORD left by 2 while copying -->
1343 <bitfield name="SHIFT_BY_2" pos="30" type="boolean"/>
1344 <!-- does the same thing as CP_MEM_TO_MEM::UNK31 -->
1345 <bitfield name="UNK31" pos="31" type="boolean"/>
1346 </reg32>
1347 <stripe varset="chip" variants="A2XX-A4XX">
1348 <reg32 offset="1" name="SRC" type="address"/>
1349 </stripe>
1350 <stripe varset="chip" variants="A5XX-">
1351 <reg64 offset="1" name="SRC" type="address"/>
1352 </stripe>
1353 </domain>
1354
1355 <domain name="CP_MEM_TO_MEM" width="32">
1356 <reg32 offset="0" name="0">
1357 <!--
1358 not sure how many src operands we have, but the low
1359 bits negate the n'th src argument.
1360 -->
1361 <bitfield name="NEG_A" pos="0" type="boolean"/>
1362 <bitfield name="NEG_B" pos="1" type="boolean"/>
1363 <bitfield name="NEG_C" pos="2" type="boolean"/>
1364
1365 <!-- if set treat src/dst as 64bit values -->
1366 <bitfield name="DOUBLE" pos="29" type="boolean"/>
1367 <!-- execute CP_WAIT_FOR_MEM_WRITES beforehand -->
1368 <bitfield name="WAIT_FOR_MEM_WRITES" pos="30" type="boolean"/>
1369 <!-- some other kind of wait -->
1370 <bitfield name="UNK31" pos="31" type="boolean"/>
1371 </reg32>
1372 <reg64 offset="1" name="DST" type="waddress"/>
1373 <reg64 offset="3" name="SRC_A" type="address"/>
1374 <reg64 offset="5" name="SRC_B" type="address"/>
1375 <reg64 offset="7" name="SRC_C" type="address"/>
1376 <!--
1377 followed by sequence of addresses.. the first is the
1378 destination and the rest are N src addresses which are
1379 summed (after being negated if NEG_x bit set) allowing
1380 to do things like 'result += end - start' (which turns
1381 out to be useful for queries and accumulating results
1382 across multiple tiles)
1383 -->
1384 </domain>
1385
1386 <domain name="CP_MEMCPY" width="32">
1387 <reg32 offset="0" name="0">
1388 <bitfield name="DWORDS" low="0" high="31" type="uint"/>
1389 </reg32>
1390 <reg32 offset="1" name="1">
1391 <bitfield name="SRC_LO" low="0" high="31" type="hex"/>
1392 </reg32>
1393 <reg32 offset="2" name="2">
1394 <bitfield name="SRC_HI" low="0" high="31" type="hex"/>
1395 </reg32>
1396 <reg32 offset="3" name="3">
1397 <bitfield name="DST_LO" low="0" high="31" type="hex"/>
1398 </reg32>
1399 <reg32 offset="4" name="4">
1400 <bitfield name="DST_HI" low="0" high="31" type="hex"/>
1401 </reg32>
1402 </domain>
1403
1404 <domain name="CP_REG_TO_SCRATCH" width="32">
1405 <reg32 offset="0" name="0">
1406 <bitfield name="REG" low="0" high="17" type="hex"/>
1407 <bitfield name="SCRATCH" low="20" high="22" type="uint"/>
1408 <!-- number of registers/dwords copied is CNT + 1. -->
1409 <bitfield name="CNT" low="24" high="26" type="uint"/>
1410 <!-- skip implied CP_WAIT_FOR_IDLE + CP_WAIT_FOR_ME -->
1411 <bitfield name="SKIP_WAIT_FOR_ME" pos="27" type="boolean" varset="chip" variants="A7XX-"/>
1412 </reg32>
1413 </domain>
1414
1415 <domain name="CP_SCRATCH_TO_REG" width="32">
1416 <reg32 offset="0" name="0">
1417 <bitfield name="REG" low="0" high="17" type="hex"/>
1418 <!-- note: CP_MEM_TO_REG always sets this when writing to the register -->
1419 <bitfield name="UNK18" pos="18" type="boolean"/>
1420 <bitfield name="SCRATCH" low="20" high="22" type="uint"/>
1421 <!-- number of registers/dwords copied is CNT + 1. -->
1422 <bitfield name="CNT" low="24" high="26" type="uint"/>
1423 </reg32>
1424 </domain>
1425
1426 <domain name="CP_SCRATCH_WRITE" width="32">
1427 <reg32 offset="0" name="0">
1428 <bitfield name="SCRATCH" low="20" high="22" type="uint"/>
1429 </reg32>
1430 <!-- followed by one or more DWORDs to write to scratch registers -->
1431 </domain>
1432
1433 <domain name="CP_MEM_WRITE" width="32">
1434 <stripe varset="chip" variants="A2XX-A4XX">
1435 <reg32 offset="0" name="ADDR" type="address"/>
1436 </stripe>
1437 <stripe varset="chip" variants="A5XX-">
1438 <reg64 offset="0" name="ADDR" type="address"/>
1439 </stripe>
1440 <!-- followed by the DWORDs to write -->
1441 </domain>
1442
1443 <enum name="cp_cond_function">
1444 <value value="0" name="WRITE_ALWAYS"/>
1445 <value value="1" name="WRITE_LT"/>
1446 <value value="2" name="WRITE_LE"/>
1447 <value value="3" name="WRITE_EQ"/>
1448 <value value="4" name="WRITE_NE"/>
1449 <value value="5" name="WRITE_GE"/>
1450 <value value="6" name="WRITE_GT"/>
1451 </enum>
1452
1453 <domain name="CP_COND_WRITE" width="32">
1454 <reg32 offset="0" name="0">
1455 <bitfield name="FUNCTION" low="0" high="2" type="cp_cond_function"/>
1456 <bitfield name="POLL_MEMORY" pos="4" type="boolean"/>
1457 <bitfield name="WRITE_MEMORY" pos="8" type="boolean"/>
1458 </reg32>
1459 <reg32 offset="1" name="1">
1460 <bitfield name="POLL_ADDR" low="0" high="31" type="hex"/>
1461 </reg32>
1462 <reg32 offset="2" name="2">
1463 <bitfield name="REF" low="0" high="31"/>
1464 </reg32>
1465 <reg32 offset="3" name="3">
1466 <bitfield name="MASK" low="0" high="31"/>
1467 </reg32>
1468 <reg32 offset="4" name="4">
1469 <bitfield name="WRITE_ADDR" low="0" high="31" type="hex"/>
1470 </reg32>
1471 <reg32 offset="5" name="5">
1472 <bitfield name="WRITE_DATA" low="0" high="31"/>
1473 </reg32>
1474 </domain>
1475
1476 <enum name="poll_memory_type">
1477 <value value="0" name="POLL_REGISTER"/>
1478 <value value="1" name="POLL_MEMORY"/>
1479 <value value="2" name="POLL_SCRATCH"/>
1480 <value value="3" name="POLL_ON_CHIP" varset="chip" variants="A7XX-"/>
1481 <value value="4" name="POLL_SYSTEM_VARIABLE" varset="chip" variants="A8XX-"/>
1482 </enum>
1483
1484 <domain name="CP_COND_WRITE5" width="32">
1485 <reg32 offset="0" name="0">
1486 <bitfield name="FUNCTION" low="0" high="2" type="cp_cond_function"/>
1487 <bitfield name="SIGNED_COMPARE" pos="3" type="boolean"/>
1488 <!-- POLL_REGISTER polls a register at POLL_ADDR_LO. -->
1489 <bitfield name="POLL" low="4" high="6" type="poll_memory_type"/>
1490 <bitfield name="WRITE_MEMORY" pos="8" type="boolean"/>
1491 </reg32>
1492 <reg64 offset="1" name="POLL_ADDR" type="address"/>
1493 <reg32 offset="3" name="3">
1494 <bitfield name="REF" low="0" high="31"/>
1495 </reg32>
1496 <reg32 offset="4" name="4">
1497 <bitfield name="MASK" low="0" high="31"/>
1498 </reg32>
1499 <reg64 offset="5" name="WRITE_ADDR" type="waddress"/>
1500 <reg32 offset="7" name="7">
1501 <bitfield name="WRITE_DATA" low="0" high="31"/>
1502 </reg32>
1503 </domain>
1504
1505 <domain name="CP_WAIT_MEM_GTE" width="32">
1506 <doc>
1507 Wait until a memory value is greater than or equal to the
1508 reference, using signed comparison.
1509 </doc>
1510 <reg32 offset="0" name="0">
1511 <!-- Reserved for flags, presumably? Unused in FW -->
1512 <bitfield name="RESERVED" low="0" high="31" type="hex"/>
1513 </reg32>
1514 <reg64 offset="1" name="POLL_ADDR" type="address"/>
1515 <reg32 offset="3" name="3">
1516 <bitfield name="REF" low="0" high="31"/>
1517 </reg32>
1518 </domain>
1519
1520 <domain name="CP_WAIT_REG_MEM" width="32">
1521 <doc>
1522 This uses the same internal comparison as CP_COND_WRITE,
1523 but waits until the comparison is true instead. It busy-loops in
1524 the CP for the given number of cycles before trying again.
1525 </doc>
1526 <reg32 offset="0" name="0">
1527 <bitfield name="FUNCTION" low="0" high="2" type="cp_cond_function"/>
1528 <bitfield name="SIGNED_COMPARE" pos="3" type="boolean"/>
1529 <bitfield name="POLL" low="4" high="5" type="poll_memory_type"/>
1530 <bitfield name="WRITE_MEMORY" pos="8" type="boolean"/>
1531 </reg32>
1532 <reg64 offset="1" name="POLL_ADDR" type="address"/>
1533 <reg32 offset="3" name="3">
1534 <bitfield name="REF" low="0" high="31"/>
1535 </reg32>
1536 <reg32 offset="4" name="4">
1537 <bitfield name="MASK" low="0" high="31"/>
1538 </reg32>
1539 <reg32 offset="5" name="5">
1540 <bitfield name="DELAY_LOOP_CYCLES" low="0" high="31"/>
1541 </reg32>
1542 </domain>
1543
1544 <domain name="CP_WAIT_TWO_REGS" width="32">
1545 <doc>
1546 Waits for REG0 to not be 0 or REG1 to not equal REF
1547 </doc>
1548 <reg32 offset="0" name="0">
1549 <bitfield name="REG0" low="0" high="17" type="hex"/>
1550 </reg32>
1551 <reg32 offset="1" name="1">
1552 <bitfield name="REG1" low="0" high="17" type="hex"/>
1553 </reg32>
1554 <reg32 offset="2" name="2">
1555 <bitfield name="REF" low="0" high="31" type="uint"/>
1556 </reg32>
1557 </domain>
1558
1559 <domain name="CP_DISPATCH_COMPUTE" width="32">
1560 <reg32 offset="0" name="0"/>
1561 <reg32 offset="1" name="1">
1562 <bitfield name="X" low="0" high="31"/>
1563 </reg32>
1564 <reg32 offset="2" name="2">
1565 <bitfield name="Y" low="0" high="31"/>
1566 </reg32>
1567 <reg32 offset="3" name="3">
1568 <bitfield name="Z" low="0" high="31"/>
1569 </reg32>
1570 </domain>
1571
1572 <domain name="CP_SET_RENDER_MODE" width="32">
1573 <enum name="render_mode_cmd">
1574 <value value="1" name="BYPASS"/>
1575 <value value="2" name="BINNING"/>
1576 <value value="3" name="GMEM"/>
1577 <value value="5" name="BLIT2D"/>
1578 <!-- placeholder name.. used when CP_BLIT packets with BLIT_OP_SCALE?? -->
1579 <value value="7" name="BLIT2DSCALE"/>
1580 <!-- 8 set before going back to BYPASS exiting 2D -->
1581 <value value="8" name="END2D"/>
1582 </enum>
1583 <reg32 offset="0" name="0">
1584 <bitfield name="MODE" low="0" high="8" type="render_mode_cmd"/>
1585 <!--
1586 normally 0x1/0x3, sometimes see 0x5/0x8 with unknown registers in
1587 0x21xx range.. possibly (at least some) a5xx variants have a
1588 2d core?
1589 -->
1590 </reg32>
1591 <!-- I think first buffer is for GPU to save context in case of ctx switch? -->
1592 <reg32 offset="1" name="1">
1593 <bitfield name="ADDR_0_LO" low="0" high="31"/>
1594 </reg32>
1595 <reg32 offset="2" name="2">
1596 <bitfield name="ADDR_0_HI" low="0" high="31"/>
1597 </reg32>
1598 <reg32 offset="3" name="3">
1599 <!--
1600 set when in GMEM.. maybe indicates GMEM contents need to be
1601 preserved on ctx switch?
1602 -->
1603 <bitfield name="VSC_ENABLE" pos="3" type="boolean"/>
1604 <bitfield name="GMEM_ENABLE" pos="4" type="boolean"/>
1605 </reg32>
1606 <reg32 offset="4" name="4"/>
1607 <!-- second buffer looks like some cmdstream.. length in dwords: -->
1608 <reg32 offset="5" name="5">
1609 <bitfield name="ADDR_1_LEN" low="0" high="31" type="uint"/>
1610 </reg32>
1611 <reg32 offset="6" name="6">
1612 <bitfield name="ADDR_1_LO" low="0" high="31"/>
1613 </reg32>
1614 <reg32 offset="7" name="7">
1615 <bitfield name="ADDR_1_HI" low="0" high="31"/>
1616 </reg32>
1617 </domain>
1618
1619 <!-- this looks fairly similar to CP_SET_RENDER_MODE minus first dword -->
1620 <domain name="CP_COMPUTE_CHECKPOINT" width="32">
1621 <!-- I think first buffer is for GPU to save context in case of ctx switch? -->
1622 <reg32 offset="0" name="0">
1623 <bitfield name="ADDR_0_LO" low="0" high="31"/>
1624 </reg32>
1625 <reg32 offset="1" name="1">
1626 <bitfield name="ADDR_0_HI" low="0" high="31"/>
1627 </reg32>
1628 <reg32 offset="2" name="2">
1629 </reg32>
1630 <reg32 offset="3" name="3"/>
1631 <!-- second buffer looks like some cmdstream.. length in dwords: -->
1632 <reg32 offset="4" name="4">
1633 <bitfield name="ADDR_1_LEN" low="0" high="31" type="uint"/>
1634 </reg32>
1635 <reg32 offset="5" name="5">
1636 <bitfield name="ADDR_1_LO" low="0" high="31"/>
1637 </reg32>
1638 <reg32 offset="6" name="6">
1639 <bitfield name="ADDR_1_HI" low="0" high="31"/>
1640 </reg32>
1641 <reg32 offset="7" name="7"/>
1642 </domain>
1643
1644 <domain name="CP_PERFCOUNTER_ACTION" width="32">
1645 <reg32 offset="0" name="0">
1646 </reg32>
1647 <reg32 offset="1" name="1">
1648 <bitfield name="ADDR_0_LO" low="0" high="31"/>
1649 </reg32>
1650 <reg32 offset="2" name="2">
1651 <bitfield name="ADDR_0_HI" low="0" high="31"/>
1652 </reg32>
1653 </domain>
1654
1655 <domain varset="chip" name="CP_EVENT_WRITE" width="32">
1656 <reg32 offset="0" name="0">
1657 <bitfield name="EVENT" low="0" high="7" type="vgt_event_type"/>
1658 <!-- when set, write back timestamp instead of value from packet: -->
1659 <bitfield name="TIMESTAMP" pos="30" type="boolean"/>
1660 <bitfield name="IRQ" pos="31" type="boolean"/>
1661 </reg32>
1662 <!--
1663 TODO what is gpuaddr for, seems to be all 0's.. maybe needed for
1664 context switch?
1665 -->
1666 <reg64 offset="1" name="ADDR" type="waddress"/>
1667 <reg32 offset="3" name="3">
1668 <!-- ??? -->
1669 </reg32>
1670 </domain>
1671
1672 <domain varset="chip" name="CP_EVENT_WRITE7" width="32">
1673 <enum name="event_write_src">
1674 <!-- Write payload[0] -->
1675 <value value="0" name="EV_WRITE_USER_32B"/>
1676 <!-- Write payload[0] payload[1] -->
1677 <value value="1" name="EV_WRITE_USER_64B"/>
1678 <!-- Write (TIMESTAMP_GLOBAL + TIMESTAMP_LOCAL) -->
1679 <value value="2" name="EV_WRITE_TIMESTAMP_SUM"/>
1680 <value value="3" name="EV_WRITE_ALWAYSON"/>
1681 <!-- Write payload[1] regs starting at payload[0] offset -->
1682 <value value="4" name="EV_WRITE_REGS_CONTENT"/>
1683 </enum>
1684
1685 <enum name="event_write_dst">
1686 <value value="0" name="EV_DST_RAM"/>
1687 <value value="1" name="EV_DST_ONCHIP"/>
1688 </enum>
1689
1690 <reg32 offset="0" name="0">
1691 <bitfield name="EVENT" low="0" high="7" type="vgt_event_type"/>
1692 <bitfield name="WRITE_SAMPLE_COUNT" pos="12" type="boolean"/>
1693 <!-- Write sample count at (iova + 16) -->
1694 <bitfield name="SAMPLE_COUNT_END_OFFSET" pos="13" type="boolean"/>
1695 <!-- *(iova + 8) += *(iova + 16) - *iova -->
1696 <bitfield name="WRITE_ACCUM_SAMPLE_COUNT_DIFF" pos="14" type="boolean"/>
1697
1698 <!-- Next 4 flags are valid to set only when concurrent binning is enabled -->
1699 <!-- Increment 16b BV counter. Valid only in BV pipe -->
1700 <bitfield name="INC_BV_COUNT" pos="16" type="boolean"/>
1701 <!-- Increment 16b BR counter. Valid only in BR pipe -->
1702 <bitfield name="INC_BR_COUNT" pos="17" type="boolean"/>
1703 <bitfield name="CLEAR_RENDER_RESOURCE" pos="18" type="boolean"/>
1704 <bitfield name="CLEAR_LRZ_RESOURCE" pos="19" type="boolean"/>
1705
1706 <bitfield name="WRITE_SRC" low="20" high="22" type="event_write_src"/>
1707 <bitfield name="WRITE_DST" pos="24" type="event_write_dst" addvariant="yes"/>
1708 <!-- Writes into WRITE_DST from WRITE_SRC. RB_DONE_TS requires WRITE_ENABLED. -->
1709 <bitfield name="WRITE_ENABLED" pos="27" type="boolean"/>
1710 <bitfield name="IRQ" pos="31" type="boolean"/>
1711 </reg32>
1712
1713 <stripe varset="event_write_dst" variants="EV_DST_RAM">
1714 <reg64 offset="1" name="1" type="waddress"/>
1715 <reg32 offset="3" name="3">
1716 <bitfield name="PAYLOAD_0" low="0" high="31"/>
1717 </reg32>
1718 <reg32 offset="4" name="4">
1719 <bitfield name="PAYLOAD_1" low="0" high="31"/>
1720 </reg32>
1721 </stripe>
1722
1723 <stripe varset="event_write_dst" variants="EV_DST_ONCHIP">
1724 <reg32 offset="1" name="1">
1725 <bitfield name="ONCHIP_ADDR_0" low="0" high="31"/>
1726 </reg32>
1727 <reg32 offset="3" name="3">
1728 <bitfield name="PAYLOAD_0" low="0" high="31"/>
1729 </reg32>
1730 <reg32 offset="4" name="4">
1731 <bitfield name="PAYLOAD_1" low="0" high="31"/>
1732 </reg32>
1733 </stripe>
1734 </domain>
1735
1736 <domain name="CP_BLIT" width="32">
1737 <enum name="cp_blit_cmd">
1738 <value value="0" name="BLIT_OP_FILL"/>
1739 <value value="1" name="BLIT_OP_COPY"/>
1740 <value value="3" name="BLIT_OP_SCALE"/> <!-- used for mipmap generation -->
1741 </enum>
1742 <reg32 offset="0" name="0">
1743 <bitfield name="OP" low="0" high="3" type="cp_blit_cmd"/>
1744 </reg32>
1745 <reg32 offset="1" name="1">
1746 <bitfield name="SRC_X1" low="0" high="13" type="uint"/>
1747 <bitfield name="SRC_Y1" low="16" high="29" type="uint"/>
1748 </reg32>
1749 <reg32 offset="2" name="2">
1750 <bitfield name="SRC_X2" low="0" high="13" type="uint"/>
1751 <bitfield name="SRC_Y2" low="16" high="29" type="uint"/>
1752 </reg32>
1753 <reg32 offset="3" name="3">
1754 <bitfield name="DST_X1" low="0" high="13" type="uint"/>
1755 <bitfield name="DST_Y1" low="16" high="29" type="uint"/>
1756 </reg32>
1757 <reg32 offset="4" name="4">
1758 <bitfield name="DST_X2" low="0" high="13" type="uint"/>
1759 <bitfield name="DST_Y2" low="16" high="29" type="uint"/>
1760 </reg32>
1761 </domain>
1762
1763 <domain name="CP_EXEC_CS" width="32">
1764 <reg32 offset="0" name="0">
1765 </reg32>
1766 <reg32 offset="1" name="1">
1767 <bitfield name="NGROUPS_X" low="0" high="31" type="uint"/>
1768 </reg32>
1769 <reg32 offset="2" name="2">
1770 <bitfield name="NGROUPS_Y" low="0" high="31" type="uint"/>
1771 </reg32>
1772 <reg32 offset="3" name="3">
1773 <bitfield name="NGROUPS_Z" low="0" high="31" type="uint"/>
1774 </reg32>
1775 </domain>
1776
1777 <domain name="CP_EXEC_CS_INDIRECT" width="32" varset="chip" prefix="chip" variants="A4XX-">
1778 <reg32 offset="0" name="0">
1779 </reg32>
1780 <stripe varset="chip" variants="A4XX">
1781 <reg32 offset="1" name="ADDR" type="address"/>
1782 <reg32 offset="2" name="2">
1783 <!-- localsize is value minus one: -->
1784 <bitfield name="LOCALSIZEX" low="2" high="11" type="uint"/>
1785 <bitfield name="LOCALSIZEY" low="12" high="21" type="uint"/>
1786 <bitfield name="LOCALSIZEZ" low="22" high="31" type="uint"/>
1787 </reg32>
1788 </stripe>
1789 <stripe varset="chip" variants="A5XX-">
1790 <reg64 offset="1" name="ADDR" type="address"/>
1791 <reg32 offset="3" name="3">
1792 <!-- localsize is value minus one: -->
1793 <bitfield name="LOCALSIZEX" low="2" high="11" type="uint"/>
1794 <bitfield name="LOCALSIZEY" low="12" high="21" type="uint"/>
1795 <bitfield name="LOCALSIZEZ" low="22" high="31" type="uint"/>
1796 </reg32>
1797 </stripe>
1798 </domain>
1799
1800 <domain name="CP_SET_MARKER" width="32" varset="chip" prefix="chip" variants="A6XX-">
1801 <doc>Tell CP the current operation mode, indicates save and restore procedure</doc>
1802 <enum name="set_marker_mode">
1803 <value value="0" name="SET_RENDER_MODE"/>
1804 <!-- IFPC - inter-frame power collapse -->
1805 <value value="1" name="SET_IFPC_MODE"/>
1806 </enum>
1807 <enum name="a6xx_ifpc_mode">
1808 <value value="0" name="IFPC_ENABLE"/>
1809 <value value="1" name="IFPC_DISABLE"/>
1810 </enum>
1811 <enum name="a6xx_marker">
1812 <value value="1" name="RM6_DIRECT_RENDER"/>
1813 <value value="2" name="RM6_BIN_VISIBILITY"/>
1814 <value value="3" name="RM6_BIN_DIRECT"/>
1815 <value value="4" name="RM6_BIN_RENDER_START"/>
1816 <value value="5" name="RM6_BIN_END_OF_DRAWS"/>
1817 <value value="6" name="RM6_BIN_RESOLVE"/>
1818 <value value="7" name="RM6_BIN_RENDER_END"/>
1819 <value value="8" name="RM6_COMPUTE"/>
1820 <value value="12" name="RM6_BLIT2DSCALE"/> <!-- no-op (at least on current sqe fw) -->
1821
1822 <!--
1823 These values come from a6xx_set_marker() in the
1824 downstream kernel, and they can only be set by the kernel
1825 -->
1826 <value value="13" name="RM6_IB1LIST_START"/>
1827 <value value="14" name="RM6_IB1LIST_END"/>
1828 <value value="15" name="RM7_BIN_VISIBILITY_END"/>
1829
1830 <!-- new in a8xx: -->
1831 <value value="32" name="RM8_DEPTH_PASS_START"/>
1832 <value value="33" name="RM8_DEPTH_PASS_END"/>
1833 <value value="34" name="RM8_SET_RENDER_TARGET"/>
1834 <value value="35" name="RM8_PGMEM_ON"/>
1835 <value value="36" name="RM8_PGMEM_OFF"/>
1836 </enum>
1837 <stripe varset="chip" variants="A6XX-A7XX">
1838 <reg32 offset="0" name="0">
1839 <!-- if b8 is set, the low bits are interpreted differently (and b4 ignored) -->
1840 <bitfield name="MARKER_MODE" pos="8" type="set_marker_mode" addvariant="yes"/>
1841
1842
1843 <bitfield name="MODE" low="0" high="3" type="a6xx_marker" varset="set_marker_mode" variants="SET_RENDER_MODE"/>
1844 <!-- used by preemption to determine if GMEM needs to be saved or not -->
1845 <bitfield name="USES_GMEM" pos="4" type="boolean" varset="set_marker_mode" variants="SET_RENDER_MODE"/>
1846
1847
1848 <bitfield name="IFPC_MODE" pos="0" type="a6xx_ifpc_mode" varset="set_marker_mode" variants="SET_IFPC_MODE"/>
1849
1850
1851 <!--
1852 CP_SET_MARKER is used with these bits to create a
1853 critical section around a workaround for ray tracing.
1854 The workaround happens after BVH building, and appears
1855 to invalidate the RTU's BVH node cache. It makes sure
1856 that only one of BR/BV/LPAC is executing the
1857 workaround at a time, and no draws using RT on BV/LPAC
1858 are executing while the workaround is executed on BR (or
1859 vice versa, that no draws on BV/BR using RT are executed
1860 while the workaround executes on LPAC), by
1861 hooking subsequent CP_EVENT_WRITE/CP_DRAW_*/CP_EXEC_CS.
1862 The blob usage is:
1863
1864
1865 CP_SET_MARKER(RT_WA_START)
1866 ... workaround here ...
1867 CP_SET_MARKER(RT_WA_END)
1868 ...
1869 CP_SET_MARKER(SHADER_USES_RT)
1870 CP_DRAW_INDX(...) or CP_EXEC_CS(...)
1871 -->
1872 <bitfield name="SHADER_USES_RT" pos="9" type="boolean" variants="A7XX-"/>
1873 <bitfield name="RT_WA_START" pos="10" type="boolean" variants="A7XX-"/>
1874 <bitfield name="RT_WA_END" pos="11" type="boolean" variants="A7XX-"/>
1875 </reg32>
1876 </stripe>
1877 <stripe varset="chip" variants="A8XX-">
1878 <reg32 offset="0" name="0">
1879 <!-- if b8 is set, the low bits are interpreted differently (and b4 ignored) -->
1880 <bitfield name="MARKER_MODE" pos="8" type="set_marker_mode" addvariant="yes"/>
1881 <bitfield name="MODE" low="0" high="6" type="a6xx_marker" varset="set_marker_mode" variants="SET_RENDER_MODE"/>
1882 <bitfield name="USES_GMEM" pos="7" type="boolean" varset="set_marker_mode" variants="SET_RENDER_MODE"/>
1883 <bitfield name="IFPC_MODE" pos="0" type="a6xx_ifpc_mode" varset="set_marker_mode" variants="SET_IFPC_MODE"/>
1884 <!-- idk if the RT w/a fields apply to a8xx as well -->
1885 </reg32>
1886 </stripe>
1887 </domain>
1888
1889 <domain name="CP_SET_PSEUDO_REG" width="32" varset="chip" prefix="chip" variants="A6XX-">
1890 <doc>Set internal CP registers, used to indicate context save data addresses</doc>
1891 <enum name="pseudo_reg">
1892 <value value="0" name="SMMU_INFO"/>
1893 <value value="1" name="NON_SECURE_SAVE_ADDR"/>
1894 <value value="2" name="SECURE_SAVE_ADDR"/>
1895 <value value="3" name="NON_PRIV_SAVE_ADDR"/>
1896 <value value="4" name="COUNTER"/>
1897
1898 <!--
1899 On a6xx the registers are set directly and CP_SET_BIN_DATA5_OFFSET reads them,
1900 but that doesn't work with concurrent binning because BR will be reading from
1901 a different set of streams than BV is writing, so on a7xx we have these
1902 pseudo-regs instead, which do the right thing.
1903
1904 The corresponding VSC registers exist, and they're written by BV when it
1905 encounters CP_SET_PSEUDO_REG. When BR later encounters the same CP_SET_PSEUDO_REG
1906 it will only write some private scratch registers which are read by
1907 CP_SET_BIN_DATA5_OFFSET.
1908
1909 If concurrent binning is disabled then BR also does binning so it will also
1910 write the "real" registers in BR.
1911 -->
1912 <value value="8" name="VSC_PIPE_DATA_DRAW_BASE"/>
1913 <value value="9" name="VSC_SIZE_BASE"/>
1914 <value value="10" name="VSC_PIPE_DATA_PRIM_BASE"/>
1915 <value value="11" name="UNK_STRM_ADDRESS"/>
1916 <value value="12" name="UNK_STRM_SIZE_ADDRESS"/>
1917
1918 <value value="16" name="BINDLESS_BASE_0_ADDR"/>
1919 <value value="17" name="BINDLESS_BASE_1_ADDR"/>
1920 <value value="18" name="BINDLESS_BASE_2_ADDR"/>
1921 <value value="19" name="BINDLESS_BASE_3_ADDR"/>
1922 <value value="20" name="BINDLESS_BASE_4_ADDR"/>
1923 <value value="21" name="BINDLESS_BASE_5_ADDR"/>
1924 <value value="22" name="BINDLESS_BASE_6_ADDR"/>
1925 </enum>
1926 <array offset="0" stride="3" length="100">
1927 <reg32 offset="0" name="0">
1928 <bitfield name="PSEUDO_REG" low="0" high="10" type="pseudo_reg"/>
1929 </reg32>
1930 <reg32 offset="1" name="1">
1931 <bitfield name="LO" low="0" high="31"/>
1932 </reg32>
1933 <reg32 offset="2" name="2">
1934 <bitfield name="HI" low="0" high="31"/>
1935 </reg32>
1936 </array>
1937 </domain>
1938
1939 <domain name="CP_REG_TEST" width="32" varset="chip" prefix="chip" variants="A6XX-">
1940 <doc>
1941 Tests bit in specified register and sets predicate for CP_COND_REG_EXEC.
1942 So:
1943
1944 opcode: CP_REG_TEST (39) (2 dwords)
1945 { REG = 0xc10 | BIT = 0 }
1946 0000: 70b90001 00000c10
1947 opcode: CP_COND_REG_EXEC (47) (3 dwords)
1948 0000: 70c70002 10000000 00000004
1949 opcode: CP_INDIRECT_BUFFER (3f) (4 dwords)
1950
1951 Will execute the CP_INDIRECT_BUFFER only if b0 in the register at
1952 offset 0x0c10 is 1
1953 </doc>
1954 <enum name="source_type">
1955 <value value="0" name="SOURCE_REG"/>
1956 <!-- Don't confuse with scratch registers, this is a separate memory
1957 written into by CP_MEM_TO_SCRATCH_MEM. -->
1958 <value value="1" name="SOURCE_SCRATCH_MEM" varset="chip" variants="A7XX-"/>
1959 </enum>
1960 <reg32 offset="0" name="0">
1961 <!-- the register to test -->
1962 <bitfield name="REG" low="0" high="17" varset="source_type" variants="SOURCE_REG"/>
1963 <bitfield name="SCRATCH_MEM_OFFSET" low="0" high="17" varset="source_type" variants="SOURCE_SCRATCH_MEM"/>
1964 <bitfield name="SOURCE" pos="18" type="source_type" addvariant="yes"/>
1965 <!-- the bit to test -->
1966 <bitfield name="BIT" low="20" high="24" type="uint"/>
1967 <!-- skip implied CP_WAIT_FOR_ME -->
1968 <bitfield name="SKIP_WAIT_FOR_ME" pos="25" type="boolean"/>
1969 <!-- the predicate bit to set (new in gen3+) -->
1970 <bitfield name="PRED_BIT" low="26" high="30" type="uint"/>
1971 <!-- update the predicate reg directly (new in gen3+) -->
1972 <bitfield name="PRED_UPDATE" pos="31" type="boolean"/>
1973 </reg32>
1974
1975 <!--
1976 In PRED_UPDATE mode, the predicate reg is updated directly using two
1977 more dwords, ignoring other bits:
1978
1979 PRED_REG = (PRED_REG & ~PRED_MASK) | (PRED_VAL & PRED_MASK);
1980 -->
1981 <reg32 offset="1" name="PRED_MASK" type="hex"/>
1982 <reg32 offset="2" name="PRED_VAL" type="hex"/>
1983 </domain>
1984
1985 <!-- I *think* this existed at least as far back as a4xx -->
1986 <domain name="CP_COND_REG_EXEC" width="32">
1987 <enum name="compare_mode">
1988 <!-- use the predicate bit set by CP_REG_TEST -->
1989 <value value="1" name="PRED_TEST"/>
1990 <!-- compare two registers directly for equality -->
1991 <value value="2" name="REG_COMPARE"/>
1992 <!-- test if certain render modes are set via CP_SET_MARKER -->
1993 <value value="3" name="RENDER_MODE" varset="chip" variants="A6XX-"/>
1994 <!-- compare REG0 for equality with immediate -->
1995 <value value="4" name="REG_COMPARE_IMM" varset="chip" variants="A7XX-"/>
1996 <!-- test which of BR/BV are enabled -->
1997 <value value="5" name="THREAD_MODE" varset="chip" variants="A7XX-"/>
1998 </enum>
1999 <reg32 offset="0" name="0" varset="compare_mode">
2000 <bitfield name="REG0" low="0" high="17" variants="REG_COMPARE" type="hex"/>
2001
2002 <!-- the predicate bit to test (new in gen3+) -->
2003 <bitfield name="PRED_BIT" low="18" high="22" variants="PRED_TEST" type="uint"/>
2004 <bitfield name="SKIP_WAIT_FOR_ME" pos="23" varset="chip" variants="A7XX-" type="boolean"/>
2005 <!-- With REG_COMPARE instead of register read from ONCHIP memory -->
2006 <bitfield name="ONCHIP_MEM" pos="24" varset="chip" variants="A7XX-" type="boolean"/>
2007
2008 <!--
2009 Note: these bits have the same meaning, and use the same
2010 internal mechanism as the bits in CP_SET_DRAW_STATE.
2011 When RENDER_MODE is selected, they're used as
2012 a bitmask of which modes pass the test.
2013 -->
2014
2015 <!-- RM6_BIN_VISIBILITY -->
2016 <bitfield name="BINNING" pos="25" variants="RENDER_MODE" type="boolean"/>
2017 <!-- all others -->
2018 <bitfield name="GMEM" pos="26" variants="RENDER_MODE" type="boolean"/>
2019 <!-- RM6_DIRECT_RENDER -->
2020 <bitfield name="SYSMEM" pos="27" variants="RENDER_MODE" type="boolean"/>
2021
2022 <bitfield name="BV" pos="25" variants="THREAD_MODE" type="boolean"/>
2023 <bitfield name="BR" pos="26" variants="THREAD_MODE" type="boolean"/>
2024 <bitfield name="LPAC" pos="27" variants="THREAD_MODE" type="boolean"/>
2025
2026 <bitfield name="MODE" low="28" high="31" type="compare_mode" addvariant="yes"/>
2027 </reg32>
2028
2029 <stripe varset="compare_mode" variants="PRED_TEST">
2030 <reg32 offset="1" name="1">
2031 <bitfield name="DWORDS" low="0" high="23" type="uint"/>
2032 </reg32>
2033 </stripe>
2034
2035 <stripe varset="compare_mode" variants="REG_COMPARE">
2036 <reg32 offset="1" name="1">
2037 <bitfield name="REG1" low="0" high="17" type="hex"/>
2038 <!-- Instead of register read from ONCHIP memory -->
2039 <bitfield name="ONCHIP_MEM" pos="24" varset="chip" variants="A7XX-" type="boolean"/>
2040 </reg32>
2041 </stripe>
2042
2043 <stripe varset="compare_mode" variants="RENDER_MODE">
2044 <reg32 offset="1" name="1">
2045 <bitfield name="DWORDS" low="0" high="23" type="uint"/>
2046 </reg32>
2047 </stripe>
2048
2049 <stripe varset="compare_mode" variants="REG_COMPARE_IMM">
2050 <reg32 offset="1" name="1">
2051 <bitfield name="IMM" low="0" high="31"/>
2052 </reg32>
2053 </stripe>
2054
2055 <stripe varset="compare_mode" variants="THREAD_MODE">
2056 <reg32 offset="1" name="1">
2057 <bitfield name="DWORDS" low="0" high="23" type="uint"/>
2058 </reg32>
2059 </stripe>
2060
2061 <reg32 offset="2" name="2">
2062 <bitfield name="DWORDS" low="0" high="23" type="uint"/>
2063 </reg32>
2064 </domain>
2065
2066 <domain name="CP_COND_EXEC" width="32">
2067 <doc>
2068 Executes the following DWORDs of commands if the dword
2069 at BOOL_ADDR is not equal to 0 and the the timestamp
2070 value ACTIVE_TIMESTAMP is ahead of the value fetched
2071 from TIMESTAMP_ADDR.
2072
2073 The timestamp comparision is an unsigned compare with
2074 wraparound, ie:
2075
2076 (ACTIVE_TIMESTAMP - *TIMESTAMP_ADDR) &lt; 0x80000000
2077 </doc>
2078 <reg64 offset="0" name="BOOL_ADDR" type="address"/>
2079 <reg64 offset="2" name="TIMESTAMP_ADDR" type="address"/>
2080 <reg32 offset="4" name="ACTIVE_TIMESTAMP"/>
2081 <reg32 offset="5" name="DWORDS"/>
2082 </domain>
2083
2084 <domain name="CP_SET_AMBLE" width="32">
2085 <doc>
2086 Used by the userspace and kernel drivers to set various IB's
2087 which are executed during context save/restore for handling
2088 state that isn't restored by the context switch routine itself.
2089 </doc>
2090 <enum name="amble_type">
2091 <value name="PREAMBLE_AMBLE_TYPE" value="0">
2092 <doc>Executed unconditionally when switching back to the context.</doc>
2093 </value>
2094 <value name="BIN_PREAMBLE_AMBLE_TYPE" value="1">
2095 <doc>
2096 Executed when switching back after switching
2097 away during execution of
2098 a CP_SET_MARKER packet with RM6_BIN_RENDER_END as the
2099 payload *and* skipsaverestore is set. This is
2100 expected to restore static register values not
2101 saved when skipsaverestore is set.
2102
2103 On BV, a skipsaverestore preemption is triggered
2104 and this preamble type is executed whenever a
2105 CP_THREAD_CONTROL that synchronizes threads
2106 happens. This can be explicitly via
2107 SYNC_THREADS, or implicitly when the value of
2108 CONCURRENT_BIN_DISABLE changes from the previous
2109 thread control.
2110 </doc>
2111 </value>
2112 <value name="POSTAMBLE_AMBLE_TYPE" value="2">
2113 <doc>
2114 Executed when switching away from the context,
2115 except for context switches initiated via
2116 CP_YIELD.
2117 </doc>
2118 </value>
2119 <value name="KMD_AMBLE_TYPE" value="3">
2120 <doc>
2121 This can only be set by the RB (i.e. the kernel)
2122 and executes with protected mode off, but
2123 is otherwise similar to POSTAMBLE_AMBLE_TYPE.
2124 </doc>
2125 </value>
2126 </enum>
2127 <reg64 offset="0" name="ADDR" type="address"/>
2128 <reg32 offset="2" name="2">
2129 <bitfield name="DWORDS" low="0" high="19" type="uint"/>
2130 <bitfield name="TYPE" low="20" high="21" type="amble_type"/>
2131 </reg32>
2132 </domain>
2133
2134 <domain name="CP_REG_WRITE" width="32">
2135 <enum name="reg_tracker">
2136 <doc>
2137 Keep shadow copies of these registers and only set them
2138 when drawing, avoiding redundant writes:
2139 - VPC_CNTL_0
2140 - HLSQ_CONTROL_1_REG
2141 - HLSQ_UNKNOWN_B980
2142 </doc>
2143 <value name="TRACK_CNTL_REG" value="0x1"/>
2144 <doc>
2145 Track RB_RENDER_CNTL, and insert a WFI in the following
2146 situation:
2147 - There is a write that disables binning
2148 - There was a draw with binning left enabled, but in
2149 BYPASS mode
2150 Presumably this is a hang workaround?
2151 </doc>
2152 <value name="TRACK_RENDER_CNTL" value="0x2"/>
2153 <doc>
2154 Do a mysterious CP_EVENT_WRITE 0x3f when the low bit of
2155 the data to write is 0. Used by the Vulkan blob with
2156 PC_MULTIVIEW_CNTL, but this isn't predicated on particular
2157 register(s) like the others.
2158 </doc>
2159 <value name="UNK_EVENT_WRITE" value="0x4"/>
2160 <doc>
2161 Tracks GRAS_LRZ_CNTL::GREATER, GRAS_LRZ_CNTL::DIR, and
2162 GRAS_LRZ_VIEW_INFO with previous values, and if one of
2163 the following is true:
2164 - GRAS_LRZ_CNTL::GREATER has changed
2165 - GRAS_LRZ_CNTL::DIR has changed, the old value is not
2166 CUR_DIR_GE, and the new value is not CUR_DIR_DISABLED
2167 - GRAS_LRZ_VIEW_INFO has changed
2168 then it does a LRZ_FLUSH with GRAS_LRZ_CNTL::ENABLE
2169 forced to 1.
2170 Only exists in a650_sqe.fw.
2171 </doc>
2172 <value name="TRACK_LRZ" value="0x8"/>
2173 </enum>
2174 <reg32 offset="0" name="0">
2175 <bitfield name="TRACKER" low="0" high="3" type="reg_tracker"/>
2176 </reg32>
2177 <reg32 offset="1" name="1"/>
2178 <reg32 offset="2" name="2"/>
2179 </domain>
2180
2181 <domain name="CP_SMMU_TABLE_UPDATE" width="32">
2182 <doc>
2183 Note that the SMMU's definition of TTBRn can take different forms
2184 depending on the pgtable format. But a5xx+ only uses aarch64
2185 format.
2186 </doc>
2187 <reg32 offset="0" name="0">
2188 <bitfield name="TTBR0_LO" low="0" high="31"/>
2189 </reg32>
2190 <reg32 offset="1" name="1">
2191 <bitfield name="TTBR0_HI" low="0" high="15"/>
2192 <bitfield name="ASID" low="16" high="31"/>
2193 </reg32>
2194 <reg32 offset="2" name="2">
2195 <doc>Unused, does not apply to aarch64 pgtable format</doc>
2196 <bitfield name="CONTEXTIDR" low="0" high="31"/>
2197 </reg32>
2198 <reg32 offset="3" name="3">
2199 <bitfield name="CONTEXTBANK" low="0" high="31"/>
2200 </reg32>
2201 </domain>
2202
2203 <domain name="CP_START_BIN" width="32">
2204 <reg32 offset="0" name="BIN_COUNT" type="uint"/>
2205 <reg64 offset="1" name="PREFIX_ADDR" type="address"/>
2206 <reg32 offset="3" name="PREFIX_DWORDS">
2207 <doc>
2208 Size of prefix for each bin. For each bin index i, the
2209 prefix commands at PREFIX_ADDR + i * PREFIX_DWORDS are
2210 executed in an IB2 before the IB1 commands following
2211 this packet.
2212 </doc>
2213 </reg32>
2214 <reg32 offset="4" name="BODY_DWORDS">
2215 <doc>Number of dwords after this packet until CP_END_BIN</doc>
2216 </reg32>
2217 </domain>
2218
2219 <domain name="CP_WAIT_TIMESTAMP" width="32">
2220 <enum name="ts_wait_value_src">
2221 <!-- Wait for value at memory address to be >= SRC_0 (signed comparison) -->
2222 <value value="0" name="TS_WAIT_GE_32B"/>
2223 <!-- Wait for value at memory address to be >= SRC_0 (unsigned) -->
2224 <value value="1" name="TS_WAIT_GE_64B"/>
2225 <!-- Write (TIMESTAMP_GLOBAL + TIMESTAMP_LOCAL) -->
2226 <value value="2" name="TS_WAIT_GE_TIMESTAMP_SUM"/>
2227 </enum>
2228
2229 <enum name="ts_wait_type">
2230 <value value="0" name="TS_WAIT_RAM"/>
2231 <value value="1" name="TS_WAIT_ONCHIP"/>
2232 </enum>
2233
2234 <reg32 offset="0" name="0">
2235 <bitfield name="WAIT_VALUE_SRC" low="0" high="1" type="ts_wait_value_src"/>
2236 <bitfield name="WAIT_DST" pos="4" type="ts_wait_type" addvariant="yes"/>
2237 </reg32>
2238
2239 <stripe varset="ts_wait_type" variants="TS_WAIT_RAM">
2240 <reg64 offset="1" name="ADDR" type="address"/>
2241 </stripe>
2242
2243 <stripe varset="ts_wait_type" variants="TS_WAIT_ONCHIP">
2244 <reg32 offset="1" name="ONCHIP_ADDR_0" low="0" high="31"/>
2245 </stripe>
2246
2247 <reg32 offset="3" name="SRC_0"/>
2248 <reg32 offset="4" name="SRC_1"/>
2249 </domain>
2250
2251 <domain name="CP_BV_BR_COUNT_OPS" width="32">
2252 <enum name="pipe_count_op">
2253 <value name="PIPE_CLEAR_BV_BR" value="0x1"/>
2254 <value name="PIPE_SET_BR_OFFSET" value="0x2"/>
2255 <!-- Wait until for BV_counter > BR_counter -->
2256 <value name="PIPE_BR_WAIT_FOR_BV" value="0x3"/>
2257 <!-- Wait until (BR_counter + BR_OFFSET) > BV_counter -->
2258 <value name="PIPE_BV_WAIT_FOR_BR" value="0x4"/>
2259 </enum>
2260 <reg32 offset="0" name="0">
2261 <bitfield name="OP" low="0" high="3" type="pipe_count_op"/>
2262 </reg32>
2263 <reg32 offset="1" name="1">
2264 <bitfield name="BR_OFFSET" low="0" high="15" type="uint"/>
2265 </reg32>
2266 </domain>
2267
2268 <domain name="CP_MODIFY_TIMESTAMP" width="32">
2269 <enum name="timestamp_op">
2270 <value name="MODIFY_TIMESTAMP_CLEAR" value="0"/>
2271 <value name="MODIFY_TIMESTAMP_ADD_GLOBAL" value="1"/>
2272 <value name="MODIFY_TIMESTAMP_ADD_LOCAL" value="2"/>
2273 </enum>
2274 <reg32 offset="0" name="0">
2275 <bitfield name="ADD" low="0" high="7" type="uint"/>
2276 <bitfield name="OP" low="28" high="31" type="timestamp_op"/>
2277 </reg32>
2278 </domain>
2279
2280 <domain name="CP_MEM_TO_SCRATCH_MEM" width="32">
2281 <doc>
2282 Best guess is that it is a faster way to fetch all the VSC_CHANNEL_VISIBILITY registers
2283 and keep them in a local scratch memory instead of fetching every time
2284 when skipping IBs.
2285 </doc>
2286 <reg32 offset="0" name="0">
2287 <bitfield name="CNT" low="0" high="5" type="uint"/>
2288 </reg32>
2289 <reg32 offset="1" name="1">
2290 <doc>Scratch memory size is 48 dwords`</doc>
2291 <bitfield name="OFFSET" low="0" high="5" type="uint"/>
2292 </reg32>
2293 <reg32 offset="2" name="2">
2294 <bitfield name="SRC" low="0" high="31"/>
2295 </reg32>
2296 <reg32 offset="3" name="3">
2297 <bitfield name="SRC_HI" low="0" high="31"/>
2298 </reg32>
2299 </domain>
2300
2301 <domain name="CP_THREAD_CONTROL" width="32">
2302 <enum name="cp_thread">
2303 <value name="CP_SET_THREAD_BR" value="1"/> <!-- Render -->
2304 <value name="CP_SET_THREAD_BV" value="2"/> <!-- Visibility -->
2305 <value name="CP_SET_THREAD_BOTH" value="3"/>
2306 </enum>
2307 <reg32 offset="0" name="0">
2308 <bitfield low="0" high="1" name="THREAD" type="cp_thread"/>
2309 <bitfield pos="27" name="CONCURRENT_BIN_DISABLE" type="boolean"/>
2310 <bitfield pos="31" name="SYNC_THREADS" type="boolean"/>
2311 </reg32>
2312 </domain>
2313
2314 <domain name="CP_FIXED_STRIDE_DRAW_TABLE" width="32">
2315 <reg64 offset="0" name="IB_BASE"/>
2316 <reg32 offset="2" name="2">
2317 <!-- STRIDE * COUNT -->
2318 <bitfield name="IB_SIZE" low="0" high="11"/>
2319 <bitfield name="STRIDE" low="20" high="31"/>
2320 </reg32>
2321 <reg32 offset="3" name="3">
2322 <bitfield name="COUNT" low="0" high="31"/>
2323 </reg32>
2324 </domain>
2325
2326 <domain name="CP_RESET_CONTEXT_STATE" width="32">
2327 <reg32 offset="0" name="0">
2328 <bitfield name="CLEAR_ON_CHIP_TS" pos="0" type="boolean"/>
2329 <bitfield name="CLEAR_RESOURCE_TABLE" pos="1" type="boolean"/>
2330 <bitfield name="CLEAR_BV_BR_COUNTER" pos="2" type="boolean"/>
2331 <bitfield name="RESET_GLOBAL_LOCAL_TS" pos="3" type="boolean"/>
2332 </reg32>
2333 </domain>
2334
2335 <domain name="CP_SCOPE_CNTL" width="32">
2336 <enum name="cp_scope">
2337 <value value="0" name="INTERRUPTS"/>
2338 </enum>
2339 <reg32 offset="0" name="0">
2340 <bitfield name="DISABLE_PREEMPTION" pos="0" type="boolean"/>
2341 <bitfield low="28" high="31" name="SCOPE" type="cp_scope"/>
2342 </reg32>
2343 </domain>
2344
2345 <domain name="CP_INDIRECT_BUFFER" width="32" varset="chip" prefix="chip" variants="A5XX-">
2346 <reg64 offset="0" name="IB_BASE" type="address"/>
2347 <reg32 offset="2" name="2">
2348 <bitfield name="IB_SIZE" low="0" high="19"/>
2349 </reg32>
2350 </domain>
2351
2352 <domain name="CP_RESOURCE_LIST" width="32">
2353 <doc>
2354 A7xx introduces the "resource table" which is managed by
2355 CP_RESOURCE_LIST. It is used to synchronize BR and BV access
2356 to resources such as LRZ buffers.
2357
2358 The resource table consists of resources that are in-use by BR.
2359 Each "resource" has a base address, which is
2360 usually a pointer but is treated by the HW as an opaque handle,
2361 a read/write bit, and a timestamp when it was last used.
2362 Resources are removed from the table upon event completion when
2363 a special CP_EVENT_WRITE::CLEAR_RENDER_RESOURCE bit is set, which
2364 will remove all resources with a timestamp up to the current
2365 timestamp.
2366
2367 CP_RESOURCE_LIST first specifies a list of BV resources. For
2368 each BV resource, the HW will check if there is a corresponding
2369 BR resource in the table, and if at least one of the BV and BR
2370 resources is marked WRITE then it will stall until the BR
2371 resource is removed.
2372
2373 It then specifies a list of BR resources. These will be added to
2374 the resource table, unless there is an overflow in which case
2375 the designated overflow register will have bit 0 set. Overflow
2376 should cause the next binning pass to stall until BR is done,
2377 effectively disabling concurrent binning.
2378
2379 CP_RESOURCE_LIST must be executed by BV. BR resources are added
2380 by BV and removed by BR.
2381
2382 There is a separate table for "LRZ resources." These behave a
2383 bit differently: specifying an LRZ resource via BV_RES_LRZ
2384 stalls on any matching resource existing and then adds it to the
2385 table, making it both a BV and BR resource in one. There is a
2386 separate CLEAR_LRZ_RESOURCE bit for removing resources from the
2387 LRZ table, and it only removes one resource given by a base
2388 address passed to CP_EVENT_WRITE. Therefore timestamps are
2389 unnecessary.
2390 </doc>
2391 <reg32 offset="0" name="BV_COUNT" type="uint"/>
2392 <doc>
2393 What follows is a list of CP_BV_RESOURCE and then CP_RESOURCE_LIST_BR.
2394 </doc>
2395 </domain>
2396
2397 <domain name="CP_BV_RESOURCE" width="32">
2398 <doc>
2399 BV resources don't go in the table. Instead CP waits until any
2400 corresponding BR resources with the same base pointer are
2401 finished before the packet completes.
2402 </doc>
2403 <enum name="cp_bv_resource_encoding">
2404 <value value="0" name="BV_RES_DIRECT"/>
2405 <doc>
2406 INDIRECT resources are encoded as a 32b offset + 3b
2407 bindless base selector. The offset is added to the given
2408 BINDLESS_BASE pseudoregister and then the 64b value
2409 fetched there is used as the pointer.
2410 </doc>
2411 <value value="1" name="BV_RES_INDIRECT_READ"/>
2412 <value value="2" name="BV_RES_LRZ"/>
2413 <value value="3" name="BV_RES_INDIRECT_WRITE"/>
2414 </enum>
2415 <reg64 offset="0" name="0">
2416 <bitfield name="BASE_ADDR" low="1" high="61" shr="1" type="address"/>
2417 <bitfield name="WRITE" pos="0" type="boolean"/>
2418 <bitfield name="ENCODING" low="62" high="63" type="cp_bv_resource_encoding"/>
2419 </reg64>
2420 </domain>
2421
2422 <domain name="CP_RESOURCE_LIST_BR" width="32">
2423 <reg32 offset="0" name="0">
2424 <bitfield name="BR_COUNT" low="0" high="23" type="uint"/>
2425 <bitfield name="OVERFLOW_ONCHIP_ADDR" low="24" high="26"/>
2426 <bitfield name="OVERFLOW" pos="31" type="boolean"/>
2427 </reg32>
2428 <doc>
2429 What follows is a list of CP_BR_RESOURCE.
2430 </doc>
2431 </domain>
2432
2433 <domain name="CP_BR_RESOURCE" width="32">
2434 <enum name="cp_br_resource_encoding">
2435 <value value="0" name="BR_RES_DIRECT"/>
2436 <value value="2" name="BR_RES_INDIRECT_READ"/>
2437 <value value="3" name="BR_RES_INDIRECT_WRITE"/> <!-- set WRITE bit -->
2438 </enum>
2439 <reg64 offset="0" name="0">
2440 <bitfield name="BASE_ADDR" low="1" high="61" shr="1" type="address"/>
2441 <bitfield name="WRITE" pos="0" type="boolean"/>
2442 <bitfield name="ENCODING" low="62" high="63" type="cp_br_resource_encoding"/>
2443 </reg64>
2444 </domain>
2445
2446 </database>
2447