sm_geometry

Switch matrix geometry definitions.

Classes

SmGeometry

A data structure representing the geometry of a Switch Matrix.

Module Contents

SmGeometry

class SmGeometry

A data structure representing the geometry of a Switch Matrix.

Sets all attributes to default values: None for names and paths, zero for dimensions and coordinates, and empty lists for ports and port geometries.

Variables:

• name (str) – Name of the switch matrix

• src (Path) – File path of the switch matrix HDL source file

• csv (Path) – File path of the switch matrix CSV file

• width (int) – Width of the switch matrix

• height (int) – Height of the switch matrix

• relX (int) – X coordinate of the switch matrix, relative within the tile

• relY (int) – Y coordinate of the switch matrix, relative within the tile

• northPorts (list[Port]) – List of the ports of the switch matrix in north direction

• southPorts (list[Port]) – List of the ports of the switch matrix in south direction

• eastPorts (list[Port]) – List of the ports of the switch matrix in east direction

• westPorts (list[Port]) – List of the ports of the switch matrix in west direction

• jumpPorts (list[Port]) – List of the jump ports of the switch matrix

• portGeoms (list[PortGeometry]) – List of geometries of the ports of the switch matrix

• northWiresReservedWidth (int) – Reserved width for wires going north

• southWiresReservedWidth (int) – Reserved width for wires going south

• eastWiresReservedHeight (int) – Reserved height for wires going east

• westWiresReservedHeight (int) – Reserved height for wires going west

• southPortsTopY (int) – Top most y coord of any south port, reference for stair-wires

• westPortsRightX (int) – Right most x coord of any west port, reference for stair-wires

Methods

generateBelPorts(belGeomList) → None

Generate port geometries for BEL connections to the switch matrix.

Creates PortGeometry objects for connecting BEL internal ports to the switch matrix. These ports facilitate routing between BELs and the switch matrix interconnect network.

Parameters:

belGeomList (list[BelGeometry]) – List of BEL geometries to connect to the switch matrix

generateGeometry(tile, tileBorder, belGeoms, padding) → None

Generate the geometry for a switch matrix.

Creates the geometric representation of a switch matrix including its dimensions, port arrangements, and spatial relationships. Calculates the required space for routing wires and positions the switch matrix within the tile. the required space for routing wires and positions for the switch matrix

Parameters:

• tile (Tile) – The tile object containing the switch matrix definition

• tileBorder (Border) – The border type of the tile within the fabric

• belGeoms (list[BelGeometry]) – List of BEL geometries within the same tile

• padding (int) – The padding space to add around the switch matrix

generatePortsGeometry(padding) → None

Generate the geometry for all ports of the switch matrix.

Creates PortGeometry objects for all jump, north, south, east, and west ports of the switch matrix. Positions each port according to its type and assigns appropriate coordinates and grouping information.

Parameters:

padding (int) – The padding space to add around ports

preprocessPorts(tileBorder) → None

Order the ports for downstream drawing.

Ensure that ports are ordered correctly, merge connected jump ports and augment ports for term tiles. This step augments ports in border tiles. This is needed, as these are not contained in the (north…west)SidePorts in FABulous.

saveToCSV(writer) → None

Save switch matrix geometry data to CSV format.

Writes the switch matrix geometry information including name, source and CSV file paths, position, dimensions, and all port geometries to a CSV file using the provided writer.

Parameters:

writer (object) – The CSV writer object to use for output