dsh-stm32 0.1.3 → 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 +52 -38
- package/README_EN.md +44 -33
- 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 +37 -35
- package/lib/data/chips.js +3 -3
- package/lib/data/clock-db.js +830 -0
- package/lib/data/clock-f1.js +12 -45
- package/lib/data/cmsis-sources.js +239 -18
- package/lib/data/db-presets.js +252 -0
- package/lib/data/device-facts.js +99 -26
- 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 +15 -14
- package/lib/data/svd.js +32 -16
- package/lib/data/toolchain-config.js +0 -14
- package/lib/engine/assets.js +191 -456
- package/lib/engine/breakpoints.js +66 -11
- 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 +423 -17
- package/lib/engine/debug.js +25 -6
- package/lib/engine/doctor.js +160 -17
- 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 +290 -21
- 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 +1244 -60
- 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 +25 -6
- package/lib/engine/probe-session.js +50 -14
- 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 +101 -40
- package/lib/engine/regs.js +41 -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 +188 -30
- 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 +4 -2
- package/lib/skill/stm32-workflow.js +2 -2
- package/lib/tools/assets.js +39 -108
- package/lib/tools/cache.js +2 -2
- package/lib/tools/debug-session.js +2 -2
- package/lib/tools/doctor.js +55 -5
- package/lib/tools/firmware-install.js +31 -6
- package/lib/tools/flash.js +32 -4
- package/lib/tools/generate.js +22 -0
- package/lib/tools/ioc-inspect.js +1 -1
- package/lib/tools/ioc-plan.js +56 -2
- package/lib/tools/ioc-verify.js +237 -0
- package/lib/tools/project-create.js +41 -5
- package/lib/tools/regs.js +8 -8
- package/lib/tools/route-plan.js +1 -1
- package/lib/tools/rtt.js +157 -34
- 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 +2 -2
- package/templates/register/Core/Inc/rtt.h +37 -2
- package/templates/register/Core/Src/main.c +17 -25
- package/templates/register/Core/Src/rtt.c +85 -9
- package/templates/scaffold/RTT.md +6 -2
- package/templates/scaffold/STM32F103XX_FLASH.ld +3 -0
- package/templates/scaffold/openocd.cfg +5 -3
- package/templates/scaffold/vscode/launch.json +8 -4
- package/docs/development-notes.md +0 -2487
- package/docs/dsh-stm32-plugin-/350/247/204/346/240/274.md +0 -673
- package/docs/logic-audit.md +0 -607
|
@@ -0,0 +1,248 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* L2 数据:`.ioc` 外设预设 —— "启用一个外设"到底要写哪些键。
|
|
3
|
+
*
|
|
4
|
+
* 为什么必须做成预设:CubeMX **不是**「读到 USART1.VirtualMode 就建 USART1」。
|
|
5
|
+
* 它按「某根脚的 Mode + Signal」推导复用模式,再核对 Mcu.IPn 里有这个实例,才生成
|
|
6
|
+
* MX_xxx_Init。实测(C8T6 + CubeMX 6.15.0 + STM32Cube_FW_F1_V1.8.7):只写
|
|
7
|
+
* Mcu.IPn=USART1 + USART1.IPParameters/VirtualMode + PA9.Signal=USART1_TX 时,
|
|
8
|
+
* CubeMX 静默丢弃整个 USART1(生成结果里没有 MX_USART1_UART_Init,
|
|
9
|
+
* HAL_UART_MODULE_ENABLED 仍注释);补上 PA9/PA10 的 .Mode=Asynchronous 之后
|
|
10
|
+
* 立刻生成成功,真机 USART1->BRR=0x271(115200@72 MHz)实测通过。
|
|
11
|
+
*
|
|
12
|
+
* 另一条实测结论:GPIO 脚(Signal=GPIO_Output/Input)**没有** .Mode —— 单模式信号。
|
|
13
|
+
* 只有多模式外设(USART/TIM/ADC…)才靠 .Mode 区分复用功能。
|
|
14
|
+
*
|
|
15
|
+
* 这些键集来自 504 个官方板级 .ioc 的写法 + 本机 CubeMX 实测,不是猜的;
|
|
16
|
+
* 换族时按同样的规则加一份表即可(`family` 字段是唯一的族相关入口)。
|
|
17
|
+
*/
|
|
18
|
+
/**
|
|
19
|
+
* 族相关的引脚别名:**离线兜底表**,只在读不到 CubeMX db 时用。
|
|
20
|
+
*
|
|
21
|
+
* 正常路径是 src/engine/ioc-plan.ts 的 createPinNameResolver:它按 .ioc 里的 Mcu.Name 去本机
|
|
22
|
+
* CubeMX 的 `db/mcu/<Mcu.Name>.xml` 查真实引脚名(R16),db 里叫什么就写什么。
|
|
23
|
+
* 这张表只收 F1 的 6 根带后缀的脚(PA0→PA0-WKUP、PC13→PC13-TAMPER-RTC、PC14/PC15、PD0/PD1),
|
|
24
|
+
* 没装 CubeMX 或 db 里没有这颗时才会用到;CubeMX 换版本后 db 名可能变,那时这里就会写错脚,
|
|
25
|
+
* 所以缺 db 时 ioc-plan 会在 warnings 里明确提醒。
|
|
26
|
+
*/
|
|
27
|
+
export const PIN_DB_ALIASES = {
|
|
28
|
+
STM32F1: {
|
|
29
|
+
PA0: "PA0-WKUP",
|
|
30
|
+
PC13: "PC13-TAMPER-RTC",
|
|
31
|
+
PC14: "PC14-OSC32_IN",
|
|
32
|
+
PC15: "PC15-OSC32_OUT",
|
|
33
|
+
PD0: "PD0-OSC_IN",
|
|
34
|
+
PD1: "PD1-OSC_OUT",
|
|
35
|
+
},
|
|
36
|
+
};
|
|
37
|
+
/** 把逻辑引脚名换成 .ioc 里要用的 db 名(族未知时原样返回)。 */
|
|
38
|
+
export function pinDbName(family, pin) {
|
|
39
|
+
const table = PIN_DB_ALIASES[family.trim().toUpperCase()];
|
|
40
|
+
if (table === undefined)
|
|
41
|
+
return pin;
|
|
42
|
+
return table[pin.trim().toUpperCase()] ?? pin;
|
|
43
|
+
}
|
|
44
|
+
function usart(name, tx, rx) {
|
|
45
|
+
return {
|
|
46
|
+
name,
|
|
47
|
+
label: name + " 异步串口",
|
|
48
|
+
ip: name,
|
|
49
|
+
pins: [
|
|
50
|
+
{ role: "tx", defaultPin: tx, signal: name + "_TX", mode: "Asynchronous" },
|
|
51
|
+
{ role: "rx", defaultPin: rx, signal: name + "_RX", mode: "Asynchronous" },
|
|
52
|
+
],
|
|
53
|
+
parameters: [{ name: "VirtualMode", value: "VM_ASYNC" }],
|
|
54
|
+
notes: [name + ":默认 8N1 / 115200(CubeMX 缺省值),要改波特率请用 entries 设 " + name + ".IPParameters 与对应键"],
|
|
55
|
+
};
|
|
56
|
+
}
|
|
57
|
+
function timerPwm(name, channel, pin, dbSignal) {
|
|
58
|
+
const mode = "PWM Generation" + String(channel) + " CH" + String(channel);
|
|
59
|
+
return {
|
|
60
|
+
name,
|
|
61
|
+
label: name + " CH" + String(channel) + " PWM 输出",
|
|
62
|
+
ip: name,
|
|
63
|
+
pins: [{
|
|
64
|
+
role: "ch" + String(channel),
|
|
65
|
+
defaultPin: pin,
|
|
66
|
+
signal: dbSignal,
|
|
67
|
+
mode: "",
|
|
68
|
+
shared: { key: dbSignal, ipSignal: name + "_CH" + String(channel), ipMode: mode },
|
|
69
|
+
}],
|
|
70
|
+
parameters: [{ name: "Channel-" + mode, value: "TIM_CHANNEL_" + String(channel) }],
|
|
71
|
+
notes: [
|
|
72
|
+
name + " PWM:默认 Prescaler=0 / Period=65535(CubeMX 缺省)," +
|
|
73
|
+
'要 1 kHz 请配 parameters {"Prescaler":"71","Period":"999"}(72 MHz 定时器时钟)',
|
|
74
|
+
],
|
|
75
|
+
};
|
|
76
|
+
}
|
|
77
|
+
/**
|
|
78
|
+
* F1 的 ADC 预设:一个规则通道(Rank 1)。
|
|
79
|
+
* `Channel-0#ChannelRegularConversion` 必须与引脚一致(PA1 → ADC_CHANNEL_1),
|
|
80
|
+
* 换引脚时这两个参数要一起改,所以 pins 覆盖时会上报提醒。
|
|
81
|
+
*/
|
|
82
|
+
function adc(name, pin, channel) {
|
|
83
|
+
return {
|
|
84
|
+
name,
|
|
85
|
+
label: name + " 规则通道 IN" + String(channel),
|
|
86
|
+
ip: name,
|
|
87
|
+
pins: [{
|
|
88
|
+
role: "in" + String(channel),
|
|
89
|
+
defaultPin: pin,
|
|
90
|
+
signal: "ADCx_IN" + String(channel),
|
|
91
|
+
mode: "",
|
|
92
|
+
shared: { key: "ADCx_IN" + String(channel), ipSignal: name + "_IN" + String(channel), ipMode: "IN" + String(channel) },
|
|
93
|
+
}],
|
|
94
|
+
parameters: [
|
|
95
|
+
{ name: "Rank-0#ChannelRegularConversion", value: "1" },
|
|
96
|
+
{ name: "Channel-0#ChannelRegularConversion", value: "ADC_CHANNEL_" + String(channel) },
|
|
97
|
+
{ name: "SamplingTime-0#ChannelRegularConversion", value: "ADC_SAMPLETIME_13CYCLES_5" },
|
|
98
|
+
{ name: "master", value: "1" },
|
|
99
|
+
{ name: "NbrOfConversionFlag", value: "1" },
|
|
100
|
+
],
|
|
101
|
+
// F1 的 ADC 时钟上限 14 MHz:RCC 缺省 ADCPRE=÷2 会跑在 36 MHz(超规格)。
|
|
102
|
+
extraEntries: [{ key: "RCC.ADCPresc", value: "RCC_ADCPCLK2_DIV6" }],
|
|
103
|
+
notes: ["ADC:已顺带把 RCC.ADCPresc 设成 ÷6(F1 的 ADC 上限 14 MHz,72 MHz÷6=12 MHz)"],
|
|
104
|
+
};
|
|
105
|
+
}
|
|
106
|
+
/** F103C8 上 ADC 通道 → 默认引脚(只收这颗片子上真实存在的 IN0..IN9)。 */
|
|
107
|
+
/** 允许配 DMA 的外设(F103 的 DMA 请求表:ADC1/SPI/I2C/USART/TIM 都能接到 DMA1 的某个通道)。 */
|
|
108
|
+
const ALLOWED_DMA_IP = ["ADC1", "ADC2", "ADC3", "SPI1", "SPI2", "I2C1", "I2C2", "USART1", "USART2", "USART3", "TIM1", "TIM2", "TIM3", "TIM4"];
|
|
109
|
+
const ADC_PIN_BY_CHANNEL = {
|
|
110
|
+
0: "PA0", 1: "PA1", 4: "PA4", 5: "PA5", 6: "PA6", 7: "PA7", 8: "PB0", 9: "PB1",
|
|
111
|
+
};
|
|
112
|
+
/**
|
|
113
|
+
* 多 Rank ADC(C5):一次扫多路,写成 `ADC1:1,4,5`。
|
|
114
|
+
*
|
|
115
|
+
* 键的形状来自 ImportADCParameter 的反汇编:每条转换占三个同下标键
|
|
116
|
+
* (Rank-n / Channel-n / SamplingTime-n),`NbrOfConversion` 必须等于条数,
|
|
117
|
+
* Rank 从 1 开始连续(R2 规则会盯着这三点)。引脚用 ADCx_INn 共享信号 + SH 块表达。
|
|
118
|
+
*/
|
|
119
|
+
function adcMulti(name, channels) {
|
|
120
|
+
const pins = channels.map((channel) => ({
|
|
121
|
+
role: "in" + String(channel),
|
|
122
|
+
defaultPin: ADC_PIN_BY_CHANNEL[channel] ?? "",
|
|
123
|
+
signal: "ADCx_IN" + String(channel),
|
|
124
|
+
mode: "",
|
|
125
|
+
shared: { key: "ADCx_IN" + String(channel), ipSignal: name + "_IN" + String(channel), ipMode: "IN" + String(channel) },
|
|
126
|
+
}));
|
|
127
|
+
const parameters = channels.flatMap((channel, index) => [
|
|
128
|
+
{ name: "Rank-" + String(index) + "#ChannelRegularConversion", value: String(index + 1) },
|
|
129
|
+
{ name: "Channel-" + String(index) + "#ChannelRegularConversion", value: "ADC_CHANNEL_" + String(channel) },
|
|
130
|
+
{ name: "SamplingTime-" + String(index) + "#ChannelRegularConversion", value: "ADC_SAMPLETIME_13CYCLES_5" },
|
|
131
|
+
]);
|
|
132
|
+
parameters.push({ name: "NbrOfConversion", value: String(channels.length) });
|
|
133
|
+
parameters.push({ name: "master", value: "1" });
|
|
134
|
+
parameters.push({ name: "NbrOfConversionFlag", value: "1" });
|
|
135
|
+
return {
|
|
136
|
+
name,
|
|
137
|
+
label: name + " 规则通道 " + channels.map((channel) => "IN" + String(channel)).join("+"),
|
|
138
|
+
ip: name,
|
|
139
|
+
pins,
|
|
140
|
+
parameters,
|
|
141
|
+
extraEntries: [{ key: "RCC.ADCPresc", value: "RCC_ADCPCLK2_DIV6" }],
|
|
142
|
+
notes: [
|
|
143
|
+
name + " 多 Rank:" + String(channels.length) + " 路扫描(通道 " + channels.join("、") +
|
|
144
|
+
"),DMA 要自己配(Dma.* 由 entries 写;ADC 用 DMA 时 Mode=Circular 才会连续搬)",
|
|
145
|
+
],
|
|
146
|
+
};
|
|
147
|
+
}
|
|
148
|
+
/**
|
|
149
|
+
* 纯时基定时器(C4):只有 Prescaler/Period,不占任何引脚。
|
|
150
|
+
*
|
|
151
|
+
* 为什么单独一条:TIM2/3/4 的 PWM 预设会占 CH1 引脚;只想"每 1 ms 中断一次"时占引脚反而添乱,
|
|
152
|
+
* 而 CubeMX 对"没有引脚的定时器"是完全支持的(生成 MX_TIM3_Init,HAL_TIM_Base_Start_IT 就能用)。
|
|
153
|
+
* 调用方式:peripherals: [{ name: "TIM3:timebase" }]。
|
|
154
|
+
*/
|
|
155
|
+
function timerBase(name) {
|
|
156
|
+
return {
|
|
157
|
+
name,
|
|
158
|
+
label: name + " 纯时基(无引脚)",
|
|
159
|
+
ip: name,
|
|
160
|
+
pins: [],
|
|
161
|
+
parameters: [
|
|
162
|
+
{ name: "Prescaler", value: "71" },
|
|
163
|
+
{ name: "Period", value: "999" },
|
|
164
|
+
{ name: "CounterMode", value: "TIM_COUNTERMODE_UP" },
|
|
165
|
+
{ name: "ClockDivision", value: "TIM_CLOCKDIVISION_DIV1" },
|
|
166
|
+
{ name: "AutoReloadPreload", value: "TIM_AUTORELOAD_PRELOAD_DISABLE" },
|
|
167
|
+
],
|
|
168
|
+
notes: [
|
|
169
|
+
name + " 纯时基:只生成 MX_" + name + "_Init,不占引脚。要中断再在 entries 里加 NVIC." + name + "_IRQn;" +
|
|
170
|
+
"Prescaler/Period 是 72 MHz 下的 1 kHz(71 / 999),换频率用 parameters 覆盖",
|
|
171
|
+
],
|
|
172
|
+
};
|
|
173
|
+
}
|
|
174
|
+
/**
|
|
175
|
+
* DMA 通道预设(C3):`DMA:ADC1` → 给 ADC1 配一条 DMA 通道。
|
|
176
|
+
*
|
|
177
|
+
* 八个字段的顺序来自 ImportDMAParameter 的反汇编:Instance、Direction、PeriphInc、MemInc、
|
|
178
|
+
* PeriphDataAlignment、MemDataAlignment、Mode、Priority。缺 `Mcu.IPn=DMA` 时 CubeMX 会把整组
|
|
179
|
+
* Dma.* 丢掉(R1 规则专盯这一条),所以预设的 ip 就是 "DMA"。
|
|
180
|
+
* `Dma.RequestsNb` 由 ioc-plan 按实际 Dma.<IP>.<n> 组数重算,不在这里写死。
|
|
181
|
+
*/
|
|
182
|
+
function dmaPreset(ip, channel) {
|
|
183
|
+
const base = "Dma." + ip + ".0.";
|
|
184
|
+
const isAdc = ip.startsWith("ADC");
|
|
185
|
+
return {
|
|
186
|
+
name: "DMA:" + ip,
|
|
187
|
+
label: ip + " 的 DMA 通道(" + channel + ")",
|
|
188
|
+
ip: "DMA",
|
|
189
|
+
pins: [],
|
|
190
|
+
parameters: [],
|
|
191
|
+
rawEntries: [
|
|
192
|
+
{ key: base + "Instance", value: channel },
|
|
193
|
+
{ key: base + "Direction", value: "DMA_PERIPH_TO_MEMORY" },
|
|
194
|
+
{ key: base + "PeriphInc", value: "DMA_PINC_DISABLE" },
|
|
195
|
+
{ key: base + "MemInc", value: "DMA_MINC_ENABLE" },
|
|
196
|
+
{ key: base + "PeriphDataAlignment", value: isAdc ? "DMA_PDATAALIGN_HALFWORD" : "DMA_PDATAALIGN_BYTE" },
|
|
197
|
+
{ key: base + "MemDataAlignment", value: isAdc ? "DMA_MDATAALIGN_HALFWORD" : "DMA_MDATAALIGN_BYTE" },
|
|
198
|
+
{ key: base + "Mode", value: "DMA_CIRCULAR" },
|
|
199
|
+
{ key: base + "Priority", value: "DMA_PRIORITY_LOW" },
|
|
200
|
+
],
|
|
201
|
+
notes: [
|
|
202
|
+
ip + " 的 DMA:circular + MINC,外设/内存都是半字(ADC 是 12 位右对齐,用 uint16_t 缓冲最省事);" +
|
|
203
|
+
"要改通道/优先级用 parameters 覆盖 Instance / Mode / Priority",
|
|
204
|
+
],
|
|
205
|
+
};
|
|
206
|
+
}
|
|
207
|
+
/** 内置预设表(按名字查)。 */
|
|
208
|
+
export const PERIPHERAL_PRESETS = [
|
|
209
|
+
usart("USART1", "PA9", "PA10"),
|
|
210
|
+
usart("USART2", "PA2", "PA3"),
|
|
211
|
+
usart("USART3", "PB10", "PB11"),
|
|
212
|
+
// PA0 的定时器信号在 db 里与 TIM2_ETR 合并成 S_TIM2_CH1_ETR,必须用这个名字。
|
|
213
|
+
timerPwm("TIM2", 1, "PA0", "S_TIM2_CH1_ETR"),
|
|
214
|
+
timerPwm("TIM3", 1, "PA6", "S_TIM3_CH1"),
|
|
215
|
+
timerPwm("TIM4", 1, "PB6", "S_TIM4_CH1"),
|
|
216
|
+
adc("ADC1", "PA1", 1),
|
|
217
|
+
adc("ADC2", "PA1", 1),
|
|
218
|
+
];
|
|
219
|
+
/** 按名字找预设(大小写不敏感)。支持 `TIM3:timebase` 这种"变体"写法。 */
|
|
220
|
+
export function findPeripheralPreset(name) {
|
|
221
|
+
const raw = name.trim().toUpperCase();
|
|
222
|
+
const [base, variant] = raw.split(":");
|
|
223
|
+
// ADC1:1,4,5 —— 多 Rank(通道号列表)
|
|
224
|
+
if (variant !== undefined && /^[0-9]+(?:,[0-9]+)*$/u.test(variant)) {
|
|
225
|
+
if (!/^ADC[1-3]$/u.test(base ?? ""))
|
|
226
|
+
return null;
|
|
227
|
+
const channels = [...new Set(variant.split(",").map((item) => Number.parseInt(item, 10)))].filter((item) => Number.isFinite(item));
|
|
228
|
+
if (channels.length === 0 || channels.some((channel) => ADC_PIN_BY_CHANNEL[channel] === undefined))
|
|
229
|
+
return null;
|
|
230
|
+
return adcMulti(base, channels);
|
|
231
|
+
}
|
|
232
|
+
if (variant !== undefined && /^[A-Z]+[0-9]+$/u.test(variant) && base === "DMA") {
|
|
233
|
+
const ip = variant;
|
|
234
|
+
const channel = ip.startsWith("ADC") ? "DMA1_Channel1" : "DMA1_Channel" + String((ALLOWED_DMA_IP.indexOf(ip) % 7) + 2);
|
|
235
|
+
return ALLOWED_DMA_IP.includes(ip) ? dmaPreset(ip, channel) : null;
|
|
236
|
+
}
|
|
237
|
+
if (variant === "TIMEBASE") {
|
|
238
|
+
if (!/^TIM[1-8]$/u.test(base ?? ""))
|
|
239
|
+
return null;
|
|
240
|
+
return timerBase(base);
|
|
241
|
+
}
|
|
242
|
+
return PERIPHERAL_PRESETS.find((preset) => preset.name.toUpperCase() === raw) ?? null;
|
|
243
|
+
}
|
|
244
|
+
/** 支持的外设名列表(报错时给用户看)。 */
|
|
245
|
+
export function peripheralPresetNames() {
|
|
246
|
+
// 纯时基是"变体"写法:TIM2/3/4:timebase,不占引脚。
|
|
247
|
+
return [...PERIPHERAL_PRESETS.map((preset) => preset.name), "TIM1..TIM8:timebase", "ADC1:1,4,5(多 Rank,通道号列表)", "DMA:ADC1(给该外设配 DMA 通道)"];
|
|
248
|
+
}
|