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
@@ -0,0 +1,319 @@
1
+ /**
2
+ * pllmn 模型的时钟规划(PLLM / PLLN / PLLP:F2 / F4 / F7 / G4 / L4 这类族)。
3
+ *
4
+ * 与 pllmul 模型的区别只在「源 → SYSCLK」这一段:
5
+ * pllmul:sysclk = src × PLLMUL
6
+ * pllmn :vco = src / PLLM × PLLN;sysclk = vco / PLLP
7
+ * 后面 AHB/APB/ADC 分频与要写的 RCC.* 键基本一致(键名从 PLLMUL 变成 PLLM/PLLN/PLLP)。
8
+ *
9
+ * 事实来源:PLLM/PLLN/PLLP 的枚举、PLLN 的 Min/Max、总线频率上限、VCO 允许区间、以及
10
+ * AHB/APB 分频的枚举名都从 db 的 RCC-*_Modes.xml 读(见 src/data/clock-db.ts);
11
+ * 核过手册/真机的族在那边用 override 表压过 db(F103 这类 db 偏保守的族)。
12
+ */
13
+ import { apbDivValue, pllSourceById } from "../data/clock-f1.js";
14
+ import { emptyClockPlan, formatHz, peripheralClockHz } from "./clock-plan.js";
15
+ /** PLL 输入频率(HSI 用 .ioc 的 RCC.HSI_VALUE;HSE 用 RCC.HSE_VALUE)。 */
16
+ export function pllInHzOfSource(source, hseHz, hsiHz, facts) {
17
+ const fact = pllSourceById(source, facts.sources);
18
+ if (fact === null)
19
+ return 0;
20
+ if (fact.id === "hse")
21
+ return hseHz;
22
+ const divider = fact.divider ?? (fact.id === "hsi-div2" ? 2 : 1);
23
+ return Math.round(hsiHz / divider);
24
+ }
25
+ function divFact(divs, div) {
26
+ if (divs === undefined)
27
+ return null;
28
+ return divs.find((item) => item.div === div) ?? null;
29
+ }
30
+ function minimalDiv(divs, value, limit) {
31
+ let best = null;
32
+ for (const item of divs) {
33
+ if (value / item.div > limit)
34
+ continue;
35
+ if (best === null || item.div < best.div)
36
+ best = item;
37
+ }
38
+ return best ?? divs[divs.length - 1];
39
+ }
40
+ /** 从 .ioc 读 RCC.HSE_VALUE / RCC.HSI_VALUE,缺省按 8 / 16 MHz(F4 的 HSI 是 16 MHz)。 */
41
+ function readSourcesHz(entries) {
42
+ const hse = Number.parseInt((entries.get("RCC.HSE_VALUE") ?? "").trim(), 10);
43
+ const hsi = Number.parseInt((entries.get("RCC.HSI_VALUE") ?? "").trim(), 10);
44
+ return {
45
+ hseHz: Number.isFinite(hse) && hse > 0 ? hse : 8_000_000,
46
+ hsiHz: Number.isFinite(hsi) && hsi > 0 ? hsi : 16_000_000,
47
+ };
48
+ }
49
+ /**
50
+ * pllmn 的规划入口。返回与 pllmul 完全同形状的 ClockPlan,这样 ioc-plan 不用分叉。
51
+ */
52
+ export function planClockPllmn(input) {
53
+ const { request, entries, facts, familyId } = input;
54
+ // VCO 区间跟着 facts 走(db 读出来的或核过的 override),不再按族名查表:
55
+ // 这样新族只要 db 里有 VCOOutputFreq_Value/VCOInputFreq_Value 就能规划。
56
+ const vcoLimits = facts.vco;
57
+ const pllM = facts.pllM ?? [];
58
+ // L4 这类族的 SYSCLK 输出是 PLLR(PLLP 属于 PLLSAI1,只有 DIV7/DIV17)
59
+ const useR = facts.sysclkOutput === "R";
60
+ const pllP = (useR ? (facts.pllR ?? []) : (facts.pllP ?? []));
61
+ // PLL1 族的分频键是 RCC.PLL1P/PLL1R(H5/U5/WBA/L4+),写 PLLP/PLLR 会被当成未知键丢掉。
62
+ // 键名一律以 db 为准(L4+ 是 RCC.PLLM1 / RCC.PLL1P,U5 的 PLL1P 是整数区间),查不到才回退旧写法。
63
+ const outputKey = useR
64
+ ? (facts.pllRKey ?? (facts.pll1Naming === true ? "RCC.PLL1R" : "RCC.PLLR"))
65
+ : (facts.pllPKey ?? (facts.pll1Naming === true ? "RCC.PLL1P" : "RCC.PLLP"));
66
+ const pllN = facts.pllN ?? null;
67
+ if (vcoLimits === undefined) {
68
+ return emptyClockPlan(familyId + " 的 PLLM/PLLN/PLLP 模型已从 db 读到,但 VCO 允许区间(db 的 VCOOutputFreq_Value/VCOInputFreq_Value 或 override 表)没有:clock 参数不会生效");
69
+ }
70
+ if (pllM.length === 0 || pllP.length === 0 || pllN === null) {
71
+ return emptyClockPlan(familyId + " 的 db 事实不全(缺 PLLM/PLLN/PLLP 枚举):clock 参数不会生效");
72
+ }
73
+ const { hseHz, hsiHz } = readSourcesHz(entries);
74
+ const hasHse = entries.has("RCC.HSE_VALUE") || entries.get("RCC.PLLSourceVirtual") === "RCC_PLLSOURCE_HSE";
75
+ const targetHz = request?.targetHz ?? 0;
76
+ const wantedSource = request?.pllSource ?? (hasHse ? "hse" : "hsi");
77
+ // 1) 枚举所有 (源, M, N, P),留下 VCO 与 SYSCLK 都合法的组合
78
+ const candidates = [];
79
+ const nMin = Math.max(pllN.min, 2);
80
+ // H5 的 PLLN 到 512(其余族 432 以内),上限按 db 给的值,再兜一层 512 防脏数据。
81
+ const nMax = Math.min(pllN.max, 512);
82
+ for (const source of facts.sources) {
83
+ if (!source.selectable)
84
+ continue;
85
+ const srcHz = pllInHzOfSource(source.id, hseHz, hsiHz, facts);
86
+ if (srcHz <= 0)
87
+ continue;
88
+ for (const m of pllM) {
89
+ const inHz = srcHz / m.div;
90
+ if (vcoLimits.inMinHz !== undefined && inHz < vcoLimits.inMinHz)
91
+ continue;
92
+ if (vcoLimits.inMaxHz !== undefined && inHz > vcoLimits.inMaxHz)
93
+ continue;
94
+ // PLL1 族:VCO 允许区间按输入频段分段(H5 的 PLL1_VCI_Range),先定段再判 VCO。
95
+ const bands = facts.vcoBands ?? [];
96
+ let bandMinHz = vcoLimits.minHz;
97
+ let bandMaxHz = vcoLimits.maxHz;
98
+ let band;
99
+ if (bands.length > 0) {
100
+ band = bands.find((item) => inHz >= item.inMinHz && inHz <= item.inMaxHz);
101
+ if (band === undefined)
102
+ continue;
103
+ bandMinHz = band.minHz;
104
+ bandMaxHz = band.maxHz;
105
+ }
106
+ // N 全扫(50..432,几百个值,成本可忽略):早先按目标反推邻域会在 P≠1 时把正确档位截掉
107
+ // (8 MHz/4 × 168 × 1/2 = 168 MHz 这种档位就落在窗口外,实测选了 86 MHz)。
108
+ for (let n = nMin; n <= nMax; n += 1) {
109
+ const vcoHz = Math.round(inHz * n);
110
+ if (vcoHz < bandMinHz || vcoHz > bandMaxHz)
111
+ continue;
112
+ for (const p of pllP) {
113
+ const sysclkHz = Math.round(vcoHz / p.div);
114
+ if (sysclkHz <= 0 || sysclkHz > facts.limits.sysclkHz)
115
+ continue;
116
+ const score = targetHz > 0 ? Math.abs(sysclkHz - targetHz) : 0;
117
+ candidates.push({
118
+ source: source.id,
119
+ sourceLabel: source.label,
120
+ m: m.div,
121
+ n,
122
+ p: p.div,
123
+ vcoHz,
124
+ sysclkHz,
125
+ score,
126
+ ...(band === undefined ? {} : { vciValue: band.value }),
127
+ ...(band?.vcoSel === undefined ? {} : { vcoSelValue: band.vcoSel }),
128
+ });
129
+ }
130
+ }
131
+ }
132
+ }
133
+ if (candidates.length === 0) {
134
+ return emptyClockPlan("在 " + familyId + " 的 PLLM/PLLN/PLLP 组合里找不到满足 VCO 与 SYSCLK 上限的档位:clock 参数不会生效");
135
+ }
136
+ // 2) 选最接近目标的;同分时优先「用户指定的源」、再优先 P=2(VCO 越高越少抖动)
137
+ const sameSource = candidates.filter((item) => item.source === wantedSource);
138
+ const pool = sameSource.length > 0 ? sameSource : candidates;
139
+ pool.sort((left, right) => left.score - right.score || left.p - right.p || left.m - right.m);
140
+ const best = pool[0];
141
+ // 3) 总线频率与分频(APB1/APB2 都取满足各自上限的最小分频)。
142
+ // APB2 曾经写死 ÷1:F4/F7/G4/L4 的 SYSCLK 上限恰好等于 APB2 上限,看不出来;
143
+ // F2 是 120 MHz SYSCLK / 60 MHz APB2,写死 ÷1 会把 APB2 顶到 120 MHz(超规格),
144
+ // CubeMX 载入这份 .ioc 会卡住不返回(实测 >240 s 无输出)。
145
+ const apb1Div = request?.apb1Div ?? minimalDiv(facts.apbDivs, best.sysclkHz, facts.limits.apb1Hz).div;
146
+ const apb2Div = request?.apb2Div ?? minimalDiv(facts.apbDivs, best.sysclkHz, facts.limits.apb2Hz).div;
147
+ const apb1Hz = Math.round(best.sysclkHz / apb1Div);
148
+ const apb2Hz = Math.round(best.sysclkHz / apb2Div);
149
+ const adcDiv = request?.adcDiv ?? minimalDiv(facts.adcDivs.length > 0 ? facts.adcDivs : [{ div: 1, iocValue: "" }], apb2Hz, facts.limits.adcHz).div;
150
+ const adcHz = Math.round(apb2Hz / adcDiv);
151
+ const chain = {
152
+ pllSource: best.source,
153
+ pllSourceLabel: best.sourceLabel,
154
+ pllInHz: Math.round(pllInHzOfSource(best.source, hseHz, hsiHz, facts) / best.m),
155
+ pllMul: best.n,
156
+ pllM: best.m,
157
+ pllN: best.n,
158
+ pllP: best.p,
159
+ pllClkHz: best.vcoHz / best.p,
160
+ sysclkHz: best.sysclkHz,
161
+ hclkHz: best.sysclkHz,
162
+ apb1Div,
163
+ apb1TimHz: apb1Div === 1 ? apb1Hz : apb1Hz * 2,
164
+ apb1Hz,
165
+ apb2Div,
166
+ apb2Hz,
167
+ apb2TimHz: apb2Div === 1 ? apb2Hz : apb2Hz * 2,
168
+ adcDiv,
169
+ adcHz,
170
+ usbHz: 0,
171
+ usbAvailable: false,
172
+ usbPrescaled: false,
173
+ mcoHz: 0,
174
+ };
175
+ const peripherals = facts.peripheralClocks.map((fact) => ({
176
+ id: fact.id,
177
+ label: fact.label,
178
+ bus: fact.bus,
179
+ clockHz: peripheralClockHz(chain, fact),
180
+ note: "",
181
+ }));
182
+ // 4) 要写的键(pllmn 用 PLLM/PLLN/PLLP,没有 PLLMUL)
183
+ const mFact = divFact(pllM, best.m);
184
+ const pFact = divFact(pllP, best.p);
185
+ if (mFact === null || pFact === null) {
186
+ return emptyClockPlan("PLLM/PLLP 的 .ioc 取值在 db 枚举里找不到:clock 参数不会生效");
187
+ }
188
+ const draft = new Map();
189
+ draft.set("RCC.PLLSourceVirtual", pllSourceById(best.source, facts.sources).iocValue);
190
+ draft.set(facts.pllMKey ?? "RCC.PLLM", mFact.iocValue);
191
+ draft.set("RCC.PLLN", String(best.n));
192
+ draft.set(outputKey, pFact.iocValue);
193
+ // PLL1 族:把输入频段与 VCO 档位一起写回去,否则 CubeMX 按默认档(通常是窄档)校验,
194
+ // 选出来的 VCO 可能落在默认档之外 → 载入后被改回默认频率。
195
+ if (facts.vciRangeKey !== undefined && best.vciValue !== undefined)
196
+ draft.set(facts.vciRangeKey, best.vciValue);
197
+ if (facts.vcoSelKey !== undefined && best.vcoSelValue !== undefined)
198
+ draft.set(facts.vcoSelKey, best.vcoSelValue);
199
+ // H5/U5 的 PLL 有显式开关:不写 PLLUsed=1 时 CubeMX 认为 PLL 不用,SYSCLK 回落 HSI。
200
+ if (facts.pllEnable !== undefined) {
201
+ // 只写 PLLUsed=1:PLLState 是 db 里按 PLLUsed 派生的(Condition=PLLUsed=0 时给 OFF),
202
+ // 写它反而会被 CubeMX 丢掉(F4/F7 实测:missingKeys 里出现 RCC.PLLState、IPParameters 判成改写)。
203
+ draft.set(facts.pllEnable.usedKey, facts.pllEnable.usedValue);
204
+ }
205
+ // SYSCLK 源的键名按 db 决定:F303 只有 SYSCLKSourceVirtual 生效(写 RCC.SYSCLKSource 会被丢)。
206
+ draft.set(facts.sysclkSourceKey ?? "RCC.SYSCLKSource", "RCC_SYSCLKSOURCE_PLLCLK");
207
+ // 分频键的取值必须来自 db 的枚举名:AHB 与 APB 不是同一套名字(F2/F4/F7 的 AHB 是
208
+ // RCC_SYSCLK_DIVn,APB 是 RCC_HCLK_DIVn;C0 反过来)。写错名字 CubeMX **不报错**,
209
+ // 载入时直接死循环(F2 实测 >240 s 停在 setPackage),所以这里按 div 去枚举里查,
210
+ // 查不到就不写这个键(缺省值本来就是 ÷1,正好是我们要的)。
211
+ const divValueOf = (divs, div, fallback) => divFact(divs, div)?.iocValue ?? fallback(div);
212
+ const ahbValue = divValueOf(facts.ahbDivs, 1, () => "");
213
+ if (ahbValue !== "")
214
+ draft.set("RCC.AHBCLKDivider", ahbValue);
215
+ draft.set("RCC.APB1CLKDivider", divValueOf(facts.apbDivs, apb1Div, apbDivValue));
216
+ draft.set("RCC.APB2CLKDivider", divValueOf(facts.apbDivs, apb2Div, apbDivValue));
217
+ // 派生频率键:只有 db 里真有这个参数名的才写(H5 没有 PLLCLKFreq_Value,写进去会被当成未知键丢掉)。
218
+ const known = facts.knownDerivedNames ?? [];
219
+ const setDerived = (names, value) => {
220
+ const list = typeof names === "string" ? [names] : names;
221
+ // SYSCLKFreq_VALUE 的尾巴是 _VALUE(不是 Freq_Value),所以它永远不在 derivedNames 名单里,
222
+ // 但这一族一定有它(每个族的 RCC Modes 都带),必须写。
223
+ const name = list.includes("SYSCLKFreq_VALUE")
224
+ ? "SYSCLKFreq_VALUE"
225
+ : known.length === 0
226
+ ? list[0]
227
+ : list.find((item) => known.includes(item));
228
+ if (name === undefined)
229
+ return;
230
+ draft.set("RCC." + name, String(value));
231
+ };
232
+ setDerived("SYSCLKFreq_VALUE", best.sysclkHz);
233
+ setDerived("HCLKFreq_Value", best.sysclkHz);
234
+ // AHB 只 ÷1(上面写的 AHBCLKDivider 就是 ÷1),所以 AHB 与 Cortex 都等于 HCLK。
235
+ // 不写它们 CubeMX 保存时会按自己的树重算一遍,verify 里就成了「值被改写」的噪声(F2 实测)。
236
+ setDerived("AHBFreq_Value", best.sysclkHz);
237
+ // Cortex(SysTick)只有在 db 没给选择/分频参数时才等于 HCLK。H5/U5/WBA/L4+ 有 Cortex_Div 这类参数,
238
+ // 实测同一族两次往返能反着改(H5 写 HCLK 被改成 HCLK÷8,U5 写 HCLK÷8 又被改回 HCLK)——
239
+ // 那就交给 CubeMX 算,verify 会归到 derivedRecomputed(不参与 benign)。
240
+ if (facts.cortexFollowsHclk !== false) {
241
+ setDerived("CortexFreq_Value", best.sysclkHz);
242
+ setDerived("FCLKCortexFreq_Value", best.sysclkHz);
243
+ }
244
+ setDerived(["PLLCLKFreq_Value", "PLL1CLKFreq_Value", "PLLRCLKFreq_Value", "PLLPoutputFreq_Value"], Math.round(best.vcoHz / best.p));
245
+ setDerived("VCOOutputFreq_Value", best.vcoHz);
246
+ setDerived("APB1Freq_Value", apb1Hz);
247
+ setDerived("APB1TimFreq_Value", chain.apb1TimHz);
248
+ setDerived("APB2Freq_Value", apb2Hz);
249
+ setDerived("APB2TimFreq_Value", chain.apb2TimHz);
250
+ if (adcDiv >= 2 && facts.adcDivs.length > 0) {
251
+ const adcFact = divFact(facts.adcDivs, adcDiv);
252
+ if (adcFact !== null && adcFact.iocValue !== "") {
253
+ draft.set("RCC.ADCPresc", adcFact.iocValue);
254
+ setDerived(["ADCFreqValue", "ADCFreq_Value"], adcHz);
255
+ }
256
+ }
257
+ // RCC.IPParameters 要把上面这些名字并进去(CubeMX 按它决定读哪些键)
258
+ const existing = (entries.get("RCC.IPParameters") ?? "").split(",").map((item) => item.trim()).filter((item) => item !== "");
259
+ const merged = [...existing];
260
+ for (const key of draft.keys()) {
261
+ const name = key.slice("RCC.".length);
262
+ if (!merged.includes(name))
263
+ merged.push(name);
264
+ }
265
+ // CubeMX 自己写这一列时是**按 ASCII 升序**排的(实测 F2:48MHZClocksFreq_Value,AHBCLKDivider,
266
+ // AHBFreq_Value,… ,VcooutputI2S——大写整体排在小写前面)。这里跟着排序,否则每次 verify 都会
267
+ // 报「IPParameters 的值被改写」,把真正的差异淹掉。
268
+ draft.set("RCC.IPParameters", merged.sort().join(","));
269
+ const reachable = targetHz === 0 || best.sysclkHz === targetHz;
270
+ const deltaHz = targetHz === 0 ? 0 : best.sysclkHz - targetHz;
271
+ const notes = [];
272
+ notes.push((targetHz === 0 ? "时钟现状" : reachable ? "目标 " + formatHz(targetHz) + " 可达" : "目标 " + formatHz(targetHz) + " 不可达,已选 " + formatHz(best.sysclkHz)) +
273
+ ":" + best.sourceLabel + " ÷" + String(best.m) + " ×" + String(best.n) + " ÷" + String(best.p) +
274
+ " → SYSCLK " + formatHz(best.sysclkHz) + "(VCO " + formatHz(best.vcoHz) + ")");
275
+ if (!reachable)
276
+ notes.push("PLLM/PLLN/PLLP 只能凑出上面这一档最接近的频率");
277
+ return {
278
+ mode: targetHz === 0 ? "snapshot" : "nearest",
279
+ ok: true,
280
+ reachable,
281
+ deltaHz,
282
+ note: notes.join(";"),
283
+ requested: {
284
+ targetHz,
285
+ pllSource: wantedSource,
286
+ pllMul: best.n,
287
+ apb1Div,
288
+ apb2Div,
289
+ adcDiv,
290
+ },
291
+ achieved: chain,
292
+ alternatives: candidates
293
+ .filter((item) => item.sysclkHz !== best.sysclkHz && item.source === best.source)
294
+ .sort((left, right) => left.score - right.score)
295
+ .slice(0, 3)
296
+ .map((item) => ({
297
+ sysclkHz: item.sysclkHz,
298
+ pllSource: item.source,
299
+ pllSourceLabel: item.sourceLabel,
300
+ pllMul: item.n,
301
+ apb1Div: minimalDiv(facts.apbDivs, item.sysclkHz, facts.limits.apb1Hz).div,
302
+ apb2Div: minimalDiv(facts.apbDivs, item.sysclkHz, facts.limits.apb2Hz).div,
303
+ adcDiv,
304
+ usbAvailable: false,
305
+ deltaHz: targetHz === 0 ? 0 : item.sysclkHz - targetHz,
306
+ })),
307
+ peripherals,
308
+ bauds: [],
309
+ entries: [...draft.entries()].map(([key, value]) => ({ key, value })),
310
+ unset: [
311
+ "RCC.PLLMUL",
312
+ "RCC.PLLMCOFreq_Value",
313
+ "RCC.USBPrescaler",
314
+ facts.pll1Naming === true ? (useR ? "RCC.PLL1P" : "RCC.PLL1R") : useR ? "RCC.PLLP" : "RCC.PLLR",
315
+ ],
316
+ warnings: [],
317
+ errors: [],
318
+ };
319
+ }
@@ -18,6 +18,7 @@
18
18
  */
19
19
  import { existsSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
20
20
  import { basename, join } from "node:path";
21
+ import { defineSuffix } from "../data/device-facts.js";
21
22
  import { readTextFile } from "./text-file.js";
22
23
  /** ST 的 CMake 布局里那份「CubeMX 生成」的源清单。 */
23
24
  export const CUBEMX_CMAKE_REL = "cmake/stm32cubemx/CMakeLists.txt";
@@ -63,9 +64,20 @@ export function pickStartupFile(projectDir) {
63
64
  export function startupStem(file) {
64
65
  return basename(file).replace(/^startup_/iu, "").replace(/\.s$/iu, "").toLowerCase();
65
66
  }
66
- /** stm32f103xb → STM32F103xB(就是 CMSIS 头里那个宏,也是 cmake 源清单里那一行)。 */
67
+ /**
68
+ * stm32f103xb → STM32F103xB(就是 CMSIS 头里那个宏,也是 cmake 源清单里那一行)。
69
+ *
70
+ * 不能简单"大写后把倒数第二个 X 换小写":那条规则只对 xb/xc/xe 这种「x + 容量字母」成立,
71
+ * 对 xx 档(startup_stm32f407xx.s)会把 STM32F407xx 写成 **STM32F407xX** → CMSIS 头认不出设备,
72
+ * 编译期报「Please select first the target STM32F4xx device」。对 cx/rx 这种「按封装分档」的
73
+ * (startup_stm32f410cx.s → STM32F410Cx)更是大小写相反。尾缀规则统一由 defineSuffix 决定。
74
+ */
67
75
  export function deviceDefineFromStartup(file) {
68
- return startupStem(file).toUpperCase().replace(/X(?=.$)/u, "x");
76
+ const stem = startupStem(file);
77
+ // 太短的名字没尾缀可拆(例如 startup_stm32.s):原样大写,别在这里瞎猜。
78
+ if (stem.length < 8)
79
+ return stem.toUpperCase();
80
+ return stem.slice(0, -2).toUpperCase() + defineSuffix(stem.slice(-2));
69
81
  }
70
82
  /** stm32f103xb → { token: stm32f1xx, upper: STM32F1xx };认不出返回 null。 */
71
83
  export function familyTokensFromStartup(file) {
@@ -75,6 +87,36 @@ export function familyTokensFromStartup(file) {
75
87
  const code = matched[1];
76
88
  return { token: "stm32" + code + "xx", upper: "STM32" + code.toUpperCase() + "xx" };
77
89
  }
90
+ /**
91
+ * 从工程里真实存在的 Drivers/STM32<族>xx_HAL_Driver 目录反推家族名。
92
+ *
93
+ * 为什么不能只靠启动文件名:F1/F4 这类「族段两字符」的启动文件名(stm32f103xb)能拆出 f1,
94
+ * 但 WBA 是 startup_stm32wba50xx.s、WL 是 startup_stm32wle4xx.s —— 族段三四个字符,
95
+ * ^stm32([a-z]\d) 直接匹配不上,于是 collectCmakeSources 报「认不出启动文件属于哪个族」,
96
+ * 源清单一个字都不改(WBA/WL 的 CMakeLists 里就留着固件包里根本不存在的
97
+ * stm32wbaxx_hal_gpio_ex.c,cmake configure 在 target_sources 处失败)。
98
+ * 目录名是磁盘上的事实:STM32WBAxx_HAL_Driver → token stm32wbaxx、upper STM32WBAxx。
99
+ */
100
+ export function familyTokensFromDriversDir(projectDir) {
101
+ const dir = join(projectDir, "Drivers");
102
+ if (!existsSync(dir))
103
+ return null;
104
+ let names;
105
+ try {
106
+ names = readdirSync(dir);
107
+ }
108
+ catch {
109
+ return null;
110
+ }
111
+ const hits = names
112
+ .map((name) => /^STM32([A-Z0-9]+)xx_HAL_Driver$/u.exec(name)?.[1] ?? "")
113
+ .filter((token) => token.length >= 2)
114
+ .sort();
115
+ if (hits.length === 0)
116
+ return null;
117
+ const code = hits[0];
118
+ return { token: "stm32" + code.toLowerCase() + "xx", upper: "STM32" + code + "xx" };
119
+ }
78
120
  /**
79
121
  * 抹掉注释再匹配。
80
122
  *
@@ -168,9 +210,10 @@ export function collectCmakeSources(projectDir) {
168
210
  if (startup === null) {
169
211
  return { error: "工程根没有 startup_stm32*.s(不是脚手架建的 HAL 工程?),无从反推芯片与源清单" };
170
212
  }
171
- const family = familyTokensFromStartup(startup.file);
213
+ // 优先信磁盘上的 HAL 目录(WBA/WL 这种三四字符族段的启动文件名拆不出族);拆不出再回退文件名规则。
214
+ const family = familyTokensFromDriversDir(projectDir) ?? familyTokensFromStartup(startup.file);
172
215
  if (family === null)
173
- return { error: "认不出启动文件 " + startup.file + " 属于哪个 STM32 家族" };
216
+ return { error: "认不出启动文件 " + startup.file + " 属于哪个 STM32 家族(Drivers 下也没有 STM32*xx_HAL_Driver 目录)" };
174
217
  const deviceDefine = deviceDefineFromStartup(startup.file);
175
218
  const notes = [...startup.notes];
176
219
  const moduleFacts = halModulesInUse(projectDir, family);
@@ -203,18 +246,29 @@ export function collectCmakeSources(projectDir) {
203
246
  "(先确认 Drivers 目录是不是完整拷贝)");
204
247
  }
205
248
  const appFiles = [];
206
- const appCandidates = [
207
- "Core/Src/main.c",
208
- "Core/Src/" + family.token + "_it.c",
209
- "Core/Src/" + family.token + "_hal_msp.c",
210
- "Core/Src/sysmem.c",
211
- "Core/Src/syscalls.c",
212
- startup.file,
213
- ];
214
- for (const rel of appCandidates) {
249
+ // 固定项先排:main / 中断 / MSP 是每份工程都有的入口文件。
250
+ for (const rel of ["Core/Src/main.c", "Core/Src/" + family.token + "_it.c", "Core/Src/" + family.token + "_hal_msp.c"]) {
215
251
  if (exists(rel))
216
252
  appFiles.push(rel);
217
253
  }
254
+ // 其余从磁盘枚举:CubeMX 在「每个外设一对 .c/.h」模式下会把 GPIO/ADC/USART 拆成 gpio.c、adc.c…
255
+ // 早期这里只列了 sysmem/syscalls,导致这些文件不进 CMakeLists(C0 实测:main.c 引 MX_GPIO_Init,
256
+ // gpio.c 没参与链接 → undefined reference to MX_GPIO_Init)。
257
+ try {
258
+ const coreSrc = join(projectDir, "Core", "Src");
259
+ for (const name of readdirSync(coreSrc).filter((item) => /\.c$/iu.test(item)).sort()) {
260
+ const rel = "Core/Src/" + name;
261
+ // system_*.c 已经在 driverFiles 里(排在 HAL 驱动那块),这里不能再列一次。
262
+ if (rel === systemSrc)
263
+ continue;
264
+ if (!appFiles.includes(rel))
265
+ appFiles.push(rel);
266
+ }
267
+ }
268
+ catch {
269
+ notes.push("读不了 Core/Src(工程可能还没生成代码),应用源清单只含已知入口文件");
270
+ }
271
+ appFiles.push(startup.file);
218
272
  return { startup: startup.file, deviceDefine, family, modules: moduleFacts.modules, driverDir, driverFiles, appFiles, notes };
219
273
  }
220
274
  function findBlock(lines, varName) {
@@ -0,0 +1,44 @@
1
+ /**
2
+ * CubeMX 图形界面的占用检测。
3
+ *
4
+ * 为什么需要:CubeMX 是**单实例**应用。GUI 已经开着的时候再执行
5
+ * `jre/bin/java.exe -jar STM32CubeMX.exe -q <script>`,命令行会被转发给那个 GUI 进程 ——
6
+ * `-q`(无界面)失效,脚本在 GUI 里跑,于是弹出 "Warning: Load Project … would you like to save the project ?"
7
+ * 这类**模态框**:没人点它,生成就一直挂着(一次 3–4 分钟的活变成无限等)。
8
+ *
9
+ * 插件这边能做的不是"替你点按钮"(SWT 原生窗口,UIA/SendKeys 都不稳),而是**先发现、先拒绝**,
10
+ * 让人把 GUI 关掉再重跑 —— 报错比卡死便宜。
11
+ */
12
+ import { runCapture } from "./subprocess-runner.js";
13
+ import { parseTasklistCsv } from "./doctor.js";
14
+ /**
15
+ * 当前正在运行的 CubeMX GUI 进程(只认 STM32CubeMX.exe;无头调用自己跑的是 jre/bin/java.exe,不算)。
16
+ * 拿不到进程列表(非 Windows / tasklist 不可用)时返回空数组:不因为探测失败就拦住用户。
17
+ */
18
+ export async function findRunningCubeMxGui(subprocess, signal) {
19
+ let outcome;
20
+ try {
21
+ outcome = await runCapture(subprocess, {
22
+ argv: ["tasklist", "/NH", "/FO", "CSV"],
23
+ timeoutMs: 10_000,
24
+ maxBytes: 512 * 1024,
25
+ ...(signal === undefined ? {} : { signal }),
26
+ });
27
+ }
28
+ catch {
29
+ return [];
30
+ }
31
+ if (outcome.spawnError !== null || outcome.exitCode !== 0)
32
+ return [];
33
+ return parseTasklistCsv(outcome.stdout + "\n" + outcome.stderr, ["STM32CubeMX.exe"]).map((process) => ({
34
+ name: process.name,
35
+ pid: process.pid,
36
+ }));
37
+ }
38
+ /** 检测到 GUI 时给用户的一句话(直接进 errors/message)。 */
39
+ export function describeCubeMxGuiConflict(processes) {
40
+ const list = processes.map((process) => process.name + "#" + String(process.pid)).join("、");
41
+ return ("检测到 STM32CubeMX 图形界面正在运行(" + list + "):CubeMX 是单实例,命令行会被转发给它," +
42
+ "无头模式(-q)失效并可能弹出\"是否保存工程\"这类模态框,生成会一直等下去。" +
43
+ "请先关掉 CubeMX 窗口(或保存后退出),再重跑;不想关也可以先用 CubeMX 自己 Generate Code,再回来跑 stm32_build");
44
+ }
@@ -0,0 +1,137 @@
1
+ /**
2
+ * L1:STM32CubeProgrammer CLI 烧录后端(openocd 之外的第二条腿)。
3
+ *
4
+ * 为什么需要它(2026-11-08 真机教训):openocd 0.12 没有 C0/U0 等族的 target 脚本,
5
+ * 插件内置适配版也只覆盖到「flash 驱动能借用」的程度;C0 那次靠会话外手敲
6
+ * STM32_Programmer_CLI 才烧进去——这条能力必须在插件里,而不是在用户的肌肉记忆里。
7
+ *
8
+ * 探针支持面(-h 实测 + 本机 -l 实测):CLI 的 SWD 路径只认 **ST-LINK**
9
+ * (port=SWD 的参数全是 ST-LINK 系;DAPLink/CMSIS-DAP 不走这条)。
10
+ * 所以它是「插着 ST-LINK 时的第二后端」,不是万能替补,报告里要如实说。
11
+ *
12
+ * 判据短语全部来自对本机 v2.19.0 的 STM32_Programmer_CLI.exe / CubeProgrammer_API.dll
13
+ * 内嵌消息表的实测提取(UTF-16 串扫描),不是文档转述:
14
+ * 下载成功 Data downloaded successfully / Sector[%d] downloaded successfully
15
+ * 校验成功 Download verified successfully
16
+ * 校验失败 Download verification failed
17
+ * 没插探针 No ST-Link detected!
18
+ *
19
+ * 退出码不参与成败判定:CLI 失败时也常退 0,只认输出行(与 openocd 同哲学,docs/A25)。
20
+ */
21
+ import { basename } from "node:path";
22
+ import { runStreaming } from "./subprocess-runner.js";
23
+ import { describeSearchScope, resolveSearchConfig, looksLikeCubePrgBin } from "../data/search-roots.js";
24
+ import { existsSync } from "node:fs";
25
+ export function parseCubeProgrammerLog(text) {
26
+ const downloaded = /Data downloaded successfully|Sector[d+] downloaded successfully/iu.test(text);
27
+ const verified = /Download verified successfully/iu.test(text);
28
+ const verifyFailed = /Download verification failed/iu.test(text);
29
+ const errors = [];
30
+ const seen = new Set();
31
+ for (const raw of text.split(/\r?\n/u)) {
32
+ const line = raw.trim();
33
+ if (line === "")
34
+ continue;
35
+ const isError = /^Error[: ]/iu.test(line) ||
36
+ /No ST-Link detected/iu.test(line) ||
37
+ /Unable to connect/iu.test(line) ||
38
+ verifyFailedTest(line);
39
+ if (!isError)
40
+ continue;
41
+ if (seen.has(line))
42
+ continue;
43
+ seen.add(line);
44
+ errors.push(line);
45
+ }
46
+ return { downloaded, verified, verifyFailed, errors };
47
+ }
48
+ function verifyFailedTest(line) {
49
+ return /Download verification failed/iu.test(line);
50
+ }
51
+ /** 拼 CLI 参数(可单测):连接 SWD → 下载 elf → 校验 → 复位。 */
52
+ export function buildCubeProgrammerArgs(elfPath, o = {}) {
53
+ const freq = o.adapterSpeed === undefined ? "" : " freq=" + String(Math.trunc(o.adapterSpeed));
54
+ const args = ["-c", "port=SWD" + freq, "-d", elfPath, "-v"];
55
+ if (o.runAfterReset !== false)
56
+ args.push("-rst");
57
+ return args;
58
+ }
59
+ /** 找本机 CubeProgrammer CLI:显式路径 → 搜索根 → 注册表没有就认 PATH 裸命令。 */
60
+ export function findCubeProgrammerCli(binDirs, explicit) {
61
+ if (explicit !== undefined && explicit !== "") {
62
+ const hit = [explicit, explicit + ".exe"].find((p) => existsSync(p));
63
+ return hit ?? null;
64
+ }
65
+ for (const dir of binDirs) {
66
+ const p = dir + "/STM32_Programmer_CLI.exe";
67
+ if (existsSync(p))
68
+ return p;
69
+ if (looksLikeCubePrgBin(dir))
70
+ return dir + "/STM32_Programmer_CLI.exe";
71
+ }
72
+ return null;
73
+ }
74
+ export async function runCubeProgrammerFlash(subprocess, request) {
75
+ const startedAt = Date.now();
76
+ const config = resolveSearchConfig(process.env, request.binDirs === undefined ? {} : { binDirs: request.binDirs });
77
+ const cli = findCubeProgrammerCli(config.cubePrgBins, request.cliPath);
78
+ const empty = (errors, message) => ({
79
+ ok: false, command: "", args: [], exitCode: null, programmed: false, verified: false,
80
+ errors, logTail: "", durationMs: Date.now() - startedAt, message,
81
+ searched: describeSearchScope(config.cubePrgBins, "STM32_CUBE_PRG_ROOT"),
82
+ });
83
+ if (cli === null) {
84
+ return empty(["没找到 STM32_Programmer_CLI.exe"], "烧不了:本机找不到 STM32CubeProgrammer 的 CLI(查过 " + describeSearchScope(config.cubePrgBins, "STM32_CUBE_PRG_ROOT") + ")。" +
85
+ "装上它就有了不依赖 openocd target 脚本的第二条后端(H5/WBA/WB0/WL3 只能走它):" +
86
+ "https://www.st.com/en/development-tools/stm32cubeprog.html(默认安装路径会被自动发现;已装在别处就设 STM32_CUBE_PRG_ROOT 指到安装根或 bin)");
87
+ }
88
+ const args = [cli, ...buildCubeProgrammerArgs(request.elfPath, {
89
+ ...(request.adapterSpeed === undefined ? {} : { adapterSpeed: request.adapterSpeed }),
90
+ runAfterReset: request.runAfterReset !== false,
91
+ })];
92
+ let out = "";
93
+ const outcome = await runStreaming(subprocess, {
94
+ argv: args,
95
+ cwd: request.projectDir,
96
+ timeoutMs: request.timeoutMs ?? 120_000,
97
+ ...(request.signal === undefined ? {} : { signal: request.signal }),
98
+ onOutput: (_stream, text) => {
99
+ out += text;
100
+ for (const line of text.split(/\r?\n/u)) {
101
+ if (line.trim() !== "")
102
+ request.onProgress?.(line.trim());
103
+ }
104
+ },
105
+ });
106
+ // 判定用 runStreaming 收全的 stdout+stderr;onOutput 增量只用于实时转发进度。
107
+ const log = out.length > outcome.stdout.length + outcome.stderr.length ? out : outcome.stdout + "\n" + outcome.stderr;
108
+ const verdict = parseCubeProgrammerLog(log);
109
+ const errors = [...verdict.errors];
110
+ if (outcome.spawnError !== null)
111
+ errors.push("CLI 启动失败:" + outcome.spawnError);
112
+ if (outcome.timedOut)
113
+ errors.push("超时(" + String(request.timeoutMs ?? 120_000) + " ms):CLI 没跑完");
114
+ // 成功 = 下载行 + 校验行都在、没有失败行;退出码不参与(CLI 失败也常退 0)。
115
+ const ok = errors.length === 0 && verdict.downloaded && verdict.verified;
116
+ const message = ok
117
+ ? "烧录成功(CubeProgrammer," + ((Date.now() - startedAt) / 1000).toFixed(1) + " s,已校验)"
118
+ : "烧录失败(CubeProgrammer):" + (errors[0] ?? (verdict.downloaded ? "校验行没出现" : "下载行没出现"));
119
+ const exitValue = typeof outcome.exitCode === "number" ? outcome.exitCode : null;
120
+ return {
121
+ ok,
122
+ command: args.map((a) => (a.includes(" ") ? '"' + a + '"' : a)).join(" "),
123
+ args: args.slice(1),
124
+ exitCode: exitValue,
125
+ programmed: verdict.downloaded,
126
+ verified: verdict.verified,
127
+ errors,
128
+ logTail: log.split(/\r?\n/u).slice(-25).join("\n"),
129
+ durationMs: Date.now() - startedAt,
130
+ message,
131
+ searched: describeSearchScope(config.cubePrgBins, "STM32_CUBE_PRG_ROOT"),
132
+ };
133
+ }
134
+ /** 报告卡片里给这行署名:烧的是哪条后端。 */
135
+ export function cubeProgrammerBackendNote(cliPath) {
136
+ return "烧录后端:STM32CubeProgrammer CLI(" + basename(cliPath) + ");注意它只认 ST-LINK,DAPLink/CMSIS-DAP 探针仍走 openocd。";
137
+ }