dsh-stm32 0.1.2 → 0.1.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +92 -40
- package/README_EN.md +85 -36
- package/assets/README.md +85 -0
- package/assets/VERSION +1 -0
- package/assets/device/c0/chips.json +1108 -0
- package/assets/device/f0/chips.json +1570 -0
- package/assets/device/f1/chips.json +1238 -0
- package/assets/device/f1/svd/100.json +943 -0
- package/assets/device/f1/svd/101.json +901 -0
- package/assets/device/f1/svd/102.json +522 -0
- package/assets/device/f1/svd/103.json +1139 -0
- package/assets/device/f1/svd/105.json +1117 -0
- package/assets/device/f1/svd/107.json +1195 -0
- package/assets/device/f2/chips.json +674 -0
- package/assets/device/f3/chips.json +1318 -0
- package/assets/device/f4/chips.json +2942 -0
- package/assets/device/f7/chips.json +1710 -0
- package/assets/device/g0/chips.json +2102 -0
- package/assets/device/g4/chips.json +2494 -0
- package/assets/device/h5/chips.json +898 -0
- package/assets/device/h7/chips.json +1948 -0
- package/assets/device/l0/chips.json +2494 -0
- package/assets/device/l1/chips.json +1234 -0
- package/assets/device/l4/chips.json +2130 -0
- package/assets/device/l4+/chips.json +856 -0
- package/assets/device/l5/chips.json +226 -0
- package/assets/device/u0/chips.json +688 -0
- package/assets/device/u3/chips.json +310 -0
- package/assets/device/u5/chips.json +884 -0
- package/assets/device/wba/chips.json +506 -0
- package/assets/device/wl/chips.json +184 -0
- package/assets/headers/f1/stm32f100xb.h +5972 -0
- package/assets/headers/f1/stm32f100xe.h +6587 -0
- package/assets/headers/f1/stm32f101x6.h +5315 -0
- package/assets/headers/f1/stm32f101xb.h +5446 -0
- package/assets/headers/f1/stm32f101xe.h +6503 -0
- package/assets/headers/f1/stm32f101xg.h +6713 -0
- package/assets/headers/f1/stm32f102x6.h +6448 -0
- package/assets/headers/f1/stm32f102xb.h +6570 -0
- package/assets/headers/f1/stm32f103x6.h +10109 -0
- package/assets/headers/f1/stm32f103xb.h +10240 -0
- package/assets/headers/f1/stm32f103xe.h +11767 -0
- package/assets/headers/f1/stm32f103xg.h +11951 -0
- package/assets/headers/f1/stm32f105xc.h +14340 -0
- package/assets/headers/f1/stm32f107xc.h +15253 -0
- package/assets/headers/f1/stm32f1xx.h +273 -0
- package/assets/headers/f1/system_stm32f1xx.h +96 -0
- package/assets/ioc/family/C0.ioc +82 -0
- package/assets/ioc/family/F0.ioc +71 -0
- package/assets/ioc/family/F2.ioc +91 -0
- package/assets/ioc/family/F3.ioc +94 -0
- package/assets/ioc/family/F4.ioc +91 -0
- package/assets/ioc/family/F7.ioc +102 -0
- package/assets/ioc/family/G0.ioc +90 -0
- package/assets/ioc/family/G4.ioc +110 -0
- package/assets/ioc/family/H5.ioc +116 -0
- package/assets/ioc/family/H7.ioc +133 -0
- package/assets/ioc/family/L0.ioc +92 -0
- package/assets/ioc/family/L1.ioc +87 -0
- package/assets/ioc/family/L4+.ioc +92 -0
- package/assets/ioc/family/L4.ioc +93 -0
- package/assets/ioc/family/L5.ioc +91 -0
- package/assets/ioc/family/U0.ioc +103 -0
- package/assets/ioc/family/U3.ioc +113 -0
- package/assets/ioc/family/U5.ioc +102 -0
- package/assets/ioc/family/WBA.ioc +100 -0
- package/assets/ioc/family/WL.ioc +93 -0
- package/assets/ioc/minimal/STM32F100C8Tx.ioc +113 -0
- package/assets/ioc/minimal/STM32F100RCTx.ioc +113 -0
- package/assets/ioc/minimal/STM32F101C4Tx.ioc +113 -0
- package/assets/ioc/minimal/STM32F101C8Tx.ioc +113 -0
- package/assets/ioc/minimal/STM32F101RCTx.ioc +113 -0
- package/assets/ioc/minimal/STM32F101RFTx.ioc +113 -0
- package/assets/ioc/minimal/STM32F102C4Tx.ioc +113 -0
- package/assets/ioc/minimal/STM32F102C8Tx.ioc +113 -0
- package/assets/ioc/minimal/STM32F103C4Tx.ioc +113 -0
- package/assets/ioc/minimal/STM32F103C8Tx.ioc +113 -0
- package/assets/ioc/minimal/STM32F103RCTx.ioc +113 -0
- package/assets/ioc/minimal/STM32F103RFTx.ioc +113 -0
- package/assets/ioc/minimal/STM32F105RCTx.ioc +113 -0
- package/assets/ioc/minimal/STM32F107RCTx.ioc +113 -0
- package/assets/ld/f1/STM32F100C8Tx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F100RCTx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F101C4Tx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F101C8Tx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F101RCTx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F101RFTx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F102C4Tx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F102C8Tx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F103C4Tx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F103C8Tx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F103RCTx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F103RFTx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F105RCTx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F107RCTx_FLASH.ld +249 -0
- package/assets/manifest.json +1130 -0
- package/assets/startup/f1/startup_stm32f100xb.s +407 -0
- package/assets/startup/f1/startup_stm32f100xe.s +449 -0
- package/assets/startup/f1/startup_stm32f101x6.s +322 -0
- package/assets/startup/f1/startup_stm32f101xb.s +338 -0
- package/assets/startup/f1/startup_stm32f101xe.s +423 -0
- package/assets/startup/f1/startup_stm32f101xg.s +439 -0
- package/assets/startup/f1/startup_stm32f102x6.s +330 -0
- package/assets/startup/f1/startup_stm32f102xb.s +346 -0
- package/assets/startup/f1/startup_stm32f103x6.s +348 -0
- package/assets/startup/f1/startup_stm32f103xb.s +364 -0
- package/assets/startup/f1/startup_stm32f103xe.s +470 -0
- package/assets/startup/f1/startup_stm32f103xg.s +466 -0
- package/assets/startup/f1/startup_stm32f105xc.s +463 -0
- package/assets/startup/f1/startup_stm32f107xc.s +472 -0
- package/assets/templates/family/C0.ioc +82 -0
- package/assets/templates/family/F0.ioc +71 -0
- package/assets/templates/family/F2.ioc +91 -0
- package/assets/templates/family/F3.ioc +94 -0
- package/assets/templates/family/F4.ioc +91 -0
- package/assets/templates/family/F7.ioc +102 -0
- package/assets/templates/family/G0.ioc +90 -0
- package/assets/templates/family/G4.ioc +110 -0
- package/assets/templates/family/H5.ioc +116 -0
- package/assets/templates/family/H7.ioc +133 -0
- package/assets/templates/family/L0.ioc +92 -0
- package/assets/templates/family/L1.ioc +87 -0
- package/assets/templates/family/L4+.ioc +92 -0
- package/assets/templates/family/L4.ioc +93 -0
- package/assets/templates/family/L5.ioc +91 -0
- package/assets/templates/family/U0.ioc +103 -0
- package/assets/templates/family/U3.ioc +113 -0
- package/assets/templates/family/U5.ioc +102 -0
- package/assets/templates/family/WB.ioc +81 -0
- package/assets/templates/family/WBA.ioc +100 -0
- package/assets/templates/family/WL.ioc +93 -0
- package/docs/reading-guide.md +94 -71
- package/lib/data/chips.js +38 -51
- package/lib/data/clock-db.js +830 -0
- package/lib/data/clock-f1.js +12 -45
- package/lib/data/cmsis-sources.js +264 -17
- package/lib/data/db-presets.js +252 -0
- package/lib/data/device-facts.js +274 -0
- package/lib/data/family.js +515 -0
- package/lib/data/firmware-packages.js +562 -0
- package/lib/data/install-guides.js +2 -2
- package/lib/data/ioc-presets.js +248 -0
- package/lib/data/ioc-schema.js +1058 -0
- package/lib/data/rm-topics/stm32c0.json +227 -0
- package/lib/data/rm-topics.js +103 -0
- package/lib/data/search-roots.js +42 -1
- package/lib/data/stm32f1.js +95 -150
- package/lib/data/svd.js +643 -0
- package/lib/data/toolchain-config.js +0 -14
- package/lib/engine/assets.js +659 -0
- package/lib/engine/breakpoints.js +297 -0
- package/lib/engine/clock-derived.js +101 -0
- package/lib/engine/clock-direct.js +313 -0
- package/lib/engine/clock-plan.js +96 -52
- package/lib/engine/clock-pllmn.js +319 -0
- package/lib/engine/cmake-sources.js +67 -13
- package/lib/engine/cube-mx-guard.js +44 -0
- package/lib/engine/cube-programmer.js +137 -0
- package/lib/engine/cubemx-db.js +273 -0
- package/lib/engine/debug-session.js +576 -22
- package/lib/engine/debug.js +99 -46
- package/lib/engine/doctor.js +162 -19
- package/lib/engine/facts-acquire.js +416 -0
- package/lib/engine/facts.js +134 -0
- package/lib/engine/firmware-install.js +176 -5
- package/lib/engine/firmware-official.js +451 -0
- package/lib/engine/flash.js +317 -76
- package/lib/engine/gdb-mi.js +476 -0
- package/lib/engine/generate.js +9 -2
- package/lib/engine/hal-chip.js +124 -41
- package/lib/engine/ioc-plan.js +1247 -63
- package/lib/engine/ioc-rules.js +698 -0
- package/lib/engine/ioc-verify.js +706 -0
- package/lib/engine/ioc.js +43 -4
- package/lib/engine/msys2-install.js +4 -4
- package/lib/engine/probe-error.js +231 -0
- package/lib/engine/probe-session.js +347 -0
- package/lib/engine/probe.js +18 -3
- package/lib/engine/register-clock.js +41 -0
- package/lib/engine/register-gpio.js +115 -0
- package/lib/engine/register-linker.js +12 -7
- package/lib/engine/register-template.js +130 -45
- package/lib/engine/regs.js +43 -8
- package/lib/engine/rm-extract.js +144 -0
- package/lib/engine/rm-sources.js +360 -0
- package/lib/engine/rm-text.js +56 -0
- package/lib/engine/rtt.js +758 -0
- package/lib/engine/scaffold.js +185 -18
- package/lib/engine/toolchain-gate.js +0 -4
- package/lib/engine/watch.js +227 -0
- package/lib/index.js +12 -2
- package/lib/skill/stm32-workflow.js +2 -2
- package/lib/tools/assets.js +272 -0
- package/lib/tools/cache.js +8 -0
- package/lib/tools/debug-session.js +41 -6
- package/lib/tools/debug.js +41 -11
- package/lib/tools/doctor.js +65 -4
- package/lib/tools/firmware-install.js +31 -6
- package/lib/tools/flash.js +47 -10
- package/lib/tools/generate.js +25 -0
- package/lib/tools/ioc-apply.js +2 -0
- package/lib/tools/ioc-inspect.js +2 -0
- package/lib/tools/ioc-plan.js +59 -2
- package/lib/tools/ioc-verify.js +237 -0
- package/lib/tools/project-create.js +63 -3
- package/lib/tools/regs.js +453 -61
- package/lib/tools/route-plan.js +3 -0
- package/lib/tools/rtt.js +470 -0
- package/lib/tools/watch.js +256 -0
- package/package.json +5 -4
- package/templates/openocd/stm32c0x.cfg +83 -0
- package/templates/openocd/stm32u0x.cfg +64 -0
- package/templates/register/CMakeLists.txt +8 -2
- package/templates/register/Core/Inc/rtt.h +138 -0
- package/templates/register/Core/Src/main.c +42 -25
- package/templates/register/Core/Src/rtt.c +373 -0
- package/templates/scaffold/RTT.md +90 -0
- package/templates/scaffold/STM32F103XX_FLASH.ld +3 -0
- package/templates/scaffold/cmake/user/CMakeLists.txt +7 -0
- package/templates/scaffold/openocd.cfg +5 -3
- package/templates/scaffold/vscode/launch.json +8 -4
- package/docs/development-notes.md +0 -2116
- package/docs/dsh-stm32-plugin-/350/247/204/346/240/274.md +0 -673
- package/docs/logic-audit.md +0 -607
- package/lib/data/f1-ram.generated.js +0 -34
|
@@ -0,0 +1,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
|
+
}
|