dsh-stm32 0.1.0 → 0.1.2

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