copperflow 0.3.4 → 0.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +107 -13
- package/dist/app/THIRD_PARTY_LICENSES.txt +5 -0
- package/dist/app/assets/NewPartDialog-BBJaZFCo.js +160 -0
- package/dist/app/assets/VerifyPartDialog-BHLqD_WJ.css +1 -0
- package/dist/app/assets/VerifyPartDialog-Ey6xpQ_U.js +2 -0
- package/dist/app/assets/index-BKoIKo22.css +1 -0
- package/dist/app/assets/index-DPmr2dR1.js +20 -0
- package/dist/app/assets/texture-worker-CyI_g_XZ.js +1 -0
- package/dist/app/index.html +2 -2
- package/dist/cli-commands.js +120 -16
- package/dist/cli-commands.js.map +1 -1
- package/dist/cli-impedance.d.ts +4 -0
- package/dist/cli-impedance.js +56 -0
- package/dist/cli-impedance.js.map +1 -0
- package/dist/cli-simulate.d.ts +3 -0
- package/dist/cli-simulate.js +54 -0
- package/dist/cli-simulate.js.map +1 -0
- package/dist/core/analyze.js +5 -2
- package/dist/core/analyze.js.map +1 -1
- package/dist/core/bom.d.ts +6 -1
- package/dist/core/bom.js +23 -4
- package/dist/core/bom.js.map +1 -1
- package/dist/core/case-results.d.ts +4 -0
- package/dist/core/case-results.js +9 -0
- package/dist/core/case-results.js.map +1 -0
- package/dist/core/change-files.d.ts +31 -0
- package/dist/core/change-files.js +67 -0
- package/dist/core/change-files.js.map +1 -0
- package/dist/core/change-render.d.ts +18 -0
- package/dist/core/change-render.js +48 -0
- package/dist/core/change-render.js.map +1 -0
- package/dist/core/change-view.d.ts +33 -0
- package/dist/core/change-view.js +73 -0
- package/dist/core/change-view.js.map +1 -0
- package/dist/core/change-words.d.ts +39 -0
- package/dist/core/change-words.js +214 -0
- package/dist/core/change-words.js.map +1 -0
- package/dist/core/checklist-text.d.ts +21 -0
- package/dist/core/checklist-text.js +59 -0
- package/dist/core/checklist-text.js.map +1 -0
- package/dist/core/edit.js +5 -2
- package/dist/core/edit.js.map +1 -1
- package/dist/core/fabrication.d.ts +9 -2
- package/dist/core/fabrication.js +29 -10
- package/dist/core/fabrication.js.map +1 -1
- package/dist/core/library.d.ts +46 -0
- package/dist/core/library.js +54 -16
- package/dist/core/library.js.map +1 -1
- package/dist/core/modules.d.ts +1 -0
- package/dist/core/modules.js +17 -0
- package/dist/core/modules.js.map +1 -1
- package/dist/core/order-report.d.ts +10 -0
- package/dist/core/order-report.js +93 -0
- package/dist/core/order-report.js.map +1 -0
- package/dist/core/pin-header.d.ts +5 -0
- package/dist/core/pin-header.js +77 -0
- package/dist/core/pin-header.js.map +1 -0
- package/dist/core/pin-map.d.ts +46 -0
- package/dist/core/pin-map.js +101 -0
- package/dist/core/pin-map.js.map +1 -0
- package/dist/core/render.d.ts +24 -4
- package/dist/core/render.js +16 -6
- package/dist/core/render.js.map +1 -1
- package/dist/core/sheet-card.d.ts +4 -0
- package/dist/core/sheet-card.js +46 -1
- package/dist/core/sheet-card.js.map +1 -1
- package/dist/core/sheet-files.js +10 -3
- package/dist/core/sheet-files.js.map +1 -1
- package/dist/core/simulate.d.ts +19 -0
- package/dist/core/simulate.js +72 -0
- package/dist/core/simulate.js.map +1 -0
- package/dist/core/step-export.d.ts +17 -0
- package/dist/core/step-export.js +35 -0
- package/dist/core/step-export.js.map +1 -0
- package/dist/core/supplier-prop.d.ts +6 -0
- package/dist/core/supplier-prop.js +21 -0
- package/dist/core/supplier-prop.js.map +1 -0
- package/dist/core/workspace.d.ts +2 -1
- package/dist/core/workspace.js +2 -1
- package/dist/core/workspace.js.map +1 -1
- package/dist/engine/board.js +3 -1
- package/dist/engine/board.js.map +1 -1
- package/dist/engine/checks/fast-lines.d.ts +60 -0
- package/dist/engine/checks/fast-lines.js +209 -0
- package/dist/engine/checks/fast-lines.js.map +1 -0
- package/dist/engine/checks/index.js +2 -0
- package/dist/engine/checks/index.js.map +1 -1
- package/dist/engine/design-diff.d.ts +120 -0
- package/dist/engine/design-diff.js +249 -0
- package/dist/engine/design-diff.js.map +1 -0
- package/dist/engine/design.d.ts +3 -0
- package/dist/engine/design.js +7 -2
- package/dist/engine/design.js.map +1 -1
- package/dist/engine/fab/export.d.ts +17 -1
- package/dist/engine/fab/export.js +26 -4
- package/dist/engine/fab/export.js.map +1 -1
- package/dist/engine/fab/names.d.ts +2 -2
- package/dist/engine/fab/names.js +4 -2
- package/dist/engine/fab/names.js.map +1 -1
- package/dist/engine/fab/picture/board-picture.d.ts +52 -0
- package/dist/engine/fab/picture/board-picture.js +102 -0
- package/dist/engine/fab/picture/board-picture.js.map +1 -0
- package/dist/engine/fab/picture/board-view.d.ts +20 -0
- package/dist/engine/fab/picture/board-view.js +50 -0
- package/dist/engine/fab/picture/board-view.js.map +1 -0
- package/dist/engine/fab/picture/compose.d.ts +50 -0
- package/dist/engine/fab/picture/compose.js +208 -0
- package/dist/engine/fab/picture/compose.js.map +1 -0
- package/dist/engine/fab/picture/layer-images.d.ts +9 -0
- package/dist/engine/fab/picture/layer-images.js +67 -0
- package/dist/engine/fab/picture/layer-images.js.map +1 -0
- package/dist/engine/fab/picture/looks.d.ts +152 -0
- package/dist/engine/fab/picture/looks.js +53 -0
- package/dist/engine/fab/picture/looks.js.map +1 -0
- package/dist/engine/fab/picture/png.d.ts +31 -0
- package/dist/engine/fab/picture/png.js +47 -0
- package/dist/engine/fab/picture/png.js.map +1 -0
- package/dist/engine/fab/picture/raster.d.ts +46 -0
- package/dist/engine/fab/picture/raster.js +170 -0
- package/dist/engine/fab/picture/raster.js.map +1 -0
- package/dist/engine/fab/zip.d.ts +2 -1
- package/dist/engine/fab/zip.js +1 -1
- package/dist/engine/fab/zip.js.map +1 -1
- package/dist/engine/impedance.d.ts +72 -0
- package/dist/engine/impedance.js +133 -0
- package/dist/engine/impedance.js.map +1 -0
- package/dist/engine/line-length.d.ts +15 -0
- package/dist/engine/line-length.js +116 -0
- package/dist/engine/line-length.js.map +1 -0
- package/dist/engine/model.d.ts +2 -0
- package/dist/engine/model.js.map +1 -1
- package/dist/engine/pcb-place/roles.d.ts +3 -1
- package/dist/engine/pcb-place/roles.js +5 -0
- package/dist/engine/pcb-place/roles.js.map +1 -1
- package/dist/engine/rules/impedance-widths.d.ts +20 -0
- package/dist/engine/rules/impedance-widths.js +57 -0
- package/dist/engine/rules/impedance-widths.js.map +1 -0
- package/dist/engine/rules/load.js +11 -2
- package/dist/engine/rules/load.js.map +1 -1
- package/dist/engine/rules/pairs.d.ts +27 -0
- package/dist/engine/rules/pairs.js +86 -0
- package/dist/engine/rules/pairs.js.map +1 -0
- package/dist/engine/rules/profiles.js +16 -0
- package/dist/engine/rules/profiles.js.map +1 -1
- package/dist/engine/rules/schema.d.ts +44 -0
- package/dist/engine/rules/schema.js +16 -1
- package/dist/engine/rules/schema.js.map +1 -1
- package/dist/engine/sim/answer.d.ts +13 -0
- package/dist/engine/sim/answer.js +101 -0
- package/dist/engine/sim/answer.js.map +1 -0
- package/dist/engine/sim/cases.d.ts +29 -0
- package/dist/engine/sim/cases.js +63 -0
- package/dist/engine/sim/cases.js.map +1 -0
- package/dist/engine/sim/devices.d.ts +109 -0
- package/dist/engine/sim/devices.js +137 -0
- package/dist/engine/sim/devices.js.map +1 -0
- package/dist/engine/sim/elements.d.ts +49 -0
- package/dist/engine/sim/elements.js +2 -0
- package/dist/engine/sim/elements.js.map +1 -0
- package/dist/engine/sim/from-circuit.d.ts +52 -0
- package/dist/engine/sim/from-circuit.js +354 -0
- package/dist/engine/sim/from-circuit.js.map +1 -0
- package/dist/engine/sim/limits.d.ts +12 -0
- package/dist/engine/sim/limits.js +79 -0
- package/dist/engine/sim/limits.js.map +1 -0
- package/dist/engine/sim/linear.d.ts +2 -0
- package/dist/engine/sim/linear.js +49 -0
- package/dist/engine/sim/linear.js.map +1 -0
- package/dist/engine/sim/model-schema.d.ts +246 -0
- package/dist/engine/sim/model-schema.js +115 -0
- package/dist/engine/sim/model-schema.js.map +1 -0
- package/dist/engine/sim/part-models.d.ts +47 -0
- package/dist/engine/sim/part-models.js +102 -0
- package/dist/engine/sim/part-models.js.map +1 -0
- package/dist/engine/sim/run.d.ts +14 -0
- package/dist/engine/sim/run.js +13 -0
- package/dist/engine/sim/run.js.map +1 -0
- package/dist/engine/sim/solve.d.ts +42 -0
- package/dist/engine/sim/solve.js +294 -0
- package/dist/engine/sim/solve.js.map +1 -0
- package/dist/engine/sim/spice.d.ts +5 -0
- package/dist/engine/sim/spice.js +66 -0
- package/dist/engine/sim/spice.js.map +1 -0
- package/dist/engine/sim/values.d.ts +4 -0
- package/dist/engine/sim/values.js +40 -0
- package/dist/engine/sim/values.js.map +1 -0
- package/dist/engine/solid/heights.d.ts +29 -0
- package/dist/engine/solid/heights.js +87 -0
- package/dist/engine/solid/heights.js.map +1 -0
- package/dist/engine/solid/limits.d.ts +7 -0
- package/dist/engine/solid/limits.js +20 -0
- package/dist/engine/solid/limits.js.map +1 -0
- package/dist/engine/solid/model.d.ts +54 -0
- package/dist/engine/solid/model.js +147 -0
- package/dist/engine/solid/model.js.map +1 -0
- package/dist/engine/solid/step.d.ts +5 -0
- package/dist/engine/solid/step.js +164 -0
- package/dist/engine/solid/step.js.map +1 -0
- package/dist/engine/solid/thickness.d.ts +11 -0
- package/dist/engine/solid/thickness.js +10 -0
- package/dist/engine/solid/thickness.js.map +1 -0
- package/dist/library/kicad/board.d.ts +26 -0
- package/dist/library/kicad/board.js +96 -0
- package/dist/library/kicad/board.js.map +1 -0
- package/dist/library/kicad/copper.d.ts +44 -0
- package/dist/library/kicad/copper.js +106 -0
- package/dist/library/kicad/copper.js.map +1 -0
- package/dist/library/kicad/footprints.d.ts +62 -0
- package/dist/library/kicad/footprints.js +184 -0
- package/dist/library/kicad/footprints.js.map +1 -0
- package/dist/library/kicad/geometry.d.ts +36 -0
- package/dist/library/kicad/geometry.js +84 -0
- package/dist/library/kicad/geometry.js.map +1 -0
- package/dist/library/kicad/import.d.ts +58 -0
- package/dist/library/kicad/import.js +240 -0
- package/dist/library/kicad/import.js.map +1 -0
- package/dist/library/kicad/plan.d.ts +40 -0
- package/dist/library/kicad/plan.js +139 -0
- package/dist/library/kicad/plan.js.map +1 -0
- package/dist/library/kicad/read.d.ts +30 -0
- package/dist/library/kicad/read.js +105 -0
- package/dist/library/kicad/read.js.map +1 -0
- package/dist/library/kicad/sexpr.d.ts +36 -0
- package/dist/library/kicad/sexpr.js +153 -0
- package/dist/library/kicad/sexpr.js.map +1 -0
- package/dist/library/kicad/tally.d.ts +32 -0
- package/dist/library/kicad/tally.js +55 -0
- package/dist/library/kicad/tally.js.map +1 -0
- package/dist/library/kicad/write.d.ts +37 -0
- package/dist/library/kicad/write.js +146 -0
- package/dist/library/kicad/write.js.map +1 -0
- package/dist/library/new-part.d.ts +2 -0
- package/dist/library/new-part.js +1 -0
- package/dist/library/new-part.js.map +1 -1
- package/dist/mcp/board-import-tool.d.ts +1 -1
- package/dist/mcp/board-import-tool.js +14 -4
- package/dist/mcp/board-import-tool.js.map +1 -1
- package/dist/mcp/copper-summary.d.ts +2 -0
- package/dist/mcp/copper-summary.js +4 -2
- package/dist/mcp/copper-summary.js.map +1 -1
- package/dist/mcp/create-part.d.ts +23 -0
- package/dist/mcp/create-part.js +1 -0
- package/dist/mcp/create-part.js.map +1 -1
- package/dist/mcp/fast-summary.d.ts +3 -0
- package/dist/mcp/fast-summary.js +46 -0
- package/dist/mcp/fast-summary.js.map +1 -0
- package/dist/mcp/render-tool.d.ts +33 -2
- package/dist/mcp/render-tool.js +21 -5
- package/dist/mcp/render-tool.js.map +1 -1
- package/dist/mcp/server.js +18 -8
- package/dist/mcp/server.js.map +1 -1
- package/dist/mcp/sheet-card-tools.d.ts +3 -1
- package/dist/mcp/sheet-card-tools.js +3 -1
- package/dist/mcp/sheet-card-tools.js.map +1 -1
- package/dist/mcp/simulate-tool.d.ts +10 -0
- package/dist/mcp/simulate-tool.js +12 -0
- package/dist/mcp/simulate-tool.js.map +1 -0
- package/dist/render/render.js +8113 -108
- package/dist/studio/change-route.d.ts +18 -0
- package/dist/studio/change-route.js +24 -0
- package/dist/studio/change-route.js.map +1 -0
- package/dist/studio/http-error.d.ts +5 -0
- package/dist/studio/http-error.js +9 -0
- package/dist/studio/http-error.js.map +1 -0
- package/dist/studio/live.d.ts +2 -0
- package/dist/studio/live.js.map +1 -1
- package/dist/studio/server.js +43 -15
- package/dist/studio/server.js.map +1 -1
- package/dist/studio/verify-routes.d.ts +42 -0
- package/dist/studio/verify-routes.js +110 -0
- package/dist/studio/verify-routes.js.map +1 -0
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/library/modules/CanNode/CanNode.sheet.tsx +1 -1
- package/library/modules/CanNode/parts/MCP2515-I-SO/MCP2515_I_SO.tsx +1 -0
- package/library/modules/CanNode/parts/MCP2515-I-SO/part.yaml +2 -0
- package/library/modules/CanNode/parts/MCP2515-I-SO/verification.md +2 -1
- package/library/modules/CanNode/parts/TJA1051T-3/TJA1051T_3.tsx +1 -0
- package/library/modules/CanNode/parts/TJA1051T-3/part.yaml +2 -0
- package/library/modules/CanNode/parts/TJA1051T-3/verification.md +2 -1
- package/library/modules/DigitalInput24V/DigitalInput24V.sheet.tsx +7 -7
- package/library/modules/RelayDriver/RelayDriver.sheet.tsx +3 -3
- package/library/modules/RelayDriver/parts/AO3400A/part.yaml +34 -0
- package/library/modules/RelayDriver/parts/AO3400A/verification.md +11 -1
- package/library/modules/RelayDriver/parts/SRD-12VDC-SL-C/SRD_12VDC_SL_C.tsx +1 -0
- package/library/modules/RelayDriver/parts/SRD-12VDC-SL-C/part.yaml +14 -0
- package/library/modules/RelayDriver/parts/SRD-12VDC-SL-C/verification.md +4 -1
- package/package.json +1 -1
- package/skills/copperflow/references/copper.md +8 -0
- package/skills/copperflow/references/design-rules.md +48 -0
- package/skills/copperflow/references/modules.md +26 -0
- package/skills/copperflow/references/writing-circuits.md +3 -0
- package/dist/app/assets/NewPartDialog-C4sKWnGI.js +0 -160
- package/dist/app/assets/index-BgzJedaB.css +0 -1
- package/dist/app/assets/index-C_U9me2P.js +0 -19
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
/** The thermal voltage kT/q at 300 K (27 °C), in volts. */
|
|
2
|
+
export declare const VT = 0.025852;
|
|
3
|
+
/** A diode's breakdown: `iz` flows at a reverse voltage of `vz`, rising e-fold every `nvt` volts beyond it. */
|
|
4
|
+
export interface Breakdown {
|
|
5
|
+
vz: number;
|
|
6
|
+
iz: number;
|
|
7
|
+
nvt: number;
|
|
8
|
+
}
|
|
9
|
+
/** A junction diode: Shockley's equation i = is (e^(v / (n VT)) - 1) behind a series resistance `rs`. */
|
|
10
|
+
export interface DiodeModel {
|
|
11
|
+
is: number;
|
|
12
|
+
n: number;
|
|
13
|
+
rs: number;
|
|
14
|
+
breakdown?: Breakdown;
|
|
15
|
+
}
|
|
16
|
+
export interface Curve {
|
|
17
|
+
i: number;
|
|
18
|
+
g: number;
|
|
19
|
+
}
|
|
20
|
+
/** The junction's current and slope at the junction voltage `v` (anode minus cathode, without `rs`). */
|
|
21
|
+
export declare function diodeCurve(model: DiodeModel, v: number): Curve;
|
|
22
|
+
/**
|
|
23
|
+
* The emission coefficient n and saturation current is from one point (vf at if, n given) or two (n from their
|
|
24
|
+
* slope). The series resistance rs, when given, is taken off each point first: the fitted curve meets every point.
|
|
25
|
+
*/
|
|
26
|
+
export declare function fitDiode(figures: {
|
|
27
|
+
vf: number;
|
|
28
|
+
vfAt: number;
|
|
29
|
+
vf2?: number;
|
|
30
|
+
vf2At?: number;
|
|
31
|
+
rs?: number;
|
|
32
|
+
n: number;
|
|
33
|
+
}): {
|
|
34
|
+
is: number;
|
|
35
|
+
n: number;
|
|
36
|
+
rs: number;
|
|
37
|
+
};
|
|
38
|
+
/** A MOSFET's square law, fitted so that the on-resistance at the datasheet's gate voltage is the datasheet's. */
|
|
39
|
+
export interface MosModel {
|
|
40
|
+
/** The threshold, as a positive voltage for either channel. */
|
|
41
|
+
vth: number;
|
|
42
|
+
/** The square law's factor k in A/V²: id = k ((vgs - vth) vds - vds² / 2) below saturation. */
|
|
43
|
+
k: number;
|
|
44
|
+
/** The gate voltage at which the datasheet gives its on-resistance: at or above it the switch is fully on. */
|
|
45
|
+
vgsOn: number;
|
|
46
|
+
body: DiodeModel;
|
|
47
|
+
}
|
|
48
|
+
/** k from rds(on) at vgs: in the linear region near vds = 0 the channel's resistance is 1 / (k (vgs - vth)). */
|
|
49
|
+
export declare function fitMos(figures: {
|
|
50
|
+
vth: number;
|
|
51
|
+
rdson: number;
|
|
52
|
+
rdsonAt: number;
|
|
53
|
+
}): number;
|
|
54
|
+
export interface MosPoint {
|
|
55
|
+
id: number;
|
|
56
|
+
/** d id / d vgs and d id / d vds. */
|
|
57
|
+
gm: number;
|
|
58
|
+
gds: number;
|
|
59
|
+
region: "off" | "linear" | "saturation";
|
|
60
|
+
}
|
|
61
|
+
/** The drain current of an N channel (positive voltages) at vgs and vds >= 0. */
|
|
62
|
+
export declare function mosCurve(model: MosModel, vgs: number, vds: number): MosPoint;
|
|
63
|
+
/** A bipolar transistor in the Ebers-Moll transport form, with saturation current is and gains bf and br. */
|
|
64
|
+
export interface BjtModel {
|
|
65
|
+
is: number;
|
|
66
|
+
bf: number;
|
|
67
|
+
br: number;
|
|
68
|
+
}
|
|
69
|
+
export interface BjtPoint {
|
|
70
|
+
ic: number;
|
|
71
|
+
ib: number;
|
|
72
|
+
/** Partial derivatives of ic and ib by vbe and vbc. */
|
|
73
|
+
dic: {
|
|
74
|
+
be: number;
|
|
75
|
+
bc: number;
|
|
76
|
+
};
|
|
77
|
+
dib: {
|
|
78
|
+
be: number;
|
|
79
|
+
bc: number;
|
|
80
|
+
};
|
|
81
|
+
}
|
|
82
|
+
/** NPN currents into the collector and the base at vbe and vbc. */
|
|
83
|
+
export declare function bjtCurve(model: BjtModel, vbe: number, vbc: number): BjtPoint;
|
|
84
|
+
/** The forced gain at which a datasheet usually states vce(sat): ic / ib = 10. */
|
|
85
|
+
export declare const FORCED_GAIN = 10;
|
|
86
|
+
/** vce(sat) of the transport model at the forced gain: VT ln((1 / alphaR + forced / br) / (1 - forced / bf)). */
|
|
87
|
+
export declare function vceSat(bf: number, br: number, forced?: number): number;
|
|
88
|
+
/**
|
|
89
|
+
* is from vbe at ic (the transport current, n = 1), bf = hfe, and br found by bisection so that vce(sat) at the
|
|
90
|
+
* forced gain is the datasheet's; without vcesat, br = 1.
|
|
91
|
+
*/
|
|
92
|
+
export declare function fitBjt(figures: {
|
|
93
|
+
hfe: number;
|
|
94
|
+
vbe: number;
|
|
95
|
+
vbeAt: number;
|
|
96
|
+
vcesat?: number;
|
|
97
|
+
}): BjtModel;
|
|
98
|
+
/** The junction voltage beyond which a step is limited: n VT ln(n VT / (√2 is)). */
|
|
99
|
+
export declare function criticalVoltage(model: {
|
|
100
|
+
is: number;
|
|
101
|
+
n: number;
|
|
102
|
+
}): number;
|
|
103
|
+
/**
|
|
104
|
+
* The step of a junction voltage from `previous` to `next` with large forward steps taken on a logarithm, as the
|
|
105
|
+
* textbook's limiting does, so Newton's method does not overshoot an exponential.
|
|
106
|
+
*/
|
|
107
|
+
export declare function limitJunction(next: number, previous: number, nvt: number, critical: number): number;
|
|
108
|
+
/** The largest change of a MOSFET's gate voltage in one Newton step. */
|
|
109
|
+
export declare const GATE_STEP = 1;
|
|
@@ -0,0 +1,137 @@
|
|
|
1
|
+
// The device equations of the DC solver and how each is fitted to datasheet figures. The method is the textbook's:
|
|
2
|
+
// F. N. Najm, "Circuit Simulation", Wiley 2010 (ch. 2 for nodal analysis, ch. 3 for Newton's method and the limiting
|
|
3
|
+
// of junction voltage steps). Every model is a static curve i = f(v) with its slope, evaluated at 300 K.
|
|
4
|
+
/** The thermal voltage kT/q at 300 K (27 °C), in volts. */
|
|
5
|
+
export const VT = 0.025852;
|
|
6
|
+
/** Above this exponent a junction's exponential is continued as a straight line, so nothing overflows. */
|
|
7
|
+
const EXP_LIMIT = 60;
|
|
8
|
+
/** e^x and its slope, continued linearly above EXP_LIMIT. */
|
|
9
|
+
function expLimited(x) {
|
|
10
|
+
if (x <= EXP_LIMIT) {
|
|
11
|
+
const value = Math.exp(x);
|
|
12
|
+
return { value, slope: value };
|
|
13
|
+
}
|
|
14
|
+
const top = Math.exp(EXP_LIMIT);
|
|
15
|
+
return { value: top * (1 + x - EXP_LIMIT), slope: top };
|
|
16
|
+
}
|
|
17
|
+
/** The junction's current and slope at the junction voltage `v` (anode minus cathode, without `rs`). */
|
|
18
|
+
export function diodeCurve(model, v) {
|
|
19
|
+
const nvt = model.n * VT;
|
|
20
|
+
const forward = expLimited(v / nvt);
|
|
21
|
+
let i = model.is * (forward.value - 1);
|
|
22
|
+
let g = (model.is * forward.slope) / nvt;
|
|
23
|
+
const b = model.breakdown;
|
|
24
|
+
if (b) {
|
|
25
|
+
// Zero at 0 V and exactly iz at -vz: the offset e^(-vz / nvt) is taken out and the rest scaled back.
|
|
26
|
+
const floor = Math.exp(-b.vz / b.nvt);
|
|
27
|
+
const reverse = expLimited((-v - b.vz) / b.nvt);
|
|
28
|
+
const scale = b.iz / (1 - floor);
|
|
29
|
+
i -= scale * (reverse.value - floor);
|
|
30
|
+
g += (scale * reverse.slope) / b.nvt;
|
|
31
|
+
}
|
|
32
|
+
return { i, g: g + 1e-15 };
|
|
33
|
+
}
|
|
34
|
+
/**
|
|
35
|
+
* The emission coefficient n and saturation current is from one point (vf at if, n given) or two (n from their
|
|
36
|
+
* slope). The series resistance rs, when given, is taken off each point first: the fitted curve meets every point.
|
|
37
|
+
*/
|
|
38
|
+
export function fitDiode(figures) {
|
|
39
|
+
const rs = figures.rs ?? 0;
|
|
40
|
+
const v1 = figures.vf - figures.vfAt * rs;
|
|
41
|
+
let n = figures.n;
|
|
42
|
+
if (figures.vf2 !== undefined && figures.vf2At !== undefined) {
|
|
43
|
+
const v2 = figures.vf2 - figures.vf2At * rs;
|
|
44
|
+
n = (v2 - v1) / (VT * Math.log(figures.vf2At / figures.vfAt));
|
|
45
|
+
}
|
|
46
|
+
if (!(n > 0) || !Number.isFinite(n))
|
|
47
|
+
throw new Error("the two forward points do not rise together; check vf, vfAt, vf2 and vf2At");
|
|
48
|
+
const is = figures.vfAt / Math.expm1(v1 / (n * VT));
|
|
49
|
+
return { is, n, rs };
|
|
50
|
+
}
|
|
51
|
+
/** k from rds(on) at vgs: in the linear region near vds = 0 the channel's resistance is 1 / (k (vgs - vth)). */
|
|
52
|
+
export function fitMos(figures) {
|
|
53
|
+
const overdrive = figures.rdsonAt - figures.vth;
|
|
54
|
+
if (!(overdrive > 0))
|
|
55
|
+
throw new Error(`rdsonAt (${figures.rdsonAt} V) must be above vth (${figures.vth} V)`);
|
|
56
|
+
return 1 / (figures.rdson * overdrive);
|
|
57
|
+
}
|
|
58
|
+
/** The drain current of an N channel (positive voltages) at vgs and vds >= 0. */
|
|
59
|
+
export function mosCurve(model, vgs, vds) {
|
|
60
|
+
const over = vgs - model.vth;
|
|
61
|
+
if (over <= 0)
|
|
62
|
+
return { id: 0, gm: 0, gds: 0, region: "off" };
|
|
63
|
+
if (vds < over)
|
|
64
|
+
return { id: model.k * (over * vds - (vds * vds) / 2), gm: model.k * vds, gds: model.k * (over - vds), region: "linear" };
|
|
65
|
+
return { id: (model.k / 2) * over * over, gm: model.k * over, gds: 0, region: "saturation" };
|
|
66
|
+
}
|
|
67
|
+
/** NPN currents into the collector and the base at vbe and vbc. */
|
|
68
|
+
export function bjtCurve(model, vbe, vbc) {
|
|
69
|
+
const fe = expLimited(vbe / VT);
|
|
70
|
+
const fc = expLimited(vbc / VT);
|
|
71
|
+
const transport = model.is * (fe.value - fc.value);
|
|
72
|
+
const ibe = (model.is / model.bf) * (fe.value - 1);
|
|
73
|
+
const ibc = (model.is / model.br) * (fc.value - 1);
|
|
74
|
+
const gbe = (model.is * fe.slope) / VT;
|
|
75
|
+
const gbc = (model.is * fc.slope) / VT;
|
|
76
|
+
return {
|
|
77
|
+
ic: transport - ibc,
|
|
78
|
+
ib: ibe + ibc,
|
|
79
|
+
dic: { be: gbe, bc: -gbc - gbc / model.br },
|
|
80
|
+
dib: { be: gbe / model.bf, bc: gbc / model.br },
|
|
81
|
+
};
|
|
82
|
+
}
|
|
83
|
+
/** The forced gain at which a datasheet usually states vce(sat): ic / ib = 10. */
|
|
84
|
+
export const FORCED_GAIN = 10;
|
|
85
|
+
/** vce(sat) of the transport model at the forced gain: VT ln((1 / alphaR + forced / br) / (1 - forced / bf)). */
|
|
86
|
+
export function vceSat(bf, br, forced = FORCED_GAIN) {
|
|
87
|
+
const alphaR = br / (1 + br);
|
|
88
|
+
return VT * Math.log((1 / alphaR + forced / br) / (1 - forced / bf));
|
|
89
|
+
}
|
|
90
|
+
/**
|
|
91
|
+
* is from vbe at ic (the transport current, n = 1), bf = hfe, and br found by bisection so that vce(sat) at the
|
|
92
|
+
* forced gain is the datasheet's; without vcesat, br = 1.
|
|
93
|
+
*/
|
|
94
|
+
export function fitBjt(figures) {
|
|
95
|
+
if (!(figures.hfe > FORCED_GAIN))
|
|
96
|
+
throw new Error(`hfe must be above ${FORCED_GAIN}`);
|
|
97
|
+
const is = figures.vbeAt / Math.exp(figures.vbe / VT);
|
|
98
|
+
if (figures.vcesat === undefined)
|
|
99
|
+
return { is, bf: figures.hfe, br: 1 };
|
|
100
|
+
// vce(sat) falls as br rises; search br on a log scale between 0.01 and 1000.
|
|
101
|
+
let low = Math.log(0.01);
|
|
102
|
+
let high = Math.log(1000);
|
|
103
|
+
const at = (logBr) => vceSat(figures.hfe, Math.exp(logBr));
|
|
104
|
+
if (figures.vcesat >= at(low))
|
|
105
|
+
return { is, bf: figures.hfe, br: 0.01 };
|
|
106
|
+
if (figures.vcesat <= at(high))
|
|
107
|
+
return { is, bf: figures.hfe, br: 1000 };
|
|
108
|
+
for (let step = 0; step < 80; step++) {
|
|
109
|
+
const mid = (low + high) / 2;
|
|
110
|
+
if (at(mid) > figures.vcesat)
|
|
111
|
+
low = mid;
|
|
112
|
+
else
|
|
113
|
+
high = mid;
|
|
114
|
+
}
|
|
115
|
+
return { is, bf: figures.hfe, br: Math.exp((low + high) / 2) };
|
|
116
|
+
}
|
|
117
|
+
/** The junction voltage beyond which a step is limited: n VT ln(n VT / (√2 is)). */
|
|
118
|
+
export function criticalVoltage(model) {
|
|
119
|
+
const nvt = model.n * VT;
|
|
120
|
+
return nvt * Math.log(nvt / (Math.SQRT2 * model.is));
|
|
121
|
+
}
|
|
122
|
+
/**
|
|
123
|
+
* The step of a junction voltage from `previous` to `next` with large forward steps taken on a logarithm, as the
|
|
124
|
+
* textbook's limiting does, so Newton's method does not overshoot an exponential.
|
|
125
|
+
*/
|
|
126
|
+
export function limitJunction(next, previous, nvt, critical) {
|
|
127
|
+
if (next <= critical || Math.abs(next - previous) <= 2 * nvt)
|
|
128
|
+
return next;
|
|
129
|
+
if (previous > 0) {
|
|
130
|
+
const arg = 1 + (next - previous) / nvt;
|
|
131
|
+
return arg > 0 ? previous + nvt * Math.log(arg) : critical;
|
|
132
|
+
}
|
|
133
|
+
return nvt * Math.log(next / nvt);
|
|
134
|
+
}
|
|
135
|
+
/** The largest change of a MOSFET's gate voltage in one Newton step. */
|
|
136
|
+
export const GATE_STEP = 1;
|
|
137
|
+
//# sourceMappingURL=devices.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"devices.js","sourceRoot":"","sources":["../../../src/engine/sim/devices.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
import type { BjtModel, DiodeModel, MosModel } from "./devices.js";
|
|
2
|
+
/** A set net: an ideal voltage source from `node` to the reference. */
|
|
3
|
+
export interface Source {
|
|
4
|
+
name: string;
|
|
5
|
+
node: number;
|
|
6
|
+
volts: number;
|
|
7
|
+
}
|
|
8
|
+
export type Element = {
|
|
9
|
+
kind: "resistor";
|
|
10
|
+
part: string;
|
|
11
|
+
a: number;
|
|
12
|
+
b: number;
|
|
13
|
+
ohms: number;
|
|
14
|
+
} | {
|
|
15
|
+
kind: "diode";
|
|
16
|
+
part: string;
|
|
17
|
+
anode: number;
|
|
18
|
+
cathode: number;
|
|
19
|
+
model: DiodeModel;
|
|
20
|
+
} | {
|
|
21
|
+
kind: "mos";
|
|
22
|
+
part: string;
|
|
23
|
+
drain: number;
|
|
24
|
+
gate: number;
|
|
25
|
+
source: number;
|
|
26
|
+
polarity: 1 | -1;
|
|
27
|
+
model: MosModel;
|
|
28
|
+
} | {
|
|
29
|
+
kind: "bjt";
|
|
30
|
+
part: string;
|
|
31
|
+
collector: number;
|
|
32
|
+
base: number;
|
|
33
|
+
emitter: number;
|
|
34
|
+
polarity: 1 | -1;
|
|
35
|
+
model: BjtModel;
|
|
36
|
+
}
|
|
37
|
+
/** A pin that draws `amps` into the part, from `node` to the reference. */
|
|
38
|
+
| {
|
|
39
|
+
kind: "load";
|
|
40
|
+
part: string;
|
|
41
|
+
node: number;
|
|
42
|
+
amps: number;
|
|
43
|
+
};
|
|
44
|
+
export interface SimCircuit {
|
|
45
|
+
/** Node names; node k is `nodes[k - 1]`. */
|
|
46
|
+
nodes: string[];
|
|
47
|
+
sources: Source[];
|
|
48
|
+
elements: Element[];
|
|
49
|
+
}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"elements.js","sourceRoot":"","sources":["../../../src/engine/sim/elements.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
import type { Circuit } from "../model.js";
|
|
2
|
+
import type { SimCircuit } from "./elements.js";
|
|
3
|
+
import type { Model, ModelKind } from "./model-schema.js";
|
|
4
|
+
import { type PartFigures } from "./part-models.js";
|
|
5
|
+
export interface SimRequest {
|
|
6
|
+
/** Net name to volts, or "open" to leave it floating. */
|
|
7
|
+
set: Readonly<Record<string, number | "open">>;
|
|
8
|
+
/** Switches, jumpers and push buttons that are closed. */
|
|
9
|
+
closed?: readonly string[];
|
|
10
|
+
/** Relays whose coil is energised: their contacts are as when it is. */
|
|
11
|
+
coil?: readonly string[];
|
|
12
|
+
}
|
|
13
|
+
/** A modelled part: its elements by index, its limits and the figures that were assumed. */
|
|
14
|
+
export interface SimPart {
|
|
15
|
+
name: string;
|
|
16
|
+
kind: ModelKind | "resistor" | "relay";
|
|
17
|
+
/** The element whose voltage and current are the part's; the others add their power. */
|
|
18
|
+
main: number;
|
|
19
|
+
elements: number[];
|
|
20
|
+
assumed: string[];
|
|
21
|
+
figures: PartFigures["figures"];
|
|
22
|
+
footprint?: string;
|
|
23
|
+
}
|
|
24
|
+
export interface Unmodelled {
|
|
25
|
+
part: string;
|
|
26
|
+
kind: string;
|
|
27
|
+
/** The part's power and ground pins with their nodes. */
|
|
28
|
+
power: {
|
|
29
|
+
pin: string;
|
|
30
|
+
node: number;
|
|
31
|
+
}[];
|
|
32
|
+
}
|
|
33
|
+
export interface Built {
|
|
34
|
+
sim: SimCircuit;
|
|
35
|
+
parts: SimPart[];
|
|
36
|
+
unmodelled: Unmodelled[];
|
|
37
|
+
/** Every net name and the node it is on. */
|
|
38
|
+
netNodes: Map<string, number>;
|
|
39
|
+
/** The nodes no element path reaches from a set net. Node numbers: named groups first, in natural order. */
|
|
40
|
+
floating: Set<number>;
|
|
41
|
+
capacitors: {
|
|
42
|
+
part: string;
|
|
43
|
+
a: number;
|
|
44
|
+
b: number;
|
|
45
|
+
rating?: number;
|
|
46
|
+
}[];
|
|
47
|
+
}
|
|
48
|
+
export type BuildResult = Built | {
|
|
49
|
+
refused: string[];
|
|
50
|
+
};
|
|
51
|
+
/** The solver's circuit for `circuit` with the request's sources, or the reasons it cannot be run. */
|
|
52
|
+
export declare function buildSimCircuit(circuit: Circuit, models: ReadonlyMap<string, Model>, request: SimRequest): BuildResult;
|