1//=- llvm/CodeGen/DFAPacketizer.cpp - DFA Packetizer for VLIW -*- C++ -*-=====//
2//
3//                     The LLVM Compiler Infrastructure
4//
5// This file is distributed under the University of Illinois Open Source
6// License. See LICENSE.TXT for details.
7//
8//===----------------------------------------------------------------------===//
9// This class implements a deterministic finite automaton (DFA) based
10// packetizing mechanism for VLIW architectures. It provides APIs to
11// determine whether there exists a legal mapping of instructions to
12// functional unit assignments in a packet. The DFA is auto-generated from
13// the target's Schedule.td file.
14//
15// A DFA consists of 3 major elements: states, inputs, and transitions. For
16// the packetizing mechanism, the input is the set of instruction classes for
17// a target. The state models all possible combinations of functional unit
18// consumption for a given set of instructions in a packet. A transition
19// models the addition of an instruction to a packet. In the DFA constructed
20// by this class, if an instruction can be added to a packet, then a valid
21// transition exists from the corresponding state. Invalid transitions
22// indicate that the instruction cannot be added to the current packet.
23//
24//===----------------------------------------------------------------------===//
25
26#include "llvm/CodeGen/DFAPacketizer.h"
27#include "llvm/CodeGen/MachineInstr.h"
28#include "llvm/CodeGen/MachineInstrBundle.h"
29#include "llvm/CodeGen/ScheduleDAGInstrs.h"
30#include "llvm/MC/MCInstrItineraries.h"
31#include "llvm/Target/TargetInstrInfo.h"
32using namespace llvm;
33
34DFAPacketizer::DFAPacketizer(const InstrItineraryData *I, const int (*SIT)[2],
35                             const unsigned *SET):
36  InstrItins(I), CurrentState(0), DFAStateInputTable(SIT),
37  DFAStateEntryTable(SET) {}
38
39
40//
41// ReadTable - Read the DFA transition table and update CachedTable.
42//
43// Format of the transition tables:
44// DFAStateInputTable[][2] = pairs of <Input, Transition> for all valid
45//                           transitions
46// DFAStateEntryTable[i] = Index of the first entry in DFAStateInputTable
47//                         for the ith state
48//
49void DFAPacketizer::ReadTable(unsigned int state) {
50  unsigned ThisState = DFAStateEntryTable[state];
51  unsigned NextStateInTable = DFAStateEntryTable[state+1];
52  // Early exit in case CachedTable has already contains this
53  // state's transitions.
54  if (CachedTable.count(UnsignPair(state,
55                                   DFAStateInputTable[ThisState][0])))
56    return;
57
58  for (unsigned i = ThisState; i < NextStateInTable; i++)
59    CachedTable[UnsignPair(state, DFAStateInputTable[i][0])] =
60      DFAStateInputTable[i][1];
61}
62
63
64// canReserveResources - Check if the resources occupied by a MCInstrDesc
65// are available in the current state.
66bool DFAPacketizer::canReserveResources(const llvm::MCInstrDesc *MID) {
67  unsigned InsnClass = MID->getSchedClass();
68  const llvm::InstrStage *IS = InstrItins->beginStage(InsnClass);
69  unsigned FuncUnits = IS->getUnits();
70  UnsignPair StateTrans = UnsignPair(CurrentState, FuncUnits);
71  ReadTable(CurrentState);
72  return (CachedTable.count(StateTrans) != 0);
73}
74
75
76// reserveResources - Reserve the resources occupied by a MCInstrDesc and
77// change the current state to reflect that change.
78void DFAPacketizer::reserveResources(const llvm::MCInstrDesc *MID) {
79  unsigned InsnClass = MID->getSchedClass();
80  const llvm::InstrStage *IS = InstrItins->beginStage(InsnClass);
81  unsigned FuncUnits = IS->getUnits();
82  UnsignPair StateTrans = UnsignPair(CurrentState, FuncUnits);
83  ReadTable(CurrentState);
84  assert(CachedTable.count(StateTrans) != 0);
85  CurrentState = CachedTable[StateTrans];
86}
87
88
89// canReserveResources - Check if the resources occupied by a machine
90// instruction are available in the current state.
91bool DFAPacketizer::canReserveResources(llvm::MachineInstr *MI) {
92  const llvm::MCInstrDesc &MID = MI->getDesc();
93  return canReserveResources(&MID);
94}
95
96// reserveResources - Reserve the resources occupied by a machine
97// instruction and change the current state to reflect that change.
98void DFAPacketizer::reserveResources(llvm::MachineInstr *MI) {
99  const llvm::MCInstrDesc &MID = MI->getDesc();
100  reserveResources(&MID);
101}
102
103namespace llvm {
104// DefaultVLIWScheduler - This class extends ScheduleDAGInstrs and overrides
105// Schedule method to build the dependence graph.
106class DefaultVLIWScheduler : public ScheduleDAGInstrs {
107public:
108  DefaultVLIWScheduler(MachineFunction &MF, MachineLoopInfo &MLI,
109                   MachineDominatorTree &MDT, bool IsPostRA);
110  // Schedule - Actual scheduling work.
111  void schedule();
112};
113}
114
115DefaultVLIWScheduler::DefaultVLIWScheduler(
116  MachineFunction &MF, MachineLoopInfo &MLI, MachineDominatorTree &MDT,
117  bool IsPostRA) :
118  ScheduleDAGInstrs(MF, MLI, MDT, IsPostRA) {
119  CanHandleTerminators = true;
120}
121
122void DefaultVLIWScheduler::schedule() {
123  // Build the scheduling graph.
124  buildSchedGraph(0);
125}
126
127// VLIWPacketizerList Ctor
128VLIWPacketizerList::VLIWPacketizerList(
129  MachineFunction &MF, MachineLoopInfo &MLI, MachineDominatorTree &MDT,
130  bool IsPostRA) : TM(MF.getTarget()), MF(MF)  {
131  TII = TM.getInstrInfo();
132  ResourceTracker = TII->CreateTargetScheduleState(&TM, 0);
133  VLIWScheduler = new DefaultVLIWScheduler(MF, MLI, MDT, IsPostRA);
134}
135
136// VLIWPacketizerList Dtor
137VLIWPacketizerList::~VLIWPacketizerList() {
138  if (VLIWScheduler)
139    delete VLIWScheduler;
140
141  if (ResourceTracker)
142    delete ResourceTracker;
143}
144
145// endPacket - End the current packet, bundle packet instructions and reset
146// DFA state.
147void VLIWPacketizerList::endPacket(MachineBasicBlock *MBB,
148                                         MachineInstr *MI) {
149  if (CurrentPacketMIs.size() > 1) {
150    MachineInstr *MIFirst = CurrentPacketMIs.front();
151    finalizeBundle(*MBB, MIFirst, MI);
152  }
153  CurrentPacketMIs.clear();
154  ResourceTracker->clearResources();
155}
156
157// PacketizeMIs - Bundle machine instructions into packets.
158void VLIWPacketizerList::PacketizeMIs(MachineBasicBlock *MBB,
159                                      MachineBasicBlock::iterator BeginItr,
160                                      MachineBasicBlock::iterator EndItr) {
161  assert(VLIWScheduler && "VLIW Scheduler is not initialized!");
162  VLIWScheduler->startBlock(MBB);
163  VLIWScheduler->enterRegion(MBB, BeginItr, EndItr, MBB->size());
164  VLIWScheduler->schedule();
165
166  // Generate MI -> SU map.
167  MIToSUnit.clear();
168  for (unsigned i = 0, e = VLIWScheduler->SUnits.size(); i != e; ++i) {
169    SUnit *SU = &VLIWScheduler->SUnits[i];
170    MIToSUnit[SU->getInstr()] = SU;
171  }
172
173  // The main packetizer loop.
174  for (; BeginItr != EndItr; ++BeginItr) {
175    MachineInstr *MI = BeginItr;
176
177    this->initPacketizerState();
178
179    // End the current packet if needed.
180    if (this->isSoloInstruction(MI)) {
181      endPacket(MBB, MI);
182      continue;
183    }
184
185    // Ignore pseudo instructions.
186    if (this->ignorePseudoInstruction(MI, MBB))
187      continue;
188
189    SUnit *SUI = MIToSUnit[MI];
190    assert(SUI && "Missing SUnit Info!");
191
192    // Ask DFA if machine resource is available for MI.
193    bool ResourceAvail = ResourceTracker->canReserveResources(MI);
194    if (ResourceAvail) {
195      // Dependency check for MI with instructions in CurrentPacketMIs.
196      for (std::vector<MachineInstr*>::iterator VI = CurrentPacketMIs.begin(),
197           VE = CurrentPacketMIs.end(); VI != VE; ++VI) {
198        MachineInstr *MJ = *VI;
199        SUnit *SUJ = MIToSUnit[MJ];
200        assert(SUJ && "Missing SUnit Info!");
201
202        // Is it legal to packetize SUI and SUJ together.
203        if (!this->isLegalToPacketizeTogether(SUI, SUJ)) {
204          // Allow packetization if dependency can be pruned.
205          if (!this->isLegalToPruneDependencies(SUI, SUJ)) {
206            // End the packet if dependency cannot be pruned.
207            endPacket(MBB, MI);
208            break;
209          } // !isLegalToPruneDependencies.
210        } // !isLegalToPacketizeTogether.
211      } // For all instructions in CurrentPacketMIs.
212    } else {
213      // End the packet if resource is not available.
214      endPacket(MBB, MI);
215    }
216
217    // Add MI to the current packet.
218    BeginItr = this->addToPacket(MI);
219  } // For all instructions in BB.
220
221  // End any packet left behind.
222  endPacket(MBB, EndItr);
223  VLIWScheduler->exitRegion();
224  VLIWScheduler->finishBlock();
225}
226