dsh-stm32 0.1.1 → 0.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (62) hide show
  1. package/README.md +98 -31
  2. package/README_EN.md +96 -29
  3. package/docs/development-notes.md +837 -4
  4. package/docs/reading-guide.md +759 -0
  5. package/lib/commands/register.js +49 -0
  6. package/lib/data/chips.js +147 -30
  7. package/lib/data/clock-f1.js +158 -0
  8. package/lib/data/cmsis-sources.js +237 -42
  9. package/lib/data/device-facts.js +201 -0
  10. package/lib/data/stm32f1.js +130 -0
  11. package/lib/data/svd.js +627 -0
  12. package/lib/engine/assets.js +924 -0
  13. package/lib/engine/breakpoints.js +242 -0
  14. package/lib/engine/build.js +115 -16
  15. package/lib/engine/cache.js +56 -0
  16. package/lib/engine/clock-plan.js +608 -0
  17. package/lib/engine/cmake-sources.js +428 -0
  18. package/lib/engine/debug-session.js +153 -5
  19. package/lib/engine/debug.js +114 -15
  20. package/lib/engine/doctor.js +395 -4
  21. package/lib/engine/fetch.js +174 -30
  22. package/lib/engine/flash.js +70 -9
  23. package/lib/engine/generate.js +11 -0
  24. package/lib/engine/hal-chip.js +230 -0
  25. package/lib/engine/ioc-plan.js +33 -7
  26. package/lib/engine/msys2-install.js +332 -61
  27. package/lib/engine/probe-error.js +212 -0
  28. package/lib/engine/probe-session.js +311 -0
  29. package/lib/engine/project-export.js +129 -0
  30. package/lib/engine/register-clock.js +132 -0
  31. package/lib/engine/register-linker.js +129 -0
  32. package/lib/engine/register-template.js +115 -20
  33. package/lib/engine/regs.js +2 -0
  34. package/lib/engine/rtt.js +600 -0
  35. package/lib/engine/scaffold.js +104 -28
  36. package/lib/engine/zip.js +142 -0
  37. package/lib/index.js +10 -0
  38. package/lib/skill/stm32-workflow.js +3 -3
  39. package/lib/tools/assets.js +341 -0
  40. package/lib/tools/build.js +12 -0
  41. package/lib/tools/cache.js +47 -8
  42. package/lib/tools/debug-session.js +40 -5
  43. package/lib/tools/debug.js +41 -4
  44. package/lib/tools/doctor.js +22 -2
  45. package/lib/tools/flash.js +15 -3
  46. package/lib/tools/generate.js +3 -0
  47. package/lib/tools/ioc-apply.js +2 -0
  48. package/lib/tools/ioc-inspect.js +2 -0
  49. package/lib/tools/ioc-plan.js +198 -4
  50. package/lib/tools/project-create.js +50 -1
  51. package/lib/tools/project-export.js +100 -0
  52. package/lib/tools/regs.js +453 -61
  53. package/lib/tools/route-plan.js +3 -0
  54. package/lib/tools/rtt.js +347 -0
  55. package/package.json +5 -3
  56. package/templates/register/CMakeLists.txt +25 -6
  57. package/templates/register/Core/Inc/rtt.h +103 -0
  58. package/templates/register/Core/Src/main.c +43 -9
  59. package/templates/register/Core/Src/rtt.c +297 -0
  60. package/templates/scaffold/RTT.md +86 -0
  61. package/templates/scaffold/cmake/user/CMakeLists.txt +7 -0
  62. package/templates/scaffold/openocd.cfg +8 -0
@@ -0,0 +1,130 @@
1
+ /**
2
+ * L1:STM32F1 型号 → 芯片事实(容量档 / 启动文件 / 设备宏 / 设备头 / Flash / RAM / 引脚数)。
3
+ *
4
+ * 这里只剩**解析逻辑**,没有事实:事实全部来自资源包缓存里的 device/f1/chips.json,
5
+ * 经 src/data/device-facts.ts 读入(用户 2026-10-31「内置表删了吧」的决定)。
6
+ * 所以本文件不再有 F1_LINES / GROUP_BY_LETTER / FLASH_BY_LETTER / RAM_BY_LINE_LETTER
7
+ * 这类表——加一款芯片只改资源仓库的 scripts/build-assets.mjs,插件一个字都不用动。
8
+ *
9
+ * 支持三种输入(与 0.2 一致,调用方不用改):
10
+ * - 完整型号:STM32F103C8T6 / STM32F103RCT6 / STM32F107VCT6
11
+ * - 去掉温度后缀:STM32F103C8(按 chips.json 里同前缀的唯一一颗归一化)
12
+ * - 显式容量档:F103:xb(脚本与 cmsis 缓存 id 用;取该档在资源包里的一个代表型号)
13
+ *
14
+ * 认不出时返回 chip: null + 人话原因,绝不编一个不存在的启动文件。
15
+ * 没装资源包时同样返回 chip: null,原因里带「先跑 stm32_assets refresh,或检查网络」。
16
+ */
17
+ import { DEVICE_FACTS_HINT, loadDeviceFacts } from "./device-facts.js";
18
+ /** 完整型号:STM32F103RCT6 → line 103 / 封装 R / 容量 C / 后缀 T / 温度 6。 */
19
+ const CPN_PATTERN = /^STM32F(\d{3})([A-Z])([0-9A-G])([A-Z])?([0-9])?$/u;
20
+ /** 容量档写法:F103:xb(脚本、cmsis 缓存 id 用)。 */
21
+ const GROUP_PATTERN = /^F(\d{2,3}):(X[0-9A-Z]{1,2})$/u;
22
+ /**
23
+ * 型号 → 芯片事实。认不出返回 chip: null + 原因,绝不编一个不存在的启动文件。
24
+ */
25
+ export function resolveF1Chip(input) {
26
+ const text = input.trim().toUpperCase();
27
+ if (text.length === 0)
28
+ return { chip: null, reason: "没有给型号" };
29
+ const facts = loadDeviceFacts();
30
+ if (!facts.ok)
31
+ return { chip: null, reason: facts.error };
32
+ const loose = GROUP_PATTERN.exec(text);
33
+ if (loose !== null) {
34
+ const code = loose[1] ?? "";
35
+ const group = (loose[2] ?? "").toLowerCase();
36
+ if (!facts.lines.includes(code))
37
+ return { chip: null, reason: lineMissing(facts, code) };
38
+ const fact = facts.byLineGroup.get(code + ":" + group);
39
+ if (fact === undefined)
40
+ return { chip: null, reason: groupMissing(facts, code, group) };
41
+ return { chip: chipFromFact(fact), reason: "" };
42
+ }
43
+ const m = CPN_PATTERN.exec(text);
44
+ if (m === null)
45
+ return { chip: null, reason: "不是 F1 的型号格式:" + input };
46
+ const code = m[1] ?? "";
47
+ const suffix = m[4] ?? "";
48
+ const extra = m[5] ?? "";
49
+ if (suffix.length > 0 && !"TXUYK".includes(suffix)) {
50
+ return { chip: null, reason: "认不出封装后缀 " + suffix + "(期望 T/U/Y 之一):" + input };
51
+ }
52
+ if (extra.length > 0 && !"67".includes(extra)) {
53
+ return { chip: null, reason: "认不出温度档 " + extra + "(期望 6 或 7):" + input };
54
+ }
55
+ if (!facts.lines.includes(code))
56
+ return { chip: null, reason: lineMissing(facts, code) };
57
+ const fact = matchFact(facts, text);
58
+ if (fact === null) {
59
+ return { chip: null, reason: unknownChip(facts, text, code, m[3] ?? "") };
60
+ }
61
+ return { chip: chipFromFact(fact), reason: "" };
62
+ }
63
+ /**
64
+ * 型号 → 资源包里的那颗。先精确匹配 cpn;没有再按「cpn 以输入开头」归一化
65
+ * (STM32F103C8 → STM32F103C8T6,即用户省略了温度后缀)。
66
+ * 多命中时取 cpn 最短、再按字典序——同一份事实永远给同一个结果。
67
+ */
68
+ function matchFact(facts, text) {
69
+ const exact = facts.byCpn.get(text);
70
+ if (exact !== undefined)
71
+ return exact;
72
+ const candidates = facts.chips.filter((chip) => chip.cpn.startsWith(text));
73
+ if (candidates.length === 0)
74
+ return null;
75
+ candidates.sort((left, right) => {
76
+ if (left.cpn.length !== right.cpn.length)
77
+ return left.cpn.length - right.cpn.length;
78
+ return left.cpn < right.cpn ? -1 : left.cpn > right.cpn ? 1 : 0;
79
+ });
80
+ return candidates[0] ?? null;
81
+ }
82
+ function lineMissing(facts, code) {
83
+ return ("F1 里没有 F" + code + " 这一 line(资源包已知:" + facts.lines.join("/") + ");" + DEVICE_FACTS_HINT + ",看有没有新版资源包。");
84
+ }
85
+ function groupMissing(facts, code, group) {
86
+ const groups = facts.groupsByLine.get(code) ?? [];
87
+ return ("STM32F" + code + " 没有 " + group + " 这一容量档(资源包里的档位:" + groups.join("/") + ");" +
88
+ DEVICE_FACTS_HINT + ",看有没有新版资源包。");
89
+ }
90
+ /**
91
+ * 格式对、line 在,但资源包里没有这一颗。
92
+ * 分两种情况说清楚,别把「没收录」说成「不存在」:
93
+ * · 这个容量档在资源包里有,只是没有这个封装/温度后缀的组合(例如 C8T7);
94
+ * · 这个容量档根本没收录(上游 CubeMX 没给出这档的 RAM/Flash,或者资源包还没覆盖,例如 F100RCT6)。
95
+ */
96
+ function unknownChip(facts, text, code, densityLetter) {
97
+ const groups = facts.groupsByLine.get(code) ?? [];
98
+ const direct = "x" + densityLetter.toLowerCase();
99
+ const inGroup = groups.includes(direct);
100
+ const detail = inGroup
101
+ ? "这一容量档在,但没有「封装 + 温度后缀」正好是这串的组合"
102
+ : "这一档没有收录(上游没给这档的 RAM/Flash,或资源包还没覆盖)";
103
+ return ("资源包(" + (facts.version === "" ? "未知版本" : facts.version) + ")里没有 " + text + " 这一颗:" +
104
+ "STM32F" + code + " 收录了 " + groups.join("/") + " 容量档;" + detail + ";" +
105
+ DEVICE_FACTS_HINT + ",看有没有新版资源包,或换一颗同档的常见型号(资源包共 " + String(facts.chips.length) + " 颗)。");
106
+ }
107
+ function chipFromFact(fact) {
108
+ const lineMatch = /^STM32F(\d{3})/u.exec(fact.cpn);
109
+ const densityMatch = /^STM32F\d{3}[A-Z]([0-9A-G])/u.exec(fact.cpn);
110
+ return {
111
+ cpn: fact.cpn,
112
+ prefix: lineMatch === null ? "STM32F" + fact.line : "STM32F" + (lineMatch[1] ?? fact.line),
113
+ densityLetter: densityMatch?.[1] ?? fact.group.slice(1).toUpperCase(),
114
+ group: fact.group,
115
+ startup: fact.startup,
116
+ deviceDefine: fact.deviceDefine,
117
+ deviceHeader: fact.deviceHeader,
118
+ pinCount: fact.pinCount,
119
+ flashBytes: fact.flashBytes,
120
+ ramBytes: fact.ramBytes,
121
+ notes: [],
122
+ };
123
+ }
124
+ /** 该 line 的全部容量档(去重升序;给「这个型号能选哪些档」的报告用)。 */
125
+ export function f1GroupsFor(code) {
126
+ const facts = loadDeviceFacts();
127
+ if (!facts.ok)
128
+ return [];
129
+ return facts.groupsByLine.get(code.trim()) ?? [];
130
+ }