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,297 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* B4:断点预算 —— 按芯片的真实上限限制硬件断点 / 数据观察点,超限在碰探针之前就报。
|
|
3
|
+
*
|
|
4
|
+
* 为什么要有这一层:Cortex-M 的硬件断点用 FPB 代码比较器、观察点用 DWT 数据比较器,
|
|
5
|
+
* STM32F1 只有 6 / 4 个。第 7 个断点不是"慢一点",而是 gdb 报
|
|
6
|
+
* "Cannot insert breakpoint N" 然后整次调试提前收场,用户看到的是"调试莫名其妙失败"。
|
|
7
|
+
* 所以这里在设断点之前先把请求和预算对齐:超了就一次说清超了几个、删哪个、换成什么,
|
|
8
|
+
* 而且这一步发生在 spawn openocd 之前(探针不动、不占用)。
|
|
9
|
+
*
|
|
10
|
+
* 预算来源(优先级从高到低):
|
|
11
|
+
* 1. 内置资源 chips.json 里给这颗芯片写的 breakpoints / watchpoints;
|
|
12
|
+
* 2. 按内核的硬件上限(data/family.ts 的 debugBudgetForCore):M0/M0+ 4/2、M3/M4 6/4、M7/M33/M55 8/4;
|
|
13
|
+
* 3. 都没有(没有 .ioc / 认不出族)→ F1 实测值 6 / 4,并在 note 里说清是兜底。
|
|
14
|
+
*
|
|
15
|
+
* 为什么不按族写死:比较器个数是**内核**属性(FPB/DWT),同族不同内核会对不上;
|
|
16
|
+
* 按内核算一次就对,也能覆盖 MPU 之外的所有 STM32。
|
|
17
|
+
*/
|
|
18
|
+
import { readFileSync, readdirSync } from "node:fs";
|
|
19
|
+
import { join } from "node:path";
|
|
20
|
+
import { findChipFact } from "../data/device-facts.js";
|
|
21
|
+
import { debugBudgetForCore, readProjectFamily } from "../data/family.js";
|
|
22
|
+
import { locateCubemxDb, readMcuFacts } from "./cubemx-db.js";
|
|
23
|
+
import { resolveSearchConfig } from "../data/search-roots.js";
|
|
24
|
+
/** F1 实测:6 个硬件断点、4 个观察点。 */
|
|
25
|
+
export const F1_BREAKPOINT_BUDGET = { code: 6, data: 4 };
|
|
26
|
+
/** used 夹在 [0, limit] 里:报告不能让"已用"看起来超过上限或为负。 */
|
|
27
|
+
export function quotaOf(used, limit) {
|
|
28
|
+
const cap = Number.isFinite(limit) ? Math.max(0, Math.trunc(limit)) : 0;
|
|
29
|
+
const taken = Number.isFinite(used) ? Math.min(cap, Math.max(0, Math.trunc(used))) : 0;
|
|
30
|
+
return { used: taken, limit: cap, remaining: cap - taken };
|
|
31
|
+
}
|
|
32
|
+
function usableCount(value) {
|
|
33
|
+
return typeof value === "number" && Number.isFinite(value) && value > 0 ? Math.trunc(value) : null;
|
|
34
|
+
}
|
|
35
|
+
/**
|
|
36
|
+
* chips.json 里的芯片记录 → 预算;没写就返回 null(调用方回退 F1 默认)。
|
|
37
|
+
* 只写了一个字段时,另一个按 F1 默认补齐——比整份作废更有用。
|
|
38
|
+
*/
|
|
39
|
+
export function budgetFromChipFact(chip) {
|
|
40
|
+
if (chip === null || chip === undefined)
|
|
41
|
+
return null;
|
|
42
|
+
const code = usableCount(chip.breakpoints);
|
|
43
|
+
const data = usableCount(chip.watchpoints);
|
|
44
|
+
if (code === null && data === null)
|
|
45
|
+
return null;
|
|
46
|
+
return { code: code ?? F1_BREAKPOINT_BUDGET.code, data: data ?? F1_BREAKPOINT_BUDGET.data };
|
|
47
|
+
}
|
|
48
|
+
/** 工程里 .ioc 的 Mcu.CPN(找不到就是空串;多个 .ioc 时按文件名顺序取第一个读得出来的)。 */
|
|
49
|
+
export function readIocCpn(projectDir) {
|
|
50
|
+
let names;
|
|
51
|
+
try {
|
|
52
|
+
names = readdirSync(projectDir);
|
|
53
|
+
}
|
|
54
|
+
catch {
|
|
55
|
+
return "";
|
|
56
|
+
}
|
|
57
|
+
const candidates = names.filter((name) => name.toLowerCase().endsWith(".ioc")).sort();
|
|
58
|
+
for (const name of candidates) {
|
|
59
|
+
try {
|
|
60
|
+
const text = readFileSync(join(projectDir, name), "utf8");
|
|
61
|
+
const match = /^Mcu\.CPN=(.+)$/mu.exec(text);
|
|
62
|
+
const cpn = match === null ? "" : (match[1] ?? "").trim();
|
|
63
|
+
if (cpn !== "")
|
|
64
|
+
return cpn.toUpperCase();
|
|
65
|
+
}
|
|
66
|
+
catch {
|
|
67
|
+
// 读不了就试下一个;没有可用的就回退默认预算(不让断点预算把调试挡在门外)。
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
return "";
|
|
71
|
+
}
|
|
72
|
+
/** 工程 → 芯片 → 预算。任何一步失败都退回内核上限(再不行 F1 默认)并说明原因。 */
|
|
73
|
+
/**
|
|
74
|
+
* `.ioc` 里的 `Mcu.Name`(db 分组名,例如 STM32F103C(8-B)Tx);读不到返回空串。
|
|
75
|
+
*
|
|
76
|
+
* 用它去查本机 CubeMX db 的 `<Core>`:族画像里的 core 是"手写兜底",db 才是逐型号的真源
|
|
77
|
+
* (同一族里 MPU/双核/单核写法不同,见 cubemx-db.ts 里 CubemxMcuFacts.core 的注释)。
|
|
78
|
+
*/
|
|
79
|
+
function readIocMcuName(projectDir) {
|
|
80
|
+
let names;
|
|
81
|
+
try {
|
|
82
|
+
names = readdirSync(projectDir);
|
|
83
|
+
}
|
|
84
|
+
catch {
|
|
85
|
+
return "";
|
|
86
|
+
}
|
|
87
|
+
for (const name of names.filter((item) => item.toLowerCase().endsWith(".ioc")).sort()) {
|
|
88
|
+
try {
|
|
89
|
+
const matched = /^Mcu\.Name=(.+)$/mu.exec(readFileSync(join(projectDir, name), "utf8"));
|
|
90
|
+
const value = (matched?.[1] ?? "").trim();
|
|
91
|
+
if (value !== "")
|
|
92
|
+
return value;
|
|
93
|
+
}
|
|
94
|
+
catch {
|
|
95
|
+
// 读不了就试下一个
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
return "";
|
|
99
|
+
}
|
|
100
|
+
export function resolveBreakpointBudget(projectDir, env = process.env) {
|
|
101
|
+
const cpn = readIocCpn(projectDir);
|
|
102
|
+
const family = readProjectFamily(projectDir);
|
|
103
|
+
// 内核优先取本机 CubeMX db 里这颗芯片的 <Core>(逐型号真源),读不到才退回族画像的 core。
|
|
104
|
+
const db = locateCubemxDb(resolveSearchConfig(env).cubeMxRoots);
|
|
105
|
+
const mcuName = db === null ? "" : readIocMcuName(projectDir);
|
|
106
|
+
const dbFacts = db === null || mcuName === "" ? null : readMcuFacts(db, mcuName);
|
|
107
|
+
const coreFromDb = (dbFacts?.core ?? "").trim();
|
|
108
|
+
const coreText = coreFromDb !== "" ? coreFromDb : (family?.core ?? "");
|
|
109
|
+
const coreSource = coreFromDb !== "" ? "db" : "profile";
|
|
110
|
+
// 内核预算:MPU(A7/A35)不走比较器模型。
|
|
111
|
+
const coreBudget = coreText === "" || /cortex-a/i.test(coreText) ? null : debugBudgetForCore(coreText);
|
|
112
|
+
const fallback = (why) => {
|
|
113
|
+
if (coreBudget === null) {
|
|
114
|
+
return {
|
|
115
|
+
budget: F1_BREAKPOINT_BUDGET,
|
|
116
|
+
source: "f1-default",
|
|
117
|
+
chip: cpn,
|
|
118
|
+
note: "断点预算按 STM32F1 默认 " + String(F1_BREAKPOINT_BUDGET.code) + " 个硬件断点 / "
|
|
119
|
+
+ String(F1_BREAKPOINT_BUDGET.data) + " 个观察点算(" + why + ")",
|
|
120
|
+
};
|
|
121
|
+
}
|
|
122
|
+
return {
|
|
123
|
+
budget: coreBudget,
|
|
124
|
+
source: "core",
|
|
125
|
+
chip: cpn,
|
|
126
|
+
note: "断点预算按内核 " + coreText + "(" + (coreSource === "db" ? "本机 CubeMX db 的 <Core>" : "族画像兜底") + ")的硬件上限:"
|
|
127
|
+
+ String(coreBudget.code) + " 个硬件断点 / " + String(coreBudget.data) + " 个观察点(" + why + ")",
|
|
128
|
+
};
|
|
129
|
+
};
|
|
130
|
+
if (cpn === "")
|
|
131
|
+
return fallback("工程里没找到 .ioc");
|
|
132
|
+
let fact = null;
|
|
133
|
+
try {
|
|
134
|
+
fact = findChipFact(cpn, env);
|
|
135
|
+
}
|
|
136
|
+
catch {
|
|
137
|
+
fact = null;
|
|
138
|
+
}
|
|
139
|
+
if (fact === null)
|
|
140
|
+
return fallback("chips.json 里没有 " + cpn);
|
|
141
|
+
const budget = budgetFromChipFact(fact);
|
|
142
|
+
if (budget === null)
|
|
143
|
+
return fallback("chips.json 的 " + cpn + " 没写 breakpoints/watchpoints");
|
|
144
|
+
return {
|
|
145
|
+
budget,
|
|
146
|
+
source: "chips.json",
|
|
147
|
+
chip: cpn,
|
|
148
|
+
note: "断点预算来自 chips.json(" + cpn + "):" + String(budget.code) + " 个硬件断点 / " + String(budget.data) + " 个观察点",
|
|
149
|
+
};
|
|
150
|
+
}
|
|
151
|
+
const BREAK_COMMANDS = new Set(["break", "b", "tbreak", "tb", "hbreak", "thbreak", "rbreak"]);
|
|
152
|
+
const WATCH_COMMANDS = new Set(["watch", "rwatch", "awatch"]);
|
|
153
|
+
/**
|
|
154
|
+
* "main" / "watch:g_led_count" / "break:HAL_Delay" → 规范化断点。
|
|
155
|
+
* 前缀只用来标 kind,去掉前缀后的部分原样交给 gdb。空串返回 null(调用方忽略)。
|
|
156
|
+
*/
|
|
157
|
+
export function parseBreakpointSpec(text) {
|
|
158
|
+
const raw = text.trim();
|
|
159
|
+
if (raw === "")
|
|
160
|
+
return null;
|
|
161
|
+
const lower = raw.toLowerCase();
|
|
162
|
+
for (const prefix of ["watch:", "rwatch:", "awatch:", "data:"]) {
|
|
163
|
+
if (lower.startsWith(prefix)) {
|
|
164
|
+
const location = raw.slice(prefix.length).trim();
|
|
165
|
+
return location === "" ? null : { location, kind: "data" };
|
|
166
|
+
}
|
|
167
|
+
}
|
|
168
|
+
for (const prefix of ["break:", "tbreak:", "hbreak:", "code:"]) {
|
|
169
|
+
if (lower.startsWith(prefix)) {
|
|
170
|
+
const location = raw.slice(prefix.length).trim();
|
|
171
|
+
return location === "" ? null : { location, kind: "code" };
|
|
172
|
+
}
|
|
173
|
+
}
|
|
174
|
+
return { location: raw, kind: "code" };
|
|
175
|
+
}
|
|
176
|
+
/** 一条 gdb 命令 → 断点请求(只认 break/watch 家族;别的命令原样留给 preCommands 执行)。 */
|
|
177
|
+
export function breakpointFromGdbCommand(command) {
|
|
178
|
+
const text = command.trim();
|
|
179
|
+
if (text === "")
|
|
180
|
+
return null;
|
|
181
|
+
const match = /^([A-Za-z]+)(?:\s+(.*))?$/u.exec(text);
|
|
182
|
+
if (match === null)
|
|
183
|
+
return null;
|
|
184
|
+
const verb = (match[1] ?? "").toLowerCase();
|
|
185
|
+
const rest = (match[2] ?? "").trim();
|
|
186
|
+
if (BREAK_COMMANDS.has(verb))
|
|
187
|
+
return { location: rest === "" ? "(当前 pc)" : rest, kind: "code" };
|
|
188
|
+
if (WATCH_COMMANDS.has(verb))
|
|
189
|
+
return { location: rest === "" ? "(当前表达式)" : rest, kind: "data" };
|
|
190
|
+
return null;
|
|
191
|
+
}
|
|
192
|
+
/**
|
|
193
|
+
* 把三处来源(breakAt / breakpoints / preCommands)收成一份不重复的请求清单。
|
|
194
|
+
*
|
|
195
|
+
* 同一位置只留一个:硬件比较器按地址分配,重复的 break 在 gdb 里会各占一个编号,
|
|
196
|
+
* 真到 FPB 上就是白吃一个比较器。
|
|
197
|
+
*/
|
|
198
|
+
export function collectBreakpointRequests(input) {
|
|
199
|
+
const notes = [];
|
|
200
|
+
const raw = [];
|
|
201
|
+
const breakAt = (input.breakAt ?? "").trim();
|
|
202
|
+
if (breakAt !== "" && breakAt.toLowerCase() !== "none")
|
|
203
|
+
raw.push({ location: breakAt, kind: "code" });
|
|
204
|
+
for (const text of input.breakpoints ?? []) {
|
|
205
|
+
const spec = parseBreakpointSpec(text);
|
|
206
|
+
if (spec === null)
|
|
207
|
+
notes.push("breakpoints 里有一个空串,已经忽略");
|
|
208
|
+
else
|
|
209
|
+
raw.push(spec);
|
|
210
|
+
}
|
|
211
|
+
let fromPre = 0;
|
|
212
|
+
for (const command of input.preCommands ?? []) {
|
|
213
|
+
const spec = breakpointFromGdbCommand(command);
|
|
214
|
+
if (spec === null)
|
|
215
|
+
continue;
|
|
216
|
+
raw.push(spec);
|
|
217
|
+
fromPre += 1;
|
|
218
|
+
}
|
|
219
|
+
if (fromPre > 0)
|
|
220
|
+
notes.push("preCommands 里有 " + String(fromPre) + " 条 break/watch 命令,也一起算进断点预算");
|
|
221
|
+
const seen = new Set();
|
|
222
|
+
const requested = [];
|
|
223
|
+
for (const spec of raw) {
|
|
224
|
+
const key = spec.kind + "\u0000" + spec.location;
|
|
225
|
+
if (seen.has(key))
|
|
226
|
+
continue;
|
|
227
|
+
seen.add(key);
|
|
228
|
+
requested.push(spec);
|
|
229
|
+
}
|
|
230
|
+
if (requested.length !== raw.length) {
|
|
231
|
+
notes.push("有 " + String(raw.length - requested.length) + " 个重复断点(同一位置)并成了一个,不重复占比较器");
|
|
232
|
+
}
|
|
233
|
+
return { requested, notes };
|
|
234
|
+
}
|
|
235
|
+
/** 超预算时的一句话(放进 errors[0],用户最先看到的就是它)。 */
|
|
236
|
+
function overflowDetail(codeAsked, dataAsked, budget, overCode, overData) {
|
|
237
|
+
const parts = [];
|
|
238
|
+
if (overCode > 0)
|
|
239
|
+
parts.push("多 " + String(overCode) + " 个硬件断点");
|
|
240
|
+
if (overData > 0)
|
|
241
|
+
parts.push("多 " + String(overData) + " 个观察点");
|
|
242
|
+
return "这次要设 " + String(codeAsked) + " 个硬件断点 / " + String(dataAsked) + " 个观察点,芯片上限是 "
|
|
243
|
+
+ String(budget.code) + "/" + String(budget.data) + "(" + parts.join("、") + ")";
|
|
244
|
+
}
|
|
245
|
+
/** 超预算时用户能照着做的建议(放进 notes,不塞进一行里的长句)。 */
|
|
246
|
+
function overflowSuggestion(budget, overCode, overData) {
|
|
247
|
+
const parts = [];
|
|
248
|
+
if (overCode > 0) {
|
|
249
|
+
parts.push("删掉多出来的 " + String(overCode) + " 个 break:硬件断点占 FPB 比较器,第 " + String(budget.code + 1) + " 个 gdb 只会报 Cannot insert breakpoint 并把整次调试带崩;要连着停几个点就改用 tbreak(命中即删),或者先 break 一个、到点再换下一个");
|
|
250
|
+
}
|
|
251
|
+
if (overData > 0) {
|
|
252
|
+
parts.push("观察点同理:DWT 只有 " + String(budget.data) + " 个数据比较器,超出的改成一次 watch 一个、或用 print / x 轮询变量");
|
|
253
|
+
}
|
|
254
|
+
parts.push("F1 的 " + String(budget.code) + "/" + String(budget.data) + " 是硅片上限(FPB/DWT 比较器数量),想同时停更多点只能换芯片");
|
|
255
|
+
return parts.join(";");
|
|
256
|
+
}
|
|
257
|
+
/** 请求清单 vs 预算:按顺序放到放不下为止,剩下的进 overflow。 */
|
|
258
|
+
export function planBreakpoints(requested, budget) {
|
|
259
|
+
const cap = {
|
|
260
|
+
code: Number.isFinite(budget.code) ? Math.max(0, Math.trunc(budget.code)) : 0,
|
|
261
|
+
data: Number.isFinite(budget.data) ? Math.max(0, Math.trunc(budget.data)) : 0,
|
|
262
|
+
};
|
|
263
|
+
const placed = [];
|
|
264
|
+
const overflow = [];
|
|
265
|
+
let codeUsed = 0;
|
|
266
|
+
let dataUsed = 0;
|
|
267
|
+
for (const request of requested) {
|
|
268
|
+
if (request.kind === "data") {
|
|
269
|
+
if (dataUsed < cap.data) {
|
|
270
|
+
dataUsed += 1;
|
|
271
|
+
placed.push(request);
|
|
272
|
+
}
|
|
273
|
+
else
|
|
274
|
+
overflow.push(request);
|
|
275
|
+
continue;
|
|
276
|
+
}
|
|
277
|
+
if (codeUsed < cap.code) {
|
|
278
|
+
codeUsed += 1;
|
|
279
|
+
placed.push(request);
|
|
280
|
+
}
|
|
281
|
+
else
|
|
282
|
+
overflow.push(request);
|
|
283
|
+
}
|
|
284
|
+
const codeAsked = codeUsed + overflow.filter((item) => item.kind === "code").length;
|
|
285
|
+
const dataAsked = dataUsed + overflow.filter((item) => item.kind === "data").length;
|
|
286
|
+
const ok = overflow.length === 0;
|
|
287
|
+
return {
|
|
288
|
+
ok,
|
|
289
|
+
placed,
|
|
290
|
+
overflow,
|
|
291
|
+
suggestion: ok ? "" : overflowSuggestion(cap, codeAsked - codeUsed, dataAsked - dataUsed),
|
|
292
|
+
detail: ok ? "" : overflowDetail(codeAsked, dataAsked, cap, codeAsked - codeUsed, dataAsked - dataUsed),
|
|
293
|
+
budget: cap,
|
|
294
|
+
used: { code: codeUsed, data: dataUsed },
|
|
295
|
+
remaining: { code: cap.code - codeUsed, data: cap.data - dataUsed },
|
|
296
|
+
};
|
|
297
|
+
}
|
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 派生频率键的「跟随改写」(RCC.<外设>Freq_Value 这类)。
|
|
3
|
+
*
|
|
4
|
+
* 背景:.ioc 里每个外设都有一份自己的时钟值(USART1Freq_Value、I2C1Freq_Value、MCO1PinFreq_Value…),
|
|
5
|
+
* 它们由 CubeMX 的时钟树按“多路选择器 + 分频”算出来。插件只写自己算得出的那几组
|
|
6
|
+
* (SYSCLK/HCLK/APB1/APB2/ADC/TIM),其余交给 CubeMX 保存时重算 → ioc_verify 里每次都会多出一批
|
|
7
|
+
* “派生键被重算”的记录(不参与 benign 判定,但噪声大,也说明我们承认了“不知道”)。
|
|
8
|
+
*
|
|
9
|
+
* 这里补一条保守规则:**旧值等于某个时钟域、且该域的新旧都唯一** 的派生键,跟着那个域改写。
|
|
10
|
+
* 依据是 CubeMX 自己的默认选择(2026-11 C0 板级往返实测:I2C1/I2S1/USART1/MCO1Pin/MCO2Pin 五个键
|
|
11
|
+
* 从 12 MHz(旧 SYSCLK=APB)变成 48 MHz(新 SYSCLK=APB),与 SYSCLK/APB 同步)。
|
|
12
|
+
* 判据保守是为了不制造假的 valueChanged:
|
|
13
|
+
* - 旧值对不上任何时钟域 → 不动(例如 WatchDogFreq_Value=32000 走 LSI,永远对不上);
|
|
14
|
+
* - 对上多个域、而这些域的新值又不一样(真的分叉了:比如 SYSCLK 72M 但 APB1 36M)→ 不动;
|
|
15
|
+
* - 计划自己已经写过的键 → 不动(以规划器的公式为准)。
|
|
16
|
+
*/
|
|
17
|
+
/** 可作为“跟随目标”的时钟域键名(新值从 entries 里读;旧值用改写前的快照)。 */
|
|
18
|
+
const CLOCK_SLOTS = [
|
|
19
|
+
"SYSCLKFreq_VALUE",
|
|
20
|
+
"HCLKFreq_Value",
|
|
21
|
+
"AHBFreq_Value",
|
|
22
|
+
"CortexFreq_Value",
|
|
23
|
+
"FCLKCortexFreq_Value",
|
|
24
|
+
"APB1Freq_Value",
|
|
25
|
+
"APB1TimFreq_Value",
|
|
26
|
+
"APB2Freq_Value",
|
|
27
|
+
"APB2TimFreq_Value",
|
|
28
|
+
"APBFreq_Value",
|
|
29
|
+
"APBTimFreq_Value",
|
|
30
|
+
"ADCFreqValue",
|
|
31
|
+
"ADCFreq_Value",
|
|
32
|
+
];
|
|
33
|
+
/** RCC 下的派生频率名(SYSCLKFreq_VALUE 的 VALUE 是全大写,必须忽略大小写)。 */
|
|
34
|
+
export function isDerivedFrequencyKey(key) {
|
|
35
|
+
return key.startsWith("RCC.") && /(?:Freq_Value|FreqValue)$/iu.test(key.slice("RCC.".length));
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
* 这些派生名看着是"频率",但**不是**跟着 SYSCLK/APB 走的那批,不能拿旧值当跟随依据:
|
|
39
|
+
* - MCO1PinFreq_Value:MCO 输出脚,源由 RCC.MCO1Source 选(默认 HSI 16 MHz),和 SYSCLK 无关;
|
|
40
|
+
* - VCOInputFreq_Value / VCOOutputFreq_Value:PLL 内部节点(= PLL 输入、×N 之后的频率);
|
|
41
|
+
* - PLL* / PLLI2S* / PLLSAI* / PLL1*:PLL 各路输出;
|
|
42
|
+
* - HSE/HSI/LSE/LSI/MSI:振荡器本身的频率,是**输入**不是输出;
|
|
43
|
+
* - RTC/LSCO/WatchDog:32 kHz 域(LSI/LSE)或独立域。
|
|
44
|
+
*
|
|
45
|
+
* 真机证据(2026-11 G4 @170 MHz 回归):不排除 MCO1PinFreq_Value 与 VCOInputFreq_Value 时,
|
|
46
|
+
* 这两个键的旧值恰好等于旧 SYSCLK(模板里就是这么写的),被"跟着走"改成 170 MHz,
|
|
47
|
+
* 而 CubeMX 回写是 16 MHz / 4 MHz → ioc_verify 报两条 valueChanged、benign 翻成 false。
|
|
48
|
+
*/
|
|
49
|
+
const NOT_FOLLOWED = /^(?:MCO|LSCO|RTC|WatchDog|VCO|PLL|HSE|HSI|LSE|LSI|MSI)/iu;
|
|
50
|
+
/** 可以按"旧值等于某个时钟域"跟随改写的派生名。 */
|
|
51
|
+
export function isFollowableDerivedName(name) {
|
|
52
|
+
if (!/(?:Freq_Value|FreqValue)$/iu.test(name))
|
|
53
|
+
return false;
|
|
54
|
+
return !NOT_FOLLOWED.test(name);
|
|
55
|
+
}
|
|
56
|
+
/**
|
|
57
|
+
* 按“旧值等于某个时钟域”的规则改写派生频率键。
|
|
58
|
+
*
|
|
59
|
+
* 参数 entries 会被就地改写;before 是改写前的快照(在规划器写键之前拍的 new Map(entries));
|
|
60
|
+
* written 是本次计划已经写过的键,这些不碰(以规划器的值为准)。
|
|
61
|
+
*/
|
|
62
|
+
export function followDerivedClocks(entries, before, written) {
|
|
63
|
+
const result = { written: [], skipped: [] };
|
|
64
|
+
const slots = [];
|
|
65
|
+
for (const name of CLOCK_SLOTS) {
|
|
66
|
+
const key = "RCC." + name;
|
|
67
|
+
const oldText = before.get(key);
|
|
68
|
+
const newText = entries.get(key);
|
|
69
|
+
if (oldText === undefined || newText === undefined)
|
|
70
|
+
continue;
|
|
71
|
+
if (!/^\d+$/u.test(oldText.trim()) || !/^\d+$/u.test(newText.trim()))
|
|
72
|
+
continue;
|
|
73
|
+
slots.push({ name, oldHz: Number.parseInt(oldText.trim(), 10), newHz: Number.parseInt(newText.trim(), 10) });
|
|
74
|
+
}
|
|
75
|
+
if (slots.length === 0)
|
|
76
|
+
return result;
|
|
77
|
+
for (const [key, value] of entries) {
|
|
78
|
+
if (!isDerivedFrequencyKey(key))
|
|
79
|
+
continue;
|
|
80
|
+
if (!isFollowableDerivedName(key.slice("RCC.".length)))
|
|
81
|
+
continue;
|
|
82
|
+
if (written.has(key))
|
|
83
|
+
continue;
|
|
84
|
+
if (!/^\d+$/u.test(value.trim()))
|
|
85
|
+
continue;
|
|
86
|
+
const oldHz = Number.parseInt(value.trim(), 10);
|
|
87
|
+
const hits = slots.filter((slot) => slot.oldHz === oldHz);
|
|
88
|
+
if (hits.length === 0)
|
|
89
|
+
continue;
|
|
90
|
+
const newHz = hits[0]?.newHz;
|
|
91
|
+
if (!hits.every((slot) => slot.newHz === newHz)) {
|
|
92
|
+
result.skipped.push({ key, from: oldHz, reason: "ambiguous" });
|
|
93
|
+
continue;
|
|
94
|
+
}
|
|
95
|
+
if (newHz === oldHz)
|
|
96
|
+
continue;
|
|
97
|
+
entries.set(key, String(newHz));
|
|
98
|
+
result.written.push({ key, from: oldHz, to: newHz, follows: hits[0]?.name });
|
|
99
|
+
}
|
|
100
|
+
return result;
|
|
101
|
+
}
|