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
@@ -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
+ }
@@ -380,7 +380,3 @@ export function gateReportNotes(result) {
380
380
  lines.push("⚠ " + warning);
381
381
  return lines;
382
382
  }
383
- /** 一句话给别的工具拼失败报告用(tool card 第一行)。 */
384
- export function gateBlockedMessage(result) {
385
- return result.message;
386
- }
@@ -0,0 +1,227 @@
1
+ /**
2
+ * L1:变量监视与硬件观察点的登记表(纯状态 + 纯函数)。
3
+ *
4
+ * 为什么单独一层:
5
+ * - 登记项要跨 stm32_watch 的多次调用保留(add → sample → list → remove),
6
+ * 但"登记了什么、上次值是多少"是纯数据,放这里能离线单测;
7
+ * - 真正连 gdb 的动作(采样求值、装/删观察点)在 DebugSessionManager 里,
8
+ * 这样才能复用常驻的 MI 会话(P3)而不是每次另起一个 gdb;
9
+ * - 观察点(data watchpoint)和硬件断点抢同一批比较器(F1 只有 4 个),
10
+ * 预算校验也在这里做,别等 gdb 报 "Cannot insert watchpoint" 才发现。
11
+ *
12
+ * 生命周期:观察点活在 gdb 进程里。
13
+ * - 会话关闭(stm32_debug_stop / turn 结束 / 租约到期)时引擎会 resetWatchState(),登记表一起清;
14
+ * - MI 会话重建(gdb 进程没了、下次 eval 重新连)时观察点已经不在,
15
+ * markWatchpointsStale() 把编号清 0 并写明原因;值监视项不受影响,重新 sample 就行。
16
+ */
17
+ export const WATCH_KINDS = ["value", "write", "read", "access"];
18
+ /** 报告/提示里给人看的名字。 */
19
+ export const WATCH_KIND_LABELS = {
20
+ value: "值监视(每次 sample 求值)",
21
+ write: "写观察点(gdb watch)",
22
+ read: "读观察点(gdb rwatch)",
23
+ access: "读写观察点(gdb awatch)",
24
+ };
25
+ /** 一次会话里登记项的上限:再多的话 sample 一次要停芯片太久。 */
26
+ export const MAX_WATCH_ENTRIES = 32;
27
+ export const MAX_WATCH_EXPRESSION_LENGTH = 200;
28
+ export function createWatchState() {
29
+ return { entries: [], nextId: 1 };
30
+ }
31
+ /** 引擎用的单例:工具层与 DebugSessionManager 共用同一份登记表。 */
32
+ export const watchState = createWatchState();
33
+ export function isWatchKind(value) {
34
+ return WATCH_KINDS.includes(value);
35
+ }
36
+ /** 表达式去空白、拒绝空/超长/带换行的(带换行会把 gdb 命令行拆坏)。 */
37
+ export function normalizeWatchExpression(text) {
38
+ if (typeof text !== "string")
39
+ return null;
40
+ const trimmed = text.trim();
41
+ if (trimmed === "")
42
+ return null;
43
+ if (trimmed.length > MAX_WATCH_EXPRESSION_LENGTH)
44
+ return null;
45
+ if (/[\r\n\u0000]/u.test(trimmed))
46
+ return null;
47
+ return trimmed;
48
+ }
49
+ /**
50
+ * 登记一项。expression 会先规范化;同一个表达式 + 同一种 kind 只登记一次
51
+ * (重复登记只会让 sample 多读一遍同一处内存,没意义)。
52
+ */
53
+ export function registerWatch(state, expression, kind, now, gdbNumber = 0) {
54
+ const normalized = normalizeWatchExpression(expression);
55
+ if (normalized === null) {
56
+ return { entry: null, error: "表达式为空、超过 " + String(MAX_WATCH_EXPRESSION_LENGTH) + " 字符或带换行:" + JSON.stringify(expression) };
57
+ }
58
+ const duplicate = state.entries.find((item) => item.expression === normalized && item.kind === kind);
59
+ if (duplicate !== undefined) {
60
+ return { entry: null, error: "已经登记过:" + normalized + "(" + WATCH_KIND_LABELS[kind] + ",id " + String(duplicate.id) + ")" };
61
+ }
62
+ if (state.entries.length >= MAX_WATCH_ENTRIES) {
63
+ return { entry: null, error: "登记项太多(上限 " + String(MAX_WATCH_ENTRIES) + "):先 remove 掉不用的" };
64
+ }
65
+ const entry = {
66
+ id: state.nextId,
67
+ expression: normalized,
68
+ kind,
69
+ gdbNumber,
70
+ lastValue: "",
71
+ lastAt: 0,
72
+ lastError: "",
73
+ addedAt: now,
74
+ };
75
+ state.nextId += 1;
76
+ state.entries.push(entry);
77
+ return { entry, error: "" };
78
+ }
79
+ export function removeWatchByIds(state, ids) {
80
+ const wanted = new Set(ids);
81
+ const removed = [];
82
+ state.entries = state.entries.filter((entry) => {
83
+ if (wanted.has(entry.id)) {
84
+ removed.push(entry);
85
+ return false;
86
+ }
87
+ return true;
88
+ });
89
+ return removed;
90
+ }
91
+ export function removeAllWatches(state) {
92
+ const removed = state.entries.slice();
93
+ state.entries = [];
94
+ return removed;
95
+ }
96
+ export function resetWatchState(state = watchState) {
97
+ state.entries = [];
98
+ state.nextId = 1;
99
+ }
100
+ export function sampledWatches(state) {
101
+ return state.entries.filter((entry) => entry.kind === "value");
102
+ }
103
+ export function hardwareWatchpoints(state) {
104
+ return state.entries.filter((entry) => entry.kind !== "value");
105
+ }
106
+ /** MI 会话重建后调用:gdb 里那些观察点已经跟着旧进程没了。 */
107
+ export function markWatchpointsStale(state, reason) {
108
+ const affected = hardwareWatchpoints(state).filter((entry) => entry.gdbNumber !== 0);
109
+ for (const entry of affected) {
110
+ entry.gdbNumber = 0;
111
+ entry.lastError = reason;
112
+ }
113
+ return affected;
114
+ }
115
+ /** 记一次采样结果:出错时保留上一次的值(采样失败不该把历史值抹掉)。 */
116
+ export function recordWatchSample(entry, value, error, now) {
117
+ if (error === "" && value !== "")
118
+ entry.lastValue = value;
119
+ entry.lastAt = now;
120
+ entry.lastError = error;
121
+ }
122
+ /** gdb 打印的标量 → 数字;结构体/数组/字符串返回 null(算不了差值)。 */
123
+ export function numericWatchValue(text) {
124
+ const body = text.trim();
125
+ if (/^[-+]?0x[0-9a-f]+$/iu.test(body)) {
126
+ const hex = Number.parseInt(body, 16);
127
+ return Number.isFinite(hex) ? hex : null;
128
+ }
129
+ if (/^[-+]?\d+$/u.test(body)) {
130
+ const decimal = Number.parseInt(body, 10);
131
+ return Number.isFinite(decimal) ? decimal : null;
132
+ }
133
+ if (/^[-+]?\d*\.\d+$/u.test(body)) {
134
+ const float = Number.parseFloat(body);
135
+ return Number.isFinite(float) ? float : null;
136
+ }
137
+ return null;
138
+ }
139
+ /** 与上次值的差:数字给带符号差值,非数字给"变化"。 */
140
+ export function formatWatchDelta(previous, current) {
141
+ if (current === "")
142
+ return "—";
143
+ if (previous === "")
144
+ return "首次";
145
+ if (previous === current)
146
+ return "0";
147
+ const before = numericWatchValue(previous);
148
+ const after = numericWatchValue(current);
149
+ if (before !== null && after !== null) {
150
+ const diff = after - before;
151
+ return (diff > 0 ? "+" : "") + String(diff);
152
+ }
153
+ return "变化";
154
+ }
155
+ /**
156
+ * 采样结果的提示尾巴。最要紧的是区分「目标本来就在停着」:会话刚起时 MI 已经 monitor halt 过,
157
+ * 这时候采计数器的 delta 全是 0(外设照跑,所以 DMA 值反而会变),不说清就像工具坏了。
158
+ */
159
+ export function formatWatchSampleNote(halted, resumed, targetWasRunning) {
160
+ if (!targetWasRunning)
161
+ return "(目标本来就在停着:值不会变,想看得先 continue 或 monitor resume)";
162
+ if (halted && resumed)
163
+ return "(目标在跑,已停下采完再放回去)";
164
+ if (halted)
165
+ return "(目标在跑,已停下采样)";
166
+ return "";
167
+ }
168
+ /** 列表里一行:id + 表达式 + 种类 + 最近值(或失败原因)。 */
169
+ export function formatWatchEntry(entry) {
170
+ const parts = ["#" + String(entry.id), entry.expression, "[" + WATCH_KIND_LABELS[entry.kind] + "]"];
171
+ parts.push(entry.lastValue === "" ? "= (还没采过)" : "= " + entry.lastValue);
172
+ if (entry.gdbNumber > 0)
173
+ parts.push("(gdb #" + String(entry.gdbNumber) + ")");
174
+ if (entry.lastError !== "")
175
+ parts.push("x " + entry.lastError);
176
+ return parts.join(" ");
177
+ }
178
+ export function formatWatchLines(entries) {
179
+ return entries.map((entry) => formatWatchEntry(entry));
180
+ }
181
+ /**
182
+ * 解析 eval 回退路径的输出:每条表达式前面用 echo ===DSH:W<id>=== 打了标记,
183
+ * 标记后是 gdb 打印的 "$N = ..."。结构体/数组会打多行,整段都算这条的值。
184
+ */
185
+ export function parseWatchMarkers(output) {
186
+ const values = new Map();
187
+ const marks = [];
188
+ for (const match of output.matchAll(/===DSH:W(\d+)===/gu)) {
189
+ const id = Number(match[1]);
190
+ const start = match.index ?? 0;
191
+ if (!Number.isFinite(id))
192
+ continue;
193
+ marks.push({ id, start, end: start + match[0].length });
194
+ }
195
+ for (let index = 0; index < marks.length; index += 1) {
196
+ const mark = marks[index];
197
+ const next = marks[index + 1];
198
+ const segment = output.slice(mark.end, next === undefined ? output.length : next.start).trim();
199
+ if (segment === "") {
200
+ values.set(mark.id, { value: "", error: "没有输出" });
201
+ continue;
202
+ }
203
+ const printed = /^\$\d+\s*=\s*([\s\S]*)$/u.exec(segment);
204
+ if (printed === null) {
205
+ const firstLine = segment.split(/\r?\n/u)[0] ?? segment;
206
+ values.set(mark.id, { value: "", error: firstLine.trim() });
207
+ continue;
208
+ }
209
+ values.set(mark.id, { value: printed[1].trim(), error: "" });
210
+ }
211
+ return values;
212
+ }
213
+ /**
214
+ * 从 gdb 输出里取观察点编号。
215
+ * 形如 "Hardware watchpoint 2: g_tick_1k"、"Watchpoint 3: foo"(软件观察点,单步开销大)。
216
+ */
217
+ export function parseWatchpointNumber(text) {
218
+ const match = /watchpoint\s+(\d+)\s*:/iu.exec(text);
219
+ if (match === null)
220
+ return null;
221
+ const number = Number(match[1]);
222
+ return Number.isFinite(number) && number > 0 ? number : null;
223
+ }
224
+ /** gdb 建的是硬件观察点还是软件观察点(软件观察点会拖慢目标,报告里要说明)。 */
225
+ export function isHardwareWatchpoint(text) {
226
+ return /Hardware\s+(?:read\s+|access\s+)?watchpoint/iu.test(text);
227
+ }
package/lib/index.js CHANGED
@@ -12,7 +12,9 @@
12
12
  */
13
13
  import { registerCommands } from "./commands/register.js";
14
14
  import { debugSessions } from "./engine/debug-session.js";
15
+ import { stopRtt } from "./engine/rtt.js";
15
16
  import { registerStm32Skill } from "./skill/stm32-workflow.js";
17
+ import { registerAssets } from "./tools/assets.js";
16
18
  import { registerBuild } from "./tools/build.js";
17
19
  import { registerCache } from "./tools/cache.js";
18
20
  import { registerCodePatch } from "./tools/code-patch.js";
@@ -20,17 +22,19 @@ import { registerDebugRun } from "./tools/debug.js";
20
22
  import { registerDebugSession } from "./tools/debug-session.js";
21
23
  import { registerDoctor } from "./tools/doctor.js";
22
24
  import { registerEnvInstall } from "./tools/env-install.js";
23
- import { registerEnvProbe } from "./tools/env-probe.js";
24
25
  import { registerFirmwareInstall } from "./tools/firmware-install.js";
25
26
  import { registerFlash } from "./tools/flash.js";
26
27
  import { registerGenerate } from "./tools/generate.js";
27
28
  import { registerIocApply } from "./tools/ioc-apply.js";
28
29
  import { registerIocInspect } from "./tools/ioc-inspect.js";
29
30
  import { registerIocPlan } from "./tools/ioc-plan.js";
31
+ import { registerIocVerify } from "./tools/ioc-verify.js";
30
32
  import { registerProjectCreate } from "./tools/project-create.js";
31
33
  import { registerProjectExport } from "./tools/project-export.js";
32
34
  import { registerRegsRead } from "./tools/regs.js";
33
35
  import { registerRoutePlan } from "./tools/route-plan.js";
36
+ import { registerRtt } from "./tools/rtt.js";
37
+ import { registerWatchTool } from "./tools/watch.js";
34
38
  import { registerWebRoutes } from "./engine/web-routes.js";
35
39
  export const name = "dsh-stm32";
36
40
  export const inject = ["tools", "subprocess", "jobs"];
@@ -61,7 +65,6 @@ export function callerIdOf(event, session) {
61
65
  return "";
62
66
  }
63
67
  export function apply(ctx) {
64
- registerEnvProbe(ctx);
65
68
  registerEnvInstall(ctx);
66
69
  registerFirmwareInstall(ctx);
67
70
  registerProjectCreate(ctx);
@@ -71,12 +74,16 @@ export function apply(ctx) {
71
74
  registerIocInspect(ctx);
72
75
  registerIocPlan(ctx);
73
76
  registerIocApply(ctx);
77
+ registerIocVerify(ctx);
74
78
  registerBuild(ctx);
75
79
  registerFlash(ctx);
76
80
  registerDebugRun(ctx);
77
81
  registerDebugSession(ctx);
78
82
  registerRegsRead(ctx);
79
83
  registerRoutePlan(ctx);
84
+ registerRtt(ctx);
85
+ registerWatchTool(ctx);
86
+ registerAssets(ctx);
80
87
  registerCache(ctx);
81
88
  registerDoctor(ctx);
82
89
  // 设置面板的宿主 API(浏览器端 lib/client.js 用)。宿主没 webServer 服务时静默跳过。
@@ -99,6 +106,9 @@ export function apply(ctx) {
99
106
  ctx.on("session/event", (session, event) => {
100
107
  if (event?.type !== "turn/end")
101
108
  return;
109
+ // RTT 的 rtt server 挂在同一个 openocd 上:会话一关它也跟着没了,本地状态不能继续
110
+ // 报 running。先收 RTT 再收会话,顺序只影响日志好不好看。
111
+ void stopRtt();
102
112
  // A9:只关这条会话自己开的调试会话。事件结构宿主没公开,所以按可能的位置逐个试;
103
113
  // 全都取不到就传空串,debug-session 会退回原来的「无条件关」行为。
104
114
  const owner = callerIdOf(event, session);