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:
VP1002LPDDR4The 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:
- class JS4Memory[source]#
Bases:
CircuitThe 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:
CircuitThe 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.