dsh-stm32 0.1.3 → 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 (221) hide show
  1. package/README.md +52 -38
  2. package/README_EN.md +44 -33
  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 +37 -35
  133. package/lib/data/chips.js +3 -3
  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 +239 -18
  137. package/lib/data/db-presets.js +252 -0
  138. package/lib/data/device-facts.js +99 -26
  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 +15 -14
  148. package/lib/data/svd.js +32 -16
  149. package/lib/data/toolchain-config.js +0 -14
  150. package/lib/engine/assets.js +191 -456
  151. package/lib/engine/breakpoints.js +66 -11
  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 +423 -17
  161. package/lib/engine/debug.js +25 -6
  162. package/lib/engine/doctor.js +160 -17
  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 +290 -21
  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 +1244 -60
  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 +25 -6
  177. package/lib/engine/probe-session.js +50 -14
  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 +101 -40
  183. package/lib/engine/regs.js +41 -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 +188 -30
  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 +4 -2
  192. package/lib/skill/stm32-workflow.js +2 -2
  193. package/lib/tools/assets.js +39 -108
  194. package/lib/tools/cache.js +2 -2
  195. package/lib/tools/debug-session.js +2 -2
  196. package/lib/tools/doctor.js +55 -5
  197. package/lib/tools/firmware-install.js +31 -6
  198. package/lib/tools/flash.js +32 -4
  199. package/lib/tools/generate.js +22 -0
  200. package/lib/tools/ioc-inspect.js +1 -1
  201. package/lib/tools/ioc-plan.js +56 -2
  202. package/lib/tools/ioc-verify.js +237 -0
  203. package/lib/tools/project-create.js +41 -5
  204. package/lib/tools/regs.js +8 -8
  205. package/lib/tools/route-plan.js +1 -1
  206. package/lib/tools/rtt.js +157 -34
  207. package/lib/tools/watch.js +256 -0
  208. package/package.json +5 -4
  209. package/templates/openocd/stm32c0x.cfg +83 -0
  210. package/templates/openocd/stm32u0x.cfg +64 -0
  211. package/templates/register/CMakeLists.txt +2 -2
  212. package/templates/register/Core/Inc/rtt.h +37 -2
  213. package/templates/register/Core/Src/main.c +17 -25
  214. package/templates/register/Core/Src/rtt.c +85 -9
  215. package/templates/scaffold/RTT.md +6 -2
  216. package/templates/scaffold/STM32F103XX_FLASH.ld +3 -0
  217. package/templates/scaffold/openocd.cfg +5 -3
  218. package/templates/scaffold/vscode/launch.json +8 -4
  219. package/docs/development-notes.md +0 -2487
  220. package/docs/dsh-stm32-plugin-/350/247/204/346/240/274.md +0 -673
  221. package/docs/logic-audit.md +0 -607
@@ -0,0 +1,134 @@
1
+ import { existsSync, readFileSync, readdirSync } from "node:fs";
2
+ import { join } from "node:path";
3
+ import { homedir } from "node:os";
4
+ import { loadRmTopics } from "../data/rm-topics.js";
5
+ /** facts 缓存根(可用 DSH_STM32_FACTS 覆盖)。 */
6
+ export function factsRoot(env = process.env) {
7
+ const custom = env.DSH_STM32_FACTS;
8
+ return custom !== undefined && custom !== "" ? custom : join(homedir(), ".dsh-stm32", "facts");
9
+ }
10
+ /** STM32C031F6P6 → { family: "c0", line: "STM32C031" }。 */
11
+ export function partToFamilyLine(part) {
12
+ const m = /^STM32([A-Z])(\d)(\d)(\d)/i.exec(part.trim().toUpperCase());
13
+ if (m === null)
14
+ return null;
15
+ const a = m[1] ?? "";
16
+ const b = m[2] ?? "";
17
+ const c = m[3] ?? "";
18
+ const d = m[4] ?? "";
19
+ if (a === "" || b === "" || c === "" || d === "")
20
+ return null;
21
+ return { family: "stm32" + (a + b).toLowerCase(), line: "STM32" + a + b + c + d };
22
+ }
23
+ /** 从工程 .ioc 里读 MCU 型号(Mcu.CPN 或 Mcu.UserName)。 */
24
+ export function mcuFromIoc(projectDir) {
25
+ try {
26
+ const files = readdirSync(projectDir).filter((name) => name.toLowerCase().endsWith(".ioc"));
27
+ for (const name of files) {
28
+ const text = readFileSync(join(projectDir, name), "utf8");
29
+ const cpn = /^Mcu\.CPN=(.+)$/mu.exec(text)?.[1]?.trim();
30
+ if (cpn !== undefined && cpn !== "")
31
+ return cpn;
32
+ }
33
+ }
34
+ catch {
35
+ return null;
36
+ }
37
+ return null;
38
+ }
39
+ /** 给 summary 补 spec/载体两个维度(readFactsFor 的每条出口都过这里)。 */
40
+ function withSpecFields(s, part, env) {
41
+ const t = partToFamilyLine(part);
42
+ if (t === null)
43
+ return { ...s, hasSpec: false, rmPath: "" };
44
+ const loaded = loadRmTopics(t.family, t.line, factsRoot(env));
45
+ let rmPath = "";
46
+ try {
47
+ const raw = JSON.parse(readFileSync(join(factsRoot(env), t.family, t.line, "facts.json"), "utf8"));
48
+ const pdf = (raw.sources ?? []).find((x) => x.kind === "rm-pdf" && typeof x.path === "string" && existsSync(x.path));
49
+ rmPath = typeof pdf?.path === "string" ? pdf.path : "";
50
+ }
51
+ catch {
52
+ // facts 还没生成或读不动:rmPath 保持空串,不影响门禁
53
+ }
54
+ return { ...s, hasSpec: loaded.hasSpec, rmPath };
55
+ }
56
+ export function readFactsFor(part, env = process.env) {
57
+ return withSpecFields(readFactsRaw(part, env), part, env);
58
+ }
59
+ function readFactsRaw(part, env) {
60
+ const target = partToFamilyLine(part);
61
+ if (target === null) {
62
+ return { found: false, path: "", part, line: "", semantics: 0, verified: false, lines: [], needs: ["无法从型号 " + part + " 解析出族/线"] };
63
+ }
64
+ const file = join(factsRoot(env), target.family, target.line, "facts.json");
65
+ if (!existsSync(file)) {
66
+ return {
67
+ found: false,
68
+ path: file,
69
+ part: part.toUpperCase(),
70
+ line: target.line,
71
+ semantics: 0,
72
+ verified: false,
73
+ lines: [],
74
+ needs: ["facts 未生成:node scripts/facts/build-facts.mjs --part " + part.toUpperCase() + "(SVD 会自动本地找→下载缓存→联网取;语义另需该线 rm-facts)"],
75
+ };
76
+ }
77
+ let pkg;
78
+ try {
79
+ pkg = JSON.parse(readFileSync(file, "utf8"));
80
+ }
81
+ catch (error) {
82
+ return { found: false, path: file, part, line: target.line, semantics: 0, verified: false, lines: [], needs: ["facts.json 解析失败:" + (error instanceof Error ? error.message : String(error))] };
83
+ }
84
+ const semantics = pkg.semantics ?? [];
85
+ const lines = [];
86
+ for (const item of semantics) {
87
+ const page = item.source?.page === undefined ? "" : "(RM p." + String(item.source.page) + ")";
88
+ lines.push(item.id + ":" + item.statement + page);
89
+ if (Array.isArray(item.table) && item.table.length > 0) {
90
+ lines.push(" " + item.table.map((row) => Object.values(row).join("/")).join(" | "));
91
+ }
92
+ }
93
+ const declared = Array.isArray(pkg.needs) ? pkg.needs.filter((n) => typeof n === "string" && n !== "") : [];
94
+ const needs = semantics.length === 0
95
+ ? (declared.length > 0 ? declared : ["本线只有结构、语义未核实:需要该线对应的 RM 手册与 rm-facts 抽取"])
96
+ : declared;
97
+ return { found: true, path: file, part: pkg.part ?? part, line: pkg.line ?? target.line, semantics: semantics.length, verified: semantics.length > 0, lines, needs };
98
+ }
99
+ /** 给工具输出用的摘要行(带结论语气)。 */
100
+ export function describeFacts(summary) {
101
+ if (!summary.found)
102
+ return ["事实层:" + (summary.needs[0] ?? "未生成") + (summary.hasSpec ? "(这颗芯片有清单,烧录门禁会拦)" : "(这颗芯片没清单,不拦烧录)")];
103
+ const rm = summary.rmPath === "" ? "" : "|RM 载体本地路径:" + summary.rmPath;
104
+ if (!summary.verified) {
105
+ if (summary.hasSpec)
106
+ return ["事实层:" + summary.line + " 有清单但机检没过:" + summary.needs.join(";") + "(stm32_flash 拒烧,allowUnknownFacts=true 可强制)" + rm];
107
+ return ["事实层:" + summary.line + " 仅结构、无主题清单:不拦烧录" + rm];
108
+ }
109
+ const out = ["事实层:" + summary.line + "(" + String(summary.semantics) + " 条语义,已验证)" + rm];
110
+ for (const line of summary.lines)
111
+ out.push(" · " + line);
112
+ return out;
113
+ }
114
+ /**
115
+ * 给 stm32_generate / stm32_project_create 用的「生成前风险」一行式摘要。
116
+ * 与 describeFacts(doctor/flash 的多行详单)不同口径:这里只回答一件事——
117
+ * 生成完这块板,烧录门禁会不会拦、缺什么。三态各一句,found=false 也给指路命令。
118
+ */
119
+ export function generationRiskNotes(part, env = process.env) {
120
+ if (part === null || part.trim() === "")
121
+ return [];
122
+ const s = readFactsFor(part, env);
123
+ const rm = s.rmPath === "" ? "" : ";RM 载体:本地 " + s.rmPath + "(调试怪行为可 pdf_scan/pdf_read_page 反查原文)";
124
+ if (s.found && s.verified) {
125
+ return ["事实层 " + s.line + " 已核实 " + String(s.semantics) + " 条语义(自举/调试门控/选项字节)→ stm32_flash 不会因只读门禁拦;逐条摘要见 stm32_doctor" + rm];
126
+ }
127
+ if (s.hasSpec) {
128
+ return ["事实层 " + (s.found ? s.line : part) + " 有 rm-topics 主题清单但机检没过/书没建起来 → stm32_flash 会拒烧(allowUnknownFacts=true 可强制)" + (s.needs.length > 0 ? ":" + s.needs[0] : "") + rm];
129
+ }
130
+ if (!s.found) {
131
+ return ["事实层(RM/SVD)未生成(stm32_flash 对没清单的芯片只提示不拦;工具会自动补,补失败多半是离线,可跑 build-facts.mjs --part " + s.part + ")"];
132
+ }
133
+ return ["事实层 " + s.line + " 只有结构、没有主题清单:不拦烧录,直接烧即可" + rm];
134
+ }
@@ -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
- }