2 * Copyright (c) 2013 Rob Clark <robdclark@gmail.com>
4 * Permission is hereby granted, free of charge, to any person obtaining a
5 * copy of this software and associated documentation files (the "Software"),
6 * to deal in the Software without restriction, including without limitation
7 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8 * and/or sell copies of the Software, and to permit persons to whom the
9 * Software is furnished to do so, subject to the following conditions:
11 * The above copyright notice and this permission notice (including the next
12 * paragraph) shall be included in all copies or substantial portions of the
15 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
18 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
30 #include "compiler/shader_enums.h"
32 #include "util/bitscan.h"
33 #include "util/list.h"
35 #include "util/u_debug.h"
37 #include "instr-a3xx.h"
39 /* low level intermediate representation of an adreno shader program */
43 struct ir3_instruction
;
49 uint16_t instrs_count
; /* expanded to account for rpt's */
50 uint16_t nops_count
; /* # of nop instructions, including nopN */
53 /* NOTE: max_reg, etc, does not include registers not touched
54 * by the shader (ie. vertex fetched via VFD_DECODE but not
57 int8_t max_reg
; /* highest GPR # used by shader */
61 /* number of sync bits: */
64 /* estimate of number of cycles stalled on (ss) */
67 uint16_t last_baryf
; /* instruction # of last varying fetch */
72 IR3_REG_CONST
= 0x001,
73 IR3_REG_IMMED
= 0x002,
75 /* high registers are used for some things in compute shaders,
76 * for example. Seems to be for things that are global to all
77 * threads in a wave, so possibly these are global/shared by
78 * all the threads in the wave?
81 IR3_REG_RELATIV
= 0x010,
83 /* Most instructions, it seems, can do float abs/neg but not
84 * integer. The CP pass needs to know what is intended (int or
85 * float) in order to do the right thing. For this reason the
86 * abs/neg flags are split out into float and int variants. In
87 * addition, .b (bitwise) operations, the negate is actually a
88 * bitwise not, so split that out into a new flag to make it
97 IR3_REG_POS_INF
= 0x1000,
98 /* (ei) flag, end-input? Set on last bary, presumably to signal
99 * that the shader needs no more input:
102 /* meta-flags, for intermediate stages of IR, ie.
103 * before register assignment is done:
105 IR3_REG_SSA
= 0x4000, /* 'instr' is ptr to assigning instr */
106 IR3_REG_ARRAY
= 0x8000,
110 /* used for cat5 instructions, but also for internal/IR level
111 * tracking of what registers are read/written by an instruction.
112 * wrmask may be a bad name since it is used to represent both
113 * src and dst that touch multiple adjacent registers.
115 unsigned wrmask
: 16; /* up to vec16 */
117 /* for relative addressing, 32bits for array size is too small,
118 * but otoh we don't need to deal with disjoint sets, so instead
119 * use a simple size field (number of scalar components).
121 * Note the size field isn't important for relative const (since
122 * we don't have to do register allocation for constants).
126 bool merged
: 1; /* half-regs conflict with full regs (ie >= a6xx) */
129 * the component is in the low two bits of the reg #, so
130 * rN.x becomes: (N << 2) | x
145 /* For IR3_REG_SSA, src registers contain ptr back to assigning
148 * For IR3_REG_ARRAY, the pointer is back to the last dependent
149 * array access (although the net effect is the same, it points
150 * back to a previous instruction that we depend on).
152 struct ir3_instruction
*instr
;
156 * Stupid/simple growable array implementation:
158 #define DECLARE_ARRAY(type, name) \
159 unsigned name ## _count, name ## _sz; \
162 #define array_insert(ctx, arr, val) do { \
163 if (arr ## _count == arr ## _sz) { \
164 arr ## _sz = MAX2(2 * arr ## _sz, 16); \
165 arr = reralloc_size(ctx, arr, arr ## _sz * sizeof(arr[0])); \
167 arr[arr ##_count++] = val; \
170 struct ir3_instruction
{
171 struct ir3_block
*block
;
174 /* (sy) flag is set on first instruction, and after sample
175 * instructions (probably just on RAW hazard).
177 IR3_INSTR_SY
= 0x001,
178 /* (ss) flag is set on first instruction, and first instruction
179 * to depend on the result of "long" instructions (RAW hazard):
181 * rcp, rsq, log2, exp2, sin, cos, sqrt
183 * It seems to synchronize until all in-flight instructions are
184 * completed, for example:
187 * add.f hr2.z, (neg)hr2.z, hc0.y
188 * mul.f hr2.w, (neg)hr2.y, (neg)hr2.y
191 * mad.f16 hr2.w, hr2.z, hr2.z, hr2.w
193 * mad.f16 hr2.w, (neg)hr0.w, (neg)hr0.w, hr2.w
194 * (ss)(rpt2)mul.f hr1.x, (r)hr1.x, hr1.w
195 * (rpt2)mul.f hr0.x, (neg)(r)hr0.x, hr2.x
197 * The last mul.f does not have (ss) set, presumably because the
198 * (ss) on the previous instruction does the job.
200 * The blob driver also seems to set it on WAR hazards, although
201 * not really clear if this is needed or just blob compiler being
202 * sloppy. So far I haven't found a case where removing the (ss)
203 * causes problems for WAR hazard, but I could just be getting
207 * (ss)(rpt2)mad.f32 r3.y, (r)c9.x, r1.x, (r)r3.z
210 IR3_INSTR_SS
= 0x002,
211 /* (jp) flag is set on jump targets:
213 IR3_INSTR_JP
= 0x004,
214 IR3_INSTR_UL
= 0x008,
215 IR3_INSTR_3D
= 0x010,
220 IR3_INSTR_S2EN
= 0x200,
222 IR3_INSTR_SAT
= 0x800,
223 /* (cat5/cat6) Bindless */
224 IR3_INSTR_B
= 0x1000,
225 /* (cat5-only) Get some parts of the encoding from a1.x */
226 IR3_INSTR_A1EN
= 0x2000,
227 /* meta-flags, for intermediate stages of IR, ie.
228 * before register assignment is done:
230 IR3_INSTR_MARK
= 0x4000,
231 IR3_INSTR_UNUSED
= 0x8000,
239 struct ir3_register
**regs
;
245 struct ir3_block
*target
;
248 type_t src_type
, dst_type
;
262 unsigned tex_base
: 3;
269 int iim_val
: 3; /* for ldgb/stgb, # of components */
270 unsigned d
: 3; /* for ldc, component offset */
275 unsigned w
: 1; /* write */
276 unsigned r
: 1; /* read */
277 unsigned l
: 1; /* local */
278 unsigned g
: 1; /* global */
280 /* for meta-instructions, just used to hold extra data
281 * before instruction scheduling, etc
284 int off
; /* component/offset */
287 /* for output collects, this maps back to the entry in the
288 * ir3_shader_variant::outputs table.
294 unsigned input_offset
;
295 unsigned samp_base
: 3;
296 unsigned tex_base
: 3;
299 /* maps back to entry in ir3_shader_variant::inputs table: */
301 /* for sysvals, identifies the sysval type. Mostly so we can
302 * identify the special cases where a sysval should not be DCE'd
303 * (currently, just pre-fs texture fetch)
305 gl_system_value sysval
;
309 /* When we get to the RA stage, we need instruction's position/name: */
313 /* used for per-pass extra instruction data.
315 * TODO we should remove the per-pass data like this and 'use_count'
316 * and do something similar to what RA does w/ ir3_ra_instr_data..
317 * ie. use the ir3_count_instructions pass, and then use instr->ip
318 * to index into a table of pass-private data.
323 * Valid if pass calls ir3_find_ssa_uses().. see foreach_ssa_use()
327 int use_count
; /* currently just updated/used by cp */
329 /* Used during CP and RA stages. For collect and shader inputs/
330 * outputs where we need a sequence of consecutive registers,
331 * keep track of each src instructions left (ie 'n-1') and right
332 * (ie 'n+1') neighbor. The front-end must insert enough mov's
333 * to ensure that each instruction has at most one left and at
334 * most one right neighbor. During the copy-propagation pass,
335 * we only remove mov's when we can preserve this constraint.
336 * And during the RA stage, we use the neighbor information to
337 * allocate a block of registers in one shot.
339 * TODO: maybe just add something like:
340 * struct ir3_instruction_ref {
341 * struct ir3_instruction *instr;
345 * Or can we get away without the refcnt stuff? It seems like
346 * it should be overkill.. the problem is if, potentially after
347 * already eliminating some mov's, if you have a single mov that
348 * needs to be grouped with it's neighbors in two different
349 * places (ex. shader output and a collect).
352 struct ir3_instruction
*left
, *right
;
353 uint16_t left_cnt
, right_cnt
;
356 /* an instruction can reference at most one address register amongst
357 * it's src/dst registers. Beyond that, you need to insert mov's.
359 * NOTE: do not write this directly, use ir3_instr_set_address()
361 struct ir3_instruction
*address
;
363 /* Tracking for additional dependent instructions. Used to handle
364 * barriers, WAR hazards for arrays/SSBOs/etc.
366 DECLARE_ARRAY(struct ir3_instruction
*, deps
);
369 * From PoV of instruction scheduling, not execution (ie. ignores global/
370 * local distinction):
371 * shared image atomic SSBO everything
372 * barrier()/ - R/W R/W R/W R/W X
373 * groupMemoryBarrier()
374 * memoryBarrier() - R/W R/W
375 * (but only images declared coherent?)
376 * memoryBarrierAtomic() - R/W
377 * memoryBarrierBuffer() - R/W
378 * memoryBarrierImage() - R/W
379 * memoryBarrierShared() - R/W
381 * TODO I think for SSBO/image/shared, in cases where we can determine
382 * which variable is accessed, we don't need to care about accesses to
383 * different variables (unless declared coherent??)
386 IR3_BARRIER_EVERYTHING
= 1 << 0,
387 IR3_BARRIER_SHARED_R
= 1 << 1,
388 IR3_BARRIER_SHARED_W
= 1 << 2,
389 IR3_BARRIER_IMAGE_R
= 1 << 3,
390 IR3_BARRIER_IMAGE_W
= 1 << 4,
391 IR3_BARRIER_BUFFER_R
= 1 << 5,
392 IR3_BARRIER_BUFFER_W
= 1 << 6,
393 IR3_BARRIER_ARRAY_R
= 1 << 7,
394 IR3_BARRIER_ARRAY_W
= 1 << 8,
395 } barrier_class
, barrier_conflict
;
397 /* Entry in ir3_block's instruction list: */
398 struct list_head node
;
404 // TODO only computerator/assembler:
408 static inline struct ir3_instruction
*
409 ir3_neighbor_first(struct ir3_instruction
*instr
)
412 while (instr
->cp
.left
) {
413 instr
= instr
->cp
.left
;
414 if (++cnt
> 0xffff) {
422 static inline int ir3_neighbor_count(struct ir3_instruction
*instr
)
426 debug_assert(!instr
->cp
.left
);
428 while (instr
->cp
.right
) {
430 instr
= instr
->cp
.right
;
441 struct ir3_compiler
*compiler
;
442 gl_shader_stage type
;
444 DECLARE_ARRAY(struct ir3_instruction
*, inputs
);
445 DECLARE_ARRAY(struct ir3_instruction
*, outputs
);
447 /* Track bary.f (and ldlv) instructions.. this is needed in
448 * scheduling to ensure that all varying fetches happen before
449 * any potential kill instructions. The hw gets grumpy if all
450 * threads in a group are killed before the last bary.f gets
451 * a chance to signal end of input (ei).
453 DECLARE_ARRAY(struct ir3_instruction
*, baryfs
);
455 /* Track all indirect instructions (read and write). To avoid
456 * deadlock scenario where an address register gets scheduled,
457 * but other dependent src instructions cannot be scheduled due
458 * to dependency on a *different* address register value, the
459 * scheduler needs to ensure that all dependencies other than
460 * the instruction other than the address register are scheduled
461 * before the one that writes the address register. Having a
462 * convenient list of instructions that reference some address
463 * register simplifies this.
465 DECLARE_ARRAY(struct ir3_instruction
*, a0_users
);
468 DECLARE_ARRAY(struct ir3_instruction
*, a1_users
);
470 /* and same for instructions that consume predicate register: */
471 DECLARE_ARRAY(struct ir3_instruction
*, predicates
);
473 /* Track texture sample instructions which need texture state
474 * patched in (for astc-srgb workaround):
476 DECLARE_ARRAY(struct ir3_instruction
*, astc_srgb
);
478 /* List of blocks: */
479 struct list_head block_list
;
481 /* List of ir3_array's: */
482 struct list_head array_list
;
485 unsigned block_count
, instr_count
;
490 struct list_head node
;
494 struct nir_register
*r
;
496 /* To avoid array write's from getting DCE'd, keep track of the
497 * most recent write. Any array access depends on the most
498 * recent write. This way, nothing depends on writes after the
499 * last read. But all the writes that happen before that have
500 * something depending on them
502 struct ir3_instruction
*last_write
;
504 /* extra stuff used in RA pass: */
505 unsigned base
; /* base vreg name */
506 unsigned reg
; /* base physical reg */
507 uint16_t start_ip
, end_ip
;
509 /* Indicates if half-precision */
513 struct ir3_array
* ir3_lookup_array(struct ir3
*ir
, unsigned id
);
516 struct list_head node
;
519 const struct nir_block
*nblock
;
521 struct list_head instr_list
; /* list of ir3_instruction */
523 /* each block has either one or two successors.. in case of
524 * two successors, 'condition' decides which one to follow.
525 * A block preceding an if/else has two successors.
527 struct ir3_instruction
*condition
;
528 struct ir3_block
*successors
[2];
530 struct set
*predecessors
; /* set of ir3_block */
532 uint16_t start_ip
, end_ip
;
534 /* Track instructions which do not write a register but other-
535 * wise must not be discarded (such as kill, stg, etc)
537 DECLARE_ARRAY(struct ir3_instruction
*, keeps
);
539 /* used for per-pass extra block data. Mainly used right
540 * now in RA step to track livein/liveout.
549 static inline uint32_t
550 block_id(struct ir3_block
*block
)
553 return block
->serialno
;
555 return (uint32_t)(unsigned long)block
;
559 struct ir3
* ir3_create(struct ir3_compiler
*compiler
, gl_shader_stage type
);
560 void ir3_destroy(struct ir3
*shader
);
561 void * ir3_assemble(struct ir3
*shader
,
562 struct ir3_info
*info
, uint32_t gpu_id
);
563 void * ir3_alloc(struct ir3
*shader
, int sz
);
565 struct ir3_block
* ir3_block_create(struct ir3
*shader
);
567 struct ir3_instruction
* ir3_instr_create(struct ir3_block
*block
, opc_t opc
);
568 struct ir3_instruction
* ir3_instr_create2(struct ir3_block
*block
,
569 opc_t opc
, int nreg
);
570 struct ir3_instruction
* ir3_instr_clone(struct ir3_instruction
*instr
);
571 void ir3_instr_add_dep(struct ir3_instruction
*instr
, struct ir3_instruction
*dep
);
572 const char *ir3_instr_name(struct ir3_instruction
*instr
);
574 struct ir3_register
* ir3_reg_create(struct ir3_instruction
*instr
,
576 struct ir3_register
* ir3_reg_clone(struct ir3
*shader
,
577 struct ir3_register
*reg
);
579 void ir3_instr_set_address(struct ir3_instruction
*instr
,
580 struct ir3_instruction
*addr
);
582 static inline bool ir3_instr_check_mark(struct ir3_instruction
*instr
)
584 if (instr
->flags
& IR3_INSTR_MARK
)
585 return true; /* already visited */
586 instr
->flags
|= IR3_INSTR_MARK
;
590 void ir3_block_clear_mark(struct ir3_block
*block
);
591 void ir3_clear_mark(struct ir3
*shader
);
593 unsigned ir3_count_instructions(struct ir3
*ir
);
594 unsigned ir3_count_instructions_ra(struct ir3
*ir
);
596 void ir3_find_ssa_uses(struct ir3
*ir
, void *mem_ctx
, bool falsedeps
);
598 void ir3_set_dst_type(struct ir3_instruction
*instr
, bool half
);
599 void ir3_fixup_src_type(struct ir3_instruction
*instr
);
601 #include "util/set.h"
602 #define foreach_ssa_use(__use, __instr) \
603 for (struct ir3_instruction *__use = (void *)~0; \
604 __use && (__instr)->uses; __use = NULL) \
605 set_foreach ((__instr)->uses, __entry) \
606 if ((__use = (void *)__entry->key))
608 #define MAX_ARRAYS 16
616 static inline uint32_t regid(int num
, int comp
)
618 return (num
<< 2) | (comp
& 0x3);
621 static inline uint32_t reg_num(struct ir3_register
*reg
)
623 return reg
->num
>> 2;
626 static inline uint32_t reg_comp(struct ir3_register
*reg
)
628 return reg
->num
& 0x3;
631 #define INVALID_REG regid(63, 0)
632 #define VALIDREG(r) ((r) != INVALID_REG)
633 #define CONDREG(r, val) COND(VALIDREG(r), (val))
635 static inline bool is_flow(struct ir3_instruction
*instr
)
637 return (opc_cat(instr
->opc
) == 0);
640 static inline bool is_kill(struct ir3_instruction
*instr
)
642 return instr
->opc
== OPC_KILL
;
645 static inline bool is_nop(struct ir3_instruction
*instr
)
647 return instr
->opc
== OPC_NOP
;
650 static inline bool is_same_type_reg(struct ir3_register
*reg1
,
651 struct ir3_register
*reg2
)
653 unsigned type_reg1
= (reg1
->flags
& (IR3_REG_HIGH
| IR3_REG_HALF
));
654 unsigned type_reg2
= (reg2
->flags
& (IR3_REG_HIGH
| IR3_REG_HALF
));
656 if (type_reg1
^ type_reg2
)
662 /* Is it a non-transformative (ie. not type changing) mov? This can
663 * also include absneg.s/absneg.f, which for the most part can be
664 * treated as a mov (single src argument).
666 static inline bool is_same_type_mov(struct ir3_instruction
*instr
)
668 struct ir3_register
*dst
;
670 switch (instr
->opc
) {
672 if (instr
->cat1
.src_type
!= instr
->cat1
.dst_type
)
674 /* If the type of dest reg and src reg are different,
675 * it shouldn't be considered as same type mov
677 if (!is_same_type_reg(instr
->regs
[0], instr
->regs
[1]))
682 if (instr
->flags
& IR3_INSTR_SAT
)
684 /* If the type of dest reg and src reg are different,
685 * it shouldn't be considered as same type mov
687 if (!is_same_type_reg(instr
->regs
[0], instr
->regs
[1]))
694 dst
= instr
->regs
[0];
696 /* mov's that write to a0 or p0.x are special: */
697 if (dst
->num
== regid(REG_P0
, 0))
699 if (reg_num(dst
) == REG_A0
)
702 if (dst
->flags
& (IR3_REG_RELATIV
| IR3_REG_ARRAY
))
708 /* A move from const, which changes size but not type, can also be
709 * folded into dest instruction in some cases.
711 static inline bool is_const_mov(struct ir3_instruction
*instr
)
713 if (instr
->opc
!= OPC_MOV
)
716 if (!(instr
->regs
[1]->flags
& IR3_REG_CONST
))
719 type_t src_type
= instr
->cat1
.src_type
;
720 type_t dst_type
= instr
->cat1
.dst_type
;
722 return (type_float(src_type
) && type_float(dst_type
)) ||
723 (type_uint(src_type
) && type_uint(dst_type
)) ||
724 (type_sint(src_type
) && type_sint(dst_type
));
727 static inline bool is_alu(struct ir3_instruction
*instr
)
729 return (1 <= opc_cat(instr
->opc
)) && (opc_cat(instr
->opc
) <= 3);
732 static inline bool is_sfu(struct ir3_instruction
*instr
)
734 return (opc_cat(instr
->opc
) == 4);
737 static inline bool is_tex(struct ir3_instruction
*instr
)
739 return (opc_cat(instr
->opc
) == 5);
742 static inline bool is_tex_or_prefetch(struct ir3_instruction
*instr
)
744 return is_tex(instr
) || (instr
->opc
== OPC_META_TEX_PREFETCH
);
747 static inline bool is_mem(struct ir3_instruction
*instr
)
749 return (opc_cat(instr
->opc
) == 6);
752 static inline bool is_barrier(struct ir3_instruction
*instr
)
754 return (opc_cat(instr
->opc
) == 7);
758 is_half(struct ir3_instruction
*instr
)
760 return !!(instr
->regs
[0]->flags
& IR3_REG_HALF
);
764 is_high(struct ir3_instruction
*instr
)
766 return !!(instr
->regs
[0]->flags
& IR3_REG_HIGH
);
770 is_store(struct ir3_instruction
*instr
)
772 /* these instructions, the "destination" register is
773 * actually a source, the address to store to.
775 switch (instr
->opc
) {
790 static inline bool is_load(struct ir3_instruction
*instr
)
792 switch (instr
->opc
) {
802 /* probably some others too.. */
809 static inline bool is_input(struct ir3_instruction
*instr
)
811 /* in some cases, ldlv is used to fetch varying without
812 * interpolation.. fortunately inloc is the first src
813 * register in either case
815 switch (instr
->opc
) {
824 static inline bool is_bool(struct ir3_instruction
*instr
)
826 switch (instr
->opc
) {
837 cat3_half_opc(opc_t opc
)
840 case OPC_MAD_F32
: return OPC_MAD_F16
;
841 case OPC_SEL_B32
: return OPC_SEL_B16
;
842 case OPC_SEL_S32
: return OPC_SEL_S16
;
843 case OPC_SEL_F32
: return OPC_SEL_F16
;
844 case OPC_SAD_S32
: return OPC_SAD_S16
;
850 cat3_full_opc(opc_t opc
)
853 case OPC_MAD_F16
: return OPC_MAD_F32
;
854 case OPC_SEL_B16
: return OPC_SEL_B32
;
855 case OPC_SEL_S16
: return OPC_SEL_S32
;
856 case OPC_SEL_F16
: return OPC_SEL_F32
;
857 case OPC_SAD_S16
: return OPC_SAD_S32
;
863 cat4_half_opc(opc_t opc
)
866 case OPC_RSQ
: return OPC_HRSQ
;
867 case OPC_LOG2
: return OPC_HLOG2
;
868 case OPC_EXP2
: return OPC_HEXP2
;
874 cat4_full_opc(opc_t opc
)
877 case OPC_HRSQ
: return OPC_RSQ
;
878 case OPC_HLOG2
: return OPC_LOG2
;
879 case OPC_HEXP2
: return OPC_EXP2
;
884 static inline bool is_meta(struct ir3_instruction
*instr
)
886 return (opc_cat(instr
->opc
) == -1);
889 static inline unsigned dest_regs(struct ir3_instruction
*instr
)
891 if ((instr
->regs_count
== 0) || is_store(instr
) || is_flow(instr
))
894 return util_last_bit(instr
->regs
[0]->wrmask
);
898 writes_gpr(struct ir3_instruction
*instr
)
900 if (dest_regs(instr
) == 0)
902 /* is dest a normal temp register: */
903 struct ir3_register
*reg
= instr
->regs
[0];
904 debug_assert(!(reg
->flags
& (IR3_REG_CONST
| IR3_REG_IMMED
)));
905 if ((reg_num(reg
) == REG_A0
) ||
906 (reg
->num
== regid(REG_P0
, 0)))
911 static inline bool writes_addr0(struct ir3_instruction
*instr
)
913 if (instr
->regs_count
> 0) {
914 struct ir3_register
*dst
= instr
->regs
[0];
915 return dst
->num
== regid(REG_A0
, 0);
920 static inline bool writes_addr1(struct ir3_instruction
*instr
)
922 if (instr
->regs_count
> 0) {
923 struct ir3_register
*dst
= instr
->regs
[0];
924 return dst
->num
== regid(REG_A0
, 1);
929 static inline bool writes_pred(struct ir3_instruction
*instr
)
931 if (instr
->regs_count
> 0) {
932 struct ir3_register
*dst
= instr
->regs
[0];
933 return reg_num(dst
) == REG_P0
;
938 /* returns defining instruction for reg */
939 /* TODO better name */
940 static inline struct ir3_instruction
*ssa(struct ir3_register
*reg
)
942 if (reg
->flags
& (IR3_REG_SSA
| IR3_REG_ARRAY
)) {
948 static inline bool conflicts(struct ir3_instruction
*a
,
949 struct ir3_instruction
*b
)
951 return (a
&& b
) && (a
!= b
);
954 static inline bool reg_gpr(struct ir3_register
*r
)
956 if (r
->flags
& (IR3_REG_CONST
| IR3_REG_IMMED
))
958 if ((reg_num(r
) == REG_A0
) || (reg_num(r
) == REG_P0
))
963 static inline type_t
half_type(type_t type
)
966 case TYPE_F32
: return TYPE_F16
;
967 case TYPE_U32
: return TYPE_U16
;
968 case TYPE_S32
: return TYPE_S16
;
979 static inline type_t
full_type(type_t type
)
982 case TYPE_F16
: return TYPE_F32
;
983 case TYPE_U16
: return TYPE_U32
;
984 case TYPE_S16
: return TYPE_S32
;
995 /* some cat2 instructions (ie. those which are not float) can embed an
998 static inline bool ir3_cat2_int(opc_t opc
)
1038 /* map cat2 instruction to valid abs/neg flags: */
1039 static inline unsigned ir3_cat2_absneg(opc_t opc
)
1056 return IR3_REG_FABS
| IR3_REG_FNEG
;
1077 return IR3_REG_SABS
| IR3_REG_SNEG
;
1091 return IR3_REG_BNOT
;
1098 /* map cat3 instructions to valid abs/neg flags: */
1099 static inline unsigned ir3_cat3_absneg(opc_t opc
)
1106 return IR3_REG_FNEG
;
1118 /* neg *may* work on 3rd src.. */
1128 #define MASK(n) ((1 << (n)) - 1)
1130 /* iterator for an instructions's sources (reg), also returns src #: */
1131 #define foreach_src_n(__srcreg, __n, __instr) \
1132 if ((__instr)->regs_count) \
1133 for (struct ir3_register *__srcreg = (void *)~0; __srcreg; __srcreg = NULL) \
1134 for (unsigned __cnt = (__instr)->regs_count - 1, __n = 0; __n < __cnt; __n++) \
1135 if ((__srcreg = (__instr)->regs[__n + 1]))
1137 /* iterator for an instructions's sources (reg): */
1138 #define foreach_src(__srcreg, __instr) \
1139 foreach_src_n(__srcreg, __i, __instr)
1141 static inline unsigned __ssa_src_cnt(struct ir3_instruction
*instr
)
1143 unsigned cnt
= instr
->regs_count
+ instr
->deps_count
;
1149 static inline struct ir3_instruction
**
1150 __ssa_srcp_n(struct ir3_instruction
*instr
, unsigned n
)
1152 if (n
== (instr
->regs_count
+ instr
->deps_count
))
1153 return &instr
->address
;
1154 if (n
>= instr
->regs_count
)
1155 return &instr
->deps
[n
- instr
->regs_count
];
1156 if (ssa(instr
->regs
[n
]))
1157 return &instr
->regs
[n
]->instr
;
1161 static inline bool __is_false_dep(struct ir3_instruction
*instr
, unsigned n
)
1163 if (n
== (instr
->regs_count
+ instr
->deps_count
))
1165 if (n
>= instr
->regs_count
)
1170 #define foreach_ssa_srcp_n(__srcp, __n, __instr) \
1171 for (struct ir3_instruction **__srcp = (void *)~0; __srcp; __srcp = NULL) \
1172 for (unsigned __cnt = __ssa_src_cnt(__instr), __n = 0; __n < __cnt; __n++) \
1173 if ((__srcp = __ssa_srcp_n(__instr, __n)))
1175 #define foreach_ssa_srcp(__srcp, __instr) \
1176 foreach_ssa_srcp_n(__srcp, __i, __instr)
1178 /* iterator for an instruction's SSA sources (instr), also returns src #: */
1179 #define foreach_ssa_src_n(__srcinst, __n, __instr) \
1180 for (struct ir3_instruction *__srcinst = (void *)~0; __srcinst; __srcinst = NULL) \
1181 foreach_ssa_srcp_n(__srcp, __n, __instr) \
1182 if ((__srcinst = *__srcp))
1184 /* iterator for an instruction's SSA sources (instr): */
1185 #define foreach_ssa_src(__srcinst, __instr) \
1186 foreach_ssa_src_n(__srcinst, __i, __instr)
1188 /* iterators for shader inputs: */
1189 #define foreach_input_n(__ininstr, __cnt, __ir) \
1190 for (struct ir3_instruction *__ininstr = (void *)~0; __ininstr; __ininstr = NULL) \
1191 for (unsigned __cnt = 0; __cnt < (__ir)->inputs_count; __cnt++) \
1192 if ((__ininstr = (__ir)->inputs[__cnt]))
1193 #define foreach_input(__ininstr, __ir) \
1194 foreach_input_n(__ininstr, __i, __ir)
1196 /* iterators for shader outputs: */
1197 #define foreach_output_n(__outinstr, __cnt, __ir) \
1198 for (struct ir3_instruction *__outinstr = (void *)~0; __outinstr; __outinstr = NULL) \
1199 for (unsigned __cnt = 0; __cnt < (__ir)->outputs_count; __cnt++) \
1200 if ((__outinstr = (__ir)->outputs[__cnt]))
1201 #define foreach_output(__outinstr, __ir) \
1202 foreach_output_n(__outinstr, __i, __ir)
1204 /* iterators for instructions: */
1205 #define foreach_instr(__instr, __list) \
1206 list_for_each_entry(struct ir3_instruction, __instr, __list, node)
1207 #define foreach_instr_rev(__instr, __list) \
1208 list_for_each_entry_rev(struct ir3_instruction, __instr, __list, node)
1209 #define foreach_instr_safe(__instr, __list) \
1210 list_for_each_entry_safe(struct ir3_instruction, __instr, __list, node)
1212 /* iterators for blocks: */
1213 #define foreach_block(__block, __list) \
1214 list_for_each_entry(struct ir3_block, __block, __list, node)
1215 #define foreach_block_safe(__block, __list) \
1216 list_for_each_entry_safe(struct ir3_block, __block, __list, node)
1217 #define foreach_block_rev(__block, __list) \
1218 list_for_each_entry_rev(struct ir3_block, __block, __list, node)
1220 /* iterators for arrays: */
1221 #define foreach_array(__array, __list) \
1222 list_for_each_entry(struct ir3_array, __array, __list, node)
1224 /* Check if condition is true for any src instruction.
1227 check_src_cond(struct ir3_instruction
*instr
, bool (*cond
)(struct ir3_instruction
*))
1229 /* Note that this is also used post-RA so skip the ssa iterator: */
1230 foreach_src (reg
, instr
) {
1231 struct ir3_instruction
*src
= reg
->instr
;
1236 /* meta:split/collect aren't real instructions, the thing that
1237 * we actually care about is *their* srcs
1239 if ((src
->opc
== OPC_META_SPLIT
) || (src
->opc
== OPC_META_COLLECT
)) {
1240 if (check_src_cond(src
, cond
))
1251 #define IR3_PASS(ir, pass, ...) ({ \
1252 bool progress = pass(ir, ##__VA_ARGS__); \
1254 ir3_debug_print(ir, "AFTER: " #pass); \
1261 void ir3_validate(struct ir3
*ir
);
1264 void ir3_print(struct ir3
*ir
);
1265 void ir3_print_instr(struct ir3_instruction
*instr
);
1267 /* delay calculation: */
1268 int ir3_delayslots(struct ir3_instruction
*assigner
,
1269 struct ir3_instruction
*consumer
, unsigned n
, bool soft
);
1270 unsigned ir3_delay_calc(struct ir3_block
*block
, struct ir3_instruction
*instr
,
1271 bool soft
, bool pred
);
1272 void ir3_remove_nops(struct ir3
*ir
);
1274 /* dead code elimination: */
1275 struct ir3_shader_variant
;
1276 bool ir3_dce(struct ir3
*ir
, struct ir3_shader_variant
*so
);
1278 /* fp16 conversion folding */
1279 bool ir3_cf(struct ir3
*ir
);
1281 /* copy-propagate: */
1282 bool ir3_cp(struct ir3
*ir
, struct ir3_shader_variant
*so
);
1284 /* group neighbors and insert mov's to resolve conflicts: */
1285 bool ir3_group(struct ir3
*ir
);
1288 bool ir3_sched_add_deps(struct ir3
*ir
);
1289 int ir3_sched(struct ir3
*ir
);
1292 bool ir3_postsched(struct ir3
*ir
);
1294 bool ir3_a6xx_fixup_atomic_dests(struct ir3
*ir
, struct ir3_shader_variant
*so
);
1296 /* register assignment: */
1297 struct ir3_ra_reg_set
* ir3_ra_alloc_reg_set(struct ir3_compiler
*compiler
);
1298 int ir3_ra(struct ir3_shader_variant
*v
, struct ir3_instruction
**precolor
, unsigned nprecolor
);
1301 bool ir3_legalize(struct ir3
*ir
, struct ir3_shader_variant
*so
, int *max_bary
);
1304 ir3_has_latency_to_hide(struct ir3
*ir
)
1306 /* VS/GS/TCS/TESS co-exist with frag shader invocations, but we don't
1307 * know the nature of the fragment shader. Just assume it will have
1310 if (ir
->type
!= MESA_SHADER_FRAGMENT
)
1313 foreach_block (block
, &ir
->block_list
) {
1314 foreach_instr (instr
, &block
->instr_list
) {
1315 if (is_tex_or_prefetch(instr
))
1318 if (is_load(instr
)) {
1319 switch (instr
->opc
) {
1334 /* ************************************************************************* */
1335 /* instruction helpers */
1337 /* creates SSA src of correct type (ie. half vs full precision) */
1338 static inline struct ir3_register
* __ssa_src(struct ir3_instruction
*instr
,
1339 struct ir3_instruction
*src
, unsigned flags
)
1341 struct ir3_register
*reg
;
1342 if (src
->regs
[0]->flags
& IR3_REG_HALF
)
1343 flags
|= IR3_REG_HALF
;
1344 reg
= ir3_reg_create(instr
, 0, IR3_REG_SSA
| flags
);
1346 reg
->wrmask
= src
->regs
[0]->wrmask
;
1350 static inline struct ir3_register
* __ssa_dst(struct ir3_instruction
*instr
)
1352 struct ir3_register
*reg
= ir3_reg_create(instr
, 0, 0);
1353 reg
->flags
|= IR3_REG_SSA
;
1357 static inline struct ir3_instruction
*
1358 create_immed_typed(struct ir3_block
*block
, uint32_t val
, type_t type
)
1360 struct ir3_instruction
*mov
;
1361 unsigned flags
= (type_size(type
) < 32) ? IR3_REG_HALF
: 0;
1363 mov
= ir3_instr_create(block
, OPC_MOV
);
1364 mov
->cat1
.src_type
= type
;
1365 mov
->cat1
.dst_type
= type
;
1366 __ssa_dst(mov
)->flags
|= flags
;
1367 ir3_reg_create(mov
, 0, IR3_REG_IMMED
| flags
)->uim_val
= val
;
1372 static inline struct ir3_instruction
*
1373 create_immed(struct ir3_block
*block
, uint32_t val
)
1375 return create_immed_typed(block
, val
, TYPE_U32
);
1378 static inline struct ir3_instruction
*
1379 create_uniform_typed(struct ir3_block
*block
, unsigned n
, type_t type
)
1381 struct ir3_instruction
*mov
;
1382 unsigned flags
= (type_size(type
) < 32) ? IR3_REG_HALF
: 0;
1384 mov
= ir3_instr_create(block
, OPC_MOV
);
1385 mov
->cat1
.src_type
= type
;
1386 mov
->cat1
.dst_type
= type
;
1387 __ssa_dst(mov
)->flags
|= flags
;
1388 ir3_reg_create(mov
, n
, IR3_REG_CONST
| flags
);
1393 static inline struct ir3_instruction
*
1394 create_uniform(struct ir3_block
*block
, unsigned n
)
1396 return create_uniform_typed(block
, n
, TYPE_F32
);
1399 static inline struct ir3_instruction
*
1400 create_uniform_indirect(struct ir3_block
*block
, int n
,
1401 struct ir3_instruction
*address
)
1403 struct ir3_instruction
*mov
;
1405 mov
= ir3_instr_create(block
, OPC_MOV
);
1406 mov
->cat1
.src_type
= TYPE_U32
;
1407 mov
->cat1
.dst_type
= TYPE_U32
;
1409 ir3_reg_create(mov
, 0, IR3_REG_CONST
| IR3_REG_RELATIV
)->array
.offset
= n
;
1411 ir3_instr_set_address(mov
, address
);
1416 static inline struct ir3_instruction
*
1417 ir3_MOV(struct ir3_block
*block
, struct ir3_instruction
*src
, type_t type
)
1419 struct ir3_instruction
*instr
= ir3_instr_create(block
, OPC_MOV
);
1420 unsigned flags
= (type_size(type
) < 32) ? IR3_REG_HALF
: 0;
1422 __ssa_dst(instr
)->flags
|= flags
;
1423 if (src
->regs
[0]->flags
& IR3_REG_ARRAY
) {
1424 struct ir3_register
*src_reg
= __ssa_src(instr
, src
, IR3_REG_ARRAY
);
1425 src_reg
->array
= src
->regs
[0]->array
;
1427 __ssa_src(instr
, src
, src
->regs
[0]->flags
& IR3_REG_HIGH
);
1429 debug_assert(!(src
->regs
[0]->flags
& IR3_REG_RELATIV
));
1430 instr
->cat1
.src_type
= type
;
1431 instr
->cat1
.dst_type
= type
;
1435 static inline struct ir3_instruction
*
1436 ir3_COV(struct ir3_block
*block
, struct ir3_instruction
*src
,
1437 type_t src_type
, type_t dst_type
)
1439 struct ir3_instruction
*instr
= ir3_instr_create(block
, OPC_MOV
);
1440 unsigned dst_flags
= (type_size(dst_type
) < 32) ? IR3_REG_HALF
: 0;
1441 unsigned src_flags
= (type_size(src_type
) < 32) ? IR3_REG_HALF
: 0;
1443 debug_assert((src
->regs
[0]->flags
& IR3_REG_HALF
) == src_flags
);
1445 __ssa_dst(instr
)->flags
|= dst_flags
;
1446 __ssa_src(instr
, src
, 0);
1447 instr
->cat1
.src_type
= src_type
;
1448 instr
->cat1
.dst_type
= dst_type
;
1449 debug_assert(!(src
->regs
[0]->flags
& IR3_REG_ARRAY
));
1453 static inline struct ir3_instruction
*
1454 ir3_NOP(struct ir3_block
*block
)
1456 return ir3_instr_create(block
, OPC_NOP
);
1459 #define IR3_INSTR_0 0
1461 #define __INSTR0(flag, name, opc) \
1462 static inline struct ir3_instruction * \
1463 ir3_##name(struct ir3_block *block) \
1465 struct ir3_instruction *instr = \
1466 ir3_instr_create(block, opc); \
1467 instr->flags |= flag; \
1470 #define INSTR0F(f, name) __INSTR0(IR3_INSTR_##f, name##_##f, OPC_##name)
1471 #define INSTR0(name) __INSTR0(0, name, OPC_##name)
1473 #define __INSTR1(flag, name, opc) \
1474 static inline struct ir3_instruction * \
1475 ir3_##name(struct ir3_block *block, \
1476 struct ir3_instruction *a, unsigned aflags) \
1478 struct ir3_instruction *instr = \
1479 ir3_instr_create(block, opc); \
1481 __ssa_src(instr, a, aflags); \
1482 instr->flags |= flag; \
1485 #define INSTR1F(f, name) __INSTR1(IR3_INSTR_##f, name##_##f, OPC_##name)
1486 #define INSTR1(name) __INSTR1(0, name, OPC_##name)
1488 #define __INSTR2(flag, name, opc) \
1489 static inline struct ir3_instruction * \
1490 ir3_##name(struct ir3_block *block, \
1491 struct ir3_instruction *a, unsigned aflags, \
1492 struct ir3_instruction *b, unsigned bflags) \
1494 struct ir3_instruction *instr = \
1495 ir3_instr_create(block, opc); \
1497 __ssa_src(instr, a, aflags); \
1498 __ssa_src(instr, b, bflags); \
1499 instr->flags |= flag; \
1502 #define INSTR2F(f, name) __INSTR2(IR3_INSTR_##f, name##_##f, OPC_##name)
1503 #define INSTR2(name) __INSTR2(0, name, OPC_##name)
1505 #define __INSTR3(flag, name, opc) \
1506 static inline struct ir3_instruction * \
1507 ir3_##name(struct ir3_block *block, \
1508 struct ir3_instruction *a, unsigned aflags, \
1509 struct ir3_instruction *b, unsigned bflags, \
1510 struct ir3_instruction *c, unsigned cflags) \
1512 struct ir3_instruction *instr = \
1513 ir3_instr_create2(block, opc, 4); \
1515 __ssa_src(instr, a, aflags); \
1516 __ssa_src(instr, b, bflags); \
1517 __ssa_src(instr, c, cflags); \
1518 instr->flags |= flag; \
1521 #define INSTR3F(f, name) __INSTR3(IR3_INSTR_##f, name##_##f, OPC_##name)
1522 #define INSTR3(name) __INSTR3(0, name, OPC_##name)
1524 #define __INSTR4(flag, name, opc) \
1525 static inline struct ir3_instruction * \
1526 ir3_##name(struct ir3_block *block, \
1527 struct ir3_instruction *a, unsigned aflags, \
1528 struct ir3_instruction *b, unsigned bflags, \
1529 struct ir3_instruction *c, unsigned cflags, \
1530 struct ir3_instruction *d, unsigned dflags) \
1532 struct ir3_instruction *instr = \
1533 ir3_instr_create2(block, opc, 5); \
1535 __ssa_src(instr, a, aflags); \
1536 __ssa_src(instr, b, bflags); \
1537 __ssa_src(instr, c, cflags); \
1538 __ssa_src(instr, d, dflags); \
1539 instr->flags |= flag; \
1542 #define INSTR4F(f, name) __INSTR4(IR3_INSTR_##f, name##_##f, OPC_##name)
1543 #define INSTR4(name) __INSTR4(0, name, OPC_##name)
1545 /* cat0 instructions: */
1556 /* cat2 instructions, most 2 src but some 1 src: */
1604 /* cat3 instructions: */
1613 /* NOTE: SEL_B32 checks for zero vs nonzero */
1623 /* cat4 instructions: */
1635 /* cat5 instructions: */
1644 static inline struct ir3_instruction
*
1645 ir3_SAM(struct ir3_block
*block
, opc_t opc
, type_t type
,
1646 unsigned wrmask
, unsigned flags
, struct ir3_instruction
*samp_tex
,
1647 struct ir3_instruction
*src0
, struct ir3_instruction
*src1
)
1649 struct ir3_instruction
*sam
;
1651 sam
= ir3_instr_create(block
, opc
);
1652 sam
->flags
|= flags
;
1653 __ssa_dst(sam
)->wrmask
= wrmask
;
1654 if (flags
& IR3_INSTR_S2EN
) {
1655 __ssa_src(sam
, samp_tex
, IR3_REG_HALF
);
1658 __ssa_src(sam
, src0
, 0);
1661 __ssa_src(sam
, src1
, 0);
1663 sam
->cat5
.type
= type
;
1668 /* cat6 instructions: */
1683 INSTR2(ATOMIC_CMPXCHG
)
1693 INSTR3F(G
, ATOMIC_ADD
)
1694 INSTR3F(G
, ATOMIC_SUB
)
1695 INSTR3F(G
, ATOMIC_XCHG
)
1696 INSTR3F(G
, ATOMIC_INC
)
1697 INSTR3F(G
, ATOMIC_DEC
)
1698 INSTR3F(G
, ATOMIC_CMPXCHG
)
1699 INSTR3F(G
, ATOMIC_MIN
)
1700 INSTR3F(G
, ATOMIC_MAX
)
1701 INSTR3F(G
, ATOMIC_AND
)
1702 INSTR3F(G
, ATOMIC_OR
)
1703 INSTR3F(G
, ATOMIC_XOR
)
1708 INSTR4F(G
, ATOMIC_ADD
)
1709 INSTR4F(G
, ATOMIC_SUB
)
1710 INSTR4F(G
, ATOMIC_XCHG
)
1711 INSTR4F(G
, ATOMIC_INC
)
1712 INSTR4F(G
, ATOMIC_DEC
)
1713 INSTR4F(G
, ATOMIC_CMPXCHG
)
1714 INSTR4F(G
, ATOMIC_MIN
)
1715 INSTR4F(G
, ATOMIC_MAX
)
1716 INSTR4F(G
, ATOMIC_AND
)
1717 INSTR4F(G
, ATOMIC_OR
)
1718 INSTR4F(G
, ATOMIC_XOR
)
1723 /* cat7 instructions: */
1727 /* meta instructions: */
1728 INSTR0(META_TEX_PREFETCH
);
1730 /* ************************************************************************* */
1731 /* split this out or find some helper to use.. like main/bitset.h.. */
1734 #include "util/bitset.h"
1738 typedef BITSET_DECLARE(regmask_t
, 2 * MAX_REG
);
1741 __regmask_get(regmask_t
*regmask
, struct ir3_register
*reg
, unsigned n
)
1744 /* a6xx+ case, with merged register file, we track things in terms
1745 * of half-precision registers, with a full precisions register
1746 * using two half-precision slots:
1748 if (reg
->flags
& IR3_REG_HALF
) {
1749 return BITSET_TEST(*regmask
, n
);
1752 return BITSET_TEST(*regmask
, n
) || BITSET_TEST(*regmask
, n
+1);
1755 /* pre a6xx case, with separate register file for half and full
1758 if (reg
->flags
& IR3_REG_HALF
)
1760 return BITSET_TEST(*regmask
, n
);
1765 __regmask_set(regmask_t
*regmask
, struct ir3_register
*reg
, unsigned n
)
1768 /* a6xx+ case, with merged register file, we track things in terms
1769 * of half-precision registers, with a full precisions register
1770 * using two half-precision slots:
1772 if (reg
->flags
& IR3_REG_HALF
) {
1773 BITSET_SET(*regmask
, n
);
1776 BITSET_SET(*regmask
, n
);
1777 BITSET_SET(*regmask
, n
+1);
1780 /* pre a6xx case, with separate register file for half and full
1783 if (reg
->flags
& IR3_REG_HALF
)
1785 BITSET_SET(*regmask
, n
);
1789 static inline void regmask_init(regmask_t
*regmask
)
1791 memset(regmask
, 0, sizeof(*regmask
));
1794 static inline void regmask_set(regmask_t
*regmask
, struct ir3_register
*reg
)
1796 if (reg
->flags
& IR3_REG_RELATIV
) {
1797 for (unsigned i
= 0; i
< reg
->size
; i
++)
1798 __regmask_set(regmask
, reg
, reg
->array
.offset
+ i
);
1800 for (unsigned mask
= reg
->wrmask
, n
= reg
->num
; mask
; mask
>>= 1, n
++)
1802 __regmask_set(regmask
, reg
, n
);
1806 static inline void regmask_or(regmask_t
*dst
, regmask_t
*a
, regmask_t
*b
)
1809 for (i
= 0; i
< ARRAY_SIZE(*dst
); i
++)
1810 (*dst
)[i
] = (*a
)[i
] | (*b
)[i
];
1813 static inline bool regmask_get(regmask_t
*regmask
,
1814 struct ir3_register
*reg
)
1816 if (reg
->flags
& IR3_REG_RELATIV
) {
1817 for (unsigned i
= 0; i
< reg
->size
; i
++)
1818 if (__regmask_get(regmask
, reg
, reg
->array
.offset
+ i
))
1821 for (unsigned mask
= reg
->wrmask
, n
= reg
->num
; mask
; mask
>>= 1, n
++)
1823 if (__regmask_get(regmask
, reg
, n
))
1829 /* ************************************************************************* */