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.
Files changed (82) hide show
  1. package/README.md +127 -29
  2. package/README_EN.md +125 -29
  3. package/client/client.js +682 -0
  4. package/docs/development-notes.md +1385 -5
  5. package/docs/logic-audit.md +607 -0
  6. package/docs/reading-guide.md +738 -0
  7. package/lib/client.js +682 -0
  8. package/lib/commands/register.js +214 -12
  9. package/lib/data/chips.js +134 -4
  10. package/lib/data/clock-f1.js +158 -0
  11. package/lib/data/cmsis-sources.js +316 -0
  12. package/lib/data/f1-ram.generated.js +34 -0
  13. package/lib/data/firmware-packages.js +352 -0
  14. package/lib/data/install-guides.js +190 -0
  15. package/lib/data/search-roots.js +135 -15
  16. package/lib/data/stm32f1.js +186 -0
  17. package/lib/data/toolchain-config.js +310 -0
  18. package/lib/engine/build.js +121 -16
  19. package/lib/engine/cache.js +336 -0
  20. package/lib/engine/clock-plan.js +608 -0
  21. package/lib/engine/cmake-sources.js +428 -0
  22. package/lib/engine/code-patch.js +18 -6
  23. package/lib/engine/debug-session.js +163 -4
  24. package/lib/engine/debug.js +84 -19
  25. package/lib/engine/doctor.js +395 -4
  26. package/lib/engine/fetch.js +287 -0
  27. package/lib/engine/firmware-install.js +668 -0
  28. package/lib/engine/flash.js +145 -15
  29. package/lib/engine/fs-longpath.js +107 -0
  30. package/lib/engine/generate-cache.js +118 -0
  31. package/lib/engine/generate-script.js +30 -8
  32. package/lib/engine/generate.js +296 -14
  33. package/lib/engine/hal-chip.js +230 -0
  34. package/lib/engine/ioc-plan.js +47 -8
  35. package/lib/engine/msys2-install.js +1870 -0
  36. package/lib/engine/probe.js +57 -6
  37. package/lib/engine/project-export.js +129 -0
  38. package/lib/engine/register-clock.js +132 -0
  39. package/lib/engine/register-linker.js +129 -0
  40. package/lib/engine/register-template.js +449 -0
  41. package/lib/engine/regs.js +18 -4
  42. package/lib/engine/route-plan.js +553 -0
  43. package/lib/engine/scaffold.js +303 -72
  44. package/lib/engine/subprocess-runner.js +2 -0
  45. package/lib/engine/tar.js +250 -0
  46. package/lib/engine/text-file.js +150 -0
  47. package/lib/engine/thirdparty.js +243 -0
  48. package/lib/engine/tool-env.js +51 -0
  49. package/lib/engine/toolchain-gate.js +386 -0
  50. package/lib/engine/vscode-config.js +99 -0
  51. package/lib/engine/web-api.js +375 -0
  52. package/lib/engine/web-routes.js +100 -0
  53. package/lib/engine/xcube-catalog.js +102 -0
  54. package/lib/engine/xcube.js +254 -0
  55. package/lib/engine/zip.js +142 -0
  56. package/lib/index.js +44 -2
  57. package/lib/skill/stm32-workflow.js +3 -3
  58. package/lib/tools/build.js +55 -3
  59. package/lib/tools/cache.js +250 -0
  60. package/lib/tools/code-patch.js +29 -2
  61. package/lib/tools/debug-session.js +56 -14
  62. package/lib/tools/debug.js +43 -2
  63. package/lib/tools/doctor.js +16 -3
  64. package/lib/tools/env-install.js +472 -0
  65. package/lib/tools/env-probe.js +6 -2
  66. package/lib/tools/firmware-install.js +255 -0
  67. package/lib/tools/flash.js +41 -2
  68. package/lib/tools/generate.js +96 -10
  69. package/lib/tools/ioc-apply.js +27 -11
  70. package/lib/tools/ioc-inspect.js +4 -2
  71. package/lib/tools/ioc-plan.js +209 -11
  72. package/lib/tools/project-create.js +229 -21
  73. package/lib/tools/project-dir.js +95 -0
  74. package/lib/tools/project-export.js +100 -0
  75. package/lib/tools/regs.js +82 -7
  76. package/lib/tools/route-plan.js +467 -0
  77. package/package.json +11 -4
  78. package/templates/register/CMakeLists.txt +52 -0
  79. package/templates/register/Core/Src/main.c +72 -0
  80. package/templates/scaffold/openocd.cfg +8 -0
  81. package/templates/scaffold/vscode/launch.json +8 -6
  82. package/templates/scaffold/vscode/settings.json +5 -11
@@ -0,0 +1,375 @@
1
+ /**
2
+ * 设置面板的宿主 API(Web 端):浏览器插件 lib/client.js 用 fetch 调这里。
3
+ *
4
+ * 为什么走 HTTP 而不是 ctx.remote:面板只要读配置、跑探测、起安装三件事;
5
+ * typert 的 remote 服务要另加一层协议定义与类型生成,对三个按钮的页面不值。
6
+ * 路由由宿主 webServer 服务注册(与 dsh-market 同一做法),客户端相对 document.baseURI
7
+ * 取路径,所以不论部署在根路径还是子路径都能用。
8
+ *
9
+ * 本文件分两层:
10
+ * - 纯函数(configSnapshot / saveConfig / probeTools / installPlan / 任务登记)—— 可离线单测;
11
+ * - handleWebApi 按路径分发,输入输出都是普通对象,不碰 Node 的 IncomingMessage。
12
+ * HTTP 适配在 src/index.ts 里,保持极薄。
13
+ */
14
+ import { binDirsFromConfig, configReadingDisabled, cubeMxRootsFromConfig, readToolchainConfig, toolchainConfigPath, updateToolchainConfig, } from "../data/toolchain-config.js";
15
+ import { resolveSearchConfig } from "../data/search-roots.js";
16
+ import { buildTargets, probeAll } from "./probe.js";
17
+ import { planOrInstallMsys2 } from "./msys2-install.js";
18
+ function envOf(deps) {
19
+ return deps.env ?? process.env;
20
+ }
21
+ function describeError(error) {
22
+ return error instanceof Error ? error.message : String(error);
23
+ }
24
+ /** 只留非空字符串,顺带去重;用于面板传来的目录数组。null 表示不是字符串数组。 */
25
+ function stringList(value) {
26
+ if (value === undefined || value === null)
27
+ return [];
28
+ if (!Array.isArray(value))
29
+ return null;
30
+ const out = [];
31
+ for (const item of value) {
32
+ if (typeof item !== "string")
33
+ return null;
34
+ const trimmed = item.trim();
35
+ if (trimmed === "")
36
+ continue;
37
+ if (!out.includes(trimmed))
38
+ out.push(trimmed);
39
+ }
40
+ return out;
41
+ }
42
+ /** pacman 包名不允许以 - 开头:那会被当成选项,等于把安装变成任意标志注入。 */
43
+ function packageList(value) {
44
+ const list = stringList(value);
45
+ if (list === null)
46
+ return { ok: false, packages: [], error: "packages 必须是字符串数组" };
47
+ for (const name of list) {
48
+ if (name.startsWith("-"))
49
+ return { ok: false, packages: [], error: "包名不能以 - 开头:" + name };
50
+ if (/[\s"'|&;<>]/u.test(name))
51
+ return { ok: false, packages: [], error: "包名里有空白或 shell 特殊字符:" + name };
52
+ }
53
+ return { ok: true, packages: list, error: "" };
54
+ }
55
+ /** 面板打开时读一次:配置内容 + 由它推导出的 binDirs / CubeMX 根。 */
56
+ export function configSnapshot(env = process.env) {
57
+ const read = readToolchainConfig(env);
58
+ return {
59
+ ok: read.config !== null,
60
+ path: read.path,
61
+ exists: read.exists,
62
+ readingDisabled: configReadingDisabled(env),
63
+ errors: [...read.errors],
64
+ config: read.config,
65
+ binDirs: binDirsFromConfig(read.config),
66
+ cubeMxRoots: cubeMxRootsFromConfig(read.config),
67
+ };
68
+ }
69
+ /**
70
+ * 保存面板上改过的字段。
71
+ * 只接受认识的键,每个键都能单独缺省(缺省 = 保留原值),这样前端可以只发 diff。
72
+ */
73
+ export function saveConfig(payload, env = process.env) {
74
+ if (payload === null || typeof payload !== "object" || Array.isArray(payload)) {
75
+ return { ok: false, error: "请求体必须是 JSON 对象", path: toolchainConfigPath(env), config: null };
76
+ }
77
+ const patch = {};
78
+ for (const key of ["msys64", "cubeMxRoot"]) {
79
+ const value = payload[key];
80
+ if (value === undefined)
81
+ continue;
82
+ if (typeof value !== "string") {
83
+ return { ok: false, error: key + " 必须是字符串", path: toolchainConfigPath(env), config: null };
84
+ }
85
+ patch[key] = value.trim();
86
+ }
87
+ if (payload["binDirs"] !== undefined) {
88
+ const binDirs = stringList(payload["binDirs"]);
89
+ if (binDirs === null) {
90
+ return { ok: false, error: "binDirs 必须是字符串数组", path: toolchainConfigPath(env), config: null };
91
+ }
92
+ patch.binDirs = binDirs;
93
+ }
94
+ if (payload["packages"] !== undefined) {
95
+ const packages = packageList(payload["packages"]);
96
+ if (!packages.ok) {
97
+ return { ok: false, error: packages.error, path: toolchainConfigPath(env), config: null };
98
+ }
99
+ patch.packages = packages.packages;
100
+ }
101
+ if (Object.keys(patch).length === 0) {
102
+ return {
103
+ ok: false,
104
+ error: "没有要保存的字段(msys64 / binDirs / packages / cubeMxRoot)",
105
+ path: toolchainConfigPath(env),
106
+ config: null,
107
+ };
108
+ }
109
+ const written = updateToolchainConfig(patch, env);
110
+ const read = readToolchainConfig(env);
111
+ return { ok: written.ok, error: written.error, path: written.path, config: read.config };
112
+ }
113
+ /** build 的 gcc/cmake/ninja 才算必需;CubeMX 两项是可选能力。 */
114
+ export function capabilitiesOf(tools) {
115
+ const has = (id) => tools.some((tool) => tool.id === id && tool.found);
116
+ return {
117
+ build: has("gcc") && has("cmake") && has("ninja"),
118
+ flash: has("openocd"),
119
+ debug: has("openocd") && has("gdb"),
120
+ generate: has("cubemx") && has("cubemx-java"),
121
+ };
122
+ }
123
+ export function summarizeProbe(results, config) {
124
+ const capabilities = capabilitiesOf(results);
125
+ const missingRequired = results.filter((item) => item.required && !item.found).map((item) => item.label);
126
+ const found = results.filter((item) => item.found).length;
127
+ const message = missingRequired.length === 0
128
+ ? "工具链就绪:" + String(found) + "/" + String(results.length) + " 项可用,可以编译 / 烧录 / 调试"
129
+ : "缺 " + missingRequired.join("、") + ":编译 / 烧录 / 调试会失败(CubeMX 两项只影响生成代码)";
130
+ return {
131
+ ok: missingRequired.length === 0,
132
+ binDirs: config.binDirs,
133
+ cubeMxRoots: config.cubeMxRoots,
134
+ capabilities,
135
+ missingRequired,
136
+ tools: [...results],
137
+ message,
138
+ };
139
+ }
140
+ /** 面板点「探测工具链」:显式入参 > 环境变量 > 配置文件 > 默认值 + 自动发现。 */
141
+ export async function probeTools(payload, deps) {
142
+ const overrides = {};
143
+ if (payload["binDirs"] !== undefined) {
144
+ const binDirs = stringList(payload["binDirs"]);
145
+ if (binDirs === null)
146
+ return { ok: false, error: "binDirs 必须是字符串数组", summary: null };
147
+ if (binDirs.length > 0)
148
+ overrides.binDirs = binDirs;
149
+ }
150
+ if (payload["cubeMxRoot"] !== undefined) {
151
+ if (typeof payload["cubeMxRoot"] !== "string") {
152
+ return { ok: false, error: "cubeMxRoot 必须是字符串", summary: null };
153
+ }
154
+ const root = payload["cubeMxRoot"].trim();
155
+ if (root !== "")
156
+ overrides.cubeMxRoots = [root];
157
+ }
158
+ const config = resolveSearchConfig(envOf(deps), overrides);
159
+ const targets = buildTargets(config);
160
+ const options = deps.signal === undefined ? {} : { signal: deps.signal };
161
+ const results = await probeAll(deps.subprocess, targets, config, options);
162
+ return {
163
+ ok: true,
164
+ error: "",
165
+ summary: summarizeProbe(results, { binDirs: [...config.binDirs], cubeMxRoots: [...config.cubeMxRoots] }),
166
+ };
167
+ }
168
+ const INSTALL_LOG_LIMIT = 200;
169
+ const installTasks = new Map();
170
+ let installSeq = 0;
171
+ function newInstallTask() {
172
+ installSeq += 1;
173
+ const id = "install-" + String(Date.now()) + "-" + String(installSeq);
174
+ const task = { id, status: "running", startedAt: Date.now(), finishedAt: 0, lines: [], result: null, error: "" };
175
+ installTasks.set(id, task);
176
+ return task;
177
+ }
178
+ function appendLine(task, line) {
179
+ task.lines.push(line);
180
+ if (task.lines.length > INSTALL_LOG_LIMIT)
181
+ task.lines.splice(0, task.lines.length - INSTALL_LOG_LIMIT);
182
+ }
183
+ export function installTaskState(taskId) {
184
+ const task = installTasks.get(taskId);
185
+ if (task === undefined)
186
+ return null;
187
+ const result = task.result;
188
+ const message = task.status === "running"
189
+ ? "正在安装:步骤在跑,日志往下滚。"
190
+ : task.error !== ""
191
+ ? task.error
192
+ : result === null
193
+ ? ""
194
+ : result.message;
195
+ return {
196
+ taskId: task.id,
197
+ status: task.status,
198
+ lines: [...task.lines],
199
+ message,
200
+ steps: result === null
201
+ ? []
202
+ : result.steps.map((step) => ({ id: step.id, label: step.label, status: step.status, detail: step.detail })),
203
+ ok: result === null ? false : result.ok,
204
+ durationMs: (task.finishedAt === 0 ? Date.now() : task.finishedAt) - task.startedAt,
205
+ };
206
+ }
207
+ /** 计划模式:只算大小与步骤,零副作用(不下载、不建目录、不写注册表)。 */
208
+ export async function installPlan(payload, deps) {
209
+ const request = {
210
+ mode: "plan",
211
+ writePath: payload["writePath"] !== false,
212
+ };
213
+ if (payload["targetDir"] !== undefined) {
214
+ if (typeof payload["targetDir"] !== "string")
215
+ return { ok: false, error: "targetDir 必须是字符串", plan: null };
216
+ request.targetDir = payload["targetDir"].trim();
217
+ }
218
+ if (payload["packages"] !== undefined) {
219
+ const packages = packageList(payload["packages"]);
220
+ if (!packages.ok)
221
+ return { ok: false, error: packages.error, plan: null };
222
+ if (packages.packages.length > 0)
223
+ request.packages = packages.packages;
224
+ }
225
+ if (deps.signal !== undefined)
226
+ request.signal = deps.signal;
227
+ try {
228
+ const plan = await planOrInstallMsys2(deps.subprocess, request, envOf(deps));
229
+ return { ok: true, error: "", plan };
230
+ }
231
+ catch (error) {
232
+ return { ok: false, error: "出计划失败:" + describeError(error), plan: null };
233
+ }
234
+ }
235
+ /** 真装:立刻返回 taskId,安装跑在后台,面板轮询 install/state。 */
236
+ export function installStart(payload, deps) {
237
+ if (payload["confirm"] !== true) {
238
+ return { ok: false, error: "真装必须带 confirm:true(面板上要先点确认)", taskId: "" };
239
+ }
240
+ const request = { mode: "install", writePath: payload["writePath"] !== false };
241
+ if (payload["targetDir"] !== undefined) {
242
+ if (typeof payload["targetDir"] !== "string")
243
+ return { ok: false, error: "targetDir 必须是字符串", taskId: "" };
244
+ request.targetDir = payload["targetDir"].trim();
245
+ }
246
+ if (payload["packages"] !== undefined) {
247
+ const packages = packageList(payload["packages"]);
248
+ if (!packages.ok)
249
+ return { ok: false, error: packages.error, taskId: "" };
250
+ if (packages.packages.length > 0)
251
+ request.packages = packages.packages;
252
+ }
253
+ if (deps.signal !== undefined)
254
+ request.signal = deps.signal;
255
+ const task = newInstallTask();
256
+ const env = envOf(deps);
257
+ appendLine(task, "开始安装:" + new Date(task.startedAt).toLocaleTimeString());
258
+ void planOrInstallMsys2(deps.subprocess, { ...request, onProgress: (line) => appendLine(task, line) }, env)
259
+ .then((result) => {
260
+ task.result = result;
261
+ task.status = result.ok ? "done" : "failed";
262
+ task.error = result.ok ? "" : result.message;
263
+ appendLine(task, result.message);
264
+ })
265
+ .catch((error) => {
266
+ task.status = "failed";
267
+ task.error = "安装异常终止:" + describeError(error);
268
+ appendLine(task, task.error);
269
+ })
270
+ .finally(() => {
271
+ task.finishedAt = Date.now();
272
+ if (installTasks.size > 20) {
273
+ const oldest = [...installTasks.values()]
274
+ .sort((left, right) => left.startedAt - right.startedAt)
275
+ .slice(0, installTasks.size - 20);
276
+ for (const item of oldest)
277
+ installTasks.delete(item.id);
278
+ }
279
+ });
280
+ return { ok: true, error: "", taskId: task.id };
281
+ }
282
+ /* ---------------------------- 分发 ---------------------------- */
283
+ export const WEB_API_PREFIX = "/dsh-stm32/api";
284
+ export const WEB_API_PATHS = [
285
+ WEB_API_PREFIX + "/config",
286
+ WEB_API_PREFIX + "/config/save",
287
+ WEB_API_PREFIX + "/probe",
288
+ WEB_API_PREFIX + "/install/plan",
289
+ WEB_API_PREFIX + "/install/start",
290
+ WEB_API_PREFIX + "/install/state",
291
+ ];
292
+ function ok(body) {
293
+ return { status: 200, body: { ok: true, ...body } };
294
+ }
295
+ function fail(status, error) {
296
+ return { status, body: { ok: false, error } };
297
+ }
298
+ function parseJsonBody(text) {
299
+ if (text.trim() === "")
300
+ return { ok: true, value: {}, error: "" };
301
+ try {
302
+ const parsed = JSON.parse(text);
303
+ if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
304
+ return { ok: false, value: {}, error: "请求体必须是 JSON 对象" };
305
+ }
306
+ return { ok: true, value: parsed, error: "" };
307
+ }
308
+ catch (error) {
309
+ return { ok: false, value: {}, error: "请求体不是合法 JSON:" + describeError(error) };
310
+ }
311
+ }
312
+ /**
313
+ * 按路径分发。input.body 是原始文本(适配层读好的),input.query 已解析成普通对象。
314
+ * 未知路径 404、方法不对 405:面板出错时能立刻看出是哪一层的问题。
315
+ */
316
+ export async function handleWebApi(input) {
317
+ const method = input.method.toUpperCase();
318
+ const path = input.path.replace(/\/+$/u, "");
319
+ const query = input.query ?? {};
320
+ const needsBody = path !== WEB_API_PREFIX + "/config" && path !== WEB_API_PREFIX + "/install/state";
321
+ if (needsBody && method !== "POST")
322
+ return fail(405, "这个接口只接受 POST");
323
+ if (!needsBody && method !== "GET")
324
+ return fail(405, "这个接口只接受 GET");
325
+ const parsed = needsBody ? parseJsonBody(input.body ?? "") : { ok: true, value: {}, error: "" };
326
+ if (!parsed.ok)
327
+ return fail(400, parsed.error);
328
+ const env = envOf(input.deps);
329
+ if (path === WEB_API_PREFIX + "/config") {
330
+ return ok({ snapshot: configSnapshot(env) });
331
+ }
332
+ if (path === WEB_API_PREFIX + "/config/save") {
333
+ const saved = saveConfig(parsed.value, env);
334
+ if (!saved.ok)
335
+ return fail(400, saved.error);
336
+ return ok({ path: saved.path, config: saved.config, snapshot: configSnapshot(env) });
337
+ }
338
+ if (path === WEB_API_PREFIX + "/probe") {
339
+ try {
340
+ const probed = await probeTools(parsed.value, input.deps);
341
+ if (!probed.ok)
342
+ return fail(400, probed.error);
343
+ return ok({ summary: probed.summary });
344
+ }
345
+ catch (error) {
346
+ return fail(500, "探测失败:" + describeError(error));
347
+ }
348
+ }
349
+ if (path === WEB_API_PREFIX + "/install/plan") {
350
+ const planned = await installPlan(parsed.value, input.deps);
351
+ if (!planned.ok)
352
+ return fail(400, planned.error);
353
+ return ok({ plan: planned.plan });
354
+ }
355
+ if (path === WEB_API_PREFIX + "/install/start") {
356
+ const started = installStart(parsed.value, input.deps);
357
+ if (!started.ok)
358
+ return fail(400, started.error);
359
+ return ok({ taskId: started.taskId });
360
+ }
361
+ if (path === WEB_API_PREFIX + "/install/state") {
362
+ const taskId = query["taskId"] ?? "";
363
+ if (taskId === "")
364
+ return fail(400, "缺少 taskId");
365
+ const state = installTaskState(taskId);
366
+ if (state === null)
367
+ return fail(404, "没有这个安装任务:" + taskId);
368
+ return ok({ state });
369
+ }
370
+ return fail(404, "没有这个接口:" + path);
371
+ }
372
+ /** 单测用:清空安装任务表。 */
373
+ export function resetInstallTasks() {
374
+ installTasks.clear();
375
+ }
@@ -0,0 +1,100 @@
1
+ /**
2
+ * 把 web-api 的分发器接到宿主的 webServer 服务上。
3
+ *
4
+ * 这一层刻意只做四件事:拼 URL、读请求体、调分发给、写 JSON 响应。
5
+ * 参数校验、配置读写、探测、安装调度全在 web-api.ts 里,那边可以离线单测。
6
+ *
7
+ * 注册是"锦上添花"的层:宿主没组合 webServer 服务(例如纯 CLI 组合)时直接跳过,
8
+ * 工具与斜杠命令照常可用。
9
+ */
10
+ import { handleWebApi, WEB_API_PATHS } from "./web-api.js";
11
+ /** 请求体上限:面板最大的请求是配置对象,1 MB 已经非常宽松。 */
12
+ const MAX_BODY_BYTES = 1_000_000;
13
+ function readBody(request) {
14
+ return new Promise((resolve) => {
15
+ let text = "";
16
+ let done = false;
17
+ const finish = (value) => {
18
+ if (done)
19
+ return;
20
+ done = true;
21
+ resolve(value);
22
+ };
23
+ if (typeof request.on !== "function") {
24
+ finish("");
25
+ return;
26
+ }
27
+ request.on("data", (chunk) => {
28
+ text += String(chunk);
29
+ if (text.length > MAX_BODY_BYTES) {
30
+ text = text.slice(0, MAX_BODY_BYTES);
31
+ finish(text);
32
+ }
33
+ });
34
+ request.on("end", () => finish(text));
35
+ request.on("error", () => finish(text));
36
+ });
37
+ }
38
+ function parseUrl(rawUrl) {
39
+ const url = typeof rawUrl === "string" && rawUrl !== "" ? rawUrl : "/";
40
+ try {
41
+ const parsed = new URL(url, "http://127.0.0.1");
42
+ const query = {};
43
+ parsed.searchParams.forEach((value, key) => {
44
+ query[key] = value;
45
+ });
46
+ return { path: parsed.pathname, query };
47
+ }
48
+ catch {
49
+ return { path: url, query: {} };
50
+ }
51
+ }
52
+ function send(response, status, body) {
53
+ const text = JSON.stringify(body);
54
+ if (typeof response.writeHead === "function") {
55
+ response.writeHead(status, {
56
+ "content-type": "application/json; charset=utf-8",
57
+ "cache-control": "no-store",
58
+ "content-length": Buffer.byteLength(text),
59
+ });
60
+ }
61
+ if (typeof response.end === "function")
62
+ response.end(text);
63
+ }
64
+ export function registerWebRoutes(ctx) {
65
+ if (typeof ctx.inject !== "function")
66
+ return;
67
+ ctx.inject(["webServer"], (scope) => {
68
+ const server = scope.get("webServer");
69
+ const subprocess = scope.get("subprocess");
70
+ if (server === undefined || server === null || typeof server.register !== "function")
71
+ return;
72
+ if (subprocess === undefined || subprocess === null)
73
+ return;
74
+ const deps = { subprocess };
75
+ for (const path of WEB_API_PATHS) {
76
+ server.register({
77
+ kind: "exact",
78
+ path,
79
+ handler: async (request, response) => {
80
+ const url = parseUrl(request?.url);
81
+ const body = request?.method === "GET" ? "" : await readBody(request);
82
+ try {
83
+ const result = await handleWebApi({
84
+ method: String(request?.method ?? "GET"),
85
+ path: url.path,
86
+ query: url.query,
87
+ body,
88
+ deps,
89
+ });
90
+ send(response, result.status, result.body);
91
+ }
92
+ catch (error) {
93
+ const message = error instanceof Error ? error.message : String(error);
94
+ send(response, 500, { ok: false, error: "面板接口异常:" + message });
95
+ }
96
+ },
97
+ });
98
+ }
99
+ });
100
+ }
@@ -0,0 +1,102 @@
1
+ /**
2
+ * X-CUBE / I-CUBE 第三方包目录(快照)。
3
+ *
4
+ * 由 scripts/gen-xcube-catalog.mjs 从 CubeMX 的包索引目录生成,不要手改;想要最新的目录,重跑一次生成脚本。
5
+ *
6
+ * 来源:CubeMX 包索引 ~/.stm32cubemx/thirdparties/pdsc(159 个 .pdsc)
7
+ * 生成时间:2026-10-24T03:04:36.542Z
8
+ * 索引文件数:159(一个包的每个版本各占一个 .pdsc,所以文件数恒 ≥ 归并后的条目数;条目数看 XCUBE_CATALOG_ENTRY_COUNT)
9
+ *
10
+ * 用途:.ioc 里第三方包的身份有两种写法,都靠这张表认出来 ——
11
+ * Mcu.ThirdParty0=STMicroelectronics.X-CUBE-ALGOBUILD.1.4.0
12
+ * STMicroelectronics.X-CUBE-ALGOBUILD.1.4.0.IPParameters=...
13
+ * 有了目录才能判断这个工程到底用不用第三方包,进而决定 thirdparties/pdsc 要不要加载。
14
+ */
15
+ /**
16
+ * 生成这份快照时 CubeMX 包索引目录里的 .pdsc 文件数。
17
+ * 它和下面的条目数不是一回事:一个包有多个版本就多个文件,归并后只算一条,所以它 > 条目数。
18
+ */
19
+ export const XCUBE_CATALOG_FILE_COUNT = 159;
20
+ /** 生成时间(ISO 字符串)。 */
21
+ export const XCUBE_CATALOG_GENERATED_AT = "2026-10-24T03:04:36.542Z";
22
+ export const XCUBE_PACK_CATALOG = [
23
+ { vendor: "Avnet-IOTCONNECT", name: "X-CUBE-iotc-st67-sdk", versions: ["1.0.0"] },
24
+ { vendor: "Cesanta", name: "I-CUBE-Mongoose", versions: ["7.19.0"] },
25
+ { vendor: "EmbeddedOffice", name: "I-CUBE-FS-RTOS", versions: ["1.0.1"] },
26
+ { vendor: "emotas", name: "I-CUBE-CANOPEN", versions: ["1.3.0"] },
27
+ { vendor: "Infineon", name: "AIROC-Wi-Fi-Bluetooth-STM32", versions: ["1.7.1"] },
28
+ { vendor: "ITTIA_DB", name: "I-CUBE-ITTIADB", versions: ["8.9.0"] },
29
+ { vendor: "quantropi", name: "X-CUBE-qispace-sdk-base", versions: ["2.1.0"] },
30
+ { vendor: "RealThread", name: "X-CUBE-RT-Thread_Nano", versions: ["4.1.1"] },
31
+ { vendor: "SEGGER", name: "I-CUBE-embOS", versions: ["1.3.1"] },
32
+ { vendor: "STMicroelectronics", name: "eDS-WB_DPC_3PH2L-BIDIR", versions: ["1.1.1"] },
33
+ { vendor: "STMicroelectronics", name: "eDS-WB_DPC_TT-BIDIR", versions: ["2.1.1"] },
34
+ { vendor: "STMicroelectronics", name: "eDS-WB_DPC_VIENNA", versions: ["1.2.0"] },
35
+ { vendor: "STMicroelectronics", name: "FP-ATR-ASTRA1", versions: ["2.0.2", "2.0.3"] },
36
+ { vendor: "STMicroelectronics", name: "FP-ATR-SIGFOX1", versions: ["3.2.0"] },
37
+ { vendor: "STMicroelectronics", name: "FP-SNS-FLIGHT1", versions: ["5.1.0"] },
38
+ { vendor: "STMicroelectronics", name: "FP-SNS-MOTENV1", versions: ["5.1.0"] },
39
+ { vendor: "STMicroelectronics", name: "FP-SNS-MOTENVWB1", versions: ["1.4.0", "1.5.0"] },
40
+ { vendor: "STMicroelectronics", name: "FP-SNS-SMARTAG2", versions: ["1.2.0"] },
41
+ { vendor: "STMicroelectronics", name: "FP-SNS-STAIOTCFT", versions: ["1.0.0", "1.1.0", "2.0.0"] },
42
+ { vendor: "STMicroelectronics", name: "FP-SNS-STBOX1", versions: ["2.1.0"] },
43
+ { vendor: "STMicroelectronics", name: "X-CUBE-AI", versions: ["10.2.0", "10.2.1"] },
44
+ { vendor: "STMicroelectronics", name: "X-CUBE-ALGOBUILD", versions: ["1.4.0", "1.5.0"] },
45
+ { vendor: "STMicroelectronics", name: "X-CUBE-ALS", versions: ["1.0.2"] },
46
+ { vendor: "STMicroelectronics", name: "X-CUBE-AZRTOS-F4", versions: ["1.1.0"] },
47
+ { vendor: "STMicroelectronics", name: "X-CUBE-AZRTOS-F7", versions: ["1.1.0"] },
48
+ { vendor: "STMicroelectronics", name: "X-CUBE-AZRTOS-G0", versions: ["1.1.0"] },
49
+ { vendor: "STMicroelectronics", name: "X-CUBE-AZRTOS-G4", versions: ["2.0.0"] },
50
+ { vendor: "STMicroelectronics", name: "X-CUBE-AZRTOS-H7", versions: ["3.4.0", "3.5.0"] },
51
+ { vendor: "STMicroelectronics", name: "X-CUBE-AZRTOS-H7RS", versions: ["1.1.0", "1.2.0", "1.3.0"] },
52
+ { vendor: "STMicroelectronics", name: "X-CUBE-AZRTOS-L4", versions: ["2.0.0"] },
53
+ { vendor: "STMicroelectronics", name: "X-CUBE-AZRTOS-L5", versions: ["2.0.0"] },
54
+ { vendor: "STMicroelectronics", name: "X-CUBE-AZRTOS-WB", versions: ["2.0.0"] },
55
+ { vendor: "STMicroelectronics", name: "X-CUBE-AZRTOS-WL", versions: ["2.0.0"] },
56
+ { vendor: "STMicroelectronics", name: "X-CUBE-BLE1", versions: ["7.1.0"] },
57
+ { vendor: "STMicroelectronics", name: "X-CUBE-BLE2", versions: ["3.3.0"] },
58
+ { vendor: "STMicroelectronics", name: "X-CUBE-BLEMGR", versions: ["4.1.0", "4.2.0"] },
59
+ { vendor: "STMicroelectronics", name: "X-CUBE-DISPLAY", versions: ["3.0.0"] },
60
+ { vendor: "STMicroelectronics", name: "X-CUBE-DPower", versions: ["1.3.0"] },
61
+ { vendor: "STMicroelectronics", name: "X-CUBE-EEPRMA1", versions: ["5.2.0"] },
62
+ { vendor: "STMicroelectronics", name: "X-CUBE-FREERTOS", versions: ["1.3.1", "1.4.0", "1.5.0", "1.6.0"] },
63
+ { vendor: "STMicroelectronics", name: "X-CUBE-GNSS1", versions: ["7.1.0", "7.1.1"] },
64
+ { vendor: "STMicroelectronics", name: "X-CUBE-IPS", versions: ["3.2.0"] },
65
+ { vendor: "STMicroelectronics", name: "X-CUBE-ISPU", versions: ["2.1.0"] },
66
+ { vendor: "STMicroelectronics", name: "X-CUBE-MEMS1", versions: ["11.3.0", "12.0.0", "12.1.0", "13.0.0"] },
67
+ { vendor: "STMicroelectronics", name: "X-CUBE-NFC10", versions: ["1.0.0"] },
68
+ { vendor: "STMicroelectronics", name: "X-CUBE-NFC12", versions: ["1.0.0"] },
69
+ { vendor: "STMicroelectronics", name: "X-CUBE-NFC13", versions: ["1.0.0"] },
70
+ { vendor: "STMicroelectronics", name: "X-CUBE-NFC4", versions: ["3.0.0"] },
71
+ { vendor: "STMicroelectronics", name: "X-CUBE-NFC6", versions: ["3.1.0", "3.2.0"] },
72
+ { vendor: "STMicroelectronics", name: "X-CUBE-NFC7", versions: ["2.0.0"] },
73
+ { vendor: "STMicroelectronics", name: "X-CUBE-NFC9", versions: ["1.0.0"] },
74
+ { vendor: "STMicroelectronics", name: "X-CUBE-PM33A1", versions: ["1.0.0"] },
75
+ { vendor: "STMicroelectronics", name: "X-CUBE-SFXS2LP1", versions: ["4.0.0"] },
76
+ { vendor: "STMicroelectronics", name: "X-CUBE-SMBUS", versions: ["2.1.0", "2.1.1"] },
77
+ { vendor: "STMicroelectronics", name: "X-CUBE-ST60", versions: ["1.1.0"] },
78
+ { vendor: "STMicroelectronics", name: "X-CUBE-ST67W61", versions: ["1.1.0", "1.2.0", "1.3.0"] },
79
+ { vendor: "STMicroelectronics", name: "X-CUBE-STSE01", versions: ["1.0.0", "2.0.0"] },
80
+ { vendor: "STMicroelectronics", name: "X-CUBE-SUBG2", versions: ["5.0.0"] },
81
+ { vendor: "STMicroelectronics", name: "X-CUBE-TCPP", versions: ["4.2.0"] },
82
+ { vendor: "STMicroelectronics", name: "X-CUBE-TOF1", versions: ["3.4.3"] },
83
+ { vendor: "STMicroelectronics", name: "X-CUBE-TOUCHGFX", versions: ["4.26.0", "4.26.1", "4.27.0"] },
84
+ { vendor: "STMicroelectronics", name: "X-CUBE-WB05N", versions: ["2.0.0", "2.1.0"] },
85
+ { vendor: "STMicroelectronics", name: "X-CUBE-WBA", versions: ["1.1.0"] },
86
+ { vendor: "wolfSSL", name: "I-CUBE-wolfMQTT", versions: ["1.19.2"] },
87
+ { vendor: "wolfSSL", name: "I-CUBE-wolfSSH", versions: ["1.4.20"] },
88
+ { vendor: "wolfSSL", name: "I-CUBE-wolfSSL", versions: ["5.8.2"] },
89
+ { vendor: "wolfSSL", name: "I-CUBE-wolfTPM", versions: ["3.8.0"] },
90
+ ];
91
+ /**
92
+ * 快照里的包条目数(归并后)。
93
+ * 由数组长度派生而不是另写一个常量:手写的数字迟早会和数组对不上,
94
+ * 报告里就会出现"收录 159 条"但实际只能匹配 67 条的自相矛盾(审计 A23)。
95
+ */
96
+ export const XCUBE_CATALOG_ENTRY_COUNT = XCUBE_PACK_CATALOG.length;
97
+ /** 快照来源(进报告 notes,便于判断新旧)。两个数字都从上面的常量派生,重跑生成脚本不会漂。 */
98
+ export const XCUBE_CATALOG_SOURCE = "CubeMX 包索引 ~/.stm32cubemx/thirdparties/pdsc(上游 "
99
+ + String(XCUBE_CATALOG_FILE_COUNT)
100
+ + " 个 .pdsc,归并成 "
101
+ + String(XCUBE_CATALOG_ENTRY_COUNT)
102
+ + " 个包)";