dsh-stm32 0.1.0 → 0.1.2

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.
Files changed (82) hide show
  1. package/README.md +127 -29
  2. package/README_EN.md +125 -29
  3. package/client/client.js +682 -0
  4. package/docs/development-notes.md +1385 -5
  5. package/docs/logic-audit.md +607 -0
  6. package/docs/reading-guide.md +738 -0
  7. package/lib/client.js +682 -0
  8. package/lib/commands/register.js +214 -12
  9. package/lib/data/chips.js +134 -4
  10. package/lib/data/clock-f1.js +158 -0
  11. package/lib/data/cmsis-sources.js +316 -0
  12. package/lib/data/f1-ram.generated.js +34 -0
  13. package/lib/data/firmware-packages.js +352 -0
  14. package/lib/data/install-guides.js +190 -0
  15. package/lib/data/search-roots.js +135 -15
  16. package/lib/data/stm32f1.js +186 -0
  17. package/lib/data/toolchain-config.js +310 -0
  18. package/lib/engine/build.js +121 -16
  19. package/lib/engine/cache.js +336 -0
  20. package/lib/engine/clock-plan.js +608 -0
  21. package/lib/engine/cmake-sources.js +428 -0
  22. package/lib/engine/code-patch.js +18 -6
  23. package/lib/engine/debug-session.js +163 -4
  24. package/lib/engine/debug.js +84 -19
  25. package/lib/engine/doctor.js +395 -4
  26. package/lib/engine/fetch.js +287 -0
  27. package/lib/engine/firmware-install.js +668 -0
  28. package/lib/engine/flash.js +145 -15
  29. package/lib/engine/fs-longpath.js +107 -0
  30. package/lib/engine/generate-cache.js +118 -0
  31. package/lib/engine/generate-script.js +30 -8
  32. package/lib/engine/generate.js +296 -14
  33. package/lib/engine/hal-chip.js +230 -0
  34. package/lib/engine/ioc-plan.js +47 -8
  35. package/lib/engine/msys2-install.js +1870 -0
  36. package/lib/engine/probe.js +57 -6
  37. package/lib/engine/project-export.js +129 -0
  38. package/lib/engine/register-clock.js +132 -0
  39. package/lib/engine/register-linker.js +129 -0
  40. package/lib/engine/register-template.js +449 -0
  41. package/lib/engine/regs.js +18 -4
  42. package/lib/engine/route-plan.js +553 -0
  43. package/lib/engine/scaffold.js +303 -72
  44. package/lib/engine/subprocess-runner.js +2 -0
  45. package/lib/engine/tar.js +250 -0
  46. package/lib/engine/text-file.js +150 -0
  47. package/lib/engine/thirdparty.js +243 -0
  48. package/lib/engine/tool-env.js +51 -0
  49. package/lib/engine/toolchain-gate.js +386 -0
  50. package/lib/engine/vscode-config.js +99 -0
  51. package/lib/engine/web-api.js +375 -0
  52. package/lib/engine/web-routes.js +100 -0
  53. package/lib/engine/xcube-catalog.js +102 -0
  54. package/lib/engine/xcube.js +254 -0
  55. package/lib/engine/zip.js +142 -0
  56. package/lib/index.js +44 -2
  57. package/lib/skill/stm32-workflow.js +3 -3
  58. package/lib/tools/build.js +55 -3
  59. package/lib/tools/cache.js +250 -0
  60. package/lib/tools/code-patch.js +29 -2
  61. package/lib/tools/debug-session.js +56 -14
  62. package/lib/tools/debug.js +43 -2
  63. package/lib/tools/doctor.js +16 -3
  64. package/lib/tools/env-install.js +472 -0
  65. package/lib/tools/env-probe.js +6 -2
  66. package/lib/tools/firmware-install.js +255 -0
  67. package/lib/tools/flash.js +41 -2
  68. package/lib/tools/generate.js +96 -10
  69. package/lib/tools/ioc-apply.js +27 -11
  70. package/lib/tools/ioc-inspect.js +4 -2
  71. package/lib/tools/ioc-plan.js +209 -11
  72. package/lib/tools/project-create.js +229 -21
  73. package/lib/tools/project-dir.js +95 -0
  74. package/lib/tools/project-export.js +100 -0
  75. package/lib/tools/regs.js +82 -7
  76. package/lib/tools/route-plan.js +467 -0
  77. package/package.json +11 -4
  78. package/templates/register/CMakeLists.txt +52 -0
  79. package/templates/register/Core/Src/main.c +72 -0
  80. package/templates/scaffold/openocd.cfg +8 -0
  81. package/templates/scaffold/vscode/launch.json +8 -6
  82. package/templates/scaffold/vscode/settings.json +5 -11
@@ -10,12 +10,19 @@
10
10
  * 这里不做工具注册、不做 job 管理,只接收 onProgress 回调,便于在终端直接跑。
11
11
  */
12
12
  import { copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, rmdirSync, rmSync, writeFileSync } from "node:fs";
13
+ import { hostname } from "node:os";
13
14
  import { basename, dirname, join, relative, resolve } from "node:path";
15
+ import { firmwareNeedFromIoc, firmwareSourceLabel, locateFirmwarePackage, } from "../data/firmware-packages.js";
14
16
  import { describeSearchScope, resolveSearchConfig } from "../data/search-roots.js";
15
17
  import { buildGenerateScript, parseGenerateLog } from "./generate-script.js";
18
+ import { firmwareExtraDirs } from "./firmware-install.js";
19
+ import { describeRefresh, refreshCubemxCmakeLists } from "./cmake-sources.js";
20
+ import { cacheHit, cacheKeyFor, entryFromFiles, readCache, writeCache } from "./generate-cache.js";
21
+ import { cubeMxUserHome, needsThirdpartyPacks, parkThirdpartyDb } from "./thirdparty.js";
16
22
  import { listGeneratedFiles, mapGeneratedPath } from "./layout.js";
17
23
  import { canMergeUserCode, mergeUserCode } from "./usercode-merge.js";
18
24
  import { runStreaming } from "./subprocess-runner.js";
25
+ import { readTextFile } from "./text-file.js";
19
26
  /** 工程内保存插件自身状态(锁、备份、临时脚本)的目录。 */
20
27
  export const STATE_DIR = ".dsh-stm32";
21
28
  function nowStamp() {
@@ -30,6 +37,12 @@ function fail(request, message, extra = {}) {
30
37
  iocPath: "",
31
38
  layout: request.layout === undefined || request.layout === "auto" ? "coupled" : request.layout,
32
39
  durationMs: 0,
40
+ skipped: false,
41
+ cacheKey: "",
42
+ thirdparty: { parked: false, detail: "" },
43
+ firmwareDir: "",
44
+ firmwarePackage: "",
45
+ firmwareSource: "",
33
46
  verdict: { ok: false, successLine: "", errors: [], knownNoise: [] },
34
47
  script: "",
35
48
  command: "",
@@ -50,6 +63,32 @@ export function findIocFile(projectDir) {
50
63
  return null;
51
64
  return join(projectDir, names[0]);
52
65
  }
66
+ /**
67
+ * 产物判据(审计 A10)。CubeMX 缺包或包版本不认时会照样打「Code succesfully generated」,
68
+ * 只是不拷 HAL —— 所以日志成功行不能当成功。这里按磁盘上的东西再判一次。
69
+ */
70
+ export function assessGenerateProducts(projectDir, appliedCount) {
71
+ const problems = [];
72
+ if (appliedCount === 0)
73
+ problems.push("没有任何产物落位");
74
+ if (!existsSync(join(projectDir, "Core", "Src", "main.c")))
75
+ problems.push("没有 Core/Src/main.c");
76
+ // 工程自带 HAL 目录(脚手架拷过、或用过 LibraryCopy)时,Src 不能是空的:
77
+ // 那正是「CubeMX 没认到固件包」的痕迹。
78
+ const drivers = join(projectDir, "Drivers");
79
+ if (existsSync(drivers)) {
80
+ for (const entry of readdirSync(drivers, { withFileTypes: true })) {
81
+ if (!entry.isDirectory() || !/_HAL_Driver$/u.test(entry.name))
82
+ continue;
83
+ const src = join(drivers, entry.name, "Src");
84
+ const cFiles = existsSync(src) ? readdirSync(src).filter((name) => name.toLowerCase().endsWith(".c")).length : 0;
85
+ if (cFiles === 0) {
86
+ problems.push("工程里有 Drivers/" + entry.name + " 但 Src 下没有 .c 文件:CubeMX 多半没认到固件包(日志照样会打成功行)");
87
+ }
88
+ }
89
+ }
90
+ return { ok: problems.length === 0, problems };
91
+ }
53
92
  /**
54
93
  * 推断生成布局:现有 main.c 里出现形如 USER CODE BEGIN MX_GPIO_Init_1 的标签
55
94
  * 说明工程用的是"外设初始化并入 main.c"的耦合布局(ST VS Code 扩展默认)。
@@ -61,15 +100,33 @@ export function detectLayout(projectDir) {
61
100
  const text = readFileSync(mainC, "utf8");
62
101
  return /\/\* USER CODE BEGIN MX_[A-Za-z0-9_]+_1 \*\//u.test(text) ? "coupled" : "per-ip";
63
102
  }
103
+ const LOCK_HOST = hostname();
104
+ /** A14:锁里记的 pid 还活着吗。EPERM 说明进程在(只是不归我们管),按活着算。 */
105
+ export function isProcessAlive(pid) {
106
+ if (!Number.isInteger(pid) || pid <= 0)
107
+ return false;
108
+ try {
109
+ process.kill(pid, 0);
110
+ return true;
111
+ }
112
+ catch (error) {
113
+ return error.code === "EPERM";
114
+ }
115
+ }
64
116
  function acquireLock(projectDir, purpose) {
65
117
  const dir = join(projectDir, STATE_DIR);
66
118
  mkdirSync(dir, { recursive: true });
67
119
  const lockPath = join(dir, "lock.json");
120
+ let staleNote;
68
121
  if (existsSync(lockPath)) {
69
122
  try {
70
123
  const info = JSON.parse(readFileSync(lockPath, "utf8"));
71
124
  const age = Date.now() - info.startedAt;
72
- if (age < 30 * 60 * 1000) {
125
+ // A14:以前只看时间,DSH 崩溃/断电后 30 分钟内所有生成都被挡,要用户手删锁文件。
126
+ // 现在同时看进程是否活着;锁文件从别的机器拷来时 pid 没有参考价值,直接按陈旧处理。
127
+ const sameHost = info.host === undefined || info.host === "" || info.host === LOCK_HOST;
128
+ const alive = sameHost && isProcessAlive(info.pid);
129
+ if (age < 30 * 60 * 1000 && alive) {
73
130
  return {
74
131
  error: "已有任务占用 CubeMX 单飞锁:" +
75
132
  String(info.purpose) +
@@ -82,12 +139,19 @@ function acquireLock(projectDir, purpose) {
82
139
  " 后重试。",
83
140
  };
84
141
  }
142
+ staleNote =
143
+ "接管了上次没释放的 CubeMX 单飞锁(" +
144
+ String(info.purpose) +
145
+ ",pid " +
146
+ String(info.pid) +
147
+ (sameHost ? ",进程已不在" : ",来自另一台机器 " + String(info.host)) +
148
+ ")";
85
149
  }
86
150
  catch {
87
151
  // 锁文件损坏按陈旧处理
88
152
  }
89
153
  }
90
- const info = { pid: process.pid, startedAt: Date.now(), purpose };
154
+ const info = { pid: process.pid, startedAt: Date.now(), purpose, host: LOCK_HOST };
91
155
  writeFileSync(lockPath, JSON.stringify(info, null, 1), "utf8");
92
156
  return {
93
157
  release: () => {
@@ -98,6 +162,7 @@ function acquireLock(projectDir, purpose) {
98
162
  // 释放失败不影响结论
99
163
  }
100
164
  },
165
+ ...(staleNote === undefined ? {} : { note: staleNote }),
101
166
  };
102
167
  }
103
168
  function cubeMxLaunch(cubeMxRoots) {
@@ -131,22 +196,46 @@ function applyGeneratedFiles(projectDir, generated, backupRoot, dryRun) {
131
196
  }
132
197
  const sourceAbs = join(projectDir, source);
133
198
  const targetAbs = join(projectDir, target);
134
- const newText = readFileSync(sourceAbs, "utf8");
199
+ // CubeMX 的产物是 UTF-8;旧文件可能是 Keil 编辑过的 GB18030(审计 B2)。
200
+ const newFile = readTextFile(sourceAbs);
201
+ if (!newFile.ok) {
202
+ files.push({ source, target, action: "skipped-encoding", preserved: [], droppedLabels: [] });
203
+ notes.push(target + " 的生成物读不了(" + newFile.error + "),未覆盖");
204
+ continue;
205
+ }
206
+ const newText = newFile.text;
135
207
  const existing = existsSync(targetAbs);
136
208
  if (!existing) {
137
209
  files.push({ source, target, action: dryRun ? "would-write" : "created", preserved: [], droppedLabels: [] });
138
210
  if (!dryRun) {
139
- mkdirSync(dirname(targetAbs), { recursive: true });
140
- writeFileSync(targetAbs, newText, "utf8");
211
+ try {
212
+ mkdirSync(dirname(targetAbs), { recursive: true });
213
+ writeFileSync(targetAbs, newText, "utf8");
214
+ }
215
+ catch (error) {
216
+ const message = error instanceof Error ? error.message : String(error);
217
+ throw new Error("写不了 " + targetAbs + ":" + message);
218
+ }
141
219
  }
142
220
  continue;
143
221
  }
144
- const oldText = readFileSync(targetAbs, "utf8");
222
+ const oldFile = readTextFile(targetAbs);
223
+ if (!oldFile.ok) {
224
+ files.push({ source, target, action: "skipped-encoding", preserved: [], droppedLabels: [] });
225
+ notes.push(target + " 的旧文件编码认不出来(" + oldFile.error + "):本次不覆盖,免得把它的中文注释写坏;" +
226
+ "先转成 UTF-8 再重跑生成。");
227
+ continue;
228
+ }
229
+ const oldText = oldFile.text;
145
230
  if (!canMergeUserCode(newText)) {
146
231
  files.push({ source, target, action: "skipped-no-user-code-markers", preserved: [], droppedLabels: [] });
147
232
  notes.push(target + " 的新内容没有 USER CODE 标记,未覆盖(旧文件保持原样)");
148
233
  continue;
149
234
  }
235
+ if (oldFile.encoding !== "utf8" && oldFile.encoding !== "utf8-bom") {
236
+ notes.push(target + " 原来是 " + oldFile.encoding + " 编码(多半是 Keil 编辑过的 GBK 文件):本次按 UTF-8 写回," +
237
+ "中文内容无损;如果你的编辑器仍按 GBK 打开会看到乱码,把它设成 UTF-8 即可。");
238
+ }
150
239
  const merged = mergeUserCode(oldText, newText);
151
240
  files.push({
152
241
  source,
@@ -160,8 +249,14 @@ function applyGeneratedFiles(projectDir, generated, backupRoot, dryRun) {
160
249
  }
161
250
  if (!dryRun) {
162
251
  backupFile(projectDir, backupRoot, target);
163
- mkdirSync(dirname(targetAbs), { recursive: true });
164
- writeFileSync(targetAbs, merged.merged, "utf8");
252
+ try {
253
+ mkdirSync(dirname(targetAbs), { recursive: true });
254
+ writeFileSync(targetAbs, merged.merged, "utf8");
255
+ }
256
+ catch (error) {
257
+ const message = error instanceof Error ? error.message : String(error);
258
+ throw new Error("写不了 " + targetAbs + ":" + message + "(旧文件已备份到 " + backupRoot + ")");
259
+ }
165
260
  }
166
261
  }
167
262
  return { files, notes };
@@ -250,21 +345,144 @@ export async function runGenerate(subprocess, request) {
250
345
  describeSearchScope(config.cubeMxRoots) +
251
346
  ";可用 STM32_CUBEMX_ROOT 指定安装根,或把 STM32CubeMX 装到这些位置之一");
252
347
  }
348
+ const iocFile = readTextFile(iocPath);
349
+ if (!iocFile.ok)
350
+ return fail(request, "读不了 .ioc(" + iocPath + "):" + iocFile.error);
351
+ const iocText = iocFile.text;
352
+ // 先认 .ioc 要哪个固件包,再在 CubeMX 根下找它(官方 Repository 与插件的 dsh-firmware 都找)。
353
+ // 找到就通过脚本命令 setCustomFWPath 明确指过去:CubeMX 不认目录名时只会静默用别的版本(docs §14)。
354
+ // 除了 CubeMX 根,还要认 stm32_firmware_install 的另外两种落点:<cacheRoot>/firmware 与显式 targetDir,
355
+ // 否则装完包这里又说"没找到"(B10)。
356
+ const firmware = locateFirmwarePackage(config.cubeMxRoots, {
357
+ ...firmwareNeedFromIoc(iocText),
358
+ extraDirs: firmwareExtraDirs(process.env),
359
+ });
360
+ const cacheKey = cacheKeyFor(iocText, launch.java, launch.jar, layout);
361
+ const stateDir = join(projectDir, STATE_DIR);
362
+ const enteredAt = Date.now();
363
+ const progress = request.onProgress ?? (() => undefined);
364
+ let skipMiss = "";
365
+ // 先看缓存:.ioc、CubeMX 版本、布局都没动且产物 hash 全对 → 一秒都不用等。
366
+ if (request.skipIfUnchanged !== false) {
367
+ const hit = cacheHit(readCache(stateDir), cacheKey.key, projectDir);
368
+ if (hit.hit && hit.entry !== null) {
369
+ const cached = hit.entry;
370
+ // 老洞(审计后补):cmake/stm32cubemx/CMakeLists.txt 一直是脚手架快照,CubeMX 从不重写它。
371
+ // 跳过的这次也要把它对齐一次 —— 否则用户只改了 Core 里的代码(.ioc 没动)时,源清单永远缺模块。
372
+ const cmake = refreshCubemxCmakeLists(projectDir);
373
+ return {
374
+ ok: true,
375
+ projectDir,
376
+ iocPath,
377
+ layout,
378
+ durationMs: Date.now() - enteredAt,
379
+ skipped: true,
380
+ cacheKey: cacheKey.key,
381
+ thirdparty: { parked: false, detail: "未探测(本次跳过 CubeMX)" },
382
+ firmwareDir: firmware.dir,
383
+ firmwarePackage: firmware.packageName,
384
+ firmwareSource: firmware.source,
385
+ verdict: { ok: true, successLine: "(跳过 CubeMX:复用上次生成结果)", errors: [], knownNoise: [] },
386
+ script: "",
387
+ command: "",
388
+ files: cached.files.map((file) => ({
389
+ source: file.target,
390
+ target: file.target,
391
+ action: "unchanged-cached",
392
+ preserved: [],
393
+ droppedLabels: [],
394
+ })),
395
+ backupDir: "",
396
+ message: "跳过 CubeMX:.ioc、CubeMX 版本与布局都没变,且 " +
397
+ String(cached.files.length) +
398
+ " 个产物 hash 全部一致(直接复用 " +
399
+ new Date(cached.createdAt).toLocaleString() +
400
+ " 的生成结果,耗时 0 s)",
401
+ notes: [
402
+ "想强制重新生成就传 skipIfUnchanged=false(会再跑一次 CubeMX,3–4 分钟)。",
403
+ "生成缓存只认 .ioc / CubeMX 版本 / 布局:换了固件包内容(例如重下同一个包)也要传 skipIfUnchanged=false。",
404
+ "缓存文件:.dsh-stm32/" + "generate-cache.json" + ";删掉它等效于强制重跑。",
405
+ describeRefresh(cmake),
406
+ ...cmake.notes,
407
+ ],
408
+ logTail: "",
409
+ };
410
+ }
411
+ skipMiss = hit.reason;
412
+ }
253
413
  const lock = acquireLock(projectDir, "generate " + basename(iocPath));
254
414
  if ("error" in lock)
255
415
  return fail(request, lock.error, { iocPath, layout });
416
+ if (lock.note !== undefined)
417
+ progress(lock.note);
418
+ // 第三方包索引:没有 X-CUBE 就临时停放,省掉两次 159 包枚举(实测约 25 s)。
419
+ const thirdparty = { parked: false, detail: "" };
420
+ let park = null;
421
+ const parkNotes = [];
422
+ // 判定靠包目录(src/engine/xcube-catalog.ts)+ 本机 pdsc 索引:认得出用的是什么包,也说得出本机有没有。
423
+ const home = cubeMxUserHome(process.env);
424
+ if (request.thirdpartyPacks === "keep") {
425
+ thirdparty.detail = "thirdpartyPacks=keep:原样加载第三方包索引";
426
+ }
427
+ else {
428
+ const pdscDir = home === null ? undefined : home + "/thirdparties/pdsc";
429
+ const decision = needsThirdpartyPacks(iocText, pdscDir === undefined ? {} : { pdscDir });
430
+ parkNotes.push(...decision.warnings);
431
+ if (decision.needed) {
432
+ thirdparty.detail = "保留第三方包索引:" + decision.reason;
433
+ }
434
+ else if (home === null) {
435
+ thirdparty.detail = "无法确定 CubeMX 用户目录(USERPROFILE/HOME 为空),未停放第三方包索引";
436
+ }
437
+ else {
438
+ const parked = parkThirdpartyDb(home + "/thirdparties");
439
+ if (parked.ok) {
440
+ park = parked;
441
+ thirdparty.parked = true;
442
+ thirdparty.detail = parked.detail + ";判定依据:" + decision.reason;
443
+ }
444
+ else {
445
+ thirdparty.detail = parked.detail;
446
+ }
447
+ }
448
+ }
449
+ if (park !== null)
450
+ progress("第三方包索引:" + thirdparty.detail);
256
451
  const stamp = nowStamp();
257
- const stateDir = join(projectDir, STATE_DIR);
258
452
  const tmpDir = join(stateDir, "tmp");
259
- mkdirSync(tmpDir, { recursive: true });
260
453
  const scriptPath = join(tmpDir, "gen-" + stamp + ".txt");
261
- const script = buildGenerateScript(iocPath.replace(/\\/g, "/"), projectDir.replace(/\\/g, "/"), layout);
262
- writeFileSync(scriptPath, script, "utf8");
263
- const argv = [launch.java, "-jar", launch.jar, "-q", scriptPath];
454
+ const script = buildGenerateScript(iocPath.replace(/\\/g, "/"), projectDir.replace(/\\/g, "/"), layout, firmware.dir);
455
+ // A5:工程盘只读 / .dsh-stm32 被删 / 权限不足时,这里以前会抛未捕获异常把工具打成崩溃。
456
+ try {
457
+ mkdirSync(tmpDir, { recursive: true });
458
+ writeFileSync(scriptPath, script, "utf8");
459
+ }
460
+ catch (error) {
461
+ const message = error instanceof Error ? error.message : String(error);
462
+ return fail(request, "写不了 CubeMX 脚本(" + scriptPath + "):" + message + ";工程目录可能只读,或 .dsh-stm32 被占用。");
463
+ }
464
+ // B18:脚本里是绝对路径,CubeMX 是 Java,按平台默认字符集读脚本(中文 Windows = GBK)。
465
+ // 路径含中文时脚本会乱码,这里逼 JVM 用 UTF-8 读文件。
466
+ const argv = [launch.java, "-Dfile.encoding=UTF-8", "-jar", launch.jar, "-q", scriptPath];
264
467
  const command = argv.map((part) => (part.includes(" ") ? '"' + part + '"' : part)).join(" ");
265
468
  const startedAt = Date.now();
266
- const progress = request.onProgress ?? (() => undefined);
469
+ if (skipMiss !== "")
470
+ progress("未跳过 CubeMX:" + skipMiss);
267
471
  progress("使用布局:" + (layout === "coupled" ? "coupled(外设初始化并入 main.c)" : "per-ip(每外设一对 .c/.h)"));
472
+ if (firmware.found) {
473
+ progress("固件包:" +
474
+ firmware.packageName +
475
+ "(" +
476
+ firmwareSourceLabel(firmware.source) +
477
+ ")→ 脚本里用 setCustomFWPath 明确指过去");
478
+ }
479
+ else {
480
+ progress("固件包:没找到 " +
481
+ (firmware.packageName === "" ? "任何一个固件包" : firmware.packageName) +
482
+ "(找过 " +
483
+ firmware.checked.join("、") +
484
+ ");脚本里不发 setCustomFWPath,CubeMX 会自己挑一个版本");
485
+ }
268
486
  progress("脚本:" + scriptPath);
269
487
  progress("命令:" + command);
270
488
  let outcome;
@@ -286,16 +504,41 @@ export async function runGenerate(subprocess, request) {
286
504
  }
287
505
  finally {
288
506
  lock.release();
507
+ if (park !== null) {
508
+ // CubeMX 进程已经退出,这里把第三方包索引改回去;失败了要让人看见。
509
+ for (const note of park.restore())
510
+ parkNotes.push("! " + note);
511
+ }
289
512
  }
290
513
  const log = outcome.stdout + "\n" + outcome.stderr;
291
514
  const verdict = parseGenerateLog(log);
292
515
  const durationMs = Date.now() - startedAt;
516
+ // 失败路径也要把「第三方包索引」的判定与缺包警告带出去:CubeMX 报缺包时,
517
+ // 我们自己那条"本机没有这个包"恰恰是最有用的信息,不能只在成功时给。
518
+ const failureNotes = [];
519
+ if (thirdparty.detail !== "")
520
+ failureNotes.push("第三方包索引:" + thirdparty.detail);
521
+ failureNotes.push(...parkNotes);
522
+ if (!firmware.found) {
523
+ failureNotes.push("没找到 .ioc 要的固件包(找过 " +
524
+ firmware.checked.join("、") +
525
+ "):CubeMX 会退回它自己认识的版本,生成出来的 Drivers 可能不是你期望的那份;" +
526
+ "可以用 stm32_firmware_install 装一次 —— 它会落到 <CubeMX>/dsh-firmware(CubeMX 根写不进去时落到下载缓存)," +
527
+ "之后再生成时这里会连 CubeMX 根、下载缓存、安装记录一起搜。");
528
+ }
293
529
  const baseReport = {
294
530
  projectDir,
295
531
  iocPath,
296
532
  layout,
297
533
  durationMs,
534
+ skipped: false,
535
+ cacheKey: cacheKey.key,
536
+ thirdparty,
537
+ firmwareDir: firmware.dir,
538
+ firmwarePackage: firmware.packageName,
539
+ firmwareSource: firmware.source,
298
540
  verdict,
541
+ notes: failureNotes,
299
542
  script,
300
543
  command,
301
544
  logTail: tail(log, 25),
@@ -327,12 +570,51 @@ export async function runGenerate(subprocess, request) {
327
570
  }
328
571
  const backupRoot = join(stateDir, "backups", stamp);
329
572
  const applied = applyGeneratedFiles(projectDir, generated, backupRoot, request.dryRun === true);
573
+ // A10:日志成功行只作附加信息,产物不对就不算成功(也不写生成缓存)。
574
+ const product = assessGenerateProducts(projectDir, applied.files.length);
575
+ if (!product.ok) {
576
+ return fail(request, "CubeMX 报告成功,但产物不对:" + product.problems.join(";"), {
577
+ ...baseReport,
578
+ files: applied.files,
579
+ backupDir: request.dryRun === true ? "" : backupRoot,
580
+ });
581
+ }
330
582
  const notes = [...applied.notes];
583
+ // 老洞:CubeMX 不写 cmake/stm32cubemx/CMakeLists.txt(实测 mtime 停留在脚手架拷贝那一刻),
584
+ // 这份源清单必须由我们按磁盘事实对齐,否则开了 UART/CAN 会链接期 undefined reference。
585
+ const cmake = refreshCubemxCmakeLists(projectDir, request.dryRun === true ? { dryRun: true } : {});
586
+ notes.push(describeRefresh(cmake));
587
+ notes.push(...cmake.notes);
331
588
  if (verdict.knownNoise.length > 0) {
332
589
  notes.push("CubeMX 噪音 " + String(verdict.knownNoise.length) + " 条(与本芯片无关,已忽略)");
333
590
  }
334
591
  if (request.dryRun !== true)
335
592
  notes.push(...cleanupGenerated(projectDir, generated));
593
+ if (firmware.found) {
594
+ notes.push("本次指定固件包:" +
595
+ firmware.dir +
596
+ "(来源:" +
597
+ firmwareSourceLabel(firmware.source) +
598
+ ")- 脚本里用 project setCustomFWPath 传的,不写进 .ioc。");
599
+ }
600
+ if (thirdparty.detail !== "")
601
+ notes.push("第三方包索引:" + thirdparty.detail);
602
+ notes.push(...parkNotes);
603
+ if (request.dryRun !== true) {
604
+ // 记下这次产物:下次 .ioc 没变就能直接跳过 CubeMX(3–4 分钟 → 0 s)。
605
+ const entry = entryFromFiles(cacheKey.key, cacheKey.iocSha256, cacheKey.cubeMxStamp, layout, projectDir, applied.files.filter((file) => file.action !== "skipped-no-user-code-markers").map((file) => file.target));
606
+ if (entry === null) {
607
+ notes.push("没能写生成缓存(有产物取不到 hash),下次仍会跑 CubeMX");
608
+ }
609
+ else {
610
+ try {
611
+ writeCache(stateDir, entry);
612
+ }
613
+ catch (error) {
614
+ notes.push("没能写生成缓存:" + String(error.message));
615
+ }
616
+ }
617
+ }
336
618
  return {
337
619
  ok: true,
338
620
  ...baseReport,
@@ -0,0 +1,230 @@
1
+ /**
2
+ * L2.5:HAL 路线的「具体型号 → 工程文件事实」派生。
3
+ *
4
+ * 为什么单独一层:脚手架里原本写死了 C8T6 的四样东西(startup_stm32f103xb.s、
5
+ * 设备宏 STM32F103xB、链接脚本 STM32F103XX_FLASH.ld、demo.ioc 里的 Mcu.CPN)。
6
+ * 要支持 F1 全系,这四样都得按型号算出来。算它们需要的数据来自三处,缺一不可:
7
+ *
8
+ * 1. 容量档 → 启动文件 / 设备宏 / 设备头 / Flash / RAM:src/data/stm32f1.ts 的 resolveF1Chip
9
+ * (上游启动文件是实测出来的事实,别在这里再抄一份)。
10
+ * 2. 型号 → CubeMX 的 db/mcu 分组名(Mcu.Name,带括号,例如 STM32F103R(C-D-E)Tx):
11
+ * 本文件内置分组表,来源是本机 CubeMX db/mcu/*.xml 的真实文件名。
12
+ * 3. 型号 → 工程文件里的名字:具体型号名(STM32F103RCTx)+ _FLASH.ld
13
+ * —— 和 ST 自己 Projects/<board>/SW4STM32/ 下的链接脚本命名一致(实测
14
+ * STM32F103RBTx_FLASH.ld / STM32F107VCTx_FLASH.ld)。
15
+ *
16
+ * 两种「名字」必须分清(.ioc 里同时出现,写错 CubeMX 会认不出芯片):
17
+ * - ProjectManager.DeviceId = Mcu.UserName = 具体型号名 STM32F103C8Tx
18
+ * - Mcu.Name = db/mcu 的分组名 STM32F103C(8-B)Tx
19
+ *
20
+ * 本文件只做纯计算与纯渲染(不读盘、不依赖 CubeMX 是否装了),这样能单测。
21
+ */
22
+ import { resolveF1Chip } from "../data/stm32f1.js";
23
+ /** HAL 路线不给型号时按蓝丸(STM32F103C8T6)建,与历史行为一致。 */
24
+ export const DEFAULT_HAL_MCU = "STM32F103C8T6";
25
+ /**
26
+ * 老工程兼容用的链接脚本名。模板里那份是 C8T6 的(64K/20K),
27
+ * 新工程一律另有 <DeviceId>_FLASH.ld;这个旧名只为「已有工程的 cmake 还指着它」而留。
28
+ */
29
+ export const LEGACY_LINKER_SCRIPT = "STM32F103XX_FLASH.ld";
30
+ /** 模板里写死的 C8T6 事实(渲染时被替换掉;C8T6 本身替换后逐字节不变)。 */
31
+ const TEMPLATE_DEVICE_DEFINE = "STM32F103xB";
32
+ const TEMPLATE_STARTUP = "startup_stm32f103xb.s";
33
+ /** 封装字母 → 引脚数(与 CubeMX db/mcu 的 LQFP48/64/100/144 对应)。 */
34
+ const PIN_COUNT_BY_PACKAGE = { T: 36, C: 48, R: 64, V: 100, Z: 144 };
35
+ /**
36
+ * 型号 → CubeMX db/mcu 分组名用的「容量档分组」表。
37
+ * 键:line(三位数字)→ 封装字母 → 该封装在 db 里真实出现过的分组(升序,靠前的先命中)。
38
+ * 只收 Tx/Ux/Yx 这种带封装后缀的条目;特殊单型号(STM32F103C6Ux、STM32F107VCHx 之类)
39
+ * 走「退回具体型号名」的兜底,不在这里硬编。
40
+ */
41
+ const MCU_NAME_GROUPS = {
42
+ "100": { C: ["4-6", "8-B"], R: ["4-6", "8-B", "C-D-E"], V: ["8-B", "C-D-E"], Z: ["C-D-E"] },
43
+ "101": { C: ["4-6", "8-B"], R: ["4-6", "8-B", "C-D-E", "F-G"], T: ["4-6", "8-B"], V: ["8-B", "C-D-E", "F-G"], Z: ["C-D-E", "F-G"] },
44
+ "102": { C: ["4-6", "8-B"], R: ["4-6", "8-B"] },
45
+ "103": { C: ["4-6", "8-B"], R: ["4-6", "8-B", "C-D-E", "F-G"], T: ["4-6", "8-B"], V: ["8-B", "C-D-E", "F-G"], Z: ["C-D-E", "F-G"] },
46
+ "105": { R: ["8-B-C"], V: ["8-B-C"] },
47
+ "107": { R: ["B-C"], V: ["B-C"] },
48
+ };
49
+ /** 分组标签 → 它覆盖的容量字母。 */
50
+ const GROUP_LETTERS = {
51
+ "4-6": ["4", "6"],
52
+ "8-B": ["8", "B"],
53
+ "C-D-E": ["C", "D", "E"],
54
+ "F-G": ["F", "G"],
55
+ "B-C": ["B", "C"],
56
+ "8-B-C": ["8", "B", "C"],
57
+ };
58
+ /** 型号拆解:STM32F103RCT6 → line 103 / 封装 R / 容量 C / 后缀 T / 温度 6。 */
59
+ const PART_PATTERN = /^STM32F(\d{3})([A-Z])([0-9A-G])([A-Z])?([0-9])?$/u;
60
+ /**
61
+ * 型号 → HAL 路线的芯片事实。
62
+ *
63
+ * 与 resolveF1Chip 的分工:那里回答「启动文件/设备宏/Flash/RAM」,这里再补上
64
+ * 「.ioc 里的名字 + 链接脚本名 + 封装」,并拒绝 HAL 路线没法处理的输入:
65
+ * - 只给容量档(F103:xb):定不了封装、引脚与型号名,HAL 路线必须给完整型号;
66
+ * - RAM 未收录:链接脚本的 RAM 大小不能猜(宁可报错也不生成一个错的内存布局)。
67
+ */
68
+ export function resolveHalChip(input) {
69
+ const raw = (input ?? "").trim();
70
+ const mcu = raw.length === 0 ? DEFAULT_HAL_MCU : raw.toUpperCase();
71
+ const resolved = resolveF1Chip(mcu);
72
+ if (resolved.chip === null) {
73
+ return {
74
+ facts: null,
75
+ reason: resolved.reason +
76
+ "。HAL 路线要完整型号(封装字母要写全),例如 STM32F103C8T6 / STM32F103RCT6 / STM32F107VCT6",
77
+ };
78
+ }
79
+ const chip = resolved.chip;
80
+ const parts = PART_PATTERN.exec(mcu);
81
+ if (parts === null) {
82
+ return {
83
+ facts: null,
84
+ reason: "HAL 路线要完整型号(带封装字母),例如 STM32F103RCT6;" + mcu +
85
+ " 只给了容量档,定不了 .ioc 里的封装与型号名",
86
+ };
87
+ }
88
+ const code = parts[1] ?? "";
89
+ const packageLetter = parts[2] ?? "";
90
+ const suffixLetter = (parts[4] ?? "").length > 0 ? (parts[4] ?? "") : "T";
91
+ if (suffixLetter !== "T" && suffixLetter !== "U" && suffixLetter !== "Y") {
92
+ return {
93
+ facts: null,
94
+ reason: ".ioc 模板只覆盖 T/U/Y 三种封装后缀,认不出 " + suffixLetter + ":" + mcu,
95
+ };
96
+ }
97
+ const flashBytes = chip.flashBytes;
98
+ if (flashBytes === null)
99
+ return { facts: null, reason: "认不出 " + mcu + " 的 Flash 大小,链接脚本没法渲染" };
100
+ const ramBytes = chip.ramBytes;
101
+ if (ramBytes === null) {
102
+ return {
103
+ facts: null,
104
+ reason: (chip.notes.length > 0 ? chip.notes.join(";") + ";" : "") +
105
+ "链接脚本里的 RAM 大小不能猜:先按 CubeMX 的 db/mcu 补上 " + chip.prefix + chip.densityLetter + " 的 RAM 再建",
106
+ };
107
+ }
108
+ const notes = [];
109
+ const pinCount = chip.pinCount ?? PIN_COUNT_BY_PACKAGE[packageLetter] ?? null;
110
+ const deviceId = chip.prefix + packageLetter + chip.densityLetter + suffixLetter + "x";
111
+ // db/mcu 的分组名只在「该封装 + 该后缀确实按分组收录」时成立:
112
+ // Tx 全是分组名;Ux 只有 T 封装分组(STM32F103T(8-B)Ux),C 封装是单型号(STM32F103C6Ux);
113
+ // Yx 只有 R 封装分组(STM32F103R(C-D-E)Yx)。
114
+ const grouped = suffixLetter === "T" || (suffixLetter === "U" && packageLetter === "T") || (suffixLetter === "Y" && packageLetter === "R");
115
+ let mcuName = deviceId;
116
+ if (grouped) {
117
+ const groups = MCU_NAME_GROUPS[code]?.[packageLetter] ?? [];
118
+ const hit = groups.find((entry) => (GROUP_LETTERS[entry] ?? []).includes(chip.densityLetter));
119
+ if (hit === undefined) {
120
+ notes.push("CubeMX 的 db/mcu 里没有 " + deviceId + " 这一分组名,Mcu.Name 按具体型号名写(CubeMX 打不开 .ioc 的话把型号换成同容量档的常见型号)");
121
+ }
122
+ else {
123
+ mcuName = chip.prefix + packageLetter + "(" + hit + ")" + suffixLetter + "x";
124
+ }
125
+ }
126
+ const packageKind = suffixLetter === "U" ? "VFQFPN" : suffixLetter === "Y" ? "WLCSP" : "LQFP";
127
+ const packageName = pinCount === null ? packageKind : packageKind + String(pinCount);
128
+ return {
129
+ facts: {
130
+ mcu,
131
+ deviceId,
132
+ mcuName,
133
+ packageName,
134
+ pinCount,
135
+ startup: chip.startup,
136
+ deviceDefine: chip.deviceDefine,
137
+ deviceHeader: chip.deviceHeader,
138
+ flashBytes,
139
+ ramBytes,
140
+ linkerScript: deviceId + "_FLASH.ld",
141
+ // 旧名只有蓝丸(C8T6 的 64K Flash / 20K RAM)对得上;别的芯片写旧名 = 一份骗人的内存布局。
142
+ keepLegacyLinkerScript: deviceId === "STM32F103C8Tx" && flashBytes === 64 * 1024 && ramBytes === 20 * 1024,
143
+ notes,
144
+ },
145
+ reason: "",
146
+ };
147
+ }
148
+ /** 一句话说清这款芯片会变成什么(报告/warning 里用)。 */
149
+ export function describeHalChip(facts) {
150
+ return (facts.mcu + "(" + facts.deviceId + "," + facts.packageName + "):启动文件 " + facts.startup +
151
+ "、设备宏 " + facts.deviceDefine + "、链接脚本 " + facts.linkerScript);
152
+ }
153
+ function kiloText(bytes) {
154
+ return String(Math.round(bytes / 1024));
155
+ }
156
+ /**
157
+ * 链接脚本按芯片渲染。
158
+ *
159
+ * 只改三处(其余 SECTIONS 与芯片无关;F1 全是 RAM 0x20000000 / FLASH 0x08000000):
160
+ * - 头注释里的型号名
161
+ * - 头注释里的 "NKbytes FLASH and MKbytes RAM"
162
+ * - MEMORY 里的 LENGTH 值
163
+ * 模板缺任何一处都抛错:宁可建不出来,也不生成一个 Flash/RAM 是错的链接脚本。
164
+ */
165
+ export function renderLinkerScript(template, facts) {
166
+ const flashK = kiloText(facts.flashBytes);
167
+ const ramK = kiloText(facts.ramBytes);
168
+ const abstract = /(\*\*\s+Abstract\s+:\s+Linker script for )[^\r\n]+/u;
169
+ const sizes = /\d+Kbytes FLASH and \d+Kbytes RAM/u;
170
+ const ramLine = /(RAM \(xrw\)[ \t]*:[ \t]*ORIGIN = 0x20000000,[ \t]*LENGTH = )[^\r\n]+/u;
171
+ const flashLine = /(FLASH \(rx\)[ \t]*:[ \t]*ORIGIN = 0x8000000,[ \t]*LENGTH = )[^\r\n]+/u;
172
+ for (const [pattern, what] of [
173
+ [abstract, "Abstract 行(Linker script for …)"],
174
+ [sizes, "『NKbytes FLASH and MKbytes RAM』行"],
175
+ [ramLine, "MEMORY 里的 RAM 行"],
176
+ [flashLine, "MEMORY 里的 FLASH 行"],
177
+ ]) {
178
+ if (!pattern.test(template)) {
179
+ throw new Error("链接脚本模板缺 " + what + ",没法按芯片渲染(模板被改过?)");
180
+ }
181
+ }
182
+ let text = template.replace(abstract, (_match, head) => head + facts.deviceId + " series");
183
+ text = text.replace(sizes, (_match) => flashK + "Kbytes FLASH and " + ramK + "Kbytes RAM");
184
+ text = text.replace(ramLine, (_match, head) => head + ramK + "K");
185
+ text = text.replace(flashLine, (_match, head) => head + flashK + "K");
186
+ return text;
187
+ }
188
+ /**
189
+ * .ioc 按芯片渲染:只改这五行,引脚/时钟树沿用模板的最小集(PA13/PA14 SWD + 一个 GPIO)。
190
+ * 缺键就抛错——没把握的 .ioc 宁可不写,写一份 CubeMX 认不出的配置更糟。
191
+ */
192
+ export function renderIoc(template, facts) {
193
+ const values = [
194
+ ["Mcu.CPN", facts.mcu],
195
+ ["Mcu.Name", facts.mcuName],
196
+ ["Mcu.Package", facts.packageName],
197
+ ["Mcu.UserName", facts.deviceId],
198
+ ["ProjectManager.DeviceId", facts.deviceId],
199
+ ];
200
+ const eol = template.includes("\r\n") ? "\r\n" : "\n";
201
+ const seen = new Set();
202
+ const lines = template.split(/\r?\n/u).map((line) => {
203
+ for (const [key, value] of values) {
204
+ if (line.startsWith(key + "=")) {
205
+ seen.add(key);
206
+ return key + "=" + value;
207
+ }
208
+ }
209
+ return line;
210
+ });
211
+ const missing = values.map(([key]) => key).filter((key) => !seen.has(key));
212
+ if (missing.length > 0) {
213
+ throw new Error(".ioc 模板缺这些键:" + missing.join("、") + "(模板被改过?)");
214
+ }
215
+ return lines.join(eol);
216
+ }
217
+ /** 工具链 cmake 文件里的 -T 指向渲染后的链接脚本名。 */
218
+ export function pointLinkerFlagAt(text, facts) {
219
+ if (!text.includes(LEGACY_LINKER_SCRIPT)) {
220
+ throw new Error("工具链 cmake 文件里找不到 -T …" + LEGACY_LINKER_SCRIPT + "(模板被改过?)");
221
+ }
222
+ return text.split(LEGACY_LINKER_SCRIPT).join(facts.linkerScript);
223
+ }
224
+ /** cmake/stm32cubemx/CMakeLists.txt 里的设备宏与启动文件名按芯片替换。 */
225
+ export function renderStartupAndDefine(text, facts) {
226
+ if (!text.includes(TEMPLATE_DEVICE_DEFINE) || !text.includes(TEMPLATE_STARTUP)) {
227
+ throw new Error("cmake/stm32cubemx/CMakeLists.txt 里找不到 " + TEMPLATE_DEVICE_DEFINE + " 或 " + TEMPLATE_STARTUP + "(模板被改过?)");
228
+ }
229
+ return text.split(TEMPLATE_DEVICE_DEFINE).join(facts.deviceDefine).split(TEMPLATE_STARTUP).join(facts.startup);
230
+ }