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
package/lib/engine/rtt.js CHANGED
@@ -55,6 +55,19 @@ const HINT_CONNECT = "连不上 RTT 通道:确认 start 成功(openocd 的 r
55
55
  const HINT_NOT_RUNNING = "RTT 还没启动:先 stm32_rtt action=start,addr 填模板里控制块的地址。";
56
56
  const HINT_SETUP = "openocd 拒绝了 RTT 命令:看 evidence 里 openocd 的原话;常见原因是控制块地址/长度不对,或者目标没在跑(rtt start 需要目标在跑)。";
57
57
  const HINT_TCL_TIMEOUT = "openocd 的 Tcl 口超时:确认调试会话还在(stm32_debug_session action=status),必要时重启会话再试。";
58
+ /** 连接被拒/被重置 = openocd 已经没了(探针掉线也会这样),别把它报成「目标里没有控制块」。 */
59
+ const HINT_SESSION_GONE = "调试会话的 openocd 已经不在了(连接被拒/被重置):先 stm32_debug_stop 关掉残留会话,再重试;反复出现就插拔探针(USB)后重来。";
60
+ /** 从 Tcl 连接错误里认出「会话已经死了」:这类错误换多少 addr 都没用。 */
61
+ export function sessionGoneHint(error) {
62
+ return /ECONNREFUSED|ECONNRESET|ECONNABORTED|EPIPE|socket hang up/iu.test(error) ? HINT_SESSION_GONE : null;
63
+ }
64
+ /** 连接被拒 = 多半是 openocd 还没开始 accept(刚起来 300 ms 内),值得重试一次。 */
65
+ function isConnectRefused(error) {
66
+ return error !== null && /ECONNREFUSED|ECONNRESET|ECONNABORTED|EPIPE|socket hang up/iu.test(error);
67
+ }
68
+ function sleepMs(ms) {
69
+ return new Promise((done) => setTimeout(done, ms));
70
+ }
58
71
  const HINT_FRAME = "通道字节流不符合我们的帧约定([4B 长度|1B 级别|8B 时间戳|UTF-8]):核对模板里写通道 0 的函数,或先 stop 再 start 重来。";
59
72
  const HINT_CANCEL = "已取消:重新调用同一个工具即可,RTT 状态不会被这次取消弄坏。";
60
73
  function initialState() {
@@ -148,12 +161,39 @@ export function parseRttFrames(buffer, maxFrameBytes = DEFAULT_MAX_FRAME_BYTES)
148
161
  };
149
162
  }
150
163
  const t = Number(buffer.readBigUInt64LE(offset + 5));
151
- const text = buffer.toString("utf8", offset + RTT_FRAME_HEADER_BYTES, offset + 4 + length);
164
+ const rawText = buffer.toString("utf8", offset + RTT_FRAME_HEADER_BYTES, offset + 4 + length);
165
+ // 环形缓冲回绕/残留时,一帧尾部会被环起点处的旧数据或清零区补齐:末尾的 NUL 不是内容,
166
+ // 裁掉它,否则 dump 出来的文本尾巴挂一串 \0(真机上必现)。
167
+ const text = rawText.replace(/\u0000+$/u, "");
152
168
  records.push({ t, level, text });
153
169
  offset += 4 + length;
154
170
  }
155
171
  return { records, rest: Buffer.from(buffer.subarray(offset)), error: null };
156
172
  }
173
+ /**
174
+ * 在缓冲区里找第一个「看起来是帧头」的偏移:长度字段在 [9, maxFrameBytes]、级别在 1..4,
175
+ * 且剩余字节够一整帧(不够也算候选:先对齐过来,等后续字节补齐)。
176
+ *
177
+ * 为什么需要它:openocd 的 rtt server 在客户端连上时会把整块通道缓冲(由短及长,正好是
178
+ * 通道大小时就是 1024 字节)一次性推过来,而固件的写指针早就绕过好几圈 —— 首字节往往落在
179
+ * 某条记录的中间。parseRttFrames 是严格解析器(偏移 0 失步就报错),对齐这一步只能在外面做。
180
+ *
181
+ * 返回 -1 表示整段都找不到帧头(那才是真的「通道里不是我们的帧」)。
182
+ */
183
+ export function resyncRttFrames(buffer, maxFrameBytes = DEFAULT_MAX_FRAME_BYTES) {
184
+ for (let offset = 0; offset + 4 <= buffer.length; offset += 1) {
185
+ const length = buffer.readUInt32LE(offset);
186
+ if (length < RTT_MIN_FRAME_BYTES || length > maxFrameBytes)
187
+ continue;
188
+ if (offset + 4 + length > buffer.length)
189
+ return offset;
190
+ const level = buffer.readUInt8(offset + 4);
191
+ if (level < RTT_MIN_LEVEL || level > RTT_MAX_LEVEL)
192
+ continue;
193
+ return offset;
194
+ }
195
+ return -1;
196
+ }
157
197
  /**
158
198
  * 按同一套约定编一帧。引擎自己不用它(记录是固件写的),但它是帧格式的可执行参考:
159
199
  * 模板端的 C 实现和单测都对着它写。
@@ -171,7 +211,13 @@ export function encodeRttFrame(record) {
171
211
  async function readControlBlock(addr, tclPort, timeoutMs, signal) {
172
212
  const addresses = [addr, addWords(addr, 4), addWords(addr, 8)];
173
213
  const commands = addresses.map((address) => "mdw " + address);
174
- const round = await tclRoundTrip(tclPort, commands, timeoutMs, signal);
214
+ // openocd 刚起来时 Tcl 口可能还没开始 accept(300 ms 级):这种 ECONNREFUSED 是"还没好",
215
+ // 不是"会话死了"。重试两次再判定,否则会把它误报成 openocd 已经不在了。
216
+ let round = await tclRoundTrip(tclPort, commands, timeoutMs, signal);
217
+ for (let attempt = 0; attempt < 2 && !round.ok && isConnectRefused(round.error); attempt += 1) {
218
+ await sleepMs(250);
219
+ round = await tclRoundTrip(tclPort, commands, timeoutMs, signal);
220
+ }
175
221
  if (!round.ok)
176
222
  return { ok: false, words: null, error: round.error ?? "读控制块失败", output: round.output };
177
223
  touch();
@@ -240,8 +286,10 @@ export async function startRtt(request) {
240
286
  }
241
287
  const block = await readControlBlock(addr, tclPort, tclTimeout, request.signal);
242
288
  if (!block.ok) {
243
- const timeout = /超时|timeout/iu.test(block.error ?? "");
244
- const probeError = rttError(timeout ? "timeout" : "unknown", "读控制块失败:" + (block.error ?? "未知原因"), timeout ? HINT_TCL_TIMEOUT : HINT_NO_BLOCK, [block.error ?? ""]);
289
+ const errorText = block.error ?? "";
290
+ const timeout = /超时|timeout/iu.test(errorText);
291
+ const gone = sessionGoneHint(errorText);
292
+ const probeError = rttError(timeout ? "timeout" : "unknown", "读控制块失败:" + (errorText === "" ? "未知原因" : errorText), gone ?? (timeout ? HINT_TCL_TIMEOUT : HINT_NO_BLOCK), [errorText]);
245
293
  return { ...base, tclPort, output: block.output, durationMs: Date.now() - startedAt, probeError, message: formatProbeError(probeError) };
246
294
  }
247
295
  const words = block.words;
@@ -322,6 +370,16 @@ async function collectFromPort(port, options) {
322
370
  let error = null;
323
371
  let failureKind = "unknown";
324
372
  let failureHint = HINT_FRAME;
373
+ /** 已经收过的记录(时间戳|级别|文本):openocd 回绕后会重推同一段,别重复计数。 */
374
+ const seen = new Set();
375
+ let duplicates = 0;
376
+ /** 对齐时跳过的字节总数:攒成一条 note,免得每个 chunk 刷一条一样的(实测硬件上刷 27 条)。 */
377
+ let skippedBytes = 0;
378
+ let skippedAtHead = true;
379
+ /** 尾部半条记录的解析错误:等窗口结束再写进 notes,中途不提前收尾。 */
380
+ let tailError = null;
381
+ /** follow 模式下"只留最新 N 条"的提示只写一次。 */
382
+ let keepNewestNoted = false;
325
383
  const socket = createConnection({ host: "127.0.0.1", port });
326
384
  state.socket = socket;
327
385
  socket.setNoDelay(true);
@@ -359,8 +417,21 @@ async function collectFromPort(port, options) {
359
417
  failureKind = "unknown";
360
418
  failureHint = HINT_CANCEL;
361
419
  }
420
+ if (skippedBytes > 0) {
421
+ notes.unshift((skippedAtHead ? "开头 " : "中段 ") + String(skippedBytes) + " 字节不是帧头(环形缓冲绕圈/回绕),已跳过并对齐到帧边界");
422
+ }
362
423
  if (reason === "window" && carry.length > 0) {
363
- notes.push("窗口结束时尾部还有 " + String(carry.length) + " 字节的半个帧,没算进 records");
424
+ notes.push("窗口结束时尾部还有 " + String(carry.length) + " 字节的半个帧,没算进 records"
425
+ + (tailError === null ? "" : "(" + tailError + ")"));
426
+ }
427
+ if (duplicates > 0) {
428
+ notes.push("重复记录 " + String(duplicates) + " 条(时间戳+级别+文本都相同)已去重");
429
+ }
430
+ if (reason === "window" && error === null && records.length === 0 && state.lastError !== null) {
431
+ // 整段窗口一条都没解出来:通道里确实不是我们的帧(例如固件写的是别的格式)。
432
+ error = state.lastError;
433
+ failureKind = "unknown";
434
+ failureHint = HINT_FRAME;
364
435
  }
365
436
  resolve({
366
437
  ok: error === null,
@@ -375,6 +446,38 @@ async function collectFromPort(port, options) {
375
446
  durationMs: Date.now() - startedAt,
376
447
  });
377
448
  };
449
+ /** 把解析出来的记录收进去:去重、按 level 过滤、maxRecords 到了就收尾。返回 false 表示已经 finish。 */
450
+ const takeRecords = (list) => {
451
+ for (const record of list) {
452
+ const key = String(record.t) + "|" + String(record.level) + "|" + record.text;
453
+ if (seen.has(key)) {
454
+ duplicates += 1;
455
+ continue;
456
+ }
457
+ seen.add(key);
458
+ if (record.level > options.level) {
459
+ dropped += 1;
460
+ state.dropped += 1;
461
+ continue;
462
+ }
463
+ if (records.length >= options.maxRecords) {
464
+ if (options.keepNewest !== true) {
465
+ finish("truncated", null);
466
+ return false;
467
+ }
468
+ // follow:窗口长、记录多,只留最新的 N 条(用户要的是"现在在打什么",不是全史)。
469
+ records.shift();
470
+ if (!keepNewestNoted) {
471
+ keepNewestNoted = true;
472
+ notes.push("记录超过 maxRecords=" + String(options.maxRecords) + ",只保留最新的 " + String(options.maxRecords) + " 条");
473
+ }
474
+ truncated = true;
475
+ }
476
+ records.push(record);
477
+ state.records += 1;
478
+ }
479
+ return true;
480
+ };
378
481
  const onAbort = () => {
379
482
  finish("aborted", null);
380
483
  };
@@ -395,34 +498,53 @@ async function collectFromPort(port, options) {
395
498
  bytes += chunk.length;
396
499
  state.bytes += chunk.length;
397
500
  carry = Buffer.concat([carry, chunk]);
398
- const parsed = parseRttFrames(carry, options.maxFrameBytes);
399
- carry = parsed.rest;
400
- if (parsed.error !== null) {
401
- // 环形缓冲回绕后,通道字节流尾部经常剩半条记录;只要已经解出过记录,
402
- // 就当「窗口结束 + 尾部丢半帧」,不要把整次 dump 判失败(实测 C8T6 上必现)。
403
- if (records.length > 0) {
404
- state.lastError = parsed.error;
405
- notes.push("RTT 通道尾部有半条记录(多半是环形缓冲回绕),已丢弃:" + parsed.error);
406
- finish("window", null);
501
+ // 对齐/解析最多来回这么多次:整块环形缓冲里可能夹着多段垃圾,但绝不无限转。
502
+ for (let guard = 0; guard < 64; guard += 1) {
503
+ if (settled)
504
+ return;
505
+ const parsed = parseRttFrames(carry, options.maxFrameBytes);
506
+ // 先把已经解出来的记录收下:解析只是在后面的垃圾处失步,前面读到的不能一起扔掉
507
+ // (实测 C8T6:整块 1024 字节缓冲推过来时,开头对不齐 + 后面一长串 0,旧写法会 0 条记录)。
508
+ if (!takeRecords(parsed.records))
509
+ return;
510
+ if (parsed.error === null) {
511
+ carry = parsed.rest;
407
512
  return;
408
513
  }
409
- state.lastError = parsed.error;
410
- finish("error", parsed.error);
411
- return;
412
- }
413
- for (const record of parsed.records) {
414
- if (record.level > options.level) {
415
- dropped += 1;
416
- state.dropped += 1;
514
+ // 连上通道时 openocd 常把整块环形缓冲从中间推过来(固件写指针早已绕过一圈),
515
+ // 或者回绕后中段夹着半条记录:先往后找帧头对齐,别整次 dump 判失败。
516
+ // 注意要在 parsed.rest 上找:在整段 carry 上找会永远在偏移 0 命中刚解出的那帧的首字节,
517
+ // 于是每次都在原地打转(实测真机上卡死在这里,后面的记录一条都解不出来)。
518
+ const rest = parsed.rest;
519
+ const offset = resyncRttFrames(rest, options.maxFrameBytes);
520
+ if (offset > 0) {
521
+ if (skippedBytes === 0)
522
+ skippedAtHead = records.length === 0;
523
+ skippedBytes += offset;
524
+ carry = rest.subarray(offset);
417
525
  continue;
418
526
  }
419
- if (records.length >= options.maxRecords) {
420
- finish("truncated", null);
527
+ if (offset === 0) {
528
+ // rest 本身就以帧头开头:这帧还没收齐,等下一个 chunk 补齐。
529
+ carry = rest;
421
530
  return;
422
531
  }
423
- records.push(record);
424
- state.records += 1;
532
+ // 整段都找不到帧头:既可能是回绕后的半条记录,也可能只是这半条还没写完(下一个 chunk 就补齐)。
533
+ // 旧写法在「已解出过记录」时直接 finish("window"),实测 C8T6 上会把后面还能解出来的整秒记录全丢掉。
534
+ tailError = parsed.error;
535
+ if (records.length === 0)
536
+ state.lastError = parsed.error;
537
+ // 垃圾攒太多就只留尾巴:一帧最长 maxFrameBytes,帧头最坏也就落在这么多字节之前。
538
+ const keepBytes = options.maxFrameBytes + RTT_FRAME_HEADER_BYTES;
539
+ if (rest.length > keepBytes)
540
+ carry = rest.subarray(rest.length - keepBytes);
541
+ else
542
+ carry = rest;
543
+ return;
425
544
  }
545
+ // 对齐来回 64 次还没收敛:剩下的按垃圾丢掉,别把 socket 拖死。
546
+ state.lastError = "对齐帧头来回 " + String(64) + " 次仍未收敛,剩下的 " + String(carry.length) + " 字节按垃圾丢弃";
547
+ carry = Buffer.alloc(0);
426
548
  });
427
549
  socket.on("close", () => {
428
550
  finish("closed", null);
@@ -445,10 +567,36 @@ async function collectFromPort(port, options) {
445
567
  onAbort();
446
568
  });
447
569
  }
570
+ /**
571
+ * 读固件侧的丢帧计数(rtt.c 里的 static uint32_t s_dropped,自复位起累计)。
572
+ * 为什么值得多花一次 gdb 往返:宿主侧的 dropped 是「按级别过滤掉几条」,固件侧的 s_dropped 才是
573
+ * 「环满丢了几条」—— 这才是「RTT 会不会丢数据」真正该看的数字。
574
+ * 走 eval(halt -> print -> resume),目标会被停约 50–100 ms;读不到就返回 -1,不编数。
575
+ */
576
+ export async function readFirmwareDropCount() {
577
+ const session = sessionInfo();
578
+ if (session === null)
579
+ return { value: -1, note: "没有活跃会话,读不到固件侧 s_dropped(-1)" };
580
+ try {
581
+ const { debugSessions } = await import("./debug-session.js");
582
+ const report = await debugSessions.eval({ commands: ["p (unsigned)s_dropped"] });
583
+ const matched = /\$\d+\s*=\s*(\d+)/u.exec(report.output);
584
+ if (matched === null) {
585
+ const last = report.output.trim().split("\n").slice(-1)[0];
586
+ return { value: -1, note: "固件里没找到 s_dropped(符号被优化掉或改名):" + last };
587
+ }
588
+ return { value: Number(matched[1]), note: "固件侧 s_dropped=" + matched[1] + "(自复位起累计)" };
589
+ }
590
+ catch (error) {
591
+ return { value: -1, note: "读 s_dropped 失败:" + (error instanceof Error ? error.message : String(error)) };
592
+ }
593
+ }
448
594
  /** dump:从通道 0 读一段时间的记录;level 是保留上限(默认 4 = 全要)。 */
449
595
  export async function dumpRtt(request = {}) {
450
596
  const rawSeconds = request.seconds ?? DEFAULT_DUMP_SECONDS;
451
- const seconds = clampNumber(rawSeconds, 0.2, 60);
597
+ const keepNewest = request.keepNewest === true;
598
+ const maxWindow = keepNewest ? 300 : 60;
599
+ const seconds = clampNumber(rawSeconds, 0.2, maxWindow);
452
600
  const level = Math.round(clampNumber(request.level ?? RTT_MAX_LEVEL, RTT_MIN_LEVEL, RTT_MAX_LEVEL));
453
601
  const maxRecords = Math.round(clampNumber(request.maxRecords ?? DEFAULT_MAX_RECORDS, 1, 5_000));
454
602
  const maxFrameBytes = Math.round(clampNumber(request.maxFrameBytes ?? DEFAULT_MAX_FRAME_BYTES, RTT_MIN_FRAME_BYTES, 65_536));
@@ -461,6 +609,7 @@ export async function dumpRtt(request = {}) {
461
609
  dropped: 0,
462
610
  bytes: 0,
463
611
  truncated: false,
612
+ firmwareDropped: -1,
464
613
  stopped: false,
465
614
  port,
466
615
  addr,
@@ -481,19 +630,27 @@ export async function dumpRtt(request = {}) {
481
630
  const probeError = rttError("unknown", "已取消", HINT_CANCEL);
482
631
  return { ...base, probeError, error: probeError.cause, message: formatProbeError(probeError) };
483
632
  }
484
- const outcome = await collectFromPort(port, { seconds, level, maxRecords, maxFrameBytes, connectTimeoutMs, ...(request.signal === undefined ? {} : { signal: request.signal }) });
633
+ const outcome = await collectFromPort(port, { seconds, level, maxRecords, maxFrameBytes, connectTimeoutMs, keepNewest, ...(request.signal === undefined ? {} : { signal: request.signal }) });
485
634
  const notes = [...outcome.notes];
486
635
  if (seconds !== rawSeconds)
487
- notes.push("seconds=" + String(rawSeconds) + " 超出 0.2..60,按 " + String(seconds) + " s 收;要更长的窗口就分多次 dump");
636
+ notes.push("seconds=" + String(rawSeconds) + " 超出 0.2.." + String(maxWindow) + ",按 " + String(seconds) + " s 收");
488
637
  if (outcome.error !== null)
489
638
  state.lastError = outcome.error;
639
+ let firmwareDropped = -1;
640
+ if (request.readFirmwareDrop === true && outcome.ok) {
641
+ const reading = await readFirmwareDropCount();
642
+ firmwareDropped = reading.value;
643
+ notes.push(reading.note);
644
+ }
490
645
  let message;
491
646
  if (outcome.ok) {
492
647
  message = "dump 到 " + String(outcome.records.length) + " 条 RTT 记录(端口 " + String(port) + ",窗口 " + String(seconds) + " s,收 " + String(outcome.bytes) + " 字节)";
493
648
  if (outcome.dropped > 0)
494
649
  message += ",按级别过滤掉 " + String(outcome.dropped) + " 条";
495
650
  if (outcome.truncated)
496
- message += ",达到 maxRecords 提前收尾";
651
+ message += keepNewest ? ",超过 maxRecords 只保留最新 " + String(maxRecords) + " 条" : ",达到 maxRecords 提前收尾";
652
+ if (firmwareDropped >= 0)
653
+ message += ";固件侧累计丢帧 " + String(firmwareDropped) + " 条";
497
654
  if (outcome.stopped)
498
655
  message += ",通道在窗口内被关掉(目标复位或 rtt stop)";
499
656
  }
@@ -507,6 +664,7 @@ export async function dumpRtt(request = {}) {
507
664
  dropped: outcome.dropped,
508
665
  bytes: outcome.bytes,
509
666
  truncated: outcome.truncated,
667
+ firmwareDropped,
510
668
  stopped: outcome.stopped,
511
669
  port,
512
670
  addr,
@@ -22,10 +22,13 @@ import { fileURLToPath } from "node:url";
22
22
  import { DSH_FIRMWARE_DIR_NAME } from "../data/firmware-packages.js";
23
23
  import { firmwareExtraDirs } from "./firmware-install.js";
24
24
  import { copyFileLong, copyTreeLong, mkdirTrackedLong } from "./fs-longpath.js";
25
- import { describeHalChip, LEGACY_LINKER_SCRIPT, pointLinkerFlagAt, renderIoc, renderLinkerScript, renderStartupAndDefine, resolveHalChip, } from "./hal-chip.js";
25
+ import { describeHalChip, LEGACY_LINKER_SCRIPT, pointLinkerFlagAt, renderIoc, renderCmakeLists, renderLinkerScript, renderOpenocdTarget, resolveHalChip, } from "./hal-chip.js";
26
26
  import { describeDroppedPlaceholder, detectVscodeFill, fillVscodeTemplate } from "./vscode-config.js";
27
+ import { readLocalManifest } from "./assets.js";
28
+ import { bundledOpenocdConfig, familyProfileOf } from "../data/family.js";
27
29
  export const DEFAULT_FIRMWARE_PACKAGE = "STM32Cube_FW_F1_V1.8.7";
28
- export const DEFAULT_MCU_CUBE_VERSION = "6.15.0";
30
+ /** ST 官网的 CubeMX 下载页:缺件提示直接给链接,别只说"去装"。 */
31
+ export const CUBEMX_DOWNLOAD_URL = "https://www.st.com/en/development-tools/stm32cubemx.html";
29
32
  export const SCAFFOLD_PROJECT_NAME = /^[A-Za-z_][A-Za-z0-9_]*$/u;
30
33
  /**
31
34
  * 工程内的状态目录名。这里自己写一份常量而不是 import generate.ts 的 STATE_DIR:
@@ -119,10 +122,10 @@ export function cleanupAfterFailure(targetDir, targetExistedBefore, created) {
119
122
  * 用它当判据等于「不是 C8T6 的工程就别想建」。具体型号要哪个启动文件由
120
123
  * createProjectScaffold 按芯片查(缺了会列出包里真实带的那些)。
121
124
  */
122
- function isUsableFirmwareRoot(candidate) {
123
- return (fs.existsSync(path.join(candidate, "Drivers", "STM32F1xx_HAL_Driver")) &&
125
+ function isUsableFirmwareRoot(candidate, deviceLine = "F1") {
126
+ return (fs.existsSync(path.join(candidate, "Drivers", "STM32" + deviceLine + "xx_HAL_Driver")) &&
124
127
  fs.existsSync(path.join(candidate, "Drivers", "CMSIS", "Include")) &&
125
- fs.existsSync(path.join(candidate, "Drivers", "CMSIS", "Device", "ST", "STM32F1xx", "Source", "Templates", "gcc")));
128
+ fs.existsSync(path.join(candidate, "Drivers", "CMSIS", "Device", "ST", "STM32" + deviceLine + "xx", "Source", "Templates", "gcc")));
126
129
  }
127
130
  /**
128
131
  * 找固件包:先扫 CubeMX 根(官方仓库 → 插件的 dsh-firmware),再扫 extraDirs
@@ -131,14 +134,14 @@ function isUsableFirmwareRoot(candidate) {
131
134
  * 为什么要带 extraDirs:stm32_firmware_install 在 CubeMX 根写不进去时会落到下载缓存或调用方指定目录。
132
135
  * 只扫 CubeMX 根的话,用户明明装好了,建工程却报"找不到固件包"(审计 B10)。
133
136
  */
134
- export function resolveFirmwareRoot(cubeMxRoots, packageName = DEFAULT_FIRMWARE_PACKAGE, extraDirs = []) {
137
+ export function resolveFirmwareRoot(cubeMxRoots, packageName = DEFAULT_FIRMWARE_PACKAGE, extraDirs = [], deviceLine = "F1") {
135
138
  const checked = [];
136
139
  for (const cubeRoot of cubeMxRoots) {
137
140
  // 官方仓库优先,其次插件自己的 dsh-firmware(与 Repository 并列,见 firmware-packages.ts)。
138
141
  for (const parent of ["Repository", DSH_FIRMWARE_DIR_NAME]) {
139
142
  const candidate = path.join(cubeRoot, parent, packageName);
140
143
  checked.push(candidate);
141
- if (isUsableFirmwareRoot(candidate))
144
+ if (isUsableFirmwareRoot(candidate, deviceLine))
142
145
  return { root: candidate, checked };
143
146
  }
144
147
  }
@@ -147,12 +150,78 @@ export function resolveFirmwareRoot(cubeMxRoots, packageName = DEFAULT_FIRMWARE_
147
150
  const candidates = path.basename(extra.dir) === packageName ? [extra.dir] : [path.join(extra.dir, packageName)];
148
151
  for (const candidate of candidates) {
149
152
  checked.push(candidate);
150
- if (isUsableFirmwareRoot(candidate))
153
+ if (isUsableFirmwareRoot(candidate, deviceLine))
151
154
  return { root: candidate, checked };
152
155
  }
153
156
  }
154
157
  return { checked };
155
158
  }
159
+ /**
160
+ * 按族找固件包:STM32Cube_FW_<族>_V<version> 的最高已装版本(官方 Repository 优先,其次 dsh-firmware、再其次下载缓存)。
161
+ *
162
+ * 为什么不能沿用 resolveFirmwareRoot 的固定包名:F1 的默认包名是写死的 V1.8.7,而其它族的版本号
163
+ * 取决于用户装了哪一版;写死任何一个都会在用户装的是别的版本时误报"找不到固件包"。
164
+ * 显式给了 firmwarePackage 就仍旧按精确名找(用户可强制某个版本)。
165
+ */
166
+ export function resolveFamilyFirmwareRoot(familyLine, cubeMxRoots, extraDirs = [], explicitPackage = "") {
167
+ const deviceLine = familyLine.replace("+", "");
168
+ const prefix = "STM32Cube_FW_" + deviceLine;
169
+ if (explicitPackage !== "") {
170
+ const exact = resolveFirmwareRoot(cubeMxRoots, explicitPackage, extraDirs, deviceLine);
171
+ return {
172
+ ...(exact.root === undefined ? {} : { root: exact.root }),
173
+ packageName: explicitPackage,
174
+ checked: exact.checked,
175
+ };
176
+ }
177
+ const checked = [];
178
+ const parents = cubeMxRoots.flatMap((root) => [path.join(root, "Repository"), path.join(root, DSH_FIRMWARE_DIR_NAME)]);
179
+ parents.push(...extraDirs.map((extra) => extra.dir));
180
+ const pattern = new RegExp("^" + prefix + "_V(\\d+)\\.(\\d+)\\.(\\d+)$", "u");
181
+ const found = [];
182
+ for (const parent of parents) {
183
+ checked.push(parent);
184
+ let entries;
185
+ try {
186
+ entries = fs.readdirSync(parent);
187
+ }
188
+ catch {
189
+ continue;
190
+ }
191
+ for (const name of entries) {
192
+ const match = pattern.exec(name);
193
+ if (match === null)
194
+ continue;
195
+ const candidate = path.join(parent, name);
196
+ if (!isUsableFirmwareRoot(candidate, deviceLine))
197
+ continue;
198
+ found.push({ root: candidate, packageName: name, version: [Number(match[1]), Number(match[2]), Number(match[3])] });
199
+ }
200
+ }
201
+ found.sort((left, right) => left.version[0] - right.version[0] || left.version[1] - right.version[1] || left.version[2] - right.version[2]);
202
+ const best = found.pop();
203
+ if (best === undefined)
204
+ return { packageName: prefix, checked };
205
+ return { root: best.root, packageName: best.packageName, checked };
206
+ }
207
+ /**
208
+ * 非 F1 族的 .ioc 模板:内置资源里的 ioc/family/<族>.ioc(CubeMX 6.15 无头 config save 出来的认证配置)。
209
+ *
210
+ * 为什么不能套 F1 的模板:.ioc 的时钟树/IP 列表是逐族的(RCC 键名、PLL 参数、Mcu.IP 清单全不同),
211
+ * 拿 F1 的骨架改成 F4 的型号,CubeMX 打开就会报配置不一致。
212
+ */
213
+ export function assetsFamilyIocText(familyLine) {
214
+ const state = readLocalManifest();
215
+ if (state.versionDir === "")
216
+ return null;
217
+ const file = path.join(state.versionDir, "ioc", "family", familyLine.toUpperCase() + ".ioc");
218
+ try {
219
+ return fs.existsSync(file) ? fs.readFileSync(file, "utf8") : null;
220
+ }
221
+ catch {
222
+ return null;
223
+ }
224
+ }
156
225
  /**
157
226
  * 动手之前就能判定的拒绝条件(纯读,不写盘)。
158
227
  *
@@ -234,7 +303,11 @@ function templateTargets(tpl, projectName) {
234
303
  }
235
304
  /** 被模板/固件包直接覆盖的工程文件(Drivers/ 整棵树不在内:那是 ST 源码,不是用户文件)。 */
236
305
  function overwriteTargetsFor(writtenRels, facts) {
237
- return [...writtenRels, facts.startup, "Core/Src/system_stm32f1xx.c", facts.linkerScript];
306
+ return [...writtenRels, facts.startup, systemFileRel(facts), facts.linkerScript];
307
+ }
308
+ /** 固件包里的系统文件在本工程里的相对路径(F1 → Core/Src/system_stm32f1xx.c)。 */
309
+ function systemFileRel(facts) {
310
+ return "Core/Src/system_stm32" + facts.familyLine.replace("+", "").toLowerCase() + "xx.c";
238
311
  }
239
312
  /** 备份说明(写进 warnings,卡片上第一眼就能看到原件在哪)。 */
240
313
  export function backupWarning(backup) {
@@ -249,7 +322,6 @@ export function createProjectScaffold(request) {
249
322
  const startedAt = Date.now();
250
323
  const targetDir = path.resolve(request.targetDir);
251
324
  const projectName = request.projectName ?? path.basename(targetDir);
252
- const firmwarePackage = request.firmwarePackage ?? DEFAULT_FIRMWARE_PACKAGE;
253
325
  // 芯片事实先算出来:连失败报告都要说清"本来是按哪款芯片建"。
254
326
  const chip = resolveHalChip(request.mcu);
255
327
  const facts = chip.facts;
@@ -278,14 +350,34 @@ export function createProjectScaffold(request) {
278
350
  const tpl = templateDir();
279
351
  if (!fs.existsSync(tpl))
280
352
  return fail("插件模板目录缺失:" + tpl + "(重新安装插件)");
281
- const firmware = resolveFirmwareRoot(request.cubeMxRoots ?? [], firmwarePackage, firmwareExtraDirs());
353
+ // 固件包按族找(F1 的默认版本仍是 V1.8.7;其它族取本机已装的最高版本,用户也可显式指定包名)。
354
+ // F1 不给包名时仍按历史默认(V1.8.7):同一台机器上装了 1.8.4/1.8.5 时,"最高版本"会让老工程换基线。
355
+ // HAL 路线离不开 CubeMX:固件包由它的包管理器维护,Core/ 的 MX_*_Init 也要 stm32_generate 调无头 CubeMX 生成。
356
+ // 缺它时不能只说"找不到固件包"——用户会以为是网络问题,而不是"这台机器根本没装 CubeMX"。
357
+ const cubeMxRoots = request.cubeMxRoots ?? [];
358
+ const cubeMxFound = cubeMxRoots.some((root) => fs.existsSync(root));
359
+ const cubeMxHint = cubeMxFound
360
+ ? ""
361
+ : "本机没找到 STM32CubeMX 安装(找过:" + (cubeMxRoots.length === 0 ? "(没有候选目录)" : cubeMxRoots.join(";")) + ")。" +
362
+ "HAL 路线离不开它:① 固件包只由 CubeMX 的包管理器维护;② Core/ 下的 MX_*_Init 要 stm32_generate 调无头 CubeMX 生成。" +
363
+ "官网下载安装(含内置 JRE,约 1.5 GB,装到默认目录会被自动发现):" + CUBEMX_DOWNLOAD_URL +
364
+ "。只写寄存器程序不需要它(route=register)。";
365
+ const explicitPackage = request.firmwarePackage ?? (facts.familyLine === "F1" ? DEFAULT_FIRMWARE_PACKAGE : "");
366
+ const firmware = resolveFamilyFirmwareRoot(facts.familyLine, request.cubeMxRoots ?? [], firmwareExtraDirs(), explicitPackage);
367
+ const firmwarePackage = firmware.packageName;
282
368
  if (firmware.root === undefined) {
283
- return fail("找不到 CubeMX 固件包 " + firmwarePackage + "(找过:" + firmware.checked.join(";") + ")。" +
284
- "固件包是 Drivers/ 与 startup 的唯一合法来源,插件不内嵌 ST 代码。");
369
+ // 显式给了包名就报那个名字;没给就说明找的是该族任意版本(_V*)。
370
+ const wanted = explicitPackage === "" ? firmwarePackage + "_V*" : firmwarePackage;
371
+ return fail("找不到 " + facts.familyId + " 的 CubeMX 固件包 " + wanted + "(找过:" + firmware.checked.join(";") + ")。" +
372
+ "固件包是 Drivers/ 与 startup 的唯一合法来源,插件不内嵌 ST 代码。两条路任选:" +
373
+ "① 直接调 stm32_firmware_install(传 mcu:" + facts.mcu + ",真装要给 dryRun:false + confirm:true)——" +
374
+ "它会先从 ST 官网下官方 zip 交给 CubeMX 装进 Repository,走不通再回退 GitHub 拼包;" +
375
+ "② 在 CubeMX 里用包管理器(Help → Manage embedded software packages)自己装这个族的固件包,然后重跑 stm32_project_create。" +
376
+ (cubeMxHint === "" ? "" : "\n" + cubeMxHint));
285
377
  }
286
378
  // 2) 固件包里必须真有这款芯片的启动文件与设备头:认不出就停在这里,别建出个编译不过的工程
287
379
  // (startup 是 copy 进工程的,设备头随 Drivers/ 整树拷过来,所以只校验存在性)。
288
- const deviceDir = path.join(firmware.root, "Drivers", "CMSIS", "Device", "ST", "STM32F1xx");
380
+ const deviceDir = path.join(firmware.root, "Drivers", "CMSIS", "Device", "ST", "STM32" + facts.familyLine.replace("+", "") + "xx");
289
381
  const templatesDir = path.join(deviceDir, "Source", "Templates");
290
382
  const gccDir = path.join(templatesDir, "gcc");
291
383
  const startupSource = path.join(gccDir, facts.startup);
@@ -301,12 +393,23 @@ export function createProjectScaffold(request) {
301
393
  return fail("固件包里没有 " + facts.deviceDefine + " 的设备头 " + facts.deviceHeader + ":" + headerSource +
302
394
  "。设备头随 Drivers/ 一起复制,缺它说明这份固件包不完整(换一个版本的 " + firmwarePackage + ")。");
303
395
  }
396
+ // 非 F1 族的 .ioc 模板来自内置资源(逐族的时钟树 / Mcu.IP 清单 / RCC 键名);没有就拒绝,
397
+ // 绝不拿 F1 的骨架改个型号名——CubeMX 打开会报配置不一致(那是"看起来建成了但打不开"的工程)。
398
+ let familyIocText = null;
399
+ if (facts.familyLine !== "F1") {
400
+ familyIocText = assetsFamilyIocText(facts.familyLine);
401
+ if (familyIocText === null) {
402
+ return fail("内置资源里没有 " + facts.familyLine + " 的 .ioc 模板(ioc/family/" + facts.familyLine.toUpperCase() + ".ioc):" +
403
+ "先跑 stm32_assets verify 确认安装完整(缺文件就重装插件);F1 之外的族不能套 F1 的模板(时钟树与外设清单逐族不同)。");
404
+ }
405
+ }
304
406
  // 3) 模板全部读进内存并按芯片渲染好——这一步一个字节都不写:
305
407
  // 渲染失败只可能是模板被改过,宁可在动手前拒绝,也不留下一半 C8T6 一半新芯片的工程。
306
408
  const vscodeFill = detectVscodeFill(request.binDirs ?? []);
307
409
  const droppedVscode = new Set();
308
410
  const written = [];
309
411
  let linkerScriptText = "";
412
+ let openocdNote = "";
310
413
  try {
311
414
  // 链接脚本按芯片渲染;模板里那份(C8T6 的 64K/20K)只作渲染源 + 蓝丸的兼容副本。
312
415
  linkerScriptText = renderLinkerScript(fs.readFileSync(path.join(tpl, LEGACY_LINKER_SCRIPT), "utf8"), facts);
@@ -314,17 +417,33 @@ export function createProjectScaffold(request) {
314
417
  // 旧名的链接脚本只在蓝丸上留一份:别的芯片写旧名 = 一份骗人的内存布局。
315
418
  if (destRel === LEGACY_LINKER_SCRIPT && !facts.keepLegacyLinkerScript)
316
419
  continue;
317
- let text = fs.readFileSync(source, "utf8");
420
+ // .ioc 用族模板(非 F1)或插件模板(F1);其余文件仍从模板目录读。
421
+ let text = destRel === projectName + ".ioc" && familyIocText !== null ? familyIocText : fs.readFileSync(source, "utf8");
318
422
  if (destRel !== ".gitignore" && destRel !== LEGACY_LINKER_SCRIPT) {
319
423
  text = text.split("__PROJECT_NAME__").join(projectName);
320
424
  }
321
425
  if (destRel === projectName + ".ioc")
322
- text = renderIoc(text, facts);
426
+ text = renderIoc(text, facts, projectName);
323
427
  if (destRel === "cmake/gcc-arm-none-eabi.cmake" || destRel === "cmake/starm-clang.cmake") {
324
428
  text = pointLinkerFlagAt(text, facts);
325
429
  }
430
+ // Cmake 与 openocd 配置里的族相关字面量(STM32F1xx / stm32f1x)都按芯片换掉。
326
431
  if (destRel === "cmake/stm32cubemx/CMakeLists.txt")
327
- text = renderStartupAndDefine(text, facts);
432
+ text = renderCmakeLists(text, facts);
433
+ if (destRel === "openocd.cfg" || destRel === ".vscode/launch.json") {
434
+ const rendered = renderOpenocdTarget(text, facts, destRel === "openocd.cfg" ? "openocd" : "launch");
435
+ text = rendered.text;
436
+ if (rendered.note !== "")
437
+ openocdNote = rendered.note;
438
+ }
439
+ // 探针型号决定 interface:实见 ST-Link 却写 cmsis-dap,用户按 F5 会拿到
440
+ // "Debug adapter doesn't support 'swd' transport"(C0/U0 的 target 脚本尤其)。
441
+ if (destRel === "openocd.cfg" || destRel === ".vscode/launch.json") {
442
+ const iface = request.interfaceConfig;
443
+ if (iface !== undefined && iface !== "" && iface !== "interface/cmsis-dap.cfg") {
444
+ text = text.split("interface/cmsis-dap.cfg").join(iface);
445
+ }
446
+ }
328
447
  if (destRel.startsWith(".vscode/")) {
329
448
  const filled = fillVscodeTemplate(text, vscodeFill);
330
449
  text = filled.text;
@@ -333,6 +452,16 @@ export function createProjectScaffold(request) {
333
452
  }
334
453
  written.push({ rel: destRel, text });
335
454
  }
455
+ // 该族在 openocd 0.12 里没有 target 脚本(C0 / U0):把插件内置的那份复制进工程,
456
+ // 让 openocd.cfg / launch.json 里那条 source openocd/<name>.cfg 真能找到文件。
457
+ const bundled = familyProfileOf(facts.familyId).bundledTarget;
458
+ if (bundled !== null) {
459
+ const source = bundledOpenocdConfig(bundled);
460
+ if (source === null) {
461
+ throw new Error("插件缺少内置 target 脚本 templates/openocd/" + bundled + ".cfg(安装不完整):" + facts.familyId + " 靠它烧录/调试");
462
+ }
463
+ written.push({ rel: "openocd/" + bundled + ".cfg", text: fs.readFileSync(source, "utf8") });
464
+ }
336
465
  }
337
466
  catch (error) {
338
467
  return fail("没写任何文件:模板按芯片渲染失败(" + String(error.message) + ")。目标目录 " + targetDir + " 未被改动。");
@@ -370,7 +499,7 @@ export function createProjectScaffold(request) {
370
499
  // 2) 固件包:Drivers 全量 + 本芯片的 startup + system(与 GUI 新工程逐字节一致)
371
500
  driverFiles = copyTreeLong(path.join(firmware.root, "Drivers"), path.join(targetDir, "Drivers"), DRIVER_SKIP_PREFIXES, createdDirs);
372
501
  copyFileLong(startupSource, path.join(targetDir, facts.startup));
373
- copyFileLong(path.join(templatesDir, "system_stm32f1xx.c"), path.join(targetDir, "Core", "Src", "system_stm32f1xx.c"));
502
+ copyFileLong(path.join(templatesDir, path.basename(systemFileRel(facts))), path.join(targetDir, ...systemFileRel(facts).split("/")));
374
503
  }
375
504
  catch (error) {
376
505
  const cleanup = cleanupAfterFailure(targetDir, targetExistedBefore, createdDirs);
@@ -393,6 +522,10 @@ export function createProjectScaffold(request) {
393
522
  }
394
523
  for (const token of droppedVscode)
395
524
  warnings.push(describeDroppedPlaceholder(token));
525
+ if (openocdNote !== "")
526
+ warnings.push(openocdNote);
527
+ if (cubeMxHint !== "")
528
+ warnings.push(cubeMxHint);
396
529
  warnings.push("没有生成 .mxproject:那是 CubeMX GUI 的工程元数据,插件不伪造;用 GUI 打开并生成一次即可补上。", "Core/ 下的 main.c 等还没生成:接着调 stm32_generate(3–4 分钟,需要 CubeMX 全权限)。");
397
530
  return {
398
531
  ok: true,
@@ -413,3 +546,37 @@ export function createProjectScaffold(request) {
413
546
  ";芯片 " + describeHalChip(facts) + (backupNote === null ? "" : ";" + backupNote),
414
547
  };
415
548
  }
549
+ export function writeVscodeConfigs(request) {
550
+ const files = [];
551
+ const warnings = [];
552
+ const dropped = new Set();
553
+ const source = path.join(templateDir(), "vscode");
554
+ const destDir = path.join(request.targetDir, ".vscode");
555
+ const fill = detectVscodeFill(request.binDirs ?? []);
556
+ const iface = request.interfaceConfig !== undefined && request.interfaceConfig !== "" ? request.interfaceConfig : "interface/cmsis-dap.cfg";
557
+ try {
558
+ fs.mkdirSync(destDir, { recursive: true });
559
+ for (const name of fs.readdirSync(source).sort()) {
560
+ const dest = path.join(destDir, name);
561
+ if (fs.existsSync(dest)) {
562
+ warnings.push(".vscode/" + name + " 已存在,未覆盖");
563
+ continue;
564
+ }
565
+ let text = fs.readFileSync(path.join(source, name), "utf8");
566
+ text = text.split("__PROJECT_NAME__").join(request.projectName);
567
+ if (iface !== "interface/cmsis-dap.cfg")
568
+ text = text.split("interface/cmsis-dap.cfg").join(iface);
569
+ const filled = fillVscodeTemplate(text, fill);
570
+ for (const token of filled.dropped)
571
+ dropped.add(token);
572
+ fs.writeFileSync(dest, filled.text, "utf8");
573
+ files.push(".vscode/" + name);
574
+ }
575
+ }
576
+ catch (error) {
577
+ return { files, warnings, error: "写 .vscode 配置失败:" + String(error.message) };
578
+ }
579
+ for (const token of dropped)
580
+ warnings.push(describeDroppedPlaceholder(token));
581
+ return { files, warnings, error: "" };
582
+ }