1 //===- RISCVCompressInstEmitter.cpp - Generator for RISCV Compression -===//
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4 // See https://llvm.org/LICENSE.txt for license information.
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
7 // RISCVCompressInstEmitter implements a tablegen-driven CompressPat based
8 // RISCV Instruction Compression mechanism.
10 //===--------------------------------------------------------------===//
12 // RISCVCompressInstEmitter implements a tablegen-driven CompressPat Instruction
13 // Compression mechanism for generating RISCV compressed instructions
14 // (C ISA Extension) from the expanded instruction form.
16 // This tablegen backend processes CompressPat declarations in a
17 // td file and generates all the required checks to validate the pattern
18 // declarations; validate the input and output operands to generate the correct
19 // compressed instructions. The checks include validating different types of
20 // operands; register operands, immediate operands, fixed register and fixed
24 // class CompressPat<dag input, dag output> {
26 // dag Output = output;
27 // list<Predicate> Predicates = [];
30 // let Predicates = [HasStdExtC] in {
31 // def : CompressPat<(ADD GPRNoX0:$rs1, GPRNoX0:$rs1, GPRNoX0:$rs2),
32 // (C_ADD GPRNoX0:$rs1, GPRNoX0:$rs2)>;
35 // The result is an auto-generated header file
36 // 'RISCVGenCompressInstEmitter.inc' which exports two functions for
37 // compressing/uncompressing MCInst instructions, plus
38 // some helper functions:
40 // bool compressInst(MCInst &OutInst, const MCInst &MI,
41 // const MCSubtargetInfo &STI,
42 // MCContext &Context);
44 // bool uncompressInst(MCInst &OutInst, const MCInst &MI,
45 // const MCRegisterInfo &MRI,
46 // const MCSubtargetInfo &STI);
48 // In addition, it exports a function for checking whether
49 // an instruction is compressable:
51 // bool isCompressibleInst(const MachineInstr& MI,
52 // const RISCVSubtarget *Subtarget,
53 // const MCRegisterInfo &MRI,
54 // const MCSubtargetInfo &STI);
56 // The clients that include this auto-generated header file and
57 // invoke these functions can compress an instruction before emitting
58 // it in the target-specific ASM or ELF streamer or can uncompress
59 // an instruction before printing it when the expanded instruction
60 // format aliases is favored.
62 //===----------------------------------------------------------------------===//
64 #include "CodeGenInstruction.h"
65 #include "CodeGenTarget.h"
66 #include "llvm/ADT/IndexedMap.h"
67 #include "llvm/ADT/SmallVector.h"
68 #include "llvm/ADT/StringExtras.h"
69 #include "llvm/ADT/StringMap.h"
70 #include "llvm/Support/Debug.h"
71 #include "llvm/Support/ErrorHandling.h"
72 #include "llvm/TableGen/Error.h"
73 #include "llvm/TableGen/Record.h"
74 #include "llvm/TableGen/TableGenBackend.h"
79 #define DEBUG_TYPE "compress-inst-emitter"
82 class RISCVCompressInstEmitter
{
84 enum MapKind
{ Operand
, Imm
, Reg
};
87 unsigned Operand
; // Operand number mapped to.
88 int64_t Imm
; // Integer immediate value.
89 Record
*Reg
; // Physical register.
91 int TiedOpIdx
= -1; // Tied operand index within the instruction.
94 CodeGenInstruction Source
; // The source instruction definition.
95 CodeGenInstruction Dest
; // The destination instruction to transform to.
97 PatReqFeatures
; // Required target features to enable pattern.
99 SourceOperandMap
; // Maps operands in the Source Instruction to
100 // the corresponding Dest instruction operand.
102 DestOperandMap
; // Maps operands in the Dest Instruction
103 // to the corresponding Source instruction operand.
105 CompressPat(CodeGenInstruction
&S
, CodeGenInstruction
&D
,
106 std::vector
<Record
*> RF
, IndexedMap
<OpData
> &SourceMap
,
107 IndexedMap
<OpData
> &DestMap
, bool IsCompressOnly
)
108 : Source(S
), Dest(D
), PatReqFeatures(RF
), SourceOperandMap(SourceMap
),
109 DestOperandMap(DestMap
), IsCompressOnly(IsCompressOnly
) {}
111 enum EmitterType
{ Compress
, Uncompress
, CheckCompress
};
112 RecordKeeper
&Records
;
113 CodeGenTarget Target
;
114 SmallVector
<CompressPat
, 4> CompressPatterns
;
116 void addDagOperandMapping(Record
*Rec
, DagInit
*Dag
, CodeGenInstruction
&Inst
,
117 IndexedMap
<OpData
> &OperandMap
, bool IsSourceInst
);
118 void evaluateCompressPat(Record
*Compress
);
119 void emitCompressInstEmitter(raw_ostream
&o
, EmitterType EType
);
120 bool validateTypes(Record
*SubType
, Record
*Type
, bool IsSourceInst
);
121 bool validateRegister(Record
*Reg
, Record
*RegClass
);
122 void createDagOperandMapping(Record
*Rec
, StringMap
<unsigned> &SourceOperands
,
123 StringMap
<unsigned> &DestOperands
,
124 DagInit
*SourceDag
, DagInit
*DestDag
,
125 IndexedMap
<OpData
> &SourceOperandMap
);
127 void createInstOperandMapping(Record
*Rec
, DagInit
*SourceDag
,
129 IndexedMap
<OpData
> &SourceOperandMap
,
130 IndexedMap
<OpData
> &DestOperandMap
,
131 StringMap
<unsigned> &SourceOperands
,
132 CodeGenInstruction
&DestInst
);
135 RISCVCompressInstEmitter(RecordKeeper
&R
) : Records(R
), Target(R
) {}
137 void run(raw_ostream
&o
);
139 } // End anonymous namespace.
141 bool RISCVCompressInstEmitter::validateRegister(Record
*Reg
, Record
*RegClass
) {
142 assert(Reg
->isSubClassOf("Register") && "Reg record should be a Register");
143 assert(RegClass
->isSubClassOf("RegisterClass") &&
144 "RegClass record should be a RegisterClass");
145 const CodeGenRegisterClass
&RC
= Target
.getRegisterClass(RegClass
);
146 const CodeGenRegister
*R
= Target
.getRegisterByName(Reg
->getName().lower());
147 assert((R
!= nullptr) && "Register not defined!!");
148 return RC
.contains(R
);
151 bool RISCVCompressInstEmitter::validateTypes(Record
*DagOpType
,
154 if (DagOpType
== InstOpType
)
156 // Only source instruction operands are allowed to not match Input Dag
161 if (DagOpType
->isSubClassOf("RegisterClass") &&
162 InstOpType
->isSubClassOf("RegisterClass")) {
163 const CodeGenRegisterClass
&RC
= Target
.getRegisterClass(InstOpType
);
164 const CodeGenRegisterClass
&SubRC
= Target
.getRegisterClass(DagOpType
);
165 return RC
.hasSubClass(&SubRC
);
168 // At this point either or both types are not registers, reject the pattern.
169 if (DagOpType
->isSubClassOf("RegisterClass") ||
170 InstOpType
->isSubClassOf("RegisterClass"))
173 // Let further validation happen when compress()/uncompress() functions are
175 LLVM_DEBUG(dbgs() << (IsSourceInst
? "Input" : "Output")
176 << " Dag Operand Type: '" << DagOpType
->getName()
178 << "Instruction Operand Type: '" << InstOpType
->getName()
179 << "' can't be checked at pattern validation time!\n");
183 /// The patterns in the Dag contain different types of operands:
184 /// Register operands, e.g.: GPRC:$rs1; Fixed registers, e.g: X1; Immediate
185 /// operands, e.g.: simm6:$imm; Fixed immediate operands, e.g.: 0. This function
186 /// maps Dag operands to its corresponding instruction operands. For register
187 /// operands and fixed registers it expects the Dag operand type to be contained
188 /// in the instantiated instruction operand type. For immediate operands and
189 /// immediates no validation checks are enforced at pattern validation time.
190 void RISCVCompressInstEmitter::addDagOperandMapping(
191 Record
*Rec
, DagInit
*Dag
, CodeGenInstruction
&Inst
,
192 IndexedMap
<OpData
> &OperandMap
, bool IsSourceInst
) {
193 // TiedCount keeps track of the number of operands skipped in Inst
194 // operands list to get to the corresponding Dag operand. This is
195 // necessary because the number of operands in Inst might be greater
196 // than number of operands in the Dag due to how tied operands
198 unsigned TiedCount
= 0;
199 for (unsigned i
= 0, e
= Inst
.Operands
.size(); i
!= e
; ++i
) {
200 int TiedOpIdx
= Inst
.Operands
[i
].getTiedRegister();
201 if (-1 != TiedOpIdx
) {
202 // Set the entry in OperandMap for the tied operand we're skipping.
203 OperandMap
[i
].Kind
= OperandMap
[TiedOpIdx
].Kind
;
204 OperandMap
[i
].Data
= OperandMap
[TiedOpIdx
].Data
;
208 if (DefInit
*DI
= dyn_cast
<DefInit
>(Dag
->getArg(i
- TiedCount
))) {
209 if (DI
->getDef()->isSubClassOf("Register")) {
210 // Check if the fixed register belongs to the Register class.
211 if (!validateRegister(DI
->getDef(), Inst
.Operands
[i
].Rec
))
212 PrintFatalError(Rec
->getLoc(),
213 "Error in Dag '" + Dag
->getAsString() +
214 "'Register: '" + DI
->getDef()->getName() +
215 "' is not in register class '" +
216 Inst
.Operands
[i
].Rec
->getName() + "'");
217 OperandMap
[i
].Kind
= OpData::Reg
;
218 OperandMap
[i
].Data
.Reg
= DI
->getDef();
221 // Validate that Dag operand type matches the type defined in the
222 // corresponding instruction. Operands in the input Dag pattern are
223 // allowed to be a subclass of the type specified in corresponding
224 // instruction operand instead of being an exact match.
225 if (!validateTypes(DI
->getDef(), Inst
.Operands
[i
].Rec
, IsSourceInst
))
226 PrintFatalError(Rec
->getLoc(),
227 "Error in Dag '" + Dag
->getAsString() + "'. Operand '" +
228 Dag
->getArgNameStr(i
- TiedCount
) + "' has type '" +
229 DI
->getDef()->getName() +
230 "' which does not match the type '" +
231 Inst
.Operands
[i
].Rec
->getName() +
232 "' in the corresponding instruction operand!");
234 OperandMap
[i
].Kind
= OpData::Operand
;
235 } else if (IntInit
*II
= dyn_cast
<IntInit
>(Dag
->getArg(i
- TiedCount
))) {
236 // Validate that corresponding instruction operand expects an immediate.
237 if (Inst
.Operands
[i
].Rec
->isSubClassOf("RegisterClass"))
240 "Error in Dag '" + Dag
->getAsString() + "' Found immediate: '" +
242 "' but corresponding instruction operand expected a register!");
243 // No pattern validation check possible for values of fixed immediate.
244 OperandMap
[i
].Kind
= OpData::Imm
;
245 OperandMap
[i
].Data
.Imm
= II
->getValue();
247 dbgs() << " Found immediate '" << II
->getValue() << "' at "
248 << (IsSourceInst
? "input " : "output ")
249 << "Dag. No validation time check possible for values of "
250 "fixed immediate.\n");
252 llvm_unreachable("Unhandled CompressPat argument type!");
256 // Verify the Dag operand count is enough to build an instruction.
257 static bool verifyDagOpCount(CodeGenInstruction
&Inst
, DagInit
*Dag
,
259 if (Dag
->getNumArgs() == Inst
.Operands
.size())
261 // Source instructions are non compressed instructions and don't have tied
264 PrintFatalError(Inst
.TheDef
->getLoc(),
265 "Input operands for Inst '" + Inst
.TheDef
->getName() +
266 "' and input Dag operand count mismatch");
267 // The Dag can't have more arguments than the Instruction.
268 if (Dag
->getNumArgs() > Inst
.Operands
.size())
269 PrintFatalError(Inst
.TheDef
->getLoc(),
270 "Inst '" + Inst
.TheDef
->getName() +
271 "' and Dag operand count mismatch");
273 // The Instruction might have tied operands so the Dag might have
274 // a fewer operand count.
275 unsigned RealCount
= Inst
.Operands
.size();
276 for (const auto &Operand
: Inst
.Operands
)
277 if (Operand
.getTiedRegister() != -1)
280 if (Dag
->getNumArgs() != RealCount
)
281 PrintFatalError(Inst
.TheDef
->getLoc(),
282 "Inst '" + Inst
.TheDef
->getName() +
283 "' and Dag operand count mismatch");
287 static bool validateArgsTypes(Init
*Arg1
, Init
*Arg2
) {
288 return cast
<DefInit
>(Arg1
)->getDef() == cast
<DefInit
>(Arg2
)->getDef();
291 // Creates a mapping between the operand name in the Dag (e.g. $rs1) and
292 // its index in the list of Dag operands and checks that operands with the same
293 // name have the same types. For example in 'C_ADD $rs1, $rs2' we generate the
294 // mapping $rs1 --> 0, $rs2 ---> 1. If the operand appears twice in the (tied)
295 // same Dag we use the last occurrence for indexing.
296 void RISCVCompressInstEmitter::createDagOperandMapping(
297 Record
*Rec
, StringMap
<unsigned> &SourceOperands
,
298 StringMap
<unsigned> &DestOperands
, DagInit
*SourceDag
, DagInit
*DestDag
,
299 IndexedMap
<OpData
> &SourceOperandMap
) {
300 for (unsigned i
= 0; i
< DestDag
->getNumArgs(); ++i
) {
301 // Skip fixed immediates and registers, they were handled in
302 // addDagOperandMapping.
303 if ("" == DestDag
->getArgNameStr(i
))
305 DestOperands
[DestDag
->getArgNameStr(i
)] = i
;
308 for (unsigned i
= 0; i
< SourceDag
->getNumArgs(); ++i
) {
309 // Skip fixed immediates and registers, they were handled in
310 // addDagOperandMapping.
311 if ("" == SourceDag
->getArgNameStr(i
))
314 StringMap
<unsigned>::iterator it
=
315 SourceOperands
.find(SourceDag
->getArgNameStr(i
));
316 if (it
!= SourceOperands
.end()) {
317 // Operand sharing the same name in the Dag should be mapped as tied.
318 SourceOperandMap
[i
].TiedOpIdx
= it
->getValue();
319 if (!validateArgsTypes(SourceDag
->getArg(it
->getValue()),
320 SourceDag
->getArg(i
)))
321 PrintFatalError(Rec
->getLoc(),
322 "Input Operand '" + SourceDag
->getArgNameStr(i
) +
323 "' has a mismatched tied operand!\n");
325 it
= DestOperands
.find(SourceDag
->getArgNameStr(i
));
326 if (it
== DestOperands
.end())
327 PrintFatalError(Rec
->getLoc(), "Operand " + SourceDag
->getArgNameStr(i
) +
328 " defined in Input Dag but not used in"
330 // Input Dag operand types must match output Dag operand type.
331 if (!validateArgsTypes(DestDag
->getArg(it
->getValue()),
332 SourceDag
->getArg(i
)))
333 PrintFatalError(Rec
->getLoc(), "Type mismatch between Input and "
334 "Output Dag operand '" +
335 SourceDag
->getArgNameStr(i
) + "'!");
336 SourceOperands
[SourceDag
->getArgNameStr(i
)] = i
;
340 /// Map operand names in the Dag to their index in both corresponding input and
341 /// output instructions. Validate that operands defined in the input are
342 /// used in the output pattern while populating the maps.
343 void RISCVCompressInstEmitter::createInstOperandMapping(
344 Record
*Rec
, DagInit
*SourceDag
, DagInit
*DestDag
,
345 IndexedMap
<OpData
> &SourceOperandMap
, IndexedMap
<OpData
> &DestOperandMap
,
346 StringMap
<unsigned> &SourceOperands
, CodeGenInstruction
&DestInst
) {
347 // TiedCount keeps track of the number of operands skipped in Inst
348 // operands list to get to the corresponding Dag operand.
349 unsigned TiedCount
= 0;
350 LLVM_DEBUG(dbgs() << " Operand mapping:\n Source Dest\n");
351 for (unsigned i
= 0, e
= DestInst
.Operands
.size(); i
!= e
; ++i
) {
352 int TiedInstOpIdx
= DestInst
.Operands
[i
].getTiedRegister();
353 if (TiedInstOpIdx
!= -1) {
355 DestOperandMap
[i
].Data
= DestOperandMap
[TiedInstOpIdx
].Data
;
356 DestOperandMap
[i
].Kind
= DestOperandMap
[TiedInstOpIdx
].Kind
;
357 if (DestOperandMap
[i
].Kind
== OpData::Operand
)
358 // No need to fill the SourceOperandMap here since it was mapped to
359 // destination operand 'TiedInstOpIdx' in a previous iteration.
360 LLVM_DEBUG(dbgs() << " " << DestOperandMap
[i
].Data
.Operand
362 << " Dest operand tied with operand '"
363 << TiedInstOpIdx
<< "'\n");
366 // Skip fixed immediates and registers, they were handled in
367 // addDagOperandMapping.
368 if (DestOperandMap
[i
].Kind
!= OpData::Operand
)
371 unsigned DagArgIdx
= i
- TiedCount
;
372 StringMap
<unsigned>::iterator SourceOp
=
373 SourceOperands
.find(DestDag
->getArgNameStr(DagArgIdx
));
374 if (SourceOp
== SourceOperands
.end())
375 PrintFatalError(Rec
->getLoc(),
376 "Output Dag operand '" +
377 DestDag
->getArgNameStr(DagArgIdx
) +
378 "' has no matching input Dag operand.");
380 assert(DestDag
->getArgNameStr(DagArgIdx
) ==
381 SourceDag
->getArgNameStr(SourceOp
->getValue()) &&
382 "Incorrect operand mapping detected!\n");
383 DestOperandMap
[i
].Data
.Operand
= SourceOp
->getValue();
384 SourceOperandMap
[SourceOp
->getValue()].Data
.Operand
= i
;
385 LLVM_DEBUG(dbgs() << " " << SourceOp
->getValue() << " ====> " << i
390 /// Validates the CompressPattern and create operand mapping.
391 /// These are the checks to validate a CompressPat pattern declarations.
392 /// Error out with message under these conditions:
393 /// - Dag Input opcode is an expanded instruction and Dag Output opcode is a
394 /// compressed instruction.
395 /// - Operands in Dag Input must be all used in Dag Output.
396 /// Register Operand type in Dag Input Type must be contained in the
397 /// corresponding Source Instruction type.
398 /// - Register Operand type in Dag Input must be the same as in Dag Ouput.
399 /// - Register Operand type in Dag Output must be the same as the
400 /// corresponding Destination Inst type.
401 /// - Immediate Operand type in Dag Input must be the same as in Dag Ouput.
402 /// - Immediate Operand type in Dag Ouput must be the same as the corresponding
403 /// Destination Instruction type.
404 /// - Fixed register must be contained in the corresponding Source Instruction
406 /// - Fixed register must be contained in the corresponding Destination
407 /// Instruction type. Warning message printed under these conditions:
408 /// - Fixed immediate in Dag Input or Dag Ouput cannot be checked at this time
409 /// and generate warning.
410 /// - Immediate operand type in Dag Input differs from the corresponding Source
411 /// Instruction type and generate a warning.
412 void RISCVCompressInstEmitter::evaluateCompressPat(Record
*Rec
) {
413 // Validate input Dag operands.
414 DagInit
*SourceDag
= Rec
->getValueAsDag("Input");
415 assert(SourceDag
&& "Missing 'Input' in compress pattern!");
416 LLVM_DEBUG(dbgs() << "Input: " << *SourceDag
<< "\n");
418 // Checking we are transforming from compressed to uncompressed instructions.
419 Record
*Operator
= SourceDag
->getOperatorAsDef(Rec
->getLoc());
420 if (!Operator
->isSubClassOf("RVInst"))
421 PrintFatalError(Rec
->getLoc(), "Input instruction '" + Operator
->getName() +
422 "' is not a 32 bit wide instruction!");
423 CodeGenInstruction
SourceInst(Operator
);
424 verifyDagOpCount(SourceInst
, SourceDag
, true);
426 // Validate output Dag operands.
427 DagInit
*DestDag
= Rec
->getValueAsDag("Output");
428 assert(DestDag
&& "Missing 'Output' in compress pattern!");
429 LLVM_DEBUG(dbgs() << "Output: " << *DestDag
<< "\n");
431 Record
*DestOperator
= DestDag
->getOperatorAsDef(Rec
->getLoc());
432 if (!DestOperator
->isSubClassOf("RVInst16"))
433 PrintFatalError(Rec
->getLoc(), "Output instruction '" +
434 DestOperator
->getName() +
435 "' is not a 16 bit wide instruction!");
436 CodeGenInstruction
DestInst(DestOperator
);
437 verifyDagOpCount(DestInst
, DestDag
, false);
439 // Fill the mapping from the source to destination instructions.
441 IndexedMap
<OpData
> SourceOperandMap
;
442 SourceOperandMap
.grow(SourceInst
.Operands
.size());
443 // Create a mapping between source Dag operands and source Inst operands.
444 addDagOperandMapping(Rec
, SourceDag
, SourceInst
, SourceOperandMap
,
445 /*IsSourceInst*/ true);
447 IndexedMap
<OpData
> DestOperandMap
;
448 DestOperandMap
.grow(DestInst
.Operands
.size());
449 // Create a mapping between destination Dag operands and destination Inst
451 addDagOperandMapping(Rec
, DestDag
, DestInst
, DestOperandMap
,
452 /*IsSourceInst*/ false);
454 StringMap
<unsigned> SourceOperands
;
455 StringMap
<unsigned> DestOperands
;
456 createDagOperandMapping(Rec
, SourceOperands
, DestOperands
, SourceDag
, DestDag
,
458 // Create operand mapping between the source and destination instructions.
459 createInstOperandMapping(Rec
, SourceDag
, DestDag
, SourceOperandMap
,
460 DestOperandMap
, SourceOperands
, DestInst
);
462 // Get the target features for the CompressPat.
463 std::vector
<Record
*> PatReqFeatures
;
464 std::vector
<Record
*> RF
= Rec
->getValueAsListOfDefs("Predicates");
465 copy_if(RF
, std::back_inserter(PatReqFeatures
), [](Record
*R
) {
466 return R
->getValueAsBit("AssemblerMatcherPredicate");
469 CompressPatterns
.push_back(CompressPat(SourceInst
, DestInst
, PatReqFeatures
,
470 SourceOperandMap
, DestOperandMap
,
471 Rec
->getValueAsBit("isCompressOnly")));
475 getReqFeatures(std::set
<std::pair
<bool, StringRef
>> &FeaturesSet
,
476 std::set
<std::set
<std::pair
<bool, StringRef
>>> &AnyOfFeatureSets
,
477 const std::vector
<Record
*> &ReqFeatures
) {
478 for (auto &R
: ReqFeatures
) {
479 const DagInit
*D
= R
->getValueAsDag("AssemblerCondDag");
480 std::string CombineType
= D
->getOperator()->getAsString();
481 if (CombineType
!= "any_of" && CombineType
!= "all_of")
482 PrintFatalError(R
->getLoc(), "Invalid AssemblerCondDag!");
483 if (D
->getNumArgs() == 0)
484 PrintFatalError(R
->getLoc(), "Invalid AssemblerCondDag!");
485 bool IsOr
= CombineType
== "any_of";
486 std::set
<std::pair
<bool, StringRef
>> AnyOfSet
;
488 for (auto *Arg
: D
->getArgs()) {
490 if (auto *NotArg
= dyn_cast
<DagInit
>(Arg
)) {
491 if (NotArg
->getOperator()->getAsString() != "not" ||
492 NotArg
->getNumArgs() != 1)
493 PrintFatalError(R
->getLoc(), "Invalid AssemblerCondDag!");
494 Arg
= NotArg
->getArg(0);
497 if (!isa
<DefInit
>(Arg
) ||
498 !cast
<DefInit
>(Arg
)->getDef()->isSubClassOf("SubtargetFeature"))
499 PrintFatalError(R
->getLoc(), "Invalid AssemblerCondDag!");
501 AnyOfSet
.insert({IsNot
, cast
<DefInit
>(Arg
)->getDef()->getName()});
503 FeaturesSet
.insert({IsNot
, cast
<DefInit
>(Arg
)->getDef()->getName()});
507 AnyOfFeatureSets
.insert(AnyOfSet
);
511 static unsigned getPredicates(DenseMap
<const Record
*, unsigned> &PredicateMap
,
512 std::vector
<const Record
*> &Predicates
,
513 Record
*Rec
, StringRef Name
) {
514 unsigned &Entry
= PredicateMap
[Rec
];
518 if (!Rec
->isValueUnset(Name
)) {
519 Predicates
.push_back(Rec
);
520 Entry
= Predicates
.size();
524 PrintFatalError(Rec
->getLoc(), "No " + Name
+
525 " predicate on this operand at all: '" +
526 Rec
->getName() + "'");
530 static void printPredicates(const std::vector
<const Record
*> &Predicates
,
531 StringRef Name
, raw_ostream
&o
) {
532 for (unsigned i
= 0; i
< Predicates
.size(); ++i
) {
533 StringRef Pred
= Predicates
[i
]->getValueAsString(Name
);
534 o
<< " case " << i
+ 1 << ": {\n"
535 << " // " << Predicates
[i
]->getName() << "\n"
536 << " " << Pred
<< "\n"
541 static void mergeCondAndCode(raw_ostream
&CombinedStream
, StringRef CondStr
,
543 // Remove first indentation and last '&&'.
544 CondStr
= CondStr
.drop_front(6).drop_back(4);
545 CombinedStream
.indent(4) << "if (" << CondStr
<< ") {\n";
546 CombinedStream
<< CodeStr
;
547 CombinedStream
.indent(4) << " return true;\n";
548 CombinedStream
.indent(4) << "} // if\n";
551 void RISCVCompressInstEmitter::emitCompressInstEmitter(raw_ostream
&o
,
553 Record
*AsmWriter
= Target
.getAsmWriter();
554 if (!AsmWriter
->getValueAsInt("PassSubtarget"))
555 PrintFatalError(AsmWriter
->getLoc(),
556 "'PassSubtarget' is false. SubTargetInfo object is needed "
557 "for target features.\n");
559 StringRef Namespace
= Target
.getName();
561 // Sort entries in CompressPatterns to handle instructions that can have more
562 // than one candidate for compression\uncompression, e.g ADD can be
563 // transformed to a C_ADD or a C_MV. When emitting 'uncompress()' function the
564 // source and destination are flipped and the sort key needs to change
566 llvm::stable_sort(CompressPatterns
, [EType
](const CompressPat
&LHS
,
567 const CompressPat
&RHS
) {
568 if (EType
== EmitterType::Compress
|| EType
== EmitterType::CheckCompress
)
569 return (LHS
.Source
.TheDef
->getName() < RHS
.Source
.TheDef
->getName());
571 return (LHS
.Dest
.TheDef
->getName() < RHS
.Dest
.TheDef
->getName());
574 // A list of MCOperandPredicates for all operands in use, and the reverse map.
575 std::vector
<const Record
*> MCOpPredicates
;
576 DenseMap
<const Record
*, unsigned> MCOpPredicateMap
;
577 // A list of ImmLeaf Predicates for all operands in use, and the reverse map.
578 std::vector
<const Record
*> ImmLeafPredicates
;
579 DenseMap
<const Record
*, unsigned> ImmLeafPredicateMap
;
583 raw_string_ostream
Func(F
);
584 raw_string_ostream
FuncH(FH
);
585 bool NeedMRI
= false;
587 if (EType
== EmitterType::Compress
)
588 o
<< "\n#ifdef GEN_COMPRESS_INSTR\n"
589 << "#undef GEN_COMPRESS_INSTR\n\n";
590 else if (EType
== EmitterType::Uncompress
)
591 o
<< "\n#ifdef GEN_UNCOMPRESS_INSTR\n"
592 << "#undef GEN_UNCOMPRESS_INSTR\n\n";
593 else if (EType
== EmitterType::CheckCompress
)
594 o
<< "\n#ifdef GEN_CHECK_COMPRESS_INSTR\n"
595 << "#undef GEN_CHECK_COMPRESS_INSTR\n\n";
597 if (EType
== EmitterType::Compress
) {
598 FuncH
<< "static bool compressInst(MCInst &OutInst,\n";
599 FuncH
.indent(25) << "const MCInst &MI,\n";
600 FuncH
.indent(25) << "const MCSubtargetInfo &STI,\n";
601 FuncH
.indent(25) << "MCContext &Context) {\n";
602 } else if (EType
== EmitterType::Uncompress
){
603 FuncH
<< "static bool uncompressInst(MCInst &OutInst,\n";
604 FuncH
.indent(27) << "const MCInst &MI,\n";
605 FuncH
.indent(27) << "const MCRegisterInfo &MRI,\n";
606 FuncH
.indent(27) << "const MCSubtargetInfo &STI) {\n";
607 } else if (EType
== EmitterType::CheckCompress
) {
608 FuncH
<< "static bool isCompressibleInst(const MachineInstr &MI,\n";
609 FuncH
.indent(27) << "const RISCVSubtarget *Subtarget,\n";
610 FuncH
.indent(27) << "const MCRegisterInfo &MRI,\n";
611 FuncH
.indent(27) << "const MCSubtargetInfo &STI) {\n";
614 if (CompressPatterns
.empty()) {
616 o
.indent(2) << "return false;\n}\n";
617 if (EType
== EmitterType::Compress
)
618 o
<< "\n#endif //GEN_COMPRESS_INSTR\n";
619 else if (EType
== EmitterType::Uncompress
)
620 o
<< "\n#endif //GEN_UNCOMPRESS_INSTR\n\n";
621 else if (EType
== EmitterType::CheckCompress
)
622 o
<< "\n#endif //GEN_CHECK_COMPRESS_INSTR\n\n";
626 std::string CaseString
;
627 raw_string_ostream
CaseStream(CaseString
);
630 CaseStream
<< " switch (MI.getOpcode()) {\n";
631 CaseStream
<< " default: return false;\n";
633 bool CompressOrCheck
=
634 EType
== EmitterType::Compress
|| EType
== EmitterType::CheckCompress
;
635 bool CompressOrUncompress
=
636 EType
== EmitterType::Compress
|| EType
== EmitterType::Uncompress
;
638 for (auto &CompressPat
: CompressPatterns
) {
639 if (EType
== EmitterType::Uncompress
&& CompressPat
.IsCompressOnly
)
642 std::string CondString
;
643 std::string CodeString
;
644 raw_string_ostream
CondStream(CondString
);
645 raw_string_ostream
CodeStream(CodeString
);
646 CodeGenInstruction
&Source
=
647 CompressOrCheck
? CompressPat
.Source
: CompressPat
.Dest
;
648 CodeGenInstruction
&Dest
=
649 CompressOrCheck
? CompressPat
.Dest
: CompressPat
.Source
;
650 IndexedMap
<OpData
> SourceOperandMap
= CompressOrCheck
?
651 CompressPat
.SourceOperandMap
: CompressPat
.DestOperandMap
;
652 IndexedMap
<OpData
> &DestOperandMap
= CompressOrCheck
?
653 CompressPat
.DestOperandMap
: CompressPat
.SourceOperandMap
;
655 CurOp
= Source
.TheDef
->getName();
656 // Check current and previous opcode to decide to continue or end a case.
657 if (CurOp
!= PrevOp
) {
659 CaseStream
.indent(6) << "break;\n } // case " + PrevOp
+ "\n";
660 CaseStream
.indent(4) << "case " + Namespace
+ "::" + CurOp
+ ": {\n";
663 std::set
<std::pair
<bool, StringRef
>> FeaturesSet
;
664 std::set
<std::set
<std::pair
<bool, StringRef
>>> AnyOfFeatureSets
;
665 // Add CompressPat required features.
666 getReqFeatures(FeaturesSet
, AnyOfFeatureSets
, CompressPat
.PatReqFeatures
);
668 // Add Dest instruction required features.
669 std::vector
<Record
*> ReqFeatures
;
670 std::vector
<Record
*> RF
= Dest
.TheDef
->getValueAsListOfDefs("Predicates");
671 copy_if(RF
, std::back_inserter(ReqFeatures
), [](Record
*R
) {
672 return R
->getValueAsBit("AssemblerMatcherPredicate");
674 getReqFeatures(FeaturesSet
, AnyOfFeatureSets
, ReqFeatures
);
676 // Emit checks for all required features.
677 for (auto &Op
: FeaturesSet
) {
678 StringRef Not
= Op
.first
? "!" : "";
679 CondStream
.indent(6) << Not
<< "STI.getFeatureBits()[" << Namespace
680 << "::" << Op
.second
<< "]"
684 // Emit checks for all required feature groups.
685 for (auto &Set
: AnyOfFeatureSets
) {
686 CondStream
.indent(6) << "(";
687 for (auto &Op
: Set
) {
688 bool isLast
= &Op
== &*Set
.rbegin();
689 StringRef Not
= Op
.first
? "!" : "";
690 CondStream
<< Not
<< "STI.getFeatureBits()[" << Namespace
691 << "::" << Op
.second
<< "]";
693 CondStream
<< " || ";
695 CondStream
<< ") &&\n";
698 // Start Source Inst operands validation.
700 for (OpNo
= 0; OpNo
< Source
.Operands
.size(); ++OpNo
) {
701 if (SourceOperandMap
[OpNo
].TiedOpIdx
!= -1) {
702 if (Source
.Operands
[OpNo
].Rec
->isSubClassOf("RegisterClass"))
704 << "(MI.getOperand(" << OpNo
<< ").getReg() == MI.getOperand("
705 << SourceOperandMap
[OpNo
].TiedOpIdx
<< ").getReg()) &&\n";
707 PrintFatalError("Unexpected tied operand types!\n");
709 // Check for fixed immediates\registers in the source instruction.
710 switch (SourceOperandMap
[OpNo
].Kind
) {
711 case OpData::Operand
:
712 // We don't need to do anything for source instruction operand checks.
716 << "(MI.getOperand(" << OpNo
<< ").isImm()) &&\n"
717 << " (MI.getOperand(" << OpNo
718 << ").getImm() == " << SourceOperandMap
[OpNo
].Data
.Imm
<< ") &&\n";
721 Record
*Reg
= SourceOperandMap
[OpNo
].Data
.Reg
;
723 << "(MI.getOperand(" << OpNo
<< ").getReg() == " << Namespace
724 << "::" << Reg
->getName() << ") &&\n";
729 CodeStream
.indent(6) << "// " << Dest
.AsmString
<< "\n";
730 if (CompressOrUncompress
)
731 CodeStream
.indent(6) << "OutInst.setOpcode(" << Namespace
732 << "::" << Dest
.TheDef
->getName() << ");\n";
734 for (const auto &DestOperand
: Dest
.Operands
) {
735 CodeStream
.indent(6) << "// Operand: " << DestOperand
.Name
<< "\n";
736 switch (DestOperandMap
[OpNo
].Kind
) {
737 case OpData::Operand
: {
738 unsigned OpIdx
= DestOperandMap
[OpNo
].Data
.Operand
;
739 // Check that the operand in the Source instruction fits
740 // the type for the Dest instruction.
741 if (DestOperand
.Rec
->isSubClassOf("RegisterClass")) {
743 // This is a register operand. Check the register class.
744 // Don't check register class if this is a tied operand, it was done
745 // for the operand its tied to.
746 if (DestOperand
.getTiedRegister() == -1)
747 CondStream
.indent(6) << "(MRI.getRegClass(" << Namespace
748 << "::" << DestOperand
.Rec
->getName()
749 << "RegClassID).contains(MI.getOperand("
750 << OpIdx
<< ").getReg())) &&\n";
752 if (CompressOrUncompress
)
754 << "OutInst.addOperand(MI.getOperand(" << OpIdx
<< "));\n";
756 // Handling immediate operands.
757 if (CompressOrUncompress
) {
759 getPredicates(MCOpPredicateMap
, MCOpPredicates
, DestOperand
.Rec
,
760 "MCOperandPredicate");
762 << Namespace
<< "ValidateMCOperand("
763 << "MI.getOperand(" << OpIdx
<< "), STI, " << Entry
<< ") &&\n";
766 getPredicates(ImmLeafPredicateMap
, ImmLeafPredicates
,
767 DestOperand
.Rec
, "ImmediateCode");
769 << "MI.getOperand(" << OpIdx
<< ").isImm() &&\n";
770 CondStream
.indent(6) << Namespace
<< "ValidateMachineOperand("
771 << "MI.getOperand(" << OpIdx
772 << "), Subtarget, " << Entry
<< ") &&\n";
774 if (CompressOrUncompress
)
776 << "OutInst.addOperand(MI.getOperand(" << OpIdx
<< "));\n";
781 if (CompressOrUncompress
) {
782 unsigned Entry
= getPredicates(MCOpPredicateMap
, MCOpPredicates
,
783 DestOperand
.Rec
, "MCOperandPredicate");
785 << Namespace
<< "ValidateMCOperand("
786 << "MCOperand::createImm(" << DestOperandMap
[OpNo
].Data
.Imm
787 << "), STI, " << Entry
<< ") &&\n";
789 unsigned Entry
= getPredicates(ImmLeafPredicateMap
, ImmLeafPredicates
,
790 DestOperand
.Rec
, "ImmediateCode");
793 << "ValidateMachineOperand(MachineOperand::CreateImm("
794 << DestOperandMap
[OpNo
].Data
.Imm
<< "), SubTarget, " << Entry
797 if (CompressOrUncompress
)
798 CodeStream
.indent(6) << "OutInst.addOperand(MCOperand::createImm("
799 << DestOperandMap
[OpNo
].Data
.Imm
<< "));\n";
802 if (CompressOrUncompress
) {
803 // Fixed register has been validated at pattern validation time.
804 Record
*Reg
= DestOperandMap
[OpNo
].Data
.Reg
;
806 << "OutInst.addOperand(MCOperand::createReg(" << Namespace
807 << "::" << Reg
->getName() << "));\n";
813 if (CompressOrUncompress
)
814 CodeStream
.indent(6) << "OutInst.setLoc(MI.getLoc());\n";
815 mergeCondAndCode(CaseStream
, CondStream
.str(), CodeStream
.str());
818 Func
<< CaseStream
.str() << "\n";
819 // Close brace for the last case.
820 Func
.indent(4) << "} // case " << CurOp
<< "\n";
821 Func
.indent(2) << "} // switch\n";
822 Func
.indent(2) << "return false;\n}\n";
824 if (!MCOpPredicates
.empty()) {
825 o
<< "static bool " << Namespace
826 << "ValidateMCOperand(const MCOperand &MCOp,\n"
827 << " const MCSubtargetInfo &STI,\n"
828 << " unsigned PredicateIndex) {\n"
829 << " switch (PredicateIndex) {\n"
831 << " llvm_unreachable(\"Unknown MCOperandPredicate kind\");\n"
834 printPredicates(MCOpPredicates
, "MCOperandPredicate", o
);
840 if (!ImmLeafPredicates
.empty()) {
841 o
<< "static bool " << Namespace
842 << "ValidateMachineOperand(const MachineOperand &MO,\n"
843 << " const RISCVSubtarget *Subtarget,\n"
844 << " unsigned PredicateIndex) {\n"
845 << " int64_t Imm = MO.getImm();\n"
846 << " switch (PredicateIndex) {\n"
848 << " llvm_unreachable(\"Unknown ImmLeaf Predicate kind\");\n"
851 printPredicates(ImmLeafPredicates
, "ImmediateCode", o
);
858 if (NeedMRI
&& EType
== EmitterType::Compress
)
859 o
.indent(2) << "const MCRegisterInfo &MRI = *Context.getRegisterInfo();\n";
862 if (EType
== EmitterType::Compress
)
863 o
<< "\n#endif //GEN_COMPRESS_INSTR\n";
864 else if (EType
== EmitterType::Uncompress
)
865 o
<< "\n#endif //GEN_UNCOMPRESS_INSTR\n\n";
866 else if (EType
== EmitterType::CheckCompress
)
867 o
<< "\n#endif //GEN_CHECK_COMPRESS_INSTR\n\n";
870 void RISCVCompressInstEmitter::run(raw_ostream
&o
) {
871 std::vector
<Record
*> Insts
= Records
.getAllDerivedDefinitions("CompressPat");
873 // Process the CompressPat definitions, validating them as we do so.
874 for (unsigned i
= 0, e
= Insts
.size(); i
!= e
; ++i
)
875 evaluateCompressPat(Insts
[i
]);
878 emitSourceFileHeader("Compress instruction Source Fragment", o
);
879 // Generate compressInst() function.
880 emitCompressInstEmitter(o
, EmitterType::Compress
);
881 // Generate uncompressInst() function.
882 emitCompressInstEmitter(o
, EmitterType::Uncompress
);
883 // Generate isCompressibleInst() function.
884 emitCompressInstEmitter(o
, EmitterType::CheckCompress
);
889 void EmitCompressInst(RecordKeeper
&RK
, raw_ostream
&OS
) {
890 RISCVCompressInstEmitter(RK
).run(OS
);