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 ValueRef
& operator=(Value
*val
) { this->set(val
); return *this; }
390 inline bool exists() const { return value
!= NULL
; }
393 void set(const ValueRef
&);
394 inline Value
*get() const { return value
; }
395 inline Value
*rep() const;
397 inline Instruction
*getInsn() const { return insn
; }
398 inline void setInsn(Instruction
*inst
) { insn
= inst
; }
400 inline bool isIndirect(int dim
) const { return indirect
[dim
] >= 0; }
401 inline const ValueRef
*getIndirect(int dim
) const;
403 inline DataFile
getFile() const;
404 inline unsigned getSize() const;
406 // SSA: return eventual (traverse MOVs) literal value, if it exists
407 ImmediateValue
*getImmediate() const;
411 int8_t indirect
[2]; // >= 0 if relative to lvalue in insn->src[indirect[i]]
414 bool usedAsPtr
; // for printing
425 ValueDef(const ValueDef
&);
428 inline ValueDef
& operator=(Value
*val
) { this->set(val
); return *this; }
430 inline bool exists() const { return value
!= NULL
; }
432 inline Value
*get() const { return value
; }
433 inline Value
*rep() const;
435 void replace(Value
*, bool doSet
); // replace all uses of the old value
437 inline Instruction
*getInsn() const { return insn
; }
438 inline void setInsn(Instruction
*inst
) { insn
= inst
; }
440 inline DataFile
getFile() const;
441 inline unsigned getSize() const;
443 inline void setSSA(LValue
*);
444 inline const LValue
*preSSA() const;
447 Value
*value
; // should make this LValue * ...
448 LValue
*origin
; // pre SSA value
457 virtual Value
*clone(Function
*) const { return NULL
; }
459 virtual int print(char *, size_t, DataType ty
= TYPE_NONE
) const = 0;
461 virtual bool equals(const Value
*, bool strict
= false) const;
462 virtual bool interfers(const Value
*) const;
464 inline Instruction
*getUniqueInsn() const;
465 inline Instruction
*getInsn() const; // use when uniqueness is certain
467 inline int refCount() { return uses
.size(); }
469 inline LValue
*asLValue();
470 inline Symbol
*asSym();
471 inline ImmediateValue
*asImm();
472 inline const Symbol
*asSym() const;
473 inline const ImmediateValue
*asImm() const;
475 bool coalesce(Value
*, bool force
= false);
477 inline bool inFile(DataFile f
) { return reg
.file
== f
; }
479 static inline Value
*get(Iterator
&);
481 std::list
<ValueRef
*> uses
;
482 std::list
<ValueDef
*> defs
;
483 typedef std::list
<ValueRef
*>::iterator UseIterator
;
484 typedef std::list
<ValueRef
*>::const_iterator UseCIterator
;
485 typedef std::list
<ValueDef
*>::iterator DefIterator
;
486 typedef std::list
<ValueDef
*>::const_iterator DefCIterator
;
491 // TODO: these should be in LValue:
496 class LValue
: public Value
499 LValue(Function
*, DataFile file
);
500 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);
517 virtual Value
*clone(Function
*) const;
519 virtual bool equals(const Value
*that
, bool strict
) const;
521 virtual int print(char *, size_t, DataType ty
= TYPE_NONE
) const;
523 // print with indirect values
524 int print(char *, size_t, Value
*, Value
*, DataType ty
= TYPE_NONE
) const;
526 inline void setFile(DataFile file
, ubyte fileIndex
= 0)
529 reg
.fileIndex
= fileIndex
;
532 inline void setOffset(int32_t offset
);
533 inline void setAddress(Symbol
*base
, int32_t offset
);
534 inline void setSV(SVSemantic sv
, uint32_t idx
= 0);
536 inline const Symbol
*getBase() const { return baseSym
; }
539 Symbol
*baseSym
; // array base for Symbols representing array elements
542 class ImmediateValue
: public Value
545 ImmediateValue(Program
*, uint32_t);
546 ImmediateValue(Program
*, float);
547 ImmediateValue(Program
*, double);
549 // NOTE: not added to program with
550 ImmediateValue(const ImmediateValue
*, DataType ty
);
552 virtual bool equals(const Value
*that
, bool strict
) const;
554 // these only work if 'type' is valid (we mostly use untyped literals):
555 bool isInteger(const int ival
) const; // ival is cast to this' type
556 bool isNegative() const;
561 // for constant folding:
562 ImmediateValue
operator+(const ImmediateValue
&) const;
563 ImmediateValue
operator-(const ImmediateValue
&) const;
564 ImmediateValue
operator*(const ImmediateValue
&) const;
565 ImmediateValue
operator/(const ImmediateValue
&) const;
567 bool compare(CondCode cc
, float fval
) const;
569 virtual int print(char *, size_t, DataType ty
= TYPE_NONE
) const;
576 Instruction(Function
*, operation
, DataType
);
577 virtual ~Instruction();
579 virtual Instruction
*clone(bool deep
) const;
581 void setDef(int i
, Value
*);
582 void setSrc(int s
, Value
*);
583 void setSrc(int s
, const ValueRef
&);
584 void swapSources(int a
, int b
);
585 bool setIndirect(int s
, int dim
, Value
*);
587 inline Value
*getDef(int d
) const { return def
[d
].get(); }
588 inline Value
*getSrc(int s
) const { return src
[s
].get(); }
589 inline Value
*getIndirect(int s
, int dim
) const;
591 inline bool defExists(unsigned d
) const
593 return d
< def
.size() && def
[d
].exists();
595 inline bool srcExists(unsigned s
) const
597 return s
< src
.size() && src
[s
].exists();
600 inline bool constrainedDefs() const { return defExists(1); }
602 bool setPredicate(CondCode ccode
, Value
*);
603 inline Value
*getPredicate() const;
604 bool writesPredicate() const;
606 inline void setFlagsSrc(int s
, Value
*);
607 inline void setFlagsDef(int d
, Value
*);
609 unsigned int defCount(unsigned int mask
) const;
610 unsigned int srcCount(unsigned int mask
) const;
612 // save & remove / set indirect[0,1] and predicate source
613 void takeExtraSources(int s
, Value
*[3]);
614 void putExtraSources(int s
, Value
*[3]);
616 inline void setType(DataType type
) { dType
= sType
= type
; }
618 inline void setType(DataType dtype
, DataType stype
)
624 inline bool isPseudo() const { return op
< OP_MOV
; }
627 bool isCommutationLegal(const Instruction
*) const; // must be adjacent !
628 bool isActionEqual(const Instruction
*) const;
629 bool isResultEqual(const Instruction
*) const;
633 inline CmpInstruction
*asCmp();
634 inline TexInstruction
*asTex();
635 inline FlowInstruction
*asFlow();
636 inline const TexInstruction
*asTex() const;
637 inline const CmpInstruction
*asCmp() const;
638 inline const FlowInstruction
*asFlow() const;
644 int serial
; // CFG order
647 DataType dType
; // destination or defining type
648 DataType sType
; // source or secondary type
653 uint8_t subOp
; // quadop, 1 for mul-high, etc.
655 unsigned encSize
: 4; // encoding size in bytes
656 unsigned saturate
: 1; // to [0.0f, 1.0f]
657 unsigned join
: 1; // converge control flow (use OP_JOIN until end)
658 unsigned fixed
: 1; // prevent dead code elimination
659 unsigned terminator
: 1; // end of basic block
661 unsigned ftz
: 1; // flush denormal to zero
662 unsigned dnz
: 1; // denormals, NaN are zero
663 unsigned ipa
: 4; // interpolation mode
665 unsigned perPatch
: 1;
666 unsigned exit
: 1; // terminate program after insn
668 int8_t postFactor
; // MUL/DIV(if < 0) by 1 << postFactor
674 std::deque
<ValueDef
> def
; // no gaps !
675 std::deque
<ValueRef
> src
; // no gaps !
679 // instruction specific methods:
680 // (don't want to subclass, would need more constructors and memory pools)
682 inline void setInterpolate(unsigned int mode
) { ipa
= mode
; }
684 unsigned int getInterpMode() const { return ipa
& 0x3; }
685 unsigned int getSampleMode() const { return ipa
& 0xc; }
690 void cloneBase(Instruction
*clone
, bool deep
) const;
704 class TexInstruction
: public Instruction
710 Target(TexTarget targ
= TEX_TARGET_2D
) : target(targ
) { }
712 const char *getName() const { return descTable
[target
].name
; }
713 unsigned int getArgCount() const { return descTable
[target
].argc
; }
714 unsigned int getDim() const { return descTable
[target
].dim
; }
715 int isArray() const { return descTable
[target
].array
? 1 : 0; }
716 int isCube() const { return descTable
[target
].cube
? 1 : 0; }
717 int isShadow() const { return descTable
[target
].shadow
? 1 : 0; }
719 Target
& operator=(TexTarget targ
)
721 assert(targ
< TEX_TARGET_COUNT
);
725 inline bool operator==(TexTarget targ
) const { return target
== targ
; }
738 static const struct Desc descTable
[TEX_TARGET_COUNT
];
741 enum TexTarget target
;
745 TexInstruction(Function
*, operation
);
746 virtual ~TexInstruction();
748 virtual Instruction
*clone(bool deep
) const;
750 inline void setTexture(Target targ
, uint8_t r
, uint8_t s
)
757 inline Value
*getIndirectR() const;
758 inline Value
*getIndirectS() const;
772 bool liveOnly
; // only execute on live pixels of a quad (optimization)
776 int8_t useOffsets
; // 0, 1, or 4 for textureGatherOffsets
786 class CmpInstruction
: public Instruction
789 CmpInstruction(Function
*, operation
);
791 virtual Instruction
*clone(bool deep
) const;
793 void setCondition(CondCode cond
) { setCond
= cond
; }
794 CondCode
getCondition() const { return setCond
; }
800 class FlowInstruction
: public Instruction
803 FlowInstruction(Function
*, operation
, BasicBlock
*target
);
806 unsigned allWarp
: 1;
807 unsigned absolute
: 1;
809 unsigned builtin
: 1; // true for calls to emulation code
821 BasicBlock(Function
*);
824 inline int getId() const { return id
; }
825 inline unsigned int getInsnCount() const { return numInsns
; }
826 inline bool isTerminated() const { return exit
&& exit
->terminator
; }
828 bool dominatedBy(BasicBlock
*bb
);
829 inline bool reachableBy(BasicBlock
*by
, BasicBlock
*term
);
831 // returns mask of conditional out blocks
832 // e.g. 3 for IF { .. } ELSE { .. } ENDIF, 1 for IF { .. } ENDIF
833 unsigned int initiatesSimpleConditional() const;
836 Function
*getFunction() const { return func
; }
837 Program
*getProgram() const { return program
; }
839 Instruction
*getEntry() const { return entry
; } // first non-phi instruction
840 Instruction
*getPhi() const { return phi
; }
841 Instruction
*getFirst() const { return phi
? phi
: entry
; }
842 Instruction
*getExit() const { return exit
; }
844 void insertHead(Instruction
*);
845 void insertTail(Instruction
*);
846 void insertBefore(Instruction
*, Instruction
*);
847 void insertAfter(Instruction
*, Instruction
*);
848 void remove(Instruction
*);
849 void permuteAdjacent(Instruction
*, Instruction
*);
851 BasicBlock
*idom() const;
853 // NOTE: currently does not rebuild the dominator tree
854 BasicBlock
*splitBefore(Instruction
*, bool attach
= true);
855 BasicBlock
*splitAfter(Instruction
*, bool attach
= true);
857 DLList
& getDF() { return df
; }
858 DLList::Iterator
iterDF() { return df
.iterator(); }
860 static inline BasicBlock
*get(Iterator
&);
861 static inline BasicBlock
*get(Graph::Node
*);
864 Graph::Node cfg
; // first edge is branch *taken* (the ELSE branch)
872 Instruction
*joinAt
; // for quick reference
874 bool explicitCont
; // loop headers: true if loop contains continue stmts
884 unsigned int numInsns
;
890 void splitCommon(Instruction
*, BasicBlock
*, bool attach
);
896 Function(Program
*, const char *name
);
899 inline Program
*getProgram() const { return prog
; }
900 inline const char *getName() const { return name
; }
901 inline int getId() const { return id
; }
904 void printLiveIntervals() const;
905 void printCFGraph(const char *filePath
);
907 bool setEntry(BasicBlock
*);
908 bool setExit(BasicBlock
*);
910 unsigned int orderInstructions(ArrayList
&);
912 inline void add(BasicBlock
*bb
, int& id
) { allBBlocks
.insert(bb
, id
); }
913 inline void add(Instruction
*insn
, int& id
) { allInsns
.insert(insn
, id
); }
914 inline void add(LValue
*lval
, int& id
) { allLValues
.insert(lval
, id
); }
916 inline LValue
*getLValue(int id
);
922 Graph::Node
*cfgExit
;
924 Graph::Node call
; // node in the call graph
926 BasicBlock
**bbArray
; // BBs in emission order
929 unsigned int loopNestingBound
;
935 ArrayList allBBlocks
;
937 ArrayList allLValues
;
940 void buildLiveSetsPreSSA(BasicBlock
*, const int sequence
);
944 const char *const name
;
951 CG_STAGE_SSA
, // expected directly before register allocation
961 TYPE_TESSELLATION_CONTROL
,
962 TYPE_TESSELLATION_EVAL
,
968 Program(Type type
, Target
*targ
);
973 Type
getType() const { return progType
; }
975 inline void add(Function
*fn
, int& id
) { allFuncs
.insert(fn
, id
); }
976 inline void add(Value
*rval
, int& id
) { allRValues
.insert(rval
, id
); }
978 bool makeFromTGSI(struct nv50_ir_prog_info
*);
979 bool makeFromSM4(struct nv50_ir_prog_info
*);
981 bool optimizeSSA(int level
);
982 bool optimizePostRA(int level
);
983 bool registerAllocation();
984 bool emitBinary(struct nv50_ir_prog_info
*);
986 const Target
*getTarget() const { return target
; }
997 ArrayList allRValues
;
1004 MemoryPool mem_Instruction
;
1005 MemoryPool mem_CmpInstruction
;
1006 MemoryPool mem_TexInstruction
;
1007 MemoryPool mem_FlowInstruction
;
1008 MemoryPool mem_LValue
;
1009 MemoryPool mem_Symbol
;
1010 MemoryPool mem_ImmediateValue
;
1014 void releaseInstruction(Instruction
*);
1015 void releaseValue(Value
*);
1018 // TODO: add const version
1022 bool run(Program
*, bool ordered
= false, bool skipPhi
= false);
1023 bool run(Function
*, bool ordered
= false, bool skipPhi
= false);
1026 // return false to continue with next entity on next higher level
1027 virtual bool visit(Function
*) { return true; }
1028 virtual bool visit(BasicBlock
*) { return true; }
1029 virtual bool visit(Instruction
*) { return false; }
1031 bool doRun(Program
*, bool ordered
, bool skipPhi
);
1032 bool doRun(Function
*, bool ordered
, bool skipPhi
);
1040 // =============================================================================
1042 #include "nv50_ir_inlines.h"
1044 } // namespace nv50_ir
1046 #endif // __NV50_IR_H__