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
@@ -13,7 +13,18 @@
13
13
  * 3) F1 的 USB 只能从 PLLCLK÷1.5 得到 48 MHz,所以只有 PLLCLK=72 MHz 时 USB 可用;
14
14
  * 其它频率下 USBFreq_Value 退化成 PLLCLK,报告必须点明"USB 不可用"。
15
15
  */
16
- import { F1_ADC_DIVS, F1_APB_DIVS, F1_BAUD_LIST, F1_CLOCK_LIMITS, F1_PERIPHERAL_CLOCKS, F1_PLL_MULS, F1_PLL_SOURCES, F1_USB_PRESCALER, adcDivFromValue, adcDivValue, apbDivFromValue, apbDivValue, pllMulValue, pllSourceById, } from "../data/clock-f1.js";
16
+ import { adcDivFromValue, adcDivValue, apbDivFromValue, apbDivValue, F1_FACTS, pllMulValue, pllSourceById, } from "../data/clock-f1.js";
17
+ /** 当前这次规划用的时钟事实(db 派生或 F1 兜底)。planClock 是同步单线程,入口赋值即可。 */
18
+ let activeFacts = F1_FACTS;
19
+ /** 当前这颗芯片的 HSI 频率(Hz)。planClock 入口从 .ioc 的 RCC.HSI_VALUE 读,缺省 8 MHz。 */
20
+ let activeHsiHz = 8_000_000;
21
+ /** PLL 输入频率:HSE 用实际晶振值,HSI 按该族的固定分频(F0/L0 的 RCC_PLLSOURCE_HSI = HSI/2)。 */
22
+ function pllInHzOf(source, hseHz) {
23
+ if (source.id === "hse")
24
+ return hseHz;
25
+ const divider = source.divider ?? (source.id === "hsi-div2" ? 2 : 1);
26
+ return Math.round(activeHsiHz / divider);
27
+ }
17
28
  const ZERO_CHAIN = {
18
29
  pllSource: "",
19
30
  pllSourceLabel: "",
@@ -75,6 +86,11 @@ export function formatHz(hz) {
75
86
  return String(Math.round(hz / 1000)) + " kHz";
76
87
  return String(hz) + " Hz";
77
88
  }
89
+ /** RCC.HSI_VALUE(Hz);没有就按 8 MHz(各族实际可能是 16/48 MHz,所以优先读 .ioc)。 */
90
+ function readHsiHz(entries) {
91
+ const parsed = Number.parseInt((entries.get("RCC.HSI_VALUE") ?? "").trim(), 10);
92
+ return Number.isFinite(parsed) && parsed > 0 ? parsed : 8_000_000;
93
+ }
78
94
  /** RCC.HSE_VALUE(Hz);没有就按 8 MHz。 */
79
95
  function readHseHz(entries) {
80
96
  const raw = entries.get("RCC.HSE_VALUE") ?? "";
@@ -132,32 +148,32 @@ function buildChain(input) {
132
148
  const pllClk = input.pllInHz * input.pllMul;
133
149
  const sysclk = pllClk;
134
150
  const hclk = sysclk;
135
- if (sysclk > F1_CLOCK_LIMITS.sysclkHz) {
136
- errors.push("SYSCLK " + formatHz(sysclk) + " 超过 F1 上限 " + formatHz(F1_CLOCK_LIMITS.sysclkHz) +
151
+ if (sysclk > activeFacts.limits.sysclkHz) {
152
+ errors.push("SYSCLK " + formatHz(sysclk) + " 超过 F1 上限 " + formatHz(activeFacts.limits.sysclkHz) +
137
153
  "(" + input.source.label + " ×" + String(input.pllMul) + ")");
138
154
  }
139
155
  let apb1Div = input.apb1Div;
140
156
  if (apb1Div === undefined)
141
- apb1Div = minimalDiv(F1_APB_DIVS, sysclk, F1_CLOCK_LIMITS.apb1Hz)?.div ?? 16;
157
+ apb1Div = minimalDiv(activeFacts.apbDivs, sysclk, activeFacts.limits.apb1Hz)?.div ?? 16;
142
158
  const apb1 = Math.round(sysclk / apb1Div);
143
- if (apb1 > F1_CLOCK_LIMITS.apb1Hz) {
144
- errors.push("APB1 " + formatHz(apb1) + " 超过 F1 上限 " + formatHz(F1_CLOCK_LIMITS.apb1Hz) +
145
- "(APB1CLKDivider 至少要 " + needDivText(F1_APB_DIVS, sysclk, F1_CLOCK_LIMITS.apb1Hz) + ")");
159
+ if (apb1 > activeFacts.limits.apb1Hz) {
160
+ errors.push("APB1 " + formatHz(apb1) + " 超过 F1 上限 " + formatHz(activeFacts.limits.apb1Hz) +
161
+ "(APB1CLKDivider 至少要 " + needDivText(activeFacts.apbDivs, sysclk, activeFacts.limits.apb1Hz) + ")");
146
162
  }
147
163
  const apb2Div = input.apb2Div ?? 1;
148
164
  const apb2 = Math.round(sysclk / apb2Div);
149
- if (apb2 > F1_CLOCK_LIMITS.apb2Hz) {
150
- errors.push("APB2 " + formatHz(apb2) + " 超过 F1 上限 " + formatHz(F1_CLOCK_LIMITS.apb2Hz));
165
+ if (apb2 > activeFacts.limits.apb2Hz) {
166
+ errors.push("APB2 " + formatHz(apb2) + " 超过 F1 上限 " + formatHz(activeFacts.limits.apb2Hz));
151
167
  }
152
168
  let adcDiv = input.adcDiv;
153
169
  if (adcDiv === undefined)
154
- adcDiv = minimalDiv(F1_ADC_DIVS, apb2, F1_CLOCK_LIMITS.adcHz)?.div ?? 8;
170
+ adcDiv = minimalDiv(activeFacts.adcDivs, apb2, activeFacts.limits.adcHz)?.div ?? 8;
155
171
  const adc = Math.round(apb2 / adcDiv);
156
- if (adc > F1_CLOCK_LIMITS.adcHz && input.enforceAdc) {
157
- errors.push("ADC " + formatHz(adc) + " 超过 F1 上限 " + formatHz(F1_CLOCK_LIMITS.adcHz) +
158
- "(ADCPresc 至少要 " + needDivText(F1_ADC_DIVS, apb2, F1_CLOCK_LIMITS.adcHz) + ")");
172
+ if (adc > activeFacts.limits.adcHz && input.enforceAdc) {
173
+ errors.push("ADC " + formatHz(adc) + " 超过 F1 上限 " + formatHz(activeFacts.limits.adcHz) +
174
+ "(ADCPresc 至少要 " + needDivText(activeFacts.adcDivs, apb2, activeFacts.limits.adcHz) + ")");
159
175
  }
160
- const usbAvailable = pllClk === F1_USB_PRESCALER.requiresPllClkHz;
176
+ const usbAvailable = pllClk === activeFacts.usb.requiresPllClkHz;
161
177
  const chain = {
162
178
  pllSource: input.source.id,
163
179
  pllSourceLabel: input.source.label,
@@ -174,7 +190,7 @@ function buildChain(input) {
174
190
  apb2TimHz: apb2Div === 1 ? apb2 : apb2 * 2,
175
191
  adcDiv,
176
192
  adcHz: adc,
177
- usbHz: usbAvailable ? F1_USB_PRESCALER.hz : pllClk,
193
+ usbHz: usbAvailable ? activeFacts.usb.hz : pllClk,
178
194
  usbAvailable,
179
195
  usbPrescaled: false,
180
196
  mcoHz: mcoHzFor(input.mcoSource, { hseHz: input.hseHz, pllClk, sysclk }),
@@ -195,7 +211,7 @@ export function peripheralClockHz(chain, fact) {
195
211
  }
196
212
  function peripheralReport(chain, enabled, usbWanted) {
197
213
  const rows = [];
198
- for (const fact of F1_PERIPHERAL_CLOCKS) {
214
+ for (const fact of activeFacts.peripheralClocks) {
199
215
  const notes = [];
200
216
  if (fact.kind === "adc")
201
217
  notes.push("APB2÷" + String(chain.adcDiv));
@@ -232,7 +248,7 @@ function peripheralReport(chain, enabled, usbWanted) {
232
248
  }
233
249
  function baudTables(chain, bauds) {
234
250
  const tables = [];
235
- for (const fact of F1_PERIPHERAL_CLOCKS) {
251
+ for (const fact of activeFacts.peripheralClocks) {
236
252
  if (fact.kind !== "usart")
237
253
  continue;
238
254
  const clockHz = fact.bus === "apb2" ? chain.apb2Hz : chain.apb1Hz;
@@ -286,19 +302,21 @@ function mergeIpParameters(existing, draft, unset) {
286
302
  * entries/unset 为空(一个字节都不改)。
287
303
  */
288
304
  export function planClock(request, ctx) {
305
+ activeFacts = ctx.clockFacts ?? F1_FACTS;
306
+ activeHsiHz = readHsiHz(ctx.entries);
289
307
  const entries = ctx.entries;
290
308
  const hseHz = request?.hseHz !== undefined && request.hseHz > 0 ? request.hseHz : readHseHz(entries);
291
309
  const mcoSource = entries.get("RCC.MCOSource") ?? "";
292
310
  const hasHse = detectsHse(entries);
293
311
  const enabled = enabledIps(entries);
294
312
  const usbWanted = request?.usb === true || enabled.has("USB");
295
- const bauds = (request?.bauds ?? F1_BAUD_LIST).filter((value) => Number.isFinite(value) && value > 0);
296
- const detected = pllSourceById(hasHse ? "hse" : "hsi-div2") ?? F1_PLL_SOURCES[0];
313
+ const bauds = (request?.bauds ?? activeFacts.baudList).filter((value) => Number.isFinite(value) && value > 0);
314
+ const detected = pllSourceById(hasHse ? "hse" : "hsi-div2", activeFacts.sources) ?? activeFacts.sources[0];
297
315
  if (request === undefined) {
298
316
  // 只读现状:按 .ioc 里记着的源/倍频/分频反推(缺键就用 CubeMX 的缺省值)。
299
- const storedSource = pllSourceById(entries.get("RCC.PLLSourceVirtual") ?? "");
317
+ const storedSource = pllSourceById(entries.get("RCC.PLLSourceVirtual") ?? "", activeFacts.sources);
300
318
  const source = storedSource !== null && storedSource.selectable ? storedSource : detected;
301
- const pllIn = source.id === "hse" ? hseHz : source.defaultHz;
319
+ const pllIn = pllInHzOf(source, hseHz);
302
320
  const mul = Number.parseInt((entries.get("RCC.PLLMUL") ?? "").replace(/^RCC_PLL_MUL/u, ""), 10);
303
321
  const pllMul = Number.isFinite(mul) && mul >= 2 && mul <= 16 ? mul : source.id === "hse" ? 9 : 16;
304
322
  const apb1Div = apbDivFromValue(entries.get("RCC.APB1CLKDivider") ?? "") ?? undefined;
@@ -326,7 +344,7 @@ export function planClock(request, ctx) {
326
344
  achieved: chain,
327
345
  alternatives: [],
328
346
  peripherals: peripheralReport(chain, enabled, usbWanted),
329
- bauds: baudTables(chain, bauds.length > 0 ? bauds : F1_BAUD_LIST),
347
+ bauds: baudTables(chain, bauds.length > 0 ? bauds : activeFacts.baudList),
330
348
  entries: [],
331
349
  unset: [],
332
350
  warnings: [],
@@ -345,10 +363,10 @@ export function planClock(request, ctx) {
345
363
  const warnings = [];
346
364
  /** 定点模式:直接用给定倍频。 */
347
365
  if (wantsExplicit) {
348
- const source = (request.pllSource === undefined ? detected : pllSourceById(request.pllSource)) ?? detected;
366
+ const source = (request.pllSource === undefined ? detected : pllSourceById(request.pllSource, activeFacts.sources)) ?? detected;
349
367
  if (!source.selectable)
350
368
  errors.push(source.label + " 不能当 PLL 输入:" + source.note);
351
- const pllIn = source.id === "hse" ? hseHz : source.defaultHz;
369
+ const pllIn = pllInHzOf(source, hseHz);
352
370
  const built = buildChain({
353
371
  source,
354
372
  pllInHz: pllIn,
@@ -377,7 +395,7 @@ export function planClock(request, ctx) {
377
395
  // 就近搜:只搜 PLL 那条路(SYSCLK 必须来自 PLL,HSE/HSI 直通只在小频率下有意义,不规划)。
378
396
  const target = request.targetHz;
379
397
  const sources = [];
380
- const wantedSource = request.pllSource === undefined ? null : pllSourceById(request.pllSource);
398
+ const wantedSource = request.pllSource === undefined ? null : pllSourceById(request.pllSource, activeFacts.sources);
381
399
  if (wantedSource !== null) {
382
400
  if (!wantedSource.selectable)
383
401
  return { ...emptyClockPlan(wantedSource.label + " 不能当 PLL 输入:" + wantedSource.note), errors: [wantedSource.note] };
@@ -390,8 +408,8 @@ export function planClock(request, ctx) {
390
408
  /** 被上限/显式分频否掉的档:全部不可行时拿最近那档的理由当错误信息,别只说"没有可行组合"。 */
391
409
  const rejected = [];
392
410
  for (const source of sources) {
393
- const pllIn = source.id === "hse" ? hseHz : source.defaultHz;
394
- for (const fact of F1_PLL_MULS) {
411
+ const pllIn = pllInHzOf(source, hseHz);
412
+ for (const fact of activeFacts.muls) {
395
413
  const built = buildChain({
396
414
  source,
397
415
  pllInHz: pllIn,
@@ -428,7 +446,7 @@ export function planClock(request, ctx) {
428
446
  return gap !== 0 ? gap : right.sysclkHz - left.sysclkHz;
429
447
  });
430
448
  const chosen = candidates[0];
431
- const source = pllSourceById(chosen.pllSource) ?? detected;
449
+ const source = pllSourceById(chosen.pllSource, activeFacts.sources) ?? detected;
432
450
  const reachable = chosen.sysclkHz === target;
433
451
  // 命中了就不再给备选(和 explicit 模式保持一致);不可达才列附近档,方便用户改主意。
434
452
  const alternatives = reachable
@@ -467,26 +485,45 @@ function finish(input) {
467
485
  else {
468
486
  parts.push("目标 " + formatHz(input.targetHz) + " 不可达,已选 " + formatHz(chain.sysclkHz) +
469
487
  "(差 " + (delta > 0 ? "+" : "-") + formatHz(Math.abs(delta)) + ")");
470
- if (input.targetHz > F1_CLOCK_LIMITS.sysclkHz) {
471
- parts.push("F1 的 SYSCLK 上限是 " + formatHz(F1_CLOCK_LIMITS.sysclkHz));
488
+ // 文案别写死 "F1 的":同一个 finish 被 F0/G0/L0/L1/F3 这些 pllmul 族共用,
489
+ // 实测 F303 打到 72 MHz 时报出「F1 的 PLL 只能整数倍频」会把人带偏(见 §72.2)。
490
+ if (input.targetHz > activeFacts.limits.sysclkHz) {
491
+ parts.push("SYSCLK 上限是 " + formatHz(activeFacts.limits.sysclkHz) + "(db 的 SYSCLKFreq_VALUE)");
492
+ }
493
+ else if (activeFacts.muls.length > 0) {
494
+ const muls = activeFacts.muls.map((fact) => fact.mul);
495
+ parts.push("这一族的 PLL 只能整数倍频(×" + String(Math.min(...muls)) + "..×" + String(Math.max(...muls)) + ")," +
496
+ chain.pllSourceLabel + " 拼不出这一档");
472
497
  }
473
498
  else {
474
- parts.push("F1 的 PLL 只能整数倍频(×2..×16)," + chain.pllSourceLabel + " 拼不出这一档");
499
+ parts.push(chain.pllSourceLabel + " 拼不出这一档");
475
500
  }
476
501
  }
477
502
  // 换源提示:另一个可用源也许正好凑得出目标,但没说它能替代(HSI 精度差 / 要换晶振)。
478
- if (!input.reachable && input.targetHz > 0 && input.targetHz <= F1_CLOCK_LIMITS.sysclkHz) {
479
- for (const other of F1_PLL_SOURCES) {
503
+ if (!input.reachable && input.targetHz > 0 && input.targetHz <= activeFacts.limits.sysclkHz) {
504
+ const mulList = activeFacts.muls.map((fact) => fact.mul);
505
+ const lowestMul = mulList.length === 0 ? 2 : Math.min(...mulList);
506
+ const highestMul = mulList.length === 0 ? 16 : Math.max(...mulList);
507
+ for (const other of activeFacts.sources) {
480
508
  if (!other.selectable || other.id === chain.pllSource)
481
509
  continue;
482
- if (other.id === "hse")
483
- continue; // 板上没晶振就没法凭空变一个出来
484
- const pllIn = other.defaultHz;
510
+ // HSE 也算一个「能凑出来但要板上真有晶振」的候选:默认不选(.ioc 里没接晶振时凭空假设一个
511
+ // 会生成跑不起来的配置),但把组合明写出来,让人自己决定要不要加晶振。
512
+ const pllIn = other.id === "hse"
513
+ ? readHseHz(input.entries)
514
+ : Math.round(activeHsiHz / (other.divider ?? (other.id === "hsi-div2" ? 2 : 1)));
515
+ if (pllIn <= 0)
516
+ continue;
485
517
  const mul = input.targetHz / pllIn;
486
- if (!Number.isInteger(mul) || mul < 2 || mul > 16)
518
+ if (!Number.isInteger(mul) || mul < lowestMul || mul > highestMul)
487
519
  continue;
520
+ const why = other.id === "hsi-div2"
521
+ ? "HSI 精度 ±1%,UART 波特率会跟着漂"
522
+ : other.id === "hse"
523
+ ? "这要板上真接着晶振(.ioc 里没写 RCC_OSC_IN,也没启 HSE)"
524
+ : "需要板上换晶振";
488
525
  parts.push("(改用 " + other.label + " ×" + String(mul) + " 正好 " + formatHz(input.targetHz) +
489
- ",但 " + (other.id === "hsi-div2" ? "HSI 精度 ±1%,UART 波特率会跟着漂" : "需要板上换晶振") + ",默认没选它)");
526
+ ",但 " + why + ",默认没选它)");
490
527
  break;
491
528
  }
492
529
  }
@@ -494,8 +531,14 @@ function finish(input) {
494
531
  warnings.push("用 HSI÷2(内部 RC,±1%)当 PLL 输入:UART 波特率会漂,量产建议接 8 MHz 晶振(HSE)。");
495
532
  }
496
533
  if (!chain.usbAvailable && input.usbWanted) {
497
- warnings.push("USB 不可用:F1 的 USB 只能从 PLLCLK÷1.5 得到 48 MHz,需要 PLLCLK=72 MHz;当前 SYSCLK " +
498
- formatHz(chain.sysclkHz) + "。");
534
+ // 同样别写死 "F1 的":db 派生的族把 requiresPllClkHz 记 0(USB 规则没建模),
535
+ // 这里得说「没建模」,不能声称它们有 F1 那条 PLLCLK÷1.5 的路。
536
+ const requires = activeFacts.usb.requiresPllClkHz;
537
+ warnings.push(requires > 0
538
+ ? "USB 不可用:这一族的 48 MHz 只在 PLLCLK=" + formatHz(requires) + " 时拿得到;当前 SYSCLK " +
539
+ formatHz(chain.sysclkHz) + "。"
540
+ : "USB 不可用:这一族的 USB 时钟来源还没建模(计划不会写 RCC.USBPrescaler),当前 SYSCLK " +
541
+ formatHz(chain.sysclkHz) + "。");
499
542
  }
500
543
  if (!chain.usbAvailable && input.entries.get("RCC.USBPrescaler") !== undefined) {
501
544
  warnings.push("RCC.USBPrescaler 在 SYSCLK " + formatHz(chain.sysclkHz) + " 下无效(拿不到 48 MHz),已删掉这个键。");
@@ -509,7 +552,8 @@ function finish(input) {
509
552
  const push = (key, value) => {
510
553
  entries.push({ key, value });
511
554
  };
512
- push("RCC.SYSCLKSource", "RCC_SYSCLKSOURCE_PLLCLK");
555
+ // 键名按 db 决定:F3(F303)读的是 SYSCLKSourceVirtual,写 RCC.SYSCLKSource 会被静默丢掉。
556
+ push(activeFacts.sysclkSourceKey ?? "RCC.SYSCLKSource", "RCC_SYSCLKSOURCE_PLLCLK");
513
557
  push("RCC.PLLSourceVirtual", input.source.iocValue);
514
558
  push("RCC.PLLMUL", pllMulValue(chain.pllMul));
515
559
  push("RCC.SYSCLKFreq_VALUE", String(chain.sysclkHz));
@@ -529,13 +573,13 @@ function finish(input) {
529
573
  push("RCC.MCOFreq_Value", String(chain.mcoHz));
530
574
  push("RCC.TimSysFreq_Value", String(chain.apb1TimHz));
531
575
  // CubeMX 的写法:没真的用 USB 分频时,USBFreq_Value 记的就是 PLLCLK(不是 48)。
532
- push("RCC.USBFreq_Value", String(chain.usbPrescaled ? F1_USB_PRESCALER.hz : chain.pllClkHz));
576
+ push("RCC.USBFreq_Value", String(chain.usbPrescaled ? activeFacts.usb.hz : chain.pllClkHz));
533
577
  if (chain.apb2Div !== 1)
534
578
  push("RCC.APB2CLKDivider", apbDivValue(chain.apb2Div));
535
579
  else if (input.entries.get("RCC.APB2CLKDivider") !== undefined)
536
580
  unset.push("RCC.APB2CLKDivider");
537
581
  if (chain.usbPrescaled)
538
- push("RCC.USBPrescaler", F1_USB_PRESCALER.iocValue);
582
+ push("RCC.USBPrescaler", activeFacts.usb.iocValue);
539
583
  else if (input.entries.get("RCC.USBPrescaler") !== undefined)
540
584
  unset.push("RCC.USBPrescaler");
541
585
  const draft = new Map(input.entries);
@@ -562,7 +606,7 @@ function finish(input) {
562
606
  achieved: chain,
563
607
  alternatives: input.alternatives,
564
608
  peripherals: peripheralReport(chain, input.enabled, input.usbWanted),
565
- bauds: baudTables(chain, input.bauds.length > 0 ? input.bauds : F1_BAUD_LIST),
609
+ bauds: baudTables(chain, input.bauds.length > 0 ? input.bauds : activeFacts.baudList),
566
610
  entries,
567
611
  unset,
568
612
  warnings,
@@ -572,23 +616,23 @@ function finish(input) {
572
616
  /** 定点模式没命中目标时,顺手给出附近的可选档(方便用户改主意)。 */
573
617
  function nearestList(base, chosenHz, targetHz, hasHse, hseHz, request) {
574
618
  const sources = [];
575
- const wantedSource = request.pllSource === undefined ? null : pllSourceById(request.pllSource);
576
- const detected = pllSourceById(hasHse ? "hse" : "hsi-div2") ?? F1_PLL_SOURCES[0];
619
+ const wantedSource = request.pllSource === undefined ? null : pllSourceById(request.pllSource, activeFacts.sources);
620
+ const detected = pllSourceById(hasHse ? "hse" : "hsi-div2", activeFacts.sources) ?? activeFacts.sources[0];
577
621
  sources.push(wantedSource ?? detected);
578
622
  const rows = [...base];
579
623
  for (const source of sources) {
580
624
  if (!source.selectable)
581
625
  continue;
582
- const pllIn = source.id === "hse" ? hseHz : source.defaultHz;
583
- for (const fact of F1_PLL_MULS) {
626
+ const pllIn = pllInHzOf(source, hseHz);
627
+ for (const fact of activeFacts.muls) {
584
628
  const sysclk = pllIn * fact.mul;
585
- if (sysclk > F1_CLOCK_LIMITS.sysclkHz || sysclk === chosenHz)
629
+ if (sysclk > activeFacts.limits.sysclkHz || sysclk === chosenHz)
586
630
  continue;
587
631
  if (rows.some((row) => row.sysclkHz === sysclk))
588
632
  continue;
589
- const apb1 = minimalDiv(F1_APB_DIVS, sysclk, F1_CLOCK_LIMITS.apb1Hz);
633
+ const apb1 = minimalDiv(activeFacts.apbDivs, sysclk, activeFacts.limits.apb1Hz);
590
634
  const apb2 = sysclk;
591
- const adc = minimalDiv(F1_ADC_DIVS, apb2, F1_CLOCK_LIMITS.adcHz);
635
+ const adc = minimalDiv(activeFacts.adcDivs, apb2, activeFacts.limits.adcHz);
592
636
  if (apb1 === null || adc === null)
593
637
  continue;
594
638
  rows.push({
@@ -598,7 +642,7 @@ function nearestList(base, chosenHz, targetHz, hasHse, hseHz, request) {
598
642
  pllMul: fact.mul,
599
643
  apb1Div: apb1.div,
600
644
  adcDiv: adc.div,
601
- usbAvailable: sysclk === F1_USB_PRESCALER.requiresPllClkHz,
645
+ usbAvailable: sysclk === activeFacts.usb.requiresPllClkHz,
602
646
  deltaHz: sysclk - targetHz,
603
647
  });
604
648
  }
@@ -0,0 +1,319 @@
1
+ /**
2
+ * pllmn 模型的时钟规划(PLLM / PLLN / PLLP:F2 / F4 / F7 / G4 / L4 这类族)。
3
+ *
4
+ * 与 pllmul 模型的区别只在「源 → SYSCLK」这一段:
5
+ * pllmul:sysclk = src × PLLMUL
6
+ * pllmn :vco = src / PLLM × PLLN;sysclk = vco / PLLP
7
+ * 后面 AHB/APB/ADC 分频与要写的 RCC.* 键基本一致(键名从 PLLMUL 变成 PLLM/PLLN/PLLP)。
8
+ *
9
+ * 事实来源:PLLM/PLLN/PLLP 的枚举、PLLN 的 Min/Max、总线频率上限、VCO 允许区间、以及
10
+ * AHB/APB 分频的枚举名都从 db 的 RCC-*_Modes.xml 读(见 src/data/clock-db.ts);
11
+ * 核过手册/真机的族在那边用 override 表压过 db(F103 这类 db 偏保守的族)。
12
+ */
13
+ import { apbDivValue, pllSourceById } from "../data/clock-f1.js";
14
+ import { emptyClockPlan, formatHz, peripheralClockHz } from "./clock-plan.js";
15
+ /** PLL 输入频率(HSI 用 .ioc 的 RCC.HSI_VALUE;HSE 用 RCC.HSE_VALUE)。 */
16
+ export function pllInHzOfSource(source, hseHz, hsiHz, facts) {
17
+ const fact = pllSourceById(source, facts.sources);
18
+ if (fact === null)
19
+ return 0;
20
+ if (fact.id === "hse")
21
+ return hseHz;
22
+ const divider = fact.divider ?? (fact.id === "hsi-div2" ? 2 : 1);
23
+ return Math.round(hsiHz / divider);
24
+ }
25
+ function divFact(divs, div) {
26
+ if (divs === undefined)
27
+ return null;
28
+ return divs.find((item) => item.div === div) ?? null;
29
+ }
30
+ function minimalDiv(divs, value, limit) {
31
+ let best = null;
32
+ for (const item of divs) {
33
+ if (value / item.div > limit)
34
+ continue;
35
+ if (best === null || item.div < best.div)
36
+ best = item;
37
+ }
38
+ return best ?? divs[divs.length - 1];
39
+ }
40
+ /** 从 .ioc 读 RCC.HSE_VALUE / RCC.HSI_VALUE,缺省按 8 / 16 MHz(F4 的 HSI 是 16 MHz)。 */
41
+ function readSourcesHz(entries) {
42
+ const hse = Number.parseInt((entries.get("RCC.HSE_VALUE") ?? "").trim(), 10);
43
+ const hsi = Number.parseInt((entries.get("RCC.HSI_VALUE") ?? "").trim(), 10);
44
+ return {
45
+ hseHz: Number.isFinite(hse) && hse > 0 ? hse : 8_000_000,
46
+ hsiHz: Number.isFinite(hsi) && hsi > 0 ? hsi : 16_000_000,
47
+ };
48
+ }
49
+ /**
50
+ * pllmn 的规划入口。返回与 pllmul 完全同形状的 ClockPlan,这样 ioc-plan 不用分叉。
51
+ */
52
+ export function planClockPllmn(input) {
53
+ const { request, entries, facts, familyId } = input;
54
+ // VCO 区间跟着 facts 走(db 读出来的或核过的 override),不再按族名查表:
55
+ // 这样新族只要 db 里有 VCOOutputFreq_Value/VCOInputFreq_Value 就能规划。
56
+ const vcoLimits = facts.vco;
57
+ const pllM = facts.pllM ?? [];
58
+ // L4 这类族的 SYSCLK 输出是 PLLR(PLLP 属于 PLLSAI1,只有 DIV7/DIV17)
59
+ const useR = facts.sysclkOutput === "R";
60
+ const pllP = (useR ? (facts.pllR ?? []) : (facts.pllP ?? []));
61
+ // PLL1 族的分频键是 RCC.PLL1P/PLL1R(H5/U5/WBA/L4+),写 PLLP/PLLR 会被当成未知键丢掉。
62
+ // 键名一律以 db 为准(L4+ 是 RCC.PLLM1 / RCC.PLL1P,U5 的 PLL1P 是整数区间),查不到才回退旧写法。
63
+ const outputKey = useR
64
+ ? (facts.pllRKey ?? (facts.pll1Naming === true ? "RCC.PLL1R" : "RCC.PLLR"))
65
+ : (facts.pllPKey ?? (facts.pll1Naming === true ? "RCC.PLL1P" : "RCC.PLLP"));
66
+ const pllN = facts.pllN ?? null;
67
+ if (vcoLimits === undefined) {
68
+ return emptyClockPlan(familyId + " 的 PLLM/PLLN/PLLP 模型已从 db 读到,但 VCO 允许区间(db 的 VCOOutputFreq_Value/VCOInputFreq_Value 或 override 表)没有:clock 参数不会生效");
69
+ }
70
+ if (pllM.length === 0 || pllP.length === 0 || pllN === null) {
71
+ return emptyClockPlan(familyId + " 的 db 事实不全(缺 PLLM/PLLN/PLLP 枚举):clock 参数不会生效");
72
+ }
73
+ const { hseHz, hsiHz } = readSourcesHz(entries);
74
+ const hasHse = entries.has("RCC.HSE_VALUE") || entries.get("RCC.PLLSourceVirtual") === "RCC_PLLSOURCE_HSE";
75
+ const targetHz = request?.targetHz ?? 0;
76
+ const wantedSource = request?.pllSource ?? (hasHse ? "hse" : "hsi");
77
+ // 1) 枚举所有 (源, M, N, P),留下 VCO 与 SYSCLK 都合法的组合
78
+ const candidates = [];
79
+ const nMin = Math.max(pllN.min, 2);
80
+ // H5 的 PLLN 到 512(其余族 432 以内),上限按 db 给的值,再兜一层 512 防脏数据。
81
+ const nMax = Math.min(pllN.max, 512);
82
+ for (const source of facts.sources) {
83
+ if (!source.selectable)
84
+ continue;
85
+ const srcHz = pllInHzOfSource(source.id, hseHz, hsiHz, facts);
86
+ if (srcHz <= 0)
87
+ continue;
88
+ for (const m of pllM) {
89
+ const inHz = srcHz / m.div;
90
+ if (vcoLimits.inMinHz !== undefined && inHz < vcoLimits.inMinHz)
91
+ continue;
92
+ if (vcoLimits.inMaxHz !== undefined && inHz > vcoLimits.inMaxHz)
93
+ continue;
94
+ // PLL1 族:VCO 允许区间按输入频段分段(H5 的 PLL1_VCI_Range),先定段再判 VCO。
95
+ const bands = facts.vcoBands ?? [];
96
+ let bandMinHz = vcoLimits.minHz;
97
+ let bandMaxHz = vcoLimits.maxHz;
98
+ let band;
99
+ if (bands.length > 0) {
100
+ band = bands.find((item) => inHz >= item.inMinHz && inHz <= item.inMaxHz);
101
+ if (band === undefined)
102
+ continue;
103
+ bandMinHz = band.minHz;
104
+ bandMaxHz = band.maxHz;
105
+ }
106
+ // N 全扫(50..432,几百个值,成本可忽略):早先按目标反推邻域会在 P≠1 时把正确档位截掉
107
+ // (8 MHz/4 × 168 × 1/2 = 168 MHz 这种档位就落在窗口外,实测选了 86 MHz)。
108
+ for (let n = nMin; n <= nMax; n += 1) {
109
+ const vcoHz = Math.round(inHz * n);
110
+ if (vcoHz < bandMinHz || vcoHz > bandMaxHz)
111
+ continue;
112
+ for (const p of pllP) {
113
+ const sysclkHz = Math.round(vcoHz / p.div);
114
+ if (sysclkHz <= 0 || sysclkHz > facts.limits.sysclkHz)
115
+ continue;
116
+ const score = targetHz > 0 ? Math.abs(sysclkHz - targetHz) : 0;
117
+ candidates.push({
118
+ source: source.id,
119
+ sourceLabel: source.label,
120
+ m: m.div,
121
+ n,
122
+ p: p.div,
123
+ vcoHz,
124
+ sysclkHz,
125
+ score,
126
+ ...(band === undefined ? {} : { vciValue: band.value }),
127
+ ...(band?.vcoSel === undefined ? {} : { vcoSelValue: band.vcoSel }),
128
+ });
129
+ }
130
+ }
131
+ }
132
+ }
133
+ if (candidates.length === 0) {
134
+ return emptyClockPlan("在 " + familyId + " 的 PLLM/PLLN/PLLP 组合里找不到满足 VCO 与 SYSCLK 上限的档位:clock 参数不会生效");
135
+ }
136
+ // 2) 选最接近目标的;同分时优先「用户指定的源」、再优先 P=2(VCO 越高越少抖动)
137
+ const sameSource = candidates.filter((item) => item.source === wantedSource);
138
+ const pool = sameSource.length > 0 ? sameSource : candidates;
139
+ pool.sort((left, right) => left.score - right.score || left.p - right.p || left.m - right.m);
140
+ const best = pool[0];
141
+ // 3) 总线频率与分频(APB1/APB2 都取满足各自上限的最小分频)。
142
+ // APB2 曾经写死 ÷1:F4/F7/G4/L4 的 SYSCLK 上限恰好等于 APB2 上限,看不出来;
143
+ // F2 是 120 MHz SYSCLK / 60 MHz APB2,写死 ÷1 会把 APB2 顶到 120 MHz(超规格),
144
+ // CubeMX 载入这份 .ioc 会卡住不返回(实测 >240 s 无输出)。
145
+ const apb1Div = request?.apb1Div ?? minimalDiv(facts.apbDivs, best.sysclkHz, facts.limits.apb1Hz).div;
146
+ const apb2Div = request?.apb2Div ?? minimalDiv(facts.apbDivs, best.sysclkHz, facts.limits.apb2Hz).div;
147
+ const apb1Hz = Math.round(best.sysclkHz / apb1Div);
148
+ const apb2Hz = Math.round(best.sysclkHz / apb2Div);
149
+ const adcDiv = request?.adcDiv ?? minimalDiv(facts.adcDivs.length > 0 ? facts.adcDivs : [{ div: 1, iocValue: "" }], apb2Hz, facts.limits.adcHz).div;
150
+ const adcHz = Math.round(apb2Hz / adcDiv);
151
+ const chain = {
152
+ pllSource: best.source,
153
+ pllSourceLabel: best.sourceLabel,
154
+ pllInHz: Math.round(pllInHzOfSource(best.source, hseHz, hsiHz, facts) / best.m),
155
+ pllMul: best.n,
156
+ pllM: best.m,
157
+ pllN: best.n,
158
+ pllP: best.p,
159
+ pllClkHz: best.vcoHz / best.p,
160
+ sysclkHz: best.sysclkHz,
161
+ hclkHz: best.sysclkHz,
162
+ apb1Div,
163
+ apb1TimHz: apb1Div === 1 ? apb1Hz : apb1Hz * 2,
164
+ apb1Hz,
165
+ apb2Div,
166
+ apb2Hz,
167
+ apb2TimHz: apb2Div === 1 ? apb2Hz : apb2Hz * 2,
168
+ adcDiv,
169
+ adcHz,
170
+ usbHz: 0,
171
+ usbAvailable: false,
172
+ usbPrescaled: false,
173
+ mcoHz: 0,
174
+ };
175
+ const peripherals = facts.peripheralClocks.map((fact) => ({
176
+ id: fact.id,
177
+ label: fact.label,
178
+ bus: fact.bus,
179
+ clockHz: peripheralClockHz(chain, fact),
180
+ note: "",
181
+ }));
182
+ // 4) 要写的键(pllmn 用 PLLM/PLLN/PLLP,没有 PLLMUL)
183
+ const mFact = divFact(pllM, best.m);
184
+ const pFact = divFact(pllP, best.p);
185
+ if (mFact === null || pFact === null) {
186
+ return emptyClockPlan("PLLM/PLLP 的 .ioc 取值在 db 枚举里找不到:clock 参数不会生效");
187
+ }
188
+ const draft = new Map();
189
+ draft.set("RCC.PLLSourceVirtual", pllSourceById(best.source, facts.sources).iocValue);
190
+ draft.set(facts.pllMKey ?? "RCC.PLLM", mFact.iocValue);
191
+ draft.set("RCC.PLLN", String(best.n));
192
+ draft.set(outputKey, pFact.iocValue);
193
+ // PLL1 族:把输入频段与 VCO 档位一起写回去,否则 CubeMX 按默认档(通常是窄档)校验,
194
+ // 选出来的 VCO 可能落在默认档之外 → 载入后被改回默认频率。
195
+ if (facts.vciRangeKey !== undefined && best.vciValue !== undefined)
196
+ draft.set(facts.vciRangeKey, best.vciValue);
197
+ if (facts.vcoSelKey !== undefined && best.vcoSelValue !== undefined)
198
+ draft.set(facts.vcoSelKey, best.vcoSelValue);
199
+ // H5/U5 的 PLL 有显式开关:不写 PLLUsed=1 时 CubeMX 认为 PLL 不用,SYSCLK 回落 HSI。
200
+ if (facts.pllEnable !== undefined) {
201
+ // 只写 PLLUsed=1:PLLState 是 db 里按 PLLUsed 派生的(Condition=PLLUsed=0 时给 OFF),
202
+ // 写它反而会被 CubeMX 丢掉(F4/F7 实测:missingKeys 里出现 RCC.PLLState、IPParameters 判成改写)。
203
+ draft.set(facts.pllEnable.usedKey, facts.pllEnable.usedValue);
204
+ }
205
+ // SYSCLK 源的键名按 db 决定:F303 只有 SYSCLKSourceVirtual 生效(写 RCC.SYSCLKSource 会被丢)。
206
+ draft.set(facts.sysclkSourceKey ?? "RCC.SYSCLKSource", "RCC_SYSCLKSOURCE_PLLCLK");
207
+ // 分频键的取值必须来自 db 的枚举名:AHB 与 APB 不是同一套名字(F2/F4/F7 的 AHB 是
208
+ // RCC_SYSCLK_DIVn,APB 是 RCC_HCLK_DIVn;C0 反过来)。写错名字 CubeMX **不报错**,
209
+ // 载入时直接死循环(F2 实测 >240 s 停在 setPackage),所以这里按 div 去枚举里查,
210
+ // 查不到就不写这个键(缺省值本来就是 ÷1,正好是我们要的)。
211
+ const divValueOf = (divs, div, fallback) => divFact(divs, div)?.iocValue ?? fallback(div);
212
+ const ahbValue = divValueOf(facts.ahbDivs, 1, () => "");
213
+ if (ahbValue !== "")
214
+ draft.set("RCC.AHBCLKDivider", ahbValue);
215
+ draft.set("RCC.APB1CLKDivider", divValueOf(facts.apbDivs, apb1Div, apbDivValue));
216
+ draft.set("RCC.APB2CLKDivider", divValueOf(facts.apbDivs, apb2Div, apbDivValue));
217
+ // 派生频率键:只有 db 里真有这个参数名的才写(H5 没有 PLLCLKFreq_Value,写进去会被当成未知键丢掉)。
218
+ const known = facts.knownDerivedNames ?? [];
219
+ const setDerived = (names, value) => {
220
+ const list = typeof names === "string" ? [names] : names;
221
+ // SYSCLKFreq_VALUE 的尾巴是 _VALUE(不是 Freq_Value),所以它永远不在 derivedNames 名单里,
222
+ // 但这一族一定有它(每个族的 RCC Modes 都带),必须写。
223
+ const name = list.includes("SYSCLKFreq_VALUE")
224
+ ? "SYSCLKFreq_VALUE"
225
+ : known.length === 0
226
+ ? list[0]
227
+ : list.find((item) => known.includes(item));
228
+ if (name === undefined)
229
+ return;
230
+ draft.set("RCC." + name, String(value));
231
+ };
232
+ setDerived("SYSCLKFreq_VALUE", best.sysclkHz);
233
+ setDerived("HCLKFreq_Value", best.sysclkHz);
234
+ // AHB 只 ÷1(上面写的 AHBCLKDivider 就是 ÷1),所以 AHB 与 Cortex 都等于 HCLK。
235
+ // 不写它们 CubeMX 保存时会按自己的树重算一遍,verify 里就成了「值被改写」的噪声(F2 实测)。
236
+ setDerived("AHBFreq_Value", best.sysclkHz);
237
+ // Cortex(SysTick)只有在 db 没给选择/分频参数时才等于 HCLK。H5/U5/WBA/L4+ 有 Cortex_Div 这类参数,
238
+ // 实测同一族两次往返能反着改(H5 写 HCLK 被改成 HCLK÷8,U5 写 HCLK÷8 又被改回 HCLK)——
239
+ // 那就交给 CubeMX 算,verify 会归到 derivedRecomputed(不参与 benign)。
240
+ if (facts.cortexFollowsHclk !== false) {
241
+ setDerived("CortexFreq_Value", best.sysclkHz);
242
+ setDerived("FCLKCortexFreq_Value", best.sysclkHz);
243
+ }
244
+ setDerived(["PLLCLKFreq_Value", "PLL1CLKFreq_Value", "PLLRCLKFreq_Value", "PLLPoutputFreq_Value"], Math.round(best.vcoHz / best.p));
245
+ setDerived("VCOOutputFreq_Value", best.vcoHz);
246
+ setDerived("APB1Freq_Value", apb1Hz);
247
+ setDerived("APB1TimFreq_Value", chain.apb1TimHz);
248
+ setDerived("APB2Freq_Value", apb2Hz);
249
+ setDerived("APB2TimFreq_Value", chain.apb2TimHz);
250
+ if (adcDiv >= 2 && facts.adcDivs.length > 0) {
251
+ const adcFact = divFact(facts.adcDivs, adcDiv);
252
+ if (adcFact !== null && adcFact.iocValue !== "") {
253
+ draft.set("RCC.ADCPresc", adcFact.iocValue);
254
+ setDerived(["ADCFreqValue", "ADCFreq_Value"], adcHz);
255
+ }
256
+ }
257
+ // RCC.IPParameters 要把上面这些名字并进去(CubeMX 按它决定读哪些键)
258
+ const existing = (entries.get("RCC.IPParameters") ?? "").split(",").map((item) => item.trim()).filter((item) => item !== "");
259
+ const merged = [...existing];
260
+ for (const key of draft.keys()) {
261
+ const name = key.slice("RCC.".length);
262
+ if (!merged.includes(name))
263
+ merged.push(name);
264
+ }
265
+ // CubeMX 自己写这一列时是**按 ASCII 升序**排的(实测 F2:48MHZClocksFreq_Value,AHBCLKDivider,
266
+ // AHBFreq_Value,… ,VcooutputI2S——大写整体排在小写前面)。这里跟着排序,否则每次 verify 都会
267
+ // 报「IPParameters 的值被改写」,把真正的差异淹掉。
268
+ draft.set("RCC.IPParameters", merged.sort().join(","));
269
+ const reachable = targetHz === 0 || best.sysclkHz === targetHz;
270
+ const deltaHz = targetHz === 0 ? 0 : best.sysclkHz - targetHz;
271
+ const notes = [];
272
+ notes.push((targetHz === 0 ? "时钟现状" : reachable ? "目标 " + formatHz(targetHz) + " 可达" : "目标 " + formatHz(targetHz) + " 不可达,已选 " + formatHz(best.sysclkHz)) +
273
+ ":" + best.sourceLabel + " ÷" + String(best.m) + " ×" + String(best.n) + " ÷" + String(best.p) +
274
+ " → SYSCLK " + formatHz(best.sysclkHz) + "(VCO " + formatHz(best.vcoHz) + ")");
275
+ if (!reachable)
276
+ notes.push("PLLM/PLLN/PLLP 只能凑出上面这一档最接近的频率");
277
+ return {
278
+ mode: targetHz === 0 ? "snapshot" : "nearest",
279
+ ok: true,
280
+ reachable,
281
+ deltaHz,
282
+ note: notes.join(";"),
283
+ requested: {
284
+ targetHz,
285
+ pllSource: wantedSource,
286
+ pllMul: best.n,
287
+ apb1Div,
288
+ apb2Div,
289
+ adcDiv,
290
+ },
291
+ achieved: chain,
292
+ alternatives: candidates
293
+ .filter((item) => item.sysclkHz !== best.sysclkHz && item.source === best.source)
294
+ .sort((left, right) => left.score - right.score)
295
+ .slice(0, 3)
296
+ .map((item) => ({
297
+ sysclkHz: item.sysclkHz,
298
+ pllSource: item.source,
299
+ pllSourceLabel: item.sourceLabel,
300
+ pllMul: item.n,
301
+ apb1Div: minimalDiv(facts.apbDivs, item.sysclkHz, facts.limits.apb1Hz).div,
302
+ apb2Div: minimalDiv(facts.apbDivs, item.sysclkHz, facts.limits.apb2Hz).div,
303
+ adcDiv,
304
+ usbAvailable: false,
305
+ deltaHz: targetHz === 0 ? 0 : item.sysclkHz - targetHz,
306
+ })),
307
+ peripherals,
308
+ bauds: [],
309
+ entries: [...draft.entries()].map(([key, value]) => ({ key, value })),
310
+ unset: [
311
+ "RCC.PLLMUL",
312
+ "RCC.PLLMCOFreq_Value",
313
+ "RCC.USBPrescaler",
314
+ facts.pll1Naming === true ? (useR ? "RCC.PLL1P" : "RCC.PLL1R") : useR ? "RCC.PLLP" : "RCC.PLLR",
315
+ ],
316
+ warnings: [],
317
+ errors: [],
318
+ };
319
+ }