dsh-stm32 0.1.6 → 0.1.7
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 +517 -517
- package/README_EN.md +510 -510
- package/client/client.js +24 -24
- package/lib/client.js +24 -24
- package/lib/commands/register.js +5 -5
- package/lib/data/chips.js +4 -4
- package/lib/data/clock-db.js +24 -24
- package/lib/data/clock-f1.js +2 -2
- package/lib/data/cmsis-sources.js +6 -6
- package/lib/data/db-presets.js +4 -4
- package/lib/data/device-facts.js +6 -6
- package/lib/data/family.js +16 -16
- package/lib/data/firmware-packages.js +10 -10
- package/lib/data/install-guides.js +18 -18
- package/lib/data/ioc-presets.js +3 -3
- package/lib/data/ioc-schema.js +32 -32
- package/lib/data/rm-topics.js +6 -6
- package/lib/data/search-roots.js +62 -16
- package/lib/data/serial-config.js +7 -7
- package/lib/data/stm32f1.js +1 -1
- package/lib/data/svd.js +7 -7
- package/lib/data/toolchain-config.js +3 -3
- package/lib/engine/assets.js +5 -5
- package/lib/engine/breakpoints.js +5 -5
- package/lib/engine/cache.js +4 -4
- package/lib/engine/clock-derived.js +2 -2
- package/lib/engine/clock-direct.js +3 -3
- package/lib/engine/clock-plan.js +7 -7
- package/lib/engine/clock-pllmn.js +6 -6
- package/lib/engine/cmake-sources.js +9 -9
- package/lib/engine/code-patch.js +5 -5
- package/lib/engine/cube-mx-guard.js +3 -3
- package/lib/engine/cube-programmer.js +4 -4
- package/lib/engine/cubemx-db.js +7 -7
- package/lib/engine/debug-session.js +12 -12
- package/lib/engine/debug.js +3 -3
- package/lib/engine/doctor.js +12 -12
- package/lib/engine/download.js +1 -1
- package/lib/engine/facts-acquire.js +3 -3
- package/lib/engine/fetch.js +2 -2
- package/lib/engine/firmware-install.js +16 -16
- package/lib/engine/firmware-official.js +8 -8
- package/lib/engine/flash.js +22 -22
- package/lib/engine/fs-longpath.js +1 -1
- package/lib/engine/gdb-mi.js +7 -7
- package/lib/engine/generate-script.js +2 -2
- package/lib/engine/generate.js +17 -17
- package/lib/engine/hal-chip.js +7 -7
- package/lib/engine/ioc-plan.js +52 -52
- package/lib/engine/ioc-rules.js +9 -9
- package/lib/engine/ioc-verify.js +34 -34
- package/lib/engine/msys2-install.js +50 -50
- package/lib/engine/probe-error.js +8 -8
- package/lib/engine/probe-session.js +3 -3
- package/lib/engine/probe.js +47 -50
- package/lib/engine/project-export.js +1 -1
- package/lib/engine/register-clock.js +5 -5
- package/lib/engine/register-gpio.js +3 -3
- package/lib/engine/register-linker.js +7 -7
- package/lib/engine/register-template.js +22 -22
- package/lib/engine/regs.js +3 -3
- package/lib/engine/rm-extract.js +2 -2
- package/lib/engine/rm-sources.js +1 -1
- package/lib/engine/route-plan.js +9 -9
- package/lib/engine/rtt.js +18 -18
- package/lib/engine/scaffold.js +22 -22
- package/lib/engine/serial.js +24 -24
- package/lib/engine/tar.js +1 -1
- package/lib/engine/text-file.js +1 -1
- package/lib/engine/thirdparty.js +3 -3
- package/lib/engine/tool-env.js +2 -2
- package/lib/engine/toolchain-gate.js +8 -8
- package/lib/engine/usercode-merge.js +2 -2
- package/lib/engine/vscode-config.js +2 -2
- package/lib/engine/web-api.js +1 -1
- package/lib/engine/xcube-catalog.js +1 -1
- package/lib/index.js +5 -5
- package/lib/skill/stm32-workflow.js +1 -1
- package/lib/tools/assets.js +1 -1
- package/lib/tools/cache.js +2 -2
- package/lib/tools/debug-session.js +5 -5
- package/lib/tools/doctor.js +2 -2
- package/lib/tools/download.js +1 -1
- package/lib/tools/env-install.js +3 -3
- package/lib/tools/firmware-install.js +5 -5
- package/lib/tools/flash.js +8 -8
- package/lib/tools/generate.js +1 -1
- package/lib/tools/ioc-apply.js +1 -1
- package/lib/tools/ioc-plan.js +1 -1
- package/lib/tools/ioc-verify.js +11 -11
- package/lib/tools/project-create.js +4 -4
- package/lib/tools/project-dir.js +1 -1
- package/lib/tools/regs.js +10 -10
- package/lib/tools/route-plan.js +9 -9
- package/lib/tools/rtt.js +9 -9
- package/lib/tools/serial.js +8 -8
- package/package.json +70 -70
- package/templates/scaffold/RTT.md +26 -34
package/lib/engine/generate.js
CHANGED
|
@@ -102,7 +102,7 @@ export function detectLayout(projectDir) {
|
|
|
102
102
|
return /\/\* USER CODE BEGIN MX_[A-Za-z0-9_]+_1 \*\//u.test(text) ? "coupled" : "per-ip";
|
|
103
103
|
}
|
|
104
104
|
const LOCK_HOST = hostname();
|
|
105
|
-
/** A14
|
|
105
|
+
/** A14:锁中记录的 pid 是否仍在运行。EPERM 说明进程存在(只是不受本插件管理),按仍在运行处理。 */
|
|
106
106
|
export function isProcessAlive(pid) {
|
|
107
107
|
if (!Number.isInteger(pid) || pid <= 0)
|
|
108
108
|
return false;
|
|
@@ -123,7 +123,7 @@ export function acquireLock(projectDir, purpose) {
|
|
|
123
123
|
try {
|
|
124
124
|
const info = JSON.parse(readFileSync(lockPath, "utf8"));
|
|
125
125
|
const age = Date.now() - info.startedAt;
|
|
126
|
-
// A14
|
|
126
|
+
// A14:以前只比较时间,DSH 异常退出或断电后 30 分钟内所有生成均被阻止,需用户手动删除锁文件。
|
|
127
127
|
// 现在同时看进程是否活着;锁文件从别的机器拷来时 pid 没有参考价值,直接按陈旧处理。
|
|
128
128
|
const sameHost = info.host === undefined || info.host === "" || info.host === LOCK_HOST;
|
|
129
129
|
const alive = sameHost && isProcessAlive(info.pid);
|
|
@@ -135,7 +135,7 @@ export function acquireLock(projectDir, purpose) {
|
|
|
135
135
|
String(info.pid) +
|
|
136
136
|
",开始于 " +
|
|
137
137
|
new Date(info.startedAt).toLocaleString() +
|
|
138
|
-
")。CubeMX
|
|
138
|
+
")。CubeMX 会写用户级数据库,不能并发;等待该进程结束或删除 " +
|
|
139
139
|
lockPath +
|
|
140
140
|
" 后重试。",
|
|
141
141
|
};
|
|
@@ -223,7 +223,7 @@ function applyGeneratedFiles(projectDir, generated, backupRoot, dryRun) {
|
|
|
223
223
|
const oldFile = readTextFile(targetAbs);
|
|
224
224
|
if (!oldFile.ok) {
|
|
225
225
|
files.push({ source, target, action: "skipped-encoding", preserved: [], droppedLabels: [] });
|
|
226
|
-
notes.push(target + " 的旧文件编码认不出来(" + oldFile.error + "
|
|
226
|
+
notes.push(target + " 的旧文件编码认不出来(" + oldFile.error + "):本次不覆盖,以免破坏其中的中文注释;" +
|
|
227
227
|
"先转成 UTF-8 再重跑生成。");
|
|
228
228
|
continue;
|
|
229
229
|
}
|
|
@@ -235,7 +235,7 @@ function applyGeneratedFiles(projectDir, generated, backupRoot, dryRun) {
|
|
|
235
235
|
}
|
|
236
236
|
if (oldFile.encoding !== "utf8" && oldFile.encoding !== "utf8-bom") {
|
|
237
237
|
notes.push(target + " 原来是 " + oldFile.encoding + " 编码(多半是 Keil 编辑过的 GBK 文件):本次按 UTF-8 写回," +
|
|
238
|
-
"
|
|
238
|
+
"中文内容无损;若编辑器仍按 GBK 打开会出现乱码,将其设置为 UTF-8 即可。");
|
|
239
239
|
}
|
|
240
240
|
const merged = mergeUserCode(oldText, newText);
|
|
241
241
|
files.push({
|
|
@@ -275,14 +275,14 @@ function sleepSync(ms) {
|
|
|
275
275
|
* 删空目录,带重试。
|
|
276
276
|
*
|
|
277
277
|
* Windows 上刚被 rm 的文件会先进 delete-pending 状态:目录此刻仍算非空,
|
|
278
|
-
* `rmdir` 报 ENOTEMPTY
|
|
278
|
+
* `rmdir` 报 ENOTEMPTY;占用该目录的句柄(CubeMX 的 JVM、杀毒扫描等)关闭后目录才真正为空。
|
|
279
279
|
* 所以这里轮询几次,而不是一次失败就留一堆空目录在工程根里。
|
|
280
280
|
*/
|
|
281
281
|
function removeDirIfEmpty(dir, attempts = 20, delayMs = 500) {
|
|
282
282
|
let lastCode = "";
|
|
283
283
|
for (let attempt = 0; attempt < attempts; attempt += 1) {
|
|
284
284
|
try {
|
|
285
|
-
//
|
|
285
|
+
// 必须使用 rmdirSync:rmSync 对目录即使 recursive:false 也会报 ERR_FS_EISDIR(此前 Src/Inc 无法删除的原因)。
|
|
286
286
|
rmdirSync(dir);
|
|
287
287
|
return null;
|
|
288
288
|
}
|
|
@@ -350,7 +350,7 @@ export async function runGenerate(subprocess, request) {
|
|
|
350
350
|
if (!iocFile.ok)
|
|
351
351
|
return fail(request, "读不了 .ioc(" + iocPath + "):" + iocFile.error);
|
|
352
352
|
const iocText = iocFile.text;
|
|
353
|
-
//
|
|
353
|
+
// 先确认 .ioc 所需的固件包,再在 CubeMX 根下查找该包(官方 Repository 与插件的 dsh-firmware 均查找)。
|
|
354
354
|
// 找到就通过脚本命令 setCustomFWPath 明确指过去:CubeMX 不认目录名时只会静默用别的版本(docs §14)。
|
|
355
355
|
// 除了 CubeMX 根,还要认 stm32_firmware_install 的另外两种落点:<cacheRoot>/firmware 与显式 targetDir,
|
|
356
356
|
// 否则装完包这里又说"没找到"(B10)。
|
|
@@ -368,8 +368,8 @@ export async function runGenerate(subprocess, request) {
|
|
|
368
368
|
const hit = cacheHit(readCache(stateDir), cacheKey.key, projectDir);
|
|
369
369
|
if (hit.hit && hit.entry !== null) {
|
|
370
370
|
const cached = hit.entry;
|
|
371
|
-
//
|
|
372
|
-
//
|
|
371
|
+
// 旧问题(审计后补充):cmake/stm32cubemx/CMakeLists.txt 一直是脚手架快照,CubeMX 从不重写该文件。
|
|
372
|
+
// 跳过本次生成时同样需要对齐一次 —— 否则用户只修改 Core 中的代码(.ioc 未改动)时,源清单将始终缺少模块。
|
|
373
373
|
const cmake = refreshCubemxCmakeLists(projectDir);
|
|
374
374
|
return {
|
|
375
375
|
ok: true,
|
|
@@ -402,7 +402,7 @@ export async function runGenerate(subprocess, request) {
|
|
|
402
402
|
notes: [
|
|
403
403
|
"想强制重新生成就传 skipIfUnchanged=false(会再跑一次 CubeMX,3–4 分钟)。",
|
|
404
404
|
"生成缓存只认 .ioc / CubeMX 版本 / 布局:换了固件包内容(例如重下同一个包)也要传 skipIfUnchanged=false。",
|
|
405
|
-
"缓存文件:.dsh-stm32/" + "generate-cache.json" + "
|
|
405
|
+
"缓存文件:.dsh-stm32/" + "generate-cache.json" + ";删除该文件等效于强制重新生成。",
|
|
406
406
|
describeRefresh(cmake),
|
|
407
407
|
...cmake.notes,
|
|
408
408
|
],
|
|
@@ -453,7 +453,7 @@ export async function runGenerate(subprocess, request) {
|
|
|
453
453
|
const tmpDir = join(stateDir, "tmp");
|
|
454
454
|
const scriptPath = join(tmpDir, "gen-" + stamp + ".txt");
|
|
455
455
|
const script = buildGenerateScript(iocPath.replace(/\\/g, "/"), projectDir.replace(/\\/g, "/"), layout, firmware.dir);
|
|
456
|
-
// A5:工程盘只读 / .dsh-stm32
|
|
456
|
+
// A5:工程盘只读 / .dsh-stm32 被删除 / 权限不足时,此处以前会抛出未捕获异常导致工具失败。
|
|
457
457
|
try {
|
|
458
458
|
mkdirSync(tmpDir, { recursive: true });
|
|
459
459
|
writeFileSync(scriptPath, script, "utf8");
|
|
@@ -466,7 +466,7 @@ export async function runGenerate(subprocess, request) {
|
|
|
466
466
|
// 路径含中文时脚本会乱码,这里逼 JVM 用 UTF-8 读文件。
|
|
467
467
|
const argv = [launch.java, "-Dfile.encoding=UTF-8", "-jar", launch.jar, "-q", scriptPath];
|
|
468
468
|
const command = argv.map((part) => (part.includes(" ") ? '"' + part + '"' : part)).join(" ");
|
|
469
|
-
// CubeMX 单实例:GUI
|
|
469
|
+
// CubeMX 单实例:GUI 运行时 -q 会被转发过去并弹出模态框,生成会持续阻塞(实测阻塞 4 分钟以上)。
|
|
470
470
|
// 这里先探测、先拒绝,别让用户对着一个不动的进度条猜。
|
|
471
471
|
const guiProcesses = await findRunningCubeMxGui(subprocess, request.signal);
|
|
472
472
|
if (guiProcesses.length > 0) {
|
|
@@ -521,7 +521,7 @@ export async function runGenerate(subprocess, request) {
|
|
|
521
521
|
const verdict = parseGenerateLog(log);
|
|
522
522
|
const durationMs = Date.now() - startedAt;
|
|
523
523
|
// 失败路径也要把「第三方包索引」的判定与缺包警告带出去:CubeMX 报缺包时,
|
|
524
|
-
//
|
|
524
|
+
// 本插件输出的"本机没有这个包"恰恰是最有用的信息,不能只在成功时给出。
|
|
525
525
|
const failureNotes = [];
|
|
526
526
|
if (thirdparty.detail !== "")
|
|
527
527
|
failureNotes.push("第三方包索引:" + thirdparty.detail);
|
|
@@ -529,8 +529,8 @@ export async function runGenerate(subprocess, request) {
|
|
|
529
529
|
if (!firmware.found) {
|
|
530
530
|
failureNotes.push("没找到 .ioc 要的固件包(找过 " +
|
|
531
531
|
firmware.checked.join("、") +
|
|
532
|
-
"):CubeMX
|
|
533
|
-
"可以用 stm32_firmware_install
|
|
532
|
+
"):CubeMX 会回退到其识别的版本,生成的 Drivers 可能不是用户期望的版本;" +
|
|
533
|
+
"可以用 stm32_firmware_install 安装一次 —— 生成文件落在 <CubeMX>/dsh-firmware(CubeMX 根目录不可写时落在下载缓存)," +
|
|
534
534
|
"之后再生成时这里会连 CubeMX 根、下载缓存、安装记录一起搜。");
|
|
535
535
|
}
|
|
536
536
|
const baseReport = {
|
|
@@ -588,7 +588,7 @@ export async function runGenerate(subprocess, request) {
|
|
|
588
588
|
}
|
|
589
589
|
const notes = [...applied.notes];
|
|
590
590
|
// 老洞:CubeMX 不写 cmake/stm32cubemx/CMakeLists.txt(实测 mtime 停留在脚手架拷贝那一刻),
|
|
591
|
-
//
|
|
591
|
+
// 本插件必须按磁盘事实对齐这份源清单,否则启用 UART/CAN 会在链接期出现 undefined reference。
|
|
592
592
|
const cmake = refreshCubemxCmakeLists(projectDir, request.dryRun === true ? { dryRun: true } : {});
|
|
593
593
|
notes.push(describeRefresh(cmake));
|
|
594
594
|
notes.push(...cmake.notes);
|
package/lib/engine/hal-chip.js
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
*
|
|
4
4
|
* 为什么单独一层:脚手架里原本写死了 C8T6 的四样东西(startup_stm32f103xb.s、
|
|
5
5
|
* 设备宏 STM32F103xB、链接脚本 STM32F103XX_FLASH.ld、demo.ioc 里的 Mcu.CPN)。
|
|
6
|
-
* 要支持 F1
|
|
6
|
+
* 要支持 F1 全系,这四样都需按型号计算。计算所需数据来自三处,缺一不可:
|
|
7
7
|
*
|
|
8
8
|
* 1. 容量档 → 启动文件 / 设备宏 / 设备头 / Flash / RAM:src/data/stm32f1.ts 的 resolveF1Chip
|
|
9
9
|
* (上游启动文件是实测出来的事实,别在这里再抄一份)。
|
|
@@ -26,7 +26,7 @@ import { familyIdOfPart, familyProfileOf } from "../data/family.js";
|
|
|
26
26
|
export const DEFAULT_HAL_MCU = "STM32F103C8T6";
|
|
27
27
|
/**
|
|
28
28
|
* 老工程兼容用的链接脚本名。模板里那份是 C8T6 的(64K/20K),
|
|
29
|
-
* 新工程一律另有 <DeviceId>_FLASH.ld
|
|
29
|
+
* 新工程一律另有 <DeviceId>_FLASH.ld;该旧名仅为「已有工程的 cmake 仍引用该名称」保留。
|
|
30
30
|
*/
|
|
31
31
|
export const LEGACY_LINKER_SCRIPT = "STM32F103XX_FLASH.ld";
|
|
32
32
|
/** 模板里写死的 C8T6 事实(渲染时被替换掉;C8T6 本身替换后逐字节不变)。 */
|
|
@@ -95,7 +95,7 @@ export function resolveHalChip(input) {
|
|
|
95
95
|
const notes = [];
|
|
96
96
|
// 封装脚数与 db 分组名都从内置资源的 chips.json 来(DeviceFactsChip.pinCount / mcuName):
|
|
97
97
|
// 插件不再自己维护「封装字母 → 脚数」「line → 分组名」两张表 —— 那只是 db 的 Package/RefName 的手抄快照,
|
|
98
|
-
// 换族、换 db
|
|
98
|
+
// 换族、换 db 版本即失真(§65 已因预设表出现过一次错误)。
|
|
99
99
|
const pinCount = chip.pinCount;
|
|
100
100
|
const deviceId = chip.prefix + packageLetter + chip.densityLetter + suffixLetter + "x";
|
|
101
101
|
const mcuName = chip.mcuName !== "" ? chip.mcuName : deviceId;
|
|
@@ -207,7 +207,7 @@ export function renderLinkerScript(template, facts) {
|
|
|
207
207
|
[flashLine, "MEMORY 里的 FLASH 行"],
|
|
208
208
|
]) {
|
|
209
209
|
if (!pattern.test(template)) {
|
|
210
|
-
throw new Error("链接脚本模板缺 " + what + "
|
|
210
|
+
throw new Error("链接脚本模板缺 " + what + ",无法按芯片渲染(模板可能已被修改)");
|
|
211
211
|
}
|
|
212
212
|
}
|
|
213
213
|
let text = template.replace(abstract, (_match, head) => head + facts.deviceId + " series");
|
|
@@ -228,7 +228,7 @@ export function renderIoc(template, facts, projectName = "") {
|
|
|
228
228
|
["Mcu.UserName", facts.deviceId],
|
|
229
229
|
["ProjectManager.DeviceId", facts.deviceId],
|
|
230
230
|
// 工程文件名也要跟着工程走:模板里写的是 demo.ioc,CubeMX 保存时发现"文件名与键不一致"
|
|
231
|
-
//
|
|
231
|
+
// 会将其改回真实文件名 —— 该假 diff 在每次 plan→verify 时都会出现(F4 已实测)。
|
|
232
232
|
// 这条不是必需键(老模板可能没有),所以单独放 optional,不参与缺键检查。
|
|
233
233
|
...(projectName === "" ? [] : [["ProjectManager.ProjectFileName", projectName + ".ioc"]]),
|
|
234
234
|
];
|
|
@@ -252,7 +252,7 @@ export function renderIoc(template, facts, projectName = "") {
|
|
|
252
252
|
/** 工具链 cmake 文件里的 -T 指向渲染后的链接脚本名。 */
|
|
253
253
|
export function pointLinkerFlagAt(text, facts) {
|
|
254
254
|
if (!text.includes(LEGACY_LINKER_SCRIPT)) {
|
|
255
|
-
throw new Error("工具链 cmake 文件里找不到 -T …" + LEGACY_LINKER_SCRIPT + "
|
|
255
|
+
throw new Error("工具链 cmake 文件里找不到 -T …" + LEGACY_LINKER_SCRIPT + "(模板可能已被修改)");
|
|
256
256
|
}
|
|
257
257
|
return text.split(LEGACY_LINKER_SCRIPT).join(facts.linkerScript);
|
|
258
258
|
}
|
|
@@ -264,7 +264,7 @@ export function pointLinkerFlagAt(text, facts) {
|
|
|
264
264
|
* - 设备宏:STM32F103xB(只对 C8T6 成立,别的芯片编不过)
|
|
265
265
|
* - 启动文件:startup_stm32f103xb.s
|
|
266
266
|
* 少了第一步,非 F1 工程会去 include 一个不存在的 STM32F1xx 目录(cmake 不报错、编译期才发现)。
|
|
267
|
-
* 驱动源清单(STM32_Drivers_Src
|
|
267
|
+
* 驱动源清单(STM32_Drivers_Src)有意不在此处修改:该清单是"本工程实际使用的模块"的产物,
|
|
268
268
|
* 由 refreshCubemxCmakeLists 在 CubeMX 生成之后按 hal_conf.h 重算。
|
|
269
269
|
*/
|
|
270
270
|
export function renderCmakeLists(text, facts) {
|
package/lib/engine/ioc-plan.js
CHANGED
|
@@ -3,8 +3,8 @@
|
|
|
3
3
|
*
|
|
4
4
|
* 设计要点(规格 §3 I3、§8、§11 A8):
|
|
5
5
|
* - 插件**永远不静默改 \`.ioc\`**:plan 只算、不写源文件;apply 必须带 planId,且源文件 SHA-256
|
|
6
|
-
* 与 plan 时一致,否则拒绝(防止"plan
|
|
7
|
-
* - plan 的候选文件先落在 \`.dsh-stm32/plans/<planId>.ioc\`,apply
|
|
6
|
+
* 与 plan 时一致,否则拒绝(防止"plan 之后用户又通过 CubeMX GUI 修改过")。
|
|
7
|
+
* - plan 的候选文件先落在 \`.dsh-stm32/plans/<planId>.ioc\`,apply 前重新核对候选文件的 SHA-256,
|
|
8
8
|
* 保证"确认的那份"就是"写进去的那份"。
|
|
9
9
|
* - apply 前再跑一遍安全校验(Serial Wire 在、KeepUserCode 开),是第二道闸:plan 通过之后
|
|
10
10
|
* 候选文件也可能被人手改过。
|
|
@@ -85,8 +85,8 @@ function dominantEol(text) {
|
|
|
85
85
|
* 也就是按 **UTF-16 码元**逐字符比。JS 的 `<` 比较同样是码元序,所以直接比字符串即可。
|
|
86
86
|
* 语料 504 份板级 .ioc 实测:6.x 的 266 份里 261 份(98.1%)是这种序。
|
|
87
87
|
*
|
|
88
|
-
*
|
|
89
|
-
*
|
|
88
|
+
* 以前此处按"数字段比数值"排序(Mcu.Pin2 在 Mcu.Pin10 之前),这是本插件自行确定的排序:
|
|
89
|
+
* 键数超过 10 就与 CubeMX 的写法错位,用户将本插件生成的 .ioc 与 CubeMX 另存结果对比时会出现大量行位移。
|
|
90
90
|
*/
|
|
91
91
|
export function compareIocKeys(left, right) {
|
|
92
92
|
return left < right ? -1 : left > right ? 1 : 0;
|
|
@@ -148,7 +148,7 @@ export function readIocText(path) {
|
|
|
148
148
|
catch {
|
|
149
149
|
throw new Error("不是合法的 UTF-8:" + path +
|
|
150
150
|
"(多半是中文编辑器另存成了 GBK/ANSI)。请用 VS Code 以 UTF-8 另存后再改;" +
|
|
151
|
-
"
|
|
151
|
+
"插件不推测编码,以免破坏整份 .ioc");
|
|
152
152
|
}
|
|
153
153
|
}
|
|
154
154
|
function buildLineTable(text) {
|
|
@@ -204,7 +204,7 @@ export function renderIocText(text, changes) {
|
|
|
204
204
|
out.push({ key: lineKey(line), line });
|
|
205
205
|
});
|
|
206
206
|
// 新增键按 key 排序插到对应位置;末尾的空行是原文件的(可能是"文件末尾有换行"的表现),
|
|
207
|
-
//
|
|
207
|
+
// 不能移除,新键需插在这些空行**之前**。
|
|
208
208
|
let tail = out.length;
|
|
209
209
|
while (tail > 0 && out[tail - 1].line.trim() === "")
|
|
210
210
|
tail -= 1;
|
|
@@ -259,8 +259,8 @@ const EXTI_MODES = {
|
|
|
259
259
|
/**
|
|
260
260
|
* 引脚属性键写进 <pin>.GPIOParameters 的顺序。
|
|
261
261
|
*
|
|
262
|
-
*
|
|
263
|
-
*
|
|
262
|
+
* 该顺序并非插件主观选择,而是 CubeMX 6.15.0 回写时自身使用的顺序——CubeMX 把 GPIOParameters 当
|
|
263
|
+
* 集合重新序列化,**无视插件写入的排列**(因此排列只影响 diff 噪声,不影响功能)。
|
|
264
264
|
*
|
|
265
265
|
* 证据两条:
|
|
266
266
|
* 1) 真机探针(2026-11-02,demo.ioc 副本 load+save):写 `GPIO_Label,GPIO_PuPd,GPIO_ModeDefaultEXTI`
|
|
@@ -300,7 +300,7 @@ function adcPrescalerDiv(token) {
|
|
|
300
300
|
/**
|
|
301
301
|
* DMA 请求参数的白名单顺序(CubeMX 按这个顺序把参数名写进
|
|
302
302
|
* `Dma.<IP>.<n>.RequestParameters`)。F1 的 DMA 没有 FIFO,所以列到 Priority 为止;
|
|
303
|
-
* 后面几个是 F4/H7
|
|
303
|
+
* 后面几个是 F4/H7 才有的字段,保留在此是为了写入这些字段时顺序仍然正确。
|
|
304
304
|
* 实测依据:richhal.ioc:30(F1,8 个字段)与语料里 F4 的 9 字段版本(多一个 FIFOMode)。
|
|
305
305
|
*/
|
|
306
306
|
export const DMA_PARAM_ORDER = [
|
|
@@ -309,7 +309,7 @@ export const DMA_PARAM_ORDER = [
|
|
|
309
309
|
];
|
|
310
310
|
/**
|
|
311
311
|
* 解析 `Dma.<IP>.<n>.<参数>` 的分组(`Dma.{ip}.{n}.{name}` 这条 spec 的三段占位符)。
|
|
312
|
-
*
|
|
312
|
+
* 不使用手写正则:键名的形状全部由 src/data/ioc-schema.ts 的真值表定义,此处只取该真值表的参数。
|
|
313
313
|
* 返回 null 表示不是 DMA 请求参数键(含 Dma.RequestParameters 本身)。返回的 name 就是参数名。
|
|
314
314
|
*/
|
|
315
315
|
function dmaGroupOf(key) {
|
|
@@ -362,8 +362,8 @@ function samePinOrder(left, right) {
|
|
|
362
362
|
* **按 db 里 <Pin Position> 升序**,虚拟脚(VP_*)永远在最后。
|
|
363
363
|
*
|
|
364
364
|
* 证据:demo.ioc 原序 PC13-TAMPER-RTC(2), PC14-OSC32_IN(3), PC15-OSC32_OUT(4), PD0-OSC_IN(5),
|
|
365
|
-
* PD1-OSC_OUT(6), PA13, PA14, VP_SYS_VS_Systick 正是 Position
|
|
366
|
-
* CubeMX 回写成 PA0-WKUP(10), PA5(15), PA6(16), PA7(17)…PA13, PA14, VP_* ——
|
|
365
|
+
* PD1-OSC_OUT(6), PA13, PA14, VP_SYS_VS_Systick 正是 Position 序;插件追加 PA5/PA6/PA7/PA0 之后
|
|
366
|
+
* CubeMX 回写成 PA0-WKUP(10), PA5(15), PA6(16), PA7(17)…PA13, PA14, VP_* —— 插件尾部追加的顺序被 CubeMX 重排。
|
|
367
367
|
* db 不可用(没装 CubeMX / 查不到这根脚)时保持原序,只在末尾放 VP_*。
|
|
368
368
|
*/
|
|
369
369
|
function sortPinsByPosition(order, positionOf) {
|
|
@@ -403,9 +403,9 @@ function writePinOrder(entries, order, positionOf) {
|
|
|
403
403
|
* 证据:单核族全对——F0/F2/F3/F4/F7/G0/G4/L0/L1/L4/WB/WL3/C0/U0 共 302 份 0 反例,F1 12/12;
|
|
404
404
|
* 差别只在 TIM2…TIM4,TIM15(纯字典序会把 TIM15 排到 TIM2 前)。整语料:纯字典序 375/502、
|
|
405
405
|
* natural 392/502、natural + 伪实例置尾 435/502;剩下的反例全是双核/TrustZone 板
|
|
406
|
-
* (NVIC2 在 NVIC1 前、板名插在中间),CubeMX
|
|
406
|
+
* (NVIC2 在 NVIC1 前、板名插在中间),CubeMX 对这些板另有插入序,不在本项目当前范围(F1)。
|
|
407
407
|
*
|
|
408
|
-
*
|
|
408
|
+
* 插件原来只把新 IP 追加在尾部:只要新 IP 的字典序不在末尾,回写就必然被重排(真机往返 B 里
|
|
409
409
|
* ADC1/DMA 被挪到 NVIC/RCC/SYS 前面,5 条 changedValues、benign=false)。
|
|
410
410
|
*/
|
|
411
411
|
function compareIpInstance(left, right) {
|
|
@@ -460,7 +460,7 @@ function sortIpSlots(entries) {
|
|
|
460
460
|
}
|
|
461
461
|
/**
|
|
462
462
|
* 引脚属性名 → schema spec id。属性键必须登记在 src/data/ioc-schema.ts 里,
|
|
463
|
-
*
|
|
463
|
+
* 否则覆盖率检查会将该键视为未知键报出(这正是插件所需的保护:拼错的名字会被抓到)。
|
|
464
464
|
*/
|
|
465
465
|
const PIN_ATTRIBUTE_SPEC = {
|
|
466
466
|
"GPIO_Label": "pin.gpio_label",
|
|
@@ -526,8 +526,8 @@ function addPin(table, request, profile) {
|
|
|
526
526
|
// 2026-11-02 真机(6.15.0)补充两条:
|
|
527
527
|
// - 写在引脚上的 GPIO_* 属性键,只有同时列进 <pin>.GPIOParameters 才会被保留,
|
|
528
528
|
// 否则 CubeMX 静默删掉(实测 PC13-TAMPER-RTC.PinState 就是这样丢的);
|
|
529
|
-
// - GPIO_Mode / PinState
|
|
530
|
-
//
|
|
529
|
+
// - GPIO_Mode / PinState 的值不被 CubeMX 规范化,写什么回写什么(GPIO_MODE_OUTPUT_OD / GPIO_PIN_SET 都逐字保留),
|
|
530
|
+
// 因此能否表达开漏、初始电平只取决于插件是否写入这两个键。
|
|
531
531
|
const attributes = new Map();
|
|
532
532
|
if (label !== "")
|
|
533
533
|
attributes.set("GPIO_Label", label);
|
|
@@ -590,7 +590,7 @@ function addPin(table, request, profile) {
|
|
|
590
590
|
* 把实例名登记进 Mcu.IP<i>(已有就什么都不做)。
|
|
591
591
|
*
|
|
592
592
|
* 真机证据(F4 板级 .ioc 往返):只写 PA13/PA14 的 Serial_Wire 而不把 SYS 登记进 Mcu.IP<i> 时,
|
|
593
|
-
* CubeMX 会自己补一条 Mcu.IP2=SYS 并把 Mcu.IPNb 从 2 改成 3 —— 也就是"
|
|
593
|
+
* CubeMX 会自己补一条 Mcu.IP2=SYS 并把 Mcu.IPNb 从 2 改成 3 —— 也就是"插件漏了一项",
|
|
594
594
|
* 在 ioc_verify 里表现为 Mcu.IPNb 值被改写 + addedKeys 多一个 Mcu.IP2。补上之后往返才干净。
|
|
595
595
|
*/
|
|
596
596
|
function ensureIpInstance(entries, name) {
|
|
@@ -614,10 +614,10 @@ function ensureIpInstance(entries, name) {
|
|
|
614
614
|
* 真机证据(C0 板级 .ioc 往返,2026-11):C0 的 db 把调试口单列成一个 IP 实例
|
|
615
615
|
* (`STM32C031C(4-6)Tx.xml` 里有 `<IP InstanceName="DEBUG" Name="DEBUG"/>`;F1/F4 的 db 里**没有**这个实例)。
|
|
616
616
|
* 所以只要引脚上有 `PA13.Signal=DEBUG_SWDIO`,CubeMX 回写就会插一条 `Mcu.IP1=DEBUG`(紧跟 CORTEX_M0+`,
|
|
617
|
-
* 正好是 natural 序)并把 `Mcu.IPNb`
|
|
617
|
+
* 正好是 natural 序)并把 `Mcu.IPNb` 加一。插件不写就永远差这一条:`ioc_verify` 的 `addedKeys` 里保留该键,
|
|
618
618
|
* `Mcu.IP1..IP4` 还会整排位移,看起来像"5 个键的值被改写"。
|
|
619
619
|
*
|
|
620
|
-
* 判据用 db 而不是族 id:db 里没有 DEBUG 实例的族(F1/F4
|
|
620
|
+
* 判据用 db 而不是族 id:db 里没有 DEBUG 实例的族(F1/F4)补了反而多写一个 CubeMX 不认的实例。
|
|
621
621
|
*/
|
|
622
622
|
function ensureDebugInstance(entries, facts) {
|
|
623
623
|
if (facts === null || !hasIpInstance(facts, "DEBUG"))
|
|
@@ -632,7 +632,7 @@ function ensureDebugInstance(entries, facts) {
|
|
|
632
632
|
*
|
|
633
633
|
* 真机证据(C0 板级 .ioc 往返,2026-11):只要 .ioc 里有引脚——哪怕只有 PA13/PA14 的 SWD——
|
|
634
634
|
* CubeMX 保存时都会把 MX_GPIO_Init 插到清单**第二位**(SystemClock_Config 之后、CORTEX 之前)。
|
|
635
|
-
* 因为是插在中间而不是追加到末尾,ioc_verify 里"纯追加 MX_*_Init 不算差异"
|
|
635
|
+
* 因为是插在中间而不是追加到末尾,ioc_verify 里"纯追加 MX_*_Init 不算差异"的例外无法覆盖该键,
|
|
636
636
|
* 会记成一条 valueChanged。族模板里本来就有这一项(G0/U0 实测都有),C0 模板是零引脚所以没有。
|
|
637
637
|
*/
|
|
638
638
|
function ensureGpioInitEntry(entries) {
|
|
@@ -644,7 +644,7 @@ function ensureGpioInitEntry(entries) {
|
|
|
644
644
|
if (items.some((item) => item.includes("-MX_GPIO_Init-")))
|
|
645
645
|
return false;
|
|
646
646
|
// 判据是"有引脚"而不是"有 GPIO 引脚":H5 实测纯 SWD(PA13/PA14 的 Serial_Wire)也会被 CubeMX 插进
|
|
647
|
-
// MX_GPIO_Init
|
|
647
|
+
// MX_GPIO_Init;反之 C0 模板零引脚时 CubeMX 不插入,插件插入反而被删掉(两条都来自真机往返)。
|
|
648
648
|
const hasPins = [...entries.keys()].some((key) => key.endsWith(".Mode"));
|
|
649
649
|
if (!hasPins)
|
|
650
650
|
return false;
|
|
@@ -672,15 +672,15 @@ function ensureSerialWire(table, pins) {
|
|
|
672
672
|
}
|
|
673
673
|
table.warnings.push("已删除 " + pin + "(No_Debug 会让 CubeMX 生成 __HAL_AFIO_REMAP_SWJ_DISABLE())");
|
|
674
674
|
}
|
|
675
|
-
//
|
|
675
|
+
// 调试口归属哪个实例由**本族 db** 决定,不能一律写 SYS:
|
|
676
676
|
// - F1/F4 的 db 里调试口就是 SYS(Pin 的 signal 叫 SYS_JTMS-SWDIO),要补 Mcu.IPn=SYS;
|
|
677
|
-
// - C0/U0 的 db
|
|
678
|
-
// ——2026-11 C0 板级 .ioc
|
|
677
|
+
// - C0/U0 的 db 将调试口单列成 DEBUG 实例(signal 叫 DEBUG_SWDIO),此时写 SYS 反而会多出一个实例
|
|
678
|
+
// ——2026-11 C0 板级 .ioc 往返实测:插件写入的 Mcu.IP4=SYS 被 CubeMX 整条删除、IPNb 5→4,
|
|
679
679
|
// ioc_verify 因此报了两条 valueChanged。
|
|
680
680
|
// DEBUG 实例由紧随其后的 ensureDebugInstance 按 db 补,这里只管 SYS。
|
|
681
681
|
const facts = pins.facts;
|
|
682
682
|
const debugSignals = [];
|
|
683
|
-
// preferred
|
|
683
|
+
// preferred 的顺序即目标写法优先级;fallback 是 db 里存在别名笔误时的回退正则。
|
|
684
684
|
const debugPins = [
|
|
685
685
|
{ logical: "PA13", role: "swdio", preferred: ["SYS_JTMS-SWDIO", "DEBUG_SWDIO"], fallback: /SWDIO|JTMS/u },
|
|
686
686
|
{ logical: "PA14", role: "swclk", preferred: ["SYS_JTCK-SWCLK", "DEBUG_SWCLK"], fallback: /SWCLK|JTCK/u },
|
|
@@ -778,7 +778,7 @@ function applyInterrupts(table, requests, context, notes) {
|
|
|
778
778
|
const inIps = context.facts !== null && context.facts.ips.has(name.toUpperCase());
|
|
779
779
|
const inSvd = context.interrupts !== null && context.interrupts.has(name);
|
|
780
780
|
// EXTI 线是按线号分组的(EXTI0…EXTI4 / EXTI9_5 / EXTI15_10),SVD 里就叫这么个名字,
|
|
781
|
-
//
|
|
781
|
+
// 但该名字不是外设实例,db 里查不到;写 pins 的 interrupt 时也是同一名字来源,因此直接放行。
|
|
782
782
|
const isExtiGroup = /^EXTI[0-9]+(?:_[0-9]+)?$/u.test(name);
|
|
783
783
|
if (!CORE_EXCEPTIONS.has(name) && !inIps && !inSvd && !isExtiGroup) {
|
|
784
784
|
if (context.interrupts === null && context.facts === null) {
|
|
@@ -905,7 +905,7 @@ function enablePeripheral(table, request, pinNames, notes, familyId) {
|
|
|
905
905
|
}
|
|
906
906
|
else if (builtin !== null) {
|
|
907
907
|
preset = builtin;
|
|
908
|
-
notes.push("
|
|
908
|
+
notes.push("内置表回退启用 " + preset.name + "(" + preset.label + "):db 派生不可用 —— " + derived.reason);
|
|
909
909
|
}
|
|
910
910
|
else {
|
|
911
911
|
table.errors.push("不能启用 " + JSON.stringify(request.name) + ":" + derived.reason +
|
|
@@ -962,14 +962,14 @@ function enablePeripheral(table, request, pinNames, notes, familyId) {
|
|
|
962
962
|
enableSharedSignal(table, role.shared);
|
|
963
963
|
}
|
|
964
964
|
}
|
|
965
|
-
// 逐字键(DMA 这类键名不受 <ip>.<名字>
|
|
965
|
+
// 逐字键(DMA 这类键名不受 <ip>.<名字> 约束):先写这些键,再统一重算 Dma.RequestsNb。
|
|
966
966
|
for (const raw of preset.rawEntries ?? []) {
|
|
967
967
|
table.entries.set(raw.key, paramOverrides.get(raw.key.replace("Dma.", "").replace(/\.0\./u, ".")) ?? raw.value);
|
|
968
968
|
}
|
|
969
969
|
// G1/G2:DMA 三件套。CubeMX 自己写的是
|
|
970
970
|
// Dma.<IP>.<n>.RequestParameters=Instance,Direction,...,Priority(白名单,与 IPParameters 同机制:
|
|
971
971
|
// 不在名单里的字段会被静默忽略)
|
|
972
|
-
// Dma.Request<i>=<IP
|
|
972
|
+
// Dma.Request<i>=<IP>(把请求号绑定回实例;只有 RequestsNb 时该键只是孤立计数)
|
|
973
973
|
// 语料 504 份里含 DMA 的 17 份全部三件套齐全,richhal.ioc:30-32 是 F1 的实物证据;
|
|
974
974
|
// 另有 64/64 的 Dma.Request<i> 值等于同号 Dma.<IP>.<n> 的 IP 名,且 RequestParameters 列出的
|
|
975
975
|
// 名字与真的写了的键一一对应(0 处不符)。
|
|
@@ -1003,9 +1003,9 @@ function enablePeripheral(table, request, pinNames, notes, familyId) {
|
|
|
1003
1003
|
});
|
|
1004
1004
|
table.entries.set(renderIocKey("dma.request_parameters", { ip: info.ip, n: info.n }), present.join(","));
|
|
1005
1005
|
table.entries.set(renderIocKey("dma.request_index", { n: request }), info.ip);
|
|
1006
|
-
// CubeMX 见到 DMA
|
|
1006
|
+
// CubeMX 见到 DMA 通道就同时打开对应中断(实测 6.15.0 + F1:加一条 ADC1 DMA 后
|
|
1007
1007
|
// 保存,diff 里唯一多出来的键就是 NVIC.DMA1_Channel1_IRQn,值固定这一串)。
|
|
1008
|
-
//
|
|
1008
|
+
// 插件不补该中断时,每次回写都会多一条 added-key 噪声;只在缺失时补,用户设置过的值不覆盖。
|
|
1009
1009
|
const instance = (table.entries.get(renderIocKey("dma.request_group", { ip: info.ip, n: info.n, name: "Instance" })) ?? "").trim();
|
|
1010
1010
|
const channelIrq = renderIocKey("nvic.vector", { name: instance });
|
|
1011
1011
|
if (/^DMA[12]_Channel[0-9]$/u.test(instance) && !table.entries.has(channelIrq)) {
|
|
@@ -1080,7 +1080,7 @@ function enablePeripheral(table, request, pinNames, notes, familyId) {
|
|
|
1080
1080
|
/**
|
|
1081
1081
|
* 自洽校验(都按 CubeMX 的真实推导规则,不是风格洁癖):
|
|
1082
1082
|
* - Mcu.IPNb 必须等于 Mcu.IPn 的条数;
|
|
1083
|
-
* -
|
|
1083
|
+
* - 外设进入 Mcu.IPn 就必须有引脚 .Signal 指向该外设;
|
|
1084
1084
|
* - 多模式外设的引脚还得表达功能:普通外设(USART)用 `.Mode`,共享信号外设(定时器/ADC)
|
|
1085
1085
|
* 用 `SH.<pin信号>.<n>=<IP 信号>,<IP 模式>` —— 两者都缺时 CubeMX 静默丢弃整个外设,不报错。
|
|
1086
1086
|
*/
|
|
@@ -1120,7 +1120,7 @@ function validatePeripheralWiring(entries, warnings, facts) {
|
|
|
1120
1120
|
continue;
|
|
1121
1121
|
const pins = pinsByDevice.get(device) ?? [];
|
|
1122
1122
|
if (pins.length === 0) {
|
|
1123
|
-
warnings.push(device + " 在 Mcu.IPn 里,但没有引脚的 .Signal
|
|
1123
|
+
warnings.push(device + " 在 Mcu.IPn 里,但没有引脚的 .Signal 指向该外设 → CubeMX 会忽略该外设");
|
|
1124
1124
|
continue;
|
|
1125
1125
|
}
|
|
1126
1126
|
const noMode = pins.filter((pin) => {
|
|
@@ -1217,8 +1217,8 @@ export function planIocChanges(request) {
|
|
|
1217
1217
|
warnings.push("这份 .ioc 的换行不一致(既有 CRLF 又有 LF):写回时会统一成多数的那种(CRLF)");
|
|
1218
1218
|
}
|
|
1219
1219
|
else if (source.includes("\n") && !source.includes("\r\n")) {
|
|
1220
|
-
// 纯 LF:CubeMX
|
|
1221
|
-
//
|
|
1220
|
+
// 纯 LF:CubeMX 保存时写 CRLF。本插件保留原样(否则用户第一次 apply 就会看到整文件换行变化),
|
|
1221
|
+
// 但需说明代价——将本插件文件与 CubeMX 另存结果逐字节对比时会差整文件换行(键值不受影响)。
|
|
1222
1222
|
warnings.push("这份 .ioc 是纯 LF 换行(CubeMX 自己保存时用 CRLF):写回保持 LF,逐字节对比 CubeMX 另存的结果会整文件不同");
|
|
1223
1223
|
}
|
|
1224
1224
|
if (!diagnostics.finalNewline) {
|
|
@@ -1241,7 +1241,7 @@ export function planIocChanges(request) {
|
|
|
1241
1241
|
const family = (after.get(renderIocKey("mcu.family")) ?? "").trim();
|
|
1242
1242
|
const familyProfile = family === "" ? null : familyProfileOf(family);
|
|
1243
1243
|
const svdSupported = familyProfile === null || familyProfile.capabilities.svdValidation;
|
|
1244
|
-
// SVD 的中断表先准备好:interrupts
|
|
1244
|
+
// SVD 的中断表先准备好:interrupts 参数需用该表校验中断名,R20 也需要该表(同一个 set 复用,只读一次盘)。
|
|
1245
1245
|
// .ioc 里只有 CPN(STM32F103C8T6),先换成 SVD 的 line(103);没有内置资源时 device 为 null,校验跳过。
|
|
1246
1246
|
let interrupts = null;
|
|
1247
1247
|
const cpn = (after.get(renderIocKey("mcu.cpn")) ?? "").trim();
|
|
@@ -1258,7 +1258,7 @@ export function planIocChanges(request) {
|
|
|
1258
1258
|
}
|
|
1259
1259
|
}
|
|
1260
1260
|
// 引脚名解析器(本机 db)先建出来:Serial Wire 要按该芯片的脚名/信号名写,
|
|
1261
|
-
//
|
|
1261
|
+
// 引脚表排序需要 Position,外设预设需要 db,都依赖该 db。该函数只读 db,不改 .ioc。
|
|
1262
1262
|
const pinNames = createPinNameResolver({ mcuName: (after.get(renderIocKey("mcu.name")) ?? "").trim(), family });
|
|
1263
1263
|
// db 指纹写进报告:任何一条返回路径(包括"没有变化"、失败)都要带上,报 bug 时能一眼看出 db 版本差异。
|
|
1264
1264
|
empty.dbVersion = pinNames.db?.version ?? "";
|
|
@@ -1271,7 +1271,7 @@ export function planIocChanges(request) {
|
|
|
1271
1271
|
if (ensureDebugInstance(pinTable.entries, pinNames.facts)) {
|
|
1272
1272
|
notes.push("把 DEBUG 登记进 Mcu.IP<i>:本族 db 把调试口单列成实例 DEBUG,CubeMX 回写时自己会补(C0 实证)");
|
|
1273
1273
|
}
|
|
1274
|
-
//
|
|
1274
|
+
// 有引脚就必须有 MX_GPIO_Init 这一项(C0 模板零引脚缺少该项,CubeMX 保存时插在第二位)。
|
|
1275
1275
|
if (pinTable.order.length > 0 && ensureGpioInitEntry(pinTable.entries)) {
|
|
1276
1276
|
notes.push("ProjectManager.functionlistsort 补上 2-MX_GPIO_Init-GPIO-false-HAL-true:有引脚时 CubeMX 会自己插这一项(C0 实证)");
|
|
1277
1277
|
}
|
|
@@ -1293,12 +1293,12 @@ export function planIocChanges(request) {
|
|
|
1293
1293
|
}
|
|
1294
1294
|
// 引脚表变化过才重写 Mcu.PinN。
|
|
1295
1295
|
// 为什么不再按"有没有 .Signal"过滤:F1 的 PB2 在 CubeMX 里只有 PB2.Mode=B2-BOOT1(BOOT1 是复用功能,
|
|
1296
|
-
// 不带 .Signal)。按 .Signal
|
|
1296
|
+
// 不带 .Signal)。按 .Signal 过滤会将该引脚从 Mcu.PinN 里静默剔除——PinsNb 缩水,PB2.Mode / PB2.GPIO_*
|
|
1297
1297
|
// 成了没有引脚指向的孤儿键,CubeMX 下次打开就丢这段配置。所以:已在表里的引脚一个都不删,只追加。
|
|
1298
1298
|
// 虚拟引脚(VP_*)的清理归 ensureSerialWire 管,这里不掺和。
|
|
1299
|
-
// 排序:CubeMX
|
|
1299
|
+
// 排序:CubeMX 按 db 的 <Pin Position> 升序写 Mcu.Pin<i>(虚拟脚在最后),本插件以前只会尾部追加,
|
|
1300
1300
|
// 所以每次加引脚都会多一条"引脚表被重排"的真 diff(三次真机探针一致)。
|
|
1301
|
-
// 没有 db 时所有脚都查不到 Position
|
|
1301
|
+
// 没有 db 时所有脚都查不到 Position:排序退化为「原序 + 虚拟脚挪到最后」,仍是所需结果
|
|
1302
1302
|
// (原文件本来就是 CubeMX 写的,顺序已经对;VP_* 无论哪种情况都在最后)。
|
|
1303
1303
|
const positionOf = (pin) => {
|
|
1304
1304
|
const fact = pinNames.facts === null ? undefined : pinNames.facts.pins.get(pin);
|
|
@@ -1343,12 +1343,12 @@ export function planIocChanges(request) {
|
|
|
1343
1343
|
// - pllmul 模型(F0/F1/L0…)且有该族总线上限 → 直接规划(F1 的派生结果与手写表逐项相等,已在单测里钉住);
|
|
1344
1344
|
// - direct 模型(C0:没有 PLL,SYSCLK 直接取源)→ 走 clock-direct.ts;
|
|
1345
1345
|
// - unknown(H7/U5 分相 PLL 这类还没实现的模型)→ 明确拒绝,不套别的族的键名;
|
|
1346
|
-
// - 读不到 db
|
|
1346
|
+
// - 读不到 db(未安装 CubeMX)→ F1 使用 F1_FACTS 回退,其它族拒绝。
|
|
1347
1347
|
const clockDb = pinNames.facts === null || pinNames.db === null ? null : readClockDbFacts(pinNames.db, pinNames.facts);
|
|
1348
1348
|
const clockDbFacts = clockDb === null ? null : clockFactsFromDb(clockDb, family === "" ? "STM32F1" : family);
|
|
1349
1349
|
const clockSupported = familyProfile === null || familyProfile.capabilities.clockPlan || clockDbFacts !== null;
|
|
1350
1350
|
// 拒绝原因按「先看事实、再看族画像」排:族画像里的 clockPlan 是早期「只按 F1 手写表」的粗粒度闸门,
|
|
1351
|
-
// 现在 24 个族都能从 db
|
|
1351
|
+
// 现在 24 个族都能从 db 现算,以该闸门为原因会掩盖真正缺口(H7 是分相 PLL 未实现,不是「只支持 F1」)。
|
|
1352
1352
|
const clockRefusal = clockSupported
|
|
1353
1353
|
? ""
|
|
1354
1354
|
: (clockDb === null
|
|
@@ -1395,7 +1395,7 @@ export function planIocChanges(request) {
|
|
|
1395
1395
|
warnings.push(...clockPlan.warnings);
|
|
1396
1396
|
if (clockPlan.note !== "")
|
|
1397
1397
|
notes.push("时钟:" + clockPlan.note);
|
|
1398
|
-
// 派生频率键(RCC.<外设>Freq_Value
|
|
1398
|
+
// 派生频率键(RCC.<外设>Freq_Value)的“跟随改写”需要在写键之前取快照:该规则依赖“旧值等于哪个时钟域”
|
|
1399
1399
|
// 判断该跟着谁走,新旧值都从这张表里读。详见 clock-derived.ts 的注释。
|
|
1400
1400
|
const beforeClockWrite = new Map(after);
|
|
1401
1401
|
for (const item of clockPlan.entries)
|
|
@@ -1426,7 +1426,7 @@ export function planIocChanges(request) {
|
|
|
1426
1426
|
}
|
|
1427
1427
|
for (const ip of instances) {
|
|
1428
1428
|
// 只补真外设实例(ADC1/TIM3/USART1…)。NVIC / RCC / SYS / DMA 这些是"伪实例",
|
|
1429
|
-
//
|
|
1429
|
+
// 这些实例的键(NVIC.TIM2_IRQn、RCC.SYSCLKSource…)不属于 IPParameters 白名单,补进去反而写错。
|
|
1430
1430
|
if (!/^[A-Z]+[0-9]+$/u.test(ip))
|
|
1431
1431
|
continue;
|
|
1432
1432
|
const listed = (after.get(ip + ".IPParameters") ?? "").split(",").map((item) => item.trim()).filter((item) => item !== "");
|
|
@@ -1448,25 +1448,25 @@ export function planIocChanges(request) {
|
|
|
1448
1448
|
after.set(ip + ".IPParameters", [...listed, ...added].join(","));
|
|
1449
1449
|
notes.push("自动补 " + ip + ".IPParameters:" + added.join("、") + "(不补会被 CubeMX 静默丢弃)");
|
|
1450
1450
|
}
|
|
1451
|
-
// schema 覆盖率闸门(两道,S5 收尾)。放在 C6 之后:自动补 IPParameters
|
|
1451
|
+
// schema 覆盖率闸门(两道,S5 收尾)。放在 C6 之后:自动补 IPParameters 会新增一个键,该键同样需要审查。
|
|
1452
1452
|
// 第一道:键形状必须在真值表里(uncovered 就是"完全没登记的形状")。
|
|
1453
1453
|
// 第二道:namespace 级命中({ip}.{name} / Dma.{ip}.{n}.{name} 这类模板)只证明了"前缀.某东西",
|
|
1454
1454
|
// 拼错的键也能命中;所以要按上下文逐条判——是不是 Mcu.IP<i> 里真实启用的实例、参数名在不在
|
|
1455
1455
|
// db 的 RefParameter 清单里、ip 位写的是不是引脚名、Dma 参数在不在白名单里。
|
|
1456
1456
|
// 只审"这次计划写或改的键":文件里原有的键是 CubeMX 自己写的,审了只会误报。
|
|
1457
|
-
//
|
|
1457
|
+
// 仍然只告警、不硬失败——老工程模板可能带本插件未登记的键,阻断 plan 比漏报更糟;
|
|
1458
1458
|
// 真正的闸门在单测里(schema 覆盖率 0 uncovered + 每类写键点都有 spec)。
|
|
1459
1459
|
// C7:Mcu.IP<i> 顺序。只有这次动过 IP 槽位才重排——CubeMX 回写时按 natural 序重排
|
|
1460
|
-
// (见 sortIpSlots
|
|
1460
|
+
// (见 sortIpSlots 注释),不排序等于每次启用字典序靠前的外设都制造 5 条假 diff。
|
|
1461
1461
|
const ipTouched = [...after.keys()].some((key) => matchIocKey(key)?.spec.id === "mcu.ip_index" && after.get(key) !== before.get(key));
|
|
1462
1462
|
if (ipTouched && sortIpSlots(after)) {
|
|
1463
|
-
notes.push("按 CubeMX 的 natural 序重排 Mcu.IP<i>(TIM2…TIM4,TIM15
|
|
1463
|
+
notes.push("按 CubeMX 的 natural 序重排 Mcu.IP<i>(TIM2…TIM4,TIM15;板名置尾):CubeMX 回写时也按此顺序");
|
|
1464
1464
|
}
|
|
1465
1465
|
const touched = [...after.keys()].filter((key) => after.get(key) !== before.get(key)).sort(compareIocKeys);
|
|
1466
1466
|
const coverage = iocSchemaCoverage(touched);
|
|
1467
1467
|
if (coverage.uncovered.length > 0) {
|
|
1468
1468
|
warnings.push("[SCHEMA] " + String(coverage.uncovered.length) + " 个键不在 .ioc schema 真值表里(" +
|
|
1469
|
-
coverage.uncovered.slice(0, 5).join("、") + "):可能是 CubeMX
|
|
1469
|
+
coverage.uncovered.slice(0, 5).join("、") + "):可能是 CubeMX 新版本加的键,也可能是键名拼写有误" +
|
|
1470
1470
|
"——拼错的键会被 CubeMX 静默忽略,确认后请补进 src/data/ioc-schema.ts");
|
|
1471
1471
|
}
|
|
1472
1472
|
if (coverage.weak.length > 0) {
|
|
@@ -1511,7 +1511,7 @@ export function planIocChanges(request) {
|
|
|
1511
1511
|
duplicated.map((change) => change.key + "×" + String(diagnostics.duplicates.get(change.key) ?? 0)).join("、") +
|
|
1512
1512
|
"。先在 CubeMX 里重新保存一次把重复键清掉,再来改");
|
|
1513
1513
|
}
|
|
1514
|
-
//
|
|
1514
|
+
// 安全闸:这两条是由已发生问题得出的硬约束,不满足则不生成 plan。
|
|
1515
1515
|
const candidateText = renderIocText(source, planned);
|
|
1516
1516
|
const summary = summarizeIoc(candidateText, iocPath);
|
|
1517
1517
|
if (!summary.debug.serialWire) {
|