dsh-stm32 0.1.2 → 0.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (225) hide show
  1. package/README.md +92 -40
  2. package/README_EN.md +85 -36
  3. package/assets/README.md +85 -0
  4. package/assets/VERSION +1 -0
  5. package/assets/device/c0/chips.json +1108 -0
  6. package/assets/device/f0/chips.json +1570 -0
  7. package/assets/device/f1/chips.json +1238 -0
  8. package/assets/device/f1/svd/100.json +943 -0
  9. package/assets/device/f1/svd/101.json +901 -0
  10. package/assets/device/f1/svd/102.json +522 -0
  11. package/assets/device/f1/svd/103.json +1139 -0
  12. package/assets/device/f1/svd/105.json +1117 -0
  13. package/assets/device/f1/svd/107.json +1195 -0
  14. package/assets/device/f2/chips.json +674 -0
  15. package/assets/device/f3/chips.json +1318 -0
  16. package/assets/device/f4/chips.json +2942 -0
  17. package/assets/device/f7/chips.json +1710 -0
  18. package/assets/device/g0/chips.json +2102 -0
  19. package/assets/device/g4/chips.json +2494 -0
  20. package/assets/device/h5/chips.json +898 -0
  21. package/assets/device/h7/chips.json +1948 -0
  22. package/assets/device/l0/chips.json +2494 -0
  23. package/assets/device/l1/chips.json +1234 -0
  24. package/assets/device/l4/chips.json +2130 -0
  25. package/assets/device/l4+/chips.json +856 -0
  26. package/assets/device/l5/chips.json +226 -0
  27. package/assets/device/u0/chips.json +688 -0
  28. package/assets/device/u3/chips.json +310 -0
  29. package/assets/device/u5/chips.json +884 -0
  30. package/assets/device/wba/chips.json +506 -0
  31. package/assets/device/wl/chips.json +184 -0
  32. package/assets/headers/f1/stm32f100xb.h +5972 -0
  33. package/assets/headers/f1/stm32f100xe.h +6587 -0
  34. package/assets/headers/f1/stm32f101x6.h +5315 -0
  35. package/assets/headers/f1/stm32f101xb.h +5446 -0
  36. package/assets/headers/f1/stm32f101xe.h +6503 -0
  37. package/assets/headers/f1/stm32f101xg.h +6713 -0
  38. package/assets/headers/f1/stm32f102x6.h +6448 -0
  39. package/assets/headers/f1/stm32f102xb.h +6570 -0
  40. package/assets/headers/f1/stm32f103x6.h +10109 -0
  41. package/assets/headers/f1/stm32f103xb.h +10240 -0
  42. package/assets/headers/f1/stm32f103xe.h +11767 -0
  43. package/assets/headers/f1/stm32f103xg.h +11951 -0
  44. package/assets/headers/f1/stm32f105xc.h +14340 -0
  45. package/assets/headers/f1/stm32f107xc.h +15253 -0
  46. package/assets/headers/f1/stm32f1xx.h +273 -0
  47. package/assets/headers/f1/system_stm32f1xx.h +96 -0
  48. package/assets/ioc/family/C0.ioc +82 -0
  49. package/assets/ioc/family/F0.ioc +71 -0
  50. package/assets/ioc/family/F2.ioc +91 -0
  51. package/assets/ioc/family/F3.ioc +94 -0
  52. package/assets/ioc/family/F4.ioc +91 -0
  53. package/assets/ioc/family/F7.ioc +102 -0
  54. package/assets/ioc/family/G0.ioc +90 -0
  55. package/assets/ioc/family/G4.ioc +110 -0
  56. package/assets/ioc/family/H5.ioc +116 -0
  57. package/assets/ioc/family/H7.ioc +133 -0
  58. package/assets/ioc/family/L0.ioc +92 -0
  59. package/assets/ioc/family/L1.ioc +87 -0
  60. package/assets/ioc/family/L4+.ioc +92 -0
  61. package/assets/ioc/family/L4.ioc +93 -0
  62. package/assets/ioc/family/L5.ioc +91 -0
  63. package/assets/ioc/family/U0.ioc +103 -0
  64. package/assets/ioc/family/U3.ioc +113 -0
  65. package/assets/ioc/family/U5.ioc +102 -0
  66. package/assets/ioc/family/WBA.ioc +100 -0
  67. package/assets/ioc/family/WL.ioc +93 -0
  68. package/assets/ioc/minimal/STM32F100C8Tx.ioc +113 -0
  69. package/assets/ioc/minimal/STM32F100RCTx.ioc +113 -0
  70. package/assets/ioc/minimal/STM32F101C4Tx.ioc +113 -0
  71. package/assets/ioc/minimal/STM32F101C8Tx.ioc +113 -0
  72. package/assets/ioc/minimal/STM32F101RCTx.ioc +113 -0
  73. package/assets/ioc/minimal/STM32F101RFTx.ioc +113 -0
  74. package/assets/ioc/minimal/STM32F102C4Tx.ioc +113 -0
  75. package/assets/ioc/minimal/STM32F102C8Tx.ioc +113 -0
  76. package/assets/ioc/minimal/STM32F103C4Tx.ioc +113 -0
  77. package/assets/ioc/minimal/STM32F103C8Tx.ioc +113 -0
  78. package/assets/ioc/minimal/STM32F103RCTx.ioc +113 -0
  79. package/assets/ioc/minimal/STM32F103RFTx.ioc +113 -0
  80. package/assets/ioc/minimal/STM32F105RCTx.ioc +113 -0
  81. package/assets/ioc/minimal/STM32F107RCTx.ioc +113 -0
  82. package/assets/ld/f1/STM32F100C8Tx_FLASH.ld +249 -0
  83. package/assets/ld/f1/STM32F100RCTx_FLASH.ld +249 -0
  84. package/assets/ld/f1/STM32F101C4Tx_FLASH.ld +249 -0
  85. package/assets/ld/f1/STM32F101C8Tx_FLASH.ld +249 -0
  86. package/assets/ld/f1/STM32F101RCTx_FLASH.ld +249 -0
  87. package/assets/ld/f1/STM32F101RFTx_FLASH.ld +249 -0
  88. package/assets/ld/f1/STM32F102C4Tx_FLASH.ld +249 -0
  89. package/assets/ld/f1/STM32F102C8Tx_FLASH.ld +249 -0
  90. package/assets/ld/f1/STM32F103C4Tx_FLASH.ld +249 -0
  91. package/assets/ld/f1/STM32F103C8Tx_FLASH.ld +249 -0
  92. package/assets/ld/f1/STM32F103RCTx_FLASH.ld +249 -0
  93. package/assets/ld/f1/STM32F103RFTx_FLASH.ld +249 -0
  94. package/assets/ld/f1/STM32F105RCTx_FLASH.ld +249 -0
  95. package/assets/ld/f1/STM32F107RCTx_FLASH.ld +249 -0
  96. package/assets/manifest.json +1130 -0
  97. package/assets/startup/f1/startup_stm32f100xb.s +407 -0
  98. package/assets/startup/f1/startup_stm32f100xe.s +449 -0
  99. package/assets/startup/f1/startup_stm32f101x6.s +322 -0
  100. package/assets/startup/f1/startup_stm32f101xb.s +338 -0
  101. package/assets/startup/f1/startup_stm32f101xe.s +423 -0
  102. package/assets/startup/f1/startup_stm32f101xg.s +439 -0
  103. package/assets/startup/f1/startup_stm32f102x6.s +330 -0
  104. package/assets/startup/f1/startup_stm32f102xb.s +346 -0
  105. package/assets/startup/f1/startup_stm32f103x6.s +348 -0
  106. package/assets/startup/f1/startup_stm32f103xb.s +364 -0
  107. package/assets/startup/f1/startup_stm32f103xe.s +470 -0
  108. package/assets/startup/f1/startup_stm32f103xg.s +466 -0
  109. package/assets/startup/f1/startup_stm32f105xc.s +463 -0
  110. package/assets/startup/f1/startup_stm32f107xc.s +472 -0
  111. package/assets/templates/family/C0.ioc +82 -0
  112. package/assets/templates/family/F0.ioc +71 -0
  113. package/assets/templates/family/F2.ioc +91 -0
  114. package/assets/templates/family/F3.ioc +94 -0
  115. package/assets/templates/family/F4.ioc +91 -0
  116. package/assets/templates/family/F7.ioc +102 -0
  117. package/assets/templates/family/G0.ioc +90 -0
  118. package/assets/templates/family/G4.ioc +110 -0
  119. package/assets/templates/family/H5.ioc +116 -0
  120. package/assets/templates/family/H7.ioc +133 -0
  121. package/assets/templates/family/L0.ioc +92 -0
  122. package/assets/templates/family/L1.ioc +87 -0
  123. package/assets/templates/family/L4+.ioc +92 -0
  124. package/assets/templates/family/L4.ioc +93 -0
  125. package/assets/templates/family/L5.ioc +91 -0
  126. package/assets/templates/family/U0.ioc +103 -0
  127. package/assets/templates/family/U3.ioc +113 -0
  128. package/assets/templates/family/U5.ioc +102 -0
  129. package/assets/templates/family/WB.ioc +81 -0
  130. package/assets/templates/family/WBA.ioc +100 -0
  131. package/assets/templates/family/WL.ioc +93 -0
  132. package/docs/reading-guide.md +94 -71
  133. package/lib/data/chips.js +38 -51
  134. package/lib/data/clock-db.js +830 -0
  135. package/lib/data/clock-f1.js +12 -45
  136. package/lib/data/cmsis-sources.js +264 -17
  137. package/lib/data/db-presets.js +252 -0
  138. package/lib/data/device-facts.js +274 -0
  139. package/lib/data/family.js +515 -0
  140. package/lib/data/firmware-packages.js +562 -0
  141. package/lib/data/install-guides.js +2 -2
  142. package/lib/data/ioc-presets.js +248 -0
  143. package/lib/data/ioc-schema.js +1058 -0
  144. package/lib/data/rm-topics/stm32c0.json +227 -0
  145. package/lib/data/rm-topics.js +103 -0
  146. package/lib/data/search-roots.js +42 -1
  147. package/lib/data/stm32f1.js +95 -150
  148. package/lib/data/svd.js +643 -0
  149. package/lib/data/toolchain-config.js +0 -14
  150. package/lib/engine/assets.js +659 -0
  151. package/lib/engine/breakpoints.js +297 -0
  152. package/lib/engine/clock-derived.js +101 -0
  153. package/lib/engine/clock-direct.js +313 -0
  154. package/lib/engine/clock-plan.js +96 -52
  155. package/lib/engine/clock-pllmn.js +319 -0
  156. package/lib/engine/cmake-sources.js +67 -13
  157. package/lib/engine/cube-mx-guard.js +44 -0
  158. package/lib/engine/cube-programmer.js +137 -0
  159. package/lib/engine/cubemx-db.js +273 -0
  160. package/lib/engine/debug-session.js +576 -22
  161. package/lib/engine/debug.js +99 -46
  162. package/lib/engine/doctor.js +162 -19
  163. package/lib/engine/facts-acquire.js +416 -0
  164. package/lib/engine/facts.js +134 -0
  165. package/lib/engine/firmware-install.js +176 -5
  166. package/lib/engine/firmware-official.js +451 -0
  167. package/lib/engine/flash.js +317 -76
  168. package/lib/engine/gdb-mi.js +476 -0
  169. package/lib/engine/generate.js +9 -2
  170. package/lib/engine/hal-chip.js +124 -41
  171. package/lib/engine/ioc-plan.js +1247 -63
  172. package/lib/engine/ioc-rules.js +698 -0
  173. package/lib/engine/ioc-verify.js +706 -0
  174. package/lib/engine/ioc.js +43 -4
  175. package/lib/engine/msys2-install.js +4 -4
  176. package/lib/engine/probe-error.js +231 -0
  177. package/lib/engine/probe-session.js +347 -0
  178. package/lib/engine/probe.js +18 -3
  179. package/lib/engine/register-clock.js +41 -0
  180. package/lib/engine/register-gpio.js +115 -0
  181. package/lib/engine/register-linker.js +12 -7
  182. package/lib/engine/register-template.js +130 -45
  183. package/lib/engine/regs.js +43 -8
  184. package/lib/engine/rm-extract.js +144 -0
  185. package/lib/engine/rm-sources.js +360 -0
  186. package/lib/engine/rm-text.js +56 -0
  187. package/lib/engine/rtt.js +758 -0
  188. package/lib/engine/scaffold.js +185 -18
  189. package/lib/engine/toolchain-gate.js +0 -4
  190. package/lib/engine/watch.js +227 -0
  191. package/lib/index.js +12 -2
  192. package/lib/skill/stm32-workflow.js +2 -2
  193. package/lib/tools/assets.js +272 -0
  194. package/lib/tools/cache.js +8 -0
  195. package/lib/tools/debug-session.js +41 -6
  196. package/lib/tools/debug.js +41 -11
  197. package/lib/tools/doctor.js +65 -4
  198. package/lib/tools/firmware-install.js +31 -6
  199. package/lib/tools/flash.js +47 -10
  200. package/lib/tools/generate.js +25 -0
  201. package/lib/tools/ioc-apply.js +2 -0
  202. package/lib/tools/ioc-inspect.js +2 -0
  203. package/lib/tools/ioc-plan.js +59 -2
  204. package/lib/tools/ioc-verify.js +237 -0
  205. package/lib/tools/project-create.js +63 -3
  206. package/lib/tools/regs.js +453 -61
  207. package/lib/tools/route-plan.js +3 -0
  208. package/lib/tools/rtt.js +470 -0
  209. package/lib/tools/watch.js +256 -0
  210. package/package.json +5 -4
  211. package/templates/openocd/stm32c0x.cfg +83 -0
  212. package/templates/openocd/stm32u0x.cfg +64 -0
  213. package/templates/register/CMakeLists.txt +8 -2
  214. package/templates/register/Core/Inc/rtt.h +138 -0
  215. package/templates/register/Core/Src/main.c +42 -25
  216. package/templates/register/Core/Src/rtt.c +373 -0
  217. package/templates/scaffold/RTT.md +90 -0
  218. package/templates/scaffold/STM32F103XX_FLASH.ld +3 -0
  219. package/templates/scaffold/cmake/user/CMakeLists.txt +7 -0
  220. package/templates/scaffold/openocd.cfg +5 -3
  221. package/templates/scaffold/vscode/launch.json +8 -4
  222. package/docs/development-notes.md +0 -2116
  223. package/docs/dsh-stm32-plugin-/350/247/204/346/240/274.md +0 -673
  224. package/docs/logic-audit.md +0 -607
  225. package/lib/data/f1-ram.generated.js +0 -34
@@ -0,0 +1,313 @@
1
+ /**
2
+ * direct 模型的时钟规划(没有 PLL,SYSCLK 直接取源:STM32C0 这类族)。
3
+ *
4
+ * 与 pllmul / pllmn 的区别只在「源 → SYSCLK」这一段:
5
+ * pllmul:sysclk = src × PLLMUL
6
+ * pllmn :vco = src / PLLM × PLLN;sysclk = vco / PLLP
7
+ * direct:sysclk = src(HSI 时再 ÷ HSISYSCLKDivider)
8
+ * 后面 APB/ADC 分频与要写的 RCC.* 键同形,所以对外还是同一个 ClockPlan。
9
+ *
10
+ * 事实来源:能当源的枚举(SYSCLKSource)、源分频枚举(HSISYSCLKDivider)、总线频率上限、
11
+ * 派生频率参数名都从 db 的 RCC-*_Modes.xml 读(src/data/clock-db.ts);不手抄。
12
+ *
13
+ * 实测依据(2026-11,DB.6.0.150,C031C6T6):拿 C0 模板写
14
+ * RCC.SYSCLKSource=RCC_SYSCLKSOURCE_HSI + RCC.HSISYSCLKDivider=RCC_HSI_DIV1 +
15
+ * RCC.APB1CLKDivider=RCC_APB1_DIV1 + 14 个派生键后,CubeMX 无头 load+save 的 RCC 段零 diff。
16
+ */
17
+ import { pllSourceById } from "../data/clock-f1.js";
18
+ import { emptyClockPlan, formatHz, peripheralClockHz } from "./clock-plan.js";
19
+ function divFact(divs, div) {
20
+ if (divs === undefined)
21
+ return null;
22
+ return divs.find((item) => item.div === div) ?? null;
23
+ }
24
+ function minimalDiv(divs, value, limit) {
25
+ // 没有 APB 分频参数的族(WB0/WL3 总线不分频):只有 ÷1 这一档,别去写那个键。
26
+ if (divs.length === 0)
27
+ return { div: 1, iocValue: "" };
28
+ let best = null;
29
+ for (const item of divs) {
30
+ if (item.div <= 0 || value / item.div > limit)
31
+ continue;
32
+ if (best === null || item.div < best.div)
33
+ best = item;
34
+ }
35
+ return best ?? divs[divs.length - 1];
36
+ }
37
+ /**
38
+ * 源的标称频率(Hz)。hzKey 是 db 给的「这一路频率写在 .ioc 的哪个键」(HSE → RCC.HSE_VALUE);
39
+ * 空 hzKey = 固定频率源(WB0/WL3 的 RC64MPLL 64 MHz),不读 .ioc。
40
+ */
41
+ function readSourceHz(entries, source) {
42
+ const key = source.hzKey ?? (source.id === "hse" ? "RCC.HSE_VALUE" : source.id === "hsi" ? "RCC.HSI_VALUE" : "");
43
+ if (key === "")
44
+ return source.defaultHz;
45
+ const parsed = Number.parseInt((entries.get(key) ?? "").trim(), 10);
46
+ return Number.isFinite(parsed) && parsed > 0 ? parsed : source.defaultHz;
47
+ }
48
+ /**
49
+ * .ioc 里配了外部晶振没有:看有没有引脚的 Signal=RCC_OSC_IN/OUT。
50
+ * 不能看「有没有 RCC.HSE_VALUE」——CubeMX 生成的模板**都**带这个键(默认 8 MHz),
51
+ * 板上没晶振时它只是个占位值,拿它当「有 HSE」会把 C0 规划成 8 MHz。
52
+ */
53
+ function hasHseCrystal(entries) {
54
+ for (const value of entries.values()) {
55
+ const trimmed = value.trim();
56
+ if (trimmed === "RCC_OSC_IN" || trimmed === "RCC_OSC_OUT")
57
+ return true;
58
+ }
59
+ return false;
60
+ }
61
+ /**
62
+ * direct 模型的规划入口。返回与 pllmul/pllmn 同形状的 ClockPlan,ioc-plan 不用再分叉。
63
+ */
64
+ export function planClockDirect(input) {
65
+ const { request, entries, facts, familyId } = input;
66
+ const sources = facts.sources.filter((source) => source.selectable);
67
+ if (sources.length === 0) {
68
+ return emptyClockPlan(familyId + " 的 db 里没有能直连 SYSCLK 的源(SYSCLKSource 只有 LSE/LSI 这类):clock 参数不会生效");
69
+ }
70
+ if (request !== undefined && (request.targetHz ?? 0) <= 0 && request.pllMul !== undefined) {
71
+ return emptyClockPlan(familyId + " 没有 PLL(SYSCLK 直接取源),pllMul(倍频)不适用:请给 targetHz,例如 clock:{ targetHz: 48000000 }");
72
+ }
73
+ const srcKey = facts.sysclkSourceKey ?? "RCC.SYSCLKSource";
74
+ // 源分频两种写法:单键(C0 的 HSISYSCLKDivider 只管 HSI)与「一源一键」(WB0/WL3:
75
+ // HSE 走 SYSCLK32Divider/SYSCLK48Divider、RC64MPLL 走 SYSCLK64Divider)。
76
+ const legacySrcDivKey = facts.srcDivKey ?? "";
77
+ const legacySrcDivs = facts.srcDivs ?? [];
78
+ const perSource = facts.srcDivBySource ?? {};
79
+ const divsOf = (source) => {
80
+ const bySource = perSource[source];
81
+ if (bySource !== undefined && bySource.divs.length > 0)
82
+ return bySource.divs;
83
+ if (legacySrcDivKey !== "" && legacySrcDivs.length > 0 && (facts.srcDivSources ?? []).includes(source))
84
+ return legacySrcDivs;
85
+ return [{ div: 1, iocValue: "" }];
86
+ };
87
+ const divKeyOf = (source) => {
88
+ if (source !== null) {
89
+ const bySource = perSource[source];
90
+ if (bySource !== undefined)
91
+ return bySource.key;
92
+ if (legacySrcDivKey !== "" && (facts.srcDivSources ?? []).includes(source))
93
+ return legacySrcDivKey;
94
+ }
95
+ return "";
96
+ };
97
+ const currentValue = entries.get(srcKey) ?? "";
98
+ const currentSource = pllSourceById(sources.find((source) => source.iocValue === currentValue)?.id ?? "", sources)?.id ?? null;
99
+ const currentDivKey = divKeyOf(currentSource);
100
+ const currentDivValue = currentDivKey === "" ? "" : (entries.get(currentDivKey) ?? "");
101
+ const wantedSource = request?.pllSource !== undefined && sources.some((source) => source.id === request.pllSource)
102
+ ? request.pllSource
103
+ : currentSource ??
104
+ (hasHseCrystal(entries) && sources.some((source) => source.id === "hse")
105
+ ? "hse"
106
+ : (sources.find((source) => source.id === "hsi")?.id ?? sources[0].id));
107
+ const targetHz = request?.targetHz ?? 0;
108
+ // 1) 枚举「源 × 源分频」,留下不超过 SYSCLK 上限的档位(direct 没有 VCO,约束只有这一条)
109
+ const candidates = [];
110
+ for (const source of sources) {
111
+ const sourceHz = readSourceHz(entries, source);
112
+ if (sourceHz <= 0)
113
+ continue;
114
+ for (const div of divsOf(source.id)) {
115
+ if (div.div <= 0)
116
+ continue;
117
+ const sysclkHz = Math.round(sourceHz / div.div);
118
+ if (sysclkHz <= 0 || sysclkHz > facts.limits.sysclkHz)
119
+ continue;
120
+ candidates.push({
121
+ source: source.id,
122
+ sourceLabel: source.label,
123
+ div: div.div,
124
+ divValue: div.iocValue,
125
+ sourceHz,
126
+ sysclkHz,
127
+ score: targetHz > 0 ? Math.abs(sysclkHz - targetHz) : 0,
128
+ });
129
+ }
130
+ }
131
+ if (candidates.length === 0) {
132
+ return emptyClockPlan("在 " + familyId + " 的 SYSCLK 源里找不到不超过 " + formatHz(facts.limits.sysclkHz) + " 的档位:clock 参数不会生效");
133
+ }
134
+ let best;
135
+ if (targetHz === 0) {
136
+ // 快照:优先按 .ioc 现在的源与分频读,读不出来就取该源的 ÷1
137
+ const asIs = candidates.find((item) => item.source === wantedSource && (currentDivValue === "" ? item.div === 1 : item.divValue === currentDivValue));
138
+ best = asIs ?? candidates.filter((item) => item.source === wantedSource).sort((left, right) => left.div - right.div)[0] ?? candidates[0];
139
+ }
140
+ else {
141
+ // 先按「当前/偏好的源」找最近档;那个源凑不出来时(WB0/WL3 的 HSE 只有 32/48 MHz,
142
+ // 64 MHz 得走 RC64MPLL)再放开到所有源,否则会把可达的目标报成不可达。
143
+ const byScore = (left, right) => left.score - right.score || left.div - right.div;
144
+ const sameSource = candidates.filter((item) => item.source === wantedSource).sort(byScore);
145
+ const allSources = [...candidates].sort(byScore);
146
+ const sameBest = sameSource[0];
147
+ best = sameBest !== undefined && sameBest.score <= allSources[0].score ? sameBest : allSources[0];
148
+ }
149
+ // 2) 总线分频:APB1/APB2 各取满足上限的最小分频;单 APB 族(C0)没有 APB2 参数,APB2 跟着 APB1 走
150
+ const hasApb2 = (facts.apb2Divs ?? []).length > 0;
151
+ const apb1Div = request?.apb1Div ?? minimalDiv(facts.apbDivs, best.sysclkHz, facts.limits.apb1Hz).div;
152
+ const apb2Div = !hasApb2 ? apb1Div : (request?.apb2Div ?? minimalDiv(facts.apb2Divs, best.sysclkHz, facts.limits.apb2Hz).div);
153
+ const apb1Hz = Math.round(best.sysclkHz / apb1Div);
154
+ const apb2Hz = Math.round(best.sysclkHz / apb2Div);
155
+ const adcDiv = 1;
156
+ // direct 族的 ADC 时钟由 ADCCLockSelection 从 SYSCLK 取(C0 默认就是 SYSCLK),
157
+ // 不像 F1/F4 走 ADCPresc:所以这里不写 RCC.ADCPresc,只把 ADCFreq_Value 写对。
158
+ const adcHz = best.sysclkHz;
159
+ const chain = {
160
+ pllSource: best.source,
161
+ pllSourceLabel: best.sourceLabel + (best.div > 1 ? " ÷" + String(best.div) : ""),
162
+ pllInHz: best.sysclkHz,
163
+ pllMul: 1,
164
+ pllClkHz: best.sysclkHz,
165
+ sysclkHz: best.sysclkHz,
166
+ hclkHz: best.sysclkHz,
167
+ apb1Div,
168
+ apb1TimHz: apb1Div === 1 ? apb1Hz : apb1Hz * 2,
169
+ apb1Hz,
170
+ apb2Div,
171
+ apb2Hz,
172
+ apb2TimHz: apb2Div === 1 ? apb2Hz : apb2Hz * 2,
173
+ adcDiv,
174
+ adcHz,
175
+ usbHz: 0,
176
+ usbAvailable: false,
177
+ usbPrescaled: false,
178
+ mcoHz: 0,
179
+ };
180
+ const peripherals = facts.peripheralClocks.map((fact) => ({
181
+ id: fact.id,
182
+ label: fact.label,
183
+ bus: fact.bus,
184
+ clockHz: peripheralClockHz(chain, fact),
185
+ note: "",
186
+ }));
187
+ // 3) 要写的键:源 + 源分频 + AHB/APB 分频 + 派生频率
188
+ const draft = new Map();
189
+ const source = sources.find((item) => item.id === best.source);
190
+ if (source === undefined)
191
+ return emptyClockPlan("SYSCLK 源的 .ioc 取值在 db 枚举里找不到:clock 参数不会生效");
192
+ draft.set(srcKey, source.iocValue);
193
+ const bestDivKey = divKeyOf(best.source);
194
+ if (bestDivKey !== "" && best.divValue !== "")
195
+ draft.set(bestDivKey, best.divValue);
196
+ // AHB 只 ÷1。取值名按族不同(C0 是 RCC_HCLK_DIV1、F2 是 RCC_SYSCLK_DIV1),从 db 查。
197
+ const ahbOne = divFact(facts.ahbDivs, 1);
198
+ if (ahbOne !== null && ahbOne.iocValue !== "")
199
+ draft.set("RCC.AHBCLKDivider", ahbOne.iocValue);
200
+ // 没有 APB 分频参数的族(WB0/WL3)不写这个键:CubeMX 会把未知键当垃圾丢掉,
201
+ // 计划里写了、保存后消失 = ioc_verify 报 missingKeys。
202
+ if (facts.apbDivs.length > 0)
203
+ draft.set("RCC.APB1CLKDivider", divFact(facts.apbDivs, apb1Div)?.iocValue ?? "");
204
+ if (hasApb2)
205
+ draft.set("RCC.APB2CLKDivider", divFact(facts.apb2Divs, apb2Div)?.iocValue ?? "");
206
+ // 空值(db 里查不到这个分频的枚举名)不写:空串会让 CubeMX 载入失败。
207
+ for (const [key, value] of [...draft.entries()])
208
+ if (value === "")
209
+ draft.delete(key);
210
+ // 4) 派生频率键:只写「按名字算得出来」的那批(PWR/HCLK/SYSCLK/APB/APB Tim/ADC)。
211
+ // 其余(MCO1PinFreq_Value、USART1Freq_Value、VcooutputI2S…)依赖各外设自己的选源,
212
+ // 猜错会让 ioc_verify 报「值被改写」(真差异),不如留给 CubeMX 按树重算——
213
+ // 那种差异会进 derivedRecomputed 桶,不参与 benign 判定。
214
+ const derivedNames = new Set(facts.derivedClockNames ?? []);
215
+ for (const key of entries.keys()) {
216
+ if (!key.startsWith("RCC."))
217
+ continue;
218
+ const name = key.slice("RCC.".length);
219
+ if (/freq_?value$/iu.test(name))
220
+ derivedNames.add(name);
221
+ }
222
+ // 名字比较一律转小写:.ioc 里同一类键的写法不统一(SFreq_VALUE 全大写、APBFreq_Value 驼峰、
223
+ // ADCFreqValue 连写),按原样写正则必漏一半。
224
+ const derivedValueOf = (name) => {
225
+ const lower = name.toLowerCase();
226
+ // WatchDogFreq_Value 不在这一组:它是 LSI 32 kHz(C0 实测 CubeMX 回写 32000,按 SYSCLK 写就是错值)
227
+ if (/^(sysclk|hclk|ahb|cortex|fclkcortex|pwr)freq_value$/u.test(lower))
228
+ return best.sysclkHz;
229
+ if (/^apb2timfreq_value$/u.test(lower))
230
+ return chain.apb2TimHz;
231
+ if (/^apb2freq_value$/u.test(lower))
232
+ return apb2Hz;
233
+ if (/^(apb1|apb)timfreq_value$/u.test(lower))
234
+ return chain.apb1TimHz;
235
+ if (/^(apb1|apb)freq_value$/u.test(lower))
236
+ return apb1Hz;
237
+ // 只写 ADCFreq_Value:synchADCFreq_Value/asynchADCFreq_Value 是 ADCCLockSelection 的另一档,
238
+ // 猜错就成真差异,留给 CubeMX 重算。
239
+ if (/^adcfreq_?value$/u.test(lower))
240
+ return adcHz;
241
+ return null;
242
+ };
243
+ let derivedWritten = 0;
244
+ for (const name of [...derivedNames].sort()) {
245
+ const value = derivedValueOf(name);
246
+ if (value === null)
247
+ continue;
248
+ draft.set("RCC." + name, String(value));
249
+ derivedWritten += 1;
250
+ }
251
+ // 5) RCC.IPParameters:已有名单 ∪ 本次写入(CubeMX 按 ASCII 升序写这一列,我们跟着排)
252
+ const existing = (entries.get("RCC.IPParameters") ?? "").split(",").map((item) => item.trim()).filter((item) => item !== "");
253
+ const merged = [...existing];
254
+ for (const key of draft.keys()) {
255
+ const name = key.slice("RCC.".length);
256
+ if (!merged.includes(name))
257
+ merged.push(name);
258
+ }
259
+ draft.set("RCC.IPParameters", merged.sort().join(","));
260
+ const reachable = targetHz === 0 || best.sysclkHz === targetHz;
261
+ const deltaHz = targetHz === 0 ? 0 : best.sysclkHz - targetHz;
262
+ const notes = [];
263
+ notes.push((targetHz === 0
264
+ ? "时钟现状"
265
+ : reachable
266
+ ? "目标 " + formatHz(targetHz) + " 可达"
267
+ : "目标 " + formatHz(targetHz) + " 不可达,已选 " + formatHz(best.sysclkHz)) +
268
+ ":" + chain.pllSourceLabel + " → SYSCLK " + formatHz(best.sysclkHz) + "(这一族没有 PLL,SYSCLK 直接取源)");
269
+ if (!reachable)
270
+ notes.push("SYSCLK 只能取「源 ÷ 分频」这一档组合,凑不出目标时给的是最近档");
271
+ if (derivedWritten > 0)
272
+ notes.push("顺带写对了 " + String(derivedWritten) + " 个派生频率键(其余留给 CubeMX 按树重算)");
273
+ const warnings = [];
274
+ if (best.source === "hsi") {
275
+ warnings.push("用 HSI(内部 RC,±1%)当 SYSCLK:UART 波特率会漂,量产建议接晶振(HSE)。");
276
+ }
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: 0,
287
+ apb1Div,
288
+ apb2Div,
289
+ adcDiv,
290
+ },
291
+ achieved: chain,
292
+ alternatives: candidates
293
+ .filter((item) => item.sysclkHz !== best.sysclkHz)
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 + (item.div > 1 ? " ÷" + String(item.div) : ""),
300
+ pllMul: 1,
301
+ apb1Div: minimalDiv(facts.apbDivs, item.sysclkHz, facts.limits.apb1Hz).div,
302
+ adcDiv,
303
+ usbAvailable: false,
304
+ deltaHz: targetHz === 0 ? 0 : item.sysclkHz - targetHz,
305
+ })),
306
+ peripherals,
307
+ bauds: [],
308
+ entries: [...draft.entries()].map(([key, value]) => ({ key, value })),
309
+ unset: ["RCC.PLLMUL", "RCC.PLLMCOFreq_Value", "RCC.PLLSourceVirtual"],
310
+ warnings,
311
+ errors: [],
312
+ };
313
+ }
@@ -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
  }