#include "aie/Dialect/AIE/IR/AIETargetModel.h"

Inheritance diagram for xilinx::AIE::AIE2TargetModel:

Collaboration diagram for xilinx::AIE::AIE2TargetModel:

Public Member Functions
	AIE2TargetModel (TargetModelKind k)
AIEArch	getTargetArch () const override
	Return the target architecture.
uint32_t	getAddressGenGranularity () const override
	Return the data bus width of the device.
uint32_t	getNumSlaveSlots () const override
	Return the number of packet-rule slots per stream-switch slave port.
uint32_t	getNumArbiters () const override
	Return the number of arbiters per stream switch.
uint32_t	getNumMselsPerArbiter () const override
	Return the number of master select values per stream-switch arbiter.
uint32_t	getMaxPacketId () const override
	Return the largest packet id the stream switch can route.
uint32_t	getMaxOutOfOrderId () const override
	Return the largest out-of-order BD id (unsupported = 0).
uint32_t	getMaxRepeatCount () const override
	Return the largest DMA task repeat count (unsupported = 0).
uint32_t	getDmaTaskQueueDepth () const override
	Return how many DMA tasks a single channel's task queue holds (unsupported = 0).
std::optional< TileID >	getMemWest (TileID src) const override
	Return the tile ID of the memory to the west of the given tile, if it exists.
std::optional< TileID >	getMemEast (TileID src) const override
	Return the tile ID of the memory to the east of the given tile, if it exists.
std::optional< TileID >	getMemNorth (TileID src) const override
	Return the tile ID of the memory to the north of the given tile, if it exists.
std::optional< TileID >	getMemSouth (TileID src) const override
	Return the tile ID of the memory to the south of the given tile, if it exists.
bool	isMemWest (int srcCol, int srcRow, int dstCol, int dstRow) const override
	Return true if src has a memory tile which is West of dst.
bool	isMemEast (int srcCol, int srcRow, int dstCol, int dstRow) const override
	Return true if src has a memory tile which is East of dst.
bool	isMemNorth (int srcCol, int srcRow, int dstCol, int dstRow) const override
	Return true if src has a memory tile which is North of dst.
bool	isMemSouth (int srcCol, int srcRow, int dstCol, int dstRow) const override
	Return true if src has a memory tile which is South of dst.
bool	isLegalMemAffinity (int coreCol, int coreRow, int memCol, int memRow) const override
	Return true if core can access the memory in mem.
uint32_t	getMemInternalBaseAddress (TileID src) const override
	Return the base address in the local address map for a core.
uint32_t	getMemSouthBaseAddress () const override
	Return the base address in the local address map for a core.
uint32_t	getMemWestBaseAddress () const override
	Return the base address in the local address map for a core.
uint32_t	getMemNorthBaseAddress () const override
	Return the base address in the local address map for a core.
uint32_t	getMemEastBaseAddress () const override
	Return the base address in the local address map for a core.
uint32_t	getLocalMemorySize () const override
	Return the size (in bytes) of the local data memory of a core.
uint32_t	getProgramMemorySize () const override
	Return the size (in bytes) of a core's program memory.
uint32_t	getCoreDataAddressSpaceSize () const override
	Return the size (in bytes) of the address space a core can issue data accesses into.
uint32_t	getAccumulatorCascadeSize () const override
	Return the size (in bits) of the accumulator/cascade.
uint32_t	getComputeTileLoadStoreBusWidth () const override
	Return the data bus width (in bits) for load/store operations of a compute core.
uint32_t	getComputeTileMaxVectorAlignBits () const override
	Return the alignment (in bits) required by the widest vector load/store a compute core can issue.
uint32_t	getNumLocks (AIETileType tileType) const override
	Return the number of lock objects for a given tile type.
uint32_t	getMaxLockValue () const override
	Return the maximum value that can be stored in a lock register.
std::optional< uint32_t >	getLocalLockAddress (uint32_t lockId, TileID tile) const override
uint32_t	getNumBDs (AIETileType tileType) const override
	Return the number of buffer descriptors for a given tile type.
uint32_t	getBDMaxDims (AIETileType tileType) const override
	Return the maximum number of addressing dimensions (wraps/strides) a single buffer descriptor supports for a given tile type.
const DmaBdLayout &	getDmaBdLimits (AIETileType tileType) const
uint64_t	getDmaBdMaxLen (AIETileType tileType) const override
	Return the maximum transfer length, measured in address-generation granules (see getAddressGenGranularity(), 32-bit words on AIE2), that fits in the buffer_length field of a DMA buffer descriptor for the given tile type.
uint32_t	getDmaBdWrapBits (AIETileType tileType) const override
	Return the bit width of the wrap (size) field in a DMA buffer descriptor for the given tile type.
uint32_t	getDmaBdStepBits (AIETileType tileType) const override
	Return the bit width of the step (stride) field in a DMA buffer descriptor for the given tile type.
uint32_t	getDmaBdIterBits (AIETileType tileType) const override
	Return the bit width of the iteration (repeat) wrap/stride fields in a DMA buffer descriptor for the given tile type.
bool	isBdChannelAccessible (int col, int row, uint32_t bd_id, int channel) const override
	Return true iff buffer descriptor bd_id on tile (col, row) can be submitted on channel channel.
const DmaBdLayout *	getDmaBdLayout (AIETileType tileType) const override
	Return the register layout of a buffer descriptor on the given tile type, or null if the target has none modeled for it.
uint64_t	getDmaBdAddress (int col, int row, uint32_t bd_id, int channel, AIE::DMAChannelDir direction) const override
	Return the array address of the dma buffer descriptor for the given col, row, buffer descriptor id, channel and direction.
uint32_t	getDmaBdAddressOffset (int col, int row) const override
	Return the offset of the base address field within the shim dma buffer descriptor.
uint32_t	getDmaControlAddress (int col, int row, int channel, AIE::DMAChannelDir direction) const override
	Return the array address of the dma task queue register for the given col, row, channel and direction.
std::optional< uint32_t >	getDmaStatusAddress (int col, int row, int channel, AIE::DMAChannelDir direction) const override
	Return the address of the DMA status register for a channel, or nullopt when this target's layout has not been verified.
uint32_t	getDmaTaskQueueSizeMask () const override
	Return the mask selecting the live task-queue occupancy field within the getDmaStatusAddress() register (0 when unsupported).
uint32_t	getDmaChannelIdleMask () const override
	Return the bits of the getDmaStatusAddress() register that are all clear exactly when the channel has finished every task pushed to it: nothing queued, nothing running, nothing stalled (0 when unsupported).
uint32_t	getMemTileSize () const override
	Return the size (in bytes) of a MemTile.
uint32_t	getNumBanks (int col, int row) const override
	Return the number of memory banks of a given tile.
uint32_t	getMaxChannelNumForAdjacentMemTile (int col, int row) const override
uint32_t	getNumDestSwitchboxConnections (int col, int row, WireBundle bundle) const override
	Return the number of destinations of connections inside a switchbox.
uint32_t	getNumSourceSwitchboxConnections (int col, int row, WireBundle bundle) const override
	Return the number of sources of connections inside a switchbox.
uint32_t	getNumDestShimMuxConnections (int col, int row, WireBundle bundle) const override
	Return the number of destinations of connections inside a shimmux.
uint32_t	getNumSourceShimMuxConnections (int col, int row, WireBundle bundle) const override
	Return the number of sources of connections inside a shimmux.
bool	isLegalTileConnection (int col, int row, WireBundle srcBundle, int srcChan, WireBundle dstBundle, int dstChan) const override
std::optional< uint32_t >	getStreamSwitchPortIndex (int col, int row, WireBundle bundle, uint32_t port_num, bool master) const override
	Get stream switch port index for a given port specification Return port index for Stream_Switch_Event_Port_Selection register, or nullopt if invalid.
uint32_t	getColumnShift () const override
uint32_t	getRowShift () const override
std::vector< std::pair< uint32_t, uint32_t > >	getShimBurstEncodingsAndLengths () const override
uint32_t	getNumLocks (int col, int row) const
	Return the number of lock objects for a tile at the given coordinates.
const DmaBdLayout *	getDmaBdLayout (int col, int row) const
Public Member Functions inherited from xilinx::AIE::AIETargetModel
TargetModelKind	getKind () const
	AIETargetModel (TargetModelKind k)
virtual	~AIETargetModel ()
virtual int	columns () const =0
	Return the number of columns in the device.
virtual int	physicalColumns () const
	Width of the physical array this (possibly virtualized) device is carved from.
virtual int	firstPlaceableColumn () const
	First physical column at which a partition may be anchored.
std::vector< int >	partitionStartColumns (int numCols) const
	Every physical column offset at which a numCols-wide partition still fits.
virtual int	rows () const =0
	Return the number of rows in the device.
virtual uint32_t	getNumControllersPerColumn () const
	Number of microcontrollers (uC) per column.
virtual uint32_t	getNumControllers () const
	Total number of microcontrollers (uC) in the device.
virtual AIETileType	getTileType (int col, int row) const =0
	Return the tile type for the given tile coordinates.
bool	isCoreTile (int col, int row) const
	Return true if the given tile is a Core tile.
bool	isMemTile (int col, int row) const
	Return true if the given tile is a Mem tile.
bool	isShimNOCTile (int col, int row) const
	Return true if the given tile is a ShimNOC tile.
bool	isShimPLTile (int col, int row) const
	Return true if the given tile is a ShimPL tile.
bool	isShimNOCorPLTile (int col, int row) const
	Return true if the given tile is either a ShimNOC or ShimPL tile.
virtual bool	isValidTile (TileID src) const
	Return true if the given tile ID is valid.
bool	isInternal (int srcCol, int srcRow, int dstCol, int dstRow) const
	Return true if src is the internal memory of dst.
bool	isWest (int srcCol, int srcRow, int dstCol, int dstRow) const
	Return true if src is West of dst.
bool	isEast (int srcCol, int srcRow, int dstCol, int dstRow) const
	Return true if src is East of dst.
bool	isNorth (int srcCol, int srcRow, int dstCol, int dstRow) const
	Return true if src is North of dst.
bool	isSouth (int srcCol, int srcRow, int dstCol, int dstRow) const
	Return true if src is South of dst.
SharedMemory	getSharedMemory (TileID a, TileID b) const
	Return the memory module a and b can both reach, if any.
std::optional< uint32_t >	getLockLocalBaseIndex (int localCol, int localRow, int lockCol, int lockRow) const
	Return the lock base index (or offset) in the local tile when accessing a neighbor's lock or an empty optional if an invalid neighbor is given Takes into account differences between Memory and Core tiles.
std::optional< uint32_t >	getMemLocalBaseAddress (int localCol, int localRow, int memCol, int memRow) const
	Return the memory base address (or offset) in the local tile when accessing a neighbor's memory or an empty optional if an invalid neighbor is given Takes into account differences between Memory and Core tiles.
virtual uint32_t	getDefaultCoreStackSize () const
	Return the default stack reservation (in bytes) for a core that does not state one.
uint32_t	getCoreStackAlignment () const
	Stack-pointer alignment in bytes, matching Peano's AIE frame lowering: AIE1/AIE2 require 32B; AIE2P/AIE2PS require 64B, not their 32B data bus.
virtual uint32_t	getMemTileLoadStoreBusWidth () const
	Return the data bus width (in bits) for load/store operations of a memory tile.
uint32_t	getNumLocks (int col, int row) const
	Return the number of lock objects for a tile at the given coordinates.
uint32_t	getNumBDs (int col, int row) const
	Return the number of buffer descriptors supported by the DMA in the given tile.
uint32_t	getBDMaxDims (int col, int row) const
	Return the maximum number of BD addressing dimensions for the tile at (col, row).
uint64_t	getDmaBdMaxLen (int col, int row) const
uint32_t	getDmaBdWrapBits (int col, int row) const
uint32_t	getDmaBdStepBits (int col, int row) const
uint32_t	getDmaBdIterBits (int col, int row) const
uint32_t	getNumBDsForChannel (int col, int row, int channel) const
	Return the number of buffer descriptors accessible on channel channel for the tile at (col, row).
std::pair< uint32_t, uint32_t >	getBdIdRangeForChannel (int col, int row, int channel) const
	Return the half-open range [first, last) of buffer descriptor ids that channel channel of the tile at (col, row) can submit.
const DmaBdLayout *	getDmaBdLayout (int col, int row) const
uint32_t	getLocalDmaControlAddress (int col, int row, int channel, AIE::DMAChannelDir direction) const
	Return the DMA task-queue register address relative to its tile.
virtual uint32_t	getNumMemTileRows () const =0
uint32_t	getDmaTaskQueueDepth (int, int, int, AIE::DMAChannelDir) const
	Return the task-queue depth for one channel.
void	validate () const
uint32_t	getModelProperties () const
void	addModelProperty (uint32_t prop)
bool	hasProperty (ModelProperty Prop) const
virtual uint32_t	getDefaultAxCache () const
virtual bool	isSupportedBlockFormat (std::string const &format) const
virtual bool	isMemTilePadValueSupported () const
const RegisterInfo *	lookupRegister (llvm::StringRef name, TileID tile, bool isMem=false) const
	Register Database API - provides access to register and event information for trace configuration and low-level register access.
std::optional< uint32_t >	lookupEvent (llvm::StringRef name, TileID tile, bool isMem=false) const
	Lookup event number by name and tile.
std::optional< uint32_t >	encodeFieldValue (const BitFieldInfo &field, uint32_t value) const
	Encode a field value with proper bit shifting.
std::optional< uint32_t >	getFieldMask (const BitFieldInfo &field) const
	Compute a 32-bit mask for a register field.
llvm::DenseMap< TileID, int >	getTileToControllerIdMap (bool columnWiseUniqueIDs=true) const
	Return a mapping from tile coordinates to controller IDs.
std::optional< uint32_t >	resolvePortValue (llvm::StringRef value, TileID tile, bool master) const
	Resolve stream switch port specification to port index.

Static Public Member Functions
static bool	classof (const AIETargetModel *model)

Protected Member Functions
std::unique_ptr< RegisterDatabase >	loadRegisterDatabase () const override
	AIE2 TargetModel.
Protected Member Functions inherited from xilinx::AIE::AIETargetModel
const RegisterDatabase *	getRegisterDatabase () const
	Get the register database, loading it lazily on first access.

Additional Inherited Members
Public Types inherited from xilinx::AIE::AIETargetModel
enum	TargetModelKind { TK_AIE1_VC1902 , TK_AIE1_Last , TK_AIE2_VE2302 , TK_AIE2_VE2802 , TK_AIE2_NPU1_1Col , TK_AIE2_NPU1_2Col , TK_AIE2_NPU1_3Col , TK_AIE2_NPU1_4Col , TK_AIE2_NPU1_Last , TK_AIE2_NPU2 = TK_AIE2_NPU1_Last , TK_AIE2_NPU2_1Col , TK_AIE2_NPU2_2Col , TK_AIE2_NPU2_3Col , TK_AIE2_NPU2_4Col , TK_AIE2_NPU2_5Col , TK_AIE2_NPU2_6Col , TK_AIE2_NPU2_7Col , TK_AIE2_NPU2_Last , TK_AIE2PS_VE3858 = TK_AIE2_NPU2_Last , TK_AIE2PS_Last , TK_AIE2_Last = TK_AIE2PS_Last }
enum	ModelProperty { UsesSemaphoreLocks = 1U << 0 , IsNPU = 1U << 1 , IsVirtualized = 1U << 2 , UsesMultiDimensionalBDs = 1U << 3 , UsesBDIteration = 1U << 4 , SupportsOutOfOrderDMA = 1U << 5 }
enum class	SharedMemory { None , First , Second , Either }
	Which of two tiles' memory modules both of them can address. More...

Detailed Description

Definition at line 845 of file AIETargetModel.h.

Constructor & Destructor Documentation

◆ AIE2TargetModel()

xilinx::AIE::AIE2TargetModel::AIE2TargetModel ( TargetModelKind k )

inline

Definition at line 850 of file AIETargetModel.h.

References xilinx::AIE::AIETargetModel::addModelProperty(), xilinx::AIE::AIETargetModel::AIETargetModel(), xilinx::AIE::AIETargetModel::SupportsOutOfOrderDMA, xilinx::AIE::AIETargetModel::UsesBDIteration, xilinx::AIE::AIETargetModel::UsesMultiDimensionalBDs, and xilinx::AIE::AIETargetModel::UsesSemaphoreLocks.

Referenced by xilinx::AIE::AIE2PSTargetModel::AIE2PSTargetModel(), xilinx::AIE::BaseNPU1TargetModel::BaseNPU1TargetModel(), xilinx::AIE::BaseNPU2TargetModel::BaseNPU2TargetModel(), xilinx::AIE::VE2302TargetModel::VE2302TargetModel(), and xilinx::AIE::VE2802TargetModel::VE2802TargetModel().

Member Function Documentation

◆ classof()

bool xilinx::AIE::AIE2TargetModel::classof ( const AIETargetModel * model )

inlinestatic

Definition at line 1002 of file AIETargetModel.h.

References xilinx::AIE::AIETargetModel::AIETargetModel(), xilinx::AIE::AIETargetModel::getKind(), xilinx::AIE::AIETargetModel::TK_AIE2_Last, and xilinx::AIE::AIETargetModel::TK_AIE2_VE2302.

◆ getAccumulatorCascadeSize()

uint32_t xilinx::AIE::AIE2TargetModel::getAccumulatorCascadeSize ( ) const

inlineoverridevirtual

Return the size (in bits) of the accumulator/cascade.

Implements xilinx::AIE::AIETargetModel.

Definition at line 896 of file AIETargetModel.h.

◆ getAddressGenGranularity()

uint32_t xilinx::AIE::AIE2TargetModel::getAddressGenGranularity ( ) const

inlineoverridevirtual

Return the data bus width of the device.

Implements xilinx::AIE::AIETargetModel.

Definition at line 860 of file AIETargetModel.h.

◆ getBDMaxDims()

uint32_t xilinx::AIE::AIE2TargetModel::getBDMaxDims ( AIETileType tileType ) const

inlineoverridevirtual

Return the maximum number of addressing dimensions (wraps/strides) a single buffer descriptor supports for a given tile type.

This is the hardware ND access-pattern limit; it does not count the separate shim iteration/repeat dimension that runtime-sequence BD tasks hoist the leading tap dimension into.

Implements xilinx::AIE::AIETargetModel.

Definition at line 913 of file AIETargetModel.h.

◆ getColumnShift()

uint32_t xilinx::AIE::AIE2TargetModel::getColumnShift ( ) const

inlineoverridevirtual

Implements xilinx::AIE::AIETargetModel.

Definition at line 999 of file AIETargetModel.h.

Referenced by xilinx::AIE::AIE2PSTargetModel::getDmaBdAddress(), getDmaBdAddress(), xilinx::AIE::AIE2PSTargetModel::getDmaControlAddress(), getDmaControlAddress(), and getDmaStatusAddress().

◆ getComputeTileLoadStoreBusWidth()

uint32_t xilinx::AIE::AIE2TargetModel::getComputeTileLoadStoreBusWidth ( ) const

inlineoverridevirtual

Return the data bus width (in bits) for load/store operations of a compute core.

Implements xilinx::AIE::AIETargetModel.

Definition at line 897 of file AIETargetModel.h.

◆ getComputeTileMaxVectorAlignBits()

uint32_t xilinx::AIE::AIE2TargetModel::getComputeTileMaxVectorAlignBits ( ) const

inlineoverridevirtual

Return the alignment (in bits) required by the widest vector load/store a compute core can issue.

This is NOT the load/store bus width. From AIE2P on, a full-width (512-bit) vector access requires 512-bit alignment even though the bus is 256 bits wide. Mirrors vector_ldst_align in aie_api (aie_api/detail/ld_st.hpp), which is the contract kernels compile against: AIE1 (AIE_ARCH 10): 16B AIE2 (AIE_ARCH 20): 32B AIE2P/AIE2PS (AIE_ARCH 21/22): 64B A buffer a core may access with a full-width vector must be aligned to this, or the access silently touches the wrong memory.

Reimplemented from xilinx::AIE::AIETargetModel.

Reimplemented in xilinx::AIE::BaseNPU2TargetModel.

Definition at line 898 of file AIETargetModel.h.

◆ getCoreDataAddressSpaceSize()

uint32_t xilinx::AIE::AIE2TargetModel::getCoreDataAddressSpaceSize ( ) const

inlineoverridevirtual

Return the size (in bytes) of the address space a core can issue data accesses into.

The neighbour memory windows sit at the bottom of it; the span above them reaches no memory and is reserved so nothing is placed there.

Implements xilinx::AIE::AIETargetModel.

Definition at line 895 of file AIETargetModel.h.

◆ getDmaBdAddress()

uint64_t xilinx::AIE::AIE2TargetModel::getDmaBdAddress	(	int	col,
		int	row,
		uint32_t	bd_id,
		int	channel,
		AIE::DMAChannelDir	direction ) const

overridevirtual

Return the array address of the dma buffer descriptor for the given col, row, buffer descriptor id, channel and direction.

Not all architecture variants will use channel and direction so these have default values.

Implements xilinx::AIE::AIETargetModel.

Definition at line 827 of file AIETargetModel.cpp.

References getColumnShift(), getRowShift(), xilinx::AIE::AIETargetModel::isCoreTile(), xilinx::AIE::AIETargetModel::isMemTile(), and xilinx::AIE::AIETargetModel::isShimNOCTile().

Referenced by xilinx::AIE::AIE2PSTargetModel::getDmaBdAddress().

◆ getDmaBdAddressOffset()

uint32_t xilinx::AIE::AIE2TargetModel::getDmaBdAddressOffset	(	int	col,
		int	row ) const

overridevirtual

Return the offset of the base address field within the shim dma buffer descriptor.

Implements xilinx::AIE::AIETargetModel.

Definition at line 962 of file AIETargetModel.cpp.

References xilinx::AIE::AIETargetModel::isCoreTile().

◆ getDmaBdIterBits()

uint32_t xilinx::AIE::AIE2TargetModel::getDmaBdIterBits ( AIETileType tileType ) const

inlineoverridevirtual

Return the bit width of the iteration (repeat) wrap/stride fields in a DMA buffer descriptor for the given tile type.

Implements xilinx::AIE::AIETargetModel.

Definition at line 932 of file AIETargetModel.h.

References getDmaBdLimits(), xilinx::AIE::DmaBdLayout::iterationSize, and xilinx::AIE::DmaBdField::width.

◆ getDmaBdLayout() [1/2]

const DmaBdLayout * xilinx::AIE::AIE2TargetModel::getDmaBdLayout ( AIETileType tileType ) const

overridevirtual

Return the register layout of a buffer descriptor on the given tile type, or null if the target has none modeled for it.

Reimplemented from xilinx::AIE::AIETargetModel.

Definition at line 946 of file AIETargetModel.cpp.

Referenced by getDmaBdLimits().

◆ getDmaBdLayout() [2/2]

const DmaBdLayout * xilinx::AIE::AIETargetModel::getDmaBdLayout	(	int	col,
		int	row ) const

inline

Definition at line 527 of file AIETargetModel.h.

◆ getDmaBdLimits()

const DmaBdLayout & xilinx::AIE::AIE2TargetModel::getDmaBdLimits ( AIETileType tileType ) const

inline

Definition at line 919 of file AIETargetModel.h.

References getDmaBdLayout().

Referenced by getDmaBdIterBits(), getDmaBdMaxLen(), getDmaBdStepBits(), and getDmaBdWrapBits().

◆ getDmaBdMaxLen()

uint64_t xilinx::AIE::AIE2TargetModel::getDmaBdMaxLen ( AIETileType tileType ) const

inlineoverridevirtual

Return the maximum transfer length, measured in address-generation granules (see getAddressGenGranularity(), 32-bit words on AIE2), that fits in the buffer_length field of a DMA buffer descriptor for the given tile type.

The field width is tile-type specific (e.g. on AIE2 the shim field is 32 bits, the mem-tile field 17 bits and the core-tile field 14 bits).

Implements xilinx::AIE::AIETargetModel.

Definition at line 923 of file AIETargetModel.h.

References xilinx::AIE::DmaBdLayout::bufferLength, getDmaBdLimits(), and xilinx::AIE::DmaBdField::mask().

◆ getDmaBdStepBits()

uint32_t xilinx::AIE::AIE2TargetModel::getDmaBdStepBits ( AIETileType tileType ) const

inlineoverridevirtual

Return the bit width of the step (stride) field in a DMA buffer descriptor for the given tile type.

Implements xilinx::AIE::AIETargetModel.

Definition at line 929 of file AIETargetModel.h.

References xilinx::AIE::DmaBdLayout::d0Stride, getDmaBdLimits(), and xilinx::AIE::DmaBdField::width.

◆ getDmaBdWrapBits()

uint32_t xilinx::AIE::AIE2TargetModel::getDmaBdWrapBits ( AIETileType tileType ) const

inlineoverridevirtual

Return the bit width of the wrap (size) field in a DMA buffer descriptor for the given tile type.

Used to compute the maximum legal wrap value per dimension.

Implements xilinx::AIE::AIETargetModel.

Definition at line 926 of file AIETargetModel.h.

References xilinx::AIE::DmaBdLayout::d0Size, getDmaBdLimits(), and xilinx::AIE::DmaBdField::width.

◆ getDmaChannelIdleMask()

uint32_t xilinx::AIE::AIE2TargetModel::getDmaChannelIdleMask ( ) const

inlineoverridevirtual

Return the bits of the getDmaStatusAddress() register that are all clear exactly when the channel has finished every task pushed to it: nothing queued, nothing running, nothing stalled (0 when unsupported).

Reimplemented from xilinx::AIE::AIETargetModel.

Definition at line 968 of file AIETargetModel.h.

References getDmaTaskQueueSizeMask().

◆ getDmaControlAddress()

uint32_t xilinx::AIE::AIE2TargetModel::getDmaControlAddress	(	int	col,
		int	row,
		int	channel,
		AIE::DMAChannelDir	direction ) const

overridevirtual

Return the array address of the dma task queue register for the given col, row, channel and direction.

Implements xilinx::AIE::AIETargetModel.

Definition at line 969 of file AIETargetModel.cpp.

References getColumnShift(), getRowShift(), xilinx::AIE::AIETargetModel::isCoreTile(), xilinx::AIE::AIETargetModel::isMemTile(), and xilinx::AIE::AIETargetModel::isShimNOCTile().

Referenced by xilinx::AIE::AIE2PSTargetModel::getDmaControlAddress().

◆ getDmaStatusAddress()

std::optional< uint32_t > xilinx::AIE::AIE2TargetModel::getDmaStatusAddress	(	int	,
		int	,
		int	,
		AIE::DMAChannelDir	) const

overridevirtual

Return the address of the DMA status register for a channel, or nullopt when this target's layout has not been verified.

The register carries the live task-queue occupancy in getDmaTaskQueueSizeMask(), which is the only way to observe queue space: the queue does not backpressure, so a push onto a full queue is dropped rather than stalled.

Reimplemented from xilinx::AIE::AIETargetModel.

Definition at line 994 of file AIETargetModel.cpp.

References getColumnShift(), getRowShift(), xilinx::AIE::AIETargetModel::isCoreTile(), xilinx::AIE::AIETargetModel::isMemTile(), and xilinx::AIE::AIETargetModel::isShimNOCTile().

Referenced by xilinx::AIE::AIE2PSTargetModel::getDmaStatusAddress().

◆ getDmaTaskQueueDepth()

uint32_t xilinx::AIE::AIE2TargetModel::getDmaTaskQueueDepth ( ) const

inlineoverridevirtual

Return how many DMA tasks a single channel's task queue holds (unsupported = 0).

Pushing to a full queue drops the push and sets the channel's sticky Task_Queue_Overflow bit, stranding whoever waits on that transfer. Flat rather than per-tile-type because aie-rt's XAie_DmaGetMaxQueueSize (XAIE_DMA_MAX_QUEUE_SIZE) returns the same depth for every tile type and architecture.

Implements xilinx::AIE::AIETargetModel.

Definition at line 868 of file AIETargetModel.h.

◆ getDmaTaskQueueSizeMask()

uint32_t xilinx::AIE::AIE2TargetModel::getDmaTaskQueueSizeMask ( ) const

inlineoverridevirtual

Return the mask selecting the live task-queue occupancy field within the getDmaStatusAddress() register (0 when unsupported).

The field does not count the task the channel is running.

Reimplemented from xilinx::AIE::AIETargetModel.

Definition at line 963 of file AIETargetModel.h.

Referenced by getDmaChannelIdleMask().

◆ getLocalLockAddress()

std::optional< uint32_t > xilinx::AIE::AIE2TargetModel::getLocalLockAddress	(	uint32_t	lockId,
		TileID	tile ) const

overridevirtual

Implements xilinx::AIE::AIETargetModel.

Definition at line 1308 of file AIETargetModel.cpp.

References getNumLocks(), xilinx::AIE::AIETargetModel::isCoreTile(), xilinx::AIE::AIETargetModel::isMemTile(), and xilinx::AIE::AIETargetModel::isShimNOCorPLTile().

◆ getLocalMemorySize()

uint32_t xilinx::AIE::AIE2TargetModel::getLocalMemorySize ( ) const

inlineoverridevirtual

Return the size (in bytes) of the local data memory of a core.

Implements xilinx::AIE::AIETargetModel.

Definition at line 893 of file AIETargetModel.h.

◆ getMaxChannelNumForAdjacentMemTile()

uint32_t xilinx::AIE::AIE2TargetModel::getMaxChannelNumForAdjacentMemTile	(	int	col,
		int	row ) const

inlineoverridevirtual

Implements xilinx::AIE::AIETargetModel.

Definition at line 978 of file AIETargetModel.h.

◆ getMaxLockValue()

uint32_t xilinx::AIE::AIE2TargetModel::getMaxLockValue ( ) const

inlineoverridevirtual

Return the maximum value that can be stored in a lock register.

Implements xilinx::AIE::AIETargetModel.

Definition at line 905 of file AIETargetModel.h.

◆ getMaxOutOfOrderId()

uint32_t xilinx::AIE::AIE2TargetModel::getMaxOutOfOrderId ( ) const

inlineoverridevirtual

Return the largest out-of-order BD id (unsupported = 0).

Implements xilinx::AIE::AIETargetModel.

Definition at line 866 of file AIETargetModel.h.

◆ getMaxPacketId()

uint32_t xilinx::AIE::AIE2TargetModel::getMaxPacketId ( ) const

inlineoverridevirtual

Return the largest packet id the stream switch can route.

Implements xilinx::AIE::AIETargetModel.

Definition at line 865 of file AIETargetModel.h.

◆ getMaxRepeatCount()

uint32_t xilinx::AIE::AIE2TargetModel::getMaxRepeatCount ( ) const

inlineoverridevirtual

Return the largest DMA task repeat count (unsupported = 0).

Implements xilinx::AIE::AIETargetModel.

Definition at line 867 of file AIETargetModel.h.

◆ getMemEast()

std::optional< TileID > xilinx::AIE::AIE2TargetModel::getMemEast ( TileID src ) const

overridevirtual

Return the tile ID of the memory to the east of the given tile, if it exists.

Implements xilinx::AIE::AIETargetModel.

Definition at line 766 of file AIETargetModel.cpp.

References xilinx::AIE::AIETargetModel::isValidTile().

◆ getMemEastBaseAddress()

uint32_t xilinx::AIE::AIE2TargetModel::getMemEastBaseAddress ( ) const

inlineoverridevirtual

Return the base address in the local address map for a core.

Implements xilinx::AIE::AIETargetModel.

Definition at line 892 of file AIETargetModel.h.

Referenced by getMemInternalBaseAddress().

◆ getMemInternalBaseAddress()

uint32_t xilinx::AIE::AIE2TargetModel::getMemInternalBaseAddress ( TileID src ) const

inlineoverridevirtual

Return the base address in the local address map for a core.

Implements xilinx::AIE::AIETargetModel.

Definition at line 885 of file AIETargetModel.h.

References getMemEastBaseAddress().

◆ getMemNorth()

std::optional< TileID > xilinx::AIE::AIE2TargetModel::getMemNorth ( TileID src ) const

overridevirtual

Return the tile ID of the memory to the north of the given tile, if it exists.

Implements xilinx::AIE::AIETargetModel.

Definition at line 775 of file AIETargetModel.cpp.

References xilinx::AIE::AIETargetModel::isValidTile().

◆ getMemNorthBaseAddress()

uint32_t xilinx::AIE::AIE2TargetModel::getMemNorthBaseAddress ( ) const

inlineoverridevirtual

Return the base address in the local address map for a core.

Implements xilinx::AIE::AIETargetModel.

Definition at line 891 of file AIETargetModel.h.

◆ getMemSouth()

std::optional< TileID > xilinx::AIE::AIE2TargetModel::getMemSouth ( TileID src ) const

overridevirtual

Return the tile ID of the memory to the south of the given tile, if it exists.

Implements xilinx::AIE::AIETargetModel.

Definition at line 782 of file AIETargetModel.cpp.

References xilinx::AIE::AIETargetModel::isMemTile(), and xilinx::AIE::AIETargetModel::isValidTile().

◆ getMemSouthBaseAddress()

uint32_t xilinx::AIE::AIE2TargetModel::getMemSouthBaseAddress ( ) const

inlineoverridevirtual

Return the base address in the local address map for a core.

Implements xilinx::AIE::AIETargetModel.

Definition at line 889 of file AIETargetModel.h.

◆ getMemTileSize()

uint32_t xilinx::AIE::AIE2TargetModel::getMemTileSize ( ) const

inlineoverridevirtual

Return the size (in bytes) of a MemTile.

Implements xilinx::AIE::AIETargetModel.

Definition at line 972 of file AIETargetModel.h.

◆ getMemWest()

std::optional< TileID > xilinx::AIE::AIE2TargetModel::getMemWest ( TileID src ) const

overridevirtual

Return the tile ID of the memory to the west of the given tile, if it exists.

Implements xilinx::AIE::AIETargetModel.

Definition at line 757 of file AIETargetModel.cpp.

References xilinx::AIE::AIETargetModel::isValidTile().

◆ getMemWestBaseAddress()

uint32_t xilinx::AIE::AIE2TargetModel::getMemWestBaseAddress ( ) const

inlineoverridevirtual

Return the base address in the local address map for a core.

Implements xilinx::AIE::AIETargetModel.

Definition at line 890 of file AIETargetModel.h.

◆ getNumArbiters()

uint32_t xilinx::AIE::AIE2TargetModel::getNumArbiters ( ) const

inlineoverridevirtual

Return the number of arbiters per stream switch.

Implements xilinx::AIE::AIETargetModel.

Definition at line 863 of file AIETargetModel.h.

◆ getNumBanks()

uint32_t xilinx::AIE::AIE2TargetModel::getNumBanks	(	int	col,
		int	row ) const

inlineoverridevirtual

Return the number of memory banks of a given tile.

Implements xilinx::AIE::AIETargetModel.

Definition at line 974 of file AIETargetModel.h.

References xilinx::AIE::AIETargetModel::getTileType().

◆ getNumBDs()

uint32_t xilinx::AIE::AIE2TargetModel::getNumBDs ( AIETileType tileType ) const

inlineoverridevirtual

Return the number of buffer descriptors for a given tile type.

Implements xilinx::AIE::AIETargetModel.

Definition at line 910 of file AIETargetModel.h.

◆ getNumDestShimMuxConnections()

uint32_t xilinx::AIE::AIE2TargetModel::getNumDestShimMuxConnections	(	int	col,
		int	row,
		WireBundle	bundle ) const

overridevirtual

Return the number of destinations of connections inside a shimmux.

These are the targets of connect operations in the switchbox.

Implements xilinx::AIE::AIETargetModel.

Definition at line 1170 of file AIETargetModel.cpp.

References xilinx::AIE::AIETargetModel::isShimNOCorPLTile().

◆ getNumDestSwitchboxConnections()

uint32_t xilinx::AIE::AIE2TargetModel::getNumDestSwitchboxConnections	(	int	col,
		int	row,
		WireBundle	bundle ) const

overridevirtual

Return the number of destinations of connections inside a switchbox.

These are the targets of connect operations in the switchbox.

Implements xilinx::AIE::AIETargetModel.

Definition at line 1020 of file AIETargetModel.cpp.

References xilinx::AIE::AIETargetModel::columns(), xilinx::AIE::AIETargetModel::isMemTile(), xilinx::AIE::AIETargetModel::isShimNOCTile(), xilinx::AIE::AIETargetModel::isShimPLTile(), and xilinx::AIE::AIETargetModel::rows().

Referenced by xilinx::AIE::AIE2PSTargetModel::getNumDestSwitchboxConnections(), and isLegalTileConnection().

◆ getNumLocks() [1/2]

uint32_t xilinx::AIE::AIE2TargetModel::getNumLocks ( AIETileType tileType ) const

inlineoverridevirtual

Return the number of lock objects for a given tile type.

Implements xilinx::AIE::AIETargetModel.

Definition at line 901 of file AIETargetModel.h.

Referenced by getLocalLockAddress().

◆ getNumLocks() [2/2]

uint32_t xilinx::AIE::AIETargetModel::getNumLocks	(	int	col,
		int	row ) const

inline

Return the number of lock objects for a tile at the given coordinates.

Definition at line 414 of file AIETargetModel.h.

◆ getNumMselsPerArbiter()

uint32_t xilinx::AIE::AIE2TargetModel::getNumMselsPerArbiter ( ) const

inlineoverridevirtual

Return the number of master select values per stream-switch arbiter.

Implements xilinx::AIE::AIETargetModel.

Definition at line 864 of file AIETargetModel.h.

◆ getNumSlaveSlots()

uint32_t xilinx::AIE::AIE2TargetModel::getNumSlaveSlots ( ) const

inlineoverridevirtual

Return the number of packet-rule slots per stream-switch slave port.

Implements xilinx::AIE::AIETargetModel.

Definition at line 862 of file AIETargetModel.h.

◆ getNumSourceShimMuxConnections()

uint32_t xilinx::AIE::AIE2TargetModel::getNumSourceShimMuxConnections	(	int	col,
		int	row,
		WireBundle	bundle ) const

overridevirtual

Return the number of sources of connections inside a shimmux.

These are the origins of connect operations in the switchbox.

Implements xilinx::AIE::AIETargetModel.

Definition at line 1190 of file AIETargetModel.cpp.

References xilinx::AIE::AIETargetModel::isShimNOCorPLTile().

◆ getNumSourceSwitchboxConnections()

uint32_t xilinx::AIE::AIE2TargetModel::getNumSourceSwitchboxConnections	(	int	col,
		int	row,
		WireBundle	bundle ) const

overridevirtual

Return the number of sources of connections inside a switchbox.

These are the origins of connect operations in the switchbox.

Implements xilinx::AIE::AIETargetModel.

Definition at line 1091 of file AIETargetModel.cpp.

References xilinx::AIE::AIETargetModel::columns(), xilinx::AIE::AIETargetModel::isMemTile(), xilinx::AIE::AIETargetModel::isShimNOCTile(), xilinx::AIE::AIETargetModel::isShimPLTile(), and xilinx::AIE::AIETargetModel::rows().

Referenced by xilinx::AIE::AIE2PSTargetModel::getNumSourceSwitchboxConnections(), and isLegalTileConnection().

◆ getProgramMemorySize()

uint32_t xilinx::AIE::AIE2TargetModel::getProgramMemorySize ( ) const

inlineoverridevirtual

Return the size (in bytes) of a core's program memory.

Implements xilinx::AIE::AIETargetModel.

Definition at line 894 of file AIETargetModel.h.

◆ getRowShift()

uint32_t xilinx::AIE::AIE2TargetModel::getRowShift ( ) const

inlineoverridevirtual

Implements xilinx::AIE::AIETargetModel.

Definition at line 1000 of file AIETargetModel.h.

Referenced by xilinx::AIE::AIE2PSTargetModel::getDmaBdAddress(), getDmaBdAddress(), xilinx::AIE::AIE2PSTargetModel::getDmaControlAddress(), getDmaControlAddress(), and getDmaStatusAddress().

◆ getShimBurstEncodingsAndLengths()

std::vector< std::pair< uint32_t, uint32_t > > xilinx::AIE::AIE2TargetModel::getShimBurstEncodingsAndLengths ( ) const

overridevirtual

Implements xilinx::AIE::AIETargetModel.

Reimplemented in xilinx::AIE::BaseNPU2TargetModel.

Definition at line 1303 of file AIETargetModel.cpp.

◆ getStreamSwitchPortIndex()

std::optional< uint32_t > xilinx::AIE::AIE2TargetModel::getStreamSwitchPortIndex	(	int	col,
		int	row,
		WireBundle	bundle,
		uint32_t	channel,
		bool	master ) const

overridevirtual

Get stream switch port index for a given port specification Return port index for Stream_Switch_Event_Port_Selection register, or nullopt if invalid.

Implements xilinx::AIE::AIETargetModel.

Definition at line 1434 of file AIETargetModel.cpp.

References xilinx::AIE::AIETargetModel::isCoreTile(), xilinx::AIE::AIETargetModel::isMemTile(), and xilinx::AIE::AIETargetModel::isShimNOCTile().

Referenced by xilinx::AIE::AIE2PSTargetModel::getStreamSwitchPortIndex().

◆ getTargetArch()

AIEArch xilinx::AIE::AIE2TargetModel::getTargetArch ( ) const

overridevirtual

Return the target architecture.

Implements xilinx::AIE::AIETargetModel.

Reimplemented in xilinx::AIE::BaseNPU2TargetModel.

Definition at line 754 of file AIETargetModel.cpp.

References xilinx::AIE2.

◆ isBdChannelAccessible()

bool xilinx::AIE::AIE2TargetModel::isBdChannelAccessible	(	int	col,
		int	row,
		uint32_t	bd_id,
		int	channel ) const

inlineoverridevirtual

Return true iff buffer descriptor bd_id on tile (col, row) can be submitted on channel channel.

Implements xilinx::AIE::AIETargetModel.

Definition at line 936 of file AIETargetModel.h.

References xilinx::AIE::AIETargetModel::getTileType().

◆ isLegalMemAffinity()

bool xilinx::AIE::AIE2TargetModel::isLegalMemAffinity	(	int	coreCol,
		int	coreRow,
		int	memCol,
		int	memRow ) const

overridevirtual

Return true if core can access the memory in mem.

Implements xilinx::AIE::AIETargetModel.

Definition at line 811 of file AIETargetModel.cpp.

References xilinx::AIE::AIETargetModel::isEast(), xilinx::AIE::AIETargetModel::isInternal(), isMemEast(), isMemNorth(), isMemSouth(), xilinx::AIE::AIETargetModel::isMemTile(), isMemWest(), and xilinx::AIE::AIETargetModel::isWest().

◆ isLegalTileConnection()

bool xilinx::AIE::AIE2TargetModel::isLegalTileConnection	(	int	col,
		int	row,
		WireBundle	srcBundle,
		int	srcChan,
		WireBundle	dstBundle,
		int	dstChan ) const

overridevirtual

Implements xilinx::AIE::AIETargetModel.

Definition at line 1209 of file AIETargetModel.cpp.

References getNumDestSwitchboxConnections(), getNumSourceSwitchboxConnections(), xilinx::AIE::AIETargetModel::isCoreTile(), xilinx::AIE::AIETargetModel::isMemTile(), and xilinx::AIE::AIETargetModel::isShimNOCorPLTile().

◆ isMemEast()

bool xilinx::AIE::AIE2TargetModel::isMemEast	(	int	srcCol,
		int	srcRow,
		int	dstCol,
		int	dstRow ) const

overridevirtual

Return true if src has a memory tile which is East of dst.

Implements xilinx::AIE::AIETargetModel.

Definition at line 796 of file AIETargetModel.cpp.

References xilinx::AIE::AIETargetModel::isInternal().

Referenced by isLegalMemAffinity().

◆ isMemNorth()

bool xilinx::AIE::AIE2TargetModel::isMemNorth	(	int	srcCol,
		int	srcRow,
		int	dstCol,
		int	dstRow ) const

overridevirtual

Return true if src has a memory tile which is North of dst.

Implements xilinx::AIE::AIETargetModel.

Definition at line 801 of file AIETargetModel.cpp.

References xilinx::AIE::AIETargetModel::isNorth().

Referenced by isLegalMemAffinity().

◆ isMemSouth()

bool xilinx::AIE::AIE2TargetModel::isMemSouth	(	int	srcCol,
		int	srcRow,
		int	dstCol,
		int	dstRow ) const

overridevirtual

Return true if src has a memory tile which is South of dst.

Implements xilinx::AIE::AIETargetModel.

Definition at line 806 of file AIETargetModel.cpp.

References xilinx::AIE::AIETargetModel::isSouth().

Referenced by isLegalMemAffinity().

◆ isMemWest()

bool xilinx::AIE::AIE2TargetModel::isMemWest	(	int	srcCol,
		int	srcRow,
		int	dstCol,
		int	dstRow ) const

overridevirtual

Return true if src has a memory tile which is West of dst.

Implements xilinx::AIE::AIETargetModel.

Definition at line 791 of file AIETargetModel.cpp.

References xilinx::AIE::AIETargetModel::isWest().

Referenced by isLegalMemAffinity().

◆ loadRegisterDatabase()

std::unique_ptr< RegisterDatabase > xilinx::AIE::AIE2TargetModel::loadRegisterDatabase ( ) const

overrideprotectedvirtual

AIE2 TargetModel.

Reimplemented from xilinx::AIE::AIETargetModel.

Definition at line 750 of file AIETargetModel.cpp.

References xilinx::AIE::RegisterDatabase::loadAIE2().

The documentation for this class was generated from the following files:

include/aie/Dialect/AIE/IR/AIETargetModel.h
lib/Dialect/AIE/IR/AIETargetModel.cpp

Public Member Functions

Static Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ AIE2TargetModel()

Member Function Documentation

◆ classof()

◆ getAccumulatorCascadeSize()

◆ getAddressGenGranularity()

◆ getBDMaxDims()

◆ getColumnShift()

◆ getComputeTileLoadStoreBusWidth()

◆ getComputeTileMaxVectorAlignBits()

◆ getCoreDataAddressSpaceSize()

◆ getDmaBdAddress()

◆ getDmaBdAddressOffset()

◆ getDmaBdIterBits()

◆ getDmaBdLayout() [1/2]

◆ getDmaBdLayout() [2/2]

◆ getDmaBdLimits()

◆ getDmaBdMaxLen()

◆ getDmaBdStepBits()

◆ getDmaBdWrapBits()

◆ getDmaChannelIdleMask()

◆ getDmaControlAddress()

◆ getDmaStatusAddress()

◆ getDmaTaskQueueDepth()

◆ getDmaTaskQueueSizeMask()

◆ getLocalLockAddress()

◆ getLocalMemorySize()

◆ getMaxChannelNumForAdjacentMemTile()

◆ getMaxLockValue()

◆ getMaxOutOfOrderId()

◆ getMaxPacketId()

◆ getMaxRepeatCount()

◆ getMemEast()

◆ getMemEastBaseAddress()

◆ getMemInternalBaseAddress()

◆ getMemNorth()

◆ getMemNorthBaseAddress()

◆ getMemSouth()

◆ getMemSouthBaseAddress()

◆ getMemTileSize()

◆ getMemWest()

◆ getMemWestBaseAddress()

◆ getNumArbiters()

◆ getNumBanks()

◆ getNumBDs()

◆ getNumDestShimMuxConnections()

◆ getNumDestSwitchboxConnections()

◆ getNumLocks() [1/2]

◆ getNumLocks() [2/2]

◆ getNumMselsPerArbiter()

◆ getNumSlaveSlots()

◆ getNumSourceShimMuxConnections()

◆ getNumSourceSwitchboxConnections()

◆ getProgramMemorySize()

◆ getRowShift()

◆ getShimBurstEncodingsAndLengths()

◆ getStreamSwitchPortIndex()

◆ getTargetArch()

◆ isBdChannelAccessible()

◆ isLegalMemAffinity()

◆ isLegalTileConnection()

◆ isMemEast()

◆ isMemNorth()

◆ isMemSouth()

◆ isMemWest()

◆ loadRegisterDatabase()