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.
- package/README.md +92 -40
- package/README_EN.md +85 -36
- 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 +94 -71
- package/lib/data/chips.js +38 -51
- package/lib/data/clock-db.js +830 -0
- package/lib/data/clock-f1.js +12 -45
- package/lib/data/cmsis-sources.js +264 -17
- package/lib/data/db-presets.js +252 -0
- package/lib/data/device-facts.js +274 -0
- 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 +95 -150
- package/lib/data/svd.js +643 -0
- package/lib/data/toolchain-config.js +0 -14
- package/lib/engine/assets.js +659 -0
- package/lib/engine/breakpoints.js +297 -0
- 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 +576 -22
- package/lib/engine/debug.js +99 -46
- package/lib/engine/doctor.js +162 -19
- 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 +317 -76
- 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 +1247 -63
- 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 +231 -0
- package/lib/engine/probe-session.js +347 -0
- 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 +130 -45
- package/lib/engine/regs.js +43 -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 +758 -0
- 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 +12 -2
- package/lib/skill/stm32-workflow.js +2 -2
- package/lib/tools/assets.js +272 -0
- package/lib/tools/cache.js +8 -0
- package/lib/tools/debug-session.js +41 -6
- package/lib/tools/debug.js +41 -11
- package/lib/tools/doctor.js +65 -4
- package/lib/tools/firmware-install.js +31 -6
- package/lib/tools/flash.js +47 -10
- package/lib/tools/generate.js +25 -0
- package/lib/tools/ioc-apply.js +2 -0
- package/lib/tools/ioc-inspect.js +2 -0
- package/lib/tools/ioc-plan.js +59 -2
- package/lib/tools/ioc-verify.js +237 -0
- package/lib/tools/project-create.js +63 -3
- package/lib/tools/regs.js +453 -61
- package/lib/tools/route-plan.js +3 -0
- package/lib/tools/rtt.js +470 -0
- 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 +8 -2
- package/templates/register/Core/Inc/rtt.h +138 -0
- package/templates/register/Core/Src/main.c +42 -25
- package/templates/register/Core/Src/rtt.c +373 -0
- package/templates/scaffold/RTT.md +90 -0
- package/templates/scaffold/STM32F103XX_FLASH.ld +3 -0
- package/templates/scaffold/cmake/user/CMakeLists.txt +7 -0
- package/templates/scaffold/openocd.cfg +5 -3
- package/templates/scaffold/vscode/launch.json +8 -4
- package/docs/development-notes.md +0 -2116
- package/docs/dsh-stm32-plugin-/350/247/204/346/240/274.md +0 -673
- package/docs/logic-audit.md +0 -607
- package/lib/data/f1-ram.generated.js +0 -34
|
@@ -19,6 +19,10 @@ import { accessSync, constants, existsSync, mkdirSync, readFileSync, readdirSync
|
|
|
19
19
|
import path from "node:path";
|
|
20
20
|
import { dshFirmwareDir, firmwarePlanFor, verifyFirmwarePackage, } from "../data/firmware-packages.js";
|
|
21
21
|
import { cacheRoot } from "./cache.js";
|
|
22
|
+
import { describeCubeMxGuiConflict, findRunningCubeMxGui } from "./cube-mx-guard.js";
|
|
23
|
+
import { locateCubemxDb } from "./cubemx-db.js";
|
|
24
|
+
import { downloadOfficialZip, installViaSwmgr, officialFirmwareUrl, resolveFwLibrary, verifyZipCrc, SWMGR_TIME_LIMIT_MS, } from "./firmware-official.js";
|
|
25
|
+
import { cubeMxLaunch } from "./generate.js";
|
|
22
26
|
import { fetchAll } from "./fetch.js";
|
|
23
27
|
import { extractTarGz } from "./tar.js";
|
|
24
28
|
function slash(value) {
|
|
@@ -370,6 +374,8 @@ function emptyResult(mode, message) {
|
|
|
370
374
|
steps: [],
|
|
371
375
|
verify: { ok: false, checks: [] },
|
|
372
376
|
download: { files: 0, bytes: 0 },
|
|
377
|
+
source: "",
|
|
378
|
+
downloadUrl: "",
|
|
373
379
|
notes: [],
|
|
374
380
|
message,
|
|
375
381
|
nextStep: "",
|
|
@@ -389,6 +395,8 @@ function planResult(request, plan, decision) {
|
|
|
389
395
|
const verify = verifyFirmwarePackage(decision.dir, plan.family);
|
|
390
396
|
return {
|
|
391
397
|
ok: verify.ok,
|
|
398
|
+
source: "existing",
|
|
399
|
+
downloadUrl: "",
|
|
392
400
|
mode: "plan",
|
|
393
401
|
family: plan.family,
|
|
394
402
|
version: plan.version,
|
|
@@ -409,6 +417,8 @@ function planResult(request, plan, decision) {
|
|
|
409
417
|
}
|
|
410
418
|
return {
|
|
411
419
|
ok: true,
|
|
420
|
+
source: "",
|
|
421
|
+
downloadUrl: "",
|
|
412
422
|
mode: "plan",
|
|
413
423
|
family: plan.family,
|
|
414
424
|
version: plan.version,
|
|
@@ -494,6 +504,150 @@ function nextStepFor(kind, dir, packageName) {
|
|
|
494
504
|
}
|
|
495
505
|
return "直接调 stm32_generate:" + locate + "这个目录是调用方显式指定的:换机器或挪了目录之后要重新装(或更新安装记录),否则 generate 找不到。";
|
|
496
506
|
}
|
|
507
|
+
/**
|
|
508
|
+
* 官网直取:下 ST 官方 zip → 校验 Content-Length + 每条 CRC32 → 交给 CubeMX 的 swmgr install 记账。
|
|
509
|
+
*
|
|
510
|
+
* 成功才返回报告;任何一步走不通就只往 notes 里记一条原因、返回 null,让调用方回退 GitHub 拼包。
|
|
511
|
+
* 不在这里抛异常:官网通道是"更好但不保证"的路,不该让本来能装上的包因为官网失败而装不上。
|
|
512
|
+
*/
|
|
513
|
+
async function tryOfficial(request, plan, decision, steps, notes, progress) {
|
|
514
|
+
const subprocess = request.subprocess;
|
|
515
|
+
if (subprocess === undefined) {
|
|
516
|
+
notes.push("官网直取跳过:这次调用没带进程服务,只能走 GitHub 拼包。");
|
|
517
|
+
return null;
|
|
518
|
+
}
|
|
519
|
+
const env = request.env ?? process.env;
|
|
520
|
+
const explicitRoot = request.cubeMxRoot === undefined ? "" : request.cubeMxRoot.trim();
|
|
521
|
+
const root = explicitRoot !== ""
|
|
522
|
+
? explicitRoot
|
|
523
|
+
: orderCubeMxRoots(request.cubeMxRoots).find((item) => hasCubeMxExe(item)) ?? "";
|
|
524
|
+
if (root === "") {
|
|
525
|
+
notes.push("官网直取跳过:没找到 STM32CubeMX 安装根(cubeMxRoot / cubeMxRoots 里都没有 STM32CubeMX.exe),只能走 GitHub 拼包。");
|
|
526
|
+
return null;
|
|
527
|
+
}
|
|
528
|
+
const launch = cubeMxLaunch([root]);
|
|
529
|
+
if (launch === null) {
|
|
530
|
+
notes.push("官网直取跳过:" + root + " 下没有可用的 java(jre/bin/java.exe)或 STM32CubeMX.exe,只能走 GitHub 拼包。");
|
|
531
|
+
return null;
|
|
532
|
+
}
|
|
533
|
+
// CubeMX 是单实例:GUI 开着时 -q 会被转发过去、可能弹模态框,swmgr 会一直等。
|
|
534
|
+
const gui = await findRunningCubeMxGui(subprocess, request.signal);
|
|
535
|
+
if (gui.length > 0) {
|
|
536
|
+
notes.push("官网直取跳过:" + describeCubeMxGuiConflict(gui));
|
|
537
|
+
return null;
|
|
538
|
+
}
|
|
539
|
+
const db = locateCubemxDb([root]);
|
|
540
|
+
const fwLibrary = resolveFwLibrary(db === null ? "" : db.root, request.mcu ?? "", plan.packageBase);
|
|
541
|
+
const url = officialFirmwareUrl(fwLibrary, plan.version, env);
|
|
542
|
+
// 下载按大文件给默认值;等 CubeMX 装包另算上限(许可没记录时不再干等)。
|
|
543
|
+
const downloadTimeoutMs = Math.max(request.timeoutMs ?? 600_000, 600_000);
|
|
544
|
+
const swmgrTimeoutMs = Math.min(downloadTimeoutMs, SWMGR_TIME_LIMIT_MS);
|
|
545
|
+
const prepare = stepOf(steps, "prepare");
|
|
546
|
+
const download = stepOf(steps, "download");
|
|
547
|
+
const extract = stepOf(steps, "extract");
|
|
548
|
+
const packageStep = stepOf(steps, "package");
|
|
549
|
+
const verifyStep = stepOf(steps, "verify");
|
|
550
|
+
prepare.status = "done";
|
|
551
|
+
prepare.detail = "官网直取:包装在 CubeMX 官方 Repository(" + root + "/Repository/" + plan.dirName + ")";
|
|
552
|
+
const zipFile = path.join(slash(cacheRoot(env)), "firmware", "downloads", plan.dirName + ".zip");
|
|
553
|
+
download.status = "running";
|
|
554
|
+
download.label = "下载官方固件包(" + fwLibrary + ")";
|
|
555
|
+
download.detail = url;
|
|
556
|
+
progress("官网直取:" + url);
|
|
557
|
+
const fetched = await downloadOfficialZip({
|
|
558
|
+
url,
|
|
559
|
+
destFile: zipFile,
|
|
560
|
+
...(request.fetchImpl === undefined ? {} : { fetchImpl: request.fetchImpl }),
|
|
561
|
+
...(request.signal === undefined ? {} : { signal: request.signal }),
|
|
562
|
+
timeoutMs: downloadTimeoutMs,
|
|
563
|
+
onProgress: (bytes, total) => {
|
|
564
|
+
const pct = total > 0 ? String(Math.floor((bytes * 100) / total)) + "%" : "";
|
|
565
|
+
progress("下载 " + String(Math.round(bytes / 1024)) + " KB" + (pct === "" ? "" : "(" + pct + ")"));
|
|
566
|
+
},
|
|
567
|
+
});
|
|
568
|
+
if (!fetched.ok) {
|
|
569
|
+
download.status = "failed";
|
|
570
|
+
download.detail = fetched.error;
|
|
571
|
+
notes.push("官网直取没下下来(HTTP " + String(fetched.status) + ":" + fetched.error + "),改用 GitHub 拼包。");
|
|
572
|
+
return null;
|
|
573
|
+
}
|
|
574
|
+
download.status = "done";
|
|
575
|
+
download.detail = String(Math.round(fetched.bytes / 1024)) + " KB(Content-Length " + String(fetched.contentLength) + " B,已核对)";
|
|
576
|
+
extract.status = "running";
|
|
577
|
+
extract.label = "校验官方 zip";
|
|
578
|
+
const crc = verifyZipCrc(zipFile, (checked, total) => progress("校验 CRC " + String(checked) + "/" + String(total)));
|
|
579
|
+
if (!crc.ok) {
|
|
580
|
+
extract.status = "failed";
|
|
581
|
+
extract.detail = crc.error !== "" ? crc.error : "CRC 对不上:" + crc.mismatches.map((item) => item.name).join("、");
|
|
582
|
+
notes.push("官网直取下的 zip 校验不过(" + extract.detail + "),已删掉重来,改用 GitHub 拼包。");
|
|
583
|
+
rmSync(zipFile, { force: true });
|
|
584
|
+
return null;
|
|
585
|
+
}
|
|
586
|
+
extract.status = "done";
|
|
587
|
+
extract.detail = "zip " + String(crc.entries) + " 条,逐条解压比过 " + String(crc.checked) + " 条 CRC32";
|
|
588
|
+
packageStep.status = "running";
|
|
589
|
+
packageStep.label = "交给 CubeMX 装进 Repository";
|
|
590
|
+
const installed = await installViaSwmgr({
|
|
591
|
+
subprocess,
|
|
592
|
+
java: launch.java,
|
|
593
|
+
jar: launch.jar,
|
|
594
|
+
root,
|
|
595
|
+
zipFile,
|
|
596
|
+
dirName: plan.dirName,
|
|
597
|
+
family: plan.family,
|
|
598
|
+
version: plan.version,
|
|
599
|
+
workDir: path.join(slash(cacheRoot(env)), "firmware", "swmgr"),
|
|
600
|
+
...(request.signal === undefined ? {} : { signal: request.signal }),
|
|
601
|
+
timeoutMs: swmgrTimeoutMs,
|
|
602
|
+
onProgress: progress,
|
|
603
|
+
});
|
|
604
|
+
if (!installed.ok) {
|
|
605
|
+
packageStep.status = "failed";
|
|
606
|
+
packageStep.detail = installed.logTail;
|
|
607
|
+
if (installed.missingLicence !== "") {
|
|
608
|
+
notes.push("官网直取没装成:" + installed.missingLicence + " 的许可协议 CubeMX 还没记录(已接受:" +
|
|
609
|
+
(installed.acceptedLicences.length === 0 ? "无" : installed.acceptedLicences.join("、")) +
|
|
610
|
+
")。这一族/版本的首装要先在 CubeMX 里点一次同意:Help → Manage embedded software packages → " +
|
|
611
|
+
"展开 " + plan.packageBase + " → Install → 许可协议点 I Agree;点过之后这条通道就能自己装," +
|
|
612
|
+
"本次先回退 GitHub 拼包。");
|
|
613
|
+
}
|
|
614
|
+
else {
|
|
615
|
+
notes.push("官网直取没装成(" + installed.error + ")。首次装某个族/版本时 CubeMX 会弹许可协议等人点同意," +
|
|
616
|
+
"无头进程等不到就只能放弃——去 CubeMX 包管理器里点一次同意,或继续用 GitHub 拼包。");
|
|
617
|
+
}
|
|
618
|
+
return null;
|
|
619
|
+
}
|
|
620
|
+
packageStep.status = "done";
|
|
621
|
+
packageStep.detail = "CubeMX 已装到 " + installed.dir + "(package.xml 由官方包自带,CubeMX 自己记账)";
|
|
622
|
+
if (installed.reused) {
|
|
623
|
+
notes.push("官网直取:Repository 里本来就有 " + plan.dirName + ",CubeMX 复核了一遍(日志末尾:" + installed.logTail + ")。");
|
|
624
|
+
}
|
|
625
|
+
const verify = verifyFirmwarePackage(installed.dir, plan.family);
|
|
626
|
+
if (!verify.ok) {
|
|
627
|
+
verifyStep.status = "failed";
|
|
628
|
+
verifyStep.detail = "缺:" + verify.missing.join("、");
|
|
629
|
+
notes.push("官网直取装出来的包自检缺 " + verify.missing.join("、") + ",改用 GitHub 拼包。");
|
|
630
|
+
return null;
|
|
631
|
+
}
|
|
632
|
+
verifyStep.status = "done";
|
|
633
|
+
verifyStep.detail = "三条判据全过(" + String(verify.checks.length) + " 项检查)";
|
|
634
|
+
const recordProblem = rememberFirmwareInstall(env, plan.dirName, installed.dir, "repository");
|
|
635
|
+
if (recordProblem !== "") {
|
|
636
|
+
notes.push("没写进安装记录(" + recordProblem + "):包在官方 Repository 里,生成时按 CubeMX 根也能找到。");
|
|
637
|
+
}
|
|
638
|
+
return {
|
|
639
|
+
ok: true,
|
|
640
|
+
source: "official",
|
|
641
|
+
downloadUrl: url,
|
|
642
|
+
targetKind: "repository",
|
|
643
|
+
targetDir: installed.dir,
|
|
644
|
+
download: { files: crc.entries, bytes: fetched.bytes },
|
|
645
|
+
verify,
|
|
646
|
+
message: "固件包从官网装好了:" + plan.dirName + " 在 " + installed.dir + "(CubeMX 官方 Repository," + fwLibrary + ")。" +
|
|
647
|
+
"下载 " + String(Math.round(fetched.bytes / 1024)) + " KB、zip " + String(crc.entries) + " 条逐条校验通过,三条判据全过。",
|
|
648
|
+
nextStep: nextStepFor("repository", installed.dir, plan.dirName),
|
|
649
|
+
};
|
|
650
|
+
}
|
|
497
651
|
/** 真装。失败时已下载的东西会留在目标目录里(方便重试),最终判据是三条自检。 */
|
|
498
652
|
export async function installFirmware(request) {
|
|
499
653
|
const plan = firmwarePlanFor(request);
|
|
@@ -527,6 +681,7 @@ export async function installFirmware(request) {
|
|
|
527
681
|
}
|
|
528
682
|
return finish({
|
|
529
683
|
ok: verify.ok,
|
|
684
|
+
source: "existing",
|
|
530
685
|
verify,
|
|
531
686
|
message: verify.ok
|
|
532
687
|
? "本机已经有 " + plan.dirName + "(" + decision.dir + "),不用下载。"
|
|
@@ -534,6 +689,23 @@ export async function installFirmware(request) {
|
|
|
534
689
|
nextStep: "直接调 stm32_generate。",
|
|
535
690
|
});
|
|
536
691
|
}
|
|
692
|
+
// 官网直取(默认 auto):能走通就装进 CubeMX 自己的 Repository,走不通才回退下面的 GitHub 拼包。
|
|
693
|
+
// 显式 target=repository 也走这条路——反正落点相同,但官方包更全、不用我们维护 coreHeaders 表。
|
|
694
|
+
const source = request.source ?? "auto";
|
|
695
|
+
if (source !== "github" && request.targetDir === undefined && (request.target ?? "auto") !== "cache") {
|
|
696
|
+
const official = await tryOfficial(request, plan, decision, steps, notes, progress);
|
|
697
|
+
if (official !== null)
|
|
698
|
+
return finish(official);
|
|
699
|
+
if (source === "official") {
|
|
700
|
+
return finish({
|
|
701
|
+
ok: false,
|
|
702
|
+
source: "official",
|
|
703
|
+
message: "官网直取没成功(source=official,不回退 GitHub):" + (notes[notes.length - 1] ?? "原因见 notes。"),
|
|
704
|
+
nextStep: "首次装某个族/版本时 CubeMX 会弹许可协议等人点同意 —— 在 CubeMX 包管理器里点一次,再重跑;" +
|
|
705
|
+
"或者把 source 改成 auto,让插件回退 GitHub 拼包。",
|
|
706
|
+
});
|
|
707
|
+
}
|
|
708
|
+
}
|
|
537
709
|
try {
|
|
538
710
|
mkdirSync(decision.dir, { recursive: true });
|
|
539
711
|
prepare.status = "done";
|
|
@@ -568,7 +740,9 @@ export async function installFirmware(request) {
|
|
|
568
740
|
const options = {
|
|
569
741
|
...(request.signal === undefined ? {} : { signal: request.signal }),
|
|
570
742
|
...(request.fetchImpl === undefined ? {} : { fetchImpl: request.fetchImpl }),
|
|
571
|
-
|
|
743
|
+
// 固件包动辄十几 MB,fetch 层默认 30 s 对 CMSIS device 的 tarball 不够(F7/L4 实测三源全超时)。
|
|
744
|
+
// 这里给一个适合"大文件下载"的默认值;调用方仍可用 timeoutMs 覆盖。
|
|
745
|
+
timeoutMs: request.timeoutMs ?? 240_000,
|
|
572
746
|
onProgress: (outcome, done, total) => {
|
|
573
747
|
progress("下载 " + String(done) + "/" + String(total) + ":" + outcome.path + (outcome.ok ? " OK" : " 失败(" + outcome.error + ")"));
|
|
574
748
|
},
|
|
@@ -634,6 +808,7 @@ export async function installFirmware(request) {
|
|
|
634
808
|
}
|
|
635
809
|
return finish({
|
|
636
810
|
ok: true,
|
|
811
|
+
source: "github",
|
|
637
812
|
download: { files, bytes },
|
|
638
813
|
verify,
|
|
639
814
|
message: "固件包装好了:" + plan.dirName + " 在 " + decision.dir + "(" + kindLabel(decision.kind) + ")。" +
|
|
@@ -662,7 +837,3 @@ export async function installFirmware(request) {
|
|
|
662
837
|
}
|
|
663
838
|
}
|
|
664
839
|
}
|
|
665
|
-
/** 计划 / 真装的总入口。 */
|
|
666
|
-
export async function planOrInstallFirmware(request) {
|
|
667
|
-
return (request.mode ?? "plan") === "install" ? installFirmware(request) : firmwareInstallPlan(request);
|
|
668
|
-
}
|