part3_si_constraints module#

JS4 Part 3: SI constraints on the VP1002 to Micron LPDDR4 link.

JS4SIConstraintsCircuit takes Part 2’s board (part2_power): Part 1’s fanned-out board, its memory placed (part1_fanout_escape), which already applies the ball-field pair structure (ball_field), with Part 2’s decoupling, plane pours and power rules. It applies UG863’s skew limits, four of them tightened to the kit’s layout targets, and its trace length budget (constraint), an insertion loss limit, the package delay pin models, the reference planes and UG863’s spacing (rules).

Each FPGA pin of memory triplet M0, which holds every pin the offer uses, carries its package delay as a TerminatingPinModel, read from the synthetic estimates the part package supplies (models); a real design reads its Vivado export instead. JITX picks the pin assignment when the board is routed, so before routing each constrained path reports its pin unassigned, or for CKE no path.

CAC and data take the substrate’s 46 ohm single-ended structure and CK and DQS its 85 ohm differential structure: the structures inside UG863’s 45 ohm and 82 ohm +/-10% windows (constraint). Inside a ball field a pair’s route segment takes a narrower structure by a tag on its Route; a single-ended line keeps its own. UG863’s spacing holds the byte lanes and channels apart.

The loss limit is LOSS_LIMIT_DB on every LPDDR4 signal, standing in for an SI team’s budget, not a UG863 value (constraint, “Not applied”). The substrate’s loss model is dielectric loss at 10 GHz only, about 0.0068 dB/mm on the 46 ohm stripline, so a 75 mm path reads about 0.5 dB.

To see the report, save this as a script in the project root and run it with the project’s runtime running:

import jitx

from jitxexamples.jumpstart_kits.js4_fpga_lpddr4.part3_si_constraints import (
    JS4SIConstraintsDesign,
)


def main() -> None:
    with jitx.runtime as rt:
        report = rt.submit(JS4SIConstraintsDesign).issues(satisfied=True, wait=30)
        if not report.complete:
            print("report incomplete: raise wait and run again")
        for group in report.groups():
            print("met" if group.satisfied else "NOT MET", group.text)
            if len(group.issues) > 1:
                for issue in group:
                    print("   ", issue.text)


if __name__ == "__main__":
    main()

main() sits behind the __name__ guard because JITX design discovery imports every .py file under the project root. The design needs the parts chain base describes.

LOSS_LIMIT_DB = 1.0#

Insertion loss limit, dB, on every LPDDR4 signal, standing in for an SI team’s budget. Not a UG863 value.

class JS4SIConstraintsCircuit(params=LPDDR4ConstraintParams(skew_ck=Toleranced(0, 4e-13, 4e-13), skew_ck_cke=Toleranced(0, 4e-12, 4e-12), skew_ck_cs=Toleranced(0, 4e-12, 4e-12), skew_ck_ca=Toleranced(0, 1e-10, 1e-10), skew_ck_dqs=Toleranced(0, 1.5e-10, 1.5e-10), skew_dqs=Toleranced(0, 4e-13, 4e-13), skew_dqs_dq=Toleranced(0, 2e-11, 2e-11), spread_dq=None, loss=None), loss=1.0)[source]#

Bases: JS4PowerCircuit

JS4PowerCircuit with the SI constraints, the pin models and the spacing rules of Part 3.

Parameters:
class JS4SIConstraintsDesign(*args, **kwargs)[source]#

Bases: Design

Part 3’s reference: Part 2’s design with the SI constraints, before any route but Part 1’s escapes.

board: Board = Reference18Board()#
substrate: Substrate = Reference18Substrate()#
circuit: Circuit = JS4SIConstraintsCircuit()#