dsh-stm32 0.1.5 → 0.1.6
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/docs/reading-guide.md +32 -0
- package/lib/engine/ioc-plan.js +28 -6
- package/lib/engine/serial.js +10 -6
- package/lib/skill/stm32-workflow.js +1 -1
- package/lib/tools/assets.js +8 -3
- package/lib/tools/build.js +0 -1
- package/lib/tools/ioc-plan.js +17 -7
- package/package.json +70 -70
package/docs/reading-guide.md
CHANGED
|
@@ -819,9 +819,41 @@ const fake = {
|
|
|
819
819
|
| `src/engine/` | 65 个 `.ts` / 26,961 行 |
|
|
820
820
|
| `src/data/` | 18 个 `.ts` / 7,785 行 |
|
|
821
821
|
| 单测 | 60 个套件 / 947 pass / 0 fail(`node test/run-units.mjs`) |
|
|
822
|
+
| TypeScript | 110 个文件、42,261 行(`src/`,不含 client) |
|
|
823
|
+
| `src/tools/` | 24 个文件 / 25 个注册工具 / 7,583 行 |
|
|
824
|
+
| `src/engine/` | 65 个 `.ts` / 26,358 行 |
|
|
825
|
+
| `src/data/` | 17 个 `.ts` / 7,625 行 |
|
|
826
|
+
| 单测 | 61 个套件 / 923 pass / 0 fail(`node test/run-units.mjs`,本机实测) |
|
|
822
827
|
|
|
823
828
|
第 1–11 章的目录表与模块计数保留 D 阶段原样(45 个 engine 模块、23 个 tools 文件),读旧章节时以本节为准。
|
|
824
829
|
|
|
830
|
+
## 14. 0.1.6 增补:宿主 schema 子集与 `pins` / `parameters` 数组化
|
|
831
|
+
|
|
832
|
+
> 接续 §13,同属 0.1.6。这一节不改业务行为,只让 25 个工具的 schema 落进 DSH 0.2.2-rc.1 允许的子集。
|
|
833
|
+
|
|
834
|
+
### 14.1 先读哪里
|
|
835
|
+
|
|
836
|
+
- `src/types.ts` 的 `JsonSchema`:现在就是宿主子集本身——`type` / `oneOf` / `properties` / `required` / `additionalProperties`(仅 boolean)/ `items` / `enum` / `const` + 注解 `description` / `title` / `default` / `examples`。`minimum` / `maximum` 已删除,看到需要范围时去 `description` 和执行期校验里找。
|
|
837
|
+
- `src/tools/ioc-plan.ts` 的 `parameters`:`peripherals[].pins` / `parameters` 是 `type:"array"` + `items:{key,value}`,`pllMul` 是 `integer` + `enum[2..16]`。
|
|
838
|
+
- `src/engine/ioc-plan.ts` 的 `KeyValuePair` 与 `keyValueMap()`:数组 → `Map` 的唯一入口,空 key / 重复 key 在这里记 `errors`。
|
|
839
|
+
- `src/engine/serial.ts` 的 `SERIAL_SETTINGS_PROPERTIES`:参数 schema 与输出 `settings` schema 复用同一片段,范围只在 `description` 里;真正的越界判定在 `src/data/serial-config.ts` 的 `normalizeSerialSettings`。
|
|
840
|
+
- `test/schema-subset-units.test.mjs`:镜像校验器 + 从 `app.asar` 抽真校验器做真值对齐。改任何工具的 schema 后先跑它。
|
|
841
|
+
|
|
842
|
+
### 14.2 三条不变量
|
|
843
|
+
|
|
844
|
+
1. 任何 schema 节点只出现子集关键字;`additionalProperties` 只能是 boolean,`items` 只在数组上,`properties`/`required` 只在对象上。
|
|
845
|
+
2. 数值范围**不进 schema**:写 `description`,并在执行期校验(`keep`:非法即 `ok=false` 且不动文件;串口:`normalizeSerialSettings` 记 errors 并保持默认值)。
|
|
846
|
+
3. 「任意键 → 值」的映射不允许再写成 `additionalProperties: {…}`;要么换成 `[{key,value}]` 数组,要么用 `additionalProperties: true` 兜底。
|
|
847
|
+
|
|
848
|
+
### 14.3 计数口径(0.1.6 起)
|
|
849
|
+
|
|
850
|
+
| 项 | 当前值 |
|
|
851
|
+
| --- | --- |
|
|
852
|
+
| 注册工具 | 25 个(25/25 schema 合规) |
|
|
853
|
+
| 单测 | 61 个套件 / 923 pass / 0 fail |
|
|
854
|
+
|
|
855
|
+
本机同基线实测为 921,加 2 条新用例后 923;§13.5 表里原有的 937 是另一台机器的发布记录。
|
|
856
|
+
|
|
825
857
|
---
|
|
826
858
|
|
|
827
859
|
读完这一遍,最值得回头再看两处的顺序是:**先 7.8(generate)再看 5.5**,因为 generate 是全仓库复杂度顶点,看懂它就等于看懂了「编码层 + 备份 + 缓存 + 产物判据 + 锁」这五条横切关注点如何在一个流程里共存。
|
package/lib/engine/ioc-plan.js
CHANGED
|
@@ -29,6 +29,26 @@ import { planClockDirect } from "./clock-direct.js";
|
|
|
29
29
|
import { followDerivedClocks } from "./clock-derived.js";
|
|
30
30
|
import { isKnownPin } from "../data/chips.js";
|
|
31
31
|
import { capabilityGap, familyProfileOf, isF1 } from "../data/family.js";
|
|
32
|
+
/** 把 [{key,value}] 折成查找表:空 key 与重复 key 记错误,重复时后值覆盖前值。 */
|
|
33
|
+
function keyValueMap(pairs, label, errors) {
|
|
34
|
+
const map = new Map();
|
|
35
|
+
for (const [index, pair] of (pairs ?? []).entries()) {
|
|
36
|
+
if (pair === null || typeof pair !== "object") {
|
|
37
|
+
errors.push(label + "[" + String(index) + "] 不是 {key,value} 对象");
|
|
38
|
+
continue;
|
|
39
|
+
}
|
|
40
|
+
const key = typeof pair.key === "string" ? pair.key.trim() : "";
|
|
41
|
+
const value = typeof pair.value === "string" ? pair.value : "";
|
|
42
|
+
if (key === "") {
|
|
43
|
+
errors.push(label + "[" + String(index) + "] 的 key 是空串");
|
|
44
|
+
continue;
|
|
45
|
+
}
|
|
46
|
+
if (map.has(key))
|
|
47
|
+
errors.push(label + " 里的 key " + JSON.stringify(key) + " 重复,后面的值覆盖前面的");
|
|
48
|
+
map.set(key, value);
|
|
49
|
+
}
|
|
50
|
+
return map;
|
|
51
|
+
}
|
|
32
52
|
export function sha256Hex(text) {
|
|
33
53
|
return createHash("sha256").update(text, "utf8").digest("hex");
|
|
34
54
|
}
|
|
@@ -908,9 +928,11 @@ function enablePeripheral(table, request, pinNames, notes, familyId) {
|
|
|
908
928
|
}
|
|
909
929
|
table.entries.set(renderIocKey("mcu.ip_nb"), String(slots));
|
|
910
930
|
// 引脚:Mode + Signal + Locked。
|
|
911
|
-
const
|
|
931
|
+
const pinOverrides = keyValueMap(request.pins, preset.name + ".pins", table.errors);
|
|
932
|
+
const paramOverrides = keyValueMap(request.parameters, preset.name + ".parameters", table.errors);
|
|
933
|
+
const overrodePins = pinOverrides.size > 0;
|
|
912
934
|
for (const role of preset.pins) {
|
|
913
|
-
const logical = (
|
|
935
|
+
const logical = (pinOverrides.get(role.role) ?? role.defaultPin).trim().toUpperCase();
|
|
914
936
|
if (logical === "") {
|
|
915
937
|
table.errors.push(preset.name + " 的引脚 " + role.role + " 被指定成空串");
|
|
916
938
|
continue;
|
|
@@ -942,7 +964,7 @@ function enablePeripheral(table, request, pinNames, notes, familyId) {
|
|
|
942
964
|
}
|
|
943
965
|
// 逐字键(DMA 这类键名不受 <ip>.<名字> 约束):先写它们,再统一重算 Dma.RequestsNb。
|
|
944
966
|
for (const raw of preset.rawEntries ?? []) {
|
|
945
|
-
table.entries.set(raw.key,
|
|
967
|
+
table.entries.set(raw.key, paramOverrides.get(raw.key.replace("Dma.", "").replace(/\.0\./u, ".")) ?? raw.value);
|
|
946
968
|
}
|
|
947
969
|
// G1/G2:DMA 三件套。CubeMX 自己写的是
|
|
948
970
|
// Dma.<IP>.<n>.RequestParameters=Instance,Direction,...,Priority(白名单,与 IPParameters 同机制:
|
|
@@ -1004,15 +1026,15 @@ function enablePeripheral(table, request, pinNames, notes, familyId) {
|
|
|
1004
1026
|
const paramsKey = renderIocKey("periph.ip_parameters", { ip: preset.ip });
|
|
1005
1027
|
const names = (table.entries.get(paramsKey) ?? "").split(",").map((item) => item.trim()).filter((item) => item !== "");
|
|
1006
1028
|
for (const param of preset.parameters) {
|
|
1007
|
-
table.entries.set(renderIocKey("periph.parameter", { ip: preset.ip, name: param.name }),
|
|
1029
|
+
table.entries.set(renderIocKey("periph.parameter", { ip: preset.ip, name: param.name }), paramOverrides.get(param.name) ?? param.value);
|
|
1008
1030
|
if (!names.includes(param.name))
|
|
1009
1031
|
names.push(param.name);
|
|
1010
|
-
if (overrodePins &&
|
|
1032
|
+
if (overrodePins && !paramOverrides.has(param.name) && param.name.startsWith("Channel-")) {
|
|
1011
1033
|
table.warnings.push(preset.name + " 换了引脚,但 " + param.name + " 仍是 " + param.value +
|
|
1012
1034
|
":通道号必须与引脚一致,请一并用 parameters 改");
|
|
1013
1035
|
}
|
|
1014
1036
|
}
|
|
1015
|
-
for (const [name, value] of
|
|
1037
|
+
for (const [name, value] of paramOverrides) {
|
|
1016
1038
|
if (names.includes(name))
|
|
1017
1039
|
continue;
|
|
1018
1040
|
names.push(name);
|
package/lib/engine/serial.js
CHANGED
|
@@ -88,10 +88,14 @@ const POLL_MS = 40;
|
|
|
88
88
|
* 串口参数的 JSON Schema 片段(平铺),给工具层拼 parameters.properties 用。
|
|
89
89
|
* 单独放一份的理由:白名单/范围/默认值只有一处定义,工具 schema 与 normalizeSerialSettings
|
|
90
90
|
* 就不会各说各话(schema 说 1…4M、代码只认到 1M 这种错最难发现)。
|
|
91
|
+
*
|
|
92
|
+
* 注意:宿主 0.2.2 起 schema 子集不再接受 minimum/maximum(UNSUPPORTED_SCHEMA),
|
|
93
|
+
* 所以范围只写进 description;真正的范围校验在 normalizeSerialSettings(越界记 errors,
|
|
94
|
+
* 保持默认值),这里不重复。唯一的例外是 dataBits:只有 5…8 四个值,用 enum 表达。
|
|
91
95
|
*/
|
|
92
96
|
export const SERIAL_SETTINGS_PROPERTIES = {
|
|
93
|
-
baudRate: { type: "integer", description: "
|
|
94
|
-
dataBits: { type: "integer",
|
|
97
|
+
baudRate: { type: "integer", description: "波特率 " + String(SERIAL_BAUD_MIN) + "…" + String(SERIAL_BAUD_MAX) + ",默认 " + String(SERIAL_DEFAULTS.baudRate), default: SERIAL_DEFAULTS.baudRate },
|
|
98
|
+
dataBits: { type: "integer", enum: [5, 6, 7, 8], description: "数据位 " + String(SERIAL_DATA_BITS_MIN) + "…" + String(SERIAL_DATA_BITS_MAX) + ",默认 " + String(SERIAL_DEFAULTS.dataBits), default: SERIAL_DEFAULTS.dataBits },
|
|
95
99
|
stopBits: { type: "string", enum: [...SERIAL_STOP_BITS], description: "停止位,默认 1", default: SERIAL_DEFAULTS.stopBits },
|
|
96
100
|
parity: { type: "string", enum: [...SERIAL_PARITIES], description: "校验位,默认 none", default: SERIAL_DEFAULTS.parity },
|
|
97
101
|
flow: { type: "string", enum: [...SERIAL_FLOWS], description: "流控,默认 none(STM32 板子一般不用)", default: SERIAL_DEFAULTS.flow },
|
|
@@ -99,10 +103,10 @@ export const SERIAL_SETTINGS_PROPERTIES = {
|
|
|
99
103
|
rts: { type: "boolean", description: "打开时把 RTS 拉低(默认 false)", default: SERIAL_DEFAULTS.rts },
|
|
100
104
|
encoding: { type: "string", enum: [...SERIAL_ENCODINGS], description: "文本编码,默认 utf8", default: SERIAL_DEFAULTS.encoding },
|
|
101
105
|
newline: { type: "string", enum: [...SERIAL_NEWLINES], description: "send 自动补的换行,默认 crlf", default: SERIAL_DEFAULTS.newline },
|
|
102
|
-
timeoutMs: { type: "integer", description: "读/等回包超时(ms
|
|
103
|
-
maxLines: { type: "integer", description: "read
|
|
104
|
-
maxBytes: { type: "integer", description: "read
|
|
105
|
-
idleTimeoutMs: { type: "integer", description: "多久没人碰就自动放口(ms
|
|
106
|
+
timeoutMs: { type: "integer", description: "读/等回包超时(ms)0…" + String(SERIAL_LIMITS.timeoutMs) + ",默认 " + String(SERIAL_DEFAULTS.timeoutMs), default: SERIAL_DEFAULTS.timeoutMs },
|
|
107
|
+
maxLines: { type: "integer", description: "read 一次最多返回多少行 1…" + String(SERIAL_LIMITS.maxLines) + ",默认 " + String(SERIAL_DEFAULTS.maxLines), default: SERIAL_DEFAULTS.maxLines },
|
|
108
|
+
maxBytes: { type: "integer", description: "read 一次最多读多少字节 256…" + String(SERIAL_LIMITS.maxBytes) + ",默认 " + String(SERIAL_DEFAULTS.maxBytes), default: SERIAL_DEFAULTS.maxBytes },
|
|
109
|
+
idleTimeoutMs: { type: "integer", description: "多久没人碰就自动放口(ms)0…" + String(SERIAL_LIMITS.idleTimeoutMs) + ",0 = 不自动关,默认 " + String(SERIAL_DEFAULTS.idleTimeoutMs), default: SERIAL_DEFAULTS.idleTimeoutMs },
|
|
106
110
|
persist: { type: "boolean", description: "true = 会话跨 turn 保留(默认 false:turn 结束就关)", default: SERIAL_DEFAULTS.persist },
|
|
107
111
|
};
|
|
108
112
|
/** 端口清单缓存多久(open 与 list 都要用;WMI 查询一次约 0.5 s,不缓存会拖慢一切)。 */
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
*/
|
|
7
7
|
export const STM32_SKILL_NAME = "stm32-workflow";
|
|
8
8
|
const DESCRIPTION = "STM32 多族(HAL 建工程 21 个单核族+WB 双核 M4;寄存器建工程 21 族)+ dsh-stm32 标准工作流:红线(自有三层文件外只写 USER CODE、.ioc 事务、烧录调试分开、Serial Wire 不能关)+ 三层工程规范(Driver/Service/App,新文件只登记 cmake/user/CMakeLists.txt)";
|
|
9
|
-
export const SKILL_CONTENT = "# STM32 工作流(dsh-stm32)\n\n适用:插件当前支持的族——**HAL 建工程 21 个单核族**(C0/F0/F1/F2/F3/F4/F7/G0/G4/H5/H7/L0/L1/L4/L4+/L5/U0/U3/U5/WBA/WL)+ 双核 WB(只建 M4 核);**寄存器版建工程覆盖内置资源 chips.json 里的 21 族**(C0/F0/F1/F2/F3/F4/F7/G0/G4/H5/H7/L0/L1/L4/L4+/L5/U0/U3/U5/WBA/WL;时钟留复位默认、LED/GPIO 按族生成),其余族(WB / WB0 / WL3 / MP1 / MP2 / N6)仍只有 HAL 或明确拒绝。各族能力由族画像诚实降级,拿不准先 `stm32_route_plan`。本工程的验证板仍是蓝丸。本机的验证板是蓝丸 STM32F103C8T6(64 KiB Flash / 20 KiB RAM);探针 ST-Link / DAPLink(CMSIS-DAP)/ J-Link 都支持——`stm32_flash` / `stm32_debug_run` 先按 USB 实见结果选 interface(ST-Link → `interface/stlink-dap.cfg`,DAPLink/CMSIS-DAP → `interface/cmsis-dap.cfg`,J-Link → `interface/jlink.cfg` 且必须再跟一条 `-c \"transport select swd\"`,它默认选 jtag),装了 STM32CubeProgrammer 时 ST-Link 还有 CLI 后端(`stm32_flash` 的 backend 参数:auto / openocd / cubeprogrammer);`stm32_project_create` 建的工程自带 `.vscode/launch.json`(① 只烧录 / ② 烧录并调试),直接按 F5/Ctrl+F5 即可;换型号不是'换块板子',是一起换启动文件、设备宏与链接脚本——`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`,走寄存器版(启动文件与设备头从缓存目录取,不预置进插件)。**寄存器版建工程覆盖 21 族**(内置资源 chips.json 收了的族),不在这 21 族里的芯片会被判 `hal-only`。\n- 要 HAL:先看工具链与固件包就位没有。`gcc` / `cmake` / `ninja` / `openocd` / `gdb` 可以让 `stm32_env_install` 代装;**CubeMX 与固件包插件不代装**(GUI 向导 + 要 ST 账号),照 `guides[].steps` 自己做,离线机器可以整目录拷过来。\n- `unclear`:别猜,先把需求说具体(外设、数据量、要不要中断/DMA),再重调一次。\n\n## 一、硬规范(红线)\n\n**R1 HAL 工程里,只有自己的三层文件(App/Service/Driver)可自由修改;其余文件只准写在 USER CODE 块内。**\n自己的 `App/`、`Service/`、`Driver/` 下的 .c/.h(见第三节)随便建、随便改,业务逻辑只往那里长。\n除它们之外的一切 CubeMX 产物(`Core/Src/main.c`、各 `*_it.c`、HAL 配置头等)只准在 `/* USER CODE BEGIN X */` 与 `/* USER CODE END X */` 之间写——那是 CubeMX 承诺'重新生成时原样保留'的唯一区域,块外任何一行都不属于你。\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 块里;文件名前缀随族变化,F4 是 `stm32f4xx_*`);\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)。**唯一例外:`cmake/user/CMakeLists.txt` 是用户源注册钩子,新模块登记只准改它(见 W3)。**\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 变了就拒绝。GPIO 引脚用 `pins` 的字段直接表达:`outputType: od` 写开漏(`pp` 是默认值、不写键)、`initial: high` 写初始电平(`low` 不写键)、`interrupt: rising|falling|both` 一次写全 EXTI 链路(`Signal=GPXTI<line>` + `GPIO_ModeDefaultEXTI` + `GPIOParameters` + `SH.GPXTI<line>` + 按线号自动选中的 `NVIC.EXTI*_IRQn`);外设中断用 `interrupts: [USART1:2:0]`(`2:0` 是 preempt:sub,名字按本机 db 实例 / SVD 中断表校验)。\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永远不要用'能不能断下来'来判断烧录成功——openocd 的证据是 `** Programming Finished **` 与 `** Verified OK **`,CubeProgrammer CLI 是 `Data downloaded successfully` 与 `Download verified successfully`。H5/WBA/WB0/WL3 这类 openocd 根本没有 flash 驱动的族,用 `stm32_flash` 的 `backend: \"cubeprogrammer\"`(只认 ST-Link;auto 也会在 openocd 失败后兜底)。\n\n**R6 探针只有一块,型号不必手选。** build / flash / generate 之前先让出调试会话(RTT / debug_session 会占着探针,先 `stm32_debug_stop` / `stm32_rtt stop`);我输出结束(turn/end)时插件会自动关会话,所以别在输出中途把探针攥着不说。interface 由工具按 USB 实见结果决定(ST-Link 走 stlink,DAPLink 走 cmsis-dap),报驱动不匹配时它会自动换一次;**只有工程里手写了 `openocd.cfg` 才以它为准**,那时你负责改它,插件不替你换。\n\n**R7 先 build 再 flash。** 改完代码不编译就烧,烧的是旧 elf;烧完看现象会得出错误结论。\n\n**R8 结论必须带证据。** 说'闪了'要给寄存器/计数器证据(例如 `GPIOC_ODR` 在 0x2000/0x0000 之间翻转、`g_led_blink_count` 单调增长),不要只说'看起来好了'。\n\n## 二、标准流程\n\n1. `stm32_doctor` —— 工具链齐不齐(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. 写代码:业务逻辑按第三节三层结构写进自己的 .c/.h;`main.c` 的 USER CODE 块只留 `app_init()` / `app_run()` 两个插头(W1/W2),块外一行都不碰(R1)。\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## 三、工程写作规范(三层结构与文件组织;针对 HAL 路线工程)\n\n**W1 程序分三层,目录即架构。新模块必须按此;存量代码渐进迁移,不要求一次到位。**\n- `Driver/`(下层):板级外设封装(led、key、uart…),全工程**唯一允许直接调 HAL** 的一层;一个模块一对文件:`Driver/led/led.c` + `led.h`。\n- `Service/`(中层):协议解析、调度、环形缓冲、参数存储;可调 Driver,禁止绕过它直接碰寄存器。\n- `App/`(上层):业务状态机与流程编排;只调 Service/Driver 的 API,**禁止 include HAL 头**。\n`Core/`、`Drivers/` 是 CubeMX 与固件包区,按 R1/R2 处理,不属于这三层。函数以模块名为前缀(`led_init()`、`ring_push()`),同一工程不混用命名风格。\n\n**W2 上层入口只留插头。** `Core/Src/main.c` 的 USER CODE 块里只放两个调用:`app_init()`(BEGIN 2)与 `app_run()`(WHILE 块)。业务逻辑一律写进 App/ 的文件;块内不写状态机、不写外设操作。\n\n**W3 新文件登记只准改 `cmake/user/CMakeLists.txt`(全工程唯一可编辑的 CMake 文件)。** 只动两个变量:`USER_Include_Dirs` 追加各模块目录、`USER_Application_Src` 追加各 .c(相对路径写法照抄现有条目)。根 `CMakeLists.txt` 与 `cmake/stm32cubemx/CMakeLists.txt` 都不许动——后者会被 CubeMX 重写覆盖(R2 的无声故障就出在这),前者 ST 名义上可改但本项目一律不动。\n\n**W4 中断纪律。** ISR(`stm32f1xx_it.c` 自带 USER CODE 块内)只置 `volatile` 标志或入环形缓冲,微秒级出中断;消费逻辑放 App/Service。ISR 上下文禁止 printf、Flash 写、长循环。\n\n**W5 时间与阻塞。** 计时统一 `HAL_GetTick()`;超时判断用回绕安全写法 `(uint32_t)(HAL_GetTick() - t0) < ms`。App/Service 禁止新增 `HAL_Delay` 与无超时 `while` 等待;Driver 初始化里的短等待必须带超时与失败返回。\n\n**W6 资源与错误。** 禁 `malloc`(静态分配 + 编译期尺寸);模块对外返回 `enum <mod>_err`(0 = OK),不返回裸 bool 掩盖失败原因;头文件只暴露类型与 API,实现细节 `static`;include guard 风格全工程统一。\n\n**W7 写完的验收顺序。** `stm32_build`(0 error)→ `stm32_flash`(看 Verified OK)→ 按 R8 读回寄存器/计数器证据。只改代码没动 .ioc 时**不要**跑 `stm32_generate`(省 3–4 分钟,也不引入回归面)。\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- [ ] 新增 .c/.h 已登记进 `cmake/user/CMakeLists.txt`(另外两份 CMakeLists 没动)\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)\n\n## 七、外设写了却没生效?先让它自己说(oracle 诊断)\n\n症状:`stm32_generate` 报成功、`Code succesfully generated`,但 `Core/Src/main.c` 里没有 `MX_TIM2_Init` / `MX_ADC1_Init`,`stm32f1xx_hal_conf.h` 的 `HAL_TIM_MODULE_ENABLED` 仍是注释,日志里**一个 ERROR 都没有**。CubeMX 对不认识的键就是这么处理的:静默丢弃。\n\n**第一步:调 `stm32_ioc_verify`**(约 25–40 s,把 .ioc 复制到 `.dsh-stm32/verify/<stamp>/` 后用 `config load` + `config save` 让 CubeMX 写回“它理解的结果”,工程里的 .ioc 一个字节都不动)。看这几个字段:\n\n- `droppedPeripherals`:写了但 CubeMX 没认的外设;\n- `plannedFunctions`:它计划生成的 `MX_*_Init`(等于不生成代码就预览结果);\n- `signalRewrites`:引脚信号被规范化的地方(`TIM2_CH1` → `S_TIM2_CH1_ETR`、`ADC1_IN1` → `ADCx_IN1`);\n- `sharedSignals`:它自己补出来的 `SH.<信号>.0=<IP 信号>,<IP 模式>`;\n- `autoAddedFunctions`:CubeMX 保存时自己往 `ProjectManager.functionlistsort` 追加的 `MX_*_Init` 条目(我们故意不写,它按既有编号自己补;不影响生成正确性,所以单独列出来而不算 diff);\n- `removedKeys` / `addedKeys`:被 CubeMX 删掉 / 它自己补出来的键(各截 60 条;拼错的键一定出现在 removedKeys 里);\n- `changedValues`:键还在、值被改写的(零 diff 不能只看键在不在);\n- `attribution`:把差异归因分桶——`orderOnly`(值相同、行序不同)、`valueNormalized`(值只是成员顺序/空白被规范化,语义不变)、`valueChanged`(值真被改)、`missingKeys` / `addedKeys` / `droppedPeripherals` / `autoAddedFunctions`,以及 `benign`;\n- `hints`:针对每个被丢外设的“缺什么”。\n\n**判“零实质差异”只看 `attribution.benign`**:`true` 表示只剩行序/成员序的规范化或它自己补的初始化清单,可以放心 generate;`false` 就按各桶逐条修(`removedKeys` 里的 `NVIC.<IP>_IRQn` 通常是“外设没启用就开中断”,`hints` 会直说)。\n\n**三条已知原因(按 hints 对号入座)**:\n\n1. 引脚没列进 `Mcu.PinN`(`Mcu.PinsNb` 也要跟着改)——只写 `PA5.Signal=…` 不列进引脚表,CubeMX 根本不应用这根脚。\n2. 普通外设(USART/SPI…)缺 `<pin>.Mode`:如 `PA9.Mode=Asynchronous`。\n3. 定时器/ADC 走**共享信号**,引脚不能写 `.Mode`,要写块:\n `PA0-WKUP.Signal=S_TIM2_CH1_ETR`(PA0 的定时器信号与 `TIM2_ETR` 合并,必须用合并名)+ `SH.S_TIM2_CH1_ETR.0=TIM2_CH1,PWM Generation1 CH1` + `SH.S_TIM2_CH1_ETR.ConfNb=1`;ADC 是 `PA1.Signal=ADCx_IN1` + `SH.ADCx_IN1.0=ADC1_IN1,IN1`。\n\n**修法**:优先用 `stm32_ioc_plan` 的 `peripherals:[{name:'TIM2', parameters:{Prescaler:'71',Period:'999'}}]` 预设(内置 USART1/2/3、TIM2/3/4 CH1 PWM、ADC1/2),它已经按上面三条写全;预设有缺口时再 `entries` 逐键补,改完**再跑一次 `stm32_ioc_verify` 确认 `droppedPeripherals` 为空**,最后才 `stm32_generate`。\n\n**读告警的口径**:`stm32_ioc_plan` 输出里带 `[R1]`…`[R23]` 前缀的告警/错误来自反编译 CubeMX 导入器 + 真机回写实验得到的离线规则(docs §35、§60):R1 = 有 Dma.* 但 Mcu.IPn 里缺 DMA;R2 = ADC Rank/Channel/NbrOfConversion 不自洽;R3 = NVIC 值不是 9 段;R5 = F1 的 ADC 预分频不是除 6;R7 = 某参数没列进 `<IP>.IPParameters` 白名单(会被静默忽略);R18 = 主频超过 db 里芯片上限;R20 = 中断名不在 SVD 中断表里;R21 = DMA 三件套缺件;R22 = 引脚上的 GPIO_* 属性没列进 `GPIOParameters`(CubeMX 会静默删掉,写了等于没写);R23 = EXTI 链路断了(缺 `GPIO_ModeDefaultEXTI` / `SH.GPXTI<line>` / `NVIC.EXTI*_IRQn`,或线号与引脚不符)。看到就先修,再去生成。另有 `[SCHEMA]` 前缀的告警(不是规则编号):生成器写出了不在 .ioc 真值表(`src/data/ioc-schema.ts`)里的键,多半是键名拼错或被 CubeMX 静默忽略的形状——先确认,确属新键再补进真值表。\n\n**别做**:不要手改工程里的 .ioc(走 plan → 用户确认 → apply);不要把 verify 的副本覆盖回工程(副本里被丢的键是真被删了);不要同时跑两个 CubeMX(有单飞锁,会提示占用)。verify 需要本机有可无头调用的 CubeMX(`stm32_ioc_verify` 的 `errors` 会说明去哪配)。";
|
|
9
|
+
export const SKILL_CONTENT = "# STM32 工作流(dsh-stm32)\n\n适用:插件当前支持的族——**HAL 建工程 21 个单核族**(C0/F0/F1/F2/F3/F4/F7/G0/G4/H5/H7/L0/L1/L4/L4+/L5/U0/U3/U5/WBA/WL)+ 双核 WB(只建 M4 核);**寄存器版建工程覆盖内置资源 chips.json 里的 21 族**(C0/F0/F1/F2/F3/F4/F7/G0/G4/H5/H7/L0/L1/L4/L4+/L5/U0/U3/U5/WBA/WL;时钟留复位默认、LED/GPIO 按族生成),其余族(WB / WB0 / WL3 / MP1 / MP2 / N6)仍只有 HAL 或明确拒绝。各族能力由族画像诚实降级,拿不准先 `stm32_route_plan`。本工程的验证板仍是蓝丸。本机的验证板是蓝丸 STM32F103C8T6(64 KiB Flash / 20 KiB RAM);探针 ST-Link / DAPLink(CMSIS-DAP)/ J-Link 都支持——`stm32_flash` / `stm32_debug_run` 先按 USB 实见结果选 interface(ST-Link → `interface/stlink-dap.cfg`,DAPLink/CMSIS-DAP → `interface/cmsis-dap.cfg`,J-Link → `interface/jlink.cfg` 且必须再跟一条 `-c \"transport select swd\"`,它默认选 jtag),装了 STM32CubeProgrammer 时 ST-Link 还有 CLI 后端(`stm32_flash` 的 backend 参数:auto / openocd / cubeprogrammer);`stm32_project_create` 建的工程自带 `.vscode/launch.json`(① 只烧录 / ② 烧录并调试),直接按 F5/Ctrl+F5 即可;换型号不是'换块板子',是一起换启动文件、设备宏与链接脚本——`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`,走寄存器版(启动文件与设备头从缓存目录取,不预置进插件)。**寄存器版建工程覆盖 21 族**(内置资源 chips.json 收了的族),不在这 21 族里的芯片会被判 `hal-only`。\n- 要 HAL:先看工具链与固件包就位没有。`gcc` / `cmake` / `ninja` / `openocd` / `gdb` 可以让 `stm32_env_install` 代装;**CubeMX 与固件包插件不代装**(GUI 向导 + 要 ST 账号),照 `guides[].steps` 自己做,离线机器可以整目录拷过来。\n- `unclear`:别猜,先把需求说具体(外设、数据量、要不要中断/DMA),再重调一次。\n\n## 一、硬规范(红线)\n\n**R1 HAL 工程里,只有自己的三层文件(App/Service/Driver)可自由修改;其余文件只准写在 USER CODE 块内。**\n自己的 `App/`、`Service/`、`Driver/` 下的 .c/.h(见第三节)随便建、随便改,业务逻辑只往那里长。\n除它们之外的一切 CubeMX 产物(`Core/Src/main.c`、各 `*_it.c`、HAL 配置头等)只准在 `/* USER CODE BEGIN X */` 与 `/* USER CODE END X */` 之间写——那是 CubeMX 承诺'重新生成时原样保留'的唯一区域,块外任何一行都不属于你。\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 块里;文件名前缀随族变化,F4 是 `stm32f4xx_*`);\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)。**唯一例外:`cmake/user/CMakeLists.txt` 是用户源注册钩子,新模块登记只准改它(见 W3)。**\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 变了就拒绝。GPIO 引脚用 `pins` 的字段直接表达:`outputType: od` 写开漏(`pp` 是默认值、不写键)、`initial: high` 写初始电平(`low` 不写键)、`interrupt: rising|falling|both` 一次写全 EXTI 链路(`Signal=GPXTI<line>` + `GPIO_ModeDefaultEXTI` + `GPIOParameters` + `SH.GPXTI<line>` + 按线号自动选中的 `NVIC.EXTI*_IRQn`);外设中断用 `interrupts: [USART1:2:0]`(`2:0` 是 preempt:sub,名字按本机 db 实例 / SVD 中断表校验)。\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永远不要用'能不能断下来'来判断烧录成功——openocd 的证据是 `** Programming Finished **` 与 `** Verified OK **`,CubeProgrammer CLI 是 `Data downloaded successfully` 与 `Download verified successfully`。H5/WBA/WB0/WL3 这类 openocd 根本没有 flash 驱动的族,用 `stm32_flash` 的 `backend: \"cubeprogrammer\"`(只认 ST-Link;auto 也会在 openocd 失败后兜底)。\n\n**R6 探针只有一块,型号不必手选。** build / flash / generate 之前先让出调试会话(RTT / debug_session 会占着探针,先 `stm32_debug_stop` / `stm32_rtt stop`);我输出结束(turn/end)时插件会自动关会话,所以别在输出中途把探针攥着不说。interface 由工具按 USB 实见结果决定(ST-Link 走 stlink,DAPLink 走 cmsis-dap),报驱动不匹配时它会自动换一次;**只有工程里手写了 `openocd.cfg` 才以它为准**,那时你负责改它,插件不替你换。\n\n**R7 先 build 再 flash。** 改完代码不编译就烧,烧的是旧 elf;烧完看现象会得出错误结论。\n\n**R8 结论必须带证据。** 说'闪了'要给寄存器/计数器证据(例如 `GPIOC_ODR` 在 0x2000/0x0000 之间翻转、`g_led_blink_count` 单调增长),不要只说'看起来好了'。\n\n## 二、标准流程\n\n1. `stm32_doctor` —— 工具链齐不齐(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. 写代码:业务逻辑按第三节三层结构写进自己的 .c/.h;`main.c` 的 USER CODE 块只留 `app_init()` / `app_run()` 两个插头(W1/W2),块外一行都不碰(R1)。\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## 三、工程写作规范(三层结构与文件组织;针对 HAL 路线工程)\n\n**W1 程序分三层,目录即架构。新模块必须按此;存量代码渐进迁移,不要求一次到位。**\n- `Driver/`(下层):板级外设封装(led、key、uart…),全工程**唯一允许直接调 HAL** 的一层;一个模块一对文件:`Driver/led/led.c` + `led.h`。\n- `Service/`(中层):协议解析、调度、环形缓冲、参数存储;可调 Driver,禁止绕过它直接碰寄存器。\n- `App/`(上层):业务状态机与流程编排;只调 Service/Driver 的 API,**禁止 include HAL 头**。\n`Core/`、`Drivers/` 是 CubeMX 与固件包区,按 R1/R2 处理,不属于这三层。函数以模块名为前缀(`led_init()`、`ring_push()`),同一工程不混用命名风格。\n\n**W2 上层入口只留插头。** `Core/Src/main.c` 的 USER CODE 块里只放两个调用:`app_init()`(BEGIN 2)与 `app_run()`(WHILE 块)。业务逻辑一律写进 App/ 的文件;块内不写状态机、不写外设操作。\n\n**W3 新文件登记只准改 `cmake/user/CMakeLists.txt`(全工程唯一可编辑的 CMake 文件)。** 只动两个变量:`USER_Include_Dirs` 追加各模块目录、`USER_Application_Src` 追加各 .c(相对路径写法照抄现有条目)。根 `CMakeLists.txt` 与 `cmake/stm32cubemx/CMakeLists.txt` 都不许动——后者会被 CubeMX 重写覆盖(R2 的无声故障就出在这),前者 ST 名义上可改但本项目一律不动。\n\n**W4 中断纪律。** ISR(`stm32f1xx_it.c` 自带 USER CODE 块内)只置 `volatile` 标志或入环形缓冲,微秒级出中断;消费逻辑放 App/Service。ISR 上下文禁止 printf、Flash 写、长循环。\n\n**W5 时间与阻塞。** 计时统一 `HAL_GetTick()`;超时判断用回绕安全写法 `(uint32_t)(HAL_GetTick() - t0) < ms`。App/Service 禁止新增 `HAL_Delay` 与无超时 `while` 等待;Driver 初始化里的短等待必须带超时与失败返回。\n\n**W6 资源与错误。** 禁 `malloc`(静态分配 + 编译期尺寸);模块对外返回 `enum <mod>_err`(0 = OK),不返回裸 bool 掩盖失败原因;头文件只暴露类型与 API,实现细节 `static`;include guard 风格全工程统一。\n\n**W7 写完的验收顺序。** `stm32_build`(0 error)→ `stm32_flash`(看 Verified OK)→ 按 R8 读回寄存器/计数器证据。只改代码没动 .ioc 时**不要**跑 `stm32_generate`(省 3–4 分钟,也不引入回归面)。\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- [ ] 新增 .c/.h 已登记进 `cmake/user/CMakeLists.txt`(另外两份 CMakeLists 没动)\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)\n\n## 七、外设写了却没生效?先让它自己说(oracle 诊断)\n\n症状:`stm32_generate` 报成功、`Code succesfully generated`,但 `Core/Src/main.c` 里没有 `MX_TIM2_Init` / `MX_ADC1_Init`,`stm32f1xx_hal_conf.h` 的 `HAL_TIM_MODULE_ENABLED` 仍是注释,日志里**一个 ERROR 都没有**。CubeMX 对不认识的键就是这么处理的:静默丢弃。\n\n**第一步:调 `stm32_ioc_verify`**(约 25–40 s,把 .ioc 复制到 `.dsh-stm32/verify/<stamp>/` 后用 `config load` + `config save` 让 CubeMX 写回“它理解的结果”,工程里的 .ioc 一个字节都不动)。看这几个字段:\n\n- `droppedPeripherals`:写了但 CubeMX 没认的外设;\n- `plannedFunctions`:它计划生成的 `MX_*_Init`(等于不生成代码就预览结果);\n- `signalRewrites`:引脚信号被规范化的地方(`TIM2_CH1` → `S_TIM2_CH1_ETR`、`ADC1_IN1` → `ADCx_IN1`);\n- `sharedSignals`:它自己补出来的 `SH.<信号>.0=<IP 信号>,<IP 模式>`;\n- `autoAddedFunctions`:CubeMX 保存时自己往 `ProjectManager.functionlistsort` 追加的 `MX_*_Init` 条目(我们故意不写,它按既有编号自己补;不影响生成正确性,所以单独列出来而不算 diff);\n- `removedKeys` / `addedKeys`:被 CubeMX 删掉 / 它自己补出来的键(各截 60 条;拼错的键一定出现在 removedKeys 里);\n- `changedValues`:键还在、值被改写的(零 diff 不能只看键在不在);\n- `attribution`:把差异归因分桶——`orderOnly`(值相同、行序不同)、`valueNormalized`(值只是成员顺序/空白被规范化,语义不变)、`valueChanged`(值真被改)、`missingKeys` / `addedKeys` / `droppedPeripherals` / `autoAddedFunctions`,以及 `benign`;\n- `hints`:针对每个被丢外设的“缺什么”。\n\n**判“零实质差异”只看 `attribution.benign`**:`true` 表示只剩行序/成员序的规范化或它自己补的初始化清单,可以放心 generate;`false` 就按各桶逐条修(`removedKeys` 里的 `NVIC.<IP>_IRQn` 通常是“外设没启用就开中断”,`hints` 会直说)。\n\n**三条已知原因(按 hints 对号入座)**:\n\n1. 引脚没列进 `Mcu.PinN`(`Mcu.PinsNb` 也要跟着改)——只写 `PA5.Signal=…` 不列进引脚表,CubeMX 根本不应用这根脚。\n2. 普通外设(USART/SPI…)缺 `<pin>.Mode`:如 `PA9.Mode=Asynchronous`。\n3. 定时器/ADC 走**共享信号**,引脚不能写 `.Mode`,要写块:\n `PA0-WKUP.Signal=S_TIM2_CH1_ETR`(PA0 的定时器信号与 `TIM2_ETR` 合并,必须用合并名)+ `SH.S_TIM2_CH1_ETR.0=TIM2_CH1,PWM Generation1 CH1` + `SH.S_TIM2_CH1_ETR.ConfNb=1`;ADC 是 `PA1.Signal=ADCx_IN1` + `SH.ADCx_IN1.0=ADC1_IN1,IN1`。\n\n**修法**:优先用 `stm32_ioc_plan` 的 `peripherals:[{name:'TIM2', parameters:[{key:'Prescaler',value:'71'},{key:'Period',value:'999'}]}]` 预设(内置 USART1/2/3、TIM2/3/4 CH1 PWM、ADC1/2),它已经按上面三条写全;预设有缺口时再 `entries` 逐键补,改完**再跑一次 `stm32_ioc_verify` 确认 `droppedPeripherals` 为空**,最后才 `stm32_generate`。\n\n**读告警的口径**:`stm32_ioc_plan` 输出里带 `[R1]`…`[R23]` 前缀的告警/错误来自反编译 CubeMX 导入器 + 真机回写实验得到的离线规则(docs §35、§60):R1 = 有 Dma.* 但 Mcu.IPn 里缺 DMA;R2 = ADC Rank/Channel/NbrOfConversion 不自洽;R3 = NVIC 值不是 9 段;R5 = F1 的 ADC 预分频不是除 6;R7 = 某参数没列进 `<IP>.IPParameters` 白名单(会被静默忽略);R18 = 主频超过 db 里芯片上限;R20 = 中断名不在 SVD 中断表里;R21 = DMA 三件套缺件;R22 = 引脚上的 GPIO_* 属性没列进 `GPIOParameters`(CubeMX 会静默删掉,写了等于没写);R23 = EXTI 链路断了(缺 `GPIO_ModeDefaultEXTI` / `SH.GPXTI<line>` / `NVIC.EXTI*_IRQn`,或线号与引脚不符)。看到就先修,再去生成。另有 `[SCHEMA]` 前缀的告警(不是规则编号):生成器写出了不在 .ioc 真值表(`src/data/ioc-schema.ts`)里的键,多半是键名拼错或被 CubeMX 静默忽略的形状——先确认,确属新键再补进真值表。\n\n**别做**:不要手改工程里的 .ioc(走 plan → 用户确认 → apply);不要把 verify 的副本覆盖回工程(副本里被丢的键是真被删了);不要同时跑两个 CubeMX(有单飞锁,会提示占用)。verify 需要本机有可无头调用的 CubeMX(`stm32_ioc_verify` 的 `errors` 会说明去哪配)。";
|
|
10
10
|
/** 注册 skill;宿主没组合 skills 服务时直接返回。 */
|
|
11
11
|
export function registerStm32Skill(ctx) {
|
|
12
12
|
const skills = ctx.get("skills");
|
package/lib/tools/assets.js
CHANGED
|
@@ -121,8 +121,7 @@ export function registerAssets(ctx, options = {}) {
|
|
|
121
121
|
},
|
|
122
122
|
keep: {
|
|
123
123
|
type: "number",
|
|
124
|
-
|
|
125
|
-
description: "prune 保留几个历史版本,默认 2(内置资源不受影响)。",
|
|
124
|
+
description: "prune 保留几个历史版本(≥1 的整数),默认 2(内置资源不受影响)。",
|
|
126
125
|
},
|
|
127
126
|
},
|
|
128
127
|
required: [],
|
|
@@ -255,7 +254,13 @@ export function registerAssets(ctx, options = {}) {
|
|
|
255
254
|
/* ---------------------------- prune ---------------------------- */
|
|
256
255
|
if (action === "prune") {
|
|
257
256
|
const value = base();
|
|
258
|
-
|
|
257
|
+
// schema 里不能再写 minimum(宿主 0.2.2 的 schema 子集不认),范围改在这里兜。
|
|
258
|
+
if (args.keep !== undefined && (typeof args.keep !== "number" || !Number.isFinite(args.keep) || Math.floor(args.keep) < 1)) {
|
|
259
|
+
value.ok = false;
|
|
260
|
+
value.message = "keep 必须是 ≥1 的整数(实际 " + JSON.stringify(args.keep) + ")。什么都没删。";
|
|
261
|
+
return value;
|
|
262
|
+
}
|
|
263
|
+
const keep = typeof args.keep === "number" ? Math.floor(args.keep) : 2;
|
|
259
264
|
const pruned = pruneOldVersions(env, keep);
|
|
260
265
|
value.ok = true;
|
|
261
266
|
value.versions = versionsOf();
|
package/lib/tools/build.js
CHANGED
|
@@ -118,7 +118,6 @@ export function registerBuild(ctx) {
|
|
|
118
118
|
type: "array",
|
|
119
119
|
items: { type: "string", enum: ["elf", "hex", "bin"] },
|
|
120
120
|
description: "编译成功后额外转出的产物格式(默认只有 elf):hex 给产线烧录器 / CubeProgrammer,bin 给串口 ISP 与 OTA 镜像。转换失败不判编译失败,只写 warning。",
|
|
121
|
-
additionalProperties: false,
|
|
122
121
|
},
|
|
123
122
|
foreground: { type: "boolean", description: "同步返回完整报告(默认 false,走后台 job)。" },
|
|
124
123
|
binDirs: { type: "array", items: { type: "string" }, description: "工具链目录候选,优先于默认值/环境变量。" },
|
package/lib/tools/ioc-plan.js
CHANGED
|
@@ -321,14 +321,24 @@ export function registerIocPlan(ctx) {
|
|
|
321
321
|
properties: {
|
|
322
322
|
name: { type: "string", description: "预设名(= 实例名),如 USART1、TIM2、ADC1。" },
|
|
323
323
|
pins: {
|
|
324
|
-
type: "
|
|
325
|
-
description: "
|
|
326
|
-
|
|
324
|
+
type: "array",
|
|
325
|
+
description: "覆盖默认引脚:[{ key: \"tx\", value: \"PA2\" }]。key 是角色名(tx/rx/ch1/in1…),value 是逻辑引脚名(PA2)。",
|
|
326
|
+
items: {
|
|
327
|
+
type: "object",
|
|
328
|
+
additionalProperties: false,
|
|
329
|
+
properties: { key: { type: "string" }, value: { type: "string" } },
|
|
330
|
+
required: ["key", "value"],
|
|
331
|
+
},
|
|
327
332
|
},
|
|
328
333
|
parameters: {
|
|
329
|
-
type: "
|
|
330
|
-
description: "覆盖默认参数(写进 <ip>.IPParameters
|
|
331
|
-
|
|
334
|
+
type: "array",
|
|
335
|
+
description: "覆盖默认参数(写进 <ip>.IPParameters):[{ key: \"Prescaler\", value: \"71\" }, { key: \"Period\", value: \"999\" }]。",
|
|
336
|
+
items: {
|
|
337
|
+
type: "object",
|
|
338
|
+
additionalProperties: false,
|
|
339
|
+
properties: { key: { type: "string" }, value: { type: "string" } },
|
|
340
|
+
required: ["key", "value"],
|
|
341
|
+
},
|
|
332
342
|
},
|
|
333
343
|
},
|
|
334
344
|
required: ["name"],
|
|
@@ -342,7 +352,7 @@ export function registerIocPlan(ctx) {
|
|
|
342
352
|
properties: {
|
|
343
353
|
targetHz: { type: "number", description: "目标 SYSCLK(Hz),例如 60000000。" },
|
|
344
354
|
pllSource: { type: "string", enum: ["hse", "hsi-div2", "hsi"], description: "PLL 输入源;缺省按 .ioc 有没有配 HSE 晶振决定。" },
|
|
345
|
-
pllMul: { type: "
|
|
355
|
+
pllMul: { type: "integer", enum: [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16], description: "定点倍频 ×2..×16;给了就不再就近搜。" },
|
|
346
356
|
apb1Div: { type: "number", description: "APB1 分频 1/2/4/8/16;缺省取满足 APB1≤36 MHz 的最小分频。" },
|
|
347
357
|
apb2Div: { type: "number", description: "APB2 分频;缺省 1(降频只会拖慢外设)。" },
|
|
348
358
|
adcDiv: { type: "number", description: "ADC 预分频 2/4/6/8;缺省取满足 ADC≤14 MHz 的最小分频。" },
|
package/package.json
CHANGED
|
@@ -1,70 +1,70 @@
|
|
|
1
|
-
{
|
|
2
|
-
"name": "dsh-stm32",
|
|
3
|
-
"version": "0.1.
|
|
4
|
-
"description": "DSH 插件:STM32 全流程工具层(HAL 多族 + 寄存器 21 族)—— 环境探测、.ioc 事务、生成工程、编译、烧录、调试;芯片事实与模板随包内置",
|
|
5
|
-
"type": "module",
|
|
6
|
-
"main": "lib/index.js",
|
|
7
|
-
"exports": {
|
|
8
|
-
".": "./lib/index.js",
|
|
9
|
-
"./client": "./lib/client.js",
|
|
10
|
-
"./package.json": "./package.json"
|
|
11
|
-
},
|
|
12
|
-
"files": [
|
|
13
|
-
"lib",
|
|
14
|
-
"client",
|
|
15
|
-
"templates",
|
|
16
|
-
"assets",
|
|
17
|
-
"docs/reading-guide.md",
|
|
18
|
-
"cordis.patch.yml",
|
|
19
|
-
"README.md",
|
|
20
|
-
"README_EN.md",
|
|
21
|
-
"LICENSE"
|
|
22
|
-
],
|
|
23
|
-
"engines": {
|
|
24
|
-
"node": ">=20"
|
|
25
|
-
},
|
|
26
|
-
"scripts": {
|
|
27
|
-
"build": "tsc -p tsconfig.json && node scripts/copy-client.mjs && node scripts/copy-data.mjs",
|
|
28
|
-
"typecheck": "tsc -p tsconfig.json --noEmit",
|
|
29
|
-
"test": "node test/run-units.mjs",
|
|
30
|
-
"prepublishOnly": "npm run build",
|
|
31
|
-
"test:pack": "node scripts/pack-smoke.mjs",
|
|
32
|
-
"test:size": "node scripts/pack-size.mjs"
|
|
33
|
-
},
|
|
34
|
-
"keywords": [
|
|
35
|
-
"dsh-plugin",
|
|
36
|
-
"dsh",
|
|
37
|
-
"stm32",
|
|
38
|
-
"stm32f103c8t6",
|
|
39
|
-
"cortex-m3",
|
|
40
|
-
"arm",
|
|
41
|
-
"embedded",
|
|
42
|
-
"firmware",
|
|
43
|
-
"stm32cubemx",
|
|
44
|
-
"openocd",
|
|
45
|
-
"cmsis-dap",
|
|
46
|
-
"gdb"
|
|
47
|
-
],
|
|
48
|
-
"license": "MIT",
|
|
49
|
-
"author": "dsh-stm32 contributors",
|
|
50
|
-
"repository": {
|
|
51
|
-
"type": "git",
|
|
52
|
-
"url": "git+https://github.com/JingYu-er/dsh-stm32.git"
|
|
53
|
-
},
|
|
54
|
-
"homepage": "https://github.com/JingYu-er/dsh-stm32#readme",
|
|
55
|
-
"bugs": {
|
|
56
|
-
"url": "https://github.com/JingYu-er/dsh-stm32/issues"
|
|
57
|
-
},
|
|
58
|
-
"dsh": {
|
|
59
|
-
"bundle": {
|
|
60
|
-
"patch": "./cordis.patch.yml"
|
|
61
|
-
},
|
|
62
|
-
"client": {
|
|
63
|
-
"platform": "web"
|
|
64
|
-
}
|
|
65
|
-
},
|
|
66
|
-
"devDependencies": {
|
|
67
|
-
"@types/node": "^26.6.5",
|
|
68
|
-
"typescript": "^5.9.2"
|
|
69
|
-
}
|
|
70
|
-
}
|
|
1
|
+
{
|
|
2
|
+
"name": "dsh-stm32",
|
|
3
|
+
"version": "0.1.6",
|
|
4
|
+
"description": "DSH 插件:STM32 全流程工具层(HAL 多族 + 寄存器 21 族)—— 环境探测、.ioc 事务、生成工程、编译、烧录、调试;芯片事实与模板随包内置",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"main": "lib/index.js",
|
|
7
|
+
"exports": {
|
|
8
|
+
".": "./lib/index.js",
|
|
9
|
+
"./client": "./lib/client.js",
|
|
10
|
+
"./package.json": "./package.json"
|
|
11
|
+
},
|
|
12
|
+
"files": [
|
|
13
|
+
"lib",
|
|
14
|
+
"client",
|
|
15
|
+
"templates",
|
|
16
|
+
"assets",
|
|
17
|
+
"docs/reading-guide.md",
|
|
18
|
+
"cordis.patch.yml",
|
|
19
|
+
"README.md",
|
|
20
|
+
"README_EN.md",
|
|
21
|
+
"LICENSE"
|
|
22
|
+
],
|
|
23
|
+
"engines": {
|
|
24
|
+
"node": ">=20"
|
|
25
|
+
},
|
|
26
|
+
"scripts": {
|
|
27
|
+
"build": "tsc -p tsconfig.json && node scripts/copy-client.mjs && node scripts/copy-data.mjs",
|
|
28
|
+
"typecheck": "tsc -p tsconfig.json --noEmit",
|
|
29
|
+
"test": "node test/run-units.mjs",
|
|
30
|
+
"prepublishOnly": "npm run build",
|
|
31
|
+
"test:pack": "node scripts/pack-smoke.mjs",
|
|
32
|
+
"test:size": "node scripts/pack-size.mjs"
|
|
33
|
+
},
|
|
34
|
+
"keywords": [
|
|
35
|
+
"dsh-plugin",
|
|
36
|
+
"dsh",
|
|
37
|
+
"stm32",
|
|
38
|
+
"stm32f103c8t6",
|
|
39
|
+
"cortex-m3",
|
|
40
|
+
"arm",
|
|
41
|
+
"embedded",
|
|
42
|
+
"firmware",
|
|
43
|
+
"stm32cubemx",
|
|
44
|
+
"openocd",
|
|
45
|
+
"cmsis-dap",
|
|
46
|
+
"gdb"
|
|
47
|
+
],
|
|
48
|
+
"license": "MIT",
|
|
49
|
+
"author": "dsh-stm32 contributors",
|
|
50
|
+
"repository": {
|
|
51
|
+
"type": "git",
|
|
52
|
+
"url": "git+https://github.com/JingYu-er/dsh-stm32.git"
|
|
53
|
+
},
|
|
54
|
+
"homepage": "https://github.com/JingYu-er/dsh-stm32#readme",
|
|
55
|
+
"bugs": {
|
|
56
|
+
"url": "https://github.com/JingYu-er/dsh-stm32/issues"
|
|
57
|
+
},
|
|
58
|
+
"dsh": {
|
|
59
|
+
"bundle": {
|
|
60
|
+
"patch": "./cordis.patch.yml"
|
|
61
|
+
},
|
|
62
|
+
"client": {
|
|
63
|
+
"platform": "web"
|
|
64
|
+
}
|
|
65
|
+
},
|
|
66
|
+
"devDependencies": {
|
|
67
|
+
"@types/node": "^26.6.5",
|
|
68
|
+
"typescript": "^5.9.2"
|
|
69
|
+
}
|
|
70
|
+
}
|