fabric

FPGA fabric definition module.

This module contains the Fabric class which represents the complete FPGA fabric including tile layout, configuration parameters, and connectivity information. The fabric is the top-level container for all tiles, BELs, and routing resources.

Classes

Fabric

Store the configuration of a fabric.

Module Contents

Fabric

class Fabric[source]

Store the configuration of a fabric.

All the information is parsed from the CSV file.

Variables:

  • fabric_dir (Path) – The path to the fabric config file

  • tile (list[list[Tile]]) – The tile map of the fabric

  • name (str) – The name of the fabric

  • numberOfRows (int) – The number of rows of the fabric

  • numberOfColumns (int) – The number of columns of the fabric

  • configBitMode (ConfigBitMode) – The configuration bit mode of the fabric. Currently supports frame based or ff chain

  • frameBitsPerRow (int) – The number of frame bits per row of the fabric

  • maxFramesPerCol (int) – The maximum number of frames per column of the fabric

  • package (str) – The extra package used by the fabric. Only useful for VHDL output.

  • generateDelayInSwitchMatrix (int) – The amount of delay in a switch matrix.

  • multiplexerStyle (MultiplexerStyle) – The style of the multiplexer used in the fabric. Currently supports custom or generic

  • frameSelectWidth (int) – The width of the frame select signal.

  • rowSelectWidth (int) – The width of the row select signal.

  • desync_flag (int) – The flag indicating desynchronization status, used to manage timing issues within the fabric.

  • numberOfBRAMs (int) – The number of BRAMs in the fabric.

  • superTileEnable (bool) – Whether the fabric has super tile.

  • disableUserCLK (bool) – Whether to disable UserCLK generation in the fabric.

  • tileDic (dict[str, Tile]) – A dictionary of tiles used in the fabric. The key is the name of the tile and the value is the tile.

  • superTileDic (dict[str, SuperTile]) – A dictionary of super tiles used in the fabric. The key is the name of the supertile and the value is the supertile.

  • unusedTileDic (dict[str, Tile]) – A dictionary of tiles that are not used in the fabric, but defined in the fabric.csv. The key is the name of the tile and the value is the tile.

  • unusedSuperTileDic (dict[str, SuperTile]) – A dictionary of super tiles that are not used in the fabric, but defined in the fabric.csv. The key is the name of the tile and the value is the tile.

  • commonWirePair (list[tuple[str, str]]) – A list of common wire pairs in the fabric.

Methods

determine_border_side(x, y) → Side | None[source]

Determine which border side a tile position is on, if any.

Parameters:

  • x (int) – X coordinate in the fabric grid

  • y (int) – Y coordinate in the fabric grid

Returns:

The border side (NORTH, SOUTH, EAST, or WEST) if the position is on a border, None otherwise. If on a corner, returns the vertical side (NORTH or SOUTH) as priority.

find_tile_positions(tile) → list[tuple[int, int]] | None[source]

Find all positions where a tile or supertile appears in the fabric grid.

Parameters:

tile (Tile | SuperTile) – The tile or supertile to search for

Returns:

List of (x, y) positions where the tile/supertile appears, or None if not found

getAllUniqueBels() → list[Bel][source]

Get all unique BELs from all tiles in the fabric.

Returns:

A list of all unique BELs across all tiles.

getBelsByTileXY(x, y) → list[Bel][source]

Get all the Bels of a tile.

Parameters:

  • x (int) – The x coordinate of / column the tile.

  • y (int) – The y coordinate / row of the tile.

Returns:

A list of Bels in the tile.

Raises:

ValueError – Tile coordinates are out of range.

getSuperTileByName(name) → SuperTile[source]

Get a supertile by its name from the fabric.

Searches for the supertile first in the used supertiles dictionary, then in the unused supertiles dictionary if not found.

Parameters:

name (str) – The name of the supertile to retrieve.

Returns:

The super tile object if found.

Raises:

KeyError – If the super tile name is not found in either used or unused super tiles.

getTileByName(name) → Tile | SuperTile[source]

Get a tile by its name from the fabric.

Search for the tile first in the used tiles dictionary, then in the unused tiles dictionary then in the supertiles if not found.

Parameters:

name (str) – The name of the tile to retrieve.

Returns:

The tile or supertile object if found.

Raises:

KeyError – If the tile name is not found in either used or unused tiles.

get_all_unique_tiles() → list[Tile | SuperTile][source]

Get list of unique tile types used in the fabric.

Returns:

List of unique tile types (one instance per type name)

get_tile_row_column_indices(tile_name) → tuple[set[int], set[int]][source]

Get all row and column indices where a tile type appears.

Parameters:

tile_name (str) – Name of the tile type to search for

Returns:

(row_indices, column_indices) where the tile type appears