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,698 @@
1
+ /**
2
+ * L2:.ioc 的「CubeMX 会怎么读它」离线规则检查。
3
+ *
4
+ * 规则来源不是猜的:把 D:/app/STM32CubeMX/STM32CubeMX.exe(其实是 227 MB 的 jar)解开,
5
+ * 反汇编 com.st.microxplorer.importproject 包得到的。证据链见 docs/development-notes.md 第 35 节:
6
+ * - ImportParameterContext 按 IP 名分发 ADC / DAC / RCC / DMA / NVIC;
7
+ * - ImportDMAParameter 读 Dma.RequestsNb(默认 0)、按冒号切子字段、认 MEMTOMEM;
8
+ * - ImportADCParameter 有 addRegularConversionRank(int, String) 与 setParamValueWithId(...);
9
+ * - NvicVector 的字段顺序:Enable、preemptionPriority、subPriority、configurablePriority、
10
+ * systemHandler、irqHandlerGenerated、enableCodeNeeded 等。
11
+ * 这些规则在这里离线执行:不启动 CubeMX 就能报出这份 .ioc 会不会被丢键或被覆盖。
12
+ */
13
+ import { readIpModeNames, resolveDbPinName } from "./cubemx-db.js";
14
+ import { extiVectorNameOf, familyProfileOf } from "../data/family.js";
15
+ const IP_KEY = /^Mcu[.]IP[0-9]+$/u;
16
+ const NVIC_KEY = /^NVIC[.](.+_IRQn)$/u;
17
+ const DMA_KEY = /^Dma[.]([A-Za-z0-9_]+)[.]([0-9]+)[.]/u;
18
+ const ADC_RANK_KEY = /^(ADC[0-9]*)[.](Rank|Channel|SamplingTime)-([0-9]+)#/u;
19
+ /**
20
+ * R7:<IP>.IPParameters 是「这个 IP 有哪些参数」的白名单。
21
+ * 只写 <IP>.Prescaler=71 而不把它列进 IPParameters,CubeMX 会当没写(实测 TIM2 的 Prescaler/Period 就这么丢的)。
22
+ */
23
+ function checkIpParameters(entries, report) {
24
+ for (const [key, value] of entries) {
25
+ if (!key.endsWith(".IPParameters"))
26
+ continue;
27
+ const ip = key.slice(0, key.length - ".IPParameters".length);
28
+ if (ip.startsWith("Mcu.") || ip.startsWith("ProjectManager") || ip.startsWith("SH"))
29
+ continue;
30
+ const listed = new Set(value.split(",").map((item) => item.trim()).filter((item) => item !== ""));
31
+ const missing = [];
32
+ for (const other of entries.keys()) {
33
+ if (!other.startsWith(ip + ".") || other === key)
34
+ continue;
35
+ const name = other.slice(ip.length + 1);
36
+ if (name.includes(".") || name === "IPParameters")
37
+ continue;
38
+ if (!listed.has(name))
39
+ missing.push(name);
40
+ }
41
+ if (missing.length > 0) {
42
+ report.warnings.push({
43
+ rule: "R7",
44
+ message: ip + ".IPParameters 没列出这些参数:" + missing.join("、") +
45
+ "(CubeMX 只认白名单里的参数,其余会被忽略)",
46
+ });
47
+ }
48
+ }
49
+ }
50
+ /** R1:有 Dma.* 就必须有 Mcu.IPn=DMA,否则整组 DMA 会被丢(实测)。 */
51
+ function checkDmaIp(entries, report) {
52
+ const dmaKeys = [...entries.keys()].filter((key) => DMA_KEY.test(key) || key === "Dma.RequestsNb");
53
+ if (dmaKeys.length === 0)
54
+ return;
55
+ const hasDmaIp = [...entries.entries()].some(([key, value]) => IP_KEY.test(key) && value.trim() === "DMA");
56
+ if (!hasDmaIp) {
57
+ report.errors.push({
58
+ rule: "R1",
59
+ message: "写了 " + String(dmaKeys.length) + " 个 Dma.* 键,但 Mcu.IPn 里没有 DMA —— CubeMX 会整组丢弃(实测)",
60
+ });
61
+ }
62
+ }
63
+ /**
64
+ * R21:DMA 三件套必须齐全(与 IPParameters 同机制,缺了整组静默失效)。
65
+ *
66
+ * 语料 504 份 .ioc 里含 DMA 的 17 份全部写了 `Dma.<IP>.<n>.RequestParameters` 与
67
+ * `Dma.Request<i>`;richhal.ioc:30-32 是 F1 实物。实测 64/64 的 `Dma.Request<i>` 值等于
68
+ * 同号 `Dma.<IP>.<n>` 的 IP 名,且 RequestParameters 列出的名字与写了的键一一对应。
69
+ */
70
+ function checkDmaRequests(entries, report) {
71
+ const groups = new Map();
72
+ for (const key of entries.keys()) {
73
+ const match = /^Dma[.]([A-Za-z0-9_]+)[.]([0-9]+)[.]([A-Za-z0-9_]+)$/u.exec(key);
74
+ if (match === null)
75
+ continue;
76
+ const group = match[1] + "." + match[2];
77
+ const list = groups.get(group) ?? [];
78
+ if (match[3] !== "RequestParameters")
79
+ list.push(match[3]);
80
+ groups.set(group, list);
81
+ }
82
+ if (groups.size === 0)
83
+ return;
84
+ const order = [];
85
+ for (const [group, names] of groups) {
86
+ const listed = (entries.get("Dma." + group + ".RequestParameters") ?? "").split(",").map((item) => item.trim()).filter((item) => item !== "");
87
+ if (listed.length === 0) {
88
+ report.errors.push({
89
+ rule: "R21",
90
+ message: "Dma." + group + " 没有 RequestParameters —— CubeMX 只认白名单里的字段,整组 DMA 参数会被静默忽略",
91
+ });
92
+ }
93
+ else {
94
+ const missing = names.filter((name) => !listed.includes(name));
95
+ if (missing.length > 0) {
96
+ report.warnings.push({
97
+ rule: "R21",
98
+ message: "Dma." + group + ".RequestParameters 没列出这些字段:" + missing.join("、") + "(会被 CubeMX 忽略)",
99
+ });
100
+ }
101
+ }
102
+ order.push(group);
103
+ }
104
+ const requestKeys = [...entries.keys()].filter((key) => /^Dma[.]Request[0-9]+$/u.test(key)).length;
105
+ if (requestKeys === 0) {
106
+ report.errors.push({
107
+ rule: "R21",
108
+ message: "写 " + String(groups.size) + " 组 Dma.<IP>.<n> 却没有 Dma.Request<i>=<IP> —— 请求号没绑到实例,Dma.RequestsNb 只是个孤立计数",
109
+ });
110
+ }
111
+ else if (requestKeys !== groups.size) {
112
+ report.warnings.push({
113
+ rule: "R21",
114
+ message: "Dma.Request<i> 有 " + String(requestKeys) + " 条,但 Dma.<IP>.<n> 有 " + String(groups.size) + " 组(RequestsNb=" +
115
+ (entries.get("Dma.RequestsNb") ?? "<缺失>") + ")",
116
+ });
117
+ }
118
+ for (let index = 0; index < order.length; index += 1) {
119
+ const bound = entries.get("Dma.Request" + String(index));
120
+ if (bound === undefined)
121
+ continue;
122
+ const ip = order[index].split(".")[0];
123
+ if (bound.trim() !== ip) {
124
+ report.warnings.push({
125
+ rule: "R21",
126
+ message: "Dma.Request" + String(index) + "=" + bound + " 与第 " + String(index + 1) + " 组 Dma." + order[index] +
127
+ " 的实例对不上(按语料应当等于 " + ip + ")",
128
+ });
129
+ }
130
+ }
131
+ }
132
+ /** R2:ADC 规则通道的 Rank/Channel/SamplingTime 要同 id,NbrOfConversion 与条数一致,Rank 值 1..N 连续。 */
133
+ function checkAdcRanks(entries, report) {
134
+ const ranks = new Map();
135
+ for (const [key, value] of entries) {
136
+ const match = ADC_RANK_KEY.exec(key);
137
+ if (match === null || match[2] !== "Rank")
138
+ continue;
139
+ const instance = match[1];
140
+ const list = ranks.get(instance) ?? [];
141
+ const parsed = Number.parseInt(value, 10);
142
+ if (Number.isFinite(parsed))
143
+ list.push(parsed);
144
+ ranks.set(instance, list);
145
+ }
146
+ for (const [instance, list] of ranks) {
147
+ const declared = Number.parseInt(entries.get(instance + ".NbrOfConversion") ?? "", 10);
148
+ if (Number.isFinite(declared) && declared !== list.length) {
149
+ report.warnings.push({
150
+ rule: "R2",
151
+ message: instance + ".NbrOfConversion=" + String(declared) + " 但找到 " + String(list.length) + " 组 Rank",
152
+ });
153
+ }
154
+ const sorted = [...list].sort((a, b) => a - b);
155
+ const expected = sorted.map((_, index) => index + 1);
156
+ if (sorted.join(",") !== expected.join(",")) {
157
+ report.warnings.push({
158
+ rule: "R2",
159
+ message: instance + " 的 Rank 值不连续(" + sorted.join(",") + "),CubeMX 按 1..N 生成,建议改成连续",
160
+ });
161
+ }
162
+ }
163
+ for (const [key] of entries) {
164
+ const match = ADC_RANK_KEY.exec(key);
165
+ if (match === null)
166
+ continue;
167
+ const instance = match[1];
168
+ const slot = match[3];
169
+ if (match[2] !== "Rank")
170
+ continue;
171
+ if (!entries.has(instance + ".Channel-" + slot + "#ChannelRegularConversion")) {
172
+ report.warnings.push({ rule: "R2", message: instance + " 的 Rank-" + slot + " 没有配对的 Channel-" + slot });
173
+ }
174
+ }
175
+ }
176
+ /** R3:NVIC 值必须是冒号分隔的 9 段(NvicVector 的 Enable/Preempt/Sub/… 顺序)。 */
177
+ function checkNvicValues(entries, report) {
178
+ for (const [key, value] of entries) {
179
+ const match = NVIC_KEY.exec(key);
180
+ if (match === null)
181
+ continue;
182
+ const fields = value.split(":");
183
+ if (fields.length < 6) {
184
+ report.warnings.push({
185
+ rule: "R3",
186
+ // 实测(CubeMX 6.15 往返 F4 板级 .ioc):4 段的旧值不会被"按默认值覆盖",
187
+ // 而是被补齐成 9 段、前 N 段语义保留(true:0:0:false → true:0:0:false:false:true:true:true:false)。
188
+ // 所以这里只提示"会被补齐",不再吓唬人说值会丢。
189
+ message: "NVIC." + String(match[1]) + " 的值只有 " + String(fields.length) +
190
+ " 段(CubeMX 6.x 写 9 段:Enable:Preempt:Sub:Configurable:System:IrqHandlerGenerated…):CubeMX 会补齐成 9 段,前 " +
191
+ String(fields.length) + " 段语义保留",
192
+ });
193
+ continue;
194
+ }
195
+ if (fields[0] !== "true" && fields[0] !== "false") {
196
+ report.warnings.push({ rule: "R3", message: "NVIC." + String(match[1]) + " 的第一段应是 true/false,实际是 " + fields[0] });
197
+ }
198
+ }
199
+ }
200
+ /** R5:F1 的 ADC 时钟上限 14 MHz;ADCPresc 不是除 6 时提醒(实测生成的代码会写成除 2)。 */
201
+ function checkAdcClock(entries, family, report) {
202
+ if (family.toUpperCase() !== "STM32F1")
203
+ return;
204
+ const presc = (entries.get("RCC.ADCPresc") ?? "").trim();
205
+ if (presc === "") {
206
+ report.warnings.push({ rule: "R5", message: "没有 RCC.ADCPresc:F1 的 ADC 上限 14 MHz,缺省除 2 会让 72 MHz 系统跑出 36 MHz" });
207
+ return;
208
+ }
209
+ if (presc !== "RCC_ADCPCLK2_DIV6") {
210
+ report.warnings.push({
211
+ rule: "R5",
212
+ message: "RCC.ADCPresc=" + presc + "(F1 上限 14 MHz,72 MHz 系统建议 RCC_ADCPCLK2_DIV6);" +
213
+ "另外实测 CubeMX 生成的 SystemClock_Config 不一定采纳这个键,生成后要看一眼 AdcClockSelection",
214
+ });
215
+ }
216
+ }
217
+ /** 伪外设:在 Mcu.IPn 里出现但没有自己的引脚,不能按「必须有引脚指向」去校验。 */
218
+ const PSEUDO_IPS = new Set([
219
+ "NVIC", "RCC", "SYS", "DMA", "USB", "USB_OTG_FS", "USB_OTG_HS",
220
+ "CORTEX_M0", "CORTEX_M3", "CORTEX_M4", "CORTEX_M7", "FREERTOS",
221
+ ]);
222
+ /** 会出现在引脚名后面的键后缀(ImportEngine 里按引脚前缀 + 后缀收集)。 */
223
+ const PIN_SUFFIXES = new Set([
224
+ "Signal", "Mode", "Locked", "GPIOParameters", "GPIO_Label", "GPIO_PuPd", "GPIO_Speed",
225
+ "GPIO_OType", "GPIO_Mode", "GPIO_ModeDefaultEXTI", "GPIO_ModeDefaultPP", "GPIO_ModeDefaultOutputPP",
226
+ ]);
227
+ /** R4:引脚的键必须对应 Mcu.PinN 里的引脚,否则 CubeMX 不会应用(实测)。 */
228
+ function checkPinReferences(entries, report) {
229
+ const listed = new Set();
230
+ for (const [key, value] of entries) {
231
+ if (/^Mcu[.]Pin[0-9]+$/u.test(key))
232
+ listed.add(value.trim());
233
+ }
234
+ if (listed.size === 0)
235
+ return;
236
+ const unknown = new Set();
237
+ for (const key of entries.keys()) {
238
+ const dot = key.indexOf(".");
239
+ if (dot <= 0)
240
+ continue;
241
+ const prefix = key.slice(0, dot);
242
+ const suffix = key.slice(dot + 1);
243
+ if (!PIN_SUFFIXES.has(suffix))
244
+ continue;
245
+ if (prefix.startsWith("Mcu") || prefix.startsWith("SH"))
246
+ continue;
247
+ if (!listed.has(prefix))
248
+ unknown.add(prefix);
249
+ }
250
+ for (const pin of unknown) {
251
+ report.warnings.push({
252
+ rule: "R4",
253
+ message: pin + " 有配置键但没列进 Mcu.PinN —— CubeMX 只应用引脚表里的脚(补 Mcu.PinN 与 Mcu.PinsNb)",
254
+ });
255
+ }
256
+ }
257
+ /** R6:SH.<信号>.ConfNb 必须等于 SH.<信号>.<n> 的条数,值形如 <IP 信号>,<IP 模式> 或 GPIO_EXTIn。 */
258
+ function checkSharedSignals(entries, report) {
259
+ const groups = new Map();
260
+ for (const [key, value] of entries) {
261
+ const match = /^SH[.](.+)[.]([0-9]+)$/u.exec(key);
262
+ if (match === null)
263
+ continue;
264
+ const list = groups.get(match[1]) ?? [];
265
+ list.push(value);
266
+ groups.set(match[1], list);
267
+ }
268
+ for (const [signal, values] of groups) {
269
+ const declared = Number.parseInt(entries.get("SH." + signal + ".ConfNb") ?? "", 10);
270
+ if (!Number.isFinite(declared)) {
271
+ report.warnings.push({ rule: "R6", message: "SH." + signal + " 有 " + String(values.length) + " 条映射但缺 ConfNb" });
272
+ }
273
+ else if (declared !== values.length) {
274
+ report.warnings.push({
275
+ rule: "R6",
276
+ message: "SH." + signal + ".ConfNb=" + String(declared) + " 但实际有 " + String(values.length) + " 条映射",
277
+ });
278
+ }
279
+ for (const value of values) {
280
+ if (!value.includes(",") && !value.startsWith("GPIO_EXTI")) {
281
+ report.warnings.push({
282
+ rule: "R6",
283
+ message: "SH." + signal + " 的值 " + value + " 既不是 <IP 信号>,<IP 模式> 也不是 GPIO_EXTIn",
284
+ });
285
+ }
286
+ }
287
+ }
288
+ }
289
+ /** R8:Mcu.IPNb / Mcu.PinsNb 必须与实际条数一致(CubeMX 自己会重算,不一致说明文件被手改过)。 */
290
+ function checkIpPinCounts(entries, report) {
291
+ const count = (pattern) => {
292
+ let total = 0;
293
+ for (const key of entries.keys())
294
+ if (pattern.test(key))
295
+ total += 1;
296
+ return total;
297
+ };
298
+ const ipCount = count(/^Mcu[.]IP[0-9]+$/u);
299
+ const pinCount = count(/^Mcu[.]Pin[0-9]+$/u);
300
+ const ipNb = Number.parseInt(entries.get("Mcu.IPNb") ?? "", 10);
301
+ const pinsNb = Number.parseInt(entries.get("Mcu.PinsNb") ?? "", 10);
302
+ if (Number.isFinite(ipNb) && ipNb !== ipCount) {
303
+ report.warnings.push({ rule: "R8", message: "Mcu.IPNb=" + String(ipNb) + " 但实际有 " + String(ipCount) + " 个 Mcu.IPn 键" });
304
+ }
305
+ if (Number.isFinite(pinsNb) && pinsNb !== pinCount) {
306
+ report.warnings.push({ rule: "R8", message: "Mcu.PinsNb=" + String(pinsNb) + " 但实际有 " + String(pinCount) + " 个 Mcu.PinN 键" });
307
+ }
308
+ }
309
+ /** R12:引脚只有 .Mode 或只有 .Signal —— 外设引脚两种缺一不可(GPIO 脚只有 .Signal 是正常的)。 */
310
+ /** 形如 ADC1 / DAC1 / TIM2 / USART3 / SPI1 / I2C2 / CAN1 / SDIO / RTC / IWDG / WWDG 的外设实例名。 */
311
+ const IP_INSTANCE = /^(?:ADC|DAC|TIM|USART|UART|SPI|I2C|CAN|USB|SDIO|ETH|RTC|IWDG|WWDG)[0-9]*$/u;
312
+ /**
313
+ * R15:外设参数键指向的实例不在 Mcu.IPn 里。
314
+ *
315
+ * 证据:CubeMX 的 ImportEngine 先按 Mcu.IPn 建「这次工程里有哪些外设实例」,再按实例名分发参数
316
+ * (ImportParameterContext)。实例不存在时,挂在它下面的 USART2.BaudRate / TIM3.Prescaler 这类键
317
+ * 没有接收方,会被静默丢掉——表现是「.ioc 里明明写了,生成出来的代码里没有」。
318
+ *
319
+ * 只查「首段看起来就是外设实例名」的键,RCC. / NVIC. / SH. / Dma. / Mcu. / ProjectManager. 这些
320
+ * 都不是实例名,不参与(Dma.* 由 R1 管)。
321
+ */
322
+ function checkIpInstanceKeys(entries, report) {
323
+ const instances = new Set();
324
+ for (const [key, value] of entries) {
325
+ if (IP_KEY.test(key))
326
+ instances.add(value.trim().toUpperCase());
327
+ }
328
+ const orphans = new Map();
329
+ for (const key of entries.keys()) {
330
+ const head = key.split(".")[0] ?? "";
331
+ if (!IP_INSTANCE.test(head))
332
+ continue;
333
+ if (instances.has(head.toUpperCase()))
334
+ continue;
335
+ const list = orphans.get(head) ?? [];
336
+ if (list.length < 4)
337
+ list.push(key);
338
+ orphans.set(head, list);
339
+ }
340
+ for (const [ip, keys] of orphans) {
341
+ report.warnings.push({
342
+ rule: "R15",
343
+ message: ip + " 有参数键(" + keys.join("、") + "),但 Mcu.IPn 里没有 " + ip +
344
+ " —— CubeMX 按 Mcu.IPn 建实例,这些键没有接收方,会被静默丢弃",
345
+ });
346
+ }
347
+ }
348
+ function checkModeSignalPairs(entries, report) {
349
+ const pins = new Set();
350
+ for (const key of entries.keys()) {
351
+ if (!key.endsWith(".Mode"))
352
+ continue;
353
+ const pin = key.slice(0, key.length - ".Mode".length);
354
+ // 只认真正的引脚键:引脚名里没有点(Dma.ADC1.0.Mode 这种是外设参数,不是引脚)
355
+ if (pin.includes("."))
356
+ continue;
357
+ pins.add(pin);
358
+ }
359
+ for (const pin of pins) {
360
+ if (pin.startsWith("VP_") || pin.startsWith("SH"))
361
+ continue;
362
+ if (!entries.has(pin + ".Signal")) {
363
+ report.warnings.push({ rule: "R12", message: pin + " 有 .Mode 却没有 .Signal(CubeMX 不会把它当外设引脚)" });
364
+ }
365
+ }
366
+ }
367
+ /** 模式名归一:CubeMX 里 "Serial Wire" / "Serial_Wire"、"PWM Generation1 CH1" 混着用。 */
368
+ function normalizeModeText(text) {
369
+ return text.trim().toLowerCase().replace(/[\s_-]+/gu, "_").replace(/^_+|_+$/gu, "");
370
+ }
371
+ /**
372
+ * R13 的判定核心:.ioc 写的 Signal 是不是这根脚在 db 里支持的信号。
373
+ * 要容忍三类 CubeMX 自己写出来的「伪信号」:
374
+ * - GPIO_Output / GPXTI8(GPIO 模式与外部中断):等价于 db 的 GPIO;
375
+ * - ADCx_IN1:db 里是 ADC1_IN1 / ADC2_IN1(x 是占位符);
376
+ * - S_TIM2_CH1_ETR:db 把共享信号拆成 TIM2_CH1 与 TIM2_ETR,认前缀即可。
377
+ */
378
+ export function pinSignalSupported(signals, signal) {
379
+ const raw = signal.trim();
380
+ if (raw === "")
381
+ return false;
382
+ if (signals.has(raw))
383
+ return true;
384
+ const gpio = signals.has("GPIO");
385
+ if (/^GPIO(?:_|$)/u.test(raw))
386
+ return gpio;
387
+ if (/^GPXTI[0-9]+$/u.test(raw))
388
+ return gpio;
389
+ const adc = /^ADCx_IN([0-9]+)$/u.exec(raw);
390
+ if (adc !== null) {
391
+ return [...signals.keys()].some((name) => name === "ADC1_IN" + adc[1] || name === "ADC2_IN" + adc[1] || name === "ADC3_IN" + adc[1]);
392
+ }
393
+ const stripped = raw.replace(/^S_/u, "");
394
+ if (signals.has(stripped))
395
+ return true;
396
+ for (const name of signals.keys()) {
397
+ if (name.length >= 5 && stripped.startsWith(name))
398
+ return true;
399
+ }
400
+ return false;
401
+ }
402
+ /** 从信号名推外设实例(TIM3_CH1 → TIM3、USART1_TX → USART1);推不出返回空串。 */
403
+ export function instanceFromSignal(signal) {
404
+ const raw = signal.replace(/^S_/u, "");
405
+ const match = /^([A-Z]+[0-9]+)_/u.exec(raw);
406
+ if (match !== null)
407
+ return match[1];
408
+ if (/^SYS_/u.test(raw))
409
+ return "SYS";
410
+ return "";
411
+ }
412
+ /** 收集「引脚 → (Signal, Mode)」:键里带点的是外设参数(Dma.ADC1.0.Mode),不是引脚。 */
413
+ function collectPins(entries) {
414
+ const out = [];
415
+ for (const key of entries.keys()) {
416
+ if (!key.endsWith(".Signal"))
417
+ continue;
418
+ const pin = key.slice(0, key.length - ".Signal".length);
419
+ if (pin.includes("."))
420
+ continue;
421
+ if (pin.startsWith("VP_") || pin.startsWith("SH"))
422
+ continue;
423
+ const index = out.findIndex((item) => item.pin === pin);
424
+ const signal = entries.get(pin + ".Signal") ?? "";
425
+ const mode = entries.get(pin + ".Mode") ?? "";
426
+ if (index >= 0)
427
+ out[index] = { pin, signal, mode };
428
+ else
429
+ out.push({ pin, signal, mode });
430
+ }
431
+ return out;
432
+ }
433
+ /** R13:<pin>.Signal 必须是该脚在 db 里支持的信号(含 GPIO/ADCx_INn/S_ 共享名)。 */
434
+ function checkPinSignals(entries, facts, report) {
435
+ for (const item of collectPins(entries)) {
436
+ if (item.signal === "")
437
+ continue;
438
+ const dbPin = resolveDbPinName(facts, item.pin) ?? item.pin;
439
+ const fact = facts.pins.get(dbPin);
440
+ if (fact === undefined)
441
+ continue;
442
+ if (pinSignalSupported(fact.signals, item.signal))
443
+ continue;
444
+ const sample = [...fact.signals.keys()].slice(0, 8).join("、");
445
+ report.warnings.push({
446
+ rule: "R13",
447
+ message: item.pin + ".Signal=" + item.signal + " 不是 db(" + facts.name + ")里 " + dbPin +
448
+ " 支持的信号(该脚支持:" + sample + (fact.signals.size > 8 ? "…" : "") + ")",
449
+ });
450
+ }
451
+ }
452
+ /** R14:<pin>.Mode 必须是该信号允许的模式(GPIO 查 IOModes,外设查该 IP 的 RefMode 名单)。 */
453
+ function checkPinModes(entries, facts, db, report) {
454
+ for (const item of collectPins(entries)) {
455
+ if (item.mode === "")
456
+ continue;
457
+ const dbPin = resolveDbPinName(facts, item.pin) ?? item.pin;
458
+ const fact = facts.pins.get(dbPin);
459
+ if (fact === undefined)
460
+ continue;
461
+ if (/^GPIO(?:_|$)/u.test(item.signal) || /^GPXTI[0-9]+$/u.test(item.signal)) {
462
+ const allowed = fact.signals.get("GPIO") ?? [];
463
+ if (allowed.length === 0)
464
+ continue;
465
+ const wanted = normalizeModeText(item.mode.replace(/^GPIO_/u, ""));
466
+ if (allowed.some((name) => normalizeModeText(name) === wanted))
467
+ continue;
468
+ report.warnings.push({ rule: "R14", message: item.pin + ".Mode=" + item.mode + " 不在 db 的 GPIO 模式里(" + allowed.join("、") + ")" });
469
+ continue;
470
+ }
471
+ const instance = instanceFromSignal(item.signal);
472
+ // SYS 跳过:db 里 SYS 的 Modes.xml 列的是 TIM/TIM1… 这类时基复用,根本没有调试口的模式名,
473
+ // 拿它校验 <pin>.Mode 必然误报。504 份板级 .ioc 的实测取值是 Serial_Wire(149)/Serial-Wire(44)/
474
+ // Trace_Asynchronous_SW(33)/Serial-WireDebug(18)/JTAG_5_pins(5)/SYS_WakeUp*(20) —— 全部不在 db 名单里,
475
+ // 而 CubeMX 自己保存时就是这么写的(F4 板级文件 4→9 段往返实测:PA13.Mode=Serial_Wire 原样保留)。
476
+ if (instance === "SYS")
477
+ continue;
478
+ if (instance === "" || db === null || !facts.ips.has(instance))
479
+ continue;
480
+ const modes = readIpModeNames(db, facts, instance);
481
+ if (modes.length === 0)
482
+ continue;
483
+ const wanted = normalizeModeText(item.mode);
484
+ if (modes.some((name) => normalizeModeText(name) === wanted))
485
+ continue;
486
+ report.warnings.push({
487
+ rule: "R14",
488
+ message: item.pin + ".Mode=" + item.mode + " 不是 " + instance + " 在 db 里的合法模式(例:" + modes.slice(0, 6).join("、") + "…)",
489
+ });
490
+ }
491
+ }
492
+ /** R17:同一根物理引脚被写了两份(PA0 与 PA0-WKUP),或同一个外设信号挂到两根脚上。 */
493
+ function checkPinConflicts(entries, facts, report) {
494
+ const byDbPin = new Map();
495
+ const bySignal = new Map();
496
+ for (const item of collectPins(entries)) {
497
+ const dbPin = resolveDbPinName(facts, item.pin) ?? item.pin;
498
+ byDbPin.set(dbPin, [...(byDbPin.get(dbPin) ?? []), item.pin]);
499
+ if (item.signal === "" || /^GPIO(?:_|$)/u.test(item.signal) || /^GPXTI[0-9]+$/u.test(item.signal))
500
+ continue;
501
+ bySignal.set(item.signal, [...(bySignal.get(item.signal) ?? []), item.pin]);
502
+ }
503
+ for (const [dbPin, pins] of byDbPin) {
504
+ const unique = [...new Set(pins)];
505
+ if (unique.length < 2)
506
+ continue;
507
+ report.errors.push({
508
+ rule: "R17",
509
+ message: "同一个物理引脚写了多份:" + unique.join("、") + "(db 里都是 " + dbPin + "),CubeMX 只会认其中一份",
510
+ });
511
+ }
512
+ for (const [signal, pins] of bySignal) {
513
+ const unique = [...new Set(pins)];
514
+ if (unique.length < 2)
515
+ continue;
516
+ report.errors.push({
517
+ rule: "R17",
518
+ message: "信号 " + signal + " 同时挂在 " + unique.join("、") + " 上:一个外设信号只能占一根脚",
519
+ });
520
+ }
521
+ }
522
+ /**
523
+ * R18:主频不得超过 db 里这颗芯片的上限。
524
+ *
525
+ * 上限只认 db 的 <Frequency>(F103C8 = 72),不写死数字;恰好等于上限是合法的。
526
+ * APB1 的 36 MHz、ADC 的 14 MHz 属于「派生上限」:ADC 由 R5 管,APB1 暂不在这里判
527
+ * (F1 之外的族上限不同,硬编码会误报)。
528
+ */
529
+ function checkClockCeiling(entries, facts, report) {
530
+ const hz = Number.parseInt(entries.get("RCC.SYSCLKFreq_VALUE") ?? "", 10);
531
+ const maxHz = Math.round(facts.frequencyMhz * 1_000_000);
532
+ if (!Number.isFinite(hz) || hz <= 0 || maxHz <= 0)
533
+ return;
534
+ if (hz <= maxHz)
535
+ return;
536
+ report.errors.push({
537
+ rule: "R18",
538
+ message: "RCC.SYSCLKFreq_VALUE=" + String(hz) + " Hz 超过 db(" + facts.name + ")的上限 " +
539
+ String(facts.frequencyMhz) + " MHz = " + String(maxHz) + " Hz",
540
+ });
541
+ }
542
+ /**
543
+ * Cortex-M 内核异常:永远合法,但 SVD 的 <interrupt> 只列"器件外设"中断,内核异常不在里面。
544
+ * 不白名单化会在每份 .ioc 上刷 9 条假警报(真机实测:BusFault/HardFault/PendSV/SysTick… 全被误报)。
545
+ */
546
+ /**
547
+ * EXTI 线号 → 中断向量名(不带 _IRQn)。**分组是按内核定的,不是全族一张表**:
548
+ * M3/M4/M7(F1/F4/G4…)→ EXTI0..EXTI4 逐线、EXTI9_5(5-9)、EXTI15_10(10-15)
549
+ * M0/M0+(C0/F0/G0/L0…)→ EXTI0_1、EXTI2_3、EXTI4_15
550
+ * M33/M55(U5/WBA/L5/H5/N6…)→ 16 条线全部逐线
551
+ * 表在 data/family.ts 的 extiVectorsOf()(证据:504 份板级 .ioc 的实测分布)。
552
+ * 不传 profile 时保持老行为(M3 分组),供不了解族的调用方用。
553
+ */
554
+ export function extiIrqName(line, profile) {
555
+ if (profile !== undefined)
556
+ return extiVectorNameOf(line, profile);
557
+ if (line <= 4)
558
+ return "EXTI" + String(line);
559
+ if (line <= 9)
560
+ return "EXTI9_5";
561
+ return "EXTI15_10";
562
+ }
563
+ export const CORE_EXCEPTIONS = new Set([
564
+ "NonMaskableInt", "HardFault", "MemoryManagement", "BusFault", "UsageFault",
565
+ "SVCall", "DebugMonitor", "PendSV", "SysTick",
566
+ ]);
567
+ export function checkNvicNames(entries, interrupts, report) {
568
+ for (const key of entries.keys()) {
569
+ const match = /^NVIC[.](.+_IRQn)$/u.exec(key);
570
+ if (match === null)
571
+ continue;
572
+ const full = match[1];
573
+ const name = full.replace(/_IRQn$/u, "");
574
+ if (interrupts.has(name) || CORE_EXCEPTIONS.has(name))
575
+ continue;
576
+ report.warnings.push({
577
+ rule: "R20",
578
+ message: "NVIC." + full + " 的中断名 " + name + " 不在 SVD 的中断表里:CubeMX 会忽略这条,生成代码里不会有对应的 NVIC 使能",
579
+ });
580
+ }
581
+ }
582
+ /**
583
+ * R22:引脚上的 GPIO_* 属性键必须同时列进 <pin>.GPIOParameters。
584
+ *
585
+ * 真机证据(2026-11-02,CubeMX 6.15.0):给 PC13-TAMPER-RTC 写 PinState=GPIO_PIN_SET,但
586
+ * GPIOParameters 里只列了 GPIO_Label → 回写后 PinState 被静默删除;同一轮里 PA5.PinState 因为
587
+ * 列进了 GPIOParameters 就原样保留。也就是说:**属性值写了、名单里没列 = 等于没写**,而且没有报错。
588
+ */
589
+ const GPIO_ATTRIBUTE_NAMES = [
590
+ "GPIO_Label", "GPIO_Speed", "GPIO_PuPd", "GPIO_Mode", "PinState",
591
+ "GPIO_ModeDefaultEXTI", "GPIO_ModeDefaultPP", "GPIO_ModeDefaultOutputPP", "GPIO_OType",
592
+ ];
593
+ function checkGpioParameterCoverage(entries, report) {
594
+ for (const [key, value] of entries) {
595
+ if (!key.endsWith(".GPIOParameters"))
596
+ continue;
597
+ const pin = key.slice(0, -".GPIOParameters".length);
598
+ const listed = new Set(value.split(",").map((item) => item.trim()).filter((item) => item !== ""));
599
+ for (const name of GPIO_ATTRIBUTE_NAMES) {
600
+ if (!entries.has(pin + "." + name))
601
+ continue;
602
+ if (listed.has(name))
603
+ continue;
604
+ report.warnings.push({
605
+ rule: "R22",
606
+ message: pin + "." + name + " 没列进 " + pin + ".GPIOParameters:CubeMX 会静默删掉这个键(实测),写了等于没写",
607
+ });
608
+ }
609
+ }
610
+ }
611
+ const EXTI_TOKENS = new Set(["GPIO_MODE_IT_RISING", "GPIO_MODE_IT_FALLING", "GPIO_MODE_IT_RISING_FALLING"]);
612
+ /**
613
+ * R23:EXTI 链路完整性。一根脚的 EXTI 由四处共同表达,缺一处就断:
614
+ * <pin>.Signal=GPXTI<line>、<pin>.GPIO_ModeDefaultEXTI、SH.GPXTI<line>.0=GPIO_EXTI<line>(+ ConfNb)、
615
+ * NVIC.<EXTI 组>_IRQn。
616
+ *
617
+ * 真机证据(2026-11-02):链路齐全时 CubeMX 逐字保留、不补任何键;而 NVIC 那条它**从不自动补**——
618
+ * 缺了 EXTI 边沿照样能触发标志位,但中断服务永远进不去,.ioc 里也看不出来。
619
+ */
620
+ function checkExtiChains(entries, profile, report) {
621
+ for (const [key, value] of entries) {
622
+ const match = /^(P[A-Z][0-9]{1,2}(?:-[A-Za-z0-9_]+)?)[.]Signal$/u.exec(key);
623
+ if (match === null)
624
+ continue;
625
+ const pin = match[1];
626
+ const exti = /^GPXTI([0-9]{1,2})$/u.exec(value.trim());
627
+ if (exti === null)
628
+ continue;
629
+ const line = Number.parseInt(exti[1], 10);
630
+ const pinNumber = /^P[A-Z]([0-9]{1,2})/u.exec(pin)?.[1];
631
+ if (pinNumber !== undefined && Number.parseInt(pinNumber, 10) !== line) {
632
+ report.warnings.push({
633
+ rule: "R23",
634
+ message: pin + ".Signal=GPXTI" + String(line) + " 的线号与引脚号不一致(" + pin + " 只能用 GPXTI" + pinNumber + ")",
635
+ });
636
+ }
637
+ const mode = (entries.get(pin + ".GPIO_ModeDefaultEXTI") ?? "").trim();
638
+ if (mode === "") {
639
+ report.warnings.push({ rule: "R23", message: pin + " 配了 EXTI 但没有 " + pin + ".GPIO_ModeDefaultEXTI(边沿触发方式),CubeMX 认不出这个中断" });
640
+ }
641
+ else if (!EXTI_TOKENS.has(mode)) {
642
+ report.warnings.push({ rule: "R23", message: pin + ".GPIO_ModeDefaultEXTI=" + mode + " 不是合法值(" + [...EXTI_TOKENS].join("、") + ")" });
643
+ }
644
+ const shared = entries.get("SH.GPXTI" + String(line) + ".0");
645
+ if (shared === undefined) {
646
+ report.warnings.push({
647
+ rule: "R23",
648
+ message: "缺 SH.GPXTI" + String(line) + ".0=GPIO_EXTI" + String(line) + "(共享信号块):CubeMX 靠它把 EXTI 归属还原出来",
649
+ });
650
+ }
651
+ // 该族没有 EXTI 向量表(Cortex-A 的 MP1/MP2)时 extiIrqName 返回空串:不写也告不了警。
652
+ const irq = extiIrqName(line, profile);
653
+ if (irq === "") {
654
+ report.warnings.push({
655
+ rule: "R23",
656
+ message: pin + ".Signal=GPXTI" + String(line) + " 但 " + (profile?.id ?? "该芯片") + " 没有 EXTI<线> 的 NVIC 向量(Cortex-A 不走 NVIC/EXTI 模型)",
657
+ });
658
+ }
659
+ else if (!entries.has("NVIC." + irq + "_IRQn")) {
660
+ report.warnings.push({
661
+ rule: "R23",
662
+ message: "有 EXTI" + String(line) + " 却没有 NVIC." + irq + "_IRQn:中断不会使能(CubeMX 不会自动补这一条)",
663
+ });
664
+ }
665
+ }
666
+ }
667
+ /** 对外入口:跑一遍全部离线规则。 */
668
+ export function checkIocRules(entries, context = {}) {
669
+ const report = { errors: [], warnings: [] };
670
+ const family = (entries.get("Mcu.Family") ?? "").trim();
671
+ checkIpParameters(entries, report);
672
+ checkDmaIp(entries, report);
673
+ checkDmaRequests(entries, report);
674
+ checkAdcRanks(entries, report);
675
+ checkNvicValues(entries, report);
676
+ checkAdcClock(entries, family, report);
677
+ checkPinReferences(entries, report);
678
+ checkSharedSignals(entries, report);
679
+ checkIpPinCounts(entries, report);
680
+ checkModeSignalPairs(entries, report);
681
+ checkIpInstanceKeys(entries, report);
682
+ checkGpioParameterCoverage(entries, report);
683
+ // EXTI 的 NVIC 向量分组按内核不同(M0/M3/M33 三档),所以这条规则要族画像。
684
+ checkExtiChains(entries, family === "" ? null : familyProfileOf(family), report);
685
+ // db 类规则:没有 db 就整体跳过(查不到 ≠ 写错了)。
686
+ const facts = context.facts ?? null;
687
+ if (facts !== null) {
688
+ checkPinSignals(entries, facts, report);
689
+ checkPinModes(entries, facts, context.db ?? null, report);
690
+ checkPinConflicts(entries, facts, report);
691
+ checkClockCeiling(entries, facts, report);
692
+ }
693
+ const interrupts = context.interrupts ?? null;
694
+ if (interrupts !== null) {
695
+ checkNvicNames(entries, interrupts, report);
696
+ }
697
+ return report;
698
+ }