dsh-stm32 0.1.2 → 0.1.3
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 +59 -21
- package/README_EN.md +59 -21
- package/docs/development-notes.md +374 -3
- package/docs/reading-guide.md +87 -66
- package/lib/data/chips.js +38 -51
- package/lib/data/cmsis-sources.js +27 -1
- package/lib/data/device-facts.js +201 -0
- package/lib/data/stm32f1.js +94 -150
- package/lib/data/svd.js +627 -0
- package/lib/engine/assets.js +924 -0
- package/lib/engine/breakpoints.js +242 -0
- package/lib/engine/debug-session.js +153 -5
- package/lib/engine/debug.js +75 -41
- package/lib/engine/doctor.js +2 -2
- package/lib/engine/flash.js +31 -59
- package/lib/engine/ioc-plan.js +5 -5
- package/lib/engine/probe-error.js +212 -0
- package/lib/engine/probe-session.js +311 -0
- package/lib/engine/register-template.js +32 -8
- package/lib/engine/regs.js +2 -0
- package/lib/engine/rtt.js +600 -0
- package/lib/index.js +8 -0
- package/lib/tools/assets.js +341 -0
- package/lib/tools/cache.js +8 -0
- package/lib/tools/debug-session.js +40 -5
- package/lib/tools/debug.js +41 -11
- package/lib/tools/doctor.js +11 -0
- package/lib/tools/flash.js +15 -6
- package/lib/tools/generate.js +3 -0
- package/lib/tools/ioc-apply.js +2 -0
- package/lib/tools/ioc-inspect.js +2 -0
- package/lib/tools/ioc-plan.js +3 -0
- package/lib/tools/project-create.js +24 -0
- package/lib/tools/regs.js +453 -61
- package/lib/tools/route-plan.js +3 -0
- package/lib/tools/rtt.js +347 -0
- package/package.json +1 -1
- package/templates/register/CMakeLists.txt +7 -1
- package/templates/register/Core/Inc/rtt.h +103 -0
- package/templates/register/Core/Src/main.c +25 -0
- package/templates/register/Core/Src/rtt.c +297 -0
- package/templates/scaffold/RTT.md +86 -0
- package/templates/scaffold/cmake/user/CMakeLists.txt +7 -0
- package/lib/data/f1-ram.generated.js +0 -34
|
@@ -12,6 +12,7 @@
|
|
|
12
12
|
* 1) 把 F1Chip 翻译成下载清单(路径 + markers + 实测 sha256);
|
|
13
13
|
* 2) 把用户给的各种写法(型号 / F1:B / F1:103xb / 0.1 的老缓存 id)解析成同一个缓存条目。
|
|
14
14
|
*/
|
|
15
|
+
import { loadDeviceFacts } from "./device-facts.js";
|
|
15
16
|
import { resolveF1Chip } from "./stm32f1.js";
|
|
16
17
|
const JS_DELIVR_FASTLY = (repo, ref, file) => "https://fastly.jsdelivr.net/gh/STMicroelectronics/" + repo + "@" + ref + "/" + file;
|
|
17
18
|
const JS_DELIVR_CDN = (repo, ref, file) => "https://cdn.jsdelivr.net/gh/STMicroelectronics/" + repo + "@" + ref + "/" + file;
|
|
@@ -71,6 +72,31 @@ function choiceFromChip(chip) {
|
|
|
71
72
|
chip,
|
|
72
73
|
};
|
|
73
74
|
}
|
|
75
|
+
/**
|
|
76
|
+
* 只给容量字母(F1:B / F1:8)时,从设备事实里挑一颗同档芯片当代表:
|
|
77
|
+
* 优先 F103(档位最全,0.1 的 "F1:B" 正是按 F103 解释的),再按 line / CPN 升序。
|
|
78
|
+
*
|
|
79
|
+
* 以前这里靠手写的「容量字母 → 档位」常量表(随 chip-table.json 2026-10-31 一起删了)。
|
|
80
|
+
* 现在这条事实也只从资源包缓存读:没有缓存就返回 null,上层会明说先 refresh,
|
|
81
|
+
* 不会编一个可能不存在的启动文件名。
|
|
82
|
+
*/
|
|
83
|
+
function chipForDensityLetter(letter) {
|
|
84
|
+
const wanted = letter.trim().toUpperCase();
|
|
85
|
+
const facts = loadDeviceFacts();
|
|
86
|
+
if (!facts.ok)
|
|
87
|
+
return null;
|
|
88
|
+
const candidates = facts.chips.filter((chip) => /^STM32F\d{3}[A-Z]([0-9A-G])/u.exec(chip.cpn)?.[1] === wanted);
|
|
89
|
+
if (candidates.length === 0)
|
|
90
|
+
return null;
|
|
91
|
+
const ordered = [...candidates].sort((a, b) => {
|
|
92
|
+
const byLine = Number(a.line) - Number(b.line);
|
|
93
|
+
if (byLine !== 0)
|
|
94
|
+
return byLine;
|
|
95
|
+
return a.cpn < b.cpn ? -1 : a.cpn > b.cpn ? 1 : 0;
|
|
96
|
+
});
|
|
97
|
+
const preferred = ordered.find((chip) => chip.line === "103") ?? ordered[0];
|
|
98
|
+
return preferred === undefined ? null : resolveF1Chip(preferred.cpn).chip;
|
|
99
|
+
}
|
|
74
100
|
/**
|
|
75
101
|
* 只给容量档(F1:B / F1:8 / F1:xb)时,用 F103 当代表:F103 的档位最全
|
|
76
102
|
* (x6/xb/xe/xg),0.1 的 "F1:B" 也正是按 F103 解释的,行为不变。
|
|
@@ -82,7 +108,7 @@ function chipForKey(key) {
|
|
|
82
108
|
if (/^x[0-9a-z]{1,2}$/u.test(text))
|
|
83
109
|
return resolveF1Chip("F103:" + text.toUpperCase()).chip;
|
|
84
110
|
if (/^[0-9a-z]$/u.test(text))
|
|
85
|
-
return
|
|
111
|
+
return chipForDensityLetter(text);
|
|
86
112
|
return null;
|
|
87
113
|
}
|
|
88
114
|
/**
|
|
@@ -0,0 +1,201 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* L1:设备事实(device facts)——唯一来源是本地资源包缓存里的 device/f1/chips.json。
|
|
3
|
+
*
|
|
4
|
+
* 用户 2026-10-31 的决定(原话「内置表删了吧」):插件不再自带任何芯片事实表。型号 → 容量档 /
|
|
5
|
+
* 启动文件 / 设备宏 / 设备头 / Flash / RAM / 引脚数,全部取自资源仓库 dsh-stm32-assets 的
|
|
6
|
+
* device/f1/chips.json,装到 <DSH_STM32_ASSETS 根或 ~/.dsh-stm32/assets>/<version>/device/f1/chips.json。
|
|
7
|
+
*
|
|
8
|
+
* 第一次用没有缓存怎么办:工具层调 ensureAssets()(src/engine/assets.ts)自动 refresh 一次;
|
|
9
|
+
* 没网、没装就只能明说「先跑 stm32_assets refresh,或检查网络」,绝不退回内置表(已经没有内置表了)。
|
|
10
|
+
*
|
|
11
|
+
* 为什么要内存缓存:resolveF1Chip 在一个工程里会被调几十次(校验 .ioc、渲染启动文件名、选时钟),
|
|
12
|
+
* 每次都读一遍 JSON 太浪费。缓存键带 path + size + mtimeMs:资源包升级/重装/手改后自动失效,
|
|
13
|
+
* 不需要任何 reset 钩子(也没有全局状态需要维护)。
|
|
14
|
+
*
|
|
15
|
+
* 只读:本文件不写盘、不联网、不起进程。
|
|
16
|
+
*/
|
|
17
|
+
import fs from "node:fs";
|
|
18
|
+
import path from "node:path";
|
|
19
|
+
import { ASSETS_DEVICE_FACTS_FILE, ASSETS_REFRESH_HINT, errText, readLocalManifest } from "../engine/assets.js";
|
|
20
|
+
/** chips.json 在资源包里的相对路径(manifest 的 profiles.core 也按 device/** 收录它)。 */
|
|
21
|
+
export const DEVICE_FACTS_REL = ASSETS_DEVICE_FACTS_FILE;
|
|
22
|
+
/** 没缓存/没这颗芯片时,给用户的那句可执行提示(所有结构化错误都带上它)。 */
|
|
23
|
+
export const DEVICE_FACTS_HINT = ASSETS_REFRESH_HINT;
|
|
24
|
+
let cache = null;
|
|
25
|
+
function isRecord(value) {
|
|
26
|
+
return typeof value === "object" && value !== null && !Array.isArray(value);
|
|
27
|
+
}
|
|
28
|
+
function textOf(value) {
|
|
29
|
+
return typeof value === "string" ? value.trim() : "";
|
|
30
|
+
}
|
|
31
|
+
function countOf(value) {
|
|
32
|
+
return typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : null;
|
|
33
|
+
}
|
|
34
|
+
/**
|
|
35
|
+
* 一条 chips.json 记录 → DeviceFactsChip。
|
|
36
|
+
* 关键字段(cpn / line / group / 启动文件 / 设备宏 / 设备头 / Flash / RAM / 引脚数)缺一个就丢掉:
|
|
37
|
+
* 半条事实比没有事实更危险——它会算出错误的链接脚本内存布局。
|
|
38
|
+
*/
|
|
39
|
+
function chipFrom(value) {
|
|
40
|
+
if (!isRecord(value))
|
|
41
|
+
return null;
|
|
42
|
+
const cpn = textOf(value["cpn"]).toUpperCase();
|
|
43
|
+
const line = textOf(value["line"]);
|
|
44
|
+
const group = textOf(value["group"]).toLowerCase();
|
|
45
|
+
const startup = textOf(value["startup"]);
|
|
46
|
+
const deviceDefine = textOf(value["deviceDefine"]);
|
|
47
|
+
const deviceHeader = textOf(value["deviceHeader"]);
|
|
48
|
+
const pinCount = countOf(value["pinCount"]);
|
|
49
|
+
const flashBytes = countOf(value["flashBytes"]);
|
|
50
|
+
const ramBytes = countOf(value["ramBytes"]);
|
|
51
|
+
// B4:断点预算(可选字段,chips.json 没写就是没有,调用方回退 F1 默认)。
|
|
52
|
+
const breakpoints = countOf(value["breakpoints"]);
|
|
53
|
+
const watchpoints = countOf(value["watchpoints"]);
|
|
54
|
+
if (cpn === "" || line === "" || group === "" || startup === "" || deviceDefine === "" || deviceHeader === "")
|
|
55
|
+
return null;
|
|
56
|
+
if (pinCount === null || flashBytes === null || ramBytes === null)
|
|
57
|
+
return null;
|
|
58
|
+
return {
|
|
59
|
+
cpn,
|
|
60
|
+
line,
|
|
61
|
+
group,
|
|
62
|
+
packageName: textOf(value["packageName"]),
|
|
63
|
+
pinCount,
|
|
64
|
+
flashBytes,
|
|
65
|
+
ramBytes,
|
|
66
|
+
deviceId: textOf(value["deviceId"]),
|
|
67
|
+
mcuName: textOf(value["mcuName"]),
|
|
68
|
+
startup,
|
|
69
|
+
deviceDefine,
|
|
70
|
+
deviceHeader,
|
|
71
|
+
linkerScript: textOf(value["linkerScript"]),
|
|
72
|
+
...(breakpoints === null || breakpoints <= 0 ? {} : { breakpoints: Math.trunc(breakpoints) }),
|
|
73
|
+
...(watchpoints === null || watchpoints <= 0 ? {} : { watchpoints: Math.trunc(watchpoints) }),
|
|
74
|
+
};
|
|
75
|
+
}
|
|
76
|
+
function emptyFacts(filePath, version, error) {
|
|
77
|
+
return {
|
|
78
|
+
ok: false,
|
|
79
|
+
path: filePath,
|
|
80
|
+
version,
|
|
81
|
+
chips: [],
|
|
82
|
+
byCpn: new Map(),
|
|
83
|
+
byLineGroup: new Map(),
|
|
84
|
+
lines: [],
|
|
85
|
+
groupsByLine: new Map(),
|
|
86
|
+
error,
|
|
87
|
+
};
|
|
88
|
+
}
|
|
89
|
+
/** 解析 chips.json 文本 → DeviceFacts(纯函数,测试可直接喂字符串)。 */
|
|
90
|
+
export function parseDeviceFacts(text, filePath, version = "") {
|
|
91
|
+
let parsed;
|
|
92
|
+
try {
|
|
93
|
+
parsed = JSON.parse(text);
|
|
94
|
+
}
|
|
95
|
+
catch (error) {
|
|
96
|
+
return emptyFacts(filePath, version, "本地设备事实不是合法 JSON(" + filePath + "):" + errText(error) + ";" + DEVICE_FACTS_HINT + "。");
|
|
97
|
+
}
|
|
98
|
+
const list = isRecord(parsed) && Array.isArray(parsed["chips"]) ? parsed["chips"] : [];
|
|
99
|
+
const chips = [];
|
|
100
|
+
const byCpn = new Map();
|
|
101
|
+
const byLineGroup = new Map();
|
|
102
|
+
const groupsByLine = new Map();
|
|
103
|
+
for (const item of list) {
|
|
104
|
+
const chip = chipFrom(item);
|
|
105
|
+
if (chip === null)
|
|
106
|
+
continue;
|
|
107
|
+
chips.push(chip);
|
|
108
|
+
if (!byCpn.has(chip.cpn))
|
|
109
|
+
byCpn.set(chip.cpn, chip);
|
|
110
|
+
const lineGroup = chip.line + ":" + chip.group;
|
|
111
|
+
// 同一个 line+档 有多颗芯片(F103C8T6 / F103RBT6 / ...),只留一颗当代表:
|
|
112
|
+
// cpn 最小的那颗,保证「同一份事实同一个结果」,不随文件顺序变。
|
|
113
|
+
const existing = byLineGroup.get(lineGroup);
|
|
114
|
+
if (existing === undefined || chip.cpn < existing.cpn)
|
|
115
|
+
byLineGroup.set(lineGroup, chip);
|
|
116
|
+
const groups = groupsByLine.get(chip.line) ?? new Set();
|
|
117
|
+
groups.add(chip.group);
|
|
118
|
+
groupsByLine.set(chip.line, groups);
|
|
119
|
+
}
|
|
120
|
+
const lines = [...groupsByLine.keys()].sort((left, right) => left.localeCompare(right));
|
|
121
|
+
const sortedGroups = new Map();
|
|
122
|
+
for (const [line, groups] of groupsByLine) {
|
|
123
|
+
sortedGroups.set(line, [...groups].sort((left, right) => left.localeCompare(right)));
|
|
124
|
+
}
|
|
125
|
+
if (chips.length === 0) {
|
|
126
|
+
return emptyFacts(filePath, version, "本地设备事实里一条可用的芯片都没有(" + filePath + "):文件可能是空的或字段不全;" + DEVICE_FACTS_HINT + "。");
|
|
127
|
+
}
|
|
128
|
+
return { ok: true, path: filePath, version, chips, byCpn, byLineGroup, lines, groupsByLine: sortedGroups, error: "" };
|
|
129
|
+
}
|
|
130
|
+
/**
|
|
131
|
+
* 读设备事实(内存缓存一次,按 path+size+mtimeMs 自动失效)。
|
|
132
|
+
*
|
|
133
|
+
* env 默认 process.env:DSH_STM32_ASSETS 可以覆盖资源包根目录(测试与自定义安装用)。
|
|
134
|
+
* 读不到不抛——返回 ok:false + 人话,让调用方(工具卡片)照常渲染。
|
|
135
|
+
*/
|
|
136
|
+
export function loadDeviceFacts(env = process.env) {
|
|
137
|
+
const state = readLocalManifest(env);
|
|
138
|
+
const filePath = state.versionDir === "" ? path.join(state.root, "device", "f1", "chips.json") : path.join(state.versionDir, DEVICE_FACTS_REL);
|
|
139
|
+
if (state.versionDir === "") {
|
|
140
|
+
return emptyFacts(filePath, "", (state.error === "" ? "本地还没装资源包" : state.error) + ";设备事实只从资源包缓存读," + DEVICE_FACTS_HINT + "。");
|
|
141
|
+
}
|
|
142
|
+
let stat;
|
|
143
|
+
try {
|
|
144
|
+
stat = fs.statSync(filePath);
|
|
145
|
+
}
|
|
146
|
+
catch {
|
|
147
|
+
return emptyFacts(filePath, state.version, "资源包 " + state.version + " 里没有 " + DEVICE_FACTS_REL + "(" + filePath + "):这一版资源包不全;" + DEVICE_FACTS_HINT + "。");
|
|
148
|
+
}
|
|
149
|
+
const key = filePath + ":" + String(stat.size) + ":" + String(stat.mtimeMs);
|
|
150
|
+
if (cache !== null && cache.key === key)
|
|
151
|
+
return cache.facts;
|
|
152
|
+
let text;
|
|
153
|
+
try {
|
|
154
|
+
text = fs.readFileSync(filePath, "utf8");
|
|
155
|
+
}
|
|
156
|
+
catch (error) {
|
|
157
|
+
return emptyFacts(filePath, state.version, "设备事实读不了(" + filePath + "):" + errText(error) + ";" + DEVICE_FACTS_HINT + "。");
|
|
158
|
+
}
|
|
159
|
+
const facts = parseDeviceFacts(text, filePath, state.version);
|
|
160
|
+
cache = { key, facts };
|
|
161
|
+
return facts;
|
|
162
|
+
}
|
|
163
|
+
/** 型号 → 事实;没有这颗(或没有缓存)返回 null。cpn 大小写不敏感。 */
|
|
164
|
+
export function findChipFact(cpn, env = process.env) {
|
|
165
|
+
const wanted = cpn.trim().toUpperCase();
|
|
166
|
+
if (wanted === "")
|
|
167
|
+
return null;
|
|
168
|
+
const facts = loadDeviceFacts(env);
|
|
169
|
+
return facts.ok ? facts.byCpn.get(wanted) ?? null : null;
|
|
170
|
+
}
|
|
171
|
+
export class DeviceFactError extends Error {
|
|
172
|
+
code;
|
|
173
|
+
cpn;
|
|
174
|
+
constructor(code, message, cpn = "") {
|
|
175
|
+
super(message);
|
|
176
|
+
this.name = "DeviceFactError";
|
|
177
|
+
this.code = code;
|
|
178
|
+
this.cpn = cpn;
|
|
179
|
+
}
|
|
180
|
+
}
|
|
181
|
+
/** 型号 → 事实;没有就抛 DeviceFactError(message 一定带 refresh 提示)。 */
|
|
182
|
+
export function requireChipFact(cpn, env = process.env) {
|
|
183
|
+
const wanted = cpn.trim().toUpperCase();
|
|
184
|
+
const facts = loadDeviceFacts(env);
|
|
185
|
+
if (!facts.ok)
|
|
186
|
+
throw new DeviceFactError("facts-missing", facts.error, wanted);
|
|
187
|
+
const found = facts.byCpn.get(wanted);
|
|
188
|
+
if (found === undefined) {
|
|
189
|
+
throw new DeviceFactError("chip-unknown", "资源包(" + facts.version + ")里没有 " + (wanted === "" ? "(空型号)" : wanted) + " 这颗芯片:" +
|
|
190
|
+
"已知 line " + (facts.lines.length === 0 ? "(无)" : facts.lines.join("/")) + ";" + DEVICE_FACTS_HINT + "。", wanted);
|
|
191
|
+
}
|
|
192
|
+
return found;
|
|
193
|
+
}
|
|
194
|
+
/**
|
|
195
|
+
* 设备事实的来源(写进报告/错误文案):读到缓存 → chips.json 的绝对路径;没有缓存 → "none"。
|
|
196
|
+
* 想看版本用 loadDeviceFacts().version。
|
|
197
|
+
*/
|
|
198
|
+
export function deviceFactsSource(env = process.env) {
|
|
199
|
+
const facts = loadDeviceFacts(env);
|
|
200
|
+
return facts.ok ? facts.path : "none";
|
|
201
|
+
}
|
package/lib/data/stm32f1.js
CHANGED
|
@@ -1,102 +1,49 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* L1:STM32F1
|
|
2
|
+
* L1:STM32F1 型号 → 芯片事实(容量档 / 启动文件 / 设备宏 / 设备头 / Flash / RAM / 引脚数)。
|
|
3
3
|
*
|
|
4
|
-
*
|
|
5
|
-
*
|
|
4
|
+
* 这里只剩**解析逻辑**,没有事实:事实全部来自资源包缓存里的 device/f1/chips.json,
|
|
5
|
+
* 经 src/data/device-facts.ts 读入(用户 2026-10-31「内置表删了吧」的决定)。
|
|
6
|
+
* 所以本文件不再有 F1_LINES / GROUP_BY_LETTER / FLASH_BY_LETTER / RAM_BY_LINE_LETTER
|
|
7
|
+
* 这类表——加一款芯片只改资源仓库的 scripts/build-assets.mjs,插件一个字都不用动。
|
|
6
8
|
*
|
|
7
|
-
*
|
|
8
|
-
*
|
|
9
|
-
*
|
|
10
|
-
*
|
|
11
|
-
* 3. 本文件内置的容量字母表。
|
|
9
|
+
* 支持三种输入(与 0.2 一致,调用方不用改):
|
|
10
|
+
* - 完整型号:STM32F103C8T6 / STM32F103RCT6 / STM32F107VCT6
|
|
11
|
+
* - 去掉温度后缀:STM32F103C8(按 chips.json 里同前缀的唯一一颗归一化)
|
|
12
|
+
* - 显式容量档:F103:xb(脚本与 cmsis 缓存 id 用;取该档在资源包里的一个代表型号)
|
|
12
13
|
*
|
|
13
|
-
*
|
|
14
|
-
*
|
|
15
|
-
*/
|
|
16
|
-
import { F1_RAM_FROM_DB } from "./f1-ram.generated.js";
|
|
17
|
-
/** 容量字母 → 上游容量档的兜底映射(当 line 没有「x + 字母」这个档时用它)。 */
|
|
18
|
-
const GROUP_BY_LETTER = {
|
|
19
|
-
"4": "x6",
|
|
20
|
-
"6": "x6",
|
|
21
|
-
"8": "xb",
|
|
22
|
-
B: "xb",
|
|
23
|
-
C: "xe",
|
|
24
|
-
D: "xe",
|
|
25
|
-
E: "xe",
|
|
26
|
-
F: "xg",
|
|
27
|
-
G: "xg",
|
|
28
|
-
};
|
|
29
|
-
/** 容量字母 → Flash 字节(ST 的容量字母就是 Flash 档)。 */
|
|
30
|
-
const FLASH_BY_LETTER = {
|
|
31
|
-
"4": 16 * 1024,
|
|
32
|
-
"6": 32 * 1024,
|
|
33
|
-
"8": 64 * 1024,
|
|
34
|
-
B: 128 * 1024,
|
|
35
|
-
C: 256 * 1024,
|
|
36
|
-
D: 384 * 1024,
|
|
37
|
-
E: 512 * 1024,
|
|
38
|
-
F: 768 * 1024,
|
|
39
|
-
G: 1024 * 1024,
|
|
40
|
-
};
|
|
41
|
-
/**
|
|
42
|
-
* RAM 字节。键是「line:容量字母」——一个容量档会跨多个字母,而它们的 RAM 并不相同
|
|
43
|
-
* (F103xC 是 48 KiB,F103xE 是 64 KiB),所以不能按档查。
|
|
44
|
-
* 只收有把握的组合;查不到返回 null 并在 notes 里说清楚,绝不猜。
|
|
14
|
+
* 认不出时返回 chip: null + 人话原因,绝不编一个不存在的启动文件。
|
|
15
|
+
* 没装资源包时同样返回 chip: null,原因里带「先跑 stm32_assets refresh,或检查网络」。
|
|
45
16
|
*/
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
"103:D": 64 * 1024,
|
|
52
|
-
"103:E": 64 * 1024,
|
|
53
|
-
"105:C": 64 * 1024,
|
|
54
|
-
"107:C": 64 * 1024,
|
|
55
|
-
};
|
|
56
|
-
/** F1 各 line 在上游真实存在的容量档(由固件包 gcc 启动文件实测得出;F106 不是独立产品线)。 */
|
|
57
|
-
export const F1_LINES = [
|
|
58
|
-
{ code: "100", prefix: "STM32F100", groups: ["xb", "xe"], familyDir: "STM32F1xx" },
|
|
59
|
-
{ code: "101", prefix: "STM32F101", groups: ["x6", "xb", "xe", "xg"], familyDir: "STM32F1xx" },
|
|
60
|
-
{ code: "102", prefix: "STM32F102", groups: ["x6", "xb"], familyDir: "STM32F1xx" },
|
|
61
|
-
{ code: "103", prefix: "STM32F103", groups: ["x6", "xb", "xe", "xg"], familyDir: "STM32F1xx" },
|
|
62
|
-
{ code: "105", prefix: "STM32F105", groups: ["xc"], familyDir: "STM32F1xx" },
|
|
63
|
-
{ code: "107", prefix: "STM32F107", groups: ["xc"], familyDir: "STM32F1xx" },
|
|
64
|
-
];
|
|
65
|
-
/** 封装字母(型号第 4 位)→ 引脚数。 */
|
|
66
|
-
const PINS_BY_PACKAGE = {
|
|
67
|
-
T: 36,
|
|
68
|
-
C: 48,
|
|
69
|
-
R: 64,
|
|
70
|
-
V: 100,
|
|
71
|
-
Z: 144,
|
|
72
|
-
};
|
|
17
|
+
import { DEVICE_FACTS_HINT, loadDeviceFacts } from "./device-facts.js";
|
|
18
|
+
/** 完整型号:STM32F103RCT6 → line 103 / 封装 R / 容量 C / 后缀 T / 温度 6。 */
|
|
19
|
+
const CPN_PATTERN = /^STM32F(\d{3})([A-Z])([0-9A-G])([A-Z])?([0-9])?$/u;
|
|
20
|
+
/** 容量档写法:F103:xb(脚本、cmsis 缓存 id 用)。 */
|
|
21
|
+
const GROUP_PATTERN = /^F(\d{2,3}):(X[0-9A-Z]{1,2})$/u;
|
|
73
22
|
/**
|
|
74
23
|
* 型号 → 芯片事实。认不出返回 chip: null + 原因,绝不编一个不存在的启动文件。
|
|
75
|
-
*
|
|
76
|
-
* 支持三种输入:
|
|
77
|
-
* - 完整型号:STM32F103C8T6 / STM32F103RCT6 / STM32F107VCT6
|
|
78
|
-
* - 去掉温度后缀:STM32F103C8
|
|
79
|
-
* - 显式容量档:F103:xb(脚本与测试用)
|
|
80
24
|
*/
|
|
81
25
|
export function resolveF1Chip(input) {
|
|
82
26
|
const text = input.trim().toUpperCase();
|
|
83
27
|
if (text.length === 0)
|
|
84
28
|
return { chip: null, reason: "没有给型号" };
|
|
85
|
-
const
|
|
29
|
+
const facts = loadDeviceFacts();
|
|
30
|
+
if (!facts.ok)
|
|
31
|
+
return { chip: null, reason: facts.error };
|
|
32
|
+
const loose = GROUP_PATTERN.exec(text);
|
|
86
33
|
if (loose !== null) {
|
|
87
34
|
const code = loose[1] ?? "";
|
|
88
35
|
const group = (loose[2] ?? "").toLowerCase();
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
36
|
+
if (!facts.lines.includes(code))
|
|
37
|
+
return { chip: null, reason: lineMissing(facts, code) };
|
|
38
|
+
const fact = facts.byLineGroup.get(code + ":" + group);
|
|
39
|
+
if (fact === undefined)
|
|
40
|
+
return { chip: null, reason: groupMissing(facts, code, group) };
|
|
41
|
+
return { chip: chipFromFact(fact), reason: "" };
|
|
93
42
|
}
|
|
94
|
-
const m =
|
|
43
|
+
const m = CPN_PATTERN.exec(text);
|
|
95
44
|
if (m === null)
|
|
96
45
|
return { chip: null, reason: "不是 F1 的型号格式:" + input };
|
|
97
46
|
const code = m[1] ?? "";
|
|
98
|
-
const packageLetter = m[2] ?? "";
|
|
99
|
-
const densityLetter = m[3] ?? "";
|
|
100
47
|
const suffix = m[4] ?? "";
|
|
101
48
|
const extra = m[5] ?? "";
|
|
102
49
|
if (suffix.length > 0 && !"TXUYK".includes(suffix)) {
|
|
@@ -105,82 +52,79 @@ export function resolveF1Chip(input) {
|
|
|
105
52
|
if (extra.length > 0 && !"67".includes(extra)) {
|
|
106
53
|
return { chip: null, reason: "认不出温度档 " + extra + "(期望 6 或 7):" + input };
|
|
107
54
|
}
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
const fallback = GROUP_BY_LETTER[densityLetter];
|
|
114
|
-
if (fallback === undefined) {
|
|
115
|
-
return { chip: null, reason: "认不出容量字母 " + densityLetter + ":" + input };
|
|
116
|
-
}
|
|
117
|
-
return {
|
|
118
|
-
chip: null,
|
|
119
|
-
reason: line.prefix + " 没有 " + fallback + " 这一容量档(上游真实档位:" + line.groups.join("/") + ")",
|
|
120
|
-
};
|
|
55
|
+
if (!facts.lines.includes(code))
|
|
56
|
+
return { chip: null, reason: lineMissing(facts, code) };
|
|
57
|
+
const fact = matchFact(facts, text);
|
|
58
|
+
if (fact === null) {
|
|
59
|
+
return { chip: null, reason: unknownChip(facts, text, code, m[3] ?? "") };
|
|
121
60
|
}
|
|
122
|
-
return
|
|
61
|
+
return { chip: chipFromFact(fact), reason: "" };
|
|
123
62
|
}
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
63
|
+
/**
|
|
64
|
+
* 型号 → 资源包里的那颗。先精确匹配 cpn;没有再按「cpn 以输入开头」归一化
|
|
65
|
+
* (STM32F103C8 → STM32F103C8T6,即用户省略了温度后缀)。
|
|
66
|
+
* 多命中时取 cpn 最短、再按字典序——同一份事实永远给同一个结果。
|
|
67
|
+
*/
|
|
68
|
+
function matchFact(facts, text) {
|
|
69
|
+
const exact = facts.byCpn.get(text);
|
|
70
|
+
if (exact !== undefined)
|
|
71
|
+
return exact;
|
|
72
|
+
const candidates = facts.chips.filter((chip) => chip.cpn.startsWith(text));
|
|
73
|
+
if (candidates.length === 0)
|
|
134
74
|
return null;
|
|
135
|
-
|
|
75
|
+
candidates.sort((left, right) => {
|
|
76
|
+
if (left.cpn.length !== right.cpn.length)
|
|
77
|
+
return left.cpn.length - right.cpn.length;
|
|
78
|
+
return left.cpn < right.cpn ? -1 : left.cpn > right.cpn ? 1 : 0;
|
|
79
|
+
});
|
|
80
|
+
return candidates[0] ?? null;
|
|
136
81
|
}
|
|
137
|
-
function
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
82
|
+
function lineMissing(facts, code) {
|
|
83
|
+
return ("F1 里没有 F" + code + " 这一 line(资源包已知:" + facts.lines.join("/") + ");" + DEVICE_FACTS_HINT + ",看有没有新版资源包。");
|
|
84
|
+
}
|
|
85
|
+
function groupMissing(facts, code, group) {
|
|
86
|
+
const groups = facts.groupsByLine.get(code) ?? [];
|
|
87
|
+
return ("STM32F" + code + " 没有 " + group + " 这一容量档(资源包里的档位:" + groups.join("/") + ");" +
|
|
88
|
+
DEVICE_FACTS_HINT + ",看有没有新版资源包。");
|
|
89
|
+
}
|
|
90
|
+
/**
|
|
91
|
+
* 格式对、line 在,但资源包里没有这一颗。
|
|
92
|
+
* 分两种情况说清楚,别把「没收录」说成「不存在」:
|
|
93
|
+
* · 这个容量档在资源包里有,只是没有这个封装/温度后缀的组合(例如 C8T7);
|
|
94
|
+
* · 这个容量档根本没收录(上游 CubeMX 没给出这档的 RAM/Flash,或者资源包还没覆盖,例如 F100RCT6)。
|
|
95
|
+
*/
|
|
96
|
+
function unknownChip(facts, text, code, densityLetter) {
|
|
97
|
+
const groups = facts.groupsByLine.get(code) ?? [];
|
|
98
|
+
const direct = "x" + densityLetter.toLowerCase();
|
|
99
|
+
const inGroup = groups.includes(direct);
|
|
100
|
+
const detail = inGroup
|
|
101
|
+
? "这一容量档在,但没有「封装 + 温度后缀」正好是这串的组合"
|
|
102
|
+
: "这一档没有收录(上游没给这档的 RAM/Flash,或资源包还没覆盖)";
|
|
103
|
+
return ("资源包(" + (facts.version === "" ? "未知版本" : facts.version) + ")里没有 " + text + " 这一颗:" +
|
|
104
|
+
"STM32F" + code + " 收录了 " + groups.join("/") + " 容量档;" + detail + ";" +
|
|
105
|
+
DEVICE_FACTS_HINT + ",看有没有新版资源包,或换一颗同档的常见型号(资源包共 " + String(facts.chips.length) + " 颗)。");
|
|
106
|
+
}
|
|
107
|
+
function chipFromFact(fact) {
|
|
108
|
+
const lineMatch = /^STM32F(\d{3})/u.exec(fact.cpn);
|
|
109
|
+
const densityMatch = /^STM32F\d{3}[A-Z]([0-9A-G])/u.exec(fact.cpn);
|
|
161
110
|
return {
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
notes,
|
|
174
|
-
},
|
|
175
|
-
reason: "",
|
|
111
|
+
cpn: fact.cpn,
|
|
112
|
+
prefix: lineMatch === null ? "STM32F" + fact.line : "STM32F" + (lineMatch[1] ?? fact.line),
|
|
113
|
+
densityLetter: densityMatch?.[1] ?? fact.group.slice(1).toUpperCase(),
|
|
114
|
+
group: fact.group,
|
|
115
|
+
startup: fact.startup,
|
|
116
|
+
deviceDefine: fact.deviceDefine,
|
|
117
|
+
deviceHeader: fact.deviceHeader,
|
|
118
|
+
pinCount: fact.pinCount,
|
|
119
|
+
flashBytes: fact.flashBytes,
|
|
120
|
+
ramBytes: fact.ramBytes,
|
|
121
|
+
notes: [],
|
|
176
122
|
};
|
|
177
123
|
}
|
|
178
|
-
|
|
179
|
-
const found = Object.entries(GROUP_BY_LETTER).find(([, value]) => value === group);
|
|
180
|
-
return found === undefined ? "" : found[0];
|
|
181
|
-
}
|
|
182
|
-
/** 该 line 的全部容量档(给「这个型号能选哪些档」的报告用)。 */
|
|
124
|
+
/** 该 line 的全部容量档(去重升序;给「这个型号能选哪些档」的报告用)。 */
|
|
183
125
|
export function f1GroupsFor(code) {
|
|
184
|
-
const
|
|
185
|
-
|
|
126
|
+
const facts = loadDeviceFacts();
|
|
127
|
+
if (!facts.ok)
|
|
128
|
+
return [];
|
|
129
|
+
return facts.groupsByLine.get(code.trim()) ?? [];
|
|
186
130
|
}
|