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,362 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ECAD 工作区与 tscircuit 构建(S97)。
|
|
3
|
+
*
|
|
4
|
+
* 分工:
|
|
5
|
+
* circuit/ tscircuit 源码(唯一写者),package.json + lockfile 固定版本
|
|
6
|
+
* kicad/ tsci build 生成的真 KiCad 工程(每次重建、只读)
|
|
7
|
+
* libs/ 从 KiCad 库抽取的符号/封装与 3D 模型
|
|
8
|
+
* out/ gerber / step / svg 成品
|
|
9
|
+
*
|
|
10
|
+
* 为什么必须用 bun:Node 直接跑 `.tsx` 报 `Unknown file extension ".tsx"`,
|
|
11
|
+
* tsci 的 eval 走的是 bun 的 TS 加载器;KiCad 自带的 bun 正好可用。
|
|
12
|
+
*/
|
|
13
|
+
import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
|
|
14
|
+
import { basename, dirname, join } from "node:path";
|
|
15
|
+
import { runCapture } from "../subprocess-runner.js";
|
|
16
|
+
import { JLC_STANDARD, writeDru } from "./dfm.js";
|
|
17
|
+
import { normalizeKicadProject } from "./normalize.js";
|
|
18
|
+
import { applySchEdits, editStorePath, readSchEdits } from "../schematic/edit.js";
|
|
19
|
+
import { tsxPathOf, vendorJlcpcbFootprints } from "./jlcpcb.js";
|
|
20
|
+
import { ecadEnv } from "./toolchain.js";
|
|
21
|
+
export const ECAD_DIRS = ["circuit", "kicad", "libs", "out"];
|
|
22
|
+
/** 在 `hardware/` 下规划四个子目录;不建目录(初始化由 initEcadWorkspace 负责)。 */
|
|
23
|
+
const KICAD_SUBDIR_NAMES = new Set(["kicad", "pcb", "hw"]);
|
|
24
|
+
export function planEcadWorkspace(projectDir, hardwareDir) {
|
|
25
|
+
// hardwareDir 有两种形态:`hardware/`(工程自带子目录)或 `hardware/kicad`(只有 KiCad 子目录)。
|
|
26
|
+
// 后一种要回到它的上一级,否则 circuit/ 会被算成 hardware/kicad/circuit(S133)。
|
|
27
|
+
const root = hardwareDir !== ""
|
|
28
|
+
? (KICAD_SUBDIR_NAMES.has(basename(hardwareDir)) ? dirname(hardwareDir) : hardwareDir)
|
|
29
|
+
: join(projectDir, "hardware");
|
|
30
|
+
return {
|
|
31
|
+
projectDir,
|
|
32
|
+
root,
|
|
33
|
+
circuitDir: join(root, "circuit"),
|
|
34
|
+
kicadDir: join(root, "kicad"),
|
|
35
|
+
libsDir: join(root, "libs"),
|
|
36
|
+
outDir: join(root, "out"),
|
|
37
|
+
initialized: existsSync(join(root, "circuit", "package.json")),
|
|
38
|
+
};
|
|
39
|
+
}
|
|
40
|
+
/**
|
|
41
|
+
* 建目录并写最小 tscircuit 工程骨架(不装依赖)。
|
|
42
|
+
*
|
|
43
|
+
* 依赖安装单独一步(`npm i` 约 730 MB),失败也不影响后续重试;这里只保证
|
|
44
|
+
* 目录与 package.json 就位,`tsci build` 前再检查 node_modules。
|
|
45
|
+
*/
|
|
46
|
+
export function initEcadWorkspace(workspace) {
|
|
47
|
+
const created = [];
|
|
48
|
+
try {
|
|
49
|
+
for (const dir of [workspace.root, workspace.circuitDir, workspace.kicadDir, workspace.libsDir, workspace.outDir]) {
|
|
50
|
+
if (!existsSync(dir)) {
|
|
51
|
+
mkdirSync(dir, { recursive: true });
|
|
52
|
+
created.push(dir);
|
|
53
|
+
}
|
|
54
|
+
}
|
|
55
|
+
const pkgPath = join(workspace.circuitDir, "package.json");
|
|
56
|
+
if (!existsSync(pkgPath)) {
|
|
57
|
+
const pkg = {
|
|
58
|
+
name: "dsh-stm32-circuit",
|
|
59
|
+
private: true,
|
|
60
|
+
version: "0.0.0",
|
|
61
|
+
devDependencies: {
|
|
62
|
+
tscircuit: "latest",
|
|
63
|
+
typescript: "^5.0.0",
|
|
64
|
+
},
|
|
65
|
+
};
|
|
66
|
+
writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf8");
|
|
67
|
+
created.push(pkgPath);
|
|
68
|
+
}
|
|
69
|
+
return { ok: true, error: "", created, workspace };
|
|
70
|
+
}
|
|
71
|
+
catch (error) {
|
|
72
|
+
return {
|
|
73
|
+
ok: false,
|
|
74
|
+
error: "初始化 ECAD 工作区失败:" + (error instanceof Error ? error.message : String(error)),
|
|
75
|
+
created,
|
|
76
|
+
workspace,
|
|
77
|
+
};
|
|
78
|
+
}
|
|
79
|
+
}
|
|
80
|
+
function findDistRoot(circuitDir) {
|
|
81
|
+
const dist = join(circuitDir, "dist");
|
|
82
|
+
return existsSync(dist) ? dist : "";
|
|
83
|
+
}
|
|
84
|
+
/** 在 `dist/` 下找第一个含 `kicad/*.kicad_pcb` 的目录。 */
|
|
85
|
+
function findKicadProject(distRoot) {
|
|
86
|
+
const empty = { kicadDir: "", pcbSvg: "", schematicSvg: "", circuitJson: "" };
|
|
87
|
+
if (distRoot === "" || !existsSync(distRoot))
|
|
88
|
+
return empty;
|
|
89
|
+
for (const entry of readdirSync(distRoot, { withFileTypes: true })) {
|
|
90
|
+
if (!entry.isDirectory())
|
|
91
|
+
continue;
|
|
92
|
+
const dir = join(distRoot, entry.name);
|
|
93
|
+
const kicadDir = join(dir, "kicad");
|
|
94
|
+
const hasPcb = existsSync(kicadDir) && readdirSync(kicadDir).some((name) => name.endsWith(".kicad_pcb"));
|
|
95
|
+
if (!hasPcb)
|
|
96
|
+
continue;
|
|
97
|
+
return {
|
|
98
|
+
kicadDir,
|
|
99
|
+
pcbSvg: existsSync(join(dir, "pcb.svg")) ? join(dir, "pcb.svg") : "",
|
|
100
|
+
schematicSvg: existsSync(join(dir, "schematic.svg")) ? join(dir, "schematic.svg") : "",
|
|
101
|
+
circuitJson: existsSync(join(dir, "circuit.json")) ? join(dir, "circuit.json") : "",
|
|
102
|
+
};
|
|
103
|
+
}
|
|
104
|
+
return empty;
|
|
105
|
+
}
|
|
106
|
+
function tail(text, limit = 4000) {
|
|
107
|
+
return text.length <= limit ? text : text.slice(text.length - limit);
|
|
108
|
+
}
|
|
109
|
+
/**
|
|
110
|
+
* 跑一次 `tsci build`。
|
|
111
|
+
*
|
|
112
|
+
* 不自动装依赖:缺 `node_modules` 时直接给出可执行的错误,避免工具在 730 MB 的
|
|
113
|
+
* 安装上静默卡住。构建超时默认 5 分钟(首次打包较慢)。
|
|
114
|
+
*/
|
|
115
|
+
export async function runTsciBuild(request) {
|
|
116
|
+
const { subprocess, toolchain, workspace } = request;
|
|
117
|
+
const notes = [];
|
|
118
|
+
const started = Date.now();
|
|
119
|
+
const fail = (error) => ({
|
|
120
|
+
ok: false,
|
|
121
|
+
error,
|
|
122
|
+
exitCode: null,
|
|
123
|
+
timedOut: false,
|
|
124
|
+
durationMs: Date.now() - started,
|
|
125
|
+
stdoutTail: "",
|
|
126
|
+
stderrTail: "",
|
|
127
|
+
circuitJson: "",
|
|
128
|
+
pcbSvg: "",
|
|
129
|
+
schematicSvg: "",
|
|
130
|
+
kicadProjectDir: "",
|
|
131
|
+
notes,
|
|
132
|
+
});
|
|
133
|
+
if (toolchain.bun === "")
|
|
134
|
+
return fail("没找到 bun:它随 KiCad 一起安装,或用 DSH_STM32_BUN 指定");
|
|
135
|
+
if (!existsSync(join(workspace.circuitDir, "package.json"))) {
|
|
136
|
+
return fail("ECAD 工作区还没初始化:先运行 stm32_ecad_init 生成 " + workspace.circuitDir);
|
|
137
|
+
}
|
|
138
|
+
const cli = join(workspace.circuitDir, "node_modules", "tscircuit", "cli.mjs");
|
|
139
|
+
if (!existsSync(cli)) {
|
|
140
|
+
return fail("tscircuit 未安装:在 " + workspace.circuitDir + " 里执行 npm install(首次约 730 MB),再重试");
|
|
141
|
+
}
|
|
142
|
+
const argv = [toolchain.bun, cli, "build"];
|
|
143
|
+
const entry = (request.entry ?? "").trim();
|
|
144
|
+
if (entry !== "")
|
|
145
|
+
argv.push(entry);
|
|
146
|
+
argv.push("--kicad-project");
|
|
147
|
+
if (request.svgs !== false)
|
|
148
|
+
argv.push("--svgs");
|
|
149
|
+
if (request.routingDisabled === true) {
|
|
150
|
+
// 同坐标焊盘(USB-C 16P 的 A1/B12 这类)会让自动布线器放弃整板布线(S130),
|
|
151
|
+
// 这里降级为「只摆件不布线」,板子与原理图照样产出。
|
|
152
|
+
argv.push("--routing-disabled");
|
|
153
|
+
// 同坐标焊盘必然触发「间距 0 mm」的摆放检查;这不是设计错误,是封装的物理结构。
|
|
154
|
+
argv.push("--ignore-placement-drc");
|
|
155
|
+
notes.push("已跳过自动布线并忽略摆放间距检查:封装里有同坐标焊盘,布线需在 KiCad 里手工完成");
|
|
156
|
+
}
|
|
157
|
+
const outcome = await runCapture(subprocess, {
|
|
158
|
+
argv,
|
|
159
|
+
cwd: workspace.circuitDir,
|
|
160
|
+
env: ecadEnv(toolchain),
|
|
161
|
+
timeoutMs: request.timeoutMs ?? 300_000,
|
|
162
|
+
maxBytes: 1024 * 1024,
|
|
163
|
+
...(request.signal === undefined ? {} : { signal: request.signal }),
|
|
164
|
+
});
|
|
165
|
+
const distRoot = findDistRoot(workspace.circuitDir);
|
|
166
|
+
const found = findKicadProject(distRoot);
|
|
167
|
+
if (found.kicadDir !== "") {
|
|
168
|
+
// 封装名归一化:把 tscircuit 的生成名换回真库名,并把官方封装复制进工程库。
|
|
169
|
+
if (found.circuitJson !== "" && existsSync(found.circuitJson)) {
|
|
170
|
+
const normalized = normalizeKicadProject(found.kicadDir, readFileSync(found.circuitJson, "utf8"), {
|
|
171
|
+
footprintRoot: toolchain.footprintDir,
|
|
172
|
+
libsDir: workspace.libsDir,
|
|
173
|
+
});
|
|
174
|
+
if (!normalized.ok)
|
|
175
|
+
notes.push(`封装名没归一化:${normalized.renamed.length === 0 ? "电路里没有 kicad: 前缀的封装" : ""}`);
|
|
176
|
+
else if (normalized.renamed.length > 0) {
|
|
177
|
+
notes.push(`封装名归一化:${normalized.renamed.length} 个(复制官方封装 ${normalized.copied} 份)`);
|
|
178
|
+
}
|
|
179
|
+
for (const note of normalized.notes)
|
|
180
|
+
notes.push(note);
|
|
181
|
+
}
|
|
182
|
+
// 立创封装固化:出处只在电路源码里,几何在 PCB 里,两边一对才留得下来。
|
|
183
|
+
const pcbFile = readdirSync(found.kicadDir).find((name) => name.endsWith(".kicad_pcb"));
|
|
184
|
+
if (pcbFile !== undefined) {
|
|
185
|
+
const vendored = vendorJlcpcbFootprints({
|
|
186
|
+
tsxFile: tsxPathOf(workspace.circuitDir, entry),
|
|
187
|
+
pcbFile: join(found.kicadDir, pcbFile),
|
|
188
|
+
kicadDir: found.kicadDir,
|
|
189
|
+
libsDir: workspace.libsDir,
|
|
190
|
+
});
|
|
191
|
+
// 原理图编辑重放(S170):人工连线/标名存在 circuit/schematic-edits.json 里,
|
|
192
|
+
// 这里把指令画回刚生成的 .kicad_sch —— 不重放,下一次构建就会把编辑抹掉。
|
|
193
|
+
{
|
|
194
|
+
const edits = readSchEdits(editStorePath(workspace.circuitDir));
|
|
195
|
+
if (edits.length > 0) {
|
|
196
|
+
for (const name of readdirSync(found.kicadDir)) {
|
|
197
|
+
if (!name.endsWith(".kicad_sch"))
|
|
198
|
+
continue;
|
|
199
|
+
const schFile = join(found.kicadDir, name);
|
|
200
|
+
const before = readFileSync(schFile, "utf8");
|
|
201
|
+
const outcome = applySchEdits(before, schFile, edits);
|
|
202
|
+
if (!outcome.ok) {
|
|
203
|
+
notes.push("原理图编辑没重放:" + outcome.error);
|
|
204
|
+
continue;
|
|
205
|
+
}
|
|
206
|
+
if (outcome.applied > 0)
|
|
207
|
+
writeFileSync(schFile, outcome.text, "utf8");
|
|
208
|
+
if (outcome.applied > 0)
|
|
209
|
+
notes.push("原理图编辑重放:" + String(outcome.applied) + " 条");
|
|
210
|
+
for (const failure of outcome.failed)
|
|
211
|
+
notes.push("原理图编辑失败:" + failure);
|
|
212
|
+
}
|
|
213
|
+
}
|
|
214
|
+
}
|
|
215
|
+
if (vendored.ok && vendored.vendored.length > 0) {
|
|
216
|
+
notes.push("立创封装固化:" + String(vendored.vendored.length) + " 个(" + vendored.vendored.map((item) => "C" + item.code).join("、") + ")");
|
|
217
|
+
}
|
|
218
|
+
for (const note of vendored.notes)
|
|
219
|
+
notes.push(note);
|
|
220
|
+
if (!vendored.ok)
|
|
221
|
+
notes.push("立创封装没固化:" + vendored.error);
|
|
222
|
+
}
|
|
223
|
+
// 把嘉立创工艺写进工程的设计规则:之后跑 kicad-cli pcb drc 用的就是打板判据。
|
|
224
|
+
const dru = writeDru(found.kicadDir);
|
|
225
|
+
if (!dru.ok)
|
|
226
|
+
notes.push(`设计规则没写进 KiCad 工程:${dru.error}`);
|
|
227
|
+
else
|
|
228
|
+
notes.push(`设计规则:${basename(dru.file)}(线宽 ${JLC_STANDARD.minTrackMm} mm、孔径 ${JLC_STANDARD.minDrillMm} mm)`);
|
|
229
|
+
}
|
|
230
|
+
const ok = outcome.exitCode === 0 && found.kicadDir !== "";
|
|
231
|
+
if (outcome.exitCode === 0 && found.kicadDir === "") {
|
|
232
|
+
notes.push("构建命令成功但没有找到 dist/<name>/kicad/*.kicad_pcb:检查入口文件是否导出 board");
|
|
233
|
+
}
|
|
234
|
+
if (outcome.timedOut)
|
|
235
|
+
notes.push("构建超时:tscircuit 未在限制时间内完成");
|
|
236
|
+
return {
|
|
237
|
+
ok,
|
|
238
|
+
error: ok ? "" : (outcome.spawnError ?? tail(outcome.stderr)) || "tscircuit 构建失败",
|
|
239
|
+
exitCode: outcome.exitCode,
|
|
240
|
+
timedOut: outcome.timedOut,
|
|
241
|
+
durationMs: Date.now() - started,
|
|
242
|
+
stdoutTail: tail(outcome.stdout),
|
|
243
|
+
stderrTail: tail(outcome.stderr),
|
|
244
|
+
circuitJson: found.circuitJson,
|
|
245
|
+
pcbSvg: found.pcbSvg,
|
|
246
|
+
schematicSvg: found.schematicSvg,
|
|
247
|
+
kicadProjectDir: found.kicadDir,
|
|
248
|
+
notes,
|
|
249
|
+
};
|
|
250
|
+
}
|
|
251
|
+
/** 列出 `circuit/` 下的入口候选(`*.circuit.tsx`,按名字排序)。 */
|
|
252
|
+
export function listCircuitEntries(circuitDir) {
|
|
253
|
+
if (!existsSync(circuitDir))
|
|
254
|
+
return [];
|
|
255
|
+
return readdirSync(circuitDir, { withFileTypes: true })
|
|
256
|
+
.filter((entry) => entry.isFile() && entry.name.endsWith(".circuit.tsx"))
|
|
257
|
+
.map((entry) => entry.name)
|
|
258
|
+
.sort();
|
|
259
|
+
}
|
|
260
|
+
/**
|
|
261
|
+
* 布线器的工作目录与派生板子不算「最近一次构建」。
|
|
262
|
+
*
|
|
263
|
+
* KiCadRoutingTools 把每一步的中间结果写在 `<板名>.kicad_pcb.autoroute/` 下(`step04_route.kicad_pcb`
|
|
264
|
+
* 这类文件比成品板新),不排除掉的话面板与工具报的「最近构建」会指向中间步骤——那份板子没有
|
|
265
|
+
* 原理图、也不是最终产物。
|
|
266
|
+
*/
|
|
267
|
+
function isRouterWorkingPath(name) {
|
|
268
|
+
return name.includes(".autoroute") || name.endsWith(".auto.kicad_pcb") || name.endsWith(".norm.kicad_pcb");
|
|
269
|
+
}
|
|
270
|
+
/** 在若干根目录下找最新的 `.kicad_pcb`,同目录里的 `.kicad_sch` 一并返回。 */
|
|
271
|
+
function newestKicadProject(roots) {
|
|
272
|
+
let best = null;
|
|
273
|
+
const stack = roots.filter((root) => existsSync(root));
|
|
274
|
+
while (stack.length > 0) {
|
|
275
|
+
const current = stack.pop();
|
|
276
|
+
let entries;
|
|
277
|
+
try {
|
|
278
|
+
entries = readdirSync(current, { withFileTypes: true });
|
|
279
|
+
}
|
|
280
|
+
catch {
|
|
281
|
+
continue;
|
|
282
|
+
}
|
|
283
|
+
for (const entry of entries) {
|
|
284
|
+
if (entry.name.startsWith(".") || isRouterWorkingPath(entry.name))
|
|
285
|
+
continue;
|
|
286
|
+
const path = join(current, entry.name);
|
|
287
|
+
if (entry.isDirectory()) {
|
|
288
|
+
stack.push(path);
|
|
289
|
+
continue;
|
|
290
|
+
}
|
|
291
|
+
if (!entry.name.endsWith(".kicad_pcb"))
|
|
292
|
+
continue;
|
|
293
|
+
let mtimeMs = 0;
|
|
294
|
+
try {
|
|
295
|
+
mtimeMs = statSync(path).mtimeMs;
|
|
296
|
+
}
|
|
297
|
+
catch {
|
|
298
|
+
continue;
|
|
299
|
+
}
|
|
300
|
+
// 同一毫秒内写完的两份产物在 Windows 上时间戳可能相等;相等时按路径字典序定胜负,
|
|
301
|
+
// 否则遍历顺序(readdir 的实现细节)会让「取最新」变成不确定的行为。
|
|
302
|
+
if (best !== null && (mtimeMs < best.mtimeMs || (mtimeMs === best.mtimeMs && path <= best.pcbFile)))
|
|
303
|
+
continue;
|
|
304
|
+
const schematicFile = readdirSync(current)
|
|
305
|
+
.filter((name) => name.endsWith(".kicad_sch"))
|
|
306
|
+
.map((name) => join(current, name))
|
|
307
|
+
.sort()[0];
|
|
308
|
+
best = { kicadDir: current, pcbFile: path, schematicFile: schematicFile ?? "", mtimeMs };
|
|
309
|
+
}
|
|
310
|
+
}
|
|
311
|
+
return best === null ? null : { kicadDir: best.kicadDir, pcbFile: best.pcbFile, schematicFile: best.schematicFile };
|
|
312
|
+
}
|
|
313
|
+
/**
|
|
314
|
+
* 取最近一次构建产出的 KiCad 工程。
|
|
315
|
+
*
|
|
316
|
+
* 先看 `hardware/kicad/`(成品拷贝),再看 `circuit/dist/`(tsci 的原始产物);
|
|
317
|
+
* 两边都没有时给一句能照着做的错误,而不是让调用方拿到空路径。
|
|
318
|
+
*/
|
|
319
|
+
export function findLatestKicadBuild(workspace) {
|
|
320
|
+
const found = newestKicadProject([workspace.kicadDir, join(workspace.circuitDir, "dist")]);
|
|
321
|
+
if (found === null) {
|
|
322
|
+
return {
|
|
323
|
+
ok: false,
|
|
324
|
+
error: "还没有可用的 KiCad 工程:先跑一次 stm32_ecad_build(在 hardware/circuit 下生成 dist/<name>/kicad)",
|
|
325
|
+
kicadDir: "",
|
|
326
|
+
pcbFile: "",
|
|
327
|
+
schematicFile: "",
|
|
328
|
+
};
|
|
329
|
+
}
|
|
330
|
+
return { ok: true, error: "", ...found };
|
|
331
|
+
}
|
|
332
|
+
/** 目录大小(字节):用于初始化报告里说明 node_modules 占位。 */
|
|
333
|
+
export function dirSizeBytes(dir) {
|
|
334
|
+
if (!existsSync(dir))
|
|
335
|
+
return 0;
|
|
336
|
+
let total = 0;
|
|
337
|
+
const stack = [dir];
|
|
338
|
+
while (stack.length > 0) {
|
|
339
|
+
const current = stack.pop();
|
|
340
|
+
let entries;
|
|
341
|
+
try {
|
|
342
|
+
entries = readdirSync(current, { withFileTypes: true });
|
|
343
|
+
}
|
|
344
|
+
catch {
|
|
345
|
+
continue;
|
|
346
|
+
}
|
|
347
|
+
for (const entry of entries) {
|
|
348
|
+
const path = join(current, entry.name);
|
|
349
|
+
if (entry.isDirectory())
|
|
350
|
+
stack.push(path);
|
|
351
|
+
else {
|
|
352
|
+
try {
|
|
353
|
+
total += statSync(path).size;
|
|
354
|
+
}
|
|
355
|
+
catch {
|
|
356
|
+
/* 忽略读不到的文件 */
|
|
357
|
+
}
|
|
358
|
+
}
|
|
359
|
+
}
|
|
360
|
+
}
|
|
361
|
+
return total;
|
|
362
|
+
}
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
/** 最小 zip 打包器:只做 STORE(不压缩),够交付用,不引入依赖。 */
|
|
2
|
+
import { Buffer } from "node:buffer";
|
|
3
|
+
const CRC_TABLE = (() => {
|
|
4
|
+
const table = new Uint32Array(256);
|
|
5
|
+
for (let index = 0; index < 256; index += 1) {
|
|
6
|
+
let value = index;
|
|
7
|
+
for (let bit = 0; bit < 8; bit += 1) {
|
|
8
|
+
value = (value & 1) === 1 ? 0xedb88320 ^ (value >>> 1) : value >>> 1;
|
|
9
|
+
}
|
|
10
|
+
table[index] = value >>> 0;
|
|
11
|
+
}
|
|
12
|
+
return table;
|
|
13
|
+
})();
|
|
14
|
+
function crc32(data) {
|
|
15
|
+
let value = 0xffffffff;
|
|
16
|
+
for (let index = 0; index < data.length; index += 1) {
|
|
17
|
+
value = (CRC_TABLE[(value ^ (data[index] ?? 0)) & 0xff] ?? 0) ^ (value >>> 8);
|
|
18
|
+
}
|
|
19
|
+
return (value ^ 0xffffffff) >>> 0;
|
|
20
|
+
}
|
|
21
|
+
function dosTime(date) {
|
|
22
|
+
const time = ((date.getHours() & 0x1f) << 11) | ((date.getMinutes() & 0x3f) << 5) | ((date.getSeconds() / 2) & 0x1f);
|
|
23
|
+
const day = (((date.getFullYear() - 1980) & 0x7f) << 9) | (((date.getMonth() + 1) & 0x0f) << 5) | (date.getDate() & 0x1f);
|
|
24
|
+
return { time: time, date: day };
|
|
25
|
+
}
|
|
26
|
+
/**
|
|
27
|
+
* 生成一个 zip(STORE)。条目名用 POSIX 分隔符,调用方负责保证相对路径。
|
|
28
|
+
* 只支持 UTF-8 文件名与普通文件;目录条目由调用方按需加入(以 / 结尾)。
|
|
29
|
+
*/
|
|
30
|
+
export function createZip(entries, now = new Date()) {
|
|
31
|
+
const chunks = [];
|
|
32
|
+
const central = [];
|
|
33
|
+
let offset = 0;
|
|
34
|
+
const stamp = dosTime(now);
|
|
35
|
+
for (const entry of entries) {
|
|
36
|
+
const name = Buffer.from(entry.name.replace(/\\/gu, "/"), "utf8");
|
|
37
|
+
const data = entry.data;
|
|
38
|
+
const checksum = crc32(data);
|
|
39
|
+
const local = Buffer.alloc(30);
|
|
40
|
+
local.writeUInt32LE(0x04034b50, 0);
|
|
41
|
+
local.writeUInt16LE(20, 4);
|
|
42
|
+
local.writeUInt16LE(0x0800, 6);
|
|
43
|
+
local.writeUInt16LE(0, 8);
|
|
44
|
+
local.writeUInt16LE(stamp.time, 10);
|
|
45
|
+
local.writeUInt16LE(stamp.date, 12);
|
|
46
|
+
local.writeUInt32LE(checksum, 14);
|
|
47
|
+
local.writeUInt32LE(data.length, 18);
|
|
48
|
+
local.writeUInt32LE(data.length, 22);
|
|
49
|
+
local.writeUInt16LE(name.length, 26);
|
|
50
|
+
local.writeUInt16LE(0, 28);
|
|
51
|
+
chunks.push(local, name, data);
|
|
52
|
+
const header = Buffer.alloc(46);
|
|
53
|
+
header.writeUInt32LE(0x02014b50, 0);
|
|
54
|
+
header.writeUInt16LE(20, 4);
|
|
55
|
+
header.writeUInt16LE(20, 6);
|
|
56
|
+
header.writeUInt16LE(0x0800, 8);
|
|
57
|
+
header.writeUInt16LE(0, 10);
|
|
58
|
+
header.writeUInt16LE(stamp.time, 12);
|
|
59
|
+
header.writeUInt16LE(stamp.date, 14);
|
|
60
|
+
header.writeUInt32LE(checksum, 16);
|
|
61
|
+
header.writeUInt32LE(data.length, 20);
|
|
62
|
+
header.writeUInt32LE(data.length, 24);
|
|
63
|
+
header.writeUInt16LE(name.length, 28);
|
|
64
|
+
header.writeUInt16LE(0, 30);
|
|
65
|
+
header.writeUInt16LE(0, 32);
|
|
66
|
+
header.writeUInt16LE(0, 34);
|
|
67
|
+
header.writeUInt16LE(0, 36);
|
|
68
|
+
header.writeUInt32LE(0, 38);
|
|
69
|
+
header.writeUInt32LE(offset, 42);
|
|
70
|
+
central.push(header, name);
|
|
71
|
+
offset += 30 + name.length + data.length;
|
|
72
|
+
}
|
|
73
|
+
const centralSize = central.reduce((sum, item) => sum + item.length, 0);
|
|
74
|
+
const end = Buffer.alloc(22);
|
|
75
|
+
end.writeUInt32LE(0x06054b50, 0);
|
|
76
|
+
end.writeUInt16LE(0, 4);
|
|
77
|
+
end.writeUInt16LE(0, 6);
|
|
78
|
+
end.writeUInt16LE(entries.length, 8);
|
|
79
|
+
end.writeUInt16LE(entries.length, 10);
|
|
80
|
+
end.writeUInt32LE(centralSize, 12);
|
|
81
|
+
end.writeUInt32LE(offset, 16);
|
|
82
|
+
end.writeUInt16LE(0, 20);
|
|
83
|
+
return Buffer.concat([...chunks, ...central, end]);
|
|
84
|
+
}
|
|
85
|
+
/** 读回条目名与大小(只用于自检与测试,不做解压)。 */
|
|
86
|
+
export function listZipEntries(buffer) {
|
|
87
|
+
const result = [];
|
|
88
|
+
let index = 0;
|
|
89
|
+
while (index + 30 <= buffer.length && buffer.readUInt32LE(index) === 0x04034b50) {
|
|
90
|
+
const size = buffer.readUInt32LE(index + 18);
|
|
91
|
+
const nameLength = buffer.readUInt16LE(index + 26);
|
|
92
|
+
const extraLength = buffer.readUInt16LE(index + 28);
|
|
93
|
+
const name = buffer.subarray(index + 30, index + 30 + nameLength).toString("utf8");
|
|
94
|
+
result.push({ name: name, size: size });
|
|
95
|
+
index += 30 + nameLength + extraLength + size;
|
|
96
|
+
}
|
|
97
|
+
return result;
|
|
98
|
+
}
|
|
@@ -0,0 +1,158 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 调试台的事件总线:把工具调用、面板操作与设备副作用收敛成一条带序号的流。
|
|
3
|
+
*
|
|
4
|
+
* 设计取舍:
|
|
5
|
+
* - 单一事实源。时间线、SSE 推流、证据目录都读这一份事件,面板不各自记账,
|
|
6
|
+
* 所以「模型做了什么」与「用户看到什么」不会分叉。
|
|
7
|
+
* - 只保留最近 5000 条(环形)。RTT 与串口已按窗口汇总,剩下的条目量级在千级,
|
|
8
|
+
* 5000 条足够回看一整轮联调,内存占用保持在兆级以内。
|
|
9
|
+
* - 被挤出的条目不是直接丢弃,而是交给 event-log.ts 定期落盘(默认 30 秒一批),
|
|
10
|
+
* 于是「内存里只留近期」与「证据目录里的完整记录」同时成立。
|
|
11
|
+
*
|
|
12
|
+
* 本模块是纯内存实现:不碰文件系统、不碰定时器,可在单测里直接驱动。
|
|
13
|
+
*/
|
|
14
|
+
/** 内存里保留的事件条数。 */
|
|
15
|
+
export const EVENT_RING_LIMIT = 5000;
|
|
16
|
+
/** 单条事件 payload 的序列化上限(字节)。超出时保留预览并标记截断。 */
|
|
17
|
+
export const EVENT_PAYLOAD_LIMIT = 8192;
|
|
18
|
+
/** 等待落盘的挤出条目上限;落盘通道卡住时丢弃最旧的,并留一条缺口事件。 */
|
|
19
|
+
export const EVENT_PENDING_LIMIT = 2000;
|
|
20
|
+
const ring = [];
|
|
21
|
+
let pending = [];
|
|
22
|
+
let pendingDropped = 0;
|
|
23
|
+
let nextSeq = 1;
|
|
24
|
+
let sessionKey = "";
|
|
25
|
+
const listeners = new Set();
|
|
26
|
+
function trimmedPayload(payload) {
|
|
27
|
+
if (payload === undefined)
|
|
28
|
+
return { payload: undefined, truncated: false };
|
|
29
|
+
let text;
|
|
30
|
+
try {
|
|
31
|
+
text = JSON.stringify(payload);
|
|
32
|
+
}
|
|
33
|
+
catch {
|
|
34
|
+
return { payload: { note: "payload 含无法序列化的值,已省略" }, truncated: true };
|
|
35
|
+
}
|
|
36
|
+
if (text.length <= EVENT_PAYLOAD_LIMIT)
|
|
37
|
+
return { payload, truncated: false };
|
|
38
|
+
return {
|
|
39
|
+
payload: { preview: text.slice(0, EVENT_PAYLOAD_LIMIT - 32) },
|
|
40
|
+
truncated: true,
|
|
41
|
+
};
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
* 追加一条事件。
|
|
45
|
+
*
|
|
46
|
+
* 序号由总线分配,调用方不要自己造:面板按 seq 增量拉取,自己造的序号会让续播错位。
|
|
47
|
+
*/
|
|
48
|
+
export function emitEvent(input) {
|
|
49
|
+
const trimmed = trimmedPayload(input.payload);
|
|
50
|
+
const event = {
|
|
51
|
+
seq: nextSeq,
|
|
52
|
+
time: new Date().toISOString(),
|
|
53
|
+
source: input.source,
|
|
54
|
+
kind: input.kind,
|
|
55
|
+
status: input.status ?? "info",
|
|
56
|
+
summary: input.summary,
|
|
57
|
+
};
|
|
58
|
+
if (trimmed.payload !== undefined)
|
|
59
|
+
event.payload = trimmed.payload;
|
|
60
|
+
if (trimmed.truncated)
|
|
61
|
+
event.truncated = true;
|
|
62
|
+
if (input.refs !== undefined && input.refs.length > 0)
|
|
63
|
+
event.refs = input.refs;
|
|
64
|
+
const owner = (input.session ?? sessionKey).trim();
|
|
65
|
+
if (owner !== "")
|
|
66
|
+
event.session = owner;
|
|
67
|
+
nextSeq += 1;
|
|
68
|
+
ring.push(event);
|
|
69
|
+
if (ring.length > EVENT_RING_LIMIT) {
|
|
70
|
+
const overflow = ring.splice(0, ring.length - EVENT_RING_LIMIT);
|
|
71
|
+
for (const item of overflow)
|
|
72
|
+
pending.push(item);
|
|
73
|
+
if (pending.length > EVENT_PENDING_LIMIT) {
|
|
74
|
+
pendingDropped += pending.length - EVENT_PENDING_LIMIT;
|
|
75
|
+
pending = pending.slice(pending.length - EVENT_PENDING_LIMIT);
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
for (const listener of listeners) {
|
|
79
|
+
try {
|
|
80
|
+
listener(event);
|
|
81
|
+
}
|
|
82
|
+
catch {
|
|
83
|
+
// 订阅方自己出错不影响其它订阅方,也不该让工具调用失败。
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
return event;
|
|
87
|
+
}
|
|
88
|
+
/** 订阅新事件,返回注销函数。 */
|
|
89
|
+
export function subscribeEvents(listener) {
|
|
90
|
+
listeners.add(listener);
|
|
91
|
+
return () => {
|
|
92
|
+
listeners.delete(listener);
|
|
93
|
+
};
|
|
94
|
+
}
|
|
95
|
+
/**
|
|
96
|
+
* 取序号大于 since 的事件(按 seq 升序)。
|
|
97
|
+
* 传 session 时只返回该会话的事件;不传则返回全部(单会话时面板不传也能用)。
|
|
98
|
+
*/
|
|
99
|
+
export function eventSnapshot(since = 0, session) {
|
|
100
|
+
const wanted = (session ?? "").trim();
|
|
101
|
+
const base = since <= 0 ? ring.slice() : ring.filter((event) => event.seq > since);
|
|
102
|
+
if (wanted === "")
|
|
103
|
+
return base;
|
|
104
|
+
return base.filter((event) => event.session === wanted);
|
|
105
|
+
}
|
|
106
|
+
/** 内存里当前保留的事件条数(面板与诊断用);传 session 时只数该会话的。 */
|
|
107
|
+
export function eventCount(session) {
|
|
108
|
+
const wanted = (session ?? "").trim();
|
|
109
|
+
if (wanted === "")
|
|
110
|
+
return ring.length;
|
|
111
|
+
return ring.reduce((total, event) => (event.session === wanted ? total + 1 : total), 0);
|
|
112
|
+
}
|
|
113
|
+
/** 取走待落盘的挤出事件;调用方负责写入成功后再确认。 */
|
|
114
|
+
export function drainEvicted() {
|
|
115
|
+
const drained = pending;
|
|
116
|
+
pending = [];
|
|
117
|
+
return drained;
|
|
118
|
+
}
|
|
119
|
+
/** 把落盘失败的条目放回队首(维持时间顺序),供下一轮重试。 */
|
|
120
|
+
export function requeueEvicted(events) {
|
|
121
|
+
if (events.length === 0)
|
|
122
|
+
return;
|
|
123
|
+
pending = events.concat(pending);
|
|
124
|
+
if (pending.length > EVENT_PENDING_LIMIT) {
|
|
125
|
+
pendingDropped += pending.length - EVENT_PENDING_LIMIT;
|
|
126
|
+
pending = pending.slice(pending.length - EVENT_PENDING_LIMIT);
|
|
127
|
+
}
|
|
128
|
+
}
|
|
129
|
+
/** 因落盘积压被丢弃的条数,写进缺口事件,避免证据目录看起来连续其实是断的。 */
|
|
130
|
+
export function takeDroppedCount() {
|
|
131
|
+
const count = pendingDropped;
|
|
132
|
+
pendingDropped = 0;
|
|
133
|
+
return count;
|
|
134
|
+
}
|
|
135
|
+
/**
|
|
136
|
+
* 绑定会话键:证据目录按它分目录,做到「一个会话一个目录」。
|
|
137
|
+
*
|
|
138
|
+
* 工具执行时能拿到 agent id,面板能拿到 session id,两者谁先到就用谁;
|
|
139
|
+
* 都没绑定时退回进程级默认键,事件照样可用,只是目录不按会话切分。
|
|
140
|
+
*/
|
|
141
|
+
export function setEventSessionKey(key) {
|
|
142
|
+
const normalized = key.trim();
|
|
143
|
+
if (normalized === "" || normalized === sessionKey)
|
|
144
|
+
return;
|
|
145
|
+
sessionKey = normalized;
|
|
146
|
+
}
|
|
147
|
+
export function eventSessionKey() {
|
|
148
|
+
return sessionKey;
|
|
149
|
+
}
|
|
150
|
+
/** 单测用:清空全部状态。 */
|
|
151
|
+
export function resetEventBus() {
|
|
152
|
+
ring.length = 0;
|
|
153
|
+
pending = [];
|
|
154
|
+
pendingDropped = 0;
|
|
155
|
+
nextSeq = 1;
|
|
156
|
+
sessionKey = "";
|
|
157
|
+
listeners.clear();
|
|
158
|
+
}
|