master
John Lauer Variants -HV-SB-RR (16 vias + 296-ball User.9 layer + roundrect pads, one footprint) and -LE (baseline copy with its ow… 7bfa24d
{
  "part": "LAN7800",
  "package": "QFN-48 7x7mm",
  "source": "adom/lan7800",
  "generator": "adom-footprint 1.0.22 (heatsink / solderballs verbs)",
  "deviceset": "one Fusion deviceset; each variant is a device bound to its own STEP so Change Package swaps footprint + 3D together",
  "variants": [
    {
      "suffix": "",
      "device": "baseline",
      "kicad_mod": "lan7800-qfn48-7x7-y9x.kicad_mod",
      "footprintName": "QFN-48 7x7mm",
      "step": "QFN-48_7x7mm.step",
      "changed": "nothing; the page footprint as-is (49 SMD pads)",
      "stepAliases": [
        "LAN7800.step",
        "LAN7800.step"
      ]
    },
    {
      "suffix": "-HV",
      "device": "heatsink vias",
      "kicad_mod": "lan7800-qfn48-7x7-y9x-HV.kicad_mod",
      "footprintName": "QFN-48 7x7mm-HV",
      "step": "QFN-48_7x7mm-HV.step",
      "changed": "+16 thru_hole pads under pad 49 (1.2 mm pitch, 0.3 mm drill, 0.6 mm OD, 0.45 mm inset), on copper + mask layers only (*.Cu *.Mask); nothing on a drawing layer",
      "viaPadNumber": "49",
      "viaPadNumberNote": "KiCad: pads sharing a number share the net, so the vias are on the EP net with no symbol change and DRC is clean. EAGLE needs unique pad names: adom-lbr should emit them as [email protected]@16 (EAGLE's own multi-pad convention) and connect all 17 to the EP pin.",
      "vias": [
        {
          "x": -1.8,
          "y": -1.8
        },
        {
          "x": -0.6,
          "y": -1.8
        },
        {
          "x": 0.6,
          "y": -1.8
        },
        {
          "x": 1.8,
          "y": -1.8
        },
        {
          "x": -1.8,
          "y": -0.6
        },
        {
          "x": -0.6,
          "y": -0.6
        },
        {
          "x": 0.6,
          "y": -0.6
        },
        {
          "x": 1.8,
          "y": -0.6
        },
        {
          "x": -1.8,
          "y": 0.6
        },
        {
          "x": -0.6,
          "y": 0.6
        },
        {
          "x": 0.6,
          "y": 0.6
        },
        {
          "x": 1.8,
          "y": 0.6
        },
        {
          "x": -1.8,
          "y": 1.8
        },
        {
          "x": -0.6,
          "y": 1.8
        },
        {
          "x": 0.6,
          "y": 1.8
        },
        {
          "x": 1.8,
          "y": 1.8
        }
      ],
      "via": {
        "annularDiameter": 0.6,
        "drill": 0.3,
        "net": "same as pad 49",
        "plated": true,
        "ringWidth": 0.15
      },
      "pitch": 1.2,
      "insetFromPadEdge": 0.44999999999999996,
      "stepAliases": [
        "LAN7800.heatsink-vias.step",
        "LAN7800-HV.step"
      ]
    },
    {
      "suffix": "-SB",
      "device": "solder balls",
      "kicad_mod": "lan7800-qfn48-7x7-y9x-SB.kicad_mod",
      "footprintName": "QFN-48 7x7mm-SB",
      "step": "QFN-48_7x7mm-SB.step",
      "changed": "+296 filled fp_circle \u00d80.30 mm on KiCad layer User.9 (Adom.SolderBalls), one per 300um jet-paste ball at 0.25 mm pitch; copper unchanged",
      "ballLayer": {
        "kicad": "User.9",
        "name": "Adom.SolderBalls",
        "eagleLayer": 101,
        "note": "a .kicad_mod cannot carry a layer NAME (that lives in the board's layer table), so the layer is User.9 in the file and this manifest is the sidecar that names it; adom-lbr maps User.9 -> 101 Adom.SolderBalls",
        "hiddenByDefault": true
      },
      "ball": {
        "alloy": "63Sn/37Pb, Indium 12.8HF flux, type 6 powder, 80% metal",
        "diameter": 0.3,
        "pitch": 0.25,
        "shape": "hemisphere, flat face on the pad"
      },
      "count": 296,
      "ballsJson": "lan7800-qfn48-7x7-y9x-SB.solder-balls.json",
      "stepAliases": [
        "LAN7800.solder-balls.step",
        "LAN7800-SB.step"
      ]
    },
    {
      "suffix": "-RR",
      "device": "rounded pads",
      "kicad_mod": "lan7800-qfn48-7x7-y9x-RR.kicad_mod",
      "footprintName": "QFN-48 7x7mm-RR",
      "step": "QFN-48_7x7mm-RR.step",
      "stepAliases": [
        "LAN7800-RR.step",
        "QFN-48_7x7mm.step (same chip body as baseline)"
      ],
      "changed": "every SMD pad shape -> KiCad roundrect: signal pads roundrect_rratio 0.25 (the KiCad/IPC default; EAGLE/Fusion roundness 50 = percent of the pad's smaller side), exposed pad 49 roundrect_rratio 0.1 (roundness 20); copper positions and sizes unchanged. Note: the baseline's signal pads were `oval` (semicircular ends), so -RR is LESS rounded at the ends than baseline, not more; it matches Altium's default rounded-rectangle style.",
      "padShape": {
        "signal": {
          "shape": "roundrect",
          "rratio": 0.25,
          "eagleRoundness": 50
        },
        "exposedPad": {
          "shape": "roundrect",
          "rratio": 0.1,
          "eagleRoundness": 20
        }
      }
    },
    {
      "suffix": "-LE",
      "device": "laser-etched model",
      "kicad_mod": "lan7800-qfn48-7x7-y9x-LE.kicad_mod",
      "footprintName": "QFN-48 7x7mm-LE",
      "step": "QFN-48_7x7mm-LE.step",
      "stepAliases": [
        "LAN7800-LE.step"
      ],
      "changed": "footprint identical to baseline (own package name so adom-lbr gets a distinct package); the 3D model carries the laser-etched part number (step2glb)"
    },
    {
      "suffix": "-HV-SB-RR",
      "device": "heatsink vias + solder balls + rounded pads",
      "kicad_mod": "lan7800-qfn48-7x7-y9x-HV-SB-RR.kicad_mod",
      "footprintName": "QFN-48 7x7mm-HV-SB-RR",
      "step": "QFN-48_7x7mm-HV-SB-RR.step",
      "stepAliases": [
        "LAN7800-HV-SB-RR.step"
      ],
      "changed": "= -RR pads (roundrect rratio 0.25, EP 0.1) + the 16 heatsink vias as thru_hole pads on 49 + the 296-ball Adom.SolderBalls layer on User.9; the 3D model is the CHIP-ONLY laser-etched body (no via or ball solids: Fusion generates vias from the pads on the board, and nobody wants balls rendered)",
      "vias": 16,
      "balls": 296,
      "padShape": {
        "signal": {
          "shape": "roundrect",
          "rratio": 0.25,
          "eagleRoundness": 50
        },
        "exposedPad": {
          "shape": "roundrect",
          "rratio": 0.1,
          "eagleRoundness": 20
        }
      },
      "ballLayer": {
        "kicad": "User.9",
        "name": "Adom.SolderBalls",
        "eagleLayer": 101,
        "hiddenByDefault": true
      }
    }
  ],
  "notes": [
    "-SB carries no vias, but its balls still keep 0.55 mm clear of the STANDARD via positions (the keep-out is derived from the exposed-pad geometry, not from vias present in the file), so -SB and the layered file both have 296 balls and a board can gain the vias later without moving paste. The vias+balls combination is lan7800-qfn48-7x7-y9x.layers.kicad_mod if a fourth device is ever wanted.",
    "Re-running `adom-footprint heatsink` / `solderballs` on a variant is idempotent."
  ],
  "stepPairing": "Fusion bridge binds a STEP to a PACKAGE by name: stem == package name (case-insensitive after normalisation, spaces -> _), then deviceset+device (LAN7800-HV), then deviceset. Use `step`; `stepAliases` are the older descriptive names and do not pair on their own.",
  "pin1": {
    "corner": "top-left",
    "order": "ccw",
    "description": "Datasheet DS00001992 Figure 3-1 (top view): pin 1 top-left; pins 1..12 run DOWN the left edge, 13..24 along the bottom left-to-right, 25..36 UP the right edge, 37..48 along the top right-to-left. Pad 1 at KiCad (-3.5, -2.75); silk pin-1 dot at (-3.5, -3.5).",
    "verified": "2026-08-30 against the datasheet figure and the 6x6 VSX footprint on this page (same orientation); the STEP's pin-1 dimple (top-left) now matches with model rotate 0 0 0",
    "history": "Before 2026-08-30 the y9x footprint was rotated 90 degrees (pad 1 bottom-left, 1..12 along the bottom); fixed by rotating pads (size w/h swapped) and silk/courtyard/comment geometry with (x, y) -> (-y, x) in KiCad's Y-down frame; text and the STEP binding were left as they were."
  },
  "baselineFixes": [
    "2026-08-30: F.CrtYd grown from the 7x7 body (\u00b13.5, which cut through the pads) to \u00b14.25 mm = pads (\u00b14.0) + 0.25 mm IPC nominal; lint courtyard_too_small cleared.",
    "2026-08-30: F.Fab body outline added: 7x7 fp_poly with a 1 mm pin-1 chamfer at the top-left corner."
  ]
}