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,144 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* PCB 对账:把 `.kicad_pcb` 的焊盘网络与原理图解析出的网络对照。
|
|
3
|
+
*
|
|
4
|
+
* 为什么值得做:原理图解析是几何推算,PCB 是同一份设计的另一种表示,
|
|
5
|
+
* 两者一致才说明解析器没有把线接错。对账只读 PCB,不写回、不改 `.ioc`。
|
|
6
|
+
*
|
|
7
|
+
* 判据用「连通性」而不是「名字相等」:同一条 PCB 网络上所有焊盘在原理图里必须落在
|
|
8
|
+
* 同一个网络;名字差异(如 `/col1/GND` 与 `GND`)单独列出,不计为连通错误。
|
|
9
|
+
*/
|
|
10
|
+
import { readFileSync } from "node:fs";
|
|
11
|
+
import { atomOf, childOf, childrenOf, numberOf, parseSexpr } from "./sexpr.js";
|
|
12
|
+
function netNameOf(node) {
|
|
13
|
+
if (node === null)
|
|
14
|
+
return "";
|
|
15
|
+
const first = node[1];
|
|
16
|
+
const second = node[2];
|
|
17
|
+
const firstName = typeof first === "string" ? first : "";
|
|
18
|
+
const secondName = typeof second === "string" ? second : "";
|
|
19
|
+
// KiCad 10 写 (net "GND"),老版本写 (net 12 "GND"):首项不是数字时它才是网络名。
|
|
20
|
+
if (firstName !== "" && !Number.isFinite(Number(firstName)))
|
|
21
|
+
return firstName;
|
|
22
|
+
return secondName;
|
|
23
|
+
}
|
|
24
|
+
function refOf(footprint) {
|
|
25
|
+
for (const property of childrenOf(footprint, "property")) {
|
|
26
|
+
if (atomOf(property, 1) === "Reference")
|
|
27
|
+
return atomOf(property, 2);
|
|
28
|
+
}
|
|
29
|
+
return "";
|
|
30
|
+
}
|
|
31
|
+
export function parsePcbText(text, file) {
|
|
32
|
+
const doc = parseSexpr(text);
|
|
33
|
+
const nets = new Map();
|
|
34
|
+
let footprints = 0;
|
|
35
|
+
let pads = 0;
|
|
36
|
+
const refs = [];
|
|
37
|
+
for (const footprint of childrenOf(doc, "footprint")) {
|
|
38
|
+
footprints += 1;
|
|
39
|
+
const ref = refOf(footprint);
|
|
40
|
+
if (ref !== "" && !refs.includes(ref))
|
|
41
|
+
refs.push(ref);
|
|
42
|
+
for (const pad of childrenOf(footprint, "pad")) {
|
|
43
|
+
pads += 1;
|
|
44
|
+
const number = atomOf(pad, 1);
|
|
45
|
+
const net = netNameOf(childOf(pad, "net"));
|
|
46
|
+
if (net === "" || net.startsWith("unconnected-"))
|
|
47
|
+
continue;
|
|
48
|
+
const list = nets.get(net) ?? [];
|
|
49
|
+
list.push({ ref, number, net });
|
|
50
|
+
nets.set(net, list);
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
const version = numberOf(childOf(doc, "version"), 1);
|
|
54
|
+
return {
|
|
55
|
+
file,
|
|
56
|
+
version: Number.isFinite(version) ? version : 0,
|
|
57
|
+
generator: atomOf(childOf(doc, "generator"), 1),
|
|
58
|
+
footprints,
|
|
59
|
+
pads,
|
|
60
|
+
refs,
|
|
61
|
+
nets,
|
|
62
|
+
};
|
|
63
|
+
}
|
|
64
|
+
export function readPcb(file) {
|
|
65
|
+
return parsePcbText(readFileSync(file, "utf8"), file);
|
|
66
|
+
}
|
|
67
|
+
/** 去掉 KiCad 网络名的图纸路径前缀(`/col1/GND` → `GND`)。 */
|
|
68
|
+
export function normalizeNetName(name) {
|
|
69
|
+
return name.replace(/^\/[^/]+\//u, "");
|
|
70
|
+
}
|
|
71
|
+
/** 原理图:`ref:number` → 网络名与它用到的标号。 */
|
|
72
|
+
function schematicPinNets(schematic) {
|
|
73
|
+
const out = new Map();
|
|
74
|
+
for (const net of schematic.nets) {
|
|
75
|
+
for (const pin of net.pins) {
|
|
76
|
+
if (pin.ref === "")
|
|
77
|
+
continue;
|
|
78
|
+
const key = `${pin.ref}:${pin.number}`;
|
|
79
|
+
if (!out.has(key))
|
|
80
|
+
out.set(key, { name: net.name, labels: net.labels });
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
return out;
|
|
84
|
+
}
|
|
85
|
+
/**
|
|
86
|
+
* 对账:以 PCB 网络为真值,检查同一条 PCB 网络上的焊盘在原理图里是否落在同一网络。
|
|
87
|
+
*/
|
|
88
|
+
export function crossCheckPcb(schematic, pcb) {
|
|
89
|
+
const pinNets = schematicPinNets(schematic);
|
|
90
|
+
const split = [];
|
|
91
|
+
const nameMismatches = [];
|
|
92
|
+
const seenMismatch = new Set();
|
|
93
|
+
let compared = 0;
|
|
94
|
+
let matched = 0;
|
|
95
|
+
for (const [net, pads] of pcb.nets) {
|
|
96
|
+
if (pads.length < 2)
|
|
97
|
+
continue;
|
|
98
|
+
const resolved = pads
|
|
99
|
+
.map((pad) => ({ pad, schematic: pinNets.get(`${pad.ref}:${pad.number}`) }))
|
|
100
|
+
.filter((item) => item.schematic !== undefined);
|
|
101
|
+
if (resolved.length < 2)
|
|
102
|
+
continue;
|
|
103
|
+
compared += 1;
|
|
104
|
+
const distinct = new Set(resolved.map((item) => item.schematic.name));
|
|
105
|
+
if (distinct.size === 1) {
|
|
106
|
+
matched += 1;
|
|
107
|
+
const schematicNet = [...distinct][0];
|
|
108
|
+
// 两边都是自动名(原理图 N$n / PCB Net-(...))时不报:没有标号,名字不可比。
|
|
109
|
+
const pcbName = normalizeNetName(net);
|
|
110
|
+
const labels = new Set(resolved.flatMap((item) => item.schematic.labels.map(normalizeNetName)));
|
|
111
|
+
const named = !schematicNet.startsWith("N$") && !net.startsWith("Net-(");
|
|
112
|
+
if (named && pcbName !== normalizeNetName(schematicNet) && !labels.has(pcbName)) {
|
|
113
|
+
for (const item of resolved) {
|
|
114
|
+
const key = `${item.pad.ref}:${item.pad.number}`;
|
|
115
|
+
if (seenMismatch.has(key))
|
|
116
|
+
continue;
|
|
117
|
+
seenMismatch.add(key);
|
|
118
|
+
nameMismatches.push({ ref: item.pad.ref, number: item.pad.number, pcbNet: net, schematicNet });
|
|
119
|
+
}
|
|
120
|
+
}
|
|
121
|
+
}
|
|
122
|
+
else {
|
|
123
|
+
split.push({ net, pins: resolved.map((item) => `${item.pad.ref}.${item.pad.number}=${item.schematic.name}`) });
|
|
124
|
+
}
|
|
125
|
+
}
|
|
126
|
+
const pcbPads = new Set();
|
|
127
|
+
for (const pads of pcb.nets.values()) {
|
|
128
|
+
for (const pad of pads)
|
|
129
|
+
pcbPads.add(`${pad.ref}:${pad.number}`);
|
|
130
|
+
}
|
|
131
|
+
const missingPads = schematic.components
|
|
132
|
+
.flatMap((component) => component.pins.map((pin) => ({ ref: component.ref, number: pin.number })))
|
|
133
|
+
.filter((pin) => !pcbPads.has(`${pin.ref}:${pin.number}`))
|
|
134
|
+
.slice(0, 40);
|
|
135
|
+
return {
|
|
136
|
+
compared,
|
|
137
|
+
matched,
|
|
138
|
+
split,
|
|
139
|
+
nameMismatches: nameMismatches.slice(0, 40),
|
|
140
|
+
missingPads,
|
|
141
|
+
summary: `PCB 上有名字且能对上的网络 ${compared} 个:连通一致 ${matched} 个,` +
|
|
142
|
+
`被拆开 ${split.length} 个,名字不一致 ${nameMismatches.length} 个`,
|
|
143
|
+
};
|
|
144
|
+
}
|
|
@@ -0,0 +1,134 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 原理图一键评审(S135)。
|
|
3
|
+
*
|
|
4
|
+
* 把「读图 → 与 .ioc 对账 → 出 .ioc 草案」串成一次调用,并只给一个总判据:
|
|
5
|
+
* 有 error 即不通过。所有需要人决策的项(例如某颗芯片的某个脚没有该复用功能)
|
|
6
|
+
* 单独归到 decisions,避免与「必须修的错」混在一起。
|
|
7
|
+
*/
|
|
8
|
+
import { readdirSync, readFileSync } from "node:fs";
|
|
9
|
+
import { join } from "node:path";
|
|
10
|
+
import { locateCubemxDb, readMcuFacts } from "../cubemx-db.js";
|
|
11
|
+
import { mcuFromIoc } from "../facts.js";
|
|
12
|
+
import { resolveProjectLayout } from "../project-layout.js";
|
|
13
|
+
import { resolveSearchConfig } from "../../data/search-roots.js";
|
|
14
|
+
import { checkSchematic } from "./checks.js";
|
|
15
|
+
import { findRootSchematic, readSchematic } from "./model.js";
|
|
16
|
+
import { draftIoc } from "./to-ioc.js";
|
|
17
|
+
function findRoot(projectDir, explicit) {
|
|
18
|
+
if (explicit !== "")
|
|
19
|
+
return { file: explicit, error: "" };
|
|
20
|
+
// 硬件目录按工程约定解析(hardware/ 或 hardware/kicad),与流程图页用同一套判据(S135)。
|
|
21
|
+
const layout = resolveProjectLayout(projectDir);
|
|
22
|
+
const dirs = [layout.hardwareDir, layout.projectDir].filter((dir) => dir !== "");
|
|
23
|
+
for (const dir of dirs) {
|
|
24
|
+
const found = findRootSchematic(dir);
|
|
25
|
+
if (found !== null)
|
|
26
|
+
return { file: found, error: "" };
|
|
27
|
+
}
|
|
28
|
+
return { file: "", error: "工程里没有 .kicad_sch:先选择包含 KiCad 工程的目录,或在参数里给 rootFile" };
|
|
29
|
+
}
|
|
30
|
+
/** 从 .ioc 里取器件库的文件名(Mcu.Name),它比 CPN 更接近 db 里的命名。 */
|
|
31
|
+
function dbMcuNameOf(firmwareDir) {
|
|
32
|
+
try {
|
|
33
|
+
const name = readdirSync(firmwareDir).find((item) => item.endsWith(".ioc"));
|
|
34
|
+
if (name === undefined)
|
|
35
|
+
return "";
|
|
36
|
+
const text = readFileSync(join(firmwareDir, name), "utf8");
|
|
37
|
+
const match = /^Mcu\.Name=(.+)$/mu.exec(text);
|
|
38
|
+
return match === null ? "" : (match[1] ?? "").trim();
|
|
39
|
+
}
|
|
40
|
+
catch {
|
|
41
|
+
return "";
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
/** 读图、对账、出草案,汇总成一份可读的评审结果。 */
|
|
45
|
+
export function runSchematicReview(request, tools = {}) {
|
|
46
|
+
const steps = [];
|
|
47
|
+
const notes = [];
|
|
48
|
+
const started = Date.now();
|
|
49
|
+
const root = findRoot(request.projectDir, request.rootFile ?? "");
|
|
50
|
+
if (root.file === "") {
|
|
51
|
+
return {
|
|
52
|
+
ok: false,
|
|
53
|
+
error: root.error,
|
|
54
|
+
rootFile: "",
|
|
55
|
+
steps,
|
|
56
|
+
components: 0,
|
|
57
|
+
nets: 0,
|
|
58
|
+
mcu: null,
|
|
59
|
+
findings: [],
|
|
60
|
+
errors: 0,
|
|
61
|
+
warnings: 0,
|
|
62
|
+
ioc: null,
|
|
63
|
+
decisions: [],
|
|
64
|
+
notes,
|
|
65
|
+
};
|
|
66
|
+
}
|
|
67
|
+
let mark = Date.now();
|
|
68
|
+
const read = readSchematic(root.file);
|
|
69
|
+
steps.push({ step: "读图", ok: true, detail: read.report.components.length + " 个元件 / " + read.report.nets.length + " 个网络", ms: Date.now() - mark });
|
|
70
|
+
if (read.report.mcu === null)
|
|
71
|
+
notes.push("没有识别出主控:流程图与引脚矩阵会为空");
|
|
72
|
+
const schematic = read.report;
|
|
73
|
+
mark = Date.now();
|
|
74
|
+
const check = checkSchematic(schematic, {});
|
|
75
|
+
steps.push({ step: "规则检查", ok: true, detail: check.summary.errors + " 错误 / " + check.summary.warnings + " 警告", ms: Date.now() - mark });
|
|
76
|
+
mark = Date.now();
|
|
77
|
+
let draft = null;
|
|
78
|
+
const mcu = schematic.mcu;
|
|
79
|
+
if (mcu !== null) {
|
|
80
|
+
// 原理图里常常没写型号(tscircuit 导出的符号 Value 为空):回落到 .ioc 里的芯片型号。
|
|
81
|
+
const layout = resolveProjectLayout(request.projectDir);
|
|
82
|
+
const firmware = layout.firmwareDir === "" ? layout.projectDir : layout.firmwareDir;
|
|
83
|
+
const dbName = dbMcuNameOf(firmware);
|
|
84
|
+
const wanted = mcu.value !== "" ? mcu.value : (dbName !== "" ? dbName : (mcuFromIoc(firmware) ?? ""));
|
|
85
|
+
const roots = request.cubeMxRoots !== undefined && request.cubeMxRoots.length > 0
|
|
86
|
+
? [...request.cubeMxRoots]
|
|
87
|
+
: resolveSearchConfig(process.env).cubeMxRoots;
|
|
88
|
+
const db = locateCubemxDb(roots);
|
|
89
|
+
if (db === null) {
|
|
90
|
+
notes.push("没有找到 CubeMX 器件库:.ioc 草案只给网络名,信号建议要装 CubeMX 后才准");
|
|
91
|
+
}
|
|
92
|
+
else {
|
|
93
|
+
const facts = wanted === "" ? null : readMcuFacts(db, wanted);
|
|
94
|
+
if (wanted === "")
|
|
95
|
+
notes.push("原理图与 .ioc 里都没有写芯片型号:先补型号再生成配置草案");
|
|
96
|
+
else if (facts === null)
|
|
97
|
+
notes.push("器件库里没有 " + wanted + ":跳过信号匹配");
|
|
98
|
+
else
|
|
99
|
+
draft = draftIoc(schematic, facts);
|
|
100
|
+
}
|
|
101
|
+
}
|
|
102
|
+
steps.push({ step: "配置草案", ok: true, detail: draft === null ? "未生成" : draft.pins.length + " 个脚,待确认 " + String(draft.unresolved.length), ms: Date.now() - mark });
|
|
103
|
+
const decisions = [];
|
|
104
|
+
if (draft !== null) {
|
|
105
|
+
for (const pin of draft.pins) {
|
|
106
|
+
if (pin.signal !== "" || pin.net === "")
|
|
107
|
+
continue;
|
|
108
|
+
decisions.push({ pin: pin.number + " " + pin.name, net: pin.net, reason: pin.note === "" ? "器件库没有该脚的匹配信号" : pin.note });
|
|
109
|
+
}
|
|
110
|
+
for (const item of draft.softwareFallbacks) {
|
|
111
|
+
decisions.push({ pin: item.pin, net: item.net, reason: "硬件复用对不上,可改用软件模拟 " + item.protocol + ":" + item.tradeoff });
|
|
112
|
+
}
|
|
113
|
+
}
|
|
114
|
+
const errors = check.summary.errors;
|
|
115
|
+
return {
|
|
116
|
+
ok: errors === 0,
|
|
117
|
+
error: errors === 0 ? "" : "原理图检查有 " + String(errors) + " 条错误",
|
|
118
|
+
rootFile: root.file,
|
|
119
|
+
steps,
|
|
120
|
+
components: schematic.components.length,
|
|
121
|
+
nets: schematic.nets.length,
|
|
122
|
+
mcu: mcu === null ? null : { ref: mcu.ref, value: mcu.value },
|
|
123
|
+
findings: check.findings.map((item) => ({ rule: item.rule, severity: item.severity, message: item.message })),
|
|
124
|
+
errors: check.summary.errors,
|
|
125
|
+
warnings: check.summary.warnings,
|
|
126
|
+
ioc: draft === null ? null : {
|
|
127
|
+
pins: draft.pins.length,
|
|
128
|
+
unresolved: draft.unresolved.map((item) => item.number + " " + item.net),
|
|
129
|
+
softwareFallbacks: draft.softwareFallbacks.map((item) => item.pin + " " + item.protocol),
|
|
130
|
+
},
|
|
131
|
+
decisions,
|
|
132
|
+
notes: [...notes, ...(Date.now() - started > 3000 ? ["本次评审耗时 " + String(Date.now() - started) + " ms"] : [])],
|
|
133
|
+
};
|
|
134
|
+
}
|
|
@@ -0,0 +1,134 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* S-expression 读写:KiCad 的原理图、封装、网表全部是这一种括号语法。
|
|
3
|
+
*
|
|
4
|
+
* 为什么不用正则按行扫:同一个文件里 `(symbol ...)` 既可能出现在 `lib_symbols`
|
|
5
|
+
* (库定义,嵌套在符号单元里),也可能是顶层实例,缩进与层级都不同;行级统计会把
|
|
6
|
+
* 实例数算成 0。只有按括号深度建树,才能同时拿到库引脚定义与实例坐标。
|
|
7
|
+
*
|
|
8
|
+
* 解析只做两件事:字符串字面量(含 `\"`、`\\` 转义)与括号列表;数值、布尔、
|
|
9
|
+
* 关键字都保留为原子的原始文本,由调用方决定怎么解释。
|
|
10
|
+
*/
|
|
11
|
+
/** 列表判定,便于在 strict 模式下做类型收窄。 */
|
|
12
|
+
export function isList(node) {
|
|
13
|
+
return Array.isArray(node);
|
|
14
|
+
}
|
|
15
|
+
/**
|
|
16
|
+
* 解析一个完整的 S-expression 文档。
|
|
17
|
+
*
|
|
18
|
+
* 顶层必须是单个列表,多余内容(注释、尾随空白)忽略;结构不完整时报错,
|
|
19
|
+
* 由调用方翻译成"文件不是合法的 KiCad 语法"。
|
|
20
|
+
*/
|
|
21
|
+
export function parseSexpr(text) {
|
|
22
|
+
let index = 0;
|
|
23
|
+
const length = text.length;
|
|
24
|
+
const skipSpace = () => {
|
|
25
|
+
while (index < length) {
|
|
26
|
+
const char = text[index];
|
|
27
|
+
if (char === " " || char === "\t" || char === "\n" || char === "\r") {
|
|
28
|
+
index += 1;
|
|
29
|
+
continue;
|
|
30
|
+
}
|
|
31
|
+
break;
|
|
32
|
+
}
|
|
33
|
+
};
|
|
34
|
+
const readAtom = () => {
|
|
35
|
+
if (text[index] === '"') {
|
|
36
|
+
index += 1;
|
|
37
|
+
let out = "";
|
|
38
|
+
while (index < length) {
|
|
39
|
+
const char = text[index];
|
|
40
|
+
if (char === "\\") {
|
|
41
|
+
const next = text[index + 1];
|
|
42
|
+
if (next === undefined)
|
|
43
|
+
throw new Error("字符串未闭合");
|
|
44
|
+
out += next;
|
|
45
|
+
index += 2;
|
|
46
|
+
continue;
|
|
47
|
+
}
|
|
48
|
+
if (char === '"') {
|
|
49
|
+
index += 1;
|
|
50
|
+
return out;
|
|
51
|
+
}
|
|
52
|
+
out += char;
|
|
53
|
+
index += 1;
|
|
54
|
+
}
|
|
55
|
+
throw new Error("字符串未闭合");
|
|
56
|
+
}
|
|
57
|
+
const start = index;
|
|
58
|
+
while (index < length) {
|
|
59
|
+
const char = text[index];
|
|
60
|
+
if (char === " " || char === "\t" || char === "\n" || char === "\r" || char === "(" || char === ")")
|
|
61
|
+
break;
|
|
62
|
+
index += 1;
|
|
63
|
+
}
|
|
64
|
+
if (index === start)
|
|
65
|
+
throw new Error("空的原子");
|
|
66
|
+
return text.slice(start, index);
|
|
67
|
+
};
|
|
68
|
+
const readList = () => {
|
|
69
|
+
if (text[index] !== "(")
|
|
70
|
+
throw new Error(`期望 (,位置 ${index}`);
|
|
71
|
+
index += 1;
|
|
72
|
+
const out = [];
|
|
73
|
+
for (;;) {
|
|
74
|
+
skipSpace();
|
|
75
|
+
if (index >= length)
|
|
76
|
+
throw new Error("括号未闭合");
|
|
77
|
+
const char = text[index];
|
|
78
|
+
if (char === ")") {
|
|
79
|
+
index += 1;
|
|
80
|
+
return out;
|
|
81
|
+
}
|
|
82
|
+
out.push(char === "(" ? readList() : readAtom());
|
|
83
|
+
}
|
|
84
|
+
};
|
|
85
|
+
skipSpace();
|
|
86
|
+
if (index >= length)
|
|
87
|
+
throw new Error("文件为空");
|
|
88
|
+
if (text[index] !== "(")
|
|
89
|
+
throw new Error(`文档不是以 ( 开头,位置 ${index}`);
|
|
90
|
+
return readList();
|
|
91
|
+
}
|
|
92
|
+
/** 列表的第一个原子(节点类型名),非列表或首项非原子时为空串。 */
|
|
93
|
+
export function headOf(node) {
|
|
94
|
+
if (!Array.isArray(node))
|
|
95
|
+
return "";
|
|
96
|
+
const first = node[0];
|
|
97
|
+
return typeof first === "string" ? first : "";
|
|
98
|
+
}
|
|
99
|
+
/** 取所有首项等于 `name` 的子列表。 */
|
|
100
|
+
export function childrenOf(node, name) {
|
|
101
|
+
if (!Array.isArray(node))
|
|
102
|
+
return [];
|
|
103
|
+
const out = [];
|
|
104
|
+
for (const item of node) {
|
|
105
|
+
if (Array.isArray(item) && headOf(item) === name)
|
|
106
|
+
out.push(item);
|
|
107
|
+
}
|
|
108
|
+
return out;
|
|
109
|
+
}
|
|
110
|
+
/** 取第一个首项等于 `name` 的子列表。 */
|
|
111
|
+
export function childOf(node, name) {
|
|
112
|
+
if (!Array.isArray(node))
|
|
113
|
+
return null;
|
|
114
|
+
for (const item of node) {
|
|
115
|
+
if (Array.isArray(item) && headOf(item) === name)
|
|
116
|
+
return item;
|
|
117
|
+
}
|
|
118
|
+
return null;
|
|
119
|
+
}
|
|
120
|
+
/** 第 `index` 项按原子读;不是原子时为空串。 */
|
|
121
|
+
export function atomOf(node, index) {
|
|
122
|
+
if (!Array.isArray(node))
|
|
123
|
+
return "";
|
|
124
|
+
const item = node[index];
|
|
125
|
+
return typeof item === "string" ? item : "";
|
|
126
|
+
}
|
|
127
|
+
/** 第 `index` 项按数值读;缺失或非数值时返回 NaN,调用方用 Number.isFinite 判定。 */
|
|
128
|
+
export function numberOf(node, index) {
|
|
129
|
+
const atom = atomOf(node, index);
|
|
130
|
+
if (atom === "")
|
|
131
|
+
return Number.NaN;
|
|
132
|
+
const value = Number(atom);
|
|
133
|
+
return Number.isFinite(value) ? value : Number.NaN;
|
|
134
|
+
}
|
|
@@ -0,0 +1,197 @@
|
|
|
1
|
+
import { resolveDbPinName } from "../cubemx-db.js";
|
|
2
|
+
const POWER_NET = /^(GND|VSS|VDD|VCC|VBAT|VBUS|VDDA|VSSA|\+?3V3|\+?5V)/u;
|
|
3
|
+
const NON_GPIO = /^(PA|PB|PC|PD|PE|PF|PG|PH|PI)\d+$/u;
|
|
4
|
+
function tokensOf(name) {
|
|
5
|
+
return name
|
|
6
|
+
.toUpperCase()
|
|
7
|
+
.split(/[^A-Z0-9]+/u)
|
|
8
|
+
.filter((token) => token.length > 1);
|
|
9
|
+
}
|
|
10
|
+
/** 匹配时剔掉引脚名本身(PB1 这类词元会把同名的 SYS_VREF_OUT_PB1 顶上来)。 */
|
|
11
|
+
function tokensForMatch(net, pinName) {
|
|
12
|
+
const pin = pinName.toUpperCase();
|
|
13
|
+
return tokensOf(net).filter((token) => token !== pin);
|
|
14
|
+
}
|
|
15
|
+
/** 候选信号按与网络名的词元重合度排序。 */
|
|
16
|
+
function scoreSignals(signals, netName, pinName) {
|
|
17
|
+
const tokens = tokensForMatch(netName, pinName);
|
|
18
|
+
const scored = signals.map((signal) => {
|
|
19
|
+
const upper = signal.toUpperCase();
|
|
20
|
+
const score = tokens.filter((token) => upper.includes(token)).length;
|
|
21
|
+
return { signal, score };
|
|
22
|
+
});
|
|
23
|
+
scored.sort((a, b) => (b.score === a.score ? a.signal.localeCompare(b.signal) : b.score - a.score));
|
|
24
|
+
return scored.map((item) => item.signal);
|
|
25
|
+
}
|
|
26
|
+
/** 引脚名在器件库里可能写作 PB9-BOOT0 这类复合名,先做一次解析。 */
|
|
27
|
+
function signalsOf(facts, name) {
|
|
28
|
+
const dbName = resolveDbPinName(facts, name);
|
|
29
|
+
const found = dbName === null ? facts.pins.get(name.toUpperCase()) : facts.pins.get(dbName);
|
|
30
|
+
if (found === undefined)
|
|
31
|
+
return [];
|
|
32
|
+
return [...found.signals.keys()].sort((a, b) => a.localeCompare(b));
|
|
33
|
+
}
|
|
34
|
+
/** 网络名只是引脚默认名(PA4 这类)时不算连接信息。 */
|
|
35
|
+
function isUnnamedNet(pinName, net) {
|
|
36
|
+
return net.toUpperCase() === pinName.toUpperCase();
|
|
37
|
+
}
|
|
38
|
+
/** 从网络名看出协议(只认最常见的三组)。 */
|
|
39
|
+
function protocolOf(net) {
|
|
40
|
+
const upper = net.toUpperCase();
|
|
41
|
+
if (/\bSCL\b|\bSDA\b/u.test(upper))
|
|
42
|
+
return "I2C";
|
|
43
|
+
if (/\bMOSI\b|\bMISO\b|\bSCK\b|\bCS\b/u.test(upper))
|
|
44
|
+
return "SPI";
|
|
45
|
+
if (/\bTX\b|\bRX\b/u.test(upper))
|
|
46
|
+
return "UART";
|
|
47
|
+
return "";
|
|
48
|
+
}
|
|
49
|
+
/** 软件模拟的代价:说清楚,不当作等价方案。 */
|
|
50
|
+
function softwareTradeoff(protocol) {
|
|
51
|
+
if (protocol === "I2C")
|
|
52
|
+
return "软件模拟 I2C:两个 GPIO 开漏 + 上拉,速率通常 100 kHz 以内,占 CPU,时序受中断影响";
|
|
53
|
+
if (protocol === "SPI")
|
|
54
|
+
return "软件模拟 SPI:GPIO 逐位翻转,速率与稳定性都低于硬件 SPI";
|
|
55
|
+
return "软件模拟 UART:GPIO + 定时器采样,波特率误差与 CPU 占用都要算清楚";
|
|
56
|
+
}
|
|
57
|
+
function peripheralOf(signal) {
|
|
58
|
+
const head = signal.split("_")[0] ?? "";
|
|
59
|
+
return /[0-9]/u.test(head) && head !== "" ? head : "";
|
|
60
|
+
}
|
|
61
|
+
/** 纯 GPIO 网络才给 input/output 建议;外设信号交给 peripherals 预设。 */
|
|
62
|
+
function gpioSuggestion(name, net, signal) {
|
|
63
|
+
if (signal !== "" && peripheralOf(signal) !== "" && !signal.startsWith("GPIO"))
|
|
64
|
+
return null;
|
|
65
|
+
const upper = net.toUpperCase();
|
|
66
|
+
if (/BOOT0|NRST|SWDIO|SWCLK/u.test(upper))
|
|
67
|
+
return null;
|
|
68
|
+
if (/^(LED|D[0-9])/u.test(upper))
|
|
69
|
+
return "output";
|
|
70
|
+
if (/^(KEY|SW|BTN|BUTTON)/u.test(upper))
|
|
71
|
+
return "input";
|
|
72
|
+
return null;
|
|
73
|
+
}
|
|
74
|
+
export function draftIoc(schematic, facts, options = {}) {
|
|
75
|
+
const mcu = schematic.mcu === null ? null : { ref: schematic.mcu.ref, value: schematic.mcu.value };
|
|
76
|
+
if (mcu === null) {
|
|
77
|
+
return {
|
|
78
|
+
ok: false,
|
|
79
|
+
error: "原理图里没有识别出主控(按元件型号是否以 STM32/GD32 等开头判断):先确认识别结果再生成配置草案",
|
|
80
|
+
mcu: null,
|
|
81
|
+
pins: [],
|
|
82
|
+
unresolved: [],
|
|
83
|
+
peripherals: [],
|
|
84
|
+
gpioPins: [],
|
|
85
|
+
softwareFallbacks: [],
|
|
86
|
+
notes: [],
|
|
87
|
+
};
|
|
88
|
+
}
|
|
89
|
+
if (facts === null) {
|
|
90
|
+
return {
|
|
91
|
+
ok: false,
|
|
92
|
+
error: "没有可用的 CubeMX 器件库(" + mcu.value + "):先装 CubeMX 或用 stm32_firmware_install 取器件包,才能把网络名对到库里的信号",
|
|
93
|
+
mcu,
|
|
94
|
+
pins: [],
|
|
95
|
+
unresolved: [],
|
|
96
|
+
peripherals: [],
|
|
97
|
+
gpioPins: [],
|
|
98
|
+
softwareFallbacks: [],
|
|
99
|
+
notes: [],
|
|
100
|
+
};
|
|
101
|
+
}
|
|
102
|
+
const pins = [];
|
|
103
|
+
const unresolved = [];
|
|
104
|
+
const gpioPins = [];
|
|
105
|
+
const softwareFallbacks = [];
|
|
106
|
+
const notes = [];
|
|
107
|
+
let unnamed = 0;
|
|
108
|
+
for (const pin of schematic.mcu?.pins ?? []) {
|
|
109
|
+
const net = pin.net;
|
|
110
|
+
if (net === "" || pin.noConnect)
|
|
111
|
+
continue;
|
|
112
|
+
if (POWER_NET.test(net.toUpperCase()))
|
|
113
|
+
continue;
|
|
114
|
+
if (isUnnamedNet(pin.name, net)) {
|
|
115
|
+
unnamed += 1;
|
|
116
|
+
continue;
|
|
117
|
+
}
|
|
118
|
+
const dbSignals = signalsOf(facts, pin.name);
|
|
119
|
+
// 器件库缺这个脚的信号时,用厂商手册的引脚表兜底:库是「能不能配」,手册是「这颗片子怎么描述」(S123)。
|
|
120
|
+
const manualSignals = options.pinFunctions?.get(pin.name.toUpperCase()) ?? [];
|
|
121
|
+
const merged = [...dbSignals];
|
|
122
|
+
for (const signal of manualSignals)
|
|
123
|
+
if (!merged.includes(signal))
|
|
124
|
+
merged.push(signal);
|
|
125
|
+
const candidates = scoreSignals(merged, net, pin.name);
|
|
126
|
+
const best = candidates[0] ?? "";
|
|
127
|
+
const tokens = tokensForMatch(net, pin.name);
|
|
128
|
+
const matchCount = best === "" || tokens.length === 0 ? 0 : tokens.filter((token) => best.toUpperCase().includes(token)).length;
|
|
129
|
+
const matched = best !== "" && matchCount > 0;
|
|
130
|
+
const confidence = !matched ? "low" : matchCount >= 2 || best.toUpperCase() === net.toUpperCase() ? "high" : "medium";
|
|
131
|
+
const fromManual = matched && !dbSignals.includes(best);
|
|
132
|
+
const note = !matched
|
|
133
|
+
? manualSignals.length > 0
|
|
134
|
+
? "器件库与厂商手册都没有对得上的信号,按手册确认该脚复用"
|
|
135
|
+
: "库里找不到与网络名对得上的信号,按外设手册确认该脚复用"
|
|
136
|
+
: fromManual
|
|
137
|
+
? "信号来自厂商手册引脚表(器件库没有这个脚的信号),按手册确认"
|
|
138
|
+
: "";
|
|
139
|
+
const gpio = gpioSuggestion(pin.name, net, matched ? best : "");
|
|
140
|
+
const dedicated = /BOOT0/u.test(net.toUpperCase());
|
|
141
|
+
const resolvedBy = gpio !== null ? (gpio === "output" ? "GPIO 输出" : "GPIO 输入") : dedicated ? "BOOT0 专用脚" : "";
|
|
142
|
+
if (resolvedBy !== "" && !matched) {
|
|
143
|
+
pins.push({ number: pin.number, name: pin.name, net, signal: "", confidence: "high", candidates: candidates.slice(0, 6), note: resolvedBy + "(见 gpioPins 与说明)", source: "cubemx" });
|
|
144
|
+
if (gpio !== null && NON_GPIO.test(pin.name))
|
|
145
|
+
gpioPins.push({ pin: pin.name, signal: gpio, label: net.replace(/[^A-Za-z0-9_]/gu, "_") });
|
|
146
|
+
continue;
|
|
147
|
+
}
|
|
148
|
+
const protocol = matched ? "" : protocolOf(net);
|
|
149
|
+
const softwareOk = protocol !== "" && NON_GPIO.test(pin.name);
|
|
150
|
+
if (!matched) {
|
|
151
|
+
unresolved.push({ number: pin.number, name: pin.name, net, candidates: candidates.slice(0, 6) });
|
|
152
|
+
if (softwareOk) {
|
|
153
|
+
softwareFallbacks.push({
|
|
154
|
+
pin: pin.name,
|
|
155
|
+
net,
|
|
156
|
+
protocol,
|
|
157
|
+
suggestion: pin.name + " 配成 GPIO(" + protocol + " 模拟)",
|
|
158
|
+
tradeoff: softwareTradeoff(protocol),
|
|
159
|
+
});
|
|
160
|
+
}
|
|
161
|
+
}
|
|
162
|
+
pins.push({ number: pin.number, name: pin.name, net, signal: matched ? best : "", confidence, candidates: candidates.slice(0, 6), note, source: fromManual ? "datasheet" : "cubemx" });
|
|
163
|
+
if (gpio !== null && NON_GPIO.test(pin.name))
|
|
164
|
+
gpioPins.push({ pin: pin.name, signal: gpio, label: net.replace(/[^A-Za-z0-9_]/gu, "_") });
|
|
165
|
+
}
|
|
166
|
+
const byPeripheral = new Map();
|
|
167
|
+
for (const pin of pins) {
|
|
168
|
+
if (pin.signal === "")
|
|
169
|
+
continue;
|
|
170
|
+
const name = peripheralOf(pin.signal);
|
|
171
|
+
if (name === "" || pin.signal.startsWith("GPIO"))
|
|
172
|
+
continue;
|
|
173
|
+
const entry = byPeripheral.get(name) ?? { signals: new Set(), pins: new Set() };
|
|
174
|
+
entry.signals.add(pin.signal);
|
|
175
|
+
entry.pins.add(pin.name);
|
|
176
|
+
byPeripheral.set(name, entry);
|
|
177
|
+
}
|
|
178
|
+
if (softwareFallbacks.length > 0)
|
|
179
|
+
notes.push("有 " + String(softwareFallbacks.length) + " 处硬件复用对不上,可用软件模拟顶上;先按协议换脚更稳");
|
|
180
|
+
if (unnamed > 0)
|
|
181
|
+
notes.push("有 " + String(unnamed) + " 个脚的网络名与脚名相同(PA4 这类默认名),未计入草案");
|
|
182
|
+
if (unresolved.length > 0)
|
|
183
|
+
notes.push("有 " + String(unresolved.length) + " 个脚对不上库信号,已列在 unresolved,需按外设手册确认后再落 .ioc");
|
|
184
|
+
if (gpioPins.length > 0)
|
|
185
|
+
notes.push("gpioPins 可直接作为 stm32_ioc_plan 的 pins 入参;外设信号用 peripherals 预设");
|
|
186
|
+
return {
|
|
187
|
+
ok: true,
|
|
188
|
+
error: "",
|
|
189
|
+
mcu,
|
|
190
|
+
pins,
|
|
191
|
+
unresolved,
|
|
192
|
+
peripherals: [...byPeripheral.entries()].map(([name, entry]) => ({ name, signals: [...entry.signals], pins: [...entry.pins] })),
|
|
193
|
+
gpioPins,
|
|
194
|
+
softwareFallbacks,
|
|
195
|
+
notes,
|
|
196
|
+
};
|
|
197
|
+
}
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 引脚坐标变换:库坐标 → 图纸坐标。
|
|
3
|
+
*
|
|
4
|
+
* 库符号的 `pin (at x y)` 是 +y 向上的笛卡尔坐标,图纸是 +y 向下;符号实例再用
|
|
5
|
+
* `(at cx cy rot)` 与可选 `(mirror x|y)` 摆放。实测这套式子在样例工程上
|
|
6
|
+
* 122/145 个引脚与导线端点精确重合(0.02 mm),其余行级近似方案明显更差,
|
|
7
|
+
* 因此这里固定按「翻转 → 顺时针旋转 → 平移到实例坐标」计算。
|
|
8
|
+
*/
|
|
9
|
+
/** 把库引脚坐标摆到图纸坐标。 */
|
|
10
|
+
export function placePin(pin, symbol) {
|
|
11
|
+
let px = pin.x;
|
|
12
|
+
let py = -pin.y;
|
|
13
|
+
if (symbol.mirror === "x")
|
|
14
|
+
py = -py;
|
|
15
|
+
if (symbol.mirror === "y")
|
|
16
|
+
px = -px;
|
|
17
|
+
const degrees = ((symbol.rot % 360) + 360) % 360;
|
|
18
|
+
const radians = (degrees * Math.PI) / 180;
|
|
19
|
+
const cos = Math.cos(radians);
|
|
20
|
+
const sin = Math.sin(radians);
|
|
21
|
+
return {
|
|
22
|
+
x: symbol.at.x + px * cos + py * sin,
|
|
23
|
+
y: symbol.at.y - px * sin + py * cos,
|
|
24
|
+
};
|
|
25
|
+
}
|