dsh-stm32 0.1.1 → 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.
- package/README.md +52 -23
- package/README_EN.md +50 -21
- package/docs/development-notes.md +466 -4
- package/docs/reading-guide.md +738 -0
- package/lib/commands/register.js +49 -0
- package/lib/data/chips.js +134 -4
- package/lib/data/clock-f1.js +158 -0
- package/lib/data/cmsis-sources.js +211 -42
- package/lib/data/f1-ram.generated.js +34 -0
- package/lib/data/stm32f1.js +186 -0
- package/lib/engine/build.js +115 -16
- package/lib/engine/cache.js +56 -0
- package/lib/engine/clock-plan.js +608 -0
- package/lib/engine/cmake-sources.js +428 -0
- package/lib/engine/debug.js +75 -10
- package/lib/engine/doctor.js +395 -4
- package/lib/engine/fetch.js +174 -30
- package/lib/engine/flash.js +95 -6
- package/lib/engine/generate.js +11 -0
- package/lib/engine/hal-chip.js +230 -0
- package/lib/engine/ioc-plan.js +28 -2
- package/lib/engine/msys2-install.js +332 -61
- package/lib/engine/project-export.js +129 -0
- package/lib/engine/register-clock.js +132 -0
- package/lib/engine/register-linker.js +129 -0
- package/lib/engine/register-template.js +88 -17
- package/lib/engine/scaffold.js +104 -28
- package/lib/engine/zip.js +142 -0
- package/lib/index.js +2 -0
- package/lib/skill/stm32-workflow.js +3 -3
- package/lib/tools/build.js +12 -0
- package/lib/tools/cache.js +39 -8
- package/lib/tools/debug.js +7 -0
- package/lib/tools/doctor.js +11 -2
- package/lib/tools/flash.js +3 -0
- package/lib/tools/ioc-plan.js +195 -4
- package/lib/tools/project-create.js +26 -1
- package/lib/tools/project-export.js +100 -0
- package/package.json +5 -3
- package/templates/register/CMakeLists.txt +19 -6
- package/templates/register/Core/Src/main.c +18 -9
- package/templates/scaffold/openocd.cfg +8 -0
|
@@ -6,7 +6,13 @@
|
|
|
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 { resolveF1Chip } from "./stm32f1.js";
|
|
10
16
|
const JS_DELIVR_FASTLY = (repo, ref, file) => "https://fastly.jsdelivr.net/gh/STMicroelectronics/" + repo + "@" + ref + "/" + file;
|
|
11
17
|
const JS_DELIVR_CDN = (repo, ref, file) => "https://cdn.jsdelivr.net/gh/STMicroelectronics/" + repo + "@" + ref + "/" + file;
|
|
12
18
|
const RAW_GITHUB = (repo, ref, file) => "https://raw.githubusercontent.com/STMicroelectronics/" + repo + "/" + ref + "/" + file;
|
|
@@ -34,58 +40,204 @@ export const CMSIS_FAMILIES = {
|
|
|
34
40
|
deviceDefinePrefix: "STM32F1",
|
|
35
41
|
},
|
|
36
42
|
};
|
|
43
|
+
/** line 代号:STM32F103 → F1。 */
|
|
44
|
+
export function familyOf(chip) {
|
|
45
|
+
return chip.prefix.slice(5, 7);
|
|
46
|
+
}
|
|
37
47
|
/**
|
|
38
|
-
*
|
|
48
|
+
* 缓存条目里的「档位键」= line + 容量档,例如 103xb。
|
|
39
49
|
*
|
|
40
|
-
*
|
|
41
|
-
*
|
|
42
|
-
*
|
|
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 的那套文件。
|
|
50
|
+
* 为什么不只用容量档(任务书写的是 <family>:<group>):同名档位在 F1 内部会撞车——
|
|
51
|
+
* F100 / F101 / F102 / F103 各有一套 startup_stm32f10xxb.s 设备头,只用 xb 会把
|
|
52
|
+
* 四份不同的文件当成同一份缓存。带上 line 之后每档唯一,且一眼看得出是哪一颗。
|
|
46
53
|
*/
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
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
|
+
}
|
|
55
106
|
/**
|
|
56
|
-
*
|
|
107
|
+
* 从型号(或容量档写法)推出启动文件与设备宏。
|
|
57
108
|
*
|
|
58
|
-
*
|
|
59
|
-
*
|
|
60
|
-
* 认不出就返回 null:宁可明说"这一代还没做",也不要编一个文件名让链接器报一堆奇怪错误。
|
|
109
|
+
* 0.2 起不再写死 F103:内部一律走 resolveF1Chip(F100/F101/F102/F103/F105/F107 × 各自档位)。
|
|
110
|
+
* 老签名与老写法("F1:B")保持可用。
|
|
61
111
|
*/
|
|
62
112
|
export function startupChoiceFor(mcu) {
|
|
63
|
-
const
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
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);
|
|
71
140
|
}
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
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));
|
|
80
158
|
}
|
|
81
|
-
|
|
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;
|
|
82
232
|
}
|
|
83
233
|
/**
|
|
84
234
|
* 组装一代/一档模板的下载计划:路径全部按 ST 固件包布局摆,
|
|
85
235
|
* 寄存器版工程直接 -I Drivers/CMSIS/Include -I Drivers/CMSIS/Device/ST/STM32F1xx/Include 就能编译,
|
|
86
236
|
* 与 HAL 工程共用同一套 include 约定。
|
|
87
237
|
*/
|
|
88
|
-
export function cmsisTemplatePlan(
|
|
238
|
+
export function cmsisTemplatePlan(input) {
|
|
239
|
+
const chip = chipOf(input);
|
|
240
|
+
const choice = "cpn" in input ? choiceFromChip(input) : { ...input, ...(chip === null ? {} : { chip }) };
|
|
89
241
|
const spec = CMSIS_FAMILIES[choice.family];
|
|
90
242
|
if (spec === undefined)
|
|
91
243
|
return null;
|
|
@@ -101,6 +253,7 @@ export function cmsisTemplatePlan(choice) {
|
|
|
101
253
|
urls: sourceUrls(spec.deviceRepo, spec.deviceRef, spec.deviceIncludeDir + "/" + header),
|
|
102
254
|
minBytes: 200,
|
|
103
255
|
markers: ["#ifndef __STM32", "#ifndef __SYSTEM_STM32"],
|
|
256
|
+
sha256: DEVICE_HEADER_SHA256[header],
|
|
104
257
|
});
|
|
105
258
|
}
|
|
106
259
|
targets.push({
|
|
@@ -108,6 +261,7 @@ export function cmsisTemplatePlan(choice) {
|
|
|
108
261
|
urls: sourceUrls(spec.deviceRepo, spec.deviceRef, spec.deviceIncludeDir + "/" + choice.deviceHeader),
|
|
109
262
|
minBytes: 10_000,
|
|
110
263
|
markers: ["#ifndef __STM32", "#ifndef __SYSTEM_STM32"],
|
|
264
|
+
sha256: DEVICE_HEADER_SHA256[choice.deviceHeader],
|
|
111
265
|
});
|
|
112
266
|
// 2) system_stm32f1xx.c 与启动文件
|
|
113
267
|
targets.push({
|
|
@@ -115,31 +269,46 @@ export function cmsisTemplatePlan(choice) {
|
|
|
115
269
|
urls: sourceUrls(spec.deviceRepo, spec.deviceRef, spec.deviceTemplatesDir + "/system_stm32f1xx.c"),
|
|
116
270
|
minBytes: 1_000,
|
|
117
271
|
markers: ["SystemInit"],
|
|
272
|
+
sha256: SYSTEM_C_SHA256,
|
|
118
273
|
});
|
|
119
274
|
targets.push({
|
|
120
275
|
path: deviceBase + "/Source/Templates/gcc/" + choice.startup,
|
|
121
276
|
urls: sourceUrls(spec.deviceRepo, spec.deviceRef, spec.deviceTemplatesDir + "/gcc/" + choice.startup),
|
|
122
277
|
minBytes: 1_000,
|
|
123
278
|
markers: ["_estack", ".syntax unified"],
|
|
279
|
+
sha256: STARTUP_SHA256[choice.startup],
|
|
124
280
|
});
|
|
125
|
-
// 3) CMSIS 内核头(ST
|
|
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
|
+
};
|
|
126
293
|
for (const header of [spec.coreHeader, "cmsis_compiler.h", "cmsis_gcc.h", "cmsis_version.h", "mpu_armv7.h"]) {
|
|
127
294
|
targets.push({
|
|
128
295
|
path: "Drivers/CMSIS/Include/" + header,
|
|
129
296
|
urls: sourceUrls(spec.cmsisRepo, spec.cmsisRef, spec.coreIncludeDir + "/" + header),
|
|
130
297
|
minBytes: 500,
|
|
131
|
-
markers: ["__CMSIS", "__CORE_"
|
|
298
|
+
markers: coreHeaderMarkers[header] ?? ["__CMSIS", "__CORE_"],
|
|
299
|
+
sha256: CORE_HEADER_SHA256[header],
|
|
132
300
|
});
|
|
133
301
|
}
|
|
134
302
|
const license = "STMicroelectronics CMSIS device headers / startup / CMSIS core headers — Apache License 2.0."
|
|
135
303
|
+ "\n来源仓库:github.com/STMicroelectronics/" + spec.deviceRepo + "(" + spec.deviceRef + ")、"
|
|
136
304
|
+ "github.com/STMicroelectronics/" + spec.cmsisRepo + "(" + spec.cmsisRef + ")。"
|
|
137
305
|
+ "\n本目录是下载缓存,不是插件源码;删掉它不影响插件,下次用时会重新下载。\n";
|
|
138
|
-
|
|
306
|
+
// 0.2:条目按 line+档位分(cmsis:F1:103xb),目录同名。没有 chip 的旧调用退化成 startup 文件名。
|
|
307
|
+
const groupKey = chip === null ? choice.startup.replace(/^startup_/u, "").replace(/\.s$/u, "") : cmsisGroupKey(chip);
|
|
139
308
|
return {
|
|
140
309
|
family: choice.family,
|
|
141
|
-
id:
|
|
142
|
-
dirName: choice.family + "/" +
|
|
310
|
+
id: chip === null ? cmsisEntryId(choice.family, groupKey) : chipEntryId(chip),
|
|
311
|
+
dirName: choice.family + "/" + groupKey,
|
|
143
312
|
choice,
|
|
144
313
|
targets,
|
|
145
314
|
license,
|
|
@@ -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
|
+
};
|
|
@@ -0,0 +1,186 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* L1:STM32F1 全系的芯片事实表(型号 → 容量档 / 启动文件 / 设备宏 / Flash / RAM)。
|
|
3
|
+
*
|
|
4
|
+
* 为什么单独一个文件:容量字母 → 上游启动文件的映射是事实,不是逻辑。
|
|
5
|
+
* 加一款芯片只改这里,不动引擎。
|
|
6
|
+
*
|
|
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. 本文件内置的容量字母表。
|
|
12
|
+
*
|
|
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 里说清楚,绝不猜。
|
|
45
|
+
*/
|
|
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
|
+
};
|
|
73
|
+
/**
|
|
74
|
+
* 型号 → 芯片事实。认不出返回 chip: null + 原因,绝不编一个不存在的启动文件。
|
|
75
|
+
*
|
|
76
|
+
* 支持三种输入:
|
|
77
|
+
* - 完整型号:STM32F103C8T6 / STM32F103RCT6 / STM32F107VCT6
|
|
78
|
+
* - 去掉温度后缀:STM32F103C8
|
|
79
|
+
* - 显式容量档:F103:xb(脚本与测试用)
|
|
80
|
+
*/
|
|
81
|
+
export function resolveF1Chip(input) {
|
|
82
|
+
const text = input.trim().toUpperCase();
|
|
83
|
+
if (text.length === 0)
|
|
84
|
+
return { chip: null, reason: "没有给型号" };
|
|
85
|
+
const loose = /^F(\d{2,3}):(X[0-9A-Z]{1,2})$/u.exec(text);
|
|
86
|
+
if (loose !== null) {
|
|
87
|
+
const code = loose[1] ?? "";
|
|
88
|
+
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);
|
|
93
|
+
}
|
|
94
|
+
const m = /^STM32F(\d{3})([A-Z])([0-9A-G])([A-Z])?([0-9])?$/u.exec(text);
|
|
95
|
+
if (m === null)
|
|
96
|
+
return { chip: null, reason: "不是 F1 的型号格式:" + input };
|
|
97
|
+
const code = m[1] ?? "";
|
|
98
|
+
const packageLetter = m[2] ?? "";
|
|
99
|
+
const densityLetter = m[3] ?? "";
|
|
100
|
+
const suffix = m[4] ?? "";
|
|
101
|
+
const extra = m[5] ?? "";
|
|
102
|
+
if (suffix.length > 0 && !"TXUYK".includes(suffix)) {
|
|
103
|
+
return { chip: null, reason: "认不出封装后缀 " + suffix + "(期望 T/U/Y 之一):" + input };
|
|
104
|
+
}
|
|
105
|
+
if (extra.length > 0 && !"67".includes(extra)) {
|
|
106
|
+
return { chip: null, reason: "认不出温度档 " + extra + "(期望 6 或 7):" + input };
|
|
107
|
+
}
|
|
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
|
+
};
|
|
121
|
+
}
|
|
122
|
+
return fromGroup(line, group, text, packageLetter, densityLetter);
|
|
123
|
+
}
|
|
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)
|
|
134
|
+
return null;
|
|
135
|
+
return line.groups.includes(fallback) ? fallback : null;
|
|
136
|
+
}
|
|
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
|
+
}
|
|
161
|
+
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: "",
|
|
176
|
+
};
|
|
177
|
+
}
|
|
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 的全部容量档(给「这个型号能选哪些档」的报告用)。 */
|
|
183
|
+
export function f1GroupsFor(code) {
|
|
184
|
+
const line = F1_LINES.find((item) => item.code === code);
|
|
185
|
+
return line === undefined ? [] : line.groups;
|
|
186
|
+
}
|