com.xilinx.rapidwright.design.xdc

Class XDCParser

Object

com.xilinx.rapidwright.design.xdc.XDCParser

public class XDCParser
extends Object

Parses an XDC file for a limited subset of constraint types. It uses a full Tcl interpreter, so complex language constructs are possible.

If the Parser encounters unsupported commands or command options, the parsed TCL code is converted back to strings and returned as UnsupportedConstraintElements.

The parser can match cell references in constraints to modified designs. Users can supply their own EdifCellLookup to specify how to rewrite constraints.

For a regular, non-rewritten netlist, users should use RegularEdifCellLookup.

If no netlist is present, a null lookup will leave more complex get_cells calls unevaluated as unsupported constraints.

Created on: Jul 27, 2015

Constructor Summary

Constructors

Constructor and Description
XDCParser()

Method Summary

Modifier and Type	Method and Description
static <T> tcl.lang.Interp	makeTclInterp(XDCConstraints constraints, Device dev, EdifCellLookup<T> cellLookup) Create a tcl interpreter with XDC parsing commands Cell references are intentionally never disposed (see TclHashIdentifiedObject), so lifetime of this interpreter should be limited.
static XDCConstraints	parseXDC(Device dev, List<String> lines, EdifCellLookup<?> cellLookup) Parse XDC
static XDCConstraints	parseXDC(String fileName, Design design)
static XDCConstraints	parseXDC(String fileName, Device dev)
static XDCConstraints	parseXDC(String fileName, Device dev, EdifCellLookup<?> cellLookup)
static XDCConstraints	parseXDC(String fileName, Device dev, EDIFNetlist netlist)
static void	writeXDC(List<String> constraints, OutputStream out)

Methods inherited from class Object

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

Constructor Detail

XDCParser

public XDCParser()

Method Detail

makeTclInterp

public static <T> tcl.lang.Interp makeTclInterp(XDCConstraints constraints,
                                                Device dev,
                                                EdifCellLookup<T> cellLookup)

Create a tcl interpreter with XDC parsing commands Cell references are intentionally never disposed (see TclHashIdentifiedObject), so lifetime of this interpreter should be limited.

Type Parameters:

T - lookup's cell representation

Parameters:

constraints - Constraints object to output to

dev - Device

cellLookup - the cell lookup (see class level documentation for parameter details)

Returns:

interpreter

parseXDC

public static XDCConstraints parseXDC(Device dev,
                                      List<String> lines,
                                      EdifCellLookup<?> cellLookup)

Parse XDC

Parameters:

dev - the device

lines - XDC content

cellLookup - the cell lookup (see class level documentation for parameter details)

Returns:

parsed constraints

parseXDC

public static XDCConstraints parseXDC(String fileName,
                                      Device dev,
                                      EdifCellLookup<?> cellLookup)

Parameters:

fileName - Name of the XDC file to parse

dev - the design

cellLookup - the cell lookup (see class level documentation for parameter details)

Returns:

A map of port names to package pin information.

parseXDC

public static XDCConstraints parseXDC(String fileName,
                                      Device dev,
                                      EDIFNetlist netlist)

Parameters:

fileName - Name of the XDC file to parse

dev - the design

netlist - optional netlist to enable more advanced get_cells calls

Returns:

A map of port names to package pin information.

parseXDC

public static XDCConstraints parseXDC(String fileName,
                                      Design design)

Parameters:

fileName - Name of the XDC file to parse

design - The design

Returns:

A map of port names to package pin information.

parseXDC

public static XDCConstraints parseXDC(String fileName,
                                      Device dev)

Parameters:

fileName - Name of the XDC file to parse

dev - the device

Returns:

A map of port names to package pin information.

writeXDC

public static void writeXDC(List<String> constraints,
                            OutputStream out)