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,706 @@
1
+ /**
2
+ * L2:`.ioc` 的「CubeMX 到底怎么理解这份配置」诊断(oracle)。
3
+ *
4
+ * 为什么需要:CubeMX 遇到不认识的键**不报错,直接丢**。我们写对了 USART 却丢了 TIM/ADC 时,
5
+ * 生成日志里一个 ERROR 都没有,只能靠「生成完翻 main.c 看有没有 MX_xxx_Init」倒推。
6
+ *
7
+ * 这里利用 CubeMX 无头脚本的 `config save`:`config load` 之后把**它理解的工程**写回 .ioc。
8
+ * 走的是文本导入(与 `stm32_generate` 同一条路),因此 save 出来的东西就是「它理解的结果」:
9
+ * 哪些外设真的激活了(`Mcu.IPn`)、引脚信号被规范化成什么、有没有补 `SH.*` 共享信号块、
10
+ * 计划生成哪些 `MX_*_Init`(`ProjectManager.functionlistsort`)。
11
+ *
12
+ * 纪律:
13
+ * - **只对副本操作**。CubeMX 的 `config save` 会忽略给定路径、直接覆盖被 load 的那份文件,
14
+ * 所以这里把 .ioc 复制到 `.dsh-stm32/verify/<stamp>/` 再跑,绝不碰工程里的 .ioc。
15
+ * - 只读结论:不生成代码、不改工程、不写 cmake。
16
+ */
17
+ import { copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
18
+ import { basename, isAbsolute, join, resolve } from "node:path";
19
+ import { parseIocEntries } from "./ioc.js";
20
+ import { STATE_DIR, acquireLock, cubeMxLaunch } from "./generate.js";
21
+ import { runStreaming } from "./subprocess-runner.js";
22
+ import { describeCubeMxGuiConflict, findRunningCubeMxGui } from "./cube-mx-guard.js";
23
+ import { locateCubemxDb, readIpParameterNames, readMcuFacts } from "./cubemx-db.js";
24
+ import { readClockTreeDerivedNames } from "../data/clock-db.js";
25
+ import { DMA_PARAM_ORDER } from "./ioc-plan.js";
26
+ import { resolveSearchConfig } from "../data/search-roots.js";
27
+ import { auditIocKeys, matchIocKey, renderIocKey } from "../data/ioc-schema.js";
28
+ const KEY_SAMPLE_LIMIT = 60;
29
+ function peripheralsOf(entries) {
30
+ const count = Number.parseInt(entries.get("Mcu.IPNb") ?? "", 10);
31
+ const names = [];
32
+ if (Number.isFinite(count)) {
33
+ for (let index = 0; index < count; index += 1) {
34
+ const name = (entries.get("Mcu.IP" + String(index)) ?? "").trim();
35
+ if (name !== "")
36
+ names.push(name);
37
+ }
38
+ }
39
+ if (names.length > 0)
40
+ return names;
41
+ for (const [key, value] of entries) {
42
+ if (/^Mcu\.IP\d+$/u.test(key) && value.trim() !== "")
43
+ names.push(value.trim());
44
+ }
45
+ return names;
46
+ }
47
+ /** `3-MX_USART1_UART_Init-USART1-false-HAL-true` → MX_USART1_UART_Init。 */
48
+ export function plannedFunctionOf(entry) {
49
+ const parts = entry.trim().split("-");
50
+ for (const part of parts) {
51
+ if (part.startsWith("MX_"))
52
+ return part;
53
+ }
54
+ return "";
55
+ }
56
+ function pinSignals(entries) {
57
+ const result = new Map();
58
+ for (const [key, value] of entries) {
59
+ if (!key.endsWith(".Signal"))
60
+ continue;
61
+ const pin = key.slice(0, key.length - ".Signal".length);
62
+ if (pin.startsWith("SH."))
63
+ continue;
64
+ result.set(pin, value.trim());
65
+ }
66
+ return result;
67
+ }
68
+ /**
69
+ * RCC 的派生频率名(不带 `RCC.` 前缀):`SYSCLKFreq_VALUE`、`APB1Freq_Value`、`ADCFreqValue`、
70
+ * `VCOOutputFreq_Value`、`VcooutputI2S` 这些。
71
+ *
72
+ * 它们不是设定,是 CubeMX 按 PLL/分频**算出来的结果**(db 里只有 Comment/Min/Max,公式在 java 里,
73
+ * 我们不重算)。模板带的是上一版的旧值,改了 PLL 之后它必然重算一遍。
74
+ */
75
+ export function isDerivedClockName(name) {
76
+ // 注意别把 `SYSCLKFreq_VALUE` 放进来:它是「我们写进去的设定」(计划声明目标 SYSCLK),
77
+ // 被 CubeMX 改成别的值就是模型错了,必须报 valueChanged 而不是归到派生重算。
78
+ return /(?:Freq_Value|FreqValue|VcooutputI2S)$/u.test(name.trim());
79
+ }
80
+ /** 键 `RCC.APB1Freq_Value` 是不是派生频率键(只看 RCC 实例,别的实例同名的键不是一回事)。 */
81
+ export function isDerivedClockKey(key) {
82
+ const match = /^RCC\.([A-Za-z0-9_]+)$/u.exec(key);
83
+ return match === null ? false : isDerivedClockName(match[1]);
84
+ }
85
+ /**
86
+ * 两边的值是否只差「CSV 成员顺序 / 空白」——CubeMX 维护自己的名单顺序(如 GPIOParameters、
87
+ * functionlistsort)时会这样改,语义不变,不该算我们写错。
88
+ */
89
+ export function isIocValueNormalized(before, after) {
90
+ if (before === after)
91
+ return true;
92
+ if (before.replace(/\s+/gu, " ").trim() === after.replace(/\s+/gu, " ").trim())
93
+ return true;
94
+ const split = (text) => text.split(",").map((item) => item.trim()).filter((item) => item !== "");
95
+ const left = split(before);
96
+ const right = split(after);
97
+ if (left.length < 2 || left.length !== right.length)
98
+ return false;
99
+ const sortedLeft = [...left].sort();
100
+ const sortedRight = [...right].sort();
101
+ return sortedLeft.every((item, index) => item === sortedRight[index]);
102
+ }
103
+ /**
104
+ * 两边都有、但相对顺序变了的键(不在最长保序子序列里的那些)。
105
+ *
106
+ * 为什么需要:.ioc 的行序对 CubeMX 是有语义的(Mcu.PinN 决定引脚表顺序,IPParameters 是插入序),
107
+ * 所以「零 diff」必须同时是「零 reorder」;只比键集合会把这个盲区放过。
108
+ */
109
+ export function misorderedKeysOf(before, after) {
110
+ const commonSet = new Set();
111
+ const common = [];
112
+ for (const key of before.keys()) {
113
+ if (!after.has(key))
114
+ continue;
115
+ commonSet.add(key);
116
+ common.push(key);
117
+ }
118
+ if (common.length < 2)
119
+ return [];
120
+ const rank = new Map();
121
+ let position = 0;
122
+ for (const key of after.keys()) {
123
+ if (!commonSet.has(key))
124
+ continue;
125
+ rank.set(key, position);
126
+ position += 1;
127
+ }
128
+ const sequence = common.map((key) => rank.get(key) ?? 0);
129
+ if (sequence.length > 1500) {
130
+ // 超大文件不走 O(n^2):只报「位置变小」的键,够定位问题。
131
+ return common.filter((_key, index) => sequence[index] !== index).slice(0, KEY_SAMPLE_LIMIT);
132
+ }
133
+ const best = new Array(sequence.length).fill(1);
134
+ const prev = new Array(sequence.length).fill(-1);
135
+ for (let i = 0; i < sequence.length; i += 1) {
136
+ for (let j = 0; j < i; j += 1) {
137
+ if (sequence[j] < sequence[i] && best[j] + 1 > best[i]) {
138
+ best[i] = best[j] + 1;
139
+ prev[i] = j;
140
+ }
141
+ }
142
+ }
143
+ let end = 0;
144
+ for (let i = 1; i < sequence.length; i += 1) {
145
+ if (best[i] > best[end])
146
+ end = i;
147
+ }
148
+ const keep = new Set();
149
+ for (let cursor = end; cursor >= 0; cursor = prev[cursor]) {
150
+ keep.add(cursor);
151
+ if (prev[cursor] < 0)
152
+ break;
153
+ }
154
+ return common.filter((_key, index) => !keep.has(index));
155
+ }
156
+ function listedPins(entries) {
157
+ const listed = new Set();
158
+ const count = Number.parseInt(entries.get("Mcu.PinsNb") ?? "", 10);
159
+ if (Number.isFinite(count)) {
160
+ for (let index = 0; index < count; index += 1) {
161
+ const pin = (entries.get("Mcu.Pin" + String(index)) ?? "").trim();
162
+ if (pin !== "")
163
+ listed.add(pin);
164
+ }
165
+ }
166
+ if (listed.size === 0) {
167
+ for (const [key, value] of entries) {
168
+ if (/^Mcu\.Pin\d+$/u.test(key) && value.trim() !== "")
169
+ listed.add(value.trim());
170
+ }
171
+ }
172
+ return listed;
173
+ }
174
+ function sharedSignalBlocks(entries) {
175
+ const keys = new Map();
176
+ for (const [key, value] of entries) {
177
+ const match = /^SH\.(.+)\.(\d+|ConfNb)$/u.exec(key);
178
+ if (match === null)
179
+ continue;
180
+ const name = match[1];
181
+ const list = keys.get(name) ?? [];
182
+ list.push(key.slice("SH.".length + name.length + 1) + "=" + value);
183
+ keys.set(name, list);
184
+ }
185
+ return [...keys.entries()].map(([key, items]) => ({ key, entries: items.sort() }));
186
+ }
187
+ /** 这个外设在 before 文本里有没有引脚指向(普通信号 / S_ 定时器信号 / ADCx 共享信号)。 */
188
+ function pinsPointingAt(before, device) {
189
+ const pins = [];
190
+ for (const [pin, signal] of pinSignals(before)) {
191
+ if (signal.startsWith(device + "_")) {
192
+ pins.push(pin);
193
+ continue;
194
+ }
195
+ const stripped = signal.startsWith("S_") ? signal.slice(2) : signal;
196
+ if (stripped.startsWith(device + "_")) {
197
+ pins.push(pin);
198
+ continue;
199
+ }
200
+ const sharedCount = Number.parseInt(before.get("SH." + signal + ".ConfNb") ?? "", 10);
201
+ if (Number.isFinite(sharedCount) && sharedCount > 0) {
202
+ for (let index = 0; index < sharedCount; index += 1) {
203
+ const target = (before.get("SH." + signal + "." + String(index)) ?? "").split(",")[0]?.trim() ?? "";
204
+ if (target.startsWith(device + "_")) {
205
+ pins.push(pin);
206
+ break;
207
+ }
208
+ }
209
+ }
210
+ }
211
+ return pins;
212
+ }
213
+ /**
214
+ * 把被丢/被补的键逐条过一遍真值表审计(auditIocKeys),得出「CubeMX 为什么不认它」。
215
+ *
216
+ * 没有 db 上下文时返回 verdict 空串的条目:与其猜一个原因,不如明说没判。
217
+ */
218
+ function explainKeys(keys, context, beforeIps) {
219
+ const sample = keys.slice(0, KEY_SAMPLE_LIMIT);
220
+ if (sample.length === 0)
221
+ return [];
222
+ if (context === null) {
223
+ return sample.map((key) => ({
224
+ key,
225
+ verdict: "",
226
+ detail: "这次没有 db 上下文(本机 CubeMX db 不可用),只报键名、不判成因",
227
+ }));
228
+ }
229
+ const beforeSet = new Set(beforeIps.map((name) => name.toUpperCase()));
230
+ return auditIocKeys(sample, context).map((finding) => {
231
+ let detail = finding.detail;
232
+ if (finding.verdict === "ok") {
233
+ // 「形状已登记、上下文也过」但键还是被丢了——必须说清这是「真机才知道」,
234
+ // 不能让它看起来像「我们写对了、CubeMX 无理丢弃」。典型例子:RCC.<member> 的派生名
235
+ // 由 CubeMX 自己按时钟树算(语料 847 个不同成员,跨族没法列白名单),写它基本不生效。
236
+ detail =
237
+ "键名形状已登记(" + finding.specId + ")、上下文也没有明显问题,但它仍然被丢了:" +
238
+ "这类键的生效条件只能靠真机实验确认(例如 RCC.<成员> 的派生名由 CubeMX 自己算)";
239
+ }
240
+ const ip = (matchIocKey(finding.key)?.params.ip ?? "").trim();
241
+ if (finding.verdict === "inactive-instance" && ip !== "" && beforeSet.has(ip.toUpperCase())) {
242
+ detail +=
243
+ "(before 文本的 Mcu.IP<i> 里本来有它,是 CubeMX 回写时把整个外设删了:指出的引脚/模式不完整,见 hints)";
244
+ }
245
+ return { key: finding.key, verdict: finding.verdict, detail };
246
+ });
247
+ }
248
+ /** 纯函数:把「我们写的」与「CubeMX 理解的」两份 .ioc 文本对比成诊断。 */
249
+ export function diffIocForVerify(beforeText, afterText, audit,
250
+ /** 计划里写过的键(来自 <projectDir>/.dsh-stm32/plans/*.json)。null/缺省 = 不知道,按形状归类。 */
251
+ planned,
252
+ /** 时钟树里由 CubeMX 自己算的频率槽(db/plugins/clock/<ClockTree>.xml 的 refParameter);null = 不知道。 */
253
+ clockTreeDerived) {
254
+ const plannedKeys = planned ?? null;
255
+ const isDerived = (key) => {
256
+ if (isDerivedClockKey(key))
257
+ return true;
258
+ if (clockTreeDerived === null || clockTreeDerived === undefined)
259
+ return false;
260
+ const name = /^RCC\.([A-Za-z0-9_]+)$/u.exec(key);
261
+ return name !== null && clockTreeDerived.has(name[1]);
262
+ };
263
+ const before = parseIocEntries(beforeText);
264
+ const after = parseIocEntries(afterText);
265
+ const beforeIps = peripheralsOf(before);
266
+ const afterIps = peripheralsOf(after);
267
+ const dropped = beforeIps.filter((name) => !afterIps.includes(name));
268
+ const added = afterIps.filter((name) => !beforeIps.includes(name));
269
+ const rawList = (after.get("ProjectManager.functionlistsort") ?? "")
270
+ .split(",")
271
+ .map((item) => item.trim())
272
+ .filter((item) => item !== "");
273
+ const plannedRaw = rawList.length > 0 ? rawList : (before.get("ProjectManager.functionlistsort") ?? "")
274
+ .split(",")
275
+ .map((item) => item.trim())
276
+ .filter((item) => item !== "");
277
+ const plannedFunctions = plannedRaw.map(plannedFunctionOf).filter((name) => name !== "");
278
+ const beforePins = pinSignals(before);
279
+ const afterPins = pinSignals(after);
280
+ const signalRewrites = [];
281
+ for (const [pin, signal] of beforePins) {
282
+ const next = afterPins.get(pin);
283
+ if (next !== undefined && next !== signal)
284
+ signalRewrites.push({ pin, before: signal, after: next });
285
+ }
286
+ const listed = listedPins(before);
287
+ const removedKeys = [...before.keys()].filter((key) => !after.has(key)).sort();
288
+ const addedKeys = [...after.keys()].filter((key) => !before.has(key)).sort();
289
+ // 只比键存在性会漏掉「值被 CubeMX 规范化/重算」:键还在、值变了——这类差异最容易被误读成零 diff。
290
+ const changedValues = [];
291
+ for (const [key, value] of before) {
292
+ const next = after.get(key);
293
+ if (next !== undefined && next !== value)
294
+ changedValues.push({ key, before: value, after: next });
295
+ }
296
+ changedValues.sort((left, right) => (left.key < right.key ? -1 : left.key > right.key ? 1 : 0));
297
+ // Mcu.IP<i> 槽位重排:两边外设集合完全相同 → 只是「第 i 个槽位放谁」变了,语义无害。
298
+ // 逐键比值会把这种重排报成「几乎所有槽位都变了」,从集合看却一个外设都没变;
299
+ // 单独成桶(ipOrderOnly)后再算 benign 才不会假阳性。
300
+ const sameIpSet = beforeIps.length === afterIps.length &&
301
+ [...beforeIps].sort().join(",") === [...afterIps].sort().join(",");
302
+ const ipOrderOnly = [];
303
+ if (sameIpSet) {
304
+ for (let index = changedValues.length - 1; index >= 0; index -= 1) {
305
+ const item = changedValues[index];
306
+ if (matchIocKey(item.key)?.spec.id !== "mcu.ip_index")
307
+ continue;
308
+ ipOrderOnly.unshift(item.key);
309
+ changedValues.splice(index, 1);
310
+ }
311
+ }
312
+ // functionlistsort 的「纯追加 MX_*_Init」不算差异:那是 CubeMX 保存时自己维护的一列。
313
+ // 只有「只追加、不删条目、不改已有条目的值」才这么处理;删条目/改值仍然留在 changedValues 里。
314
+ const autoAddedFunctions = [];
315
+ const listSortIndex = changedValues.findIndex((item) => item.key === "ProjectManager.functionlistsort");
316
+ if (listSortIndex >= 0) {
317
+ const change = changedValues[listSortIndex];
318
+ const beforeItems = change.before.split(",").map((item) => item.trim()).filter((item) => item !== "");
319
+ const afterItems = change.after.split(",").map((item) => item.trim()).filter((item) => item !== "");
320
+ const appended = afterItems.slice(beforeItems.length);
321
+ const keptPrefix = afterItems.slice(0, beforeItems.length);
322
+ const onlyAppended = keptPrefix.length === beforeItems.length &&
323
+ keptPrefix.every((item, index) => item === beforeItems[index]) &&
324
+ appended.length > 0 &&
325
+ // 外设名里会出现 '+'(U0 的 CORTEX_M0+ 生成 MX_CORTEX_M0+_Init),别把它当成非法条目。
326
+ appended.every((item) => /^[0-9]+-MX_[A-Za-z0-9_+]+_Init-[^,]*$/u.test(item));
327
+ if (onlyAppended) {
328
+ autoAddedFunctions.push(...appended);
329
+ changedValues.splice(listSortIndex, 1);
330
+ }
331
+ }
332
+ // RCC.IPParameters 只被 CubeMX **追加**派生频率名时不算差异:这一列是「这台 MCU 有哪些 RCC 参数」
333
+ // 的登记表,我们写的是它的子集,它保存时把重算出来的频率名一并登记进去。
334
+ // 判据:我们的名字**一个不少**(after ⊇ before),多出来的必须全是派生频率名,只多不少。
335
+ // 顺序不参与判定——这一列是集合,CubeMX 按 ASCII 升序写,我们跟着排;
336
+ // 删名/改名/插进非派生名仍然留在 changedValues 里。
337
+ const ipParametersAdded = [];
338
+ const ipParametersIndex = changedValues.findIndex((item) => item.key === "RCC.IPParameters");
339
+ if (ipParametersIndex >= 0) {
340
+ const change = changedValues[ipParametersIndex];
341
+ const splitNames = (text) => text.split(",").map((name) => name.trim()).filter((name) => name !== "");
342
+ const beforeNames = splitNames(change.before);
343
+ const afterNames = splitNames(change.after);
344
+ const afterSet = new Set(afterNames);
345
+ const keptAll = beforeNames.every((name) => afterSet.has(name));
346
+ const beforeSet = new Set(beforeNames);
347
+ const extras = afterNames.filter((name) => !beforeSet.has(name));
348
+ if (keptAll && afterNames.length > beforeNames.length && extras.every((name) => isDerivedClockName(name) || (clockTreeDerived?.has(name) ?? false))) {
349
+ ipParametersAdded.push(...extras);
350
+ changedValues.splice(ipParametersIndex, 1);
351
+ }
352
+ }
353
+ // 审计上下文:instances 用 after 的 Mcu.IPn —— CubeMX 最终认的外设表,才是「这个参数键有没有接收方」的答案。
354
+ const auditContext = audit === undefined || audit === null ? null : { ...audit, instances: afterIps };
355
+ // 归因:键序变化 + 值规范化,各自单独成桶(见 IocVerifyAttribution 的三条动机)。
356
+ const misordered = misorderedKeysOf(before, after);
357
+ const valueNormalized = [];
358
+ const valueChanged = [];
359
+ const derivedRecomputed = [];
360
+ for (const item of changedValues) {
361
+ // 派生频率键被 CubeMX 重算:计划里没写过它 → 这是它按树算出来的结果,不是我们写错;
362
+ // 计划里写过它 → 两边对不上,那是我们算错了,得留在 valueChanged 里让人看见。
363
+ if (isDerived(item.key) && !(plannedKeys?.has(item.key) ?? false)) {
364
+ derivedRecomputed.push(item);
365
+ continue;
366
+ }
367
+ const bucket = isIocValueNormalized(item.before, item.after) ? valueNormalized : valueChanged;
368
+ bucket.push(item);
369
+ }
370
+ // CubeMX 自己补出来的派生键(我们不写、它按树算)。计划里写过的仍算缺键。
371
+ const derivedAdded = addedKeys.filter((key) => isDerived(key) && !(plannedKeys?.has(key) ?? false));
372
+ const keptAddedKeys = addedKeys.filter((key) => !derivedAdded.includes(key));
373
+ const attribution = {
374
+ // IP 槽位重排已经从 valueChanged 里摘走,这里也不重复报成「行序变化」(两者都是无害桶,别重复计数)。
375
+ orderOnly: misordered.filter((key) => !ipOrderOnly.includes(key)).slice(0, KEY_SAMPLE_LIMIT),
376
+ valueNormalized: valueNormalized.slice(0, KEY_SAMPLE_LIMIT),
377
+ valueChanged: valueChanged.slice(0, KEY_SAMPLE_LIMIT),
378
+ missingKeys: removedKeys.slice(0, KEY_SAMPLE_LIMIT),
379
+ addedKeys: keptAddedKeys.slice(0, KEY_SAMPLE_LIMIT),
380
+ droppedPeripherals: dropped,
381
+ autoAddedFunctions,
382
+ droppedReasons: explainKeys(removedKeys, auditContext, beforeIps),
383
+ addedVerdicts: explainKeys(keptAddedKeys, auditContext, beforeIps),
384
+ ipOrderOnly: ipOrderOnly.slice(0, KEY_SAMPLE_LIMIT),
385
+ derivedRecomputed: derivedRecomputed.slice(0, KEY_SAMPLE_LIMIT),
386
+ derivedAdded,
387
+ ipParametersAdded,
388
+ benign: dropped.length === 0 &&
389
+ removedKeys.length === 0 &&
390
+ keptAddedKeys.length === 0 &&
391
+ valueChanged.length === 0 &&
392
+ signalRewrites.length === 0,
393
+ };
394
+ const hints = [];
395
+ // 实测(6.15.0):中断所属外设没在 Mcu.IPn 里时,NVIC.<IP>_IRQn 会被静默删掉——
396
+ // 用户看到的现象是「开了中断但生成代码里没有」,这里把因果说清楚。
397
+ for (const key of removedKeys) {
398
+ const vector = /^NVIC\.([A-Za-z0-9_]+?)_IRQn$/u.exec(key);
399
+ if (vector === null)
400
+ continue;
401
+ const ip = vector[1] ?? "";
402
+ if (ip === "" || ip.startsWith("EXTI"))
403
+ continue;
404
+ if (peripheralsOf(after).includes(ip))
405
+ continue;
406
+ hints.push(key + " 被 CubeMX 删掉了:" + ip + " 不在它认的外设表里(Mcu.IPn)——" +
407
+ "先启用外设(peripherals)再开它的中断,否则中断键会被静默丢弃");
408
+ }
409
+ for (const device of dropped) {
410
+ const pins = pinsPointingAt(before, device);
411
+ if (pins.length === 0) {
412
+ hints.push(device + " 没有引脚指向它:补 <pin>.Signal=" + device + "_…(普通外设)——" +
413
+ "CubeMX 只从引脚推导外设,光写 " + device + ".IPParameters 不够");
414
+ continue;
415
+ }
416
+ const unlisted = pins.filter((pin) => !listed.has(pin));
417
+ const noFunction = pins.filter((pin) => {
418
+ const signal = before.get(pin + ".Signal") ?? "";
419
+ if ((before.get(pin + ".Mode") ?? "").trim() !== "")
420
+ return false;
421
+ return (before.get("SH." + signal + ".ConfNb") ?? "") === "";
422
+ });
423
+ if (unlisted.length > 0) {
424
+ hints.push(device + " 的引脚 " + unlisted.join("、") + " 没列进 Mcu.PinN:CubeMX 只应用引脚表里的脚(补 Mcu.PinN 与 PinsNb)");
425
+ }
426
+ if (noFunction.length > 0) {
427
+ hints.push(device + " 的引脚 " + noFunction.join("、") + " 缺功能表达:普通外设写 <pin>.Mode(如 USART 的 Asynchronous);" +
428
+ "定时器/ADC 写共享信号块 SH.<pin信号>.0=<IP 信号>,<IP 模式> 并把 SH.<pin信号>.ConfNb 设成条数" +
429
+ "(引脚本身不要写 .Mode)");
430
+ }
431
+ if (unlisted.length === 0 && noFunction.length === 0) {
432
+ hints.push(device + " 的引脚写法看起来是对的却仍被丢:对照本次 after 文本里该外设的键,多半还差 <" + device + ">.IPParameters 的某个模式项");
433
+ }
434
+ }
435
+ return {
436
+ afterPeripherals: afterIps,
437
+ droppedPeripherals: dropped,
438
+ addedPeripherals: added,
439
+ plannedFunctions,
440
+ plannedFunctionsRaw: plannedRaw,
441
+ signalRewrites,
442
+ sharedSignals: sharedSignalBlocks(after),
443
+ removedKeys: removedKeys.slice(0, KEY_SAMPLE_LIMIT),
444
+ addedKeys: addedKeys.slice(0, KEY_SAMPLE_LIMIT),
445
+ changedValues: changedValues.slice(0, KEY_SAMPLE_LIMIT),
446
+ misorderedKeys: misordered.slice(0, KEY_SAMPLE_LIMIT),
447
+ attribution,
448
+ autoAddedFunctions,
449
+ hints,
450
+ };
451
+ }
452
+ /**
453
+ * 读最近一次 ioc 计划写过的键(planIocChanges 落的 <projectDir>/.dsh-stm32/plans/<id>.json)。
454
+ *
455
+ * 用途:区分「派生频率键是 CubeMX 自己重算的」和「我们算错了」。读不到就返回 null(按形状归类),
456
+ * 而不是让诊断失败——独立跑 verify 时本来就没有计划。
457
+ */
458
+ function readPlannedKeys(projectDir) {
459
+ const dir = join(projectDir, STATE_DIR, "plans");
460
+ let newest = null;
461
+ for (const name of readdirSafe(dir)) {
462
+ if (!name.toLowerCase().endsWith(".json"))
463
+ continue;
464
+ const id = name.slice(0, name.length - ".json".length);
465
+ let at = "";
466
+ try {
467
+ const parsed = JSON.parse(readFileSync(join(dir, name), "utf8"));
468
+ at = typeof parsed.createdAt === "string" ? parsed.createdAt : "";
469
+ }
470
+ catch {
471
+ at = "";
472
+ }
473
+ if (newest === null || at >= newest.at)
474
+ newest = { id, at };
475
+ }
476
+ if (newest === null)
477
+ return null;
478
+ try {
479
+ const parsed = JSON.parse(readFileSync(join(dir, newest.id + ".json"), "utf8"));
480
+ const keys = (parsed.changes ?? [])
481
+ .map((item) => (typeof item.key === "string" ? item.key : ""))
482
+ .filter((key) => key !== "");
483
+ return keys.length === 0 ? null : new Set(keys);
484
+ }
485
+ catch {
486
+ return null;
487
+ }
488
+ }
489
+ function findIoc(projectDir) {
490
+ const dir = projectDir;
491
+ const names = [];
492
+ for (const name of readdirSafe(dir)) {
493
+ if (name.toLowerCase().endsWith(".ioc"))
494
+ names.push(name);
495
+ }
496
+ if (names.length === 1)
497
+ return join(dir, names[0]);
498
+ return null;
499
+ }
500
+ function readdirSafe(dir) {
501
+ try {
502
+ return readdirSync(dir);
503
+ }
504
+ catch {
505
+ return [];
506
+ }
507
+ }
508
+ /**
509
+ * 给归因准备键名上下文:从 before 文本读 Mcu.Name,去本机 db 拿引脚表 / IP 实例表 / 参数清单。
510
+ *
511
+ * 拿不到 db 时就返回 audit=null(只报键名、不判成因),而不是让整次诊断失败:
512
+ * 「CubeMX 不认这个键」这个结论不依赖 db,只有「为什么不认」依赖它。
513
+ */
514
+ function buildAuditInput(beforeText, roots) {
515
+ const entries = parseIocEntries(beforeText);
516
+ const mcuName = (entries.get(renderIocKey("mcu.name")) ?? "").trim();
517
+ const db = locateCubemxDb([...roots]);
518
+ if (db === null) {
519
+ return {
520
+ audit: null,
521
+ note: "本机没找到可用的 CubeMX db:被丢/被补的键只报键名,不判成因(参数名与引脚名无从校验)。",
522
+ clockTreeDerived: null,
523
+ };
524
+ }
525
+ const facts = mcuName === "" ? null : readMcuFacts(db, mcuName);
526
+ if (facts === null) {
527
+ return {
528
+ audit: null,
529
+ note: "db(" + db.version + ")里没有 Mcu.Name=" + (mcuName === "" ? "(缺失)" : mcuName) +
530
+ " 这颗芯片的描述:被丢/被补的键只报键名,不判成因。",
531
+ clockTreeDerived: null,
532
+ };
533
+ }
534
+ return {
535
+ audit: {
536
+ pins: [...facts.pins.keys()],
537
+ dbInstances: [...facts.ips.keys()],
538
+ // 没有该实例的参数清单时返回 null:这条不校验,而不是「查不到就报错」。
539
+ paramNamesOf: (instance) => {
540
+ const names = readIpParameterNames(db, facts, instance);
541
+ return names.length === 0 ? null : names;
542
+ },
543
+ dmaParamNames: DMA_PARAM_ORDER,
544
+ },
545
+ note: "差异归因的上下文来自本机 CubeMX db(" + db.version + "," + facts.name + "):" +
546
+ "参数名按 RefParameter 清单、引脚名按 db 引脚表校验" +
547
+ (facts.clockTree === "" ? "" : ";时钟树 " + facts.clockTree + " 的 refParameter 当成 CubeMX 自算的频率槽"),
548
+ clockTreeDerived: new Set(readClockTreeDerivedNames(db, facts.clockTree)),
549
+ };
550
+ }
551
+ /**
552
+ * 跑一次「load + save」诊断。
553
+ *
554
+ * 耗时(实测 2026-11,DB.6.0.150,Windows):**98–120 s**,不是早期记的 25–40 s——这台机器上
555
+ * 光是 load 就要 ~98 s,而且保存完成之后进程有时还不退出(日志已有 `SaveConfig` 但 java 挂着)。
556
+ * 所以默认超时给 180 s(request.timeoutMs 可调),而判定「成功」只看日志里有没有
557
+ * `SaveConfig`/`Bye bye`,不看进程有没有正常退出——反之,没这一行就绝不能报通过。
558
+ */
559
+ export async function runIocVerify(subprocess, request) {
560
+ const projectDir = resolve(request.projectDir);
561
+ const iocPath = request.iocPath !== undefined && request.iocPath !== ""
562
+ ? (isAbsolute(request.iocPath) ? request.iocPath : resolve(projectDir, request.iocPath))
563
+ : findIoc(projectDir);
564
+ const base = {
565
+ ok: false, projectDir, iocPath: iocPath ?? "", snapshotPath: "", durationMs: 0,
566
+ diff: diffIocForVerify("", ""), notes: [], errors: [], message: "",
567
+ };
568
+ if (iocPath === null || !existsSync(iocPath)) {
569
+ return { ...base, errors: ["找不到 .ioc:工程根目录下必须有且只有一个 *.ioc,或用 iocPath 指定"], message: "没诊断:找不到 .ioc" };
570
+ }
571
+ const config = resolveSearchConfig(process.env, request.cubeMxRoots === undefined ? {} : { cubeMxRoots: request.cubeMxRoots });
572
+ const launch = cubeMxLaunch(config.cubeMxRoots);
573
+ if (launch === null) {
574
+ return {
575
+ ...base,
576
+ errors: ["找不到可无头调用的 STM32CubeMX(需要 <root>/jre/bin/java.exe 与 <root>/STM32CubeMX.exe);可用 STM32_CUBEMX_ROOT 指定"],
577
+ message: "没诊断:找不到 CubeMX",
578
+ };
579
+ }
580
+ const lock = acquireLock(projectDir, "ioc verify");
581
+ if ("error" in lock)
582
+ return { ...base, errors: [lock.error], message: "没诊断:CubeMX 正忙" };
583
+ // 与 generate 同一个理由:CubeMX 是单实例,GUI 开着时无头调用会被转发并弹模态框。
584
+ const guiProcesses = await findRunningCubeMxGui(subprocess);
585
+ if (guiProcesses.length > 0) {
586
+ const conflict = describeCubeMxGuiConflict(guiProcesses);
587
+ return { ...base, errors: [conflict], message: "没诊断:" + conflict };
588
+ }
589
+ const beforeText = readFileSync(iocPath, "utf8");
590
+ const stamp = new Date().toISOString().replace(/[-:T.]/gu, "").slice(0, 14);
591
+ const workDir = join(projectDir, STATE_DIR, "verify", stamp);
592
+ mkdirSync(workDir, { recursive: true });
593
+ const snapshotPath = join(workDir, basename(iocPath));
594
+ copyFileSync(iocPath, snapshotPath);
595
+ const scriptPath = join(workDir, "verify.txt");
596
+ writeFileSync(scriptPath, ["config load " + snapshotPath.replace(/\\/g, "/"), "config save " + snapshotPath.replace(/\\/g, "/"), "exit", ""].join("\n"), "utf8");
597
+ const startedAt = Date.now();
598
+ try {
599
+ const argv = [launch.java, "-Dfile.encoding=UTF-8", "-jar", launch.jar, "-q", scriptPath];
600
+ const outcome = await runStreaming(subprocess, {
601
+ argv,
602
+ cwd: projectDir,
603
+ timeoutMs: request.timeoutMs ?? 180_000,
604
+ maxBytes: 1024 * 1024,
605
+ });
606
+ const log = outcome.stdout + "\n" + outcome.stderr;
607
+ const afterText = readFileSync(snapshotPath, "utf8");
608
+ // 判定成功的唯一依据是日志里走到了保存:CubeMX 卡死/崩溃/超时时快照还是我们复制进去的原文,
609
+ // 逐键比出来的「零 diff」是假通过(实测 F2 写错 AHB 枚举名时就是这样,>240 s 不返回)。
610
+ const savedDone = /SaveConfig|Bye bye/iu.test(log);
611
+ const logTail = log.trim().split(/\r?\n/u).slice(-3).join(" | ");
612
+ if (!savedDone) {
613
+ const how = outcome.timedOut
614
+ ? "超时 " + String(request.timeoutMs ?? 180_000) + " ms 被中止"
615
+ : "退出码 " + (outcome.exitCode === null ? "(没有)" : String(outcome.exitCode));
616
+ return {
617
+ ...base,
618
+ snapshotPath,
619
+ durationMs: Date.now() - startedAt,
620
+ errors: ["CubeMX 没有保存完:" + how + ";日志末尾:" + logTail],
621
+ message: "诊断失败:CubeMX 没保存完(" + how + ")。日志里没有 SaveConfig/Bye bye," +
622
+ "快照还是原样的 .ioc —— 这时报「零 diff」是假通过,所以直接判失败",
623
+ };
624
+ }
625
+ const auditInfo = buildAuditInput(beforeText, config.cubeMxRoots);
626
+ const diff = diffIocForVerify(beforeText, afterText, auditInfo.audit, readPlannedKeys(projectDir), auditInfo.clockTreeDerived);
627
+ const notes = [
628
+ "CubeMX 写回的是「它理解的结果」,不是正确答案:被丢掉的外设不会自己补回来。",
629
+ "副本在 " + snapshotPath + "(工程里的 .ioc 没动过)。",
630
+ "判定口径:Mcu.IPn = 真正激活的外设;functionlistsort = 计划生成的 MX_*_Init。",
631
+ auditInfo.note,
632
+ ];
633
+ if (outcome.timedOut || outcome.exitCode !== 0) {
634
+ notes.push("CubeMX 已经保存完(日志里有 SaveConfig),但进程没有正常退出(" +
635
+ (outcome.timedOut ? "超时被中止" : "退出码 " + String(outcome.exitCode ?? "(没有)")) +
636
+ "):这台机器上次实测就这样,结论照常可用,只是得多花一次超时的时间。");
637
+ }
638
+ const derived = diff.attribution;
639
+ if (derived.derivedRecomputed.length > 0 || derived.derivedAdded.length > 0 || derived.ipParametersAdded.length > 0) {
640
+ notes.push("派生频率键(*Freq_Value/*FreqValue)是 CubeMX 按 PLL 与分频**算出来的**,不是我们写的设定:" +
641
+ "重算 " + String(derived.derivedRecomputed.length) + " 个、它自己补 " + String(derived.derivedAdded.length) +
642
+ " 个、RCC.IPParameters 里追加 " + String(derived.ipParametersAdded.length) +
643
+ " 个名字——都不算差异(计划里写过的派生键仍会报)。");
644
+ }
645
+ const dropped = diff.droppedPeripherals;
646
+ const valueSuffix = diff.attribution.valueChanged.length === 0
647
+ ? ""
648
+ : ";另有 " + String(diff.attribution.valueChanged.length) + " 个键的值真被改写(键还在,值不一样)";
649
+ const normalizedSuffix = diff.attribution.valueNormalized.length === 0
650
+ ? ""
651
+ : ";另有 " + String(diff.attribution.valueNormalized.length) + " 个键的值只是成员顺序被规范化(语义不变)";
652
+ const orderSuffix = diff.attribution.orderOnly.length === 0
653
+ ? ""
654
+ : ";另有 " + String(diff.attribution.orderOnly.length) + " 个键的值相同但行序不同(CubeMX 按自己的顺序重排)";
655
+ const causeSuffix = (() => {
656
+ const counts = new Map();
657
+ for (const reason of diff.attribution.droppedReasons) {
658
+ if (reason.verdict === "" || reason.verdict === "ok")
659
+ continue;
660
+ counts.set(reason.verdict, (counts.get(reason.verdict) ?? 0) + 1);
661
+ }
662
+ if (counts.size === 0)
663
+ return "";
664
+ const label = {
665
+ "inactive-instance": "外设没进 Mcu.IPn(参数没有接收方)",
666
+ "unknown-parameter": "参数名不在 db 的 RefParameter 清单里",
667
+ "pin-attribute": "把引脚属性写成了外设参数(没登记进 GPIOParameters)",
668
+ "unknown-namespace": "前缀既不认识也不是已启用实例",
669
+ unregistered: "键名形状没登记进真值表",
670
+ "unknown-dma-parameter": "DMA 参数名不在白名单里",
671
+ };
672
+ const parts = [...counts.entries()].map(([verdict, count]) => String(count) + " 个" + (label[verdict] ?? verdict));
673
+ return ";它丢掉的键里 " + parts.join("、") + "(attribution.droppedReasons 逐条给了原因)";
674
+ })();
675
+ const autoSuffix = diff.autoAddedFunctions.length === 0
676
+ ? ""
677
+ : ";它另外自己补了 " + String(diff.autoAddedFunctions.length) + " 条初始化清单(functionlistsort,不影响生成正确性)";
678
+ const derivedCount = derived.derivedRecomputed.length + derived.derivedAdded.length;
679
+ const derivedSuffix = derivedCount === 0
680
+ ? ""
681
+ : ";它按时钟树重算了 " + String(derivedCount) + " 个派生频率键(*Freq_Value,不是设定)";
682
+ const ipSuffix = derived.ipParametersAdded.length === 0
683
+ ? ""
684
+ : ";RCC.IPParameters 里它自己追加了 " + derived.ipParametersAdded.slice(0, 4).join("/") +
685
+ (derived.ipParametersAdded.length > 4 ? " 等 " + String(derived.ipParametersAdded.length) + " 个派生名" : "");
686
+ return {
687
+ ...base,
688
+ ok: true,
689
+ snapshotPath,
690
+ durationMs: Date.now() - startedAt,
691
+ diff,
692
+ notes,
693
+ message: (dropped.length === 0
694
+ ? "CubeMX 认了全部 " + String(diff.afterPeripherals.length) + " 个外设;计划生成 " + String(diff.plannedFunctions.length) + " 个初始化函数"
695
+ : "CubeMX 丢了 " + dropped.join("、") + "(其余 " + String(diff.afterPeripherals.length) + " 个认了)") +
696
+ valueSuffix + normalizedSuffix + orderSuffix + autoSuffix + derivedSuffix + ipSuffix + causeSuffix,
697
+ };
698
+ }
699
+ catch (error) {
700
+ const message = error instanceof Error ? error.message : String(error);
701
+ return { ...base, snapshotPath, errors: [message], message: "诊断失败:" + message };
702
+ }
703
+ finally {
704
+ lock.release();
705
+ }
706
+ }