
Lt8710 sepic manual
freudenthal/skidl-eda
skidl-eda: AI circuit-design loop harness on the skidl stack

skidl-eda: AI circuit-design loop harness on the skidl stack
Lt3758 iso flyback manual is an open-source printed circuit board by freudenthal, from the freudenthal/skidl-eda repository on GitHub. It is a 2-layer board of 52 × 36 mm with 36 parts on 23 nets.
It is built around the PS2801-1, TL431 and BAS516, with the ES1D, FDC2512 and PA1277NL among its other parts. Its parts include 3 ICs and 2 connectors.
An AI circuit-design loop harness built on the skidl stack. It turns a skidl circuit description into a KiCad-openable project and wraps it with the pieces an automated (or assisted) design loop needs: verification gates, part sourcing, SPICE simulation entry, an aggregate quality metric, a diagnostics knowledge base, human-in-the-loop regeneration from an edited schematic, and a scored PCB placement step.
Circuit to a KiCad-10 project
(.kicad_pro + .kicad_sch + .net) and run it through a gate pipeline.PWR_FLAG
autofix that reverts on regression), a KiCad save-crash gate, and a footprint
check.kicad-cli.skidl.sim to turn acceptance criteria
into PASS/FAIL..kicad_pcb.skidl-eda is a peer package that composes several libraries:
| Package | Role |
|---|---|
| skidl | authoring DSL + KiCad-10 backend + schematic router + skidl.sim |
| skidl-codegen | KiCad schematic → runnable skidl source (HITL regeneration) |
| skidl-layout | PCB placement engine + layout-quality metrics |
| kicad-sch-api | byte-perfect KiCad round-trip / edit interface for the human-in-the-loop step |
The core (generation + gates + evaluation + diagnostics + sourcing) depends only
on skidl and kicad-cli. The HITL and PCB steps pull in skidl-codegen and
skidl-layout respectively, and degrade gracefully (a clear "unavailable"
result) when those optional peers are not installed.
skidl-eda and its peers are installed from local checkouts (editable during
development). Python 3.13 or 3.14 is supported (verified end-to-end on CPython
3.13.14 + KiCad 10.0.4).
The commands below are run from inside this skidl-eda/ directory; the ../
peer paths assume the sibling checkouts sit directly beside it (the standard flat
layout: skidl/, skidl-codegen/, skidl-layout/, kicad-sch-api/, and
skidl-eda/ all under one parent).
# create an environment (uv shown; venv/pip works the same)
uv venv --python 3.13 .venv
# install the peer packages editable, then skidl-eda
uv pip install -e ../skidl -e ../skidl-layout -e ../skidl-codegen -e ../kicad-sch-api
uv pip install -e .
# to run the tests AND any simulation, add both extras (neither pytest nor
# PySpice is in the base install):
uv pip install -e ".[test,sim]"Other optional extras:
uv pip install -e ".[sim]" # PySpice for live skidl.sim simulation
uv pip install -e ".[sourcing]" # requests, for keyed DigiKey sourcing
uv pip install -e ".[test]" # pytestVerify the install resolves to the local checkouts:
python -c "import skidl, skidl_eda, kicad_sch_api, os; \
print(os.path.dirname(skidl.__file__)); print(os.path.dirname(skidl_eda.__file__))"A working KiCad 10 install (for its symbol/footprint libraries and kicad-cli)
is required for the gate, export, and PCB steps. On this project it lives at
C:\Program Files\KiCad\10.0\.
setup_kicad10() auto-defaults SKIDL_SPICE_LIB_PATH to a
KiCad-Spice-Library corpus found
beside the checkouts, in ~/.skidl/, or above the cwd (so value="<vendor NAME>"
auto-resolves out of the box — see below). A part authored as a generic device
with a Sim_Params override (e.g. a diode value="1N4742A", Sim_Params="BV=12")
whose value merely shares a name with a corpus .subckt still simulates as the
intended generic model — the converter only binds a corpus subckt when
Sim_Pins explicitly maps its nodes, or Sim_Prefer="library" is set. To pin a
session to a specific corpus (or none), set SKIDL_SPICE_LIB_PATH yourself before
setup_kicad10(); an already-set value always wins.
Always call setup_kicad10() before building a circuit. It binds skidl to the
real KiCad-10 symbol directory (see the library note
below for why this matters).
from skidl_eda import setup_kicad10
setup_kicad10()from skidl_eda import setup_kicad10, generate, summarize
setup_kicad10()
from my_design import build # your skidl circuit factory
result = generate(build(), "MyBoard", output_dir="build")
print(summarize(result))
# project: build/MyBoard -> OK
# netlist PASS | schematic PASS | project PASS | footprint PASS
# erc WARN (... ) | save_gate PASS | bom PASS | pdf PASS | evaluation PASS (grade 82/100)generate() returns a result dict. ok reflects generation plus the
save-crash gate (the "opens in KiCad" contract). ERC is report-only by default
(result["erc_clean"], per-step autofixes_applied); pass
erc_must_be_clean=True to make remaining ERC errors fail the run. The ERC
PWR_FLAG autofix runs by default (erc_autofix=True) and needs kicad-sch-api.
from skidl_eda import evaluation as E
report = E.evaluate_circuit(build()) # structural grade
report = E.evaluate_circuit(build(), reference="golden.net") # + regression oracle
print(E.summarize(report))from skidl_eda import diagnostics as D
print(D.diagnose(["3.3V rail low", "regulator hot"]).summary())
# [80%] Overloaded voltage regulator -> Replace regulator ... + test treeD.diagnose_design(evaluation=..., erc=...) feeds a design's own gate output in
as symptoms.
After a human edits the project in KiCad (or via kicad-sch-api), regenerate the
authoring source and verify it still describes the same circuit:
from skidl_eda import regenerate
res = regenerate("build/MyBoard/MyBoard.kicad_sch", output_dir="regen")
print(res.summary()) # "regenerated flat: EQUIV"
assert res.equivalent # round-trip pin-partition equivalence passedfrom skidl_eda import setup_kicad10, plan_pcb
setup_kicad10()
res = plan_pcb(build(), "build/MyBoard/MyBoard.kicad_pcb")
print(res["score"], res["overlaps"], res["pcb_written"])The PCB step is also available inline as generate(..., pcb=True) (opt-in,
report-only).
Fast in-loop layout. Both plan_pcb(...) and generate(..., pcb=True, pcb_options={...}) forward layout knobs to skidl_layout.plan_layout. For
quick iteration, prune the 8-candidate portfolio:
# via generate(): pcb_options is forwarded verbatim to plan_pcb -> plan_layout
generate(build(), "MyBoard", pcb=True,
pcb_options={"candidate_names": ["baseline", "connector_edge_first"]})
# or directly on plan_pcb() as **plan_kwargs
plan_pcb(build(), "build/MyBoard.kicad_pcb", max_candidates=2)The SKIDL_LAYOUT_CANDIDATES / SKIDL_LAYOUT_MAX_CANDIDATES environment
variables do the same with no code change (read inside plan_layout).
python -m skidl_eda.sourcing.find_symbol ADA4817 # search KiCad symbol libsfrom skidl_eda.sourcing import check_availability
check_availability("C514314") # keyless JLCPCB lookupFor simulation, skidl-eda can pull real vendor models from the
KiCad-Spice-Library
corpus (~50k .model/.subckt definitions). The corpus is referenced, never
bundled — obtain it once (it carries heterogeneous vendor licenses):
git clone --depth 1 https://github.com/kicad-spice-library/KiCad-Spice-Library \
~/.skidl/KiCad-Spice-Library
# or: python -m skidl_eda.sourcing.find_spice_model --help (prints the command)
# or: python -c "from skidl_eda.sourcing import spice_library as s; s.ensure_library(install=True)"It's auto-detected at ~/.skidl/KiCad-Spice-Library, beside this repo, or via
SKIDL_SPICE_LIB_PATH (pointed at the corpus Models dir). Search for a model
and get a paste-ready block:
python -m skidl_eda.sourcing.find_spice_model TL072 --type opamp --verify
# TL072 (subckt) Manufacturer/Texas Instruments/tl072.mod license: vendor_restricted
# value="TL072" Sim_Compat="psa"
# Sim_Pins="<pin_+in>=1 <pin_-in>=2 <pin_V+>=3 <pin_V->=4 <pin_out>=5"
# # subckt nodes (assumed op-amp order): 1=+in, 2=-in, 3=V+, 4=V-, 5=out
# verify: LOADS + convergesTwo ways to attach a hit:
SKIDL_SPICE_LIB_PATH to the corpus Models dir, then
just name the part in value. Bare .model parts (most diodes/BJTs/MOSFETs)
need no pin mapping; a .subckt (op-amps/ICs) also needs Sim_Pins or
Sim_Prefer="library". A curated built-in datasheet_fit card always wins
unless you set Sim_Prefer="library". Provenance is recorded as vendor_lib /
source library_index in sim.model_provenance[ref].Sim_Library="<abs path>" + Sim_Name="<NAME>"
(+ Sim_Pins), no env var needed.Always keep Sim_Compat="psa" for corpus models. Corpus models are real but
unvetted — prefer a built-in datasheet_fit when one exists. Vendor-
restricted files are fine for local simulation; only permissive files are
auto-copied into the shared model store (find_spice_model --into-store MPN;
override with --allow-restricted). Optional gated check:
generate(..., verify_models=True) smoke-tests every corpus-resolved part.
Requires KiCad's bundled ngspice (auto-configured on Windows); the codemodels needed for vendor
POLY(n)macromodels are loaded automatically.
Auto-resolved models load a minimal deck, not the whole file. One malformed
line anywhere in a vendor library makes ngspice reject every model defined in
it — measured across this corpus: 2,101 load failures from just 102 files, 70 of
them 100% dead (Zener_DiodesInc.lib alone defines 842 zeners). So the converter
extracts only the models a netlist needs, plus their same-file dependencies
(skidl.sim.model_deck); 1N4733A and its file-mates simulate because of it.
Explicit Sim_Library= keeps its whole-file include — pinning a file is user
intent, and the escape hatch by construction. SKIDL_SIM_MINIMAL_DECK=0 reverts
everything to whole-file includes, and moves smoke_test/--verify with it so
verification keeps predicting the sim path.
corpus_eval)The corpus is permanently unreliable — models fail to load, are the wrong
dialect, have swapped terminal identity, have behavioral thresholds above your
stimulus, or are numerically stiff. corpus_eval mechanizes the discovery: it
wires each part into a canonical, per-class test circuit, runs it in a bounded
subprocess (a hung ngspice can't stall the sweep), and writes tiered, hedged
JSONL records + a markdown rollup.
# the plain CLI (scriptable / for CI-style runs):
python -m skidl_eda.sourcing.corpus_eval --type diode --limit 20
# the WATCHABLE runner (start it and watch it go — live per-part lines, a
# running tally, rate/ETA, checkpoints; Ctrl-C-safe, resume with --resume):
python scripts/run_corpus_eval.py --type all --per-class-limit 250 --workers 8
python scripts/run_corpus_eval.py --type diode --limit 20 # a quick lookThe sweep is an external batch operation — nothing in the package or its
test suite ever triggers a real run; corpus_eval is opt-in and the reader only
reads the JSONL if it exists. scripts/run_corpus_eval.py is the standalone
runner you start by hand.
The score is tiered, never a single grade (a part can pass every single-instance test and still collapse in a multi-instance loop — see LMC6482):
dialect — can ngspice-in-KiCad run this class at all (yes/no/unknown);
a hard no short-circuits (no sim).loads / op_converges — the model parses and its .op converges.functional — per-class metrics scored vs a formula: op-amp
(follower / inverting G=−10 / open-loop rail / AC→GBW), diode (Vf@1mA,
leakage, Vz), BJT (β, Vbe), MOSFET/FET (Vth/gm/Rds_on — with
name-match → IR 10/20/30 → permutation-trial terminal identity), LDO
(line/load/dropout; >3-terminal parts honestly untestable-generic),
twoterm and threeterm (below).
Status is pass / partial / fail / untestable-generic / untested.transient_loop — always "untested" (Phase 2, not built): the standing hedge
in every record and the report header.twoterm / threeterm cover the ~19k 2- and 3-node subckts that used to
fall through to the formula-less generic subckt class:
twoterm (2 nodes) — an AC driving-point impedance sweep (a 1 A AC source
makes V(a) numerically equal to Z(f)) plus a DC I–V sweep classify the part
into z_kind = inductive / capacitive / resistive / resonant /
rectifying / clamping / zener / open, and measure l_h / c_f /
r_ohm / srf_hz / vf_v / vz_v / vclamp_*. When the part name encodes
its nominal (4532_7447669168_68u → 68 µH) that becomes a real pass/fail
target at ±30 % — the same idea as LM7805 → 5 V. Kind is decided by a
phase plurality over the midband, not a majority: a real 68 µH inductor
reads resistive below its DCR corner and capacitive above its SRF, so it is
inductive over barely half the sweep.threeterm (3 nodes, not already claimed by mosfet/ldo) — a bounded
15-bench cascade: a 6-permutation FET trial → a 6-permutation regulator trial
→ 3 pairwise impedance probes. z_kind=transistor means a 3-terminal
controlled conductor (FET/BJT/triode/SCR-like), not an identified device
family. A passive network is partial, never pass — a pairwise impedance
measurement does not verify what the part is for.Not built on purpose: ≥4-node behavioral parts get no profile. Generic
stimulus on an IR2104-class part yields confident false verdicts, so they stay
honestly untested / untestable-generic.
Output (in .claude/memory/ by default): corpus_eval_results.jsonl (the
exhaustive machine-readable store) + corpus_eval_report.md (a summarized,
hedged rollup that documents any per-class sampling cap — no silent caps). The
corpus holds ~44k models, so a full sweep needs --workers and is a
multi-hour job; --per-class-limit runs a bounded representative sample
(even-strided across the name space).
The measured records feed straight into find_spice_model's reliability: line
through the single reader skidl_eda.sourcing.reliability — which merges the
curated seed (diagnostics/data/spice_model_reliability.jsonl), the packaged
measured snapshot (diagnostics/data/corpus_eval_results.jsonl.gz), a
.claude/memory curated overlay, and any local measured results (a curated note
always wins; a measured-only part gets a synthesized, hedged line).
import_corpus_results)A full sweep is a multi-hour job, so its result is bundled with the package rather than re-measured per checkout — a fresh clone inherits the measurements immediately, and a local sweep still overrides them on the machine that ran it.
python scripts/import_corpus_results.py --dry-run # preview + summary
python scripts/import_corpus_results.py # bundle itThis reads <memory_dir>/corpus_eval_results.jsonl (snapshotting first, so it
is safe to run while a sweep is going) and writes the gzipped package-data
dataset. Gzip buys ~43× — a full corpus lands around half a megabyte. The output
is byte-deterministic, so re-importing an unchanged store produces an empty diff.
Every record carries two hashes that make staleness detectable, so a re-run refreshes only what actually needs it:
file_hash — fast blake2b of the model file's bytes. Proves the record
still describes the data on disk; if the corpus file changes, the entry is
stale.harness_hash — hash of HARNESS_VERSION plus the source of the shared
and per-class bench builders/scorers. Editing one class's profile invalidates
only that class; editing shared logic invalidates everything.--resume skips a part only when both hashes match, so blanking
harness_hash marks an entry for re-run:
python scripts/update_corpus_hashes.py # dry run: what would re-run
python scripts/update_corpus_hashes.py --apply --backupThat backfills both hashes into an existing store and invalidates the records
that failed to load or errored (~4 s for 20k records). Then re-run the sweep
with --resume to refresh exactly those.
Whole-file poisoning (fixed in harness v2). Benches used to
.includethe entire model file, so one malformed line anywhere in a vendor library killed every part defined in it — measured: 2101 load failures from just 102 files, 70 of which failed at 100%. Benches now embed a minimal extracted deck (the target block + its dependencies + file-scope.param, ASCII-sanitized), which also fixes non-UTF-8 decks and unbalanced.subckt/.ends. Internal helper subckts that need caller-supplied parameters are reported asuntestable-generic, never a false FAILS-TO-LOAD.
skidl-eda-bootstrap MyBoard --generateScaffolds a fresh project folder (a starter design, the design-circuit skill,
MCP wiring, and a design log) and optionally runs the starter through
generate().
Do not set lib_search_paths["kicad10"] = ["."] + default_lib_paths(). When
a process runs at or under a checkout that carries skidl's bundled
tests/test_data, the resolver descends from "." and binds the bundled
KiCad-6 libraries — silently shadowing KiCad-10 symbols and hiding
KiCad-10-only parts (for example Amplifier_Operational:ADA4817-1ACP simply is
not found). Call skidl_eda.setup_kicad10() instead; it points at the real
KiCad-10 symbol directory only.
canaries/sipm_tia/ contains a SiPM transimpedance amplifier authored natively
in skidl, with drivers that exercise the full loop end to end:
python canaries/sipm_tia/drive_validation.py # equivalence | sim | gates | layout
python canaries/hitl_pcb/drive_hitl_pcb.py # generate | edit | regenerate | PCBEach canary is a slimmed builder (*_skidl.py) distilled from an end-to-end
design in ../kicadprojects/, plus a drive_*.py acceptance script and a
gated tests/test_*_canary.py (fast build assertions + a live-ngspice check
that skips when the backend is absent). The set covers a spread of hard
mechanisms:
python canaries/royer_zvs/drive_royer.py # self-oscillating ZVS, 24 V -> ~2 kV HV AC
python canaries/llc_resonant/drive_llc.py # half-bridge LLC resonant converter (48 -> 12 V)
python canaries/dff_divider/drive_dff.py # behavioral D-flip-flop /2 divider (no XSPICE)
python canaries/trig_pulser/drive_trig_pulser.py # TRIGSW behavioral avalanche pulser
python canaries/hv_postreg/drive_hv_postreg.py # closed-loop precision HV linear post-reg (12..200 V)
python canaries/hvllc/drive_hvllc.py # HV LLC step-up w/ real IR2104 driver + LT1364 monitor
python canaries/funcgen/drive_funcgen.py # relaxation-VCO square+sine generator (10-120 kHz)MIT.
| Qty | Value | Footprint | References |
|---|---|---|---|
| 3 | 100uF | C_1210_3225Metric | COUT1, COUT2, COUT3 |
| 2 | 2.2uF | C_1210_3225Metric | CIN1, CIN2 |
| 2 | 4.7uF | C_0805_2012Metric | CBIAS, CVCC |
| 1 | 0.03 | R_2010_5025Metric | RS |
| 1 | 0.47uF | C_0805_2012Metric | CSS |
| 1 | 10 | R_0805_2012Metric | RG |
| 1 | 10k | R_0805_2012Metric | RC |
| 1 | 16k | R_0805_2012Metric | RFB1 |
| 1 | 1M | R_0805_2012Metric | RUV1 |
| 1 | 2.00k | R_0805_2012Metric | RFBS1 |
| 1 | 2.2nF | C_0805_2012Metric | CSN |
| 1 | 20k | R_0805_2012Metric | RSN |
| 1 | 22.1k | R_0805_2012Metric | RCOMP |
| 1 | 2200pF | C_1210_3225Metric | CY |
| 1 | 274 | R_0805_2012Metric | RLED |
| 1 | 2k | R_0805_2012Metric | RBIAS |
| 1 | 4.7nF | C_0805_2012Metric | CC |
| 1 | 44.2k | R_0805_2012Metric | RUV2 |
| 1 | 47nF | C_0805_2012Metric | CCOMP |
| 1 | 5.6k | R_0805_2012Metric | RFB2 |
| 1 | 6.19k | R_0805_2012Metric | RFBS2 |
| 1 | 63.4k | R_0805_2012Metric | RT |
| 1 | BAS516 | D_SOD-123 | DAUX |
| 1 | ES1D | D_SMB | DSN |
| 1 | FDC2512 | TO-252-2 | M1 |
| 1 | LT3758 | MSOP-10-1EP_3x3mm_P0.5mm_EP1.68x1.88mm | U1 |
| 1 | PA1277NL | Transformer_Wuerth_750315371 | T1 |
| 1 | PS2801-1 | DIP-4_W7.62mm | U2 |
| 1 | TL431 | SOT-23 | U3 |
| 1 | UPS840 | D_SMC | DOUT |
| 1 | VIN_36-72V | TerminalBlock_Xinya_XY308-2.54-2P_1x02_P2.54mm_Horizontal | J1 |
| 1 | VOUT_3V3_3A_ISO | TerminalBlock_Xinya_XY308-2.54-2P_1x02_P2.54mm_Horizontal | J2 |

freudenthal/skidl-eda
skidl-eda: AI circuit-design loop harness on the skidl stack

freudenthal/skidl-eda
skidl-eda: AI circuit-design loop harness on the skidl stack

freudenthal/skidl-eda
skidl-eda: AI circuit-design loop harness on the skidl stack

freudenthal/skidl-eda
skidl-eda: AI circuit-design loop harness on the skidl stack

freudenthal/skidl-eda
skidl-eda: AI circuit-design loop harness on the skidl stack

EmadBahra/open-source-IGBT-gate-driver
This is a beta version and it's not tested yet, so use it at your own risk under GPL v3


RomLab/pcb-system-for-underfloor-heating-v2.0
PCB for underfloor heating system


Motokichirou/gamma-spectrometer
NaI(Tl) gamma spectrometer: STM32G474 + R1307 PMT + 4-board stack, KiCad schematics, LTspice simulations



It measures 52 × 36 mm and has 2 copper layers, 1.6 mm thick.
36 parts, built around the PS2801-1, TL431, BAS516 and ES1D. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.
From the freudenthal/skidl-eda repository on GitHub, at the commit this page was made from: the board is canaries/lt3758_iso_flyback/lt3758_iso_flyback_manual.kicad_pcb. PCBKit opens the board in the browser, with nothing to install.
Its repository states no licence, so its author keeps all rights: ask freudenthal before reusing the design.