dsh-stm32 0.1.6 → 0.1.8
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 +410 -517
- package/README_EN.md +410 -510
- package/client/client.js +4363 -24
- package/docs/reading-guide.md +62 -0
- package/lib/client.js +4363 -24
- package/lib/commands/register.js +5 -5
- package/lib/data/chips.js +4 -4
- package/lib/data/clock-db.js +24 -24
- package/lib/data/clock-f1.js +2 -2
- package/lib/data/cmsis-sources.js +6 -6
- package/lib/data/db-presets.js +4 -4
- package/lib/data/device-facts.js +6 -6
- package/lib/data/family.js +16 -16
- package/lib/data/firmware-packages.js +10 -10
- package/lib/data/install-guides.js +18 -18
- package/lib/data/ioc-presets.js +3 -3
- package/lib/data/ioc-schema.js +32 -32
- package/lib/data/rm-topics.js +6 -6
- package/lib/data/search-roots.js +62 -16
- package/lib/data/serial-config.js +7 -7
- package/lib/data/stm32f1.js +1 -1
- package/lib/data/svd.js +7 -7
- package/lib/data/toolchain-config.js +3 -3
- package/lib/engine/artifacts.js +123 -0
- package/lib/engine/assets.js +5 -5
- package/lib/engine/breakpoint-hits.js +73 -0
- package/lib/engine/breakpoints.js +5 -5
- package/lib/engine/build.js +73 -3
- package/lib/engine/cache.js +4 -4
- package/lib/engine/channel-tap.js +227 -0
- package/lib/engine/channels.js +48 -0
- package/lib/engine/clock-derived.js +2 -2
- package/lib/engine/clock-direct.js +3 -3
- package/lib/engine/clock-plan.js +7 -7
- package/lib/engine/clock-pllmn.js +6 -6
- package/lib/engine/clocks.js +192 -0
- package/lib/engine/cmake-sources.js +9 -9
- package/lib/engine/code-patch.js +5 -5
- package/lib/engine/cube-mx-guard.js +3 -3
- package/lib/engine/cube-programmer.js +4 -4
- package/lib/engine/cubemx-db.js +7 -7
- package/lib/engine/debug-session.js +58 -13
- package/lib/engine/debug.js +3 -3
- package/lib/engine/doctor.js +12 -12
- package/lib/engine/download.js +1 -1
- package/lib/engine/event-bus.js +158 -0
- package/lib/engine/event-log.js +335 -0
- package/lib/engine/facts-acquire.js +3 -3
- package/lib/engine/fault-hints.js +146 -0
- package/lib/engine/fetch.js +2 -2
- package/lib/engine/firmware-install.js +16 -16
- package/lib/engine/firmware-official.js +8 -8
- package/lib/engine/flash.js +22 -22
- package/lib/engine/fs-longpath.js +1 -1
- package/lib/engine/gdb-mi.js +7 -7
- package/lib/engine/generate-script.js +2 -2
- package/lib/engine/generate.js +17 -17
- package/lib/engine/hal-chip.js +7 -7
- package/lib/engine/interrupts.js +247 -0
- package/lib/engine/ioc-diff.js +369 -0
- package/lib/engine/ioc-plan.js +52 -52
- package/lib/engine/ioc-rules.js +9 -9
- package/lib/engine/ioc-sync.js +58 -0
- package/lib/engine/ioc-verify.js +34 -34
- package/lib/engine/msys2-install.js +81 -56
- package/lib/engine/panel-actions.js +103 -0
- package/lib/engine/pinout.js +140 -0
- package/lib/engine/probe-error.js +8 -8
- package/lib/engine/probe-info.js +95 -0
- package/lib/engine/probe-session.js +3 -3
- package/lib/engine/probe.js +47 -50
- package/lib/engine/progress.js +99 -0
- package/lib/engine/project-conf.js +199 -0
- package/lib/engine/project-export.js +1 -1
- package/lib/engine/register-clock.js +5 -5
- package/lib/engine/register-gpio.js +3 -3
- package/lib/engine/register-linker.js +7 -7
- package/lib/engine/register-template.js +22 -22
- package/lib/engine/regs.js +3 -3
- package/lib/engine/rm-extract.js +2 -2
- package/lib/engine/rm-sources.js +1 -1
- package/lib/engine/route-plan.js +9 -9
- package/lib/engine/rtt.js +18 -18
- package/lib/engine/scaffold.js +22 -22
- package/lib/engine/serial.js +24 -24
- package/lib/engine/session-context.js +19 -0
- package/lib/engine/source-slice.js +59 -0
- package/lib/engine/tar.js +1 -1
- package/lib/engine/text-file.js +1 -1
- package/lib/engine/thirdparty.js +3 -3
- package/lib/engine/tool-env.js +2 -2
- package/lib/engine/tool-events.js +119 -0
- package/lib/engine/toolchain-gate.js +8 -8
- package/lib/engine/usercode-merge.js +2 -2
- package/lib/engine/vscode-config.js +2 -2
- package/lib/engine/watch-admin.js +101 -0
- package/lib/engine/watch-record.js +39 -0
- package/lib/engine/watch-recorder.js +116 -0
- package/lib/engine/web-api.js +887 -5
- package/lib/engine/web-routes.js +18 -1
- package/lib/engine/workspace-memo.js +41 -0
- package/lib/engine/xcube-catalog.js +1 -1
- package/lib/index.js +72 -29
- package/lib/skill/stm32-workflow.js +1 -1
- package/lib/tools/assets.js +1 -1
- package/lib/tools/cache.js +2 -2
- package/lib/tools/debug-session.js +5 -5
- package/lib/tools/doctor.js +2 -2
- package/lib/tools/download.js +1 -1
- package/lib/tools/env-install.js +3 -3
- package/lib/tools/firmware-install.js +5 -5
- package/lib/tools/flash.js +8 -8
- package/lib/tools/generate.js +1 -1
- package/lib/tools/ioc-apply.js +10 -1
- package/lib/tools/ioc-plan.js +1 -1
- package/lib/tools/ioc-verify.js +11 -11
- package/lib/tools/project-create.js +32 -4
- package/lib/tools/project-dir.js +8 -2
- package/lib/tools/regs.js +10 -10
- package/lib/tools/route-plan.js +9 -9
- package/lib/tools/rtt.js +17 -9
- package/lib/tools/serial.js +30 -8
- package/lib/tools/watch.js +24 -2
- package/package.json +70 -70
- package/templates/scaffold/RTT.md +26 -34
package/lib/commands/register.js
CHANGED
|
@@ -30,7 +30,7 @@ import { formatFlashReport } from "../tools/flash.js";
|
|
|
30
30
|
*
|
|
31
31
|
* 为什么不能"先按空白 split 再剥引号":`"C:/Program Files/ST/demo proj"` 在第一步就被切成两段,
|
|
32
32
|
* 之后再怎么剥都拼不回原路径 —— projectDir 只剩半截,用户看到的却是「找不到 CMakeLists.txt」,
|
|
33
|
-
*
|
|
33
|
+
* 只会判定为工程故障。因此改为一次扫描:引号内不切词,同时移除引号。
|
|
34
34
|
* 引号没闭合直接抛错:静默按空白切等于把"用户写错了"伪装成"工程坏了"。
|
|
35
35
|
*
|
|
36
36
|
* 引号内不做反斜杠转义:Windows 路径里 `\` 到处都是(C:\Users\...),当转义符只会把路径吃掉;
|
|
@@ -163,7 +163,7 @@ function err(text) {
|
|
|
163
163
|
*
|
|
164
164
|
* 为什么命令要单独过:/stm32-build、/stm32-flash、/stm32-debug 不经过工具层,缺 gcc 或 openocd 时
|
|
165
165
|
* 用户只得到一屏 cmake / spawn 原始报错,与工具入口那句「缺 X,装法是 Y」差得太远;
|
|
166
|
-
* 而 /stm32-env
|
|
166
|
+
* 而 /stm32-env 虽然存在,却常被忽略。
|
|
167
167
|
*
|
|
168
168
|
* 为什么固定 envCheck=warn:命令是"人已经决定要干"的动作,门禁没资格替人拦掉,
|
|
169
169
|
* 但必须把「缺什么、怎么装」放在输出第一行。门禁自带 60 s 探测缓存,连着敲也不贵。
|
|
@@ -219,7 +219,7 @@ function envText(rows, configPath) {
|
|
|
219
219
|
lines.push(label + " ✘ 缺 " + missing + (install === undefined ? "" : " —— " + install));
|
|
220
220
|
}
|
|
221
221
|
// 缺件也是体检结果,不是命令错误;所以两种结尾都是 success。
|
|
222
|
-
lines.push(anyMissing ? "
|
|
222
|
+
lines.push(anyMissing ? "要装:回复「装」,插件执行 stm32_env_install 生成计划(不下载)" : "依赖齐备:/stm32-build 即可编译");
|
|
223
223
|
return { kind: "success", text: lines.join("\n") };
|
|
224
224
|
}
|
|
225
225
|
/** 注册七条斜杠命令;宿主没组合 commands 服务时直接返回(工具不受影响)。 */
|
|
@@ -278,7 +278,7 @@ export function registerCommands(ctx) {
|
|
|
278
278
|
lines.push("调试:停在 " + location);
|
|
279
279
|
lines.push("端口:" + String(session.port) + ",探针由调试会话占着(空闲 " + String(Math.round(session.idleTtlMs / 1000)) + " s 自动关)");
|
|
280
280
|
lines.push("· 读变量/寄存器:stm32_debug_eval(每次调用续租)");
|
|
281
|
-
lines.push("·
|
|
281
|
+
lines.push("· 探针交还 VS Code:/stm32-stop,或等本轮输出结束(turn/end 自动关闭)");
|
|
282
282
|
return withGateWarning(warning, { kind: "success", text: lines.join("\n") });
|
|
283
283
|
}
|
|
284
284
|
catch (error) {
|
|
@@ -292,7 +292,7 @@ export function registerCommands(ctx) {
|
|
|
292
292
|
description: "关掉调试会话、释放探针(之后可以在 VS Code 里按 F5)",
|
|
293
293
|
handler: async () => {
|
|
294
294
|
try {
|
|
295
|
-
const result = await debugSessions.stop("
|
|
295
|
+
const result = await debugSessions.stop("收到 /stm32-stop");
|
|
296
296
|
return { kind: "success", text: result.message };
|
|
297
297
|
}
|
|
298
298
|
catch (error) {
|
package/lib/data/chips.js
CHANGED
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* L1:引脚名合法性 + 由本机 CubeMX db 派生的引脚表。
|
|
3
3
|
*
|
|
4
|
-
* 用户 2026-10-31
|
|
4
|
+
* 用户 2026-10-31 决定删除内置表之后,这里**不再有任何内置芯片/引脚表**(原来的 CHIPS / KNOWN_CHIPS /
|
|
5
5
|
* findChip 已删)。原因:芯片事实的唯一来源是内置资源 device/f1/chips.json,而那份文件只有 pinCount
|
|
6
6
|
* (封装上有多少根脚),没有「这个封装有哪几根 GPIO」的清单——拿 pinCount 去猜 PA0-PB15… 等于又造一张表。
|
|
7
7
|
*
|
|
8
8
|
* 于是分工变成:
|
|
9
9
|
* 1. isKnownPin(pin):只校验**引脚名**是不是 STM32 的合法名(P + A..K + 0..15,虚拟引脚 VP_* 恒放行)。
|
|
10
|
-
*
|
|
10
|
+
* 该函数拦截手误(PA99、PZ9、PA-1),不再假定某个封装是否存在该引脚。
|
|
11
11
|
* 2. deriveChipPinTable():引脚**存在性**只认本机 CubeMX 的 db/mcu XML
|
|
12
12
|
* (<Pin Name="PA1" Position="3"/>,Position>0 才是真实封装引脚)。本机没装 CubeMX / 没有这个 XML 时
|
|
13
13
|
* kind="unknown",notes 里明说「没校验」,绝不拿猜测冒充实测。
|
|
@@ -24,7 +24,7 @@ const MAX_PIN_NUMBER = 15;
|
|
|
24
24
|
* 引脚名是否合法(未知/虚拟引脚一律放行)。
|
|
25
25
|
*
|
|
26
26
|
* 为什么不再按型号判「有没有这根脚」:那需要「封装 → 引脚清单」的事实,而内置资源只给了 pinCount。
|
|
27
|
-
* 真正的引脚存在性请用 deriveChipPinTable(本机 CubeMX db
|
|
27
|
+
* 真正的引脚存在性请用 deriveChipPinTable(本机 CubeMX db)——该函数给出的是实测清单,不是符号表。
|
|
28
28
|
*/
|
|
29
29
|
export function isKnownPin(pin) {
|
|
30
30
|
const raw = pin.trim().toUpperCase();
|
|
@@ -147,7 +147,7 @@ export function deriveChipPinTable(input) {
|
|
|
147
147
|
pins: [],
|
|
148
148
|
notes: [
|
|
149
149
|
"引脚表:没有本机 CubeMX db(" + why + "),引脚存在性不校验(isKnownPin 只查引脚名是否合法);" +
|
|
150
|
-
"插件不内置引脚表(内置资源里也不再有 db
|
|
150
|
+
"插件不内置引脚表(内置资源里也不再有 db 副本),需要逐脚校验就安装 CubeMX —— 插件直接读取其 db/mcu",
|
|
151
151
|
],
|
|
152
152
|
};
|
|
153
153
|
}
|
package/lib/data/clock-db.js
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
* - `db/mcu/<Mcu.Name>.xml` 的 `<Frequency>` 就是该型号的 SYSCLK 上限(MHz);
|
|
7
7
|
* - `db/mcu/IP/RCC-*.xml`(Modes)里 `<RefParameter Name="PLLMUL" Type="list">` 的
|
|
8
8
|
* `<PossibleValue Value="RCC_PLL_MUL2" Comment="2"/>` 就是倍频枚举,分频同理。
|
|
9
|
-
*
|
|
9
|
+
* 抄写快照的局限与预设表相同:更换芯片族或 db 版本后即失真(F1 的 `S_TIM2_CH1_ETR` 已出现过一次错误)。
|
|
10
10
|
*
|
|
11
11
|
* 早先以为「APB1/APB2/ADC 的频率上限 db 里没有」,实测是错的:`RCC-*_Modes.xml` 里
|
|
12
12
|
* `<RefParameter Name="APB1Freq_Value" Max="30000000">`、`APB2Freq_Value`、`ADCFreq_Value`、
|
|
@@ -50,7 +50,7 @@ function enumOf(text, parameterName) {
|
|
|
50
50
|
if (open === null)
|
|
51
51
|
return [];
|
|
52
52
|
// 自闭合 = integer 型(PLLM/PLLN 在 F4 上就是 Min=2 Max=63 这种),没有 PossibleValue。
|
|
53
|
-
//
|
|
53
|
+
// 不加阻止时,正则会把**下一个** RefParameter 的块当成当前块的 children —— F4 的 PLLM 曾因此拿到 PLLP 的枚举名。
|
|
54
54
|
if (open[0].trimEnd().endsWith("/>"))
|
|
55
55
|
return [];
|
|
56
56
|
const from = (open.index ?? 0) + open[0].length;
|
|
@@ -75,7 +75,7 @@ function enumOf(text, parameterName) {
|
|
|
75
75
|
*
|
|
76
76
|
* 为什么需要:这些名字**不带** Freq_Value 后缀(H5 的 `EPOD_VALUE` 就是 PLL 源频率信号),
|
|
77
77
|
* 只看名字认不出是派生量。真机证据(2026-11 H5 @250 MHz 往返):计划没碰 `RCC.EPOD_VALUE`,
|
|
78
|
-
* CubeMX
|
|
78
|
+
* CubeMX 保存时把该值从 4 MHz 改成 8 MHz(跟随 PLL 源换成 HSE),ioc_verify 却记成 valueChanged
|
|
79
79
|
* → benign 翻 false。名字从 db 取而不是手抄,才能覆盖 27 族。
|
|
80
80
|
*/
|
|
81
81
|
export function readClockTreeDerivedNames(db, clockTree) {
|
|
@@ -100,14 +100,14 @@ export function readClockTreeDerivedNames(db, clockTree) {
|
|
|
100
100
|
*
|
|
101
101
|
* 判据(全部来自 db/plugins/clock/<ClockTree>.xml):
|
|
102
102
|
* 1. 找 refParameter=SYSCLKSource(WL3 叫 ROOTClkSource)的 multiplexor;
|
|
103
|
-
* 2.
|
|
103
|
+
* 2. 该多路选择器的每条 <Input refValue=...> 是一条源(refValue 决定是 hse/hsi/rc64/…);
|
|
104
104
|
* 3. 顺着 from= 往回走,只有 type="devisor" 的元素才算这一路的分频器,走到源(fixedSource/variedSource)为止。
|
|
105
105
|
* C0 的 HSISYSCLKDivider 就在 HSI → SysClkSource 中间,所以仍能读到;WB0/WL3 走回去第一个就是源,读出来是空。
|
|
106
106
|
*
|
|
107
|
-
*
|
|
108
|
-
* - null = 没读到时钟树(db 里没有该树的 xml、或 xml 里没有 SYSCLK 多路选择器)→
|
|
109
|
-
* - 空 Map = **读到了**、而且这些源确实没有 SYSCLK 分频器(WB0/WL3 就是这样)→
|
|
110
|
-
* 早先两者都返回空 Map,WB0
|
|
107
|
+
* 返回值语义需区分(关系到结果是否可信):
|
|
108
|
+
* - null = 没读到时钟树(db 里没有该树的 xml、或 xml 里没有 SYSCLK 多路选择器)→ 调用方可以按名字回退;
|
|
109
|
+
* - 空 Map = **读到了**、而且这些源确实没有 SYSCLK 分频器(WB0/WL3 就是这样)→ 调用方必须采信,不能回退。
|
|
110
|
+
* 早先两者都返回空 Map,WB0 因此仍走按名字推测的回退路径,把 CLKSYS 预分频当成 SYSCLK 分频。
|
|
111
111
|
*/
|
|
112
112
|
export function readClockTreeSysclkDividers(db, clockTree) {
|
|
113
113
|
if (clockTree === "")
|
|
@@ -189,7 +189,7 @@ function divsWithName(text, names) {
|
|
|
189
189
|
* SYSCLK 走 PLL 的哪一路输出(PLLP 还是 PLLR)。
|
|
190
190
|
*
|
|
191
191
|
* 从时钟树定义读:db/plugins/clock/<ClockTree>.xml 里 Signal id="PLLCLK" 的 refParameter
|
|
192
|
-
*
|
|
192
|
+
* 即传入 SYSCLK 多路选择器的那一路。实测 L4RS 与 U5 都指向 PLLRCLKFreq_Value,
|
|
193
193
|
* 而 U5 的 PLLP 只有 PLLPoutputFreq_Value(供 SAI/其它外设)——按 PLLP 规划会把
|
|
194
194
|
* SYSCLK 接到错的分频上。读不到(老 db)返回 null,调用方回退旧启发式。
|
|
195
195
|
*/
|
|
@@ -216,8 +216,8 @@ export function readSysclkPllOutput(db, clockTree) {
|
|
|
216
216
|
* 判据是 db 里有没有 Cortex 的选择/分频参数(CortexCLockSelectionVirtual / CortexCLockSelection /
|
|
217
217
|
* Cortex_Div)。有就不能写:那几档(÷1 与 ÷8 都在选项里,.ioc 里的默认值不一定是 CubeMX 保存时
|
|
218
218
|
* 实际用的那个)—— 实测四次往返都很任性:H5 写 HCLK 被改成 HCLK÷8,U5 写 HCLK÷8 又被改回 HCLK,
|
|
219
|
-
*
|
|
220
|
-
* verify
|
|
219
|
+
* 同一个键两次往返方向相反。这类「CubeMX 按树自行计算」的派生量交由 CubeMX 计算,本插件只写确定等于 HCLK 的那些键,
|
|
220
|
+
* verify 中该键归到 derivedRecomputed(不参与 benign)。
|
|
221
221
|
*/
|
|
222
222
|
function cortexFollowsHclk(text) {
|
|
223
223
|
return !/\bName="(?:CortexCLockSelectionVirtual|CortexCLockSelection|Cortex_Div)"/u.test(text);
|
|
@@ -250,7 +250,7 @@ function numAttr(attrs, key) {
|
|
|
250
250
|
* 同名参数在 Modes xml 里常常有多个**变体**,各自带 `<Condition Expression="scale1">`
|
|
251
251
|
* (G0/U0 的 ADC 35000000/16000000/80000000、G4 的 APB1 150M/170M 都是这种)。
|
|
252
252
|
* 这里取「最小的 Min + 最大的 Max」:CubeMX 允许多少就给多少,规划出来的档位不会因为
|
|
253
|
-
*
|
|
253
|
+
* 取错变体而被无故拒绝;最终仍受后面的 SYSCLK 上限与 CubeMX 自身校验约束。
|
|
254
254
|
* 名字按顺序试,先读出 Max 的优先(APB1Freq_Value 优先于单 APB 族的 APBFreq_Value)。
|
|
255
255
|
*/
|
|
256
256
|
function limitOf(text, names) {
|
|
@@ -466,7 +466,7 @@ export function readClockDbFacts(db, facts) {
|
|
|
466
466
|
: "内部 RC:" + (id === "hsi" ? "" : "二分频后") + "频率以 .ioc 的 RCC.HSI_VALUE 为准(db 不写各族 HSI 频率)",
|
|
467
467
|
});
|
|
468
468
|
}
|
|
469
|
-
// F0/L0 这类族只有 RCC_PLLSOURCE_HSI
|
|
469
|
+
// F0/L0 这类族只有 RCC_PLLSOURCE_HSI 一档,硬件上该源以 HSI/2 进入 PLL(不是 HSI 直连):
|
|
470
470
|
// 少了这一步,规划会把 HSI 8 MHz 当 8 MHz 源算,CubeMX 回写时按 /2 重算 → 频率对不上(F0 实测 48→24 MHz)。
|
|
471
471
|
if (sources.some((source) => source.id === "hsi") && !sources.some((source) => source.id === "hsi-div2")) {
|
|
472
472
|
for (const source of sources) {
|
|
@@ -484,7 +484,7 @@ export function readClockDbFacts(db, facts) {
|
|
|
484
484
|
const ahbDivs = toDivs(enumOf(text, "AHBCLKDivider"));
|
|
485
485
|
const apb2Divs = toDivs(enumOf(text, "APB2CLKDivider"));
|
|
486
486
|
const adcDivs = toDivs(enumOf(text, "ADCPresc"));
|
|
487
|
-
// db 里某个 RefParameter 的 DefaultValue(Hz):HSE_VALUE/PLL64_VALUE
|
|
487
|
+
// db 里某个 RefParameter 的 DefaultValue(Hz):HSE_VALUE/PLL64_VALUE 这类「源标称频率」以此作为缺省。
|
|
488
488
|
const defaultOf = (name) => {
|
|
489
489
|
for (const block of refParamBlocks(text)) {
|
|
490
490
|
if (attrOf(block.attrs, "Name") !== name)
|
|
@@ -496,7 +496,7 @@ export function readClockDbFacts(db, facts) {
|
|
|
496
496
|
return null;
|
|
497
497
|
};
|
|
498
498
|
// direct 模型:SYSCLK 直接取源,没有 PLL。能当源的只有 SYSCLKSource 里的 HSE/HSI
|
|
499
|
-
// (LSE/LSI 是 32 kHz 级,规划到 MHz
|
|
499
|
+
// (LSE/LSI 是 32 kHz 级,规划到 MHz 目标用不上,也不该作为「无法命中就选最近档」的回退)。
|
|
500
500
|
// 无线族(WB0/WL3)不叫 SYSCLKSource:WL3 是 ROOTClkSource;WL3 的 HSE 直连是 DIRECT_HSE,
|
|
501
501
|
// 内部 64 MHz RC 是 RC64MPLL(频率取 db 的 PLL64_VALUE,不读 .ioc)。
|
|
502
502
|
const directSourceEnum = enumAlias(text, ["SYSCLKSource", "ROOTClkSource"]);
|
|
@@ -516,7 +516,7 @@ export function readClockDbFacts(db, facts) {
|
|
|
516
516
|
iocValue: entry.value,
|
|
517
517
|
// 真值从 .ioc 的 RCC.HSE_VALUE / RCC.HSI_VALUE 读;这里给 db 的 DefaultValue 当缺省。
|
|
518
518
|
defaultHz: id === "hse" ? hseDefaultHz : id === "hsi" ? hsiDefaultHz : rc64Hz,
|
|
519
|
-
// RC64MPLL 是固定频率源,.ioc
|
|
519
|
+
// RC64MPLL 是固定频率源,.ioc 没有该源的频率键(PLL64_VALUE 是派生值,写入该键与自身计算冲突)。
|
|
520
520
|
...(id === "rc64" ? {} : { hzKey: id === "hse" ? "RCC.HSE_VALUE" : "RCC.HSI_VALUE" }),
|
|
521
521
|
selectable: true,
|
|
522
522
|
note: id === "hse"
|
|
@@ -528,7 +528,7 @@ export function readClockDbFacts(db, facts) {
|
|
|
528
528
|
}
|
|
529
529
|
// 源分频:哪一路有分频器、键叫什么,全从时钟树走(readClockTreeSysclkDividers)。
|
|
530
530
|
// 走不出来(db 没有该树的 xml)才回落到按名字猜的老路——WB0/WL3 的 SYSCLK32/64Divider
|
|
531
|
-
// 是 CLKSYS
|
|
531
|
+
// 是 CLKSYS 预分频而非 SYSCLK 分频,按名字推测在无线族上不成立,因此只能作为回退。
|
|
532
532
|
const srcDivBySource = {};
|
|
533
533
|
const treeDividers = readClockTreeSysclkDividers(db, facts.clockTree);
|
|
534
534
|
for (const [source, names] of treeDividers ?? new Map()) {
|
|
@@ -567,11 +567,11 @@ export function readClockDbFacts(db, facts) {
|
|
|
567
567
|
derivedNames.push(name);
|
|
568
568
|
}
|
|
569
569
|
let model = muls.length > 0 ? "pllmul" : pllM.length > 0 || pllN !== null ? "pllmn" : directSources.length > 0 ? "direct" : "unknown";
|
|
570
|
-
// direct
|
|
570
|
+
// direct 模型仅对「SYSCLK 直接取一个固定标称频率的源」成立。以下两种情况形似 direct,实为假直连:
|
|
571
571
|
// · 分相 PLL(H7:DIVM1/DIVN1/DIVP1 + PLL1/2/3 三套 6 参数,SYSCLKSource 里也有 PLLCLK);
|
|
572
572
|
// · MSI 直连(U3:SYSCLKSource 只有 MSIS/HSI/HSE,MSIS 最高 96 MHz、频率可配,不是固定标称值)。
|
|
573
573
|
// 两种都归到 unknown 并写清原因:宁可明确拒绝,也不给一个「按 HSI 猜出来」的档位 ——
|
|
574
|
-
//
|
|
574
|
+
// 此类计划写入 .ioc 后,CubeMX 会据此算出更低的 SYSCLK,verify 还可能因派生键被重算而无法发现该错误。
|
|
575
575
|
let unknownNote = "";
|
|
576
576
|
if (model === "direct") {
|
|
577
577
|
const refNames = [...new Set([...text.matchAll(/<RefParameter[^>]*\bName="([A-Za-z0-9_]+)"/gu)].map((matched) => matched[1]))];
|
|
@@ -613,8 +613,8 @@ export function readClockDbFacts(db, facts) {
|
|
|
613
613
|
: {
|
|
614
614
|
apb1Hz: apb1Max,
|
|
615
615
|
apb2Hz: apb2?.max ?? apb1Max,
|
|
616
|
-
// 没有独立 ADC 上限的族(L1 的 ADCFreq_Value 没有 Max)先按 APB2
|
|
617
|
-
//
|
|
616
|
+
// 没有独立 ADC 上限的族(L1 的 ADCFreq_Value 没有 Max)先按 APB2 上限处理,
|
|
617
|
+
// adcDivs 为空时 planner 不写 ADCPresc,此条不生效。
|
|
618
618
|
adcHz: adcLimit?.max ?? apb2?.max ?? apb1Max,
|
|
619
619
|
};
|
|
620
620
|
if (busLimits === null) {
|
|
@@ -632,7 +632,7 @@ export function readClockDbFacts(db, facts) {
|
|
|
632
632
|
...(vcoIn?.min === null || vcoIn?.min === undefined ? {} : { inMinHz: vcoIn.min }),
|
|
633
633
|
...(vcoIn?.max === null || vcoIn?.max === undefined ? {} : { inMaxHz: vcoIn.max }),
|
|
634
634
|
};
|
|
635
|
-
// SYSCLK 源按 db 的 RefParameter 名字决定:有 SYSCLKSourceVirtual
|
|
635
|
+
// SYSCLK 源按 db 的 RefParameter 名字决定:有 SYSCLKSourceVirtual 时只能写该键(F303),
|
|
636
636
|
// 无线族(WL3)根本没有 SYSCLKSource,源键叫 ROOTClkSource。
|
|
637
637
|
const sysclkSourceKey = /\bName="SYSCLKSourceVirtual"/u.test(text)
|
|
638
638
|
? "RCC.SYSCLKSourceVirtual"
|
|
@@ -668,7 +668,7 @@ export function readClockDbFacts(db, facts) {
|
|
|
668
668
|
srcDivSources,
|
|
669
669
|
srcDivBySource,
|
|
670
670
|
// 读不到 APB 分频就留空:WB0/WL3 根本没有 APB1CLKDivider,早先这里填 RCC_HCLK_DIV1..16
|
|
671
|
-
// 的假枚举,planner
|
|
671
|
+
// 的假枚举,planner 会把这些假枚举写入 .ioc,CubeMX 当成未知键丢弃(= 计划里的键凭空消失)。
|
|
672
672
|
apbDivs,
|
|
673
673
|
hasApbDivider: apbDivs.length > 0,
|
|
674
674
|
ahbDivs,
|
|
@@ -726,7 +726,7 @@ export const PLL_VCO_LIMITS = {
|
|
|
726
726
|
export function clockFactsFromDb(facts, familyId) {
|
|
727
727
|
const family = familyId.trim().toUpperCase();
|
|
728
728
|
// SYSCLK 上限三级回退:MCU xml 的 <Frequency> → db 的 SYSCLKFreq_VALUE Max → APB2 上限。
|
|
729
|
-
//
|
|
729
|
+
// 第三级为回退(G4/U0 的 <Frequency> 读出为 0,但 SYSCLKFreq_VALUE Max 存在)。
|
|
730
730
|
const sysclkMaxNow = facts.sysclkMaxHz > 0 ? facts.sysclkMaxHz : facts.sysclkMaxDbHz;
|
|
731
731
|
const limits = BUS_LIMITS[family] ??
|
|
732
732
|
facts.busLimits ??
|
package/lib/data/clock-f1.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* STM32F1 时钟树事实表(只放"书上写的数字",不放算法)。
|
|
3
3
|
*
|
|
4
|
-
*
|
|
4
|
+
* 单独成表的原因:F1 的时钟上限、PLL 可选倍频、外设所属总线,均属芯片事实,
|
|
5
5
|
* 而"给定目标频率怎么挑组合"是策略(src/engine/clock-plan.ts)。事实和策略分开,
|
|
6
6
|
* 以后扩 F0/F4 只换这张表,算法不用动。
|
|
7
7
|
*
|
|
@@ -15,7 +15,7 @@ export const F1_PLL_SOURCES = [
|
|
|
15
15
|
iocValue: "RCC_PLLSOURCE_HSE",
|
|
16
16
|
defaultHz: 8_000_000,
|
|
17
17
|
selectable: true,
|
|
18
|
-
note: "
|
|
18
|
+
note: "外部晶振(开发板 8 MHz,值料号 HSE 范围 4–16 MHz)。精度由晶振决定,通常 ≤50 ppm,UART 波特率精度由晶振保证。",
|
|
19
19
|
},
|
|
20
20
|
{
|
|
21
21
|
id: "hsi-div2",
|
|
@@ -19,7 +19,7 @@ const JS_DELIVR_FASTLY = (repo, ref, file) => "https://fastly.jsdelivr.net/gh/ST
|
|
|
19
19
|
const JS_DELIVR_CDN = (repo, ref, file) => "https://cdn.jsdelivr.net/gh/STMicroelectronics/" + repo + "@" + ref + "/" + file;
|
|
20
20
|
const RAW_GITHUB = (repo, ref, file) => "https://raw.githubusercontent.com/STMicroelectronics/" + repo + "/" + ref + "/" + file;
|
|
21
21
|
const GHPROXY = (repo, ref, file) => "https://ghproxy.net/https://raw.githubusercontent.com/STMicroelectronics/" + repo + "/" + ref + "/" + file;
|
|
22
|
-
/** 一个文件的多条下载路线,顺序 = 优先级(实测 jsDelivr
|
|
22
|
+
/** 一个文件的多条下载路线,顺序 = 优先级(实测 jsDelivr 最稳定,raw 作为回退)。 */
|
|
23
23
|
export function sourceUrls(repo, ref, file) {
|
|
24
24
|
return [JS_DELIVR_FASTLY(repo, ref, file), JS_DELIVR_CDN(repo, ref, file), RAW_GITHUB(repo, ref, file), GHPROXY(repo, ref, file)];
|
|
25
25
|
}
|
|
@@ -36,10 +36,10 @@ export function sourceUrls(repo, ref, file) {
|
|
|
36
36
|
* 2026-11-09 补 H5/H7/L4+/L5/U3/U5/WBA/WL 时逐族实测过:设备头 / system 头 / system.c /
|
|
37
37
|
* 启动文件 / 内核头在 cmsis-device-<族>@master 与 STM32Cube<族>@master 上都是 200;
|
|
38
38
|
* 唯一的例外是 STM32CubeU3 的 cmsis_gcc.h 在 jsDelivr 上 403(上游树缓存没刷),
|
|
39
|
-
* raw.githubusercontent 与 ghproxy
|
|
39
|
+
* raw.githubusercontent 与 ghproxy 两条回退路线正常——sourceUrls 的四条路线即为此类单点故障准备。
|
|
40
40
|
*
|
|
41
41
|
* 哈希钉:只有 F1 那张表(DEVICE_HEADER_SHA256 / STARTUP_SHA256 / CORE_HEADER_SHA256)
|
|
42
|
-
*
|
|
42
|
+
* 是逐文件实测的;其他族仅锁定形状(minBytes + markers),真实哈希在下载时登记进缓存索引。
|
|
43
43
|
* 这与 SVD 的处理同口径:上游同族文件会随版本漂移,锁死哈希会让"上游发新版"变成插件故障。
|
|
44
44
|
*/
|
|
45
45
|
export const CMSIS_FAMILIES = {
|
|
@@ -629,7 +629,7 @@ export function cmsisTemplatePlan(input) {
|
|
|
629
629
|
urls: sourceUrls(spec.deviceRepo, spec.deviceRef, spec.deviceTemplatesDir + "/" + spec.systemC),
|
|
630
630
|
minBytes: 1_000,
|
|
631
631
|
markers: ["SystemInit"],
|
|
632
|
-
// SYSTEM_C_SHA256 只是 F1
|
|
632
|
+
// SYSTEM_C_SHA256 只是 F1 那一份的实测值;其他族按形状校验(见 CMSIS_FAMILIES 注释)。
|
|
633
633
|
sha256: spec.family === "F1" ? SYSTEM_C_SHA256 : undefined,
|
|
634
634
|
});
|
|
635
635
|
targets.push({
|
|
@@ -670,14 +670,14 @@ export function cmsisTemplatePlan(input) {
|
|
|
670
670
|
minBytes: 500,
|
|
671
671
|
markers: coreHeaderMarkers[header] ?? ["__CMSIS", "__CORE_"],
|
|
672
672
|
// CORE_HEADER_SHA256 是 F1 那份(STM32CubeF1@master)的实测值。各族的 CMSIS 内核版本不同
|
|
673
|
-
// (U0 的 cmsis_compiler.h 与 F1
|
|
673
|
+
// (U0 的 cmsis_compiler.h 与 F1 内容差一版),以 F1 的哈希校验其他族会全部失败。
|
|
674
674
|
sha256: spec.family === "F1" ? CORE_HEADER_SHA256[header] : undefined,
|
|
675
675
|
});
|
|
676
676
|
}
|
|
677
677
|
const license = "STMicroelectronics CMSIS device headers / startup / CMSIS core headers — Apache License 2.0."
|
|
678
678
|
+ "\n来源仓库:github.com/STMicroelectronics/" + spec.deviceRepo + "(" + spec.deviceRef + ")、"
|
|
679
679
|
+ "github.com/STMicroelectronics/" + spec.cmsisRepo + "(" + spec.cmsisRef + ")。"
|
|
680
|
-
+ "\n
|
|
680
|
+
+ "\n本目录是下载缓存,不是插件源码;删除该目录不影响插件,下次使用时重新下载。\n";
|
|
681
681
|
// 0.2:条目按 line+档位分(cmsis:F1:103xb),目录同名。没有 chip 的旧调用退化成 startup 文件名。
|
|
682
682
|
const groupKey = chip !== null
|
|
683
683
|
? cmsisGroupKey(chip)
|
package/lib/data/db-presets.js
CHANGED
|
@@ -10,11 +10,11 @@
|
|
|
10
10
|
* - db 推不出来的留手写表:`TIMx:timebase`(不占脚、只有 Prescaler/Period 取值)、
|
|
11
11
|
* `DMA:<IP>`(DMA 请求表不在 db 的引脚信息里)、`ADC1:1,4,5`(多 Rank 扫描的通道顺序)。
|
|
12
12
|
*
|
|
13
|
-
*
|
|
13
|
+
* 两处「.ioc 写法与 db 不同」的差异(语料实证:CubeMX 官方板级 .ioc 504 份):
|
|
14
14
|
* 1. 定时器通道:db 写 `TIM2_CH1`,.ioc 里的 <pin>.Signal 要写 `S_TIM2_CH1`(共享信号加 S_ 前缀);
|
|
15
15
|
* 2. ADC 通道:db 写 `ADC1_IN1`,.ioc 里统一写 `ADCx_IN1`(x = 任意 ADC 实例),
|
|
16
16
|
* 具体是哪个 ADC 由 SH 块的 `ADC1_IN1,IN1` 表达。
|
|
17
|
-
*
|
|
17
|
+
* 这两条不可推测:写错会被 CubeMX 静默丢弃(§60 记录过该问题)。
|
|
18
18
|
*/
|
|
19
19
|
import { logicalPinName } from "../engine/cubemx-db.js";
|
|
20
20
|
const SERIAL_RE = /^(USART|UART|LPUART)([0-9]+)$/u;
|
|
@@ -34,8 +34,8 @@ function pinOrder(hit) {
|
|
|
34
34
|
/**
|
|
35
35
|
* db 里带某条复用例信号的引脚,按端口/脚号升序。
|
|
36
36
|
*
|
|
37
|
-
*
|
|
38
|
-
*
|
|
37
|
+
* 使用 `logicalPinName` 的原因:直接丢弃带后缀的引脚会造成误删。F1 的 PA0 在 db 里叫 PA0-WKUP,
|
|
38
|
+
* 该引脚即 TIM2_CH1 的默认脚。按「带 - 就跳过」会丢弃整根引脚(F1 上 TIM2 将无法选到引脚)。
|
|
39
39
|
*/
|
|
40
40
|
function pinsWithSignal(facts, signal) {
|
|
41
41
|
const wanted = signal.trim().toUpperCase();
|
package/lib/data/device-facts.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* L1:设备事实(device facts)——唯一来源是本地内置资源里的 device/f1/chips.json。
|
|
3
3
|
*
|
|
4
|
-
* 用户 2026-10-31
|
|
4
|
+
* 用户 2026-10-31 决定删除内置表:插件不再自带任何手写芯片事实表。型号 → 容量档 /
|
|
5
5
|
* 启动文件 / 设备宏 / 设备头 / Flash / RAM / 引脚数,全部取自随插件包发布的 assets/device/<族>/chips.json
|
|
6
6
|
* (flat 布局,2026-11 起不再走独立资源仓与联网下载)。
|
|
7
7
|
*
|
|
@@ -18,9 +18,9 @@ import fs from "node:fs";
|
|
|
18
18
|
import path from "node:path";
|
|
19
19
|
import { ASSETS_DEVICE_FACTS_FILE, ASSETS_REFRESH_HINT, errText, readLocalManifest } from "../engine/assets.js";
|
|
20
20
|
import { familyIdOfPart, familyProfileOf } from "./family.js";
|
|
21
|
-
/** chips.json 在内置资源里的相对路径(manifest 的 profiles.core 也按 device/**
|
|
21
|
+
/** chips.json 在内置资源里的相对路径(manifest 的 profiles.core 也按 device/** 收录该文件)。 */
|
|
22
22
|
export const DEVICE_FACTS_REL = ASSETS_DEVICE_FACTS_FILE;
|
|
23
|
-
/**
|
|
23
|
+
/** 无缓存/无该芯片时提供给用户的可执行提示(所有结构化错误均携带该提示)。 */
|
|
24
24
|
export const DEVICE_FACTS_HINT = ASSETS_REFRESH_HINT;
|
|
25
25
|
/** 每个族的 chips.json 各缓存一份(键里带 path:size:mtimeMs)。 */
|
|
26
26
|
const cache = new Map();
|
|
@@ -87,7 +87,7 @@ export function defineSuffix(group) {
|
|
|
87
87
|
/**
|
|
88
88
|
* 一条 chips.json 记录 → DeviceFactsChip。
|
|
89
89
|
* 关键字段(cpn / line / group / Flash / RAM / 引脚数)缺一个就丢掉:
|
|
90
|
-
*
|
|
90
|
+
* 不完整事实比缺失事实更危险——会算出错误的链接脚本内存布局。
|
|
91
91
|
* 启动文件 / 设备宏 / 设备头 缺失时按 line + group 现算(见 namingFrom)。
|
|
92
92
|
*/
|
|
93
93
|
function chipFrom(value) {
|
|
@@ -145,7 +145,7 @@ function emptyFacts(filePath, version, error) {
|
|
|
145
145
|
error,
|
|
146
146
|
};
|
|
147
147
|
}
|
|
148
|
-
/** 解析 chips.json 文本 → DeviceFacts
|
|
148
|
+
/** 解析 chips.json 文本 → DeviceFacts(纯函数,测试可直接传入字符串)。 */
|
|
149
149
|
export function parseDeviceFacts(text, filePath, version = "") {
|
|
150
150
|
let parsed;
|
|
151
151
|
try {
|
|
@@ -200,7 +200,7 @@ export function loadDeviceFacts(env = process.env) {
|
|
|
200
200
|
* STM32L4+ → device/l4+/chips.json;STM32WBA → device/wba/chips.json。
|
|
201
201
|
*
|
|
202
202
|
* 目录名取族画像的族段(小写、保留 +)—— 资源脚本就是这么建的目录。
|
|
203
|
-
* 不能按「前两个字符」推:WBA 会被推成 wb、L4+ 会被推成 l4
|
|
203
|
+
* 不能按「前两个字符」推:WBA 会被推成 wb、L4+ 会被推成 l4(均属于其他族,读到的芯片表是错的)。
|
|
204
204
|
*/
|
|
205
205
|
export function familyFactsRelOf(familyId) {
|
|
206
206
|
const raw = familyId.trim().toUpperCase();
|
package/lib/data/family.js
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
* 这些事实**CubeMX 的 db 里没有**(db 只给族 id/内核/主频/封装/引脚/IP),
|
|
7
7
|
* 所以集中放在这里,按族查一次。
|
|
8
8
|
*
|
|
9
|
-
* 反过来,族 id / 内核 / 最高主频 / Flash / RAM /
|
|
9
|
+
* 反过来,族 id / 内核 / 最高主频 / Flash / RAM / 引脚数**不进这张表**:这些字段由
|
|
10
10
|
* engine/cubemx-db.ts 的 parseMcuXml 从本机 db/mcu/<Mcu.Name>.xml 读(Family/Core/
|
|
11
11
|
* Frequency/Flash/Ram/IONb)。db 一升级,那些数字自动跟着走,不用改代码。
|
|
12
12
|
*
|
|
@@ -16,7 +16,7 @@
|
|
|
16
16
|
* f0x f1x f2x f3x f4x f7x g0x g4x h7x(+dual_bank) l0(+dual_bank) l1(+dual_bank) l4x
|
|
17
17
|
* l5x mp13x mp15x u5x wbx wlx x5x_common xl w108xx。
|
|
18
18
|
* —— 没有 C0/H5/N6/U0/U3/WBA/WB0/WL3/MP2 的专用脚本,这些族 openocdTarget = null,
|
|
19
|
-
*
|
|
19
|
+
* 烧录/调试时给明确拒绝理由,而不是以其他族的 target 强行连接。
|
|
20
20
|
*
|
|
21
21
|
* 能力闸门(capabilities)是**诚实降级**:值为 false 表示插件这条路线还没按该族实现,
|
|
22
22
|
* 调用方应当直接报"不支持"并说清原因,绝不能悄悄用 F1 的表去凑。
|
|
@@ -72,7 +72,7 @@ const PENDING_PRESET = ".ioc 外设预设表目前只有 F1(下一步按族从
|
|
|
72
72
|
const PENDING_CLOCK = "时钟规划目前只按 F1 的 RCC/PLL 实现";
|
|
73
73
|
const NO_SVD = "内置资源只有 F1 的 SVD(中断名/寄存器名校验暂不可用)";
|
|
74
74
|
/**
|
|
75
|
-
*
|
|
75
|
+
* 每项能力「缺什么」的简要说明(供工具报错使用,不用于文档)。
|
|
76
76
|
*
|
|
77
77
|
* 为什么不复用族 note:note 是给人看的整段理由(HAL/寄存器/预设/时钟/SVD 全塞在一条里),
|
|
78
78
|
* 工具拒绝某个参数时只需要那一项的原因。之前直接把 note 拼进 errors,一条报错 300 多字,
|
|
@@ -81,7 +81,7 @@ const NO_SVD = "内置资源只有 F1 的 SVD(中断名/寄存器名校验暂
|
|
|
81
81
|
export const CAPABILITY_GAPS = {
|
|
82
82
|
halScaffold: "HAL 建工程(模板/启动文件/链接脚本/设备宏)按 21 个单核族的固件包实现",
|
|
83
83
|
registerScaffold: "寄存器版模板(CMSIS 头 + 启动文件)覆盖内置资源已有芯片表的 21 族:C0/F0/F1/F2/F3/F4/F7/G0/G4/H5/H7/L0/L1/L4/L4+/L5/U0/U3/U5/WBA/WL",
|
|
84
|
-
iocPresets: "手写 .ioc 预设表只有 F1
|
|
84
|
+
iocPresets: "手写 .ioc 预设表只有 F1(其他族靠 db 派生 USART/UART/LPUART,TIM/ADC/DMA 仍需手写键)",
|
|
85
85
|
clockPlan: "时钟规划只按 F1 的 RCC/PLL 键实现",
|
|
86
86
|
svdValidation: "中断名/寄存器名校验要该族的 SVD,内置资源目前只有 F1 的",
|
|
87
87
|
};
|
|
@@ -213,7 +213,7 @@ export function familyProfiles() {
|
|
|
213
213
|
}
|
|
214
214
|
/**
|
|
215
215
|
* 型号 → 族 id。只做字符串判定,不查 db(db 里 MCU xml 的 Family 属性是更权威的来源,
|
|
216
|
-
* 见 engine/cubemx-db.ts 的 parseMcuXml
|
|
216
|
+
* 见 engine/cubemx-db.ts 的 parseMcuXml;本函数用于没有 db 的场合与 .ioc 缺失时的回退)。
|
|
217
217
|
*
|
|
218
218
|
* 例:STM32F103C8T6 → STM32F1;STM32L4R5ZIT6 → STM32L4+;STM32WBA55CG → STM32WBA;
|
|
219
219
|
* STM32H563ZI → STM32H5;STM32U575ZI → STM32U5;STM32G071RB → STM32G0。
|
|
@@ -241,7 +241,7 @@ export function familyIdOfPart(part) {
|
|
|
241
241
|
continue;
|
|
242
242
|
const next = tail.slice(segment.length, segment.length + 1);
|
|
243
243
|
// 后面跟字母时,只有「字母+数字」这种子族段才算继续(H7A3 的 A3、H7B0 的 B0);
|
|
244
|
-
//
|
|
244
|
+
// 纯字母说明属于其他族(L4R5 已在上面按 L4+ 处理,WB55 的 B 后面是 5 但 segment WB 更短、不冲突)。
|
|
245
245
|
const after = tail.slice(segment.length + 1, segment.length + 2);
|
|
246
246
|
if (next !== "" && /[A-Z]/u.test(next) && !/[0-9]/u.test(after))
|
|
247
247
|
continue;
|
|
@@ -297,7 +297,7 @@ export function isF1(profile) {
|
|
|
297
297
|
* Cortex-M0 / M0+ → 4 断点 / 2 观察点(FPB 只有 4 个比较器、DWT 2 个)
|
|
298
298
|
* Cortex-M3 / M4 → 6 / 4
|
|
299
299
|
* Cortex-M7 / M33 / M55 → 8 / 4
|
|
300
|
-
* 单型号可以在内置资源 chips.json 里写 breakpoints/watchpoints 覆盖(breakpoints.ts
|
|
300
|
+
* 单型号可以在内置资源 chips.json 里写 breakpoints/watchpoints 覆盖(breakpoints.ts 优先使用该覆盖值)。
|
|
301
301
|
*/
|
|
302
302
|
// 顺序有讲究:M33 里含有 "m3" 子串,所以 M7/M33/M55 必须排在 M3/M4 前面判。
|
|
303
303
|
const CORE_BUDGETS = [
|
|
@@ -305,9 +305,9 @@ const CORE_BUDGETS = [
|
|
|
305
305
|
[/cortex-m7|cortex-m33|cortex-m55/i, { code: 8, data: 4 }],
|
|
306
306
|
[/cortex-m3|cortex-m4/i, { code: 6, data: 4 }],
|
|
307
307
|
];
|
|
308
|
-
/** F1(Cortex-M3
|
|
308
|
+
/** F1(Cortex-M3)的实测值,也是所有查不到内核时的回退值。 */
|
|
309
309
|
export const FALLBACK_DEBUG_BUDGET = { code: 6, data: 4 };
|
|
310
|
-
/** 内核名 → 硬件断点/观察点预算;查不到返回 F1 的 6/4(调用方应在 notes
|
|
310
|
+
/** 内核名 → 硬件断点/观察点预算;查不到返回 F1 的 6/4(调用方应在 notes 里说明使用了回退值)。 */
|
|
311
311
|
export function debugBudgetForCore(core) {
|
|
312
312
|
const raw = core.trim();
|
|
313
313
|
if (raw === "")
|
|
@@ -321,7 +321,7 @@ export function debugBudgetForCore(core) {
|
|
|
321
321
|
/**
|
|
322
322
|
* 族画像 → 预算(MPU 的 A7/A35 不用这个模型,返回 null 让调用方跳过比较器预算)。
|
|
323
323
|
* 内核未知(空串)也返回 null:不知道内核就不该假装算得出一条数值预算,
|
|
324
|
-
*
|
|
324
|
+
* 使调用方退回「按 F1 回退并说明原因」的原有路径。
|
|
325
325
|
*/
|
|
326
326
|
export function debugBudgetOfFamily(profile) {
|
|
327
327
|
const core = profile.core.trim();
|
|
@@ -336,9 +336,9 @@ export function debugBudgetOfFamily(profile) {
|
|
|
336
336
|
*
|
|
337
337
|
* 为什么要内置:openocd 0.12(2023-01 的最后一个正式版)没有 stm32c0x.cfg / stm32u0x.cfg,
|
|
338
338
|
* 而这两族已经在 14 个单核族的支持范围里。上游 master 版脚本只用了 0.13 才有的
|
|
339
|
-
* `dap create ... -tap
|
|
339
|
+
* `dap create ... -tap`,将其换成 0.12 支持的 `-chain-position` 即可完整加载(adapter/target/flash bank
|
|
340
340
|
* 全部通过,只有没接探针时 init 会报 CMSIS-DAP CMD_INFO failed)。
|
|
341
|
-
*
|
|
341
|
+
* 文件放在插件模板目录而非系统 openocd 目录:升级/卸载 openocd 不会丢失该支持,
|
|
342
342
|
* 也不去改用户机器上的 openocd 安装。
|
|
343
343
|
*/
|
|
344
344
|
export function bundledOpenocdConfig(name) {
|
|
@@ -352,7 +352,7 @@ export function bundledOpenocdConfig(name) {
|
|
|
352
352
|
* 族 → openocd target 配置。
|
|
353
353
|
*
|
|
354
354
|
* family 传 null 表示"工程里没有 .ioc / 认不出族":保持历史行为回退 stm32f1x,
|
|
355
|
-
* 但在 note
|
|
355
|
+
* 但在 note 里说明使用的是回退值(用户可在 openocd.cfg 中自行写 target)。
|
|
356
356
|
*/
|
|
357
357
|
export function chooseOpenocdTarget(family) {
|
|
358
358
|
if (family === null) {
|
|
@@ -388,7 +388,7 @@ export function chooseOpenocdTarget(family) {
|
|
|
388
388
|
note: family.note,
|
|
389
389
|
error: "本机 openocd 没有 " + family.id + " 的 target 脚本(" + family.note + "):" +
|
|
390
390
|
"请在工程根目录放一份 openocd.cfg 写死 source [find target/xxx.cfg],或用 openocd 的 -f 显式指定;" +
|
|
391
|
-
"
|
|
391
|
+
"不得以其他族的 target 强行连接(会导致无法连接或读错 flash 布局)",
|
|
392
392
|
bundled: false,
|
|
393
393
|
};
|
|
394
394
|
}
|
|
@@ -487,11 +487,11 @@ const PER_LINE_EXTI_VECTORS = Array.from({ length: 16 }, (_, line) => ({
|
|
|
487
487
|
from: line,
|
|
488
488
|
to: line,
|
|
489
489
|
}));
|
|
490
|
-
/**
|
|
490
|
+
/** 无法识别内核时的回退:F1 的 M3 分组(保持历史行为,调用方应在 notes 里说明)。 */
|
|
491
491
|
export const FALLBACK_EXTI_VECTORS = M3M4M7_EXTI_VECTORS;
|
|
492
492
|
/**
|
|
493
493
|
* 族 → EXTI 向量分组。profile 为 null(工程里读不到族)时返回 F1 的 M3 分组,
|
|
494
|
-
*
|
|
494
|
+
* 这是历史行为,调用方要自行在报告里说明「分组按 M3 回退」。
|
|
495
495
|
*/
|
|
496
496
|
export function extiVectorsOf(profile) {
|
|
497
497
|
const core = (profile?.core ?? "").trim();
|
|
@@ -2,9 +2,9 @@
|
|
|
2
2
|
* 固件包(STM32Cube_FW_<族>_V<版本>)的组装清单。
|
|
3
3
|
*
|
|
4
4
|
* 背景(2026-10 实测,见 docs §14):ST 的固件包不是整体下载的,GitHub 上的 STM32Cube<族>
|
|
5
|
-
*
|
|
5
|
+
* 主仓库将 HAL 驱动与 CMSIS 设备支持均设为 git 子模块 —— 仅拉取主仓库 tarball,
|
|
6
6
|
* Drivers/STM32F1xx_HAL_Driver 与 Drivers/CMSIS/Device/ST/STM32F1xx 是**空目录**,
|
|
7
|
-
*
|
|
7
|
+
* 编译必然失败。因此需分别拉取:
|
|
8
8
|
* ① HAL 驱动仓库(stm32f1xx-hal-driver)→ Drivers/STM32F1xx_HAL_Driver/{Inc,Src}
|
|
9
9
|
* ② CMSIS 设备仓库(cmsis-device-f1) → Drivers/CMSIS/Device/ST/STM32F1xx/{Include,Source}
|
|
10
10
|
* ③ CMSIS 内核头(STM32CubeF1 主仓库 Drivers/CMSIS/Include 下的 5 个头文件,逐个拉)
|
|
@@ -18,9 +18,9 @@ import { FIRMWARE_ARCHIVE_PINS, FIRMWARE_CORE_PINS } from "./firmware-pins.js";
|
|
|
18
18
|
/**
|
|
19
19
|
* 归档只有一条官方地址(P0-2):codeload 直连。
|
|
20
20
|
*
|
|
21
|
-
*
|
|
22
|
-
*
|
|
23
|
-
*
|
|
21
|
+
* 移除 ghproxy / api 回退的原因:同一个 commit 经不同入口打包,gzip 头与顶层目录名不同,
|
|
22
|
+
* 字节哈希不一致——单个 sha256 不能同时校验三条链路。保留这类回退要么使「校验形同虚设」,
|
|
23
|
+
* 要么使「第二条始终失败」。ghproxy 还为第三方中间人,固件包不应依赖该服务。
|
|
24
24
|
*/
|
|
25
25
|
function archiveUrls(repo, ref) {
|
|
26
26
|
return ["https://codeload.github.com/STMicroelectronics/" + repo + "/tar.gz/refs/heads/" + ref];
|
|
@@ -562,7 +562,7 @@ export const FIRMWARE_FAMILIES = {
|
|
|
562
562
|
coreRepo: "STM32CubeH7",
|
|
563
563
|
coreRef: "master",
|
|
564
564
|
coreIncludeDir: "Drivers/CMSIS/Include",
|
|
565
|
-
// CM7 的 core_cm7.h 会 include cachel1_armv7.h(L1 cache
|
|
565
|
+
// CM7 的 core_cm7.h 会 include cachel1_armv7.h(L1 cache 维护):缺失该文件将导致编译直接 fatal error。
|
|
566
566
|
coreHeaders: ["cmsis_compiler.h", "cmsis_gcc.h", "cmsis_version.h", "mpu_armv7.h", "cachel1_armv7.h", "core_cm7.h"],
|
|
567
567
|
archives: [
|
|
568
568
|
{
|
|
@@ -725,7 +725,7 @@ export function firmwarePlanFor(request) {
|
|
|
725
725
|
"- CMSIS 设备支持(cmsis-device-f1):Apache-2.0。",
|
|
726
726
|
"- CMSIS 内核头(STM32CubeF1 / Drivers/CMSIS/Include):Apache-2.0。",
|
|
727
727
|
"",
|
|
728
|
-
"CubeMX
|
|
728
|
+
"CubeMX 识别该目录(实测),但 ST 的包管理器不会维护该目录:升级时请用 CubeMX 包管理器重装官方包。",
|
|
729
729
|
"",
|
|
730
730
|
].join("\n");
|
|
731
731
|
return {
|
|
@@ -766,7 +766,7 @@ function hasStartup(dir) {
|
|
|
766
766
|
* 三条判据(与 scaffold.ts 的 resolveFirmwareRoot 一致,多加一条 startup 检查):
|
|
767
767
|
* ① Drivers/CMSIS/Include 有内核头 ② Drivers/<族>_HAL_Driver 有 Inc 与 Src
|
|
768
768
|
* ③ Drivers/CMSIS/Device/ST/<族>/{Include,Source/Templates/gcc/startup_*.s}
|
|
769
|
-
*
|
|
769
|
+
* 必须自查的原因:CubeMX 找不到包时**不报错**(docs §14),仅凭其打印 Code succesfully generated 会造成误判。
|
|
770
770
|
*/
|
|
771
771
|
export function verifyFirmwarePackage(root, family) {
|
|
772
772
|
const spec = FIRMWARE_FAMILIES[family];
|
|
@@ -801,7 +801,7 @@ export function dshFirmwareDir(cubeMxRoot) {
|
|
|
801
801
|
return base + "/" + DSH_FIRMWARE_DIR_NAME;
|
|
802
802
|
}
|
|
803
803
|
/**
|
|
804
|
-
* 从 .ioc
|
|
804
|
+
* 从 .ioc 正文中读取所需的固件包。
|
|
805
805
|
* 首选 ProjectManager.FirmwarePackage=STM32Cube FW_F1 V1.8.7;
|
|
806
806
|
* 缺这一条时退回 Mcu.CPN 推族 + 该族默认版本。
|
|
807
807
|
*/
|
|
@@ -860,7 +860,7 @@ export function firmwareSourceLabel(source) {
|
|
|
860
860
|
/**
|
|
861
861
|
* 在 CubeMX 根下找 .ioc 要的固件包。两处都找:Repository(官方)与 dsh-firmware(插件组装)。
|
|
862
862
|
* 排序:包名精确匹配最优先 → 版本号大的 → 同版本优先 Repository。
|
|
863
|
-
*
|
|
863
|
+
* 两处都查找的原因:官方包零拷贝直接使用;没有官方包时才使用插件组装的那份。
|
|
864
864
|
*/
|
|
865
865
|
export function locateFirmwarePackage(cubeMxRoots, request = {}) {
|
|
866
866
|
const wanted = (request.packageName ?? "").trim();
|