dsh-stm32 0.1.3 → 0.1.5

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 (231) hide show
  1. package/README.md +115 -43
  2. package/README_EN.md +106 -38
  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 +2639 -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 +1195 -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 +110 -42
  133. package/lib/commands/register.js +1 -1
  134. package/lib/data/chips.js +3 -3
  135. package/lib/data/clock-db.js +830 -0
  136. package/lib/data/clock-f1.js +12 -45
  137. package/lib/data/cmsis-sources.js +371 -18
  138. package/lib/data/db-presets.js +252 -0
  139. package/lib/data/device-facts.js +113 -26
  140. package/lib/data/family.js +515 -0
  141. package/lib/data/firmware-packages.js +595 -12
  142. package/lib/data/firmware-pins.js +128 -0
  143. package/lib/data/install-guides.js +2 -2
  144. package/lib/data/ioc-presets.js +248 -0
  145. package/lib/data/ioc-schema.js +1058 -0
  146. package/lib/data/rm-topics/stm32c0.json +227 -0
  147. package/lib/data/rm-topics.js +103 -0
  148. package/lib/data/search-roots.js +59 -4
  149. package/lib/data/serial-config.js +430 -0
  150. package/lib/data/stm32f1.js +15 -14
  151. package/lib/data/svd.js +32 -16
  152. package/lib/data/toolchain-config.js +0 -14
  153. package/lib/engine/assets.js +191 -456
  154. package/lib/engine/breakpoints.js +66 -11
  155. package/lib/engine/clock-derived.js +101 -0
  156. package/lib/engine/clock-direct.js +313 -0
  157. package/lib/engine/clock-plan.js +96 -52
  158. package/lib/engine/clock-pllmn.js +319 -0
  159. package/lib/engine/cmake-sources.js +67 -13
  160. package/lib/engine/cube-mx-guard.js +44 -0
  161. package/lib/engine/cube-programmer.js +137 -0
  162. package/lib/engine/cubemx-db.js +273 -0
  163. package/lib/engine/debug-session.js +423 -17
  164. package/lib/engine/debug.js +25 -6
  165. package/lib/engine/doctor.js +239 -19
  166. package/lib/engine/download.js +242 -0
  167. package/lib/engine/facts-acquire.js +416 -0
  168. package/lib/engine/facts.js +134 -0
  169. package/lib/engine/fetch.js +1 -1
  170. package/lib/engine/firmware-install.js +333 -39
  171. package/lib/engine/firmware-official.js +499 -0
  172. package/lib/engine/flash.js +290 -21
  173. package/lib/engine/gdb-mi.js +476 -0
  174. package/lib/engine/generate.js +9 -2
  175. package/lib/engine/hal-chip.js +124 -41
  176. package/lib/engine/ioc-plan.js +1244 -60
  177. package/lib/engine/ioc-rules.js +698 -0
  178. package/lib/engine/ioc-verify.js +706 -0
  179. package/lib/engine/ioc.js +43 -4
  180. package/lib/engine/msys2-install.js +241 -92
  181. package/lib/engine/probe-error.js +25 -6
  182. package/lib/engine/probe-session.js +50 -14
  183. package/lib/engine/probe.js +22 -5
  184. package/lib/engine/register-clock.js +41 -0
  185. package/lib/engine/register-gpio.js +132 -0
  186. package/lib/engine/register-linker.js +37 -13
  187. package/lib/engine/register-template.js +125 -40
  188. package/lib/engine/regs.js +41 -8
  189. package/lib/engine/rm-extract.js +144 -0
  190. package/lib/engine/rm-sources.js +360 -0
  191. package/lib/engine/rm-text.js +56 -0
  192. package/lib/engine/rtt.js +188 -30
  193. package/lib/engine/scaffold.js +185 -18
  194. package/lib/engine/serial.js +1692 -0
  195. package/lib/engine/tar.js +235 -3
  196. package/lib/engine/toolchain-gate.js +0 -4
  197. package/lib/engine/watch.js +227 -0
  198. package/lib/index.js +16 -2
  199. package/lib/skill/stm32-workflow.js +2 -2
  200. package/lib/tools/assets.js +39 -108
  201. package/lib/tools/cache.js +2 -2
  202. package/lib/tools/debug-session.js +2 -2
  203. package/lib/tools/doctor.js +61 -5
  204. package/lib/tools/download.js +303 -0
  205. package/lib/tools/firmware-install.js +31 -6
  206. package/lib/tools/flash.js +32 -4
  207. package/lib/tools/generate.js +22 -0
  208. package/lib/tools/ioc-inspect.js +1 -1
  209. package/lib/tools/ioc-plan.js +56 -2
  210. package/lib/tools/ioc-verify.js +237 -0
  211. package/lib/tools/project-create.js +41 -5
  212. package/lib/tools/regs.js +8 -8
  213. package/lib/tools/route-plan.js +1 -1
  214. package/lib/tools/rtt.js +157 -34
  215. package/lib/tools/serial.js +737 -0
  216. package/lib/tools/watch.js +256 -0
  217. package/package.json +5 -4
  218. package/templates/openocd/stm32c0x.cfg +83 -0
  219. package/templates/openocd/stm32u0x.cfg +64 -0
  220. package/templates/register/CMakeLists.txt +2 -2
  221. package/templates/register/Core/Inc/rtt.h +37 -2
  222. package/templates/register/Core/Src/main.c +17 -25
  223. package/templates/register/Core/Src/rtt.c +85 -9
  224. package/templates/scaffold/RTT.md +6 -2
  225. package/templates/scaffold/STM32F103XX_FLASH.ld +3 -0
  226. package/templates/scaffold/openocd.cfg +5 -3
  227. package/templates/scaffold/vscode/launch.json +8 -4
  228. package/templates/serial/bridge.ps1 +477 -0
  229. package/docs/development-notes.md +0 -2487
  230. package/docs/dsh-stm32-plugin-/350/247/204/346/240/274.md +0 -673
  231. package/docs/logic-audit.md +0 -607
@@ -0,0 +1,227 @@
1
+ {
2
+ "family": "stm32c0",
3
+ "lines": [
4
+ "STM32C011",
5
+ "STM32C031",
6
+ "STM32C051",
7
+ "STM32C071",
8
+ "STM32C091",
9
+ "STM32C092"
10
+ ],
11
+ "doc": {
12
+ "id": "RM0490",
13
+ "rev": "Rev 6",
14
+ "title": "RM0490: STM32C0 series advanced Arm-based 32-bit MCUs",
15
+ "lang": "en",
16
+ "pages": 1023
17
+ },
18
+ "topics": [
19
+ {
20
+ "id": "c0.boot.table",
21
+ "statement": "自举区域由 BOOT_LOCK / nBOOT1 / BOOT0 引脚 / nBOOT_SEL / nBOOT0 共同选择(RM0490 Rev 6 表 9,7 行组合)",
22
+ "page": 53,
23
+ "anchors": [
24
+ "select the boot area through the boot configuration pin BOOT0 and bits"
25
+ ],
26
+ "rows": [
27
+ [
28
+ "0",
29
+ "x",
30
+ "0",
31
+ "0",
32
+ "x",
33
+ "Main flash"
34
+ ],
35
+ [
36
+ "0",
37
+ "1",
38
+ "1",
39
+ "0",
40
+ "x",
41
+ "System memory"
42
+ ],
43
+ [
44
+ "0",
45
+ "0",
46
+ "1",
47
+ "0",
48
+ "x",
49
+ "Embedded SRAM"
50
+ ],
51
+ [
52
+ "0",
53
+ "x",
54
+ "x",
55
+ "1",
56
+ "1",
57
+ "Main flash"
58
+ ],
59
+ [
60
+ "0",
61
+ "1",
62
+ "x",
63
+ "1",
64
+ "0",
65
+ "System memory"
66
+ ],
67
+ [
68
+ "0",
69
+ "0",
70
+ "x",
71
+ "1",
72
+ "0",
73
+ "Embedded SRAM"
74
+ ],
75
+ [
76
+ "1",
77
+ "x",
78
+ "x",
79
+ "x",
80
+ "x",
81
+ "Main flash memory"
82
+ ]
83
+ ],
84
+ "svd": [
85
+ {
86
+ "reg": "FLASH_OPTR",
87
+ "field": "nBOOT_SEL",
88
+ "bitOffset": 24
89
+ },
90
+ {
91
+ "reg": "FLASH_OPTR",
92
+ "field": "nBOOT1",
93
+ "bitOffset": 25
94
+ },
95
+ {
96
+ "reg": "FLASH_OPTR",
97
+ "field": "nBOOT0",
98
+ "bitOffset": 26
99
+ },
100
+ {
101
+ "reg": "FLASH_SECR",
102
+ "field": "BOOT_LOCK",
103
+ "bitOffset": 16
104
+ }
105
+ ]
106
+ },
107
+ {
108
+ "id": "c0.boot.latch",
109
+ "statement": "boot mode 配置在 reset 后锁存(latched after a reset);退出 Standby 时重新采样,Standby 期间要保持所需自举配置",
110
+ "page": 53,
111
+ "anchors": [
112
+ "boot mode configuration is latched after a reset",
113
+ "sampled when exiting Standby mode"
114
+ ]
115
+ },
116
+ {
117
+ "id": "c0.boot.nrst-sample",
118
+ "statement": "BOOT0 引脚采样发生在 NRST(外部复位)上升沿;PF2-NRST 引脚模式影响采样(p.54 Caution)",
119
+ "page": 54,
120
+ "anchors": [
121
+ "BOOT0 pin sampling is done on NRST (external reset) rising edge"
122
+ ]
123
+ },
124
+ {
125
+ "id": "c0.boot.empty",
126
+ "statement": "FLASH_ACR.EMPTY=1 时强制从系统存储器自举(表 9 脚注 1:Boot forced to system memory when EMPTY flag is set);首次编程若 EMPTY 未更新,复位后仍选系统存储器",
127
+ "page": 53,
128
+ "anchors": [
129
+ "EMPTY flag in the FLASH access control register (FLASH_ACR) is set"
130
+ ],
131
+ "svd": [
132
+ {
133
+ "reg": "FLASH_ACR",
134
+ "field": "EMPTY",
135
+ "bitOffset": 16
136
+ }
137
+ ]
138
+ },
139
+ {
140
+ "id": "c0.boot.swd",
141
+ "statement": "BOOT0 引脚与 SWD 时钟 SWCLK 共用同一 GPIO(C0 即 PA14);检测到调试器访问时硬件强制 BOOT0 低(从用户 Flash 自举)以保证 SWCLK 可用于调试,直到下一次上电",
142
+ "page": 53,
143
+ "anchors": [
144
+ "BOOT0 pin shares the same GPIO with serial wire clock (SWCLK)",
145
+ "hardware mechanism to force BOOT0 low"
146
+ ]
147
+ },
148
+ {
149
+ "id": "c0.bootloader.interface",
150
+ "statement": "嵌入式 bootloader 位于 system memory,串口为 USART / I2C / SPI(仅 C051/C071/C091/92)/ USB DFU(仅 C071)/ FDCAN(仅 C092),详见 AN2606",
151
+ "page": 54,
152
+ "anchors": [
153
+ "embedded bootloader is located in the system memory",
154
+ "application note AN2606"
155
+ ]
156
+ },
157
+ {
158
+ "id": "c0.bootlock",
159
+ "statement": "BOOT_LOCK(FLASH_SECR)置 1 强制从主 Flash 唯一入口自举,无视其余自举配置与 EMPTY;用于建立信任链(4.5.6)",
160
+ "page": 54,
161
+ "anchors": [
162
+ "Setting the BOOT_LOCK bit forces the boot from a unique entry point in the main flash memory"
163
+ ],
164
+ "svd": [
165
+ {
166
+ "reg": "FLASH_SECR",
167
+ "field": "BOOT_LOCK",
168
+ "bitOffset": 16,
169
+ "enums": [
170
+ "0x0",
171
+ "0x1"
172
+ ]
173
+ }
174
+ ]
175
+ },
176
+ {
177
+ "id": "c0.dbg.swen",
178
+ "statement": "FLASH_ACR.DBG_SWEN 由软件控制内核调试访问:0 关(敏感代码/可保护存储区场景)、1 开(4.5.5,Figure 4)",
179
+ "page": 75,
180
+ "anchors": [
181
+ "Disabling core debug access",
182
+ "DBG_SWEN = 0"
183
+ ],
184
+ "svd": [
185
+ {
186
+ "reg": "FLASH_ACR",
187
+ "field": "DBG_SWEN",
188
+ "bitOffset": 18,
189
+ "enums": [
190
+ "0x0",
191
+ "0x1"
192
+ ]
193
+ }
194
+ ]
195
+ },
196
+ {
197
+ "id": "c0.ob.program",
198
+ "statement": "选项字节编程:先清 FLASH_CR.OPTLOCK(含 LOCK 解锁序列),再向 FLASH_OPTKEYR 依次写 OPTKEY1=0x0819 2A3B、OPTKEY2=0x4C5D 6E7F;错序锁死到下次复位并触发总线错误/HardFault(4.4.2)",
199
+ "page": 67,
200
+ "anchors": [
201
+ "Write OPTKEY1 = 0x0819 2A3B of the FLASH option key register",
202
+ "Write OPTKEY2 = 0x4C5D 6E7F"
203
+ ]
204
+ },
205
+ {
206
+ "id": "c0.rdp.default",
207
+ "statement": "RDP[7:0]:0xAA=Level 0 不保护、0xCC=Level 2 全片保护、Other(除 0xAA/0xCC 的一切值)=Level 1(4.7.x FLASH_OPTR 位域)",
208
+ "page": 85,
209
+ "anchors": [
210
+ "0xAA: Level 0, read protection not active",
211
+ "0xCC: Level 2, chip read protection active",
212
+ "Other: Level 1, memories read protection active"
213
+ ],
214
+ "svd": [
215
+ {
216
+ "reg": "FLASH_OPTR",
217
+ "field": "RDP",
218
+ "bitOffset": 0,
219
+ "enums": [
220
+ "0xAA",
221
+ "0xCC"
222
+ ]
223
+ }
224
+ ]
225
+ }
226
+ ]
227
+ }
@@ -0,0 +1,103 @@
1
+ /**
2
+ * rm-topics(主题/锚点清单)的两层装载。
3
+ *
4
+ * 为什么要有「spec」这层:机器是阅卷人不是出题人——自动抽取必须有人(或踩过坑后的会话)
5
+ * 给出「要采信哪几条结论 + 在 RM 里逐字回查什么」,机器才能核验并落 semantics。
6
+ *
7
+ * 装载顺序(两层合并,同 id 用户赢):
8
+ * 1) 插件自带的族级 spec:lib/data/rm-topics/<族>.json(源在 src/data/rm-topics/,
9
+ * 随包发布;scripts/copy-data.mjs 负责进 lib)。
10
+ * 2) 用户芯片级 spec:<factsRoot>/topics/<族>/<线>.json——只覆盖手上这颗。
11
+ * 用户踩了坑(比如某条选项字节规则害得板子连不上),把「这条结论 + 回查锚点」
12
+ * 写成一份小 JSON 放进这里,这颗芯片下一次烧录前就必须过机检;没写过的其它
13
+ * 芯片不受影响(族级判据太粗,坑通常是芯片级的,见 2026-11-07 决定)。
14
+ *
15
+ * 判定「这颗芯片要不要过机检」= 合并后主题数 > 0。
16
+ */
17
+ import { existsSync, readFileSync } from "node:fs";
18
+ import { join } from "node:path";
19
+ import { fileURLToPath } from "node:url";
20
+ const EMPTY = { topics: [], lines: [], docId: "", origins: [], hasSpec: false };
21
+ function normalize(raw, fallbackLines) {
22
+ if (typeof raw !== "object" || raw === null)
23
+ return null;
24
+ const o = raw;
25
+ if (!Array.isArray(o.topics) || o.topics.length === 0)
26
+ return null;
27
+ const topics = o.topics.filter((x) => {
28
+ if (typeof x !== "object" || x === null)
29
+ return false;
30
+ const e = x;
31
+ return typeof e.id === "string" && Array.isArray(e.anchors) && e.anchors.length > 0;
32
+ });
33
+ if (topics.length === 0)
34
+ return null;
35
+ const lines = Array.isArray(o.lines) ? o.lines.map((x) => String(x).toUpperCase()) : fallbackLines;
36
+ const docId = typeof o.doc?.id === "string" ? o.doc.id : "";
37
+ return { topics, lines, docId };
38
+ }
39
+ function readJson(file) {
40
+ try {
41
+ return JSON.parse(readFileSync(file, "utf8"));
42
+ }
43
+ catch {
44
+ return null;
45
+ }
46
+ }
47
+ /**
48
+ * 插件自带族级 spec 的目录:lib/data/rm-topics/(JSON 不进 tsc,由
49
+ * scripts/copy-data.mjs 在 build 时复制;仓库里 lib/ 是入库的,装包侧也带)。
50
+ * 没有退回 src 的兜底:那条相对路径在插件真实安装位置(node_modules 深处)
51
+ * 基本不可能存在,留着只会把「没跑 copy-data」伪装成「清单在但读不到」。
52
+ */
53
+ export function bundledTopicsDir() {
54
+ return fileURLToPath(new URL("./rm-topics/", import.meta.url));
55
+ }
56
+ /** 用户芯片级 spec 的路径(暴露给用户/会话往里放)。 */
57
+ export function userTopicsPath(factsRoot, family, line) {
58
+ return join(factsRoot, "topics", family.toLowerCase(), line.toUpperCase() + ".json");
59
+ }
60
+ /**
61
+ * 两层合并装载。factsRoot 由调用方传入(engine/facts 的 factsRoot(env)),
62
+ * 本模块不 import engine——data 层保持无环。
63
+ */
64
+ export function loadRmTopics(family, line, factsRoot) {
65
+ const fam = family.toLowerCase();
66
+ const ln = line.toUpperCase();
67
+ const merged = new Map();
68
+ const lines = new Set();
69
+ const origins = [];
70
+ let docId = "";
71
+ const famFile = join(bundledTopicsDir(), fam + ".json");
72
+ if (existsSync(famFile)) {
73
+ const n = normalize(readJson(famFile), []);
74
+ if (n !== null) {
75
+ for (const tp of n.topics)
76
+ merged.set(tp.id, tp);
77
+ for (const l of n.lines)
78
+ lines.add(l);
79
+ docId = n.docId;
80
+ origins.push("bundled:" + famFile);
81
+ }
82
+ }
83
+ const userFile = userTopicsPath(factsRoot, fam, ln);
84
+ if (existsSync(userFile)) {
85
+ const n = normalize(readJson(userFile), [ln]);
86
+ if (n !== null) {
87
+ for (const tp of n.topics)
88
+ merged.set(tp.id, tp); // 同 id 用户赢
89
+ for (const l of n.lines)
90
+ lines.add(l);
91
+ if (docId === "")
92
+ docId = n.docId;
93
+ origins.push("user:" + userFile);
94
+ }
95
+ }
96
+ const topics = [...merged.values()];
97
+ if (topics.length === 0)
98
+ return EMPTY;
99
+ // 用户 spec 没写 lines 时只管自己这颗(fallbackLines 兜底);族级有 lines 尊重族级
100
+ if (lines.size === 0)
101
+ lines.add(ln);
102
+ return { topics, lines: [...lines].sort(), docId, origins, hasSpec: true };
103
+ }
@@ -14,6 +14,7 @@
14
14
  */
15
15
  import { execFileSync } from "node:child_process";
16
16
  import { existsSync, readdirSync } from "node:fs";
17
+ import { join } from "node:path";
17
18
  import { binDirsFromConfig, configReadingDisabled, cubeMxRootsFromConfig, readToolchainConfig } from "./toolchain-config.js";
18
19
  /**
19
20
  * 默认二进制目录:只放**任何 Windows 机器上都可能存在**的位置。
@@ -75,9 +76,15 @@ export function dedupePaths(paths) {
75
76
  export function looksLikeCubeMxRoot(dir, exists = existsSync) {
76
77
  return exists(dir + "/jre/bin/java.exe") && exists(dir + "/STM32CubeMX.exe");
77
78
  }
78
- /** 一个目录是不是能用的工具链 bin(至少有一个我们要的 exe)。 */
79
+ /**
80
+ * 一个目录是不是能用的工具链 bin(至少有一个我们要的 exe)。
81
+ *
82
+ * 不能只认 gcc/openocd/cmake:只补了 ninja 或 gdb 的 MSYS2(典型:先装 gcc,再单独补 gdb)
83
+ * 会被整目录漏掉,doctor 于是说「工具链没找到」。这里把 probe 的五项都算上。
84
+ */
79
85
  export function looksLikeBinDir(dir, exists = existsSync) {
80
- return ["arm-none-eabi-gcc.exe", "openocd.exe", "cmake.exe"].some((name) => exists(dir + "/" + name));
86
+ return ["arm-none-eabi-gcc.exe", "arm-none-eabi-gdb.exe", "gdb-multiarch.exe", "openocd.exe", "cmake.exe", "ninja.exe"]
87
+ .some((name) => exists(dir + "/" + name));
81
88
  }
82
89
  const MSYS_VARIANTS = ["ucrt64/bin", "mingw64/bin", "clang64/bin"];
83
90
  function msysBases(probe) {
@@ -101,6 +108,34 @@ export function discoverBinDirs(probe) {
101
108
  }
102
109
  return dedupePaths(found);
103
110
  }
111
+ /** CubeProgrammer CLI 在任何机器上的 Windows 默认安装位置(与 CubeMX 同风格:只放通用位置)。 */
112
+ export const DEFAULT_CUBE_PRG_BINS = [
113
+ "C:/Program Files/STMicroelectronics/STM32Cube/STM32CubeProgrammer/bin",
114
+ ];
115
+ /** 一个目录是不是 CubeProgrammer 的 bin:认它的 CLI 主程序(32 位子目录不算,本插件只在 64 位路径找)。 */
116
+ export function looksLikeCubePrgBin(dir, exists = existsSync) {
117
+ return exists(dir + "/STM32_Programmer_CLI.exe");
118
+ }
119
+ /** CubeProgrammer 安装散布在 ST 系目录旁边(CubeMX 的兄弟目录最常见),复用同一套 bases。 */
120
+ export function discoverCubePrgBins(probe) {
121
+ const found = [];
122
+ for (const base of cubeMxBases(probe)) {
123
+ const direct = base.replace(/\/+$/u, "") + "/STMicroelectronics/STM32Cube/STM32CubeProgrammer/bin";
124
+ if (looksLikeCubePrgBin(direct, probe.exists))
125
+ found.push(direct);
126
+ for (const child of probe.listDirs(base + "/STMicroelectronics/STM32Cube")) {
127
+ const bin = child + "/STM32CubeProgrammer/bin";
128
+ if (looksLikeCubePrgBin(bin, probe.exists))
129
+ found.push(bin);
130
+ }
131
+ }
132
+ for (const dir of probe.registryInstallDirs()) {
133
+ const normalized = normalizePathEntry(dir);
134
+ if (normalized !== "" && looksLikeCubePrgBin(normalized, probe.exists))
135
+ found.push(normalized);
136
+ }
137
+ return dedupePaths(found);
138
+ }
104
139
  function cubeMxBases(probe) {
105
140
  const bases = [];
106
141
  for (const drive of probe.driveRoots()) {
@@ -184,6 +219,13 @@ export function decodeRegistryText(value, label = "reg.exe 输出") {
184
219
  error: label + "既不是合法 UTF-8 也不是合法 GB18030(系统代码页可能不是中文/英文)",
185
220
  };
186
221
  }
222
+ /** 系统程序一律用绝对路径,避免当前目录里的同名 reg.exe 劫持查询(P1-6)。 */
223
+ function regExe() {
224
+ if (process.platform !== "win32")
225
+ return "reg.exe";
226
+ const root = process.env.SystemRoot || process.env.windir || "C:\\Windows";
227
+ return join(root, "System32", "reg.exe");
228
+ }
187
229
  /** 读注册表里 ST 记下的安装位置;没有这些键是最常见的情况,不算错误。 */
188
230
  function readRegistryInstallDirs() {
189
231
  if (process.platform !== "win32")
@@ -199,7 +241,7 @@ function readRegistryInstallDirs() {
199
241
  try {
200
242
  // 按 buffer 收:reg.exe 写的是系统代码页的字节(中文系统是 GBK),交给宿主按 UTF-8
201
243
  // 解会把中文安装路径变成乱码,existsSync 随后必然失败。
202
- const raw = execFileSync("reg.exe", ["query", entry.key, "/v", entry.value], {
244
+ const raw = execFileSync(regExe(), ["query", entry.key, "/v", entry.value], {
203
245
  encoding: "buffer",
204
246
  timeout: 4000,
205
247
  windowsHide: true,
@@ -267,6 +309,7 @@ export function discoverInstalls() {
267
309
  cached = {
268
310
  binDirs: discoverBinDirs(probe),
269
311
  cubeMxRoots: discoverCubeMxRoots(probe),
312
+ cubePrgBins: discoverCubePrgBins(probe),
270
313
  };
271
314
  }
272
315
  return cached;
@@ -339,11 +382,12 @@ export function resolveSearchConfig(env = process.env, overrides = {},
339
382
  discoveredOverride) {
340
383
  const binFromEnv = splitList(env["STM32_BIN_DIRS"]);
341
384
  const rootsFromEnv = splitList(env["STM32_CUBEMX_ROOT"]);
385
+ const prgFromEnv = splitList(env["STM32_CUBE_PRG_ROOT"]);
342
386
  const userConfig = configReadingDisabled(env) ? null : readToolchainConfig(env).config;
343
387
  const binFromConfig = binDirsFromConfig(userConfig);
344
388
  const rootsFromConfig = cubeMxRootsFromConfig(userConfig);
345
389
  const discovered = discoveryDisabled(env)
346
- ? { binDirs: [], cubeMxRoots: [] }
390
+ ? { binDirs: [], cubeMxRoots: [], cubePrgBins: [] }
347
391
  : (discoveredOverride ?? discoverInstalls());
348
392
  const binBase = overrides.binDirs
349
393
  ?? (binFromEnv.length > 0
@@ -353,8 +397,19 @@ discoveredOverride) {
353
397
  ?? (rootsFromEnv.length > 0
354
398
  ? rootsFromEnv
355
399
  : (rootsFromConfig.length > 0 ? rootsFromConfig : [...DEFAULT_CUBEMX_ROOTS]));
400
+ const prgBase = overrides.cubePrgBins
401
+ ?? (prgFromEnv.length > 0
402
+ ? prgFromEnv.map((dir) => {
403
+ const n = dir.replace(/\/+$/u, "");
404
+ if (looksLikeCubePrgBin(n))
405
+ return n;
406
+ const asBin = n + "/STM32CubeProgrammer/bin";
407
+ return looksLikeCubePrgBin(asBin) ? asBin : n; // 都没命中就原样保留(让 searchConfigWarnings 去报告不存在)
408
+ })
409
+ : [...DEFAULT_CUBE_PRG_BINS]);
356
410
  return {
357
411
  binDirs: dedupePaths([...binBase, ...(overrides.binDirs === undefined ? discovered.binDirs : [])]),
358
412
  cubeMxRoots: dedupePaths([...rootsBase, ...(overrides.cubeMxRoots === undefined ? discovered.cubeMxRoots : [])]),
413
+ cubePrgBins: dedupePaths([...prgBase, ...(overrides.cubePrgBins === undefined ? discovered.cubePrgBins ?? [] : [])]),
359
414
  };
360
415
  }