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.
Files changed (225) hide show
  1. package/README.md +92 -40
  2. package/README_EN.md +85 -36
  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 +94 -71
  133. package/lib/data/chips.js +38 -51
  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 +264 -17
  137. package/lib/data/db-presets.js +252 -0
  138. package/lib/data/device-facts.js +274 -0
  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 +95 -150
  148. package/lib/data/svd.js +643 -0
  149. package/lib/data/toolchain-config.js +0 -14
  150. package/lib/engine/assets.js +659 -0
  151. package/lib/engine/breakpoints.js +297 -0
  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 +576 -22
  161. package/lib/engine/debug.js +99 -46
  162. package/lib/engine/doctor.js +162 -19
  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 +317 -76
  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 +1247 -63
  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 +231 -0
  177. package/lib/engine/probe-session.js +347 -0
  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 +130 -45
  183. package/lib/engine/regs.js +43 -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 +758 -0
  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 +12 -2
  192. package/lib/skill/stm32-workflow.js +2 -2
  193. package/lib/tools/assets.js +272 -0
  194. package/lib/tools/cache.js +8 -0
  195. package/lib/tools/debug-session.js +41 -6
  196. package/lib/tools/debug.js +41 -11
  197. package/lib/tools/doctor.js +65 -4
  198. package/lib/tools/firmware-install.js +31 -6
  199. package/lib/tools/flash.js +47 -10
  200. package/lib/tools/generate.js +25 -0
  201. package/lib/tools/ioc-apply.js +2 -0
  202. package/lib/tools/ioc-inspect.js +2 -0
  203. package/lib/tools/ioc-plan.js +59 -2
  204. package/lib/tools/ioc-verify.js +237 -0
  205. package/lib/tools/project-create.js +63 -3
  206. package/lib/tools/regs.js +453 -61
  207. package/lib/tools/route-plan.js +3 -0
  208. package/lib/tools/rtt.js +470 -0
  209. package/lib/tools/watch.js +256 -0
  210. package/package.json +5 -4
  211. package/templates/openocd/stm32c0x.cfg +83 -0
  212. package/templates/openocd/stm32u0x.cfg +64 -0
  213. package/templates/register/CMakeLists.txt +8 -2
  214. package/templates/register/Core/Inc/rtt.h +138 -0
  215. package/templates/register/Core/Src/main.c +42 -25
  216. package/templates/register/Core/Src/rtt.c +373 -0
  217. package/templates/scaffold/RTT.md +90 -0
  218. package/templates/scaffold/STM32F103XX_FLASH.ld +3 -0
  219. package/templates/scaffold/cmake/user/CMakeLists.txt +7 -0
  220. package/templates/scaffold/openocd.cfg +5 -3
  221. package/templates/scaffold/vscode/launch.json +8 -4
  222. package/docs/development-notes.md +0 -2116
  223. package/docs/dsh-stm32-plugin-/350/247/204/346/240/274.md +0 -673
  224. package/docs/logic-audit.md +0 -607
  225. package/lib/data/f1-ram.generated.js +0 -34
@@ -1,102 +1,49 @@
1
1
  /**
2
- * L1:STM32F1 全系的芯片事实表(型号 → 容量档 / 启动文件 / 设备宏 / Flash / RAM)。
2
+ * L1:STM32F1 型号 → 芯片事实(容量档 / 启动文件 / 设备宏 / 设备头 / Flash / RAM / 引脚数)。
3
3
  *
4
- * 为什么单独一个文件:容量字母 → 上游启动文件的映射是事实,不是逻辑。
5
- * 加一款芯片只改这里,不动引擎。
4
+ * 这里只剩**解析逻辑**,没有事实:事实全部来自内置资源里的 device/f1/chips.json,
5
+ * 经 src/data/device-facts.ts 读入(用户 2026-10-31「内置表删了吧」的决定)。
6
+ * 所以本文件不再有 F1_LINES / GROUP_BY_LETTER / FLASH_BY_LETTER / RAM_BY_LINE_LETTER
7
+ * 这类表——加一款芯片只改 scripts/assets/ 的 scripts/build-assets.mjs,插件一个字都不用动。
6
8
  *
7
- * 取数优先级(写进 docs/development-notes.md):
8
- * 1. 固件包 `Drivers/CMSIS/Device/ST/STM32F1xx/Source/Templates/gcc` 里真实存在的启动文件
9
- * —— 实测 F1 有 14 个(100 xb/xe、101 x6/xb/xe/xg、102 x6/xb、103 x6/xb/xe/xg、105 xc、107 xc)。
10
- * 2. 本机 CubeMX 的 `db/mcu/*.xml`(Flash/RAM/引脚数,将来用作校验)。
11
- * 3. 本文件内置的容量字母表。
9
+ * 支持三种输入(与 0.2 一致,调用方不用改):
10
+ * - 完整型号:STM32F103C8T6 / STM32F103RCT6 / STM32F107VCT6
11
+ * - 去掉温度后缀:STM32F103C8(按 chips.json 里同前缀的唯一一颗归一化)
12
+ * - 显式容量档:F103:xb(脚本与 cmsis 缓存 id 用;取该档在内置资源里的一个代表型号)
12
13
  *
13
- * 关键坑:容量字母 → 容量档不是全局映射。字母 C 在 F103 上是 xE(startup_stm32f103xe.s),
14
- * 在 F105/F107 上却是 xC(startup_stm32f105xc.s)——先按「line 真有这一档」匹配,再退回全局表。
15
- */
16
- import { F1_RAM_FROM_DB } from "./f1-ram.generated.js";
17
- /** 容量字母 → 上游容量档的兜底映射(当 line 没有「x + 字母」这个档时用它)。 */
18
- const GROUP_BY_LETTER = {
19
- "4": "x6",
20
- "6": "x6",
21
- "8": "xb",
22
- B: "xb",
23
- C: "xe",
24
- D: "xe",
25
- E: "xe",
26
- F: "xg",
27
- G: "xg",
28
- };
29
- /** 容量字母 → Flash 字节(ST 的容量字母就是 Flash 档)。 */
30
- const FLASH_BY_LETTER = {
31
- "4": 16 * 1024,
32
- "6": 32 * 1024,
33
- "8": 64 * 1024,
34
- B: 128 * 1024,
35
- C: 256 * 1024,
36
- D: 384 * 1024,
37
- E: 512 * 1024,
38
- F: 768 * 1024,
39
- G: 1024 * 1024,
40
- };
41
- /**
42
- * RAM 字节。键是「line:容量字母」——一个容量档会跨多个字母,而它们的 RAM 并不相同
43
- * (F103xC 是 48 KiB,F103xE 是 64 KiB),所以不能按档查。
44
- * 只收有把握的组合;查不到返回 null 并在 notes 里说清楚,绝不猜。
14
+ * 认不出时返回 chip: null + 人话原因,绝不编一个不存在的启动文件。
15
+ * 缺内置资源时同样返回 chip: null,原因里带「重装插件后重试(stm32_assets verify 可定位缺件)」。
45
16
  */
46
- const RAM_BY_LINE_LETTER = {
47
- "103:6": 10 * 1024,
48
- "103:8": 20 * 1024,
49
- "103:B": 20 * 1024,
50
- "103:C": 48 * 1024,
51
- "103:D": 64 * 1024,
52
- "103:E": 64 * 1024,
53
- "105:C": 64 * 1024,
54
- "107:C": 64 * 1024,
55
- };
56
- /** F1 各 line 在上游真实存在的容量档(由固件包 gcc 启动文件实测得出;F106 不是独立产品线)。 */
57
- export const F1_LINES = [
58
- { code: "100", prefix: "STM32F100", groups: ["xb", "xe"], familyDir: "STM32F1xx" },
59
- { code: "101", prefix: "STM32F101", groups: ["x6", "xb", "xe", "xg"], familyDir: "STM32F1xx" },
60
- { code: "102", prefix: "STM32F102", groups: ["x6", "xb"], familyDir: "STM32F1xx" },
61
- { code: "103", prefix: "STM32F103", groups: ["x6", "xb", "xe", "xg"], familyDir: "STM32F1xx" },
62
- { code: "105", prefix: "STM32F105", groups: ["xc"], familyDir: "STM32F1xx" },
63
- { code: "107", prefix: "STM32F107", groups: ["xc"], familyDir: "STM32F1xx" },
64
- ];
65
- /** 封装字母(型号第 4 位)→ 引脚数。 */
66
- const PINS_BY_PACKAGE = {
67
- T: 36,
68
- C: 48,
69
- R: 64,
70
- V: 100,
71
- Z: 144,
72
- };
17
+ import { DEVICE_FACTS_HINT, loadDeviceFacts } from "./device-facts.js";
18
+ /** 完整型号:STM32F103RCT6 → line 103 / 封装 R / 容量 C / 后缀 T / 温度 6。 */
19
+ const CPN_PATTERN = /^STM32F(\d{3})([A-Z])([0-9A-G])([A-Z])?([0-9])?$/u;
20
+ /** 容量档写法:F103:xb(脚本、cmsis 缓存 id 用)。 */
21
+ const GROUP_PATTERN = /^F(\d{2,3}):(X[0-9A-Z]{1,2})$/u;
73
22
  /**
74
23
  * 型号 → 芯片事实。认不出返回 chip: null + 原因,绝不编一个不存在的启动文件。
75
- *
76
- * 支持三种输入:
77
- * - 完整型号:STM32F103C8T6 / STM32F103RCT6 / STM32F107VCT6
78
- * - 去掉温度后缀:STM32F103C8
79
- * - 显式容量档:F103:xb(脚本与测试用)
80
24
  */
81
25
  export function resolveF1Chip(input) {
82
26
  const text = input.trim().toUpperCase();
83
27
  if (text.length === 0)
84
28
  return { chip: null, reason: "没有给型号" };
85
- const loose = /^F(\d{2,3}):(X[0-9A-Z]{1,2})$/u.exec(text);
29
+ const facts = loadDeviceFacts();
30
+ if (!facts.ok)
31
+ return { chip: null, reason: facts.error };
32
+ const loose = GROUP_PATTERN.exec(text);
86
33
  if (loose !== null) {
87
34
  const code = loose[1] ?? "";
88
35
  const group = (loose[2] ?? "").toLowerCase();
89
- const line = F1_LINES.find((item) => item.code === code);
90
- if (line === undefined)
91
- return { chip: null, reason: lineMissing(code) };
92
- return fromGroup(line, group, "F" + code);
36
+ if (!facts.lines.includes(code))
37
+ return { chip: null, reason: lineMissing(facts, code) };
38
+ const fact = facts.byLineGroup.get(code + ":" + group);
39
+ if (fact === undefined)
40
+ return { chip: null, reason: groupMissing(facts, code, group) };
41
+ return { chip: chipFromFact(fact), reason: "" };
93
42
  }
94
- const m = /^STM32F(\d{3})([A-Z])([0-9A-G])([A-Z])?([0-9])?$/u.exec(text);
43
+ const m = CPN_PATTERN.exec(text);
95
44
  if (m === null)
96
45
  return { chip: null, reason: "不是 F1 的型号格式:" + input };
97
46
  const code = m[1] ?? "";
98
- const packageLetter = m[2] ?? "";
99
- const densityLetter = m[3] ?? "";
100
47
  const suffix = m[4] ?? "";
101
48
  const extra = m[5] ?? "";
102
49
  if (suffix.length > 0 && !"TXUYK".includes(suffix)) {
@@ -105,82 +52,80 @@ export function resolveF1Chip(input) {
105
52
  if (extra.length > 0 && !"67".includes(extra)) {
106
53
  return { chip: null, reason: "认不出温度档 " + extra + "(期望 6 或 7):" + input };
107
54
  }
108
- const line = F1_LINES.find((item) => item.code === code);
109
- if (line === undefined)
110
- return { chip: null, reason: lineMissing(code) };
111
- const group = chooseGroup(line, densityLetter);
112
- if (group === null) {
113
- const fallback = GROUP_BY_LETTER[densityLetter];
114
- if (fallback === undefined) {
115
- return { chip: null, reason: "认不出容量字母 " + densityLetter + ":" + input };
116
- }
117
- return {
118
- chip: null,
119
- reason: line.prefix + " 没有 " + fallback + " 这一容量档(上游真实档位:" + line.groups.join("/") + ")",
120
- };
55
+ if (!facts.lines.includes(code))
56
+ return { chip: null, reason: lineMissing(facts, code) };
57
+ const fact = matchFact(facts, text);
58
+ if (fact === null) {
59
+ return { chip: null, reason: unknownChip(facts, text, code, m[3] ?? "") };
121
60
  }
122
- return fromGroup(line, group, text, packageLetter, densityLetter);
61
+ return { chip: chipFromFact(fact), reason: "" };
123
62
  }
124
- function lineMissing(code) {
125
- return "F1 里没有 F" + code + " 这一 line(已知:" + F1_LINES.map((x) => x.code).join("/") + ")";
126
- }
127
- /** 先认「line 真有 x+字母」,再退回全局表;都不行返回 null。 */
128
- function chooseGroup(line, letter) {
129
- const direct = "x" + letter.toLowerCase();
130
- if (line.groups.includes(direct))
131
- return direct;
132
- const fallback = GROUP_BY_LETTER[letter];
133
- if (fallback === undefined)
63
+ /**
64
+ * 型号 → 内置资源里的那颗。先精确匹配 cpn;没有再按「cpn 以输入开头」归一化
65
+ * (STM32F103C8 → STM32F103C8T6,即用户省略了温度后缀)。
66
+ * 多命中时取 cpn 最短、再按字典序——同一份事实永远给同一个结果。
67
+ */
68
+ function matchFact(facts, text) {
69
+ const exact = facts.byCpn.get(text);
70
+ if (exact !== undefined)
71
+ return exact;
72
+ const candidates = facts.chips.filter((chip) => chip.cpn.startsWith(text));
73
+ if (candidates.length === 0)
134
74
  return null;
135
- return line.groups.includes(fallback) ? fallback : null;
75
+ candidates.sort((left, right) => {
76
+ if (left.cpn.length !== right.cpn.length)
77
+ return left.cpn.length - right.cpn.length;
78
+ return left.cpn < right.cpn ? -1 : left.cpn > right.cpn ? 1 : 0;
79
+ });
80
+ return candidates[0] ?? null;
136
81
  }
137
- function fromGroup(line, group, cpn, packageLetter = "", densityLetter = "") {
138
- const notes = [];
139
- if (!line.groups.includes(group)) {
140
- return {
141
- chip: null,
142
- reason: line.prefix + " 没有 " + group + " 这一容量档(上游真实档位:" + line.groups.join("/") + ")",
143
- };
144
- }
145
- const letter = densityLetter.length > 0 ? densityLetter : letterForGroup(group);
146
- const stem = line.prefix.toLowerCase() + group;
147
- // 先用手写表(有把握的组合),再用生成表(CubeMX db 里「容量字母与 RAM 唯一对应」的条目)。
148
- // db 给区间的分组(例如 F103R(C-D-E) 的 [48,64])不进生成表——字母对不上号时宁可不收。
149
- const handRam = RAM_BY_LINE_LETTER[line.code + ":" + letter];
150
- const dbRam = F1_RAM_FROM_DB[line.code + ":" + letter];
151
- const ramBytes = handRam ?? dbRam ?? null;
152
- if (handRam === undefined && dbRam !== undefined) {
153
- notes.push("RAM 取自 CubeMX db 的容量档值(" + line.prefix + letter + " = " + String(dbRam / 1024) + " KiB)");
154
- }
155
- if (ramBytes === null) {
156
- notes.push("RAM 大小未收录:" + line.prefix + letter + "(用 CubeMX 的 db/mcu 确认后再补表)");
157
- }
158
- if (packageLetter.length > 0 && PINS_BY_PACKAGE[packageLetter] === undefined) {
159
- notes.push("认不出封装字母 " + packageLetter + ",引脚数未知");
160
- }
82
+ function lineMissing(facts, code) {
83
+ return ("F1 里没有 F" + code + " 这一 line(内置资源已知:" + facts.lines.join("/") + ");" + DEVICE_FACTS_HINT + ",看有没有新版插件。");
84
+ }
85
+ function groupMissing(facts, code, group) {
86
+ const groups = facts.groupsByLine.get(code) ?? [];
87
+ return ("STM32F" + code + " 没有 " + group + " 这一容量档(内置资源里的档位:" + groups.join("/") + ");" +
88
+ DEVICE_FACTS_HINT + ",看有没有新版插件。");
89
+ }
90
+ /**
91
+ * 格式对、line 在,但内置资源里没有这一颗。
92
+ * 分两种情况说清楚,别把「没收录」说成「不存在」:
93
+ * · 这个容量档在内置资源里有,只是没有这个封装/温度后缀的组合(例如 C8T7);
94
+ * · 这个容量档根本没收录(上游 CubeMX 没给出这档的 RAM/Flash,或者内置资源还没覆盖,例如 F100RCT6)。
95
+ */
96
+ function unknownChip(facts, text, code, densityLetter) {
97
+ const groups = facts.groupsByLine.get(code) ?? [];
98
+ const direct = "x" + densityLetter.toLowerCase();
99
+ const inGroup = groups.includes(direct);
100
+ const detail = inGroup
101
+ ? "这一容量档在,但没有「封装 + 温度后缀」正好是这串的组合"
102
+ : "这一档没有收录(上游没给这档的 RAM/Flash,或内置资源还没覆盖)";
103
+ return ("内置资源(" + (facts.version === "" ? "未知版本" : facts.version) + ")里没有 " + text + " 这一颗:" +
104
+ "STM32F" + code + " 收录了 " + groups.join("/") + " 容量档;" + detail + ";" +
105
+ DEVICE_FACTS_HINT + ",看有没有新版插件,或换一颗同档的常见型号(内置资源共 " + String(facts.chips.length) + " 颗)。");
106
+ }
107
+ function chipFromFact(fact) {
108
+ const lineMatch = /^STM32F(\d{3})/u.exec(fact.cpn);
109
+ const densityMatch = /^STM32F\d{3}[A-Z]([0-9A-G])/u.exec(fact.cpn);
161
110
  return {
162
- chip: {
163
- cpn,
164
- prefix: line.prefix,
165
- densityLetter: letter,
166
- group,
167
- startup: "startup_" + stem + ".s",
168
- deviceDefine: line.prefix + "x" + group.slice(1).toUpperCase(),
169
- deviceHeader: stem + ".h",
170
- pinCount: packageLetter.length > 0 ? (PINS_BY_PACKAGE[packageLetter] ?? null) : null,
171
- flashBytes: FLASH_BY_LETTER[letter] ?? null,
172
- ramBytes,
173
- notes,
174
- },
175
- reason: "",
111
+ cpn: fact.cpn,
112
+ prefix: lineMatch === null ? "STM32F" + fact.line : "STM32F" + (lineMatch[1] ?? fact.line),
113
+ densityLetter: densityMatch?.[1] ?? fact.group.slice(1).toUpperCase(),
114
+ group: fact.group,
115
+ startup: fact.startup,
116
+ deviceDefine: fact.deviceDefine,
117
+ deviceHeader: fact.deviceHeader,
118
+ pinCount: fact.pinCount,
119
+ mcuName: fact.mcuName,
120
+ flashBytes: fact.flashBytes,
121
+ ramBytes: fact.ramBytes,
122
+ notes: [],
176
123
  };
177
124
  }
178
- function letterForGroup(group) {
179
- const found = Object.entries(GROUP_BY_LETTER).find(([, value]) => value === group);
180
- return found === undefined ? "" : found[0];
181
- }
182
- /** 该 line 的全部容量档(给「这个型号能选哪些档」的报告用)。 */
125
+ /** 该 line 的全部容量档(去重升序;给「这个型号能选哪些档」的报告用)。 */
183
126
  export function f1GroupsFor(code) {
184
- const line = F1_LINES.find((item) => item.code === code);
185
- return line === undefined ? [] : line.groups;
127
+ const facts = loadDeviceFacts();
128
+ if (!facts.ok)
129
+ return [];
130
+ return facts.groupsByLine.get(code.trim()) ?? [];
186
131
  }