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,1058 @@
1
+ /**
2
+ * CubeMX .ioc 键真值表(schema)。
3
+ *
4
+ * 目的:生成器不再逐处拼键名字符串,而是「按 schema 渲染 + 按 schema 校验」。本表是**证据登记表**,不是文档:
5
+ * 每一条都要能指出证据来源(jar.md 行号 / 语料统计 / 真机回写实验)。
6
+ *
7
+ * 证据三源(详见 docs §61):
8
+ * 1. .dsh-stm32/cubemx-re/jar.md —— javap 反汇编 + 43,264 个 class 的字面量扫描得出的写键点与顺序结论;
9
+ * 2. 504 份 boardmanager 板级 .ioc 语料统计(键出现频率、值 token 分布、顺序反例计数);
10
+ * 3. 真机实验:CubeMX 6.15.0 无头 config load + config save 回写比对(demo.ioc 副本)。
11
+ *
12
+ * 版本绑定:CubeMX 6.15.0 / db DB.6.0.150 / STM32Cube_FW_F1_V1.8.7。换版本必须重新取证。
13
+ *
14
+ * 约定:
15
+ * - key 用占位符模板,{pin} {index} {ip} {name} {n} {signal} 会被编译成正则分组,{*} 是 catch-all(不取参);
16
+ * - writer 为 null 表示「CubeMX 自己写,我们故意不写」,并在 trigger 里写清为什么;
17
+ * - rules 关联 docs 里的规则号(R6/R7/R22/R23…),规则与 schema 互为索引。
18
+ */
19
+ /** 真值表本体(49 条,按匹配优先级排列:先匹配到的生效——具体模板放前面,`{ip}.{name}` 这类兜底模板放最后)。 */
20
+ export const SPECS = [
21
+ {
22
+ "id": "mcu.cpn",
23
+ "entity": "mcu",
24
+ "key": "Mcu.CPN",
25
+ "valueKind": "text",
26
+ "valueNote": "芯片订货号(STM32F103C8Tx)。",
27
+ "trigger": "恒写(新建工程时由 CubeMX 写,我们只替换模板里已有的值)。",
28
+ "order": "dictionary",
29
+ "evidence": [
30
+ "jar.md:66-70",
31
+ "语料 504/504"
32
+ ],
33
+ "writer": "src/engine/hal-chip.ts:242-266"
34
+ },
35
+ {
36
+ "id": "mcu.name",
37
+ "entity": "mcu",
38
+ "key": "Mcu.Name",
39
+ "valueKind": "text",
40
+ "valueNote": "db 里的 Mcu.Name(STM32F103C8Tx)。",
41
+ "trigger": "恒写;引脚/信号校验都以它为准。",
42
+ "order": "dictionary",
43
+ "evidence": [
44
+ "jar.md:66-70",
45
+ "语料 504/504"
46
+ ],
47
+ "writer": "src/engine/hal-chip.ts:242-266"
48
+ },
49
+ {
50
+ "id": "mcu.user_name",
51
+ "entity": "mcu",
52
+ "key": "Mcu.UserName",
53
+ "valueKind": "text",
54
+ "valueNote": "工程名(生成 main.c 的头注释、启动工程 Target 名)。",
55
+ "trigger": "恒写。",
56
+ "order": "dictionary",
57
+ "evidence": [
58
+ "jar.md:66-70",
59
+ "语料 504/504"
60
+ ],
61
+ "writer": "src/engine/hal-chip.ts:242-266"
62
+ },
63
+ {
64
+ "id": "mcu.family",
65
+ "entity": "mcu",
66
+ "key": "Mcu.Family",
67
+ "valueKind": "text",
68
+ "valueNote": "族名(STM32F1)。",
69
+ "trigger": "恒写。",
70
+ "order": "dictionary",
71
+ "evidence": [
72
+ "jar.md:66-70",
73
+ "语料 504/504"
74
+ ],
75
+ "writer": "src/engine/hal-chip.ts:242-266"
76
+ },
77
+ {
78
+ "id": "mcu.package",
79
+ "entity": "mcu",
80
+ "key": "Mcu.Package",
81
+ "valueKind": "text",
82
+ "valueNote": "封装名(LQFP48)。",
83
+ "trigger": "恒写。",
84
+ "order": "dictionary",
85
+ "evidence": [
86
+ "jar.md:66-70",
87
+ "语料 504/504"
88
+ ],
89
+ "writer": "src/engine/hal-chip.ts:242-266"
90
+ },
91
+ {
92
+ "id": "mcu.pin_index",
93
+ "entity": "mcu",
94
+ "key": "Mcu.Pin{index}",
95
+ "valueKind": "index",
96
+ "valueNote": "引脚 db 名(PA0-WKUP、PC13-TAMPER-RTC、VP_SYS_VS_Systick)。索引 0..PinsNb-1 连续。",
97
+ "trigger": "引脚表变化时才整体重写(没变不碰字节)。顺序 = db <Pin Position> 升序,虚拟脚 VP_* 恒最后。",
98
+ "order": "index",
99
+ "evidence": [
100
+ "jar.md:75-76",
101
+ "语料 30,830 行/504 文件",
102
+ "真机 2026-11-02 四轮:回写顺序与 db Position 全一致"
103
+ ],
104
+ "writer": "src/engine/ioc-plan.ts:535"
105
+ },
106
+ {
107
+ "id": "mcu.pins_nb",
108
+ "entity": "mcu",
109
+ "key": "Mcu.PinsNb",
110
+ "valueKind": "count",
111
+ "valueNote": "引脚表条数 = 上面的索引上限。",
112
+ "trigger": "与 Mcu.Pin<i> 同进同退。",
113
+ "order": "dictionary",
114
+ "evidence": [
115
+ "jar.md:75-76",
116
+ "语料 504/504"
117
+ ],
118
+ "writer": "src/engine/ioc-plan.ts:537"
119
+ },
120
+ {
121
+ "id": "mcu.ip_index",
122
+ "entity": "mcu",
123
+ "key": "Mcu.IP{index}",
124
+ "valueKind": "index",
125
+ "valueNote": "外设实例名(USART1、NVIC、RCC…)。索引 0..IPNb-1 连续。",
126
+ "trigger": "启用/删除外设时按实有槽位重算;新外设追加到末尾(取值顺序 = CubeMX 内部遍历序,见 jar.md U1)。",
127
+ "order": "index",
128
+ "evidence": [
129
+ "jar.md:73-74",
130
+ "语料 4,686 行/504 文件,索引连续 502/504"
131
+ ],
132
+ "writer": "src/engine/ioc-plan.ts:873"
133
+ },
134
+ {
135
+ "id": "mcu.ip_nb",
136
+ "entity": "mcu",
137
+ "key": "Mcu.IPNb",
138
+ "valueKind": "count",
139
+ "valueNote": "Mcu.IP<i> 条数。",
140
+ "trigger": "与 Mcu.IP<i> 同进同退;漏写会让 CubeMX 只认前 N 个外设。",
141
+ "order": "dictionary",
142
+ "evidence": [
143
+ "jar.md:73-74",
144
+ "语料 504/504"
145
+ ],
146
+ "writer": "src/engine/ioc-plan.ts:876"
147
+ },
148
+ {
149
+ "id": "pin.signal",
150
+ "entity": "pin",
151
+ "key": "{pin}.Signal",
152
+ "valueKind": "enum",
153
+ "valueNote": "信号名:GPIO_Input / GPIO_Output / <IP>_<信号> / 共享信号的规范化名(S_TIM2_CH1_ETR、ADCx_IN1)/ EXTI 用 GPXTI<线号>。",
154
+ "trigger": "凡配了这根脚就写;无信号的脚只写 .Locked 就 return(jar.md:21)。",
155
+ "order": "dictionary",
156
+ "evidence": [
157
+ "jar.md:165-168",
158
+ "语料 29,521 脚实例 100%"
159
+ ],
160
+ "writer": "src/engine/ioc-plan.ts:611"
161
+ },
162
+ {
163
+ "id": "pin.mode",
164
+ "entity": "pin",
165
+ "key": "{pin}.Mode",
166
+ "valueKind": "enum",
167
+ "valueNote": "复用模式名(Asynchronous、Serial_Wire、PWM Generation1 CH1…)。",
168
+ "trigger": "仅多模式外设且该脚有模式时写;共享信号脚(TIM/ADC)与 EXTI 脚不写(功能由 SH 块 / GPIO_ModeDefaultEXTI 表达),GPIO 单模式脚不写。",
169
+ "order": "dictionary",
170
+ "evidence": [
171
+ "jar.md:165-168",
172
+ "语料 9,885 脚 = 33.5%",
173
+ "真机 2026-11-02:EXTI 脚回写无 .Mode"
174
+ ],
175
+ "writer": "src/engine/ioc-plan.ts:903"
176
+ },
177
+ {
178
+ "id": "pin.locked",
179
+ "entity": "pin",
180
+ "key": "{pin}.Locked",
181
+ "valueKind": "bool",
182
+ "valueNote": "字符串 true。",
183
+ "trigger": "凡配了这根脚就恒写 true;语料里 Locked=false 出现 0 次。",
184
+ "order": "dictionary",
185
+ "evidence": [
186
+ "jar.md:164",
187
+ "语料 27,304 脚 = 92.4%(24,990 true / 0 false)"
188
+ ],
189
+ "writer": "src/engine/ioc-plan.ts:610"
190
+ },
191
+ {
192
+ "id": "pin.gpio_parameters",
193
+ "entity": "pin",
194
+ "key": "{pin}.GPIOParameters",
195
+ "valueKind": "csv",
196
+ "valueNote": "该脚实际写了的 GPIO 属性名列表,顺序 Speed→PinState→PuPd→Label→ModeDefault*→Mode。",
197
+ "trigger": "只在有属性时写;一个属性都没有就删键。写在脚上的 GPIO_* 属性必须列进这里,否则 CubeMX 静默删掉(R22)。",
198
+ "order": "dictionary",
199
+ "evidence": [
200
+ "jar.md:170-171",
201
+ "语料 24,571 脚 = 83.2%",
202
+ "真机 2026-11-02:回写时顺序被 CubeMX 重排成上面那条",
203
+ "266 份 6.x 语料 11,808 条两两先后统计(0 反例)"
204
+ ],
205
+ "writer": "src/engine/ioc-plan.ts:604",
206
+ "rules": [
207
+ "R22"
208
+ ]
209
+ },
210
+ {
211
+ "id": "pin.gpio_label",
212
+ "entity": "pin",
213
+ "key": "{pin}.GPIO_Label",
214
+ "valueKind": "text",
215
+ "valueNote": "用户标签(生成 C 宏 LED_Pin)。",
216
+ "trigger": "给了标签才写;重名会被拦。",
217
+ "order": "dictionary",
218
+ "evidence": [
219
+ "jar.md:170",
220
+ "语料 14,357 次(最常见属性)"
221
+ ],
222
+ "writer": "src/engine/ioc-plan.ts:607"
223
+ },
224
+ {
225
+ "id": "pin.gpio_pupd",
226
+ "entity": "pin",
227
+ "key": "{pin}.GPIO_PuPd",
228
+ "valueKind": "enum",
229
+ "valueNote": "GPIO_NOPULL / GPIO_PULLUP / GPIO_PULLDOWN。",
230
+ "trigger": "非默认(none)才写。",
231
+ "order": "dictionary",
232
+ "evidence": [
233
+ "jar.md:170",
234
+ "语料 4,795 例 = 16.2%"
235
+ ],
236
+ "writer": "src/engine/ioc-plan.ts:607"
237
+ },
238
+ {
239
+ "id": "pin.gpio_speed",
240
+ "entity": "pin",
241
+ "key": "{pin}.GPIO_Speed",
242
+ "valueKind": "enum",
243
+ "valueNote": "GPIO_SPEED_FREQ_LOW/MEDIUM/HIGH。",
244
+ "trigger": "非默认(low)才写。",
245
+ "order": "dictionary",
246
+ "evidence": [
247
+ "jar.md:170",
248
+ "语料 4,114 例 = 13.9%"
249
+ ],
250
+ "writer": "src/engine/ioc-plan.ts:607"
251
+ },
252
+ {
253
+ "id": "pin.pin_state",
254
+ "entity": "pin",
255
+ "key": "{pin}.PinState",
256
+ "valueKind": "enum",
257
+ "valueNote": "GPIO_PIN_SET / GPIO_PIN_RESET。",
258
+ "trigger": "只在显式 initial=high 时写(默认低不写);CubeMX 不规范化这两个 token。",
259
+ "order": "dictionary",
260
+ "evidence": [
261
+ "语料 GPIO_PIN_SET 161 / GPIO_PIN_RESET 36",
262
+ "真机 2026-11-02:两个 token 都逐字保留"
263
+ ],
264
+ "writer": "src/engine/ioc-plan.ts:607"
265
+ },
266
+ {
267
+ "id": "pin.gpio_mode",
268
+ "entity": "pin",
269
+ "key": "{pin}.GPIO_Mode",
270
+ "valueKind": "enum",
271
+ "valueNote": "GPIO_MODE_INPUT / OUTPUT_PP / OUTPUT_OD / AF_PP / AF_OD / ANALOG / ANALOG_ADC_CONTROL。",
272
+ "trigger": "非默认才写:输出默认推挽、输入默认不写(CubeMX 也不给输入脚补 INPUT)、AF 默认不写;开漏输出写 OUTPUT_OD。",
273
+ "order": "dictionary",
274
+ "evidence": [
275
+ "语料 6 个 token;2,657 输出脚里 OUTPUT_PP 116、OUTPUT_OD 0 命中",
276
+ "真机 2026-11-02:GPIO_MODE_OUTPUT_OD 逐字保留"
277
+ ],
278
+ "writer": "src/engine/ioc-plan.ts:607",
279
+ "rules": [
280
+ "R22"
281
+ ]
282
+ },
283
+ {
284
+ "id": "pin.gpio_mode_default_exti",
285
+ "entity": "pin",
286
+ "key": "{pin}.GPIO_ModeDefaultEXTI",
287
+ "valueKind": "enum",
288
+ "valueNote": "GPIO_MODE_IT_RISING / GPIO_MODE_IT_FALLING / GPIO_MODE_IT_RISING_FALLING(语料只有这三个 token)。",
289
+ "trigger": "配了 EXTI 才写,并同时进 GPIOParameters;缺它 CubeMX 不认这根脚的 EXTI(R23)。",
290
+ "order": "dictionary",
291
+ "evidence": [
292
+ "语料 GPIO_ModeDefaultEXTI 318 次",
293
+ "真机 2026-11-02:EXTI 四件套逐字保留"
294
+ ],
295
+ "writer": "src/engine/ioc-plan.ts:596",
296
+ "rules": [
297
+ "R22",
298
+ "R23"
299
+ ]
300
+ },
301
+ {
302
+ "id": "pin.gpio_mode_default_pp",
303
+ "entity": "pin",
304
+ "key": "{pin}.GPIO_ModeDefaultPP",
305
+ "valueKind": "enum",
306
+ "valueNote": "多模式引脚的上电默认模式。",
307
+ "trigger": "我们不写(CubeMX 需要时自己写);语料 90 次。",
308
+ "order": "dictionary",
309
+ "evidence": [
310
+ "语料 90 次"
311
+ ],
312
+ "writer": null
313
+ },
314
+ {
315
+ "id": "pin.gpio_mode_default_output_pp",
316
+ "entity": "pin",
317
+ "key": "{pin}.GPIO_ModeDefaultOutputPP",
318
+ "valueKind": "enum",
319
+ "valueNote": "输出脚的默认模式。",
320
+ "trigger": "我们不写;语料 418 次。",
321
+ "order": "dictionary",
322
+ "evidence": [
323
+ "语料 418 次"
324
+ ],
325
+ "writer": null
326
+ },
327
+ {
328
+ "id": "pin.pin_attribute",
329
+ "entity": "pin",
330
+ "key": "{pin}.PinAttribute",
331
+ "valueKind": "text",
332
+ "valueNote": "引脚属性标记字符串。",
333
+ "trigger": "我们不写;语料 4,763 次。",
334
+ "order": "dictionary",
335
+ "evidence": [
336
+ "语料 4,763 次"
337
+ ],
338
+ "writer": null
339
+ },
340
+ {
341
+ "id": "shared_signal.slot",
342
+ "entity": "shared-signal",
343
+ "key": "SH.{signal}.{n}",
344
+ "valueKind": "csv",
345
+ "valueNote": "<IP 信号>,<IP 模式> 两段(如 TIM2_CH1,PWM Generation1 CH1)。",
346
+ "trigger": "每有一个「这根脚做这个外设的这个功能」占一个槽位;同值不重复写。缺整个 SH 块时 CubeMX 静默丢弃 TIM/ADC(R6)。",
347
+ "order": "index",
348
+ "evidence": [
349
+ "jar.md:181-182",
350
+ "语料 16,921 键/419 文件/695 子键",
351
+ "2026-10-31 实测:缺 SH 块时 TIM3/ADC1 全被丢"
352
+ ],
353
+ "writer": "src/engine/ioc-plan.ts:750",
354
+ "rules": [
355
+ "R6"
356
+ ]
357
+ },
358
+ {
359
+ "id": "shared_signal.conf_nb",
360
+ "entity": "shared-signal",
361
+ "key": "SH.{signal}.ConfNb",
362
+ "valueKind": "count",
363
+ "valueNote": "该共享信号的槽位条数。",
364
+ "trigger": "与槽位同进同退;和实际槽位数不符时 R6 告警。",
365
+ "order": "dictionary",
366
+ "evidence": [
367
+ "jar.md:181-182",
368
+ "语料 16,921 键/419 文件"
369
+ ],
370
+ "writer": "src/engine/ioc-plan.ts:751",
371
+ "rules": [
372
+ "R6"
373
+ ]
374
+ },
375
+ {
376
+ "id": "nvic.vector",
377
+ "entity": "nvic",
378
+ "key": "NVIC.{name}_IRQn",
379
+ "valueKind": "nvic9",
380
+ "valueNote": "9 段冒号值:Enabled:Preempt:Sub:Configurable:System:IrqHandlerGenerated:…(DMA 通道那串第 7 段是 false)。",
381
+ "trigger": "interrupts 参数 / pins 的 interrupt(按线号选组)/ DMA 通道自动补;已有值且未显式给优先级时保留原值。段数不对 R3 告警,名字不在 SVD 里 R20 告警。",
382
+ "order": "dictionary",
383
+ "evidence": [
384
+ "jar.md:137-149",
385
+ "真机 2026-11-02:NVIC.USART1_IRQn / NVIC.EXTI9_5_IRQn 逐字保留、0 added"
386
+ ],
387
+ "writer": "src/engine/ioc-plan.ts:617",
388
+ "rules": [
389
+ "R3",
390
+ "R20"
391
+ ]
392
+ },
393
+ {
394
+ "id": "nvic.priority_group",
395
+ "entity": "nvic",
396
+ "key": "NVIC.PriorityGroup",
397
+ "valueKind": "enum",
398
+ "valueNote": "NVIC_PRIORITYGROUP_0..4。",
399
+ "trigger": "CubeMX 恒写;我们不写(模板里带)。",
400
+ "order": "dictionary",
401
+ "evidence": [
402
+ "jar.md:128"
403
+ ],
404
+ "writer": null
405
+ },
406
+ {
407
+ "id": "nvic.force_enable_dma_vector",
408
+ "entity": "nvic",
409
+ "key": "NVIC.ForceEnableDMAVector",
410
+ "valueKind": "bool",
411
+ "valueNote": "true / false。",
412
+ "trigger": "CubeMX 恒写;我们不写。",
413
+ "order": "dictionary",
414
+ "evidence": [
415
+ "jar.md:133"
416
+ ],
417
+ "writer": null
418
+ },
419
+ {
420
+ "id": "nvic.time_base",
421
+ "entity": "nvic",
422
+ "key": "NVIC.TimeBase",
423
+ "valueKind": "text",
424
+ "valueNote": "时基用的向量名或 None。",
425
+ "trigger": "CubeMX 恒写;我们不写。",
426
+ "order": "dictionary",
427
+ "evidence": [
428
+ "jar.md:129"
429
+ ],
430
+ "writer": null
431
+ },
432
+ {
433
+ "id": "dma.request_parameters",
434
+ "entity": "dma",
435
+ "key": "Dma.{ip}.{n}.RequestParameters",
436
+ "valueKind": "csv",
437
+ "valueNote": "该请求实际写了的参数名,顺序按 DMA_PARAM_ORDER 白名单(Instance,Direction,PeriphInc,MemInc,PeriphDataAlignment,MemDataAlignment,Mode,Priority[,FIFOMode])。",
438
+ "trigger": "有该请求的参数键才写;不在白名单里的字段会被静默忽略(R21)。",
439
+ "order": "insertion",
440
+ "evidence": [
441
+ "jar.md:157",
442
+ "语料 17 份含 DMA 的文件三件套齐全",
443
+ "richhal.ioc:30-32"
444
+ ],
445
+ "writer": "src/engine/ioc-plan.ts:948",
446
+ "rules": [
447
+ "R21"
448
+ ]
449
+ },
450
+ {
451
+ "id": "dma.request_group",
452
+ "entity": "dma",
453
+ "key": "Dma.{ip}.{n}.{name}",
454
+ "valueKind": "enum",
455
+ "valueNote": "实例名/方向/对齐/模式等原样值(DMA1_Channel1、DMA_PERIPH_TO_MEMORY…)。",
456
+ "trigger": "随预设 rawEntries 写;必须同时进 RequestParameters。",
457
+ "order": "dictionary",
458
+ "evidence": [
459
+ "jar.md:158"
460
+ ],
461
+ "writer": "src/engine/ioc-plan.ts:913",
462
+ "rules": [
463
+ "R21"
464
+ ]
465
+ },
466
+ {
467
+ "id": "dma.request_index",
468
+ "entity": "dma",
469
+ "key": "Dma.Request{n}",
470
+ "valueKind": "index",
471
+ "valueNote": "请求名 → 该请求所属 IP 名。",
472
+ "trigger": "有 DMA 请求就按序号重写;孤立计数(只有 RequestsNb)CubeMX 不认。",
473
+ "order": "index",
474
+ "evidence": [
475
+ "jar.md:156",
476
+ "语料 64/64 的 Dma.Request<i> 值等于同号实例名"
477
+ ],
478
+ "writer": "src/engine/ioc-plan.ts:949",
479
+ "rules": [
480
+ "R21"
481
+ ]
482
+ },
483
+ {
484
+ "id": "dma.requests_nb",
485
+ "entity": "dma",
486
+ "key": "Dma.RequestsNb",
487
+ "valueKind": "count",
488
+ "valueNote": "DMA 请求条数(base 是小写 Dma,不是 DMA)。",
489
+ "trigger": "与 Dma.Request<i> 同进同退。",
490
+ "order": "dictionary",
491
+ "evidence": [
492
+ "jar.md:155"
493
+ ],
494
+ "writer": "src/engine/ioc-plan.ts:959",
495
+ "rules": [
496
+ "R21"
497
+ ]
498
+ },
499
+ {
500
+ "id": "periph.ip_parameters",
501
+ "entity": "peripheral",
502
+ "key": "{ip}.IPParameters",
503
+ "valueKind": "csv",
504
+ "valueNote": "该外设实际写了的参数名,顺序 = 插入序(LinkedHashMap),不是字典序。",
505
+ "trigger": "参数计数 > 0 才写;不在名单里的参数键会被静默忽略(R7)。",
506
+ "order": "insertion",
507
+ "evidence": [
508
+ "jar.md:105",
509
+ "jar.md:108(语料有序 706 / 无序 681)"
510
+ ],
511
+ "writer": "src/engine/ioc-plan.ts:984",
512
+ "rules": [
513
+ "R7"
514
+ ]
515
+ },
516
+ {
517
+ "id": "periph.parameter",
518
+ "entity": "peripheral",
519
+ "key": "{ip}.{name}",
520
+ "valueKind": "text",
521
+ "valueNote": "参数值原样(db 里的枚举名/数值)。",
522
+ "trigger": "预设参数或用户显式指定;写一个参数就要进 IPParameters。",
523
+ "order": "dictionary",
524
+ "evidence": [
525
+ "jar.md:105"
526
+ ],
527
+ "writer": "src/engine/ioc-plan.ts:970",
528
+ "rules": [
529
+ "R7"
530
+ ]
531
+ },
532
+ {
533
+ "id": "periph.ip_parameters_without_check",
534
+ "entity": "peripheral",
535
+ "key": "{ip}.IPParametersWithoutCheck",
536
+ "valueKind": "csv",
537
+ "valueNote": "不做 db 校验的参数名单。",
538
+ "trigger": "我们不写(CubeMX 极少数情况写,非空才写)。",
539
+ "order": "insertion",
540
+ "evidence": [
541
+ "jar.md:106"
542
+ ],
543
+ "writer": null
544
+ },
545
+ {
546
+ "id": "rcc.adc_presc",
547
+ "entity": "rcc",
548
+ "key": "RCC.ADCPresc",
549
+ "valueKind": "enum",
550
+ "valueNote": "RCC_ADCPCLK2_DIV2/4/6/8。",
551
+ "trigger": "ADC 预设写(F1 上 R5 要求 DIV6);必须同步 ADCFreqValue。",
552
+ "order": "dictionary",
553
+ "evidence": [
554
+ "语料 4 份带 ADCPresc 的文件 4/4 满足 ADCFreqValue == APB2/分频"
555
+ ],
556
+ "writer": "src/data/ioc-presets.ts",
557
+ "rules": [
558
+ "R5"
559
+ ]
560
+ },
561
+ {
562
+ "id": "rcc.adc_freq",
563
+ "entity": "rcc",
564
+ "key": "RCC.ADCFreqValue",
565
+ "valueKind": "hz",
566
+ "valueNote": "ADC 时钟(Hz 十进制)= APB2 / ADCPresc。",
567
+ "trigger": "改了 ADCPresc 就必须重算;否则 .ioc 自相矛盾(÷6 却写着 ÷2 的 36 MHz)。",
568
+ "order": "dictionary",
569
+ "evidence": [
570
+ "语料 4/4 满足该不变量",
571
+ "§59 真机:RCC.ADCFreqValue=12000000 被保留"
572
+ ],
573
+ "writer": "src/engine/ioc-plan.ts:1000",
574
+ "rules": [
575
+ "R5"
576
+ ]
577
+ },
578
+ {
579
+ "id": "rcc.ip_parameters",
580
+ "entity": "rcc",
581
+ "key": "RCC.IPParameters",
582
+ "valueKind": "csv",
583
+ "valueNote": "RCC 写过的键名列表,Collections.sort 之后(唯一一个排过序的 IPParameters)。",
584
+ "trigger": "有 RCC 键变化才重写;顺序错会被真机 diff 出来。",
585
+ "order": "sorted-members",
586
+ "evidence": [
587
+ "jar.md:118",
588
+ "jar.md:248(语料 429 有序 / 75 反例全为旧版板文件)"
589
+ ],
590
+ "writer": "src/engine/ioc-plan.ts:1009"
591
+ },
592
+ {
593
+ "id": "rcc.derived",
594
+ "entity": "rcc",
595
+ "key": "RCC.{member}",
596
+ "valueKind": "text",
597
+ "valueNote": "时钟树派生键(SYSCLKFreq_VALUE、PLLMUL、APB1Freq_Value…)。成员名是 [A-Za-z0-9_]+,取值由 RCC 树决定。",
598
+ "trigger": "由 clock-plan.ts 按 RCC 树逐项重算;这里兜住全部成员名,避免覆盖率检查把它们当未知键。S5 收尾把原来的 {*} 全通配收成 {member}:既能渲染键名(renderIocKey 现在拼得出 RCC.SYSCLKFreq_VALUE),也把「RCC.」这个命名空间本身钉住(RCCF.X 不再命中)。",
599
+ "order": "dictionary",
600
+ "evidence": [
601
+ "jar.md:118-121(RCCService 自己写)",
602
+ "§59 真机:派生频率被同步重算"
603
+ ],
604
+ "writer": "src/engine/clock-plan.ts"
605
+ },
606
+ {
607
+ "id": "project.functionlistsort",
608
+ "entity": "project",
609
+ "key": "ProjectManager.functionlistsort",
610
+ "valueKind": "csv",
611
+ "valueNote": "生成时按序调用的初始化清单:序号-MX_xxx_Init-IP-<bool>-HAL-<bool>。",
612
+ "trigger": "我们故意不写:CubeMX 保存时按既有编号自己追加,且每个外设的函数名后缀不统一(USART1→MX_USART1_UART_Init,TIM2→MX_TIM2_Init),猜错会把生成顺序写坏。ioc_verify 把它单独归到 autoAddedFunctions。",
613
+ "order": "sequence",
614
+ "evidence": [
615
+ "jar.md:212",
616
+ "真机 2026-11-02 两轮:只追加 1 条、格式正确"
617
+ ],
618
+ "writer": null
619
+ },
620
+ {
621
+ "id": "project.manager_key",
622
+ "entity": "project",
623
+ "key": "ProjectManager.{name}",
624
+ "valueKind": "text",
625
+ "valueNote": "工程管理项:ProjectName、TargetToolchain、KeepUserCode、HeapSize、MainLocation、DeviceId…(成员名就是 CubeMX 的字段名)。",
626
+ "trigger": "我们不写(只在 apply 前读 ProjectManager.KeepUserCode 做安全闸);CubeMX 每次保存都会写一整组。以前这些键被 {ip}.{name} 兜成 periph.parameter,等于把工程配置误记成外设参数——分出来之后,{ip}.{name} 命中时才能按「是不是真外设」判拼错。",
627
+ "order": "dictionary",
628
+ "evidence": [
629
+ "语料 65 行 / 2 份 board 级文件(34 个不同成员)",
630
+ "demo.ioc 41 个 ProjectManager.* 键(真工程文件里的主导形态)"
631
+ ],
632
+ "writer": null
633
+ },
634
+ {
635
+ "id": "project.mxcube_version",
636
+ "entity": "project",
637
+ "key": "MxCube.Version",
638
+ "valueKind": "text",
639
+ "valueNote": "写这份 .ioc 的 CubeMX 版本(6.15.0)。",
640
+ "trigger": "我们不改(改了等于伪造版本,会影响 CubeMX 的兼容分支)。",
641
+ "order": "dictionary",
642
+ "evidence": [
643
+ "语料 504 份均带(4.5.0 … 4.21.0)"
644
+ ],
645
+ "writer": null
646
+ },
647
+ {
648
+ "id": "project.keep_user_placement",
649
+ "entity": "project",
650
+ "key": "KeepUserPlacement",
651
+ "valueKind": "bool",
652
+ "valueNote": "生成时是否保留用户代码区(true/false)。",
653
+ "trigger": "CubeMX 恒写;我们不写(模板自带)。",
654
+ "order": "dictionary",
655
+ "evidence": [
656
+ "语料 504/504 均带",
657
+ "demo.ioc:2"
658
+ ],
659
+ "writer": null
660
+ },
661
+ {
662
+ "id": "project.board_ioc",
663
+ "entity": "project",
664
+ "key": "boardIOC",
665
+ "valueKind": "bool",
666
+ "valueNote": "这份 .ioc 是从板级配置导入的(true/false)。",
667
+ "trigger": "CubeMX 恒写;我们不写。",
668
+ "order": "dictionary",
669
+ "evidence": [
670
+ "语料 504/504 均带"
671
+ ],
672
+ "writer": null
673
+ },
674
+ {
675
+ "id": "project.board_name",
676
+ "entity": "project",
677
+ "key": "board",
678
+ "valueKind": "text",
679
+ "valueNote": "板名(NUCLEO-F030R8)或 custom。",
680
+ "trigger": "CubeMX 恒写;我们不写。",
681
+ "order": "dictionary",
682
+ "evidence": [
683
+ "语料 501/504"
684
+ ],
685
+ "writer": null
686
+ },
687
+ {
688
+ "id": "project.bsp_ip_name",
689
+ "entity": "project",
690
+ "key": "BSP_IP_NAME",
691
+ "valueKind": "text",
692
+ "valueNote": "BSP 组件名(只有板级配置带)。",
693
+ "trigger": "我们不写。",
694
+ "order": "dictionary",
695
+ "evidence": [
696
+ "语料 65/504"
697
+ ],
698
+ "writer": null
699
+ },
700
+ {
701
+ "id": "project.mmt_app_regions",
702
+ "entity": "project",
703
+ "key": "MMTAppRegionsCount",
704
+ "valueKind": "count",
705
+ "valueNote": "内存映射表(MMT)分区数(只有部分高端型号带)。",
706
+ "trigger": "我们不写。",
707
+ "order": "dictionary",
708
+ "evidence": [
709
+ "语料 26/504"
710
+ ],
711
+ "writer": null
712
+ },
713
+ {
714
+ "id": "project.mmt_applied",
715
+ "entity": "project",
716
+ "key": "MMTConfigApplied",
717
+ "valueKind": "bool",
718
+ "valueNote": "是否应用了 MMT 配置。",
719
+ "trigger": "我们不写。",
720
+ "order": "dictionary",
721
+ "evidence": [
722
+ "语料 26/504"
723
+ ],
724
+ "writer": null
725
+ },
726
+ {
727
+ "id": "pin.context_owner",
728
+ "entity": "pin",
729
+ "key": "{pin}.ContextOwner",
730
+ "valueKind": "text",
731
+ "valueNote": "引脚上下文归属(只有板级 BSP 配置带,如 PB4(NJRST).ContextOwner)。",
732
+ "trigger": "我们不写。",
733
+ "order": "dictionary",
734
+ "evidence": [
735
+ "语料 3 例(PB4(NJRST) / PH3-BOOT0)"
736
+ ],
737
+ "writer": null
738
+ }
739
+ ];
740
+ /** 占位符 → 正则片段。{*} 是 catch-all,不取参。 */
741
+ const PLACEHOLDER_PATTERN = {
742
+ pin: ".+?",
743
+ index: "\\d+",
744
+ ip: "[A-Za-z0-9_]+",
745
+ name: ".+?",
746
+ n: "\\d+",
747
+ signal: ".+?",
748
+ member: "[A-Za-z0-9_]+",
749
+ "*": ".*",
750
+ };
751
+ /** 正则里有特殊含义的字符(用于把模板里的字面量转义成安全的正则片段)。 */
752
+ const REGEX_SPECIALS = ".*+?^$()[]{}|\\";
753
+ function escapeRegexLiteral(text) {
754
+ let out = "";
755
+ for (const ch of text) {
756
+ out += REGEX_SPECIALS.includes(ch) ? "\\" + ch : ch;
757
+ }
758
+ return out;
759
+ }
760
+ function placeholderRegex() {
761
+ return /\{([a-z*]+)\}/gu;
762
+ }
763
+ /** 把键模板编译成锚定正则 + 占位符顺序。 */
764
+ export function compileIocKeyTemplate(template) {
765
+ const names = [];
766
+ let pattern = "";
767
+ let cursor = 0;
768
+ const re = placeholderRegex();
769
+ for (let m = re.exec(template); m !== null; m = re.exec(template)) {
770
+ pattern += escapeRegexLiteral(template.slice(cursor, m.index));
771
+ const token = m[1] ?? "";
772
+ const fragment = PLACEHOLDER_PATTERN[token];
773
+ if (fragment === undefined) {
774
+ throw new Error("ioc-schema: 未知占位符 " + m[0] + " in " + template);
775
+ }
776
+ if (token === "*") {
777
+ pattern += fragment;
778
+ }
779
+ else {
780
+ pattern += "(" + fragment + ")";
781
+ names.push(token);
782
+ }
783
+ cursor = m.index + m[0].length;
784
+ }
785
+ pattern += escapeRegexLiteral(template.slice(cursor));
786
+ return { regex: new RegExp("^" + pattern + "$", "u"), names };
787
+ }
788
+ /** 模板里固定字面量的字符数(占位符与花括号都不算)——字面量越多,模板越具体。 */
789
+ function literalWeight(template) {
790
+ return template.replace(/\{[a-z*]+\}/gu, "").length;
791
+ }
792
+ /**
793
+ * 匹配优先级:三条一起决定谁先匹配,避免宽模板抢走具体键。
794
+ *
795
+ * 0. 以字面量开头、没有 catch-all(Mcu.Pin{index} / NVIC.{name}_IRQn / {pin}.Signal 之外的都算)
796
+ * 1. 以字面量开头、带 catch-all 的命名空间兜底(RCC.{*})
797
+ * 2. 以占位符开头的通配模板({ip}.{name} / {pin}.Signal / {ip}.IPParameters)
798
+ *
799
+ * 同级再按字面量长度降序:RCC.IPParameters(16) 要压住 {ip}.IPParameters(13),
800
+ * 而 USART1.IPParameters 匹配不上 RCC.IPParameters,自然落到 {ip}.IPParameters。
801
+ */
802
+ function specMatchRank(spec) {
803
+ const startsWithPlaceholder = spec.key.startsWith("{");
804
+ if (!startsWithPlaceholder)
805
+ return spec.key.includes("{*}") ? 1 : 0;
806
+ return 2;
807
+ }
808
+ const COMPILED = SPECS
809
+ .map((spec, tableIndex) => ({ spec, tableIndex, compiled: compileIocKeyTemplate(spec.key) }))
810
+ .sort((a, b) => specMatchRank(a.spec) - specMatchRank(b.spec) ||
811
+ literalWeight(b.spec.key) - literalWeight(a.spec.key) ||
812
+ a.tableIndex - b.tableIndex)
813
+ .map((entry) => ({ spec: entry.spec, compiled: entry.compiled }));
814
+ /** 真值表(对外只读别名)。 */
815
+ export const IOC_SCHEMA = SPECS;
816
+ export function iocSpecById(id) {
817
+ return SPECS.find((spec) => spec.id === id) ?? null;
818
+ }
819
+ /** 按表内顺序做首次匹配;未登记返回 null。 */
820
+ export function matchIocKey(key) {
821
+ for (const entry of COMPILED) {
822
+ const hit = entry.compiled.regex.exec(key);
823
+ if (hit === null)
824
+ continue;
825
+ const params = {};
826
+ entry.compiled.names.forEach((name, i) => {
827
+ params[name] = hit[i + 1] ?? "";
828
+ });
829
+ return { spec: entry.spec, params };
830
+ }
831
+ return null;
832
+ }
833
+ /** 生成器写键名的唯一入口:按 spec id + 占位符值渲染。参数缺失/多余都抛错(防止拼错键名)。 */
834
+ export function renderIocKey(id, params = {}) {
835
+ const spec = iocSpecById(id);
836
+ if (spec === null)
837
+ throw new Error("ioc-schema: 未知 spec id " + id);
838
+ if (spec.key.includes("{*}")) {
839
+ throw new Error("ioc-schema: " + id + " 是 catch-all 模板,只用于识别(matchIocKey),不能用来渲染键名");
840
+ }
841
+ const used = new Set();
842
+ const rendered = spec.key.replace(placeholderRegex(), (_all, token) => {
843
+ if (token === "*")
844
+ return "";
845
+ const value = params[token];
846
+ if (value === undefined) {
847
+ throw new Error("ioc-schema: " + id + " 缺少占位符 {" + token + "} 的值");
848
+ }
849
+ used.add(token);
850
+ return String(value);
851
+ });
852
+ for (const name of Object.keys(params)) {
853
+ if (!used.has(name))
854
+ throw new Error("ioc-schema: " + id + " 不接受占位符 {" + name + "}");
855
+ }
856
+ return rendered;
857
+ }
858
+ /** 这些占位符填的是自由文本(任意字符),填什么都能匹配上。 */
859
+ const FREE_FORM_PLACEHOLDERS = ["pin", "name", "signal"];
860
+ const TIER_CACHE = new Map();
861
+ /** 由键模板形状推导命中强度(纯函数,结果按 spec id 缓存)。 */
862
+ export function iocKeyTier(spec) {
863
+ const cached = TIER_CACHE.get(spec.id);
864
+ if (cached !== undefined)
865
+ return cached;
866
+ const placeholders = [...spec.key.matchAll(placeholderRegex())].map((match) => match[1] ?? "");
867
+ let tier;
868
+ if (placeholders.length === 0) {
869
+ tier = "exact";
870
+ }
871
+ else if (placeholders.includes("*")) {
872
+ tier = "namespace";
873
+ }
874
+ else if (!placeholders.some((token) => FREE_FORM_PLACEHOLDERS.includes(token))) {
875
+ tier = "shape";
876
+ }
877
+ else {
878
+ // 自由文本占位符后面还有字面量({pin}.Signal 的 ".Signal"、NVIC.{name}_IRQn 的 "_IRQn")→ 属性/后缀被核对过。
879
+ const tail = spec.key.slice(spec.key.lastIndexOf("}") + 1);
880
+ tier = /[A-Za-z0-9_]/u.test(tail) ? "shape" : "namespace";
881
+ }
882
+ TIER_CACHE.set(spec.id, tier);
883
+ return tier;
884
+ }
885
+ /**
886
+ * 已知的「伪命名空间」:它们不是外设实例,但确实会以 `前缀.成员` 的形状出现。
887
+ * 目的是让 auditIocKeys 别把这些报成拼错。计数来自 504 份 board 级语料(键出现行数)。
888
+ */
889
+ export const IOC_NAMESPACE_PREFIXES = [
890
+ "ProjectManager", // 65 行 / 2 份(工程配置组;真工程 demo.ioc 里 41 个键)
891
+ "CAD", // 624 行 / 208 份(引脚分配图视图状态)
892
+ "File", // 504 份均带 File.Version
893
+ "MxDb", // 501 份均带 MxDb.Version
894
+ "PinOutPanel", // 501 份(RotationAngle / Zoom)
895
+ "GPIO", // 179 份(GPIO.groupedBy)
896
+ "Mcu", // 1376 行(Mcu.ThirdPartyNb / Mcu.UserConstants 等)
897
+ "STMicroelectronics", // 313 行(IDE 版本键)
898
+ "RCC", // 时钟树键的命名空间
899
+ "NVIC", // 中断控制器键的命名空间
900
+ "Dma", // DMA 键的命名空间
901
+ "SH", // 共享信号块
902
+ ];
903
+ /** 覆盖率检查:生成器实际产出的键里,有没有 schema 不认识的(按命中强度分层)。 */
904
+ export function iocSchemaCoverage(keys) {
905
+ const covered = [];
906
+ const strong = [];
907
+ const weak = [];
908
+ const uncovered = [];
909
+ const specIds = new Set();
910
+ for (const key of keys) {
911
+ const hit = matchIocKey(key);
912
+ if (hit === null) {
913
+ uncovered.push(key);
914
+ continue;
915
+ }
916
+ covered.push(key);
917
+ specIds.add(hit.spec.id);
918
+ if (iocKeyTier(hit.spec) === "namespace")
919
+ weak.push(key);
920
+ else
921
+ strong.push(key);
922
+ }
923
+ return { covered, strong, weak, uncovered, specIds: [...specIds] };
924
+ }
925
+ /** 人读描述:命中哪条 spec、占位符取值是什么。 */
926
+ export function describeIocKey(key) {
927
+ const hit = matchIocKey(key);
928
+ if (hit === null)
929
+ return key + " → 未登记";
930
+ const params = Object.entries(hit.params)
931
+ .map(([name, value]) => name + "=" + value)
932
+ .join(", ");
933
+ return key + " → " + hit.spec.id + (params === "" ? "" : " (" + params + ")");
934
+ }
935
+ /* ─────────────────────── namespace 级键的上下文审计 ───────────────────────
936
+ *
937
+ * 闸门第二道:光命中 {ip}.{name} 不算数,还要看占位符填进来的东西是不是真的存在。
938
+ * 三个判据都来自现场(.ioc 里的 Mcu.IP<i> 列表、本机 db 的引脚表与参数清单),不是猜:
939
+ * - ip 是已启用的外设实例 → 成员名必须在 db 给这个 IP 的 RefParameter 清单里(拼错 Baudrate 会被抓);
940
+ * - ip 是 db 里的引脚名 → 说明写的是「引脚属性」,但引脚属性必须逐条登记进表(否则 CubeMX 丢掉它);
941
+ * - ip 是已知伪命名空间(ProjectManager/CAD/…)→ 放行;
942
+ * - 三者都不是 → 「疑似拼错」,这是我们唯一能凭空判错的一类。 */
943
+ /**
944
+ * 这些前缀在 db 里是 IP 实例、但 CubeMX 从不把它们登记进 Mcu.IP<i>,键直接挂在伪命名空间下。
945
+ * 目前只有 GPIO:504 份板级 .ioc 里 Mcu.IPn=GPIO 出现 0 次,GPIO.groupedBy 实测只有
946
+ * "Group By Peripherals"(110) / "Show All"(8) 两种值。加新前缀前先给语料计数。
947
+ */
948
+ export const IOC_VIRTUAL_NAMESPACES = new Set(["GPIO"]);
949
+ function upperSet(values) {
950
+ const set = new Set();
951
+ for (const value of values ?? [])
952
+ set.add(value.trim().toUpperCase());
953
+ return set;
954
+ }
955
+ /**
956
+ * 参数名是否在 db 清单里。
957
+ * CubeMX 的部分参数是按实例/通道合成出来的(ADC 的 `Channel-0#ChannelRegularConversion`、
958
+ * `Rank-0#ChannelRegularConversion`、`SamplingTime-0#…`),db 的 <RefParameter> 只登记基名
959
+ * (`Channel`/`Rank`/`SamplingTime`)。所以先整体命中,再退一步判「-/# 之前的基名」命中。
960
+ */
961
+ function parameterNameKnown(name, names) {
962
+ if (names.includes(name))
963
+ return true;
964
+ const cut = name.search(/[-#]/u);
965
+ return cut > 0 && names.includes(name.slice(0, cut));
966
+ }
967
+ /** 逐键审计:形状命中 → 再看上下文。返回的 finding 顺序与输入一致(含 ok 项,便于测试断言)。 */
968
+ export function auditIocKeys(keys, context = {}) {
969
+ const instances = upperSet(context.instances);
970
+ const pins = upperSet(context.pins);
971
+ const dbInstances = upperSet(context.dbInstances);
972
+ const namespaces = upperSet([...IOC_NAMESPACE_PREFIXES, ...(context.namespaces ?? [])]);
973
+ const dmaParams = context.dmaParamNames === undefined ? null : new Set(context.dmaParamNames);
974
+ const findings = [];
975
+ for (const key of keys) {
976
+ const hit = matchIocKey(key);
977
+ if (hit === null) {
978
+ findings.push({ key, specId: "", tier: "none", verdict: "unregistered", detail: "真值表里没有这个键的形状" });
979
+ continue;
980
+ }
981
+ const tier = iocKeyTier(hit.spec);
982
+ const base = { key, specId: hit.spec.id, tier };
983
+ if (tier !== "namespace") {
984
+ findings.push({ ...base, verdict: "ok", detail: hit.spec.id });
985
+ continue;
986
+ }
987
+ if (hit.spec.id === "periph.parameter") {
988
+ const ip = (hit.params.ip ?? "").trim();
989
+ const name = hit.params.name ?? "";
990
+ const upper = ip.toUpperCase();
991
+ // GPIO 是"伪实例":db 里确实有 IP InstanceName="GPIO",但 CubeMX 从不把它写进 Mcu.IP<i>
992
+ // (504 份板级 .ioc 里 Mcu.IPn=GPIO 出现 0 次),它的 <pin>.GPIO_* 走引脚名、GPIO.groupedBy 走面板设置。
993
+ // 所以必须先判伪命名空间,否则会被判成"有实例但没启用",把一个合法键报成错误。
994
+ if (IOC_VIRTUAL_NAMESPACES.has(upper) && !instances.has(upper)) {
995
+ findings.push({ ...base, verdict: "ok", detail: ip + " 是面板/全局设置用的伪命名空间(CubeMX 不把它列进 Mcu.IP<i>)" });
996
+ continue;
997
+ }
998
+ if (instances.has(upper)) {
999
+ const names = context.paramNamesOf?.(upper) ?? null;
1000
+ if (names !== null && !parameterNameKnown(name, names)) {
1001
+ const head = name.search(/[-#]/u) > 0 ? name.slice(0, name.search(/[-#]/u)) : "";
1002
+ findings.push({
1003
+ ...base,
1004
+ verdict: "unknown-parameter",
1005
+ detail: ip + " 的 db 参数清单里没有 " + name +
1006
+ (head === "" ? "" : ",也没有基名 " + head) +
1007
+ "(CubeMX 只认清单里的参数,拼错的键会被静默丢弃)",
1008
+ });
1009
+ continue;
1010
+ }
1011
+ findings.push({ ...base, verdict: "ok", detail: ip + " 是已启用实例,参数 " + name + (names === null ? "(无 db 清单,未校验)" : ")") });
1012
+ continue;
1013
+ }
1014
+ if (dbInstances.has(upper)) {
1015
+ findings.push({
1016
+ ...base,
1017
+ verdict: "inactive-instance",
1018
+ detail: ip + " 在这颗芯片的 db 里有,但 Mcu.IP<i> 里没启用:这些参数键没有接收方,先启用外设(peripherals)",
1019
+ });
1020
+ continue;
1021
+ }
1022
+ if (pins.has(upper)) {
1023
+ findings.push({
1024
+ ...base,
1025
+ verdict: "pin-attribute",
1026
+ detail: ip + " 是引脚名," + name + " 是引脚属性;引脚属性必须逐条登记进真值表(否则 CubeMX 会丢掉它)",
1027
+ });
1028
+ continue;
1029
+ }
1030
+ if (namespaces.has(upper)) {
1031
+ findings.push({ ...base, verdict: "ok", detail: ip + " 是已知命名空间" });
1032
+ continue;
1033
+ }
1034
+ findings.push({
1035
+ ...base,
1036
+ verdict: "unknown-namespace",
1037
+ detail: ip + " 既不是已启用的外设实例,也不是 db 引脚名或已知命名空间",
1038
+ });
1039
+ continue;
1040
+ }
1041
+ if (hit.spec.id === "dma.request_group") {
1042
+ const ip = (hit.params.ip ?? "").trim();
1043
+ const name = hit.params.name ?? "";
1044
+ if (dmaParams !== null && !dmaParams.has(name)) {
1045
+ findings.push({
1046
+ ...base,
1047
+ verdict: "unknown-dma-parameter",
1048
+ detail: "Dma." + ip + " 的 " + name + " 不在 DMA 参数白名单里(写进去会被静默忽略)",
1049
+ });
1050
+ continue;
1051
+ }
1052
+ findings.push({ ...base, verdict: "ok", detail: "Dma." + ip + " 的参数 " + name });
1053
+ continue;
1054
+ }
1055
+ findings.push({ ...base, verdict: "ok", detail: hit.spec.id + "(命名空间级匹配,值未校验)" });
1056
+ }
1057
+ return findings;
1058
+ }