dsh-stm32 0.1.1 → 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 (62) hide show
  1. package/README.md +98 -31
  2. package/README_EN.md +96 -29
  3. package/docs/development-notes.md +837 -4
  4. package/docs/reading-guide.md +759 -0
  5. package/lib/commands/register.js +49 -0
  6. package/lib/data/chips.js +147 -30
  7. package/lib/data/clock-f1.js +158 -0
  8. package/lib/data/cmsis-sources.js +237 -42
  9. package/lib/data/device-facts.js +201 -0
  10. package/lib/data/stm32f1.js +130 -0
  11. package/lib/data/svd.js +627 -0
  12. package/lib/engine/assets.js +924 -0
  13. package/lib/engine/breakpoints.js +242 -0
  14. package/lib/engine/build.js +115 -16
  15. package/lib/engine/cache.js +56 -0
  16. package/lib/engine/clock-plan.js +608 -0
  17. package/lib/engine/cmake-sources.js +428 -0
  18. package/lib/engine/debug-session.js +153 -5
  19. package/lib/engine/debug.js +114 -15
  20. package/lib/engine/doctor.js +395 -4
  21. package/lib/engine/fetch.js +174 -30
  22. package/lib/engine/flash.js +70 -9
  23. package/lib/engine/generate.js +11 -0
  24. package/lib/engine/hal-chip.js +230 -0
  25. package/lib/engine/ioc-plan.js +33 -7
  26. package/lib/engine/msys2-install.js +332 -61
  27. package/lib/engine/probe-error.js +212 -0
  28. package/lib/engine/probe-session.js +311 -0
  29. package/lib/engine/project-export.js +129 -0
  30. package/lib/engine/register-clock.js +132 -0
  31. package/lib/engine/register-linker.js +129 -0
  32. package/lib/engine/register-template.js +115 -20
  33. package/lib/engine/regs.js +2 -0
  34. package/lib/engine/rtt.js +600 -0
  35. package/lib/engine/scaffold.js +104 -28
  36. package/lib/engine/zip.js +142 -0
  37. package/lib/index.js +10 -0
  38. package/lib/skill/stm32-workflow.js +3 -3
  39. package/lib/tools/assets.js +341 -0
  40. package/lib/tools/build.js +12 -0
  41. package/lib/tools/cache.js +47 -8
  42. package/lib/tools/debug-session.js +40 -5
  43. package/lib/tools/debug.js +41 -4
  44. package/lib/tools/doctor.js +22 -2
  45. package/lib/tools/flash.js +15 -3
  46. package/lib/tools/generate.js +3 -0
  47. package/lib/tools/ioc-apply.js +2 -0
  48. package/lib/tools/ioc-inspect.js +2 -0
  49. package/lib/tools/ioc-plan.js +198 -4
  50. package/lib/tools/project-create.js +50 -1
  51. package/lib/tools/project-export.js +100 -0
  52. package/lib/tools/regs.js +453 -61
  53. package/lib/tools/route-plan.js +3 -0
  54. package/lib/tools/rtt.js +347 -0
  55. package/package.json +5 -3
  56. package/templates/register/CMakeLists.txt +25 -6
  57. package/templates/register/Core/Inc/rtt.h +103 -0
  58. package/templates/register/Core/Src/main.c +43 -9
  59. package/templates/register/Core/Src/rtt.c +297 -0
  60. package/templates/scaffold/RTT.md +86 -0
  61. package/templates/scaffold/cmake/user/CMakeLists.txt +7 -0
  62. package/templates/scaffold/openocd.cfg +8 -0
@@ -6,7 +6,14 @@
6
6
  * 这些都是 Apache-2.0 的 ST/ARM 公开源码,第一次用时拉到缓存目录,之后复用。
7
7
  *
8
8
  * 每个文件给多条候选 URL(见 fetch.ts:raw.githubusercontent 在有些网络里不通)。
9
+ *
10
+ * 0.2 起这一层不再自己维护「型号 → 启动文件」的对照表:那条事实统一由 data/stm32f1.ts 的
11
+ * resolveF1Chip() 负责(100/101/102/103/105/107 全部 line × 容量档),这里只做两件事:
12
+ * 1) 把 F1Chip 翻译成下载清单(路径 + markers + 实测 sha256);
13
+ * 2) 把用户给的各种写法(型号 / F1:B / F1:103xb / 0.1 的老缓存 id)解析成同一个缓存条目。
9
14
  */
15
+ import { loadDeviceFacts } from "./device-facts.js";
16
+ import { resolveF1Chip } from "./stm32f1.js";
10
17
  const JS_DELIVR_FASTLY = (repo, ref, file) => "https://fastly.jsdelivr.net/gh/STMicroelectronics/" + repo + "@" + ref + "/" + file;
11
18
  const JS_DELIVR_CDN = (repo, ref, file) => "https://cdn.jsdelivr.net/gh/STMicroelectronics/" + repo + "@" + ref + "/" + file;
12
19
  const RAW_GITHUB = (repo, ref, file) => "https://raw.githubusercontent.com/STMicroelectronics/" + repo + "/" + ref + "/" + file;
@@ -34,58 +41,229 @@ export const CMSIS_FAMILIES = {
34
41
  deviceDefinePrefix: "STM32F1",
35
42
  },
36
43
  };
44
+ /** line 代号:STM32F103 → F1。 */
45
+ export function familyOf(chip) {
46
+ return chip.prefix.slice(5, 7);
47
+ }
37
48
  /**
38
- * F1 各容量档对应的启动文件、设备宏与设备头。
49
+ * 缓存条目里的「档位键」= line + 容量档,例如 103xb。
39
50
  *
40
- * 这里只有三档,因为 ST 上游就只提供三个文件(2026-10 实测 jsDelivr 上的真实文件名,
41
- * 探测 <x8 / <xC / <xD 三种写法都是 404):
42
- * x6(小容量 32 KiB) → startup_stm32f103x6.s + STM32F103x6 + stm32f103x6.h
43
- * x8 / xB(中容量 64/128KiB)→ startup_stm32f103xb.s + STM32F103xB + stm32f103xb.h
44
- * xC / xD / xE(大容量) → startup_stm32f103xe.s + STM32F103xE + stm32f103xe.h
45
- * 蓝丸 C8T6 的 64 KiB 属中容量:型号里的容量字母是 8,但要用 xB 的那套文件。
51
+ * 为什么不只用容量档(任务书写的是 <family>:<group>):同名档位在 F1 内部会撞车——
52
+ * F100 / F101 / F102 / F103 各有一套 startup_stm32f10xxb.s 设备头,只用 xb 会把
53
+ * 四份不同的文件当成同一份缓存。带上 line 之后每档唯一,且一眼看得出是哪一颗。
46
54
  */
47
- const F1_STARTUP_BY_DENSITY = {
48
- "6": { startup: "startup_stm32f103x6.s", define: "STM32F103x6", header: "stm32f103x6.h" },
49
- "8": { startup: "startup_stm32f103xb.s", define: "STM32F103xB", header: "stm32f103xb.h" },
50
- B: { startup: "startup_stm32f103xb.s", define: "STM32F103xB", header: "stm32f103xb.h" },
51
- C: { startup: "startup_stm32f103xe.s", define: "STM32F103xE", header: "stm32f103xe.h" },
52
- D: { startup: "startup_stm32f103xe.s", define: "STM32F103xE", header: "stm32f103xe.h" },
53
- E: { startup: "startup_stm32f103xe.s", define: "STM32F103xE", header: "stm32f103xe.h" },
54
- };
55
+ export function cmsisGroupKey(chip) {
56
+ return chip.prefix.slice(6) + chip.group;
57
+ }
58
+ /** 缓存条目 id:cmsis:<族>:<line><档>,例如 cmsis:F1:103xb。 */
59
+ export function cmsisEntryId(family, groupKey) {
60
+ return "cmsis:" + family + ":" + groupKey;
61
+ }
62
+ /** 某颗芯片的缓存条目 id。 */
63
+ export function chipEntryId(chip) {
64
+ return cmsisEntryId(familyOf(chip), cmsisGroupKey(chip));
65
+ }
66
+ function choiceFromChip(chip) {
67
+ return {
68
+ family: familyOf(chip),
69
+ startup: chip.startup,
70
+ define: chip.deviceDefine,
71
+ deviceHeader: chip.deviceHeader,
72
+ chip,
73
+ };
74
+ }
55
75
  /**
56
- * 从型号(或直接给容量档)推出启动文件与设备宏。
76
+ * 只给容量字母(F1:B / F1:8)时,从设备事实里挑一颗同档芯片当代表:
77
+ * 优先 F103(档位最全,0.1 的 "F1:B" 正是按 F103 解释的),再按 line / CPN 升序。
57
78
  *
58
- * STM32F103C8T6 → 容量档 8 → 归到 startup_stm32f103xb.s(上游 CMSIS 只有 x6/xB/xE 三套,
59
- * 没有 x8);STM32F103CBT6 → B → startup_stm32f103xb.s;C/D/E 大容量 → startup_stm32f103xe.s。
60
- * 认不出就返回 null:宁可明说"这一代还没做",也不要编一个文件名让链接器报一堆奇怪错误。
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
+ }
100
+ /**
101
+ * 只给容量档(F1:B / F1:8 / F1:xb)时,用 F103 当代表:F103 的档位最全
102
+ * (x6/xb/xe/xg),0.1 的 "F1:B" 也正是按 F103 解释的,行为不变。
103
+ */
104
+ function chipForKey(key) {
105
+ const text = key.trim().toLowerCase();
106
+ if (text.length === 0)
107
+ return null;
108
+ if (/^x[0-9a-z]{1,2}$/u.test(text))
109
+ return resolveF1Chip("F103:" + text.toUpperCase()).chip;
110
+ if (/^[0-9a-z]$/u.test(text))
111
+ return chipForDensityLetter(text);
112
+ return null;
113
+ }
114
+ /**
115
+ * 各种写法 → F1Chip:
116
+ * STM32F103C8T6 / STM32F103C8(型号)· F103:xb(容量档)· F1:B / F1:8 / F1:xb(族:档)
117
+ * 认不出返回 null(宁可明说"这一代还没做",也不编文件名让链接器报一堆奇怪错误)。
118
+ */
119
+ export function chipForInput(input) {
120
+ const text = input.trim().toUpperCase();
121
+ if (text.length === 0)
122
+ return null;
123
+ if (text.startsWith("STM32"))
124
+ return resolveF1Chip(text).chip;
125
+ if (/^F\d{2,3}:X[0-9A-Z]{1,2}$/u.test(text))
126
+ return resolveF1Chip(text).chip;
127
+ const familyForm = /^[A-Z]\d{1,2}:(.+)$/u.exec(text);
128
+ if (familyForm !== null)
129
+ return chipForKey(familyForm[1] ?? "");
130
+ return null;
131
+ }
132
+ /**
133
+ * 从型号(或容量档写法)推出启动文件与设备宏。
134
+ *
135
+ * 0.2 起不再写死 F103:内部一律走 resolveF1Chip(F100/F101/F102/F103/F105/F107 × 各自档位)。
136
+ * 老签名与老写法("F1:B")保持可用。
61
137
  */
62
138
  export function startupChoiceFor(mcu) {
63
- const text = mcu.trim().toUpperCase();
64
- const f103 = /^STM32F103([A-Z])([68BCDE])/u.exec(text);
65
- if (f103 !== null) {
66
- const density = f103[2] ?? "";
67
- const choice = F1_STARTUP_BY_DENSITY[density];
68
- if (choice === undefined)
69
- return null;
70
- return { family: "F1", startup: choice.startup, define: choice.define, deviceHeader: choice.header };
139
+ const chip = chipForInput(mcu);
140
+ return chip === null ? null : choiceFromChip(chip);
141
+ }
142
+ function refFromChip(chip) {
143
+ return { family: familyOf(chip), groupKey: cmsisGroupKey(chip), id: chipEntryId(chip), chip };
144
+ }
145
+ /**
146
+ * 缓存条目名的解析器:认
147
+ * · cmsis:F1:103xb(0.2 的规范写法)
148
+ * · F1:103xb / F103:xb / F1:B / F1:8(脚本与老文档里的写法)
149
+ * · cmsis:F1:stm32f103xb · cmsis:F1:startup_stm32f103xb(0.1 的老 id,健康条目直接复用)
150
+ * · STM32F103C8T6(型号)
151
+ */
152
+ export function parseCmsisEntryRef(ref) {
153
+ const text = ref.trim();
154
+ if (text.length === 0)
155
+ return null;
156
+ const direct = chipForInput(text);
157
+ if (direct !== null)
158
+ return refFromChip(direct);
159
+ const familyForm = /^(?:cmsis:)?([A-Za-z]\d{1,2}):(.+)$/u.exec(text);
160
+ const tail = (familyForm === null ? text : (familyForm[2] ?? "")).trim().toLowerCase();
161
+ const stem = tail.replace(/^startup_/u, "").replace(/\.s$/u, "");
162
+ const keyed = /^(?:stm32f)?(\d{3})(x[0-9a-z]{1,2})$/u.exec(stem);
163
+ if (keyed !== null) {
164
+ const chip = resolveF1Chip("F" + (keyed[1] ?? "") + ":" + (keyed[2] ?? "").toUpperCase()).chip;
165
+ return chip === null ? null : refFromChip(chip);
71
166
  }
72
- // 只给容量档(例如 F1:B)时也认,方便测试与脚本。
73
- const loose = /^F1:([68BCDE])$/u.exec(text);
74
- if (loose !== null) {
75
- const key = loose[1] ?? "";
76
- const choice = F1_STARTUP_BY_DENSITY[key];
77
- if (choice === undefined)
78
- return null;
79
- return { family: "F1", startup: choice.startup, define: choice.define, deviceHeader: choice.header };
167
+ const chip = chipForKey(stem);
168
+ return chip === null ? null : refFromChip(chip);
169
+ }
170
+ /**
171
+ * 一个写法可能指的缓存 id(第一位是规范 id)。
172
+ * 用途:用户/老索引里是 0.1 的 id 时,别把已经下好的健康条目当成"没缓存"重下一遍。
173
+ */
174
+ export function cmsisEntryAliases(ref) {
175
+ const parsed = parseCmsisEntryRef(ref);
176
+ if (parsed === null)
177
+ return [];
178
+ const out = [parsed.id];
179
+ const stem = parsed.chip === null ? "" : parsed.chip.startup.replace(/\.s$/u, "");
180
+ if (stem !== "") {
181
+ const deviceStem = stem.replace(/^startup_/u, "");
182
+ out.push(cmsisEntryId(parsed.family, deviceStem));
183
+ out.push(cmsisEntryId(parsed.family, stem));
80
184
  }
81
- return null;
185
+ out.push(parsed.family + ":" + parsed.groupKey);
186
+ return out;
187
+ }
188
+ /**
189
+ * 上游文件的 sha256(实测 2026-10-30,jsDelivr fastly master,见每条表下面的 URL 模板)。
190
+ *
191
+ * 为什么值得锁:markers 钉的是「内容里必须有这个特征」,CDN 缓存旧版、上游同名不同代
192
+ * 都拦不住;哈希一锁,上游任何一点改动都会显式失败并给出两个哈希——维护者就知道
193
+ * 该去重新实测而不是静默接受漂移。
194
+ *
195
+ * 覆盖范围(0.2):F1 全部 14 套启动文件(100:xb/xe · 101:x6/xb/xe/xg · 102:x6/xb ·
196
+ * 103:x6/xb/xe/xg · 105:xc · 107:xc)+ 16 个设备头(14 个型号头 + stm32f1xx.h +
197
+ * system_stm32f1xx.h)。实测方式:按真实 URL 各下一份,算 sha256(脚本用本仓
198
+ * lib/engine/fetch.js 的同一条下载路径,避免"表里是手抄值")。
199
+ * 重新实测:把新值整体替换,并在下面注释里更新日期。
200
+ *
201
+ * URL 模板:
202
+ * 启动文件 https://fastly.jsdelivr.net/gh/STMicroelectronics/cmsis-device-f1@master/Source/Templates/gcc/<startup>
203
+ * 设备头 https://fastly.jsdelivr.net/gh/STMicroelectronics/cmsis-device-f1@master/Include/<header>
204
+ */
205
+ export const DEVICE_HEADER_SHA256 = {
206
+ "stm32f1xx.h": "05e93fa3ddefb2e83d762b9ca4de36e3bba9cd8e9690400fe9f2c11fc0a3cef5",
207
+ "system_stm32f1xx.h": "a54dfbb3480c672f532d472a6e84bcf34df6551771d2e9966c5a3503c676b6ab",
208
+ "stm32f100xb.h": "88ceaa84c70d6b72378846f46139b63b6c66863a97cf0502049ca692ee6ca656",
209
+ "stm32f100xe.h": "9fece142c6e63348b2e3623a05ab3b5ec5e41b8e4c31e572b79525fbef400e8b",
210
+ "stm32f101x6.h": "56a2e4f93f1febf7c716703c3cb0327982bcddf05ca598c26c618f53355af580",
211
+ "stm32f101xb.h": "c310cfc3d5afe70a9cc2fead7dd6a852d302ee2c85e096f1e473df7573e0d269",
212
+ "stm32f101xe.h": "9dafcb66917c270337675bf27d7607dff88e2dfe81ca036c4b4e048616e1388b",
213
+ "stm32f101xg.h": "1fdf19e22bbbc64c28eaaab51cc1ed97a47400d5ec720b05b1be7901e75ab6e1",
214
+ "stm32f102x6.h": "c0bf0a4447e14395e908b9545380c3c1929919f7d1e294377ed1b0ac3955bc9b",
215
+ "stm32f102xb.h": "fe0233569238071756f17c289c6daa132b9006664749b0968c988e5030b48a4b",
216
+ "stm32f103x6.h": "8e827edef0fbbc1f9fef6d1ec07fcf2c3789f18a906884cf88ac5fec893521be",
217
+ "stm32f103xb.h": "d9c7c613d9fea74220892b4fbc3e80617493acad82a04bafadab2b4a7198399c",
218
+ "stm32f103xe.h": "2104082df11b7e172ecf85461a72689b849e05b222a573e3cae0b2ab279800c3",
219
+ "stm32f103xg.h": "7ca8ab045885a99481ffb141e01b0cc4f6df4d5e1914561fc0ee67b6f4a4e99a",
220
+ "stm32f105xc.h": "ee0cff14b833552194d0d4062e93f479cb640b18b5a7a19c749e753bd305d0f1",
221
+ "stm32f107xc.h": "ffb02a8480dd670d0436bedc48fca222085f343d3019088d83d9348fb4632b4d",
222
+ };
223
+ /** 实测 2026-10-30:https://fastly.jsdelivr.net/gh/STMicroelectronics/cmsis-device-f1@master/Source/Templates/system_stm32f1xx.c */
224
+ export const SYSTEM_C_SHA256 = "8465bf3fe9057adecd8b4561403836d1fa2152d3cb088831623da3f91d86ec0a";
225
+ /** 实测 2026-10-30:https://fastly.jsdelivr.net/gh/STMicroelectronics/cmsis-device-f1@master/Source/Templates/gcc/<startup> */
226
+ export const STARTUP_SHA256 = {
227
+ "startup_stm32f100xb.s": "627ed97c93a33e4678262f9403469f509c050dabc7e8467998016362517597df",
228
+ "startup_stm32f100xe.s": "7aba359302b27457575a63c87b4e1718902d555f621f29bc5f56bd7b982b4e52",
229
+ "startup_stm32f101x6.s": "bbd6f1acf892c549594521534be9560477cf4c1f904c5ac3cd6f38e5f87a1ea7",
230
+ "startup_stm32f101xb.s": "fd97158a935c10b1d6701721b78b57da6d472d2f8a8fe672f8fc0c29b5428ef8",
231
+ "startup_stm32f101xe.s": "2cb8b1d4c77cf56e39256eafbc167f7a360be3bfd07f43a5afcc0bbd6c0d7097",
232
+ "startup_stm32f101xg.s": "71c2341a2b56c99e0963dff275df48a70f4cd9b4217b71b0200543481ec49ea0",
233
+ "startup_stm32f102x6.s": "de15b09885aa64a55c3be274046ca16003eccdd434b02176f0644d1d714f3ee3",
234
+ "startup_stm32f102xb.s": "d6a7da9e8c76932edcad28a2e0ff5da429a5ffff193d9dda087bc73ee7de040e",
235
+ "startup_stm32f103x6.s": "56254accb4a72fe36b48e518bc7ea28e577353938a9c429cd847da52f660ce9e",
236
+ "startup_stm32f103xb.s": "a9a5fc7ed5ff617527dd98b3092830f4d17ed4bf57c99eac2c53bdb514ce138c",
237
+ "startup_stm32f103xe.s": "04d6550310b491d5d8ad4de87b9cecb631b5ba5a284340e31bc94e0d05e4230b",
238
+ "startup_stm32f103xg.s": "413a437ab1246c1506e5ba421d38efc0fef277e6f851af6c09904a3bafee84f9",
239
+ "startup_stm32f105xc.s": "d189def35e547ee70e70a82648b03621587ac4384bf0d78245aafcf0b6bf7d42",
240
+ "startup_stm32f107xc.s": "71db8ed11634c230e3c04381cd899d1622b2ba58e3ac03b1e6c202eceec6713a",
241
+ };
242
+ /** 实测 2026-10-30:https://fastly.jsdelivr.net/gh/STMicroelectronics/STM32CubeF1@master/Drivers/CMSIS/Include/<header> */
243
+ export const CORE_HEADER_SHA256 = {
244
+ "core_cm3.h": "655bb08e9474438dec8b1874ea6c63749dc2787b85f06a0987c4870bcb580f21",
245
+ "cmsis_compiler.h": "03ab80c426a8360eaaad833ac816462a9f38cb2e4dbdc490914880ad071181fe",
246
+ "cmsis_gcc.h": "341982e6d6c91119214c47d7a04b31f1f8ce0970c45e2c9fe0870c80d0876e28",
247
+ "cmsis_version.h": "c2570d56ee85d4f2ec0fb62f31d080d3cddf3a015500a4ed5a006a571637b43c",
248
+ "mpu_armv7.h": "e4968e627df085e4ebf46be5140be657e035d978ae1938c1c2e3ee49fbde5030",
249
+ };
250
+ /** 兼容:直接给 F1Chip 也行(0.2 内部路径),只给 StartupChoice 时按 startup 文件名反推档位。 */
251
+ function chipOf(input) {
252
+ if ("cpn" in input)
253
+ return input;
254
+ if (input.chip !== undefined)
255
+ return input.chip;
256
+ const parsed = parseCmsisEntryRef(input.startup);
257
+ return parsed === null ? null : parsed.chip;
82
258
  }
83
259
  /**
84
260
  * 组装一代/一档模板的下载计划:路径全部按 ST 固件包布局摆,
85
261
  * 寄存器版工程直接 -I Drivers/CMSIS/Include -I Drivers/CMSIS/Device/ST/STM32F1xx/Include 就能编译,
86
262
  * 与 HAL 工程共用同一套 include 约定。
87
263
  */
88
- export function cmsisTemplatePlan(choice) {
264
+ export function cmsisTemplatePlan(input) {
265
+ const chip = chipOf(input);
266
+ const choice = "cpn" in input ? choiceFromChip(input) : { ...input, ...(chip === null ? {} : { chip }) };
89
267
  const spec = CMSIS_FAMILIES[choice.family];
90
268
  if (spec === undefined)
91
269
  return null;
@@ -101,6 +279,7 @@ export function cmsisTemplatePlan(choice) {
101
279
  urls: sourceUrls(spec.deviceRepo, spec.deviceRef, spec.deviceIncludeDir + "/" + header),
102
280
  minBytes: 200,
103
281
  markers: ["#ifndef __STM32", "#ifndef __SYSTEM_STM32"],
282
+ sha256: DEVICE_HEADER_SHA256[header],
104
283
  });
105
284
  }
106
285
  targets.push({
@@ -108,6 +287,7 @@ export function cmsisTemplatePlan(choice) {
108
287
  urls: sourceUrls(spec.deviceRepo, spec.deviceRef, spec.deviceIncludeDir + "/" + choice.deviceHeader),
109
288
  minBytes: 10_000,
110
289
  markers: ["#ifndef __STM32", "#ifndef __SYSTEM_STM32"],
290
+ sha256: DEVICE_HEADER_SHA256[choice.deviceHeader],
111
291
  });
112
292
  // 2) system_stm32f1xx.c 与启动文件
113
293
  targets.push({
@@ -115,31 +295,46 @@ export function cmsisTemplatePlan(choice) {
115
295
  urls: sourceUrls(spec.deviceRepo, spec.deviceRef, spec.deviceTemplatesDir + "/system_stm32f1xx.c"),
116
296
  minBytes: 1_000,
117
297
  markers: ["SystemInit"],
298
+ sha256: SYSTEM_C_SHA256,
118
299
  });
119
300
  targets.push({
120
301
  path: deviceBase + "/Source/Templates/gcc/" + choice.startup,
121
302
  urls: sourceUrls(spec.deviceRepo, spec.deviceRef, spec.deviceTemplatesDir + "/gcc/" + choice.startup),
122
303
  minBytes: 1_000,
123
304
  markers: ["_estack", ".syntax unified"],
305
+ sha256: STARTUP_SHA256[choice.startup],
124
306
  });
125
- // 3) CMSIS 内核头(ST 主仓库里就有,不是子模块)——都带 __CORE_/__CMSIS_/__MPU_ 守卫
307
+ // 3) CMSIS 内核头(ST 主仓库里就有,不是子模块)。
308
+ // markers 按文件给:core_cm3/cmsis_compiler/cmsis_gcc/cmsis_version 带 __CORE_/__CMSIS_ 守卫,
309
+ // 但 mpu_armv7.h 是 ARM 原版,真实守卫是 ARM_MPU_ARMV7_H(V5.0.4 实测)——
310
+ // 上一版给五个头共用 [__CMSIS,__CORE_,__MPU_],mpu_armv7.h 一个都不命中,
311
+ // 网络全通、逐字节正确也会被判成"不是要的那个文件",整个寄存器模板下载必失败。
312
+ const coreHeaderMarkers = {
313
+ [spec.coreHeader]: ["__CORE_CM3_H", "__CMSIS"],
314
+ "cmsis_compiler.h": ["__CMSIS_COMPILER_H", "__CMSIS"],
315
+ "cmsis_gcc.h": ["__CMSIS_GCC_H", "__CMSIS"],
316
+ "cmsis_version.h": ["__CMSIS_VERSION", "__CMSIS"],
317
+ "mpu_armv7.h": ["ARM_MPU_ARMV7_H", "__MPU_"],
318
+ };
126
319
  for (const header of [spec.coreHeader, "cmsis_compiler.h", "cmsis_gcc.h", "cmsis_version.h", "mpu_armv7.h"]) {
127
320
  targets.push({
128
321
  path: "Drivers/CMSIS/Include/" + header,
129
322
  urls: sourceUrls(spec.cmsisRepo, spec.cmsisRef, spec.coreIncludeDir + "/" + header),
130
323
  minBytes: 500,
131
- markers: ["__CMSIS", "__CORE_", "__MPU_"],
324
+ markers: coreHeaderMarkers[header] ?? ["__CMSIS", "__CORE_"],
325
+ sha256: CORE_HEADER_SHA256[header],
132
326
  });
133
327
  }
134
328
  const license = "STMicroelectronics CMSIS device headers / startup / CMSIS core headers — Apache License 2.0."
135
329
  + "\n来源仓库:github.com/STMicroelectronics/" + spec.deviceRepo + "(" + spec.deviceRef + ")、"
136
330
  + "github.com/STMicroelectronics/" + spec.cmsisRepo + "(" + spec.cmsisRef + ")。"
137
331
  + "\n本目录是下载缓存,不是插件源码;删掉它不影响插件,下次用时会重新下载。\n";
138
- const stem = choice.startup.replace(/\.s$/u, "");
332
+ // 0.2:条目按 line+档位分(cmsis:F1:103xb),目录同名。没有 chip 的旧调用退化成 startup 文件名。
333
+ const groupKey = chip === null ? choice.startup.replace(/^startup_/u, "").replace(/\.s$/u, "") : cmsisGroupKey(chip);
139
334
  return {
140
335
  family: choice.family,
141
- id: "cmsis:" + choice.family + ":" + stem,
142
- dirName: choice.family + "/" + stem,
336
+ id: chip === null ? cmsisEntryId(choice.family, groupKey) : chipEntryId(chip),
337
+ dirName: choice.family + "/" + groupKey,
143
338
  choice,
144
339
  targets,
145
340
  license,
@@ -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
+ }