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
@@ -34,8 +34,8 @@ export const F1_PLL_SOURCES = [
34
34
  note: "F1 值料号的 PLLSRC 只有 HSE / HSI÷2 两档;HSI 直接进 PLL 是互联型(105/107)经 PREDIV1 才有的路,本插件不规划。",
35
35
  },
36
36
  ];
37
- export function pllSourceById(id) {
38
- return F1_PLL_SOURCES.find((source) => source.id === id) ?? null;
37
+ export function pllSourceById(id, sources = F1_PLL_SOURCES) {
38
+ return sources.find((source) => source.id === id) ?? null;
39
39
  }
40
40
  export const F1_PLL_MULS = Array.from({ length: 15 }, (_unused, index) => {
41
41
  const mul = index + 2;
@@ -44,14 +44,6 @@ export const F1_PLL_MULS = Array.from({ length: 15 }, (_unused, index) => {
44
44
  export function pllMulValue(mul) {
45
45
  return "RCC_PLL_MUL" + String(mul);
46
46
  }
47
- /** 从 RCC.PLLMUL 的值(RCC_PLL_MUL9)反解倍频;认不出来返回 null。 */
48
- export function pllMulFromValue(value) {
49
- const matched = /^RCC_PLL_MUL(\d{1,2})$/u.exec(value.trim());
50
- if (matched === null)
51
- return null;
52
- const mul = Number.parseInt(matched[1], 10);
53
- return Number.isFinite(mul) && mul >= 2 && mul <= 16 ? mul : null;
54
- }
55
47
  /** AHB / APB1 / APB2 分频:÷1、2、4、8、16(RM0008 RCC_CFGR.HPRE/PPRE1/PPRE2)。 */
56
48
  export const F1_APB_DIVS = [1, 2, 4, 8, 16].map((div) => ({
57
49
  div,
@@ -97,14 +89,6 @@ export const F1_CLOCK_LIMITS = {
97
89
  adcHz: 14_000_000,
98
90
  usbHz: 48_000_000,
99
91
  };
100
- /** 上限的人读标签,报告里拼错误消息用。 */
101
- export const F1_CLOCK_LIMIT_LABELS = {
102
- sysclkHz: "SYSCLK",
103
- apb1Hz: "APB1",
104
- apb2Hz: "APB2",
105
- adcHz: "ADC",
106
- usbHz: "USB",
107
- };
108
92
  /**
109
93
  * 外设 → 总线(RM0008 的 memory map 与 RCC 使能寄存器分组):
110
94
  * APB2 = USART1 / SPI1 / ADC1-3 / TIM1 / TIM8 / GPIO / AFIO;
@@ -129,30 +113,13 @@ export const F1_PERIPHERAL_CLOCKS = [
129
113
  ];
130
114
  /** UART 波特率整除误差默认算这几档(F1 值料号常用档)。 */
131
115
  export const F1_BAUD_LIST = [9600, 19200, 38400, 57600, 115200, 230400];
132
- /**
133
- * templates/scaffold/demo.ioc 里 RCC.IPParameters 列出的那 20 个键。
134
- * 改时钟时必须成套重算——只改 RCC.PLLMUL 会让 CubeMX 下次打开按旧 Freq_Value 生成
135
- * SystemClock_Config,HAL_RCC_ClockConfig 直接算错(这是本插件最容易埋雷的地方)。
136
- */
137
- export const F1_RCC_IP_KEYS = [
138
- "ADCFreqValue",
139
- "AHBFreq_Value",
140
- "APB1CLKDivider",
141
- "APB1Freq_Value",
142
- "APB1TimFreq_Value",
143
- "APB2Freq_Value",
144
- "APB2TimFreq_Value",
145
- "FCLKCortexFreq_Value",
146
- "FamilyName",
147
- "HCLKFreq_Value",
148
- "MCOFreq_Value",
149
- "PLLCLKFreq_Value",
150
- "PLLMCOFreq_Value",
151
- "PLLMUL",
152
- "PLLSourceVirtual",
153
- "SYSCLKFreq_VALUE",
154
- "SYSCLKSource",
155
- "TimSysFreq_Value",
156
- "USBFreq_Value",
157
- "VCOOutput2Freq_Value",
158
- ];
116
+ export const F1_FACTS = {
117
+ muls: F1_PLL_MULS,
118
+ sources: F1_PLL_SOURCES,
119
+ apbDivs: F1_APB_DIVS,
120
+ adcDivs: F1_ADC_DIVS,
121
+ limits: F1_CLOCK_LIMITS,
122
+ usb: F1_USB_PRESCALER,
123
+ peripheralClocks: F1_PERIPHERAL_CLOCKS,
124
+ baudList: F1_BAUD_LIST,
125
+ };
@@ -12,7 +12,8 @@
12
12
  * 1) 把 F1Chip 翻译成下载清单(路径 + markers + 实测 sha256);
13
13
  * 2) 把用户给的各种写法(型号 / F1:B / F1:103xb / 0.1 的老缓存 id)解析成同一个缓存条目。
14
14
  */
15
- import { loadDeviceFacts } from "./device-facts.js";
15
+ import { findChipFact, loadDeviceFacts } from "./device-facts.js";
16
+ import { familyIdOfPart } from "./family.js";
16
17
  import { resolveF1Chip } from "./stm32f1.js";
17
18
  const JS_DELIVR_FASTLY = (repo, ref, file) => "https://fastly.jsdelivr.net/gh/STMicroelectronics/" + repo + "@" + ref + "/" + file;
18
19
  const JS_DELIVR_CDN = (repo, ref, file) => "https://cdn.jsdelivr.net/gh/STMicroelectronics/" + repo + "@" + ref + "/" + file;
@@ -23,8 +24,23 @@ export function sourceUrls(repo, ref, file) {
23
24
  return [JS_DELIVR_FASTLY(repo, ref, file), JS_DELIVR_CDN(repo, ref, file), RAW_GITHUB(repo, ref, file), GHPROXY(repo, ref, file)];
24
25
  }
25
26
  /**
26
- * 目前验证过的一代:F1(2026-10 实测 10 个文件全部 200 + 大小,见 docs §12)。
27
- * 其它代按同样字段补一条即可(数据驱动,不改代码)。
27
+ * 寄存器件模板支持的 21 个族。
28
+ *
29
+ * 为什么是这 21 个:内置资源 device/<族>/chips.json 已经收了这 21 族的芯片事实
30
+ * (启动文件名 / 设备宏 / 设备头 / Flash / RAM 都在里面),寄存器路线需要的事实刚好齐了。
31
+ * 还没收 chips.json 的族(WB/WB0/WL3/MP1/MP2/N6)不在其中:WB 是双核、MP1/MP2/N6 是
32
+ * MPU/NPU 路线,本插件的寄存器建工程不适用;将来补了 chips.json 再按同样字段加一条 spec。
33
+ *
34
+ * 内核头沿用 F1 的口径:从 ST 的 STM32Cube<族> 主仓库取(ST 在主仓里 vendor 了 CMSIS,
35
+ * 不是子模块;2026-11-08 实测 F4/G0 的 Drivers/CMSIS/Include 都是 200)。
36
+ * 2026-11-09 补 H5/H7/L4+/L5/U3/U5/WBA/WL 时逐族实测过:设备头 / system 头 / system.c /
37
+ * 启动文件 / 内核头在 cmsis-device-<族>@master 与 STM32Cube<族>@master 上都是 200;
38
+ * 唯一的例外是 STM32CubeU3 的 cmsis_gcc.h 在 jsDelivr 上 403(上游树缓存没刷),
39
+ * raw.githubusercontent 与 ghproxy 两条兜底路线正常——sourceUrls 的四条路线就是为这种单点故障准备的。
40
+ *
41
+ * 哈希钉:只有 F1 那张表(DEVICE_HEADER_SHA256 / STARTUP_SHA256 / CORE_HEADER_SHA256)
42
+ * 是逐文件实测的;其它族只锁形状(minBytes + markers),真实哈希在下载时登记进缓存索引。
43
+ * 这与 SVD 的处理同口径:上游同族文件会随版本漂移,锁死哈希会让"上游发新版"变成插件故障。
28
44
  */
29
45
  export const CMSIS_FAMILIES = {
30
46
  F1: {
@@ -39,6 +55,308 @@ export const CMSIS_FAMILIES = {
39
55
  coreHeader: "core_cm3.h",
40
56
  deviceHeaders: ["stm32f1xx.h", "system_stm32f1xx.h"],
41
57
  deviceDefinePrefix: "STM32F1",
58
+ systemC: "system_stm32f1xx.c",
59
+ mpuHeader: "mpu_armv7.h",
60
+ },
61
+ C0: {
62
+ family: "C0",
63
+ deviceRepo: "cmsis-device-c0",
64
+ deviceRef: "master",
65
+ deviceIncludeDir: "Include",
66
+ deviceTemplatesDir: "Source/Templates",
67
+ cmsisRepo: "STM32CubeC0",
68
+ cmsisRef: "master",
69
+ coreIncludeDir: "Drivers/CMSIS/Include",
70
+ coreHeader: "core_cm0plus.h",
71
+ deviceHeaders: ["stm32c0xx.h", "system_stm32c0xx.h"],
72
+ deviceDefinePrefix: "STM32C0",
73
+ systemC: "system_stm32c0xx.c",
74
+ },
75
+ F0: {
76
+ family: "F0",
77
+ deviceRepo: "cmsis-device-f0",
78
+ deviceRef: "master",
79
+ deviceIncludeDir: "Include",
80
+ deviceTemplatesDir: "Source/Templates",
81
+ cmsisRepo: "STM32CubeF0",
82
+ cmsisRef: "master",
83
+ coreIncludeDir: "Drivers/CMSIS/Include",
84
+ coreHeader: "core_cm0.h",
85
+ deviceHeaders: ["stm32f0xx.h", "system_stm32f0xx.h"],
86
+ deviceDefinePrefix: "STM32F0",
87
+ systemC: "system_stm32f0xx.c",
88
+ },
89
+ F2: {
90
+ family: "F2",
91
+ deviceRepo: "cmsis-device-f2",
92
+ deviceRef: "master",
93
+ deviceIncludeDir: "Include",
94
+ deviceTemplatesDir: "Source/Templates",
95
+ cmsisRepo: "STM32CubeF2",
96
+ cmsisRef: "master",
97
+ coreIncludeDir: "Drivers/CMSIS/Include",
98
+ coreHeader: "core_cm3.h",
99
+ deviceHeaders: ["stm32f2xx.h", "system_stm32f2xx.h"],
100
+ deviceDefinePrefix: "STM32F2",
101
+ systemC: "system_stm32f2xx.c",
102
+ mpuHeader: "mpu_armv7.h",
103
+ },
104
+ F3: {
105
+ family: "F3",
106
+ deviceRepo: "cmsis-device-f3",
107
+ deviceRef: "master",
108
+ deviceIncludeDir: "Include",
109
+ deviceTemplatesDir: "Source/Templates",
110
+ cmsisRepo: "STM32CubeF3",
111
+ cmsisRef: "master",
112
+ coreIncludeDir: "Drivers/CMSIS/Include",
113
+ coreHeader: "core_cm4.h",
114
+ deviceHeaders: ["stm32f3xx.h", "system_stm32f3xx.h"],
115
+ deviceDefinePrefix: "STM32F3",
116
+ systemC: "system_stm32f3xx.c",
117
+ mpuHeader: "mpu_armv7.h",
118
+ },
119
+ F4: {
120
+ family: "F4",
121
+ deviceRepo: "cmsis-device-f4",
122
+ deviceRef: "master",
123
+ deviceIncludeDir: "Include",
124
+ deviceTemplatesDir: "Source/Templates",
125
+ cmsisRepo: "STM32CubeF4",
126
+ cmsisRef: "master",
127
+ coreIncludeDir: "Drivers/CMSIS/Include",
128
+ coreHeader: "core_cm4.h",
129
+ deviceHeaders: ["stm32f4xx.h", "system_stm32f4xx.h"],
130
+ deviceDefinePrefix: "STM32F4",
131
+ systemC: "system_stm32f4xx.c",
132
+ mpuHeader: "mpu_armv7.h",
133
+ },
134
+ F7: {
135
+ family: "F7",
136
+ deviceRepo: "cmsis-device-f7",
137
+ deviceRef: "master",
138
+ deviceIncludeDir: "Include",
139
+ deviceTemplatesDir: "Source/Templates",
140
+ cmsisRepo: "STM32CubeF7",
141
+ cmsisRef: "master",
142
+ coreIncludeDir: "Drivers/CMSIS/Include",
143
+ coreHeader: "core_cm7.h",
144
+ deviceHeaders: ["stm32f7xx.h", "system_stm32f7xx.h"],
145
+ deviceDefinePrefix: "STM32F7",
146
+ systemC: "system_stm32f7xx.c",
147
+ mpuHeader: "mpu_armv7.h",
148
+ },
149
+ G0: {
150
+ family: "G0",
151
+ deviceRepo: "cmsis-device-g0",
152
+ deviceRef: "master",
153
+ deviceIncludeDir: "Include",
154
+ deviceTemplatesDir: "Source/Templates",
155
+ cmsisRepo: "STM32CubeG0",
156
+ cmsisRef: "master",
157
+ coreIncludeDir: "Drivers/CMSIS/Include",
158
+ coreHeader: "core_cm0plus.h",
159
+ deviceHeaders: ["stm32g0xx.h", "system_stm32g0xx.h"],
160
+ deviceDefinePrefix: "STM32G0",
161
+ systemC: "system_stm32g0xx.c",
162
+ },
163
+ G4: {
164
+ family: "G4",
165
+ deviceRepo: "cmsis-device-g4",
166
+ deviceRef: "master",
167
+ deviceIncludeDir: "Include",
168
+ deviceTemplatesDir: "Source/Templates",
169
+ cmsisRepo: "STM32CubeG4",
170
+ cmsisRef: "master",
171
+ coreIncludeDir: "Drivers/CMSIS/Include",
172
+ coreHeader: "core_cm4.h",
173
+ deviceHeaders: ["stm32g4xx.h", "system_stm32g4xx.h"],
174
+ deviceDefinePrefix: "STM32G4",
175
+ systemC: "system_stm32g4xx.c",
176
+ mpuHeader: "mpu_armv7.h",
177
+ },
178
+ H5: {
179
+ family: "H5",
180
+ deviceRepo: "cmsis-device-h5",
181
+ deviceRef: "master",
182
+ deviceIncludeDir: "Include",
183
+ deviceTemplatesDir: "Source/Templates",
184
+ cmsisRepo: "STM32CubeH5",
185
+ cmsisRef: "master",
186
+ coreIncludeDir: "Drivers/CMSIS/Include",
187
+ coreHeader: "core_cm33.h",
188
+ deviceHeaders: ["stm32h5xx.h", "system_stm32h5xx.h"],
189
+ deviceDefinePrefix: "STM32H5",
190
+ systemC: "system_stm32h5xx.c",
191
+ mpuHeader: "mpu_armv8.h",
192
+ },
193
+ H7: {
194
+ family: "H7",
195
+ deviceRepo: "cmsis-device-h7",
196
+ deviceRef: "master",
197
+ deviceIncludeDir: "Include",
198
+ deviceTemplatesDir: "Source/Templates",
199
+ cmsisRepo: "STM32CubeH7",
200
+ cmsisRef: "master",
201
+ coreIncludeDir: "Drivers/CMSIS/Include",
202
+ coreHeader: "core_cm7.h",
203
+ deviceHeaders: ["stm32h7xx.h", "system_stm32h7xx.h"],
204
+ deviceDefinePrefix: "STM32H7",
205
+ systemC: "system_stm32h7xx.c",
206
+ mpuHeader: "mpu_armv7.h",
207
+ // H7 的 stm32h7<line>xx.h 定义 __ICACHE_PRESENT/__DCACHE_PRESENT=1,
208
+ // core_cm7.h 于是 include cachel1_armv7.h(ARM 原版,守卫 ARM_CACHEL1_ARMV7_H)。
209
+ extraCoreHeaders: ["cachel1_armv7.h"],
210
+ },
211
+ L0: {
212
+ family: "L0",
213
+ deviceRepo: "cmsis-device-l0",
214
+ deviceRef: "master",
215
+ deviceIncludeDir: "Include",
216
+ deviceTemplatesDir: "Source/Templates",
217
+ cmsisRepo: "STM32CubeL0",
218
+ cmsisRef: "master",
219
+ coreIncludeDir: "Drivers/CMSIS/Include",
220
+ coreHeader: "core_cm0plus.h",
221
+ deviceHeaders: ["stm32l0xx.h", "system_stm32l0xx.h"],
222
+ deviceDefinePrefix: "STM32L0",
223
+ systemC: "system_stm32l0xx.c",
224
+ },
225
+ L1: {
226
+ family: "L1",
227
+ deviceRepo: "cmsis-device-l1",
228
+ deviceRef: "master",
229
+ deviceIncludeDir: "Include",
230
+ deviceTemplatesDir: "Source/Templates",
231
+ cmsisRepo: "STM32CubeL1",
232
+ cmsisRef: "master",
233
+ coreIncludeDir: "Drivers/CMSIS/Include",
234
+ coreHeader: "core_cm3.h",
235
+ deviceHeaders: ["stm32l1xx.h", "system_stm32l1xx.h"],
236
+ deviceDefinePrefix: "STM32L1",
237
+ systemC: "system_stm32l1xx.c",
238
+ mpuHeader: "mpu_armv7.h",
239
+ },
240
+ L4: {
241
+ family: "L4",
242
+ deviceRepo: "cmsis-device-l4",
243
+ deviceRef: "master",
244
+ deviceIncludeDir: "Include",
245
+ deviceTemplatesDir: "Source/Templates",
246
+ cmsisRepo: "STM32CubeL4",
247
+ cmsisRef: "master",
248
+ coreIncludeDir: "Drivers/CMSIS/Include",
249
+ coreHeader: "core_cm4.h",
250
+ deviceHeaders: ["stm32l4xx.h", "system_stm32l4xx.h"],
251
+ deviceDefinePrefix: "STM32L4",
252
+ systemC: "system_stm32l4xx.c",
253
+ mpuHeader: "mpu_armv7.h",
254
+ },
255
+ // L4+(L4P5/L4Q5/L4R5/L4S5…)和 L4 共用同一个 cmsis-device-l4 仓库与 STM32CubeL4 固件包:
256
+ // 型号头(stm32l4p5xx.h 等)由 STM32L4xx 这个 umbrella 按设备宏选中,所以前缀仍是 STM32L4。
257
+ "L4+": {
258
+ family: "L4+",
259
+ deviceRepo: "cmsis-device-l4",
260
+ deviceRef: "master",
261
+ deviceIncludeDir: "Include",
262
+ deviceTemplatesDir: "Source/Templates",
263
+ cmsisRepo: "STM32CubeL4",
264
+ cmsisRef: "master",
265
+ coreIncludeDir: "Drivers/CMSIS/Include",
266
+ coreHeader: "core_cm4.h",
267
+ deviceHeaders: ["stm32l4xx.h", "system_stm32l4xx.h"],
268
+ deviceDefinePrefix: "STM32L4",
269
+ systemC: "system_stm32l4xx.c",
270
+ mpuHeader: "mpu_armv7.h",
271
+ },
272
+ L5: {
273
+ family: "L5",
274
+ deviceRepo: "cmsis-device-l5",
275
+ deviceRef: "master",
276
+ deviceIncludeDir: "Include",
277
+ deviceTemplatesDir: "Source/Templates",
278
+ cmsisRepo: "STM32CubeL5",
279
+ cmsisRef: "master",
280
+ coreIncludeDir: "Drivers/CMSIS/Include",
281
+ coreHeader: "core_cm33.h",
282
+ deviceHeaders: ["stm32l5xx.h", "system_stm32l5xx.h"],
283
+ deviceDefinePrefix: "STM32L5",
284
+ systemC: "system_stm32l5xx.c",
285
+ mpuHeader: "mpu_armv8.h",
286
+ },
287
+ U0: {
288
+ family: "U0",
289
+ deviceRepo: "cmsis-device-u0",
290
+ deviceRef: "master",
291
+ deviceIncludeDir: "Include",
292
+ deviceTemplatesDir: "Source/Templates",
293
+ cmsisRepo: "STM32CubeU0",
294
+ cmsisRef: "master",
295
+ coreIncludeDir: "Drivers/CMSIS/Include",
296
+ coreHeader: "core_cm0plus.h",
297
+ deviceHeaders: ["stm32u0xx.h", "system_stm32u0xx.h"],
298
+ deviceDefinePrefix: "STM32U0",
299
+ systemC: "system_stm32u0xx.c",
300
+ },
301
+ U3: {
302
+ family: "U3",
303
+ deviceRepo: "cmsis-device-u3",
304
+ deviceRef: "master",
305
+ deviceIncludeDir: "Include",
306
+ deviceTemplatesDir: "Source/Templates",
307
+ cmsisRepo: "STM32CubeU3",
308
+ cmsisRef: "master",
309
+ coreIncludeDir: "Drivers/CMSIS/Include",
310
+ coreHeader: "core_cm33.h",
311
+ deviceHeaders: ["stm32u3xx.h", "system_stm32u3xx.h"],
312
+ deviceDefinePrefix: "STM32U3",
313
+ systemC: "system_stm32u3xx.c",
314
+ mpuHeader: "mpu_armv8.h",
315
+ },
316
+ U5: {
317
+ family: "U5",
318
+ deviceRepo: "cmsis-device-u5",
319
+ deviceRef: "master",
320
+ deviceIncludeDir: "Include",
321
+ deviceTemplatesDir: "Source/Templates",
322
+ cmsisRepo: "STM32CubeU5",
323
+ cmsisRef: "master",
324
+ coreIncludeDir: "Drivers/CMSIS/Include",
325
+ coreHeader: "core_cm33.h",
326
+ deviceHeaders: ["stm32u5xx.h", "system_stm32u5xx.h"],
327
+ deviceDefinePrefix: "STM32U5",
328
+ systemC: "system_stm32u5xx.c",
329
+ mpuHeader: "mpu_armv8.h",
330
+ },
331
+ WBA: {
332
+ family: "WBA",
333
+ deviceRepo: "cmsis-device-wba",
334
+ deviceRef: "master",
335
+ deviceIncludeDir: "Include",
336
+ deviceTemplatesDir: "Source/Templates",
337
+ cmsisRepo: "STM32CubeWBA",
338
+ cmsisRef: "master",
339
+ coreIncludeDir: "Drivers/CMSIS/Include",
340
+ coreHeader: "core_cm33.h",
341
+ deviceHeaders: ["stm32wbaxx.h", "system_stm32wbaxx.h"],
342
+ deviceDefinePrefix: "STM32WBA",
343
+ systemC: "system_stm32wbaxx.c",
344
+ mpuHeader: "mpu_armv8.h",
345
+ },
346
+ WL: {
347
+ family: "WL",
348
+ deviceRepo: "cmsis-device-wl",
349
+ deviceRef: "master",
350
+ deviceIncludeDir: "Include",
351
+ deviceTemplatesDir: "Source/Templates",
352
+ cmsisRepo: "STM32CubeWL",
353
+ cmsisRef: "master",
354
+ coreIncludeDir: "Drivers/CMSIS/Include",
355
+ coreHeader: "core_cm4.h",
356
+ deviceHeaders: ["stm32wlxx.h", "system_stm32wlxx.h"],
357
+ deviceDefinePrefix: "STM32WL",
358
+ systemC: "system_stm32wlxx.c",
359
+ mpuHeader: "mpu_armv7.h",
42
360
  },
43
361
  };
44
362
  /** line 代号:STM32F103 → F1。 */
@@ -77,7 +395,7 @@ function choiceFromChip(chip) {
77
395
  * 优先 F103(档位最全,0.1 的 "F1:B" 正是按 F103 解释的),再按 line / CPN 升序。
78
396
  *
79
397
  * 以前这里靠手写的「容量字母 → 档位」常量表(随 chip-table.json 2026-10-31 一起删了)。
80
- * 现在这条事实也只从资源包缓存读:没有缓存就返回 null,上层会明说先 refresh,
398
+ * 现在这条事实也只从内置资源读:缺文件就返回 null,上层会明说先确认安装完整(stm32_assets verify),
81
399
  * 不会编一个可能不存在的启动文件名。
82
400
  */
83
401
  function chipForDensityLetter(letter) {
@@ -135,9 +453,19 @@ export function chipForInput(input) {
135
453
  * 0.2 起不再写死 F103:内部一律走 resolveF1Chip(F100/F101/F102/F103/F105/F107 × 各自档位)。
136
454
  * 老签名与老写法("F1:B")保持可用。
137
455
  */
138
- export function startupChoiceFor(mcu) {
456
+ export function startupChoiceFor(mcu, env = process.env) {
139
457
  const chip = chipForInput(mcu);
140
- return chip === null ? null : choiceFromChip(chip);
458
+ if (chip !== null)
459
+ return choiceFromChip(chip);
460
+ // 非 F1:事实全部来自插件内置资源 chips.json(按族分文件)。
461
+ const facts = findChipFact(mcu, env);
462
+ if (facts === null)
463
+ return null;
464
+ const familyId = familyIdOfPart(facts.cpn);
465
+ const family = familyId.slice("STM32".length);
466
+ if (CMSIS_FAMILIES[family] === undefined)
467
+ return null;
468
+ return { family, startup: facts.startup, define: facts.deviceDefine, deviceHeader: facts.deviceHeader, facts };
141
469
  }
142
470
  function refFromChip(chip) {
143
471
  return { family: familyOf(chip), groupKey: cmsisGroupKey(chip), id: chipEntryId(chip), chip };
@@ -267,6 +595,9 @@ export function cmsisTemplatePlan(input) {
267
595
  const spec = CMSIS_FAMILIES[choice.family];
268
596
  if (spec === undefined)
269
597
  return null;
598
+ const facts = choice.facts;
599
+ if (chip === null && facts === undefined)
600
+ return null;
270
601
  const familyDir = spec.deviceDefinePrefix + "xx";
271
602
  const deviceBase = "Drivers/CMSIS/Device/ST/" + familyDir;
272
603
  const targets = [];
@@ -278,7 +609,9 @@ export function cmsisTemplatePlan(input) {
278
609
  path: deviceBase + "/Include/" + header,
279
610
  urls: sourceUrls(spec.deviceRepo, spec.deviceRef, spec.deviceIncludeDir + "/" + header),
280
611
  minBytes: 200,
281
- markers: ["#ifndef __STM32", "#ifndef __SYSTEM_STM32"],
612
+ // 新族(C0/G0 等)的守卫不带前导下划线:STM32C0xx_H、SYSTEM_STM32C0XX_H;
613
+ // 老族(F0–F7/L1)是 __STM32F4xx_H、__SYSTEM_STM32F4XX_H。markers 是"至少命中一个",两种都列上。
614
+ markers: ["#ifndef __STM32", "#ifndef STM32", "#ifndef __SYSTEM_STM32", "#ifndef SYSTEM_STM32"],
282
615
  sha256: DEVICE_HEADER_SHA256[header],
283
616
  });
284
617
  }
@@ -286,16 +619,18 @@ export function cmsisTemplatePlan(input) {
286
619
  path: deviceBase + "/Include/" + choice.deviceHeader,
287
620
  urls: sourceUrls(spec.deviceRepo, spec.deviceRef, spec.deviceIncludeDir + "/" + choice.deviceHeader),
288
621
  minBytes: 10_000,
289
- markers: ["#ifndef __STM32", "#ifndef __SYSTEM_STM32"],
622
+ // 具体型号头(stm32c011xx.h / stm32f401xc.h)同样有带/不带前导下划线两代写法。
623
+ markers: ["#ifndef __STM32", "#ifndef STM32", "#ifndef __SYSTEM_STM32", "#ifndef SYSTEM_STM32"],
290
624
  sha256: DEVICE_HEADER_SHA256[choice.deviceHeader],
291
625
  });
292
- // 2) system_stm32f1xx.c 与启动文件
626
+ // 2) system_<族>xx.c 与启动文件
293
627
  targets.push({
294
- path: deviceBase + "/Source/Templates/system_stm32f1xx.c",
295
- urls: sourceUrls(spec.deviceRepo, spec.deviceRef, spec.deviceTemplatesDir + "/system_stm32f1xx.c"),
628
+ path: deviceBase + "/Source/Templates/" + spec.systemC,
629
+ urls: sourceUrls(spec.deviceRepo, spec.deviceRef, spec.deviceTemplatesDir + "/" + spec.systemC),
296
630
  minBytes: 1_000,
297
631
  markers: ["SystemInit"],
298
- sha256: SYSTEM_C_SHA256,
632
+ // SYSTEM_C_SHA256 只是 F1 那一份的实测值;别的族按形状校验(见 CMSIS_FAMILIES 注释)。
633
+ sha256: spec.family === "F1" ? SYSTEM_C_SHA256 : undefined,
299
634
  });
300
635
  targets.push({
301
636
  path: deviceBase + "/Source/Templates/gcc/" + choice.startup,
@@ -309,20 +644,34 @@ export function cmsisTemplatePlan(input) {
309
644
  // 但 mpu_armv7.h 是 ARM 原版,真实守卫是 ARM_MPU_ARMV7_H(V5.0.4 实测)——
310
645
  // 上一版给五个头共用 [__CMSIS,__CORE_,__MPU_],mpu_armv7.h 一个都不命中,
311
646
  // 网络全通、逐字节正确也会被判成"不是要的那个文件",整个寄存器模板下载必失败。
647
+ // core_cmX.h 的守卫名就是文件名大写前面加 __、后面加 _H(core_cm0plus.h → __CORE_CM0PLUS_H);
648
+ // 别再写死 __CORE_CM3_H:换了内核头(F4 → core_cm4.h)会一个都不命中。
649
+ const coreGuard = "__" + spec.coreHeader.replace(/\.h$/u, "").toUpperCase() + "_H";
312
650
  const coreHeaderMarkers = {
313
- [spec.coreHeader]: ["__CORE_CM3_H", "__CMSIS"],
651
+ [spec.coreHeader]: [coreGuard, "__CMSIS"],
314
652
  "cmsis_compiler.h": ["__CMSIS_COMPILER_H", "__CMSIS"],
315
653
  "cmsis_gcc.h": ["__CMSIS_GCC_H", "__CMSIS"],
316
654
  "cmsis_version.h": ["__CMSIS_VERSION", "__CMSIS"],
317
- "mpu_armv7.h": ["ARM_MPU_ARMV7_H", "__MPU_"],
318
655
  };
319
- for (const header of [spec.coreHeader, "cmsis_compiler.h", "cmsis_gcc.h", "cmsis_version.h", "mpu_armv7.h"]) {
656
+ // mpu 头不是可选项:core_cm0plus.h / core_cm3.h / core_cm4.h / core_cm7.h 里都 #include "mpu_armv7.h"
657
+ // (core_cm33.h → mpu_armv8.h)。少下一个文件,main.c 第一条就 fatal error: mpu_armv7.h: No such file。
658
+ // 所以按内核头自动带上,spec.mpuHeader 只用来覆盖例外。
659
+ const mpuHeader = spec.mpuHeader
660
+ ?? (spec.coreHeader === "core_cm0.h" ? undefined : /cm33/u.test(spec.coreHeader) ? "mpu_armv8.h" : "mpu_armv7.h");
661
+ if (mpuHeader !== undefined)
662
+ coreHeaderMarkers[mpuHeader] = ["ARM_MPU_", "__MPU_"];
663
+ // core_cm7.h 条件 include 的缓存头(H7):ARM 原版,真实守卫是 ARM_CACHEL1_ARMV7_H。
664
+ coreHeaderMarkers["cachel1_armv7.h"] = ["ARM_CACHEL1_ARMV7_H"];
665
+ const coreHeaders = [spec.coreHeader, "cmsis_compiler.h", "cmsis_gcc.h", "cmsis_version.h", ...(mpuHeader === undefined ? [] : [mpuHeader]), ...(spec.extraCoreHeaders ?? [])];
666
+ for (const header of coreHeaders) {
320
667
  targets.push({
321
668
  path: "Drivers/CMSIS/Include/" + header,
322
669
  urls: sourceUrls(spec.cmsisRepo, spec.cmsisRef, spec.coreIncludeDir + "/" + header),
323
670
  minBytes: 500,
324
671
  markers: coreHeaderMarkers[header] ?? ["__CMSIS", "__CORE_"],
325
- sha256: CORE_HEADER_SHA256[header],
672
+ // CORE_HEADER_SHA256 是 F1 那份(STM32CubeF1@master)的实测值。各族的 CMSIS 内核版本不同
673
+ // (U0 的 cmsis_compiler.h 与 F1 内容差一版),拿 F1 的哈希去校验别的族只会全灭。
674
+ sha256: spec.family === "F1" ? CORE_HEADER_SHA256[header] : undefined,
326
675
  });
327
676
  }
328
677
  const license = "STMicroelectronics CMSIS device headers / startup / CMSIS core headers — Apache License 2.0."
@@ -330,10 +679,14 @@ export function cmsisTemplatePlan(input) {
330
679
  + "github.com/STMicroelectronics/" + spec.cmsisRepo + "(" + spec.cmsisRef + ")。"
331
680
  + "\n本目录是下载缓存,不是插件源码;删掉它不影响插件,下次用时会重新下载。\n";
332
681
  // 0.2:条目按 line+档位分(cmsis:F1:103xb),目录同名。没有 chip 的旧调用退化成 startup 文件名。
333
- const groupKey = chip === null ? choice.startup.replace(/^startup_/u, "").replace(/\.s$/u, "") : cmsisGroupKey(chip);
682
+ const groupKey = chip !== null
683
+ ? cmsisGroupKey(chip)
684
+ : facts !== undefined
685
+ ? facts.line + facts.group
686
+ : choice.startup.replace(/^startup_/u, "").replace(/\.s$/u, "");
334
687
  return {
335
688
  family: choice.family,
336
- id: chip === null ? cmsisEntryId(choice.family, groupKey) : chipEntryId(chip),
689
+ id: chip !== null ? chipEntryId(chip) : cmsisEntryId(choice.family, groupKey),
337
690
  dirName: choice.family + "/" + groupKey,
338
691
  choice,
339
692
  targets,