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.
- package/README.md +92 -40
- package/README_EN.md +85 -36
- 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 +1948 -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 +884 -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 +94 -71
- package/lib/data/chips.js +38 -51
- package/lib/data/clock-db.js +830 -0
- package/lib/data/clock-f1.js +12 -45
- package/lib/data/cmsis-sources.js +264 -17
- package/lib/data/db-presets.js +252 -0
- package/lib/data/device-facts.js +274 -0
- package/lib/data/family.js +515 -0
- package/lib/data/firmware-packages.js +562 -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 +42 -1
- package/lib/data/stm32f1.js +95 -150
- package/lib/data/svd.js +643 -0
- package/lib/data/toolchain-config.js +0 -14
- package/lib/engine/assets.js +659 -0
- package/lib/engine/breakpoints.js +297 -0
- 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 +576 -22
- package/lib/engine/debug.js +99 -46
- package/lib/engine/doctor.js +162 -19
- package/lib/engine/facts-acquire.js +416 -0
- package/lib/engine/facts.js +134 -0
- package/lib/engine/firmware-install.js +176 -5
- package/lib/engine/firmware-official.js +451 -0
- package/lib/engine/flash.js +317 -76
- 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 +1247 -63
- 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 +4 -4
- package/lib/engine/probe-error.js +231 -0
- package/lib/engine/probe-session.js +347 -0
- package/lib/engine/probe.js +18 -3
- package/lib/engine/register-clock.js +41 -0
- package/lib/engine/register-gpio.js +115 -0
- package/lib/engine/register-linker.js +12 -7
- package/lib/engine/register-template.js +130 -45
- package/lib/engine/regs.js +43 -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 +758 -0
- package/lib/engine/scaffold.js +185 -18
- package/lib/engine/toolchain-gate.js +0 -4
- package/lib/engine/watch.js +227 -0
- package/lib/index.js +12 -2
- package/lib/skill/stm32-workflow.js +2 -2
- package/lib/tools/assets.js +272 -0
- package/lib/tools/cache.js +8 -0
- package/lib/tools/debug-session.js +41 -6
- package/lib/tools/debug.js +41 -11
- package/lib/tools/doctor.js +65 -4
- package/lib/tools/firmware-install.js +31 -6
- package/lib/tools/flash.js +47 -10
- package/lib/tools/generate.js +25 -0
- package/lib/tools/ioc-apply.js +2 -0
- package/lib/tools/ioc-inspect.js +2 -0
- package/lib/tools/ioc-plan.js +59 -2
- package/lib/tools/ioc-verify.js +237 -0
- package/lib/tools/project-create.js +63 -3
- package/lib/tools/regs.js +453 -61
- package/lib/tools/route-plan.js +3 -0
- package/lib/tools/rtt.js +470 -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 +8 -2
- package/templates/register/Core/Inc/rtt.h +138 -0
- package/templates/register/Core/Src/main.c +42 -25
- package/templates/register/Core/Src/rtt.c +373 -0
- package/templates/scaffold/RTT.md +90 -0
- package/templates/scaffold/STM32F103XX_FLASH.ld +3 -0
- package/templates/scaffold/cmake/user/CMakeLists.txt +7 -0
- package/templates/scaffold/openocd.cfg +5 -3
- package/templates/scaffold/vscode/launch.json +8 -4
- package/docs/development-notes.md +0 -2116
- package/docs/dsh-stm32-plugin-/350/247/204/346/240/274.md +0 -673
- package/docs/logic-audit.md +0 -607
- 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
|
+
}
|
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
|
}
|