2 * Copyright 2011 Christoph Bumiller
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 shall be included in
12 * all copies or substantial portions of the Software.
14 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
17 * THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
18 * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF
19 * OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
33 #include "nv50_ir_util.h"
34 #include "nv50_ir_graph.h"
36 #include "nv50_ir_driver.h"
44 OP_UNION
, // unify a new definition and several source values
45 OP_SPLIT
, // $r0d -> { $r0, $r1 } ($r0d and $r0/$r1 will be coalesced)
46 OP_MERGE
, // opposite of split, e.g. combine 2 32 bit into a 64 bit value
47 OP_CONSTRAINT
, // copy values into consecutive registers
58 OP_SAD
, // abs(src0 - src1) + src2
69 OP_SAT
, // CLAMP(f32, 0.0, 1.0)
74 OP_SET_AND
, // dst = (src0 CMP src1) & src2
78 OP_SELP
, // dst = src2 ? src0 : src1
79 OP_SLCT
, // dst = (src2 CMP 0) ? src0 : src1
86 OP_EXP
, // exponential (base M_E)
87 OP_LOG
, // natural logarithm
100 OP_BRKPT
, // breakpoint (not related to loops)
101 OP_JOINAT
, // push control flow convergence point
106 OP_VFETCH
, // indirection 0 in attribute space, indirection 1 is vertex base
107 OP_PFETCH
, // fetch base address of vertex src0 (immediate) [+ src1]
111 OP_EMIT
, // emit vertex
112 OP_RESTART
, // restart primitive
114 OP_TXB
, // texture bias
115 OP_TXL
, // texure lod
116 OP_TXF
, // texel fetch
117 OP_TXQ
, // texture size query
118 OP_TXD
, // texture derivatives
119 OP_TXG
, // texture gather
121 OP_SULD
, // surface load
122 OP_SUST
, // surface store
125 OP_RDSV
, // read system value
126 OP_WRSV
, // write system value
131 OP_POPCNT
, // bitcount(src0 & src1)
132 OP_INSBF
, // insert first src1[8:15] bits of src0 into src2 at src1[0:7]
137 #define NV50_IR_SUBOP_MUL_HIGH 1
138 #define NV50_IR_SUBOP_EMIT_RESTART 1
139 #define NV50_IR_SUBOP_LDC_IL 1
140 #define NV50_IR_SUBOP_LDC_IS 2
141 #define NV50_IR_SUBOP_LDC_ISL 3
142 #define NV50_IR_SUBOP_SHIFT_WRAP 1
153 TYPE_U64
, // 64 bit operations are only lowered after register allocation
165 CC_NEVER
= CC_FL
, // when used with FILE_FLAGS
168 CC_NOT_P
= CC_EQ
, // when used with FILE_PREDICATE
196 ROUND_M
, // towards -inf
197 ROUND_Z
, // towards 0
198 ROUND_P
, // towards +inf
199 ROUND_NI
, // nearest integer
200 ROUND_MI
, // to integer towards -inf
201 ROUND_ZI
, // to integer towards 0
202 ROUND_PI
, // to integer towards +inf
207 CACHE_CA
, // cache at all levels
208 CACHE_WB
= CACHE_CA
, // cache write back
209 CACHE_CG
, // cache at global level
210 CACHE_CS
, // cache streaming
211 CACHE_CV
, // cache as volatile
212 CACHE_WT
= CACHE_CV
// cache write-through
219 FILE_PREDICATE
, // boolean predicate
220 FILE_FLAGS
, // zero/sign/carry/overflow bits
240 TEX_TARGET_1D_SHADOW
,
241 TEX_TARGET_2D_SHADOW
,
242 TEX_TARGET_CUBE_SHADOW
,
245 TEX_TARGET_2D_MS_ARRAY
,
246 TEX_TARGET_CUBE_ARRAY
,
247 TEX_TARGET_1D_ARRAY_SHADOW
,
248 TEX_TARGET_2D_ARRAY_SHADOW
,
250 TEX_TARGET_RECT_SHADOW
,
251 TEX_TARGET_CUBE_ARRAY_SHADOW
,
263 SV_VERTEX_COUNT
, // gl_PatchVerticesIn
296 class CmpInstruction
;
297 class TexInstruction
;
298 class FlowInstruction
;
303 class ImmediateValue
;
308 int8_t fileIndex
; // signed, may be indirect for CONST[]
309 uint8_t size
; // this should match the Instruction type's size
310 DataType type
; // mainly for pretty printing
312 uint64_t u64
; // immediate values
322 int32_t offset
; // offset from 0 (base of address space)
323 int32_t id
; // register id (< 0 if virtual/unassigned)
331 // precedence: NOT after SAT after NEG after ABS
332 #define NV50_IR_MOD_ABS (1 << 0)
333 #define NV50_IR_MOD_NEG (1 << 1)
334 #define NV50_IR_MOD_SAT (1 << 2)
335 #define NV50_IR_MOD_NOT (1 << 3)
336 #define NV50_IR_MOD_NEG_ABS (NV50_IR_MOD_NEG | NV50_IR_MOD_ABS)
338 #define NV50_IR_INTERP_MODE_MASK 0x3
339 #define NV50_IR_INTERP_LINEAR (0 << 0)
340 #define NV50_IR_INTERP_PERSPECTIVE (1 << 0)
341 #define NV50_IR_INTERP_FLAT (2 << 0)
342 #define NV50_IR_INTERP_SC (3 << 0) // what exactly is that ?
343 #define NV50_IR_INTERP_SAMPLE_MASK 0xc
344 #define NV50_IR_INTERP_DEFAULT (0 << 2)
345 #define NV50_IR_INTERP_CENTROID (1 << 2)
346 #define NV50_IR_INTERP_OFFSET (2 << 2)
347 #define NV50_IR_INTERP_SAMPLEID (3 << 2)
349 // do we really want this to be a class ?
353 Modifier() : bits(0) { }
354 Modifier(unsigned int m
) : bits(m
) { }
355 Modifier(operation op
);
357 // @return new Modifier applying a after b (asserts if unrepresentable)
358 Modifier
operator*(const Modifier
) const;
359 Modifier
operator==(const Modifier m
) const { return m
.bits
== bits
; }
360 Modifier
operator!=(const Modifier m
) const { return m
.bits
!= bits
; }
362 inline Modifier
operator&(const Modifier m
) const { return bits
& m
.bits
; }
363 inline Modifier
operator|(const Modifier m
) const { return bits
| m
.bits
; }
364 inline Modifier
operator^(const Modifier m
) const { return bits
^ m
.bits
; }
366 operation
getOp() const;
368 inline int neg() const { return (bits
& NV50_IR_MOD_NEG
) ? 1 : 0; }
369 inline int abs() const { return (bits
& NV50_IR_MOD_ABS
) ? 1 : 0; }
371 inline operator bool() { return bits
? true : false; }
373 void applyTo(ImmediateValue
&imm
) const;
375 int print(char *buf
, size_t size
) const;
385 ValueRef(const ValueRef
&);
388 inline bool exists() const { return value
!= NULL
; }
391 void set(const ValueRef
&);
392 inline Value
*get() const { return value
; }
393 inline Value
*rep() const;
395 inline Instruction
*getInsn() const { return insn
; }
396 inline void setInsn(Instruction
*inst
) { insn
= inst
; }
398 inline bool isIndirect(int dim
) const { return indirect
[dim
] >= 0; }
399 inline const ValueRef
*getIndirect(int dim
) const;
401 inline DataFile
getFile() const;
402 inline unsigned getSize() const;
404 // SSA: return eventual (traverse MOVs) literal value, if it exists
405 ImmediateValue
*getImmediate() const;
409 int8_t indirect
[2]; // >= 0 if relative to lvalue in insn->src(indirect[i])
412 bool usedAsPtr
; // for printing
423 ValueDef(const ValueDef
&);
426 inline bool exists() const { return value
!= NULL
; }
428 inline Value
*get() const { return value
; }
429 inline Value
*rep() const;
431 void replace(Value
*, bool doSet
); // replace all uses of the old value
433 inline Instruction
*getInsn() const { return insn
; }
434 inline void setInsn(Instruction
*inst
) { insn
= inst
; }
436 inline DataFile
getFile() const;
437 inline unsigned getSize() const;
439 inline void setSSA(LValue
*);
440 inline const LValue
*preSSA() const;
443 Value
*value
; // should make this LValue * ...
444 LValue
*origin
; // pre SSA value
454 virtual Value
*clone(Function
*) const { return NULL
; }
456 virtual int print(char *, size_t, DataType ty
= TYPE_NONE
) const = 0;
458 virtual bool equals(const Value
*, bool strict
= false) const;
459 virtual bool interfers(const Value
*) const;
461 inline Value
*rep() const { return join
; }
463 inline Instruction
*getUniqueInsn() const;
464 inline Instruction
*getInsn() const; // use when uniqueness is certain
466 inline int refCount() { return uses
.size(); }
468 inline LValue
*asLValue();
469 inline Symbol
*asSym();
470 inline ImmediateValue
*asImm();
471 inline const Symbol
*asSym() const;
472 inline const ImmediateValue
*asImm() const;
474 bool coalesce(Value
*, bool force
= false);
476 inline bool inFile(DataFile f
) { return reg
.file
== f
; }
478 static inline Value
*get(Iterator
&);
480 std::list
<ValueRef
*> uses
;
481 std::list
<ValueDef
*> defs
;
482 typedef std::list
<ValueRef
*>::iterator UseIterator
;
483 typedef std::list
<ValueRef
*>::const_iterator UseCIterator
;
484 typedef std::list
<ValueDef
*>::iterator DefIterator
;
485 typedef std::list
<ValueDef
*>::const_iterator DefCIterator
;
490 // TODO: these should be in LValue:
495 class LValue
: public Value
498 LValue(Function
*, DataFile file
);
499 LValue(Function
*, LValue
*);
502 virtual Value
*clone(Function
*) const;
504 virtual int print(char *, size_t, DataType ty
= TYPE_NONE
) const;
512 class Symbol
: public Value
515 Symbol(Program
*, DataFile file
= FILE_MEMORY_CONST
, ubyte fileIdx
= 0);
518 virtual Value
*clone(Function
*) const;
520 virtual bool equals(const Value
*that
, bool strict
) const;
522 virtual int print(char *, size_t, DataType ty
= TYPE_NONE
) const;
524 // print with indirect values
525 int print(char *, size_t, Value
*, Value
*, DataType ty
= TYPE_NONE
) const;
527 inline void setFile(DataFile file
, ubyte fileIndex
= 0)
530 reg
.fileIndex
= fileIndex
;
533 inline void setOffset(int32_t offset
);
534 inline void setAddress(Symbol
*base
, int32_t offset
);
535 inline void setSV(SVSemantic sv
, uint32_t idx
= 0);
537 inline const Symbol
*getBase() const { return baseSym
; }
540 Symbol
*baseSym
; // array base for Symbols representing array elements
543 class ImmediateValue
: public Value
546 ImmediateValue(Program
*, uint32_t);
547 ImmediateValue(Program
*, float);
548 ImmediateValue(Program
*, double);
549 // NOTE: not added to program with
550 ImmediateValue(const ImmediateValue
*, DataType ty
);
551 ~ImmediateValue() { };
553 virtual bool equals(const Value
*that
, bool strict
) const;
555 // these only work if 'type' is valid (we mostly use untyped literals):
556 bool isInteger(const int ival
) const; // ival is cast to this' type
557 bool isNegative() const;
562 // for constant folding:
563 ImmediateValue
operator+(const ImmediateValue
&) const;
564 ImmediateValue
operator-(const ImmediateValue
&) const;
565 ImmediateValue
operator*(const ImmediateValue
&) const;
566 ImmediateValue
operator/(const ImmediateValue
&) const;
568 bool compare(CondCode cc
, float fval
) const;
570 virtual int print(char *, size_t, DataType ty
= TYPE_NONE
) const;
577 Instruction(Function
*, operation
, DataType
);
578 virtual ~Instruction();
580 virtual Instruction
*clone(bool deep
) const;
582 void setDef(int i
, Value
*);
583 void setSrc(int s
, Value
*);
584 void setSrc(int s
, const ValueRef
&);
585 void swapSources(int a
, int b
);
586 bool setIndirect(int s
, int dim
, Value
*);
588 inline ValueRef
& src(int s
) { return srcs
[s
]; }
589 inline ValueDef
& def(int s
) { return defs
[s
]; }
590 inline const ValueRef
& src(int s
) const { return srcs
[s
]; }
591 inline const ValueDef
& def(int s
) const { return defs
[s
]; }
593 inline Value
*getDef(int d
) const { return defs
[d
].get(); }
594 inline Value
*getSrc(int s
) const { return srcs
[s
].get(); }
595 inline Value
*getIndirect(int s
, int dim
) const;
597 inline bool defExists(unsigned d
) const
599 return d
< defs
.size() && defs
[d
].exists();
601 inline bool srcExists(unsigned s
) const
603 return s
< srcs
.size() && srcs
[s
].exists();
606 inline bool constrainedDefs() const { return defExists(1); }
608 bool setPredicate(CondCode ccode
, Value
*);
609 inline Value
*getPredicate() const;
610 bool writesPredicate() const;
612 inline void setFlagsSrc(int s
, Value
*);
613 inline void setFlagsDef(int d
, Value
*);
615 unsigned int defCount() const { return defs
.size(); };
616 unsigned int defCount(unsigned int mask
) const;
617 unsigned int srcCount() const { return srcs
.size(); };
618 unsigned int srcCount(unsigned int mask
) const;
620 // save & remove / set indirect[0,1] and predicate source
621 void takeExtraSources(int s
, Value
*[3]);
622 void putExtraSources(int s
, Value
*[3]);
624 inline void setType(DataType type
) { dType
= sType
= type
; }
626 inline void setType(DataType dtype
, DataType stype
)
632 inline bool isPseudo() const { return op
< OP_MOV
; }
635 bool isCommutationLegal(const Instruction
*) const; // must be adjacent !
636 bool isActionEqual(const Instruction
*) const;
637 bool isResultEqual(const Instruction
*) const;
641 inline CmpInstruction
*asCmp();
642 inline TexInstruction
*asTex();
643 inline FlowInstruction
*asFlow();
644 inline const TexInstruction
*asTex() const;
645 inline const CmpInstruction
*asCmp() const;
646 inline const FlowInstruction
*asFlow() const;
652 int serial
; // CFG order
655 DataType dType
; // destination or defining type
656 DataType sType
; // source or secondary type
661 uint8_t subOp
; // quadop, 1 for mul-high, etc.
663 unsigned encSize
: 4; // encoding size in bytes
664 unsigned saturate
: 1; // to [0.0f, 1.0f]
665 unsigned join
: 1; // converge control flow (use OP_JOIN until end)
666 unsigned fixed
: 1; // prevent dead code elimination
667 unsigned terminator
: 1; // end of basic block
669 unsigned ftz
: 1; // flush denormal to zero
670 unsigned dnz
: 1; // denormals, NaN are zero
671 unsigned ipa
: 4; // interpolation mode
673 unsigned perPatch
: 1;
674 unsigned exit
: 1; // terminate program after insn
676 int8_t postFactor
; // MUL/DIV(if < 0) by 1 << postFactor
685 std::deque
<ValueDef
> defs
; // no gaps !
686 std::deque
<ValueRef
> srcs
; // no gaps !
688 // instruction specific methods:
689 // (don't want to subclass, would need more constructors and memory pools)
691 inline void setInterpolate(unsigned int mode
) { ipa
= mode
; }
693 unsigned int getInterpMode() const { return ipa
& 0x3; }
694 unsigned int getSampleMode() const { return ipa
& 0xc; }
699 void cloneBase(Instruction
*clone
, bool deep
) const;
713 class TexInstruction
: public Instruction
719 Target(TexTarget targ
= TEX_TARGET_2D
) : target(targ
) { }
721 const char *getName() const { return descTable
[target
].name
; }
722 unsigned int getArgCount() const { return descTable
[target
].argc
; }
723 unsigned int getDim() const { return descTable
[target
].dim
; }
724 int isArray() const { return descTable
[target
].array
? 1 : 0; }
725 int isCube() const { return descTable
[target
].cube
? 1 : 0; }
726 int isShadow() const { return descTable
[target
].shadow
? 1 : 0; }
728 Target
& operator=(TexTarget targ
)
730 assert(targ
< TEX_TARGET_COUNT
);
734 inline bool operator==(TexTarget targ
) const { return target
== targ
; }
747 static const struct Desc descTable
[TEX_TARGET_COUNT
];
750 enum TexTarget target
;
754 TexInstruction(Function
*, operation
);
755 virtual ~TexInstruction();
757 virtual Instruction
*clone(bool deep
) const;
759 inline void setTexture(Target targ
, uint8_t r
, uint8_t s
)
766 inline Value
*getIndirectR() const;
767 inline Value
*getIndirectS() const;
781 bool liveOnly
; // only execute on live pixels of a quad (optimization)
785 int8_t useOffsets
; // 0, 1, or 4 for textureGatherOffsets
795 class CmpInstruction
: public Instruction
798 CmpInstruction(Function
*, operation
);
800 virtual Instruction
*clone(bool deep
) const;
802 void setCondition(CondCode cond
) { setCond
= cond
; }
803 CondCode
getCondition() const { return setCond
; }
809 class FlowInstruction
: public Instruction
812 FlowInstruction(Function
*, operation
, BasicBlock
*target
);
815 unsigned allWarp
: 1;
816 unsigned absolute
: 1;
818 unsigned builtin
: 1; // true for calls to emulation code
830 BasicBlock(Function
*);
833 inline int getId() const { return id
; }
834 inline unsigned int getInsnCount() const { return numInsns
; }
835 inline bool isTerminated() const { return exit
&& exit
->terminator
; }
837 bool dominatedBy(BasicBlock
*bb
);
838 inline bool reachableBy(BasicBlock
*by
, BasicBlock
*term
);
840 // returns mask of conditional out blocks
841 // e.g. 3 for IF { .. } ELSE { .. } ENDIF, 1 for IF { .. } ENDIF
842 unsigned int initiatesSimpleConditional() const;
845 Function
*getFunction() const { return func
; }
846 Program
*getProgram() const { return program
; }
848 Instruction
*getEntry() const { return entry
; } // first non-phi instruction
849 Instruction
*getPhi() const { return phi
; }
850 Instruction
*getFirst() const { return phi
? phi
: entry
; }
851 Instruction
*getExit() const { return exit
; }
853 void insertHead(Instruction
*);
854 void insertTail(Instruction
*);
855 void insertBefore(Instruction
*, Instruction
*);
856 void insertAfter(Instruction
*, Instruction
*);
857 void remove(Instruction
*);
858 void permuteAdjacent(Instruction
*, Instruction
*);
860 BasicBlock
*idom() const;
862 // NOTE: currently does not rebuild the dominator tree
863 BasicBlock
*splitBefore(Instruction
*, bool attach
= true);
864 BasicBlock
*splitAfter(Instruction
*, bool attach
= true);
866 DLList
& getDF() { return df
; }
867 DLList::Iterator
iterDF() { return df
.iterator(); }
869 static inline BasicBlock
*get(Iterator
&);
870 static inline BasicBlock
*get(Graph::Node
*);
873 Graph::Node cfg
; // first edge is branch *taken* (the ELSE branch)
881 Instruction
*joinAt
; // for quick reference
883 bool explicitCont
; // loop headers: true if loop contains continue stmts
893 unsigned int numInsns
;
899 void splitCommon(Instruction
*, BasicBlock
*, bool attach
);
905 Function(Program
*, const char *name
);
908 inline Program
*getProgram() const { return prog
; }
909 inline const char *getName() const { return name
; }
910 inline int getId() const { return id
; }
913 void printLiveIntervals() const;
914 void printCFGraph(const char *filePath
);
916 bool setEntry(BasicBlock
*);
917 bool setExit(BasicBlock
*);
919 unsigned int orderInstructions(ArrayList
&);
921 inline void add(BasicBlock
*bb
, int& id
) { allBBlocks
.insert(bb
, id
); }
922 inline void add(Instruction
*insn
, int& id
) { allInsns
.insert(insn
, id
); }
923 inline void add(LValue
*lval
, int& id
) { allLValues
.insert(lval
, id
); }
925 inline LValue
*getLValue(int id
);
931 Graph::Node
*cfgExit
;
933 Graph::Node call
; // node in the call graph
935 BasicBlock
**bbArray
; // BBs in emission order
938 unsigned int loopNestingBound
;
944 ArrayList allBBlocks
;
946 ArrayList allLValues
;
949 void buildLiveSetsPreSSA(BasicBlock
*, const int sequence
);
953 const char *const name
;
960 CG_STAGE_SSA
, // expected directly before register allocation
970 TYPE_TESSELLATION_CONTROL
,
971 TYPE_TESSELLATION_EVAL
,
977 Program(Type type
, Target
*targ
);
982 Type
getType() const { return progType
; }
984 inline void add(Function
*fn
, int& id
) { allFuncs
.insert(fn
, id
); }
985 inline void add(Value
*rval
, int& id
) { allRValues
.insert(rval
, id
); }
987 bool makeFromTGSI(struct nv50_ir_prog_info
*);
988 bool makeFromSM4(struct nv50_ir_prog_info
*);
990 bool optimizeSSA(int level
);
991 bool optimizePostRA(int level
);
992 bool registerAllocation();
993 bool emitBinary(struct nv50_ir_prog_info
*);
995 const Target
*getTarget() const { return target
; }
1006 ArrayList allRValues
;
1013 MemoryPool mem_Instruction
;
1014 MemoryPool mem_CmpInstruction
;
1015 MemoryPool mem_TexInstruction
;
1016 MemoryPool mem_FlowInstruction
;
1017 MemoryPool mem_LValue
;
1018 MemoryPool mem_Symbol
;
1019 MemoryPool mem_ImmediateValue
;
1023 void releaseInstruction(Instruction
*);
1024 void releaseValue(Value
*);
1027 // TODO: add const version
1031 bool run(Program
*, bool ordered
= false, bool skipPhi
= false);
1032 bool run(Function
*, bool ordered
= false, bool skipPhi
= false);
1035 // return false to continue with next entity on next higher level
1036 virtual bool visit(Function
*) { return true; }
1037 virtual bool visit(BasicBlock
*) { return true; }
1038 virtual bool visit(Instruction
*) { return false; }
1040 bool doRun(Program
*, bool ordered
, bool skipPhi
);
1041 bool doRun(Function
*, bool ordered
, bool skipPhi
);
1049 // =============================================================================
1051 #include "nv50_ir_inlines.h"
1053 } // namespace nv50_ir
1055 #endif // __NV50_IR_H__