package_delays module#

Synthetic package delays for the VP1002’s LPDDR4 pins: estimates, not AMD data.

AMD publishes a Versal device’s per-pin package delays through Vivado’s I/O ports CSV export (File > Export > Export I/O Ports). UG899 v2022.2, Appendix A, describes its columns: “I/O Bank” and “Pin Number” for every pin in the device, “Site” and “Site Type”, and “Min/Max Trace Delay (ps)”, the delay from the die’s pad site to the package ball. UG863 v1.12, “Required Memory Routing Guidelines for All Interfaces”, says to include package delay in routing constraints and to use the midpoint where a minimum and a maximum are given.

The VP1002’s own values were not available for this kit, so SYNTHETIC_CSV holds estimates in the shape of that export, for the XPIO pins of triplet M0 (banks 700, 701 and 702). Each estimate is a stated formula on the ball’s real position (estimate()); none is a measured or AMD-published value. The two legs of an XPIO P/N pair (pins 2k and 2k + 1 of a nibble) take the mean of their two estimates, on the assumption that a package matches a pair’s legs; how closely AMD matches them is not known here. The file has the export’s bank, pin and delay columns only, with the two delay columns named Min Trace Delay (ps) and Max Trace Delay (ps); check those names against your own export, and replace the file with it before relying on any delay that includes it.

The file is generated. To regenerate it, or to check it against the formula:

python -m jitxexamples.jumpstart_kits.vp1002_lpddr4.package_delays [--check]
SYNTHETIC_CSV = PosixPath('/home/runner/work/jitx-doc/jitx-doc/lib/jitxexamples/jumpstart_kits/vp1002_lpddr4/package_delays_synthetic.csv')#

one row per XPIO pin of triplet M0.

Type:

The generated file

PITCH_MM = 0.92#

NFVI1369 ball pitch, from the package’s mechanical drawing (JS1’s landpattern).

CENTER = 18#

Grid index of the middle row and column of the 37 by 37 ball array.

ASSUMED_DK = 3.3#

Assumed relative permittivity of the package substrate’s build-up dielectric.

ROUTING_FACTOR = 1.4#

Assumed ratio of a package trace’s routed length to the straight-line distance.

VERTICAL_PS = 8.0#

Assumed delay through the package’s vertical interconnect, bump to ball, in ps.

SPREAD = 0.03#

Assumed fractional spread of the minimum and maximum about the estimate.

C_MM_PER_PS = 0.299792458#

Speed of light in mm per ps.

COLUMNS = ('I/O Bank', 'Pin Number', 'Min Trace Delay (ps)', 'Max Trace Delay (ps)')#

The columns, named after UG899 Appendix A. A real export carries more columns and a row for every pin; read it by column name.

estimate(row, col)[source]#

Synthetic minimum and maximum package delay in ps for the ball at a zero-indexed grid position: a trace from the package centre, which this estimate takes as the die’s position, plus the vertical path.

Return type:

tuple[float, float]

Parameters:
triplet_balls(fpga)[source]#

Bank, ball and grid position of each XPIO pin of triplet M0, in pin order. Call where JITX instantiation is active (in a circuit or a jitx.test.TestCase).

Return type:

list[tuple[int, str, tuple[int, int]]]

Parameters:

fpga (XCVP1002)

render(balls)[source]#

The CSV text for these pins, given in triplet pin order so that pins 2k and 2k + 1 are a P/N pair.

Return type:

str

Parameters:

balls (Sequence[tuple[int, str, tuple[int, int]]])

generated()[source]#

The CSV text the formula gives for the current component.

Return type:

str

main(argv=None)[source]#
Return type:

int

Parameters:

argv (list[str] | None)