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
|
@@ -0,0 +1,254 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* L1:第三方包(X-CUBE / I-CUBE)身份识别。
|
|
3
|
+
*
|
|
4
|
+
* 为什么要有这张表:判断「这个工程要不要 thirdparties/pdsc」有两件事要做对 ——
|
|
5
|
+
* 1. 认得出 .ioc 里用的是什么包。CubeMX 写的是 `Mcu.ThirdParty0=STMicroelectronics.X-CUBE-ALGOBUILD.1.4.0`,
|
|
6
|
+
* 形如 <vendor>.<pack>.<version>,与 pdsc 文件名(<vendor>.<pack>[.<version>].pdsc)同构;
|
|
7
|
+
* 2. 说得清本机有没有这个包。目录里的 159 个 .pdsc 就是 CubeMX 能加载的全部索引。
|
|
8
|
+
*
|
|
9
|
+
* 所以:包目录由 scripts/gen-xcube-catalog.mjs 从 CubeMX 的 pdsc 目录生成成快照(xcube-catalog.ts),
|
|
10
|
+
* 这里负责把 .ioc 文本解析成包引用、再跟「本机索引」和「程序里的快照」对一遍。
|
|
11
|
+
*
|
|
12
|
+
* 不变量:认不出就保守(宁可多加载 25 s 的索引,也不要漏包生成错代码)。
|
|
13
|
+
*/
|
|
14
|
+
import { readdirSync } from "node:fs";
|
|
15
|
+
import { XCUBE_PACK_CATALOG } from "./xcube-catalog.js";
|
|
16
|
+
/** 原始行截断长度(进证据/报错,别把一整行 5 KB 的键塞进去)。 */
|
|
17
|
+
const MAX_RAW = 160;
|
|
18
|
+
/** 证据里最多列几个包。 */
|
|
19
|
+
const MAX_LISTED_PACKS = 3;
|
|
20
|
+
/** 目录条目按 vendor.name 长度降序:先匹配更长的包名,免得 X-CUBE-AI 抢走 X-CUBE-AI-xxx 的行。 */
|
|
21
|
+
const BY_LENGTH = XCUBE_PACK_CATALOG.slice().sort((a, b) => b.vendor.length + b.name.length - (a.vendor.length + a.name.length));
|
|
22
|
+
function isNumericSegment(text) {
|
|
23
|
+
return text !== undefined && /^[0-9]+$/u.test(text);
|
|
24
|
+
}
|
|
25
|
+
function clip(text) {
|
|
26
|
+
return text.length > MAX_RAW ? text.slice(0, MAX_RAW) + "…" : text;
|
|
27
|
+
}
|
|
28
|
+
/** 在快照里按 vendor + name 找包(大小写不敏感)。 */
|
|
29
|
+
export function findCatalogPack(vendor, name) {
|
|
30
|
+
const v = vendor.toLowerCase();
|
|
31
|
+
const n = name.toLowerCase();
|
|
32
|
+
for (const entry of XCUBE_PACK_CATALOG) {
|
|
33
|
+
if (entry.vendor.toLowerCase() === v && entry.name.toLowerCase() === n)
|
|
34
|
+
return entry;
|
|
35
|
+
}
|
|
36
|
+
return null;
|
|
37
|
+
}
|
|
38
|
+
/** 人读的包名:STMicroelectronics.X-CUBE-ALGOBUILD 1.4.0。 */
|
|
39
|
+
export function describePack(ref) {
|
|
40
|
+
const id = ref.vendor + "." + ref.name;
|
|
41
|
+
return ref.requestedVersion === null ? id : id + " " + ref.requestedVersion;
|
|
42
|
+
}
|
|
43
|
+
/** 把 pdsc 文件名解析成包列表(规则与 scripts/gen-xcube-catalog.mjs 一致,测试会对齐两边)。 */
|
|
44
|
+
export function parsePdscNames(names) {
|
|
45
|
+
const map = new Map();
|
|
46
|
+
for (const fileName of names) {
|
|
47
|
+
if (!fileName.toLowerCase().endsWith(".pdsc"))
|
|
48
|
+
continue;
|
|
49
|
+
const stem = fileName.slice(0, -".pdsc".length);
|
|
50
|
+
const dot = stem.indexOf(".");
|
|
51
|
+
if (dot <= 0)
|
|
52
|
+
continue;
|
|
53
|
+
const vendor = stem.slice(0, dot);
|
|
54
|
+
const segments = stem.slice(dot + 1).split(".");
|
|
55
|
+
const versionParts = [];
|
|
56
|
+
while (segments.length > 1 && isNumericSegment(segments[segments.length - 1])) {
|
|
57
|
+
const popped = segments.pop();
|
|
58
|
+
if (popped === undefined)
|
|
59
|
+
break;
|
|
60
|
+
versionParts.unshift(popped);
|
|
61
|
+
}
|
|
62
|
+
const name = segments.join(".");
|
|
63
|
+
if (name === "")
|
|
64
|
+
continue;
|
|
65
|
+
const key = (vendor + "." + name).toLowerCase();
|
|
66
|
+
const entry = map.get(key) ?? { vendor, name, versions: [] };
|
|
67
|
+
const version = versionParts.length > 0 ? versionParts.join(".") : null;
|
|
68
|
+
if (version !== null && !entry.versions.includes(version))
|
|
69
|
+
entry.versions.push(version);
|
|
70
|
+
map.set(key, entry);
|
|
71
|
+
}
|
|
72
|
+
return [...map.values()].sort((a, b) => (a.vendor + "." + a.name).localeCompare(b.vendor + "." + b.name));
|
|
73
|
+
}
|
|
74
|
+
/** 读本机 pdsc 索引目录;读不到返回 null(调用方按 unknown 处理)。 */
|
|
75
|
+
export function listInstalledPacks(pdscDir) {
|
|
76
|
+
try {
|
|
77
|
+
return parsePdscNames(readdirSync(pdscDir));
|
|
78
|
+
}
|
|
79
|
+
catch {
|
|
80
|
+
return null;
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
/** 把 `Vendor.Pack[.version]` 拆成三段;认不出来返回 null。 */
|
|
84
|
+
export function identifyPackId(value) {
|
|
85
|
+
const id = value.trim();
|
|
86
|
+
if (id === "" || id.includes(" "))
|
|
87
|
+
return null;
|
|
88
|
+
const lower = id.toLowerCase();
|
|
89
|
+
for (const entry of BY_LENGTH) {
|
|
90
|
+
const prefix = (entry.vendor + "." + entry.name).toLowerCase();
|
|
91
|
+
if (!lower.startsWith(prefix))
|
|
92
|
+
continue;
|
|
93
|
+
const rest = id.slice(prefix.length);
|
|
94
|
+
if (rest === "")
|
|
95
|
+
return { vendor: entry.vendor, name: entry.name, version: null };
|
|
96
|
+
if (!rest.startsWith("."))
|
|
97
|
+
continue;
|
|
98
|
+
const version = rest.slice(1);
|
|
99
|
+
if (version === "" || /\s/u.test(version))
|
|
100
|
+
return null;
|
|
101
|
+
return { vendor: entry.vendor, name: entry.name, version };
|
|
102
|
+
}
|
|
103
|
+
// 目录里没有的包(私有包 / 新包):第一段当 vendor、结尾纯数字段当版本,剩下的都算包名。
|
|
104
|
+
const segments = id.split(".");
|
|
105
|
+
if (segments.length < 2 || segments[0] === "" || segments[1] === "")
|
|
106
|
+
return null;
|
|
107
|
+
const versionParts = [];
|
|
108
|
+
while (segments.length > 2 && isNumericSegment(segments[segments.length - 1])) {
|
|
109
|
+
const popped = segments.pop();
|
|
110
|
+
if (popped === undefined)
|
|
111
|
+
break;
|
|
112
|
+
versionParts.unshift(popped);
|
|
113
|
+
}
|
|
114
|
+
const vendor = segments[0];
|
|
115
|
+
if (vendor === undefined)
|
|
116
|
+
return null;
|
|
117
|
+
return {
|
|
118
|
+
vendor,
|
|
119
|
+
name: segments.slice(1).join("."),
|
|
120
|
+
version: versionParts.length > 0 ? versionParts.join(".") : null,
|
|
121
|
+
};
|
|
122
|
+
}
|
|
123
|
+
function versionsOf(installed, vendor, name) {
|
|
124
|
+
if (installed === null)
|
|
125
|
+
return null;
|
|
126
|
+
const v = vendor.toLowerCase();
|
|
127
|
+
const n = name.toLowerCase();
|
|
128
|
+
for (const pack of installed) {
|
|
129
|
+
if (pack.vendor.toLowerCase() === v && pack.name.toLowerCase() === n)
|
|
130
|
+
return pack.versions;
|
|
131
|
+
}
|
|
132
|
+
return [];
|
|
133
|
+
}
|
|
134
|
+
function installStatus(versions, requested) {
|
|
135
|
+
if (versions === null)
|
|
136
|
+
return "unknown";
|
|
137
|
+
if (versions.length === 0)
|
|
138
|
+
return "missing";
|
|
139
|
+
if (requested === null)
|
|
140
|
+
return "exact";
|
|
141
|
+
return versions.includes(requested) ? "exact" : "other-version";
|
|
142
|
+
}
|
|
143
|
+
/** 在一行里找「目录里的 vendor.name」,返回命中的条目与紧随其后的版本号。 */
|
|
144
|
+
function packOnLine(line) {
|
|
145
|
+
const lower = line.toLowerCase();
|
|
146
|
+
for (const entry of BY_LENGTH) {
|
|
147
|
+
const prefix = (entry.vendor + "." + entry.name).toLowerCase();
|
|
148
|
+
const at = lower.indexOf(prefix);
|
|
149
|
+
if (at < 0)
|
|
150
|
+
continue;
|
|
151
|
+
const rest = line.slice(at + prefix.length);
|
|
152
|
+
const version = /^\.([0-9]+(?:\.[0-9]+)*)/u.exec(rest);
|
|
153
|
+
const captured = version === null ? undefined : version[1];
|
|
154
|
+
return { entry, version: captured === undefined ? null : captured };
|
|
155
|
+
}
|
|
156
|
+
return null;
|
|
157
|
+
}
|
|
158
|
+
/** 一行里是否出现了目录包名(哪怕凑不出 vendor,例如 X-CUBE-AI-demo)。 */
|
|
159
|
+
function barePackNameOnLine(line) {
|
|
160
|
+
const lower = line.toLowerCase();
|
|
161
|
+
for (const entry of BY_LENGTH) {
|
|
162
|
+
if (lower.includes(entry.name.toLowerCase()))
|
|
163
|
+
return entry.name;
|
|
164
|
+
}
|
|
165
|
+
return null;
|
|
166
|
+
}
|
|
167
|
+
/**
|
|
168
|
+
* 扫描 .ioc 正文,找出第三方包引用与 Mcu.ThirdPartyNb。
|
|
169
|
+
*
|
|
170
|
+
* 判定顺序:Mcu.ThirdPartyNb → Mcu.ThirdParty<k>(权威)→ 任意行里的 vendor.name → 任意行里的裸包名。
|
|
171
|
+
*/
|
|
172
|
+
export function scanIocPacks(iocText, options = {}) {
|
|
173
|
+
const installed = options.installed ?? null;
|
|
174
|
+
const packs = [];
|
|
175
|
+
const byId = new Map();
|
|
176
|
+
const markers = [];
|
|
177
|
+
const malformed = [];
|
|
178
|
+
let thirdPartyNb = null;
|
|
179
|
+
let nbLine = null;
|
|
180
|
+
const add = (vendor, name, version, raw) => {
|
|
181
|
+
const key = (vendor + "." + name).toLowerCase();
|
|
182
|
+
const existing = byId.get(key);
|
|
183
|
+
if (existing !== undefined) {
|
|
184
|
+
// 同一包可能出现在 Mcu.ThirdParty0 与 STMicroelectronics.X-CUBE-X.Y.Z.IPParameters 两处;补全版本即可。
|
|
185
|
+
// 证据优先留 Mcu.ThirdParty<k> 这种「声明行」,比 VP_/IPParameters 行更好读。
|
|
186
|
+
if (/^Mcu\.ThirdParty[0-9]+\s*=/u.test(raw) && !/^Mcu\.ThirdParty[0-9]+\s*=/u.test(existing.raw)) {
|
|
187
|
+
existing.raw = clip(raw);
|
|
188
|
+
}
|
|
189
|
+
if (existing.requestedVersion === null && version !== null) {
|
|
190
|
+
const versions = versionsOf(installed, vendor, name);
|
|
191
|
+
existing.requestedVersion = version;
|
|
192
|
+
existing.installed = installStatus(versions, version);
|
|
193
|
+
}
|
|
194
|
+
return;
|
|
195
|
+
}
|
|
196
|
+
const versions = versionsOf(installed, vendor, name);
|
|
197
|
+
const ref = {
|
|
198
|
+
raw: clip(raw),
|
|
199
|
+
vendor,
|
|
200
|
+
name,
|
|
201
|
+
requestedVersion: version,
|
|
202
|
+
installed: installStatus(versions, version),
|
|
203
|
+
installedVersions: versions ?? [],
|
|
204
|
+
};
|
|
205
|
+
byId.set(key, ref);
|
|
206
|
+
packs.push(ref);
|
|
207
|
+
};
|
|
208
|
+
for (const raw of iocText.split(/\r?\n/u)) {
|
|
209
|
+
const line = raw.trim();
|
|
210
|
+
if (line === "" || line.startsWith("#") || line.startsWith(";"))
|
|
211
|
+
continue;
|
|
212
|
+
const nb = /^Mcu\.ThirdPartyNb\s*=\s*(-?[0-9]+)\s*$/u.exec(line);
|
|
213
|
+
if (nb !== null) {
|
|
214
|
+
const digits = nb[1];
|
|
215
|
+
const parsed = digits === undefined ? null : Number(digits);
|
|
216
|
+
thirdPartyNb = parsed;
|
|
217
|
+
if (parsed !== null && parsed > 0)
|
|
218
|
+
nbLine = clip(line);
|
|
219
|
+
continue;
|
|
220
|
+
}
|
|
221
|
+
// 值可能是空的(Mcu.ThirdParty0=),那也算解析不了 —— 保守一点,宁可加载索引。
|
|
222
|
+
const declared = /^Mcu\.ThirdParty[0-9]+\s*=\s*(.*)$/u.exec(line);
|
|
223
|
+
if (declared !== null) {
|
|
224
|
+
const value = declared[1];
|
|
225
|
+
if (value === undefined) {
|
|
226
|
+
malformed.push(clip(line));
|
|
227
|
+
continue;
|
|
228
|
+
}
|
|
229
|
+
const id = identifyPackId(value.trim());
|
|
230
|
+
if (id === null) {
|
|
231
|
+
malformed.push(clip(line));
|
|
232
|
+
}
|
|
233
|
+
else {
|
|
234
|
+
add(id.vendor, id.name, id.version, line);
|
|
235
|
+
}
|
|
236
|
+
continue;
|
|
237
|
+
}
|
|
238
|
+
const found = packOnLine(line);
|
|
239
|
+
if (found !== null) {
|
|
240
|
+
add(found.entry.vendor, found.entry.name, found.version, line);
|
|
241
|
+
continue;
|
|
242
|
+
}
|
|
243
|
+
if (barePackNameOnLine(line) !== null && markers.length < MAX_LISTED_PACKS)
|
|
244
|
+
markers.push(clip(line));
|
|
245
|
+
}
|
|
246
|
+
return { thirdPartyNb, nbLine, packs, markers, malformed };
|
|
247
|
+
}
|
|
248
|
+
/** 把包列表写成一句话(证据/原因里用)。 */
|
|
249
|
+
export function summarizePacks(packs) {
|
|
250
|
+
if (packs.length === 0)
|
|
251
|
+
return "";
|
|
252
|
+
const listed = packs.slice(0, MAX_LISTED_PACKS).map(describePack).join("、");
|
|
253
|
+
return packs.length > MAX_LISTED_PACKS ? listed + " 等 " + String(packs.length) + " 个" : listed;
|
|
254
|
+
}
|
|
@@ -0,0 +1,142 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* L0:最小 zip 写入器(store,不压缩)—— 专门给 stm32_project_export 用。
|
|
3
|
+
*
|
|
4
|
+
* 为什么自己写而不用依赖:插件承诺零运行时依赖,为一个导出功能引 jszip/adm-zip 不值;
|
|
5
|
+
* 固件工程以文本为主,store 体积可接受(源码包本来就不大)。CRC32 用查表法。
|
|
6
|
+
*/
|
|
7
|
+
import { createWriteStream, readFileSync } from "node:fs";
|
|
8
|
+
/** CRC32(IEEE 0xEDB88320,查表法)。 */
|
|
9
|
+
const CRC_TABLE = (() => {
|
|
10
|
+
const table = new Uint32Array(256);
|
|
11
|
+
for (let n = 0; n < 256; n += 1) {
|
|
12
|
+
let c = n;
|
|
13
|
+
for (let k = 0; k < 8; k += 1)
|
|
14
|
+
c = c & 1 ? 0xedb88320 ^ (c >>> 1) : c >>> 1;
|
|
15
|
+
table[n] = c >>> 0;
|
|
16
|
+
}
|
|
17
|
+
return table;
|
|
18
|
+
})();
|
|
19
|
+
export function crc32(buffer) {
|
|
20
|
+
let crc = 0xffffffff;
|
|
21
|
+
for (const byte of buffer) {
|
|
22
|
+
// Uint32Array 的索引读回 number | undefined(noUncheckedIndexedAccess);下标恒在 0..255。
|
|
23
|
+
const table = CRC_TABLE[(crc ^ byte) & 0xff];
|
|
24
|
+
crc = ((table === undefined ? 0 : table) ^ (crc >>> 8)) >>> 0;
|
|
25
|
+
}
|
|
26
|
+
return (crc ^ 0xffffffff) >>> 0;
|
|
27
|
+
}
|
|
28
|
+
/** 当前时间 → DOS 时间字段。 */
|
|
29
|
+
function dosTime(date) {
|
|
30
|
+
const time = (date.getHours() << 11) | (date.getMinutes() << 5) | Math.floor(date.getSeconds() / 2);
|
|
31
|
+
const day = ((date.getFullYear() - 1980) << 9) | ((date.getMonth() + 1) << 5) | date.getDate();
|
|
32
|
+
return { time, date: day };
|
|
33
|
+
}
|
|
34
|
+
/**
|
|
35
|
+
* 写一个 store-only zip。sources: 条目名 → 磁盘路径;
|
|
36
|
+
* 值以 `__inline__\n` 开头时表示内容就是那个字符串本身(README 用)。
|
|
37
|
+
*/
|
|
38
|
+
export async function makeZip(outPath, sources) {
|
|
39
|
+
const chunks = [];
|
|
40
|
+
const entries = [];
|
|
41
|
+
let offset = 0;
|
|
42
|
+
const push = (buffer) => {
|
|
43
|
+
chunks.push(buffer);
|
|
44
|
+
offset += buffer.length;
|
|
45
|
+
};
|
|
46
|
+
const localHeader = (nameBuf, crc, bytes, time, date) => {
|
|
47
|
+
const header = Buffer.alloc(30);
|
|
48
|
+
header.writeUInt32LE(0x04034b50, 0);
|
|
49
|
+
header.writeUInt16LE(20, 4);
|
|
50
|
+
header.writeUInt16LE(0, 6);
|
|
51
|
+
header.writeUInt16LE(0, 8);
|
|
52
|
+
header.writeUInt16LE(time, 10);
|
|
53
|
+
header.writeUInt16LE(date, 12);
|
|
54
|
+
header.writeUInt32LE(crc, 14);
|
|
55
|
+
header.writeUInt32LE(bytes, 18);
|
|
56
|
+
header.writeUInt32LE(bytes, 22);
|
|
57
|
+
header.writeUInt16LE(nameBuf.length, 26);
|
|
58
|
+
header.writeUInt16LE(0, 28);
|
|
59
|
+
return header;
|
|
60
|
+
};
|
|
61
|
+
const now = new Date();
|
|
62
|
+
const { time, date } = dosTime(now);
|
|
63
|
+
for (const [name, source] of sources) {
|
|
64
|
+
const isInline = source.startsWith("__inline__\n");
|
|
65
|
+
const data = isInline ? Buffer.from(source.slice("__inline__\n".length), "utf8") : readFileSync(source);
|
|
66
|
+
const crc = crc32(data);
|
|
67
|
+
const nameBuf = Buffer.from(name, "utf8");
|
|
68
|
+
const header = localHeader(nameBuf, crc, data.length, time, date);
|
|
69
|
+
entries.push({ name, crc, bytes: data.length, offset });
|
|
70
|
+
push(header);
|
|
71
|
+
push(nameBuf);
|
|
72
|
+
push(data);
|
|
73
|
+
}
|
|
74
|
+
const centralStart = offset;
|
|
75
|
+
for (const entry of entries) {
|
|
76
|
+
const nameBuf = Buffer.from(entry.name, "utf8");
|
|
77
|
+
const central = Buffer.alloc(46);
|
|
78
|
+
central.writeUInt32LE(0x02014b50, 0);
|
|
79
|
+
central.writeUInt16LE(20, 4);
|
|
80
|
+
central.writeUInt16LE(20, 6);
|
|
81
|
+
central.writeUInt16LE(0, 8);
|
|
82
|
+
central.writeUInt16LE(0, 10);
|
|
83
|
+
central.writeUInt16LE(time, 12);
|
|
84
|
+
central.writeUInt16LE(date, 14);
|
|
85
|
+
central.writeUInt32LE(entry.crc, 16);
|
|
86
|
+
central.writeUInt32LE(entry.bytes, 20);
|
|
87
|
+
central.writeUInt32LE(entry.bytes, 24);
|
|
88
|
+
central.writeUInt16LE(nameBuf.length, 28);
|
|
89
|
+
central.writeUInt16LE(0, 30);
|
|
90
|
+
central.writeUInt16LE(0, 32);
|
|
91
|
+
central.writeUInt16LE(0, 34);
|
|
92
|
+
central.writeUInt16LE(0, 36);
|
|
93
|
+
central.writeUInt32LE(0, 38);
|
|
94
|
+
central.writeUInt32LE(entry.offset, 42);
|
|
95
|
+
push(central);
|
|
96
|
+
push(nameBuf);
|
|
97
|
+
}
|
|
98
|
+
const end = Buffer.alloc(22);
|
|
99
|
+
end.writeUInt32LE(0x06054b50, 0);
|
|
100
|
+
end.writeUInt16LE(0, 4);
|
|
101
|
+
end.writeUInt16LE(0, 6);
|
|
102
|
+
end.writeUInt16LE(entries.length, 8);
|
|
103
|
+
end.writeUInt16LE(entries.length, 10);
|
|
104
|
+
end.writeUInt32LE(offset - centralStart, 12);
|
|
105
|
+
end.writeUInt32LE(centralStart, 16);
|
|
106
|
+
end.writeUInt16LE(0, 20);
|
|
107
|
+
push(end);
|
|
108
|
+
await new Promise((resolve, reject) => {
|
|
109
|
+
const stream = createWriteStream(outPath);
|
|
110
|
+
stream.on("error", reject);
|
|
111
|
+
stream.on("finish", () => resolve());
|
|
112
|
+
for (const chunk of chunks)
|
|
113
|
+
stream.write(chunk);
|
|
114
|
+
stream.end();
|
|
115
|
+
});
|
|
116
|
+
}
|
|
117
|
+
/** 解包对账用(测试断言用;不带压缩支持,只认 store)。 */
|
|
118
|
+
export function listZipEntries(buffer) {
|
|
119
|
+
const names = [];
|
|
120
|
+
// 找 EOCD(从尾部扫描)
|
|
121
|
+
let eocd = -1;
|
|
122
|
+
for (let i = buffer.length - 22; i >= 0; i -= 1) {
|
|
123
|
+
if (buffer.readUInt32LE(i) === 0x06054b50) {
|
|
124
|
+
eocd = i;
|
|
125
|
+
break;
|
|
126
|
+
}
|
|
127
|
+
}
|
|
128
|
+
if (eocd < 0)
|
|
129
|
+
return names;
|
|
130
|
+
const count = buffer.readUInt16LE(eocd + 10);
|
|
131
|
+
let pointer = buffer.readUInt32LE(eocd + 16);
|
|
132
|
+
for (let n = 0; n < count; n += 1) {
|
|
133
|
+
if (buffer.readUInt32LE(pointer) !== 0x02014b50)
|
|
134
|
+
break;
|
|
135
|
+
const nameLength = buffer.readUInt16LE(pointer + 28);
|
|
136
|
+
names.push(buffer.toString("utf8", pointer + 46, pointer + 46 + nameLength));
|
|
137
|
+
const extra = buffer.readUInt16LE(pointer + 30);
|
|
138
|
+
const comment = buffer.readUInt16LE(pointer + 32);
|
|
139
|
+
pointer += 46 + nameLength + extra + comment;
|
|
140
|
+
}
|
|
141
|
+
return names;
|
|
142
|
+
}
|
package/lib/index.js
CHANGED
|
@@ -14,23 +14,58 @@ import { registerCommands } from "./commands/register.js";
|
|
|
14
14
|
import { debugSessions } from "./engine/debug-session.js";
|
|
15
15
|
import { registerStm32Skill } from "./skill/stm32-workflow.js";
|
|
16
16
|
import { registerBuild } from "./tools/build.js";
|
|
17
|
+
import { registerCache } from "./tools/cache.js";
|
|
17
18
|
import { registerCodePatch } from "./tools/code-patch.js";
|
|
18
19
|
import { registerDebugRun } from "./tools/debug.js";
|
|
19
20
|
import { registerDebugSession } from "./tools/debug-session.js";
|
|
20
21
|
import { registerDoctor } from "./tools/doctor.js";
|
|
22
|
+
import { registerEnvInstall } from "./tools/env-install.js";
|
|
21
23
|
import { registerEnvProbe } from "./tools/env-probe.js";
|
|
24
|
+
import { registerFirmwareInstall } from "./tools/firmware-install.js";
|
|
22
25
|
import { registerFlash } from "./tools/flash.js";
|
|
23
26
|
import { registerGenerate } from "./tools/generate.js";
|
|
24
27
|
import { registerIocApply } from "./tools/ioc-apply.js";
|
|
25
28
|
import { registerIocInspect } from "./tools/ioc-inspect.js";
|
|
26
29
|
import { registerIocPlan } from "./tools/ioc-plan.js";
|
|
27
30
|
import { registerProjectCreate } from "./tools/project-create.js";
|
|
31
|
+
import { registerProjectExport } from "./tools/project-export.js";
|
|
28
32
|
import { registerRegsRead } from "./tools/regs.js";
|
|
33
|
+
import { registerRoutePlan } from "./tools/route-plan.js";
|
|
34
|
+
import { registerWebRoutes } from "./engine/web-routes.js";
|
|
29
35
|
export const name = "dsh-stm32";
|
|
30
36
|
export const inject = ["tools", "subprocess", "jobs"];
|
|
37
|
+
/**
|
|
38
|
+
* A9:从 turn/end 事件里尽量挖出发起方的 agent id。
|
|
39
|
+
*
|
|
40
|
+
* 宿主没公开事件结构,所以这里按可能的位置逐个试;全都取不到就返回空串
|
|
41
|
+
* (debug-session 见到空串会退回原来的「无条件关会话」行为,不会漏关)。
|
|
42
|
+
*/
|
|
43
|
+
export function callerIdOf(event, session) {
|
|
44
|
+
const sources = [event, session];
|
|
45
|
+
for (const source of sources) {
|
|
46
|
+
if (source === null || typeof source !== "object")
|
|
47
|
+
continue;
|
|
48
|
+
const record = source;
|
|
49
|
+
const nested = [record["agent"], record["session"]];
|
|
50
|
+
for (const candidate of [record["agentId"], record["owner"], ...nested]) {
|
|
51
|
+
if (candidate === null || typeof candidate !== "object") {
|
|
52
|
+
if (typeof candidate === "string" && candidate !== "")
|
|
53
|
+
return candidate;
|
|
54
|
+
continue;
|
|
55
|
+
}
|
|
56
|
+
const id = candidate["id"];
|
|
57
|
+
if (typeof id === "string" && id !== "")
|
|
58
|
+
return id;
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
return "";
|
|
62
|
+
}
|
|
31
63
|
export function apply(ctx) {
|
|
32
64
|
registerEnvProbe(ctx);
|
|
65
|
+
registerEnvInstall(ctx);
|
|
66
|
+
registerFirmwareInstall(ctx);
|
|
33
67
|
registerProjectCreate(ctx);
|
|
68
|
+
registerProjectExport(ctx);
|
|
34
69
|
registerCodePatch(ctx);
|
|
35
70
|
registerGenerate(ctx);
|
|
36
71
|
registerIocInspect(ctx);
|
|
@@ -41,7 +76,11 @@ export function apply(ctx) {
|
|
|
41
76
|
registerDebugRun(ctx);
|
|
42
77
|
registerDebugSession(ctx);
|
|
43
78
|
registerRegsRead(ctx);
|
|
79
|
+
registerRoutePlan(ctx);
|
|
80
|
+
registerCache(ctx);
|
|
44
81
|
registerDoctor(ctx);
|
|
82
|
+
// 设置面板的宿主 API(浏览器端 lib/client.js 用)。宿主没 webServer 服务时静默跳过。
|
|
83
|
+
registerWebRoutes(ctx);
|
|
45
84
|
// 斜杠命令与 SKILL 是"锦上添花"的层:宿主没组合 commands / skills 服务时静默跳过,
|
|
46
85
|
// 工具本身照常可用(用 ctx.inject 而不是顶层 inject,避免整个插件因缺服务不加载)。
|
|
47
86
|
if (typeof ctx.inject === "function") {
|
|
@@ -57,10 +96,13 @@ export function apply(ctx) {
|
|
|
57
96
|
registerStm32Skill(ctx);
|
|
58
97
|
}
|
|
59
98
|
if (typeof ctx.on === "function") {
|
|
60
|
-
ctx.on("session/event", (
|
|
99
|
+
ctx.on("session/event", (session, event) => {
|
|
61
100
|
if (event?.type !== "turn/end")
|
|
62
101
|
return;
|
|
63
|
-
|
|
102
|
+
// A9:只关这条会话自己开的调试会话。事件结构宿主没公开,所以按可能的位置逐个试;
|
|
103
|
+
// 全都取不到就传空串,debug-session 会退回原来的「无条件关」行为。
|
|
104
|
+
const owner = callerIdOf(event, session);
|
|
105
|
+
void debugSessions.stop("turn/end:本轮输出结束,把探针还给你", owner === "" ? {} : { requireOwner: owner });
|
|
64
106
|
});
|
|
65
107
|
ctx.on("session/disposed", () => {
|
|
66
108
|
void debugSessions.stop("session/disposed");
|
|
@@ -5,8 +5,8 @@
|
|
|
5
5
|
* 但凡是能注册的服务就不要依赖路径约定(规格 §9)。
|
|
6
6
|
*/
|
|
7
7
|
export const STM32_SKILL_NAME = "stm32-workflow";
|
|
8
|
-
const DESCRIPTION = "
|
|
9
|
-
export const SKILL_CONTENT = "# STM32 工作流(dsh-stm32)\n\n
|
|
8
|
+
const DESCRIPTION = "STM32F1 全系(F100/101/102/103/105/107)+ dsh-stm32 的标准工作流与红线:只改 USER CODE、不许动 CubeMX 生成区、.ioc 走事务、烧录与调试分开、Serial Wire 不能关";
|
|
9
|
+
export const SKILL_CONTENT = "# STM32 工作流(dsh-stm32)\n\n适用:**STM32F1 全系**(F100/101/102/103/105/107)+ 本工程按型号生成的 CMake 工程。本机的验证板是蓝丸 STM32F103C8T6(64 KiB Flash / 20 KiB RAM,CMSIS-DAP 探针);换型号不是\"换块板子\",是一起换启动文件、设备宏与链接脚本——`stm32_project_create` / `stm32_generate` 按型号渲染(STM32F103RCT6 → `startup_stm32f103xe.s` + `STM32F103xE` + `STM32F103RCTx_FLASH.ld`),别手工替换这三样。\n\n## 〇、先定路线(每个新功能都先做这一步)\n\n动手写代码前先调 `stm32_route_plan`(`requirement` 一句话,可再给 `peripherals`):它按这台芯片与这句需求逐外设给出 HAL 与寄存器两版的代价/风险,并判出 `register-ok` / `both-viable` / `hal-only` / `unclear`。\n\n- `register-ok`:不建 `.ioc`,走寄存器版(启动文件与设备头从缓存目录取,不预置进插件)。\n- 要 HAL:先看工具链与固件包就位没有。`gcc` / `cmake` / `ninja` / `openocd` / `gdb` 可以让 `stm32_env_install` 代装;**CubeMX 与固件包插件不代装**(GUI 向导 + 要 ST 账号),照 `guides[].steps` 自己做,离线机器可以整目录拷过来。\n- `unclear`:别猜,先把需求说具体(外设、数据量、要不要中断/DMA),再重调一次。\n\n## 一、硬规范(红线)\n\n**R1 代码只准写在 USER CODE 块之间。**\n`/* USER CODE BEGIN X */` 与 `/* USER CODE END X */` 之间是 CubeMX 承诺\"重新生成时原样保留\"的唯一区域。\n想加的功能(GPIO 操作、状态机、自己的 .c 逻辑)全部写在块内。块外的任何一行都不属于你。\n\n**R2 不许改 CubeMX 生成区。** 具体包括(不是举例,是清单):\n- `Core/Src/main.c` 的 `main()`、`SystemClock_Config()`、`MX_GPIO_Init()` 等 `MX_*_Init()` 函数体;\n- `Core/Inc/main.h` 里 `/* Private defines */` 段的 `_Pin`/`_GPIO_Port` 宏;\n- `Core/Src/stm32f1xx_hal_msp.c`、`Core/Src/stm32f1xx_it.c`(中断服务函数内部若要加内容,只能加在它自带的 USER CODE 块里);\n- `Core/Inc/stm32f1xx_hal_conf.h`、`Core/Src/system_stm32f1xx.c`、本型号的启动文件(C8T6 是 `startup_stm32f103xb.s`,RCT6 是 `startup_stm32f103xe.s`,F107 是 `startup_stm32f107xc.s`)、本型号的链接脚本 `<DeviceId>_FLASH.ld`(`STM32F103C8Tx_FLASH.ld`、`STM32F103RCTx_FLASH.ld`、`STM32F107VCTx_FLASH.ld`;模板里的旧名 `STM32F103XX_FLASH.ld` 只是 C8T6 兼容副本);\n- `CMakeLists.txt`、`cmake/stm32cubemx/CMakeLists.txt`、`.mxproject`、`demo.ioc`(.ioc 只能通过事务改,见 R3)。\n理由:这些文件由 CubeMX 按 .ioc 重写;手改会被无声覆盖,而且覆盖后编译不报错(源清单写死在 `cmake/stm32cubemx/CMakeLists.txt:21-28`),故障会以\"改了不生效\"的形式出现。\n\n**R3 配置只准走 .ioc 事务:`stm32_ioc_plan` → 用户确认 → `stm32_ioc_apply`。**\n不要手改 .ioc 文本,不要开 CubeMX GUI,不要\"顺手\"改引脚/时钟。改时钟走同一条事务:`stm32_ioc_plan` 的 `clock: { targetHz }` 枚举可行的 PLL 组合、取最接近目标的那一档(不可达时显式标注「不可达,已选 X MHz(±Y)」),并把 `PLLMUL` / `SYSCLKFreq_VALUE` / `HCLKFre` 这些派生键全量重算;超限(SYSCLK > 72 MHz、APB1 > 36 MHz、ADC > 14 MHz 等)时它一个键都不写。apply 必须带 `planId`(`stm32_ioc_plan` 返回的那个计划 ID,参数名就是 planId),源文件 SHA-256 变了就拒绝。\n\n**R4 不许生成 `No_Debug` 的 SYS 配置。** 那会生成 `__HAL_AFIO_REMAP_SWJ_DISABLE()`,烧进去以后固件一上电就关掉 PA13/PA14 的 SWD 功能,**调试口永久失联**,只能靠 BOOT0 进系统 bootloader 抢救。\n.ioc 里必须有 `PA13.Signal=SYS_JTMS-SWDIO`、`PA14.Signal=SYS_JTCK-SWCLK`、`*.Mode=Serial_Wire`。ioc_inspect 报这条警告时必须先修。\n\n**R5 烧录与调试分开。**\n只烧录:`stm32_flash` 或 `/stm32-flash`(openocd `program ... verify reset exit`,烧完就跑,不进调试会话)。\n调试:`stm32_debug_run`(一次性停 main、取 pc/栈后释放)或 `/stm32-debug` + `stm32_debug_eval`(保持会话)。\n永远不要用\"能不能断下来\"来判断烧录成功——烧录成功的证据是 `** Programming Finished **` 与 `** Verified OK **`。\n\n**R6 探针只有一块。** build / flash / generate 之前先让出调试会话;我输出结束(turn/end)时插件会自动关会话,所以别在输出中途把探针攥着不说。\n\n**R7 先 build 再 flash。** 改完代码不编译就烧,烧的是旧 elf;烧完看现象会得出错误结论。\n\n**R8 结论必须带证据。** 说\"闪了\"要给寄存器/计数器证据(例如 `GPIOC_ODR` 在 0x2000/0x0000 之间翻转、`g_led_blink_count` 单调增长),不要只说\"看起来好了\"。\n\n## 二、标准流程\n\n1. `stm32_env_probe` —— 工具链齐不齐(gcc/gdb/openocd/cmake/ninja + CubeMX)。缺哪个就照它给的 `install` 装(第一条最省事,带可粘贴的 pacman / winget 命令),装完按 `verify` 自检;它还会问要不要我代装。CubeMX 是可选的:只影响建工程与重新生成,不影响编译/烧录/调试。\n2. `stm32_ioc_inspect` —— 看清引脚/时钟/调试口;有 `warnings` 先处理(尤其 Serial Wire)。\n3. 需要改引脚/时钟:`stm32_ioc_plan` → 给用户看 diff → `stm32_ioc_apply`(自动备份到 `.dsh-stm32/backups/<时间戳>-ioc/`)。时钟给 `clock: { targetHz }`(要钉死倍频就 `clock: { pllMul }`),报告里带逐外设频率与 UART 波特率误差。\n4. `stm32_generate` —— 无头重新生成(3–4 分钟,走 job)。产物 `Src/`/`Inc/` 会被搬到 `Core/Src`/`Core/Inc`,USER CODE 按标签保活,生成用的临时目录会被删掉。\n5. 写代码:**只在 USER CODE 块内**。\n6. `stm32_build`(clean 才有内存占用表)→ 0 错再往下。\n7. `stm32_flash` —— 只烧录;或 `stm32_debug_run` —— 烧录并停在 main。\n8. 验证:`stm32_regs_read`(读 GPIOC_ODR / AFIO_MAPR / 全局变量)或 `stm32_debug_eval`。\n\n## 三、命令对照\n\n| 想要 | 工具 | 斜杠命令 |\n|---|---|---|\n| 只烧录 | `stm32_flash` | `/stm32-flash` |\n| 烧录 + 调试 | `stm32_debug_run`(一次性)/ `stm32_debug_session`(保持) | `/stm32-debug` |\n| 编译 | `stm32_build` | `/stm32-build` |\n| 体检 | `stm32_doctor` | `/stm32-doctor` |\n| 释放探针 | `stm32_debug_stop` | `/stm32-stop` |\n\n## 四、踩过的坑(本机实测,别重复)\n\n1. **CubeMX 的\"假成功\"**:直接 `STM32CubeMX.exe -q script` 会 detach 出 javaw 并立刻 exit 0,stdout 是空的。必须 `jre\\bin\\java.exe -jar STM32CubeMX.exe -q <脚本>` 并重定向日志,成功标志是日志里的 `Code succesfully generated under`(CubeMX 自己把 successfully 拼错了)。启动要 90–150 s。\n2. **CLI 生成忽略工程设置**:.ioc 写着 `MainLocation=Core/Src`、`CoupleFile=false`,CLI 依然固定写 `Src/`/`Inc/` 并按外设拆文件。所以必须落地映射 + USER CODE 合并,否则核心代码会被搬丢。\n3. **USER CODE 按标签保活**:同标签用旧正文覆盖新正文;旧有新无的标签直接丢;标签不配对则那对放弃。\n4. **`mdw` 输出是 8 位裸 hex**:`0x4001100c: 00000000`;`[reg pc]` 返回 `pc (/32): 0x...`,要 `lindex 1`。\n5. **openocd 的日志走 stderr**:等 \"Listening on port\" 必须同时 drain stdout 和 stderr,否则永远等不到。\n6. **读寄存器的收尾用 `resume` 不要 `reset run`**:后者会复位芯片,计数器归零,看起来像\"变量丢了\"。\n7. **符号地址会随重链接漂移**:`g_led_blink_count` 曾在 `0x20000028`,改一行后变成 `0x2000002C`,老地址变成 `uwTick`。读符号前用 `nm` 确认,或直接读物理地址。\n8. **装插件用一条命令**:`dsh plugin --profile desktop add github:JingYu-er/dsh-stm32#main`(`lib/` 已入库,pnpm 不替 git 依赖构建也能直接用)。只有要改插件源码时才用 `link:`,且升级前先删掉 `node_modules/dsh-stm32` 这个 junction,否则 pnpm 覆盖时报 `EPERM`。\n9. **宿主输出契约**:工具返回的对象在 `additionalProperties: false` 下不能有多余键;声明为 number/object 的字段不接受 `null`(用可选字段 + 条件展开)。\n10. **ninja / piped stdio 在受限沙箱里会挂或 EPERM**:那是工具侧沙箱,不是工程问题;插件里经 `ctx.subprocess` 起的进程不受会话文件沙箱限制。\n11. **裸 `cmake -S . -B build` 会丢工具链文件**:交叉编译器只由 `CMakePresets.json` 注入(`cmake/gcc-arm-none-eabi.cmake`),不读 preset 就退回主机编译器,报一串找不到 `arm-none-eabi-gcc`。要么 `cmake --preset default`,要么显式 `-DCMAKE_TOOLCHAIN_FILE=cmake/gcc-arm-none-eabi.cmake`。\n12. **换芯片别留下旧链接脚本名**:`-T` 必须指向按型号渲染的 `<DeviceId>_FLASH.ld`(工具里的 `pointLinkerFlagAt` 会把工具链中的旧名改指到新名,手改反而绕开它);留着 `STM32F103XX_FLASH.ld` 烧到 256 KiB 的 RCT6 上就是「编译过、跑飞」。\n\n## 五、自检清单(每次交付前)\n\n- [ ] 改动全部落在 USER CODE 块内(`git diff` 里没有生成区的行)\n- [ ] .ioc 改动走过 plan → apply(有备份)\n- [ ] Serial Wire 仍在(`stm32_ioc_inspect` 的 `warnings` 为空)\n- [ ] `stm32_build` 0 error、0 unexpected warning\n- [ ] 烧录有 `** Verified OK **`\n- [ ] 行为验证有寄存器/计数器证据\n- [ ] 探针已释放(`stm32_doctor` 无残留进程)\n- [ ] 芯片型号 / 启动文件 / 设备宏 / `.ld` 四者配套(`stm32_doctor` 的芯片一致性检查无 blocker)";
|
|
10
10
|
/** 注册 skill;宿主没组合 skills 服务时直接返回。 */
|
|
11
11
|
export function registerStm32Skill(ctx) {
|
|
12
12
|
const skills = ctx.get("skills");
|
|
@@ -15,7 +15,7 @@ export function registerStm32Skill(ctx) {
|
|
|
15
15
|
skills.register({
|
|
16
16
|
name: STM32_SKILL_NAME,
|
|
17
17
|
description: DESCRIPTION,
|
|
18
|
-
whenToUse: "给
|
|
18
|
+
whenToUse: "给 STM32F1 工程(F100/101/102/103/105/107,本机验证板 F103C8T6)写代码、改引脚/时钟、重新生成、编译、烧录或调试时",
|
|
19
19
|
content: SKILL_CONTENT,
|
|
20
20
|
// 宿主读取 skill 时要求 source / provider 是字符串(register 本身不校验,
|
|
21
21
|
// 但 ctx.skills.get() 会用 validateDefinition 再验一次)。缺 source 的表现是
|