Source code for FABulous.fabric_definition.Tile
"""Store information about a tile."""
from dataclasses import dataclass, field
from pathlib import Path
from typing import TYPE_CHECKING
from FABulous.fabric_definition.Bel import Bel
from FABulous.fabric_definition.define import IO, Direction, PinSortMode, Side
from FABulous.fabric_definition.Gen_IO import Gen_IO
from FABulous.fabric_definition.Port import Port
from FABulous.fabric_definition.Wire import Wire
if TYPE_CHECKING:
from FABulous.fabric_generator.gds_generator.gen_io_pin_config_yaml import (
PinOrderConfig,
)
@dataclass
[docs]
class Tile:
"""Store information about a tile.
Parameters
----------
name : str
The name of the tile
ports : list[Port]
List of ports for the tile
bels : list[Bel]
List of Basic Elements of Logic (BELs) in the tile
tileDir : Path
Directory path for the tile
matrixDir : Path
Directory path for the tile matrix
gen_ios : list[Gen_IO]
List of general I/O components
userCLK : bool
True if the tile uses a clk signal
configBit : int, optional
Number of configuration bits for the switch matrix. Default is 0.
pinOrderConfig : dict[Side, PinOrderConfig] | None, optional
Configuration for pin ordering on each side of the tile. If None, defaults to
BUS_MAJOR sorting on all sides.
Attributes
----------
name : str
The name of the tile
portsInfo : list[Port]
The list of ports of the tile
bels: list[Bel]
The list of BELs of the tile
matrixDir : Path
The directory of the tile matrix
matrixConfigBits : int
The number of config bits the tile switch matrix has
gen_ios : list[Gen_IO]
The list of GEN_IOs of the tile
withUserCLK : bool
Whether the tile has a userCLK port. Default is False.
wireList : list[Wire]
The list of wires of the tile
tileDir : Path
The path to the tile folder
partOfSuperTile : bool, optional
Whether the tile is part of a super tile. Default is False.
pinOrderConfig : dict, optional
Configuration for pin ordering on each side of the tile.
"""
[docs]
withUserCLK: bool = False
[docs]
wireList: list[Wire] = field(default_factory=list)
[docs]
partOfSuperTile: bool = False
[docs]
pinOrderConfig: dict = field(default_factory=dict)
def __init__(
self,
name: str,
ports: list[Port],
bels: list[Bel],
tileDir: Path,
matrixDir: Path,
gen_ios: list[Gen_IO],
userCLK: bool,
configBit: int = 0,
pinOrderConfig: dict[Side, "PinOrderConfig"] | None = None,
) -> None:
self.name = name
self.portsInfo = ports
self.bels = bels
self.gen_ios = gen_ios
self.matrixDir = matrixDir
self.withUserCLK = userCLK
self.matrixConfigBits = configBit
self.wireList = []
self.tileDir = tileDir
if pinOrderConfig is None:
from FABulous.fabric_generator.gds_generator.gen_io_pin_config_yaml import (
PinOrderConfig,
)
self.pinOrderConfig = {
Side.NORTH: PinOrderConfig(sort_mode=PinSortMode.BUS_MAJOR),
Side.EAST: PinOrderConfig(sort_mode=PinSortMode.BUS_MAJOR),
Side.SOUTH: PinOrderConfig(sort_mode=PinSortMode.BUS_MAJOR),
Side.WEST: PinOrderConfig(sort_mode=PinSortMode.BUS_MAJOR),
}
else:
self.pinOrderConfig = pinOrderConfig
def __eq__(self, __o: object, /) -> bool:
"""Check equality between tiles based on their name.
Parameters
----------
__o : object
The object to compare with.
Returns
-------
bool
True if both tiles have the same name, False otherwise.
"""
if __o is None or not isinstance(__o, Tile):
return False
return self.name == __o.name
[docs]
def getWestSidePorts(self) -> list[Port]:
"""Get all ports physically located on the west side of the tile.
Returns
-------
list[Port]
List of ports on the west side, excluding NULL ports.
"""
return [
p for p in self.portsInfo if p.sideOfTile == Side.WEST and p.name != "NULL"
]
[docs]
def getEastSidePorts(self) -> list[Port]:
"""Get all ports physically located on the east side of the tile.
Returns
-------
list[Port]
List of ports on the east side, excluding NULL ports.
"""
return [
p for p in self.portsInfo if p.sideOfTile == Side.EAST and p.name != "NULL"
]
[docs]
def getNorthSidePorts(self) -> list[Port]:
"""Get all ports physically located on the north side of the tile.
Returns
-------
list[Port]
List of ports on the north side, excluding NULL ports.
"""
return [
p for p in self.portsInfo if p.sideOfTile == Side.NORTH and p.name != "NULL"
]
[docs]
def getSouthSidePorts(self) -> list[Port]:
"""Get all ports physically located on the south side of the tile.
Returns
-------
list[Port]
List of ports on the south side, excluding NULL ports.
"""
return [
p for p in self.portsInfo if p.sideOfTile == Side.SOUTH and p.name != "NULL"
]
[docs]
def getNorthPorts(self, io: IO) -> list[Port]:
"""Get all ports with north wire direction filtered by I/O type.
Parameters
----------
io : IO
The I/O direction to filter by (INPUT or OUTPUT).
Returns
-------
list[Port]
List of north-direction ports with specified I/O type, excluding NULL ports.
"""
return [
p
for p in self.portsInfo
if p.wireDirection == Direction.NORTH and p.name != "NULL" and p.inOut == io
]
[docs]
def getSouthPorts(self, io: IO) -> list[Port]:
"""Get all ports with south wire direction filtered by I/O type.
Parameters
----------
io : IO
The I/O direction to filter by (INPUT or OUTPUT).
Returns
-------
list[Port]
List of south-direction ports with specified I/O type, excluding NULL ports.
"""
return [
p
for p in self.portsInfo
if p.wireDirection == Direction.SOUTH and p.name != "NULL" and p.inOut == io
]
[docs]
def getEastPorts(self, io: IO) -> list[Port]:
"""Get all ports with east wire direction filtered by I/O type.
Parameters
----------
io : IO
The I/O direction to filter by (INPUT or OUTPUT).
Returns
-------
list[Port]
List of east-direction ports with specified I/O type, excluding NULL ports.
"""
return [
p
for p in self.portsInfo
if p.wireDirection == Direction.EAST and p.name != "NULL" and p.inOut == io
]
[docs]
def getWestPorts(self, io: IO) -> list[Port]:
"""Get all ports with west wire direction filtered by I/O type.
Parameters
----------
io : IO
The I/O direction to filter by (INPUT or OUTPUT).
Returns
-------
list[Port]
List of west-direction ports with specified I/O type, excluding NULL ports.
"""
return [
p
for p in self.portsInfo
if p.wireDirection == Direction.WEST and p.name != "NULL" and p.inOut == io
]
[docs]
def getTileOutputNames(self) -> list[str]:
"""Get all output port source names for the tile.
Returns
-------
list[str]
List of source names for output ports, excluding NULL and
JUMP direction ports.
"""
return [
p.sourceName
for p in self.portsInfo
if p.sourceName != "NULL"
and p.wireDirection != Direction.JUMP
and p.inOut == IO.OUTPUT
]
@property
[docs]
def globalConfigBits(self) -> int:
"""Get the total number of global configuration bits.
Calculates the sum of switch matrix configuration bits
and all BEL configuration bits.
Returns
-------
int
Total number of global configuration bits for the tile.
"""
ret = self.matrixConfigBits
for b in self.bels:
ret += b.configBit
return ret