Skip to content

Releases

v0.3.0 — SKY130 PDK + the fully-differential campaign

Choose a tag to compare

@phuocphn phuocphn released this 24 Aug 16:54
3473719

A second real PDK and the fully-differential campaign: SKY130 1.8 V for the
gm/Id sizer with a per-tech intent registry, the FD correctness work that took
fully-differential circuits from a mis-sensed CMFB to SPICE-verified open-loop
gain, CMRR and PSRR, and a recognizer that now reads sized netlists.

Added

  • ✨ Recognizer parser accepts sized SPICE netlists — MOSFET W/L/nf/m params, sky130_fd_pr__*/foundry model names via a configurable model-name table, and preserved R/C value tokens; sizes ride along on Device.params and recognize() is unchanged (#169).
  • ✨ SKY130 1.8 V core PDK for the gm/Id sizer — trimmed vendored PDK, device_handle/wl_units tech fields, LUT monotone-envelope fix (#159).
  • ✨ Per-tech gm/Id intent registry — make_intent/INTENT_BY_TECH/intent_for_tech(tech.name) threaded into size_gmid, so a per-tech override moves the block-intents (drive geometry) and flat role fallbacks (drive the pre-geometry gds estimate) together; ships a feasible sky130 spec and fixes the sky130 .op non-convergence it surfaced (#187).
  • ✨ Optional body-effect coefficients (gamma/phi) on MosfetParams plus extract_tech.py --body-effect, which fits γ/2φF per tech from a reverse-body-bias vth sweep (populated for gf180/sky130) — latent infrastructure for a future Vsb-aware model. Investigating #106, an analytic cascode-rail body-effect correction built on these was found to regress the gf180 two-stage benchmark (126 → 114 accepted; the reported cascode failures were already resolved by #124/#167), so the rail-planner correction itself was not applied (#106).

Changed

  • ♻️ Consolidate vcm and rail_v onto SizingSpec — the input common mode and a supply net's DC level become single named definitions on the spec instead of copies scattered across the gm/Id modules; with #206 this closes the #201 deduplication umbrella (#207).
  • ♻️ Consolidate the five grid-snap copies onto GridSpec.snap — one snap-then-clamp definition replaces the private _snap_w/_snap_l helpers in bias.py, bias_levels.py, stage_interface.py and friends (#206).
  • ♻️ Decouple gm/Id techs from the Level-1 square-law schema — MosfetParams.vth/mu_cox/lam are now optional (a gm/Id PDK tech may omit the nmos:/pmos: blocks entirely) and size_load_resistors takes a LUT-sourced per-polarity seed; drops the honest-but-dead square-law placeholders sky130's degenerate-at-Lmin fit was forced to carry to satisfy a schema it never touches (#195).
  • ♻️ Rename the stage-interface compatibility filter second_stage → stage_interface (module, is_*_compatible, call site) — behavior-neutral, closing the gap #144's doc-stub rename opened (#178).

Fixed

  • 🐛 Flag un-measurable analytical open-loop gain — advisory OPEN_LOOP_GAIN_CEILING_DB/open_loop_measurable on SizingResult so consumers can deprioritise three-stage topologies that report ~178 dB analytically then rail to 0 dB on every SPICE corner while bias_feasible stays True (#194).
  • 🐛 Reserve the gm/Id output_stage intent block for the source-follower buffer (fixed gm/Id = 15, L = 1× min); a third gain stage now maps to gain_stage, aligning sizer terminology with the synthesizer/recognizer (where output_stage is specifically a unity-gain common_drain_* follower) (#172).
  • 🐛 Drop the unconnected vcm_ref pin from FD circuits whose cmfb is pruned — for the 10/14 non-differential load variants prune_cmfb empties the CMFB slot, leaving vcm_ref a no-op external pin the sizer already treats as semantic (has_vcm) (#180).
  • 🐛 Remove the uncategorized cascoded_differential_pair_pmos SR pattern — the only library pattern with neither category nor circuit_block, so FBR skipped it in both slotting modes (recognized-but-never-slotted, inert) and its cascodes-in-input-pair shape contradicted the load-cascode convention (#192).
  • 🐛 telescopic_cascode_load_nmos tagged bias_infeasible — its self-biased PMOS diode stack pins the internal cascode node at vdd − |Vgs_mp1| − |Vgs_mp3|, an untunable ceiling that leaves the input-side NMOS cascode ~25 mV into triode (18/18 fail the gf180 DC bias gate); dropped from default enumeration and kept for design-space exploration, with the wide-swing telescopic_cascode_load_wideswing_nmos as the feasible equivalent (#189).
  • 🐛 Slew-rate SPICE measurement read the pole-zero-doublet settling tail instead of the slew plateau — steepest-secant-over-20%-swing replaces the 20–80% average, which collapsed to the settling speed on unsettled edges (ptm45 two-stage 0.7 → 11 V/µs) (#186).
  • 🧪 Repair test_analytic_gain_gate_skips_spice, regressed by #148's gain_db=None railing gate — the test now selects a computed-gain candidate that actually exercises the #125 gate (#186).
  • 🐛 FD load resistors never landed in the load slot — out1/out2 pin aliases + rail-check hooks on resistor_load_*; the synthesizer's 1 kΩ placeholder no longer ships (#163).
  • 🐛 FD CMFB senses the outputs (outp/outn), with loop polarity from the stage chain's inversion parity (orient_cmfb, <name>_inverting variants) — output CM was unregulated in every CMFB variant (#167).
  • 🐛 FD stage-interface check for CMFB-pinned interfaces — equality repair machinery, auto-exempting output-sensing CMFBs (#164).
  • 🐛 FD-capable DC bias-soundness gate — _read_op_fd open-input .op, output-state verdict (railed/split); dead FD circuits no longer masquerade as noise-floor gain misses (#166).
  • 🐛 FD benches drop the cross-feedback ties for the standard open-input rig — the tie network is bistable against a real CM loop (healthy sky130 circuits measured −79 dB) and made the FD DC check vacuous (#170).
  • 🐛 Re-tune the five ptm45 example specs so each sizes with all margins ≥ 0 under gm/Id — 2-stage phase margin via second_stage_current_ratio 2.5→4.0, output-swing headroom 0.1/0.15→0.2 V, 3-stage FD third_stage_current_ratio 5→6 and swing-min 0.15→0.2 V, one-stage gain 40→30 dB; restores a ptm45-only per-topology regression guard so the specs cannot silently drift again (#74).

Docs

  • 📝 SKY130 designer survey (examples/sky130_results/) — for each of the 13 op-amp templates, how many synthesizable topologies meet the SKY130 1.8 V survey spec (45 dB, 2 MHz GBW, 60° PM, ≤ 2 mW), SPICE-verified with ngspice (#205).
  • 📝 Restructure the equations.py walkthrough around the Shichman–Hodges square law — state the law once, derive every formula from it in a single pass, and map each to its CircuitGenome function (8 parts → 5) (#204).
  • 📝 Code walkthroughs — 34 hand-authored, figure-rich HTML deep dives into the sizer and recognizer internals, shipped verbatim alongside the Sphinx docs (html_extra_path, ADR 0002) with a searchable landing page and module-page deep-dive links (#173).
  • 📝 Sync the HTML code walkthroughs with #158/#190/#77/#155 (9 files, +67/−25) — living documents co-updated with the code they describe (#198).
  • 📝 Document why the FD source-follower buffer slots are deliberately absent from _FD_PAIRS — _apply_symmetry groups a pair by type alone and would fuse the two same-polarity follower devices — plus a regression test locking the invariant (#177).
  • 📝 Derive the cascode Rin = ro·(1 + gm·Rsrc) boost formula in the gm/Id blocks.py walkthrough — intuition, two theme-aware SVGs, three-step KCL (#176).
  • 📝 Update the intent.py walkthrough for the follower output_stage (fixed gm/Id = 15, L = 1× min) after #172 (#174).
  • 📝 Restructure this changelog to the Keep a Changelog + SemVer format (one line per PR).
  • 📝 Clarify the overview template table and buffered op-amps (#154).

Internal / Build

  • 🔧 Ignore .claude/ and the bsim4v5.out ngspice scratch output, keeping local scratch files out of the untracked list (#200).
  • 🧪 Lock in measured FD CMRR/PSRR (test_fd_cmrr_psrr_measured) — the #165/#167 CMFB output-sense rewire opened the ac_clean gate, so FD rejection metrics already flow through simulate_metrics (169.6/207.2 dB on the frozen three-stage FD); the FD half of #184 (#197).
  • 🧪 Guard bias resistors off gate/current rails — across every enumerated 1-/2-stage-SE/2-stage-...
Read more