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
@@ -0,0 +1,347 @@
1
+ /**
2
+ * B3:探针会话复用快路径(把 regs_read 从"每次 spawn 一个 openocd"降到毫秒级)。
3
+ *
4
+ * 背景:`stm32_regs_read` 原来是"起 openocd → mdw → shutdown",实测 1493 ms;而
5
+ * `stm32_debug_eval` 每次也要新起一个 `gdb -batch`。两者都太慢,但慢的不是"读",
6
+ * 是进程启动。这里把"常驻 openocd"这件事抽成一个小门面,让两条路都走它:
7
+ *
8
+ * - `ensureSession()`:没有会话就起一个(复用 `debug-session.ts` 的租约/Turn 收尾/端口让位),
9
+ * 有同项目的会话就直接复用(`reused=true`);
10
+ * - `readWordsViaSession()`:走 openocd 的 **Tcl RPC 口**(`halt` → `reg pc` → `mdw ...` →
11
+ * `resume`,一条 TCP 连接、几毫秒),这是 1493 ms → <150 ms 的关键;解析不到 Tcl 端口时
12
+ * 调用方回退到 gdb 路径;
13
+ * - `release()` / `touch()`:显式释放与续租(`turn/end`、90 s 空闲、`stm32_debug_stop` 都走 manager)。
14
+ *
15
+ * 唯一真相仍然是 `debugSessions`(单例):这里不自己存句柄、不自己算租约,只做"要不要起、
16
+ * 起完怎么用"的编排,避免出现两个都说自己握着探针的状态。
17
+ */
18
+ import { createConnection } from "node:net";
19
+ import { debugSessions } from "./debug-session.js";
20
+ import { isPortBusy } from "./debug.js";
21
+ import { classifyProbeFailure, formatProbeError, makeProbeError } from "./probe-error.js";
22
+ /** 默认 gdb 端口(与 debug_run / debug_session 一致)。 */
23
+ export const DEFAULT_PROBE_PORT = 3333;
24
+ /** 空闲多久自动关(沿用 L2 会话的 90 s 租约)。 */
25
+ export const DEFAULT_SESSION_IDLE_TTL_MS = 90_000;
26
+ /**
27
+ * Tcl RPC 协议:每条命令以 0x1a 结尾,每个响应也以 0x1a 结尾(不含回显)。
28
+ * 这里不用 `\n`——openocd 的 Tcl 口按 0x1a 分帧,用换行会卡住等不到响应。
29
+ */
30
+ const TCL_FRAME = String.fromCharCode(0x1a);
31
+ /**
32
+ * 响应帧收齐后立刻收尾:帧是按 0x1a 完整切出来的,计数够了就说明每条命令都回了,
33
+ * 不需要再等一个"庄家时间"(那会让每次读白等几十毫秒)。
34
+ */
35
+ const TCL_DONE_MS = 0;
36
+ /** 响应不齐(比如某条命令被 openocd 拒了但没回帧)时的兜底等待。 */
37
+ const TCL_IDLE_MS = 120;
38
+ /** 并发去重:同时来两个 ensureSession 时只起一个 openocd(后到的直接复用同一个 Promise)。 */
39
+ let starting = null;
40
+ function normalizeDir(dir) {
41
+ return dir.trim().replace(/[\\/]+$/u, "").replace(/\\/gu, "/").toLowerCase();
42
+ }
43
+ function sameProject(left, right) {
44
+ return normalizeDir(left) === normalizeDir(right);
45
+ }
46
+ /** 当前会话信息(没有就是 null)。idleDeadline 由 manager 的 remainingMs 反推,不另算一套。 */
47
+ export function sessionInfo() {
48
+ const status = debugSessions.status();
49
+ if (!status.active)
50
+ return null;
51
+ return {
52
+ port: status.port,
53
+ tclPort: status.tclPort,
54
+ configFile: status.configFile,
55
+ projectDir: status.projectDir,
56
+ startedAt: status.startedAt,
57
+ idleDeadline: Date.now() + status.remainingMs,
58
+ };
59
+ }
60
+ /** 续租(每读一次都算"用过")。 */
61
+ export function touch() {
62
+ return debugSessions.touch();
63
+ }
64
+ /**
65
+ * 显式释放(stm32_debug_stop、rtt stop、进程退出等)。
66
+ * options.requireOwner 给定时,只有会话的 owner 对得上才关——多 agent 并行时不要收走别人的探针。
67
+ */
68
+ export async function release(reason = "显式释放", options = {}) {
69
+ return await debugSessions.stop(reason, options);
70
+ }
71
+ /**
72
+ * 保证有一个可用的调试会话:
73
+ * - 已有同项目会话 → 直接复用(续租);
74
+ * - 没有 → 起一个(端口被占先报 probe-busy,不让 openocd 顺延到别的口偷偷抢探针);
75
+ * - 并发调用 → 只起一个进程。
76
+ */
77
+ export async function ensureSession(projectDir, options = {}) {
78
+ const current = sessionInfo();
79
+ let replacedDead = false;
80
+ if (current !== null && sameProject(current.projectDir, projectDir)) {
81
+ const probeAlive = options.checkSessionAlive ?? sessionLooksAlive;
82
+ if (await probeAlive(current)) {
83
+ touch();
84
+ return {
85
+ ok: true,
86
+ reused: true,
87
+ replacedDead: false,
88
+ session: sessionInfo(),
89
+ probeError: null,
90
+ message: "复用已有调试会话(gdb 端口 " + String(current.port) + ",tcl 端口 " + String(current.tclPort) + ")",
91
+ };
92
+ }
93
+ // 真机踩过:探针 HID 掉线后 openocd 自己退出,会话记录却还在,于是后续每个工具都报
94
+ // 「复用已有调试会话」然后全程失败。这里发现 Tcl 端口连不上就清掉记录、重起一个。
95
+ await debugSessions.stop("旧会话的 openocd 已经不在了(探针掉线/被 HID 错误带走),清掉记录后重起");
96
+ replacedDead = true;
97
+ }
98
+ if (starting !== null)
99
+ return await starting;
100
+ const idleTtlMs = options.idleTtlMs ?? DEFAULT_SESSION_IDLE_TTL_MS;
101
+ const promise = startSession(projectDir.trim() === "" ? projectDir : projectDir, idleTtlMs, options).finally(() => {
102
+ starting = null;
103
+ });
104
+ starting = promise;
105
+ const result = await promise;
106
+ return result.ok && replacedDead
107
+ ? { ...result, replacedDead: true, message: "旧会话的 openocd 已经不在了,已重起:" + result.message }
108
+ : result.ok
109
+ ? { ...result, replacedDead: false }
110
+ : { ...result, replacedDead };
111
+ }
112
+ /**
113
+ * 会话还活着吗:openocd 的 Tcl 端口还能连上就算活着。
114
+ * 用 Tcl 而不是 gdb 口:Tcl 口在 openocd 起来时先监听,坏掉时也最先断;连一下 500 ms 就够。
115
+ */
116
+ export async function sessionLooksAlive(info) {
117
+ const port = info.tclPort > 0 ? info.tclPort : info.port;
118
+ if (port <= 0)
119
+ return true; /* 两个端口都没有,没法判,当活着(真失败会在下一步报出来) */
120
+ return await isPortBusy(port, 500);
121
+ }
122
+ async function startSession(projectDir, idleTtlMs, options) {
123
+ if (options.subprocess !== undefined)
124
+ debugSessions.configure(options.subprocess, options.binDirs ?? []);
125
+ if (options.checkSessionAlive !== undefined) {
126
+ // 同一个注入探针也给 manager 用:起会话之后那次「确认 openocd 没当场死」不该去打真端口。
127
+ const injected = options.checkSessionAlive;
128
+ debugSessions.setAliveProbe(async () => {
129
+ const info = sessionInfo();
130
+ return info === null ? true : await injected(info);
131
+ });
132
+ }
133
+ const port = options.port ?? DEFAULT_PROBE_PORT;
134
+ const checkBusy = options.checkPortBusy ?? isPortBusy;
135
+ if (options.portBusyIsError !== false && (await checkBusy(port))) {
136
+ const probeError = makeProbeError("probe-busy", {
137
+ cause: "gdb 端口 " + String(port) + " 已被占用(多半是 VS Code 的调试会话或另一个 openocd 还握着探针)",
138
+ evidence: ["probe port " + String(port) + " busy"],
139
+ });
140
+ return { ok: false, reused: false, replacedDead: false, session: null, probeError, message: formatProbeError(probeError) };
141
+ }
142
+ const started = await debugSessions.start({
143
+ projectDir,
144
+ port,
145
+ idleTtlMs,
146
+ ...(options.elfPath === undefined ? {} : { elfPath: options.elfPath }),
147
+ ...(options.configFile === undefined || options.configFile === "" ? {} : { configFile: options.configFile }),
148
+ ...(options.adapterSpeed === undefined ? {} : { adapterSpeed: options.adapterSpeed }),
149
+ ...(options.binDirs === undefined ? {} : { binDirs: options.binDirs }),
150
+ ...(options.owner === undefined ? {} : { owner: options.owner }),
151
+ });
152
+ if (!started.ok) {
153
+ // 起会话失败的日志已经在 report.errors 里:归类只走 probe-error 那一张表。
154
+ const probeError = classifyProbeFailure({ lines: started.errors, stage: "session" });
155
+ return { ok: false, reused: false, replacedDead: false, session: null, probeError, message: formatProbeError(probeError) };
156
+ }
157
+ return {
158
+ ok: true,
159
+ reused: false,
160
+ replacedDead: false,
161
+ session: sessionInfo(),
162
+ probeError: null,
163
+ message: "起了调试会话(gdb 端口 " + String(started.port) + ",tcl 端口 " + String(started.tclPort) + ",空闲 " + String(Math.round(idleTtlMs / 1000)) + " s 后自动关)",
164
+ };
165
+ }
166
+ /**
167
+ * 在会话里跑一段操作:拿不到会话就把 probeError 原样带出来(调用方只负责格式化)。
168
+ * 失败也 touch()——会话本身是好的,只是一次读取失败,不该被提前回收。
169
+ */
170
+ export async function withSession(fn, projectDir, options = {}) {
171
+ const ensured = await ensureSession(projectDir, options);
172
+ if (!ensured.ok || ensured.session === null) {
173
+ return { ok: false, reused: ensured.reused, session: null, value: null, probeError: ensured.probeError, message: ensured.message };
174
+ }
175
+ try {
176
+ const value = await fn(ensured.session);
177
+ touch();
178
+ return { ok: true, reused: ensured.reused, session: ensured.session, value, probeError: null, message: ensured.message };
179
+ }
180
+ catch (error) {
181
+ touch();
182
+ const detail = error instanceof Error ? error.message : String(error);
183
+ const probeError = makeProbeError("unknown", { cause: "会话内操作失败:" + detail, evidence: [detail] });
184
+ return { ok: false, reused: ensured.reused, session: ensured.session, value: null, probeError, message: formatProbeError(probeError) };
185
+ }
186
+ }
187
+ /** 把 "0x4001100c" / "4001100C" 统一成 8 位小写 0x 形式;解析不了返回 null。 */
188
+ export function normalizeWordAddress(text) {
189
+ const body = text.trim().replace(/^0x/iu, "");
190
+ if (!/^[0-9a-f]{1,8}$/iu.test(body))
191
+ return null;
192
+ return "0x" + body.toLowerCase().padStart(8, "0");
193
+ }
194
+ /**
195
+ * 解析 `mdw <addr>` 的响应:openocd 回 `0x4001100c: 00000020`(值可能不带 0x)。
196
+ * 少数构建只回一个裸值,那就把地址留空、由调用方按序号对齐。
197
+ */
198
+ export function parseMdwReply(reply) {
199
+ const framed = /(?:0x)?([0-9a-f]{1,16})\s*:\s*(?:0x)?([0-9a-f]{1,8})/iu.exec(reply);
200
+ if (framed !== null) {
201
+ const address = normalizeWordAddress(framed[1] ?? "");
202
+ const value = "0x" + (framed[2] ?? "").toLowerCase().padStart(8, "0");
203
+ if (address === null)
204
+ return null;
205
+ return { address, value };
206
+ }
207
+ const bare = /^\s*(?:0x)?([0-9a-f]{1,8})\s*$/iu.exec(reply);
208
+ if (bare === null)
209
+ return null;
210
+ return { address: "", value: "0x" + (bare[1] ?? "").toLowerCase().padStart(8, "0") };
211
+ }
212
+ /** 解析 `reg pc` 的响应:Tcl 的 reg 返回 `pc (/32): 0x0800012c`,也兼容裸 0x 值。 */
213
+ export function parsePcReply(reply) {
214
+ const named = /pc\s*(?:\(\s*\/\s*32\s*\))?\s*:?\s*(0x[0-9a-f]{1,8})/iu.exec(reply);
215
+ if (named !== null)
216
+ return (named[1] ?? "").toLowerCase();
217
+ const any = /(0x[0-9a-f]{1,8})/iu.exec(reply);
218
+ if (any !== null)
219
+ return (any[1] ?? "").toLowerCase();
220
+ const bare = /^\s*([0-9a-f]{1,8})\s*$/iu.exec(reply);
221
+ return bare === null ? "" : "0x" + (bare[1] ?? "").toLowerCase().padStart(8, "0");
222
+ }
223
+ /**
224
+ * 一次 Tcl RPC 往返:连上 openocd 的 Tcl 口,按 0x1a 分帧发命令,收齐响应就断开。
225
+ * 返回 ok=false 时调用方应回退到 gdb 路径(不该把整个 regs_read 判死)。
226
+ */
227
+ export async function tclRoundTrip(port, commands, timeoutMs = 5_000, signal) {
228
+ const startedAt = Date.now();
229
+ const empty = { ok: false, replies: [], output: "", durationMs: 0 };
230
+ if (!Number.isInteger(port) || port <= 0)
231
+ return { ...empty, error: "没有可用的 Tcl 端口(openocd 日志里没有 tcl 那一行)" };
232
+ if (signal?.aborted === true)
233
+ return { ...empty, error: "已取消" };
234
+ return await new Promise((resolve) => {
235
+ const socket = createConnection({ host: "127.0.0.1", port });
236
+ const replies = [];
237
+ let buffer = "";
238
+ let settled = false;
239
+ let idleTimer = null;
240
+ let hardTimer = null;
241
+ const finish = (error) => {
242
+ if (settled)
243
+ return;
244
+ settled = true;
245
+ if (idleTimer !== null)
246
+ clearTimeout(idleTimer);
247
+ if (hardTimer !== null)
248
+ clearTimeout(hardTimer);
249
+ signal?.removeEventListener("abort", onAbort);
250
+ socket.destroy();
251
+ resolve({ ok: error === null && replies.length > 0, replies, output: replies.join("\n"), error, durationMs: Date.now() - startedAt });
252
+ };
253
+ const onAbort = () => {
254
+ finish("已取消");
255
+ };
256
+ const onData = (chunk) => {
257
+ buffer += chunk;
258
+ let frame = buffer.indexOf(TCL_FRAME);
259
+ while (frame >= 0) {
260
+ replies.push(buffer.slice(0, frame));
261
+ buffer = buffer.slice(frame + TCL_FRAME.length);
262
+ frame = buffer.indexOf(TCL_FRAME);
263
+ }
264
+ if (idleTimer !== null)
265
+ clearTimeout(idleTimer);
266
+ // 收齐了就立刻收尾;没齐就按空闲兜底(万一某条命令没回帧,也不至于卡死)。
267
+ idleTimer = setTimeout(() => { finish(null); }, replies.length >= commands.length ? TCL_DONE_MS : TCL_IDLE_MS);
268
+ };
269
+ signal?.addEventListener("abort", onAbort, { once: true });
270
+ hardTimer = setTimeout(() => { finish("Tcl 往返超时(" + String(timeoutMs) + " ms)"); }, Math.max(500, timeoutMs));
271
+ socket.setEncoding("utf8");
272
+ socket.on("connect", () => {
273
+ for (const command of commands)
274
+ socket.write(command + TCL_FRAME);
275
+ });
276
+ socket.on("data", onData);
277
+ socket.on("error", (error) => {
278
+ finish("连不上 openocd 的 Tcl 口:" + error.message);
279
+ });
280
+ });
281
+ }
282
+ /**
283
+ * 走会话的 Tcl 口读 pc + 一组字:`halt` → `reg pc` → `mdw x N` → `resume`。
284
+ * 这是 B3 的主路径(本机实测单次 < 150 ms);失败时调用方回退到 gdb(debug_sessions.read_words)。
285
+ */
286
+ export async function readWordsViaSession(request) {
287
+ const startedAt = Date.now();
288
+ const info = sessionInfo();
289
+ const base = { ok: false, pc: "", samples: [], command: "", output: "" };
290
+ if (info === null)
291
+ return { ...base, durationMs: 0, error: "没有可复用的调试会话(先 ensureSession)" };
292
+ if (info.tclPort <= 0)
293
+ return { ...base, durationMs: 0, error: "会话没有 Tcl 端口(openocd 日志里没有 tcl 那一行),改用 gdb 读" };
294
+ const wanted = [];
295
+ for (const address of request.addresses) {
296
+ const normalized = normalizeWordAddress(address);
297
+ if (normalized !== null)
298
+ wanted.push(normalized);
299
+ }
300
+ const commands = ["halt", "reg pc", ...wanted.map((address) => "mdw " + address), "resume"];
301
+ const round = await tclRoundTrip(info.tclPort, commands, request.timeoutMs ?? 5_000, request.signal);
302
+ if (!round.ok) {
303
+ return { ...base, command: commands.join("; "), output: round.output, durationMs: Date.now() - startedAt, error: round.error };
304
+ }
305
+ touch();
306
+ const pcReply = round.replies[1] ?? "";
307
+ const pc = parsePcReply(pcReply);
308
+ const byAddress = new Map();
309
+ const byIndex = [];
310
+ for (let index = 0; index < wanted.length; index += 1) {
311
+ const reply = round.replies[2 + index] ?? "";
312
+ const parsed = parseMdwReply(reply);
313
+ if (parsed === null) {
314
+ byIndex.push("");
315
+ continue;
316
+ }
317
+ byIndex.push(parsed.value);
318
+ if (parsed.address !== "")
319
+ byAddress.set(parsed.address, parsed.value);
320
+ }
321
+ const samples = wanted.map((address, index) => {
322
+ const value = byAddress.get(address) ?? byIndex[index] ?? "";
323
+ return { address, value, ok: value !== "" };
324
+ });
325
+ const failed = samples.filter((sample) => !sample.ok).length;
326
+ return {
327
+ ok: failed === 0,
328
+ pc,
329
+ samples,
330
+ command: commands.join("; "),
331
+ output: round.output,
332
+ durationMs: Date.now() - startedAt,
333
+ error: failed === 0 ? null : "有 " + String(failed) + " 个地址没读到值",
334
+ };
335
+ }
336
+ /**
337
+ * 进程退出前的尽力清理:exit 里不能 await,只让 manager 发终止信号。
338
+ * 不这么做的话,插件宿主重启后可能留下一个握死探针的 openocd(VS Code 那边就 F5 不动了)。
339
+ */
340
+ process.once("exit", () => {
341
+ try {
342
+ debugSessions.terminateSync();
343
+ }
344
+ catch {
345
+ // exit 阶段不能抛。
346
+ }
347
+ });
@@ -263,6 +263,21 @@ export function buildTargets(config) {
263
263
  ],
264
264
  verify: "ninja --version",
265
265
  },
266
+ {
267
+ id: "cubeprogrammer",
268
+ label: "STM32CubeProgrammer(CLI 烧录第二后端)",
269
+ candidates: (config.cubePrgBins ?? []).map((dir) => dir + "/STM32_Programmer_CLI.exe"),
270
+ // 只确认文件在:这货是 Java 启动器,--version 也要起 JVM,别为探测等它 5 秒。
271
+ versionArgs: [],
272
+ required: false,
273
+ hint: "可选:openocd 烧不动时的第二后端(只认 ST-LINK 探针);装在 ST 官网包,或用 STM32_CUBE_PRG_ROOT 指到安装根/bin",
274
+ impact: "只影响烧录兜底:openocd 的 target 脚本覆盖不到这族、或探针驱动对不上时,stm32_flash 会试 STM32_Programmer_CLI 补位;编译/调试/生成都不受影响,DAPLink 探针本来也没这条腿。",
275
+ install: [
276
+ "官网装 STM32CubeProgrammer(默认路径即可被自动发现):https://www.st.com/en/development-tools/stm32cubeprog.html",
277
+ "装到别处:把 bin 目录(含 STM32_Programmer_CLI.exe)写进 STM32_CUBE_PRG_ROOT,或 ~/.dsh-stm32/config.json",
278
+ ],
279
+ verify: "STM32_Programmer_CLI.exe -l(列出可用接口)",
280
+ },
266
281
  {
267
282
  id: "cubemx",
268
283
  label: "STM32CubeMX(启动器)",
@@ -273,10 +288,10 @@ export function buildTargets(config) {
273
288
  impact: "只影响建工程与重新生成代码:stm32_project_create 和改 .ioc 后的 stm32_generate 用不了;编译、烧录、调试、以及 stm32_ioc_inspect / stm32_ioc_plan 的只读分析都不受影响。",
274
289
  install: [
275
290
  "官网下载安装(winget 里没有):https://www.st.com/en/development-tools/stm32cubemx.html;装到默认目录 " + cubeMxDefaultRoot + " 会被自动发现",
276
- "装在别处:设 STM32_CUBEMX_ROOT=<安装根>(根下要有 STM32CubeMX.exe 和 jre/bin/java.exe),或把路径传给 stm32_env_probe 的 cubeMxRoots",
291
+ "装在别处:设 STM32_CUBEMX_ROOT=<安装根>(根下要有 STM32CubeMX.exe 和 jre/bin/java.exe),或把路径传给 stm32_doctor 的 cubeMxRoots",
277
292
  "装完自检:<安装根>/jre/bin/java.exe -version 能打印版本",
278
293
  ],
279
- verify: "重跑一次 stm32_env_probe,cubemx 与 cubemx-java 两项都变成 OK",
294
+ verify: "重跑一次 stm32_doctor,cubemx 与 cubemx-java 两项都变成 OK",
280
295
  },
281
296
  {
282
297
  id: "cubemx-java",
@@ -290,7 +305,7 @@ export function buildTargets(config) {
290
305
  "用官网安装包重装 STM32CubeMX(自带 JRE);只拷一个 exe 是不够的",
291
306
  "装完自检:<安装根>/jre/bin/java.exe -version",
292
307
  ],
293
- verify: "重跑一次 stm32_env_probe,cubemx-java 变成 OK",
308
+ verify: "重跑一次 stm32_doctor,cubemx-java 变成 OK",
294
309
  },
295
310
  ];
296
311
  }
@@ -130,3 +130,44 @@ export function renderClockInit(plan) {
130
130
  push(" cfgr |= ((uint32_t)(DSH_PLL_MUL - 2u) << RCC_CFGR_PLLMULL_Pos);", " } else {", " cfgr |= ((uint32_t)(DSH_HSI_MUL - 2u) << RCC_CFGR_PLLMULL_Pos); /* 0 = HSI/2 进 PLL */", " }", " RCC->CFGR = cfgr;", "", " /* 6) 开 PLL 等锁定,然后把 SYSCLK 切到 PLL 并等 SWS 确认 */", " RCC->CR |= RCC_CR_PLLON;", " spin = 0u;", " while (((RCC->CR & RCC_CR_PLLRDY) == 0u) && (spin < 100000u)) { spin++; }", " cfgr = RCC->CFGR;", " cfgr = (cfgr & ~RCC_CFGR_SW_Msk) | RCC_CFGR_SW_PLL;", " RCC->CFGR = cfgr;", " spin = 0u;", " while (((RCC->CFGR & RCC_CFGR_SWS_Msk) != RCC_CFGR_SWS_PLL) && (spin < 100000u)) { spin++; }", "", " /* 7) 让 SystemCoreClock 跟着变,delay_ms / SysTick 才是对的数 */", " SystemCoreClockUpdate();", "}", "");
131
131
  return lines.join("\n");
132
132
  }
133
+ /**
134
+ * 非 F1 的时钟:不生成 PLL 配置。
135
+ *
136
+ * 为什么先不做:PLL 源选择、倍频/分频字段、Flash 等待周期、电压调节(L4 的 VOS、G4 的
137
+ * boost)每代都不同,HSE 频率还随板子变(8/16/25 MHz 都有)。凭"看起来差不多"写一段
138
+ * PLL 代码,最常见的结局是用户烧进去板子起不来,而且没有任何提示。
139
+ *
140
+ * 现状是诚实的:复位后由启动文件里的 SystemInit()(system_<族>xx.c)决定时钟,多数族
141
+ * 默认跑 HSI;我们不覆盖它,也不谎称一个频率。要用 PLL 就在 main.c 的 clock_init() 里
142
+ * 按该族 RM 的 RCC 章补,那一块留了注释和空函数。
143
+ */
144
+ export function planGenericClock(chip) {
145
+ return {
146
+ mcu: chip.cpn,
147
+ family: chip.family,
148
+ sysclkHz: 0,
149
+ summary: "复位默认时钟(由 " + chip.systemC + " 的 SystemInit 决定;寄存器版没有生成 PLL 配置)",
150
+ warnings: [
151
+ "时钟没有配 PLL:复位后由 " + chip.systemC + " 里的 SystemInit() 决定(多数族是 HSI)。" +
152
+ "要跑到芯片上限,请在 main.c 的 clock_init() 里按 " + chip.family + " 参考手册的 RCC 章补 PLL 配置" +
153
+ "(源/倍频/分频/Flash 等待周期各代不同,所以没有替你猜);改完把 DSH_SYSCLK_HZ 与 SystemCoreClock 对上。",
154
+ ],
155
+ };
156
+ }
157
+ /** 生成非 F1 的 clock_init():空函数 + 说明,保持复位时钟。 */
158
+ export function renderGenericClockInit(plan) {
159
+ return [
160
+ "/* ---------------------------------------------------------------------------",
161
+ " * 时钟:" + plan.mcu + " —— " + plan.summary,
162
+ " * 这段刻意是空的:PLL 配置按族/按板子(HSE 频率)不同,写错会让芯片起不来。",
163
+ " * 保持 system_<族>xx.c 里 SystemInit() 的结果(SystemCoreClock 已经是真实值),",
164
+ " * delay_ms 与 SysTick 都按它算,所以不改也能正常跑。",
165
+ " * 要更高主频:按本族 RM 的 RCC 章在这里配 PLL,并把 SystemCoreClockUpdate() 调一次。",
166
+ " * -------------------------------------------------------------------------*/",
167
+ "static void clock_init(void)",
168
+ "{",
169
+ " /* 有意留空:复位时钟(见上面注释)。 */",
170
+ "}",
171
+ "",
172
+ ].join("\n");
173
+ }
@@ -0,0 +1,115 @@
1
+ /**
2
+ * 寄存器版模板里的 LED 初始化(GPIO)——按族给不同的寄存器写法。
3
+ *
4
+ * 为什么必须按族:GPIO 的时钟门与配置寄存器在两代之间都变了。
5
+ * · F1:RCC->APB2ENR 的 IOPxEN + CRL/CRH(每引脚 4 位 MODE/CNF)
6
+ * · F2/F4/F7:RCC->AHB1ENR + MODER(每引脚 2 位)
7
+ * · F0/F3/L1:RCC->AHBENR + MODER
8
+ * · G4/L4:RCC->AHB2ENR + MODER
9
+ * · C0/G0/L0/U0:RCC->IOPENR + MODER
10
+ * 拿 F1 的写法去配 F4,编译就过(GPIOC->CRH 在 F4 头里不存在?实际是 GPIO_TypeDef 没有 CRH
11
+ * 字段 → 编译期就报错),所以这张表不是"风格选择",是能不能编过的问题。
12
+ *
13
+ * 这张表是按族实测编译过的(见 docs §82 的 build matrix);新增族必须先真编一次再加进来。
14
+ */
15
+ // 这张表是编译器逼出来的,不是抄手册的:F2 的 GPIO 已经是 MODER、时钟在 AHB1ENR(拿 F1 的 CRH
16
+ // 直接报 "GPIO_TypeDef has no member named CRH");F3 有 MODER 但时钟门叫 AHBENR(不是 AHB1ENR)。
17
+ const STYLE_BY_FAMILY = {
18
+ F1: "f1-legacy",
19
+ F2: "moder-ahb1",
20
+ F3: "moder-ahb",
21
+ F4: "moder-ahb1",
22
+ F7: "moder-ahb1",
23
+ F0: "moder-ahb",
24
+ L1: "moder-ahb",
25
+ G4: "moder-ahb2",
26
+ L4: "moder-ahb2",
27
+ C0: "moder-iopenr",
28
+ G0: "moder-iopenr",
29
+ L0: "moder-iopenr",
30
+ U0: "moder-iopenr",
31
+ };
32
+ export function ledStyleOf(family) {
33
+ return STYLE_BY_FAMILY[family.toUpperCase()] ?? "none";
34
+ }
35
+ /** 生成 led_init()/led_toggle()。默认 PC13(蓝丸/多数最小系统板)。 */
36
+ export function renderLedFunctions(family) {
37
+ const style = ledStyleOf(family);
38
+ if (style === "none") {
39
+ return {
40
+ text: [
41
+ "/* 这一族还没有验证过的 GPIO 写法:led_init()/led_toggle() 留空,工程照常编译/烧录。",
42
+ " * 点灯请按本族参考手册的 GPIO 章补(时钟门 + MODER/CRL/CRH),或改用 HAL 路线。 */",
43
+ "static void led_init(void)",
44
+ "{",
45
+ "}",
46
+ "",
47
+ "static void led_toggle(void)",
48
+ "{",
49
+ "}",
50
+ "",
51
+ ].join("\n"),
52
+ warnings: ["这一族(" + family + ")还没有验证过的寄存器版 GPIO 写法:模板的 LED 是空函数,工程能编译能烧,但不会闪。"],
53
+ };
54
+ }
55
+ const clockLine = {
56
+ "moder-ahb1": " RCC->AHB1ENR |= RCC_AHB1ENR_GPIOCEN;",
57
+ "moder-ahb": " RCC->AHBENR |= RCC_AHBENR_GPIOCEN;",
58
+ "moder-ahb2": " RCC->AHB2ENR |= RCC_AHB2ENR_GPIOCEN;",
59
+ "moder-iopenr": " RCC->IOPENR |= RCC_IOPENR_GPIOCEN;",
60
+ };
61
+ if (style === "f1-legacy") {
62
+ return {
63
+ text: [
64
+ "static void led_init(void)",
65
+ "{",
66
+ "#if LED_PIN == 13u",
67
+ " RCC->APB2ENR |= RCC_APB2ENR_IOPCEN;",
68
+ " GPIOC->CRH &= ~(GPIO_CRH_MODE13 | GPIO_CRH_CNF13);",
69
+ " GPIOC->CRH |= GPIO_CRH_MODE13_0; /* 推挽输出 10 MHz */",
70
+ " GPIOC->BSRR = GPIO_BSRR_BS13; /* 先给高电平:PC13 低电平点亮 → LED 灭 */",
71
+ "#else",
72
+ "#error \"只写好了 PC13 的初始化;换引脚请在 led_init() 里补对应的 CRL/CRH 设置\"",
73
+ "#endif",
74
+ "}",
75
+ "",
76
+ "static void led_toggle(void)",
77
+ "{",
78
+ "#if LED_PIN == 13u",
79
+ " GPIOC->ODR ^= GPIO_ODR_ODR13;",
80
+ "#else",
81
+ "#error \"只写好了 PC13 的翻转;换引脚请改这里\"",
82
+ "#endif",
83
+ "}",
84
+ "",
85
+ ].join("\n"),
86
+ warnings: [],
87
+ };
88
+ }
89
+ return {
90
+ text: [
91
+ "static void led_init(void)",
92
+ "{",
93
+ "#if LED_PIN == 13u",
94
+ clockLine[style],
95
+ " /* MODER:每引脚 2 位;01 = 通用输出 */",
96
+ " GPIOC->MODER = (GPIOC->MODER & ~(3u << (13u * 2u))) | (1u << (13u * 2u));",
97
+ " GPIOC->BSRR = (1u << 13u); /* 先给高电平:PC13 低电平点亮 → LED 灭 */",
98
+ "#else",
99
+ "#error \"只写好了 PC13 的初始化;换引脚请改 MODER 的位\"",
100
+ "#endif",
101
+ "}",
102
+ "",
103
+ "static void led_toggle(void)",
104
+ "{",
105
+ "#if LED_PIN == 13u",
106
+ " GPIOC->ODR ^= (1u << 13u);",
107
+ "#else",
108
+ "#error \"只写好了 PC13 的翻转;换引脚请改这里\"",
109
+ "#endif",
110
+ "}",
111
+ "",
112
+ ].join("\n"),
113
+ warnings: [],
114
+ };
115
+ }
@@ -33,9 +33,9 @@ const RAM_FALLBACK_KB = {
33
33
  "105xc": 64,
34
34
  "107xc": 64,
35
35
  };
36
- /** line 代号:STM32F103 → 103。 */
36
+ /** line 代号:STM32F103 → 103;通用事实没有 prefix 时给空串。 */
37
37
  function lineOf(chip) {
38
- return chip.prefix.slice(6);
38
+ return (chip.prefix ?? "").slice(6);
39
39
  }
40
40
  /**
41
41
  * ST 的器件代号:完整型号去掉温度/封装尾号换成 x(STM32F103C8T6 → STM32F103C8Tx),
@@ -44,6 +44,11 @@ function lineOf(chip) {
44
44
  * 沿用同一约定,用户从 HAL 工程切过来时一眼认得出这是哪颗芯片的脚本。
45
45
  */
46
46
  export function deviceIdFor(chip) {
47
+ // chips.json 已经把 CubeMX 的 DeviceId 算好了(STM32F401CBUx 这种),直接用;
48
+ // 只有 F1Chip 走下面按型号命名的兜底。
49
+ if (chip.deviceId !== undefined && chip.deviceId !== "")
50
+ return chip.deviceId;
51
+ const prefix = chip.prefix ?? chip.cpn.slice(0, "STM32F103".length);
47
52
  const cpn = chip.cpn.toUpperCase();
48
53
  if (/^STM32F\d{3}[A-Z][0-9A-G]/u.test(cpn) && cpn.length >= 11) {
49
54
  if (/[67]$/u.test(cpn) && cpn.length >= 12)
@@ -52,7 +57,7 @@ export function deviceIdFor(chip) {
52
57
  return cpn + "Tx";
53
58
  return cpn.slice(0, -1) + "x";
54
59
  }
55
- return chip.prefix + "x" + chip.group.slice(1).toUpperCase();
60
+ return prefix + "x" + chip.group.slice(1).toUpperCase();
56
61
  }
57
62
  function kbOf(bytes) {
58
63
  return Math.round(bytes / 1024);
@@ -61,20 +66,20 @@ function kbOf(bytes) {
61
66
  export function planRegisterLinker(chip) {
62
67
  const warnings = [];
63
68
  const line = lineOf(chip);
64
- const key = chip.prefix.slice(6) + chip.group;
69
+ const key = line + chip.group;
65
70
  const deviceId = deviceIdFor(chip);
66
71
  const flashBytes = chip.flashBytes ?? 0;
67
72
  if (flashBytes <= 0) {
68
- warnings.push("这颗芯片的 Flash 大小没收录(stm32f1.ts 的 FLASH_BY_LETTER 里查不到档位 " + chip.group + "),链接脚本按 64K 生成;确认后请补表。");
73
+ warnings.push("这颗芯片的 Flash 大小没收录(内置资源 chips.json 里这一档没有 flashBytes),链接脚本按 64K 生成;确认后请更新内置资源。");
69
74
  }
70
75
  const exactRam = chip.ramBytes ?? null;
71
76
  const fallbackKb = RAM_FALLBACK_KB[key];
72
77
  const ramBytes = exactRam !== null ? exactRam : (fallbackKb ?? 20) * 1024;
73
78
  if (exactRam === null && fallbackKb === undefined) {
74
- warnings.push("F" + line + " 的档位 " + chip.group + " 的 RAM 大小没收录,链接脚本按 20K 兜底;确认后请补 stm32f1.ts 的 RAM_BY_LINE_LETTER 或 register-linker.ts 的 RAM_FALLBACK_KB。");
79
+ warnings.push((line === "" ? "这颗芯片" : "F" + line + " 的档位 " + chip.group) + " 的 RAM 大小没收录,链接脚本按 20K 兜底;确认后请更新内置资源(chips.json 的 ramBytes)。");
75
80
  }
76
81
  else if (exactRam === null) {
77
- warnings.push("F" + line + " 的档位 " + chip.group + " 的 RAM 没收录在 stm32f1.ts 里,链接脚本按 CubeMX db 的最小值 " + kbOf(ramBytes) + "K 生成(宁可小,栈不会越界);封装更大时可以把 LENGTH 改大。");
82
+ warnings.push("F" + line + " 的档位 " + chip.group + " 的 RAM 没收录,链接脚本按 CubeMX db 的最小值 " + kbOf(ramBytes) + "K 生成(宁可小,栈不会越界);封装更大时可以把 LENGTH 改大。");
78
83
  }
79
84
  if (ramBytes > 0 && ramBytes <= 8 * 1024) {
80
85
  warnings.push("这颗芯片只有 " + kbOf(ramBytes) + "K RAM,链接脚本仍保留默认的 1K 栈 + 512B 堆(_Min_Stack_Size/_Min_Heap_Size),紧张时请调小。");