dsh-stm32 0.1.0 → 0.1.2
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 +127 -29
- package/README_EN.md +125 -29
- package/client/client.js +682 -0
- package/docs/development-notes.md +1385 -5
- package/docs/logic-audit.md +607 -0
- package/docs/reading-guide.md +738 -0
- package/lib/client.js +682 -0
- package/lib/commands/register.js +214 -12
- package/lib/data/chips.js +134 -4
- package/lib/data/clock-f1.js +158 -0
- package/lib/data/cmsis-sources.js +316 -0
- package/lib/data/f1-ram.generated.js +34 -0
- package/lib/data/firmware-packages.js +352 -0
- package/lib/data/install-guides.js +190 -0
- package/lib/data/search-roots.js +135 -15
- package/lib/data/stm32f1.js +186 -0
- package/lib/data/toolchain-config.js +310 -0
- package/lib/engine/build.js +121 -16
- package/lib/engine/cache.js +336 -0
- package/lib/engine/clock-plan.js +608 -0
- package/lib/engine/cmake-sources.js +428 -0
- package/lib/engine/code-patch.js +18 -6
- package/lib/engine/debug-session.js +163 -4
- package/lib/engine/debug.js +84 -19
- package/lib/engine/doctor.js +395 -4
- package/lib/engine/fetch.js +287 -0
- package/lib/engine/firmware-install.js +668 -0
- package/lib/engine/flash.js +145 -15
- package/lib/engine/fs-longpath.js +107 -0
- package/lib/engine/generate-cache.js +118 -0
- package/lib/engine/generate-script.js +30 -8
- package/lib/engine/generate.js +296 -14
- package/lib/engine/hal-chip.js +230 -0
- package/lib/engine/ioc-plan.js +47 -8
- package/lib/engine/msys2-install.js +1870 -0
- package/lib/engine/probe.js +57 -6
- package/lib/engine/project-export.js +129 -0
- package/lib/engine/register-clock.js +132 -0
- package/lib/engine/register-linker.js +129 -0
- package/lib/engine/register-template.js +449 -0
- package/lib/engine/regs.js +18 -4
- package/lib/engine/route-plan.js +553 -0
- package/lib/engine/scaffold.js +303 -72
- package/lib/engine/subprocess-runner.js +2 -0
- package/lib/engine/tar.js +250 -0
- package/lib/engine/text-file.js +150 -0
- package/lib/engine/thirdparty.js +243 -0
- package/lib/engine/tool-env.js +51 -0
- package/lib/engine/toolchain-gate.js +386 -0
- package/lib/engine/vscode-config.js +99 -0
- package/lib/engine/web-api.js +375 -0
- package/lib/engine/web-routes.js +100 -0
- package/lib/engine/xcube-catalog.js +102 -0
- package/lib/engine/xcube.js +254 -0
- package/lib/engine/zip.js +142 -0
- package/lib/index.js +44 -2
- package/lib/skill/stm32-workflow.js +3 -3
- package/lib/tools/build.js +55 -3
- package/lib/tools/cache.js +250 -0
- package/lib/tools/code-patch.js +29 -2
- package/lib/tools/debug-session.js +56 -14
- package/lib/tools/debug.js +43 -2
- package/lib/tools/doctor.js +16 -3
- package/lib/tools/env-install.js +472 -0
- package/lib/tools/env-probe.js +6 -2
- package/lib/tools/firmware-install.js +255 -0
- package/lib/tools/flash.js +41 -2
- package/lib/tools/generate.js +96 -10
- package/lib/tools/ioc-apply.js +27 -11
- package/lib/tools/ioc-inspect.js +4 -2
- package/lib/tools/ioc-plan.js +209 -11
- package/lib/tools/project-create.js +229 -21
- package/lib/tools/project-dir.js +95 -0
- package/lib/tools/project-export.js +100 -0
- package/lib/tools/regs.js +82 -7
- package/lib/tools/route-plan.js +467 -0
- package/package.json +11 -4
- package/templates/register/CMakeLists.txt +52 -0
- package/templates/register/Core/Src/main.c +72 -0
- package/templates/scaffold/openocd.cfg +8 -0
- package/templates/scaffold/vscode/launch.json +8 -6
- package/templates/scaffold/vscode/settings.json +5 -11
package/lib/engine/scaffold.js
CHANGED
|
@@ -11,13 +11,27 @@
|
|
|
11
11
|
* `<cubeRoot>/Repository/STM32Cube_FW_F1_<ver>` **原样复制**(实测与 GUI 工程逐字节一致)。
|
|
12
12
|
*
|
|
13
13
|
* 产物里没有 .mxproject:那是 GUI 独有的工程元数据,插件不伪造(伪造成本高低不平、还容易和 .ioc 不一致)。
|
|
14
|
+
*
|
|
15
|
+
* 覆盖(overwrite=true)是**破坏性**操作,所以这里的顺序是硬规定:
|
|
16
|
+
* 先判能不能写(preflightTarget)→ 再把将被覆盖的同名文件备份(backupBeforeOverwrite)
|
|
17
|
+
* → 备份成功才开始写;备份失败就一个字节都不写。
|
|
14
18
|
*/
|
|
15
19
|
import fs from "node:fs";
|
|
16
20
|
import path from "node:path";
|
|
17
21
|
import { fileURLToPath } from "node:url";
|
|
22
|
+
import { DSH_FIRMWARE_DIR_NAME } from "../data/firmware-packages.js";
|
|
23
|
+
import { firmwareExtraDirs } from "./firmware-install.js";
|
|
24
|
+
import { copyFileLong, copyTreeLong, mkdirTrackedLong } from "./fs-longpath.js";
|
|
25
|
+
import { describeHalChip, LEGACY_LINKER_SCRIPT, pointLinkerFlagAt, renderIoc, renderLinkerScript, renderStartupAndDefine, resolveHalChip, } from "./hal-chip.js";
|
|
26
|
+
import { describeDroppedPlaceholder, detectVscodeFill, fillVscodeTemplate } from "./vscode-config.js";
|
|
18
27
|
export const DEFAULT_FIRMWARE_PACKAGE = "STM32Cube_FW_F1_V1.8.7";
|
|
19
28
|
export const DEFAULT_MCU_CUBE_VERSION = "6.15.0";
|
|
20
29
|
export const SCAFFOLD_PROJECT_NAME = /^[A-Za-z_][A-Za-z0-9_]*$/u;
|
|
30
|
+
/**
|
|
31
|
+
* 工程内的状态目录名。这里自己写一份常量而不是 import generate.ts 的 STATE_DIR:
|
|
32
|
+
* 两个引擎互不依赖(避免 generate → scaffold 的循环),改名时以 ioc-plan / code-patch 的约定为准。
|
|
33
|
+
*/
|
|
34
|
+
const STATE_DIR = ".dsh-stm32";
|
|
21
35
|
/** 模板目录随插件走:lib/engine/scaffold.js → ../../templates/scaffold。 */
|
|
22
36
|
export function templateDir() {
|
|
23
37
|
return fileURLToPath(new URL("../../templates/scaffold/", import.meta.url));
|
|
@@ -60,43 +74,174 @@ const DRIVER_SKIP_PREFIXES = [
|
|
|
60
74
|
"CMSIS/NN/NN_Lib_Tests/",
|
|
61
75
|
"BSP/",
|
|
62
76
|
];
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
77
|
+
/**
|
|
78
|
+
* mkdir -p,同时记下**这次真正新建**的目录。
|
|
79
|
+
* 为什么要记:写盘中途失败时要清掉半成品目录,而"清"必须精确到本次新建的,
|
|
80
|
+
* 用户原有的目录一个都不能动(递归删用户目录 = 把审计里的丢数据问题换个地方重演)。
|
|
81
|
+
*/
|
|
82
|
+
export function mkdirTracked(dir, created) {
|
|
83
|
+
// 实现搬到了 fs-longpath(那里要处理 \\?\ 前缀,且复制树也要用它)。
|
|
84
|
+
// 这里留这个名字是因为 register-template 与备份/写盘都在用;改名只会制造无谓的改动面。
|
|
85
|
+
mkdirTrackedLong(dir, created);
|
|
86
|
+
}
|
|
87
|
+
/**
|
|
88
|
+
* 写盘失败后的收尾:
|
|
89
|
+
* - 目标目录是本次新建的 → 整棵删掉(里面只可能有本次写的文件);
|
|
90
|
+
* - 目标目录本来就有 → 只删本次新建且现在仍是空的目录,**绝不递归删**(用户文件一个都不碰)。
|
|
91
|
+
*/
|
|
92
|
+
export function cleanupAfterFailure(targetDir, targetExistedBefore, created) {
|
|
93
|
+
if (!targetExistedBefore) {
|
|
94
|
+
try {
|
|
95
|
+
fs.rmSync(targetDir, { recursive: true, force: true });
|
|
96
|
+
return "目标目录是本次新建的,已整个删掉,不留半成品。";
|
|
80
97
|
}
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
98
|
+
catch (error) {
|
|
99
|
+
return "目标目录是本次新建的,但删不干净(" + String(error.message) + "),请手动删:" + targetDir + "。";
|
|
100
|
+
}
|
|
101
|
+
}
|
|
102
|
+
const deepestFirst = [...new Set(created)].sort((a, b) => b.length - a.length);
|
|
103
|
+
let removed = 0;
|
|
104
|
+
for (const dir of deepestFirst) {
|
|
105
|
+
try {
|
|
106
|
+
fs.rmdirSync(dir);
|
|
107
|
+
removed += 1;
|
|
108
|
+
}
|
|
109
|
+
catch {
|
|
110
|
+
// 非空(里面有用户文件或本次已写入的文件)→ 留着。宁可留半成品,也不动用户的文件。
|
|
111
|
+
}
|
|
112
|
+
}
|
|
113
|
+
return removed === 0 ? "" : "已清掉本次新建的 " + String(removed) + " 个空目录。";
|
|
114
|
+
}
|
|
115
|
+
/**
|
|
116
|
+
* 目录里是不是一个能拿来建工程的固件包(三条判据与 CubeMX 包管理器装的包一致)。
|
|
117
|
+
*
|
|
118
|
+
* 第三条只看 gcc 目录在不在,不再点名 startup_stm32f103xb.s:那是 C8T6 的启动文件,
|
|
119
|
+
* 用它当判据等于「不是 C8T6 的工程就别想建」。具体型号要哪个启动文件由
|
|
120
|
+
* createProjectScaffold 按芯片查(缺了会列出包里真实带的那些)。
|
|
121
|
+
*/
|
|
122
|
+
function isUsableFirmwareRoot(candidate) {
|
|
123
|
+
return (fs.existsSync(path.join(candidate, "Drivers", "STM32F1xx_HAL_Driver")) &&
|
|
124
|
+
fs.existsSync(path.join(candidate, "Drivers", "CMSIS", "Include")) &&
|
|
125
|
+
fs.existsSync(path.join(candidate, "Drivers", "CMSIS", "Device", "ST", "STM32F1xx", "Source", "Templates", "gcc")));
|
|
84
126
|
}
|
|
85
|
-
/**
|
|
86
|
-
|
|
127
|
+
/**
|
|
128
|
+
* 找固件包:先扫 CubeMX 根(官方仓库 → 插件的 dsh-firmware),再扫 extraDirs
|
|
129
|
+
* (<cacheRoot>/firmware 与 installed.json 里记的落点,见 firmware-install.firmwareExtraDirs)。
|
|
130
|
+
*
|
|
131
|
+
* 为什么要带 extraDirs:stm32_firmware_install 在 CubeMX 根写不进去时会落到下载缓存或调用方指定目录。
|
|
132
|
+
* 只扫 CubeMX 根的话,用户明明装好了,建工程却报"找不到固件包"(审计 B10)。
|
|
133
|
+
*/
|
|
134
|
+
export function resolveFirmwareRoot(cubeMxRoots, packageName = DEFAULT_FIRMWARE_PACKAGE, extraDirs = []) {
|
|
87
135
|
const checked = [];
|
|
88
136
|
for (const cubeRoot of cubeMxRoots) {
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
137
|
+
// 官方仓库优先,其次插件自己的 dsh-firmware(与 Repository 并列,见 firmware-packages.ts)。
|
|
138
|
+
for (const parent of ["Repository", DSH_FIRMWARE_DIR_NAME]) {
|
|
139
|
+
const candidate = path.join(cubeRoot, parent, packageName);
|
|
140
|
+
checked.push(candidate);
|
|
141
|
+
if (isUsableFirmwareRoot(candidate))
|
|
142
|
+
return { root: candidate, checked };
|
|
143
|
+
}
|
|
144
|
+
}
|
|
145
|
+
for (const extra of extraDirs) {
|
|
146
|
+
// extra.dir 可能是"放包的父目录",也可能本身就是包(显式 targetDir 指到包上)。
|
|
147
|
+
const candidates = path.basename(extra.dir) === packageName ? [extra.dir] : [path.join(extra.dir, packageName)];
|
|
148
|
+
for (const candidate of candidates) {
|
|
149
|
+
checked.push(candidate);
|
|
150
|
+
if (isUsableFirmwareRoot(candidate))
|
|
151
|
+
return { root: candidate, checked };
|
|
96
152
|
}
|
|
97
153
|
}
|
|
98
154
|
return { checked };
|
|
99
155
|
}
|
|
156
|
+
/**
|
|
157
|
+
* 动手之前就能判定的拒绝条件(纯读,不写盘)。
|
|
158
|
+
*
|
|
159
|
+
* 为什么单独抽出来:工具层要在**门禁(工具链检查)之前**先跑它——否则用户会先被要求装 CubeMX,
|
|
160
|
+
* 装完才发现目标目录根本不能写,白折腾一趟。引擎自己也调它,保证只有一份判定。
|
|
161
|
+
*/
|
|
162
|
+
export function preflightTarget(request) {
|
|
163
|
+
const targetDir = path.resolve(request.targetDir);
|
|
164
|
+
const projectName = request.projectName ?? path.basename(targetDir);
|
|
165
|
+
if (!SCAFFOLD_PROJECT_NAME.test(projectName)) {
|
|
166
|
+
return "工程名必须是 C 标识符(字母/下划线开头,只含字母数字下划线):" + projectName;
|
|
167
|
+
}
|
|
168
|
+
if (!fs.existsSync(targetDir))
|
|
169
|
+
return null;
|
|
170
|
+
const entries = fs.readdirSync(targetDir);
|
|
171
|
+
if (entries.length === 0)
|
|
172
|
+
return null;
|
|
173
|
+
if (request.overwrite !== true) {
|
|
174
|
+
return ("目标目录不是空的(" + String(entries.length) + " 项):" + targetDir +
|
|
175
|
+
"。换一个目录;确定要往里写请显式 overwrite=true(同名的工程文件会先备份到 " + STATE_DIR + "/backups 再覆盖)。");
|
|
176
|
+
}
|
|
177
|
+
if (request.route === "hal") {
|
|
178
|
+
// HAL 路线模板里那份 .ioc 是空白配置:覆盖它等于把引脚/时钟树全丢掉,且没有任何"合并"的可能。
|
|
179
|
+
// 所以不做备份+覆盖那一套,直接拒绝,把用户指回 .ioc 事务。
|
|
180
|
+
const iocPath = path.join(targetDir, projectName + ".ioc");
|
|
181
|
+
if (fs.existsSync(iocPath)) {
|
|
182
|
+
return ("目标工程里已有 " + projectName + ".ioc:" + iocPath +
|
|
183
|
+
"。模板只能给一份空白配置,覆盖它等于把引脚/时钟树全丢掉,所以这里直接拒绝。" +
|
|
184
|
+
"要改配置请走 stm32_ioc_plan → stm32_ioc_apply(会先备份 .ioc);确实要用模板重建请先自己备份或删掉它。");
|
|
185
|
+
}
|
|
186
|
+
}
|
|
187
|
+
return null;
|
|
188
|
+
}
|
|
189
|
+
/** 备份目录名:时间戳 + 来源(与 ioc-plan 的 <stamp>-ioc、code-patch 的 <stamp>-patch 同一套写法)。 */
|
|
190
|
+
function backupStamp(tag) {
|
|
191
|
+
const d = new Date();
|
|
192
|
+
const pad = (n) => String(n).padStart(2, "0");
|
|
193
|
+
return (String(d.getFullYear()) + pad(d.getMonth() + 1) + pad(d.getDate()) + "-" + pad(d.getHours()) + pad(d.getMinutes()) + pad(d.getSeconds()) + "-" + tag);
|
|
194
|
+
}
|
|
195
|
+
/**
|
|
196
|
+
* 覆盖前把**将被模板覆盖**的同名文件复制到 `<工程>/.dsh-stm32/backups/<stamp>-<tag>/` 下(保留相对路径)。
|
|
197
|
+
*
|
|
198
|
+
* 为什么要备份:overwrite=true 是用户为了"快速重建"点的头,不该顺手丢掉 .ioc 的引脚/时钟、
|
|
199
|
+
* 或 main.c 里的 USER CODE。备份失败会**抛错**,由调用方转成失败报告——一个字节都不写。
|
|
200
|
+
*/
|
|
201
|
+
export function backupBeforeOverwrite(targetDir, relatives, tag) {
|
|
202
|
+
const existing = relatives.filter((rel) => fs.existsSync(path.join(targetDir, rel)));
|
|
203
|
+
if (existing.length === 0)
|
|
204
|
+
return { dir: "", files: [] };
|
|
205
|
+
const root = path.join(targetDir, STATE_DIR, "backups");
|
|
206
|
+
let dir = path.join(root, backupStamp(tag));
|
|
207
|
+
// 同一秒内连续两次覆盖要各留一份:撞名就加序号,绝不覆盖上一次的备份。
|
|
208
|
+
for (let extra = 2; fs.existsSync(dir); extra += 1)
|
|
209
|
+
dir = path.join(root, backupStamp(tag) + "-" + String(extra));
|
|
210
|
+
fs.mkdirSync(dir, { recursive: true });
|
|
211
|
+
for (const rel of existing) {
|
|
212
|
+
const dest = path.join(dir, rel);
|
|
213
|
+
fs.mkdirSync(path.dirname(dest), { recursive: true });
|
|
214
|
+
copyFileLong(path.join(targetDir, rel), dest);
|
|
215
|
+
}
|
|
216
|
+
return { dir, files: existing };
|
|
217
|
+
}
|
|
218
|
+
/**
|
|
219
|
+
* 模板文件 → 工程里的目标(相对工程目录,正斜杠)。
|
|
220
|
+
* scaffold 的写盘与"覆盖前备份"共用这一份映射:两处各写一遍迟早对不上,备份就会漏文件。
|
|
221
|
+
*/
|
|
222
|
+
function templateTargets(tpl, projectName) {
|
|
223
|
+
const targets = new Map();
|
|
224
|
+
for (const source of listFiles(tpl, TEMPLATE_SKIP_PREFIXES)) {
|
|
225
|
+
const rel = path.relative(tpl, source).replace(/\\/gu, "/");
|
|
226
|
+
const destRel = rel.startsWith("vscode/")
|
|
227
|
+
? ".vscode/" + rel.slice("vscode/".length)
|
|
228
|
+
: rel === "demo.ioc"
|
|
229
|
+
? projectName + ".ioc"
|
|
230
|
+
: rel;
|
|
231
|
+
targets.set(source, destRel);
|
|
232
|
+
}
|
|
233
|
+
return targets;
|
|
234
|
+
}
|
|
235
|
+
/** 被模板/固件包直接覆盖的工程文件(Drivers/ 整棵树不在内:那是 ST 源码,不是用户文件)。 */
|
|
236
|
+
function overwriteTargetsFor(writtenRels, facts) {
|
|
237
|
+
return [...writtenRels, facts.startup, "Core/Src/system_stm32f1xx.c", facts.linkerScript];
|
|
238
|
+
}
|
|
239
|
+
/** 备份说明(写进 warnings,卡片上第一眼就能看到原件在哪)。 */
|
|
240
|
+
export function backupWarning(backup) {
|
|
241
|
+
if (backup.files.length === 0)
|
|
242
|
+
return null;
|
|
243
|
+
return "已把被覆盖的文件备份到 " + backup.dir + ":" + backup.files.join("、");
|
|
244
|
+
}
|
|
100
245
|
/**
|
|
101
246
|
* 建工程骨架(不调用 CubeMX;生成 Core/ 由 stm32_generate 负责)。
|
|
102
247
|
*/
|
|
@@ -105,7 +250,12 @@ export function createProjectScaffold(request) {
|
|
|
105
250
|
const targetDir = path.resolve(request.targetDir);
|
|
106
251
|
const projectName = request.projectName ?? path.basename(targetDir);
|
|
107
252
|
const firmwarePackage = request.firmwarePackage ?? DEFAULT_FIRMWARE_PACKAGE;
|
|
108
|
-
|
|
253
|
+
// 芯片事实先算出来:连失败报告都要说清"本来是按哪款芯片建"。
|
|
254
|
+
const chip = resolveHalChip(request.mcu);
|
|
255
|
+
const facts = chip.facts;
|
|
256
|
+
const chipFields = () => facts === null
|
|
257
|
+
? {}
|
|
258
|
+
: { mcu: facts.mcu, startup: facts.startup, deviceDefine: facts.deviceDefine, linkerScript: facts.linkerScript };
|
|
109
259
|
const fail = (message, warnings = []) => ({
|
|
110
260
|
ok: false,
|
|
111
261
|
targetDir,
|
|
@@ -117,57 +267,133 @@ export function createProjectScaffold(request) {
|
|
|
117
267
|
durationMs: Date.now() - startedAt,
|
|
118
268
|
warnings,
|
|
119
269
|
message,
|
|
270
|
+
...chipFields(),
|
|
120
271
|
});
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
return fail("目标目录不是空的(" + String(entries.length) + " 项):" + targetDir + "。换一个目录,或显式 overwrite=true(会覆盖同名文件)。");
|
|
128
|
-
}
|
|
129
|
-
}
|
|
272
|
+
const refusal = preflightTarget({ targetDir, projectName, route: "hal", ...(request.overwrite === undefined ? {} : { overwrite: request.overwrite }) });
|
|
273
|
+
if (refusal !== null)
|
|
274
|
+
return fail(refusal);
|
|
275
|
+
// 1) 芯片:认不出 / 缺 RAM 就拒绝(reason 是人话,直接给用户看)
|
|
276
|
+
if (facts === null)
|
|
277
|
+
return fail("认不出芯片型号:" + chip.reason);
|
|
130
278
|
const tpl = templateDir();
|
|
131
279
|
if (!fs.existsSync(tpl))
|
|
132
280
|
return fail("插件模板目录缺失:" + tpl + "(重新安装插件)");
|
|
133
|
-
const firmware = resolveFirmwareRoot(request.cubeMxRoots ?? [], firmwarePackage);
|
|
281
|
+
const firmware = resolveFirmwareRoot(request.cubeMxRoots ?? [], firmwarePackage, firmwareExtraDirs());
|
|
134
282
|
if (firmware.root === undefined) {
|
|
135
283
|
return fail("找不到 CubeMX 固件包 " + firmwarePackage + "(找过:" + firmware.checked.join(";") + ")。" +
|
|
136
284
|
"固件包是 Drivers/ 与 startup 的唯一合法来源,插件不内嵌 ST 代码。");
|
|
137
285
|
}
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
286
|
+
// 2) 固件包里必须真有这款芯片的启动文件与设备头:认不出就停在这里,别建出个编译不过的工程
|
|
287
|
+
// (startup 是 copy 进工程的,设备头随 Drivers/ 整树拷过来,所以只校验存在性)。
|
|
288
|
+
const deviceDir = path.join(firmware.root, "Drivers", "CMSIS", "Device", "ST", "STM32F1xx");
|
|
289
|
+
const templatesDir = path.join(deviceDir, "Source", "Templates");
|
|
290
|
+
const gccDir = path.join(templatesDir, "gcc");
|
|
291
|
+
const startupSource = path.join(gccDir, facts.startup);
|
|
292
|
+
const headerSource = path.join(deviceDir, "Include", facts.deviceHeader);
|
|
293
|
+
if (!fs.existsSync(startupSource)) {
|
|
294
|
+
const available = fs.existsSync(gccDir)
|
|
295
|
+
? fs.readdirSync(gccDir).filter((name) => /^startup_.*\.s$/u.test(name)).sort()
|
|
296
|
+
: [];
|
|
297
|
+
return fail("固件包里没有 " + facts.mcu + " 需要的启动文件 " + facts.startup + ":" + startupSource +
|
|
298
|
+
"。这份固件包真实带的启动文件:" + (available.length === 0 ? "(一个都没有)" : available.join("、")));
|
|
299
|
+
}
|
|
300
|
+
if (!fs.existsSync(headerSource)) {
|
|
301
|
+
return fail("固件包里没有 " + facts.deviceDefine + " 的设备头 " + facts.deviceHeader + ":" + headerSource +
|
|
302
|
+
"。设备头随 Drivers/ 一起复制,缺它说明这份固件包不完整(换一个版本的 " + firmwarePackage + ")。");
|
|
303
|
+
}
|
|
304
|
+
// 3) 模板全部读进内存并按芯片渲染好——这一步一个字节都不写:
|
|
305
|
+
// 渲染失败只可能是模板被改过,宁可在动手前拒绝,也不留下一半 C8T6 一半新芯片的工程。
|
|
306
|
+
const vscodeFill = detectVscodeFill(request.binDirs ?? []);
|
|
307
|
+
const droppedVscode = new Set();
|
|
308
|
+
const written = [];
|
|
309
|
+
let linkerScriptText = "";
|
|
310
|
+
try {
|
|
311
|
+
// 链接脚本按芯片渲染;模板里那份(C8T6 的 64K/20K)只作渲染源 + 蓝丸的兼容副本。
|
|
312
|
+
linkerScriptText = renderLinkerScript(fs.readFileSync(path.join(tpl, LEGACY_LINKER_SCRIPT), "utf8"), facts);
|
|
313
|
+
for (const [source, destRel] of templateTargets(tpl, projectName)) {
|
|
314
|
+
// 旧名的链接脚本只在蓝丸上留一份:别的芯片写旧名 = 一份骗人的内存布局。
|
|
315
|
+
if (destRel === LEGACY_LINKER_SCRIPT && !facts.keepLegacyLinkerScript)
|
|
316
|
+
continue;
|
|
317
|
+
let text = fs.readFileSync(source, "utf8");
|
|
318
|
+
if (destRel !== ".gitignore" && destRel !== LEGACY_LINKER_SCRIPT) {
|
|
319
|
+
text = text.split("__PROJECT_NAME__").join(projectName);
|
|
320
|
+
}
|
|
321
|
+
if (destRel === projectName + ".ioc")
|
|
322
|
+
text = renderIoc(text, facts);
|
|
323
|
+
if (destRel === "cmake/gcc-arm-none-eabi.cmake" || destRel === "cmake/starm-clang.cmake") {
|
|
324
|
+
text = pointLinkerFlagAt(text, facts);
|
|
325
|
+
}
|
|
326
|
+
if (destRel === "cmake/stm32cubemx/CMakeLists.txt")
|
|
327
|
+
text = renderStartupAndDefine(text, facts);
|
|
328
|
+
if (destRel.startsWith(".vscode/")) {
|
|
329
|
+
const filled = fillVscodeTemplate(text, vscodeFill);
|
|
330
|
+
text = filled.text;
|
|
331
|
+
for (const token of filled.dropped)
|
|
332
|
+
droppedVscode.add(token);
|
|
333
|
+
}
|
|
334
|
+
written.push({ rel: destRel, text });
|
|
148
335
|
}
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
}
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
336
|
+
}
|
|
337
|
+
catch (error) {
|
|
338
|
+
return fail("没写任何文件:模板按芯片渲染失败(" + String(error.message) + ")。目标目录 " + targetDir + " 未被改动。");
|
|
339
|
+
}
|
|
340
|
+
const templateFiles = written.length;
|
|
341
|
+
// —— 写盘从这里开始:先把将被覆盖的同名文件备份;备份失败就一个字节都不写 ——
|
|
342
|
+
let backup;
|
|
343
|
+
try {
|
|
344
|
+
backup = backupBeforeOverwrite(targetDir, overwriteTargetsFor(written.map((item) => item.rel), facts), "scaffold");
|
|
345
|
+
}
|
|
346
|
+
catch (error) {
|
|
347
|
+
return fail("没写任何文件:覆盖前的备份失败(" + String(error.message) + ")。目标目录 " + targetDir + " 未被改动。");
|
|
348
|
+
}
|
|
349
|
+
const backupNote = backupWarning(backup);
|
|
350
|
+
const backupWarnings = backupNote === null ? [] : [backupNote];
|
|
351
|
+
const targetExistedBefore = fs.existsSync(targetDir);
|
|
352
|
+
// npm 打包永远排除 .gitignore(它同时是 npm 的忽略过滤器):npm 安装的用户模板里必然没有。
|
|
353
|
+
// 缺它工程照建,只是 git 状态会多出 build/;warning 里说明白,别让人以为是装坏了。
|
|
354
|
+
const gitignoreMissing = !fs.existsSync(path.join(tpl, ".gitignore"));
|
|
355
|
+
const createdDirs = [];
|
|
356
|
+
let driverFiles = 0;
|
|
357
|
+
try {
|
|
358
|
+
mkdirTracked(targetDir, createdDirs);
|
|
359
|
+
mkdirTracked(path.join(targetDir, "Core", "Src"), createdDirs);
|
|
360
|
+
mkdirTracked(path.join(targetDir, "Core", "Inc"), createdDirs);
|
|
361
|
+
// 1) 模板快照(已按芯片渲染):CMake 工程文件 / 链接脚本 / .vscode / .ioc
|
|
362
|
+
// .vscode 里的调试/构建路径按本机探测填(模板只留占位符,绝不写死开发机的 D:/… 路径)。
|
|
363
|
+
for (const item of written) {
|
|
364
|
+
const dest = path.join(targetDir, item.rel);
|
|
365
|
+
mkdirTracked(path.dirname(dest), createdDirs);
|
|
366
|
+
fs.writeFileSync(dest, item.text);
|
|
367
|
+
}
|
|
368
|
+
// 链接脚本:按芯片命名的那份(蓝丸另有一份旧名兼容副本,已经作为模板项写过了)
|
|
369
|
+
fs.writeFileSync(path.join(targetDir, facts.linkerScript), linkerScriptText);
|
|
370
|
+
// 2) 固件包:Drivers 全量 + 本芯片的 startup + system(与 GUI 新工程逐字节一致)
|
|
371
|
+
driverFiles = copyTreeLong(path.join(firmware.root, "Drivers"), path.join(targetDir, "Drivers"), DRIVER_SKIP_PREFIXES, createdDirs);
|
|
372
|
+
copyFileLong(startupSource, path.join(targetDir, facts.startup));
|
|
373
|
+
copyFileLong(path.join(templatesDir, "system_stm32f1xx.c"), path.join(targetDir, "Core", "Src", "system_stm32f1xx.c"));
|
|
374
|
+
}
|
|
375
|
+
catch (error) {
|
|
376
|
+
const cleanup = cleanupAfterFailure(targetDir, targetExistedBefore, createdDirs);
|
|
377
|
+
return fail("写盘失败(已写 " + String(written.length) + " 个模板文件、" + String(driverFiles) + " 个固件文件):" +
|
|
378
|
+
String(error.message) + ";路径:" + targetDir + "。" + cleanup, backupWarnings);
|
|
379
|
+
}
|
|
164
380
|
const iocPath = path.join(targetDir, projectName + ".ioc");
|
|
165
|
-
const warnings = [
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
381
|
+
const warnings = [];
|
|
382
|
+
if (backupNote !== null)
|
|
383
|
+
warnings.push(backupNote);
|
|
384
|
+
for (const note of facts.notes)
|
|
385
|
+
warnings.push(note);
|
|
386
|
+
if (!facts.keepLegacyLinkerScript) {
|
|
387
|
+
warnings.push("链接脚本按芯片命名为 " + facts.linkerScript + "(cmake 的 -T 已指到它);旧名 " + LEGACY_LINKER_SCRIPT +
|
|
388
|
+
" 只在 C8T6 上留兼容副本,别的芯片写它是错的内存布局。");
|
|
389
|
+
}
|
|
390
|
+
if (gitignoreMissing) {
|
|
391
|
+
warnings.push("插件包里没有 .gitignore(npm 打包会排除它):工程功能不受影响,只是 git 状态会多出 build/ 目录。" +
|
|
392
|
+
"想干净就在工程根目录建一个 .gitignore,内容一行:build/");
|
|
393
|
+
}
|
|
394
|
+
for (const token of droppedVscode)
|
|
395
|
+
warnings.push(describeDroppedPlaceholder(token));
|
|
396
|
+
warnings.push("没有生成 .mxproject:那是 CubeMX GUI 的工程元数据,插件不伪造;用 GUI 打开并生成一次即可补上。", "Core/ 下的 main.c 等还没生成:接着调 stm32_generate(3–4 分钟,需要 CubeMX 全权限)。");
|
|
171
397
|
return {
|
|
172
398
|
ok: true,
|
|
173
399
|
targetDir,
|
|
@@ -179,6 +405,11 @@ export function createProjectScaffold(request) {
|
|
|
179
405
|
driverFiles,
|
|
180
406
|
durationMs: Date.now() - startedAt,
|
|
181
407
|
warnings,
|
|
182
|
-
|
|
408
|
+
mcu: facts.mcu,
|
|
409
|
+
startup: facts.startup,
|
|
410
|
+
deviceDefine: facts.deviceDefine,
|
|
411
|
+
linkerScript: facts.linkerScript,
|
|
412
|
+
message: "工程骨架已建好(" + String(templateFiles) + " 个工程文件 + " + String(driverFiles) + " 个固件文件):" + targetDir +
|
|
413
|
+
";芯片 " + describeHalChip(facts) + (backupNote === null ? "" : ";" + backupNote),
|
|
183
414
|
};
|
|
184
415
|
}
|
|
@@ -51,6 +51,7 @@ export async function runCapture(subprocess, request) {
|
|
|
51
51
|
},
|
|
52
52
|
graceMs: 3_000,
|
|
53
53
|
signal: controller.signal,
|
|
54
|
+
...(request.env === undefined ? {} : { env: request.env }),
|
|
54
55
|
});
|
|
55
56
|
const outcome = await handle.done;
|
|
56
57
|
const stdout = handle.collected.stdout?.readFrom(0).text ?? "";
|
|
@@ -129,6 +130,7 @@ export async function runStreaming(subprocess, request) {
|
|
|
129
130
|
stdio: { stdin: "ignore", stdout: { maxBytes }, stderr: { maxBytes } },
|
|
130
131
|
graceMs: 5_000,
|
|
131
132
|
signal: controller.signal,
|
|
133
|
+
...(request.env === undefined ? {} : { env: request.env }),
|
|
132
134
|
});
|
|
133
135
|
const current = handle;
|
|
134
136
|
let settled = false;
|