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
package/lib/data/svd.js
ADDED
|
@@ -0,0 +1,643 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* L1:SVD 寄存器表(device/f1/svd/<line>.json)——按名字找寄存器、按值解释位域。
|
|
3
|
+
*
|
|
4
|
+
* 为什么要这一层:regs_read 以前只认裸地址(0x4001100C),用户手里拿的是手册里的
|
|
5
|
+
* "GPIOC_ODR" / "GPIOC.ODR",读回来的 0x00000004 也没人告诉你那是 ODR2(PC2 输出高)。
|
|
6
|
+
* SVD 里这些都有:外设 baseAddress + 寄存器 addressOffset + 字段 bitOffset/bitWidth。
|
|
7
|
+
*
|
|
8
|
+
* 数据来源只有一个:内置资源 插件内置 assets/ 的 device/f1/svd/<line>.json,装到
|
|
9
|
+
* <DSH_STM32_ASSETS 根或 ~/.dsh-stm32/assets>/<version>/device/f1/svd/ 之后复用。
|
|
10
|
+
* 兼容两种布局:
|
|
11
|
+
* · 装好的缓存:<root>/<version>/device/f1/svd/103.json(install.json 里有 version);
|
|
12
|
+
* · 直接检出/自定义布局:<root>/device/f1/svd/103.json(开发时把 DSH_STM32_ASSETS 指到资源脚本 scripts/assets/)。
|
|
13
|
+
*
|
|
14
|
+
* 关键约定:
|
|
15
|
+
* · SVD 只在 profile=full 里。缺了不是"静默降级",而是结构化失败 + 一句能照着敲的
|
|
16
|
+
* "随插件内置(profile=full 也随包安装)"(见 SVD_FULL_PROFILE_HINT);
|
|
17
|
+
* · 读不到不抛:loadSvd() 返回 { device, failure },loadSvdForLine() 复用前者的便捷版(返回 null);
|
|
18
|
+
* 只有"明确要一个寄存器/一段地址"的 API(resolveRegisterRef / describeAddress)才抛 SvdError,
|
|
19
|
+
* 因为那时候没有数据就已经是错误,而不是"可选增强";
|
|
20
|
+
* · 缓存键是 path+size+mtimeMs:资源升级/重装/手改后自动失效,不需要 reset 钩子。
|
|
21
|
+
* 单测靠 svdCacheStats() + resetSvdCache() 验证"命中不重复读盘";
|
|
22
|
+
* · 严格解析:外设/寄存器/字段有任何一条不合法就整份拒绝(装错文件比没装更危险,
|
|
23
|
+
* 半个位域表会解释出错误的位)。资源脚本(scripts/assets/)的产物是脚本生成的,这份严格性目前一次都没误伤。
|
|
24
|
+
*
|
|
25
|
+
* 只读:本文件不写盘、不联网、不起进程,只读 fs + 内存缓存。
|
|
26
|
+
*/
|
|
27
|
+
import fs from "node:fs";
|
|
28
|
+
import path from "node:path";
|
|
29
|
+
import { assetsRootInfo, errText, listInstalledVersions } from "../engine/assets.js";
|
|
30
|
+
import { findChipFact } from "./device-facts.js";
|
|
31
|
+
/** SVD 在内置资源里的目录(相对版本目录)。 */
|
|
32
|
+
export const SVD_REL_DIR = "device/f1/svd";
|
|
33
|
+
/**
|
|
34
|
+
* 缺 SVD 时反复出现的那句提示。SVD 只在 profile=full 里,所以文案必须带
|
|
35
|
+
* "随插件内置(profile=full 也随包安装)"——用户照着敲就能补齐,不用翻文档。
|
|
36
|
+
*/
|
|
37
|
+
export const SVD_FULL_PROFILE_HINT = "SVD 只在 profile=full 里:重装插件(或确认安装完整)";
|
|
38
|
+
/** 资源脚本 scripts/assets/当前发布的 F1 SVD(只用于报错文案,不做硬校验:上游加 line 不用改这里)。 */
|
|
39
|
+
export const SVD_KNOWN_LINES = ["100", "101", "102", "103", "105", "107"];
|
|
40
|
+
export class SvdError extends Error {
|
|
41
|
+
code;
|
|
42
|
+
line;
|
|
43
|
+
ref;
|
|
44
|
+
hint;
|
|
45
|
+
constructor(code, message, options = {}) {
|
|
46
|
+
super(message);
|
|
47
|
+
this.name = "SvdError";
|
|
48
|
+
this.code = code;
|
|
49
|
+
this.line = options.line ?? "";
|
|
50
|
+
this.ref = options.ref ?? "";
|
|
51
|
+
this.hint = options.hint ?? "";
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
/* ------------------------------ 小工具 ------------------------------ */
|
|
55
|
+
function isRecord(value) {
|
|
56
|
+
return typeof value === "object" && value !== null && !Array.isArray(value);
|
|
57
|
+
}
|
|
58
|
+
function textOf(value) {
|
|
59
|
+
return typeof value === "string" ? value.trim() : "";
|
|
60
|
+
}
|
|
61
|
+
function quote(value) {
|
|
62
|
+
return value === "" ? "(空)" : JSON.stringify(value);
|
|
63
|
+
}
|
|
64
|
+
function isDirectory(dir) {
|
|
65
|
+
try {
|
|
66
|
+
return fs.statSync(dir).isDirectory();
|
|
67
|
+
}
|
|
68
|
+
catch {
|
|
69
|
+
return false;
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
/**
|
|
73
|
+
* SVD 里的数值:内置资源写的是十六进制字符串("0x40011000" / "0x0C"),
|
|
74
|
+
* 也接受数字与纯十进制字符串,别的都算坏数据。
|
|
75
|
+
*/
|
|
76
|
+
export function parseSvdNumber(value) {
|
|
77
|
+
if (typeof value === "number")
|
|
78
|
+
return Number.isFinite(value) && value >= 0 ? Math.trunc(value) : null;
|
|
79
|
+
if (typeof value !== "string")
|
|
80
|
+
return null;
|
|
81
|
+
const trimmed = value.trim();
|
|
82
|
+
if (trimmed === "")
|
|
83
|
+
return null;
|
|
84
|
+
if (/^0[xX][0-9a-fA-F]+$/u.test(trimmed))
|
|
85
|
+
return parseInt(trimmed.slice(2), 16);
|
|
86
|
+
if (/^[0-9]+$/u.test(trimmed))
|
|
87
|
+
return parseInt(trimmed, 10);
|
|
88
|
+
return null;
|
|
89
|
+
}
|
|
90
|
+
/**
|
|
91
|
+
* 用户写的地址:必须带 0x(1–8 位十六进制),或者不带前缀但至少 5 位("4001100C")。
|
|
92
|
+
* 为什么裸写要求 5 位:否则 "ADC1"/"DAC" 这种全是十六进制字符的外设名会被当成地址。
|
|
93
|
+
*/
|
|
94
|
+
export function parseAddressText(text) {
|
|
95
|
+
const trimmed = text.trim();
|
|
96
|
+
const prefixed = /^0[xX]([0-9a-fA-F]{1,8})$/u.exec(trimmed);
|
|
97
|
+
if (prefixed !== null)
|
|
98
|
+
return parseInt(prefixed[1] ?? "", 16) >>> 0;
|
|
99
|
+
const bare = /^([0-9a-fA-F]{5,8})$/u.exec(trimmed);
|
|
100
|
+
if (bare !== null)
|
|
101
|
+
return parseInt(bare[1] ?? "", 16) >>> 0;
|
|
102
|
+
return null;
|
|
103
|
+
}
|
|
104
|
+
/** 0x4001100C(8 位大写,跟 regs_read 的地址风格一致)。 */
|
|
105
|
+
export function formatAddress(value) {
|
|
106
|
+
return "0x" + (value >>> 0).toString(16).toUpperCase().padStart(8, "0");
|
|
107
|
+
}
|
|
108
|
+
/** 0x0C / 0x4(寄存器偏移用最短形式,跟手册一致)。 */
|
|
109
|
+
export function formatOffset(value) {
|
|
110
|
+
return "0x" + value.toString(16).toUpperCase();
|
|
111
|
+
}
|
|
112
|
+
/** 规范写法:外设名.寄存器名。 */
|
|
113
|
+
export function formatRegisterRef(resolved) {
|
|
114
|
+
return resolved.peripheral + "." + resolved.register;
|
|
115
|
+
}
|
|
116
|
+
function maskOf(bitOffset, bitWidth) {
|
|
117
|
+
const width = Math.min(Math.max(bitWidth, 0), 32);
|
|
118
|
+
if (width === 0)
|
|
119
|
+
return 0;
|
|
120
|
+
if (width >= 32)
|
|
121
|
+
return 0xFFFFFFFF;
|
|
122
|
+
const mask = (2 ** width - 1) * 2 ** bitOffset;
|
|
123
|
+
return mask > 0xFFFFFFFF ? 0xFFFFFFFF : mask;
|
|
124
|
+
}
|
|
125
|
+
function sizeMask(size) {
|
|
126
|
+
if (!Number.isFinite(size) || size <= 0 || size >= 32)
|
|
127
|
+
return 0xFFFFFFFF;
|
|
128
|
+
return 2 ** size - 1;
|
|
129
|
+
}
|
|
130
|
+
function registerBytes(size) {
|
|
131
|
+
return Math.max(1, Math.ceil((size > 0 ? size : 32) / 8));
|
|
132
|
+
}
|
|
133
|
+
/** 报错文案里点名候选,但不把 700 个寄存器全倒出来。 */
|
|
134
|
+
function listNames(names, limit = 24) {
|
|
135
|
+
if (names.length === 0)
|
|
136
|
+
return "(无)";
|
|
137
|
+
const head = names.slice(0, limit).join("、");
|
|
138
|
+
return names.length > limit ? head + " …(共 " + String(names.length) + " 个)" : head + "(共 " + String(names.length) + " 个)";
|
|
139
|
+
}
|
|
140
|
+
const svdCache = new Map();
|
|
141
|
+
const svdStats = { reads: 0, hits: 0 };
|
|
142
|
+
/** 缓存诊断:单测用它证明"第二次没再读盘"(reads 不涨、hits 涨)。 */
|
|
143
|
+
export function svdCacheStats() {
|
|
144
|
+
return { reads: svdStats.reads, hits: svdStats.hits, entries: svdCache.size };
|
|
145
|
+
}
|
|
146
|
+
/** 清空 SVD 缓存与计数器(单测用;生产不需要,键自带失效)。 */
|
|
147
|
+
export function resetSvdCache() {
|
|
148
|
+
svdCache.clear();
|
|
149
|
+
svdStats.reads = 0;
|
|
150
|
+
svdStats.hits = 0;
|
|
151
|
+
}
|
|
152
|
+
/**
|
|
153
|
+
* 可能装着 SVD 的目录,按优先级:
|
|
154
|
+
* 1. 已安装的资源版本(新 → 旧,listInstalledVersions 已排好);
|
|
155
|
+
* 2. 未分版本的自定义布局(DSH_STM32_ASSETS 直接指到资源脚本 scripts/assets//自建目录)。
|
|
156
|
+
*/
|
|
157
|
+
function svdLocations(env) {
|
|
158
|
+
const out = [];
|
|
159
|
+
const seen = new Set();
|
|
160
|
+
for (const installed of listInstalledVersions(env)) {
|
|
161
|
+
const resolved = path.resolve(installed.dir);
|
|
162
|
+
if (seen.has(resolved))
|
|
163
|
+
continue;
|
|
164
|
+
seen.add(resolved);
|
|
165
|
+
out.push({ dir: installed.dir, version: installed.version, profiles: installed.profiles, layout: "versioned" });
|
|
166
|
+
}
|
|
167
|
+
const root = assetsRootInfo(env).root;
|
|
168
|
+
const flat = path.resolve(root);
|
|
169
|
+
if (!seen.has(flat) && isDirectory(path.join(root, SVD_REL_DIR))) {
|
|
170
|
+
out.push({ dir: root, version: "", profiles: [], layout: "flat" });
|
|
171
|
+
}
|
|
172
|
+
return out;
|
|
173
|
+
}
|
|
174
|
+
/* ------------------------------ 解析 ------------------------------ */
|
|
175
|
+
function failureOf(code, line, filePath, message) {
|
|
176
|
+
return { code, line, path: filePath, message, hint: SVD_FULL_PROFILE_HINT };
|
|
177
|
+
}
|
|
178
|
+
function fieldFrom(value, where) {
|
|
179
|
+
if (!isRecord(value))
|
|
180
|
+
return { field: null, error: where + " 不是对象" };
|
|
181
|
+
const name = textOf(value["name"]);
|
|
182
|
+
if (name === "")
|
|
183
|
+
return { field: null, error: where + " 缺 name" };
|
|
184
|
+
const bitOffset = parseSvdNumber(value["bitOffset"]);
|
|
185
|
+
if (bitOffset === null || bitOffset > 31)
|
|
186
|
+
return { field: null, error: where + "(" + name + ")的 bitOffset 不合法:" + JSON.stringify(value["bitOffset"]) };
|
|
187
|
+
const bitWidth = parseSvdNumber(value["bitWidth"]);
|
|
188
|
+
if (bitWidth === null || bitWidth < 1 || bitWidth > 32) {
|
|
189
|
+
return { field: null, error: where + "(" + name + ")的 bitWidth 不合法:" + JSON.stringify(value["bitWidth"]) };
|
|
190
|
+
}
|
|
191
|
+
if (bitOffset + bitWidth > 32) {
|
|
192
|
+
return { field: null, error: where + "(" + name + ")越界:bitOffset " + String(bitOffset) + " + bitWidth " + String(bitWidth) + " > 32" };
|
|
193
|
+
}
|
|
194
|
+
return { field: { name, bitOffset, bitWidth, description: textOf(value["description"]) }, error: "" };
|
|
195
|
+
}
|
|
196
|
+
/**
|
|
197
|
+
* 解析一份 SVD 文本。纯函数:测试可以直接喂字符串,不走磁盘。
|
|
198
|
+
* 任何一条外设/寄存器/字段不合法都返回 error(宁缺勿错,见文件头)。
|
|
199
|
+
*/
|
|
200
|
+
export function parseSvd(text, filePath = "", version = "", expectedLine = "") {
|
|
201
|
+
let parsed;
|
|
202
|
+
try {
|
|
203
|
+
parsed = JSON.parse(text);
|
|
204
|
+
}
|
|
205
|
+
catch (error) {
|
|
206
|
+
return { device: null, error: "SVD 不是合法 JSON(" + filePath + "):" + errText(error) };
|
|
207
|
+
}
|
|
208
|
+
if (!isRecord(parsed))
|
|
209
|
+
return { device: null, error: "SVD 顶层不是对象(" + filePath + ")" };
|
|
210
|
+
const line = textOf(parsed["line"]);
|
|
211
|
+
if (line === "")
|
|
212
|
+
return { device: null, error: "SVD 缺 line 字段(" + filePath + ")" };
|
|
213
|
+
if (expectedLine !== "" && line !== expectedLine) {
|
|
214
|
+
return { device: null, error: "SVD 里的 line=" + quote(line) + " 与要读的 line=" + quote(expectedLine) + " 不一致(装错文件比没装更危险)" };
|
|
215
|
+
}
|
|
216
|
+
const rawPeripherals = parsed["peripherals"];
|
|
217
|
+
if (!Array.isArray(rawPeripherals) || rawPeripherals.length === 0) {
|
|
218
|
+
return { device: null, error: "SVD 缺 peripherals 数组或为空(" + filePath + ")" };
|
|
219
|
+
}
|
|
220
|
+
const peripherals = [];
|
|
221
|
+
let registerCount = 0;
|
|
222
|
+
let fieldCount = 0;
|
|
223
|
+
for (let index = 0; index < rawPeripherals.length; index += 1) {
|
|
224
|
+
const rawPeripheral = rawPeripherals[index];
|
|
225
|
+
const where = "peripherals[" + String(index) + "]";
|
|
226
|
+
if (!isRecord(rawPeripheral))
|
|
227
|
+
return { device: null, error: where + " 不是对象" };
|
|
228
|
+
const name = textOf(rawPeripheral["name"]);
|
|
229
|
+
if (name === "")
|
|
230
|
+
return { device: null, error: where + " 缺 name" };
|
|
231
|
+
const baseAddress = parseSvdNumber(rawPeripheral["baseAddress"]);
|
|
232
|
+
if (baseAddress === null)
|
|
233
|
+
return { device: null, error: "外设 " + name + " 的 baseAddress 不合法:" + JSON.stringify(rawPeripheral["baseAddress"]) };
|
|
234
|
+
const rawRegisters = rawPeripheral["registers"];
|
|
235
|
+
if (!Array.isArray(rawRegisters) || rawRegisters.length === 0) {
|
|
236
|
+
return { device: null, error: "外设 " + name + " 缺 registers 数组或为空" };
|
|
237
|
+
}
|
|
238
|
+
const registers = [];
|
|
239
|
+
for (let regIndex = 0; regIndex < rawRegisters.length; regIndex += 1) {
|
|
240
|
+
const rawRegister = rawRegisters[regIndex];
|
|
241
|
+
const regWhere = name + ".registers[" + String(regIndex) + "]";
|
|
242
|
+
if (!isRecord(rawRegister))
|
|
243
|
+
return { device: null, error: regWhere + " 不是对象" };
|
|
244
|
+
const regName = textOf(rawRegister["name"]);
|
|
245
|
+
if (regName === "")
|
|
246
|
+
return { device: null, error: regWhere + " 缺 name" };
|
|
247
|
+
const addressOffset = parseSvdNumber(rawRegister["addressOffset"]);
|
|
248
|
+
if (addressOffset === null) {
|
|
249
|
+
return { device: null, error: name + "." + regName + " 的 addressOffset 不合法:" + JSON.stringify(rawRegister["addressOffset"]) };
|
|
250
|
+
}
|
|
251
|
+
const size = parseSvdNumber(rawRegister["size"]) ?? 32;
|
|
252
|
+
if (size <= 0 || size > 64)
|
|
253
|
+
return { device: null, error: name + "." + regName + " 的 size 不合法:" + JSON.stringify(rawRegister["size"]) };
|
|
254
|
+
const rawFields = rawRegister["fields"];
|
|
255
|
+
if (rawFields !== undefined && !Array.isArray(rawFields)) {
|
|
256
|
+
return { device: null, error: name + "." + regName + " 的 fields 不是数组" };
|
|
257
|
+
}
|
|
258
|
+
const fields = [];
|
|
259
|
+
if (Array.isArray(rawFields)) {
|
|
260
|
+
for (let fieldIndex = 0; fieldIndex < rawFields.length; fieldIndex += 1) {
|
|
261
|
+
const rawField = rawFields[fieldIndex];
|
|
262
|
+
const parsedField = fieldFrom(rawField, name + "." + regName + ".fields[" + String(fieldIndex) + "]");
|
|
263
|
+
if (parsedField.field === null)
|
|
264
|
+
return { device: null, error: parsedField.error };
|
|
265
|
+
fields.push(parsedField.field);
|
|
266
|
+
fieldCount += 1;
|
|
267
|
+
}
|
|
268
|
+
}
|
|
269
|
+
registers.push({ name: regName, addressOffset, size, access: textOf(rawRegister["access"]), fields });
|
|
270
|
+
registerCount += 1;
|
|
271
|
+
}
|
|
272
|
+
peripherals.push({ name, baseAddress, registers });
|
|
273
|
+
}
|
|
274
|
+
const byName = new Map();
|
|
275
|
+
for (const peripheral of peripherals)
|
|
276
|
+
if (!byName.has(peripheral.name))
|
|
277
|
+
byName.set(peripheral.name, peripheral);
|
|
278
|
+
const flat = [];
|
|
279
|
+
for (const peripheral of peripherals) {
|
|
280
|
+
for (const register of peripheral.registers) {
|
|
281
|
+
flat.push({ address: (peripheral.baseAddress + register.addressOffset) >>> 0, peripheral, register });
|
|
282
|
+
}
|
|
283
|
+
}
|
|
284
|
+
flat.sort((left, right) => left.address - right.address);
|
|
285
|
+
const byAddress = new Map();
|
|
286
|
+
for (const entry of flat)
|
|
287
|
+
if (!byAddress.has(entry.address))
|
|
288
|
+
byAddress.set(entry.address, entry);
|
|
289
|
+
const source = (() => {
|
|
290
|
+
const raw = parsed["source"];
|
|
291
|
+
if (typeof raw === "string")
|
|
292
|
+
return raw.trim();
|
|
293
|
+
if (isRecord(raw))
|
|
294
|
+
return textOf(raw["url"]) || textOf(raw["file"]) || textOf(raw["repo"]);
|
|
295
|
+
return "";
|
|
296
|
+
})();
|
|
297
|
+
// 中断表:内置资源新版才带(2026-11-01 起)。老包没有这个字段 → 空表,R20 自动跳过。
|
|
298
|
+
const interrupts = [];
|
|
299
|
+
const rawInterrupts = parsed["interrupts"];
|
|
300
|
+
if (Array.isArray(rawInterrupts)) {
|
|
301
|
+
for (const raw of rawInterrupts) {
|
|
302
|
+
if (!isRecord(raw))
|
|
303
|
+
continue;
|
|
304
|
+
const name = textOf(raw["name"]);
|
|
305
|
+
const value = parseSvdNumber(raw["value"]);
|
|
306
|
+
if (name === "" || value === null)
|
|
307
|
+
continue;
|
|
308
|
+
interrupts.push({ name, value });
|
|
309
|
+
}
|
|
310
|
+
}
|
|
311
|
+
return {
|
|
312
|
+
device: {
|
|
313
|
+
line,
|
|
314
|
+
device: textOf(parsed["device"]),
|
|
315
|
+
family: textOf(parsed["family"]),
|
|
316
|
+
schema: parseSvdNumber(parsed["schema"]) ?? 0,
|
|
317
|
+
version,
|
|
318
|
+
path: filePath,
|
|
319
|
+
source,
|
|
320
|
+
counts: { peripherals: peripherals.length, registers: registerCount, fields: fieldCount },
|
|
321
|
+
peripherals,
|
|
322
|
+
byName,
|
|
323
|
+
peripheralNames: peripherals.map((peripheral) => peripheral.name),
|
|
324
|
+
interrupts,
|
|
325
|
+
interruptNames: new Set(interrupts.map((item) => item.name)),
|
|
326
|
+
flat,
|
|
327
|
+
byAddress,
|
|
328
|
+
},
|
|
329
|
+
error: "",
|
|
330
|
+
};
|
|
331
|
+
}
|
|
332
|
+
/* ------------------------------ 加载 ------------------------------ */
|
|
333
|
+
/**
|
|
334
|
+
* 按 line 读 SVD:成功返回 { device, failure: null },失败返回 { device: null, failure }。
|
|
335
|
+
*
|
|
336
|
+
* 不抛异常(工具卡片照常渲染);需要"没有就报错"的调用方用 requireSvd()。
|
|
337
|
+
* env 默认 process.env:DSH_STM32_ASSETS 可以换根(测试一律指到 test/fixtures,不碰真实 home)。
|
|
338
|
+
*/
|
|
339
|
+
export function loadSvd(line, env = process.env) {
|
|
340
|
+
const wanted = (line ?? "").trim();
|
|
341
|
+
if (!/^[0-9]{3}$/u.test(wanted)) {
|
|
342
|
+
return {
|
|
343
|
+
device: null,
|
|
344
|
+
failure: failureOf("line-invalid", wanted, "", "line 要三位数字(例如 " + SVD_KNOWN_LINES.join(" / ") + "),拿到的是 " + quote(wanted) + ";" + SVD_FULL_PROFILE_HINT + "。"),
|
|
345
|
+
};
|
|
346
|
+
}
|
|
347
|
+
const locations = svdLocations(env);
|
|
348
|
+
if (locations.length === 0) {
|
|
349
|
+
const root = assetsRootInfo(env).root;
|
|
350
|
+
return {
|
|
351
|
+
device: null,
|
|
352
|
+
failure: failureOf("assets-missing", wanted, path.join(root, SVD_REL_DIR, wanted + ".json"), "本地还缺内置资源(" + root + "),读不到 " + SVD_REL_DIR + "/" + wanted + ".json;" + SVD_FULL_PROFILE_HINT + "。"),
|
|
353
|
+
};
|
|
354
|
+
}
|
|
355
|
+
const tried = [];
|
|
356
|
+
for (const location of locations) {
|
|
357
|
+
const filePath = path.join(location.dir, SVD_REL_DIR, wanted + ".json");
|
|
358
|
+
let stat;
|
|
359
|
+
try {
|
|
360
|
+
stat = fs.statSync(filePath);
|
|
361
|
+
}
|
|
362
|
+
catch {
|
|
363
|
+
tried.push(filePath);
|
|
364
|
+
continue;
|
|
365
|
+
}
|
|
366
|
+
if (!stat.isFile()) {
|
|
367
|
+
tried.push(filePath);
|
|
368
|
+
continue;
|
|
369
|
+
}
|
|
370
|
+
const key = filePath + ":" + String(stat.size) + ":" + String(stat.mtimeMs);
|
|
371
|
+
const cached = svdCache.get(filePath);
|
|
372
|
+
if (cached !== undefined && cached.key === key) {
|
|
373
|
+
svdStats.hits += 1;
|
|
374
|
+
return { device: cached.device, failure: null };
|
|
375
|
+
}
|
|
376
|
+
let text;
|
|
377
|
+
try {
|
|
378
|
+
text = fs.readFileSync(filePath, "utf8");
|
|
379
|
+
svdStats.reads += 1;
|
|
380
|
+
}
|
|
381
|
+
catch (error) {
|
|
382
|
+
return {
|
|
383
|
+
device: null,
|
|
384
|
+
failure: failureOf("svd-invalid", wanted, filePath, "SVD 读不了(" + filePath + "):" + errText(error) + ";" + SVD_FULL_PROFILE_HINT + "。"),
|
|
385
|
+
};
|
|
386
|
+
}
|
|
387
|
+
const parsed = parseSvd(text, filePath, location.version, wanted);
|
|
388
|
+
if (parsed.device === null) {
|
|
389
|
+
return {
|
|
390
|
+
device: null,
|
|
391
|
+
failure: failureOf("svd-invalid", wanted, filePath, "SVD 解析失败(" + filePath + "):" + parsed.error + ";" + SVD_FULL_PROFILE_HINT + "。"),
|
|
392
|
+
};
|
|
393
|
+
}
|
|
394
|
+
svdCache.set(filePath, { key, device: parsed.device });
|
|
395
|
+
return { device: parsed.device, failure: null };
|
|
396
|
+
}
|
|
397
|
+
const versioned = locations.filter((location) => location.layout === "versioned");
|
|
398
|
+
const onlyCore = versioned.length > 0 && versioned.every((location) => location.profiles.length > 0 && !location.profiles.includes("full"));
|
|
399
|
+
const where = versioned.length === 0 ? "(" + assetsRootInfo(env).root + ")" : "(版本 " + versioned.map((location) => location.version).join("、") + ")";
|
|
400
|
+
const message = "本地资源" + where + "里没有 " + SVD_REL_DIR + "/" + wanted + ".json" +
|
|
401
|
+
(onlyCore ? ":已装的版本只装了 profile=core" : "") +
|
|
402
|
+
";" + SVD_FULL_PROFILE_HINT + "。";
|
|
403
|
+
return { device: null, failure: failureOf("svd-missing", wanted, tried[0] ?? "", message) };
|
|
404
|
+
}
|
|
405
|
+
/** 便捷版:拿不到就 null(要原因用 loadSvd)。 */
|
|
406
|
+
export function loadSvdForLine(line, env = process.env) {
|
|
407
|
+
return loadSvd(line, env).device;
|
|
408
|
+
}
|
|
409
|
+
/** 必须有 SVD:拿不到抛 SvdError(message 一定带 full profile 提示)。 */
|
|
410
|
+
export function requireSvd(line, env = process.env) {
|
|
411
|
+
const loaded = loadSvd(line, env);
|
|
412
|
+
if (loaded.device !== null)
|
|
413
|
+
return loaded.device;
|
|
414
|
+
const failure = loaded.failure;
|
|
415
|
+
const code = failure === null ? "svd-missing" : failure.code;
|
|
416
|
+
throw new SvdError(code, failure === null ? "读不到 SVD(line=" + line + ");" + SVD_FULL_PROFILE_HINT + "。" : failure.message, {
|
|
417
|
+
line: failure === null ? line : failure.line,
|
|
418
|
+
hint: SVD_FULL_PROFILE_HINT,
|
|
419
|
+
});
|
|
420
|
+
}
|
|
421
|
+
/** 型号 → SVD line(用内置资源 device facts 的 line 字段);没有这颗芯片/没有内置资源返回 null。 */
|
|
422
|
+
export function svdLineForChip(cpn, env = process.env) {
|
|
423
|
+
const chip = findChipFact(cpn, env);
|
|
424
|
+
return chip === null ? null : chip.line;
|
|
425
|
+
}
|
|
426
|
+
/* ------------------------------ 查找 ------------------------------ */
|
|
427
|
+
function findPeripheral(device, name) {
|
|
428
|
+
const exact = device.byName.get(name);
|
|
429
|
+
if (exact !== undefined)
|
|
430
|
+
return exact;
|
|
431
|
+
const wanted = name.trim().toUpperCase();
|
|
432
|
+
if (wanted === "")
|
|
433
|
+
return null;
|
|
434
|
+
for (const peripheral of device.peripherals) {
|
|
435
|
+
if (peripheral.name.toUpperCase() === wanted)
|
|
436
|
+
return peripheral;
|
|
437
|
+
}
|
|
438
|
+
return null;
|
|
439
|
+
}
|
|
440
|
+
function findRegister(peripheral, name) {
|
|
441
|
+
const exact = peripheral.registers.find((register) => register.name === name);
|
|
442
|
+
if (exact !== undefined)
|
|
443
|
+
return exact;
|
|
444
|
+
const wanted = name.trim().toUpperCase();
|
|
445
|
+
if (wanted === "")
|
|
446
|
+
return null;
|
|
447
|
+
return peripheral.registers.find((register) => register.name.toUpperCase() === wanted) ?? null;
|
|
448
|
+
}
|
|
449
|
+
function resolvedOf(entry) {
|
|
450
|
+
return {
|
|
451
|
+
ref: entry.peripheral.name + "." + entry.register.name,
|
|
452
|
+
address: entry.address,
|
|
453
|
+
addressHex: formatAddress(entry.address),
|
|
454
|
+
peripheral: entry.peripheral.name,
|
|
455
|
+
baseAddress: entry.peripheral.baseAddress,
|
|
456
|
+
register: entry.register.name,
|
|
457
|
+
addressOffset: entry.register.addressOffset,
|
|
458
|
+
offsetHex: formatOffset(entry.register.addressOffset),
|
|
459
|
+
size: entry.register.size,
|
|
460
|
+
fields: entry.register.fields,
|
|
461
|
+
};
|
|
462
|
+
}
|
|
463
|
+
/** 地址 → 命中的寄存器条目(先精确命中 byAddress,再找"落在寄存器内部"的那一条)。 */
|
|
464
|
+
function locateAddress(device, address) {
|
|
465
|
+
const exact = device.byAddress.get(address);
|
|
466
|
+
if (exact !== undefined)
|
|
467
|
+
return exact;
|
|
468
|
+
// flat 已按地址升序:找到最后一条起点 <= address 的,看它是否覆盖该地址。
|
|
469
|
+
let low = 0;
|
|
470
|
+
let high = device.flat.length - 1;
|
|
471
|
+
let candidate = null;
|
|
472
|
+
while (low <= high) {
|
|
473
|
+
const middle = (low + high) >> 1;
|
|
474
|
+
const entry = device.flat[middle];
|
|
475
|
+
if (entry === undefined)
|
|
476
|
+
break;
|
|
477
|
+
if (entry.address <= address) {
|
|
478
|
+
candidate = entry;
|
|
479
|
+
low = middle + 1;
|
|
480
|
+
}
|
|
481
|
+
else {
|
|
482
|
+
high = middle - 1;
|
|
483
|
+
}
|
|
484
|
+
}
|
|
485
|
+
if (candidate === null)
|
|
486
|
+
return null;
|
|
487
|
+
const span = registerBytes(candidate.register.size);
|
|
488
|
+
return address < candidate.address + span ? candidate : null;
|
|
489
|
+
}
|
|
490
|
+
/**
|
|
491
|
+
* 把四种写法解析成寄存器:
|
|
492
|
+
* GPIOC.ODR / GPIOC->ODR / RCC.CR(大小写与空白都容错)/ 0x4001100C(或裸 4001100C)。
|
|
493
|
+
* 失败抛 SvdError:code 区分"没装 SVD"与"外设/寄存器/地址不认识"。
|
|
494
|
+
*/
|
|
495
|
+
export function resolveRegisterRef(ref, line, env = process.env) {
|
|
496
|
+
const device = requireSvd(line, env);
|
|
497
|
+
const text = (ref ?? "").trim();
|
|
498
|
+
if (text === "") {
|
|
499
|
+
throw new SvdError("ref-invalid", "寄存器写法是空的:要 GPIOC.ODR / GPIOC->ODR / 0x4001100C 之一。", { line: device.line });
|
|
500
|
+
}
|
|
501
|
+
const address = parseAddressText(text);
|
|
502
|
+
if (address !== null) {
|
|
503
|
+
const entry = device.byAddress.get(address);
|
|
504
|
+
if (entry !== undefined)
|
|
505
|
+
return resolvedOf(entry);
|
|
506
|
+
const inside = locateAddress(device, address);
|
|
507
|
+
if (inside !== null) {
|
|
508
|
+
throw new SvdError("register-unknown", formatAddress(address) + " 不是寄存器起点:它落在 " + inside.peripheral.name + "." + inside.register.name +
|
|
509
|
+
"(起点 " + formatAddress(inside.address) + ",位宽 " + String(inside.register.size) + " 位)内部。", { line: device.line, ref: text });
|
|
510
|
+
}
|
|
511
|
+
throw new SvdError("address-unknown", "line=" + device.line + " 的 SVD 里没有寄存器覆盖地址 " + formatAddress(address) + "(按裸地址读仍然可以,只是没有名字/位域)。", { line: device.line, ref: text });
|
|
512
|
+
}
|
|
513
|
+
const match = /^([A-Za-z_][A-Za-z0-9_]*)\s*(?:\.|->)\s*([A-Za-z_][A-Za-z0-9_]*)$/u.exec(text);
|
|
514
|
+
if (match === null) {
|
|
515
|
+
throw new SvdError("ref-invalid", "不认识的寄存器写法:" + quote(text) + ";支持 GPIOC.ODR、GPIOC->ODR、RCC.CR、0x4001100C 四种。", { line: device.line, ref: text });
|
|
516
|
+
}
|
|
517
|
+
const peripheralName = match[1] ?? "";
|
|
518
|
+
const registerName = match[2] ?? "";
|
|
519
|
+
const peripheral = findPeripheral(device, peripheralName);
|
|
520
|
+
if (peripheral === null) {
|
|
521
|
+
throw new SvdError("peripheral-unknown", "内置资源(line=" + device.line + ")里没有外设 " + peripheralName.toUpperCase() + ";已知外设:" + listNames(device.peripheralNames) + "。", { line: device.line, ref: text });
|
|
522
|
+
}
|
|
523
|
+
const register = findRegister(peripheral, registerName);
|
|
524
|
+
if (register === null) {
|
|
525
|
+
throw new SvdError("register-unknown", "外设 " + peripheral.name + " 里没有寄存器 " + registerName.toUpperCase() + ";已知寄存器:" +
|
|
526
|
+
listNames(peripheral.registers.map((item) => item.name)) + "。", { line: device.line, ref: text });
|
|
527
|
+
}
|
|
528
|
+
return {
|
|
529
|
+
ref: peripheral.name + "." + register.name,
|
|
530
|
+
address: (peripheral.baseAddress + register.addressOffset) >>> 0,
|
|
531
|
+
addressHex: formatAddress((peripheral.baseAddress + register.addressOffset) >>> 0),
|
|
532
|
+
peripheral: peripheral.name,
|
|
533
|
+
baseAddress: peripheral.baseAddress,
|
|
534
|
+
register: register.name,
|
|
535
|
+
addressOffset: register.addressOffset,
|
|
536
|
+
offsetHex: formatOffset(register.addressOffset),
|
|
537
|
+
size: register.size,
|
|
538
|
+
fields: register.fields,
|
|
539
|
+
};
|
|
540
|
+
}
|
|
541
|
+
/**
|
|
542
|
+
* 按地址反查名字:命中寄存器返回描述(含 exact 标志),没命中返回 null。
|
|
543
|
+
*
|
|
544
|
+
* 为什么不抛:地址没被 SVD 覆盖是"正常答案"(外设私有地址、保留区都可能有),
|
|
545
|
+
* 工具层拿去当 note 就行;SVD 本身缺失才抛 SvdError(那是配置问题,必须提示 full profile)。
|
|
546
|
+
*/
|
|
547
|
+
export function describeAddress(address, line, env = process.env) {
|
|
548
|
+
const device = requireSvd(line, env);
|
|
549
|
+
const numeric = typeof address === "number" ? (Number.isFinite(address) ? address >>> 0 : null) : parseAddressText(address);
|
|
550
|
+
if (numeric === null) {
|
|
551
|
+
throw new SvdError("ref-invalid", "地址不合法:" + quote(typeof address === "number" ? String(address) : address) + "(要 0x 开头的 1–8 位十六进制,或 5–8 位裸十六进制)。", { line: device.line });
|
|
552
|
+
}
|
|
553
|
+
const entry = locateAddress(device, numeric);
|
|
554
|
+
if (entry === null)
|
|
555
|
+
return null;
|
|
556
|
+
return {
|
|
557
|
+
address: numeric,
|
|
558
|
+
addressHex: formatAddress(numeric),
|
|
559
|
+
ref: entry.peripheral.name + "." + entry.register.name,
|
|
560
|
+
peripheral: entry.peripheral.name,
|
|
561
|
+
baseAddress: entry.peripheral.baseAddress,
|
|
562
|
+
register: entry.register.name,
|
|
563
|
+
addressOffset: entry.register.addressOffset,
|
|
564
|
+
size: entry.register.size,
|
|
565
|
+
fields: entry.register.fields,
|
|
566
|
+
exact: numeric === entry.address,
|
|
567
|
+
offsetInRegister: numeric - entry.address,
|
|
568
|
+
};
|
|
569
|
+
}
|
|
570
|
+
/* ------------------------------ 位域解释 ------------------------------ */
|
|
571
|
+
function registerNameOf(register) {
|
|
572
|
+
return "register" in register ? register.register : register.name;
|
|
573
|
+
}
|
|
574
|
+
function parseValueInput(value) {
|
|
575
|
+
if (typeof value === "number")
|
|
576
|
+
return Number.isFinite(value) && value >= 0 ? Math.trunc(value) >>> 0 : null;
|
|
577
|
+
const text = (value ?? "").trim();
|
|
578
|
+
if (text === "")
|
|
579
|
+
return null;
|
|
580
|
+
if (/^0[xX][0-9a-fA-F]+$/u.test(text))
|
|
581
|
+
return parseInt(text.slice(2), 16) >>> 0;
|
|
582
|
+
if (/^[0-9]+$/u.test(text))
|
|
583
|
+
return parseInt(text, 10) >>> 0;
|
|
584
|
+
return null;
|
|
585
|
+
}
|
|
586
|
+
/**
|
|
587
|
+
* 把一个读回来的值按位域拆开:返回全部字段 + 置位字段(set)+ 没被任何位域解释的位。
|
|
588
|
+
* 接受 "0x00000004" 这种字符串(regs_read 的样本就是这种格式)。
|
|
589
|
+
*/
|
|
590
|
+
export function decodeRegisterValue(register, value) {
|
|
591
|
+
const numeric = parseValueInput(value);
|
|
592
|
+
if (numeric === null) {
|
|
593
|
+
throw new SvdError("value-invalid", "寄存器值不合法:" + quote(typeof value === "number" ? String(value) : value) + "(要 0x 十六进制或十进制非负整数)。", {
|
|
594
|
+
ref: "name" in register ? register.name : register.register,
|
|
595
|
+
});
|
|
596
|
+
}
|
|
597
|
+
const size = register.size > 0 && register.size <= 32 ? register.size : 32;
|
|
598
|
+
const masked = numeric & sizeMask(size);
|
|
599
|
+
const width = size >= 32 ? 32 : size;
|
|
600
|
+
const decoded = [];
|
|
601
|
+
let covered = 0;
|
|
602
|
+
for (const field of register.fields) {
|
|
603
|
+
const mask = maskOf(field.bitOffset, field.bitWidth) & sizeMask(width);
|
|
604
|
+
covered = (covered | mask) >>> 0;
|
|
605
|
+
const raw = (masked & mask) >>> 0;
|
|
606
|
+
const fieldValue = field.bitOffset >= 32 ? 0 : raw >>> field.bitOffset;
|
|
607
|
+
decoded.push({
|
|
608
|
+
name: field.name,
|
|
609
|
+
bitOffset: field.bitOffset,
|
|
610
|
+
bitWidth: field.bitWidth,
|
|
611
|
+
mask,
|
|
612
|
+
raw,
|
|
613
|
+
value: fieldValue,
|
|
614
|
+
description: field.description,
|
|
615
|
+
});
|
|
616
|
+
}
|
|
617
|
+
const uncovered = (masked & ~covered) >>> 0;
|
|
618
|
+
const uncoveredBits = [];
|
|
619
|
+
for (let bit = 0; bit < width; bit += 1) {
|
|
620
|
+
if ((uncovered & (1 << bit)) !== 0)
|
|
621
|
+
uncoveredBits.push(bit);
|
|
622
|
+
}
|
|
623
|
+
return {
|
|
624
|
+
register: registerNameOf(register),
|
|
625
|
+
value: masked,
|
|
626
|
+
valueHex: formatAddress(masked),
|
|
627
|
+
size,
|
|
628
|
+
fields: decoded,
|
|
629
|
+
set: decoded.filter((field) => field.value !== 0),
|
|
630
|
+
clear: decoded.filter((field) => field.value === 0),
|
|
631
|
+
uncovered,
|
|
632
|
+
uncoveredBits,
|
|
633
|
+
};
|
|
634
|
+
}
|
|
635
|
+
/** 一行人话:ODR0=1、ODR2=1、ODR15=1(+ 未解释的工作位)。 */
|
|
636
|
+
export function formatDecodedFields(decoded) {
|
|
637
|
+
const parts = decoded.set.map((field) => field.name + "=" + String(field.value));
|
|
638
|
+
const base = parts.length === 0 ? "没有置位的位域" : parts.join("、");
|
|
639
|
+
const tail = decoded.uncovered === 0
|
|
640
|
+
? ""
|
|
641
|
+
: "(另有 " + formatAddress(decoded.uncovered) + " 不属于任何位域:第 " + decoded.uncoveredBits.map((bit) => String(bit)).join("、") + " 位)";
|
|
642
|
+
return base + tail;
|
|
643
|
+
}
|
|
@@ -294,17 +294,3 @@ export function cubeMxRootsFromConfig(config) {
|
|
|
294
294
|
export function resetToolchainConfigCache() {
|
|
295
295
|
cache = null;
|
|
296
296
|
}
|
|
297
|
-
/** 给报告 / 命令卡片用的一句话描述。 */
|
|
298
|
-
export function describeToolchainConfig(read) {
|
|
299
|
-
if (!read.exists)
|
|
300
|
-
return "还没有配置(没有 " + read.path + ")";
|
|
301
|
-
if (read.config === null)
|
|
302
|
-
return "配置读不了:" + (read.errors[0] ?? "未知原因");
|
|
303
|
-
const parts = [];
|
|
304
|
-
parts.push(read.config.msys64 === "" ? "MSYS2 未配置" : "MSYS2 " + read.config.msys64);
|
|
305
|
-
if (read.config.packages.length > 0)
|
|
306
|
-
parts.push("包 " + String(read.config.packages.length) + " 个");
|
|
307
|
-
if (read.config.cubeMxRoot !== "")
|
|
308
|
-
parts.push("CubeMX " + read.config.cubeMxRoot);
|
|
309
|
-
return parts.join(";") + "(" + read.path + ")";
|
|
310
|
-
}
|