dsh-stm32 0.1.7 → 0.1.9
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.
- package/README.md +567 -516
- package/README_EN.md +544 -510
- package/client/client.js +7033 -682
- package/docs/reading-guide.md +921 -859
- package/lib/client.js +7033 -682
- package/lib/commands/register.js +2 -0
- package/lib/data/firmware-packages.js +35 -0
- package/lib/data/firmware-pins.js +7 -0
- package/lib/data/install-guides.js +110 -0
- package/lib/data/ioc-presets.js +118 -0
- package/lib/engine/artifacts.js +123 -0
- package/lib/engine/breakpoint-hits.js +73 -0
- package/lib/engine/build.js +161 -5
- package/lib/engine/channel-tap.js +227 -0
- package/lib/engine/channels.js +48 -0
- package/lib/engine/clocks.js +192 -0
- package/lib/engine/datasheet/auto.js +74 -0
- package/lib/engine/datasheet/digest.js +74 -0
- package/lib/engine/datasheet/lcsc.js +60 -0
- package/lib/engine/datasheet/pinout.js +119 -0
- package/lib/engine/datasheet/price.js +152 -0
- package/lib/engine/datasheet/search.js +147 -0
- package/lib/engine/datasheet/store.js +371 -0
- package/lib/engine/debug-session.js +48 -2
- package/lib/engine/ecad/autobuild.js +156 -0
- package/lib/engine/ecad/bom.js +238 -0
- package/lib/engine/ecad/brief.js +205 -0
- package/lib/engine/ecad/checks.js +239 -0
- package/lib/engine/ecad/design.js +177 -0
- package/lib/engine/ecad/dfm.js +314 -0
- package/lib/engine/ecad/easyeda.js +454 -0
- package/lib/engine/ecad/fabrication.js +104 -0
- package/lib/engine/ecad/gen/footprint.js +159 -0
- package/lib/engine/ecad/gen/symbol.js +103 -0
- package/lib/engine/ecad/import.js +372 -0
- package/lib/engine/ecad/jlcpcb.js +141 -0
- package/lib/engine/ecad/libs.js +316 -0
- package/lib/engine/ecad/models3d.js +89 -0
- package/lib/engine/ecad/netgate.js +286 -0
- package/lib/engine/ecad/normalize.js +182 -0
- package/lib/engine/ecad/package.js +126 -0
- package/lib/engine/ecad/padmerge.js +128 -0
- package/lib/engine/ecad/padprecheck.js +123 -0
- package/lib/engine/ecad/part-import.js +257 -0
- package/lib/engine/ecad/pcb/apply.js +53 -0
- package/lib/engine/ecad/pcb/emc-deep.js +396 -0
- package/lib/engine/ecad/pcb/emc.js +275 -0
- package/lib/engine/ecad/pcb/geometry.js +63 -0
- package/lib/engine/ecad/pcb/gerber.js +499 -0
- package/lib/engine/ecad/pcb/hand-sync.js +242 -0
- package/lib/engine/ecad/pcb/impedance.js +119 -0
- package/lib/engine/ecad/pcb/ipc-open.js +78 -0
- package/lib/engine/ecad/pcb/ipc-script.js +276 -0
- package/lib/engine/ecad/pcb/ipc.js +129 -0
- package/lib/engine/ecad/pcb/krt.js +182 -0
- package/lib/engine/ecad/pcb/links.js +393 -0
- package/lib/engine/ecad/pcb/mech.js +201 -0
- package/lib/engine/ecad/pcb/model-fix.js +178 -0
- package/lib/engine/ecad/pcb/netlist.js +146 -0
- package/lib/engine/ecad/pcb/pcb-svg.js +199 -0
- package/lib/engine/ecad/pcb/placement.js +140 -0
- package/lib/engine/ecad/pcb/power.js +203 -0
- package/lib/engine/ecad/pcb/render3d.js +208 -0
- package/lib/engine/ecad/pcb/route.js +167 -0
- package/lib/engine/ecad/pcb/router.js +469 -0
- package/lib/engine/ecad/pcb/rules.js +122 -0
- package/lib/engine/ecad/pcb/scene.js +513 -0
- package/lib/engine/ecad/pcb/stackup.js +154 -0
- package/lib/engine/ecad/pcb/swap.js +222 -0
- package/lib/engine/ecad/pcb/tracks.js +70 -0
- package/lib/engine/ecad/runtime.js +227 -0
- package/lib/engine/ecad/toolchain.js +146 -0
- package/lib/engine/ecad/tsci.js +362 -0
- package/lib/engine/ecad/zip.js +98 -0
- package/lib/engine/event-bus.js +158 -0
- package/lib/engine/event-log.js +335 -0
- package/lib/engine/fault-hints.js +146 -0
- package/lib/engine/generate-script.js +4 -1
- package/lib/engine/generate.js +145 -5
- package/lib/engine/interrupts.js +247 -0
- package/lib/engine/ioc-diff.js +369 -0
- package/lib/engine/ioc-plan.js +12 -2
- package/lib/engine/ioc-sync.js +58 -0
- package/lib/engine/mcu-info.js +134 -0
- package/lib/engine/msys2-install.js +31 -6
- package/lib/engine/panel-actions.js +103 -0
- package/lib/engine/pdf/curve.js +321 -0
- package/lib/engine/pdf/png.js +83 -0
- package/lib/engine/pdf/reader.js +336 -0
- package/lib/engine/pdf/schematic.js +93 -0
- package/lib/engine/pdf/tables.js +249 -0
- package/lib/engine/pdf/toolchain.js +50 -0
- package/lib/engine/pinout.js +140 -0
- package/lib/engine/probe-info.js +95 -0
- package/lib/engine/probe.js +45 -0
- package/lib/engine/progress.js +99 -0
- package/lib/engine/project-conf.js +254 -0
- package/lib/engine/project-layout.js +198 -0
- package/lib/engine/project-repair.js +205 -0
- package/lib/engine/schematic/checks.js +153 -0
- package/lib/engine/schematic/draw.js +390 -0
- package/lib/engine/schematic/edit.js +229 -0
- package/lib/engine/schematic/kicad-sch.js +225 -0
- package/lib/engine/schematic/model.js +442 -0
- package/lib/engine/schematic/nets.js +219 -0
- package/lib/engine/schematic/pcb.js +144 -0
- package/lib/engine/schematic/review.js +134 -0
- package/lib/engine/schematic/sexpr.js +134 -0
- package/lib/engine/schematic/to-ioc.js +197 -0
- package/lib/engine/schematic/transform.js +25 -0
- package/lib/engine/session-context.js +106 -0
- package/lib/engine/source-slice.js +59 -0
- package/lib/engine/tool-events.js +119 -0
- package/lib/engine/toolchain-gate.js +8 -0
- package/lib/engine/watch-admin.js +101 -0
- package/lib/engine/watch-record.js +39 -0
- package/lib/engine/watch-recorder.js +116 -0
- package/lib/engine/web-api.js +1123 -4
- package/lib/engine/web-routes.js +18 -1
- package/lib/engine/workspace-memo.js +41 -0
- package/lib/index.js +118 -24
- package/lib/skill/stm32-workflow.js +1 -1
- package/lib/tools/build.js +10 -2
- package/lib/tools/code-patch.js +2 -2
- package/lib/tools/datasheet.js +447 -0
- package/lib/tools/debug-session.js +9 -4
- package/lib/tools/debug.js +2 -2
- package/lib/tools/doctor.js +2 -2
- package/lib/tools/ecad.js +903 -0
- package/lib/tools/flash.js +2 -2
- package/lib/tools/gen.js +166 -0
- package/lib/tools/generate.js +7 -5
- package/lib/tools/import-circuit.js +146 -0
- package/lib/tools/ioc-apply.js +11 -2
- package/lib/tools/ioc-inspect.js +2 -2
- package/lib/tools/ioc-plan.js +2 -2
- package/lib/tools/ioc-verify.js +2 -2
- package/lib/tools/layout.js +92 -0
- package/lib/tools/mcu-info.js +163 -0
- package/lib/tools/part-import.js +182 -0
- package/lib/tools/pcb.js +2316 -0
- package/lib/tools/pdf.js +423 -0
- package/lib/tools/project-create.js +28 -0
- package/lib/tools/project-dir.js +25 -1
- package/lib/tools/regs.js +2 -2
- package/lib/tools/route-plan.js +2 -2
- package/lib/tools/rtt.js +10 -2
- package/lib/tools/sch-draw.js +433 -0
- package/lib/tools/sch-edit.js +145 -0
- package/lib/tools/schematic.js +817 -0
- package/lib/tools/serial.js +22 -0
- package/lib/tools/watch.js +24 -2
- package/package.json +1 -1
package/lib/commands/register.js
CHANGED
|
@@ -96,6 +96,41 @@ export const FIRMWARE_FAMILIES = {
|
|
|
96
96
|
},
|
|
97
97
|
],
|
|
98
98
|
},
|
|
99
|
+
F4: {
|
|
100
|
+
family: "F4",
|
|
101
|
+
packageBase: "STM32Cube_FW_F4",
|
|
102
|
+
defaultVersion: "1.28.0",
|
|
103
|
+
halDir: "Drivers/STM32F4xx_HAL_Driver",
|
|
104
|
+
deviceDir: "Drivers/CMSIS/Device/ST/STM32F4xx",
|
|
105
|
+
coreRepo: "STM32CubeF4",
|
|
106
|
+
coreRef: "master",
|
|
107
|
+
coreIncludeDir: "Drivers/CMSIS/Include",
|
|
108
|
+
coreHeaders: ["cmsis_compiler.h", "cmsis_gcc.h", "cmsis_version.h", "mpu_armv7.h", "core_cm4.h"],
|
|
109
|
+
archives: [
|
|
110
|
+
{
|
|
111
|
+
id: "hal",
|
|
112
|
+
label: "HAL 驱动(stm32f4xx-hal-driver)",
|
|
113
|
+
repo: "stm32f4xx-hal-driver",
|
|
114
|
+
ref: "master",
|
|
115
|
+
dirs: [
|
|
116
|
+
{ from: "Inc", to: "Drivers/STM32F4xx_HAL_Driver/Inc" },
|
|
117
|
+
{ from: "Src", to: "Drivers/STM32F4xx_HAL_Driver/Src" },
|
|
118
|
+
],
|
|
119
|
+
urls: archiveUrls("stm32f4xx-hal-driver", "master"),
|
|
120
|
+
},
|
|
121
|
+
{
|
|
122
|
+
id: "device",
|
|
123
|
+
label: "CMSIS 设备支持(cmsis-device-f4)",
|
|
124
|
+
repo: "cmsis-device-f4",
|
|
125
|
+
ref: "master",
|
|
126
|
+
dirs: [
|
|
127
|
+
{ from: "Include", to: "Drivers/CMSIS/Device/ST/STM32F4xx/Include" },
|
|
128
|
+
{ from: "Source", to: "Drivers/CMSIS/Device/ST/STM32F4xx/Source" },
|
|
129
|
+
],
|
|
130
|
+
urls: archiveUrls("cmsis-device-f4", "master"),
|
|
131
|
+
},
|
|
132
|
+
],
|
|
133
|
+
},
|
|
99
134
|
F3: {
|
|
100
135
|
family: "F3",
|
|
101
136
|
packageBase: "STM32Cube_FW_F3",
|
|
@@ -6,6 +6,8 @@ export const FIRMWARE_ARCHIVE_PINS = {
|
|
|
6
6
|
"cmsis-device-f1@master": { sha256: "491ff97b7269e27a84e3b908d3b65d63d4dfc38c385de579a26af2382d8909fe", bytes: 1086613 },
|
|
7
7
|
"cmsis-device-f2@master": { sha256: "531048d083630a2c533b494df2832225fb17f21dd1e2db2cd24a10764117e13c", bytes: 570002 },
|
|
8
8
|
"cmsis-device-f3@master": { sha256: "1e9cbd17629346b18ed49618132bda41da45dbfa93dfd1363ac11dca00a5f86d", bytes: 1602025 },
|
|
9
|
+
"cmsis-device-f4@master": { sha256: "dee070c37bcfc08cd1df4bab271d2b31adfa0742e5ac2f969636c3c204952510", bytes: 2877163 },
|
|
10
|
+
"stm32f4xx-hal-driver@master": { sha256: "368b397b70a2aef4a8b0a855e885366c24b1820e6467759028c1ec87c2df4870", bytes: 1344810 },
|
|
9
11
|
"cmsis-device-f7@master": { sha256: "30e46a88abf06f8456275f4b72f154e378ba8c5430843a25c183d417e0ac8aca", bytes: 2297133 },
|
|
10
12
|
"cmsis-device-g0@master": { sha256: "932db70cb121c344dd3a267e64343c8de54fe6b3bd3a2354bebd09916227b69a", bytes: 1065568 },
|
|
11
13
|
"cmsis-device-l1@master": { sha256: "fdb847637ea1a3766e9102d2e655fa014a8f3b775c5b559f527fded001eb00dd", bytes: 1729637 },
|
|
@@ -54,6 +56,11 @@ export const FIRMWARE_CORE_PINS = {
|
|
|
54
56
|
"STM32CubeF2@master/Drivers/CMSIS/Include/cmsis_version.h": { sha256: "c2570d56ee85d4f2ec0fb62f31d080d3cddf3a015500a4ed5a006a571637b43c", bytes: 1677 },
|
|
55
57
|
"STM32CubeF2@master/Drivers/CMSIS/Include/core_cm3.h": { sha256: "655bb08e9474438dec8b1874ea6c63749dc2787b85f06a0987c4870bcb580f21", bytes: 109913 },
|
|
56
58
|
"STM32CubeF2@master/Drivers/CMSIS/Include/mpu_armv7.h": { sha256: "e4968e627df085e4ebf46be5140be657e035d978ae1938c1c2e3ee49fbde5030", bytes: 11441 },
|
|
59
|
+
"STM32CubeF4@master/Drivers/CMSIS/Include/cmsis_compiler.h": { sha256: "b51963d271c1571ca3463654c76aa7ea50c4eac5d0a2710df10414ac64d9e0f8", bytes: 9481 },
|
|
60
|
+
"STM32CubeF4@master/Drivers/CMSIS/Include/cmsis_gcc.h": { sha256: "43bfd1fe69fbbc2ca70aaf7d43cc3e20f16e0c7f66e1bdef9b51af6dc14b2617", bytes: 63374 },
|
|
61
|
+
"STM32CubeF4@master/Drivers/CMSIS/Include/cmsis_version.h": { sha256: "184c19fd3ee73632edf35a0b4d49cd48be75fbf49e6ccb19d9db05fa83bea4b3", bytes: 1680 },
|
|
62
|
+
"STM32CubeF4@master/Drivers/CMSIS/Include/core_cm4.h": { sha256: "f5b63d52dd1557b15ca414cb59c264f595a7b5669db2a5878dffe22f4caedc8c", bytes: 120975 },
|
|
63
|
+
"STM32CubeF4@master/Drivers/CMSIS/Include/mpu_armv7.h": { sha256: "29206b52ee02290ed6f5a5415ebd4187de802cf176d9b3cb844390d8e5571372", bytes: 11731 },
|
|
57
64
|
"STM32CubeF3@master/Drivers/CMSIS/Include/cmsis_compiler.h": { sha256: "03ab80c426a8360eaaad833ac816462a9f38cb2e4dbdc490914880ad071181fe", bytes: 8748 },
|
|
58
65
|
"STM32CubeF3@master/Drivers/CMSIS/Include/cmsis_gcc.h": { sha256: "341982e6d6c91119214c47d7a04b31f1f8ce0970c45e2c9fe0870c80d0876e28", bytes: 60259 },
|
|
59
66
|
"STM32CubeF3@master/Drivers/CMSIS/Include/cmsis_version.h": { sha256: "c2570d56ee85d4f2ec0fb62f31d080d3cddf3a015500a4ed5a006a571637b43c", bytes: 1677 },
|
|
@@ -22,6 +22,12 @@ export const COMPONENT_INSTALLABILITY = {
|
|
|
22
22
|
cubemx: "manual",
|
|
23
23
|
"cubemx-java": "manual",
|
|
24
24
|
firmware: "manual",
|
|
25
|
+
// KiCad 是独立安装包(1.5 GB,带自有 Python 与 bun),装法与版本都由 ST 之外的厂商管;
|
|
26
|
+
// npm 随 Node.js 来,可能先有 node 再有 npm,也可能反过来。
|
|
27
|
+
kicad: "manual",
|
|
28
|
+
npm: "manual",
|
|
29
|
+
// poppler 在 MSYS2 的仓库里,一条 pacman 就能补;插件不代装,但能给准确命令。
|
|
30
|
+
poppler: "auto",
|
|
25
31
|
};
|
|
26
32
|
const CUBEMX_LABEL = "STM32CubeMX(启动器)+ 内置 JRE";
|
|
27
33
|
/**
|
|
@@ -153,6 +159,12 @@ export function guideFor(component, firmware = { family: "", packageName: "", re
|
|
|
153
159
|
return cubeMxGuide();
|
|
154
160
|
if (component === "firmware")
|
|
155
161
|
return firmwareGuide(firmware);
|
|
162
|
+
if (component === "kicad")
|
|
163
|
+
return kicadGuide();
|
|
164
|
+
if (component === "npm")
|
|
165
|
+
return npmGuide();
|
|
166
|
+
if (component === "poppler")
|
|
167
|
+
return popplerGuide();
|
|
156
168
|
return null;
|
|
157
169
|
}
|
|
158
170
|
/** 一批组件 → 去重后的指引(cubemx + cubemx-java 只留一份,顺序稳定)。 */
|
|
@@ -188,3 +200,101 @@ export function guideLines(guide, maxSteps = 4) {
|
|
|
188
200
|
lines.push(" 免安装:" + guide.portable);
|
|
189
201
|
return lines;
|
|
190
202
|
}
|
|
203
|
+
/**
|
|
204
|
+
* KiCad 的安装指引。
|
|
205
|
+
*
|
|
206
|
+
* 事实依据(2026-11 取证):电路设计的构建与检查全部落在 KiCad 自带的三件套上——
|
|
207
|
+
* `bin/kicad-cli.exe`(ERC/DRC/Gerber/STEP)、`bin/bun.exe`(跑 tscircuit 的 TSX 入口,
|
|
208
|
+
* Node 直接跑会报 `Unknown file extension ".tsx"`)、`bin/python.exe`(3.11,带 pcbnew)。
|
|
209
|
+
* 所以「装了 tscircuit」不等于能用:必须装 KiCad 10。
|
|
210
|
+
*/
|
|
211
|
+
export function kicadGuide() {
|
|
212
|
+
return {
|
|
213
|
+
component: "kicad",
|
|
214
|
+
label: "KiCad 10(kicad-cli / bun / pcbnew)",
|
|
215
|
+
installability: "manual",
|
|
216
|
+
why: "电路设计的构建、检查与导出调用的是 KiCad 自带的 kicad-cli 与 bun,插件不自带 EDA 内核。",
|
|
217
|
+
sizeHint: "约 1.5 GB(含符号库、封装库与 3D 模型)",
|
|
218
|
+
needsAccount: false,
|
|
219
|
+
steps: [
|
|
220
|
+
{
|
|
221
|
+
title: "官网下载 10.x 安装包",
|
|
222
|
+
detail: "kicad.org/download 选 Windows 安装包;装到默认目录即可被自动发现。",
|
|
223
|
+
command: "https://www.kicad.org/download/windows/",
|
|
224
|
+
},
|
|
225
|
+
{
|
|
226
|
+
title: "非默认目录时指路径",
|
|
227
|
+
detail: "把安装根目录(含 bin/ 与 share/kicad/)写进配置项 DSH_STM32_KICAD_ROOT。",
|
|
228
|
+
command: 'setx DSH_STM32_KICAD_ROOT "D:/app/KiCad/10.0"',
|
|
229
|
+
},
|
|
230
|
+
{
|
|
231
|
+
title: "确认版本是 10.x",
|
|
232
|
+
detail: "原理图读取只认 KiCad 10 的文件格式(version 20260306),9 及更早的工程会明确拒绝。",
|
|
233
|
+
},
|
|
234
|
+
],
|
|
235
|
+
verify: "kicad-cli version(应输出 10.x)",
|
|
236
|
+
portable: "把已有 KiCad 目录整个拷过来,设置 DSH_STM32_KICAD_ROOT 指向它即可。",
|
|
237
|
+
};
|
|
238
|
+
}
|
|
239
|
+
/**
|
|
240
|
+
* npm 的安装指引。
|
|
241
|
+
*
|
|
242
|
+
* tscircuit 的依赖(约 730 MB)由 `npm install` 拉进 hardware/circuit/node_modules;
|
|
243
|
+
* 构建本身用 KiCad 的 bun 跑,不依赖 node 的模块解析,但装依赖这一步绕不开 npm。
|
|
244
|
+
*/
|
|
245
|
+
export function npmGuide() {
|
|
246
|
+
return {
|
|
247
|
+
component: "npm",
|
|
248
|
+
label: "Node.js 的 npm(安装 tscircuit 依赖)",
|
|
249
|
+
installability: "manual",
|
|
250
|
+
why: "首次构建要在 hardware/circuit 下执行 npm install 拉 tscircuit 及其 259 个依赖。",
|
|
251
|
+
sizeHint: "Node.js 约 30 MB;依赖下载约 730 MB",
|
|
252
|
+
needsAccount: false,
|
|
253
|
+
steps: [
|
|
254
|
+
{
|
|
255
|
+
title: "安装 Node.js LTS",
|
|
256
|
+
detail: "npm 随 Node.js 一起安装;装完新开终端确认 PATH 生效。",
|
|
257
|
+
command: "winget install OpenJS.NodeJS.LTS",
|
|
258
|
+
},
|
|
259
|
+
{
|
|
260
|
+
title: "已有 Node.js 时确认 npm 在 PATH",
|
|
261
|
+
detail: "插件通过 PATH 找 npm;nvm 等多版本管理器需要先切到有 npm 的版本。",
|
|
262
|
+
},
|
|
263
|
+
],
|
|
264
|
+
verify: "npm --version",
|
|
265
|
+
};
|
|
266
|
+
}
|
|
267
|
+
/**
|
|
268
|
+
* poppler(S117):PDF 的文字、页面渲染与图内位图。
|
|
269
|
+
*
|
|
270
|
+
* 选 poppler 而不是 pymupdf:一个 pacman 包同时给出 pdftotext / pdfinfo / pdftoppm /
|
|
271
|
+
* pdftocairo,都是独立可执行文件,不需要往任何 Python 环境里装库。
|
|
272
|
+
*/
|
|
273
|
+
export function popplerGuide() {
|
|
274
|
+
return {
|
|
275
|
+
component: "poppler",
|
|
276
|
+
label: "poppler(PDF 文字与页面渲染)",
|
|
277
|
+
installability: "auto",
|
|
278
|
+
why: "读数据手册与原理图 PDF 时,文字与表格交给 pdftotext,曲线与控制框图交给 pdftoppm 渲染成图像。",
|
|
279
|
+
sizeHint: "约 11 MB(含 poppler-data)",
|
|
280
|
+
needsAccount: false,
|
|
281
|
+
steps: [
|
|
282
|
+
{
|
|
283
|
+
title: "在 MSYS2 里装",
|
|
284
|
+
detail: "打开 MSYS2 UCRT64 终端执行下面的命令;装到 ucrt64/bin,插件默认会检索这个目录。",
|
|
285
|
+
command: "pacman -S --needed mingw-w64-ucrt-x86_64-poppler",
|
|
286
|
+
},
|
|
287
|
+
{
|
|
288
|
+
title: "确认三个命令都在",
|
|
289
|
+
detail: "pdftotext、pdfinfo、pdftoppm 都要能找到;缺一个就重装整包(poppler-data 一并装上)。",
|
|
290
|
+
command: "pdftotext -v && pdfinfo -v && pdftoppm -v",
|
|
291
|
+
},
|
|
292
|
+
{
|
|
293
|
+
title: "不在默认目录时指路径",
|
|
294
|
+
detail: "把 bin 目录写进配置项 binDirs,或在会话里设 DSH_STM32_BIN_DIRS。",
|
|
295
|
+
command: 'setx DSH_STM32_BIN_DIRS "C:/msys64/ucrt64/bin"',
|
|
296
|
+
},
|
|
297
|
+
],
|
|
298
|
+
verify: "stm32_doctor(poppler 一行应显示版本号)",
|
|
299
|
+
};
|
|
300
|
+
}
|
package/lib/data/ioc-presets.js
CHANGED
|
@@ -54,6 +54,103 @@ function usart(name, tx, rx) {
|
|
|
54
54
|
notes: [name + ":默认 8N1 / 115200(CubeMX 缺省值),要改波特率请用 entries 设 " + name + ".IPParameters 与对应键"],
|
|
55
55
|
};
|
|
56
56
|
}
|
|
57
|
+
/**
|
|
58
|
+
* SPI 主机预设(S187):键集与「引脚 .Mode 必须与模式配套」这两点都是实测出来的。
|
|
59
|
+
*
|
|
60
|
+
* 实测(F303 + CubeMX 6.18.1):`Full_Duplex_Master` 只配了 SCK/MOSI、缺 MISO 时,
|
|
61
|
+
* CubeMX **静默丢弃整个 SPI1**——不出 spi.c、`HAL_SPI_MODULE_ENABLED` 仍是注释,
|
|
62
|
+
* 日志里连 `Load IP Config File for SPI1` 都没有。补齐 PA6(MISO) 后立刻生成 MX_SPI1_Init;
|
|
63
|
+
* 把 Direction 改成 1LINE、两根脚改成 `TransmitOnly_Master`(只发不收)也能生成。
|
|
64
|
+
* 所以 SPI 的 .Mode 不是装饰:它决定这套脚是否构成一个完整配置。
|
|
65
|
+
*/
|
|
66
|
+
function spi(name, mode, pins) {
|
|
67
|
+
const direction = mode === "Full_Duplex_Master" ? "SPI_DIRECTION_2LINES" : "SPI_DIRECTION_1LINE";
|
|
68
|
+
const suffix = mode === "Full_Duplex_Master" ? "" : "(" + (mode === "TransmitOnly_Master" ? "只发" : "只收") + ")";
|
|
69
|
+
return {
|
|
70
|
+
name: mode === "Full_Duplex_Master" ? name : name + (mode === "TransmitOnly_Master" ? ":tx" : ":rx"),
|
|
71
|
+
label: name + " SPI 主机" + suffix,
|
|
72
|
+
ip: name,
|
|
73
|
+
pins: pins.map((entry) => ({ role: entry.role, defaultPin: entry.pin, signal: name + "_" + entry.role.toUpperCase(), mode })),
|
|
74
|
+
parameters: [
|
|
75
|
+
{ name: "VirtualType", value: "VM_MASTER" },
|
|
76
|
+
{ name: "Mode", value: "SPI_MODE_MASTER" },
|
|
77
|
+
{ name: "Direction", value: direction },
|
|
78
|
+
{ name: "TIMode", value: "SPI_TIMODE_DISABLE" },
|
|
79
|
+
{ name: "DataSize", value: "SPI_DATASIZE_8BIT" },
|
|
80
|
+
{ name: "FirstBit", value: "SPI_FIRSTBIT_MSB" },
|
|
81
|
+
{ name: "BaudRatePrescaler", value: "SPI_BAUDRATEPRESCALER_4" },
|
|
82
|
+
{ name: "CalculateBaudRate", value: "true" },
|
|
83
|
+
{ name: "CLKPolarity", value: "SPI_POLARITY_LOW" },
|
|
84
|
+
{ name: "CLKPhase", value: "SPI_PHASE_1EDGE" },
|
|
85
|
+
{ name: "NSS", value: "SPI_NSS_SOFT" },
|
|
86
|
+
{ name: "CRCCalculation", value: "SPI_CRCCALCULATION_DISABLE" },
|
|
87
|
+
{ name: "CRCPolynomial", value: "7" },
|
|
88
|
+
],
|
|
89
|
+
notes: [
|
|
90
|
+
name + ":" + (mode === "Full_Duplex_Master"
|
|
91
|
+
? "全双工要求 SCK+MISO+MOSI 三根脚齐全,缺一根 CubeMX 会把整个外设静默丢掉"
|
|
92
|
+
: "只发/只收模式用 " + String(direction) + ",只占 " + String(pins.length) + " 根脚"),
|
|
93
|
+
"默认 8Bit / MSB / CPOL=Low / CPHA=1Edge / NSS=软件 / 分频 4(72 MHz 下 18 MHz);" +
|
|
94
|
+
"要看实际时钟用 entries 设 " + name + ".BaudRatePrescaler",
|
|
95
|
+
],
|
|
96
|
+
};
|
|
97
|
+
}
|
|
98
|
+
/**
|
|
99
|
+
* I2C 主机预设(S187):键名分两代,**按芯片用的 IP 版本选**。
|
|
100
|
+
*
|
|
101
|
+
* - 老的 I2C v1(i2c1_v1_0/v1_1,F1/F2/F4/L1 等):`ClockSpeed` + `DutyCycle` + `OwnAddress1`;
|
|
102
|
+
* - 新的 I2C v2(i2c2_v1_1,F0/F3/L0+/L4/G0/G4 等):`I2C_Speed_Mode` + `Speed` + `Timing` + `OwnAddress`
|
|
103
|
+
* (见 `db/mcu/IP/I2C-F0-i2c2_v1_1_Cube_Modes.xml` 的 RefMode I2C 参数表)。
|
|
104
|
+
*
|
|
105
|
+
* 写错代的键不会报错——CubeMX 只是不认,然后安静地什么都不生成(实测 F303 上第一版用了
|
|
106
|
+
* `ClockSpeed/DutyCycle`,生成阶段直接 CodeEngine 报错、连 main.c 都没有)。所以这一条按族分派。
|
|
107
|
+
* 引脚 `.Mode` 两代都是 `I2C`,缺了同样不生成。
|
|
108
|
+
*/
|
|
109
|
+
const I2C_LEGACY_FAMILIES = new Set(["F1", "F2", "F4", "L1"]);
|
|
110
|
+
/** 从 `Mcu.Name`(例如 STM32F303C(B-C)Tx)里取家族代号:F3 / F1 / L4 … */
|
|
111
|
+
export function chipFamily(iocText) {
|
|
112
|
+
const name = /^Mcu\.Name=(.+)$/mu.exec(iocText)?.[1] ?? "";
|
|
113
|
+
const family = /^STM32([A-Z]\d)/u.exec(name.trim());
|
|
114
|
+
return family === null ? "" : family[1];
|
|
115
|
+
}
|
|
116
|
+
export function i2cParameters(family, speed) {
|
|
117
|
+
if (I2C_LEGACY_FAMILIES.has(family)) {
|
|
118
|
+
return [
|
|
119
|
+
{ name: "ClockSpeed", value: String(speed) },
|
|
120
|
+
{ name: "DutyCycle", value: "I2C_DUTYCYCLE_2" },
|
|
121
|
+
{ name: "OwnAddress1", value: "0" },
|
|
122
|
+
{ name: "AddressingMode", value: "I2C_ADDRESSINGMODE_7BIT" },
|
|
123
|
+
];
|
|
124
|
+
}
|
|
125
|
+
return [
|
|
126
|
+
{ name: "I2C_Speed_Mode", value: speed > 100000 ? "I2C_Fast" : "I2C_Standard" },
|
|
127
|
+
{ name: "Speed", value: String(speed / 1000) },
|
|
128
|
+
{ name: "Analog_Filter", value: "I2C_ANALOGFILTER_ENABLE" },
|
|
129
|
+
{ name: "OwnAddress", value: "0" },
|
|
130
|
+
{ name: "DualAddressMode", value: "I2C_DUALADDRESS_DISABLE" },
|
|
131
|
+
{ name: "GeneralCallMode", value: "I2C_GENERALCALL_DISABLE" },
|
|
132
|
+
{ name: "NoStretchMode", value: "I2C_NOSTRETCH_DISABLE" },
|
|
133
|
+
{ name: "AddressingMode", value: "I2C_ADDRESSINGMODE_7BIT" },
|
|
134
|
+
];
|
|
135
|
+
}
|
|
136
|
+
function i2c(name, scl, sda, speed = 100000) {
|
|
137
|
+
return {
|
|
138
|
+
name,
|
|
139
|
+
label: name + " I2C 主机(" + String(speed / 1000) + " kHz)",
|
|
140
|
+
ip: name,
|
|
141
|
+
pins: [
|
|
142
|
+
{ role: "scl", defaultPin: scl, signal: name + "_SCL", mode: "I2C" },
|
|
143
|
+
{ role: "sda", defaultPin: sda, signal: name + "_SDA", mode: "I2C" },
|
|
144
|
+
],
|
|
145
|
+
// 占位:真正的键在 ioc-plan 里按 MCU 家族从 i2cParameters() 取(两代键名不同)。
|
|
146
|
+
parameters: i2cParameters("", speed),
|
|
147
|
+
parametersByFamily: true,
|
|
148
|
+
notes: [
|
|
149
|
+
name + ":SCL/SDA 都要外接上拉(模块板一般不带上拉);默认 7 位地址、主机模式、" + String(speed / 1000) + " kHz",
|
|
150
|
+
"键名按芯片的 I2C IP 代分派:F1/F2/F4/L1 用 ClockSpeed+DutyCycle,F0/F3/L0+/L4/G0/G4 用 I2C_Speed_Mode+Speed",
|
|
151
|
+
],
|
|
152
|
+
};
|
|
153
|
+
}
|
|
57
154
|
function timerPwm(name, channel, pin, dbSignal) {
|
|
58
155
|
const mode = "PWM Generation" + String(channel) + " CH" + String(channel);
|
|
59
156
|
return {
|
|
@@ -209,6 +306,27 @@ export const PERIPHERAL_PRESETS = [
|
|
|
209
306
|
usart("USART1", "PA9", "PA10"),
|
|
210
307
|
usart("USART2", "PA2", "PA3"),
|
|
211
308
|
usart("USART3", "PB10", "PB11"),
|
|
309
|
+
// S187:SPI/I2C 之前完全没有预设,模型只能自己拼键——拼错一根脚就会被 CubeMX 静默丢弃。
|
|
310
|
+
spi("SPI1", "Full_Duplex_Master", [
|
|
311
|
+
{ role: "sck", pin: "PA5" },
|
|
312
|
+
{ role: "miso", pin: "PA6" },
|
|
313
|
+
{ role: "mosi", pin: "PA7" },
|
|
314
|
+
]),
|
|
315
|
+
spi("SPI1", "TransmitOnly_Master", [
|
|
316
|
+
{ role: "sck", pin: "PA5" },
|
|
317
|
+
{ role: "mosi", pin: "PA7" },
|
|
318
|
+
]),
|
|
319
|
+
spi("SPI1", "ReceiveOnly_Master", [
|
|
320
|
+
{ role: "sck", pin: "PA5" },
|
|
321
|
+
{ role: "miso", pin: "PA6" },
|
|
322
|
+
]),
|
|
323
|
+
spi("SPI2", "Full_Duplex_Master", [
|
|
324
|
+
{ role: "sck", pin: "PB13" },
|
|
325
|
+
{ role: "miso", pin: "PB14" },
|
|
326
|
+
{ role: "mosi", pin: "PB15" },
|
|
327
|
+
]),
|
|
328
|
+
i2c("I2C1", "PB6", "PB7"),
|
|
329
|
+
i2c("I2C2", "PB10", "PB11"),
|
|
212
330
|
// PA0 的定时器信号在 db 里与 TIM2_ETR 合并成 S_TIM2_CH1_ETR,必须用这个名字。
|
|
213
331
|
timerPwm("TIM2", 1, "PA0", "S_TIM2_CH1_ETR"),
|
|
214
332
|
timerPwm("TIM3", 1, "PA6", "S_TIM3_CH1"),
|
|
@@ -0,0 +1,123 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 产物与内存:读构建目录里的 elf / hex / bin,配上芯片的 Flash / RAM 容量,供调试台显示。
|
|
3
|
+
*
|
|
4
|
+
* 只读文件属性,不跑 size / objdump:内存占用来自上一次 `stm32_build` 的
|
|
5
|
+
* `--print-memory-usage` 结果(面板从事件流里取),避免为了一个数字再起一个子进程。
|
|
6
|
+
*/
|
|
7
|
+
import { createHash } from "node:crypto";
|
|
8
|
+
import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
|
|
9
|
+
import { basename, join } from "node:path";
|
|
10
|
+
import { findChipFact } from "../data/device-facts.js";
|
|
11
|
+
import { detectBuildDir, findElf } from "./build.js";
|
|
12
|
+
import { readIocCpn } from "./breakpoints.js";
|
|
13
|
+
function statFile(file) {
|
|
14
|
+
try {
|
|
15
|
+
const info = statSync(file);
|
|
16
|
+
return { name: basename(file), path: file, size: info.size, mtimeMs: info.mtimeMs, sha256: "" };
|
|
17
|
+
}
|
|
18
|
+
catch {
|
|
19
|
+
return null;
|
|
20
|
+
}
|
|
21
|
+
}
|
|
22
|
+
/** 给一个产物补上校验和;超过上限的文件保持空串,调用方据此提示(S62)。 */
|
|
23
|
+
function withHash(file) {
|
|
24
|
+
if (file === null)
|
|
25
|
+
return null;
|
|
26
|
+
return { ...file, sha256: hashFile(file) };
|
|
27
|
+
}
|
|
28
|
+
/** 与 elf 同名、扩展名不同的兄弟产物。 */
|
|
29
|
+
function sibling(elfPath, extension) {
|
|
30
|
+
const dot = elfPath.lastIndexOf(".");
|
|
31
|
+
const base = dot === -1 ? elfPath : elfPath.slice(0, dot);
|
|
32
|
+
return statFile(base + extension);
|
|
33
|
+
}
|
|
34
|
+
/** 超过这个大小的 elf 不算校验和:调试台每 10 秒轮询一次,不值得。 */
|
|
35
|
+
export const ARTIFACT_HASH_MAX_BYTES = 8 * 1024 * 1024;
|
|
36
|
+
/** 单个文件的 SHA-256(S68):构建摘要用它标出「这次 elf 和上次是不是同一个」。 */
|
|
37
|
+
export function sha256OfPath(filePath) {
|
|
38
|
+
const file = statFile(filePath);
|
|
39
|
+
return file === null ? "" : hashFile(file);
|
|
40
|
+
}
|
|
41
|
+
function hashFile(file) {
|
|
42
|
+
if (file.size > ARTIFACT_HASH_MAX_BYTES)
|
|
43
|
+
return "";
|
|
44
|
+
try {
|
|
45
|
+
return createHash("sha256").update(readFileSync(file.path)).digest("hex");
|
|
46
|
+
}
|
|
47
|
+
catch {
|
|
48
|
+
return "";
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
function listElves(buildDir) {
|
|
52
|
+
let names;
|
|
53
|
+
try {
|
|
54
|
+
names = readdirSync(buildDir);
|
|
55
|
+
}
|
|
56
|
+
catch {
|
|
57
|
+
return [];
|
|
58
|
+
}
|
|
59
|
+
const files = [];
|
|
60
|
+
for (const name of names) {
|
|
61
|
+
if (!name.toLowerCase().endsWith(".elf"))
|
|
62
|
+
continue;
|
|
63
|
+
const file = statFile(join(buildDir, name));
|
|
64
|
+
if (file !== null)
|
|
65
|
+
files.push(file);
|
|
66
|
+
}
|
|
67
|
+
return files;
|
|
68
|
+
}
|
|
69
|
+
export function readArtifacts(projectDir, env = process.env) {
|
|
70
|
+
const dir = projectDir.trim();
|
|
71
|
+
if (dir === "")
|
|
72
|
+
return { ok: false, error: "projectDir 不能为空" };
|
|
73
|
+
const notes = [];
|
|
74
|
+
const buildDir = detectBuildDir(dir) ?? "";
|
|
75
|
+
if (buildDir === "") {
|
|
76
|
+
notes.push("还没有可识别的构建目录:先执行 stm32_build 或 cmake --preset。");
|
|
77
|
+
}
|
|
78
|
+
let elfInfo = null;
|
|
79
|
+
if (buildDir !== "")
|
|
80
|
+
elfInfo = findElf(buildDir);
|
|
81
|
+
const elf = withHash(elfInfo === null ? null : statFile(elfInfo.path));
|
|
82
|
+
const hex = withHash(elf === null ? null : sibling(elf.path, ".hex"));
|
|
83
|
+
const bin = withHash(elf === null ? null : sibling(elf.path, ".bin"));
|
|
84
|
+
const otherElves = buildDir === "" ? [] : listElves(buildDir).filter((file) => file.path !== elf?.path);
|
|
85
|
+
if (otherElves.length > 0) {
|
|
86
|
+
notes.push("构建目录里有 " + String(otherElves.length + 1) + " 个 .elf,当前显示按工程名/修改时间挑出的那个。");
|
|
87
|
+
}
|
|
88
|
+
const sha256 = elf?.sha256 ?? "";
|
|
89
|
+
if (elf !== null && sha256 === "") {
|
|
90
|
+
notes.push("elf 超过 " + String(Math.round(ARTIFACT_HASH_MAX_BYTES / 1024 / 1024)) + " MB,跳过校验和。");
|
|
91
|
+
}
|
|
92
|
+
const cpn = readIocCpn(dir);
|
|
93
|
+
let chip = null;
|
|
94
|
+
if (cpn !== "") {
|
|
95
|
+
const fact = findChipFact(cpn, env);
|
|
96
|
+
if (fact === null)
|
|
97
|
+
notes.push("资源包里没有 " + cpn + " 的容量数据,内存占用只能看构建输出。");
|
|
98
|
+
else
|
|
99
|
+
chip = { cpn, flashBytes: fact.flashBytes, ramBytes: fact.ramBytes };
|
|
100
|
+
}
|
|
101
|
+
else {
|
|
102
|
+
notes.push("工程里没有 .ioc 的 Mcu.CPN,无法给出容量上限。");
|
|
103
|
+
}
|
|
104
|
+
return {
|
|
105
|
+
ok: true,
|
|
106
|
+
report: {
|
|
107
|
+
projectDir: dir,
|
|
108
|
+
buildDir,
|
|
109
|
+
elf,
|
|
110
|
+
hex,
|
|
111
|
+
bin,
|
|
112
|
+
otherElves,
|
|
113
|
+
chip,
|
|
114
|
+
sha256,
|
|
115
|
+
notes,
|
|
116
|
+
},
|
|
117
|
+
};
|
|
118
|
+
}
|
|
119
|
+
/** 构建目录存在但还没有产物的判断,供面板给出下一步。 */
|
|
120
|
+
export function hasBuildDir(projectDir) {
|
|
121
|
+
const dir = detectBuildDir(projectDir);
|
|
122
|
+
return dir !== null && existsSync(dir);
|
|
123
|
+
}
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 断点命中记录:从 gdb 的输出里认出「停在哪」,攒成一份可回看的短历史。
|
|
3
|
+
*
|
|
4
|
+
* 只解析文本,不订阅 MI 事件——eval 的两条路径(常驻 MI / gdb -batch)都产出同一种
|
|
5
|
+
* 停点描述,在这里统一处理,面板与命令行看到的是同一份记录。
|
|
6
|
+
*/
|
|
7
|
+
/** 历史长度:一次联调最多回看这么多条停点。 */
|
|
8
|
+
export const HIT_LIMIT = 50;
|
|
9
|
+
const BREAKPOINT_LINE = /^Breakpoint (\d+), (.+)$/u;
|
|
10
|
+
const WATCHPOINT_LINE = /^(?:Hardware |Software |)watchpoint (\d+): (.+)$/u;
|
|
11
|
+
const STOPPED_LINE = /已停下 —— (.+)$/u;
|
|
12
|
+
const OLD_VALUE = /^Old value = (.+)$/u;
|
|
13
|
+
const NEW_VALUE = /^New value = (.+)$/u;
|
|
14
|
+
/** 从一段 gdb 输出里抽出停点;不认识的行走掉。 */
|
|
15
|
+
export function parseStops(output) {
|
|
16
|
+
const stops = [];
|
|
17
|
+
const lines = output.split(/\r?\n/u);
|
|
18
|
+
for (let index = 0; index < lines.length; index += 1) {
|
|
19
|
+
const line = (lines[index] ?? "").trim();
|
|
20
|
+
if (line === "")
|
|
21
|
+
continue;
|
|
22
|
+
const plain = BREAKPOINT_LINE.exec(line);
|
|
23
|
+
if (plain !== null && plain[1] !== undefined && plain[2] !== undefined) {
|
|
24
|
+
stops.push({ id: Number(plain[1]), text: plain[2].trim() });
|
|
25
|
+
continue;
|
|
26
|
+
}
|
|
27
|
+
const watched = WATCHPOINT_LINE.exec(line);
|
|
28
|
+
if (watched !== null && watched[1] !== undefined && watched[2] !== undefined) {
|
|
29
|
+
// 观察点命中后紧跟两行旧值/新值,拼进同一条更有用。
|
|
30
|
+
const parts = [watched[2].trim()];
|
|
31
|
+
const old = OLD_VALUE.exec((lines[index + 1] ?? "").trim());
|
|
32
|
+
const fresh = NEW_VALUE.exec((lines[index + 2] ?? "").trim());
|
|
33
|
+
if (old !== null && old[1] !== undefined)
|
|
34
|
+
parts.push("原值 " + old[1]);
|
|
35
|
+
if (fresh !== null && fresh[1] !== undefined)
|
|
36
|
+
parts.push("新值 " + fresh[1]);
|
|
37
|
+
stops.push({ id: Number(watched[1]), text: parts.join(",") });
|
|
38
|
+
continue;
|
|
39
|
+
}
|
|
40
|
+
const stopped = STOPPED_LINE.exec(line);
|
|
41
|
+
if (stopped !== null && stopped[1] !== undefined) {
|
|
42
|
+
const detail = stopped[1].replace(/(本次 eval 结束会按默认再 resume.*$/u, "").trim();
|
|
43
|
+
if (detail !== "")
|
|
44
|
+
stops.push({ id: 0, text: detail });
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
return stops;
|
|
48
|
+
}
|
|
49
|
+
/** 环形历史:满了丢最旧的一条。 */
|
|
50
|
+
export class HitHistory {
|
|
51
|
+
items = [];
|
|
52
|
+
limit;
|
|
53
|
+
constructor(limit = HIT_LIMIT) {
|
|
54
|
+
this.limit = Math.max(1, Math.trunc(limit));
|
|
55
|
+
}
|
|
56
|
+
/** 把一段输出的停点追加进历史,返回本次新增条数。 */
|
|
57
|
+
record(output, nowMs = Date.now()) {
|
|
58
|
+
const stops = parseStops(output);
|
|
59
|
+
const time = new Date(nowMs).toISOString();
|
|
60
|
+
for (const stop of stops) {
|
|
61
|
+
this.items.push({ id: stop.id, text: stop.text, time: time });
|
|
62
|
+
if (this.items.length > this.limit)
|
|
63
|
+
this.items.splice(0, this.items.length - this.limit);
|
|
64
|
+
}
|
|
65
|
+
return stops.length;
|
|
66
|
+
}
|
|
67
|
+
list() {
|
|
68
|
+
return this.items.map((item) => ({ ...item }));
|
|
69
|
+
}
|
|
70
|
+
clear() {
|
|
71
|
+
this.items.length = 0;
|
|
72
|
+
}
|
|
73
|
+
}
|