com.xilinx.rapidwright.eco

Class ECOPlacementHelper

Object

com.xilinx.rapidwright.eco.ECOPlacementHelper

public class ECOPlacementHelper
extends Object

Class for aiding with ECO placement activities. e.g. given a SLICE site, methods are provided to spiral out to find other SLICEs and allowing them to be queried for unused LUT/FF BELs.

Field Summary

Fields

Modifier and Type	Field and Description
static Set<String>	ultraScaleFlopNames

Constructor Summary

Constructors

Constructor and Description
ECOPlacementHelper(Design design, Map<Net,Set<SitePinInst>> deferredRemovals) Constructor for ECOPlacementHelper class.

Method Summary

Modifier and Type	Method and Description
BEL	getUnusedFlop(SiteInst siteInst, Net clk) Given a SiteInst and a clock net, find an unused flop BEL that can host a new cell.
BEL	getUnusedFlop(SiteInst siteInst, Net clk, Net ce, Net rst) Given a SiteInst and a clock net, find an unused flop BEL that can host a new cell.
BEL	getUnusedLUT(SiteInst siteInst) Given a SiteInst, find an unused LUT BEL that can host a new LUT6 cell.
static Iterable<Site>	spiralOutFrom(Site site) Given a home Site, return an Iterable that yields the neighbouring sites encountered when walking outwards in a spiral fashion.
static Iterable<Site>	spiralOutFrom(Site site, PBlock pblock) Given a home Site, return an Iterable that yields the neighbouring sites encountered when walking outwards in a spiral fashion.

Methods inherited from class Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

ultraScaleFlopNames

public static final Set<String> ultraScaleFlopNames

Constructor Detail

ECOPlacementHelper

public ECOPlacementHelper(Design design,
                          Map<Net,Set<SitePinInst>> deferredRemovals)

Constructor for ECOPlacementHelper class.

Parameters:

design - Design to be analyzed.

deferredRemovals - An optional map populated with the site pins marked for removal. Sites with pins queued for removal will be treated as if the pin was already removed for the purposes of finding unused flops.

Method Detail

getUnusedFlop

public BEL getUnusedFlop(SiteInst siteInst,
                         Net clk)

Given a SiteInst and a clock net, find an unused flop BEL that can host a new cell. This flop BEL will have its bypass pin ([A-H](X|_I)) available. Assumes that CE and SR of flop to be placed is going to be held at VCC and GND respectively.

Parameters:

siteInst - SiteInst object to search inside.

clk - Desired clock net for flop cell.

Returns:

Unused flop BEL.

getUnusedFlop

public BEL getUnusedFlop(SiteInst siteInst,
                         Net clk,
                         Net ce,
                         Net rst)

Given a SiteInst and a clock net, find an unused flop BEL that can host a new cell. This flop BEL will have its bypass pin ([A-H](X|_I)) available.

Parameters:

siteInst - SiteInst object to search inside.

clk - Desired clock net for flop cell.

ce - Desired clock enable net for flop cell (null for VCC).

rst - Desired reset net for flop cell (null for GND).

Returns:

Unused flop BEL.

getUnusedLUT

public BEL getUnusedLUT(SiteInst siteInst)

Given a SiteInst, find an unused LUT BEL that can host a new LUT6 cell.

Parameters:

siteInst - SiteInst object to search inside.

Returns:

Unused LUT6 BEL.

spiralOutFrom

public static Iterable<Site> spiralOutFrom(Site site)

Given a home Site, return an Iterable that yields the neighbouring sites encountered when walking outwards in a spiral fashion. To be used in conjunction with ECOPlacementHelper.getUnusedLUT(SiteInst) and ECOPlacementHelper.getUnusedFlop(SiteInst, Net).

Parameters:

site - Originating Site.

Returns:

Iterable of neighbouring sites.

spiralOutFrom

public static Iterable<Site> spiralOutFrom(Site site,
                                           PBlock pblock)

Given a home Site, return an Iterable that yields the neighbouring sites encountered when walking outwards in a spiral fashion. To be used in conjunction with ECOPlacementHelper.getUnusedLUT(SiteInst) and ECOPlacementHelper.getUnusedFlop(SiteInst, Net).

Parameters:

site - Originating Site.

pblock - Also check to ensure the proposed sites are inside the provided pblock.

Returns:

Iterable of neighbouring sites.