dsh-stm32 0.1.7 → 0.1.9
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 +567 -516
- package/README_EN.md +544 -510
- package/client/client.js +7033 -682
- package/docs/reading-guide.md +921 -859
- package/lib/client.js +7033 -682
- package/lib/commands/register.js +2 -0
- package/lib/data/firmware-packages.js +35 -0
- package/lib/data/firmware-pins.js +7 -0
- package/lib/data/install-guides.js +110 -0
- package/lib/data/ioc-presets.js +118 -0
- package/lib/engine/artifacts.js +123 -0
- package/lib/engine/breakpoint-hits.js +73 -0
- package/lib/engine/build.js +161 -5
- package/lib/engine/channel-tap.js +227 -0
- package/lib/engine/channels.js +48 -0
- package/lib/engine/clocks.js +192 -0
- package/lib/engine/datasheet/auto.js +74 -0
- package/lib/engine/datasheet/digest.js +74 -0
- package/lib/engine/datasheet/lcsc.js +60 -0
- package/lib/engine/datasheet/pinout.js +119 -0
- package/lib/engine/datasheet/price.js +152 -0
- package/lib/engine/datasheet/search.js +147 -0
- package/lib/engine/datasheet/store.js +371 -0
- package/lib/engine/debug-session.js +48 -2
- package/lib/engine/ecad/autobuild.js +156 -0
- package/lib/engine/ecad/bom.js +238 -0
- package/lib/engine/ecad/brief.js +205 -0
- package/lib/engine/ecad/checks.js +239 -0
- package/lib/engine/ecad/design.js +177 -0
- package/lib/engine/ecad/dfm.js +314 -0
- package/lib/engine/ecad/easyeda.js +454 -0
- package/lib/engine/ecad/fabrication.js +104 -0
- package/lib/engine/ecad/gen/footprint.js +159 -0
- package/lib/engine/ecad/gen/symbol.js +103 -0
- package/lib/engine/ecad/import.js +372 -0
- package/lib/engine/ecad/jlcpcb.js +141 -0
- package/lib/engine/ecad/libs.js +316 -0
- package/lib/engine/ecad/models3d.js +89 -0
- package/lib/engine/ecad/netgate.js +286 -0
- package/lib/engine/ecad/normalize.js +182 -0
- package/lib/engine/ecad/package.js +126 -0
- package/lib/engine/ecad/padmerge.js +128 -0
- package/lib/engine/ecad/padprecheck.js +123 -0
- package/lib/engine/ecad/part-import.js +257 -0
- package/lib/engine/ecad/pcb/apply.js +53 -0
- package/lib/engine/ecad/pcb/emc-deep.js +396 -0
- package/lib/engine/ecad/pcb/emc.js +275 -0
- package/lib/engine/ecad/pcb/geometry.js +63 -0
- package/lib/engine/ecad/pcb/gerber.js +499 -0
- package/lib/engine/ecad/pcb/hand-sync.js +242 -0
- package/lib/engine/ecad/pcb/impedance.js +119 -0
- package/lib/engine/ecad/pcb/ipc-open.js +78 -0
- package/lib/engine/ecad/pcb/ipc-script.js +276 -0
- package/lib/engine/ecad/pcb/ipc.js +129 -0
- package/lib/engine/ecad/pcb/krt.js +182 -0
- package/lib/engine/ecad/pcb/links.js +393 -0
- package/lib/engine/ecad/pcb/mech.js +201 -0
- package/lib/engine/ecad/pcb/model-fix.js +178 -0
- package/lib/engine/ecad/pcb/netlist.js +146 -0
- package/lib/engine/ecad/pcb/pcb-svg.js +199 -0
- package/lib/engine/ecad/pcb/placement.js +140 -0
- package/lib/engine/ecad/pcb/power.js +203 -0
- package/lib/engine/ecad/pcb/render3d.js +208 -0
- package/lib/engine/ecad/pcb/route.js +167 -0
- package/lib/engine/ecad/pcb/router.js +469 -0
- package/lib/engine/ecad/pcb/rules.js +122 -0
- package/lib/engine/ecad/pcb/scene.js +513 -0
- package/lib/engine/ecad/pcb/stackup.js +154 -0
- package/lib/engine/ecad/pcb/swap.js +222 -0
- package/lib/engine/ecad/pcb/tracks.js +70 -0
- package/lib/engine/ecad/runtime.js +227 -0
- package/lib/engine/ecad/toolchain.js +146 -0
- package/lib/engine/ecad/tsci.js +362 -0
- package/lib/engine/ecad/zip.js +98 -0
- package/lib/engine/event-bus.js +158 -0
- package/lib/engine/event-log.js +335 -0
- package/lib/engine/fault-hints.js +146 -0
- package/lib/engine/generate-script.js +4 -1
- package/lib/engine/generate.js +145 -5
- package/lib/engine/interrupts.js +247 -0
- package/lib/engine/ioc-diff.js +369 -0
- package/lib/engine/ioc-plan.js +12 -2
- package/lib/engine/ioc-sync.js +58 -0
- package/lib/engine/mcu-info.js +134 -0
- package/lib/engine/msys2-install.js +31 -6
- package/lib/engine/panel-actions.js +103 -0
- package/lib/engine/pdf/curve.js +321 -0
- package/lib/engine/pdf/png.js +83 -0
- package/lib/engine/pdf/reader.js +336 -0
- package/lib/engine/pdf/schematic.js +93 -0
- package/lib/engine/pdf/tables.js +249 -0
- package/lib/engine/pdf/toolchain.js +50 -0
- package/lib/engine/pinout.js +140 -0
- package/lib/engine/probe-info.js +95 -0
- package/lib/engine/probe.js +45 -0
- package/lib/engine/progress.js +99 -0
- package/lib/engine/project-conf.js +254 -0
- package/lib/engine/project-layout.js +198 -0
- package/lib/engine/project-repair.js +205 -0
- package/lib/engine/schematic/checks.js +153 -0
- package/lib/engine/schematic/draw.js +390 -0
- package/lib/engine/schematic/edit.js +229 -0
- package/lib/engine/schematic/kicad-sch.js +225 -0
- package/lib/engine/schematic/model.js +442 -0
- package/lib/engine/schematic/nets.js +219 -0
- package/lib/engine/schematic/pcb.js +144 -0
- package/lib/engine/schematic/review.js +134 -0
- package/lib/engine/schematic/sexpr.js +134 -0
- package/lib/engine/schematic/to-ioc.js +197 -0
- package/lib/engine/schematic/transform.js +25 -0
- package/lib/engine/session-context.js +106 -0
- package/lib/engine/source-slice.js +59 -0
- package/lib/engine/tool-events.js +119 -0
- package/lib/engine/toolchain-gate.js +8 -0
- package/lib/engine/watch-admin.js +101 -0
- package/lib/engine/watch-record.js +39 -0
- package/lib/engine/watch-recorder.js +116 -0
- package/lib/engine/web-api.js +1123 -4
- package/lib/engine/web-routes.js +18 -1
- package/lib/engine/workspace-memo.js +41 -0
- package/lib/index.js +118 -24
- package/lib/skill/stm32-workflow.js +1 -1
- package/lib/tools/build.js +10 -2
- package/lib/tools/code-patch.js +2 -2
- package/lib/tools/datasheet.js +447 -0
- package/lib/tools/debug-session.js +9 -4
- package/lib/tools/debug.js +2 -2
- package/lib/tools/doctor.js +2 -2
- package/lib/tools/ecad.js +903 -0
- package/lib/tools/flash.js +2 -2
- package/lib/tools/gen.js +166 -0
- package/lib/tools/generate.js +7 -5
- package/lib/tools/import-circuit.js +146 -0
- package/lib/tools/ioc-apply.js +11 -2
- package/lib/tools/ioc-inspect.js +2 -2
- package/lib/tools/ioc-plan.js +2 -2
- package/lib/tools/ioc-verify.js +2 -2
- package/lib/tools/layout.js +92 -0
- package/lib/tools/mcu-info.js +163 -0
- package/lib/tools/part-import.js +182 -0
- package/lib/tools/pcb.js +2316 -0
- package/lib/tools/pdf.js +423 -0
- package/lib/tools/project-create.js +28 -0
- package/lib/tools/project-dir.js +25 -1
- package/lib/tools/regs.js +2 -2
- package/lib/tools/route-plan.js +2 -2
- package/lib/tools/rtt.js +10 -2
- package/lib/tools/sch-draw.js +433 -0
- package/lib/tools/sch-edit.js +145 -0
- package/lib/tools/schematic.js +817 -0
- package/lib/tools/serial.js +22 -0
- package/lib/tools/watch.js +24 -2
- package/package.json +1 -1
|
@@ -0,0 +1,393 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 布线进阶体检(S165):差分对、平面层、去耦距离。
|
|
3
|
+
*
|
|
4
|
+
* 三件事都只回答「板子上现在是什么样」,不改板子:
|
|
5
|
+
*
|
|
6
|
+
* 1. 差分对:按网络名认出成对的网络,算两条线的长度、过孔数、长度差;
|
|
7
|
+
* 2. 平面层:每层是否有铺铜、上面还有多少条信号线(平面被割裂的直接证据);
|
|
8
|
+
* 3. 去耦距离:两脚电容的电源脚到同网络最近引脚的距离。
|
|
9
|
+
*
|
|
10
|
+
* 认不出成对网络、板上没有电容、没有铺铜层,都如实说「没有」,不猜、不补零。
|
|
11
|
+
*/
|
|
12
|
+
import { readFileSync } from "node:fs";
|
|
13
|
+
import { parenBlocks } from "./emc.js";
|
|
14
|
+
import { inferVoltage } from "./power.js";
|
|
15
|
+
const EMPTY = {
|
|
16
|
+
ok: false,
|
|
17
|
+
error: "",
|
|
18
|
+
boardFile: "",
|
|
19
|
+
copperLayers: 0,
|
|
20
|
+
pairs: [],
|
|
21
|
+
decaps: [],
|
|
22
|
+
planes: [],
|
|
23
|
+
findings: [],
|
|
24
|
+
notes: [],
|
|
25
|
+
};
|
|
26
|
+
/** 读一块板并做三项体检。读不到或读不懂都回 `ok:false`,不抛。 */
|
|
27
|
+
export function readLinks(boardFile, options = {}) {
|
|
28
|
+
let text = "";
|
|
29
|
+
try {
|
|
30
|
+
text = readFileSync(boardFile, "utf8");
|
|
31
|
+
}
|
|
32
|
+
catch (error) {
|
|
33
|
+
return { ...EMPTY, boardFile, error: "读不到板子文件:" + (error instanceof Error ? error.message : String(error)) };
|
|
34
|
+
}
|
|
35
|
+
return analyzeLinks(text, boardFile, options);
|
|
36
|
+
}
|
|
37
|
+
export function analyzeLinks(pcbText, boardFile, options = {}) {
|
|
38
|
+
const toleranceMm = options.toleranceMm ?? 0.5;
|
|
39
|
+
const decapLimitMm = options.decapMm ?? 5;
|
|
40
|
+
let parsed;
|
|
41
|
+
try {
|
|
42
|
+
parsed = parseBoard(pcbText);
|
|
43
|
+
}
|
|
44
|
+
catch (error) {
|
|
45
|
+
return { ...EMPTY, boardFile, error: "读不懂这个 .kicad_pcb:" + (error instanceof Error ? error.message : String(error)) };
|
|
46
|
+
}
|
|
47
|
+
const pairs = analyzePairs(parsed, toleranceMm);
|
|
48
|
+
const decaps = analyzeDecaps(parsed, decapLimitMm);
|
|
49
|
+
const planes = analyzePlanes(parsed);
|
|
50
|
+
const findings = [];
|
|
51
|
+
for (const pair of pairs) {
|
|
52
|
+
if (!pair.ok && (!pair.routedP || !pair.routedN)) {
|
|
53
|
+
findings.push({
|
|
54
|
+
id: "pair.not-routed",
|
|
55
|
+
severity: "warning",
|
|
56
|
+
message: pair.id + ":还有一半没布线(" + (pair.routedP ? pair.negative : pair.positive) + " 没有走线)",
|
|
57
|
+
fix: "跑一次 stm32_pcb_autoroute,或在 KiCad 里手工补这一半。",
|
|
58
|
+
});
|
|
59
|
+
}
|
|
60
|
+
else if (!pair.ok) {
|
|
61
|
+
findings.push({
|
|
62
|
+
id: "pair.length-skew",
|
|
63
|
+
severity: "warning",
|
|
64
|
+
message: pair.id + ":两条线相差 " + pair.deltaMm.toFixed(2) + " mm(上限 " + String(toleranceMm) + " mm)",
|
|
65
|
+
fix: "在 KiCad 里对短线做蛇形补偿,或把差分对当普通网络重新布。",
|
|
66
|
+
});
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
for (const plane of planes) {
|
|
70
|
+
if (plane.planeNets.length > 0 && plane.trackCount > 0) {
|
|
71
|
+
findings.push({
|
|
72
|
+
id: "plane.signals-on-plane-layer",
|
|
73
|
+
severity: "warning",
|
|
74
|
+
message: plane.layer + " 铺了 " + plane.planeNets.join("、") + " 平面,但这一层还有 " + String(plane.trackCount) + " 段信号线",
|
|
75
|
+
fix: "信号改走外层或另开信号层;平面被割得越碎,回流越绕。",
|
|
76
|
+
});
|
|
77
|
+
}
|
|
78
|
+
}
|
|
79
|
+
const innerSignalOnly = planes.filter((plane) => plane.planeNets.length === 0 && plane.trackCount > 0);
|
|
80
|
+
if (parsed.copperLayers >= 4 && planes.every((plane) => plane.planeNets.length === 0)) {
|
|
81
|
+
findings.push({
|
|
82
|
+
id: "plane.no-inner-pour",
|
|
83
|
+
severity: "warning",
|
|
84
|
+
message: "四层以上的板,内层一段铺铜都没有" + (innerSignalOnly.length > 0 ? "(内层全在走信号)" : ""),
|
|
85
|
+
fix: "至少把一层内层铺成 GND 平面;没有参考平面的四层板等于四层信号板。",
|
|
86
|
+
});
|
|
87
|
+
}
|
|
88
|
+
for (const decap of decaps) {
|
|
89
|
+
if (!decap.ok) {
|
|
90
|
+
findings.push({
|
|
91
|
+
id: "decap.too-far",
|
|
92
|
+
severity: "info",
|
|
93
|
+
message: decap.ref + " 的 " + decap.powerNet + " 脚离最近的负载引脚 " + decap.distanceMm.toFixed(2) + " mm(建议 ≤ " + String(decapLimitMm) + " mm)",
|
|
94
|
+
fix: "把电容挪到引脚旁边,或让电源先从电容经过再进引脚。",
|
|
95
|
+
});
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
const notes = [];
|
|
99
|
+
if (pairs.length === 0)
|
|
100
|
+
notes.push("没有认出差分对:网络名里没有 _P/_N、+/-、DP/DM、CANH/CANL 这类成对后缀。");
|
|
101
|
+
if (decaps.length === 0)
|
|
102
|
+
notes.push("没有找到两脚去耦电容:需要一个脚在 GND、另一个脚在电源网络上的两脚元件。");
|
|
103
|
+
if (planes.every((plane) => plane.planeNets.length === 0))
|
|
104
|
+
notes.push("板上没有任何铺铜区:平面层体检无对象。");
|
|
105
|
+
return {
|
|
106
|
+
ok: true,
|
|
107
|
+
error: "",
|
|
108
|
+
boardFile,
|
|
109
|
+
copperLayers: parsed.copperLayers,
|
|
110
|
+
pairs,
|
|
111
|
+
decaps,
|
|
112
|
+
planes,
|
|
113
|
+
findings,
|
|
114
|
+
notes,
|
|
115
|
+
};
|
|
116
|
+
}
|
|
117
|
+
function parseBoard(text) {
|
|
118
|
+
// 顶层块取不到就是文件截断或根本不是板子:此时回空报告比回「一切正常」安全。
|
|
119
|
+
if (!text.includes("(kicad_pcb") || parenBlocks(text, "kicad_pcb").length === 0) {
|
|
120
|
+
throw new Error("没有找到完整的 (kicad_pcb 块,文件可能被截断");
|
|
121
|
+
}
|
|
122
|
+
const nets = new Map();
|
|
123
|
+
for (const block of parenBlocks(text, "net")) {
|
|
124
|
+
const m = /^\(net (\d+) "([^"]*)"\)$/u.exec(block.trim());
|
|
125
|
+
if (m !== null)
|
|
126
|
+
nets.set(m[1], m[2]);
|
|
127
|
+
}
|
|
128
|
+
const nameOf = (raw) => nets.get(raw) ?? "#" + raw;
|
|
129
|
+
const padByNet = new Map();
|
|
130
|
+
const parts = [];
|
|
131
|
+
for (const block of parenBlocks(text, "footprint")) {
|
|
132
|
+
const ref = first(block, /\(property "Reference" "([^"]+)"/u) ?? first(block, /\(fp_text reference "([^"]+)"/u) ?? "";
|
|
133
|
+
const value = first(block, /\(property "Value" "([^"]+)"/u) ?? first(block, /\(fp_text value "([^"]+)"/u) ?? "";
|
|
134
|
+
const at = /\(at ([-\d.]+) ([-\d.]+)(?: ([-\d.]+))?\)/u.exec(block);
|
|
135
|
+
if (at === null)
|
|
136
|
+
continue;
|
|
137
|
+
const fx = Number(at[1]);
|
|
138
|
+
const fy = Number(at[2]);
|
|
139
|
+
const fr = Number(at[3] ?? "0");
|
|
140
|
+
const pads = [];
|
|
141
|
+
for (const padBlock of parenBlocks(block, "pad")) {
|
|
142
|
+
const number = first(padBlock, /^\(pad "([^"]*)"/u);
|
|
143
|
+
const net = first(padBlock, /\(net (\d+)/u);
|
|
144
|
+
const padAt = /\(at ([-\d.]+) ([-\d.]+)(?: ([-\d.]+))?\)/u.exec(padBlock);
|
|
145
|
+
if (number === null || net === null || padAt === null)
|
|
146
|
+
continue;
|
|
147
|
+
const point = rotate(Number(padAt[1]), Number(padAt[2]), fr);
|
|
148
|
+
const pad = { ref, number, net: nameOf(net), x: fx + point.x, y: fy + point.y };
|
|
149
|
+
pads.push(pad);
|
|
150
|
+
const list = padByNet.get(pad.net) ?? [];
|
|
151
|
+
list.push(pad);
|
|
152
|
+
padByNet.set(pad.net, list);
|
|
153
|
+
}
|
|
154
|
+
if (pads.length > 0)
|
|
155
|
+
parts.push({ ref, value, pads });
|
|
156
|
+
}
|
|
157
|
+
const segments = [];
|
|
158
|
+
for (const block of parenBlocks(text, "segment")) {
|
|
159
|
+
const start = /\(start ([-\d.]+) ([-\d.]+)\)/u.exec(block);
|
|
160
|
+
const end = /\(end ([-\d.]+) ([-\d.]+)\)/u.exec(block);
|
|
161
|
+
const layer = first(block, /\(layer "?([^)"]+)"?\)/u);
|
|
162
|
+
const net = first(block, /\(net (\d+)/u);
|
|
163
|
+
if (start === null || end === null || layer === null || net === null)
|
|
164
|
+
continue;
|
|
165
|
+
segments.push({
|
|
166
|
+
net: nameOf(net),
|
|
167
|
+
layer,
|
|
168
|
+
x1: Number(start[1]),
|
|
169
|
+
y1: Number(start[2]),
|
|
170
|
+
x2: Number(end[1]),
|
|
171
|
+
y2: Number(end[2]),
|
|
172
|
+
});
|
|
173
|
+
}
|
|
174
|
+
const viaCountByNet = new Map();
|
|
175
|
+
for (const block of parenBlocks(text, "via")) {
|
|
176
|
+
const net = first(block, /\(net (\d+)/u);
|
|
177
|
+
if (net === null)
|
|
178
|
+
continue;
|
|
179
|
+
const name = nameOf(net);
|
|
180
|
+
viaCountByNet.set(name, (viaCountByNet.get(name) ?? 0) + 1);
|
|
181
|
+
}
|
|
182
|
+
const zones = [];
|
|
183
|
+
for (const block of parenBlocks(text, "zone")) {
|
|
184
|
+
const net = first(block, /\(net (\d+)/u);
|
|
185
|
+
const layer = first(block, /\(layer "?([^)"]+)"?\)/u);
|
|
186
|
+
if (net !== null && layer !== null)
|
|
187
|
+
zones.push({ net: nameOf(net), layer });
|
|
188
|
+
}
|
|
189
|
+
const layersBlock = parenBlocks(text, "layers")[0] ?? "";
|
|
190
|
+
const copperLayers = new Set([...layersBlock.matchAll(/"((?:F|B|In\d+)\.Cu)"/gu)].map((m) => m[1])).size;
|
|
191
|
+
return {
|
|
192
|
+
copperLayers: copperLayers === 0 ? 2 : copperLayers,
|
|
193
|
+
netNames: [...nets.values()].filter((name) => name !== ""),
|
|
194
|
+
padByNet,
|
|
195
|
+
segments,
|
|
196
|
+
viaCountByNet,
|
|
197
|
+
zones,
|
|
198
|
+
parts,
|
|
199
|
+
};
|
|
200
|
+
}
|
|
201
|
+
function analyzePairs(parsed, toleranceMm) {
|
|
202
|
+
// 差分对要看「声明过的网络名」:一对线可能只出现走线里(焊盘上只有电气连接)。
|
|
203
|
+
const names = [...new Set([...parsed.netNames, ...parsed.padByNet.keys()])];
|
|
204
|
+
const byBase = new Map();
|
|
205
|
+
for (const name of names) {
|
|
206
|
+
const found = pairSuffix(name);
|
|
207
|
+
if (found === null)
|
|
208
|
+
continue;
|
|
209
|
+
const existing = byBase.get(found.base);
|
|
210
|
+
if (existing === undefined) {
|
|
211
|
+
byBase.set(found.base, found.polarity === "P" ? { positive: name, negative: "" } : { positive: "", negative: name });
|
|
212
|
+
}
|
|
213
|
+
else if (found.polarity === "P") {
|
|
214
|
+
existing.positive = name;
|
|
215
|
+
}
|
|
216
|
+
else {
|
|
217
|
+
existing.negative = name;
|
|
218
|
+
}
|
|
219
|
+
}
|
|
220
|
+
const reports = [];
|
|
221
|
+
for (const [base, pair] of byBase) {
|
|
222
|
+
if (pair.positive === "" || pair.negative === "")
|
|
223
|
+
continue;
|
|
224
|
+
const lengthP = netLength(parsed, pair.positive);
|
|
225
|
+
const lengthN = netLength(parsed, pair.negative);
|
|
226
|
+
const routedP = lengthP > 0;
|
|
227
|
+
const routedN = lengthN > 0;
|
|
228
|
+
const deltaMm = Math.abs(lengthP - lengthN);
|
|
229
|
+
const viasP = parsed.viaCountByNet.get(pair.positive) ?? 0;
|
|
230
|
+
const viasN = parsed.viaCountByNet.get(pair.negative) ?? 0;
|
|
231
|
+
const notes = [];
|
|
232
|
+
if (routedP && routedN && viasP !== viasN)
|
|
233
|
+
notes.push("两条线的过孔数不同(" + String(viasP) + " vs " + String(viasN) + "),回流路径不对称");
|
|
234
|
+
reports.push({
|
|
235
|
+
id: base,
|
|
236
|
+
positive: pair.positive,
|
|
237
|
+
negative: pair.negative,
|
|
238
|
+
routedP,
|
|
239
|
+
routedN,
|
|
240
|
+
lengthPMm: round(lengthP),
|
|
241
|
+
lengthNMm: round(lengthN),
|
|
242
|
+
deltaMm: round(deltaMm),
|
|
243
|
+
viasP,
|
|
244
|
+
viasN,
|
|
245
|
+
ok: routedP && routedN && deltaMm <= toleranceMm,
|
|
246
|
+
notes,
|
|
247
|
+
});
|
|
248
|
+
}
|
|
249
|
+
reports.sort((a, b) => a.id.localeCompare(b.id));
|
|
250
|
+
return reports;
|
|
251
|
+
}
|
|
252
|
+
function analyzeDecaps(parsed, limitMm) {
|
|
253
|
+
const reports = [];
|
|
254
|
+
// 只认位号以 C 开头的两脚件:电源与地之间的电池、跳线也会「跨在」两个网络上,
|
|
255
|
+
// 但它们不是去耦电容,按距离评它们会得出误导的结论。
|
|
256
|
+
const capRefs = new Set(parsed.parts
|
|
257
|
+
.filter((part) => /^C\d/u.test(part.ref) && part.pads.length === 2)
|
|
258
|
+
.map((part) => part.ref));
|
|
259
|
+
// 两脚件(电容、电阻、电池)都不是「负载」,去耦要对准的是 IC 的电源脚。
|
|
260
|
+
const passiveRefs = new Set(parsed.parts.filter((part) => part.pads.length <= 2).map((part) => part.ref));
|
|
261
|
+
for (const part of parsed.parts) {
|
|
262
|
+
if (!capRefs.has(part.ref))
|
|
263
|
+
continue;
|
|
264
|
+
if (part.pads.length !== 2)
|
|
265
|
+
continue;
|
|
266
|
+
const ground = part.pads.find((pad) => /^(GND|VSS)/u.test(pad.net));
|
|
267
|
+
const power = part.pads.find((pad) => pad !== ground && inferVoltage(pad.net) !== null);
|
|
268
|
+
if (ground === undefined || power === undefined)
|
|
269
|
+
continue;
|
|
270
|
+
// 负载引脚优先:同网络的 IC 引脚才算「去耦要对准的地方」;
|
|
271
|
+
// 另一个电容的引脚不是负载,先排除,实在没有引脚再看全部。
|
|
272
|
+
const sameNet = (parsed.padByNet.get(power.net) ?? []).filter((pad) => pad.ref !== part.ref);
|
|
273
|
+
const loadPins = sameNet.filter((pad) => !passiveRefs.has(pad.ref));
|
|
274
|
+
const others = loadPins.length > 0 ? loadPins : sameNet;
|
|
275
|
+
if (others.length === 0) {
|
|
276
|
+
reports.push({
|
|
277
|
+
ref: part.ref,
|
|
278
|
+
value: part.value,
|
|
279
|
+
powerNet: power.net,
|
|
280
|
+
groundNet: ground.net,
|
|
281
|
+
distanceMm: 0,
|
|
282
|
+
nearestRef: "",
|
|
283
|
+
ok: true,
|
|
284
|
+
note: "这个电源网络没有别的引脚:可能是孤立网络,或只有这一段铺铜。",
|
|
285
|
+
});
|
|
286
|
+
continue;
|
|
287
|
+
}
|
|
288
|
+
let best = others[0];
|
|
289
|
+
let bestD = distance(power, best);
|
|
290
|
+
for (const other of others) {
|
|
291
|
+
const d = distance(power, other);
|
|
292
|
+
if (d < bestD) {
|
|
293
|
+
bestD = d;
|
|
294
|
+
best = other;
|
|
295
|
+
}
|
|
296
|
+
}
|
|
297
|
+
reports.push({
|
|
298
|
+
ref: part.ref,
|
|
299
|
+
value: part.value,
|
|
300
|
+
powerNet: power.net,
|
|
301
|
+
groundNet: ground.net,
|
|
302
|
+
distanceMm: round(bestD),
|
|
303
|
+
nearestRef: best.ref,
|
|
304
|
+
ok: bestD <= limitMm,
|
|
305
|
+
note: bestD > limitMm ? "离负载引脚偏远:高频去耦会失效" : "",
|
|
306
|
+
});
|
|
307
|
+
}
|
|
308
|
+
reports.sort((a, b) => b.distanceMm - a.distanceMm);
|
|
309
|
+
return reports;
|
|
310
|
+
}
|
|
311
|
+
function analyzePlanes(parsed) {
|
|
312
|
+
const layers = new Set(["F.Cu", "B.Cu"]);
|
|
313
|
+
for (const zone of parsed.zones)
|
|
314
|
+
layers.add(zone.layer);
|
|
315
|
+
for (const seg of parsed.segments)
|
|
316
|
+
layers.add(seg.layer);
|
|
317
|
+
const order = (layer) => {
|
|
318
|
+
if (layer === "F.Cu")
|
|
319
|
+
return -1;
|
|
320
|
+
if (layer === "B.Cu")
|
|
321
|
+
return 10_000;
|
|
322
|
+
const m = /^In(\d+)\.Cu$/u.exec(layer);
|
|
323
|
+
return m === null ? 500 : Number(m[1]);
|
|
324
|
+
};
|
|
325
|
+
return [...layers]
|
|
326
|
+
.sort((a, b) => order(a) - order(b))
|
|
327
|
+
.map((layer) => {
|
|
328
|
+
const planeNets = [...new Set(parsed.zones.filter((zone) => zone.layer === layer).map((zone) => zone.net))];
|
|
329
|
+
const onLayer = parsed.segments.filter((seg) => seg.layer === layer);
|
|
330
|
+
return {
|
|
331
|
+
layer,
|
|
332
|
+
planeNets,
|
|
333
|
+
trackCount: onLayer.length,
|
|
334
|
+
signalNets: [...new Set(onLayer.map((seg) => seg.net))].slice(0, 8),
|
|
335
|
+
};
|
|
336
|
+
});
|
|
337
|
+
}
|
|
338
|
+
function netLength(parsed, net) {
|
|
339
|
+
let total = 0;
|
|
340
|
+
for (const seg of parsed.segments) {
|
|
341
|
+
if (seg.net !== net)
|
|
342
|
+
continue;
|
|
343
|
+
total += Math.hypot(seg.x2 - seg.x1, seg.y2 - seg.y1);
|
|
344
|
+
}
|
|
345
|
+
return total;
|
|
346
|
+
}
|
|
347
|
+
function pairSuffix(name) {
|
|
348
|
+
const table = [
|
|
349
|
+
[/_P$/u, "P"],
|
|
350
|
+
[/_N$/u, "N"],
|
|
351
|
+
[/_DP$/u, "P"],
|
|
352
|
+
[/_DM$/u, "N"],
|
|
353
|
+
[/_DN$/u, "N"],
|
|
354
|
+
[/_POS$/u, "P"],
|
|
355
|
+
[/_NEG$/u, "N"],
|
|
356
|
+
[/\+$/u, "P"],
|
|
357
|
+
[/-$/u, "N"],
|
|
358
|
+
];
|
|
359
|
+
for (const [pattern, polarity] of table) {
|
|
360
|
+
if (!pattern.test(name))
|
|
361
|
+
continue;
|
|
362
|
+
const base = name.replace(pattern, "");
|
|
363
|
+
if (base !== "" && base !== name)
|
|
364
|
+
return { base, polarity: polarity };
|
|
365
|
+
}
|
|
366
|
+
if (/DP$/u.test(name) && !/_DP$/u.test(name))
|
|
367
|
+
return { base: name.slice(0, -2), polarity: "P" };
|
|
368
|
+
if (/DM$/u.test(name) && !/_DM$/u.test(name))
|
|
369
|
+
return { base: name.slice(0, -2), polarity: "N" };
|
|
370
|
+
if (/CANH$/u.test(name))
|
|
371
|
+
return { base: name.slice(0, -4), polarity: "P" };
|
|
372
|
+
if (/CANL$/u.test(name))
|
|
373
|
+
return { base: name.slice(0, -4), polarity: "N" };
|
|
374
|
+
return null;
|
|
375
|
+
}
|
|
376
|
+
function first(text, pattern) {
|
|
377
|
+
const m = pattern.exec(text);
|
|
378
|
+
return m === null ? null : m[1];
|
|
379
|
+
}
|
|
380
|
+
function rotate(dx, dy, deg) {
|
|
381
|
+
if (deg === 0)
|
|
382
|
+
return { x: dx, y: dy };
|
|
383
|
+
const rad = (deg * Math.PI) / 180;
|
|
384
|
+
const cos = Math.cos(rad);
|
|
385
|
+
const sin = Math.sin(rad);
|
|
386
|
+
return { x: dx * cos + dy * sin, y: -dx * sin + dy * cos };
|
|
387
|
+
}
|
|
388
|
+
function distance(a, b) {
|
|
389
|
+
return Math.hypot(a.x - b.x, a.y - b.y);
|
|
390
|
+
}
|
|
391
|
+
function round(value) {
|
|
392
|
+
return Math.round(value * 100) / 100;
|
|
393
|
+
}
|
|
@@ -0,0 +1,201 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 外壳与机械约束(S162)。
|
|
3
|
+
*
|
|
4
|
+
* 外壳设计师要的东西只有三样:**外形、孔位、最高的地方**。前两样能从 `.kicad_pcb` 直接读,
|
|
5
|
+
* 第三样需要元件高度——板子里没有,所以不做。这里出的是「MCAD 能直接吃」的轮廓与孔位,
|
|
6
|
+
* 外加几条能证实的检查:孔离边太近、板子没有定位孔、外形不是闭合矩形。
|
|
7
|
+
*
|
|
8
|
+
* DXF 只写 R12 的 ENTITIES(LINE / CIRCLE)——这是所有机械软件都认的最小集合。
|
|
9
|
+
*/
|
|
10
|
+
import { writeFileSync } from "node:fs";
|
|
11
|
+
import { dirname } from "node:path";
|
|
12
|
+
import { mkdirSync } from "node:fs";
|
|
13
|
+
import { blocksOnLayer, readBoardFacts } from "../dfm.js";
|
|
14
|
+
import { parenBlocks } from "./emc.js";
|
|
15
|
+
const BOARD_THICKNESS_MM = 1.6;
|
|
16
|
+
function num(value) {
|
|
17
|
+
const parsed = Number(value ?? "0");
|
|
18
|
+
return Number.isFinite(parsed) ? parsed : 0;
|
|
19
|
+
}
|
|
20
|
+
function round2(value) {
|
|
21
|
+
return Math.round(value * 100) / 100;
|
|
22
|
+
}
|
|
23
|
+
/** 读板框与孔位;只认 Edge.Cuts 的线段/圆弧端点与 `np_thru_hole`/`thru_hole` 的钻孔。 */
|
|
24
|
+
export function parseMech(pcbText, boardFile) {
|
|
25
|
+
const facts = readBoardFacts(pcbText);
|
|
26
|
+
const outlineBlocks = blocksOnLayer(pcbText, "Edge.Cuts");
|
|
27
|
+
const outlinePoints = outlineBlocks.length;
|
|
28
|
+
// 板框左下角:KiCad 坐标是绝对毫米,机械图要从 0,0 起,所以孔位统一减去它。
|
|
29
|
+
let minX = Number.POSITIVE_INFINITY;
|
|
30
|
+
let minY = Number.POSITIVE_INFINITY;
|
|
31
|
+
for (const block of outlineBlocks) {
|
|
32
|
+
for (const match of block.matchAll(/\((?:start|end|center|xy)\s+(-?[\d.]+)\s+(-?[\d.]+)\)/gu)) {
|
|
33
|
+
const x = num(match[1]);
|
|
34
|
+
const y = num(match[2]);
|
|
35
|
+
if (x < minX)
|
|
36
|
+
minX = x;
|
|
37
|
+
if (y < minY)
|
|
38
|
+
minY = y;
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
const originX = Number.isFinite(minX) ? minX : 0;
|
|
42
|
+
const originY = Number.isFinite(minY) ? minY : 0;
|
|
43
|
+
const holes = [];
|
|
44
|
+
const notes = [];
|
|
45
|
+
const findings = [];
|
|
46
|
+
if (facts.widthMm <= 0 || facts.heightMm <= 0) {
|
|
47
|
+
return {
|
|
48
|
+
ok: false,
|
|
49
|
+
error: "没在 Edge.Cuts 上读到板框:机械图需要闭合外形,先在 KiCad 里补板框",
|
|
50
|
+
boardFile,
|
|
51
|
+
widthMm: 0,
|
|
52
|
+
heightMm: 0,
|
|
53
|
+
thicknessMm: BOARD_THICKNESS_MM,
|
|
54
|
+
areaCm2: 0,
|
|
55
|
+
outlinePoints,
|
|
56
|
+
holes: [],
|
|
57
|
+
mountingHoles: 0,
|
|
58
|
+
minHoleEdgeMm: 0,
|
|
59
|
+
findings: [],
|
|
60
|
+
notes: ["板框缺失,孔位与边距都不判"],
|
|
61
|
+
};
|
|
62
|
+
}
|
|
63
|
+
// 孔:封装块里 `(pad "" np_thru_hole … (drill d))`。封装原点的 `(at x y r)` 要参与旋转,
|
|
64
|
+
// 与板图解析同一套变换(KiCad y 向下、正角度屏幕逆时针)。
|
|
65
|
+
const footprintBlocks = parenBlocks(pcbText, "footprint");
|
|
66
|
+
for (const block of footprintBlocks) {
|
|
67
|
+
const refMatch = block.match(/\(property\s+"Reference"\s+"([^"]*)"/u) ?? block.match(/\(fp_text\s+reference\s+"([^"]*)"/u);
|
|
68
|
+
const ref = refMatch?.[1] ?? "";
|
|
69
|
+
const atMatch = block.match(/\(at\s+(-?[\d.]+)\s+(-?[\d.]+)(?:\s+(-?[\d.]+))?\)/u);
|
|
70
|
+
const footprintX = num(atMatch?.[1]);
|
|
71
|
+
const footprintY = num(atMatch?.[2]);
|
|
72
|
+
const originRot = num(atMatch?.[3]);
|
|
73
|
+
const rad = (originRot * Math.PI) / 180;
|
|
74
|
+
const cos = Math.cos(rad);
|
|
75
|
+
const sin = Math.sin(rad);
|
|
76
|
+
const padBlocks = parenBlocks(block, "pad");
|
|
77
|
+
for (const pad of padBlocks) {
|
|
78
|
+
const holeKind = pad.match(/\(pad\s+"[^"]*"\s+(np_thru_hole|thru_hole)\b/u);
|
|
79
|
+
if (holeKind === null)
|
|
80
|
+
continue;
|
|
81
|
+
const drill = pad.match(/\(drill\s+([\d.]+)\)/u) ?? pad.match(/\(drill\s+oval\s+([\d.]+)\s+([\d.]+)\)/u);
|
|
82
|
+
if (drill === null)
|
|
83
|
+
continue;
|
|
84
|
+
const drillMm = num(drill[1]);
|
|
85
|
+
if (drillMm <= 0)
|
|
86
|
+
continue;
|
|
87
|
+
const padAt = pad.match(/\(at\s+(-?[\d.]+)\s+(-?[\d.]+)/u);
|
|
88
|
+
const dx = num(padAt?.[1]);
|
|
89
|
+
const dy = num(padAt?.[2]);
|
|
90
|
+
holes.push({
|
|
91
|
+
ref,
|
|
92
|
+
x: round2(footprintX + dx * cos + dy * sin - originX),
|
|
93
|
+
y: round2(footprintY - dx * sin + dy * cos - originY),
|
|
94
|
+
drillMm: round2(drillMm),
|
|
95
|
+
plated: holeKind[1] === "thru_hole",
|
|
96
|
+
});
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
if (holes.length === 0) {
|
|
100
|
+
findings.push({
|
|
101
|
+
id: "mech.no-holes",
|
|
102
|
+
severity: "info",
|
|
103
|
+
message: "板上没有通孔:如果要做外壳,至少需要两个定位孔(或螺丝孔)",
|
|
104
|
+
fix: "在电路里加 mounting hole(tscircuit 用 hole,或在 KiCad 里放 MountingHole 封装)",
|
|
105
|
+
});
|
|
106
|
+
}
|
|
107
|
+
// 孔到最近板边的距离:只看矩形包络(异形板另算)。
|
|
108
|
+
let minHoleEdgeMm = Number.POSITIVE_INFINITY;
|
|
109
|
+
for (const hole of holes) {
|
|
110
|
+
const distances = [hole.x, facts.widthMm - hole.x, hole.y, facts.heightMm - hole.y];
|
|
111
|
+
for (const distance of distances) {
|
|
112
|
+
if (distance < minHoleEdgeMm)
|
|
113
|
+
minHoleEdgeMm = distance;
|
|
114
|
+
}
|
|
115
|
+
}
|
|
116
|
+
if (holes.length > 0) {
|
|
117
|
+
minHoleEdgeMm = round2(minHoleEdgeMm);
|
|
118
|
+
if (minHoleEdgeMm < 1.2) {
|
|
119
|
+
findings.push({
|
|
120
|
+
id: "mech.hole-too-close",
|
|
121
|
+
severity: "warning",
|
|
122
|
+
message: `有孔离板边只有 ${String(minHoleEdgeMm)} mm:钻孔与铣刀会把板边崩掉`,
|
|
123
|
+
fix: "孔中心离板边至少 1.2 mm(M2 沉头建议 2.5 mm)",
|
|
124
|
+
});
|
|
125
|
+
}
|
|
126
|
+
}
|
|
127
|
+
else {
|
|
128
|
+
minHoleEdgeMm = 0;
|
|
129
|
+
}
|
|
130
|
+
if (outlinePoints < 3) {
|
|
131
|
+
notes.push("板框图元少于 3 段,外形可能不是闭合回路;DXF 仍按包络矩形导出");
|
|
132
|
+
}
|
|
133
|
+
const rectArea = facts.widthMm * facts.heightMm;
|
|
134
|
+
notes.push("板厚按 1.6 mm 标(KiCad 里板厚在 `setup` 段,这里不解析)");
|
|
135
|
+
return {
|
|
136
|
+
ok: true,
|
|
137
|
+
error: "",
|
|
138
|
+
boardFile,
|
|
139
|
+
widthMm: round2(facts.widthMm),
|
|
140
|
+
heightMm: round2(facts.heightMm),
|
|
141
|
+
thicknessMm: BOARD_THICKNESS_MM,
|
|
142
|
+
areaCm2: round2(rectArea / 100),
|
|
143
|
+
outlinePoints,
|
|
144
|
+
holes,
|
|
145
|
+
mountingHoles: holes.filter((hole) => !hole.plated).length,
|
|
146
|
+
minHoleEdgeMm,
|
|
147
|
+
findings,
|
|
148
|
+
notes,
|
|
149
|
+
};
|
|
150
|
+
}
|
|
151
|
+
export function readMech(boardFile, readText) {
|
|
152
|
+
try {
|
|
153
|
+
return parseMech(readText(boardFile), boardFile);
|
|
154
|
+
}
|
|
155
|
+
catch (error) {
|
|
156
|
+
return {
|
|
157
|
+
ok: false,
|
|
158
|
+
error: "读不到板子文件:" + (error instanceof Error ? error.message : String(error)),
|
|
159
|
+
boardFile,
|
|
160
|
+
widthMm: 0,
|
|
161
|
+
heightMm: 0,
|
|
162
|
+
thicknessMm: 0,
|
|
163
|
+
areaCm2: 0,
|
|
164
|
+
outlinePoints: 0,
|
|
165
|
+
holes: [],
|
|
166
|
+
mountingHoles: 0,
|
|
167
|
+
minHoleEdgeMm: 0,
|
|
168
|
+
findings: [],
|
|
169
|
+
notes: [],
|
|
170
|
+
};
|
|
171
|
+
}
|
|
172
|
+
}
|
|
173
|
+
/** DXF R12:板框矩形 + 每个孔一个 CIRCLE。坐标直接用 KiCad 的毫米值。 */
|
|
174
|
+
export function renderMechDxf(report) {
|
|
175
|
+
const lines = [
|
|
176
|
+
"0", "SECTION",
|
|
177
|
+
"2", "ENTITIES",
|
|
178
|
+
];
|
|
179
|
+
const rect = [
|
|
180
|
+
{ x: 0, y: 0 },
|
|
181
|
+
{ x: report.widthMm, y: 0 },
|
|
182
|
+
{ x: report.widthMm, y: report.heightMm },
|
|
183
|
+
{ x: 0, y: report.heightMm },
|
|
184
|
+
];
|
|
185
|
+
for (let i = 0; i < rect.length; i += 1) {
|
|
186
|
+
const from = rect[i];
|
|
187
|
+
const to = rect[(i + 1) % rect.length];
|
|
188
|
+
lines.push("0", "LINE", "8", "BOARD_OUTLINE", "10", String(from.x), "20", String(from.y), "30", "0", "11", String(to.x), "21", String(to.y), "31", "0");
|
|
189
|
+
}
|
|
190
|
+
for (const hole of report.holes.filter((item) => !item.plated)) {
|
|
191
|
+
lines.push("0", "CIRCLE", "8", "HOLES_MOUNT", "10", String(hole.x), "20", String(hole.y), "30", "0", "40", String(hole.drillMm / 2));
|
|
192
|
+
}
|
|
193
|
+
lines.push("0", "ENDSEC", "0", "EOF", "");
|
|
194
|
+
return lines.join("\n");
|
|
195
|
+
}
|
|
196
|
+
export function writeMechDxf(file, report) {
|
|
197
|
+
const text = renderMechDxf(report);
|
|
198
|
+
mkdirSync(dirname(file), { recursive: true });
|
|
199
|
+
writeFileSync(file, text, "utf8");
|
|
200
|
+
return text.length;
|
|
201
|
+
}
|