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.
Files changed (44) hide show
  1. package/README.md +59 -21
  2. package/README_EN.md +59 -21
  3. package/docs/development-notes.md +374 -3
  4. package/docs/reading-guide.md +87 -66
  5. package/lib/data/chips.js +38 -51
  6. package/lib/data/cmsis-sources.js +27 -1
  7. package/lib/data/device-facts.js +201 -0
  8. package/lib/data/stm32f1.js +94 -150
  9. package/lib/data/svd.js +627 -0
  10. package/lib/engine/assets.js +924 -0
  11. package/lib/engine/breakpoints.js +242 -0
  12. package/lib/engine/debug-session.js +153 -5
  13. package/lib/engine/debug.js +75 -41
  14. package/lib/engine/doctor.js +2 -2
  15. package/lib/engine/flash.js +31 -59
  16. package/lib/engine/ioc-plan.js +5 -5
  17. package/lib/engine/probe-error.js +212 -0
  18. package/lib/engine/probe-session.js +311 -0
  19. package/lib/engine/register-template.js +32 -8
  20. package/lib/engine/regs.js +2 -0
  21. package/lib/engine/rtt.js +600 -0
  22. package/lib/index.js +8 -0
  23. package/lib/tools/assets.js +341 -0
  24. package/lib/tools/cache.js +8 -0
  25. package/lib/tools/debug-session.js +40 -5
  26. package/lib/tools/debug.js +41 -11
  27. package/lib/tools/doctor.js +11 -0
  28. package/lib/tools/flash.js +15 -6
  29. package/lib/tools/generate.js +3 -0
  30. package/lib/tools/ioc-apply.js +2 -0
  31. package/lib/tools/ioc-inspect.js +2 -0
  32. package/lib/tools/ioc-plan.js +3 -0
  33. package/lib/tools/project-create.js +24 -0
  34. package/lib/tools/regs.js +453 -61
  35. package/lib/tools/route-plan.js +3 -0
  36. package/lib/tools/rtt.js +347 -0
  37. package/package.json +1 -1
  38. package/templates/register/CMakeLists.txt +7 -1
  39. package/templates/register/Core/Inc/rtt.h +103 -0
  40. package/templates/register/Core/Src/main.c +25 -0
  41. package/templates/register/Core/Src/rtt.c +297 -0
  42. package/templates/scaffold/RTT.md +86 -0
  43. package/templates/scaffold/cmake/user/CMakeLists.txt +7 -0
  44. 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 resolveF1Chip("STM32F103C" + text.toUpperCase() + "T6").chip;
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
+ }
@@ -1,102 +1,49 @@
1
1
  /**
2
- * L1:STM32F1 全系的芯片事实表(型号 → 容量档 / 启动文件 / 设备宏 / Flash / RAM)。
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
- * 取数优先级(写进 docs/development-notes.md):
8
- * 1. 固件包 `Drivers/CMSIS/Device/ST/STM32F1xx/Source/Templates/gcc` 里真实存在的启动文件
9
- * —— 实测 F1 有 14 个(100 xb/xe、101 x6/xb/xe/xg、102 x6/xb、103 x6/xb/xe/xg、105 xc、107 xc)。
10
- * 2. 本机 CubeMX 的 `db/mcu/*.xml`(Flash/RAM/引脚数,将来用作校验)。
11
- * 3. 本文件内置的容量字母表。
9
+ * 支持三种输入(与 0.2 一致,调用方不用改):
10
+ * - 完整型号:STM32F103C8T6 / STM32F103RCT6 / STM32F107VCT6
11
+ * - 去掉温度后缀:STM32F103C8(按 chips.json 里同前缀的唯一一颗归一化)
12
+ * - 显式容量档:F103:xb(脚本与 cmsis 缓存 id 用;取该档在资源包里的一个代表型号)
12
13
  *
13
- * 关键坑:容量字母 → 容量档不是全局映射。字母 C 在 F103 上是 xE(startup_stm32f103xe.s),
14
- * 在 F105/F107 上却是 xC(startup_stm32f105xc.s)——先按「line 真有这一档」匹配,再退回全局表。
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
- const RAM_BY_LINE_LETTER = {
47
- "103:6": 10 * 1024,
48
- "103:8": 20 * 1024,
49
- "103:B": 20 * 1024,
50
- "103:C": 48 * 1024,
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 loose = /^F(\d{2,3}):(X[0-9A-Z]{1,2})$/u.exec(text);
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
- const line = F1_LINES.find((item) => item.code === code);
90
- if (line === undefined)
91
- return { chip: null, reason: lineMissing(code) };
92
- return fromGroup(line, group, "F" + code);
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 = /^STM32F(\d{3})([A-Z])([0-9A-G])([A-Z])?([0-9])?$/u.exec(text);
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
- const line = F1_LINES.find((item) => item.code === code);
109
- if (line === undefined)
110
- return { chip: null, reason: lineMissing(code) };
111
- const group = chooseGroup(line, densityLetter);
112
- if (group === null) {
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 fromGroup(line, group, text, packageLetter, densityLetter);
61
+ return { chip: chipFromFact(fact), reason: "" };
123
62
  }
124
- function lineMissing(code) {
125
- return "F1 里没有 F" + code + " 这一 line(已知:" + F1_LINES.map((x) => x.code).join("/") + ")";
126
- }
127
- /** 先认「line 真有 x+字母」,再退回全局表;都不行返回 null。 */
128
- function chooseGroup(line, letter) {
129
- const direct = "x" + letter.toLowerCase();
130
- if (line.groups.includes(direct))
131
- return direct;
132
- const fallback = GROUP_BY_LETTER[letter];
133
- if (fallback === undefined)
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
- return line.groups.includes(fallback) ? fallback : null;
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 fromGroup(line, group, cpn, packageLetter = "", densityLetter = "") {
138
- const notes = [];
139
- if (!line.groups.includes(group)) {
140
- return {
141
- chip: null,
142
- reason: line.prefix + " 没有 " + group + " 这一容量档(上游真实档位:" + line.groups.join("/") + ")",
143
- };
144
- }
145
- const letter = densityLetter.length > 0 ? densityLetter : letterForGroup(group);
146
- const stem = line.prefix.toLowerCase() + group;
147
- // 先用手写表(有把握的组合),再用生成表(CubeMX db 里「容量字母与 RAM 唯一对应」的条目)。
148
- // db 给区间的分组(例如 F103R(C-D-E) 的 [48,64])不进生成表——字母对不上号时宁可不收。
149
- const handRam = RAM_BY_LINE_LETTER[line.code + ":" + letter];
150
- const dbRam = F1_RAM_FROM_DB[line.code + ":" + letter];
151
- const ramBytes = handRam ?? dbRam ?? null;
152
- if (handRam === undefined && dbRam !== undefined) {
153
- notes.push("RAM 取自 CubeMX db 的容量档值(" + line.prefix + letter + " = " + String(dbRam / 1024) + " KiB)");
154
- }
155
- if (ramBytes === null) {
156
- notes.push("RAM 大小未收录:" + line.prefix + letter + "(用 CubeMX 的 db/mcu 确认后再补表)");
157
- }
158
- if (packageLetter.length > 0 && PINS_BY_PACKAGE[packageLetter] === undefined) {
159
- notes.push("认不出封装字母 " + packageLetter + ",引脚数未知");
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
- chip: {
163
- cpn,
164
- prefix: line.prefix,
165
- densityLetter: letter,
166
- group,
167
- startup: "startup_" + stem + ".s",
168
- deviceDefine: line.prefix + "x" + group.slice(1).toUpperCase(),
169
- deviceHeader: stem + ".h",
170
- pinCount: packageLetter.length > 0 ? (PINS_BY_PACKAGE[packageLetter] ?? null) : null,
171
- flashBytes: FLASH_BY_LETTER[letter] ?? null,
172
- ramBytes,
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
- function letterForGroup(group) {
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 line = F1_LINES.find((item) => item.code === code);
185
- return line === undefined ? [] : line.groups;
126
+ const facts = loadDeviceFacts();
127
+ if (!facts.ok)
128
+ return [];
129
+ return facts.groupsByLine.get(code.trim()) ?? [];
186
130
  }