dsh-stm32 0.1.3 → 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 +52 -38
- package/README_EN.md +44 -33
- 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 +37 -35
- package/lib/data/chips.js +3 -3
- package/lib/data/clock-db.js +830 -0
- package/lib/data/clock-f1.js +12 -45
- package/lib/data/cmsis-sources.js +239 -18
- package/lib/data/db-presets.js +252 -0
- package/lib/data/device-facts.js +99 -26
- 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 +15 -14
- package/lib/data/svd.js +32 -16
- package/lib/data/toolchain-config.js +0 -14
- package/lib/engine/assets.js +191 -456
- package/lib/engine/breakpoints.js +66 -11
- package/lib/engine/clock-derived.js +101 -0
- package/lib/engine/clock-direct.js +313 -0
- package/lib/engine/clock-plan.js +96 -52
- package/lib/engine/clock-pllmn.js +319 -0
- package/lib/engine/cmake-sources.js +67 -13
- package/lib/engine/cube-mx-guard.js +44 -0
- package/lib/engine/cube-programmer.js +137 -0
- package/lib/engine/cubemx-db.js +273 -0
- package/lib/engine/debug-session.js +423 -17
- package/lib/engine/debug.js +25 -6
- package/lib/engine/doctor.js +160 -17
- 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 +290 -21
- package/lib/engine/gdb-mi.js +476 -0
- package/lib/engine/generate.js +9 -2
- package/lib/engine/hal-chip.js +124 -41
- package/lib/engine/ioc-plan.js +1244 -60
- package/lib/engine/ioc-rules.js +698 -0
- package/lib/engine/ioc-verify.js +706 -0
- package/lib/engine/ioc.js +43 -4
- package/lib/engine/msys2-install.js +4 -4
- package/lib/engine/probe-error.js +25 -6
- package/lib/engine/probe-session.js +50 -14
- 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 +101 -40
- package/lib/engine/regs.js +41 -8
- package/lib/engine/rm-extract.js +144 -0
- package/lib/engine/rm-sources.js +360 -0
- package/lib/engine/rm-text.js +56 -0
- package/lib/engine/rtt.js +188 -30
- package/lib/engine/scaffold.js +185 -18
- package/lib/engine/toolchain-gate.js +0 -4
- package/lib/engine/watch.js +227 -0
- package/lib/index.js +4 -2
- package/lib/skill/stm32-workflow.js +2 -2
- package/lib/tools/assets.js +39 -108
- package/lib/tools/cache.js +2 -2
- package/lib/tools/debug-session.js +2 -2
- package/lib/tools/doctor.js +55 -5
- package/lib/tools/firmware-install.js +31 -6
- package/lib/tools/flash.js +32 -4
- package/lib/tools/generate.js +22 -0
- package/lib/tools/ioc-inspect.js +1 -1
- package/lib/tools/ioc-plan.js +56 -2
- package/lib/tools/ioc-verify.js +237 -0
- package/lib/tools/project-create.js +41 -5
- package/lib/tools/regs.js +8 -8
- package/lib/tools/route-plan.js +1 -1
- package/lib/tools/rtt.js +157 -34
- package/lib/tools/watch.js +256 -0
- package/package.json +5 -4
- package/templates/openocd/stm32c0x.cfg +83 -0
- package/templates/openocd/stm32u0x.cfg +64 -0
- package/templates/register/CMakeLists.txt +2 -2
- package/templates/register/Core/Inc/rtt.h +37 -2
- package/templates/register/Core/Src/main.c +17 -25
- package/templates/register/Core/Src/rtt.c +85 -9
- package/templates/scaffold/RTT.md +6 -2
- package/templates/scaffold/STM32F103XX_FLASH.ld +3 -0
- package/templates/scaffold/openocd.cfg +5 -3
- package/templates/scaffold/vscode/launch.json +8 -4
- package/docs/development-notes.md +0 -2487
- package/docs/dsh-stm32-plugin-/350/247/204/346/240/274.md +0 -673
- package/docs/logic-audit.md +0 -607
|
@@ -18,6 +18,7 @@
|
|
|
18
18
|
*/
|
|
19
19
|
import { existsSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
|
|
20
20
|
import { basename, join } from "node:path";
|
|
21
|
+
import { defineSuffix } from "../data/device-facts.js";
|
|
21
22
|
import { readTextFile } from "./text-file.js";
|
|
22
23
|
/** ST 的 CMake 布局里那份「CubeMX 生成」的源清单。 */
|
|
23
24
|
export const CUBEMX_CMAKE_REL = "cmake/stm32cubemx/CMakeLists.txt";
|
|
@@ -63,9 +64,20 @@ export function pickStartupFile(projectDir) {
|
|
|
63
64
|
export function startupStem(file) {
|
|
64
65
|
return basename(file).replace(/^startup_/iu, "").replace(/\.s$/iu, "").toLowerCase();
|
|
65
66
|
}
|
|
66
|
-
/**
|
|
67
|
+
/**
|
|
68
|
+
* stm32f103xb → STM32F103xB(就是 CMSIS 头里那个宏,也是 cmake 源清单里那一行)。
|
|
69
|
+
*
|
|
70
|
+
* 不能简单"大写后把倒数第二个 X 换小写":那条规则只对 xb/xc/xe 这种「x + 容量字母」成立,
|
|
71
|
+
* 对 xx 档(startup_stm32f407xx.s)会把 STM32F407xx 写成 **STM32F407xX** → CMSIS 头认不出设备,
|
|
72
|
+
* 编译期报「Please select first the target STM32F4xx device」。对 cx/rx 这种「按封装分档」的
|
|
73
|
+
* (startup_stm32f410cx.s → STM32F410Cx)更是大小写相反。尾缀规则统一由 defineSuffix 决定。
|
|
74
|
+
*/
|
|
67
75
|
export function deviceDefineFromStartup(file) {
|
|
68
|
-
|
|
76
|
+
const stem = startupStem(file);
|
|
77
|
+
// 太短的名字没尾缀可拆(例如 startup_stm32.s):原样大写,别在这里瞎猜。
|
|
78
|
+
if (stem.length < 8)
|
|
79
|
+
return stem.toUpperCase();
|
|
80
|
+
return stem.slice(0, -2).toUpperCase() + defineSuffix(stem.slice(-2));
|
|
69
81
|
}
|
|
70
82
|
/** stm32f103xb → { token: stm32f1xx, upper: STM32F1xx };认不出返回 null。 */
|
|
71
83
|
export function familyTokensFromStartup(file) {
|
|
@@ -75,6 +87,36 @@ export function familyTokensFromStartup(file) {
|
|
|
75
87
|
const code = matched[1];
|
|
76
88
|
return { token: "stm32" + code + "xx", upper: "STM32" + code.toUpperCase() + "xx" };
|
|
77
89
|
}
|
|
90
|
+
/**
|
|
91
|
+
* 从工程里真实存在的 Drivers/STM32<族>xx_HAL_Driver 目录反推家族名。
|
|
92
|
+
*
|
|
93
|
+
* 为什么不能只靠启动文件名:F1/F4 这类「族段两字符」的启动文件名(stm32f103xb)能拆出 f1,
|
|
94
|
+
* 但 WBA 是 startup_stm32wba50xx.s、WL 是 startup_stm32wle4xx.s —— 族段三四个字符,
|
|
95
|
+
* ^stm32([a-z]\d) 直接匹配不上,于是 collectCmakeSources 报「认不出启动文件属于哪个族」,
|
|
96
|
+
* 源清单一个字都不改(WBA/WL 的 CMakeLists 里就留着固件包里根本不存在的
|
|
97
|
+
* stm32wbaxx_hal_gpio_ex.c,cmake configure 在 target_sources 处失败)。
|
|
98
|
+
* 目录名是磁盘上的事实:STM32WBAxx_HAL_Driver → token stm32wbaxx、upper STM32WBAxx。
|
|
99
|
+
*/
|
|
100
|
+
export function familyTokensFromDriversDir(projectDir) {
|
|
101
|
+
const dir = join(projectDir, "Drivers");
|
|
102
|
+
if (!existsSync(dir))
|
|
103
|
+
return null;
|
|
104
|
+
let names;
|
|
105
|
+
try {
|
|
106
|
+
names = readdirSync(dir);
|
|
107
|
+
}
|
|
108
|
+
catch {
|
|
109
|
+
return null;
|
|
110
|
+
}
|
|
111
|
+
const hits = names
|
|
112
|
+
.map((name) => /^STM32([A-Z0-9]+)xx_HAL_Driver$/u.exec(name)?.[1] ?? "")
|
|
113
|
+
.filter((token) => token.length >= 2)
|
|
114
|
+
.sort();
|
|
115
|
+
if (hits.length === 0)
|
|
116
|
+
return null;
|
|
117
|
+
const code = hits[0];
|
|
118
|
+
return { token: "stm32" + code.toLowerCase() + "xx", upper: "STM32" + code + "xx" };
|
|
119
|
+
}
|
|
78
120
|
/**
|
|
79
121
|
* 抹掉注释再匹配。
|
|
80
122
|
*
|
|
@@ -168,9 +210,10 @@ export function collectCmakeSources(projectDir) {
|
|
|
168
210
|
if (startup === null) {
|
|
169
211
|
return { error: "工程根没有 startup_stm32*.s(不是脚手架建的 HAL 工程?),无从反推芯片与源清单" };
|
|
170
212
|
}
|
|
171
|
-
|
|
213
|
+
// 优先信磁盘上的 HAL 目录(WBA/WL 这种三四字符族段的启动文件名拆不出族);拆不出再回退文件名规则。
|
|
214
|
+
const family = familyTokensFromDriversDir(projectDir) ?? familyTokensFromStartup(startup.file);
|
|
172
215
|
if (family === null)
|
|
173
|
-
return { error: "认不出启动文件 " + startup.file + " 属于哪个 STM32
|
|
216
|
+
return { error: "认不出启动文件 " + startup.file + " 属于哪个 STM32 家族(Drivers 下也没有 STM32*xx_HAL_Driver 目录)" };
|
|
174
217
|
const deviceDefine = deviceDefineFromStartup(startup.file);
|
|
175
218
|
const notes = [...startup.notes];
|
|
176
219
|
const moduleFacts = halModulesInUse(projectDir, family);
|
|
@@ -203,18 +246,29 @@ export function collectCmakeSources(projectDir) {
|
|
|
203
246
|
"(先确认 Drivers 目录是不是完整拷贝)");
|
|
204
247
|
}
|
|
205
248
|
const appFiles = [];
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
"Core/Src/" + family.token + "_it.c",
|
|
209
|
-
"Core/Src/" + family.token + "_hal_msp.c",
|
|
210
|
-
"Core/Src/sysmem.c",
|
|
211
|
-
"Core/Src/syscalls.c",
|
|
212
|
-
startup.file,
|
|
213
|
-
];
|
|
214
|
-
for (const rel of appCandidates) {
|
|
249
|
+
// 固定项先排:main / 中断 / MSP 是每份工程都有的入口文件。
|
|
250
|
+
for (const rel of ["Core/Src/main.c", "Core/Src/" + family.token + "_it.c", "Core/Src/" + family.token + "_hal_msp.c"]) {
|
|
215
251
|
if (exists(rel))
|
|
216
252
|
appFiles.push(rel);
|
|
217
253
|
}
|
|
254
|
+
// 其余从磁盘枚举:CubeMX 在「每个外设一对 .c/.h」模式下会把 GPIO/ADC/USART 拆成 gpio.c、adc.c…
|
|
255
|
+
// 早期这里只列了 sysmem/syscalls,导致这些文件不进 CMakeLists(C0 实测:main.c 引 MX_GPIO_Init,
|
|
256
|
+
// gpio.c 没参与链接 → undefined reference to MX_GPIO_Init)。
|
|
257
|
+
try {
|
|
258
|
+
const coreSrc = join(projectDir, "Core", "Src");
|
|
259
|
+
for (const name of readdirSync(coreSrc).filter((item) => /\.c$/iu.test(item)).sort()) {
|
|
260
|
+
const rel = "Core/Src/" + name;
|
|
261
|
+
// system_*.c 已经在 driverFiles 里(排在 HAL 驱动那块),这里不能再列一次。
|
|
262
|
+
if (rel === systemSrc)
|
|
263
|
+
continue;
|
|
264
|
+
if (!appFiles.includes(rel))
|
|
265
|
+
appFiles.push(rel);
|
|
266
|
+
}
|
|
267
|
+
}
|
|
268
|
+
catch {
|
|
269
|
+
notes.push("读不了 Core/Src(工程可能还没生成代码),应用源清单只含已知入口文件");
|
|
270
|
+
}
|
|
271
|
+
appFiles.push(startup.file);
|
|
218
272
|
return { startup: startup.file, deviceDefine, family, modules: moduleFacts.modules, driverDir, driverFiles, appFiles, notes };
|
|
219
273
|
}
|
|
220
274
|
function findBlock(lines, varName) {
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* CubeMX 图形界面的占用检测。
|
|
3
|
+
*
|
|
4
|
+
* 为什么需要:CubeMX 是**单实例**应用。GUI 已经开着的时候再执行
|
|
5
|
+
* `jre/bin/java.exe -jar STM32CubeMX.exe -q <script>`,命令行会被转发给那个 GUI 进程 ——
|
|
6
|
+
* `-q`(无界面)失效,脚本在 GUI 里跑,于是弹出 "Warning: Load Project … would you like to save the project ?"
|
|
7
|
+
* 这类**模态框**:没人点它,生成就一直挂着(一次 3–4 分钟的活变成无限等)。
|
|
8
|
+
*
|
|
9
|
+
* 插件这边能做的不是"替你点按钮"(SWT 原生窗口,UIA/SendKeys 都不稳),而是**先发现、先拒绝**,
|
|
10
|
+
* 让人把 GUI 关掉再重跑 —— 报错比卡死便宜。
|
|
11
|
+
*/
|
|
12
|
+
import { runCapture } from "./subprocess-runner.js";
|
|
13
|
+
import { parseTasklistCsv } from "./doctor.js";
|
|
14
|
+
/**
|
|
15
|
+
* 当前正在运行的 CubeMX GUI 进程(只认 STM32CubeMX.exe;无头调用自己跑的是 jre/bin/java.exe,不算)。
|
|
16
|
+
* 拿不到进程列表(非 Windows / tasklist 不可用)时返回空数组:不因为探测失败就拦住用户。
|
|
17
|
+
*/
|
|
18
|
+
export async function findRunningCubeMxGui(subprocess, signal) {
|
|
19
|
+
let outcome;
|
|
20
|
+
try {
|
|
21
|
+
outcome = await runCapture(subprocess, {
|
|
22
|
+
argv: ["tasklist", "/NH", "/FO", "CSV"],
|
|
23
|
+
timeoutMs: 10_000,
|
|
24
|
+
maxBytes: 512 * 1024,
|
|
25
|
+
...(signal === undefined ? {} : { signal }),
|
|
26
|
+
});
|
|
27
|
+
}
|
|
28
|
+
catch {
|
|
29
|
+
return [];
|
|
30
|
+
}
|
|
31
|
+
if (outcome.spawnError !== null || outcome.exitCode !== 0)
|
|
32
|
+
return [];
|
|
33
|
+
return parseTasklistCsv(outcome.stdout + "\n" + outcome.stderr, ["STM32CubeMX.exe"]).map((process) => ({
|
|
34
|
+
name: process.name,
|
|
35
|
+
pid: process.pid,
|
|
36
|
+
}));
|
|
37
|
+
}
|
|
38
|
+
/** 检测到 GUI 时给用户的一句话(直接进 errors/message)。 */
|
|
39
|
+
export function describeCubeMxGuiConflict(processes) {
|
|
40
|
+
const list = processes.map((process) => process.name + "#" + String(process.pid)).join("、");
|
|
41
|
+
return ("检测到 STM32CubeMX 图形界面正在运行(" + list + "):CubeMX 是单实例,命令行会被转发给它," +
|
|
42
|
+
"无头模式(-q)失效并可能弹出\"是否保存工程\"这类模态框,生成会一直等下去。" +
|
|
43
|
+
"请先关掉 CubeMX 窗口(或保存后退出),再重跑;不想关也可以先用 CubeMX 自己 Generate Code,再回来跑 stm32_build");
|
|
44
|
+
}
|
|
@@ -0,0 +1,137 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* L1:STM32CubeProgrammer CLI 烧录后端(openocd 之外的第二条腿)。
|
|
3
|
+
*
|
|
4
|
+
* 为什么需要它(2026-11-08 真机教训):openocd 0.12 没有 C0/U0 等族的 target 脚本,
|
|
5
|
+
* 插件内置适配版也只覆盖到「flash 驱动能借用」的程度;C0 那次靠会话外手敲
|
|
6
|
+
* STM32_Programmer_CLI 才烧进去——这条能力必须在插件里,而不是在用户的肌肉记忆里。
|
|
7
|
+
*
|
|
8
|
+
* 探针支持面(-h 实测 + 本机 -l 实测):CLI 的 SWD 路径只认 **ST-LINK**
|
|
9
|
+
* (port=SWD 的参数全是 ST-LINK 系;DAPLink/CMSIS-DAP 不走这条)。
|
|
10
|
+
* 所以它是「插着 ST-LINK 时的第二后端」,不是万能替补,报告里要如实说。
|
|
11
|
+
*
|
|
12
|
+
* 判据短语全部来自对本机 v2.19.0 的 STM32_Programmer_CLI.exe / CubeProgrammer_API.dll
|
|
13
|
+
* 内嵌消息表的实测提取(UTF-16 串扫描),不是文档转述:
|
|
14
|
+
* 下载成功 Data downloaded successfully / Sector[%d] downloaded successfully
|
|
15
|
+
* 校验成功 Download verified successfully
|
|
16
|
+
* 校验失败 Download verification failed
|
|
17
|
+
* 没插探针 No ST-Link detected!
|
|
18
|
+
*
|
|
19
|
+
* 退出码不参与成败判定:CLI 失败时也常退 0,只认输出行(与 openocd 同哲学,docs/A25)。
|
|
20
|
+
*/
|
|
21
|
+
import { basename } from "node:path";
|
|
22
|
+
import { runStreaming } from "./subprocess-runner.js";
|
|
23
|
+
import { describeSearchScope, resolveSearchConfig, looksLikeCubePrgBin } from "../data/search-roots.js";
|
|
24
|
+
import { existsSync } from "node:fs";
|
|
25
|
+
export function parseCubeProgrammerLog(text) {
|
|
26
|
+
const downloaded = /Data downloaded successfully|Sector[d+] downloaded successfully/iu.test(text);
|
|
27
|
+
const verified = /Download verified successfully/iu.test(text);
|
|
28
|
+
const verifyFailed = /Download verification failed/iu.test(text);
|
|
29
|
+
const errors = [];
|
|
30
|
+
const seen = new Set();
|
|
31
|
+
for (const raw of text.split(/\r?\n/u)) {
|
|
32
|
+
const line = raw.trim();
|
|
33
|
+
if (line === "")
|
|
34
|
+
continue;
|
|
35
|
+
const isError = /^Error[: ]/iu.test(line) ||
|
|
36
|
+
/No ST-Link detected/iu.test(line) ||
|
|
37
|
+
/Unable to connect/iu.test(line) ||
|
|
38
|
+
verifyFailedTest(line);
|
|
39
|
+
if (!isError)
|
|
40
|
+
continue;
|
|
41
|
+
if (seen.has(line))
|
|
42
|
+
continue;
|
|
43
|
+
seen.add(line);
|
|
44
|
+
errors.push(line);
|
|
45
|
+
}
|
|
46
|
+
return { downloaded, verified, verifyFailed, errors };
|
|
47
|
+
}
|
|
48
|
+
function verifyFailedTest(line) {
|
|
49
|
+
return /Download verification failed/iu.test(line);
|
|
50
|
+
}
|
|
51
|
+
/** 拼 CLI 参数(可单测):连接 SWD → 下载 elf → 校验 → 复位。 */
|
|
52
|
+
export function buildCubeProgrammerArgs(elfPath, o = {}) {
|
|
53
|
+
const freq = o.adapterSpeed === undefined ? "" : " freq=" + String(Math.trunc(o.adapterSpeed));
|
|
54
|
+
const args = ["-c", "port=SWD" + freq, "-d", elfPath, "-v"];
|
|
55
|
+
if (o.runAfterReset !== false)
|
|
56
|
+
args.push("-rst");
|
|
57
|
+
return args;
|
|
58
|
+
}
|
|
59
|
+
/** 找本机 CubeProgrammer CLI:显式路径 → 搜索根 → 注册表没有就认 PATH 裸命令。 */
|
|
60
|
+
export function findCubeProgrammerCli(binDirs, explicit) {
|
|
61
|
+
if (explicit !== undefined && explicit !== "") {
|
|
62
|
+
const hit = [explicit, explicit + ".exe"].find((p) => existsSync(p));
|
|
63
|
+
return hit ?? null;
|
|
64
|
+
}
|
|
65
|
+
for (const dir of binDirs) {
|
|
66
|
+
const p = dir + "/STM32_Programmer_CLI.exe";
|
|
67
|
+
if (existsSync(p))
|
|
68
|
+
return p;
|
|
69
|
+
if (looksLikeCubePrgBin(dir))
|
|
70
|
+
return dir + "/STM32_Programmer_CLI.exe";
|
|
71
|
+
}
|
|
72
|
+
return null;
|
|
73
|
+
}
|
|
74
|
+
export async function runCubeProgrammerFlash(subprocess, request) {
|
|
75
|
+
const startedAt = Date.now();
|
|
76
|
+
const config = resolveSearchConfig(process.env, request.binDirs === undefined ? {} : { binDirs: request.binDirs });
|
|
77
|
+
const cli = findCubeProgrammerCli(config.cubePrgBins, request.cliPath);
|
|
78
|
+
const empty = (errors, message) => ({
|
|
79
|
+
ok: false, command: "", args: [], exitCode: null, programmed: false, verified: false,
|
|
80
|
+
errors, logTail: "", durationMs: Date.now() - startedAt, message,
|
|
81
|
+
searched: describeSearchScope(config.cubePrgBins, "STM32_CUBE_PRG_ROOT"),
|
|
82
|
+
});
|
|
83
|
+
if (cli === null) {
|
|
84
|
+
return empty(["没找到 STM32_Programmer_CLI.exe"], "烧不了:本机找不到 STM32CubeProgrammer 的 CLI(查过 " + describeSearchScope(config.cubePrgBins, "STM32_CUBE_PRG_ROOT") + ")。" +
|
|
85
|
+
"装上它就有了不依赖 openocd target 脚本的第二条后端(H5/WBA/WB0/WL3 只能走它):" +
|
|
86
|
+
"https://www.st.com/en/development-tools/stm32cubeprog.html(默认安装路径会被自动发现;已装在别处就设 STM32_CUBE_PRG_ROOT 指到安装根或 bin)");
|
|
87
|
+
}
|
|
88
|
+
const args = [cli, ...buildCubeProgrammerArgs(request.elfPath, {
|
|
89
|
+
...(request.adapterSpeed === undefined ? {} : { adapterSpeed: request.adapterSpeed }),
|
|
90
|
+
runAfterReset: request.runAfterReset !== false,
|
|
91
|
+
})];
|
|
92
|
+
let out = "";
|
|
93
|
+
const outcome = await runStreaming(subprocess, {
|
|
94
|
+
argv: args,
|
|
95
|
+
cwd: request.projectDir,
|
|
96
|
+
timeoutMs: request.timeoutMs ?? 120_000,
|
|
97
|
+
...(request.signal === undefined ? {} : { signal: request.signal }),
|
|
98
|
+
onOutput: (_stream, text) => {
|
|
99
|
+
out += text;
|
|
100
|
+
for (const line of text.split(/\r?\n/u)) {
|
|
101
|
+
if (line.trim() !== "")
|
|
102
|
+
request.onProgress?.(line.trim());
|
|
103
|
+
}
|
|
104
|
+
},
|
|
105
|
+
});
|
|
106
|
+
// 判定用 runStreaming 收全的 stdout+stderr;onOutput 增量只用于实时转发进度。
|
|
107
|
+
const log = out.length > outcome.stdout.length + outcome.stderr.length ? out : outcome.stdout + "\n" + outcome.stderr;
|
|
108
|
+
const verdict = parseCubeProgrammerLog(log);
|
|
109
|
+
const errors = [...verdict.errors];
|
|
110
|
+
if (outcome.spawnError !== null)
|
|
111
|
+
errors.push("CLI 启动失败:" + outcome.spawnError);
|
|
112
|
+
if (outcome.timedOut)
|
|
113
|
+
errors.push("超时(" + String(request.timeoutMs ?? 120_000) + " ms):CLI 没跑完");
|
|
114
|
+
// 成功 = 下载行 + 校验行都在、没有失败行;退出码不参与(CLI 失败也常退 0)。
|
|
115
|
+
const ok = errors.length === 0 && verdict.downloaded && verdict.verified;
|
|
116
|
+
const message = ok
|
|
117
|
+
? "烧录成功(CubeProgrammer," + ((Date.now() - startedAt) / 1000).toFixed(1) + " s,已校验)"
|
|
118
|
+
: "烧录失败(CubeProgrammer):" + (errors[0] ?? (verdict.downloaded ? "校验行没出现" : "下载行没出现"));
|
|
119
|
+
const exitValue = typeof outcome.exitCode === "number" ? outcome.exitCode : null;
|
|
120
|
+
return {
|
|
121
|
+
ok,
|
|
122
|
+
command: args.map((a) => (a.includes(" ") ? '"' + a + '"' : a)).join(" "),
|
|
123
|
+
args: args.slice(1),
|
|
124
|
+
exitCode: exitValue,
|
|
125
|
+
programmed: verdict.downloaded,
|
|
126
|
+
verified: verdict.verified,
|
|
127
|
+
errors,
|
|
128
|
+
logTail: log.split(/\r?\n/u).slice(-25).join("\n"),
|
|
129
|
+
durationMs: Date.now() - startedAt,
|
|
130
|
+
message,
|
|
131
|
+
searched: describeSearchScope(config.cubePrgBins, "STM32_CUBE_PRG_ROOT"),
|
|
132
|
+
};
|
|
133
|
+
}
|
|
134
|
+
/** 报告卡片里给这行署名:烧的是哪条后端。 */
|
|
135
|
+
export function cubeProgrammerBackendNote(cliPath) {
|
|
136
|
+
return "烧录后端:STM32CubeProgrammer CLI(" + basename(cliPath) + ");注意它只认 ST-LINK,DAPLink/CMSIS-DAP 探针仍走 openocd。";
|
|
137
|
+
}
|
|
@@ -0,0 +1,273 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* L2:直接读 STM32CubeMX 安装自带的 db(只查询,不复制、不落盘)。
|
|
3
|
+
*
|
|
4
|
+
* 为什么这么做:用户要求「能在 db 查到的,只写查询逻辑」。CubeMX 安装目录里的
|
|
5
|
+
* db/mcu/*.xml 就是芯片事实(引脚、Signal、IP 实例、最高频率),
|
|
6
|
+
* db/mcu/IP/*_Modes.xml 就是各 IP 的合法模式名,db/package.xml 是库版本。
|
|
7
|
+
* 这些文件随用户的 CubeMX 版本变化,所以我们不在插件里内置副本,运行时按版本找。
|
|
8
|
+
*
|
|
9
|
+
* 结构(实测 DB.6.0.150):
|
|
10
|
+
* db/package.xml → <PackDescription Release="DB.6.0.150"/>
|
|
11
|
+
* db/mcu/STM32F103C(8-B)Tx.xml → <Mcu ... Package="LQFP48"> <Frequency>72</Frequency>
|
|
12
|
+
* <Pin Name="PA8" Position="29"><Signal Name="TIM1_CH1"/>…
|
|
13
|
+
* <IP ConfigFile="TIM-STM32F1xx" InstanceName="TIM3" Name="TIM1_8F1" Version="gptimer2_v1_x_Cube"/>
|
|
14
|
+
* db/mcu/IP/TIM1_8F1-gptimer2_v1_x_Cube_Modes.xml → <RefMode Name="PWM Generation1 No Output" …/>
|
|
15
|
+
*/
|
|
16
|
+
import { existsSync, readFileSync, readdirSync } from "node:fs";
|
|
17
|
+
import { join } from "node:path";
|
|
18
|
+
/** 读 <root>/db/package.xml 里的 Release。 */
|
|
19
|
+
function readDbVersion(dbRoot) {
|
|
20
|
+
const file = join(dbRoot, "package.xml");
|
|
21
|
+
if (!existsSync(file))
|
|
22
|
+
return null;
|
|
23
|
+
const text = readFileSync(file, "utf8");
|
|
24
|
+
const match = /Release="(DB[^"]+)"/u.exec(text);
|
|
25
|
+
return match === null ? null : match[1];
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
* 定位要用的 db:优先安装目录,其次用户目录下的历史下载库。
|
|
29
|
+
* wantedVersion 为空时用安装目录那份(CubeMX 自己也是这么选的)。
|
|
30
|
+
*/
|
|
31
|
+
export function locateCubemxDb(roots, wantedVersion = "") {
|
|
32
|
+
const candidates = [];
|
|
33
|
+
for (const root of roots)
|
|
34
|
+
candidates.push(join(root, "db"));
|
|
35
|
+
for (const root of roots) {
|
|
36
|
+
const home = process.env.USERPROFILE ?? process.env.HOME ?? "";
|
|
37
|
+
if (home !== "")
|
|
38
|
+
candidates.push(join(home, ".stm32cubemx", "databases"));
|
|
39
|
+
}
|
|
40
|
+
for (const candidate of candidates) {
|
|
41
|
+
if (!existsSync(candidate))
|
|
42
|
+
continue;
|
|
43
|
+
if (candidate.endsWith("databases")) {
|
|
44
|
+
if (wantedVersion === "")
|
|
45
|
+
continue;
|
|
46
|
+
for (const name of readdirSync(candidate)) {
|
|
47
|
+
if (name !== wantedVersion)
|
|
48
|
+
continue;
|
|
49
|
+
const version = readDbVersion(join(candidate, name, "db"));
|
|
50
|
+
if (version !== null)
|
|
51
|
+
return { root: join(candidate, name, "db"), version };
|
|
52
|
+
}
|
|
53
|
+
continue;
|
|
54
|
+
}
|
|
55
|
+
const version = readDbVersion(candidate);
|
|
56
|
+
if (version === null)
|
|
57
|
+
continue;
|
|
58
|
+
if (wantedVersion !== "" && version !== wantedVersion)
|
|
59
|
+
continue;
|
|
60
|
+
return { root: candidate, version };
|
|
61
|
+
}
|
|
62
|
+
return null;
|
|
63
|
+
}
|
|
64
|
+
/** 解析一份 MCU XML(结构简单,用正则足够,零依赖)。 */
|
|
65
|
+
export function parseMcuXml(text) {
|
|
66
|
+
const mcu = /<Mcu\b([^>]*)>/u.exec(text);
|
|
67
|
+
if (mcu === null)
|
|
68
|
+
return null;
|
|
69
|
+
const attrs = mcu[1];
|
|
70
|
+
const name = /RefName="([^"]+)"/u.exec(attrs)?.[1] ?? "";
|
|
71
|
+
const packageName = /Package="([^"]+)"/u.exec(attrs)?.[1] ?? "";
|
|
72
|
+
const frequency = Number.parseInt(/<Frequency>(\d+)<\/Frequency>/u.exec(text)?.[1] ?? "", 10);
|
|
73
|
+
// 族/产品线/内核/容量:db 3.0 之后才有,老 db 可能缺;缺就是空串/0,不猜。
|
|
74
|
+
const family = /Family="([^"]+)"/u.exec(attrs)?.[1] ?? "";
|
|
75
|
+
const line = /Line="([^"]+)"/u.exec(attrs)?.[1] ?? "";
|
|
76
|
+
const core = /<Core>([^<]+)<\/Core>/u.exec(text)?.[1]?.trim() ?? "";
|
|
77
|
+
const ramKb = Number.parseInt(/<Ram>(\d+)<\/Ram>/u.exec(text)?.[1] ?? "", 10);
|
|
78
|
+
const ioNb = Number.parseInt(/<IONb>(\d+)<\/IONb>/u.exec(text)?.[1] ?? "", 10);
|
|
79
|
+
const clockTree = /(?:^|\s)ClockTree="([^"]+)"/u.exec(attrs)?.[1] ?? "";
|
|
80
|
+
const flashKb = [];
|
|
81
|
+
for (const flash of text.matchAll(/<Flash>(\d+)<\/Flash>/gu)) {
|
|
82
|
+
const size = Number.parseInt(flash[1] ?? "", 10);
|
|
83
|
+
if (Number.isFinite(size) && !flashKb.includes(size))
|
|
84
|
+
flashKb.push(size);
|
|
85
|
+
}
|
|
86
|
+
const pins = new Map();
|
|
87
|
+
// 两种写法都要认:自闭合 <Pin ... />(如 BOOT0)与带子节点的 <Pin ...> … </Pin>;
|
|
88
|
+
// 属性顺序不固定(有的 Pin 把 Type 放前面),所以先抓整段属性再取字段。
|
|
89
|
+
const pinBlocks = text.matchAll(/<Pin\b([^>]*?)(?:\/>|>([\s\S]*?)<\/Pin>)/gu);
|
|
90
|
+
for (const block of pinBlocks) {
|
|
91
|
+
const pinAttrs = block[1];
|
|
92
|
+
const pinName = /(?:^|\s)Name="([^"]+)"/u.exec(pinAttrs)?.[1] ?? "";
|
|
93
|
+
const pinPosition = Number.parseInt(/(?:^|\s)Position="(\d+)"/u.exec(pinAttrs)?.[1] ?? "", 10);
|
|
94
|
+
if (pinName === "")
|
|
95
|
+
continue;
|
|
96
|
+
const signals = new Map();
|
|
97
|
+
for (const signal of (block[2] ?? "").matchAll(/<Signal\b([^>]*)\/?>/gu)) {
|
|
98
|
+
const signalAttrs = signal[1];
|
|
99
|
+
const signalName = /Name="([^"]+)"/u.exec(signalAttrs)?.[1] ?? "";
|
|
100
|
+
if (signalName === "")
|
|
101
|
+
continue;
|
|
102
|
+
const ioModes = /IOModes="([^"]+)"/u.exec(signalAttrs)?.[1] ?? "";
|
|
103
|
+
signals.set(signalName, ioModes === "" ? [] : ioModes.split(",").map((item) => item.trim()));
|
|
104
|
+
}
|
|
105
|
+
pins.set(pinName, {
|
|
106
|
+
name: pinName,
|
|
107
|
+
position: Number.isFinite(pinPosition) ? pinPosition : 0,
|
|
108
|
+
signals,
|
|
109
|
+
});
|
|
110
|
+
}
|
|
111
|
+
const ips = new Map();
|
|
112
|
+
// 两种写法都要认(U5 实测):自闭合 <IP …/>(F1/F2/F4 这些单上下文族)与带子节点的
|
|
113
|
+
// <IP …>…</IP>(TrustZone/多上下文族:<IP> 里挂 <ContextSplit>/<ContextIP>)。
|
|
114
|
+
// 早先只认自闭合,U5 的 110 个 <IP> 里只有 1 个是自闭合的 —— RCC 正好不是,
|
|
115
|
+
// 于是 readMcuFacts 读出来的 ips 里没有 RCC,时钟事实整族读不到(假结论「db 没有这一族的 RCC」)。
|
|
116
|
+
// 键统一大写:.ioc 的 Mcu.IP<i> 与信号名都是大写实例名,而 ipModesPath/hasIpInstance 也按大写查。
|
|
117
|
+
for (const ip of text.matchAll(/<IP\b([^>]*?)(?:\/>|>)/gu)) {
|
|
118
|
+
const ipAttrs = ip[1];
|
|
119
|
+
const rawName = /InstanceName="([^"]+)"/u.exec(ipAttrs)?.[1] ?? "";
|
|
120
|
+
if (rawName === "")
|
|
121
|
+
continue;
|
|
122
|
+
const instanceName = rawName.toUpperCase();
|
|
123
|
+
ips.set(instanceName, {
|
|
124
|
+
instanceName,
|
|
125
|
+
name: /(?:^|\s)Name="([^"]+)"/u.exec(ipAttrs)?.[1] ?? "",
|
|
126
|
+
version: /Version="([^"]+)"/u.exec(ipAttrs)?.[1] ?? "",
|
|
127
|
+
configFile: /ConfigFile="([^"]+)"/u.exec(ipAttrs)?.[1] ?? "",
|
|
128
|
+
});
|
|
129
|
+
}
|
|
130
|
+
if (pins.size === 0)
|
|
131
|
+
return null;
|
|
132
|
+
return {
|
|
133
|
+
name,
|
|
134
|
+
packageName,
|
|
135
|
+
frequencyMhz: Number.isFinite(frequency) ? frequency : 0,
|
|
136
|
+
family,
|
|
137
|
+
line,
|
|
138
|
+
core,
|
|
139
|
+
ramKb: Number.isFinite(ramKb) ? ramKb : 0,
|
|
140
|
+
flashKb,
|
|
141
|
+
ioNb: Number.isFinite(ioNb) ? ioNb : 0,
|
|
142
|
+
clockTree,
|
|
143
|
+
pins,
|
|
144
|
+
ips,
|
|
145
|
+
};
|
|
146
|
+
}
|
|
147
|
+
/** 读某个芯片的 MCU XML。mcuName 就是 .ioc 里的 Mcu.Name,例如 STM32F103C(8-B)Tx。 */
|
|
148
|
+
export function readMcuFacts(db, mcuName) {
|
|
149
|
+
const file = join(db.root, "mcu", mcuName + ".xml");
|
|
150
|
+
if (!existsSync(file))
|
|
151
|
+
return null;
|
|
152
|
+
return parseMcuXml(readFileSync(file, "utf8"));
|
|
153
|
+
}
|
|
154
|
+
/**
|
|
155
|
+
* 逻辑引脚名 → db 引脚名:先精确匹配,再按「去掉后缀」匹配。
|
|
156
|
+
*
|
|
157
|
+
* db 里同一根脚的写法逐族不同(实测):
|
|
158
|
+
* F1/F0: `PA0-WKUP`、`PC13-TAMPER-RTC`(连字符后缀)
|
|
159
|
+
* F7/L4: `PA13 (JTMS-SWDIO)`(空格 + 括号里的复用功能)
|
|
160
|
+
* 两种都要能对上,否则写进 .ioc 的键名 CubeMX 不认、整根脚被静默丢掉(L4 实测丢过 PA13/PA14)。
|
|
161
|
+
*/
|
|
162
|
+
export function resolveDbPinName(facts, logical) {
|
|
163
|
+
if (facts.pins.has(logical))
|
|
164
|
+
return logical;
|
|
165
|
+
const wanted = logical.trim().toUpperCase();
|
|
166
|
+
for (const name of facts.pins.keys()) {
|
|
167
|
+
if (pinBaseOf(name) === wanted)
|
|
168
|
+
return name;
|
|
169
|
+
}
|
|
170
|
+
return null;
|
|
171
|
+
}
|
|
172
|
+
/**
|
|
173
|
+
* db 引脚名去掉后缀(`PA0-WKUP` → PA0;`PA13 (JTMS-SWDIO)` → PA13;`PA13(JTMS/SWDIO)` → PA13)。
|
|
174
|
+
*
|
|
175
|
+
* 三种写法都在 db 里出现过(实测):F1 用连字符、F7/L4 用「空格 + 括号」、H5 用「无空格 + 斜杠」。
|
|
176
|
+
* 少拆一种,那根脚就解析不出来 → .ioc 里写的是逻辑名、CubeMX 不认、整根脚被静默丢掉(H5 实测丢过 SWD)。
|
|
177
|
+
*/
|
|
178
|
+
export function pinBaseOf(dbName) {
|
|
179
|
+
const trimmed = dbName.trim();
|
|
180
|
+
const byParen = (trimmed.split("(")[0] ?? trimmed).trim();
|
|
181
|
+
const bySpace = byParen.split(/\s+/u)[0] ?? byParen;
|
|
182
|
+
return bySpace.split("-")[0] ?? bySpace;
|
|
183
|
+
}
|
|
184
|
+
/** 反查:db 引脚名 → 逻辑名(PA0-WKUP → PA0、PA13 (JTMS-SWDIO) → PA13)。 */
|
|
185
|
+
export function logicalPinName(dbName) {
|
|
186
|
+
return pinBaseOf(dbName);
|
|
187
|
+
}
|
|
188
|
+
/** 该芯片是否有这个 IP 实例(TIM3、ADC1…)。 */
|
|
189
|
+
export function hasIpInstance(facts, instanceName) {
|
|
190
|
+
return facts.ips.has(instanceName.trim().toUpperCase());
|
|
191
|
+
}
|
|
192
|
+
/** 某个 IP 实例的 Modes 文件路径(db/mcu/IP/<Name>-<Version>_Modes.xml)。 */
|
|
193
|
+
export function ipModesPath(db, facts, instanceName) {
|
|
194
|
+
const ip = facts.ips.get(instanceName.trim().toUpperCase());
|
|
195
|
+
if (ip === undefined)
|
|
196
|
+
return null;
|
|
197
|
+
const file = join(db.root, "mcu", "IP", ip.name + "-" + ip.version + "_Modes.xml");
|
|
198
|
+
return existsSync(file) ? file : null;
|
|
199
|
+
}
|
|
200
|
+
/** 读某个 IP 的合法模式名(RefMode Name=…),例如 PWM Generation1 CH1。 */
|
|
201
|
+
export function readIpModeNames(db, facts, instanceName) {
|
|
202
|
+
const file = ipModesPath(db, facts, instanceName);
|
|
203
|
+
if (file === null)
|
|
204
|
+
return [];
|
|
205
|
+
const text = readFileSync(file, "utf8");
|
|
206
|
+
const names = [];
|
|
207
|
+
for (const match of text.matchAll(/<RefMode\b[^>]*Name="([^"]+)"/gu))
|
|
208
|
+
names.push(match[1]);
|
|
209
|
+
return [...new Set(names)];
|
|
210
|
+
}
|
|
211
|
+
/**
|
|
212
|
+
* 读某个 IP 实例的合法参数名(Modes 文件里的 <RefParameter Name="…">),例如 USART1 的
|
|
213
|
+
* BaudRate / WordLength / Parity。.ioc 里 `<IP>.<参数>` 的键名必须逐字等于这些名字,
|
|
214
|
+
* 拼错就会被 CubeMX 静默丢弃——所以覆盖率闸门用它校验「形状对、名字错」。
|
|
215
|
+
*
|
|
216
|
+
* F1 系列有个坑:参数名不在 `db/mcu/<Mcu>.xml`(那里只有 <IP> 的实例清单,RefParameter 为 0),
|
|
217
|
+
* 而在 `db/mcu/IP/<Name>-<Version>_Modes.xml` 里,所以要按 ipModesPath 再走一次。
|
|
218
|
+
* 返回空数组表示「查不到,别据此判错」(调用方据此跳过校验)。
|
|
219
|
+
*/
|
|
220
|
+
const IP_PARAM_CACHE = new Map();
|
|
221
|
+
export function readIpParameterNames(db, facts, instanceName) {
|
|
222
|
+
const file = ipModesPath(db, facts, instanceName);
|
|
223
|
+
if (file === null)
|
|
224
|
+
return [];
|
|
225
|
+
const cached = IP_PARAM_CACHE.get(file);
|
|
226
|
+
if (cached !== undefined)
|
|
227
|
+
return [...cached];
|
|
228
|
+
const text = readFileSync(file, "utf8");
|
|
229
|
+
const names = [];
|
|
230
|
+
for (const match of text.matchAll(/<RefParameter\b[^>]*\bName="([^"]+)"/gu))
|
|
231
|
+
names.push(match[1]);
|
|
232
|
+
const unique = [...new Set(names)];
|
|
233
|
+
IP_PARAM_CACHE.set(file, unique);
|
|
234
|
+
return [...unique];
|
|
235
|
+
}
|
|
236
|
+
/**
|
|
237
|
+
* 这颗芯片上「真的有引脚」的外设族(USART / TIM / ADC / SPI …)。
|
|
238
|
+
*
|
|
239
|
+
* 用途:.ioc 的 Mcu.IPn 里除了真外设,还会出现内核项(CORTEX_M0+)、板名(NUCLEO-C031C6)、
|
|
240
|
+
* SYS / DEBUG 这类没有引脚的东西。判断「进了 Mcu.IPn 却没有脚指向它 → CubeMX 会忽略」时,
|
|
241
|
+
* 必须先排除它们——它们本来就不该有脚。db 的 <Pin><Signal Name=…> 是权威来源:
|
|
242
|
+
* 芯片真实的引脚复用里出现过哪些外设族,就只校验这些族。
|
|
243
|
+
*
|
|
244
|
+
* 实测(2026-11,DB.6.0.150):C0 的 STM32C031C(4-6)Tx.xml 的引脚信号里没有 CORTEX_M0+、
|
|
245
|
+
* 也没有板名,而 USART2_TX / TIM3_CH1 / ADC1_IN13 都在 → 用它做判据不会误报内核项。
|
|
246
|
+
*/
|
|
247
|
+
export function instancesWithPins(facts) {
|
|
248
|
+
const out = new Set();
|
|
249
|
+
for (const pin of facts.pins.values()) {
|
|
250
|
+
for (const signal of pin.signals.keys()) {
|
|
251
|
+
const name = signal.startsWith("S_") ? signal.slice(2) : signal;
|
|
252
|
+
const head = (name.split("_")[0] ?? "").trim().toUpperCase();
|
|
253
|
+
if (head === "")
|
|
254
|
+
continue;
|
|
255
|
+
// 同时收实例名(USART1)与族名(USART):调用方拿 Mcu.IPn 里的实例名去比,
|
|
256
|
+
// 而名字的粒度两边不一定一样(引脚信号里常带实例号:USART1_TX、TIM3_CH1)。
|
|
257
|
+
out.add(head);
|
|
258
|
+
const base = head.replace(/[0-9]+$/u, "");
|
|
259
|
+
if (base !== "")
|
|
260
|
+
out.add(base);
|
|
261
|
+
// ADCx_IN1 / DACx_OUT1:共享信号的名字里没有实例号,只有族名 ADCx → 归到 ADC。
|
|
262
|
+
if (/^ADCX?$/u.test(head))
|
|
263
|
+
out.add("ADC");
|
|
264
|
+
if (/^DACX?$/u.test(head))
|
|
265
|
+
out.add("DAC");
|
|
266
|
+
}
|
|
267
|
+
}
|
|
268
|
+
return out;
|
|
269
|
+
}
|
|
270
|
+
/** Mcu.IPn 里的实例名 → 族名(USART1 → USART、TIM3 → TIM;不接数字的原样大写)。 */
|
|
271
|
+
export function instanceFamilyName(instanceName) {
|
|
272
|
+
return instanceName.trim().toUpperCase().replace(/[0-9]+$/u, "");
|
|
273
|
+
}
|