MLIR-AIE 1.4.6.dev
AIEResourceStages.cpp
Go to the documentation of this file.
1//===- AIEResourceStages.cpp ------------------------------------*- C++ -*-===//
2//
3// Copyright (C) 2026 Advanced Micro Devices, Inc.
4// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
5//
6//===----------------------------------------------------------------------===//
7
10
11#include "mlir/Conversion/AffineToStandard/AffineToStandard.h"
12#include "mlir/Pass/PassManager.h"
13#include "mlir/Pass/PassRegistry.h"
14
15using namespace mlir;
16using namespace xilinx;
17using namespace xilinx::AIE;
18
19void AIEX::addPlacementStage(OpPassManager &pm,
20 const AIEPlaceTilesOptions &options) {
21 pm.addPass(createAIEPlaceTilesPass(options));
22}
23
24void AIEX::addTraceStage(OpPassManager &pm) {
25 OpPassManager &dpm = pm.nest<DeviceOp>();
26 dpm.addPass(createAIEInsertTraceFlowsPass());
27 dpm.addPass(createAIETraceToConfigPass());
30 // Module-level: it rewrites callers and callees together.
32}
33
34void AIEX::addLoweringStage(OpPassManager &pm, bool dynamicObjFifos,
35 bool packetSwObjFifos, bool ctrlPktOverlay,
36 bool loadPdiToCtrlPkt, bool skipObjectFifoVerify,
37 llvm::ArrayRef<int> coverColumns,
38 bool adaptiveOverlay, bool checkQueueSpace) {
39 pm.addPass(createLowerAffinePass());
41 // The verifier checks a parameter-waiting Worker's fifo volume per dispatch
42 // from the aiex.wait_scratchpad_parameters and parameter syncs that the
43 // scratchpad lowering below replaces. Split is idempotent, so the lowering
44 // after it splits again and does not verify twice.
45 if (!skipObjectFifoVerify) {
46 OpPassManager &verify = pm.nest<DeviceOp>();
47 verify.addPass(createAIEObjectFifoSplitPass());
48 verify.addPass(createAIEObjectFifoVerifyPass());
49 }
50 // Before lock IDs and buffer addresses, which its new locks and buffers need.
52
53 pm.nest<DeviceOp>().addPass(createAIEObjectFifoSplitPass());
54 AIEGenerateColumnControlOverlayOptions overlay;
55 overlay.configuration = ctrlPktOverlay || loadPdiToCtrlPkt;
56 overlay.adaptive = adaptiveOverlay;
57 overlay.coverColumns = llvm::to_vector(coverColumns);
58 overlay.packetSwitched = packetSwObjFifos;
60 pm.addPass(createAIEImportOverlayPass());
62 OpPassManager &dpm = pm.nest<DeviceOp>();
63 dpm.addPass(createAIEAssignPacketIdsPass(packetSwObjFifos, ctrlPktOverlay));
65 AIEObjectFifoInsertCoreQueuePushesOptions pushOptions;
66 pushOptions.checkQueueSpace = checkQueueSpace;
67 dpm.addPass(createAIEObjectFifoInsertCoreQueuePushesPass(pushOptions));
71 AIEObjectFifoUnrollOptions unroll;
72 unroll.clDefaultDynamic = dynamicObjFifos;
73 dpm.addPass(createAIEObjectFifoUnrollPass(unroll));
75 dpm.addPass(createAIEAssignLockIDsPass());
79 dpm.addPass(createAIELowerCascadeFlowsPass());
80 dpm.addPass(createAIEBroadcastPacketPass());
81 dpm.addPass(createAIELowerMulticastPass());
82 pm.nest<DeviceOp>().addPass(createAIEAssignTileCtrlIDsPass());
83
84 // A buffer's name becomes a symbol in its core's object.
85 pm.nest<DeviceOp>().addPass(createAIEPrepareBuffersPass());
86}
87
88void AIEX::addBufferAddressStage(OpPassManager &pm, int64_t placementBudget) {
89 AIEAssignBufferAddressesOptions options;
90 options.clPlacementBudget = placementBudget;
91 pm.nest<DeviceOp>().addPass(createAIEAssignBufferAddressesPass(options));
92}
93
94void AIEX::addRoutingStage(OpPassManager &pm, bool allowDeadlockProne) {
95 pm.nest<DeviceOp>().addPass(createAIESplitFlowViasPass());
96 OpPassManager &dpm = pm.nest<DeviceOp>();
97 AIERoutePathfinderFlowsOptions options;
98 options.clAllowDeadlockProne = allowDeadlockProne;
99 dpm.addPass(createAIEPathfinderPass(options));
100}
101
103 PassPipelineRegistration<AIEResourceStagesOptions>(
104 "aie-resource-stages",
105 "aiecc's placement, trace, lowering, buffer address and routing stages",
106 [](OpPassManager &pm, const AIEResourceStagesOptions &options) {
107 AIEPlaceTilesOptions place;
108 place.clPlacerType = options.placer;
109 place.clCoresPerCol = options.coresPerCol;
110 place.clSASeed = options.saSeed;
111 place.clSAEffort = options.saEffort;
112 place.clPlacementBudget = options.placementBudget;
113 place.clCtrlPktOverlay =
114 options.ctrlPktOverlay || options.loadPdiToCtrlPkt;
115 place.clCtrlPktOverlayAdaptive = options.adaptiveOverlay;
116 place.clPacketSwObjectFifos = options.packetSwObjFifos;
117 addPlacementStage(pm, place);
118 addTraceStage(pm);
120 options.ctrlPktOverlay || options.loadPdiToCtrlPkt,
121 options.loadPdiToCtrlPkt, options.skipObjectFifoVerify,
122 {}, options.adaptiveOverlay);
125 });
126}
void addLoweringStage(mlir::OpPassManager &pm, bool dynamicObjFifos, bool packetSwObjFifos, bool ctrlPktOverlay, bool loadPdiToCtrlPkt, bool skipObjectFifoVerify, llvm::ArrayRef< int > coverColumns={}, bool adaptiveOverlay=true, bool checkQueueSpace=true)
Affine lowering through aie-prepare-buffers.
std::unique_ptr< mlir::OperationPass< AIE::DeviceOp > > createAIEReserveRuntimeBDIDsPass()
void addBufferAddressStage(mlir::OpPassManager &pm, int64_t placementBudget)
void addRoutingStage(mlir::OpPassManager &pm, bool allowDeadlockProne)
void addPlacementStage(mlir::OpPassManager &pm, const AIE::AIEPlaceTilesOptions &options)
aiecc's stages that give a design its tiles, locks, BD IDs, buffers and routes, in its order.
std::unique_ptr< mlir::OperationPass< AIE::DeviceOp > > createAIEXInlineTraceConfigPass()
void registerAIEResourceStagesPipeline()
std::unique_ptr< mlir::OperationPass< mlir::ModuleOp > > createAIELowerScratchpadParametersPass()
std::unique_ptr< mlir::OperationPass< AIE::DeviceOp > > createAIELowerMulticastPass()
std::unique_ptr< mlir::OperationPass< AIE::DeviceOp > > createAIEBroadcastPacketPass()
std::unique_ptr< mlir::OperationPass< mlir::ModuleOp > > createAIEFuseTraceBuffersPass()
void addTraceStage(mlir::OpPassManager &pm)
std::unique_ptr< mlir::OperationPass< DeviceOp > > createAIEInsertTraceFlowsPass()
std::unique_ptr< mlir::OperationPass< DeviceOp > > createAIETraceRegPackWritesPass()
std::unique_ptr< mlir::OperationPass< DeviceOp > > createAIEPrepareBuffersPass()
std::unique_ptr< mlir::OperationPass< DeviceOp > > createAIEObjectFifoLowerCoresPass()
std::unique_ptr< mlir::OperationPass< DeviceOp > > createAIELowerCoreIssuedConfigurationPass()
std::unique_ptr< mlir::OperationPass< DeviceOp > > createAIEObjectFifoInsertCoreQueuePushesPass()
std::unique_ptr< mlir::OperationPass< DeviceOp > > createAIEAssignTileCtrlIDsPass()
std::unique_ptr< mlir::OperationPass< DeviceOp > > createAIELowerCascadeFlowsPass()
std::unique_ptr< mlir::OperationPass< DeviceOp > > createAIEObjectFifoAllocatePass()
std::unique_ptr< mlir::OperationPass< DeviceOp > > createAIENormalizeDmaBdDimsPass()
std::unique_ptr< mlir::OperationPass< mlir::ModuleOp > > createAIEGenerateColumnControlOverlayPass()
std::unique_ptr< mlir::OperationPass< DeviceOp > > createAIEAssignLockIDsPass()
std::unique_ptr< mlir::OperationPass< DeviceOp > > createAIEObjectFifoUnrollPass()
std::unique_ptr< mlir::OperationPass< DeviceOp > > createAIEAssignPacketIdsPass()
std::unique_ptr< mlir::OperationPass< mlir::ModuleOp > > createAIEAnnotateShimSharingPass()
std::unique_ptr< mlir::OperationPass< DeviceOp > > createAIESplitFlowViasPass()
std::unique_ptr< mlir::OperationPass< DeviceOp > > createAIEObjectFifoErasePoolsPass()
std::unique_ptr< mlir::OperationPass< mlir::ModuleOp > > createAIECanonicalizeDevicePass()
std::unique_ptr< mlir::OperationPass< DeviceOp > > createAIEAssignBufferAddressesPass()
std::unique_ptr< mlir::OperationPass< DeviceOp > > createAIEObjectFifoVerifyPass()
std::unique_ptr< mlir::OperationPass< DeviceOp > > createAIETraceToConfigPass()
std::unique_ptr< mlir::OperationPass< DeviceOp > > createAIEAssignBufferDescriptorIDsPass()
std::unique_ptr< mlir::OperationPass< DeviceOp > > createAIEObjectFifoLowerDMAsPass()
std::unique_ptr< mlir::OperationPass< DeviceOp > > createAIEPathfinderPass()
std::unique_ptr< mlir::OperationPass< DeviceOp > > createAIEObjectFifoSplitPass()
std::unique_ptr< mlir::OperationPass< mlir::ModuleOp > > createAIEImportOverlayPass()
std::unique_ptr< mlir::OperationPass< mlir::ModuleOp > > createAIEPlaceTilesPass()
Options of aie-resource-stages, named and defaulted as aiecc's flags.
Definition AIEXPasses.h:120
Option< AIE::PlacerType > placer
Definition AIEXPasses.h:121