base module#

JS4 base design: the VP1002 connected to a Micron LPDDR4 memory, ready for layout.

The VP1002 offers its LPDDR4 pins with every swap AMD’s rules allow (jitxexamples.jumpstart_kits.vp1002_lpddr4); the design requires one interface and nets it to a Micron MT53E1G32D2FW with plain nets. JITX picks the pin assignment when the board is routed.

Board and substrate are the 18-layer reference stackup, jitxexamples.substrates.reference_18layer, transcribed from a production FPGA evaluation board’s fabrication drawing, on an 80 x 80 mm board.

The design also carries the supplies, straps, calibration resistors and decoupling of jitxexamples.jumpstart_kits.vp1002_lpddr4.power and jitxexamples.jumpstart_kits.vp1002_lpddr4.decoupling: each rail a named net, the ZQ and IO_VR calibration resistors, each transceiver calibration supply tied to its AVTT rail through its RREF resistor, and a decoupling set on every supply rail of the memory (sized to TI’s LPDDR4 layout guideline) and of the FPGA (a reference board’s, trimmed), each capacitor tied to a ball of its rail, by a ShortTrace below 10 uF and a plain net for bulk (decoupling), and its return pad on the ground the routing structures reference.

The interface runs as LPDDR4, so the VCCO of XPIO banks 700 to 702 and the memory’s VDD2 and VDDQ are one 1.1 V net (UG863 Table 23; jitxexamples.jumpstart_kits.vp1002_lpddr4.power): JS4BaseCircuit joins the three VCCO rails to the memory’s LP4_1V1. The memory’s VDD1, 1.8 V, is its own net. Bank 700 carries no memory signal; its VCCO is on the 1.1 V net too, a design choice: the bank must stay powered (it holds the DCI reference for every XPIO bank, UG863 “IO_VR_700, IO_VR_800 Pin Differences”), 1.1 V is inside its VCCO range (DS959 Table 1), and a rail of its own would need a supply that nothing else on the board needs.

Each resistor and capacitor sits in the circuit of the part it serves, JS4Fpga or JS4Memory. Only the FPGA is placed: the memory, the resistors and the capacitors are left for placement in the layout. The design applies no constraints and no design rules; part3_si_constraints adds the SI constraints.

JS4BaseCircuit builds the FPGA’s circuit and the memory’s through new_fpga and new_memory, so a layout can subclass them and put each part’s vias and routes in the part’s own circuit, where they move when that circuit moves.

The capacitors and the resistors are queries on the example parts catalogue, so a project that builds the design needs a parts chain that lists it, set up as the “Parts configuration” section of the repository README says (JITx-Inc/jitx-examples). In short, copy the CSV out of the installed package, into a parts/ directory that exists:

import importlib.resources
import shutil

shutil.copy(
    importlib.resources.files("jitxexamples") / "parts" / "example-passives.csv",
    "parts/approved-parts.csv",
)

and chain it without ideal, in pyproject.toml, so a query the catalogue cannot meet fails instead of resolving to a part that ignores its filters:

[tool.jitx.parts]
chain = ["csv:parts/approved-parts.csv"]

The copy is an example, not an approved list.

Not modeled yet: the system clock source, the regulators and their remote sense on VCCINT_SENSE and GND_SENSE, CKE termination, the RESET_n pull-down, the system monitor’s two ferrite beads (jitxexamples.jumpstart_kits.vp1002_lpddr4.power), and decoupling counts for this device: AMD’s Power Design Manager gives them from a design’s resource use, so the FPGA sets here are a reference board’s, trimmed (jitxexamples.jumpstart_kits.vp1002_lpddr4.decoupling).

class JS4Fpga[source]#

Bases: VP1002LPDDR4

The VP1002, placed, with its straps, its calibration resistors and the decoupling of every supply rail, so each of those parts sits in the FPGA’s circuit.

decoupling_layouts()[source]#

How a layout treats some capacitors of the FPGA’s sets, by rail name (RailLayout), read before any capacitor is created. Here none: every capacitor of every set, each one below 10 uF tied to its ball by a ShortTrace. A layout’s subclass overrides this to leave capacitors out or tie them by a plain net.

Return type:

Mapping[str, RailLayout]

ground_capacitors()[source]#

Every capacitor that returns to the main ground: the XPIO banks’ and every other rail’s but VCCAUX_SMON’s.

Return type:

list[Capacitor]

class JS4Memory[source]#

Bases: Circuit

The Micron memory with its rails’ straps, its ZQ resistors and its decoupling, so each of those parts sits in the memory’s circuit. Nothing is placed.

class JS4BaseCircuit[source]#

Bases: Circuit

The FPGA and the memory, each in its own circuit with its straps, calibration resistors and decoupling, and the nets between them. Only the FPGA is placed; no constraints, no design rules.

new_fpga()[source]#

The FPGA’s circuit.

Return type:

JS4Fpga

new_memory()[source]#

The memory’s circuit.

Return type:

JS4Memory

lpddr4_bus()[source]#

The LPDDR4 interface required from the FPGA, read back from lpddr4, the net that holds it.

Return type:

VersalLPDDR4

class JS4BaseDesign(*args, **kwargs)[source]#

Bases: Design

The base design: connected, no routes, only the FPGA placed.

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