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.
- package/README.md +52 -38
- package/README_EN.md +44 -33
- package/assets/README.md +85 -0
- package/assets/VERSION +1 -0
- package/assets/device/c0/chips.json +1108 -0
- package/assets/device/f0/chips.json +1570 -0
- package/assets/device/f1/chips.json +1238 -0
- package/assets/device/f1/svd/100.json +943 -0
- package/assets/device/f1/svd/101.json +901 -0
- package/assets/device/f1/svd/102.json +522 -0
- package/assets/device/f1/svd/103.json +1139 -0
- package/assets/device/f1/svd/105.json +1117 -0
- package/assets/device/f1/svd/107.json +1195 -0
- package/assets/device/f2/chips.json +674 -0
- package/assets/device/f3/chips.json +1318 -0
- package/assets/device/f4/chips.json +2942 -0
- package/assets/device/f7/chips.json +1710 -0
- package/assets/device/g0/chips.json +2102 -0
- package/assets/device/g4/chips.json +2494 -0
- package/assets/device/h5/chips.json +898 -0
- package/assets/device/h7/chips.json +1948 -0
- package/assets/device/l0/chips.json +2494 -0
- package/assets/device/l1/chips.json +1234 -0
- package/assets/device/l4/chips.json +2130 -0
- package/assets/device/l4+/chips.json +856 -0
- package/assets/device/l5/chips.json +226 -0
- package/assets/device/u0/chips.json +688 -0
- package/assets/device/u3/chips.json +310 -0
- package/assets/device/u5/chips.json +884 -0
- package/assets/device/wba/chips.json +506 -0
- package/assets/device/wl/chips.json +184 -0
- package/assets/headers/f1/stm32f100xb.h +5972 -0
- package/assets/headers/f1/stm32f100xe.h +6587 -0
- package/assets/headers/f1/stm32f101x6.h +5315 -0
- package/assets/headers/f1/stm32f101xb.h +5446 -0
- package/assets/headers/f1/stm32f101xe.h +6503 -0
- package/assets/headers/f1/stm32f101xg.h +6713 -0
- package/assets/headers/f1/stm32f102x6.h +6448 -0
- package/assets/headers/f1/stm32f102xb.h +6570 -0
- package/assets/headers/f1/stm32f103x6.h +10109 -0
- package/assets/headers/f1/stm32f103xb.h +10240 -0
- package/assets/headers/f1/stm32f103xe.h +11767 -0
- package/assets/headers/f1/stm32f103xg.h +11951 -0
- package/assets/headers/f1/stm32f105xc.h +14340 -0
- package/assets/headers/f1/stm32f107xc.h +15253 -0
- package/assets/headers/f1/stm32f1xx.h +273 -0
- package/assets/headers/f1/system_stm32f1xx.h +96 -0
- package/assets/ioc/family/C0.ioc +82 -0
- package/assets/ioc/family/F0.ioc +71 -0
- package/assets/ioc/family/F2.ioc +91 -0
- package/assets/ioc/family/F3.ioc +94 -0
- package/assets/ioc/family/F4.ioc +91 -0
- package/assets/ioc/family/F7.ioc +102 -0
- package/assets/ioc/family/G0.ioc +90 -0
- package/assets/ioc/family/G4.ioc +110 -0
- package/assets/ioc/family/H5.ioc +116 -0
- package/assets/ioc/family/H7.ioc +133 -0
- package/assets/ioc/family/L0.ioc +92 -0
- package/assets/ioc/family/L1.ioc +87 -0
- package/assets/ioc/family/L4+.ioc +92 -0
- package/assets/ioc/family/L4.ioc +93 -0
- package/assets/ioc/family/L5.ioc +91 -0
- package/assets/ioc/family/U0.ioc +103 -0
- package/assets/ioc/family/U3.ioc +113 -0
- package/assets/ioc/family/U5.ioc +102 -0
- package/assets/ioc/family/WBA.ioc +100 -0
- package/assets/ioc/family/WL.ioc +93 -0
- package/assets/ioc/minimal/STM32F100C8Tx.ioc +113 -0
- package/assets/ioc/minimal/STM32F100RCTx.ioc +113 -0
- package/assets/ioc/minimal/STM32F101C4Tx.ioc +113 -0
- package/assets/ioc/minimal/STM32F101C8Tx.ioc +113 -0
- package/assets/ioc/minimal/STM32F101RCTx.ioc +113 -0
- package/assets/ioc/minimal/STM32F101RFTx.ioc +113 -0
- package/assets/ioc/minimal/STM32F102C4Tx.ioc +113 -0
- package/assets/ioc/minimal/STM32F102C8Tx.ioc +113 -0
- package/assets/ioc/minimal/STM32F103C4Tx.ioc +113 -0
- package/assets/ioc/minimal/STM32F103C8Tx.ioc +113 -0
- package/assets/ioc/minimal/STM32F103RCTx.ioc +113 -0
- package/assets/ioc/minimal/STM32F103RFTx.ioc +113 -0
- package/assets/ioc/minimal/STM32F105RCTx.ioc +113 -0
- package/assets/ioc/minimal/STM32F107RCTx.ioc +113 -0
- package/assets/ld/f1/STM32F100C8Tx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F100RCTx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F101C4Tx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F101C8Tx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F101RCTx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F101RFTx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F102C4Tx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F102C8Tx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F103C4Tx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F103C8Tx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F103RCTx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F103RFTx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F105RCTx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F107RCTx_FLASH.ld +249 -0
- package/assets/manifest.json +1130 -0
- package/assets/startup/f1/startup_stm32f100xb.s +407 -0
- package/assets/startup/f1/startup_stm32f100xe.s +449 -0
- package/assets/startup/f1/startup_stm32f101x6.s +322 -0
- package/assets/startup/f1/startup_stm32f101xb.s +338 -0
- package/assets/startup/f1/startup_stm32f101xe.s +423 -0
- package/assets/startup/f1/startup_stm32f101xg.s +439 -0
- package/assets/startup/f1/startup_stm32f102x6.s +330 -0
- package/assets/startup/f1/startup_stm32f102xb.s +346 -0
- package/assets/startup/f1/startup_stm32f103x6.s +348 -0
- package/assets/startup/f1/startup_stm32f103xb.s +364 -0
- package/assets/startup/f1/startup_stm32f103xe.s +470 -0
- package/assets/startup/f1/startup_stm32f103xg.s +466 -0
- package/assets/startup/f1/startup_stm32f105xc.s +463 -0
- package/assets/startup/f1/startup_stm32f107xc.s +472 -0
- package/assets/templates/family/C0.ioc +82 -0
- package/assets/templates/family/F0.ioc +71 -0
- package/assets/templates/family/F2.ioc +91 -0
- package/assets/templates/family/F3.ioc +94 -0
- package/assets/templates/family/F4.ioc +91 -0
- package/assets/templates/family/F7.ioc +102 -0
- package/assets/templates/family/G0.ioc +90 -0
- package/assets/templates/family/G4.ioc +110 -0
- package/assets/templates/family/H5.ioc +116 -0
- package/assets/templates/family/H7.ioc +133 -0
- package/assets/templates/family/L0.ioc +92 -0
- package/assets/templates/family/L1.ioc +87 -0
- package/assets/templates/family/L4+.ioc +92 -0
- package/assets/templates/family/L4.ioc +93 -0
- package/assets/templates/family/L5.ioc +91 -0
- package/assets/templates/family/U0.ioc +103 -0
- package/assets/templates/family/U3.ioc +113 -0
- package/assets/templates/family/U5.ioc +102 -0
- package/assets/templates/family/WB.ioc +81 -0
- package/assets/templates/family/WBA.ioc +100 -0
- package/assets/templates/family/WL.ioc +93 -0
- package/docs/reading-guide.md +37 -35
- package/lib/data/chips.js +3 -3
- package/lib/data/clock-db.js +830 -0
- package/lib/data/clock-f1.js +12 -45
- package/lib/data/cmsis-sources.js +239 -18
- package/lib/data/db-presets.js +252 -0
- package/lib/data/device-facts.js +99 -26
- package/lib/data/family.js +515 -0
- package/lib/data/firmware-packages.js +562 -0
- package/lib/data/install-guides.js +2 -2
- package/lib/data/ioc-presets.js +248 -0
- package/lib/data/ioc-schema.js +1058 -0
- package/lib/data/rm-topics/stm32c0.json +227 -0
- package/lib/data/rm-topics.js +103 -0
- package/lib/data/search-roots.js +42 -1
- package/lib/data/stm32f1.js +15 -14
- package/lib/data/svd.js +32 -16
- package/lib/data/toolchain-config.js +0 -14
- package/lib/engine/assets.js +191 -456
- package/lib/engine/breakpoints.js +66 -11
- package/lib/engine/clock-derived.js +101 -0
- package/lib/engine/clock-direct.js +313 -0
- package/lib/engine/clock-plan.js +96 -52
- package/lib/engine/clock-pllmn.js +319 -0
- package/lib/engine/cmake-sources.js +67 -13
- package/lib/engine/cube-mx-guard.js +44 -0
- package/lib/engine/cube-programmer.js +137 -0
- package/lib/engine/cubemx-db.js +273 -0
- package/lib/engine/debug-session.js +423 -17
- package/lib/engine/debug.js +25 -6
- package/lib/engine/doctor.js +160 -17
- package/lib/engine/facts-acquire.js +416 -0
- package/lib/engine/facts.js +134 -0
- package/lib/engine/firmware-install.js +176 -5
- package/lib/engine/firmware-official.js +451 -0
- package/lib/engine/flash.js +290 -21
- package/lib/engine/gdb-mi.js +476 -0
- package/lib/engine/generate.js +9 -2
- package/lib/engine/hal-chip.js +124 -41
- package/lib/engine/ioc-plan.js +1244 -60
- package/lib/engine/ioc-rules.js +698 -0
- package/lib/engine/ioc-verify.js +706 -0
- package/lib/engine/ioc.js +43 -4
- package/lib/engine/msys2-install.js +4 -4
- package/lib/engine/probe-error.js +25 -6
- package/lib/engine/probe-session.js +50 -14
- package/lib/engine/probe.js +18 -3
- package/lib/engine/register-clock.js +41 -0
- package/lib/engine/register-gpio.js +115 -0
- package/lib/engine/register-linker.js +12 -7
- package/lib/engine/register-template.js +101 -40
- package/lib/engine/regs.js +41 -8
- package/lib/engine/rm-extract.js +144 -0
- package/lib/engine/rm-sources.js +360 -0
- package/lib/engine/rm-text.js +56 -0
- package/lib/engine/rtt.js +188 -30
- package/lib/engine/scaffold.js +185 -18
- package/lib/engine/toolchain-gate.js +0 -4
- package/lib/engine/watch.js +227 -0
- package/lib/index.js +4 -2
- package/lib/skill/stm32-workflow.js +2 -2
- package/lib/tools/assets.js +39 -108
- package/lib/tools/cache.js +2 -2
- package/lib/tools/debug-session.js +2 -2
- package/lib/tools/doctor.js +55 -5
- package/lib/tools/firmware-install.js +31 -6
- package/lib/tools/flash.js +32 -4
- package/lib/tools/generate.js +22 -0
- package/lib/tools/ioc-inspect.js +1 -1
- package/lib/tools/ioc-plan.js +56 -2
- package/lib/tools/ioc-verify.js +237 -0
- package/lib/tools/project-create.js +41 -5
- package/lib/tools/regs.js +8 -8
- package/lib/tools/route-plan.js +1 -1
- package/lib/tools/rtt.js +157 -34
- package/lib/tools/watch.js +256 -0
- package/package.json +5 -4
- package/templates/openocd/stm32c0x.cfg +83 -0
- package/templates/openocd/stm32u0x.cfg +64 -0
- package/templates/register/CMakeLists.txt +2 -2
- package/templates/register/Core/Inc/rtt.h +37 -2
- package/templates/register/Core/Src/main.c +17 -25
- package/templates/register/Core/Src/rtt.c +85 -9
- package/templates/scaffold/RTT.md +6 -2
- package/templates/scaffold/STM32F103XX_FLASH.ld +3 -0
- package/templates/scaffold/openocd.cfg +5 -3
- package/templates/scaffold/vscode/launch.json +8 -4
- package/docs/development-notes.md +0 -2487
- package/docs/dsh-stm32-plugin-/350/247/204/346/240/274.md +0 -673
- package/docs/logic-audit.md +0 -607
|
@@ -0,0 +1,451 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* "官网直取"通道:从 ST 的固件仓库直接下载官方 zip,再交给 CubeMX 自己记账(swmgr install)。
|
|
3
|
+
*
|
|
4
|
+
* 为什么值得单独一条路(2026-11 实测):
|
|
5
|
+
* · swmgr install <本地 zip> ask 是 CubeMX 包管理器自己用的那条命令;装完包落在
|
|
6
|
+
* <CubeMX>/Repository/<包名>,GUI 与 project generate 都认,不像 dsh-firmware 只能靠
|
|
7
|
+
* project setCustomFWPath 指过去(那条路在 WBA 上实测会让 project generate 挂住 400 s)。
|
|
8
|
+
* · 官方 zip 自带完整 HAL + CMSIS + 示例,比我们从 GitHub 拼 HAL+CMSIS 更全,也不用维护
|
|
9
|
+
* 22 张 coreHeaders 表。
|
|
10
|
+
*
|
|
11
|
+
* 为什么不能只靠它(所以默认 auto + 回退):
|
|
12
|
+
* · 新族/新版本第一次装会弹许可协议(swmgr ... ask),无头进程等不到人点同意就卡住;
|
|
13
|
+
* 这是许可协议,插件不代点,只能超时、说明、回退。
|
|
14
|
+
* · 没有 CubeMX(或没有 JRE)、CubeMX GUI 正开着、公司网络挡住 sw-center,都走不通。
|
|
15
|
+
*
|
|
16
|
+
* URL 规律(匿名 GET 200,实测 F1/H5/WBA/WL3):
|
|
17
|
+
* https://sw-center.st.com/packs/resource/firmware/stm32cube_fw_<库名后缀小写>_v<版本去点>.zip
|
|
18
|
+
* 例:STM32Cube_FW_F1 + 1.8.7 → stm32cube_fw_f1_v187.zip(56,220,914 B)
|
|
19
|
+
*/
|
|
20
|
+
import { closeSync, existsSync, mkdirSync, openSync, readFileSync, readSync, readdirSync, rmSync, statSync, writeFileSync } from "node:fs";
|
|
21
|
+
import { createWriteStream } from "node:fs";
|
|
22
|
+
import path from "node:path";
|
|
23
|
+
import { inflateRawSync } from "node:zlib";
|
|
24
|
+
import { runStreaming } from "./subprocess-runner.js";
|
|
25
|
+
const DEFAULT_BASE = "https://sw-center.st.com/packs/resource/firmware/";
|
|
26
|
+
/** 官网固件仓库根(末尾带斜杠)。DSH_STM32_FIRMWARE_BASE 可指向镜像/本地假服务器(测试用)。 */
|
|
27
|
+
export function officialFirmwareBaseUrl(env = process.env) {
|
|
28
|
+
const override = env["DSH_STM32_FIRMWARE_BASE"];
|
|
29
|
+
if (override !== undefined && override.trim() !== "") {
|
|
30
|
+
const trimmed = override.trim();
|
|
31
|
+
return trimmed.endsWith("/") ? trimmed : trimmed + "/";
|
|
32
|
+
}
|
|
33
|
+
return DEFAULT_BASE;
|
|
34
|
+
}
|
|
35
|
+
/**
|
|
36
|
+
* 包名 + 版本 → 官方 zip 的 URL。
|
|
37
|
+
* fwLibrary 是 db 的 <Mcu FwLibrary="STM32Cube_FW_H7RS">(没有这个属性的族就用 packageBase)。
|
|
38
|
+
*/
|
|
39
|
+
export function officialFirmwareUrl(fwLibrary, version, env = process.env) {
|
|
40
|
+
const lib = fwLibrary.trim();
|
|
41
|
+
const slug = lib.replace(/^STM32Cube_FW_/iu, "").toLowerCase();
|
|
42
|
+
const digits = version.trim().replace(/\./gu, "");
|
|
43
|
+
return officialFirmwareBaseUrl(env) + "stm32cube_fw_" + slug + "_v" + digits + ".zip";
|
|
44
|
+
}
|
|
45
|
+
/* ------------------------- db 里的 FwLibrary ------------------------- */
|
|
46
|
+
/**
|
|
47
|
+
* 把 db 的 RefName 变成能匹配 CPN 的正则:RefName 是"一簇型号"的写法。
|
|
48
|
+
* 例:STM32F103C(8-B)Tx → ^STM32F103C[8B]T.$(CPN STM32F103C8T6 命中)
|
|
49
|
+
* STM32H7R3A8Ix → ^STM32H7R3A8I.$
|
|
50
|
+
* 括号里是容量/温度档的枚举(连字符分隔),x/X 是封装字母通配。
|
|
51
|
+
*/
|
|
52
|
+
export function refNamePattern(refName) {
|
|
53
|
+
let source = "";
|
|
54
|
+
for (let i = 0; i < refName.length; i += 1) {
|
|
55
|
+
const ch = refName[i];
|
|
56
|
+
if (ch === "(") {
|
|
57
|
+
const close = refName.indexOf(")", i);
|
|
58
|
+
const inner = close === -1 ? "" : refName.slice(i + 1, close);
|
|
59
|
+
source += "[" + inner.split("-").join("").replace(/[\\\]]/gu, (m) => "\\" + m) + "]";
|
|
60
|
+
i = close === -1 ? i : close;
|
|
61
|
+
continue;
|
|
62
|
+
}
|
|
63
|
+
if (ch === "x" || ch === "X") {
|
|
64
|
+
source += ".";
|
|
65
|
+
continue;
|
|
66
|
+
}
|
|
67
|
+
source += ch.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
|
|
68
|
+
}
|
|
69
|
+
return new RegExp("^" + source + "$", "u");
|
|
70
|
+
}
|
|
71
|
+
/** 读某个 MCU xml 的 <Mcu FwLibrary="…">;没有这个属性返回空串(绝大多数族都是空的)。 */
|
|
72
|
+
export function readMcuFwLibrary(file) {
|
|
73
|
+
let text;
|
|
74
|
+
try {
|
|
75
|
+
// 只需要开头那段:<Mcu> 是文件第一个元素。
|
|
76
|
+
const fd = openSync(file, "r");
|
|
77
|
+
try {
|
|
78
|
+
const buf = Buffer.alloc(8192);
|
|
79
|
+
const read = readSync(fd, buf, 0, buf.length, 0);
|
|
80
|
+
text = buf.subarray(0, read).toString("utf8");
|
|
81
|
+
}
|
|
82
|
+
finally {
|
|
83
|
+
closeSync(fd);
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
catch {
|
|
87
|
+
return "";
|
|
88
|
+
}
|
|
89
|
+
const tag = /<Mcu\b([^>]*)>/u.exec(text);
|
|
90
|
+
if (tag === null)
|
|
91
|
+
return "";
|
|
92
|
+
return /(?:^|\s)FwLibrary="([^"]+)"/u.exec(tag[1])?.[1] ?? "";
|
|
93
|
+
}
|
|
94
|
+
/**
|
|
95
|
+
* 按型号在 db 里找 FwLibrary:只有少数子系列(H7RS / MP13 / WB0 / WL3)才有这个属性,
|
|
96
|
+
* 其余族返回 fallback(= 我们的 packageBase,例如 STM32Cube_FW_F1)。
|
|
97
|
+
*
|
|
98
|
+
* 为什么按型号而不是按族:STM32H7 里 H743 用 STM32Cube_FW_H7、H7R3 用 STM32Cube_FW_H7RS,
|
|
99
|
+
* 同一族两个包;只按族取会把 H7RS 的包喂给 H743。
|
|
100
|
+
*/
|
|
101
|
+
export function resolveFwLibrary(dbRoot, partNumber, fallback) {
|
|
102
|
+
const part = partNumber.trim().toUpperCase();
|
|
103
|
+
if (dbRoot === "" || part === "")
|
|
104
|
+
return fallback;
|
|
105
|
+
const mcuDir = path.join(dbRoot, "mcu");
|
|
106
|
+
let names;
|
|
107
|
+
try {
|
|
108
|
+
names = readdirSync(mcuDir).filter((name) => name.endsWith(".xml") && name !== "families.xml");
|
|
109
|
+
}
|
|
110
|
+
catch {
|
|
111
|
+
return fallback;
|
|
112
|
+
}
|
|
113
|
+
for (const name of names) {
|
|
114
|
+
const pattern = refNamePattern(name.slice(0, -4));
|
|
115
|
+
if (!pattern.test(part))
|
|
116
|
+
continue;
|
|
117
|
+
const lib = readMcuFwLibrary(path.join(mcuDir, name));
|
|
118
|
+
if (lib !== "")
|
|
119
|
+
return lib;
|
|
120
|
+
}
|
|
121
|
+
return fallback;
|
|
122
|
+
}
|
|
123
|
+
/* ------------------------------ zip 校验 ------------------------------ */
|
|
124
|
+
const CRC_TABLE = (() => {
|
|
125
|
+
const table = new Uint32Array(256);
|
|
126
|
+
for (let n = 0; n < 256; n += 1) {
|
|
127
|
+
let c = n;
|
|
128
|
+
for (let k = 0; k < 8; k += 1)
|
|
129
|
+
c = (c & 1) !== 0 ? 0xedb88320 ^ (c >>> 1) : c >>> 1;
|
|
130
|
+
table[n] = c >>> 0;
|
|
131
|
+
}
|
|
132
|
+
return table;
|
|
133
|
+
})();
|
|
134
|
+
/** CRC-32(zip 用的那个多项式);seed 传上一段的返回值即可接着算。 */
|
|
135
|
+
export function crc32Of(bytes, seed = 0) {
|
|
136
|
+
let c = (~seed) >>> 0;
|
|
137
|
+
for (let i = 0; i < bytes.length; i += 1) {
|
|
138
|
+
c = CRC_TABLE[(c ^ bytes[i]) & 0xff] ^ (c >>> 8);
|
|
139
|
+
}
|
|
140
|
+
return (~c) >>> 0;
|
|
141
|
+
}
|
|
142
|
+
function hex32(value) {
|
|
143
|
+
return "0x" + (value >>> 0).toString(16).padStart(8, "0");
|
|
144
|
+
}
|
|
145
|
+
/**
|
|
146
|
+
* 校验 zip:读中央目录 → 逐条解压 → 比 CRC-32。
|
|
147
|
+
*
|
|
148
|
+
* 为什么要全量比一遍而不是"能解开就行":ST 的 zip 有 300+ MB(WBA 388,603,994 B),
|
|
149
|
+
* 代理/断流/磁盘满都能留一个"结构完好但内容缺一块"的文件,swmgr 解包时才炸,
|
|
150
|
+
* 而那时用户已经等了几分钟、包目录还是半截。这里先自证一遍,坏在哪一条也说得清。
|
|
151
|
+
*/
|
|
152
|
+
export function verifyZipCrc(file, onProgress) {
|
|
153
|
+
const base = { ok: false, entries: 0, checked: 0, mismatches: [], error: "" };
|
|
154
|
+
let size;
|
|
155
|
+
try {
|
|
156
|
+
size = statSync(file).size;
|
|
157
|
+
}
|
|
158
|
+
catch (error) {
|
|
159
|
+
return { ...base, error: "读不了 zip:" + (error instanceof Error ? error.message : String(error)) };
|
|
160
|
+
}
|
|
161
|
+
if (size < 22)
|
|
162
|
+
return { ...base, error: "不是 zip:文件只有 " + String(size) + " B" };
|
|
163
|
+
const buffer = readFileSync(file);
|
|
164
|
+
// EOCD 在文件尾部,后面最多跟 65535 字节注释。
|
|
165
|
+
const tailStart = Math.max(0, size - 65558);
|
|
166
|
+
let eocd = -1;
|
|
167
|
+
for (let i = size - 22; i >= tailStart; i -= 1) {
|
|
168
|
+
if (buffer.readUInt32LE(i) === 0x06054b50) {
|
|
169
|
+
const commentLen = buffer.readUInt16LE(i + 20);
|
|
170
|
+
if (i + 22 + commentLen === size) {
|
|
171
|
+
eocd = i;
|
|
172
|
+
break;
|
|
173
|
+
}
|
|
174
|
+
}
|
|
175
|
+
}
|
|
176
|
+
if (eocd === -1)
|
|
177
|
+
return { ...base, error: "不是 zip:找不到中央目录结尾(EOCD)" };
|
|
178
|
+
const total = buffer.readUInt16LE(eocd + 10);
|
|
179
|
+
const cdOffset = buffer.readUInt32LE(eocd + 16);
|
|
180
|
+
const mismatches = [];
|
|
181
|
+
let offset = cdOffset;
|
|
182
|
+
let checked = 0;
|
|
183
|
+
for (let index = 0; index < total; index += 1) {
|
|
184
|
+
if (buffer.readUInt32LE(offset) !== 0x02014b50) {
|
|
185
|
+
return { ...base, entries: total, checked, mismatches, error: "中央目录第 " + String(index + 1) + " 条签名不对" };
|
|
186
|
+
}
|
|
187
|
+
const method = buffer.readUInt16LE(offset + 10);
|
|
188
|
+
const expectedCrc = buffer.readUInt32LE(offset + 16);
|
|
189
|
+
const compressedSize = buffer.readUInt32LE(offset + 20);
|
|
190
|
+
const nameLen = buffer.readUInt16LE(offset + 28);
|
|
191
|
+
const extraLen = buffer.readUInt16LE(offset + 30);
|
|
192
|
+
const commentLen = buffer.readUInt16LE(offset + 32);
|
|
193
|
+
const localOffset = buffer.readUInt32LE(offset + 42);
|
|
194
|
+
const name = buffer.subarray(offset + 46, offset + 46 + nameLen).toString("utf8");
|
|
195
|
+
offset += 46 + nameLen + extraLen + commentLen;
|
|
196
|
+
if (buffer.readUInt32LE(localOffset) !== 0x04034b50) {
|
|
197
|
+
return { ...base, entries: total, checked, mismatches, error: "条目 " + name + " 的本地头签名不对" };
|
|
198
|
+
}
|
|
199
|
+
const localNameLen = buffer.readUInt16LE(localOffset + 26);
|
|
200
|
+
const localExtraLen = buffer.readUInt16LE(localOffset + 28);
|
|
201
|
+
const dataStart = localOffset + 30 + localNameLen + localExtraLen;
|
|
202
|
+
const raw = buffer.subarray(dataStart, dataStart + compressedSize);
|
|
203
|
+
let data;
|
|
204
|
+
try {
|
|
205
|
+
if (method === 0)
|
|
206
|
+
data = raw;
|
|
207
|
+
else if (method === 8)
|
|
208
|
+
data = inflateRawSync(raw);
|
|
209
|
+
else {
|
|
210
|
+
// 其它算法(bzip2/lzma)官方包不用;不认识的条目跳过而不是判坏。
|
|
211
|
+
continue;
|
|
212
|
+
}
|
|
213
|
+
}
|
|
214
|
+
catch (error) {
|
|
215
|
+
return {
|
|
216
|
+
...base,
|
|
217
|
+
entries: total,
|
|
218
|
+
checked,
|
|
219
|
+
mismatches,
|
|
220
|
+
error: "条目 " + name + " 解压失败:" + (error instanceof Error ? error.message : String(error)),
|
|
221
|
+
};
|
|
222
|
+
}
|
|
223
|
+
const actual = crc32Of(data);
|
|
224
|
+
checked += 1;
|
|
225
|
+
if (actual !== (expectedCrc >>> 0)) {
|
|
226
|
+
mismatches.push({ name, expected: hex32(expectedCrc), actual: hex32(actual) });
|
|
227
|
+
if (mismatches.length > 5)
|
|
228
|
+
mismatches.pop();
|
|
229
|
+
}
|
|
230
|
+
if (onProgress !== undefined && checked % 200 === 0)
|
|
231
|
+
onProgress(checked, total);
|
|
232
|
+
}
|
|
233
|
+
return { ok: mismatches.length === 0, entries: total, checked, mismatches, error: "" };
|
|
234
|
+
}
|
|
235
|
+
/**
|
|
236
|
+
* 下载官方 zip。判据两条:HTTP 200 + 落盘字节数等于 Content-Length。
|
|
237
|
+
* 半截文件当场删掉——留着只会让后面的 CRC 校验报一堆看不懂的错。
|
|
238
|
+
*/
|
|
239
|
+
export async function downloadOfficialZip(request) {
|
|
240
|
+
const outcome = { ok: false, bytes: 0, contentLength: 0, status: 0, error: "" };
|
|
241
|
+
const fetchImpl = request.fetchImpl ?? fetch;
|
|
242
|
+
const timeoutMs = request.timeoutMs ?? 600_000;
|
|
243
|
+
const controller = new AbortController();
|
|
244
|
+
const timer = setTimeout(() => controller.abort(), timeoutMs);
|
|
245
|
+
const external = request.signal;
|
|
246
|
+
const onAbort = () => controller.abort();
|
|
247
|
+
if (external !== undefined) {
|
|
248
|
+
if (external.aborted) {
|
|
249
|
+
clearTimeout(timer);
|
|
250
|
+
return { ...outcome, error: "已取消" };
|
|
251
|
+
}
|
|
252
|
+
external.addEventListener("abort", onAbort, { once: true });
|
|
253
|
+
}
|
|
254
|
+
const remove = () => {
|
|
255
|
+
try {
|
|
256
|
+
rmSync(request.destFile, { force: true });
|
|
257
|
+
}
|
|
258
|
+
catch {
|
|
259
|
+
// 删不掉只是留个残渣,不改变结论。
|
|
260
|
+
}
|
|
261
|
+
};
|
|
262
|
+
try {
|
|
263
|
+
const response = await fetchImpl(request.url, { signal: controller.signal, redirect: "follow" });
|
|
264
|
+
outcome.status = response.status;
|
|
265
|
+
if (!response.ok || response.body === null) {
|
|
266
|
+
remove();
|
|
267
|
+
return { ...outcome, error: "HTTP " + String(response.status) + " " + response.statusText };
|
|
268
|
+
}
|
|
269
|
+
const declared = Number.parseInt(response.headers.get("content-length") ?? "", 10);
|
|
270
|
+
outcome.contentLength = Number.isFinite(declared) ? declared : 0;
|
|
271
|
+
mkdirSync(path.dirname(request.destFile), { recursive: true });
|
|
272
|
+
const file = createWriteStream(request.destFile);
|
|
273
|
+
let bytes = 0;
|
|
274
|
+
let lastTick = 0;
|
|
275
|
+
try {
|
|
276
|
+
const reader = response.body[Symbol.asyncIterator]();
|
|
277
|
+
for (;;) {
|
|
278
|
+
const step = await reader.next();
|
|
279
|
+
if (step.done === true)
|
|
280
|
+
break;
|
|
281
|
+
const chunk = Buffer.from(step.value);
|
|
282
|
+
bytes += chunk.length;
|
|
283
|
+
if (!file.write(chunk))
|
|
284
|
+
await new Promise((resolve) => file.once("drain", () => resolve()));
|
|
285
|
+
const now = Date.now();
|
|
286
|
+
if (request.onProgress !== undefined && now - lastTick >= 1000) {
|
|
287
|
+
lastTick = now;
|
|
288
|
+
request.onProgress(bytes, outcome.contentLength);
|
|
289
|
+
}
|
|
290
|
+
}
|
|
291
|
+
await new Promise((resolve, reject) => file.end(() => resolve()).on("error", reject));
|
|
292
|
+
}
|
|
293
|
+
catch (error) {
|
|
294
|
+
file.destroy();
|
|
295
|
+
remove();
|
|
296
|
+
throw error;
|
|
297
|
+
}
|
|
298
|
+
outcome.bytes = bytes;
|
|
299
|
+
if (outcome.contentLength > 0 && bytes !== outcome.contentLength) {
|
|
300
|
+
remove();
|
|
301
|
+
return { ...outcome, ok: false, error: "下载不完整:Content-Length " + String(outcome.contentLength) + " B,实际 " + String(bytes) + " B" };
|
|
302
|
+
}
|
|
303
|
+
return { ...outcome, ok: true };
|
|
304
|
+
}
|
|
305
|
+
catch (error) {
|
|
306
|
+
remove();
|
|
307
|
+
const message = error instanceof Error ? error.message : String(error);
|
|
308
|
+
return { ...outcome, error: controller.signal.aborted ? "超时/取消:" + message : message };
|
|
309
|
+
}
|
|
310
|
+
finally {
|
|
311
|
+
clearTimeout(timer);
|
|
312
|
+
if (external !== undefined)
|
|
313
|
+
external.removeEventListener("abort", onAbort);
|
|
314
|
+
}
|
|
315
|
+
}
|
|
316
|
+
/** swmgr 等 CubeMX 的上限:许可已接受时实测 150 MB 的 C0 包 unpack+记账约 90 s,5 分钟足够;
|
|
317
|
+
* 许可没接受时再等也没用(无头模式根本不会把对话框给出来),靠下面的许可检测提前收尾。 */
|
|
318
|
+
export const SWMGR_TIME_LIMIT_MS = 300_000;
|
|
319
|
+
/**
|
|
320
|
+
* 从 CubeMX 日志里读「已接受的固件许可」清单。
|
|
321
|
+
*
|
|
322
|
+
* CubeMX 每次启动都会打一行:
|
|
323
|
+
* [INFO] AnalyticsPlugin:257 - Accepted Firmware Licenses: FW.C0.1.3.0,FW.C0.1.4.0,FW.F4.1.28.0
|
|
324
|
+
* 实测许可按「族 + 版本」记账:同一个族的另一个版本也要重新点一次同意(FW.C0.1.3.0 与 FW.C0.1.4.0 各一条)。
|
|
325
|
+
* 没记过的族/版本,swmgr 会挂在那里等 GUI 弹框;无头 -q 模式下那个框根本不会出现。
|
|
326
|
+
*/
|
|
327
|
+
export function parseAcceptedFirmwareLicences(log) {
|
|
328
|
+
const seen = [];
|
|
329
|
+
for (const match of log.matchAll(/Accepted Firmware Licenses:\s*([^\r\n]*)/gu)) {
|
|
330
|
+
for (const item of String(match[1] ?? "").split(",")) {
|
|
331
|
+
const tag = item.trim();
|
|
332
|
+
if (tag !== "" && !seen.includes(tag))
|
|
333
|
+
seen.push(tag);
|
|
334
|
+
}
|
|
335
|
+
}
|
|
336
|
+
return seen;
|
|
337
|
+
}
|
|
338
|
+
/** CubeMX 的固件许可标签:FW.<族>.<主>.<次>.<补丁>,例如 FW.C0.1.3.0、FW.F4.1.28.0。 */
|
|
339
|
+
export function firmwareLicenceTag(family, version) {
|
|
340
|
+
const fam = family.trim().toUpperCase().replace(/^STM32/u, "");
|
|
341
|
+
const ver = version.trim().replace(/^[Vv]/u, "");
|
|
342
|
+
if (!/^[A-Z0-9+]+$/u.test(fam))
|
|
343
|
+
return "";
|
|
344
|
+
if (!/^\d+\.\d+\.\d+$/u.test(ver))
|
|
345
|
+
return "";
|
|
346
|
+
return "FW." + fam + "." + ver;
|
|
347
|
+
}
|
|
348
|
+
/**
|
|
349
|
+
* 跑 swmgr install <本地 zip> ask,让 CubeMX 自己把包装进 Repository 并记账。
|
|
350
|
+
*
|
|
351
|
+
* 许可协议:ask 模式在首次装某族/某版本时会弹 GUI 对话框等人点同意 —— 那是许可协议,
|
|
352
|
+
* 插件不代点(代点等于替用户签合同)。所以这里只等 timeoutMs,等不到就带着日志回退,
|
|
353
|
+
* 由调用方告诉用户"去 CubeMX 里点一次同意"。
|
|
354
|
+
*/
|
|
355
|
+
export async function installViaSwmgr(request) {
|
|
356
|
+
const dir = path.join(request.root, "Repository", request.dirName);
|
|
357
|
+
const present = () => existsSync(path.join(dir, "package.xml")) ||
|
|
358
|
+
existsSync(path.join(dir, "Drivers")) ||
|
|
359
|
+
existsSync(path.join(dir, "Utilities", "pc_software"));
|
|
360
|
+
// 必须在跑之前取:swmgr 装成功会把目录建出来,跑之后再取就分不清"本来就有"和"这次装上的"。
|
|
361
|
+
const existedBefore = present();
|
|
362
|
+
const slug = request.dirName.replace(/[^A-Za-z0-9_.-]/gu, "_");
|
|
363
|
+
mkdirSync(request.workDir, { recursive: true });
|
|
364
|
+
const scriptPath = path.join(request.workDir, "swmgr-" + slug + ".txt");
|
|
365
|
+
const zipForScript = request.zipFile.split("\\").join("/");
|
|
366
|
+
writeFileSync(scriptPath, ["swmgr install \"" + zipForScript + "\" ask", "exit", ""].join("\n"), "utf8");
|
|
367
|
+
const licenceTag = request.family === undefined || request.version === undefined
|
|
368
|
+
? ""
|
|
369
|
+
: firmwareLicenceTag(request.family, request.version);
|
|
370
|
+
const limitMs = request.timeoutMs ?? SWMGR_TIME_LIMIT_MS;
|
|
371
|
+
// 自己拿一个 controller:许可没记录时提前结束等待,不必熬到超时。
|
|
372
|
+
const controller = new AbortController();
|
|
373
|
+
const relayAbort = () => controller.abort();
|
|
374
|
+
if (request.signal !== undefined) {
|
|
375
|
+
if (request.signal.aborted)
|
|
376
|
+
controller.abort();
|
|
377
|
+
else
|
|
378
|
+
request.signal.addEventListener("abort", relayAbort, { once: true });
|
|
379
|
+
}
|
|
380
|
+
let seen = "";
|
|
381
|
+
let acceptedLicences = [];
|
|
382
|
+
let missingLicence = "";
|
|
383
|
+
let outcome;
|
|
384
|
+
try {
|
|
385
|
+
outcome = await runStreaming(request.subprocess, {
|
|
386
|
+
argv: [request.java, "-Dfile.encoding=UTF-8", "-jar", request.jar, "-q", scriptPath],
|
|
387
|
+
cwd: request.workDir,
|
|
388
|
+
timeoutMs: limitMs,
|
|
389
|
+
maxBytes: 2 * 1024 * 1024,
|
|
390
|
+
signal: controller.signal,
|
|
391
|
+
onOutput: (_stream, text) => {
|
|
392
|
+
if (missingLicence !== "")
|
|
393
|
+
return;
|
|
394
|
+
seen = (seen + text).slice(-200_000);
|
|
395
|
+
const list = parseAcceptedFirmwareLicences(seen);
|
|
396
|
+
if (list.length === 0)
|
|
397
|
+
return;
|
|
398
|
+
acceptedLicences = list;
|
|
399
|
+
if (licenceTag !== "" && !list.includes(licenceTag)) {
|
|
400
|
+
missingLicence = licenceTag;
|
|
401
|
+
if (request.onProgress !== undefined) {
|
|
402
|
+
request.onProgress("CubeMX 还没接受 " + licenceTag + " 的许可协议(已接受:" + list.join("、") + "),不再干等它。");
|
|
403
|
+
}
|
|
404
|
+
controller.abort();
|
|
405
|
+
}
|
|
406
|
+
},
|
|
407
|
+
});
|
|
408
|
+
}
|
|
409
|
+
finally {
|
|
410
|
+
if (request.signal !== undefined)
|
|
411
|
+
request.signal.removeEventListener("abort", relayAbort);
|
|
412
|
+
}
|
|
413
|
+
const log = outcome.stdout + "\n" + outcome.stderr;
|
|
414
|
+
// 兜底:进程输出可能在 drain 之前就结束(或没走到 onOutput),结束后再从整段日志里读一次许可清单。
|
|
415
|
+
if (acceptedLicences.length === 0)
|
|
416
|
+
acceptedLicences = parseAcceptedFirmwareLicences(log);
|
|
417
|
+
if (missingLicence === "" && licenceTag !== "" && acceptedLicences.length > 0 && !acceptedLicences.includes(licenceTag)) {
|
|
418
|
+
missingLicence = licenceTag;
|
|
419
|
+
}
|
|
420
|
+
const logTail = log.trim().split(/\r?\n/u).slice(-4).join(" | ");
|
|
421
|
+
if (request.onProgress !== undefined)
|
|
422
|
+
request.onProgress("CubeMX 安装日志末尾:" + logTail);
|
|
423
|
+
if (present())
|
|
424
|
+
return { ok: true, dir, logTail, error: "", reused: existedBefore, acceptedLicences, missingLicence: "" };
|
|
425
|
+
if (missingLicence !== "") {
|
|
426
|
+
const accepted = acceptedLicences.length === 0 ? "CubeMX 还没记录任何已接受的固件许可" : acceptedLicences.join("、");
|
|
427
|
+
return {
|
|
428
|
+
ok: false,
|
|
429
|
+
dir,
|
|
430
|
+
logTail,
|
|
431
|
+
error: "CubeMX 还没接受 " + missingLicence + " 的许可协议,这一族/版本的首装要先点一次同意(已接受的许可:" + accepted +
|
|
432
|
+
")。在 CubeMX 里 Help → Manage embedded software packages 展开对应的 STM32Cube MCU Package、选这个版本 Install、" +
|
|
433
|
+
"许可协议点 I Agree,之后这条通道就能自己装。",
|
|
434
|
+
reused: false,
|
|
435
|
+
acceptedLicences,
|
|
436
|
+
missingLicence,
|
|
437
|
+
};
|
|
438
|
+
}
|
|
439
|
+
const how = outcome.timedOut
|
|
440
|
+
? "超时 " + String(limitMs) + " ms(多半是在等许可协议对话框)"
|
|
441
|
+
: "退出码 " + (outcome.exitCode === null ? "(没有)" : String(outcome.exitCode));
|
|
442
|
+
return {
|
|
443
|
+
ok: false,
|
|
444
|
+
dir,
|
|
445
|
+
logTail,
|
|
446
|
+
error: "CubeMX 没把包装进 Repository(" + how + ");日志末尾:" + logTail,
|
|
447
|
+
reused: false,
|
|
448
|
+
acceptedLicences,
|
|
449
|
+
missingLicence: "",
|
|
450
|
+
};
|
|
451
|
+
}
|