dsh-stm32 0.1.2 → 0.1.4

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 (225) hide show
  1. package/README.md +92 -40
  2. package/README_EN.md +85 -36
  3. package/assets/README.md +85 -0
  4. package/assets/VERSION +1 -0
  5. package/assets/device/c0/chips.json +1108 -0
  6. package/assets/device/f0/chips.json +1570 -0
  7. package/assets/device/f1/chips.json +1238 -0
  8. package/assets/device/f1/svd/100.json +943 -0
  9. package/assets/device/f1/svd/101.json +901 -0
  10. package/assets/device/f1/svd/102.json +522 -0
  11. package/assets/device/f1/svd/103.json +1139 -0
  12. package/assets/device/f1/svd/105.json +1117 -0
  13. package/assets/device/f1/svd/107.json +1195 -0
  14. package/assets/device/f2/chips.json +674 -0
  15. package/assets/device/f3/chips.json +1318 -0
  16. package/assets/device/f4/chips.json +2942 -0
  17. package/assets/device/f7/chips.json +1710 -0
  18. package/assets/device/g0/chips.json +2102 -0
  19. package/assets/device/g4/chips.json +2494 -0
  20. package/assets/device/h5/chips.json +898 -0
  21. package/assets/device/h7/chips.json +1948 -0
  22. package/assets/device/l0/chips.json +2494 -0
  23. package/assets/device/l1/chips.json +1234 -0
  24. package/assets/device/l4/chips.json +2130 -0
  25. package/assets/device/l4+/chips.json +856 -0
  26. package/assets/device/l5/chips.json +226 -0
  27. package/assets/device/u0/chips.json +688 -0
  28. package/assets/device/u3/chips.json +310 -0
  29. package/assets/device/u5/chips.json +884 -0
  30. package/assets/device/wba/chips.json +506 -0
  31. package/assets/device/wl/chips.json +184 -0
  32. package/assets/headers/f1/stm32f100xb.h +5972 -0
  33. package/assets/headers/f1/stm32f100xe.h +6587 -0
  34. package/assets/headers/f1/stm32f101x6.h +5315 -0
  35. package/assets/headers/f1/stm32f101xb.h +5446 -0
  36. package/assets/headers/f1/stm32f101xe.h +6503 -0
  37. package/assets/headers/f1/stm32f101xg.h +6713 -0
  38. package/assets/headers/f1/stm32f102x6.h +6448 -0
  39. package/assets/headers/f1/stm32f102xb.h +6570 -0
  40. package/assets/headers/f1/stm32f103x6.h +10109 -0
  41. package/assets/headers/f1/stm32f103xb.h +10240 -0
  42. package/assets/headers/f1/stm32f103xe.h +11767 -0
  43. package/assets/headers/f1/stm32f103xg.h +11951 -0
  44. package/assets/headers/f1/stm32f105xc.h +14340 -0
  45. package/assets/headers/f1/stm32f107xc.h +15253 -0
  46. package/assets/headers/f1/stm32f1xx.h +273 -0
  47. package/assets/headers/f1/system_stm32f1xx.h +96 -0
  48. package/assets/ioc/family/C0.ioc +82 -0
  49. package/assets/ioc/family/F0.ioc +71 -0
  50. package/assets/ioc/family/F2.ioc +91 -0
  51. package/assets/ioc/family/F3.ioc +94 -0
  52. package/assets/ioc/family/F4.ioc +91 -0
  53. package/assets/ioc/family/F7.ioc +102 -0
  54. package/assets/ioc/family/G0.ioc +90 -0
  55. package/assets/ioc/family/G4.ioc +110 -0
  56. package/assets/ioc/family/H5.ioc +116 -0
  57. package/assets/ioc/family/H7.ioc +133 -0
  58. package/assets/ioc/family/L0.ioc +92 -0
  59. package/assets/ioc/family/L1.ioc +87 -0
  60. package/assets/ioc/family/L4+.ioc +92 -0
  61. package/assets/ioc/family/L4.ioc +93 -0
  62. package/assets/ioc/family/L5.ioc +91 -0
  63. package/assets/ioc/family/U0.ioc +103 -0
  64. package/assets/ioc/family/U3.ioc +113 -0
  65. package/assets/ioc/family/U5.ioc +102 -0
  66. package/assets/ioc/family/WBA.ioc +100 -0
  67. package/assets/ioc/family/WL.ioc +93 -0
  68. package/assets/ioc/minimal/STM32F100C8Tx.ioc +113 -0
  69. package/assets/ioc/minimal/STM32F100RCTx.ioc +113 -0
  70. package/assets/ioc/minimal/STM32F101C4Tx.ioc +113 -0
  71. package/assets/ioc/minimal/STM32F101C8Tx.ioc +113 -0
  72. package/assets/ioc/minimal/STM32F101RCTx.ioc +113 -0
  73. package/assets/ioc/minimal/STM32F101RFTx.ioc +113 -0
  74. package/assets/ioc/minimal/STM32F102C4Tx.ioc +113 -0
  75. package/assets/ioc/minimal/STM32F102C8Tx.ioc +113 -0
  76. package/assets/ioc/minimal/STM32F103C4Tx.ioc +113 -0
  77. package/assets/ioc/minimal/STM32F103C8Tx.ioc +113 -0
  78. package/assets/ioc/minimal/STM32F103RCTx.ioc +113 -0
  79. package/assets/ioc/minimal/STM32F103RFTx.ioc +113 -0
  80. package/assets/ioc/minimal/STM32F105RCTx.ioc +113 -0
  81. package/assets/ioc/minimal/STM32F107RCTx.ioc +113 -0
  82. package/assets/ld/f1/STM32F100C8Tx_FLASH.ld +249 -0
  83. package/assets/ld/f1/STM32F100RCTx_FLASH.ld +249 -0
  84. package/assets/ld/f1/STM32F101C4Tx_FLASH.ld +249 -0
  85. package/assets/ld/f1/STM32F101C8Tx_FLASH.ld +249 -0
  86. package/assets/ld/f1/STM32F101RCTx_FLASH.ld +249 -0
  87. package/assets/ld/f1/STM32F101RFTx_FLASH.ld +249 -0
  88. package/assets/ld/f1/STM32F102C4Tx_FLASH.ld +249 -0
  89. package/assets/ld/f1/STM32F102C8Tx_FLASH.ld +249 -0
  90. package/assets/ld/f1/STM32F103C4Tx_FLASH.ld +249 -0
  91. package/assets/ld/f1/STM32F103C8Tx_FLASH.ld +249 -0
  92. package/assets/ld/f1/STM32F103RCTx_FLASH.ld +249 -0
  93. package/assets/ld/f1/STM32F103RFTx_FLASH.ld +249 -0
  94. package/assets/ld/f1/STM32F105RCTx_FLASH.ld +249 -0
  95. package/assets/ld/f1/STM32F107RCTx_FLASH.ld +249 -0
  96. package/assets/manifest.json +1130 -0
  97. package/assets/startup/f1/startup_stm32f100xb.s +407 -0
  98. package/assets/startup/f1/startup_stm32f100xe.s +449 -0
  99. package/assets/startup/f1/startup_stm32f101x6.s +322 -0
  100. package/assets/startup/f1/startup_stm32f101xb.s +338 -0
  101. package/assets/startup/f1/startup_stm32f101xe.s +423 -0
  102. package/assets/startup/f1/startup_stm32f101xg.s +439 -0
  103. package/assets/startup/f1/startup_stm32f102x6.s +330 -0
  104. package/assets/startup/f1/startup_stm32f102xb.s +346 -0
  105. package/assets/startup/f1/startup_stm32f103x6.s +348 -0
  106. package/assets/startup/f1/startup_stm32f103xb.s +364 -0
  107. package/assets/startup/f1/startup_stm32f103xe.s +470 -0
  108. package/assets/startup/f1/startup_stm32f103xg.s +466 -0
  109. package/assets/startup/f1/startup_stm32f105xc.s +463 -0
  110. package/assets/startup/f1/startup_stm32f107xc.s +472 -0
  111. package/assets/templates/family/C0.ioc +82 -0
  112. package/assets/templates/family/F0.ioc +71 -0
  113. package/assets/templates/family/F2.ioc +91 -0
  114. package/assets/templates/family/F3.ioc +94 -0
  115. package/assets/templates/family/F4.ioc +91 -0
  116. package/assets/templates/family/F7.ioc +102 -0
  117. package/assets/templates/family/G0.ioc +90 -0
  118. package/assets/templates/family/G4.ioc +110 -0
  119. package/assets/templates/family/H5.ioc +116 -0
  120. package/assets/templates/family/H7.ioc +133 -0
  121. package/assets/templates/family/L0.ioc +92 -0
  122. package/assets/templates/family/L1.ioc +87 -0
  123. package/assets/templates/family/L4+.ioc +92 -0
  124. package/assets/templates/family/L4.ioc +93 -0
  125. package/assets/templates/family/L5.ioc +91 -0
  126. package/assets/templates/family/U0.ioc +103 -0
  127. package/assets/templates/family/U3.ioc +113 -0
  128. package/assets/templates/family/U5.ioc +102 -0
  129. package/assets/templates/family/WB.ioc +81 -0
  130. package/assets/templates/family/WBA.ioc +100 -0
  131. package/assets/templates/family/WL.ioc +93 -0
  132. package/docs/reading-guide.md +94 -71
  133. package/lib/data/chips.js +38 -51
  134. package/lib/data/clock-db.js +830 -0
  135. package/lib/data/clock-f1.js +12 -45
  136. package/lib/data/cmsis-sources.js +264 -17
  137. package/lib/data/db-presets.js +252 -0
  138. package/lib/data/device-facts.js +274 -0
  139. package/lib/data/family.js +515 -0
  140. package/lib/data/firmware-packages.js +562 -0
  141. package/lib/data/install-guides.js +2 -2
  142. package/lib/data/ioc-presets.js +248 -0
  143. package/lib/data/ioc-schema.js +1058 -0
  144. package/lib/data/rm-topics/stm32c0.json +227 -0
  145. package/lib/data/rm-topics.js +103 -0
  146. package/lib/data/search-roots.js +42 -1
  147. package/lib/data/stm32f1.js +95 -150
  148. package/lib/data/svd.js +643 -0
  149. package/lib/data/toolchain-config.js +0 -14
  150. package/lib/engine/assets.js +659 -0
  151. package/lib/engine/breakpoints.js +297 -0
  152. package/lib/engine/clock-derived.js +101 -0
  153. package/lib/engine/clock-direct.js +313 -0
  154. package/lib/engine/clock-plan.js +96 -52
  155. package/lib/engine/clock-pllmn.js +319 -0
  156. package/lib/engine/cmake-sources.js +67 -13
  157. package/lib/engine/cube-mx-guard.js +44 -0
  158. package/lib/engine/cube-programmer.js +137 -0
  159. package/lib/engine/cubemx-db.js +273 -0
  160. package/lib/engine/debug-session.js +576 -22
  161. package/lib/engine/debug.js +99 -46
  162. package/lib/engine/doctor.js +162 -19
  163. package/lib/engine/facts-acquire.js +416 -0
  164. package/lib/engine/facts.js +134 -0
  165. package/lib/engine/firmware-install.js +176 -5
  166. package/lib/engine/firmware-official.js +451 -0
  167. package/lib/engine/flash.js +317 -76
  168. package/lib/engine/gdb-mi.js +476 -0
  169. package/lib/engine/generate.js +9 -2
  170. package/lib/engine/hal-chip.js +124 -41
  171. package/lib/engine/ioc-plan.js +1247 -63
  172. package/lib/engine/ioc-rules.js +698 -0
  173. package/lib/engine/ioc-verify.js +706 -0
  174. package/lib/engine/ioc.js +43 -4
  175. package/lib/engine/msys2-install.js +4 -4
  176. package/lib/engine/probe-error.js +231 -0
  177. package/lib/engine/probe-session.js +347 -0
  178. package/lib/engine/probe.js +18 -3
  179. package/lib/engine/register-clock.js +41 -0
  180. package/lib/engine/register-gpio.js +115 -0
  181. package/lib/engine/register-linker.js +12 -7
  182. package/lib/engine/register-template.js +130 -45
  183. package/lib/engine/regs.js +43 -8
  184. package/lib/engine/rm-extract.js +144 -0
  185. package/lib/engine/rm-sources.js +360 -0
  186. package/lib/engine/rm-text.js +56 -0
  187. package/lib/engine/rtt.js +758 -0
  188. package/lib/engine/scaffold.js +185 -18
  189. package/lib/engine/toolchain-gate.js +0 -4
  190. package/lib/engine/watch.js +227 -0
  191. package/lib/index.js +12 -2
  192. package/lib/skill/stm32-workflow.js +2 -2
  193. package/lib/tools/assets.js +272 -0
  194. package/lib/tools/cache.js +8 -0
  195. package/lib/tools/debug-session.js +41 -6
  196. package/lib/tools/debug.js +41 -11
  197. package/lib/tools/doctor.js +65 -4
  198. package/lib/tools/firmware-install.js +31 -6
  199. package/lib/tools/flash.js +47 -10
  200. package/lib/tools/generate.js +25 -0
  201. package/lib/tools/ioc-apply.js +2 -0
  202. package/lib/tools/ioc-inspect.js +2 -0
  203. package/lib/tools/ioc-plan.js +59 -2
  204. package/lib/tools/ioc-verify.js +237 -0
  205. package/lib/tools/project-create.js +63 -3
  206. package/lib/tools/regs.js +453 -61
  207. package/lib/tools/route-plan.js +3 -0
  208. package/lib/tools/rtt.js +470 -0
  209. package/lib/tools/watch.js +256 -0
  210. package/package.json +5 -4
  211. package/templates/openocd/stm32c0x.cfg +83 -0
  212. package/templates/openocd/stm32u0x.cfg +64 -0
  213. package/templates/register/CMakeLists.txt +8 -2
  214. package/templates/register/Core/Inc/rtt.h +138 -0
  215. package/templates/register/Core/Src/main.c +42 -25
  216. package/templates/register/Core/Src/rtt.c +373 -0
  217. package/templates/scaffold/RTT.md +90 -0
  218. package/templates/scaffold/STM32F103XX_FLASH.ld +3 -0
  219. package/templates/scaffold/cmake/user/CMakeLists.txt +7 -0
  220. package/templates/scaffold/openocd.cfg +5 -3
  221. package/templates/scaffold/vscode/launch.json +8 -4
  222. package/docs/development-notes.md +0 -2116
  223. package/docs/dsh-stm32-plugin-/350/247/204/346/240/274.md +0 -673
  224. package/docs/logic-audit.md +0 -607
  225. package/lib/data/f1-ram.generated.js +0 -34
@@ -19,6 +19,10 @@ import { accessSync, constants, existsSync, mkdirSync, readFileSync, readdirSync
19
19
  import path from "node:path";
20
20
  import { dshFirmwareDir, firmwarePlanFor, verifyFirmwarePackage, } from "../data/firmware-packages.js";
21
21
  import { cacheRoot } from "./cache.js";
22
+ import { describeCubeMxGuiConflict, findRunningCubeMxGui } from "./cube-mx-guard.js";
23
+ import { locateCubemxDb } from "./cubemx-db.js";
24
+ import { downloadOfficialZip, installViaSwmgr, officialFirmwareUrl, resolveFwLibrary, verifyZipCrc, SWMGR_TIME_LIMIT_MS, } from "./firmware-official.js";
25
+ import { cubeMxLaunch } from "./generate.js";
22
26
  import { fetchAll } from "./fetch.js";
23
27
  import { extractTarGz } from "./tar.js";
24
28
  function slash(value) {
@@ -370,6 +374,8 @@ function emptyResult(mode, message) {
370
374
  steps: [],
371
375
  verify: { ok: false, checks: [] },
372
376
  download: { files: 0, bytes: 0 },
377
+ source: "",
378
+ downloadUrl: "",
373
379
  notes: [],
374
380
  message,
375
381
  nextStep: "",
@@ -389,6 +395,8 @@ function planResult(request, plan, decision) {
389
395
  const verify = verifyFirmwarePackage(decision.dir, plan.family);
390
396
  return {
391
397
  ok: verify.ok,
398
+ source: "existing",
399
+ downloadUrl: "",
392
400
  mode: "plan",
393
401
  family: plan.family,
394
402
  version: plan.version,
@@ -409,6 +417,8 @@ function planResult(request, plan, decision) {
409
417
  }
410
418
  return {
411
419
  ok: true,
420
+ source: "",
421
+ downloadUrl: "",
412
422
  mode: "plan",
413
423
  family: plan.family,
414
424
  version: plan.version,
@@ -494,6 +504,150 @@ function nextStepFor(kind, dir, packageName) {
494
504
  }
495
505
  return "直接调 stm32_generate:" + locate + "这个目录是调用方显式指定的:换机器或挪了目录之后要重新装(或更新安装记录),否则 generate 找不到。";
496
506
  }
507
+ /**
508
+ * 官网直取:下 ST 官方 zip → 校验 Content-Length + 每条 CRC32 → 交给 CubeMX 的 swmgr install 记账。
509
+ *
510
+ * 成功才返回报告;任何一步走不通就只往 notes 里记一条原因、返回 null,让调用方回退 GitHub 拼包。
511
+ * 不在这里抛异常:官网通道是"更好但不保证"的路,不该让本来能装上的包因为官网失败而装不上。
512
+ */
513
+ async function tryOfficial(request, plan, decision, steps, notes, progress) {
514
+ const subprocess = request.subprocess;
515
+ if (subprocess === undefined) {
516
+ notes.push("官网直取跳过:这次调用没带进程服务,只能走 GitHub 拼包。");
517
+ return null;
518
+ }
519
+ const env = request.env ?? process.env;
520
+ const explicitRoot = request.cubeMxRoot === undefined ? "" : request.cubeMxRoot.trim();
521
+ const root = explicitRoot !== ""
522
+ ? explicitRoot
523
+ : orderCubeMxRoots(request.cubeMxRoots).find((item) => hasCubeMxExe(item)) ?? "";
524
+ if (root === "") {
525
+ notes.push("官网直取跳过:没找到 STM32CubeMX 安装根(cubeMxRoot / cubeMxRoots 里都没有 STM32CubeMX.exe),只能走 GitHub 拼包。");
526
+ return null;
527
+ }
528
+ const launch = cubeMxLaunch([root]);
529
+ if (launch === null) {
530
+ notes.push("官网直取跳过:" + root + " 下没有可用的 java(jre/bin/java.exe)或 STM32CubeMX.exe,只能走 GitHub 拼包。");
531
+ return null;
532
+ }
533
+ // CubeMX 是单实例:GUI 开着时 -q 会被转发过去、可能弹模态框,swmgr 会一直等。
534
+ const gui = await findRunningCubeMxGui(subprocess, request.signal);
535
+ if (gui.length > 0) {
536
+ notes.push("官网直取跳过:" + describeCubeMxGuiConflict(gui));
537
+ return null;
538
+ }
539
+ const db = locateCubemxDb([root]);
540
+ const fwLibrary = resolveFwLibrary(db === null ? "" : db.root, request.mcu ?? "", plan.packageBase);
541
+ const url = officialFirmwareUrl(fwLibrary, plan.version, env);
542
+ // 下载按大文件给默认值;等 CubeMX 装包另算上限(许可没记录时不再干等)。
543
+ const downloadTimeoutMs = Math.max(request.timeoutMs ?? 600_000, 600_000);
544
+ const swmgrTimeoutMs = Math.min(downloadTimeoutMs, SWMGR_TIME_LIMIT_MS);
545
+ const prepare = stepOf(steps, "prepare");
546
+ const download = stepOf(steps, "download");
547
+ const extract = stepOf(steps, "extract");
548
+ const packageStep = stepOf(steps, "package");
549
+ const verifyStep = stepOf(steps, "verify");
550
+ prepare.status = "done";
551
+ prepare.detail = "官网直取:包装在 CubeMX 官方 Repository(" + root + "/Repository/" + plan.dirName + ")";
552
+ const zipFile = path.join(slash(cacheRoot(env)), "firmware", "downloads", plan.dirName + ".zip");
553
+ download.status = "running";
554
+ download.label = "下载官方固件包(" + fwLibrary + ")";
555
+ download.detail = url;
556
+ progress("官网直取:" + url);
557
+ const fetched = await downloadOfficialZip({
558
+ url,
559
+ destFile: zipFile,
560
+ ...(request.fetchImpl === undefined ? {} : { fetchImpl: request.fetchImpl }),
561
+ ...(request.signal === undefined ? {} : { signal: request.signal }),
562
+ timeoutMs: downloadTimeoutMs,
563
+ onProgress: (bytes, total) => {
564
+ const pct = total > 0 ? String(Math.floor((bytes * 100) / total)) + "%" : "";
565
+ progress("下载 " + String(Math.round(bytes / 1024)) + " KB" + (pct === "" ? "" : "(" + pct + ")"));
566
+ },
567
+ });
568
+ if (!fetched.ok) {
569
+ download.status = "failed";
570
+ download.detail = fetched.error;
571
+ notes.push("官网直取没下下来(HTTP " + String(fetched.status) + ":" + fetched.error + "),改用 GitHub 拼包。");
572
+ return null;
573
+ }
574
+ download.status = "done";
575
+ download.detail = String(Math.round(fetched.bytes / 1024)) + " KB(Content-Length " + String(fetched.contentLength) + " B,已核对)";
576
+ extract.status = "running";
577
+ extract.label = "校验官方 zip";
578
+ const crc = verifyZipCrc(zipFile, (checked, total) => progress("校验 CRC " + String(checked) + "/" + String(total)));
579
+ if (!crc.ok) {
580
+ extract.status = "failed";
581
+ extract.detail = crc.error !== "" ? crc.error : "CRC 对不上:" + crc.mismatches.map((item) => item.name).join("、");
582
+ notes.push("官网直取下的 zip 校验不过(" + extract.detail + "),已删掉重来,改用 GitHub 拼包。");
583
+ rmSync(zipFile, { force: true });
584
+ return null;
585
+ }
586
+ extract.status = "done";
587
+ extract.detail = "zip " + String(crc.entries) + " 条,逐条解压比过 " + String(crc.checked) + " 条 CRC32";
588
+ packageStep.status = "running";
589
+ packageStep.label = "交给 CubeMX 装进 Repository";
590
+ const installed = await installViaSwmgr({
591
+ subprocess,
592
+ java: launch.java,
593
+ jar: launch.jar,
594
+ root,
595
+ zipFile,
596
+ dirName: plan.dirName,
597
+ family: plan.family,
598
+ version: plan.version,
599
+ workDir: path.join(slash(cacheRoot(env)), "firmware", "swmgr"),
600
+ ...(request.signal === undefined ? {} : { signal: request.signal }),
601
+ timeoutMs: swmgrTimeoutMs,
602
+ onProgress: progress,
603
+ });
604
+ if (!installed.ok) {
605
+ packageStep.status = "failed";
606
+ packageStep.detail = installed.logTail;
607
+ if (installed.missingLicence !== "") {
608
+ notes.push("官网直取没装成:" + installed.missingLicence + " 的许可协议 CubeMX 还没记录(已接受:" +
609
+ (installed.acceptedLicences.length === 0 ? "无" : installed.acceptedLicences.join("、")) +
610
+ ")。这一族/版本的首装要先在 CubeMX 里点一次同意:Help → Manage embedded software packages → " +
611
+ "展开 " + plan.packageBase + " → Install → 许可协议点 I Agree;点过之后这条通道就能自己装," +
612
+ "本次先回退 GitHub 拼包。");
613
+ }
614
+ else {
615
+ notes.push("官网直取没装成(" + installed.error + ")。首次装某个族/版本时 CubeMX 会弹许可协议等人点同意," +
616
+ "无头进程等不到就只能放弃——去 CubeMX 包管理器里点一次同意,或继续用 GitHub 拼包。");
617
+ }
618
+ return null;
619
+ }
620
+ packageStep.status = "done";
621
+ packageStep.detail = "CubeMX 已装到 " + installed.dir + "(package.xml 由官方包自带,CubeMX 自己记账)";
622
+ if (installed.reused) {
623
+ notes.push("官网直取:Repository 里本来就有 " + plan.dirName + ",CubeMX 复核了一遍(日志末尾:" + installed.logTail + ")。");
624
+ }
625
+ const verify = verifyFirmwarePackage(installed.dir, plan.family);
626
+ if (!verify.ok) {
627
+ verifyStep.status = "failed";
628
+ verifyStep.detail = "缺:" + verify.missing.join("、");
629
+ notes.push("官网直取装出来的包自检缺 " + verify.missing.join("、") + ",改用 GitHub 拼包。");
630
+ return null;
631
+ }
632
+ verifyStep.status = "done";
633
+ verifyStep.detail = "三条判据全过(" + String(verify.checks.length) + " 项检查)";
634
+ const recordProblem = rememberFirmwareInstall(env, plan.dirName, installed.dir, "repository");
635
+ if (recordProblem !== "") {
636
+ notes.push("没写进安装记录(" + recordProblem + "):包在官方 Repository 里,生成时按 CubeMX 根也能找到。");
637
+ }
638
+ return {
639
+ ok: true,
640
+ source: "official",
641
+ downloadUrl: url,
642
+ targetKind: "repository",
643
+ targetDir: installed.dir,
644
+ download: { files: crc.entries, bytes: fetched.bytes },
645
+ verify,
646
+ message: "固件包从官网装好了:" + plan.dirName + " 在 " + installed.dir + "(CubeMX 官方 Repository," + fwLibrary + ")。" +
647
+ "下载 " + String(Math.round(fetched.bytes / 1024)) + " KB、zip " + String(crc.entries) + " 条逐条校验通过,三条判据全过。",
648
+ nextStep: nextStepFor("repository", installed.dir, plan.dirName),
649
+ };
650
+ }
497
651
  /** 真装。失败时已下载的东西会留在目标目录里(方便重试),最终判据是三条自检。 */
498
652
  export async function installFirmware(request) {
499
653
  const plan = firmwarePlanFor(request);
@@ -527,6 +681,7 @@ export async function installFirmware(request) {
527
681
  }
528
682
  return finish({
529
683
  ok: verify.ok,
684
+ source: "existing",
530
685
  verify,
531
686
  message: verify.ok
532
687
  ? "本机已经有 " + plan.dirName + "(" + decision.dir + "),不用下载。"
@@ -534,6 +689,23 @@ export async function installFirmware(request) {
534
689
  nextStep: "直接调 stm32_generate。",
535
690
  });
536
691
  }
692
+ // 官网直取(默认 auto):能走通就装进 CubeMX 自己的 Repository,走不通才回退下面的 GitHub 拼包。
693
+ // 显式 target=repository 也走这条路——反正落点相同,但官方包更全、不用我们维护 coreHeaders 表。
694
+ const source = request.source ?? "auto";
695
+ if (source !== "github" && request.targetDir === undefined && (request.target ?? "auto") !== "cache") {
696
+ const official = await tryOfficial(request, plan, decision, steps, notes, progress);
697
+ if (official !== null)
698
+ return finish(official);
699
+ if (source === "official") {
700
+ return finish({
701
+ ok: false,
702
+ source: "official",
703
+ message: "官网直取没成功(source=official,不回退 GitHub):" + (notes[notes.length - 1] ?? "原因见 notes。"),
704
+ nextStep: "首次装某个族/版本时 CubeMX 会弹许可协议等人点同意 —— 在 CubeMX 包管理器里点一次,再重跑;" +
705
+ "或者把 source 改成 auto,让插件回退 GitHub 拼包。",
706
+ });
707
+ }
708
+ }
537
709
  try {
538
710
  mkdirSync(decision.dir, { recursive: true });
539
711
  prepare.status = "done";
@@ -568,7 +740,9 @@ export async function installFirmware(request) {
568
740
  const options = {
569
741
  ...(request.signal === undefined ? {} : { signal: request.signal }),
570
742
  ...(request.fetchImpl === undefined ? {} : { fetchImpl: request.fetchImpl }),
571
- ...(request.timeoutMs === undefined ? {} : { timeoutMs: request.timeoutMs }),
743
+ // 固件包动辄十几 MB,fetch 层默认 30 s 对 CMSIS device 的 tarball 不够(F7/L4 实测三源全超时)。
744
+ // 这里给一个适合"大文件下载"的默认值;调用方仍可用 timeoutMs 覆盖。
745
+ timeoutMs: request.timeoutMs ?? 240_000,
572
746
  onProgress: (outcome, done, total) => {
573
747
  progress("下载 " + String(done) + "/" + String(total) + ":" + outcome.path + (outcome.ok ? " OK" : " 失败(" + outcome.error + ")"));
574
748
  },
@@ -634,6 +808,7 @@ export async function installFirmware(request) {
634
808
  }
635
809
  return finish({
636
810
  ok: true,
811
+ source: "github",
637
812
  download: { files, bytes },
638
813
  verify,
639
814
  message: "固件包装好了:" + plan.dirName + " 在 " + decision.dir + "(" + kindLabel(decision.kind) + ")。" +
@@ -662,7 +837,3 @@ export async function installFirmware(request) {
662
837
  }
663
838
  }
664
839
  }
665
- /** 计划 / 真装的总入口。 */
666
- export async function planOrInstallFirmware(request) {
667
- return (request.mode ?? "plan") === "install" ? installFirmware(request) : firmwareInstallPlan(request);
668
- }