dsh-stm32 0.1.5 → 0.1.7
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 +2 -2
- package/README_EN.md +2 -2
- package/client/client.js +24 -24
- package/docs/reading-guide.md +32 -0
- package/lib/client.js +24 -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/assets.js +5 -5
- package/lib/engine/breakpoints.js +5 -5
- package/lib/engine/cache.js +4 -4
- 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/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 +12 -12
- package/lib/engine/debug.js +3 -3
- package/lib/engine/doctor.js +12 -12
- package/lib/engine/download.js +1 -1
- package/lib/engine/facts-acquire.js +3 -3
- 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/ioc-plan.js +80 -58
- package/lib/engine/ioc-rules.js +9 -9
- package/lib/engine/ioc-verify.js +34 -34
- package/lib/engine/msys2-install.js +50 -50
- package/lib/engine/probe-error.js +8 -8
- package/lib/engine/probe-session.js +3 -3
- package/lib/engine/probe.js +47 -50
- 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 +34 -30
- 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/toolchain-gate.js +8 -8
- package/lib/engine/usercode-merge.js +2 -2
- package/lib/engine/vscode-config.js +2 -2
- package/lib/engine/web-api.js +1 -1
- package/lib/engine/xcube-catalog.js +1 -1
- package/lib/index.js +5 -5
- package/lib/skill/stm32-workflow.js +1 -1
- package/lib/tools/assets.js +9 -4
- package/lib/tools/build.js +0 -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 +1 -1
- package/lib/tools/ioc-plan.js +18 -8
- package/lib/tools/ioc-verify.js +11 -11
- package/lib/tools/project-create.js +4 -4
- package/lib/tools/project-dir.js +1 -1
- package/lib/tools/regs.js +10 -10
- package/lib/tools/route-plan.js +9 -9
- package/lib/tools/rtt.js +9 -9
- package/lib/tools/serial.js +8 -8
- package/package.json +1 -1
- package/templates/scaffold/RTT.md +26 -34
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();
|
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* L1
|
|
2
|
+
* L1:无法安装(或不应由插件代装)的组件,如何清晰说明。
|
|
3
3
|
*
|
|
4
4
|
* 门禁把缺件分成两档,因为这两档的"下一步"完全不同:
|
|
5
5
|
* auto —— MSYS2 里一条 pacman 就能补(gcc / gdb / openocd / cmake / ninja),
|
|
6
6
|
* 插件能跑 stm32_env_install 出计划、确认后自己装;
|
|
7
7
|
* manual —— 装不了或不该代装:STM32CubeMX 是 InstallAnywhere 的 GUI 向导(要 ST 账号 +
|
|
8
8
|
* 同意许可),固件包只由 CubeMX 的包管理器维护(st.com 包清单 + 22 个 git 子模块)。
|
|
9
|
-
*
|
|
9
|
+
* 这两种只能提供分步指引,插件至多将其路径写入配置。
|
|
10
10
|
*
|
|
11
11
|
* 本文件只有文案与元数据,不起进程、不读盘,便于单测与审计(改文案不用碰引擎)。
|
|
12
12
|
*/
|
|
@@ -37,7 +37,7 @@ export function cubeMxGuide() {
|
|
|
37
37
|
label: CUBEMX_LABEL,
|
|
38
38
|
installability: "manual",
|
|
39
39
|
why: "CubeMX 是 GUI 安装向导,没有官方静默参数,下载前还要登录 ST 账号并同意许可,"
|
|
40
|
-
+ "
|
|
40
|
+
+ "插件代为安装等于代用户确认许可、代用户输入账号 —— 此步骤不执行。",
|
|
41
41
|
sizeHint: "安装包数百 MB,装完约 1.5 GB(不含固件包);固件包另算,见固件包那条指引(实测 250 MB – 1.7 GB)。",
|
|
42
42
|
needsAccount: true,
|
|
43
43
|
steps: [
|
|
@@ -47,7 +47,7 @@ export function cubeMxGuide() {
|
|
|
47
47
|
},
|
|
48
48
|
{
|
|
49
49
|
title: "GUI 装一遍(默认选项即可)",
|
|
50
|
-
detail: "
|
|
50
|
+
detail: "双击安装包按向导走完;安装盘符不限,不要放在受保护目录(例如 C:\\Program Files 需要管理员权限,插件写固件包时会失败)。",
|
|
51
51
|
},
|
|
52
52
|
{
|
|
53
53
|
title: "把安装根写进配置",
|
|
@@ -55,7 +55,7 @@ export function cubeMxGuide() {
|
|
|
55
55
|
},
|
|
56
56
|
{
|
|
57
57
|
title: "自检",
|
|
58
|
-
detail: "stm32_doctor 的 tools 里 cubemx 与 cubemx-java 都应带 path;缺 jre
|
|
58
|
+
detail: "stm32_doctor 的 tools 里 cubemx 与 cubemx-java 都应带 path;缺 jre 时无头生成会直接报 java 找不到。",
|
|
59
59
|
},
|
|
60
60
|
],
|
|
61
61
|
verify: "stm32_doctor → capabilities.generate 为 true(cubemx 与 cubemx-java 都找到)。",
|
|
@@ -71,7 +71,7 @@ export function familyPrefix(family) {
|
|
|
71
71
|
/**
|
|
72
72
|
* 各系列的固件包实测体积(2026-10 本机 D:\app\STM32CubeMX\Repository 直接量的)。
|
|
73
73
|
*
|
|
74
|
-
*
|
|
74
|
+
* 固定单一数字不适用于其他系列:F1 293 MB、G4 471 MB、F4 1.67 GB,相差 6 倍。
|
|
75
75
|
* 表里没有的系列给区间,不给具体数字。
|
|
76
76
|
*/
|
|
77
77
|
const FIRMWARE_SIZE_HINTS = {
|
|
@@ -84,8 +84,8 @@ const FIRMWARE_SIZE_HINTS = {
|
|
|
84
84
|
L0: "258 MB / 17,504 个文件(v1.12.4 实测);装完占盘约 258 MB。",
|
|
85
85
|
L4: "约 300 MB / 两万个文件;装完占盘约 300 MB。",
|
|
86
86
|
};
|
|
87
|
-
const FIRMWARE_SIZE_FALLBACK = "一个系列通常 250 MB – 1.7 GB /
|
|
88
|
-
/**
|
|
87
|
+
const FIRMWARE_SIZE_FALLBACK = "一个系列通常 250 MB – 1.7 GB / 一万到四万个文件(不同系列差异较大,最多相差 6 倍);装完占盘同量级。";
|
|
88
|
+
/** 固件包体积提示:已知系列给精确值、未知系列给区间(不将 F1 的数字套用到 H7)。 */
|
|
89
89
|
export function firmwareSizeHint(family) {
|
|
90
90
|
const key = family.trim().toUpperCase();
|
|
91
91
|
return FIRMWARE_SIZE_HINTS[key] ?? FIRMWARE_SIZE_FALLBACK;
|
|
@@ -94,9 +94,9 @@ export function firmwareSizeHint(family) {
|
|
|
94
94
|
* 固件包(HAL + CMSIS + startup)的安装指引。
|
|
95
95
|
*
|
|
96
96
|
* 为什么不做成自动下载(2026-10 取证):GitHub 上 STMicroelectronics/STM32CubeF1 有 v1.8.7 标签,
|
|
97
|
-
*
|
|
98
|
-
* Drivers/STM32F1xx_HAL_Driver
|
|
99
|
-
*
|
|
97
|
+
* 但主仓库包含 22 个 git 子模块,tarball 里 Drivers/CMSIS/Device/ST/STM32F1xx 与
|
|
98
|
+
* Drivers/STM32F1xx_HAL_Driver 是**空目录**;拼接出的包 CubeMX 是否识别尚未验证。
|
|
99
|
+
* 所以现在归入 manual:由 CubeMX 自身的包管理器安装(其写入的 package.xml / 包清单才是权威)。
|
|
100
100
|
*/
|
|
101
101
|
export function firmwareGuide(input) {
|
|
102
102
|
const prefix = familyPrefix(input.family);
|
|
@@ -109,17 +109,17 @@ export function firmwareGuide(input) {
|
|
|
109
109
|
label: "固件包 " + name,
|
|
110
110
|
installability: "manual",
|
|
111
111
|
why: "固件包不在 CubeMX 安装包里,而且不是单个压缩包:HAL 驱动、CMSIS 设备头、启动文件分在不同的 git 仓库里,"
|
|
112
|
-
+ "GitHub 的源码压缩包拿到的是空目录。可靠的来源只有 CubeMX
|
|
112
|
+
+ "GitHub 的源码压缩包拿到的是空目录。可靠的来源只有 CubeMX 自己的包管理器(由 CubeMX 写入包清单与 package.xml)。",
|
|
113
113
|
sizeHint: firmwareSizeHint(input.family),
|
|
114
114
|
needsAccount: true,
|
|
115
115
|
steps: [
|
|
116
116
|
{
|
|
117
117
|
title: autoDownloadable
|
|
118
|
-
? "
|
|
119
|
-
: "
|
|
118
|
+
? "先试插件代下载(该系列已接入)"
|
|
119
|
+
: "插件尚不支持该系列代下载",
|
|
120
120
|
detail: autoDownloadable
|
|
121
|
-
? "调 stm32_firmware_install(family 给 " + input.family + ",dryRun:false + confirm:true):插件从 GitHub
|
|
122
|
-
: "目前只有 F1
|
|
121
|
+
? "调 stm32_firmware_install(family 给 " + input.family + ",dryRun:false + confirm:true):插件从 GitHub 拉取 HAL 驱动与 CMSIS 设备两个子模块仓库 + 内核头,自行补齐 package.xml,实测 CubeMX 可识别;约 2 MB,数十秒。拉取失败或需使用官方包时,按下面三步操作。"
|
|
122
|
+
: "目前只有 F1 接入自动下载(其余系列按同样字段补充一条即可);该系列请使用下面的 CubeMX 包管理器。",
|
|
123
123
|
},
|
|
124
124
|
{
|
|
125
125
|
title: "在 CubeMX 里打开包管理器",
|
|
@@ -131,7 +131,7 @@ export function firmwareGuide(input) {
|
|
|
131
131
|
},
|
|
132
132
|
{
|
|
133
133
|
title: "离线机器:整目录拷贝",
|
|
134
|
-
detail: "
|
|
134
|
+
detail: "从联网机器把 " + name + " 整个目录(或整个 Repository 目录)拷到目标机同一位置即可,不需要重装 CubeMX。",
|
|
135
135
|
},
|
|
136
136
|
{
|
|
137
137
|
title: "自检",
|
|
@@ -142,7 +142,7 @@ export function firmwareGuide(input) {
|
|
|
142
142
|
};
|
|
143
143
|
}
|
|
144
144
|
/**
|
|
145
|
-
* 组件 id → 指引;auto
|
|
145
|
+
* 组件 id → 指引;auto 组件无指引(走 stm32_env_install)。cubemx 与 cubemx-java 共用一份。
|
|
146
146
|
*
|
|
147
147
|
* firmware 需要族名/包名/仓库目录才说得具体,所以第二个参数是可选的补充信息:
|
|
148
148
|
* 调用方(route_plan)手里有这些字段就传,只拿组件 id 的人(门禁、命令卡)也能拿到通用指引 ——
|