dsh-stm32 0.1.6 → 0.1.8
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 +410 -517
- package/README_EN.md +410 -510
- package/client/client.js +4363 -24
- package/docs/reading-guide.md +62 -0
- package/lib/client.js +4363 -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/artifacts.js +123 -0
- package/lib/engine/assets.js +5 -5
- package/lib/engine/breakpoint-hits.js +73 -0
- package/lib/engine/breakpoints.js +5 -5
- package/lib/engine/build.js +73 -3
- package/lib/engine/cache.js +4 -4
- package/lib/engine/channel-tap.js +227 -0
- package/lib/engine/channels.js +48 -0
- 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/clocks.js +192 -0
- 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 +58 -13
- package/lib/engine/debug.js +3 -3
- package/lib/engine/doctor.js +12 -12
- package/lib/engine/download.js +1 -1
- package/lib/engine/event-bus.js +158 -0
- package/lib/engine/event-log.js +335 -0
- package/lib/engine/facts-acquire.js +3 -3
- package/lib/engine/fault-hints.js +146 -0
- 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/interrupts.js +247 -0
- package/lib/engine/ioc-diff.js +369 -0
- package/lib/engine/ioc-plan.js +52 -52
- package/lib/engine/ioc-rules.js +9 -9
- package/lib/engine/ioc-sync.js +58 -0
- package/lib/engine/ioc-verify.js +34 -34
- package/lib/engine/msys2-install.js +81 -56
- package/lib/engine/panel-actions.js +103 -0
- package/lib/engine/pinout.js +140 -0
- package/lib/engine/probe-error.js +8 -8
- package/lib/engine/probe-info.js +95 -0
- package/lib/engine/probe-session.js +3 -3
- package/lib/engine/probe.js +47 -50
- package/lib/engine/progress.js +99 -0
- package/lib/engine/project-conf.js +199 -0
- 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/session-context.js +19 -0
- package/lib/engine/source-slice.js +59 -0
- 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/tool-events.js +119 -0
- 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/watch-admin.js +101 -0
- package/lib/engine/watch-record.js +39 -0
- package/lib/engine/watch-recorder.js +116 -0
- package/lib/engine/web-api.js +887 -5
- package/lib/engine/web-routes.js +18 -1
- package/lib/engine/workspace-memo.js +41 -0
- package/lib/engine/xcube-catalog.js +1 -1
- package/lib/index.js +72 -29
- 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 +10 -1
- package/lib/tools/ioc-plan.js +1 -1
- package/lib/tools/ioc-verify.js +11 -11
- package/lib/tools/project-create.js +32 -4
- package/lib/tools/project-dir.js +8 -2
- package/lib/tools/regs.js +10 -10
- package/lib/tools/route-plan.js +9 -9
- package/lib/tools/rtt.js +17 -9
- package/lib/tools/serial.js +30 -8
- package/lib/tools/watch.js +24 -2
- package/package.json +70 -70
- package/templates/scaffold/RTT.md +26 -34
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* L1
|
|
2
|
+
* L1:无法安装(或不应由插件代装)的组件,如何清晰说明。
|
|
3
3
|
*
|
|
4
4
|
* 门禁把缺件分成两档,因为这两档的"下一步"完全不同:
|
|
5
5
|
* auto —— MSYS2 里一条 pacman 就能补(gcc / gdb / openocd / cmake / ninja),
|
|
6
6
|
* 插件能跑 stm32_env_install 出计划、确认后自己装;
|
|
7
7
|
* manual —— 装不了或不该代装:STM32CubeMX 是 InstallAnywhere 的 GUI 向导(要 ST 账号 +
|
|
8
8
|
* 同意许可),固件包只由 CubeMX 的包管理器维护(st.com 包清单 + 22 个 git 子模块)。
|
|
9
|
-
*
|
|
9
|
+
* 这两种只能提供分步指引,插件至多将其路径写入配置。
|
|
10
10
|
*
|
|
11
11
|
* 本文件只有文案与元数据,不起进程、不读盘,便于单测与审计(改文案不用碰引擎)。
|
|
12
12
|
*/
|
|
@@ -37,7 +37,7 @@ export function cubeMxGuide() {
|
|
|
37
37
|
label: CUBEMX_LABEL,
|
|
38
38
|
installability: "manual",
|
|
39
39
|
why: "CubeMX 是 GUI 安装向导,没有官方静默参数,下载前还要登录 ST 账号并同意许可,"
|
|
40
|
-
+ "
|
|
40
|
+
+ "插件代为安装等于代用户确认许可、代用户输入账号 —— 此步骤不执行。",
|
|
41
41
|
sizeHint: "安装包数百 MB,装完约 1.5 GB(不含固件包);固件包另算,见固件包那条指引(实测 250 MB – 1.7 GB)。",
|
|
42
42
|
needsAccount: true,
|
|
43
43
|
steps: [
|
|
@@ -47,7 +47,7 @@ export function cubeMxGuide() {
|
|
|
47
47
|
},
|
|
48
48
|
{
|
|
49
49
|
title: "GUI 装一遍(默认选项即可)",
|
|
50
|
-
detail: "
|
|
50
|
+
detail: "双击安装包按向导走完;安装盘符不限,不要放在受保护目录(例如 C:\\Program Files 需要管理员权限,插件写固件包时会失败)。",
|
|
51
51
|
},
|
|
52
52
|
{
|
|
53
53
|
title: "把安装根写进配置",
|
|
@@ -55,7 +55,7 @@ export function cubeMxGuide() {
|
|
|
55
55
|
},
|
|
56
56
|
{
|
|
57
57
|
title: "自检",
|
|
58
|
-
detail: "stm32_doctor 的 tools 里 cubemx 与 cubemx-java 都应带 path;缺 jre
|
|
58
|
+
detail: "stm32_doctor 的 tools 里 cubemx 与 cubemx-java 都应带 path;缺 jre 时无头生成会直接报 java 找不到。",
|
|
59
59
|
},
|
|
60
60
|
],
|
|
61
61
|
verify: "stm32_doctor → capabilities.generate 为 true(cubemx 与 cubemx-java 都找到)。",
|
|
@@ -71,7 +71,7 @@ export function familyPrefix(family) {
|
|
|
71
71
|
/**
|
|
72
72
|
* 各系列的固件包实测体积(2026-10 本机 D:\app\STM32CubeMX\Repository 直接量的)。
|
|
73
73
|
*
|
|
74
|
-
*
|
|
74
|
+
* 固定单一数字不适用于其他系列:F1 293 MB、G4 471 MB、F4 1.67 GB,相差 6 倍。
|
|
75
75
|
* 表里没有的系列给区间,不给具体数字。
|
|
76
76
|
*/
|
|
77
77
|
const FIRMWARE_SIZE_HINTS = {
|
|
@@ -84,8 +84,8 @@ const FIRMWARE_SIZE_HINTS = {
|
|
|
84
84
|
L0: "258 MB / 17,504 个文件(v1.12.4 实测);装完占盘约 258 MB。",
|
|
85
85
|
L4: "约 300 MB / 两万个文件;装完占盘约 300 MB。",
|
|
86
86
|
};
|
|
87
|
-
const FIRMWARE_SIZE_FALLBACK = "一个系列通常 250 MB – 1.7 GB /
|
|
88
|
-
/**
|
|
87
|
+
const FIRMWARE_SIZE_FALLBACK = "一个系列通常 250 MB – 1.7 GB / 一万到四万个文件(不同系列差异较大,最多相差 6 倍);装完占盘同量级。";
|
|
88
|
+
/** 固件包体积提示:已知系列给精确值、未知系列给区间(不将 F1 的数字套用到 H7)。 */
|
|
89
89
|
export function firmwareSizeHint(family) {
|
|
90
90
|
const key = family.trim().toUpperCase();
|
|
91
91
|
return FIRMWARE_SIZE_HINTS[key] ?? FIRMWARE_SIZE_FALLBACK;
|
|
@@ -94,9 +94,9 @@ export function firmwareSizeHint(family) {
|
|
|
94
94
|
* 固件包(HAL + CMSIS + startup)的安装指引。
|
|
95
95
|
*
|
|
96
96
|
* 为什么不做成自动下载(2026-10 取证):GitHub 上 STMicroelectronics/STM32CubeF1 有 v1.8.7 标签,
|
|
97
|
-
*
|
|
98
|
-
* Drivers/STM32F1xx_HAL_Driver
|
|
99
|
-
*
|
|
97
|
+
* 但主仓库包含 22 个 git 子模块,tarball 里 Drivers/CMSIS/Device/ST/STM32F1xx 与
|
|
98
|
+
* Drivers/STM32F1xx_HAL_Driver 是**空目录**;拼接出的包 CubeMX 是否识别尚未验证。
|
|
99
|
+
* 所以现在归入 manual:由 CubeMX 自身的包管理器安装(其写入的 package.xml / 包清单才是权威)。
|
|
100
100
|
*/
|
|
101
101
|
export function firmwareGuide(input) {
|
|
102
102
|
const prefix = familyPrefix(input.family);
|
|
@@ -109,17 +109,17 @@ export function firmwareGuide(input) {
|
|
|
109
109
|
label: "固件包 " + name,
|
|
110
110
|
installability: "manual",
|
|
111
111
|
why: "固件包不在 CubeMX 安装包里,而且不是单个压缩包:HAL 驱动、CMSIS 设备头、启动文件分在不同的 git 仓库里,"
|
|
112
|
-
+ "GitHub 的源码压缩包拿到的是空目录。可靠的来源只有 CubeMX
|
|
112
|
+
+ "GitHub 的源码压缩包拿到的是空目录。可靠的来源只有 CubeMX 自己的包管理器(由 CubeMX 写入包清单与 package.xml)。",
|
|
113
113
|
sizeHint: firmwareSizeHint(input.family),
|
|
114
114
|
needsAccount: true,
|
|
115
115
|
steps: [
|
|
116
116
|
{
|
|
117
117
|
title: autoDownloadable
|
|
118
|
-
? "
|
|
119
|
-
: "
|
|
118
|
+
? "先试插件代下载(该系列已接入)"
|
|
119
|
+
: "插件尚不支持该系列代下载",
|
|
120
120
|
detail: autoDownloadable
|
|
121
|
-
? "调 stm32_firmware_install(family 给 " + input.family + ",dryRun:false + confirm:true):插件从 GitHub
|
|
122
|
-
: "目前只有 F1
|
|
121
|
+
? "调 stm32_firmware_install(family 给 " + input.family + ",dryRun:false + confirm:true):插件从 GitHub 拉取 HAL 驱动与 CMSIS 设备两个子模块仓库 + 内核头,自行补齐 package.xml,实测 CubeMX 可识别;约 2 MB,数十秒。拉取失败或需使用官方包时,按下面三步操作。"
|
|
122
|
+
: "目前只有 F1 接入自动下载(其余系列按同样字段补充一条即可);该系列请使用下面的 CubeMX 包管理器。",
|
|
123
123
|
},
|
|
124
124
|
{
|
|
125
125
|
title: "在 CubeMX 里打开包管理器",
|
|
@@ -131,7 +131,7 @@ export function firmwareGuide(input) {
|
|
|
131
131
|
},
|
|
132
132
|
{
|
|
133
133
|
title: "离线机器:整目录拷贝",
|
|
134
|
-
detail: "
|
|
134
|
+
detail: "从联网机器把 " + name + " 整个目录(或整个 Repository 目录)拷到目标机同一位置即可,不需要重装 CubeMX。",
|
|
135
135
|
},
|
|
136
136
|
{
|
|
137
137
|
title: "自检",
|
|
@@ -142,7 +142,7 @@ export function firmwareGuide(input) {
|
|
|
142
142
|
};
|
|
143
143
|
}
|
|
144
144
|
/**
|
|
145
|
-
* 组件 id → 指引;auto
|
|
145
|
+
* 组件 id → 指引;auto 组件无指引(走 stm32_env_install)。cubemx 与 cubemx-java 共用一份。
|
|
146
146
|
*
|
|
147
147
|
* firmware 需要族名/包名/仓库目录才说得具体,所以第二个参数是可选的补充信息:
|
|
148
148
|
* 调用方(route_plan)手里有这些字段就传,只拿组件 id 的人(门禁、命令卡)也能拿到通用指引 ——
|
package/lib/data/ioc-presets.js
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
* L2 数据:`.ioc` 外设预设 —— "启用一个外设"到底要写哪些键。
|
|
3
3
|
*
|
|
4
4
|
* 为什么必须做成预设:CubeMX **不是**「读到 USART1.VirtualMode 就建 USART1」。
|
|
5
|
-
*
|
|
5
|
+
* CubeMX 按「某根脚的 Mode + Signal」推导复用模式,再核对 Mcu.IPn 中有该实例,才生成
|
|
6
6
|
* MX_xxx_Init。实测(C8T6 + CubeMX 6.15.0 + STM32Cube_FW_F1_V1.8.7):只写
|
|
7
7
|
* Mcu.IPn=USART1 + USART1.IPParameters/VirtualMode + PA9.Signal=USART1_TX 时,
|
|
8
8
|
* CubeMX 静默丢弃整个 USART1(生成结果里没有 MX_USART1_UART_Init,
|
|
@@ -16,9 +16,9 @@
|
|
|
16
16
|
* 换族时按同样的规则加一份表即可(`family` 字段是唯一的族相关入口)。
|
|
17
17
|
*/
|
|
18
18
|
/**
|
|
19
|
-
*
|
|
19
|
+
* 族相关的引脚别名:**离线回退表**,仅在读不到 CubeMX db 时使用。
|
|
20
20
|
*
|
|
21
|
-
* 正常路径是 src/engine/ioc-plan.ts 的 createPinNameResolver
|
|
21
|
+
* 正常路径是 src/engine/ioc-plan.ts 的 createPinNameResolver:该解析器按 .ioc 里的 Mcu.Name 去本机
|
|
22
22
|
* CubeMX 的 `db/mcu/<Mcu.Name>.xml` 查真实引脚名(R16),db 里叫什么就写什么。
|
|
23
23
|
* 这张表只收 F1 的 6 根带后缀的脚(PA0→PA0-WKUP、PC13→PC13-TAMPER-RTC、PC14/PC15、PD0/PD1),
|
|
24
24
|
* 没装 CubeMX 或 db 里没有这颗时才会用到;CubeMX 换版本后 db 名可能变,那时这里就会写错脚,
|
package/lib/data/ioc-schema.js
CHANGED
|
@@ -13,10 +13,10 @@
|
|
|
13
13
|
*
|
|
14
14
|
* 约定:
|
|
15
15
|
* - key 用占位符模板,{pin} {index} {ip} {name} {n} {signal} 会被编译成正则分组,{*} 是 catch-all(不取参);
|
|
16
|
-
* - writer 为 null
|
|
16
|
+
* - writer 为 null 表示「由 CubeMX 写入,本插件有意不写」,并在 trigger 中说明原因;
|
|
17
17
|
* - rules 关联 docs 里的规则号(R6/R7/R22/R23…),规则与 schema 互为索引。
|
|
18
18
|
*/
|
|
19
|
-
/** 真值表本体(49
|
|
19
|
+
/** 真值表本体(49 条,按匹配优先级排列:先匹配者生效——具体模板在前,`{ip}.{name}` 这类回退模板在后)。 */
|
|
20
20
|
export const SPECS = [
|
|
21
21
|
{
|
|
22
22
|
"id": "mcu.cpn",
|
|
@@ -24,7 +24,7 @@ export const SPECS = [
|
|
|
24
24
|
"key": "Mcu.CPN",
|
|
25
25
|
"valueKind": "text",
|
|
26
26
|
"valueNote": "芯片订货号(STM32F103C8Tx)。",
|
|
27
|
-
"trigger": "恒写(新建工程时由 CubeMX
|
|
27
|
+
"trigger": "恒写(新建工程时由 CubeMX 写入,本插件仅替换模板中已有的值)。",
|
|
28
28
|
"order": "dictionary",
|
|
29
29
|
"evidence": [
|
|
30
30
|
"jar.md:66-70",
|
|
@@ -38,7 +38,7 @@ export const SPECS = [
|
|
|
38
38
|
"key": "Mcu.Name",
|
|
39
39
|
"valueKind": "text",
|
|
40
40
|
"valueNote": "db 里的 Mcu.Name(STM32F103C8Tx)。",
|
|
41
|
-
"trigger": "
|
|
41
|
+
"trigger": "恒写;引脚/信号校验均以此为准。",
|
|
42
42
|
"order": "dictionary",
|
|
43
43
|
"evidence": [
|
|
44
44
|
"jar.md:66-70",
|
|
@@ -286,7 +286,7 @@ export const SPECS = [
|
|
|
286
286
|
"key": "{pin}.GPIO_ModeDefaultEXTI",
|
|
287
287
|
"valueKind": "enum",
|
|
288
288
|
"valueNote": "GPIO_MODE_IT_RISING / GPIO_MODE_IT_FALLING / GPIO_MODE_IT_RISING_FALLING(语料只有这三个 token)。",
|
|
289
|
-
"trigger": "配了 EXTI 才写,并同时进 GPIOParameters
|
|
289
|
+
"trigger": "配了 EXTI 才写,并同时进 GPIOParameters;缺少该键时 CubeMX 不识别该引脚的 EXTI(R23)。",
|
|
290
290
|
"order": "dictionary",
|
|
291
291
|
"evidence": [
|
|
292
292
|
"语料 GPIO_ModeDefaultEXTI 318 次",
|
|
@@ -304,7 +304,7 @@ export const SPECS = [
|
|
|
304
304
|
"key": "{pin}.GPIO_ModeDefaultPP",
|
|
305
305
|
"valueKind": "enum",
|
|
306
306
|
"valueNote": "多模式引脚的上电默认模式。",
|
|
307
|
-
"trigger": "
|
|
307
|
+
"trigger": "本插件不写(CubeMX 需要时自行写入);语料 90 次。",
|
|
308
308
|
"order": "dictionary",
|
|
309
309
|
"evidence": [
|
|
310
310
|
"语料 90 次"
|
|
@@ -317,7 +317,7 @@ export const SPECS = [
|
|
|
317
317
|
"key": "{pin}.GPIO_ModeDefaultOutputPP",
|
|
318
318
|
"valueKind": "enum",
|
|
319
319
|
"valueNote": "输出脚的默认模式。",
|
|
320
|
-
"trigger": "
|
|
320
|
+
"trigger": "本插件不写;语料 418 次。",
|
|
321
321
|
"order": "dictionary",
|
|
322
322
|
"evidence": [
|
|
323
323
|
"语料 418 次"
|
|
@@ -330,7 +330,7 @@ export const SPECS = [
|
|
|
330
330
|
"key": "{pin}.PinAttribute",
|
|
331
331
|
"valueKind": "text",
|
|
332
332
|
"valueNote": "引脚属性标记字符串。",
|
|
333
|
-
"trigger": "
|
|
333
|
+
"trigger": "本插件不写;语料 4,763 次。",
|
|
334
334
|
"order": "dictionary",
|
|
335
335
|
"evidence": [
|
|
336
336
|
"语料 4,763 次"
|
|
@@ -396,7 +396,7 @@ export const SPECS = [
|
|
|
396
396
|
"key": "NVIC.PriorityGroup",
|
|
397
397
|
"valueKind": "enum",
|
|
398
398
|
"valueNote": "NVIC_PRIORITYGROUP_0..4。",
|
|
399
|
-
"trigger": "CubeMX
|
|
399
|
+
"trigger": "CubeMX 恒写;本插件不写(模板已含)。",
|
|
400
400
|
"order": "dictionary",
|
|
401
401
|
"evidence": [
|
|
402
402
|
"jar.md:128"
|
|
@@ -409,7 +409,7 @@ export const SPECS = [
|
|
|
409
409
|
"key": "NVIC.ForceEnableDMAVector",
|
|
410
410
|
"valueKind": "bool",
|
|
411
411
|
"valueNote": "true / false。",
|
|
412
|
-
"trigger": "CubeMX
|
|
412
|
+
"trigger": "CubeMX 恒写;本插件不写。",
|
|
413
413
|
"order": "dictionary",
|
|
414
414
|
"evidence": [
|
|
415
415
|
"jar.md:133"
|
|
@@ -422,7 +422,7 @@ export const SPECS = [
|
|
|
422
422
|
"key": "NVIC.TimeBase",
|
|
423
423
|
"valueKind": "text",
|
|
424
424
|
"valueNote": "时基用的向量名或 None。",
|
|
425
|
-
"trigger": "CubeMX
|
|
425
|
+
"trigger": "CubeMX 恒写;本插件不写。",
|
|
426
426
|
"order": "dictionary",
|
|
427
427
|
"evidence": [
|
|
428
428
|
"jar.md:129"
|
|
@@ -535,7 +535,7 @@ export const SPECS = [
|
|
|
535
535
|
"key": "{ip}.IPParametersWithoutCheck",
|
|
536
536
|
"valueKind": "csv",
|
|
537
537
|
"valueNote": "不做 db 校验的参数名单。",
|
|
538
|
-
"trigger": "
|
|
538
|
+
"trigger": "本插件不写(CubeMX 极少写入,且仅非空时写)。",
|
|
539
539
|
"order": "insertion",
|
|
540
540
|
"evidence": [
|
|
541
541
|
"jar.md:106"
|
|
@@ -595,7 +595,7 @@ export const SPECS = [
|
|
|
595
595
|
"key": "RCC.{member}",
|
|
596
596
|
"valueKind": "text",
|
|
597
597
|
"valueNote": "时钟树派生键(SYSCLKFreq_VALUE、PLLMUL、APB1Freq_Value…)。成员名是 [A-Za-z0-9_]+,取值由 RCC 树决定。",
|
|
598
|
-
"trigger": "由 clock-plan.ts 按 RCC
|
|
598
|
+
"trigger": "由 clock-plan.ts 按 RCC 树逐项重算;此表覆盖全部成员名,避免覆盖率检查将其视为未知键。S5 收尾将原来的 {*} 全通配改为 {member}:既能渲染键名(renderIocKey 现在拼得出 RCC.SYSCLKFreq_VALUE),也固定住「RCC.」这个命名空间本身(RCCF.X 不再命中)。",
|
|
599
599
|
"order": "dictionary",
|
|
600
600
|
"evidence": [
|
|
601
601
|
"jar.md:118-121(RCCService 自己写)",
|
|
@@ -609,7 +609,7 @@ export const SPECS = [
|
|
|
609
609
|
"key": "ProjectManager.functionlistsort",
|
|
610
610
|
"valueKind": "csv",
|
|
611
611
|
"valueNote": "生成时按序调用的初始化清单:序号-MX_xxx_Init-IP-<bool>-HAL-<bool>。",
|
|
612
|
-
"trigger": "
|
|
612
|
+
"trigger": "本插件有意不写:CubeMX 保存时按既有编号自行追加,且每个外设的函数名后缀不统一(USART1→MX_USART1_UART_Init,TIM2→MX_TIM2_Init),猜测错误会破坏生成顺序。ioc_verify 将其单独归到 autoAddedFunctions。",
|
|
613
613
|
"order": "sequence",
|
|
614
614
|
"evidence": [
|
|
615
615
|
"jar.md:212",
|
|
@@ -623,7 +623,7 @@ export const SPECS = [
|
|
|
623
623
|
"key": "ProjectManager.{name}",
|
|
624
624
|
"valueKind": "text",
|
|
625
625
|
"valueNote": "工程管理项:ProjectName、TargetToolchain、KeepUserCode、HeapSize、MainLocation、DeviceId…(成员名就是 CubeMX 的字段名)。",
|
|
626
|
-
"trigger": "
|
|
626
|
+
"trigger": "本插件不写(仅在 apply 前读取 ProjectManager.KeepUserCode 作为安全闸);CubeMX 每次保存都会写一整组。此前这些键被 {ip}.{name} 回退为 periph.parameter,等于把工程配置误记成外设参数——分出来之后,{ip}.{name} 命中时才能按「是否为真实外设」判定拼写错误。",
|
|
627
627
|
"order": "dictionary",
|
|
628
628
|
"evidence": [
|
|
629
629
|
"语料 65 行 / 2 份 board 级文件(34 个不同成员)",
|
|
@@ -637,7 +637,7 @@ export const SPECS = [
|
|
|
637
637
|
"key": "MxCube.Version",
|
|
638
638
|
"valueKind": "text",
|
|
639
639
|
"valueNote": "写这份 .ioc 的 CubeMX 版本(6.15.0)。",
|
|
640
|
-
"trigger": "
|
|
640
|
+
"trigger": "本插件不修改(修改等于伪造版本,会影响 CubeMX 的兼容分支)。",
|
|
641
641
|
"order": "dictionary",
|
|
642
642
|
"evidence": [
|
|
643
643
|
"语料 504 份均带(4.5.0 … 4.21.0)"
|
|
@@ -650,7 +650,7 @@ export const SPECS = [
|
|
|
650
650
|
"key": "KeepUserPlacement",
|
|
651
651
|
"valueKind": "bool",
|
|
652
652
|
"valueNote": "生成时是否保留用户代码区(true/false)。",
|
|
653
|
-
"trigger": "CubeMX
|
|
653
|
+
"trigger": "CubeMX 恒写;本插件不写(模板自带)。",
|
|
654
654
|
"order": "dictionary",
|
|
655
655
|
"evidence": [
|
|
656
656
|
"语料 504/504 均带",
|
|
@@ -664,7 +664,7 @@ export const SPECS = [
|
|
|
664
664
|
"key": "boardIOC",
|
|
665
665
|
"valueKind": "bool",
|
|
666
666
|
"valueNote": "这份 .ioc 是从板级配置导入的(true/false)。",
|
|
667
|
-
"trigger": "CubeMX
|
|
667
|
+
"trigger": "CubeMX 恒写;本插件不写。",
|
|
668
668
|
"order": "dictionary",
|
|
669
669
|
"evidence": [
|
|
670
670
|
"语料 504/504 均带"
|
|
@@ -677,7 +677,7 @@ export const SPECS = [
|
|
|
677
677
|
"key": "board",
|
|
678
678
|
"valueKind": "text",
|
|
679
679
|
"valueNote": "板名(NUCLEO-F030R8)或 custom。",
|
|
680
|
-
"trigger": "CubeMX
|
|
680
|
+
"trigger": "CubeMX 恒写;本插件不写。",
|
|
681
681
|
"order": "dictionary",
|
|
682
682
|
"evidence": [
|
|
683
683
|
"语料 501/504"
|
|
@@ -690,7 +690,7 @@ export const SPECS = [
|
|
|
690
690
|
"key": "BSP_IP_NAME",
|
|
691
691
|
"valueKind": "text",
|
|
692
692
|
"valueNote": "BSP 组件名(只有板级配置带)。",
|
|
693
|
-
"trigger": "
|
|
693
|
+
"trigger": "本插件不写。",
|
|
694
694
|
"order": "dictionary",
|
|
695
695
|
"evidence": [
|
|
696
696
|
"语料 65/504"
|
|
@@ -703,7 +703,7 @@ export const SPECS = [
|
|
|
703
703
|
"key": "MMTAppRegionsCount",
|
|
704
704
|
"valueKind": "count",
|
|
705
705
|
"valueNote": "内存映射表(MMT)分区数(只有部分高端型号带)。",
|
|
706
|
-
"trigger": "
|
|
706
|
+
"trigger": "本插件不写。",
|
|
707
707
|
"order": "dictionary",
|
|
708
708
|
"evidence": [
|
|
709
709
|
"语料 26/504"
|
|
@@ -716,7 +716,7 @@ export const SPECS = [
|
|
|
716
716
|
"key": "MMTConfigApplied",
|
|
717
717
|
"valueKind": "bool",
|
|
718
718
|
"valueNote": "是否应用了 MMT 配置。",
|
|
719
|
-
"trigger": "
|
|
719
|
+
"trigger": "本插件不写。",
|
|
720
720
|
"order": "dictionary",
|
|
721
721
|
"evidence": [
|
|
722
722
|
"语料 26/504"
|
|
@@ -729,7 +729,7 @@ export const SPECS = [
|
|
|
729
729
|
"key": "{pin}.ContextOwner",
|
|
730
730
|
"valueKind": "text",
|
|
731
731
|
"valueNote": "引脚上下文归属(只有板级 BSP 配置带,如 PB4(NJRST).ContextOwner)。",
|
|
732
|
-
"trigger": "
|
|
732
|
+
"trigger": "本插件不写。",
|
|
733
733
|
"order": "dictionary",
|
|
734
734
|
"evidence": [
|
|
735
735
|
"语料 3 例(PB4(NJRST) / PH3-BOOT0)"
|
|
@@ -793,7 +793,7 @@ function literalWeight(template) {
|
|
|
793
793
|
* 匹配优先级:三条一起决定谁先匹配,避免宽模板抢走具体键。
|
|
794
794
|
*
|
|
795
795
|
* 0. 以字面量开头、没有 catch-all(Mcu.Pin{index} / NVIC.{name}_IRQn / {pin}.Signal 之外的都算)
|
|
796
|
-
* 1. 以字面量开头、带 catch-all
|
|
796
|
+
* 1. 以字面量开头、带 catch-all 的命名空间回退(RCC.{*})
|
|
797
797
|
* 2. 以占位符开头的通配模板({ip}.{name} / {pin}.Signal / {ip}.IPParameters)
|
|
798
798
|
*
|
|
799
799
|
* 同级再按字面量长度降序:RCC.IPParameters(16) 要压住 {ip}.IPParameters(13),
|
|
@@ -883,7 +883,7 @@ export function iocKeyTier(spec) {
|
|
|
883
883
|
return tier;
|
|
884
884
|
}
|
|
885
885
|
/**
|
|
886
|
-
*
|
|
886
|
+
* 已知的「伪命名空间」:并非外设实例,但确实会以 `前缀.成员` 的形式出现。
|
|
887
887
|
* 目的是让 auditIocKeys 别把这些报成拼错。计数来自 504 份 board 级语料(键出现行数)。
|
|
888
888
|
*/
|
|
889
889
|
export const IOC_NAMESPACE_PREFIXES = [
|
|
@@ -937,11 +937,11 @@ export function describeIocKey(key) {
|
|
|
937
937
|
* 闸门第二道:光命中 {ip}.{name} 不算数,还要看占位符填进来的东西是不是真的存在。
|
|
938
938
|
* 三个判据都来自现场(.ioc 里的 Mcu.IP<i> 列表、本机 db 的引脚表与参数清单),不是猜:
|
|
939
939
|
* - ip 是已启用的外设实例 → 成员名必须在 db 给这个 IP 的 RefParameter 清单里(拼错 Baudrate 会被抓);
|
|
940
|
-
* - ip 是 db 里的引脚名 → 说明写的是「引脚属性」,但引脚属性必须逐条登记进表(否则 CubeMX
|
|
940
|
+
* - ip 是 db 里的引脚名 → 说明写的是「引脚属性」,但引脚属性必须逐条登记进表(否则 CubeMX 会丢弃该属性);
|
|
941
941
|
* - ip 是已知伪命名空间(ProjectManager/CAD/…)→ 放行;
|
|
942
|
-
* - 三者都不是 →
|
|
942
|
+
* - 三者都不是 → 「疑似拼错」,这是本插件唯一能直接判错的一类。 */
|
|
943
943
|
/**
|
|
944
|
-
* 这些前缀在 db 里是 IP 实例、但 CubeMX
|
|
944
|
+
* 这些前缀在 db 里是 IP 实例、但 CubeMX 从不将其登记进 Mcu.IP<i>,键直接归入伪命名空间。
|
|
945
945
|
* 目前只有 GPIO:504 份板级 .ioc 里 Mcu.IPn=GPIO 出现 0 次,GPIO.groupedBy 实测只有
|
|
946
946
|
* "Group By Peripherals"(110) / "Show All"(8) 两种值。加新前缀前先给语料计数。
|
|
947
947
|
*/
|
|
@@ -988,11 +988,11 @@ export function auditIocKeys(keys, context = {}) {
|
|
|
988
988
|
const ip = (hit.params.ip ?? "").trim();
|
|
989
989
|
const name = hit.params.name ?? "";
|
|
990
990
|
const upper = ip.toUpperCase();
|
|
991
|
-
// GPIO 是"伪实例":db 里确实有 IP InstanceName="GPIO",但 CubeMX
|
|
992
|
-
// (504 份板级 .ioc 里 Mcu.IPn=GPIO 出现 0
|
|
991
|
+
// GPIO 是"伪实例":db 里确实有 IP InstanceName="GPIO",但 CubeMX 从不将其写入 Mcu.IP<i>
|
|
992
|
+
// (504 份板级 .ioc 里 Mcu.IPn=GPIO 出现 0 次),其 <pin>.GPIO_* 走引脚名、GPIO.groupedBy 走面板设置。
|
|
993
993
|
// 所以必须先判伪命名空间,否则会被判成"有实例但没启用",把一个合法键报成错误。
|
|
994
994
|
if (IOC_VIRTUAL_NAMESPACES.has(upper) && !instances.has(upper)) {
|
|
995
|
-
findings.push({ ...base, verdict: "ok", detail: ip + " 是面板/全局设置用的伪命名空间(CubeMX
|
|
995
|
+
findings.push({ ...base, verdict: "ok", detail: ip + " 是面板/全局设置用的伪命名空间(CubeMX 不将其列入 Mcu.IP<i>)" });
|
|
996
996
|
continue;
|
|
997
997
|
}
|
|
998
998
|
if (instances.has(upper)) {
|
|
@@ -1023,7 +1023,7 @@ export function auditIocKeys(keys, context = {}) {
|
|
|
1023
1023
|
findings.push({
|
|
1024
1024
|
...base,
|
|
1025
1025
|
verdict: "pin-attribute",
|
|
1026
|
-
detail: ip + " 是引脚名," + name + " 是引脚属性;引脚属性必须逐条登记进真值表(否则 CubeMX
|
|
1026
|
+
detail: ip + " 是引脚名," + name + " 是引脚属性;引脚属性必须逐条登记进真值表(否则 CubeMX 会丢弃该属性)",
|
|
1027
1027
|
});
|
|
1028
1028
|
continue;
|
|
1029
1029
|
}
|
package/lib/data/rm-topics.js
CHANGED
|
@@ -1,16 +1,16 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* rm-topics(主题/锚点清单)的两层装载。
|
|
3
3
|
*
|
|
4
|
-
*
|
|
4
|
+
* 为什么需要「spec」这一层:机器是阅卷人而非出题人——自动抽取必须有人(或经历过已知问题的会话)
|
|
5
5
|
* 给出「要采信哪几条结论 + 在 RM 里逐字回查什么」,机器才能核验并落 semantics。
|
|
6
6
|
*
|
|
7
7
|
* 装载顺序(两层合并,同 id 用户赢):
|
|
8
8
|
* 1) 插件自带的族级 spec:lib/data/rm-topics/<族>.json(源在 src/data/rm-topics/,
|
|
9
9
|
* 随包发布;scripts/copy-data.mjs 负责进 lib)。
|
|
10
10
|
* 2) 用户芯片级 spec:<factsRoot>/topics/<族>/<线>.json——只覆盖手上这颗。
|
|
11
|
-
*
|
|
12
|
-
* 写成一份小 JSON
|
|
13
|
-
*
|
|
11
|
+
* 用户遇到已知问题(例如某条选项字节规则导致板子无法连接),将「该结论 + 回查锚点」
|
|
12
|
+
* 写成一份小 JSON 放入此处,该芯片下一次烧录前必须通过机检;未写入的其他
|
|
13
|
+
* 芯片不受影响(族级判据过粗,已知问题通常是芯片级的,见 2026-11-07 决定)。
|
|
14
14
|
*
|
|
15
15
|
* 判定「这颗芯片要不要过机检」= 合并后主题数 > 0。
|
|
16
16
|
*/
|
|
@@ -47,7 +47,7 @@ function readJson(file) {
|
|
|
47
47
|
/**
|
|
48
48
|
* 插件自带族级 spec 的目录:lib/data/rm-topics/(JSON 不进 tsc,由
|
|
49
49
|
* scripts/copy-data.mjs 在 build 时复制;仓库里 lib/ 是入库的,装包侧也带)。
|
|
50
|
-
*
|
|
50
|
+
* 未回退到 src:该相对路径在插件真实安装位置(node_modules 深处)
|
|
51
51
|
* 基本不可能存在,留着只会把「没跑 copy-data」伪装成「清单在但读不到」。
|
|
52
52
|
*/
|
|
53
53
|
export function bundledTopicsDir() {
|
|
@@ -96,7 +96,7 @@ export function loadRmTopics(family, line, factsRoot) {
|
|
|
96
96
|
const topics = [...merged.values()];
|
|
97
97
|
if (topics.length === 0)
|
|
98
98
|
return EMPTY;
|
|
99
|
-
// 用户 spec
|
|
99
|
+
// 用户 spec 未写 lines 时仅针对该芯片(fallbackLines 回退);族级有 lines 时遵循族级
|
|
100
100
|
if (lines.size === 0)
|
|
101
101
|
lines.add(ln);
|
|
102
102
|
return { topics, lines: [...lines].sort(), docId, origins, hasSpec: true };
|
package/lib/data/search-roots.js
CHANGED
|
@@ -7,7 +7,7 @@
|
|
|
7
7
|
* 3. 用户配置文件(toolchain-config:stm32_env_install 装好后自己写的,见下)——
|
|
8
8
|
* 也整份替换默认值,但排在环境变量之后(环境变量是临时/脚本场景的活开关);
|
|
9
9
|
* 4. 默认候选表(DEFAULT_BIN_DIRS / DEFAULT_CUBEMX_ROOTS,本机常见安装位置)。
|
|
10
|
-
*
|
|
10
|
+
* 之后再把**自动发现到的**安装目录追加到尾部:仅作为回退,不覆盖上面任何一处,
|
|
11
11
|
* 这样别人把 MSYS2 装在 E:\\msys64、CubeMX 装在 F:\\tools 也能直接跑。
|
|
12
12
|
* 设 STM32_NO_DISCOVER=1 可关掉自动发现(CI / 单测里避免扫盘);
|
|
13
13
|
* 设 DSH_STM32_NO_CONFIG=1 可让第 3 档失效(单测里保证不读本机配置)。
|
|
@@ -21,7 +21,7 @@ import { binDirsFromConfig, configReadingDisabled, cubeMxRootsFromConfig, readTo
|
|
|
21
21
|
*
|
|
22
22
|
* 这里绝不能出现开发机专属路径(D:/app/msys64 之类):插件是给别人下载的,
|
|
23
23
|
* 那些路径在别人机器上必然搜不到,还会把「查过哪些地方」的文案污染成别人看不懂的样子。
|
|
24
|
-
*
|
|
24
|
+
* 非默认位置由自动发现回退处理(扫描盘符内 msys64/app/msys64/tools 等常见布局)。
|
|
25
25
|
*/
|
|
26
26
|
export const DEFAULT_BIN_DIRS = [
|
|
27
27
|
"C:/msys64/ucrt64/bin",
|
|
@@ -77,7 +77,7 @@ export function looksLikeCubeMxRoot(dir, exists = existsSync) {
|
|
|
77
77
|
return exists(dir + "/jre/bin/java.exe") && exists(dir + "/STM32CubeMX.exe");
|
|
78
78
|
}
|
|
79
79
|
/**
|
|
80
|
-
* 一个目录是不是能用的工具链 bin
|
|
80
|
+
* 一个目录是不是能用的工具链 bin(至少包含一个本插件需要的 exe)。
|
|
81
81
|
*
|
|
82
82
|
* 不能只认 gcc/openocd/cmake:只补了 ninja 或 gdb 的 MSYS2(典型:先装 gcc,再单独补 gdb)
|
|
83
83
|
* 会被整目录漏掉,doctor 于是说「工具链没找到」。这里把 probe 的五项都算上。
|
|
@@ -112,7 +112,7 @@ export function discoverBinDirs(probe) {
|
|
|
112
112
|
export const DEFAULT_CUBE_PRG_BINS = [
|
|
113
113
|
"C:/Program Files/STMicroelectronics/STM32Cube/STM32CubeProgrammer/bin",
|
|
114
114
|
];
|
|
115
|
-
/** 一个目录是不是 CubeProgrammer 的 bin
|
|
115
|
+
/** 一个目录是不是 CubeProgrammer 的 bin:以 CLI 主程序判定(32 位子目录不算,本插件只在 64 位路径找)。 */
|
|
116
116
|
export function looksLikeCubePrgBin(dir, exists = existsSync) {
|
|
117
117
|
return exists(dir + "/STM32_Programmer_CLI.exe");
|
|
118
118
|
}
|
|
@@ -145,18 +145,25 @@ function cubeMxBases(probe) {
|
|
|
145
145
|
bases.push(dir);
|
|
146
146
|
return bases;
|
|
147
147
|
}
|
|
148
|
-
/**
|
|
148
|
+
/**
|
|
149
|
+
* 在常见安装位置里找 CubeMX 根目录:安装器环境变量与注册表优先,其次扫目录。
|
|
150
|
+
*
|
|
151
|
+
* 三种来源缺一不可——2026-11 实测 ST 6.18.1 的官方安装包把路径写在 STM32CubeMX_PATH 里,
|
|
152
|
+
* 注册表只有卸载键(且没有 InstallLocation,路径藏在 DisplayIcon 的 exe 全路径里),
|
|
153
|
+
* 而安装目录本身可以落在任意盘任意层级(例如 D:/app/STMicroelectronics/STM32Cube/STM32CubeMX)。
|
|
154
|
+
*/
|
|
149
155
|
export function discoverCubeMxRoots(probe) {
|
|
150
156
|
const found = [];
|
|
151
|
-
for (const dir of probe.registryInstallDirs()) {
|
|
157
|
+
for (const dir of [...probe.installerDirs(), ...probe.registryInstallDirs()]) {
|
|
152
158
|
const normalized = normalizePathEntry(dir);
|
|
153
159
|
if (normalized !== "" && looksLikeCubeMxRoot(normalized, probe.exists))
|
|
154
160
|
found.push(normalized);
|
|
155
161
|
}
|
|
156
162
|
for (const base of cubeMxBases(probe)) {
|
|
157
|
-
const direct
|
|
158
|
-
|
|
159
|
-
|
|
163
|
+
for (const direct of cubeMxCandidates(base)) {
|
|
164
|
+
if (looksLikeCubeMxRoot(direct, probe.exists))
|
|
165
|
+
found.push(direct);
|
|
166
|
+
}
|
|
160
167
|
for (const child of probe.listDirs(base)) {
|
|
161
168
|
if (looksLikeCubeMxRoot(child, probe.exists))
|
|
162
169
|
found.push(child);
|
|
@@ -164,6 +171,11 @@ export function discoverCubeMxRoots(probe) {
|
|
|
164
171
|
}
|
|
165
172
|
return dedupePaths(found);
|
|
166
173
|
}
|
|
174
|
+
/** 一个 base 下的两种 ST 落点:直接子目录,以及 ST 安装包默认的 <base>/STMicroelectronics/STM32Cube 层级。 */
|
|
175
|
+
function cubeMxCandidates(base) {
|
|
176
|
+
const trimmed = base.replace(/\/+$/u, "");
|
|
177
|
+
return [trimmed + "/STM32CubeMX", trimmed + "/STMicroelectronics/STM32Cube/STM32CubeMX"];
|
|
178
|
+
}
|
|
167
179
|
/** 解码失败的痕迹:非法字节被换成 U+FFFD。 */
|
|
168
180
|
const REPLACEMENT_CHAR = "\u{FFFD}";
|
|
169
181
|
/**
|
|
@@ -180,7 +192,7 @@ const REPLACEMENT_CHAR = "\u{FFFD}";
|
|
|
180
192
|
* 两种都解不出来就返回 ok:false —— 宁可让用户手写一条,也不把乱码写进注册表。
|
|
181
193
|
*
|
|
182
194
|
* 备选方案(没采用):用 powershell 先把 [Console]::OutputEncoding 设成 UTF8 再调 reg.exe。
|
|
183
|
-
* 不用的原因:多一层 PowerShell
|
|
195
|
+
* 不用的原因:多一层 PowerShell 启动开销与引号转义,且字节内容已经取得,直接探测更短。
|
|
184
196
|
*/
|
|
185
197
|
export function decodeRegistryText(value, label = "reg.exe 输出") {
|
|
186
198
|
if (value === null || value === undefined) {
|
|
@@ -226,15 +238,45 @@ function regExe() {
|
|
|
226
238
|
const root = process.env.SystemRoot || process.env.windir || "C:\\Windows";
|
|
227
239
|
return join(root, "System32", "reg.exe");
|
|
228
240
|
}
|
|
241
|
+
/**
|
|
242
|
+
* 安装器写进环境变量的安装根(ST 官方 Windows 安装包写 STM32CubeMX_PATH)。
|
|
243
|
+
*
|
|
244
|
+
* 为什么不并进 STM32_CUBEMX_ROOT:该项是本插件自己的开关,语义是"整份替换默认候选";
|
|
245
|
+
* 这个是系统里客观存在的登记信息,只该参与自动发现(与注册表同级),不能因为用户
|
|
246
|
+
* 装了别的版本把候选表整个换掉。
|
|
247
|
+
*/
|
|
248
|
+
export function installerCubeMxDirs(env = process.env) {
|
|
249
|
+
return dedupePaths(splitList(env["STM32CubeMX_PATH"]).concat(splitList(env["STM32CUBEMX_PATH"])));
|
|
250
|
+
}
|
|
251
|
+
/** 注册表值可能带图标序号后缀("D:\x\app.exe",0)。 */
|
|
252
|
+
const ICON_INDEX_SUFFIX = /,\s*-?\d+\s*$/u;
|
|
253
|
+
/**
|
|
254
|
+
* 注册表里的值可能是目录(InstallLocation),也可能是指向 exe/bat 的完整路径
|
|
255
|
+
* (DisplayIcon / UninstallString)。后者取所在目录——ST 6.18.1 只在 DisplayIcon 里
|
|
256
|
+
* 留下...\STM32CubeMX\STM32CubeMX.exe,没有 InstallLocation 可读。
|
|
257
|
+
*/
|
|
258
|
+
export function dirFromRegistryValue(value) {
|
|
259
|
+
const normalized = normalizePathEntry(value.replace(ICON_INDEX_SUFFIX, ""));
|
|
260
|
+
if (normalized === "")
|
|
261
|
+
return "";
|
|
262
|
+
if (!/\.(exe|bat|cmd|com)$/iu.test(normalized))
|
|
263
|
+
return normalized;
|
|
264
|
+
const slash = normalized.lastIndexOf("/");
|
|
265
|
+
return slash <= 0 ? "" : normalized.slice(0, slash);
|
|
266
|
+
}
|
|
229
267
|
/** 读注册表里 ST 记下的安装位置;没有这些键是最常见的情况,不算错误。 */
|
|
230
268
|
function readRegistryInstallDirs() {
|
|
231
269
|
if (process.platform !== "win32")
|
|
232
270
|
return [];
|
|
271
|
+
const uninstall = "HKLM\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\STM32CubeMX";
|
|
233
272
|
const keys = [
|
|
234
273
|
{ key: "HKLM\\SOFTWARE\\STMicroelectronics\\STM32CubeMX", value: "InstallDir" },
|
|
235
274
|
{ key: "HKLM\\SOFTWARE\\WOW6432Node\\STMicroelectronics\\STM32CubeMX", value: "InstallDir" },
|
|
236
275
|
{ key: "HKCU\\SOFTWARE\\STMicroelectronics\\STM32CubeMX", value: "InstallDir" },
|
|
237
|
-
{ key:
|
|
276
|
+
{ key: uninstall, value: "InstallLocation" },
|
|
277
|
+
// ST 6.18.1 实测:只有 DisplayIcon / UninstallString,没有 InstallLocation
|
|
278
|
+
{ key: uninstall, value: "DisplayIcon" },
|
|
279
|
+
{ key: uninstall, value: "UninstallString" },
|
|
238
280
|
];
|
|
239
281
|
const out = [];
|
|
240
282
|
for (const entry of keys) {
|
|
@@ -258,15 +300,18 @@ function readRegistryInstallDirs() {
|
|
|
258
300
|
continue;
|
|
259
301
|
const parts = trimmed.split(/\s{2,}/u);
|
|
260
302
|
const dir = parts[parts.length - 1];
|
|
261
|
-
if (dir
|
|
262
|
-
|
|
303
|
+
if (dir === undefined || dir.trim() === "")
|
|
304
|
+
continue;
|
|
305
|
+
const normalized = dirFromRegistryValue(dir);
|
|
306
|
+
if (normalized !== "")
|
|
307
|
+
out.push(normalized);
|
|
263
308
|
}
|
|
264
309
|
}
|
|
265
310
|
catch {
|
|
266
311
|
// 键或值不存在:正常情况
|
|
267
312
|
}
|
|
268
313
|
}
|
|
269
|
-
return out;
|
|
314
|
+
return dedupePaths(out);
|
|
270
315
|
}
|
|
271
316
|
/** 真实系统的探针。 */
|
|
272
317
|
export function defaultDiscoverProbe() {
|
|
@@ -283,6 +328,7 @@ export function defaultDiscoverProbe() {
|
|
|
283
328
|
return [];
|
|
284
329
|
}
|
|
285
330
|
},
|
|
331
|
+
installerDirs: () => installerCubeMxDirs(),
|
|
286
332
|
registryInstallDirs: readRegistryInstallDirs,
|
|
287
333
|
driveRoots: () => {
|
|
288
334
|
if (process.platform !== "win32")
|
|
@@ -374,8 +420,8 @@ export function searchConfigWarnings(env = process.env, exists = existsSync) {
|
|
|
374
420
|
* 自动发现的安装只追加在"没给显式参数"的那一档尾部:用参数点名目录时说明调用方
|
|
375
421
|
* 心里有确切位置,再混进别处的同名工具会让"我明明指定了"变成假的。
|
|
376
422
|
*
|
|
377
|
-
*
|
|
378
|
-
* 装完工具链后不必改任何调用方就能立即生效(不需要重启 DSH
|
|
423
|
+
* 用户配置文件在这里读,是因为**这一层是唯一的汇聚点**:所有工具与引擎都经过这一层,
|
|
424
|
+
* 装完工具链后不必改任何调用方就能立即生效(不需要重启 DSH:路径由本插件自行读取)。
|
|
379
425
|
*/
|
|
380
426
|
export function resolveSearchConfig(env = process.env, overrides = {},
|
|
381
427
|
/** 单测注入用;生产代码不要传。 */
|