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.
- package/README.md +115 -43
- package/README_EN.md +106 -38
- package/assets/README.md +85 -0
- package/assets/VERSION +1 -0
- package/assets/device/c0/chips.json +1108 -0
- package/assets/device/f0/chips.json +1570 -0
- package/assets/device/f1/chips.json +1238 -0
- package/assets/device/f1/svd/100.json +943 -0
- package/assets/device/f1/svd/101.json +901 -0
- package/assets/device/f1/svd/102.json +522 -0
- package/assets/device/f1/svd/103.json +1139 -0
- package/assets/device/f1/svd/105.json +1117 -0
- package/assets/device/f1/svd/107.json +1195 -0
- package/assets/device/f2/chips.json +674 -0
- package/assets/device/f3/chips.json +1318 -0
- package/assets/device/f4/chips.json +2942 -0
- package/assets/device/f7/chips.json +1710 -0
- package/assets/device/g0/chips.json +2102 -0
- package/assets/device/g4/chips.json +2494 -0
- package/assets/device/h5/chips.json +898 -0
- package/assets/device/h7/chips.json +2639 -0
- package/assets/device/l0/chips.json +2494 -0
- package/assets/device/l1/chips.json +1234 -0
- package/assets/device/l4/chips.json +2130 -0
- package/assets/device/l4+/chips.json +856 -0
- package/assets/device/l5/chips.json +226 -0
- package/assets/device/u0/chips.json +688 -0
- package/assets/device/u3/chips.json +310 -0
- package/assets/device/u5/chips.json +1195 -0
- package/assets/device/wba/chips.json +506 -0
- package/assets/device/wl/chips.json +184 -0
- package/assets/headers/f1/stm32f100xb.h +5972 -0
- package/assets/headers/f1/stm32f100xe.h +6587 -0
- package/assets/headers/f1/stm32f101x6.h +5315 -0
- package/assets/headers/f1/stm32f101xb.h +5446 -0
- package/assets/headers/f1/stm32f101xe.h +6503 -0
- package/assets/headers/f1/stm32f101xg.h +6713 -0
- package/assets/headers/f1/stm32f102x6.h +6448 -0
- package/assets/headers/f1/stm32f102xb.h +6570 -0
- package/assets/headers/f1/stm32f103x6.h +10109 -0
- package/assets/headers/f1/stm32f103xb.h +10240 -0
- package/assets/headers/f1/stm32f103xe.h +11767 -0
- package/assets/headers/f1/stm32f103xg.h +11951 -0
- package/assets/headers/f1/stm32f105xc.h +14340 -0
- package/assets/headers/f1/stm32f107xc.h +15253 -0
- package/assets/headers/f1/stm32f1xx.h +273 -0
- package/assets/headers/f1/system_stm32f1xx.h +96 -0
- package/assets/ioc/family/C0.ioc +82 -0
- package/assets/ioc/family/F0.ioc +71 -0
- package/assets/ioc/family/F2.ioc +91 -0
- package/assets/ioc/family/F3.ioc +94 -0
- package/assets/ioc/family/F4.ioc +91 -0
- package/assets/ioc/family/F7.ioc +102 -0
- package/assets/ioc/family/G0.ioc +90 -0
- package/assets/ioc/family/G4.ioc +110 -0
- package/assets/ioc/family/H5.ioc +116 -0
- package/assets/ioc/family/H7.ioc +133 -0
- package/assets/ioc/family/L0.ioc +92 -0
- package/assets/ioc/family/L1.ioc +87 -0
- package/assets/ioc/family/L4+.ioc +92 -0
- package/assets/ioc/family/L4.ioc +93 -0
- package/assets/ioc/family/L5.ioc +91 -0
- package/assets/ioc/family/U0.ioc +103 -0
- package/assets/ioc/family/U3.ioc +113 -0
- package/assets/ioc/family/U5.ioc +102 -0
- package/assets/ioc/family/WBA.ioc +100 -0
- package/assets/ioc/family/WL.ioc +93 -0
- package/assets/ioc/minimal/STM32F100C8Tx.ioc +113 -0
- package/assets/ioc/minimal/STM32F100RCTx.ioc +113 -0
- package/assets/ioc/minimal/STM32F101C4Tx.ioc +113 -0
- package/assets/ioc/minimal/STM32F101C8Tx.ioc +113 -0
- package/assets/ioc/minimal/STM32F101RCTx.ioc +113 -0
- package/assets/ioc/minimal/STM32F101RFTx.ioc +113 -0
- package/assets/ioc/minimal/STM32F102C4Tx.ioc +113 -0
- package/assets/ioc/minimal/STM32F102C8Tx.ioc +113 -0
- package/assets/ioc/minimal/STM32F103C4Tx.ioc +113 -0
- package/assets/ioc/minimal/STM32F103C8Tx.ioc +113 -0
- package/assets/ioc/minimal/STM32F103RCTx.ioc +113 -0
- package/assets/ioc/minimal/STM32F103RFTx.ioc +113 -0
- package/assets/ioc/minimal/STM32F105RCTx.ioc +113 -0
- package/assets/ioc/minimal/STM32F107RCTx.ioc +113 -0
- package/assets/ld/f1/STM32F100C8Tx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F100RCTx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F101C4Tx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F101C8Tx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F101RCTx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F101RFTx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F102C4Tx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F102C8Tx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F103C4Tx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F103C8Tx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F103RCTx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F103RFTx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F105RCTx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F107RCTx_FLASH.ld +249 -0
- package/assets/manifest.json +1130 -0
- package/assets/startup/f1/startup_stm32f100xb.s +407 -0
- package/assets/startup/f1/startup_stm32f100xe.s +449 -0
- package/assets/startup/f1/startup_stm32f101x6.s +322 -0
- package/assets/startup/f1/startup_stm32f101xb.s +338 -0
- package/assets/startup/f1/startup_stm32f101xe.s +423 -0
- package/assets/startup/f1/startup_stm32f101xg.s +439 -0
- package/assets/startup/f1/startup_stm32f102x6.s +330 -0
- package/assets/startup/f1/startup_stm32f102xb.s +346 -0
- package/assets/startup/f1/startup_stm32f103x6.s +348 -0
- package/assets/startup/f1/startup_stm32f103xb.s +364 -0
- package/assets/startup/f1/startup_stm32f103xe.s +470 -0
- package/assets/startup/f1/startup_stm32f103xg.s +466 -0
- package/assets/startup/f1/startup_stm32f105xc.s +463 -0
- package/assets/startup/f1/startup_stm32f107xc.s +472 -0
- package/assets/templates/family/C0.ioc +82 -0
- package/assets/templates/family/F0.ioc +71 -0
- package/assets/templates/family/F2.ioc +91 -0
- package/assets/templates/family/F3.ioc +94 -0
- package/assets/templates/family/F4.ioc +91 -0
- package/assets/templates/family/F7.ioc +102 -0
- package/assets/templates/family/G0.ioc +90 -0
- package/assets/templates/family/G4.ioc +110 -0
- package/assets/templates/family/H5.ioc +116 -0
- package/assets/templates/family/H7.ioc +133 -0
- package/assets/templates/family/L0.ioc +92 -0
- package/assets/templates/family/L1.ioc +87 -0
- package/assets/templates/family/L4+.ioc +92 -0
- package/assets/templates/family/L4.ioc +93 -0
- package/assets/templates/family/L5.ioc +91 -0
- package/assets/templates/family/U0.ioc +103 -0
- package/assets/templates/family/U3.ioc +113 -0
- package/assets/templates/family/U5.ioc +102 -0
- package/assets/templates/family/WB.ioc +81 -0
- package/assets/templates/family/WBA.ioc +100 -0
- package/assets/templates/family/WL.ioc +93 -0
- package/docs/reading-guide.md +110 -42
- package/lib/commands/register.js +1 -1
- package/lib/data/chips.js +3 -3
- package/lib/data/clock-db.js +830 -0
- package/lib/data/clock-f1.js +12 -45
- package/lib/data/cmsis-sources.js +371 -18
- package/lib/data/db-presets.js +252 -0
- package/lib/data/device-facts.js +113 -26
- package/lib/data/family.js +515 -0
- package/lib/data/firmware-packages.js +595 -12
- package/lib/data/firmware-pins.js +128 -0
- package/lib/data/install-guides.js +2 -2
- package/lib/data/ioc-presets.js +248 -0
- package/lib/data/ioc-schema.js +1058 -0
- package/lib/data/rm-topics/stm32c0.json +227 -0
- package/lib/data/rm-topics.js +103 -0
- package/lib/data/search-roots.js +59 -4
- package/lib/data/serial-config.js +430 -0
- package/lib/data/stm32f1.js +15 -14
- package/lib/data/svd.js +32 -16
- package/lib/data/toolchain-config.js +0 -14
- package/lib/engine/assets.js +191 -456
- package/lib/engine/breakpoints.js +66 -11
- package/lib/engine/clock-derived.js +101 -0
- package/lib/engine/clock-direct.js +313 -0
- package/lib/engine/clock-plan.js +96 -52
- package/lib/engine/clock-pllmn.js +319 -0
- package/lib/engine/cmake-sources.js +67 -13
- package/lib/engine/cube-mx-guard.js +44 -0
- package/lib/engine/cube-programmer.js +137 -0
- package/lib/engine/cubemx-db.js +273 -0
- package/lib/engine/debug-session.js +423 -17
- package/lib/engine/debug.js +25 -6
- package/lib/engine/doctor.js +239 -19
- package/lib/engine/download.js +242 -0
- package/lib/engine/facts-acquire.js +416 -0
- package/lib/engine/facts.js +134 -0
- package/lib/engine/fetch.js +1 -1
- package/lib/engine/firmware-install.js +333 -39
- package/lib/engine/firmware-official.js +499 -0
- package/lib/engine/flash.js +290 -21
- package/lib/engine/gdb-mi.js +476 -0
- package/lib/engine/generate.js +9 -2
- package/lib/engine/hal-chip.js +124 -41
- package/lib/engine/ioc-plan.js +1244 -60
- package/lib/engine/ioc-rules.js +698 -0
- package/lib/engine/ioc-verify.js +706 -0
- package/lib/engine/ioc.js +43 -4
- package/lib/engine/msys2-install.js +241 -92
- package/lib/engine/probe-error.js +25 -6
- package/lib/engine/probe-session.js +50 -14
- package/lib/engine/probe.js +22 -5
- package/lib/engine/register-clock.js +41 -0
- package/lib/engine/register-gpio.js +132 -0
- package/lib/engine/register-linker.js +37 -13
- package/lib/engine/register-template.js +125 -40
- package/lib/engine/regs.js +41 -8
- package/lib/engine/rm-extract.js +144 -0
- package/lib/engine/rm-sources.js +360 -0
- package/lib/engine/rm-text.js +56 -0
- package/lib/engine/rtt.js +188 -30
- package/lib/engine/scaffold.js +185 -18
- package/lib/engine/serial.js +1692 -0
- package/lib/engine/tar.js +235 -3
- package/lib/engine/toolchain-gate.js +0 -4
- package/lib/engine/watch.js +227 -0
- package/lib/index.js +16 -2
- package/lib/skill/stm32-workflow.js +2 -2
- package/lib/tools/assets.js +39 -108
- package/lib/tools/cache.js +2 -2
- package/lib/tools/debug-session.js +2 -2
- package/lib/tools/doctor.js +61 -5
- package/lib/tools/download.js +303 -0
- package/lib/tools/firmware-install.js +31 -6
- package/lib/tools/flash.js +32 -4
- package/lib/tools/generate.js +22 -0
- package/lib/tools/ioc-inspect.js +1 -1
- package/lib/tools/ioc-plan.js +56 -2
- package/lib/tools/ioc-verify.js +237 -0
- package/lib/tools/project-create.js +41 -5
- package/lib/tools/regs.js +8 -8
- package/lib/tools/route-plan.js +1 -1
- package/lib/tools/rtt.js +157 -34
- package/lib/tools/serial.js +737 -0
- package/lib/tools/watch.js +256 -0
- package/package.json +5 -4
- package/templates/openocd/stm32c0x.cfg +83 -0
- package/templates/openocd/stm32u0x.cfg +64 -0
- package/templates/register/CMakeLists.txt +2 -2
- package/templates/register/Core/Inc/rtt.h +37 -2
- package/templates/register/Core/Src/main.c +17 -25
- package/templates/register/Core/Src/rtt.c +85 -9
- package/templates/scaffold/RTT.md +6 -2
- package/templates/scaffold/STM32F103XX_FLASH.ld +3 -0
- package/templates/scaffold/openocd.cfg +5 -3
- package/templates/scaffold/vscode/launch.json +8 -4
- package/templates/serial/bridge.ps1 +477 -0
- package/docs/development-notes.md +0 -2487
- package/docs/dsh-stm32-plugin-/350/247/204/346/240/274.md +0 -673
- package/docs/logic-audit.md +0 -607
package/lib/engine/clock-plan.js
CHANGED
|
@@ -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 {
|
|
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 >
|
|
136
|
-
errors.push("SYSCLK " + formatHz(sysclk) + " 超过 F1 上限 " + formatHz(
|
|
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(
|
|
157
|
+
apb1Div = minimalDiv(activeFacts.apbDivs, sysclk, activeFacts.limits.apb1Hz)?.div ?? 16;
|
|
142
158
|
const apb1 = Math.round(sysclk / apb1Div);
|
|
143
|
-
if (apb1 >
|
|
144
|
-
errors.push("APB1 " + formatHz(apb1) + " 超过 F1 上限 " + formatHz(
|
|
145
|
-
"(APB1CLKDivider 至少要 " + needDivText(
|
|
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 >
|
|
150
|
-
errors.push("APB2 " + formatHz(apb2) + " 超过 F1 上限 " + formatHz(
|
|
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(
|
|
170
|
+
adcDiv = minimalDiv(activeFacts.adcDivs, apb2, activeFacts.limits.adcHz)?.div ?? 8;
|
|
155
171
|
const adc = Math.round(apb2 / adcDiv);
|
|
156
|
-
if (adc >
|
|
157
|
-
errors.push("ADC " + formatHz(adc) + " 超过 F1 上限 " + formatHz(
|
|
158
|
-
"(ADCPresc 至少要 " + needDivText(
|
|
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 ===
|
|
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 ?
|
|
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
|
|
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
|
|
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 ??
|
|
296
|
-
const detected = pllSourceById(hasHse ? "hse" : "hsi-div2") ??
|
|
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
|
|
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 :
|
|
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
|
|
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
|
|
394
|
-
for (const fact of
|
|
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
|
-
|
|
471
|
-
|
|
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(
|
|
499
|
+
parts.push(chain.pllSourceLabel + " 拼不出这一档");
|
|
475
500
|
}
|
|
476
501
|
}
|
|
477
502
|
// 换源提示:另一个可用源也许正好凑得出目标,但没说它能替代(HSI 精度差 / 要换晶振)。
|
|
478
|
-
if (!input.reachable && input.targetHz > 0 && input.targetHz <=
|
|
479
|
-
|
|
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
|
-
|
|
483
|
-
|
|
484
|
-
const pllIn = other.
|
|
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 <
|
|
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
|
-
",但 " +
|
|
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
|
-
|
|
498
|
-
|
|
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
|
-
|
|
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 ?
|
|
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",
|
|
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 :
|
|
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") ??
|
|
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
|
|
583
|
-
for (const fact of
|
|
626
|
+
const pllIn = pllInHzOf(source, hseHz);
|
|
627
|
+
for (const fact of activeFacts.muls) {
|
|
584
628
|
const sysclk = pllIn * fact.mul;
|
|
585
|
-
if (sysclk >
|
|
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(
|
|
633
|
+
const apb1 = minimalDiv(activeFacts.apbDivs, sysclk, activeFacts.limits.apb1Hz);
|
|
590
634
|
const apb2 = sysclk;
|
|
591
|
-
const adc = minimalDiv(
|
|
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 ===
|
|
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
|
+
}
|