decoupling module#

Decoupling for a Micron MT53E1G32D2FW’s three supplies and every supply rail of the VP1002, netted and tied to their balls, for placement in the layout. Run as LPDDR4, the memory’s VDD2 and VDDQ share one 1.1 V net with the VCCO of XPIO banks 700 to 702 (power); each set still ties to the balls of the supply it was sized for.

Neither vendor gives a count to cite. Micron’s data sheet Rev. I gives no decoupling guidance for VDD1, VDD2 or VDDQ. AMD UG863 v1.12, “Recommended Decoupling Capacitor Quantities for Versal Devices”, says the quantities “can be obtained via the PDM tool” (AMD Power Design Manager) from the design’s own resource use, and DS959 v1.8 Table 1 defers to the same tool. The memory’s set is therefore sized to TI’s LPDDR4 layout guideline, SPRAD66B, and each FPGA set is trimmed from a published reference board’s set for the same rail of another Versal device.

Every capacitor is netted and tied to one ball of its rail, picked by the ball’s name: each rail’s set is spread over that rail’s balls in (row, column) order, and each XPIO bank’s set over its own bank’s VCCO balls (ball_grid()). A capacitor below 10 uF (BULK_CAPACITANCE) is tied by a ShortTrace, for placement at its ball; a bulk capacitor, 10 uF and up, by a plain net, since it sits outside the ball field on its own via to the plane and no route runs back to a ball. Nothing here places a capacitor: placing them, under or beside each package, is a layout step, and SPRAD66B’s distance and via rules (Sources) apply there.

A layout can say, before any capacitor is created, how it treats some of an FPGA rail’s set (RailLayout, by rail name, fpga_sets()): a capacitor below 10 uF it places away from its ball, tied by a plain net, and a capacitor it leaves out of the design. The balls are spread over the whole set either way, so each capacitor kept ties to the same ball, and each keeps its place in the set as its key in the FPGA sets’ caps, so caps[2] is the set’s third capacitor whatever is left out.

Sources#

  • TI SK-AM62A-LP starter kit, https://www.ti.com/tool/SK-AM62A-LP, design files SPRCAM0: schematic PROC135A1 rev A1 (2025-07-24), sheet 16 of 44 “SOC LPDDR4 INTERFACE”, block “LPDDR4 POWER DECAPS”; its BOM PROC135A1_BOM_With_Design_Updates..Notes_V1.0.xlsx; and its assembly drawings. U26 there is an MT53E1G32D2FW-046 AUT:B, the same Micron part number as this design’s memory in another temperature grade, in the same 200-ball package. Its 10 uF and 0.1 uF memory capacitors are the parts this design’s memory set queries for. The board’s 48 memory capacitors are not copied: the set here is smaller (Approximations).

  • TI SPRAD66B, AM62Ax, AM62Px, AM62Dx LPDDR4 Board Design and Layout Guidelines, February 2023, revised December 2024, https://www.ti.com/lit/pdf/sprad66: Table 1-3 “High-Speed Bypass Capacitors”, per DDR device at least 12 capacitors and at least 0.85 uF in total, 0201 typical and 0402 at most, at most 150 mil from the device.

  • Trenz Electronic TE0950 schematic SCH-TE0950-03-MAKE21C, rev 03, 2023-12-19, https://shop.trenz-electronic.de/trenzdownloads/Trenz_Electronic/Development_Boards/TE0950/REV03/Documents/SCH-TE0950-03-MAKE21C.PDF, an XCVM1102 board: page 7 “PMC/MIO” (VCCO_500 to VCCO_503), pages 8 to 10 (V_XPIO_700 to V_XPIO_702), page 12 “V_GTY” (GTYP_AVCC, GTYP_AVCC_AUX, GTYP_AVTT) and page 13 “V_Power” (VCCINT, VCC_SOC, VCC_IO, VCC_RAM, VCCAUX, VCCAUX_PMC, VCCAUX_SMON, VCC_PMC, VCC_PSLP, VCC_PSFP). The schematic gives value, voltage and dielectric, no case.

  • AMD AM006 v1.5, 2025-06-03, https://docs.amd.com/r/en-US/am006-versal-sysmon, Figure 1 “SYSMON Pinout Requirements”: 470 nF and 100 nF on VCCAUX_SMON, the pair TE0950 page 13 also uses (C108, C109).

  • Rated voltage: Eric Bogatin, “Seven Habits of Successful 2-Layer Board Designers”, Signal Integrity Journal, 2019-04-23, https://www.signalintegrityjournal.com/blogs/12-fundamentals/post/1207-seven-habits-of-successful-2-layer-board-designers, habit 5: “a voltage rating at least 2x the intended rail application”. Applied here to each rail’s maximum (power), the stricter reading.

Approximations#

  • The memory set is a choice sized to SPRAD66B Table 1-3, at least 12 bypass capacitors and 0.85 uF per DDR device: twelve 0.1 uF (1.2 uF), split across the rails by supply ball count (20 VDDQ, 24 VDD2 and 8 VDD1 balls give five, five and two), and one 10 uF bulk capacitor per rail. SK-AM62A-LP places 48, with 1000 pF and 0.01 uF parts as well; a set that size takes about a hundred vias under the package (SPRAD66B asks two per capacitor), in the field the byte lanes escape through.

  • The FPGA sets are trimmed from TE0950’s, for an XCVM1102, a smaller device than the VP1002 with fewer balls on most rails. The trim is this design’s choice, one rule applied to each rail’s TE0950 set. Drop every part of 100 uF and up: such parts serve a regulator’s control loop and belong at its output, and this design models no regulators yet (each rail is a net a regulator can join, power). Of the parts of 10 uF and up that are left, keep one, the largest, as the rail’s bulk. Halve the count of each smaller value, rounding up, so every value below 10 uF that TE0950 uses on the rail stays, in fewer parts competing for the room near the balls. Two kinds of set are kept whole: VCCAUX_SMON’s 470 nF and 100 nF, the pair AM006 Figure 1 asks for, and each XPIO bank’s one 47 uF and two 4.7 uF, since the bank’s VCCO carries the memory interface’s I/O switching. TE0950 has no GTM transceivers and no VCCINT_GT: each GTM rail (L and RN sides alike) takes the trimmed set of the GTYP rail of the same function, and VCCINT_GT_L and VCCINT_GT_R, the GTM primary supply in DS959 Table 1, take the trimmed GTYP_AVCC set, the transceiver primary supply nearest it in function. The VP1002’s GTY_*_RS rails take the trimmed GTYP sets too. VCC_IO and VCC_SOC share a net (DS959 note 8) and carry both their trimmed TE0950 sets; VCCAUX_SMON and VCCAUX_PMC share one too (note 4) and carry the trimmed VCCAUX_PMC set and the SMON pair.

  • Parts: each kind is queried by value, case, dielectric and rated voltage, so any catalogue part that meets them serves. Where the source gives no case, the case is the smallest the example catalogue carries for the value and the rating twice the rail maximum needs.

BULK_CAPACITANCE = 1e-05#

tied to its ball by a plain net, not a ShortTrace (module docstring).

Type:

Farads. A capacitor of this value or more is bulk

RATED_VOLTAGE_FACTOR = 2.0#

Rated DC voltage at least this times the rail maximum (Bogatin 2019, habit 5).

class CapacitorKind(capacitance, case, dielectric)[source]#

Bases: object

One value of a reference board’s decoupling set.

Parameters:
capacitance: float#

Farads.

case: str#
dielectric: str#

Temperature coefficient code.

C_10U = CapacitorKind(capacitance=1e-05, case='0402', dielectric='X5R')#

Murata GRM155R61A106ME11D (10 V, 20%, X5R, 0402).

Type:

10 uF 0402 X5R. SK-AM62A-LP BOM

C_100N = CapacitorKind(capacitance=1e-07, case='0201', dielectric='X5R')#

Murata GRM033R61C104KE14D (16 V, 10%, X5R, 0201); TE0950 C109: 100 nF, 6.3 V, X5R. The query asks for twice the rail maximum, not the board’s rating.

Type:

0.1 uF 0201 X5R. SK-AM62A-LP BOM

C_470N = CapacitorKind(capacitance=4.7e-07, case='0402', dielectric='X5R')#

470 nF, 6.3 V, X5R.

Type:

470 nF X5R. TE0950

C_4U7 = CapacitorKind(capacitance=4.7e-06, case='0402', dielectric='X5R')#

4.7 uF, 6.3 V, X5R.

Type:

4.7 uF X5R. TE0950

C_22U = CapacitorKind(capacitance=2.2e-05, case='0603', dielectric='X5R')#

22 uF, 25 V, X5R.

Type:

22 uF X5R. TE0950

C_47U = CapacitorKind(capacitance=4.7e-05, case='0805', dielectric='X5R')#

47 uF, 6.3 V, X5R.

Type:

47 uF X5R. TE0950

MEMORY_VDDQ_SET = (CapacitorKind(capacitance=1e-05, case='0402', dielectric='X5R'), CapacitorKind(capacitance=1e-07, case='0201', dielectric='X5R'), CapacitorKind(capacitance=1e-07, case='0201', dielectric='X5R'), CapacitorKind(capacitance=1e-07, case='0201', dielectric='X5R'), CapacitorKind(capacitance=1e-07, case='0201', dielectric='X5R'), CapacitorKind(capacitance=1e-07, case='0201', dielectric='X5R'))#

one 10 uF bulk and five of the memory’s twelve 0.1 uF (Approximations).

Type:

VDDQ, 20 balls

MEMORY_VDD2_SET = (CapacitorKind(capacitance=1e-05, case='0402', dielectric='X5R'), CapacitorKind(capacitance=1e-07, case='0201', dielectric='X5R'), CapacitorKind(capacitance=1e-07, case='0201', dielectric='X5R'), CapacitorKind(capacitance=1e-07, case='0201', dielectric='X5R'), CapacitorKind(capacitance=1e-07, case='0201', dielectric='X5R'), CapacitorKind(capacitance=1e-07, case='0201', dielectric='X5R'))#

one 10 uF bulk and five of the twelve 0.1 uF.

Type:

VDD2, 24 balls

MEMORY_VDD1_SET = (CapacitorKind(capacitance=1e-05, case='0402', dielectric='X5R'), CapacitorKind(capacitance=1e-07, case='0201', dielectric='X5R'), CapacitorKind(capacitance=1e-07, case='0201', dielectric='X5R'))#

one 10 uF bulk and two of the twelve 0.1 uF.

Type:

VDD1, 8 balls

XPIO_BANK_SET = (CapacitorKind(capacitance=4.7e-06, case='0402', dielectric='X5R'), CapacitorKind(capacitance=4.7e-06, case='0402', dielectric='X5R'), CapacitorKind(capacitance=4.7e-05, case='0805', dielectric='X5R'))#

C20, C21 (4.7 uF) and C19 (47 uF); page 9, bank 701: C23, C24 and C22; page 10, bank 702: C29, C30 and C28.

Type:

TE0950 page 8, bank 700

VCCINT_SET = (CapacitorKind(capacitance=4.7e-05, case='0805', dielectric='X5R'), CapacitorKind(capacitance=4.7e-06, case='0402', dielectric='X5R'), CapacitorKind(capacitance=4.7e-06, case='0402', dielectric='X5R'), CapacitorKind(capacitance=4.7e-06, case='0402', dielectric='X5R'), CapacitorKind(capacitance=4.7e-07, case='0402', dielectric='X5R'), CapacitorKind(capacitance=4.7e-07, case='0402', dielectric='X5R'), CapacitorKind(capacitance=4.7e-07, case='0402', dielectric='X5R'), CapacitorKind(capacitance=4.7e-07, case='0402', dielectric='X5R'))#

one of its three 47 uF (C81, C82, C83), three of its six 4.7 uF (C68, C69, C70, C76, C77, C78) and four of its eight 470 nF (C87, C88, C89, C90, C94, C95, C96, C97). Its two 330 uF (C66, C67) and three 100 uF (C71, C72, C73) are dropped.

Type:

TE0950 page 13, VCCINT, trimmed (Approximations)

VCC_SOC_SET = (CapacitorKind(capacitance=4.7e-05, case='0805', dielectric='X5R'), CapacitorKind(capacitance=4.7e-06, case='0402', dielectric='X5R'))#

C84 (47 uF) and one of C85, C86 (4.7 uF). Its 330 uF (C74) and 100 uF (C75) are dropped.

Type:

TE0950 page 13, VCC_SOC, trimmed

VCC_IO_SET = (CapacitorKind(capacitance=4.7e-05, case='0805', dielectric='X5R'), CapacitorKind(capacitance=4.7e-06, case='0402', dielectric='X5R'))#

C104 (47 uF) and one of C105, C106 (4.7 uF).

Type:

TE0950 page 13, VCC_IO, trimmed

VCC_RAM_SET = (CapacitorKind(capacitance=4.7e-05, case='0805', dielectric='X5R'),)#

C107 (47 uF), its whole set.

Type:

TE0950 page 13, VCC_RAM

VCCAUX_SET = (CapacitorKind(capacitance=4.7e-05, case='0805', dielectric='X5R'), CapacitorKind(capacitance=4.7e-06, case='0402', dielectric='X5R'))#

C98 (47 uF) and one of C99, C100 (4.7 uF).

Type:

TE0950 page 13, VCCAUX, trimmed

VCCAUX_PMC_SET = (CapacitorKind(capacitance=4.7e-05, case='0805', dielectric='X5R'), CapacitorKind(capacitance=4.7e-06, case='0402', dielectric='X5R'))#

C79 (47 uF) and C80 (4.7 uF), its whole set; half of one 4.7 uF rounds up to one.

Type:

TE0950 page 13, VCCAUX_PMC

VCCAUX_SMON_SET = (CapacitorKind(capacitance=4.7e-07, case='0402', dielectric='X5R'), CapacitorKind(capacitance=1e-07, case='0201', dielectric='X5R'))#

C108 (470 nF), C109 (100 nF); AM006 v1.5 Figure 1: 470 nF and 100 nF. Kept whole (Approximations).

Type:

TE0950 page 13, VCCAUX_SMON

VCC_PMC_SET = (CapacitorKind(capacitance=4.7e-05, case='0805', dielectric='X5R'), CapacitorKind(capacitance=4.7e-06, case='0402', dielectric='X5R'))#

C63 (47 uF) and one of C64, C65 (4.7 uF).

Type:

TE0950 page 13, VCC_PMC, trimmed

VCC_PSLP_SET = (CapacitorKind(capacitance=4.7e-05, case='0805', dielectric='X5R'), CapacitorKind(capacitance=4.7e-06, case='0402', dielectric='X5R'))#

C91 (47 uF) and one of C92, C93 (4.7 uF).

Type:

TE0950 page 13, VCC_PSLP, trimmed

VCC_PSFP_SET = (CapacitorKind(capacitance=4.7e-05, case='0805', dielectric='X5R'), CapacitorKind(capacitance=4.7e-06, case='0402', dielectric='X5R'))#

C101 (47 uF) and one of C102, C103 (4.7 uF).

Type:

TE0950 page 13, VCC_PSFP, trimmed

VCCO_500_SET = (CapacitorKind(capacitance=4.7e-05, case='0805', dielectric='X5R'), CapacitorKind(capacitance=4.7e-06, case='0402', dielectric='X5R'))#

C5 (47 uF) and one of C6, C7 (4.7 uF).

Type:

TE0950 page 7, VCCO_500, trimmed

VCCO_501_SET = (CapacitorKind(capacitance=4.7e-06, case='0402', dielectric='X5R'),)#

one of C12, C13 (4.7 uF). The set has no bulk part.

Type:

TE0950 page 7, VCCO_501, trimmed

VCCO_502_SET = (CapacitorKind(capacitance=4.7e-05, case='0805', dielectric='X5R'), CapacitorKind(capacitance=4.7e-06, case='0402', dielectric='X5R'))#

C15 (47 uF) and one of C16, C17 (4.7 uF).

Type:

TE0950 page 7, VCCO_502, trimmed

VCCO_503_SET = (CapacitorKind(capacitance=4.7e-05, case='0805', dielectric='X5R'), CapacitorKind(capacitance=4.7e-06, case='0402', dielectric='X5R'))#

C8 (47 uF) and one of C9, C10 (4.7 uF).

Type:

TE0950 page 7, VCCO_503, trimmed

GT_AVCC_SET = (CapacitorKind(capacitance=4.7e-05, case='0805', dielectric='X5R'), CapacitorKind(capacitance=4.7e-06, case='0402', dielectric='X5R'), CapacitorKind(capacitance=4.7e-07, case='0402', dielectric='X5R'))#

C41 (47 uF), one of C43, C44 (4.7 uF) and one of C45, C46 (470 nF). Its 100 uF (C40) is dropped, and its 22 uF (C42) gives way to the larger 47 uF.

Type:

TE0950 page 12, GTYP_AVCC, trimmed

GT_AVCCAUX_SET = (CapacitorKind(capacitance=2.2e-05, case='0603', dielectric='X5R'), CapacitorKind(capacitance=4.7e-07, case='0402', dielectric='X5R'))#

C37 (22 uF) and one of C38, C39 (470 nF).

Type:

TE0950 page 12, GTYP_AVCC_AUX, trimmed

GT_AVTT_SET = (CapacitorKind(capacitance=4.7e-05, case='0805', dielectric='X5R'), CapacitorKind(capacitance=4.7e-06, case='0402', dielectric='X5R'), CapacitorKind(capacitance=4.7e-07, case='0402', dielectric='X5R'))#

C47 (47 uF), one of C49, C50 (4.7 uF) and one of C51, C52 (470 nF). Its 22 uF (C48) gives way to the larger 47 uF.

Type:

TE0950 page 12, GTYP_AVTT, trimmed

make_capacitor(kind, rail_max)[source]#

The catalogue capacitor for kind on a rail whose maximum is rail_max volts.

Return type:

Capacitor

Parameters:
type GridPosition = tuple[int, int]#

Zero-indexed (row, column) of a ball in its package’s grid.

ball_grid(component)[source]#

The grid position of the ball each single-ball port of a BGA part maps to, read from the ball’s name with ball_to_rc() (JEDEC row letters, so "AB34" is row 21, column 33).

The name is the pad’s place in the BGA landpattern: pad landpattern.AB[34] is ball AB34. A port mapped to several balls (the memory’s DNU and NC) is left out. Positions come from names alone, so the part need not be placed.

Return type:

dict[Port, GridPosition]

Parameters:

component (Component)

class RailLayout(ring=frozenset({}), omit=frozenset({}))[source]#

Bases: object

How a layout treats some of one rail’s set, each capacitor named by its place in the set: ring, capacitors below 10 uF placed away from their ball, tied to it by a plain net rather than a ShortTrace; omit, capacitors not created at all. The default treats none so.

Parameters:
ring: frozenset[int] = frozenset({})#
omit: frozenset[int] = frozenset({})#
class MemoryDecoupling(memory)[source]#

Bases: Container

The memory’s VDDQ, VDD2 and VDD1 capacitors, each tied to one ball of its rail (_build()), each rail’s set spread over its balls in (row, column) order.

Parameters:

memory (MT53E1G32D2FW_046_WT_B)

short_traces: list[ShortTrace]#
bulk_nets: list[Net]#
capacitors()[source]#

Every capacitor, for netting their return pads to ground.

Return type:

list[Capacitor]

class XpioBankDecoupling(balls, grid, layout=None)[source]#

Bases: Container

One XPIO bank’s VCCO capacitors, XPIO_BANK_SET, each tied to one of the bank’s own VCCO balls (_build()), spread over them in (row, column) order, less any layout omits. caps holds each by its place in the set.

grid gives each FPGA ball’s position (ball_grid()).

Parameters:
capacitors()[source]#

Every capacitor, for netting their return pads to ground.

Return type:

list[Capacitor]

class FpgaRailDecoupling(balls, grid, kinds, rail_max, layout=None)[source]#

Bases: Container

One FPGA rail’s set, each capacitor tied to one of the rail’s balls (_build()), the set spread over the balls in (row, column) order, less any layout omits. caps holds each by its place in the set.

grid gives each ball’s position (ball_grid()).

Parameters:
capacitors()[source]#

Every capacitor, for netting their return pads.

Return type:

list[Capacitor]

class RailSet(name, balls, kinds, rail_max)[source]#

Bases: object

An FPGA rail: its name (the FPGA’s port name), its balls, its reference-board set and its maximum.

Parameters:
name: str#
balls: Sequence[Port]#
kinds: Sequence[CapacitorKind]#
rail_max: float#
fpga_rail_sets(fpga)[source]#

Every FPGA supply rail whose capacitors return to the main ground.

Not here: the XPIO banks, which XpioBankDecoupling covers; VCCAUX_SMON, which returns to GND_SMON (FpgaDecoupling); VCC_BATT and VCC_FUSE, tied to ground (FpgaStraps); the AVTTRCAL supplies, each tied to its AVTT rail and decoupled by that rail’s set (GtCalibration); and VCCINT_SENSE, a sense pin, not a supply.

Return type:

list[RailSet]

Parameters:

fpga (VP1002LPDDR4)

XPIO_BANKS = ('VCCO_700', 'VCCO_701', 'VCCO_702')#

The XPIO banks’ VCCO rails, by the FPGA’s port names.

fpga_sets(fpga)[source]#

Every FPGA set by rail name: each XPIO bank’s (XPIO_BANKS), each of fpga_rail_sets() and VCCAUX_SMON’s. These are the names a RailLayout mapping takes.

Return type:

dict[str, Sequence[CapacitorKind]]

Parameters:

fpga (VP1002LPDDR4)

class FpgaDecoupling(fpga, grid, layouts=None)[source]#

Bases: Container

Every FPGA supply rail’s set but the XPIO banks’.

grid gives each FPGA ball’s position (ball_grid()). layouts maps a rail name of fpga_sets() to how a layout treats some of its set; a rail it does not name gets every capacitor. It may name the XPIO banks too, whose sets XpioBankDecoupling builds.

Parameters:
capacitors()[source]#

The capacitors that return to the main ground: all but VCCAUX_SMON’s.

Return type:

list[Capacitor]

smon_capacitors()[source]#

VCCAUX_SMON’s capacitors, which return to GND_SMON (AM006 v1.5 Figure 1).

Return type:

list[Capacitor]