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,252 @@
1
+ /**
2
+ * 按族从 CubeMX db 派生 .ioc 外设预设(串口 / 定时器 PWM / ADC 单通道)。
3
+ *
4
+ * 为什么不维护手写预设表:脚位、复用信号名、参数默认值三样都随族与型号变,
5
+ * 手抄一份表等于把手册抄一遍,抄错一根脚的表现是「plan 成功、CubeMX 一打开就丢」。
6
+ * CubeMX 自己就有这些事实:`db/mcu/<Mcu.Name>.xml` 里每个 <Pin> 的 <Signal> 就是「这根脚能做什么」。
7
+ *
8
+ * 与手写表的边界(`src/data/ioc-presets.ts`):
9
+ * - 能从 db 推出来的一律走这里:USART/UART/LPUART、TIMx 的 CH1..CH4 PWM、ADC 的单通道规则转换;
10
+ * - db 推不出来的留手写表:`TIMx:timebase`(不占脚、只有 Prescaler/Period 取值)、
11
+ * `DMA:<IP>`(DMA 请求表不在 db 的引脚信息里)、`ADC1:1,4,5`(多 Rank 扫描的通道顺序)。
12
+ *
13
+ * 两个「.ioc 里的写法与 db 不同」的坑(语料实证:CubeMX 官方板级 .ioc 504 份):
14
+ * 1. 定时器通道:db 写 `TIM2_CH1`,.ioc 里的 <pin>.Signal 要写 `S_TIM2_CH1`(共享信号加 S_ 前缀);
15
+ * 2. ADC 通道:db 写 `ADC1_IN1`,.ioc 里统一写 `ADCx_IN1`(x = 任意 ADC 实例),
16
+ * 具体是哪个 ADC 由 SH 块的 `ADC1_IN1,IN1` 表达。
17
+ * 这两条不能靠猜:写错就会被 CubeMX 静默丢掉(§60 记过这个坑)。
18
+ */
19
+ import { logicalPinName } from "../engine/cubemx-db.js";
20
+ const SERIAL_RE = /^(USART|UART|LPUART)([0-9]+)$/u;
21
+ const TIMER_RE = /^(TIM|HRTIM)([0-9A-Z]+)$/u;
22
+ const ADC_RE = /^(ADC)([0-9])$/u;
23
+ /** PA9 → { port: "A", number: 9 };带后缀的 db 名也吃(PA0-WKUP → A/0)。 */
24
+ function splitPin(pin) {
25
+ const matched = /^P([A-Z])([0-9]{1,2})/u.exec(pin.trim().toUpperCase());
26
+ if (matched === null)
27
+ return null;
28
+ return { port: matched[1], number: Number(matched[2]) };
29
+ }
30
+ /** 按端口、脚号升序(同端口的 TX/RX 才配得成一对)。 */
31
+ function pinOrder(hit) {
32
+ return (hit.port.charCodeAt(0) - 65) * 100 + hit.number;
33
+ }
34
+ /**
35
+ * db 里带某条复用例信号的引脚,按端口/脚号升序。
36
+ *
37
+ * 为什么用 `logicalPinName` 而不是直接丢带后缀的引脚:F1 的 PA0 在 db 里叫 PA0-WKUP,
38
+ * 它就是 TIM2_CH1 的默认脚。按「带 - 就跳过」会把它整根脚丢掉(F1 上 TIM2 就再也选不到脚)。
39
+ */
40
+ function pinsWithSignal(facts, signal) {
41
+ const wanted = signal.trim().toUpperCase();
42
+ const hits = [];
43
+ for (const [pin, fact] of facts.pins) {
44
+ const dbPin = pin.toUpperCase();
45
+ if (dbPin.startsWith("VP_"))
46
+ continue;
47
+ const signals = [...fact.signals.keys()].map((name) => name.toUpperCase());
48
+ if (!signals.includes(wanted))
49
+ continue;
50
+ const split = splitPin(dbPin);
51
+ if (split === null)
52
+ continue;
53
+ hits.push({ dbPin, logical: logicalPinName(dbPin), port: split.port, number: split.number, signal: wanted });
54
+ }
55
+ hits.sort((left, right) => pinOrder(left) - pinOrder(right));
56
+ const seen = new Set();
57
+ return hits.filter((hit) => {
58
+ if (seen.has(hit.logical))
59
+ return false;
60
+ seen.add(hit.logical);
61
+ return true;
62
+ });
63
+ }
64
+ /** db 里有没有这个 IP 实例(`Mcu.IP` 清单的真值;大小写照 CubeMX 写)。 */
65
+ function instanceNameOf(facts, ip) {
66
+ const wanted = ip.trim().toUpperCase();
67
+ for (const name of facts.ips.keys()) {
68
+ if (name.toUpperCase() === wanted)
69
+ return name;
70
+ }
71
+ return null;
72
+ }
73
+ /**
74
+ * 串口预设:TX/RX 各自挑一根脚。
75
+ *
76
+ * 选脚规则(可复现,不依赖型号特例):
77
+ * 1. 优先同端口的一对(PA9/PA10 这种),取「端口字母最小、脚号最小」的那一对;
78
+ * 2. 没有同端口的对,就各取一根(TX 取最小、RX 取最小),并在 notes 里说明是跨端口;
79
+ * 3. 缺 TX 或缺 RX 直接拒绝 —— 只有单向的串口预设在这里没有意义。
80
+ */
81
+ function deriveSerial(facts, ip) {
82
+ const tx = pinsWithSignal(facts, ip + "_TX");
83
+ const rx = pinsWithSignal(facts, ip + "_RX");
84
+ if (tx.length === 0 || rx.length === 0) {
85
+ const missing = [tx.length === 0 ? "TX" : "", rx.length === 0 ? "RX" : ""].filter((item) => item !== "");
86
+ return {
87
+ preset: null,
88
+ reason: ip + " 在 db 里找不到可用的 " + missing.join("/") + " 引脚(这颗芯片的 " + ip +
89
+ " 可能没引出,或只支持同步/单线模式):换一个实例,或用 pins + entries 手写该族的键",
90
+ };
91
+ }
92
+ const samePort = tx.find((left) => rx.some((right) => right.port === left.port));
93
+ let txPick = tx[0];
94
+ let rxPick = rx[0];
95
+ const notes = [];
96
+ if (samePort !== undefined) {
97
+ txPick = samePort;
98
+ rxPick = rx.find((hit) => hit.port === samePort.port);
99
+ }
100
+ else {
101
+ notes.push(ip + ":TX(" + txPick.logical + ") 与 RX(" + rxPick.logical + ") 不在同一个端口,接线时注意");
102
+ }
103
+ const pins = [
104
+ { role: "tx", defaultPin: txPick.logical, signal: ip + "_TX", mode: "Asynchronous" },
105
+ { role: "rx", defaultPin: rxPick.logical, signal: ip + "_RX", mode: "Asynchronous" },
106
+ ];
107
+ return {
108
+ preset: {
109
+ name: ip,
110
+ label: ip + " 异步串口(按 db 选脚 " + txPick.logical + "/" + rxPick.logical + ")",
111
+ ip,
112
+ pins,
113
+ parameters: [{ name: "VirtualMode", value: "VM_ASYNC" }],
114
+ notes: [
115
+ ip + ":引脚是从本机 CubeMX db 里该型号的复用例表选的(" + txPick.logical + " TX / " + rxPick.logical + " RX);" +
116
+ "波特率等参数按 CubeMX 缺省(8N1 / 115200),要改请用 entries 设 " + ip + ".IPParameters 与对应键",
117
+ ...notes,
118
+ ],
119
+ },
120
+ reason: "",
121
+ };
122
+ }
123
+ /**
124
+ * 定时器 PWM 预设:`TIM2` → CH1。
125
+ *
126
+ * 通道信号在 db 里可能有两种写法(`TIM2_CH1` / 合并过的 `TIM2_CH1_ETR`):两种都接受,
127
+ * 命中哪个用哪个,但 .ioc 里统一写成 `S_<db 名>`。
128
+ */
129
+ function deriveTimer(facts, ip, channel, familyId) {
130
+ const base = ip + "_CH" + String(channel);
131
+ const candidates = [];
132
+ for (const signal of [base, base + "_ETR"]) {
133
+ candidates.push(...pinsWithSignal(facts, signal));
134
+ }
135
+ candidates.sort((left, right) => pinOrder(left) - pinOrder(right));
136
+ const pick = candidates[0];
137
+ if (pick === undefined) {
138
+ return {
139
+ preset: null,
140
+ reason: ip + " 的 CH" + String(channel) + " 在 db 里没有引出引脚(这颗芯片可能没有这个通道):" +
141
+ "换一个通道,或用 pins + entries 手写该族的键",
142
+ };
143
+ }
144
+ const mode = "PWM Generation" + String(channel) + " CH" + String(channel);
145
+ const iocSignal = "S_" + pick.signal;
146
+ return {
147
+ preset: {
148
+ name: ip,
149
+ label: ip + " CH" + String(channel) + " PWM 输出(按 db 选脚 " + pick.logical + ")",
150
+ ip,
151
+ pins: [{
152
+ role: "ch" + String(channel),
153
+ defaultPin: pick.logical,
154
+ signal: iocSignal,
155
+ mode: "",
156
+ shared: { key: iocSignal, ipSignal: base, ipMode: mode },
157
+ }],
158
+ parameters: [{ name: "Channel-" + mode, value: "TIM_CHANNEL_" + String(channel) }],
159
+ notes: [
160
+ ip + " PWM:Prescaler/Period 未设,CubeMX 缺省 0 / 65535;" +
161
+ "要 1 kHz 请用 entries 设 " + ip + ".Prescaler / " + ip + ".Period(按 " + familyId + " 的定时器时钟算)",
162
+ ],
163
+ },
164
+ reason: "",
165
+ };
166
+ }
167
+ /**
168
+ * ADC 单通道规则转换:`ADC1` → 优先 IN1(历史默认),没有就取最小的可用通道。
169
+ *
170
+ * `.ioc` 里引脚信号写 `ADCx_INn`(不是 db 的 `ADC1_INn`),具体实例由 SH 块表达。
171
+ * ADC 时钟预分频是族相关的(F1 的 ADC 上限 14 MHz,缺省 ÷2 会超规格),所以只在 F1 上带
172
+ * `RCC.ADCPresc`,别的族留给调用方(不猜一个该族可能不认的键)。
173
+ */
174
+ function deriveAdc(facts, ip, familyId) {
175
+ const available = [];
176
+ for (let channel = 0; channel <= 19; channel += 1) {
177
+ const hits = pinsWithSignal(facts, ip + "_IN" + String(channel));
178
+ if (hits.length > 0)
179
+ available.push({ channel, pin: hits[0] });
180
+ }
181
+ if (available.length === 0) {
182
+ return {
183
+ preset: null,
184
+ reason: ip + " 在 db 里没有任何已引出的规则通道:换一个 ADC 实例,或用 pins + entries 手写",
185
+ };
186
+ }
187
+ const chosen = available.find((item) => item.channel === 1) ?? available[0];
188
+ const channel = chosen.channel;
189
+ const iocSignal = "ADCx_IN" + String(channel);
190
+ const isF1 = familyId.trim().toUpperCase() === "STM32F1";
191
+ return {
192
+ preset: {
193
+ name: ip,
194
+ label: ip + " 规则通道 IN" + String(channel) + "(按 db 选脚 " + chosen.pin.logical + ")",
195
+ ip,
196
+ pins: [{
197
+ role: "in" + String(channel),
198
+ defaultPin: chosen.pin.logical,
199
+ signal: iocSignal,
200
+ mode: "",
201
+ shared: { key: iocSignal, ipSignal: ip + "_IN" + String(channel), ipMode: "IN" + String(channel) },
202
+ }],
203
+ parameters: [
204
+ { name: "Rank-0#ChannelRegularConversion", value: "1" },
205
+ { name: "Channel-0#ChannelRegularConversion", value: "ADC_CHANNEL_" + String(channel) },
206
+ { name: "SamplingTime-0#ChannelRegularConversion", value: "ADC_SAMPLETIME_13CYCLES_5" },
207
+ { name: "master", value: "1" },
208
+ { name: "NbrOfConversionFlag", value: "1" },
209
+ ],
210
+ ...(isF1 ? { extraEntries: [{ key: "RCC.ADCPresc", value: "RCC_ADCPCLK2_DIV6" }] } : {}),
211
+ notes: [
212
+ isF1
213
+ ? "ADC:已顺带把 RCC.ADCPresc 设成 ÷6(F1 的 ADC 上限 14 MHz,72 MHz÷6=12 MHz)"
214
+ : "ADC:" + familyId + " 的 ADC 时钟预分频没设(CubeMX 缺省值),要降频请用 entries 设 RCC.ADCPresc",
215
+ channel === 1 ? "" : "ADC:" + ip + " 没有已引出的 IN1,用了最小的可用通道 IN" + String(channel),
216
+ ].filter((note) => note !== ""),
217
+ },
218
+ reason: "",
219
+ };
220
+ }
221
+ /**
222
+ * 按名字派生预设。认识的名字:`USART1` / `UART4` / `LPUART1` / `TIM2`(默认 CH1)/ `ADC1`(默认 IN1)。
223
+ * 带变体的名字(`TIM3:timebase`、`ADC1:1,4,5`)与 DMA 不在这里派生 —— 那些是手写表的活。
224
+ */
225
+ export function derivePeripheralPreset(facts, name, options = {}) {
226
+ const raw = name.trim().toUpperCase();
227
+ const familyId = (options.familyId ?? "").trim();
228
+ if (raw.includes(":") || raw.startsWith("DMA:")) {
229
+ return { preset: null, reason: raw + " 是变体/DMA 预设,db 里没有对应事实(由手写表提供)" };
230
+ }
231
+ if (facts === null) {
232
+ return { preset: null, reason: "读不到本机 CubeMX db(没有 .ioc 的 Mcu.Name 或没装 CubeMX):没法按族选脚" };
233
+ }
234
+ const instance = instanceNameOf(facts, raw);
235
+ if (instance === null) {
236
+ return {
237
+ preset: null,
238
+ reason: raw + " 不在这颗芯片的 db IP 清单里(可用:" + [...facts.ips.keys()].join("、") + ")",
239
+ };
240
+ }
241
+ if (SERIAL_RE.test(instance))
242
+ return deriveSerial(facts, instance);
243
+ if (TIMER_RE.test(instance))
244
+ return deriveTimer(facts, instance, 1, familyId);
245
+ if (ADC_RE.test(instance))
246
+ return deriveAdc(facts, instance, familyId);
247
+ return {
248
+ preset: null,
249
+ reason: raw + " 的预设还没派生(db 只给了引脚复用例,「这根脚做什么功能」还要按族规则拼参数):" +
250
+ "现在请用 pins + entries 手写该族的键,或换用 USART/UART/LPUART/TIM/ADC 预设",
251
+ };
252
+ }
@@ -1,15 +1,15 @@
1
1
  /**
2
- * L1:设备事实(device facts)——唯一来源是本地资源包缓存里的 device/f1/chips.json。
2
+ * L1:设备事实(device facts)——唯一来源是本地内置资源里的 device/f1/chips.json。
3
3
  *
4
- * 用户 2026-10-31 的决定(原话「内置表删了吧」):插件不再自带任何芯片事实表。型号 → 容量档 /
5
- * 启动文件 / 设备宏 / 设备头 / Flash / RAM / 引脚数,全部取自资源仓库 dsh-stm32-assets 的
6
- * device/f1/chips.json,装到 <DSH_STM32_ASSETS 根或 ~/.dsh-stm32/assets>/<version>/device/f1/chips.json。
4
+ * 用户 2026-10-31 的决定(原话「内置表删了吧」):插件不再自带任何手写芯片事实表。型号 → 容量档 /
5
+ * 启动文件 / 设备宏 / 设备头 / Flash / RAM / 引脚数,全部取自随插件包发布的 assets/device/<族>/chips.json
6
+ * (flat 布局,2026-11 起不再走独立资源仓与联网下载)。
7
7
  *
8
- * 第一次用没有缓存怎么办:工具层调 ensureAssets()(src/engine/assets.ts)自动 refresh 一次;
9
- * 没网、没装就只能明说「先跑 stm32_assets refresh,或检查网络」,绝不退回内置表(已经没有内置表了)。
8
+ * 读不到怎么办:工具层调 ensureAssets()(src/engine/assets.ts)做本地完整性检查;
9
+ * 缺文件只可能是插件安装不完整——明说「重装插件后重试(stm32_assets verify 可定位缺件)」,不猜也不内置第二份事实。
10
10
  *
11
11
  * 为什么要内存缓存:resolveF1Chip 在一个工程里会被调几十次(校验 .ioc、渲染启动文件名、选时钟),
12
- * 每次都读一遍 JSON 太浪费。缓存键带 path + size + mtimeMs:资源包升级/重装/手改后自动失效,
12
+ * 每次都读一遍 JSON 太浪费。缓存键带 path + size + mtimeMs:资源升级/重装/手改后自动失效,
13
13
  * 不需要任何 reset 钩子(也没有全局状态需要维护)。
14
14
  *
15
15
  * 只读:本文件不写盘、不联网、不起进程。
@@ -17,11 +17,13 @@
17
17
  import fs from "node:fs";
18
18
  import path from "node:path";
19
19
  import { ASSETS_DEVICE_FACTS_FILE, ASSETS_REFRESH_HINT, errText, readLocalManifest } from "../engine/assets.js";
20
- /** chips.json 在资源包里的相对路径(manifest 的 profiles.core 也按 device/** 收录它)。 */
20
+ import { familyIdOfPart, familyProfileOf } from "./family.js";
21
+ /** chips.json 在内置资源里的相对路径(manifest 的 profiles.core 也按 device/** 收录它)。 */
21
22
  export const DEVICE_FACTS_REL = ASSETS_DEVICE_FACTS_FILE;
22
23
  /** 没缓存/没这颗芯片时,给用户的那句可执行提示(所有结构化错误都带上它)。 */
23
24
  export const DEVICE_FACTS_HINT = ASSETS_REFRESH_HINT;
24
- let cache = null;
25
+ /** 每个族的 chips.json 各缓存一份(键里带 path:size:mtimeMs)。 */
26
+ const cache = new Map();
25
27
  function isRecord(value) {
26
28
  return typeof value === "object" && value !== null && !Array.isArray(value);
27
29
  }
@@ -31,10 +33,51 @@ function textOf(value) {
31
33
  function countOf(value) {
32
34
  return typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : null;
33
35
  }
36
+ /**
37
+ * 只给 line + group 时按上游命名规则补出三样名字(启动文件 / 设备宏 / 设备头)+ 链接脚本名。
38
+ *
39
+ * 规则不是猜的:group(x6/xb/xe/xg/xc…)本来就是从固件包
40
+ * Drivers/CMSIS/Device/ST/STM32F1xx/Source/Templates/gcc/startup_stm32f1<line><group>.s
41
+ * Drivers/CMSIS/Device/ST/STM32F1xx/Include/stm32f1<line><group>.h
42
+ * 的文件名反推出来的,group 合法时名字唯一。
43
+ *
44
+ * 内置资源 v2026.11.x 起 chips.json 只留 db/mcu 能算出来的 9 个字段
45
+ * (cpn/line/group/packageName/pinCount/flashBytes/ramBytes/deviceId/mcuName),这三样由这里现补;
46
+ * 老版本资源(v2026.10.31-1 及更早)自带显式字段,优先用包里的 —— 新插件读老缓存照样能用。
47
+ */
48
+ export function namingFrom(line, group, deviceId) {
49
+ // line 三到四字符且可能带字母(L4+ 的 4P5、WBA 的 BA50 —— startup_stm32wba50xx.s);group 两种形态:按容量(x6/xb/xx)或按封装(cx/rx/tx)。
50
+ if (!/^[0-9A-Z]{3,4}$/u.test(line) || !/^(?:x[0-9a-z]|[0-9a-z]x)$/u.test(group)) {
51
+ return { startup: "", deviceDefine: "", deviceHeader: "", linkerScript: "" };
52
+ }
53
+ // 族字母从型号名里取(STM32F103C8Tx → F;STM32L4P5AGIx → L),不写死 F。
54
+ const letter = /^STM32([A-Z])/u.exec(deviceId)?.[1] ?? "F";
55
+ // 文件名全小写:L4+ 的 line 是 4P5(带字母),固件包里那份叫 startup_stm32l4p5xx.s。
56
+ const lowerLine = line.toLowerCase();
57
+ return {
58
+ startup: "startup_stm32" + letter.toLowerCase() + lowerLine + group + ".s",
59
+ deviceDefine: "STM32" + letter + line + defineSuffix(group),
60
+ deviceHeader: "stm32" + letter.toLowerCase() + lowerLine + group + ".h",
61
+ linkerScript: deviceId === "" ? "" : deviceId + "_FLASH.ld",
62
+ };
63
+ }
64
+ /**
65
+ * 启动文件尾缀 → 设备宏尾缀(大写的是「不是 x 的那个字符」,x 永远小写):
66
+ * xb → xB(STM32F103xB)、xx → xx(STM32F407xx)、cx → Cx(STM32F410Cx,按封装分档那种)。
67
+ * 与资源脚本 scripts/family-assets.mjs 的 defineSuffix 必须逐字一致。
68
+ */
69
+ export function defineSuffix(group) {
70
+ if (group === "xx")
71
+ return "xx";
72
+ if (group.charAt(0) === "x")
73
+ return "x" + group.charAt(1).toUpperCase();
74
+ return group.charAt(0).toUpperCase() + group.charAt(1);
75
+ }
34
76
  /**
35
77
  * 一条 chips.json 记录 → DeviceFactsChip。
36
- * 关键字段(cpn / line / group / 启动文件 / 设备宏 / 设备头 / Flash / RAM / 引脚数)缺一个就丢掉:
78
+ * 关键字段(cpn / line / group / Flash / RAM / 引脚数)缺一个就丢掉:
37
79
  * 半条事实比没有事实更危险——它会算出错误的链接脚本内存布局。
80
+ * 启动文件 / 设备宏 / 设备头 缺失时按 line + group 现算(见 namingFrom)。
38
81
  */
39
82
  function chipFrom(value) {
40
83
  if (!isRecord(value))
@@ -42,9 +85,11 @@ function chipFrom(value) {
42
85
  const cpn = textOf(value["cpn"]).toUpperCase();
43
86
  const line = textOf(value["line"]);
44
87
  const group = textOf(value["group"]).toLowerCase();
45
- const startup = textOf(value["startup"]);
46
- const deviceDefine = textOf(value["deviceDefine"]);
47
- const deviceHeader = textOf(value["deviceHeader"]);
88
+ const deviceId = textOf(value["deviceId"]);
89
+ const derived = namingFrom(line, group, deviceId);
90
+ const startup = textOf(value["startup"]) || derived.startup;
91
+ const deviceDefine = textOf(value["deviceDefine"]) || derived.deviceDefine;
92
+ const deviceHeader = textOf(value["deviceHeader"]) || derived.deviceHeader;
48
93
  const pinCount = countOf(value["pinCount"]);
49
94
  const flashBytes = countOf(value["flashBytes"]);
50
95
  const ramBytes = countOf(value["ramBytes"]);
@@ -63,12 +108,12 @@ function chipFrom(value) {
63
108
  pinCount,
64
109
  flashBytes,
65
110
  ramBytes,
66
- deviceId: textOf(value["deviceId"]),
111
+ deviceId,
67
112
  mcuName: textOf(value["mcuName"]),
68
113
  startup,
69
114
  deviceDefine,
70
115
  deviceHeader,
71
- linkerScript: textOf(value["linkerScript"]),
116
+ linkerScript: textOf(value["linkerScript"]) || derived.linkerScript,
72
117
  ...(breakpoints === null || breakpoints <= 0 ? {} : { breakpoints: Math.trunc(breakpoints) }),
73
118
  ...(watchpoints === null || watchpoints <= 0 ? {} : { watchpoints: Math.trunc(watchpoints) }),
74
119
  };
@@ -130,25 +175,50 @@ export function parseDeviceFacts(text, filePath, version = "") {
130
175
  /**
131
176
  * 读设备事实(内存缓存一次,按 path+size+mtimeMs 自动失效)。
132
177
  *
133
- * env 默认 process.env:DSH_STM32_ASSETS 可以覆盖资源包根目录(测试与自定义安装用)。
178
+ * env 默认 process.env:DSH_STM32_ASSETS 可以覆盖内置资源根目录(测试与自定义安装用)。
134
179
  * 读不到不抛——返回 ok:false + 人话,让调用方(工具卡片)照常渲染。
135
180
  */
136
181
  export function loadDeviceFacts(env = process.env) {
182
+ return loadFamilyDeviceFacts("STM32F1", env);
183
+ }
184
+ /**
185
+ * 族 id → 内置资源里的设备事实相对路径:STM32F1 → device/f1/chips.json;
186
+ * STM32L4+ → device/l4+/chips.json;STM32WBA → device/wba/chips.json。
187
+ *
188
+ * 目录名取族画像的族段(小写、保留 +)—— 资源脚本就是这么建的目录。
189
+ * 不能按「前两个字符」推:WBA 会被推成 wb、L4+ 会被推成 l4(都是别的族,读到的芯片表是错的)。
190
+ */
191
+ export function familyFactsRelOf(familyId) {
192
+ const raw = familyId.trim().toUpperCase();
193
+ const line = familyProfileOf(raw).line.toLowerCase();
194
+ if (!/^[a-z0-9]{1,3}\+?$/u.test(line))
195
+ return ASSETS_DEVICE_FACTS_FILE;
196
+ return "device/" + line + "/chips.json";
197
+ }
198
+ /**
199
+ * 按族读设备事实(内存缓存一次,按 path+size+mtimeMs 自动失效)。
200
+ *
201
+ * 为什么要按族分文件:资源脚本按族生成 device/<族>/chips.json(F0/F4/G4/L0/C0…),
202
+ * 合成一个大文件会让「装了这个族但没装那个族」这件事看不出来,也没法只更新一个族。
203
+ */
204
+ export function loadFamilyDeviceFacts(familyId, env = process.env) {
205
+ const rel = familyFactsRelOf(familyId);
137
206
  const state = readLocalManifest(env);
138
- const filePath = state.versionDir === "" ? path.join(state.root, "device", "f1", "chips.json") : path.join(state.versionDir, DEVICE_FACTS_REL);
207
+ const filePath = state.versionDir === "" ? path.join(state.root, ...rel.split("/")) : path.join(state.versionDir, ...rel.split("/"));
139
208
  if (state.versionDir === "") {
140
- return emptyFacts(filePath, "", (state.error === "" ? "本地还没装资源包" : state.error) + ";设备事实只从资源包缓存读," + DEVICE_FACTS_HINT + "。");
209
+ return emptyFacts(filePath, "", (state.error === "" ? "找不到插件内置资源" : state.error) + ";设备事实只从内置资源读," + DEVICE_FACTS_HINT + "。");
141
210
  }
142
211
  let stat;
143
212
  try {
144
213
  stat = fs.statSync(filePath);
145
214
  }
146
215
  catch {
147
- return emptyFacts(filePath, state.version, "资源包 " + state.version + " 里没有 " + DEVICE_FACTS_REL + "(" + filePath + "):这一版资源包不全;" + DEVICE_FACTS_HINT + "。");
216
+ return emptyFacts(filePath, state.version, "内置资源 " + state.version + " 里没有 " + rel + "(" + filePath + "):这一版内置资源不含 " + familyId + " 的芯片表;" + DEVICE_FACTS_HINT + "。");
148
217
  }
149
218
  const key = filePath + ":" + String(stat.size) + ":" + String(stat.mtimeMs);
150
- if (cache !== null && cache.key === key)
151
- return cache.facts;
219
+ const hit = cache.get(filePath);
220
+ if (hit !== undefined && hit.key === key)
221
+ return hit.facts;
152
222
  let text;
153
223
  try {
154
224
  text = fs.readFileSync(filePath, "utf8");
@@ -157,7 +227,7 @@ export function loadDeviceFacts(env = process.env) {
157
227
  return emptyFacts(filePath, state.version, "设备事实读不了(" + filePath + "):" + errText(error) + ";" + DEVICE_FACTS_HINT + "。");
158
228
  }
159
229
  const facts = parseDeviceFacts(text, filePath, state.version);
160
- cache = { key, facts };
230
+ cache.set(filePath, { key, facts });
161
231
  return facts;
162
232
  }
163
233
  /** 型号 → 事实;没有这颗(或没有缓存)返回 null。cpn 大小写不敏感。 */
@@ -165,7 +235,8 @@ export function findChipFact(cpn, env = process.env) {
165
235
  const wanted = cpn.trim().toUpperCase();
166
236
  if (wanted === "")
167
237
  return null;
168
- const facts = loadDeviceFacts(env);
238
+ const familyId = familyIdOfPart(wanted);
239
+ const facts = familyId === "" ? loadDeviceFacts(env) : loadFamilyDeviceFacts(familyId, env);
169
240
  return facts.ok ? facts.byCpn.get(wanted) ?? null : null;
170
241
  }
171
242
  export class DeviceFactError extends Error {
@@ -181,12 +252,14 @@ export class DeviceFactError extends Error {
181
252
  /** 型号 → 事实;没有就抛 DeviceFactError(message 一定带 refresh 提示)。 */
182
253
  export function requireChipFact(cpn, env = process.env) {
183
254
  const wanted = cpn.trim().toUpperCase();
184
- const facts = loadDeviceFacts(env);
255
+ const familyId = familyIdOfPart(wanted);
256
+ const facts = familyId === "" ? loadDeviceFacts(env) : loadFamilyDeviceFacts(familyId, env);
257
+ const label = familyId === "" ? "" : familyProfileOf(familyId).id + " ";
185
258
  if (!facts.ok)
186
- throw new DeviceFactError("facts-missing", facts.error, wanted);
259
+ throw new DeviceFactError("facts-missing", label + facts.error, wanted);
187
260
  const found = facts.byCpn.get(wanted);
188
261
  if (found === undefined) {
189
- throw new DeviceFactError("chip-unknown", "资源包(" + facts.version + ")里没有 " + (wanted === "" ? "(空型号)" : wanted) + " 这颗芯片:" +
262
+ throw new DeviceFactError("chip-unknown", label + "内置资源(" + facts.version + ")里没有 " + (wanted === "" ? "(空型号)" : wanted) + " 这颗芯片:" +
190
263
  "已知 line " + (facts.lines.length === 0 ? "(无)" : facts.lines.join("/")) + ";" + DEVICE_FACTS_HINT + "。", wanted);
191
264
  }
192
265
  return found;