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.
Files changed (221) hide show
  1. package/README.md +52 -38
  2. package/README_EN.md +44 -33
  3. package/assets/README.md +85 -0
  4. package/assets/VERSION +1 -0
  5. package/assets/device/c0/chips.json +1108 -0
  6. package/assets/device/f0/chips.json +1570 -0
  7. package/assets/device/f1/chips.json +1238 -0
  8. package/assets/device/f1/svd/100.json +943 -0
  9. package/assets/device/f1/svd/101.json +901 -0
  10. package/assets/device/f1/svd/102.json +522 -0
  11. package/assets/device/f1/svd/103.json +1139 -0
  12. package/assets/device/f1/svd/105.json +1117 -0
  13. package/assets/device/f1/svd/107.json +1195 -0
  14. package/assets/device/f2/chips.json +674 -0
  15. package/assets/device/f3/chips.json +1318 -0
  16. package/assets/device/f4/chips.json +2942 -0
  17. package/assets/device/f7/chips.json +1710 -0
  18. package/assets/device/g0/chips.json +2102 -0
  19. package/assets/device/g4/chips.json +2494 -0
  20. package/assets/device/h5/chips.json +898 -0
  21. package/assets/device/h7/chips.json +1948 -0
  22. package/assets/device/l0/chips.json +2494 -0
  23. package/assets/device/l1/chips.json +1234 -0
  24. package/assets/device/l4/chips.json +2130 -0
  25. package/assets/device/l4+/chips.json +856 -0
  26. package/assets/device/l5/chips.json +226 -0
  27. package/assets/device/u0/chips.json +688 -0
  28. package/assets/device/u3/chips.json +310 -0
  29. package/assets/device/u5/chips.json +884 -0
  30. package/assets/device/wba/chips.json +506 -0
  31. package/assets/device/wl/chips.json +184 -0
  32. package/assets/headers/f1/stm32f100xb.h +5972 -0
  33. package/assets/headers/f1/stm32f100xe.h +6587 -0
  34. package/assets/headers/f1/stm32f101x6.h +5315 -0
  35. package/assets/headers/f1/stm32f101xb.h +5446 -0
  36. package/assets/headers/f1/stm32f101xe.h +6503 -0
  37. package/assets/headers/f1/stm32f101xg.h +6713 -0
  38. package/assets/headers/f1/stm32f102x6.h +6448 -0
  39. package/assets/headers/f1/stm32f102xb.h +6570 -0
  40. package/assets/headers/f1/stm32f103x6.h +10109 -0
  41. package/assets/headers/f1/stm32f103xb.h +10240 -0
  42. package/assets/headers/f1/stm32f103xe.h +11767 -0
  43. package/assets/headers/f1/stm32f103xg.h +11951 -0
  44. package/assets/headers/f1/stm32f105xc.h +14340 -0
  45. package/assets/headers/f1/stm32f107xc.h +15253 -0
  46. package/assets/headers/f1/stm32f1xx.h +273 -0
  47. package/assets/headers/f1/system_stm32f1xx.h +96 -0
  48. package/assets/ioc/family/C0.ioc +82 -0
  49. package/assets/ioc/family/F0.ioc +71 -0
  50. package/assets/ioc/family/F2.ioc +91 -0
  51. package/assets/ioc/family/F3.ioc +94 -0
  52. package/assets/ioc/family/F4.ioc +91 -0
  53. package/assets/ioc/family/F7.ioc +102 -0
  54. package/assets/ioc/family/G0.ioc +90 -0
  55. package/assets/ioc/family/G4.ioc +110 -0
  56. package/assets/ioc/family/H5.ioc +116 -0
  57. package/assets/ioc/family/H7.ioc +133 -0
  58. package/assets/ioc/family/L0.ioc +92 -0
  59. package/assets/ioc/family/L1.ioc +87 -0
  60. package/assets/ioc/family/L4+.ioc +92 -0
  61. package/assets/ioc/family/L4.ioc +93 -0
  62. package/assets/ioc/family/L5.ioc +91 -0
  63. package/assets/ioc/family/U0.ioc +103 -0
  64. package/assets/ioc/family/U3.ioc +113 -0
  65. package/assets/ioc/family/U5.ioc +102 -0
  66. package/assets/ioc/family/WBA.ioc +100 -0
  67. package/assets/ioc/family/WL.ioc +93 -0
  68. package/assets/ioc/minimal/STM32F100C8Tx.ioc +113 -0
  69. package/assets/ioc/minimal/STM32F100RCTx.ioc +113 -0
  70. package/assets/ioc/minimal/STM32F101C4Tx.ioc +113 -0
  71. package/assets/ioc/minimal/STM32F101C8Tx.ioc +113 -0
  72. package/assets/ioc/minimal/STM32F101RCTx.ioc +113 -0
  73. package/assets/ioc/minimal/STM32F101RFTx.ioc +113 -0
  74. package/assets/ioc/minimal/STM32F102C4Tx.ioc +113 -0
  75. package/assets/ioc/minimal/STM32F102C8Tx.ioc +113 -0
  76. package/assets/ioc/minimal/STM32F103C4Tx.ioc +113 -0
  77. package/assets/ioc/minimal/STM32F103C8Tx.ioc +113 -0
  78. package/assets/ioc/minimal/STM32F103RCTx.ioc +113 -0
  79. package/assets/ioc/minimal/STM32F103RFTx.ioc +113 -0
  80. package/assets/ioc/minimal/STM32F105RCTx.ioc +113 -0
  81. package/assets/ioc/minimal/STM32F107RCTx.ioc +113 -0
  82. package/assets/ld/f1/STM32F100C8Tx_FLASH.ld +249 -0
  83. package/assets/ld/f1/STM32F100RCTx_FLASH.ld +249 -0
  84. package/assets/ld/f1/STM32F101C4Tx_FLASH.ld +249 -0
  85. package/assets/ld/f1/STM32F101C8Tx_FLASH.ld +249 -0
  86. package/assets/ld/f1/STM32F101RCTx_FLASH.ld +249 -0
  87. package/assets/ld/f1/STM32F101RFTx_FLASH.ld +249 -0
  88. package/assets/ld/f1/STM32F102C4Tx_FLASH.ld +249 -0
  89. package/assets/ld/f1/STM32F102C8Tx_FLASH.ld +249 -0
  90. package/assets/ld/f1/STM32F103C4Tx_FLASH.ld +249 -0
  91. package/assets/ld/f1/STM32F103C8Tx_FLASH.ld +249 -0
  92. package/assets/ld/f1/STM32F103RCTx_FLASH.ld +249 -0
  93. package/assets/ld/f1/STM32F103RFTx_FLASH.ld +249 -0
  94. package/assets/ld/f1/STM32F105RCTx_FLASH.ld +249 -0
  95. package/assets/ld/f1/STM32F107RCTx_FLASH.ld +249 -0
  96. package/assets/manifest.json +1130 -0
  97. package/assets/startup/f1/startup_stm32f100xb.s +407 -0
  98. package/assets/startup/f1/startup_stm32f100xe.s +449 -0
  99. package/assets/startup/f1/startup_stm32f101x6.s +322 -0
  100. package/assets/startup/f1/startup_stm32f101xb.s +338 -0
  101. package/assets/startup/f1/startup_stm32f101xe.s +423 -0
  102. package/assets/startup/f1/startup_stm32f101xg.s +439 -0
  103. package/assets/startup/f1/startup_stm32f102x6.s +330 -0
  104. package/assets/startup/f1/startup_stm32f102xb.s +346 -0
  105. package/assets/startup/f1/startup_stm32f103x6.s +348 -0
  106. package/assets/startup/f1/startup_stm32f103xb.s +364 -0
  107. package/assets/startup/f1/startup_stm32f103xe.s +470 -0
  108. package/assets/startup/f1/startup_stm32f103xg.s +466 -0
  109. package/assets/startup/f1/startup_stm32f105xc.s +463 -0
  110. package/assets/startup/f1/startup_stm32f107xc.s +472 -0
  111. package/assets/templates/family/C0.ioc +82 -0
  112. package/assets/templates/family/F0.ioc +71 -0
  113. package/assets/templates/family/F2.ioc +91 -0
  114. package/assets/templates/family/F3.ioc +94 -0
  115. package/assets/templates/family/F4.ioc +91 -0
  116. package/assets/templates/family/F7.ioc +102 -0
  117. package/assets/templates/family/G0.ioc +90 -0
  118. package/assets/templates/family/G4.ioc +110 -0
  119. package/assets/templates/family/H5.ioc +116 -0
  120. package/assets/templates/family/H7.ioc +133 -0
  121. package/assets/templates/family/L0.ioc +92 -0
  122. package/assets/templates/family/L1.ioc +87 -0
  123. package/assets/templates/family/L4+.ioc +92 -0
  124. package/assets/templates/family/L4.ioc +93 -0
  125. package/assets/templates/family/L5.ioc +91 -0
  126. package/assets/templates/family/U0.ioc +103 -0
  127. package/assets/templates/family/U3.ioc +113 -0
  128. package/assets/templates/family/U5.ioc +102 -0
  129. package/assets/templates/family/WB.ioc +81 -0
  130. package/assets/templates/family/WBA.ioc +100 -0
  131. package/assets/templates/family/WL.ioc +93 -0
  132. package/docs/reading-guide.md +37 -35
  133. package/lib/data/chips.js +3 -3
  134. package/lib/data/clock-db.js +830 -0
  135. package/lib/data/clock-f1.js +12 -45
  136. package/lib/data/cmsis-sources.js +239 -18
  137. package/lib/data/db-presets.js +252 -0
  138. package/lib/data/device-facts.js +99 -26
  139. package/lib/data/family.js +515 -0
  140. package/lib/data/firmware-packages.js +562 -0
  141. package/lib/data/install-guides.js +2 -2
  142. package/lib/data/ioc-presets.js +248 -0
  143. package/lib/data/ioc-schema.js +1058 -0
  144. package/lib/data/rm-topics/stm32c0.json +227 -0
  145. package/lib/data/rm-topics.js +103 -0
  146. package/lib/data/search-roots.js +42 -1
  147. package/lib/data/stm32f1.js +15 -14
  148. package/lib/data/svd.js +32 -16
  149. package/lib/data/toolchain-config.js +0 -14
  150. package/lib/engine/assets.js +191 -456
  151. package/lib/engine/breakpoints.js +66 -11
  152. package/lib/engine/clock-derived.js +101 -0
  153. package/lib/engine/clock-direct.js +313 -0
  154. package/lib/engine/clock-plan.js +96 -52
  155. package/lib/engine/clock-pllmn.js +319 -0
  156. package/lib/engine/cmake-sources.js +67 -13
  157. package/lib/engine/cube-mx-guard.js +44 -0
  158. package/lib/engine/cube-programmer.js +137 -0
  159. package/lib/engine/cubemx-db.js +273 -0
  160. package/lib/engine/debug-session.js +423 -17
  161. package/lib/engine/debug.js +25 -6
  162. package/lib/engine/doctor.js +160 -17
  163. package/lib/engine/facts-acquire.js +416 -0
  164. package/lib/engine/facts.js +134 -0
  165. package/lib/engine/firmware-install.js +176 -5
  166. package/lib/engine/firmware-official.js +451 -0
  167. package/lib/engine/flash.js +290 -21
  168. package/lib/engine/gdb-mi.js +476 -0
  169. package/lib/engine/generate.js +9 -2
  170. package/lib/engine/hal-chip.js +124 -41
  171. package/lib/engine/ioc-plan.js +1244 -60
  172. package/lib/engine/ioc-rules.js +698 -0
  173. package/lib/engine/ioc-verify.js +706 -0
  174. package/lib/engine/ioc.js +43 -4
  175. package/lib/engine/msys2-install.js +4 -4
  176. package/lib/engine/probe-error.js +25 -6
  177. package/lib/engine/probe-session.js +50 -14
  178. package/lib/engine/probe.js +18 -3
  179. package/lib/engine/register-clock.js +41 -0
  180. package/lib/engine/register-gpio.js +115 -0
  181. package/lib/engine/register-linker.js +12 -7
  182. package/lib/engine/register-template.js +101 -40
  183. package/lib/engine/regs.js +41 -8
  184. package/lib/engine/rm-extract.js +144 -0
  185. package/lib/engine/rm-sources.js +360 -0
  186. package/lib/engine/rm-text.js +56 -0
  187. package/lib/engine/rtt.js +188 -30
  188. package/lib/engine/scaffold.js +185 -18
  189. package/lib/engine/toolchain-gate.js +0 -4
  190. package/lib/engine/watch.js +227 -0
  191. package/lib/index.js +4 -2
  192. package/lib/skill/stm32-workflow.js +2 -2
  193. package/lib/tools/assets.js +39 -108
  194. package/lib/tools/cache.js +2 -2
  195. package/lib/tools/debug-session.js +2 -2
  196. package/lib/tools/doctor.js +55 -5
  197. package/lib/tools/firmware-install.js +31 -6
  198. package/lib/tools/flash.js +32 -4
  199. package/lib/tools/generate.js +22 -0
  200. package/lib/tools/ioc-inspect.js +1 -1
  201. package/lib/tools/ioc-plan.js +56 -2
  202. package/lib/tools/ioc-verify.js +237 -0
  203. package/lib/tools/project-create.js +41 -5
  204. package/lib/tools/regs.js +8 -8
  205. package/lib/tools/route-plan.js +1 -1
  206. package/lib/tools/rtt.js +157 -34
  207. package/lib/tools/watch.js +256 -0
  208. package/package.json +5 -4
  209. package/templates/openocd/stm32c0x.cfg +83 -0
  210. package/templates/openocd/stm32u0x.cfg +64 -0
  211. package/templates/register/CMakeLists.txt +2 -2
  212. package/templates/register/Core/Inc/rtt.h +37 -2
  213. package/templates/register/Core/Src/main.c +17 -25
  214. package/templates/register/Core/Src/rtt.c +85 -9
  215. package/templates/scaffold/RTT.md +6 -2
  216. package/templates/scaffold/STM32F103XX_FLASH.ld +3 -0
  217. package/templates/scaffold/openocd.cfg +5 -3
  218. package/templates/scaffold/vscode/launch.json +8 -4
  219. package/docs/development-notes.md +0 -2487
  220. package/docs/dsh-stm32-plugin-/350/247/204/346/240/274.md +0 -673
  221. 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
+ }