1 /*
2  Copyright (C) Intel Corp.  2006.  All Rights Reserved.
3  Intel funded Tungsten Graphics to
4  develop this 3D driver.
5 
6  Permission is hereby granted, free of charge, to any person obtaining
7  a copy of this software and associated documentation files (the
8  "Software"), to deal in the Software without restriction, including
9  without limitation the rights to use, copy, modify, merge, publish,
10  distribute, sublicense, and/or sell copies of the Software, and to
11  permit persons to whom the Software is furnished to do so, subject to
12  the following conditions:
13 
14  The above copyright notice and this permission notice (including the
15  next paragraph) shall be included in all copies or substantial
16  portions of the Software.
17 
18  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
19  EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
20  MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
21  IN NO EVENT SHALL THE COPYRIGHT OWNER(S) AND/OR ITS SUPPLIERS BE
22  LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
23  OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
24  WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
25 
26  **********************************************************************/
27  /*
28   * Authors:
29   *   Keith Whitwell <keithw@vmware.com>
30   */
31 
32 #ifndef BRW_EU_DEFINES_H
33 #define BRW_EU_DEFINES_H
34 
35 #include <stdint.h>
36 #include <stdlib.h>
37 #include "util/macros.h"
38 
39 /* The following hunk, up-to "Execution Unit" is used by both the
40  * intel/compiler and i965 codebase. */
41 
42 #define INTEL_MASK(high, low) (((1u<<((high)-(low)+1))-1)<<(low))
43 /* Using the GNU statement expression extension */
44 #define SET_FIELD(value, field)                                         \
45    ({                                                                   \
46       uint32_t fieldval = (uint32_t)(value) << field ## _SHIFT;         \
47       assert((fieldval & ~ field ## _MASK) == 0);                       \
48       fieldval & field ## _MASK;                                        \
49    })
50 
51 #define SET_BITS(value, high, low)                                      \
52    ({                                                                   \
53       const uint32_t fieldval = (uint32_t)(value) << (low);             \
54       assert((fieldval & ~INTEL_MASK(high, low)) == 0);                 \
55       fieldval & INTEL_MASK(high, low);                                 \
56    })
57 
58 #define GET_BITS(data, high, low) ((data & INTEL_MASK((high), (low))) >> (low))
59 #define GET_FIELD(word, field) (((word)  & field ## _MASK) >> field ## _SHIFT)
60 
61 #define _3DPRIM_POINTLIST         0x01
62 #define _3DPRIM_LINELIST          0x02
63 #define _3DPRIM_LINESTRIP         0x03
64 #define _3DPRIM_TRILIST           0x04
65 #define _3DPRIM_TRISTRIP          0x05
66 #define _3DPRIM_TRIFAN            0x06
67 #define _3DPRIM_QUADLIST          0x07
68 #define _3DPRIM_QUADSTRIP         0x08
69 #define _3DPRIM_LINELIST_ADJ      0x09 /* G45+ */
70 #define _3DPRIM_LINESTRIP_ADJ     0x0A /* G45+ */
71 #define _3DPRIM_TRILIST_ADJ       0x0B /* G45+ */
72 #define _3DPRIM_TRISTRIP_ADJ      0x0C /* G45+ */
73 #define _3DPRIM_TRISTRIP_REVERSE  0x0D
74 #define _3DPRIM_POLYGON           0x0E
75 #define _3DPRIM_RECTLIST          0x0F
76 #define _3DPRIM_LINELOOP          0x10
77 #define _3DPRIM_POINTLIST_BF      0x11
78 #define _3DPRIM_LINESTRIP_CONT    0x12
79 #define _3DPRIM_LINESTRIP_BF      0x13
80 #define _3DPRIM_LINESTRIP_CONT_BF 0x14
81 #define _3DPRIM_TRIFAN_NOSTIPPLE  0x16
82 #define _3DPRIM_PATCHLIST(n) ({ assert(n > 0 && n <= 32); 0x20 + (n - 1); })
83 
84 /* Bitfields for the URB_WRITE message, DW2 of message header: */
85 #define URB_WRITE_PRIM_END		0x1
86 #define URB_WRITE_PRIM_START		0x2
87 #define URB_WRITE_PRIM_TYPE_SHIFT	2
88 
89 #define BRW_SPRITE_POINT_ENABLE  16
90 
91 # define GEN7_GS_CONTROL_DATA_FORMAT_GSCTL_CUT		0
92 # define GEN7_GS_CONTROL_DATA_FORMAT_GSCTL_SID		1
93 
94 /* Execution Unit (EU) defines
95  */
96 
97 #define BRW_ALIGN_1   0
98 #define BRW_ALIGN_16  1
99 
100 #define BRW_ADDRESS_DIRECT                        0
101 #define BRW_ADDRESS_REGISTER_INDIRECT_REGISTER    1
102 
103 #define BRW_CHANNEL_X     0
104 #define BRW_CHANNEL_Y     1
105 #define BRW_CHANNEL_Z     2
106 #define BRW_CHANNEL_W     3
107 
108 enum brw_compression {
109    BRW_COMPRESSION_NONE       = 0,
110    BRW_COMPRESSION_2NDHALF    = 1,
111    BRW_COMPRESSION_COMPRESSED = 2,
112 };
113 
114 #define GEN6_COMPRESSION_1Q		0
115 #define GEN6_COMPRESSION_2Q		1
116 #define GEN6_COMPRESSION_3Q		2
117 #define GEN6_COMPRESSION_4Q		3
118 #define GEN6_COMPRESSION_1H		0
119 #define GEN6_COMPRESSION_2H		2
120 
121 enum PACKED brw_conditional_mod {
122    BRW_CONDITIONAL_NONE = 0,
123    BRW_CONDITIONAL_Z    = 1,
124    BRW_CONDITIONAL_NZ   = 2,
125    BRW_CONDITIONAL_EQ   = 1,	/* Z */
126    BRW_CONDITIONAL_NEQ  = 2,	/* NZ */
127    BRW_CONDITIONAL_G    = 3,
128    BRW_CONDITIONAL_GE   = 4,
129    BRW_CONDITIONAL_L    = 5,
130    BRW_CONDITIONAL_LE   = 6,
131    BRW_CONDITIONAL_R    = 7,    /* Gen <= 5 */
132    BRW_CONDITIONAL_O    = 8,
133    BRW_CONDITIONAL_U    = 9,
134 };
135 
136 #define BRW_DEBUG_NONE        0
137 #define BRW_DEBUG_BREAKPOINT  1
138 
139 #define BRW_DEPENDENCY_NORMAL         0
140 #define BRW_DEPENDENCY_NOTCLEARED     1
141 #define BRW_DEPENDENCY_NOTCHECKED     2
142 #define BRW_DEPENDENCY_DISABLE        3
143 
144 enum PACKED brw_execution_size {
145    BRW_EXECUTE_1  = 0,
146    BRW_EXECUTE_2  = 1,
147    BRW_EXECUTE_4  = 2,
148    BRW_EXECUTE_8  = 3,
149    BRW_EXECUTE_16 = 4,
150    BRW_EXECUTE_32 = 5,
151 };
152 
153 enum PACKED brw_horizontal_stride {
154    BRW_HORIZONTAL_STRIDE_0 = 0,
155    BRW_HORIZONTAL_STRIDE_1 = 1,
156    BRW_HORIZONTAL_STRIDE_2 = 2,
157    BRW_HORIZONTAL_STRIDE_4 = 3,
158 };
159 
160 enum PACKED gen10_align1_3src_src_horizontal_stride {
161    BRW_ALIGN1_3SRC_SRC_HORIZONTAL_STRIDE_0 = 0,
162    BRW_ALIGN1_3SRC_SRC_HORIZONTAL_STRIDE_1 = 1,
163    BRW_ALIGN1_3SRC_SRC_HORIZONTAL_STRIDE_2 = 2,
164    BRW_ALIGN1_3SRC_SRC_HORIZONTAL_STRIDE_4 = 3,
165 };
166 
167 enum PACKED gen10_align1_3src_dst_horizontal_stride {
168    BRW_ALIGN1_3SRC_DST_HORIZONTAL_STRIDE_1 = 0,
169    BRW_ALIGN1_3SRC_DST_HORIZONTAL_STRIDE_2 = 1,
170 };
171 
172 #define BRW_INSTRUCTION_NORMAL    0
173 #define BRW_INSTRUCTION_SATURATE  1
174 
175 #define BRW_MASK_ENABLE   0
176 #define BRW_MASK_DISABLE  1
177 
178 /** @{
179  *
180  * Gen6 has replaced "mask enable/disable" with WECtrl, which is
181  * effectively the same but much simpler to think about.  Now, there
182  * are two contributors ANDed together to whether channels are
183  * executed: The predication on the instruction, and the channel write
184  * enable.
185  */
186 /**
187  * This is the default value.  It means that a channel's write enable is set
188  * if the per-channel IP is pointing at this instruction.
189  */
190 #define BRW_WE_NORMAL		0
191 /**
192  * This is used like BRW_MASK_DISABLE, and causes all channels to have
193  * their write enable set.  Note that predication still contributes to
194  * whether the channel actually gets written.
195  */
196 #define BRW_WE_ALL		1
197 /** @} */
198 
199 enum opcode {
200    /* These are the actual hardware instructions. */
201    BRW_OPCODE_ILLEGAL,
202    BRW_OPCODE_SYNC,
203    BRW_OPCODE_MOV,
204    BRW_OPCODE_SEL,
205    BRW_OPCODE_MOVI, /**< G45+ */
206    BRW_OPCODE_NOT,
207    BRW_OPCODE_AND,
208    BRW_OPCODE_OR,
209    BRW_OPCODE_XOR,
210    BRW_OPCODE_SHR,
211    BRW_OPCODE_SHL,
212    BRW_OPCODE_DIM, /**< Gen7.5 only */
213    BRW_OPCODE_SMOV, /**< Gen8+ */
214    BRW_OPCODE_ASR,
215    BRW_OPCODE_ROR,  /**< Gen11+ */
216    BRW_OPCODE_ROL,  /**< Gen11+ */
217    BRW_OPCODE_CMP,
218    BRW_OPCODE_CMPN,
219    BRW_OPCODE_CSEL, /**< Gen8+ */
220    BRW_OPCODE_F32TO16, /**< Gen7 only */
221    BRW_OPCODE_F16TO32, /**< Gen7 only */
222    BRW_OPCODE_BFREV, /**< Gen7+ */
223    BRW_OPCODE_BFE, /**< Gen7+ */
224    BRW_OPCODE_BFI1, /**< Gen7+ */
225    BRW_OPCODE_BFI2, /**< Gen7+ */
226    BRW_OPCODE_JMPI,
227    BRW_OPCODE_BRD, /**< Gen7+ */
228    BRW_OPCODE_IF,
229    BRW_OPCODE_IFF, /**< Pre-Gen6 */
230    BRW_OPCODE_BRC, /**< Gen7+ */
231    BRW_OPCODE_ELSE,
232    BRW_OPCODE_ENDIF,
233    BRW_OPCODE_DO, /**< Pre-Gen6 */
234    BRW_OPCODE_CASE, /**< Gen6 only */
235    BRW_OPCODE_WHILE,
236    BRW_OPCODE_BREAK,
237    BRW_OPCODE_CONTINUE,
238    BRW_OPCODE_HALT,
239    BRW_OPCODE_CALLA, /**< Gen7.5+ */
240    BRW_OPCODE_MSAVE, /**< Pre-Gen6 */
241    BRW_OPCODE_CALL, /**< Gen6+ */
242    BRW_OPCODE_MREST, /**< Pre-Gen6 */
243    BRW_OPCODE_RET, /**< Gen6+ */
244    BRW_OPCODE_PUSH, /**< Pre-Gen6 */
245    BRW_OPCODE_FORK, /**< Gen6 only */
246    BRW_OPCODE_GOTO, /**< Gen8+ */
247    BRW_OPCODE_POP, /**< Pre-Gen6 */
248    BRW_OPCODE_WAIT,
249    BRW_OPCODE_SEND,
250    BRW_OPCODE_SENDC,
251    BRW_OPCODE_SENDS, /**< Gen9+ */
252    BRW_OPCODE_SENDSC, /**< Gen9+ */
253    BRW_OPCODE_MATH, /**< Gen6+ */
254    BRW_OPCODE_ADD,
255    BRW_OPCODE_MUL,
256    BRW_OPCODE_AVG,
257    BRW_OPCODE_FRC,
258    BRW_OPCODE_RNDU,
259    BRW_OPCODE_RNDD,
260    BRW_OPCODE_RNDE,
261    BRW_OPCODE_RNDZ,
262    BRW_OPCODE_MAC,
263    BRW_OPCODE_MACH,
264    BRW_OPCODE_LZD,
265    BRW_OPCODE_FBH, /**< Gen7+ */
266    BRW_OPCODE_FBL, /**< Gen7+ */
267    BRW_OPCODE_CBIT, /**< Gen7+ */
268    BRW_OPCODE_ADDC, /**< Gen7+ */
269    BRW_OPCODE_SUBB, /**< Gen7+ */
270    BRW_OPCODE_SAD2,
271    BRW_OPCODE_SADA2,
272    BRW_OPCODE_DP4,
273    BRW_OPCODE_DPH,
274    BRW_OPCODE_DP3,
275    BRW_OPCODE_DP2,
276    BRW_OPCODE_LINE,
277    BRW_OPCODE_PLN, /**< G45+ */
278    BRW_OPCODE_MAD, /**< Gen6+ */
279    BRW_OPCODE_LRP, /**< Gen6+ */
280    BRW_OPCODE_MADM, /**< Gen8+ */
281    BRW_OPCODE_NENOP, /**< G45 only */
282    BRW_OPCODE_NOP,
283 
284    NUM_BRW_OPCODES,
285 
286    /* These are compiler backend opcodes that get translated into other
287     * instructions.
288     */
289    FS_OPCODE_FB_WRITE = NUM_BRW_OPCODES,
290 
291    /**
292     * Same as FS_OPCODE_FB_WRITE but expects its arguments separately as
293     * individual sources instead of as a single payload blob. The
294     * position/ordering of the arguments are defined by the enum
295     * fb_write_logical_srcs.
296     */
297    FS_OPCODE_FB_WRITE_LOGICAL,
298 
299    FS_OPCODE_REP_FB_WRITE,
300 
301    FS_OPCODE_FB_READ,
302    FS_OPCODE_FB_READ_LOGICAL,
303 
304    SHADER_OPCODE_RCP,
305    SHADER_OPCODE_RSQ,
306    SHADER_OPCODE_SQRT,
307    SHADER_OPCODE_EXP2,
308    SHADER_OPCODE_LOG2,
309    SHADER_OPCODE_POW,
310    SHADER_OPCODE_INT_QUOTIENT,
311    SHADER_OPCODE_INT_REMAINDER,
312    SHADER_OPCODE_SIN,
313    SHADER_OPCODE_COS,
314 
315    /**
316     * A generic "send" opcode.  The first two sources are the message
317     * descriptor and extended message descriptor respectively.  The third
318     * and optional fourth sources are the message payload
319     */
320    SHADER_OPCODE_SEND,
321 
322    /**
323     * An "undefined" write which does nothing but indicates to liveness that
324     * we don't care about any values in the register which predate this
325     * instruction.  Used to prevent partial writes from causing issues with
326     * live ranges.
327     */
328    SHADER_OPCODE_UNDEF,
329 
330    /**
331     * Texture sampling opcodes.
332     *
333     * LOGICAL opcodes are eventually translated to the matching non-LOGICAL
334     * opcode but instead of taking a single payload blob they expect their
335     * arguments separately as individual sources. The position/ordering of the
336     * arguments are defined by the enum tex_logical_srcs.
337     */
338    SHADER_OPCODE_TEX,
339    SHADER_OPCODE_TEX_LOGICAL,
340    SHADER_OPCODE_TXD,
341    SHADER_OPCODE_TXD_LOGICAL,
342    SHADER_OPCODE_TXF,
343    SHADER_OPCODE_TXF_LOGICAL,
344    SHADER_OPCODE_TXF_LZ,
345    SHADER_OPCODE_TXL,
346    SHADER_OPCODE_TXL_LOGICAL,
347    SHADER_OPCODE_TXL_LZ,
348    SHADER_OPCODE_TXS,
349    SHADER_OPCODE_TXS_LOGICAL,
350    FS_OPCODE_TXB,
351    FS_OPCODE_TXB_LOGICAL,
352    SHADER_OPCODE_TXF_CMS,
353    SHADER_OPCODE_TXF_CMS_LOGICAL,
354    SHADER_OPCODE_TXF_CMS_W,
355    SHADER_OPCODE_TXF_CMS_W_LOGICAL,
356    SHADER_OPCODE_TXF_UMS,
357    SHADER_OPCODE_TXF_UMS_LOGICAL,
358    SHADER_OPCODE_TXF_MCS,
359    SHADER_OPCODE_TXF_MCS_LOGICAL,
360    SHADER_OPCODE_LOD,
361    SHADER_OPCODE_LOD_LOGICAL,
362    SHADER_OPCODE_TG4,
363    SHADER_OPCODE_TG4_LOGICAL,
364    SHADER_OPCODE_TG4_OFFSET,
365    SHADER_OPCODE_TG4_OFFSET_LOGICAL,
366    SHADER_OPCODE_SAMPLEINFO,
367    SHADER_OPCODE_SAMPLEINFO_LOGICAL,
368 
369    SHADER_OPCODE_IMAGE_SIZE_LOGICAL,
370 
371    /**
372     * Combines multiple sources of size 1 into a larger virtual GRF.
373     * For example, parameters for a send-from-GRF message.  Or, updating
374     * channels of a size 4 VGRF used to store vec4s such as texturing results.
375     *
376     * This will be lowered into MOVs from each source to consecutive offsets
377     * of the destination VGRF.
378     *
379     * src[0] may be BAD_FILE.  If so, the lowering pass skips emitting the MOV,
380     * but still reserves the first channel of the destination VGRF.  This can be
381     * used to reserve space for, say, a message header set up by the generators.
382     */
383    SHADER_OPCODE_LOAD_PAYLOAD,
384 
385    /**
386     * Packs a number of sources into a single value. Unlike LOAD_PAYLOAD, this
387     * acts intra-channel, obtaining the final value for each channel by
388     * combining the sources values for the same channel, the first source
389     * occupying the lowest bits and the last source occupying the highest
390     * bits.
391     */
392    FS_OPCODE_PACK,
393 
394    SHADER_OPCODE_SHADER_TIME_ADD,
395 
396    /**
397     * Typed and untyped surface access opcodes.
398     *
399     * LOGICAL opcodes are eventually translated to the matching non-LOGICAL
400     * opcode but instead of taking a single payload blob they expect their
401     * arguments separately as individual sources:
402     *
403     * Source 0: [required] Surface coordinates.
404     * Source 1: [optional] Operation source.
405     * Source 2: [required] Surface index.
406     * Source 3: [required] Number of coordinate components (as UD immediate).
407     * Source 4: [required] Opcode-specific control immediate, same as source 2
408     *                      of the matching non-LOGICAL opcode.
409     */
410    VEC4_OPCODE_UNTYPED_ATOMIC,
411    SHADER_OPCODE_UNTYPED_ATOMIC_LOGICAL,
412    SHADER_OPCODE_UNTYPED_ATOMIC_FLOAT_LOGICAL,
413    VEC4_OPCODE_UNTYPED_SURFACE_READ,
414    SHADER_OPCODE_UNTYPED_SURFACE_READ_LOGICAL,
415    VEC4_OPCODE_UNTYPED_SURFACE_WRITE,
416    SHADER_OPCODE_UNTYPED_SURFACE_WRITE_LOGICAL,
417 
418    /**
419     * Untyped A64 surface access opcodes.
420     *
421     * Source 0: 64-bit address
422     * Source 1: Operational source
423     * Source 2: [required] Opcode-specific control immediate, same as source 2
424     *                      of the matching non-LOGICAL opcode.
425     */
426    SHADER_OPCODE_A64_UNTYPED_READ_LOGICAL,
427    SHADER_OPCODE_A64_UNTYPED_WRITE_LOGICAL,
428    SHADER_OPCODE_A64_BYTE_SCATTERED_READ_LOGICAL,
429    SHADER_OPCODE_A64_BYTE_SCATTERED_WRITE_LOGICAL,
430    SHADER_OPCODE_A64_UNTYPED_ATOMIC_LOGICAL,
431    SHADER_OPCODE_A64_UNTYPED_ATOMIC_INT64_LOGICAL,
432    SHADER_OPCODE_A64_UNTYPED_ATOMIC_FLOAT_LOGICAL,
433 
434    SHADER_OPCODE_TYPED_ATOMIC_LOGICAL,
435    SHADER_OPCODE_TYPED_SURFACE_READ_LOGICAL,
436    SHADER_OPCODE_TYPED_SURFACE_WRITE_LOGICAL,
437 
438    SHADER_OPCODE_RND_MODE,
439    SHADER_OPCODE_FLOAT_CONTROL_MODE,
440 
441    /**
442     * Byte scattered write/read opcodes.
443     *
444     * LOGICAL opcodes are eventually translated to the matching non-LOGICAL
445     * opcode, but instead of taking a single payload blog they expect their
446     * arguments separately as individual sources, like untyped write/read.
447     */
448    SHADER_OPCODE_BYTE_SCATTERED_READ_LOGICAL,
449    SHADER_OPCODE_BYTE_SCATTERED_WRITE_LOGICAL,
450    SHADER_OPCODE_DWORD_SCATTERED_READ_LOGICAL,
451    SHADER_OPCODE_DWORD_SCATTERED_WRITE_LOGICAL,
452 
453    /**
454     * Memory fence messages.
455     *
456     * Source 0: Must be register g0, used as header.
457     * Source 1: Immediate bool to indicate whether control is returned to the
458     *           thread only after the fence has been honored.
459     * Source 2: Immediate byte indicating which memory to fence.  Zero means
460     *           global memory; GEN7_BTI_SLM means SLM (for Gen11+ only).
461     *
462     * Vec4 backend only uses Source 0.
463     */
464    SHADER_OPCODE_MEMORY_FENCE,
465 
466    /**
467     * Scheduling-only fence.
468     *
469     * Sources can be used to force a stall until the registers in those are
470     * available.  This might generate MOVs or SYNC_NOPs (Gen12+).
471     */
472    FS_OPCODE_SCHEDULING_FENCE,
473 
474    SHADER_OPCODE_GEN4_SCRATCH_READ,
475    SHADER_OPCODE_GEN4_SCRATCH_WRITE,
476    SHADER_OPCODE_GEN7_SCRATCH_READ,
477 
478    /**
479     * Gen8+ SIMD8 URB Read messages.
480     */
481    SHADER_OPCODE_URB_READ_SIMD8,
482    SHADER_OPCODE_URB_READ_SIMD8_PER_SLOT,
483 
484    SHADER_OPCODE_URB_WRITE_SIMD8,
485    SHADER_OPCODE_URB_WRITE_SIMD8_PER_SLOT,
486    SHADER_OPCODE_URB_WRITE_SIMD8_MASKED,
487    SHADER_OPCODE_URB_WRITE_SIMD8_MASKED_PER_SLOT,
488 
489    /**
490     * Return the index of an arbitrary live channel (i.e. one of the channels
491     * enabled in the current execution mask) and assign it to the first
492     * component of the destination.  Expected to be used as input for the
493     * BROADCAST pseudo-opcode.
494     */
495    SHADER_OPCODE_FIND_LIVE_CHANNEL,
496 
497    /**
498     * Return the current execution mask in the specified flag subregister.
499     * Can be CSE'ed more easily than a plain MOV from the ce0 ARF register.
500     */
501    FS_OPCODE_LOAD_LIVE_CHANNELS,
502 
503    /**
504     * Pick the channel from its first source register given by the index
505     * specified as second source.  Useful for variable indexing of surfaces.
506     *
507     * Note that because the result of this instruction is by definition
508     * uniform and it can always be splatted to multiple channels using a
509     * scalar regioning mode, only the first channel of the destination region
510     * is guaranteed to be updated, which implies that BROADCAST instructions
511     * should usually be marked force_writemask_all.
512     */
513    SHADER_OPCODE_BROADCAST,
514 
515    /* Pick the channel from its first source register given by the index
516     * specified as second source.
517     *
518     * This is similar to the BROADCAST instruction except that it takes a
519     * dynamic index and potentially puts a different value in each output
520     * channel.
521     */
522    SHADER_OPCODE_SHUFFLE,
523 
524    /* Select between src0 and src1 based on channel enables.
525     *
526     * This instruction copies src0 into the enabled channels of the
527     * destination and copies src1 into the disabled channels.
528     */
529    SHADER_OPCODE_SEL_EXEC,
530 
531    /* This turns into an align16 mov from src0 to dst with a swizzle
532     * provided as an immediate in src1.
533     */
534    SHADER_OPCODE_QUAD_SWIZZLE,
535 
536    /* Take every Nth element in src0 and broadcast it to the group of N
537     * channels in which it lives in the destination.  The offset within the
538     * cluster is given by src1 and the cluster size is given by src2.
539     */
540    SHADER_OPCODE_CLUSTER_BROADCAST,
541 
542    SHADER_OPCODE_GET_BUFFER_SIZE,
543 
544    SHADER_OPCODE_INTERLOCK,
545 
546    VEC4_OPCODE_MOV_BYTES,
547    VEC4_OPCODE_PACK_BYTES,
548    VEC4_OPCODE_UNPACK_UNIFORM,
549    VEC4_OPCODE_DOUBLE_TO_F32,
550    VEC4_OPCODE_DOUBLE_TO_D32,
551    VEC4_OPCODE_DOUBLE_TO_U32,
552    VEC4_OPCODE_TO_DOUBLE,
553    VEC4_OPCODE_PICK_LOW_32BIT,
554    VEC4_OPCODE_PICK_HIGH_32BIT,
555    VEC4_OPCODE_SET_LOW_32BIT,
556    VEC4_OPCODE_SET_HIGH_32BIT,
557 
558    FS_OPCODE_DDX_COARSE,
559    FS_OPCODE_DDX_FINE,
560    /**
561     * Compute dFdy(), dFdyCoarse(), or dFdyFine().
562     */
563    FS_OPCODE_DDY_COARSE,
564    FS_OPCODE_DDY_FINE,
565    FS_OPCODE_LINTERP,
566    FS_OPCODE_PIXEL_X,
567    FS_OPCODE_PIXEL_Y,
568    FS_OPCODE_UNIFORM_PULL_CONSTANT_LOAD,
569    FS_OPCODE_UNIFORM_PULL_CONSTANT_LOAD_GEN7,
570    FS_OPCODE_VARYING_PULL_CONSTANT_LOAD_GEN4,
571    FS_OPCODE_VARYING_PULL_CONSTANT_LOAD_LOGICAL,
572    FS_OPCODE_DISCARD_JUMP,
573    FS_OPCODE_SET_SAMPLE_ID,
574    FS_OPCODE_PACK_HALF_2x16_SPLIT,
575    FS_OPCODE_PLACEHOLDER_HALT,
576    FS_OPCODE_INTERPOLATE_AT_SAMPLE,
577    FS_OPCODE_INTERPOLATE_AT_SHARED_OFFSET,
578    FS_OPCODE_INTERPOLATE_AT_PER_SLOT_OFFSET,
579 
580    VS_OPCODE_URB_WRITE,
581    VS_OPCODE_PULL_CONSTANT_LOAD,
582    VS_OPCODE_PULL_CONSTANT_LOAD_GEN7,
583    VS_OPCODE_SET_SIMD4X2_HEADER_GEN9,
584 
585    VS_OPCODE_UNPACK_FLAGS_SIMD4X2,
586 
587    /**
588     * Write geometry shader output data to the URB.
589     *
590     * Unlike VS_OPCODE_URB_WRITE, this opcode doesn't do an implied move from
591     * R0 to the first MRF.  This allows the geometry shader to override the
592     * "Slot {0,1} Offset" fields in the message header.
593     */
594    GS_OPCODE_URB_WRITE,
595 
596    /**
597     * Write geometry shader output data to the URB and request a new URB
598     * handle (gen6).
599     *
600     * This opcode doesn't do an implied move from R0 to the first MRF.
601     */
602    GS_OPCODE_URB_WRITE_ALLOCATE,
603 
604    /**
605     * Terminate the geometry shader thread by doing an empty URB write.
606     *
607     * This opcode doesn't do an implied move from R0 to the first MRF.  This
608     * allows the geometry shader to override the "GS Number of Output Vertices
609     * for Slot {0,1}" fields in the message header.
610     */
611    GS_OPCODE_THREAD_END,
612 
613    /**
614     * Set the "Slot {0,1} Offset" fields of a URB_WRITE message header.
615     *
616     * - dst is the MRF containing the message header.
617     *
618     * - src0.x indicates which portion of the URB should be written to (e.g. a
619     *   vertex number)
620     *
621     * - src1 is an immediate multiplier which will be applied to src0
622     *   (e.g. the size of a single vertex in the URB).
623     *
624     * Note: the hardware will apply this offset *in addition to* the offset in
625     * vec4_instruction::offset.
626     */
627    GS_OPCODE_SET_WRITE_OFFSET,
628 
629    /**
630     * Set the "GS Number of Output Vertices for Slot {0,1}" fields of a
631     * URB_WRITE message header.
632     *
633     * - dst is the MRF containing the message header.
634     *
635     * - src0.x is the vertex count.  The upper 16 bits will be ignored.
636     */
637    GS_OPCODE_SET_VERTEX_COUNT,
638 
639    /**
640     * Set DWORD 2 of dst to the value in src.
641     */
642    GS_OPCODE_SET_DWORD_2,
643 
644    /**
645     * Prepare the dst register for storage in the "Channel Mask" fields of a
646     * URB_WRITE message header.
647     *
648     * DWORD 4 of dst is shifted left by 4 bits, so that later,
649     * GS_OPCODE_SET_CHANNEL_MASKS can OR DWORDs 0 and 4 together to form the
650     * final channel mask.
651     *
652     * Note: since GS_OPCODE_SET_CHANNEL_MASKS ORs DWORDs 0 and 4 together to
653     * form the final channel mask, DWORDs 0 and 4 of the dst register must not
654     * have any extraneous bits set prior to execution of this opcode (that is,
655     * they should be in the range 0x0 to 0xf).
656     */
657    GS_OPCODE_PREPARE_CHANNEL_MASKS,
658 
659    /**
660     * Set the "Channel Mask" fields of a URB_WRITE message header.
661     *
662     * - dst is the MRF containing the message header.
663     *
664     * - src.x is the channel mask, as prepared by
665     *   GS_OPCODE_PREPARE_CHANNEL_MASKS.  DWORDs 0 and 4 are OR'ed together to
666     *   form the final channel mask.
667     */
668    GS_OPCODE_SET_CHANNEL_MASKS,
669 
670    /**
671     * Get the "Instance ID" fields from the payload.
672     *
673     * - dst is the GRF for gl_InvocationID.
674     */
675    GS_OPCODE_GET_INSTANCE_ID,
676 
677    /**
678     * Send a FF_SYNC message to allocate initial URB handles (gen6).
679     *
680     * - dst will be used as the writeback register for the FF_SYNC operation.
681     *
682     * - src0 is the number of primitives written.
683     *
684     * - src1 is the value to hold in M0.0: number of SO vertices to write
685     *   and number of SO primitives needed. Its value will be overwritten
686     *   with the SVBI values if transform feedback is enabled.
687     *
688     * Note: This opcode uses an implicit MRF register for the ff_sync message
689     * header, so the caller is expected to set inst->base_mrf and initialize
690     * that MRF register to r0. This opcode will also write to this MRF register
691     * to include the allocated URB handle so it can then be reused directly as
692     * the header in the URB write operation we are allocating the handle for.
693     */
694    GS_OPCODE_FF_SYNC,
695 
696    /**
697     * Move r0.1 (which holds PrimitiveID information in gen6) to a separate
698     * register.
699     *
700     * - dst is the GRF where PrimitiveID information will be moved.
701     */
702    GS_OPCODE_SET_PRIMITIVE_ID,
703 
704    /**
705     * Write transform feedback data to the SVB by sending a SVB WRITE message.
706     * Used in gen6.
707     *
708     * - dst is the MRF register containing the message header.
709     *
710     * - src0 is the register where the vertex data is going to be copied from.
711     *
712     * - src1 is the destination register when write commit occurs.
713     */
714    GS_OPCODE_SVB_WRITE,
715 
716    /**
717     * Set destination index in the SVB write message payload (M0.5). Used
718     * in gen6 for transform feedback.
719     *
720     * - dst is the header to save the destination indices for SVB WRITE.
721     * - src is the register that holds the destination indices value.
722     */
723    GS_OPCODE_SVB_SET_DST_INDEX,
724 
725    /**
726     * Prepare Mx.0 subregister for being used in the FF_SYNC message header.
727     * Used in gen6 for transform feedback.
728     *
729     * - dst will hold the register with the final Mx.0 value.
730     *
731     * - src0 has the number of vertices emitted in SO (NumSOVertsToWrite)
732     *
733     * - src1 has the number of needed primitives for SO (NumSOPrimsNeeded)
734     *
735     * - src2 is the value to hold in M0: number of SO vertices to write
736     *   and number of SO primitives needed.
737     */
738    GS_OPCODE_FF_SYNC_SET_PRIMITIVES,
739 
740    /**
741     * Terminate the compute shader.
742     */
743    CS_OPCODE_CS_TERMINATE,
744 
745    /**
746     * GLSL barrier()
747     */
748    SHADER_OPCODE_BARRIER,
749 
750    /**
751     * Calculate the high 32-bits of a 32x32 multiply.
752     */
753    SHADER_OPCODE_MULH,
754 
755    /** Signed subtraction with saturation. */
756    SHADER_OPCODE_ISUB_SAT,
757 
758    /** Unsigned subtraction with saturation. */
759    SHADER_OPCODE_USUB_SAT,
760 
761    /**
762     * A MOV that uses VxH indirect addressing.
763     *
764     * Source 0: A register to start from (HW_REG).
765     * Source 1: An indirect offset (in bytes, UD GRF).
766     * Source 2: The length of the region that could be accessed (in bytes,
767     *           UD immediate).
768     */
769    SHADER_OPCODE_MOV_INDIRECT,
770 
771    VEC4_OPCODE_URB_READ,
772    TCS_OPCODE_GET_INSTANCE_ID,
773    TCS_OPCODE_URB_WRITE,
774    TCS_OPCODE_SET_INPUT_URB_OFFSETS,
775    TCS_OPCODE_SET_OUTPUT_URB_OFFSETS,
776    TCS_OPCODE_GET_PRIMITIVE_ID,
777    TCS_OPCODE_CREATE_BARRIER_HEADER,
778    TCS_OPCODE_SRC0_010_IS_ZERO,
779    TCS_OPCODE_RELEASE_INPUT,
780    TCS_OPCODE_THREAD_END,
781 
782    TES_OPCODE_GET_PRIMITIVE_ID,
783    TES_OPCODE_CREATE_INPUT_READ_HEADER,
784    TES_OPCODE_ADD_INDIRECT_URB_OFFSET,
785 };
786 
787 enum brw_urb_write_flags {
788    BRW_URB_WRITE_NO_FLAGS = 0,
789 
790    /**
791     * Causes a new URB entry to be allocated, and its address stored in the
792     * destination register (gen < 7).
793     */
794    BRW_URB_WRITE_ALLOCATE = 0x1,
795 
796    /**
797     * Causes the current URB entry to be deallocated (gen < 7).
798     */
799    BRW_URB_WRITE_UNUSED = 0x2,
800 
801    /**
802     * Causes the thread to terminate.
803     */
804    BRW_URB_WRITE_EOT = 0x4,
805 
806    /**
807     * Indicates that the given URB entry is complete, and may be sent further
808     * down the 3D pipeline (gen < 7).
809     */
810    BRW_URB_WRITE_COMPLETE = 0x8,
811 
812    /**
813     * Indicates that an additional offset (which may be different for the two
814     * vec4 slots) is stored in the message header (gen == 7).
815     */
816    BRW_URB_WRITE_PER_SLOT_OFFSET = 0x10,
817 
818    /**
819     * Indicates that the channel masks in the URB_WRITE message header should
820     * not be overridden to 0xff (gen == 7).
821     */
822    BRW_URB_WRITE_USE_CHANNEL_MASKS = 0x20,
823 
824    /**
825     * Indicates that the data should be sent to the URB using the
826     * URB_WRITE_OWORD message rather than URB_WRITE_HWORD (gen == 7).  This
827     * causes offsets to be interpreted as multiples of an OWORD instead of an
828     * HWORD, and only allows one OWORD to be written.
829     */
830    BRW_URB_WRITE_OWORD = 0x40,
831 
832    /**
833     * Convenient combination of flags: end the thread while simultaneously
834     * marking the given URB entry as complete.
835     */
836    BRW_URB_WRITE_EOT_COMPLETE = BRW_URB_WRITE_EOT | BRW_URB_WRITE_COMPLETE,
837 
838    /**
839     * Convenient combination of flags: mark the given URB entry as complete
840     * and simultaneously allocate a new one.
841     */
842    BRW_URB_WRITE_ALLOCATE_COMPLETE =
843       BRW_URB_WRITE_ALLOCATE | BRW_URB_WRITE_COMPLETE,
844 };
845 
846 enum fb_write_logical_srcs {
847    FB_WRITE_LOGICAL_SRC_COLOR0,      /* REQUIRED */
848    FB_WRITE_LOGICAL_SRC_COLOR1,      /* for dual source blend messages */
849    FB_WRITE_LOGICAL_SRC_SRC0_ALPHA,
850    FB_WRITE_LOGICAL_SRC_SRC_DEPTH,   /* gl_FragDepth */
851    FB_WRITE_LOGICAL_SRC_DST_DEPTH,   /* GEN4-5: passthrough from thread */
852    FB_WRITE_LOGICAL_SRC_SRC_STENCIL, /* gl_FragStencilRefARB */
853    FB_WRITE_LOGICAL_SRC_OMASK,       /* Sample Mask (gl_SampleMask) */
854    FB_WRITE_LOGICAL_SRC_COMPONENTS,  /* REQUIRED */
855    FB_WRITE_LOGICAL_NUM_SRCS
856 };
857 
858 enum tex_logical_srcs {
859    /** Texture coordinates */
860    TEX_LOGICAL_SRC_COORDINATE,
861    /** Shadow comparator */
862    TEX_LOGICAL_SRC_SHADOW_C,
863    /** dPdx if the operation takes explicit derivatives, otherwise LOD value */
864    TEX_LOGICAL_SRC_LOD,
865    /** dPdy if the operation takes explicit derivatives */
866    TEX_LOGICAL_SRC_LOD2,
867    /** Min LOD */
868    TEX_LOGICAL_SRC_MIN_LOD,
869    /** Sample index */
870    TEX_LOGICAL_SRC_SAMPLE_INDEX,
871    /** MCS data */
872    TEX_LOGICAL_SRC_MCS,
873    /** REQUIRED: Texture surface index */
874    TEX_LOGICAL_SRC_SURFACE,
875    /** Texture sampler index */
876    TEX_LOGICAL_SRC_SAMPLER,
877    /** Texture surface bindless handle */
878    TEX_LOGICAL_SRC_SURFACE_HANDLE,
879    /** Texture sampler bindless handle */
880    TEX_LOGICAL_SRC_SAMPLER_HANDLE,
881    /** Texel offset for gathers */
882    TEX_LOGICAL_SRC_TG4_OFFSET,
883    /** REQUIRED: Number of coordinate components (as UD immediate) */
884    TEX_LOGICAL_SRC_COORD_COMPONENTS,
885    /** REQUIRED: Number of derivative components (as UD immediate) */
886    TEX_LOGICAL_SRC_GRAD_COMPONENTS,
887 
888    TEX_LOGICAL_NUM_SRCS,
889 };
890 
891 enum surface_logical_srcs {
892    /** Surface binding table index */
893    SURFACE_LOGICAL_SRC_SURFACE,
894    /** Surface bindless handle */
895    SURFACE_LOGICAL_SRC_SURFACE_HANDLE,
896    /** Surface address; could be multi-dimensional for typed opcodes */
897    SURFACE_LOGICAL_SRC_ADDRESS,
898    /** Data to be written or used in an atomic op */
899    SURFACE_LOGICAL_SRC_DATA,
900    /** Surface number of dimensions.  Affects the size of ADDRESS */
901    SURFACE_LOGICAL_SRC_IMM_DIMS,
902    /** Per-opcode immediate argument.  For atomics, this is the atomic opcode */
903    SURFACE_LOGICAL_SRC_IMM_ARG,
904    /**
905     * Some instructions with side-effects should not be predicated on
906     * sample mask, e.g. lowered stores to scratch.
907     */
908    SURFACE_LOGICAL_SRC_ALLOW_SAMPLE_MASK,
909 
910    SURFACE_LOGICAL_NUM_SRCS
911 };
912 
913 #ifdef __cplusplus
914 /**
915  * Allow brw_urb_write_flags enums to be ORed together.
916  */
917 inline brw_urb_write_flags
918 operator|(brw_urb_write_flags x, brw_urb_write_flags y)
919 {
920    return static_cast<brw_urb_write_flags>(static_cast<int>(x) |
921                                            static_cast<int>(y));
922 }
923 #endif
924 
925 enum PACKED brw_predicate {
926    BRW_PREDICATE_NONE                =  0,
927    BRW_PREDICATE_NORMAL              =  1,
928    BRW_PREDICATE_ALIGN1_ANYV         =  2,
929    BRW_PREDICATE_ALIGN1_ALLV         =  3,
930    BRW_PREDICATE_ALIGN1_ANY2H        =  4,
931    BRW_PREDICATE_ALIGN1_ALL2H        =  5,
932    BRW_PREDICATE_ALIGN1_ANY4H        =  6,
933    BRW_PREDICATE_ALIGN1_ALL4H        =  7,
934    BRW_PREDICATE_ALIGN1_ANY8H        =  8,
935    BRW_PREDICATE_ALIGN1_ALL8H        =  9,
936    BRW_PREDICATE_ALIGN1_ANY16H       = 10,
937    BRW_PREDICATE_ALIGN1_ALL16H       = 11,
938    BRW_PREDICATE_ALIGN1_ANY32H       = 12,
939    BRW_PREDICATE_ALIGN1_ALL32H       = 13,
940    BRW_PREDICATE_ALIGN16_REPLICATE_X =  2,
941    BRW_PREDICATE_ALIGN16_REPLICATE_Y =  3,
942    BRW_PREDICATE_ALIGN16_REPLICATE_Z =  4,
943    BRW_PREDICATE_ALIGN16_REPLICATE_W =  5,
944    BRW_PREDICATE_ALIGN16_ANY4H       =  6,
945    BRW_PREDICATE_ALIGN16_ALL4H       =  7,
946 };
947 
948 enum PACKED brw_reg_file {
949    BRW_ARCHITECTURE_REGISTER_FILE = 0,
950    BRW_GENERAL_REGISTER_FILE      = 1,
951    BRW_MESSAGE_REGISTER_FILE      = 2,
952    BRW_IMMEDIATE_VALUE            = 3,
953 
954    ARF = BRW_ARCHITECTURE_REGISTER_FILE,
955    FIXED_GRF = BRW_GENERAL_REGISTER_FILE,
956    MRF = BRW_MESSAGE_REGISTER_FILE,
957    IMM = BRW_IMMEDIATE_VALUE,
958 
959    /* These are not hardware values */
960    VGRF,
961    ATTR,
962    UNIFORM, /* prog_data->params[reg] */
963    BAD_FILE,
964 };
965 
966 enum PACKED gen10_align1_3src_reg_file {
967    BRW_ALIGN1_3SRC_GENERAL_REGISTER_FILE = 0,
968    BRW_ALIGN1_3SRC_IMMEDIATE_VALUE       = 1, /* src0, src2 */
969    BRW_ALIGN1_3SRC_ACCUMULATOR           = 1, /* dest, src1 */
970 };
971 
972 /* CNL adds Align1 support for 3-src instructions. Bit 35 of the instruction
973  * word is "Execution Datatype" which controls whether the instruction operates
974  * on float or integer types. The register arguments have fields that offer
975  * more fine control their respective types.
976  */
977 enum PACKED gen10_align1_3src_exec_type {
978    BRW_ALIGN1_3SRC_EXEC_TYPE_INT   = 0,
979    BRW_ALIGN1_3SRC_EXEC_TYPE_FLOAT = 1,
980 };
981 
982 #define BRW_ARF_NULL                  0x00
983 #define BRW_ARF_ADDRESS               0x10
984 #define BRW_ARF_ACCUMULATOR           0x20
985 #define BRW_ARF_FLAG                  0x30
986 #define BRW_ARF_MASK                  0x40
987 #define BRW_ARF_MASK_STACK            0x50
988 #define BRW_ARF_MASK_STACK_DEPTH      0x60
989 #define BRW_ARF_STATE                 0x70
990 #define BRW_ARF_CONTROL               0x80
991 #define BRW_ARF_NOTIFICATION_COUNT    0x90
992 #define BRW_ARF_IP                    0xA0
993 #define BRW_ARF_TDR                   0xB0
994 #define BRW_ARF_TIMESTAMP             0xC0
995 
996 #define BRW_MRF_COMPR4			(1 << 7)
997 
998 #define BRW_AMASK   0
999 #define BRW_IMASK   1
1000 #define BRW_LMASK   2
1001 #define BRW_CMASK   3
1002 
1003 
1004 
1005 #define BRW_THREAD_NORMAL     0
1006 #define BRW_THREAD_ATOMIC     1
1007 #define BRW_THREAD_SWITCH     2
1008 
1009 enum PACKED brw_vertical_stride {
1010    BRW_VERTICAL_STRIDE_0               = 0,
1011    BRW_VERTICAL_STRIDE_1               = 1,
1012    BRW_VERTICAL_STRIDE_2               = 2,
1013    BRW_VERTICAL_STRIDE_4               = 3,
1014    BRW_VERTICAL_STRIDE_8               = 4,
1015    BRW_VERTICAL_STRIDE_16              = 5,
1016    BRW_VERTICAL_STRIDE_32              = 6,
1017    BRW_VERTICAL_STRIDE_ONE_DIMENSIONAL = 0xF,
1018 };
1019 
1020 enum PACKED gen10_align1_3src_vertical_stride {
1021    BRW_ALIGN1_3SRC_VERTICAL_STRIDE_0 = 0,
1022    BRW_ALIGN1_3SRC_VERTICAL_STRIDE_1 = 1,
1023    BRW_ALIGN1_3SRC_VERTICAL_STRIDE_2 = 1,
1024    BRW_ALIGN1_3SRC_VERTICAL_STRIDE_4 = 2,
1025    BRW_ALIGN1_3SRC_VERTICAL_STRIDE_8 = 3,
1026 };
1027 
1028 enum PACKED brw_width {
1029    BRW_WIDTH_1  = 0,
1030    BRW_WIDTH_2  = 1,
1031    BRW_WIDTH_4  = 2,
1032    BRW_WIDTH_8  = 3,
1033    BRW_WIDTH_16 = 4,
1034 };
1035 
1036 /**
1037  * Gen12+ SWSB SBID synchronization mode.
1038  *
1039  * This is represented as a bitmask including any required SBID token
1040  * synchronization modes, used to synchronize out-of-order instructions.  Only
1041  * the strongest mode of the mask will be provided to the hardware in the SWSB
1042  * field of an actual hardware instruction, but virtual instructions may be
1043  * able to take into account multiple of them.
1044  */
1045 enum tgl_sbid_mode {
1046    TGL_SBID_NULL = 0,
1047    TGL_SBID_SRC = 1,
1048    TGL_SBID_DST = 2,
1049    TGL_SBID_SET = 4
1050 };
1051 
1052 #ifdef __cplusplus
1053 /**
1054  * Allow bitwise arithmetic of tgl_sbid_mode enums.
1055  */
1056 inline tgl_sbid_mode
1057 operator|(tgl_sbid_mode x, tgl_sbid_mode y)
1058 {
1059    return tgl_sbid_mode(unsigned(x) | unsigned(y));
1060 }
1061 
1062 inline tgl_sbid_mode
1063 operator&(tgl_sbid_mode x, tgl_sbid_mode y)
1064 {
1065    return tgl_sbid_mode(unsigned(x) & unsigned(y));
1066 }
1067 
1068 inline tgl_sbid_mode &
1069 operator|=(tgl_sbid_mode &x, tgl_sbid_mode y)
1070 {
1071    return x = x | y;
1072 }
1073 
1074 #endif
1075 
1076 /**
1077  * Logical representation of the SWSB scheduling information of a hardware
1078  * instruction.  The binary representation is slightly more compact.
1079  */
1080 struct tgl_swsb {
1081    unsigned regdist : 3;
1082    unsigned sbid : 4;
1083    enum tgl_sbid_mode mode : 3;
1084 };
1085 
1086 /**
1087  * Construct a scheduling annotation with a single RegDist dependency.  This
1088  * synchronizes with the completion of the d-th previous in-order instruction.
1089  * The index is one-based, zero causes a no-op tgl_swsb to be constructed.
1090  */
1091 static inline struct tgl_swsb
tgl_swsb_regdist(unsigned d)1092 tgl_swsb_regdist(unsigned d)
1093 {
1094    const struct tgl_swsb swsb = { d };
1095    assert(swsb.regdist == d);
1096    return swsb;
1097 }
1098 
1099 /**
1100  * Construct a scheduling annotation that synchronizes with the specified SBID
1101  * token.
1102  */
1103 static inline struct tgl_swsb
tgl_swsb_sbid(enum tgl_sbid_mode mode,unsigned sbid)1104 tgl_swsb_sbid(enum tgl_sbid_mode mode, unsigned sbid)
1105 {
1106    const struct tgl_swsb swsb = { 0, sbid, mode };
1107    assert(swsb.sbid == sbid);
1108    return swsb;
1109 }
1110 
1111 /**
1112  * Construct a no-op scheduling annotation.
1113  */
1114 static inline struct tgl_swsb
tgl_swsb_null(void)1115 tgl_swsb_null(void)
1116 {
1117    return tgl_swsb_regdist(0);
1118 }
1119 
1120 /**
1121  * Return a scheduling annotation that allocates the same SBID synchronization
1122  * token as \p swsb.  In addition it will synchronize against a previous
1123  * in-order instruction if \p regdist is non-zero.
1124  */
1125 static inline struct tgl_swsb
tgl_swsb_dst_dep(struct tgl_swsb swsb,unsigned regdist)1126 tgl_swsb_dst_dep(struct tgl_swsb swsb, unsigned regdist)
1127 {
1128    swsb.regdist = regdist;
1129    swsb.mode = swsb.mode & TGL_SBID_SET;
1130    return swsb;
1131 }
1132 
1133 /**
1134  * Return a scheduling annotation that synchronizes against the same SBID and
1135  * RegDist dependencies as \p swsb, but doesn't allocate any SBID token.
1136  */
1137 static inline struct tgl_swsb
tgl_swsb_src_dep(struct tgl_swsb swsb)1138 tgl_swsb_src_dep(struct tgl_swsb swsb)
1139 {
1140    swsb.mode = swsb.mode & (TGL_SBID_SRC | TGL_SBID_DST);
1141    return swsb;
1142 }
1143 
1144 /**
1145  * Convert the provided tgl_swsb to the hardware's binary representation of an
1146  * SWSB annotation.
1147  */
1148 static inline uint8_t
tgl_swsb_encode(struct tgl_swsb swsb)1149 tgl_swsb_encode(struct tgl_swsb swsb)
1150 {
1151    if (!swsb.mode) {
1152       return swsb.regdist;
1153    } else if (swsb.regdist) {
1154       return 0x80 | swsb.regdist << 4 | swsb.sbid;
1155    } else {
1156       return swsb.sbid | (swsb.mode & TGL_SBID_SET ? 0x40 :
1157                           swsb.mode & TGL_SBID_DST ? 0x20 : 0x30);
1158    }
1159 }
1160 
1161 /**
1162  * Convert the provided binary representation of an SWSB annotation to a
1163  * tgl_swsb.
1164  */
1165 static inline struct tgl_swsb
tgl_swsb_decode(enum opcode opcode,uint8_t x)1166 tgl_swsb_decode(enum opcode opcode, uint8_t x)
1167 {
1168    if (x & 0x80) {
1169       const struct tgl_swsb swsb = { (x & 0x70u) >> 4, x & 0xfu,
1170                                      (opcode == BRW_OPCODE_SEND ||
1171                                       opcode == BRW_OPCODE_SENDC ||
1172                                       opcode == BRW_OPCODE_MATH) ?
1173                                      TGL_SBID_SET : TGL_SBID_DST };
1174       return swsb;
1175    } else if ((x & 0x70) == 0x20) {
1176       return tgl_swsb_sbid(TGL_SBID_DST, x & 0xfu);
1177    } else if ((x & 0x70) == 0x30) {
1178       return tgl_swsb_sbid(TGL_SBID_SRC, x & 0xfu);
1179    } else if ((x & 0x70) == 0x40) {
1180       return tgl_swsb_sbid(TGL_SBID_SET, x & 0xfu);
1181    } else {
1182       return tgl_swsb_regdist(x & 0x7u);
1183    }
1184 }
1185 
1186 enum tgl_sync_function {
1187    TGL_SYNC_NOP = 0x0,
1188    TGL_SYNC_ALLRD = 0x2,
1189    TGL_SYNC_ALLWR = 0x3,
1190    TGL_SYNC_BAR = 0xe,
1191    TGL_SYNC_HOST = 0xf
1192 };
1193 
1194 /**
1195  * Message target: Shared Function ID for where to SEND a message.
1196  *
1197  * These are enumerated in the ISA reference under "send - Send Message".
1198  * In particular, see the following tables:
1199  * - G45 PRM, Volume 4, Table 14-15 "Message Descriptor Definition"
1200  * - Sandybridge PRM, Volume 4 Part 2, Table 8-16 "Extended Message Descriptor"
1201  * - Ivybridge PRM, Volume 1 Part 1, section 3.2.7 "GPE Function IDs"
1202  */
1203 enum brw_message_target {
1204    BRW_SFID_NULL                     = 0,
1205    BRW_SFID_MATH                     = 1, /* Only valid on Gen4-5 */
1206    BRW_SFID_SAMPLER                  = 2,
1207    BRW_SFID_MESSAGE_GATEWAY          = 3,
1208    BRW_SFID_DATAPORT_READ            = 4,
1209    BRW_SFID_DATAPORT_WRITE           = 5,
1210    BRW_SFID_URB                      = 6,
1211    BRW_SFID_THREAD_SPAWNER           = 7,
1212    BRW_SFID_VME                      = 8,
1213 
1214    GEN6_SFID_DATAPORT_SAMPLER_CACHE  = 4,
1215    GEN6_SFID_DATAPORT_RENDER_CACHE   = 5,
1216    GEN6_SFID_DATAPORT_CONSTANT_CACHE = 9,
1217 
1218    GEN7_SFID_DATAPORT_DATA_CACHE     = 10,
1219    GEN7_SFID_PIXEL_INTERPOLATOR      = 11,
1220    HSW_SFID_DATAPORT_DATA_CACHE_1    = 12,
1221    HSW_SFID_CRE                      = 13,
1222 };
1223 
1224 #define GEN7_MESSAGE_TARGET_DP_DATA_CACHE     10
1225 
1226 #define BRW_SAMPLER_RETURN_FORMAT_FLOAT32     0
1227 #define BRW_SAMPLER_RETURN_FORMAT_UINT32      2
1228 #define BRW_SAMPLER_RETURN_FORMAT_SINT32      3
1229 
1230 #define BRW_SAMPLER_MESSAGE_SIMD8_SAMPLE              0
1231 #define BRW_SAMPLER_MESSAGE_SIMD16_SAMPLE             0
1232 #define BRW_SAMPLER_MESSAGE_SIMD16_SAMPLE_BIAS        0
1233 #define BRW_SAMPLER_MESSAGE_SIMD8_KILLPIX             1
1234 #define BRW_SAMPLER_MESSAGE_SIMD4X2_SAMPLE_LOD        1
1235 #define BRW_SAMPLER_MESSAGE_SIMD16_SAMPLE_LOD         1
1236 #define BRW_SAMPLER_MESSAGE_SIMD4X2_SAMPLE_GRADIENTS  2
1237 #define BRW_SAMPLER_MESSAGE_SIMD8_SAMPLE_GRADIENTS    2
1238 #define BRW_SAMPLER_MESSAGE_SIMD4X2_SAMPLE_COMPARE    0
1239 #define BRW_SAMPLER_MESSAGE_SIMD16_SAMPLE_COMPARE     2
1240 #define BRW_SAMPLER_MESSAGE_SIMD8_SAMPLE_BIAS_COMPARE 0
1241 #define BRW_SAMPLER_MESSAGE_SIMD4X2_SAMPLE_LOD_COMPARE 1
1242 #define BRW_SAMPLER_MESSAGE_SIMD8_SAMPLE_LOD_COMPARE  1
1243 #define BRW_SAMPLER_MESSAGE_SIMD4X2_RESINFO           2
1244 #define BRW_SAMPLER_MESSAGE_SIMD16_RESINFO            2
1245 #define BRW_SAMPLER_MESSAGE_SIMD4X2_LD                3
1246 #define BRW_SAMPLER_MESSAGE_SIMD8_LD                  3
1247 #define BRW_SAMPLER_MESSAGE_SIMD16_LD                 3
1248 
1249 #define GEN5_SAMPLER_MESSAGE_SAMPLE              0
1250 #define GEN5_SAMPLER_MESSAGE_SAMPLE_BIAS         1
1251 #define GEN5_SAMPLER_MESSAGE_SAMPLE_LOD          2
1252 #define GEN5_SAMPLER_MESSAGE_SAMPLE_COMPARE      3
1253 #define GEN5_SAMPLER_MESSAGE_SAMPLE_DERIVS       4
1254 #define GEN5_SAMPLER_MESSAGE_SAMPLE_BIAS_COMPARE 5
1255 #define GEN5_SAMPLER_MESSAGE_SAMPLE_LOD_COMPARE  6
1256 #define GEN5_SAMPLER_MESSAGE_SAMPLE_LD           7
1257 #define GEN7_SAMPLER_MESSAGE_SAMPLE_GATHER4      8
1258 #define GEN5_SAMPLER_MESSAGE_LOD                 9
1259 #define GEN5_SAMPLER_MESSAGE_SAMPLE_RESINFO      10
1260 #define GEN6_SAMPLER_MESSAGE_SAMPLE_SAMPLEINFO   11
1261 #define GEN7_SAMPLER_MESSAGE_SAMPLE_GATHER4_C    16
1262 #define GEN7_SAMPLER_MESSAGE_SAMPLE_GATHER4_PO   17
1263 #define GEN7_SAMPLER_MESSAGE_SAMPLE_GATHER4_PO_C 18
1264 #define HSW_SAMPLER_MESSAGE_SAMPLE_DERIV_COMPARE 20
1265 #define GEN9_SAMPLER_MESSAGE_SAMPLE_LZ           24
1266 #define GEN9_SAMPLER_MESSAGE_SAMPLE_C_LZ         25
1267 #define GEN9_SAMPLER_MESSAGE_SAMPLE_LD_LZ        26
1268 #define GEN9_SAMPLER_MESSAGE_SAMPLE_LD2DMS_W     28
1269 #define GEN7_SAMPLER_MESSAGE_SAMPLE_LD_MCS       29
1270 #define GEN7_SAMPLER_MESSAGE_SAMPLE_LD2DMS       30
1271 #define GEN7_SAMPLER_MESSAGE_SAMPLE_LD2DSS       31
1272 
1273 /* for GEN5 only */
1274 #define BRW_SAMPLER_SIMD_MODE_SIMD4X2                   0
1275 #define BRW_SAMPLER_SIMD_MODE_SIMD8                     1
1276 #define BRW_SAMPLER_SIMD_MODE_SIMD16                    2
1277 #define BRW_SAMPLER_SIMD_MODE_SIMD32_64                 3
1278 
1279 /* GEN9 changes SIMD mode 0 to mean SIMD8D, but lets us get the SIMD4x2
1280  * behavior by setting bit 22 of dword 2 in the message header. */
1281 #define GEN9_SAMPLER_SIMD_MODE_SIMD8D                   0
1282 #define GEN9_SAMPLER_SIMD_MODE_EXTENSION_SIMD4X2        (1 << 22)
1283 
1284 #define BRW_DATAPORT_OWORD_BLOCK_1_OWORDLOW   0
1285 #define BRW_DATAPORT_OWORD_BLOCK_1_OWORDHIGH  1
1286 #define BRW_DATAPORT_OWORD_BLOCK_2_OWORDS     2
1287 #define BRW_DATAPORT_OWORD_BLOCK_4_OWORDS     3
1288 #define BRW_DATAPORT_OWORD_BLOCK_8_OWORDS     4
1289 #define BRW_DATAPORT_OWORD_BLOCK_DWORDS(n)              \
1290    ((n) == 4 ? BRW_DATAPORT_OWORD_BLOCK_1_OWORDLOW :    \
1291     (n) == 8 ? BRW_DATAPORT_OWORD_BLOCK_2_OWORDS :      \
1292     (n) == 16 ? BRW_DATAPORT_OWORD_BLOCK_4_OWORDS :     \
1293     (n) == 32 ? BRW_DATAPORT_OWORD_BLOCK_8_OWORDS :     \
1294     (abort(), ~0))
1295 
1296 #define BRW_DATAPORT_OWORD_DUAL_BLOCK_1OWORD     0
1297 #define BRW_DATAPORT_OWORD_DUAL_BLOCK_4OWORDS    2
1298 
1299 #define BRW_DATAPORT_DWORD_SCATTERED_BLOCK_8DWORDS   2
1300 #define BRW_DATAPORT_DWORD_SCATTERED_BLOCK_16DWORDS  3
1301 
1302 /* This one stays the same across generations. */
1303 #define BRW_DATAPORT_READ_MESSAGE_OWORD_BLOCK_READ          0
1304 /* GEN4 */
1305 #define BRW_DATAPORT_READ_MESSAGE_OWORD_DUAL_BLOCK_READ     1
1306 #define BRW_DATAPORT_READ_MESSAGE_MEDIA_BLOCK_READ          2
1307 #define BRW_DATAPORT_READ_MESSAGE_DWORD_SCATTERED_READ      3
1308 /* G45, GEN5 */
1309 #define G45_DATAPORT_READ_MESSAGE_RENDER_UNORM_READ	    1
1310 #define G45_DATAPORT_READ_MESSAGE_OWORD_DUAL_BLOCK_READ     2
1311 #define G45_DATAPORT_READ_MESSAGE_AVC_LOOP_FILTER_READ	    3
1312 #define G45_DATAPORT_READ_MESSAGE_MEDIA_BLOCK_READ          4
1313 #define G45_DATAPORT_READ_MESSAGE_DWORD_SCATTERED_READ      6
1314 /* GEN6 */
1315 #define GEN6_DATAPORT_READ_MESSAGE_RENDER_UNORM_READ	    1
1316 #define GEN6_DATAPORT_READ_MESSAGE_OWORD_DUAL_BLOCK_READ     2
1317 #define GEN6_DATAPORT_READ_MESSAGE_MEDIA_BLOCK_READ          4
1318 #define GEN6_DATAPORT_READ_MESSAGE_OWORD_UNALIGN_BLOCK_READ  5
1319 #define GEN6_DATAPORT_READ_MESSAGE_DWORD_SCATTERED_READ      6
1320 
1321 #define BRW_DATAPORT_READ_TARGET_DATA_CACHE      0
1322 #define BRW_DATAPORT_READ_TARGET_RENDER_CACHE    1
1323 #define BRW_DATAPORT_READ_TARGET_SAMPLER_CACHE   2
1324 
1325 #define BRW_DATAPORT_RENDER_TARGET_WRITE_SIMD16_SINGLE_SOURCE                0
1326 #define BRW_DATAPORT_RENDER_TARGET_WRITE_SIMD16_SINGLE_SOURCE_REPLICATED     1
1327 #define BRW_DATAPORT_RENDER_TARGET_WRITE_SIMD8_DUAL_SOURCE_SUBSPAN01         2
1328 #define BRW_DATAPORT_RENDER_TARGET_WRITE_SIMD8_DUAL_SOURCE_SUBSPAN23         3
1329 #define BRW_DATAPORT_RENDER_TARGET_WRITE_SIMD8_SINGLE_SOURCE_SUBSPAN01       4
1330 
1331 #define BRW_DATAPORT_WRITE_MESSAGE_OWORD_BLOCK_WRITE                0
1332 #define BRW_DATAPORT_WRITE_MESSAGE_OWORD_DUAL_BLOCK_WRITE           1
1333 #define BRW_DATAPORT_WRITE_MESSAGE_MEDIA_BLOCK_WRITE                2
1334 #define BRW_DATAPORT_WRITE_MESSAGE_DWORD_SCATTERED_WRITE            3
1335 #define BRW_DATAPORT_WRITE_MESSAGE_RENDER_TARGET_WRITE              4
1336 #define BRW_DATAPORT_WRITE_MESSAGE_STREAMED_VERTEX_BUFFER_WRITE     5
1337 #define BRW_DATAPORT_WRITE_MESSAGE_FLUSH_RENDER_CACHE               7
1338 
1339 /* GEN6 */
1340 #define GEN6_DATAPORT_WRITE_MESSAGE_DWORD_ATOMIC_WRITE              7
1341 #define GEN6_DATAPORT_WRITE_MESSAGE_OWORD_BLOCK_WRITE               8
1342 #define GEN6_DATAPORT_WRITE_MESSAGE_OWORD_DUAL_BLOCK_WRITE          9
1343 #define GEN6_DATAPORT_WRITE_MESSAGE_MEDIA_BLOCK_WRITE               10
1344 #define GEN6_DATAPORT_WRITE_MESSAGE_DWORD_SCATTERED_WRITE           11
1345 #define GEN6_DATAPORT_WRITE_MESSAGE_RENDER_TARGET_WRITE             12
1346 #define GEN6_DATAPORT_WRITE_MESSAGE_STREAMED_VB_WRITE               13
1347 #define GEN6_DATAPORT_WRITE_MESSAGE_RENDER_TARGET_UNORM_WRITE       14
1348 
1349 /* GEN7 */
1350 #define GEN7_DATAPORT_RC_MEDIA_BLOCK_READ                           4
1351 #define GEN7_DATAPORT_RC_TYPED_SURFACE_READ                         5
1352 #define GEN7_DATAPORT_RC_TYPED_ATOMIC_OP                            6
1353 #define GEN7_DATAPORT_RC_MEMORY_FENCE                               7
1354 #define GEN7_DATAPORT_RC_MEDIA_BLOCK_WRITE                          10
1355 #define GEN7_DATAPORT_RC_RENDER_TARGET_WRITE                        12
1356 #define GEN7_DATAPORT_RC_TYPED_SURFACE_WRITE                        13
1357 #define GEN7_DATAPORT_DC_OWORD_BLOCK_READ                           0
1358 #define GEN7_DATAPORT_DC_UNALIGNED_OWORD_BLOCK_READ                 1
1359 #define GEN7_DATAPORT_DC_OWORD_DUAL_BLOCK_READ                      2
1360 #define GEN7_DATAPORT_DC_DWORD_SCATTERED_READ                       3
1361 #define GEN7_DATAPORT_DC_BYTE_SCATTERED_READ                        4
1362 #define GEN7_DATAPORT_DC_UNTYPED_SURFACE_READ                       5
1363 #define GEN7_DATAPORT_DC_UNTYPED_ATOMIC_OP                          6
1364 #define GEN7_DATAPORT_DC_MEMORY_FENCE                               7
1365 #define GEN7_DATAPORT_DC_OWORD_BLOCK_WRITE                          8
1366 #define GEN7_DATAPORT_DC_OWORD_DUAL_BLOCK_WRITE                     10
1367 #define GEN7_DATAPORT_DC_DWORD_SCATTERED_WRITE                      11
1368 #define GEN7_DATAPORT_DC_BYTE_SCATTERED_WRITE                       12
1369 #define GEN7_DATAPORT_DC_UNTYPED_SURFACE_WRITE                      13
1370 
1371 #define GEN7_DATAPORT_SCRATCH_READ                            ((1 << 18) | \
1372                                                                (0 << 17))
1373 #define GEN7_DATAPORT_SCRATCH_WRITE                           ((1 << 18) | \
1374                                                                (1 << 17))
1375 #define GEN7_DATAPORT_SCRATCH_NUM_REGS_SHIFT                        12
1376 
1377 #define GEN7_PIXEL_INTERPOLATOR_LOC_SHARED_OFFSET     0
1378 #define GEN7_PIXEL_INTERPOLATOR_LOC_SAMPLE            1
1379 #define GEN7_PIXEL_INTERPOLATOR_LOC_CENTROID          2
1380 #define GEN7_PIXEL_INTERPOLATOR_LOC_PER_SLOT_OFFSET   3
1381 
1382 /* HSW */
1383 #define HSW_DATAPORT_DC_PORT0_OWORD_BLOCK_READ                      0
1384 #define HSW_DATAPORT_DC_PORT0_UNALIGNED_OWORD_BLOCK_READ            1
1385 #define HSW_DATAPORT_DC_PORT0_OWORD_DUAL_BLOCK_READ                 2
1386 #define HSW_DATAPORT_DC_PORT0_DWORD_SCATTERED_READ                  3
1387 #define HSW_DATAPORT_DC_PORT0_BYTE_SCATTERED_READ                   4
1388 #define HSW_DATAPORT_DC_PORT0_MEMORY_FENCE                          7
1389 #define HSW_DATAPORT_DC_PORT0_OWORD_BLOCK_WRITE                     8
1390 #define HSW_DATAPORT_DC_PORT0_OWORD_DUAL_BLOCK_WRITE                10
1391 #define HSW_DATAPORT_DC_PORT0_DWORD_SCATTERED_WRITE                 11
1392 #define HSW_DATAPORT_DC_PORT0_BYTE_SCATTERED_WRITE                  12
1393 
1394 #define HSW_DATAPORT_DC_PORT1_UNTYPED_SURFACE_READ                  1
1395 #define HSW_DATAPORT_DC_PORT1_UNTYPED_ATOMIC_OP                     2
1396 #define HSW_DATAPORT_DC_PORT1_UNTYPED_ATOMIC_OP_SIMD4X2             3
1397 #define HSW_DATAPORT_DC_PORT1_MEDIA_BLOCK_READ                      4
1398 #define HSW_DATAPORT_DC_PORT1_TYPED_SURFACE_READ                    5
1399 #define HSW_DATAPORT_DC_PORT1_TYPED_ATOMIC_OP                       6
1400 #define HSW_DATAPORT_DC_PORT1_TYPED_ATOMIC_OP_SIMD4X2               7
1401 #define HSW_DATAPORT_DC_PORT1_UNTYPED_SURFACE_WRITE                 9
1402 #define HSW_DATAPORT_DC_PORT1_MEDIA_BLOCK_WRITE                     10
1403 #define HSW_DATAPORT_DC_PORT1_ATOMIC_COUNTER_OP                     11
1404 #define HSW_DATAPORT_DC_PORT1_ATOMIC_COUNTER_OP_SIMD4X2             12
1405 #define HSW_DATAPORT_DC_PORT1_TYPED_SURFACE_WRITE                   13
1406 #define GEN9_DATAPORT_DC_PORT1_A64_SCATTERED_READ                   0x10
1407 #define GEN8_DATAPORT_DC_PORT1_A64_UNTYPED_SURFACE_READ             0x11
1408 #define GEN8_DATAPORT_DC_PORT1_A64_UNTYPED_ATOMIC_OP                0x12
1409 #define GEN8_DATAPORT_DC_PORT1_A64_UNTYPED_SURFACE_WRITE            0x19
1410 #define GEN8_DATAPORT_DC_PORT1_A64_SCATTERED_WRITE                  0x1a
1411 #define GEN9_DATAPORT_DC_PORT1_UNTYPED_ATOMIC_FLOAT_OP              0x1b
1412 #define GEN9_DATAPORT_DC_PORT1_A64_UNTYPED_ATOMIC_FLOAT_OP          0x1d
1413 
1414 /* GEN9 */
1415 #define GEN9_DATAPORT_RC_RENDER_TARGET_WRITE                        12
1416 #define GEN9_DATAPORT_RC_RENDER_TARGET_READ                         13
1417 
1418 /* A64 scattered message subtype */
1419 #define GEN8_A64_SCATTERED_SUBTYPE_BYTE                             0
1420 #define GEN8_A64_SCATTERED_SUBTYPE_DWORD                            1
1421 #define GEN8_A64_SCATTERED_SUBTYPE_QWORD                            2
1422 #define GEN8_A64_SCATTERED_SUBTYPE_HWORD                            3
1423 
1424 /* Dataport special binding table indices: */
1425 #define BRW_BTI_STATELESS                255
1426 #define GEN7_BTI_SLM                     254
1427 
1428 #define HSW_BTI_STATELESS_LOCALLY_COHERENT 255
1429 #define HSW_BTI_STATELESS_NON_COHERENT 253
1430 #define HSW_BTI_STATELESS_GLOBALLY_COHERENT 252
1431 #define HSW_BTI_STATELESS_LLC_COHERENT 251
1432 #define HSW_BTI_STATELESS_L3_UNCACHED 250
1433 
1434 /* The hardware docs are a bit contradictory here.  On Haswell, where they
1435  * first added cache ability control, there were 5 different cache modes (see
1436  * HSW_BTI_STATELESS_* above).  On Broadwell, they reduced to two:
1437  *
1438  *  - IA-Coherent (BTI=255): Coherent within Gen and coherent within the
1439  *    entire IA cache memory hierarchy.
1440  *
1441  *  - Non-Coherent (BTI=253): Coherent within Gen, same cache type.
1442  *
1443  * Information about stateless cache coherency can be found in the "A32
1444  * Stateless" section of the "3D Media GPGPU" volume of the PRM for each
1445  * hardware generation.
1446  *
1447  * Unfortunately, the docs for MDC_STATELESS appear to have been copied and
1448  * pasted from Haswell and give the Haswell definitions for the BTI values of
1449  * 255 and 253 including a warning about accessing 253 surfaces from multiple
1450  * threads.  This seems to be a copy+paste error and the definitions from the
1451  * "A32 Stateless" section should be trusted instead.
1452  *
1453  * Note that because the DRM sets bit 4 of HDC_CHICKEN0 on BDW, CHV and at
1454  * least some pre-production steppings of SKL due to WaForceEnableNonCoherent,
1455  * HDC memory access may have been overridden by the kernel to be non-coherent
1456  * (matching the behavior of the same BTI on pre-Gen8 hardware) and BTI 255
1457  * may actually be an alias for BTI 253.
1458  */
1459 #define GEN8_BTI_STATELESS_IA_COHERENT   255
1460 #define GEN8_BTI_STATELESS_NON_COHERENT  253
1461 #define GEN9_BTI_BINDLESS                252
1462 
1463 /* Dataport atomic operations for Untyped Atomic Integer Operation message
1464  * (and others).
1465  */
1466 #define BRW_AOP_AND                   1
1467 #define BRW_AOP_OR                    2
1468 #define BRW_AOP_XOR                   3
1469 #define BRW_AOP_MOV                   4
1470 #define BRW_AOP_INC                   5
1471 #define BRW_AOP_DEC                   6
1472 #define BRW_AOP_ADD                   7
1473 #define BRW_AOP_SUB                   8
1474 #define BRW_AOP_REVSUB                9
1475 #define BRW_AOP_IMAX                  10
1476 #define BRW_AOP_IMIN                  11
1477 #define BRW_AOP_UMAX                  12
1478 #define BRW_AOP_UMIN                  13
1479 #define BRW_AOP_CMPWR                 14
1480 #define BRW_AOP_PREDEC                15
1481 
1482 /* Dataport atomic operations for Untyped Atomic Float Operation message. */
1483 #define BRW_AOP_FMAX                  1
1484 #define BRW_AOP_FMIN                  2
1485 #define BRW_AOP_FCMPWR                3
1486 
1487 #define BRW_MATH_FUNCTION_INV                              1
1488 #define BRW_MATH_FUNCTION_LOG                              2
1489 #define BRW_MATH_FUNCTION_EXP                              3
1490 #define BRW_MATH_FUNCTION_SQRT                             4
1491 #define BRW_MATH_FUNCTION_RSQ                              5
1492 #define BRW_MATH_FUNCTION_SIN                              6
1493 #define BRW_MATH_FUNCTION_COS                              7
1494 #define BRW_MATH_FUNCTION_SINCOS                           8 /* gen4, gen5 */
1495 #define BRW_MATH_FUNCTION_FDIV                             9 /* gen6+ */
1496 #define BRW_MATH_FUNCTION_POW                              10
1497 #define BRW_MATH_FUNCTION_INT_DIV_QUOTIENT_AND_REMAINDER   11
1498 #define BRW_MATH_FUNCTION_INT_DIV_QUOTIENT                 12
1499 #define BRW_MATH_FUNCTION_INT_DIV_REMAINDER                13
1500 #define GEN8_MATH_FUNCTION_INVM                            14
1501 #define GEN8_MATH_FUNCTION_RSQRTM                          15
1502 
1503 #define BRW_MATH_INTEGER_UNSIGNED     0
1504 #define BRW_MATH_INTEGER_SIGNED       1
1505 
1506 #define BRW_MATH_PRECISION_FULL        0
1507 #define BRW_MATH_PRECISION_PARTIAL     1
1508 
1509 #define BRW_MATH_SATURATE_NONE         0
1510 #define BRW_MATH_SATURATE_SATURATE     1
1511 
1512 #define BRW_MATH_DATA_VECTOR  0
1513 #define BRW_MATH_DATA_SCALAR  1
1514 
1515 #define BRW_URB_OPCODE_WRITE_HWORD  0
1516 #define BRW_URB_OPCODE_WRITE_OWORD  1
1517 #define BRW_URB_OPCODE_READ_HWORD   2
1518 #define BRW_URB_OPCODE_READ_OWORD   3
1519 #define GEN7_URB_OPCODE_ATOMIC_MOV  4
1520 #define GEN7_URB_OPCODE_ATOMIC_INC  5
1521 #define GEN8_URB_OPCODE_ATOMIC_ADD  6
1522 #define GEN8_URB_OPCODE_SIMD8_WRITE 7
1523 #define GEN8_URB_OPCODE_SIMD8_READ  8
1524 
1525 #define BRW_URB_SWIZZLE_NONE          0
1526 #define BRW_URB_SWIZZLE_INTERLEAVE    1
1527 #define BRW_URB_SWIZZLE_TRANSPOSE     2
1528 
1529 #define BRW_SCRATCH_SPACE_SIZE_1K     0
1530 #define BRW_SCRATCH_SPACE_SIZE_2K     1
1531 #define BRW_SCRATCH_SPACE_SIZE_4K     2
1532 #define BRW_SCRATCH_SPACE_SIZE_8K     3
1533 #define BRW_SCRATCH_SPACE_SIZE_16K    4
1534 #define BRW_SCRATCH_SPACE_SIZE_32K    5
1535 #define BRW_SCRATCH_SPACE_SIZE_64K    6
1536 #define BRW_SCRATCH_SPACE_SIZE_128K   7
1537 #define BRW_SCRATCH_SPACE_SIZE_256K   8
1538 #define BRW_SCRATCH_SPACE_SIZE_512K   9
1539 #define BRW_SCRATCH_SPACE_SIZE_1M     10
1540 #define BRW_SCRATCH_SPACE_SIZE_2M     11
1541 
1542 #define BRW_MESSAGE_GATEWAY_SFID_OPEN_GATEWAY         0
1543 #define BRW_MESSAGE_GATEWAY_SFID_CLOSE_GATEWAY        1
1544 #define BRW_MESSAGE_GATEWAY_SFID_FORWARD_MSG          2
1545 #define BRW_MESSAGE_GATEWAY_SFID_GET_TIMESTAMP        3
1546 #define BRW_MESSAGE_GATEWAY_SFID_BARRIER_MSG          4
1547 #define BRW_MESSAGE_GATEWAY_SFID_UPDATE_GATEWAY_STATE 5
1548 #define BRW_MESSAGE_GATEWAY_SFID_MMIO_READ_WRITE      6
1549 
1550 
1551 /* Gen7 "GS URB Entry Allocation Size" is a U9-1 field, so the maximum gs_size
1552  * is 2^9, or 512.  It's counted in multiples of 64 bytes.
1553  *
1554  * Identical for VS, DS, and HS.
1555  */
1556 #define GEN7_MAX_GS_URB_ENTRY_SIZE_BYTES                (512*64)
1557 #define GEN7_MAX_DS_URB_ENTRY_SIZE_BYTES                (512*64)
1558 #define GEN7_MAX_HS_URB_ENTRY_SIZE_BYTES                (512*64)
1559 #define GEN7_MAX_VS_URB_ENTRY_SIZE_BYTES                (512*64)
1560 
1561 /* Gen6 "GS URB Entry Allocation Size" is defined as a number of 1024-bit
1562  * (128 bytes) URB rows and the maximum allowed value is 5 rows.
1563  */
1564 #define GEN6_MAX_GS_URB_ENTRY_SIZE_BYTES                (5*128)
1565 
1566 /* GS Thread Payload
1567  */
1568 
1569 /* 3DSTATE_GS "Output Vertex Size" has an effective maximum of 62. It's
1570  * counted in multiples of 16 bytes.
1571  */
1572 #define GEN7_MAX_GS_OUTPUT_VERTEX_SIZE_BYTES            (62*16)
1573 
1574 
1575 /* R0 */
1576 # define GEN7_GS_PAYLOAD_INSTANCE_ID_SHIFT		27
1577 
1578 /* CR0.0[5:4] Floating-Point Rounding Modes
1579  *  Skylake PRM, Volume 7 Part 1, "Control Register", page 756
1580  */
1581 
1582 #define BRW_CR0_RND_MODE_MASK     0x30
1583 #define BRW_CR0_RND_MODE_SHIFT    4
1584 
1585 enum PACKED brw_rnd_mode {
1586    BRW_RND_MODE_RTNE = 0,  /* Round to Nearest or Even */
1587    BRW_RND_MODE_RU = 1,    /* Round Up, toward +inf */
1588    BRW_RND_MODE_RD = 2,    /* Round Down, toward -inf */
1589    BRW_RND_MODE_RTZ = 3,   /* Round Toward Zero */
1590    BRW_RND_MODE_UNSPECIFIED,  /* Unspecified rounding mode */
1591 };
1592 
1593 #define BRW_CR0_FP64_DENORM_PRESERVE (1 << 6)
1594 #define BRW_CR0_FP32_DENORM_PRESERVE (1 << 7)
1595 #define BRW_CR0_FP16_DENORM_PRESERVE (1 << 10)
1596 
1597 #define BRW_CR0_FP_MODE_MASK (BRW_CR0_FP64_DENORM_PRESERVE | \
1598                               BRW_CR0_FP32_DENORM_PRESERVE | \
1599                               BRW_CR0_FP16_DENORM_PRESERVE | \
1600                               BRW_CR0_RND_MODE_MASK)
1601 
1602 /* MDC_DS - Data Size Message Descriptor Control Field
1603  * Skylake PRM, Volume 2d, page 129
1604  *
1605  * Specifies the number of Bytes to be read or written per Dword used at
1606  * byte_scattered read/write and byte_scaled read/write messages.
1607  */
1608 #define GEN7_BYTE_SCATTERED_DATA_ELEMENT_BYTE     0
1609 #define GEN7_BYTE_SCATTERED_DATA_ELEMENT_WORD     1
1610 #define GEN7_BYTE_SCATTERED_DATA_ELEMENT_DWORD    2
1611 
1612 #endif /* BRW_EU_DEFINES_H */
1613