dsh-stm32 0.1.2 → 0.1.4
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 +92 -40
- package/README_EN.md +85 -36
- package/assets/README.md +85 -0
- package/assets/VERSION +1 -0
- package/assets/device/c0/chips.json +1108 -0
- package/assets/device/f0/chips.json +1570 -0
- package/assets/device/f1/chips.json +1238 -0
- package/assets/device/f1/svd/100.json +943 -0
- package/assets/device/f1/svd/101.json +901 -0
- package/assets/device/f1/svd/102.json +522 -0
- package/assets/device/f1/svd/103.json +1139 -0
- package/assets/device/f1/svd/105.json +1117 -0
- package/assets/device/f1/svd/107.json +1195 -0
- package/assets/device/f2/chips.json +674 -0
- package/assets/device/f3/chips.json +1318 -0
- package/assets/device/f4/chips.json +2942 -0
- package/assets/device/f7/chips.json +1710 -0
- package/assets/device/g0/chips.json +2102 -0
- package/assets/device/g4/chips.json +2494 -0
- package/assets/device/h5/chips.json +898 -0
- package/assets/device/h7/chips.json +1948 -0
- package/assets/device/l0/chips.json +2494 -0
- package/assets/device/l1/chips.json +1234 -0
- package/assets/device/l4/chips.json +2130 -0
- package/assets/device/l4+/chips.json +856 -0
- package/assets/device/l5/chips.json +226 -0
- package/assets/device/u0/chips.json +688 -0
- package/assets/device/u3/chips.json +310 -0
- package/assets/device/u5/chips.json +884 -0
- package/assets/device/wba/chips.json +506 -0
- package/assets/device/wl/chips.json +184 -0
- package/assets/headers/f1/stm32f100xb.h +5972 -0
- package/assets/headers/f1/stm32f100xe.h +6587 -0
- package/assets/headers/f1/stm32f101x6.h +5315 -0
- package/assets/headers/f1/stm32f101xb.h +5446 -0
- package/assets/headers/f1/stm32f101xe.h +6503 -0
- package/assets/headers/f1/stm32f101xg.h +6713 -0
- package/assets/headers/f1/stm32f102x6.h +6448 -0
- package/assets/headers/f1/stm32f102xb.h +6570 -0
- package/assets/headers/f1/stm32f103x6.h +10109 -0
- package/assets/headers/f1/stm32f103xb.h +10240 -0
- package/assets/headers/f1/stm32f103xe.h +11767 -0
- package/assets/headers/f1/stm32f103xg.h +11951 -0
- package/assets/headers/f1/stm32f105xc.h +14340 -0
- package/assets/headers/f1/stm32f107xc.h +15253 -0
- package/assets/headers/f1/stm32f1xx.h +273 -0
- package/assets/headers/f1/system_stm32f1xx.h +96 -0
- package/assets/ioc/family/C0.ioc +82 -0
- package/assets/ioc/family/F0.ioc +71 -0
- package/assets/ioc/family/F2.ioc +91 -0
- package/assets/ioc/family/F3.ioc +94 -0
- package/assets/ioc/family/F4.ioc +91 -0
- package/assets/ioc/family/F7.ioc +102 -0
- package/assets/ioc/family/G0.ioc +90 -0
- package/assets/ioc/family/G4.ioc +110 -0
- package/assets/ioc/family/H5.ioc +116 -0
- package/assets/ioc/family/H7.ioc +133 -0
- package/assets/ioc/family/L0.ioc +92 -0
- package/assets/ioc/family/L1.ioc +87 -0
- package/assets/ioc/family/L4+.ioc +92 -0
- package/assets/ioc/family/L4.ioc +93 -0
- package/assets/ioc/family/L5.ioc +91 -0
- package/assets/ioc/family/U0.ioc +103 -0
- package/assets/ioc/family/U3.ioc +113 -0
- package/assets/ioc/family/U5.ioc +102 -0
- package/assets/ioc/family/WBA.ioc +100 -0
- package/assets/ioc/family/WL.ioc +93 -0
- package/assets/ioc/minimal/STM32F100C8Tx.ioc +113 -0
- package/assets/ioc/minimal/STM32F100RCTx.ioc +113 -0
- package/assets/ioc/minimal/STM32F101C4Tx.ioc +113 -0
- package/assets/ioc/minimal/STM32F101C8Tx.ioc +113 -0
- package/assets/ioc/minimal/STM32F101RCTx.ioc +113 -0
- package/assets/ioc/minimal/STM32F101RFTx.ioc +113 -0
- package/assets/ioc/minimal/STM32F102C4Tx.ioc +113 -0
- package/assets/ioc/minimal/STM32F102C8Tx.ioc +113 -0
- package/assets/ioc/minimal/STM32F103C4Tx.ioc +113 -0
- package/assets/ioc/minimal/STM32F103C8Tx.ioc +113 -0
- package/assets/ioc/minimal/STM32F103RCTx.ioc +113 -0
- package/assets/ioc/minimal/STM32F103RFTx.ioc +113 -0
- package/assets/ioc/minimal/STM32F105RCTx.ioc +113 -0
- package/assets/ioc/minimal/STM32F107RCTx.ioc +113 -0
- package/assets/ld/f1/STM32F100C8Tx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F100RCTx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F101C4Tx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F101C8Tx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F101RCTx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F101RFTx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F102C4Tx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F102C8Tx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F103C4Tx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F103C8Tx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F103RCTx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F103RFTx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F105RCTx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F107RCTx_FLASH.ld +249 -0
- package/assets/manifest.json +1130 -0
- package/assets/startup/f1/startup_stm32f100xb.s +407 -0
- package/assets/startup/f1/startup_stm32f100xe.s +449 -0
- package/assets/startup/f1/startup_stm32f101x6.s +322 -0
- package/assets/startup/f1/startup_stm32f101xb.s +338 -0
- package/assets/startup/f1/startup_stm32f101xe.s +423 -0
- package/assets/startup/f1/startup_stm32f101xg.s +439 -0
- package/assets/startup/f1/startup_stm32f102x6.s +330 -0
- package/assets/startup/f1/startup_stm32f102xb.s +346 -0
- package/assets/startup/f1/startup_stm32f103x6.s +348 -0
- package/assets/startup/f1/startup_stm32f103xb.s +364 -0
- package/assets/startup/f1/startup_stm32f103xe.s +470 -0
- package/assets/startup/f1/startup_stm32f103xg.s +466 -0
- package/assets/startup/f1/startup_stm32f105xc.s +463 -0
- package/assets/startup/f1/startup_stm32f107xc.s +472 -0
- package/assets/templates/family/C0.ioc +82 -0
- package/assets/templates/family/F0.ioc +71 -0
- package/assets/templates/family/F2.ioc +91 -0
- package/assets/templates/family/F3.ioc +94 -0
- package/assets/templates/family/F4.ioc +91 -0
- package/assets/templates/family/F7.ioc +102 -0
- package/assets/templates/family/G0.ioc +90 -0
- package/assets/templates/family/G4.ioc +110 -0
- package/assets/templates/family/H5.ioc +116 -0
- package/assets/templates/family/H7.ioc +133 -0
- package/assets/templates/family/L0.ioc +92 -0
- package/assets/templates/family/L1.ioc +87 -0
- package/assets/templates/family/L4+.ioc +92 -0
- package/assets/templates/family/L4.ioc +93 -0
- package/assets/templates/family/L5.ioc +91 -0
- package/assets/templates/family/U0.ioc +103 -0
- package/assets/templates/family/U3.ioc +113 -0
- package/assets/templates/family/U5.ioc +102 -0
- package/assets/templates/family/WB.ioc +81 -0
- package/assets/templates/family/WBA.ioc +100 -0
- package/assets/templates/family/WL.ioc +93 -0
- package/docs/reading-guide.md +94 -71
- package/lib/data/chips.js +38 -51
- package/lib/data/clock-db.js +830 -0
- package/lib/data/clock-f1.js +12 -45
- package/lib/data/cmsis-sources.js +264 -17
- package/lib/data/db-presets.js +252 -0
- package/lib/data/device-facts.js +274 -0
- package/lib/data/family.js +515 -0
- package/lib/data/firmware-packages.js +562 -0
- package/lib/data/install-guides.js +2 -2
- package/lib/data/ioc-presets.js +248 -0
- package/lib/data/ioc-schema.js +1058 -0
- package/lib/data/rm-topics/stm32c0.json +227 -0
- package/lib/data/rm-topics.js +103 -0
- package/lib/data/search-roots.js +42 -1
- package/lib/data/stm32f1.js +95 -150
- package/lib/data/svd.js +643 -0
- package/lib/data/toolchain-config.js +0 -14
- package/lib/engine/assets.js +659 -0
- package/lib/engine/breakpoints.js +297 -0
- package/lib/engine/clock-derived.js +101 -0
- package/lib/engine/clock-direct.js +313 -0
- package/lib/engine/clock-plan.js +96 -52
- package/lib/engine/clock-pllmn.js +319 -0
- package/lib/engine/cmake-sources.js +67 -13
- package/lib/engine/cube-mx-guard.js +44 -0
- package/lib/engine/cube-programmer.js +137 -0
- package/lib/engine/cubemx-db.js +273 -0
- package/lib/engine/debug-session.js +576 -22
- package/lib/engine/debug.js +99 -46
- package/lib/engine/doctor.js +162 -19
- package/lib/engine/facts-acquire.js +416 -0
- package/lib/engine/facts.js +134 -0
- package/lib/engine/firmware-install.js +176 -5
- package/lib/engine/firmware-official.js +451 -0
- package/lib/engine/flash.js +317 -76
- package/lib/engine/gdb-mi.js +476 -0
- package/lib/engine/generate.js +9 -2
- package/lib/engine/hal-chip.js +124 -41
- package/lib/engine/ioc-plan.js +1247 -63
- package/lib/engine/ioc-rules.js +698 -0
- package/lib/engine/ioc-verify.js +706 -0
- package/lib/engine/ioc.js +43 -4
- package/lib/engine/msys2-install.js +4 -4
- package/lib/engine/probe-error.js +231 -0
- package/lib/engine/probe-session.js +347 -0
- package/lib/engine/probe.js +18 -3
- package/lib/engine/register-clock.js +41 -0
- package/lib/engine/register-gpio.js +115 -0
- package/lib/engine/register-linker.js +12 -7
- package/lib/engine/register-template.js +130 -45
- package/lib/engine/regs.js +43 -8
- package/lib/engine/rm-extract.js +144 -0
- package/lib/engine/rm-sources.js +360 -0
- package/lib/engine/rm-text.js +56 -0
- package/lib/engine/rtt.js +758 -0
- package/lib/engine/scaffold.js +185 -18
- package/lib/engine/toolchain-gate.js +0 -4
- package/lib/engine/watch.js +227 -0
- package/lib/index.js +12 -2
- package/lib/skill/stm32-workflow.js +2 -2
- package/lib/tools/assets.js +272 -0
- package/lib/tools/cache.js +8 -0
- package/lib/tools/debug-session.js +41 -6
- package/lib/tools/debug.js +41 -11
- package/lib/tools/doctor.js +65 -4
- package/lib/tools/firmware-install.js +31 -6
- package/lib/tools/flash.js +47 -10
- package/lib/tools/generate.js +25 -0
- package/lib/tools/ioc-apply.js +2 -0
- package/lib/tools/ioc-inspect.js +2 -0
- package/lib/tools/ioc-plan.js +59 -2
- package/lib/tools/ioc-verify.js +237 -0
- package/lib/tools/project-create.js +63 -3
- package/lib/tools/regs.js +453 -61
- package/lib/tools/route-plan.js +3 -0
- package/lib/tools/rtt.js +470 -0
- package/lib/tools/watch.js +256 -0
- package/package.json +5 -4
- package/templates/openocd/stm32c0x.cfg +83 -0
- package/templates/openocd/stm32u0x.cfg +64 -0
- package/templates/register/CMakeLists.txt +8 -2
- package/templates/register/Core/Inc/rtt.h +138 -0
- package/templates/register/Core/Src/main.c +42 -25
- package/templates/register/Core/Src/rtt.c +373 -0
- package/templates/scaffold/RTT.md +90 -0
- package/templates/scaffold/STM32F103XX_FLASH.ld +3 -0
- package/templates/scaffold/cmake/user/CMakeLists.txt +7 -0
- package/templates/scaffold/openocd.cfg +5 -3
- package/templates/scaffold/vscode/launch.json +8 -4
- package/docs/development-notes.md +0 -2116
- package/docs/dsh-stm32-plugin-/350/247/204/346/240/274.md +0 -673
- package/docs/logic-audit.md +0 -607
- package/lib/data/f1-ram.generated.js +0 -34
package/lib/data/clock-f1.js
CHANGED
|
@@ -34,8 +34,8 @@ export const F1_PLL_SOURCES = [
|
|
|
34
34
|
note: "F1 值料号的 PLLSRC 只有 HSE / HSI÷2 两档;HSI 直接进 PLL 是互联型(105/107)经 PREDIV1 才有的路,本插件不规划。",
|
|
35
35
|
},
|
|
36
36
|
];
|
|
37
|
-
export function pllSourceById(id) {
|
|
38
|
-
return
|
|
37
|
+
export function pllSourceById(id, sources = F1_PLL_SOURCES) {
|
|
38
|
+
return sources.find((source) => source.id === id) ?? null;
|
|
39
39
|
}
|
|
40
40
|
export const F1_PLL_MULS = Array.from({ length: 15 }, (_unused, index) => {
|
|
41
41
|
const mul = index + 2;
|
|
@@ -44,14 +44,6 @@ export const F1_PLL_MULS = Array.from({ length: 15 }, (_unused, index) => {
|
|
|
44
44
|
export function pllMulValue(mul) {
|
|
45
45
|
return "RCC_PLL_MUL" + String(mul);
|
|
46
46
|
}
|
|
47
|
-
/** 从 RCC.PLLMUL 的值(RCC_PLL_MUL9)反解倍频;认不出来返回 null。 */
|
|
48
|
-
export function pllMulFromValue(value) {
|
|
49
|
-
const matched = /^RCC_PLL_MUL(\d{1,2})$/u.exec(value.trim());
|
|
50
|
-
if (matched === null)
|
|
51
|
-
return null;
|
|
52
|
-
const mul = Number.parseInt(matched[1], 10);
|
|
53
|
-
return Number.isFinite(mul) && mul >= 2 && mul <= 16 ? mul : null;
|
|
54
|
-
}
|
|
55
47
|
/** AHB / APB1 / APB2 分频:÷1、2、4、8、16(RM0008 RCC_CFGR.HPRE/PPRE1/PPRE2)。 */
|
|
56
48
|
export const F1_APB_DIVS = [1, 2, 4, 8, 16].map((div) => ({
|
|
57
49
|
div,
|
|
@@ -97,14 +89,6 @@ export const F1_CLOCK_LIMITS = {
|
|
|
97
89
|
adcHz: 14_000_000,
|
|
98
90
|
usbHz: 48_000_000,
|
|
99
91
|
};
|
|
100
|
-
/** 上限的人读标签,报告里拼错误消息用。 */
|
|
101
|
-
export const F1_CLOCK_LIMIT_LABELS = {
|
|
102
|
-
sysclkHz: "SYSCLK",
|
|
103
|
-
apb1Hz: "APB1",
|
|
104
|
-
apb2Hz: "APB2",
|
|
105
|
-
adcHz: "ADC",
|
|
106
|
-
usbHz: "USB",
|
|
107
|
-
};
|
|
108
92
|
/**
|
|
109
93
|
* 外设 → 总线(RM0008 的 memory map 与 RCC 使能寄存器分组):
|
|
110
94
|
* APB2 = USART1 / SPI1 / ADC1-3 / TIM1 / TIM8 / GPIO / AFIO;
|
|
@@ -129,30 +113,13 @@ export const F1_PERIPHERAL_CLOCKS = [
|
|
|
129
113
|
];
|
|
130
114
|
/** UART 波特率整除误差默认算这几档(F1 值料号常用档)。 */
|
|
131
115
|
export const F1_BAUD_LIST = [9600, 19200, 38400, 57600, 115200, 230400];
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
"APB1TimFreq_Value",
|
|
143
|
-
"APB2Freq_Value",
|
|
144
|
-
"APB2TimFreq_Value",
|
|
145
|
-
"FCLKCortexFreq_Value",
|
|
146
|
-
"FamilyName",
|
|
147
|
-
"HCLKFreq_Value",
|
|
148
|
-
"MCOFreq_Value",
|
|
149
|
-
"PLLCLKFreq_Value",
|
|
150
|
-
"PLLMCOFreq_Value",
|
|
151
|
-
"PLLMUL",
|
|
152
|
-
"PLLSourceVirtual",
|
|
153
|
-
"SYSCLKFreq_VALUE",
|
|
154
|
-
"SYSCLKSource",
|
|
155
|
-
"TimSysFreq_Value",
|
|
156
|
-
"USBFreq_Value",
|
|
157
|
-
"VCOOutput2Freq_Value",
|
|
158
|
-
];
|
|
116
|
+
export const F1_FACTS = {
|
|
117
|
+
muls: F1_PLL_MULS,
|
|
118
|
+
sources: F1_PLL_SOURCES,
|
|
119
|
+
apbDivs: F1_APB_DIVS,
|
|
120
|
+
adcDivs: F1_ADC_DIVS,
|
|
121
|
+
limits: F1_CLOCK_LIMITS,
|
|
122
|
+
usb: F1_USB_PRESCALER,
|
|
123
|
+
peripheralClocks: F1_PERIPHERAL_CLOCKS,
|
|
124
|
+
baudList: F1_BAUD_LIST,
|
|
125
|
+
};
|
|
@@ -12,6 +12,8 @@
|
|
|
12
12
|
* 1) 把 F1Chip 翻译成下载清单(路径 + markers + 实测 sha256);
|
|
13
13
|
* 2) 把用户给的各种写法(型号 / F1:B / F1:103xb / 0.1 的老缓存 id)解析成同一个缓存条目。
|
|
14
14
|
*/
|
|
15
|
+
import { findChipFact, loadDeviceFacts } from "./device-facts.js";
|
|
16
|
+
import { familyIdOfPart } from "./family.js";
|
|
15
17
|
import { resolveF1Chip } from "./stm32f1.js";
|
|
16
18
|
const JS_DELIVR_FASTLY = (repo, ref, file) => "https://fastly.jsdelivr.net/gh/STMicroelectronics/" + repo + "@" + ref + "/" + file;
|
|
17
19
|
const JS_DELIVR_CDN = (repo, ref, file) => "https://cdn.jsdelivr.net/gh/STMicroelectronics/" + repo + "@" + ref + "/" + file;
|
|
@@ -22,8 +24,18 @@ export function sourceUrls(repo, ref, file) {
|
|
|
22
24
|
return [JS_DELIVR_FASTLY(repo, ref, file), JS_DELIVR_CDN(repo, ref, file), RAW_GITHUB(repo, ref, file), GHPROXY(repo, ref, file)];
|
|
23
25
|
}
|
|
24
26
|
/**
|
|
25
|
-
*
|
|
26
|
-
*
|
|
27
|
+
* 寄存器件模板支持的 13 个族。
|
|
28
|
+
*
|
|
29
|
+
* 为什么是这 13 个:内置资源 device/<族>/chips.json 已经收了这 13 族的芯片事实
|
|
30
|
+
* (启动文件名 / 设备宏 / 设备头 / Flash / RAM 都在里面),寄存器路线需要的事实刚好齐了。
|
|
31
|
+
* 其它族(H5/U3/U5/L5/WB/WBA/WL/H7/L4+)等内置资源补了 chips.json 再按同样字段加一条即可。
|
|
32
|
+
*
|
|
33
|
+
* 内核头沿用 F1 的口径:从 ST 的 STM32Cube<族> 主仓库取(ST 在主仓里 vendor 了 CMSIS,
|
|
34
|
+
* 不是子模块;2026-11-08 实测 F4/G0 的 Drivers/CMSIS/Include 都是 200)。
|
|
35
|
+
*
|
|
36
|
+
* 哈希钉:只有 F1 那张表(DEVICE_HEADER_SHA256 / STARTUP_SHA256 / CORE_HEADER_SHA256)
|
|
37
|
+
* 是逐文件实测的;其它族只锁形状(minBytes + markers),真实哈希在下载时登记进缓存索引。
|
|
38
|
+
* 这与 SVD 的处理同口径:上游同族文件会随版本漂移,锁死哈希会让"上游发新版"变成插件故障。
|
|
27
39
|
*/
|
|
28
40
|
export const CMSIS_FAMILIES = {
|
|
29
41
|
F1: {
|
|
@@ -38,6 +50,183 @@ export const CMSIS_FAMILIES = {
|
|
|
38
50
|
coreHeader: "core_cm3.h",
|
|
39
51
|
deviceHeaders: ["stm32f1xx.h", "system_stm32f1xx.h"],
|
|
40
52
|
deviceDefinePrefix: "STM32F1",
|
|
53
|
+
systemC: "system_stm32f1xx.c",
|
|
54
|
+
mpuHeader: "mpu_armv7.h",
|
|
55
|
+
},
|
|
56
|
+
C0: {
|
|
57
|
+
family: "C0",
|
|
58
|
+
deviceRepo: "cmsis-device-c0",
|
|
59
|
+
deviceRef: "master",
|
|
60
|
+
deviceIncludeDir: "Include",
|
|
61
|
+
deviceTemplatesDir: "Source/Templates",
|
|
62
|
+
cmsisRepo: "STM32CubeC0",
|
|
63
|
+
cmsisRef: "master",
|
|
64
|
+
coreIncludeDir: "Drivers/CMSIS/Include",
|
|
65
|
+
coreHeader: "core_cm0plus.h",
|
|
66
|
+
deviceHeaders: ["stm32c0xx.h", "system_stm32c0xx.h"],
|
|
67
|
+
deviceDefinePrefix: "STM32C0",
|
|
68
|
+
systemC: "system_stm32c0xx.c",
|
|
69
|
+
},
|
|
70
|
+
F0: {
|
|
71
|
+
family: "F0",
|
|
72
|
+
deviceRepo: "cmsis-device-f0",
|
|
73
|
+
deviceRef: "master",
|
|
74
|
+
deviceIncludeDir: "Include",
|
|
75
|
+
deviceTemplatesDir: "Source/Templates",
|
|
76
|
+
cmsisRepo: "STM32CubeF0",
|
|
77
|
+
cmsisRef: "master",
|
|
78
|
+
coreIncludeDir: "Drivers/CMSIS/Include",
|
|
79
|
+
coreHeader: "core_cm0.h",
|
|
80
|
+
deviceHeaders: ["stm32f0xx.h", "system_stm32f0xx.h"],
|
|
81
|
+
deviceDefinePrefix: "STM32F0",
|
|
82
|
+
systemC: "system_stm32f0xx.c",
|
|
83
|
+
},
|
|
84
|
+
F2: {
|
|
85
|
+
family: "F2",
|
|
86
|
+
deviceRepo: "cmsis-device-f2",
|
|
87
|
+
deviceRef: "master",
|
|
88
|
+
deviceIncludeDir: "Include",
|
|
89
|
+
deviceTemplatesDir: "Source/Templates",
|
|
90
|
+
cmsisRepo: "STM32CubeF2",
|
|
91
|
+
cmsisRef: "master",
|
|
92
|
+
coreIncludeDir: "Drivers/CMSIS/Include",
|
|
93
|
+
coreHeader: "core_cm3.h",
|
|
94
|
+
deviceHeaders: ["stm32f2xx.h", "system_stm32f2xx.h"],
|
|
95
|
+
deviceDefinePrefix: "STM32F2",
|
|
96
|
+
systemC: "system_stm32f2xx.c",
|
|
97
|
+
mpuHeader: "mpu_armv7.h",
|
|
98
|
+
},
|
|
99
|
+
F3: {
|
|
100
|
+
family: "F3",
|
|
101
|
+
deviceRepo: "cmsis-device-f3",
|
|
102
|
+
deviceRef: "master",
|
|
103
|
+
deviceIncludeDir: "Include",
|
|
104
|
+
deviceTemplatesDir: "Source/Templates",
|
|
105
|
+
cmsisRepo: "STM32CubeF3",
|
|
106
|
+
cmsisRef: "master",
|
|
107
|
+
coreIncludeDir: "Drivers/CMSIS/Include",
|
|
108
|
+
coreHeader: "core_cm4.h",
|
|
109
|
+
deviceHeaders: ["stm32f3xx.h", "system_stm32f3xx.h"],
|
|
110
|
+
deviceDefinePrefix: "STM32F3",
|
|
111
|
+
systemC: "system_stm32f3xx.c",
|
|
112
|
+
mpuHeader: "mpu_armv7.h",
|
|
113
|
+
},
|
|
114
|
+
F4: {
|
|
115
|
+
family: "F4",
|
|
116
|
+
deviceRepo: "cmsis-device-f4",
|
|
117
|
+
deviceRef: "master",
|
|
118
|
+
deviceIncludeDir: "Include",
|
|
119
|
+
deviceTemplatesDir: "Source/Templates",
|
|
120
|
+
cmsisRepo: "STM32CubeF4",
|
|
121
|
+
cmsisRef: "master",
|
|
122
|
+
coreIncludeDir: "Drivers/CMSIS/Include",
|
|
123
|
+
coreHeader: "core_cm4.h",
|
|
124
|
+
deviceHeaders: ["stm32f4xx.h", "system_stm32f4xx.h"],
|
|
125
|
+
deviceDefinePrefix: "STM32F4",
|
|
126
|
+
systemC: "system_stm32f4xx.c",
|
|
127
|
+
mpuHeader: "mpu_armv7.h",
|
|
128
|
+
},
|
|
129
|
+
F7: {
|
|
130
|
+
family: "F7",
|
|
131
|
+
deviceRepo: "cmsis-device-f7",
|
|
132
|
+
deviceRef: "master",
|
|
133
|
+
deviceIncludeDir: "Include",
|
|
134
|
+
deviceTemplatesDir: "Source/Templates",
|
|
135
|
+
cmsisRepo: "STM32CubeF7",
|
|
136
|
+
cmsisRef: "master",
|
|
137
|
+
coreIncludeDir: "Drivers/CMSIS/Include",
|
|
138
|
+
coreHeader: "core_cm7.h",
|
|
139
|
+
deviceHeaders: ["stm32f7xx.h", "system_stm32f7xx.h"],
|
|
140
|
+
deviceDefinePrefix: "STM32F7",
|
|
141
|
+
systemC: "system_stm32f7xx.c",
|
|
142
|
+
mpuHeader: "mpu_armv7.h",
|
|
143
|
+
},
|
|
144
|
+
G0: {
|
|
145
|
+
family: "G0",
|
|
146
|
+
deviceRepo: "cmsis-device-g0",
|
|
147
|
+
deviceRef: "master",
|
|
148
|
+
deviceIncludeDir: "Include",
|
|
149
|
+
deviceTemplatesDir: "Source/Templates",
|
|
150
|
+
cmsisRepo: "STM32CubeG0",
|
|
151
|
+
cmsisRef: "master",
|
|
152
|
+
coreIncludeDir: "Drivers/CMSIS/Include",
|
|
153
|
+
coreHeader: "core_cm0plus.h",
|
|
154
|
+
deviceHeaders: ["stm32g0xx.h", "system_stm32g0xx.h"],
|
|
155
|
+
deviceDefinePrefix: "STM32G0",
|
|
156
|
+
systemC: "system_stm32g0xx.c",
|
|
157
|
+
},
|
|
158
|
+
G4: {
|
|
159
|
+
family: "G4",
|
|
160
|
+
deviceRepo: "cmsis-device-g4",
|
|
161
|
+
deviceRef: "master",
|
|
162
|
+
deviceIncludeDir: "Include",
|
|
163
|
+
deviceTemplatesDir: "Source/Templates",
|
|
164
|
+
cmsisRepo: "STM32CubeG4",
|
|
165
|
+
cmsisRef: "master",
|
|
166
|
+
coreIncludeDir: "Drivers/CMSIS/Include",
|
|
167
|
+
coreHeader: "core_cm4.h",
|
|
168
|
+
deviceHeaders: ["stm32g4xx.h", "system_stm32g4xx.h"],
|
|
169
|
+
deviceDefinePrefix: "STM32G4",
|
|
170
|
+
systemC: "system_stm32g4xx.c",
|
|
171
|
+
mpuHeader: "mpu_armv7.h",
|
|
172
|
+
},
|
|
173
|
+
L0: {
|
|
174
|
+
family: "L0",
|
|
175
|
+
deviceRepo: "cmsis-device-l0",
|
|
176
|
+
deviceRef: "master",
|
|
177
|
+
deviceIncludeDir: "Include",
|
|
178
|
+
deviceTemplatesDir: "Source/Templates",
|
|
179
|
+
cmsisRepo: "STM32CubeL0",
|
|
180
|
+
cmsisRef: "master",
|
|
181
|
+
coreIncludeDir: "Drivers/CMSIS/Include",
|
|
182
|
+
coreHeader: "core_cm0plus.h",
|
|
183
|
+
deviceHeaders: ["stm32l0xx.h", "system_stm32l0xx.h"],
|
|
184
|
+
deviceDefinePrefix: "STM32L0",
|
|
185
|
+
systemC: "system_stm32l0xx.c",
|
|
186
|
+
},
|
|
187
|
+
L1: {
|
|
188
|
+
family: "L1",
|
|
189
|
+
deviceRepo: "cmsis-device-l1",
|
|
190
|
+
deviceRef: "master",
|
|
191
|
+
deviceIncludeDir: "Include",
|
|
192
|
+
deviceTemplatesDir: "Source/Templates",
|
|
193
|
+
cmsisRepo: "STM32CubeL1",
|
|
194
|
+
cmsisRef: "master",
|
|
195
|
+
coreIncludeDir: "Drivers/CMSIS/Include",
|
|
196
|
+
coreHeader: "core_cm3.h",
|
|
197
|
+
deviceHeaders: ["stm32l1xx.h", "system_stm32l1xx.h"],
|
|
198
|
+
deviceDefinePrefix: "STM32L1",
|
|
199
|
+
systemC: "system_stm32l1xx.c",
|
|
200
|
+
mpuHeader: "mpu_armv7.h",
|
|
201
|
+
},
|
|
202
|
+
L4: {
|
|
203
|
+
family: "L4",
|
|
204
|
+
deviceRepo: "cmsis-device-l4",
|
|
205
|
+
deviceRef: "master",
|
|
206
|
+
deviceIncludeDir: "Include",
|
|
207
|
+
deviceTemplatesDir: "Source/Templates",
|
|
208
|
+
cmsisRepo: "STM32CubeL4",
|
|
209
|
+
cmsisRef: "master",
|
|
210
|
+
coreIncludeDir: "Drivers/CMSIS/Include",
|
|
211
|
+
coreHeader: "core_cm4.h",
|
|
212
|
+
deviceHeaders: ["stm32l4xx.h", "system_stm32l4xx.h"],
|
|
213
|
+
deviceDefinePrefix: "STM32L4",
|
|
214
|
+
systemC: "system_stm32l4xx.c",
|
|
215
|
+
mpuHeader: "mpu_armv7.h",
|
|
216
|
+
},
|
|
217
|
+
U0: {
|
|
218
|
+
family: "U0",
|
|
219
|
+
deviceRepo: "cmsis-device-u0",
|
|
220
|
+
deviceRef: "master",
|
|
221
|
+
deviceIncludeDir: "Include",
|
|
222
|
+
deviceTemplatesDir: "Source/Templates",
|
|
223
|
+
cmsisRepo: "STM32CubeU0",
|
|
224
|
+
cmsisRef: "master",
|
|
225
|
+
coreIncludeDir: "Drivers/CMSIS/Include",
|
|
226
|
+
coreHeader: "core_cm0plus.h",
|
|
227
|
+
deviceHeaders: ["stm32u0xx.h", "system_stm32u0xx.h"],
|
|
228
|
+
deviceDefinePrefix: "STM32U0",
|
|
229
|
+
systemC: "system_stm32u0xx.c",
|
|
41
230
|
},
|
|
42
231
|
};
|
|
43
232
|
/** line 代号:STM32F103 → F1。 */
|
|
@@ -71,6 +260,31 @@ function choiceFromChip(chip) {
|
|
|
71
260
|
chip,
|
|
72
261
|
};
|
|
73
262
|
}
|
|
263
|
+
/**
|
|
264
|
+
* 只给容量字母(F1:B / F1:8)时,从设备事实里挑一颗同档芯片当代表:
|
|
265
|
+
* 优先 F103(档位最全,0.1 的 "F1:B" 正是按 F103 解释的),再按 line / CPN 升序。
|
|
266
|
+
*
|
|
267
|
+
* 以前这里靠手写的「容量字母 → 档位」常量表(随 chip-table.json 2026-10-31 一起删了)。
|
|
268
|
+
* 现在这条事实也只从内置资源读:缺文件就返回 null,上层会明说先确认安装完整(stm32_assets verify),
|
|
269
|
+
* 不会编一个可能不存在的启动文件名。
|
|
270
|
+
*/
|
|
271
|
+
function chipForDensityLetter(letter) {
|
|
272
|
+
const wanted = letter.trim().toUpperCase();
|
|
273
|
+
const facts = loadDeviceFacts();
|
|
274
|
+
if (!facts.ok)
|
|
275
|
+
return null;
|
|
276
|
+
const candidates = facts.chips.filter((chip) => /^STM32F\d{3}[A-Z]([0-9A-G])/u.exec(chip.cpn)?.[1] === wanted);
|
|
277
|
+
if (candidates.length === 0)
|
|
278
|
+
return null;
|
|
279
|
+
const ordered = [...candidates].sort((a, b) => {
|
|
280
|
+
const byLine = Number(a.line) - Number(b.line);
|
|
281
|
+
if (byLine !== 0)
|
|
282
|
+
return byLine;
|
|
283
|
+
return a.cpn < b.cpn ? -1 : a.cpn > b.cpn ? 1 : 0;
|
|
284
|
+
});
|
|
285
|
+
const preferred = ordered.find((chip) => chip.line === "103") ?? ordered[0];
|
|
286
|
+
return preferred === undefined ? null : resolveF1Chip(preferred.cpn).chip;
|
|
287
|
+
}
|
|
74
288
|
/**
|
|
75
289
|
* 只给容量档(F1:B / F1:8 / F1:xb)时,用 F103 当代表:F103 的档位最全
|
|
76
290
|
* (x6/xb/xe/xg),0.1 的 "F1:B" 也正是按 F103 解释的,行为不变。
|
|
@@ -82,7 +296,7 @@ function chipForKey(key) {
|
|
|
82
296
|
if (/^x[0-9a-z]{1,2}$/u.test(text))
|
|
83
297
|
return resolveF1Chip("F103:" + text.toUpperCase()).chip;
|
|
84
298
|
if (/^[0-9a-z]$/u.test(text))
|
|
85
|
-
return
|
|
299
|
+
return chipForDensityLetter(text);
|
|
86
300
|
return null;
|
|
87
301
|
}
|
|
88
302
|
/**
|
|
@@ -109,9 +323,19 @@ export function chipForInput(input) {
|
|
|
109
323
|
* 0.2 起不再写死 F103:内部一律走 resolveF1Chip(F100/F101/F102/F103/F105/F107 × 各自档位)。
|
|
110
324
|
* 老签名与老写法("F1:B")保持可用。
|
|
111
325
|
*/
|
|
112
|
-
export function startupChoiceFor(mcu) {
|
|
326
|
+
export function startupChoiceFor(mcu, env = process.env) {
|
|
113
327
|
const chip = chipForInput(mcu);
|
|
114
|
-
|
|
328
|
+
if (chip !== null)
|
|
329
|
+
return choiceFromChip(chip);
|
|
330
|
+
// 非 F1:事实全部来自插件内置资源 chips.json(按族分文件)。
|
|
331
|
+
const facts = findChipFact(mcu, env);
|
|
332
|
+
if (facts === null)
|
|
333
|
+
return null;
|
|
334
|
+
const familyId = familyIdOfPart(facts.cpn);
|
|
335
|
+
const family = familyId.slice("STM32".length);
|
|
336
|
+
if (CMSIS_FAMILIES[family] === undefined)
|
|
337
|
+
return null;
|
|
338
|
+
return { family, startup: facts.startup, define: facts.deviceDefine, deviceHeader: facts.deviceHeader, facts };
|
|
115
339
|
}
|
|
116
340
|
function refFromChip(chip) {
|
|
117
341
|
return { family: familyOf(chip), groupKey: cmsisGroupKey(chip), id: chipEntryId(chip), chip };
|
|
@@ -241,6 +465,9 @@ export function cmsisTemplatePlan(input) {
|
|
|
241
465
|
const spec = CMSIS_FAMILIES[choice.family];
|
|
242
466
|
if (spec === undefined)
|
|
243
467
|
return null;
|
|
468
|
+
const facts = choice.facts;
|
|
469
|
+
if (chip === null && facts === undefined)
|
|
470
|
+
return null;
|
|
244
471
|
const familyDir = spec.deviceDefinePrefix + "xx";
|
|
245
472
|
const deviceBase = "Drivers/CMSIS/Device/ST/" + familyDir;
|
|
246
473
|
const targets = [];
|
|
@@ -252,7 +479,9 @@ export function cmsisTemplatePlan(input) {
|
|
|
252
479
|
path: deviceBase + "/Include/" + header,
|
|
253
480
|
urls: sourceUrls(spec.deviceRepo, spec.deviceRef, spec.deviceIncludeDir + "/" + header),
|
|
254
481
|
minBytes: 200,
|
|
255
|
-
|
|
482
|
+
// 新族(C0/G0 等)的守卫不带前导下划线:STM32C0xx_H、SYSTEM_STM32C0XX_H;
|
|
483
|
+
// 老族(F0–F7/L1)是 __STM32F4xx_H、__SYSTEM_STM32F4XX_H。markers 是"至少命中一个",两种都列上。
|
|
484
|
+
markers: ["#ifndef __STM32", "#ifndef STM32", "#ifndef __SYSTEM_STM32", "#ifndef SYSTEM_STM32"],
|
|
256
485
|
sha256: DEVICE_HEADER_SHA256[header],
|
|
257
486
|
});
|
|
258
487
|
}
|
|
@@ -260,16 +489,18 @@ export function cmsisTemplatePlan(input) {
|
|
|
260
489
|
path: deviceBase + "/Include/" + choice.deviceHeader,
|
|
261
490
|
urls: sourceUrls(spec.deviceRepo, spec.deviceRef, spec.deviceIncludeDir + "/" + choice.deviceHeader),
|
|
262
491
|
minBytes: 10_000,
|
|
263
|
-
|
|
492
|
+
// 具体型号头(stm32c011xx.h / stm32f401xc.h)同样有带/不带前导下划线两代写法。
|
|
493
|
+
markers: ["#ifndef __STM32", "#ifndef STM32", "#ifndef __SYSTEM_STM32", "#ifndef SYSTEM_STM32"],
|
|
264
494
|
sha256: DEVICE_HEADER_SHA256[choice.deviceHeader],
|
|
265
495
|
});
|
|
266
|
-
// 2)
|
|
496
|
+
// 2) system_<族>xx.c 与启动文件
|
|
267
497
|
targets.push({
|
|
268
|
-
path: deviceBase + "/Source/Templates/
|
|
269
|
-
urls: sourceUrls(spec.deviceRepo, spec.deviceRef, spec.deviceTemplatesDir + "/
|
|
498
|
+
path: deviceBase + "/Source/Templates/" + spec.systemC,
|
|
499
|
+
urls: sourceUrls(spec.deviceRepo, spec.deviceRef, spec.deviceTemplatesDir + "/" + spec.systemC),
|
|
270
500
|
minBytes: 1_000,
|
|
271
501
|
markers: ["SystemInit"],
|
|
272
|
-
|
|
502
|
+
// SYSTEM_C_SHA256 只是 F1 那一份的实测值;别的族按形状校验(见 CMSIS_FAMILIES 注释)。
|
|
503
|
+
sha256: spec.family === "F1" ? SYSTEM_C_SHA256 : undefined,
|
|
273
504
|
});
|
|
274
505
|
targets.push({
|
|
275
506
|
path: deviceBase + "/Source/Templates/gcc/" + choice.startup,
|
|
@@ -283,20 +514,32 @@ export function cmsisTemplatePlan(input) {
|
|
|
283
514
|
// 但 mpu_armv7.h 是 ARM 原版,真实守卫是 ARM_MPU_ARMV7_H(V5.0.4 实测)——
|
|
284
515
|
// 上一版给五个头共用 [__CMSIS,__CORE_,__MPU_],mpu_armv7.h 一个都不命中,
|
|
285
516
|
// 网络全通、逐字节正确也会被判成"不是要的那个文件",整个寄存器模板下载必失败。
|
|
517
|
+
// core_cmX.h 的守卫名就是文件名大写前面加 __、后面加 _H(core_cm0plus.h → __CORE_CM0PLUS_H);
|
|
518
|
+
// 别再写死 __CORE_CM3_H:换了内核头(F4 → core_cm4.h)会一个都不命中。
|
|
519
|
+
const coreGuard = "__" + spec.coreHeader.replace(/\.h$/u, "").toUpperCase() + "_H";
|
|
286
520
|
const coreHeaderMarkers = {
|
|
287
|
-
[spec.coreHeader]: [
|
|
521
|
+
[spec.coreHeader]: [coreGuard, "__CMSIS"],
|
|
288
522
|
"cmsis_compiler.h": ["__CMSIS_COMPILER_H", "__CMSIS"],
|
|
289
523
|
"cmsis_gcc.h": ["__CMSIS_GCC_H", "__CMSIS"],
|
|
290
524
|
"cmsis_version.h": ["__CMSIS_VERSION", "__CMSIS"],
|
|
291
|
-
"mpu_armv7.h": ["ARM_MPU_ARMV7_H", "__MPU_"],
|
|
292
525
|
};
|
|
293
|
-
|
|
526
|
+
// mpu 头不是可选项:core_cm0plus.h / core_cm3.h / core_cm4.h / core_cm7.h 里都 #include "mpu_armv7.h"
|
|
527
|
+
// (core_cm33.h → mpu_armv8.h)。少下一个文件,main.c 第一条就 fatal error: mpu_armv7.h: No such file。
|
|
528
|
+
// 所以按内核头自动带上,spec.mpuHeader 只用来覆盖例外。
|
|
529
|
+
const mpuHeader = spec.mpuHeader
|
|
530
|
+
?? (spec.coreHeader === "core_cm0.h" ? undefined : /cm33/u.test(spec.coreHeader) ? "mpu_armv8.h" : "mpu_armv7.h");
|
|
531
|
+
if (mpuHeader !== undefined)
|
|
532
|
+
coreHeaderMarkers[mpuHeader] = ["ARM_MPU_", "__MPU_"];
|
|
533
|
+
const coreHeaders = [spec.coreHeader, "cmsis_compiler.h", "cmsis_gcc.h", "cmsis_version.h", ...(mpuHeader === undefined ? [] : [mpuHeader])];
|
|
534
|
+
for (const header of coreHeaders) {
|
|
294
535
|
targets.push({
|
|
295
536
|
path: "Drivers/CMSIS/Include/" + header,
|
|
296
537
|
urls: sourceUrls(spec.cmsisRepo, spec.cmsisRef, spec.coreIncludeDir + "/" + header),
|
|
297
538
|
minBytes: 500,
|
|
298
539
|
markers: coreHeaderMarkers[header] ?? ["__CMSIS", "__CORE_"],
|
|
299
|
-
|
|
540
|
+
// CORE_HEADER_SHA256 是 F1 那份(STM32CubeF1@master)的实测值。各族的 CMSIS 内核版本不同
|
|
541
|
+
// (U0 的 cmsis_compiler.h 与 F1 内容差一版),拿 F1 的哈希去校验别的族只会全灭。
|
|
542
|
+
sha256: spec.family === "F1" ? CORE_HEADER_SHA256[header] : undefined,
|
|
300
543
|
});
|
|
301
544
|
}
|
|
302
545
|
const license = "STMicroelectronics CMSIS device headers / startup / CMSIS core headers — Apache License 2.0."
|
|
@@ -304,10 +547,14 @@ export function cmsisTemplatePlan(input) {
|
|
|
304
547
|
+ "github.com/STMicroelectronics/" + spec.cmsisRepo + "(" + spec.cmsisRef + ")。"
|
|
305
548
|
+ "\n本目录是下载缓存,不是插件源码;删掉它不影响插件,下次用时会重新下载。\n";
|
|
306
549
|
// 0.2:条目按 line+档位分(cmsis:F1:103xb),目录同名。没有 chip 的旧调用退化成 startup 文件名。
|
|
307
|
-
const groupKey = chip
|
|
550
|
+
const groupKey = chip !== null
|
|
551
|
+
? cmsisGroupKey(chip)
|
|
552
|
+
: facts !== undefined
|
|
553
|
+
? facts.line + facts.group
|
|
554
|
+
: choice.startup.replace(/^startup_/u, "").replace(/\.s$/u, "");
|
|
308
555
|
return {
|
|
309
556
|
family: choice.family,
|
|
310
|
-
id: chip
|
|
557
|
+
id: chip !== null ? chipEntryId(chip) : cmsisEntryId(choice.family, groupKey),
|
|
311
558
|
dirName: choice.family + "/" + groupKey,
|
|
312
559
|
choice,
|
|
313
560
|
targets,
|