dsh-stm32 0.1.0 → 0.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +127 -29
- package/README_EN.md +125 -29
- package/client/client.js +682 -0
- package/docs/development-notes.md +1385 -5
- package/docs/logic-audit.md +607 -0
- package/docs/reading-guide.md +738 -0
- package/lib/client.js +682 -0
- package/lib/commands/register.js +214 -12
- package/lib/data/chips.js +134 -4
- package/lib/data/clock-f1.js +158 -0
- package/lib/data/cmsis-sources.js +316 -0
- package/lib/data/f1-ram.generated.js +34 -0
- package/lib/data/firmware-packages.js +352 -0
- package/lib/data/install-guides.js +190 -0
- package/lib/data/search-roots.js +135 -15
- package/lib/data/stm32f1.js +186 -0
- package/lib/data/toolchain-config.js +310 -0
- package/lib/engine/build.js +121 -16
- package/lib/engine/cache.js +336 -0
- package/lib/engine/clock-plan.js +608 -0
- package/lib/engine/cmake-sources.js +428 -0
- package/lib/engine/code-patch.js +18 -6
- package/lib/engine/debug-session.js +163 -4
- package/lib/engine/debug.js +84 -19
- package/lib/engine/doctor.js +395 -4
- package/lib/engine/fetch.js +287 -0
- package/lib/engine/firmware-install.js +668 -0
- package/lib/engine/flash.js +145 -15
- package/lib/engine/fs-longpath.js +107 -0
- package/lib/engine/generate-cache.js +118 -0
- package/lib/engine/generate-script.js +30 -8
- package/lib/engine/generate.js +296 -14
- package/lib/engine/hal-chip.js +230 -0
- package/lib/engine/ioc-plan.js +47 -8
- package/lib/engine/msys2-install.js +1870 -0
- package/lib/engine/probe.js +57 -6
- package/lib/engine/project-export.js +129 -0
- package/lib/engine/register-clock.js +132 -0
- package/lib/engine/register-linker.js +129 -0
- package/lib/engine/register-template.js +449 -0
- package/lib/engine/regs.js +18 -4
- package/lib/engine/route-plan.js +553 -0
- package/lib/engine/scaffold.js +303 -72
- package/lib/engine/subprocess-runner.js +2 -0
- package/lib/engine/tar.js +250 -0
- package/lib/engine/text-file.js +150 -0
- package/lib/engine/thirdparty.js +243 -0
- package/lib/engine/tool-env.js +51 -0
- package/lib/engine/toolchain-gate.js +386 -0
- package/lib/engine/vscode-config.js +99 -0
- package/lib/engine/web-api.js +375 -0
- package/lib/engine/web-routes.js +100 -0
- package/lib/engine/xcube-catalog.js +102 -0
- package/lib/engine/xcube.js +254 -0
- package/lib/engine/zip.js +142 -0
- package/lib/index.js +44 -2
- package/lib/skill/stm32-workflow.js +3 -3
- package/lib/tools/build.js +55 -3
- package/lib/tools/cache.js +250 -0
- package/lib/tools/code-patch.js +29 -2
- package/lib/tools/debug-session.js +56 -14
- package/lib/tools/debug.js +43 -2
- package/lib/tools/doctor.js +16 -3
- package/lib/tools/env-install.js +472 -0
- package/lib/tools/env-probe.js +6 -2
- package/lib/tools/firmware-install.js +255 -0
- package/lib/tools/flash.js +41 -2
- package/lib/tools/generate.js +96 -10
- package/lib/tools/ioc-apply.js +27 -11
- package/lib/tools/ioc-inspect.js +4 -2
- package/lib/tools/ioc-plan.js +209 -11
- package/lib/tools/project-create.js +229 -21
- package/lib/tools/project-dir.js +95 -0
- package/lib/tools/project-export.js +100 -0
- package/lib/tools/regs.js +82 -7
- package/lib/tools/route-plan.js +467 -0
- package/package.json +11 -4
- package/templates/register/CMakeLists.txt +52 -0
- package/templates/register/Core/Src/main.c +72 -0
- package/templates/scaffold/openocd.cfg +8 -0
- package/templates/scaffold/vscode/launch.json +8 -6
- package/templates/scaffold/vscode/settings.json +5 -11
package/lib/engine/probe.js
CHANGED
|
@@ -34,6 +34,34 @@ export function resolveFromDirs(candidate, binDirs) {
|
|
|
34
34
|
}
|
|
35
35
|
return null;
|
|
36
36
|
}
|
|
37
|
+
/**
|
|
38
|
+
* 引擎里找可执行文件的统一入口:先按显式目录(msys64 / binDirs)找文件,
|
|
39
|
+
* 再交给宿主解析(等价于 PATH)。门禁(toolchain-gate)走的是同一套规则,
|
|
40
|
+
* 两边不一致就会出现"门禁说齐全、引擎说找不到"的错位。
|
|
41
|
+
*/
|
|
42
|
+
export async function resolveToolIn(subprocess, names, binDirs, signal) {
|
|
43
|
+
const dirs = [...binDirs];
|
|
44
|
+
for (const name of names) {
|
|
45
|
+
const hit = resolveFromDirs(name, dirs);
|
|
46
|
+
if (hit !== null)
|
|
47
|
+
return hit;
|
|
48
|
+
}
|
|
49
|
+
if (subprocess === null || subprocess === undefined)
|
|
50
|
+
return null;
|
|
51
|
+
if (typeof subprocess.resolveExecutable !== "function")
|
|
52
|
+
return null;
|
|
53
|
+
for (const name of names) {
|
|
54
|
+
try {
|
|
55
|
+
const resolved = await subprocess.resolveExecutable(name, undefined, signal);
|
|
56
|
+
if (typeof resolved === "string" && resolved !== "")
|
|
57
|
+
return resolved;
|
|
58
|
+
}
|
|
59
|
+
catch {
|
|
60
|
+
// 宿主解析失败(命令不存在)就继续试下一个候选名。
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
return null;
|
|
64
|
+
}
|
|
37
65
|
function firstMeaningfulLine(text) {
|
|
38
66
|
for (const line of text.split(/\r?\n/u)) {
|
|
39
67
|
const trimmed = line.trim();
|
|
@@ -48,6 +76,9 @@ async function resolveCandidate(subprocess, candidate, config, options) {
|
|
|
48
76
|
return fromDirs;
|
|
49
77
|
if (isAbsoluteCandidate(candidate))
|
|
50
78
|
return null;
|
|
79
|
+
// 只认候选目录时到此为止:再往 PATH 退就分不清"装到了这个目录"和"机器上本来就有"。
|
|
80
|
+
if (options.allowPathFallback === false)
|
|
81
|
+
return null;
|
|
51
82
|
try {
|
|
52
83
|
return await subprocess.resolveExecutable(candidate, undefined, options.signal);
|
|
53
84
|
}
|
|
@@ -132,10 +163,30 @@ export async function probeAll(subprocess, targets, config, options = {}) {
|
|
|
132
163
|
}
|
|
133
164
|
return results;
|
|
134
165
|
}
|
|
166
|
+
/** 从 binDirs 里认出 MSYS2 根(<root>/ucrt64/bin 这种形状)。 */
|
|
167
|
+
export function msys64RootFromBinDirs(binDirs) {
|
|
168
|
+
for (const dir of binDirs) {
|
|
169
|
+
const match = /^(.*)\/(?:ucrt64|mingw64|clang64|mingw32)\/bin$/iu.exec(dir);
|
|
170
|
+
const root = match?.[1] ?? "";
|
|
171
|
+
if (root !== "")
|
|
172
|
+
return root;
|
|
173
|
+
}
|
|
174
|
+
return "";
|
|
175
|
+
}
|
|
176
|
+
/**
|
|
177
|
+
* 安装建议里的 pacman:知道用户的 MSYS2 在哪就用它,不知道就给 MSYS2 的默认安装位置。
|
|
178
|
+
* 绝不写死开发机的 D:/app/msys64 —— 别人机器上没这个目录,贴出来的命令等于假的。
|
|
179
|
+
*/
|
|
180
|
+
function pacmanHint(config) {
|
|
181
|
+
const root = msys64RootFromBinDirs(config.binDirs);
|
|
182
|
+
return (root === "" ? "C:/msys64" : root) + "/usr/bin/pacman.exe -S ";
|
|
183
|
+
}
|
|
135
184
|
/** 本机需要的能力清单。路径全部来自配置,不在逻辑里硬编码。 */
|
|
136
185
|
export function buildTargets(config) {
|
|
186
|
+
const pacman = pacmanHint(config);
|
|
137
187
|
const cubeMxLaunchers = config.cubeMxRoots.map((dir) => dir + "/STM32CubeMX.exe");
|
|
138
188
|
const cubeMxJavas = config.cubeMxRoots.map((dir) => dir + "/jre/bin/java.exe");
|
|
189
|
+
const cubeMxDefaultRoot = "C:/Program Files/STMicroelectronics/STM32Cube/STM32CubeMX";
|
|
139
190
|
return [
|
|
140
191
|
{
|
|
141
192
|
id: "gcc",
|
|
@@ -146,7 +197,7 @@ export function buildTargets(config) {
|
|
|
146
197
|
hint: "装 GNU Arm 工具链:msys64 里 pacman -S mingw-w64-ucrt-x86_64-arm-none-eabi-gcc",
|
|
147
198
|
impact: "编译不了:没有 arm-none-eabi-gcc 就产不出 build/Debug/demo.elf,烧录和调试也无从谈起。",
|
|
148
199
|
install: [
|
|
149
|
-
"
|
|
200
|
+
"已有 MSYS2 时最省事:" + pacman + "mingw-w64-ucrt-x86_64-arm-none-eabi-gcc(13.3.0)",
|
|
150
201
|
"没有 MSYS2:winget install --id Arm.ArmGnuToolchain;装完把它的 bin 目录加进 STM32_BIN_DIRS(分号分隔,整份替换默认值)",
|
|
151
202
|
"装完自检:arm-none-eabi-gcc --version",
|
|
152
203
|
],
|
|
@@ -161,7 +212,7 @@ export function buildTargets(config) {
|
|
|
161
212
|
hint: "调试要 GDB:msys64 里 pacman -S mingw-w64-ucrt-x86_64-gdb-multiarch",
|
|
162
213
|
impact: "调试用不了(F5 / stm32_debug_run 起不来 GDB);只烧录不受影响,纯烧录只需要 openocd。",
|
|
163
214
|
install: [
|
|
164
|
-
"MSYS2:
|
|
215
|
+
"MSYS2:" + pacman + "mingw-w64-ucrt-x86_64-gdb-multiarch(16.2;UCRT64 仓库里没有 arm-none-eabi-gdb 这个包)",
|
|
165
216
|
"不想装 MSYS2:winget install --id Arm.ArmGnuToolchain,它自带 arm-none-eabi-gdb,装完加进 STM32_BIN_DIRS",
|
|
166
217
|
"装完自检:gdb-multiarch --version",
|
|
167
218
|
],
|
|
@@ -176,7 +227,7 @@ export function buildTargets(config) {
|
|
|
176
227
|
hint: "烧录/调试服务端:msys64 里 pacman -S mingw-w64-ucrt-x86_64-openocd",
|
|
177
228
|
impact: "烧录和调试都用不了(stm32_flash / stm32_debug_run / stm32_stop 全部失败);生成代码、编译、改 USER CODE 不受影响。",
|
|
178
229
|
install: [
|
|
179
|
-
"MSYS2:
|
|
230
|
+
"MSYS2:" + pacman + "mingw-w64-ucrt-x86_64-openocd(0.12.0)",
|
|
180
231
|
"不想装 MSYS2:winget install --id xpack-dev-tools.openocd-xpack",
|
|
181
232
|
"装完自检:openocd --version",
|
|
182
233
|
],
|
|
@@ -191,7 +242,7 @@ export function buildTargets(config) {
|
|
|
191
242
|
hint: "配置/编译要 CMake:msys64 里 pacman -S mingw-w64-ucrt-x86_64-cmake",
|
|
192
243
|
impact: "配置和编译都会失败(build/Debug 配不起来);烧录现成的 elf 不受影响。",
|
|
193
244
|
install: [
|
|
194
|
-
"MSYS2:
|
|
245
|
+
"MSYS2:" + pacman + "mingw-w64-ucrt-x86_64-cmake(3.31.5)",
|
|
195
246
|
"或者 winget install --id Kitware.CMake;装了 ST 的 VS Code 扩展通常也会带一份 CMake",
|
|
196
247
|
"装完自检:cmake --version",
|
|
197
248
|
],
|
|
@@ -206,7 +257,7 @@ export function buildTargets(config) {
|
|
|
206
257
|
hint: "CMakePresets 指定 Ninja 生成器:msys64 里 pacman -S mingw-w64-ucrt-x86_64-ninja",
|
|
207
258
|
impact: "编译失败:CMakePresets 指定 Ninja 生成器,配置阶段就会报找不到 ninja。",
|
|
208
259
|
install: [
|
|
209
|
-
"MSYS2:
|
|
260
|
+
"MSYS2:" + pacman + "mingw-w64-ucrt-x86_64-ninja(1.12.1)",
|
|
210
261
|
"或者 winget install --id Ninja-build.Ninja",
|
|
211
262
|
"装完自检:ninja --version",
|
|
212
263
|
],
|
|
@@ -221,7 +272,7 @@ export function buildTargets(config) {
|
|
|
221
272
|
hint: "可选:只有建工程/重新生成代码需要;可用 STM32_CUBEMX_ROOT 指定安装根",
|
|
222
273
|
impact: "只影响建工程与重新生成代码:stm32_project_create 和改 .ioc 后的 stm32_generate 用不了;编译、烧录、调试、以及 stm32_ioc_inspect / stm32_ioc_plan 的只读分析都不受影响。",
|
|
223
274
|
install: [
|
|
224
|
-
"官网下载安装(winget 里没有):https://www.st.com/en/development-tools/stm32cubemx.html
|
|
275
|
+
"官网下载安装(winget 里没有):https://www.st.com/en/development-tools/stm32cubemx.html;装到默认目录 " + cubeMxDefaultRoot + " 会被自动发现",
|
|
225
276
|
"装在别处:设 STM32_CUBEMX_ROOT=<安装根>(根下要有 STM32CubeMX.exe 和 jre/bin/java.exe),或把路径传给 stm32_env_probe 的 cubeMxRoots",
|
|
226
277
|
"装完自检:<安装根>/jre/bin/java.exe -version 能打印版本",
|
|
227
278
|
],
|
|
@@ -0,0 +1,129 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* L2:工程交付(export)—— 把「能编译的工程」变成「别人拿到就能用」的一个 zip。
|
|
3
|
+
*
|
|
4
|
+
* 两条铁律(P1-4):
|
|
5
|
+
* 1. build/ 绝不进包:CMakeCache.txt / build.ninja / compile_commands.json 里全是
|
|
6
|
+
* 本机绝对路径,拷到别人机器上 cmake 退出码 0 但产物是旧的(实测),比不带还糟。
|
|
7
|
+
* 2. 两种意图分开:「拿到就能烧」带 prebuilt/(elf/hex/bin),「拿到就能改」绝不能带 build 缓存。
|
|
8
|
+
*/
|
|
9
|
+
import { existsSync, readdirSync, statSync } from "node:fs";
|
|
10
|
+
import { basename, join, resolve } from "node:path";
|
|
11
|
+
import { detectBuildDir, findElf } from "./build.js";
|
|
12
|
+
/** 进包的排除目录:构建缓存(绝对路径雷区)、插件备份、git、node_modules。 */
|
|
13
|
+
const SKIP_DIRS = new Set(["build", ".dsh-stm32", "node_modules", ".git"]);
|
|
14
|
+
function collectSources(projectDir) {
|
|
15
|
+
const sources = new Map();
|
|
16
|
+
const walk = (dir, relDir) => {
|
|
17
|
+
for (const entry of readdirSync(dir, { withFileTypes: true })) {
|
|
18
|
+
const rel = relDir === "" ? entry.name : relDir + "/" + entry.name;
|
|
19
|
+
if (entry.isDirectory()) {
|
|
20
|
+
if (SKIP_DIRS.has(entry.name))
|
|
21
|
+
continue;
|
|
22
|
+
walk(join(dir, entry.name), rel);
|
|
23
|
+
}
|
|
24
|
+
else {
|
|
25
|
+
sources.set(rel, join(dir, entry.name));
|
|
26
|
+
}
|
|
27
|
+
}
|
|
28
|
+
};
|
|
29
|
+
walk(projectDir, "");
|
|
30
|
+
return sources;
|
|
31
|
+
}
|
|
32
|
+
function readmeText(projectName, prebuilt, includePrebuilt) {
|
|
33
|
+
const lines = [
|
|
34
|
+
"# " + projectName,
|
|
35
|
+
"",
|
|
36
|
+
"由 dsh-stm32 插件导出(stm32_project_export)。",
|
|
37
|
+
"",
|
|
38
|
+
"## 拿到就能改",
|
|
39
|
+
"",
|
|
40
|
+
"用 CMake 正常配置编译即可(VS Code CMake Tools 或 cmake --preset Debug)。",
|
|
41
|
+
"",
|
|
42
|
+
"build/ 不在包里是有意的:CMakeCache.txt 记录的是原机器的绝对路径,",
|
|
43
|
+
"拷贝过去的 build 目录会让 cmake 静默用旧缓存编译出旧产物。",
|
|
44
|
+
"",
|
|
45
|
+
];
|
|
46
|
+
if (includePrebuilt && prebuilt.length > 0) {
|
|
47
|
+
lines.push("## 拿到就能烧(prebuilt/)");
|
|
48
|
+
lines.push("");
|
|
49
|
+
// 包里这些文件在 prebuilt/ 下,README 里的路径要对得上(别让人按裸文件名去找)。
|
|
50
|
+
for (const name of prebuilt)
|
|
51
|
+
lines.push("- prebuilt/" + name);
|
|
52
|
+
lines.push("");
|
|
53
|
+
lines.push("用 STM32CubeProgrammer / J-Flash / openocd 直接烧;改过源码后请重新编译再烧。");
|
|
54
|
+
}
|
|
55
|
+
else {
|
|
56
|
+
lines.push("## 烧录");
|
|
57
|
+
lines.push("");
|
|
58
|
+
lines.push("包里没带预编译产物:先编译得到 .elf 再烧。");
|
|
59
|
+
}
|
|
60
|
+
return lines.join("\n");
|
|
61
|
+
}
|
|
62
|
+
export async function runExport(request) {
|
|
63
|
+
const startedAt = Date.now();
|
|
64
|
+
const projectDir = resolve(request.projectDir);
|
|
65
|
+
const projectName = basename(projectDir);
|
|
66
|
+
const fail = (message) => ({
|
|
67
|
+
ok: false, projectDir, zipPath: "", zipBytes: 0, fileCount: 0, prebuilt: [],
|
|
68
|
+
durationMs: Date.now() - startedAt, message, notes: [],
|
|
69
|
+
});
|
|
70
|
+
const cancelled = () => request.signal !== undefined && request.signal.aborted;
|
|
71
|
+
if (!existsSync(projectDir))
|
|
72
|
+
return fail("工程目录不存在:" + projectDir);
|
|
73
|
+
if (cancelled())
|
|
74
|
+
return fail("已取消:没有生成 zip(连文件都没开始收集)。");
|
|
75
|
+
const includePrebuilt = request.includePrebuilt === true;
|
|
76
|
+
const prebuilt = [];
|
|
77
|
+
const buildDir = detectBuildDir(projectDir) ?? "";
|
|
78
|
+
if (includePrebuilt && buildDir !== "") {
|
|
79
|
+
const elf = findElf(buildDir);
|
|
80
|
+
if (elf !== null) {
|
|
81
|
+
prebuilt.push({ path: elf.path, size: elf.size });
|
|
82
|
+
for (const ext of ["hex", "bin"]) {
|
|
83
|
+
const candidate = elf.path.replace(/\.elf$/u, "") + "." + ext;
|
|
84
|
+
if (existsSync(candidate))
|
|
85
|
+
prebuilt.push({ path: candidate, size: statSync(candidate).size });
|
|
86
|
+
}
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
const sources = collectSources(projectDir);
|
|
90
|
+
for (const item of prebuilt)
|
|
91
|
+
sources.set("prebuilt/" + basename(item.path), item.path);
|
|
92
|
+
const notes = [];
|
|
93
|
+
notes.push("build/ 未进包:CMakeCache.txt 里是本机绝对路径,拷贝过去会静默复用旧缓存。");
|
|
94
|
+
if (includePrebuilt && prebuilt.length === 0)
|
|
95
|
+
notes.push("要求带 prebuilt 但构建目录里没有 .elf:先 stm32_build 再导出。");
|
|
96
|
+
if (request.readme !== false) {
|
|
97
|
+
const text = readmeText(projectName, prebuilt.map((item) => basename(item.path)), includePrebuilt);
|
|
98
|
+
sources.set("README.md", "__inline__\n" + text);
|
|
99
|
+
}
|
|
100
|
+
if (cancelled())
|
|
101
|
+
return fail("已取消:没有生成 zip(工程里 " + String(sources.size) + " 个文件已读完,但没写盘)。");
|
|
102
|
+
const outDir = request.outDir === undefined ? resolve(projectDir, "..") : resolve(request.outDir);
|
|
103
|
+
const zipPath = join(outDir, projectName + "-export.zip");
|
|
104
|
+
const zipImpl = request.zipImpl ??
|
|
105
|
+
(async (out, srcs) => {
|
|
106
|
+
const { makeZip } = await import("./zip.js");
|
|
107
|
+
await makeZip(out, srcs);
|
|
108
|
+
});
|
|
109
|
+
try {
|
|
110
|
+
await zipImpl(zipPath, sources);
|
|
111
|
+
}
|
|
112
|
+
catch (error) {
|
|
113
|
+
return fail("打包失败:" + (error instanceof Error ? error.message : String(error)));
|
|
114
|
+
}
|
|
115
|
+
let zipBytes = 0;
|
|
116
|
+
try {
|
|
117
|
+
zipBytes = statSync(zipPath).size;
|
|
118
|
+
}
|
|
119
|
+
catch {
|
|
120
|
+
// 注入的 zipImpl 可能没真写文件(测试替身);报告里的字节数只是给人看的,不该让它炸掉。
|
|
121
|
+
zipBytes = 0;
|
|
122
|
+
}
|
|
123
|
+
const message = "导出完成:" + zipPath + "(" + String(zipBytes) + " 字节、" + String(sources.size) + " 个文件" +
|
|
124
|
+
(includePrebuilt ? ",含 prebuilt/" + String(prebuilt.length) + " 个产物" : "") + ")。";
|
|
125
|
+
return {
|
|
126
|
+
ok: true, projectDir, zipPath, zipBytes, fileCount: sources.size, prebuilt,
|
|
127
|
+
durationMs: Date.now() - startedAt, message, notes,
|
|
128
|
+
};
|
|
129
|
+
}
|
|
@@ -0,0 +1,132 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 寄存器路线的时钟配置(F1 全系,按 line 决定上限)。
|
|
3
|
+
*
|
|
4
|
+
* 为什么寄存器路线要自己配时钟:HAL 路线由 CubeMX 生成的 SystemClock_Config() 负责,
|
|
5
|
+
* 而寄存器路线不用 CubeMX、也不用固件包,从模板拷过去的 main.c 里只有 HSI 8 MHz——
|
|
6
|
+
* 72 MHz 的板子在 8 MHz 上跑,串口/延时/定时全要按 8 MHz 算,而且用户会以为"F1 就该这么快"。
|
|
7
|
+
* 所以这里按芯片型号算出一段 clock_init(),生成 main.c 时写进去。
|
|
8
|
+
*
|
|
9
|
+
* 所有数字都查过 RM0008/RM0038/RM0041 和 14 个真实设备头(2026-10-30 实测,见
|
|
10
|
+
* data/cmsis-sources.ts 的哈希表):
|
|
11
|
+
* · 各 line 的 SYSCLK 上限:F100 24 MHz、F101 36 MHz、F102 48 MHz、F103/105/107 72 MHz
|
|
12
|
+
* · Flash 等待周期:≤24 MHz 用 0,≤48 MHz 用 1,72 MHz 用 2(RM0008 §3.3.3)
|
|
13
|
+
* · APB1 上限 36 MHz(F100 是 24 MHz,这里 F100 的 SYSCLK 只有 24 MHz 所以 /1 也够)
|
|
14
|
+
* · F100 的 FLASH_ACR 没有 LATENCY / PRFTBE 字段(只有 HLFCYA),所以 F100 完全不碰 FLASH
|
|
15
|
+
*
|
|
16
|
+
* PLL 一律走 HSE 8 MHz(蓝丸/大多数 F1 小板都是 8 MHz 晶振),算出来正好等于该 line 的上限;
|
|
17
|
+
* HSE 没起(没焊晶振)时退回 HSI/2 4 MHz × 倍频,F103/105/107 因为 4×18 > 16 只能到 64 MHz,
|
|
18
|
+
* 这时候会往 report 里塞一条 warning,让用户知道"没跑在 72"。
|
|
19
|
+
*
|
|
20
|
+
* 为什么不用 RCC_CFGR_PLLMULL9 之类的倍频宏:F100/F101 的可用倍频档位和设备头里定义的宏
|
|
21
|
+
* 并不齐全(实测 f100 没有 PLLMULL6,f105/f107 没有 PLLMULL16),而 PLLMUL 字段的编码
|
|
22
|
+
* 全家族一致(0=×2 … 14=×16,bit21:18)。所以这里统一按 (倍频 - 2) << 18 写,
|
|
23
|
+
* 只依赖全 14 个设备头都有的 RCC_CFGR_PLLMULL_Msk / _Pos。
|
|
24
|
+
*/
|
|
25
|
+
/** 实测过的 HSE 频率(蓝丸、绝大多数 F1 最小系统板)。 */
|
|
26
|
+
export const REGISTER_HSE_HZ = 8_000_000;
|
|
27
|
+
/** HSI 出厂频率(RM0008:8 MHz ±1%)。 */
|
|
28
|
+
export const REGISTER_HSI_HZ = 8_000_000;
|
|
29
|
+
/**
|
|
30
|
+
* 按 line 的时钟表。hseMul/hseDiv 是"8 MHz 晶振拿到该 line 上限"的唯一组合:
|
|
31
|
+
* 24 = 8×3 · 36 = 8/2×9 · 48 = 8×6 · 72 = 8×9
|
|
32
|
+
*/
|
|
33
|
+
const LINE_CLOCK = {
|
|
34
|
+
"100": { maxMHz: 24, hseMul: 3, hseDiv: 1, apb1Div: 1, hasFlashLatency: false },
|
|
35
|
+
"101": { maxMHz: 36, hseMul: 9, hseDiv: 2, apb1Div: 1, hasFlashLatency: true },
|
|
36
|
+
"102": { maxMHz: 48, hseMul: 6, hseDiv: 1, apb1Div: 2, hasFlashLatency: true },
|
|
37
|
+
"103": { maxMHz: 72, hseMul: 9, hseDiv: 1, apb1Div: 2, hasFlashLatency: true },
|
|
38
|
+
"105": { maxMHz: 72, hseMul: 9, hseDiv: 1, apb1Div: 2, hasFlashLatency: true },
|
|
39
|
+
"107": { maxMHz: 72, hseMul: 9, hseDiv: 1, apb1Div: 2, hasFlashLatency: true },
|
|
40
|
+
};
|
|
41
|
+
/** line 代号:STM32F103 → 103。 */
|
|
42
|
+
function lineOf(chip) {
|
|
43
|
+
return chip.prefix.slice(6);
|
|
44
|
+
}
|
|
45
|
+
/** 等待周期:RM0008 Table 3(0 WS ≤ 24 MHz,1 WS ≤ 48 MHz,2 WS ≤ 72 MHz)。 */
|
|
46
|
+
function latencyFor(hz) {
|
|
47
|
+
if (hz <= 24_000_000)
|
|
48
|
+
return 0;
|
|
49
|
+
if (hz <= 48_000_000)
|
|
50
|
+
return 1;
|
|
51
|
+
return 2;
|
|
52
|
+
}
|
|
53
|
+
/**
|
|
54
|
+
* 给一颗芯片算时钟方案。只读、纯函数;不认识 line 时按 F103 处理并记 warning
|
|
55
|
+
* (宁可给一个能跑的 72 MHz,也不抛异常让整个工程建不出来)。
|
|
56
|
+
*/
|
|
57
|
+
export function planRegisterClock(chip) {
|
|
58
|
+
const line = lineOf(chip);
|
|
59
|
+
const warnings = [];
|
|
60
|
+
let spec = LINE_CLOCK[line];
|
|
61
|
+
if (spec === undefined) {
|
|
62
|
+
warnings.push("时钟表里还没有 F" + line + ",先按 F103 的 72 MHz 方案生成;确认这颗芯片能跑到 72 MHz 后请把 line 补进 register-clock.ts 的 LINE_CLOCK。");
|
|
63
|
+
spec = LINE_CLOCK["103"];
|
|
64
|
+
}
|
|
65
|
+
const hseHz = REGISTER_HSE_HZ;
|
|
66
|
+
const pllInHz = hseHz / spec.hseDiv;
|
|
67
|
+
const sysclkHz = pllInHz * spec.hseMul;
|
|
68
|
+
const hsiMul = Math.min(16, Math.max(2, Math.round(spec.maxMHz / (REGISTER_HSI_HZ / 2 / 1_000_000))));
|
|
69
|
+
const hsiSysclkHz = (REGISTER_HSI_HZ / 2) * hsiMul;
|
|
70
|
+
const flashLatency = spec.hasFlashLatency ? latencyFor(Math.max(sysclkHz, hsiSysclkHz)) : 0;
|
|
71
|
+
const apb1Div = sysclkHz > 36_000_000 ? 2 : spec.apb1Div;
|
|
72
|
+
const apb2Div = 1;
|
|
73
|
+
const ahbHz = sysclkHz;
|
|
74
|
+
const apb1Hz = ahbHz / apb1Div;
|
|
75
|
+
const apb2Hz = ahbHz / apb2Div;
|
|
76
|
+
if (sysclkHz !== spec.maxMHz * 1_000_000) {
|
|
77
|
+
warnings.push("内部不一致:按 HSE " + hseHz + " Hz × " + spec.hseMul + " / " + spec.hseDiv + " 算出来是 " + sysclkHz + " Hz,但 F" + line + " 的上限是 " + spec.maxMHz + " MHz;请检查 register-clock.ts 的表。");
|
|
78
|
+
}
|
|
79
|
+
if (hsiSysclkHz < sysclkHz) {
|
|
80
|
+
warnings.push("HSE 没起(常见原因:板上没焊 8 MHz 晶振)时会退回 HSI/2 × " + hsiMul + " = " + Math.round(hsiSysclkHz / 1e6) + " MHz,比 " + Math.round(sysclkHz / 1e6) + " MHz 慢;生成的 clock_init() 已经带兜底,不用改代码。");
|
|
81
|
+
}
|
|
82
|
+
if (!spec.hasFlashLatency) {
|
|
83
|
+
warnings.push("F" + line + " 的 FLASH_ACR 只有 HLFCYA、没有 LATENCY/PRFTBE 字段,生成的 clock_init() 不写 FLASH->ACR(该 line 的 SYSCLK 上限本来就不需要等待周期)。");
|
|
84
|
+
}
|
|
85
|
+
const summary = Math.round(sysclkHz / 1e6) + " MHz(HSE " + Math.round(hseHz / 1e6) + " MHz"
|
|
86
|
+
+ (spec.hseDiv === 2 ? " / 2" : "") + " × " + spec.hseMul + ";AHB /" + 1 + "、APB1 /" + apb1Div
|
|
87
|
+
+ " = " + Math.round(apb1Hz / 1e6) + " MHz、APB2 /" + apb2Div + " = " + Math.round(apb2Hz / 1e6) + " MHz"
|
|
88
|
+
+ (spec.hasFlashLatency ? ";Flash " + flashLatency + " 等待周期" : "") + ")";
|
|
89
|
+
return {
|
|
90
|
+
mcu: chip.cpn,
|
|
91
|
+
line,
|
|
92
|
+
hseHz,
|
|
93
|
+
sysclkHz,
|
|
94
|
+
pllMul: spec.hseMul,
|
|
95
|
+
hseDiv: spec.hseDiv,
|
|
96
|
+
hsiMul,
|
|
97
|
+
hsiSysclkHz,
|
|
98
|
+
flashLatency,
|
|
99
|
+
hasFlashLatency: spec.hasFlashLatency,
|
|
100
|
+
apb1Div,
|
|
101
|
+
apb2Div,
|
|
102
|
+
ahbHz,
|
|
103
|
+
apb1Hz,
|
|
104
|
+
apb2Hz,
|
|
105
|
+
hsiApb1Hz: Math.round(hsiSysclkHz / apb1Div),
|
|
106
|
+
summary,
|
|
107
|
+
warnings,
|
|
108
|
+
};
|
|
109
|
+
}
|
|
110
|
+
/** 生成 main.c 里那一整块时钟代码(含注释、宏、clock_init)。 */
|
|
111
|
+
export function renderClockInit(plan) {
|
|
112
|
+
const lines = [];
|
|
113
|
+
const push = (...text) => {
|
|
114
|
+
for (const t of text)
|
|
115
|
+
lines.push(t);
|
|
116
|
+
};
|
|
117
|
+
push("/* ---------------------------------------------------------------------------", " * 时钟:" + plan.mcu + " @ " + plan.summary, " * HSE " + Math.round(plan.hseHz / 1e6) + " MHz" + (plan.hseDiv === 2 ? " / 2" : "") + " × " + plan.pllMul
|
|
118
|
+
+ " = " + Math.round(plan.sysclkHz / 1e6) + " MHz(PLL)", " * HSE 起不来时自动退回 HSI/2 × " + plan.hsiMul + " = " + Math.round(plan.hsiSysclkHz / 1e6) + " MHz,不会卡死", " * 这段是按型号算出来的,不依赖 CubeMX 生成物;换晶振改 DSH_HSE_HZ 一个数即可", " * -------------------------------------------------------------------------*/", "#define DSH_HSE_HZ " + plan.hseHz + "u", "#define DSH_PLL_MUL " + plan.pllMul + "u", "#define DSH_HSI_MUL " + plan.hsiMul + "u", "#define DSH_SYSCLK_HZ " + plan.sysclkHz + "u", "#define DSH_APB1_DIV " + plan.apb1Div + "u");
|
|
119
|
+
if (plan.hseDiv === 2)
|
|
120
|
+
push("#define DSH_HSE_DIV 2u");
|
|
121
|
+
if (plan.hasFlashLatency)
|
|
122
|
+
push("#define DSH_FLASH_LATENCY " + plan.flashLatency + "u");
|
|
123
|
+
push("", "/*", " * 把 SYSCLK 从复位默认的 HSI 8 MHz 切到 PLL。" + (plan.hasFlashLatency ? "顺序不能换:先加 Flash 等待周期,再切时钟。" : ""), " * HSE 就绪用有限次自旋等(不依赖中断,也不会因为没焊晶振死在这里)。", " */", "static void clock_init(void)", "{", " uint32_t cfgr;", " uint32_t spin;", " int use_hse;", "");
|
|
124
|
+
if (plan.hasFlashLatency) {
|
|
125
|
+
push(" /* 1) Flash 等待周期:" + Math.round(plan.sysclkHz / 1e6) + " MHz 用 " + plan.flashLatency + " 个(先设再提速) */", " FLASH->ACR = FLASH_ACR_PRFTBE | (DSH_FLASH_LATENCY << FLASH_ACR_LATENCY_Pos);", "");
|
|
126
|
+
}
|
|
127
|
+
push(" /* 2) 先把 SYSCLK 切回 HSI(重复调用也安全),再动 PLL */", " cfgr = RCC->CFGR;", " cfgr = (cfgr & ~RCC_CFGR_SW_Msk) | RCC_CFGR_SW_HSI;", " RCC->CFGR = cfgr;", " spin = 0u;", " while (((RCC->CFGR & RCC_CFGR_SWS_Msk) != RCC_CFGR_SWS_HSI) && (spin < 100000u)) { spin++; }", "", " /* 3) 开 HSE 并等就绪;等不到就用 HSI/2 当 PLL 源 */", " RCC->CR |= RCC_CR_HSEON;", " spin = 0u;", " while (((RCC->CR & RCC_CR_HSERDY) == 0u) && (spin < 100000u)) { spin++; }", " use_hse = ((RCC->CR & RCC_CR_HSERDY) != 0u) ? 1 : 0;", "", " /* 4) 关 PLL 才能改 PLL 参数(RM0008 要求 PLL 关闭时改 PLLSRC/PLLMUL) */", " RCC->CR &= ~RCC_CR_PLLON;", " spin = 0u;", " while (((RCC->CR & RCC_CR_PLLRDY) != 0u) && (spin < 100000u)) { spin++; }", "", " /* 5) 组 CFGR:AHB /1、APB2 /1、APB1" + (plan.apb1Div === 2 ? " /2" : " /1") + "(F1 的 APB1 上限 36 MHz) */", " cfgr = RCC->CFGR;", " cfgr &= ~(RCC_CFGR_HPRE_Msk | RCC_CFGR_PPRE1_Msk | RCC_CFGR_PPRE2_Msk | RCC_CFGR_PLLSRC | RCC_CFGR_PLLXTPRE | RCC_CFGR_PLLMULL_Msk);", " cfgr |= RCC_CFGR_HPRE_DIV1 | RCC_CFGR_PPRE2_DIV1;", " cfgr |= (DSH_APB1_DIV == 2u) ? RCC_CFGR_PPRE1_DIV2 : RCC_CFGR_PPRE1_DIV1;", " if (use_hse != 0) {", " cfgr |= RCC_CFGR_PLLSRC; /* PLL 源 = HSE" + (plan.hseDiv === 2 ? "(先 /2 再进 PLL)" : "") + " */");
|
|
128
|
+
if (plan.hseDiv === 2)
|
|
129
|
+
push(" cfgr |= RCC_CFGR_PLLXTPRE;");
|
|
130
|
+
push(" cfgr |= ((uint32_t)(DSH_PLL_MUL - 2u) << RCC_CFGR_PLLMULL_Pos);", " } else {", " cfgr |= ((uint32_t)(DSH_HSI_MUL - 2u) << RCC_CFGR_PLLMULL_Pos); /* 0 = HSI/2 进 PLL */", " }", " RCC->CFGR = cfgr;", "", " /* 6) 开 PLL 等锁定,然后把 SYSCLK 切到 PLL 并等 SWS 确认 */", " RCC->CR |= RCC_CR_PLLON;", " spin = 0u;", " while (((RCC->CR & RCC_CR_PLLRDY) == 0u) && (spin < 100000u)) { spin++; }", " cfgr = RCC->CFGR;", " cfgr = (cfgr & ~RCC_CFGR_SW_Msk) | RCC_CFGR_SW_PLL;", " RCC->CFGR = cfgr;", " spin = 0u;", " while (((RCC->CFGR & RCC_CFGR_SWS_Msk) != RCC_CFGR_SWS_PLL) && (spin < 100000u)) { spin++; }", "", " /* 7) 让 SystemCoreClock 跟着变,delay_ms / SysTick 才是对的数 */", " SystemCoreClockUpdate();", "}", "");
|
|
131
|
+
return lines.join("\n");
|
|
132
|
+
}
|
|
@@ -0,0 +1,129 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 寄存器路线的链接脚本(按芯片型号渲染一份 <DeviceId>_FLASH.ld)。
|
|
3
|
+
*
|
|
4
|
+
* 为什么必须按型号渲染:templates/scaffold/STM32F103XX_FLASH.ld 是给 F103C8T6 写的——
|
|
5
|
+
* MEMORY 里写死 LENGTH = 64K FLASH / 20K RAM。拿它去链 F103RBT6(128K/20K)还能跑,
|
|
6
|
+
* 但链 F103ZET6(512K/64K)就只用到前 64K,超出部分链接器直接报 overflow;
|
|
7
|
+
* 反过来链 F100C6(16K/4K)更糟:链接器以为有 64K Flash,把 .data/.bss 摆到不存在的
|
|
8
|
+
* 内存上,烧进去就是 HardFault。所以寄存器路线不从模板拷死脚本,而是改 MEMORY 两行。
|
|
9
|
+
*
|
|
10
|
+
* 时间/复杂度上这也是最省的做法:链接脚本是 ASCII 文本,改两行比引一个链接脚本生成器简单。
|
|
11
|
+
*/
|
|
12
|
+
/**
|
|
13
|
+
* F100/F101/F102 的 RAM 兜底表(KB),取值来自 STM32CubeMX 的 db/mcu/*.xml:
|
|
14
|
+
* 同一 line+档位在 db 里是一个合并条目,<Ram> 取的是该组内最小封装的值。
|
|
15
|
+
* 为什么用最小值:链接脚本把 RAM 写小只会"少用",写大才会把栈顶伸到不存在的空间;
|
|
16
|
+
* 所以兜底宁可小,同时往 report 里写一条 warning 让用户去确认。
|
|
17
|
+
* (F103/F105/F107 用 stm32f1.ts 里已核对的 RAM_BY_LINE_LETTER,不走这张表。)
|
|
18
|
+
*/
|
|
19
|
+
const RAM_FALLBACK_KB = {
|
|
20
|
+
"100x6": 4,
|
|
21
|
+
"100xb": 8,
|
|
22
|
+
"100xe": 24,
|
|
23
|
+
"101x6": 4,
|
|
24
|
+
"101xb": 10,
|
|
25
|
+
"101xe": 32,
|
|
26
|
+
"101xg": 80,
|
|
27
|
+
"102x6": 4,
|
|
28
|
+
"102xb": 10,
|
|
29
|
+
"103x6": 6,
|
|
30
|
+
"103xb": 20,
|
|
31
|
+
"103xe": 48,
|
|
32
|
+
"103xg": 96,
|
|
33
|
+
"105xc": 64,
|
|
34
|
+
"107xc": 64,
|
|
35
|
+
};
|
|
36
|
+
/** line 代号:STM32F103 → 103。 */
|
|
37
|
+
function lineOf(chip) {
|
|
38
|
+
return chip.prefix.slice(6);
|
|
39
|
+
}
|
|
40
|
+
/**
|
|
41
|
+
* ST 的器件代号:完整型号去掉温度/封装尾号换成 x(STM32F103C8T6 → STM32F103C8Tx),
|
|
42
|
+
* 只给容量档的写法(F103)用 STM32F103xB 这种"档位代号"。
|
|
43
|
+
* 为什么要凑出这个名字:CubeMX 生成工程里链接脚本就叫 <DeviceId>_FLASH.ld,
|
|
44
|
+
* 沿用同一约定,用户从 HAL 工程切过来时一眼认得出这是哪颗芯片的脚本。
|
|
45
|
+
*/
|
|
46
|
+
export function deviceIdFor(chip) {
|
|
47
|
+
const cpn = chip.cpn.toUpperCase();
|
|
48
|
+
if (/^STM32F\d{3}[A-Z][0-9A-G]/u.test(cpn) && cpn.length >= 11) {
|
|
49
|
+
if (/[67]$/u.test(cpn) && cpn.length >= 12)
|
|
50
|
+
return cpn.slice(0, -1) + "x";
|
|
51
|
+
if (/^STM32F\d{3}[A-Z][0-9A-G]$/u.test(cpn))
|
|
52
|
+
return cpn + "Tx";
|
|
53
|
+
return cpn.slice(0, -1) + "x";
|
|
54
|
+
}
|
|
55
|
+
return chip.prefix + "x" + chip.group.slice(1).toUpperCase();
|
|
56
|
+
}
|
|
57
|
+
function kbOf(bytes) {
|
|
58
|
+
return Math.round(bytes / 1024);
|
|
59
|
+
}
|
|
60
|
+
/** 给一颗芯片算链接脚本参数(只读、纯函数)。 */
|
|
61
|
+
export function planRegisterLinker(chip) {
|
|
62
|
+
const warnings = [];
|
|
63
|
+
const line = lineOf(chip);
|
|
64
|
+
const key = chip.prefix.slice(6) + chip.group;
|
|
65
|
+
const deviceId = deviceIdFor(chip);
|
|
66
|
+
const flashBytes = chip.flashBytes ?? 0;
|
|
67
|
+
if (flashBytes <= 0) {
|
|
68
|
+
warnings.push("这颗芯片的 Flash 大小没收录(stm32f1.ts 的 FLASH_BY_LETTER 里查不到档位 " + chip.group + "),链接脚本按 64K 生成;确认后请补表。");
|
|
69
|
+
}
|
|
70
|
+
const exactRam = chip.ramBytes ?? null;
|
|
71
|
+
const fallbackKb = RAM_FALLBACK_KB[key];
|
|
72
|
+
const ramBytes = exactRam !== null ? exactRam : (fallbackKb ?? 20) * 1024;
|
|
73
|
+
if (exactRam === null && fallbackKb === undefined) {
|
|
74
|
+
warnings.push("F" + line + " 的档位 " + chip.group + " 的 RAM 大小没收录,链接脚本按 20K 兜底;确认后请补 stm32f1.ts 的 RAM_BY_LINE_LETTER 或 register-linker.ts 的 RAM_FALLBACK_KB。");
|
|
75
|
+
}
|
|
76
|
+
else if (exactRam === null) {
|
|
77
|
+
warnings.push("F" + line + " 的档位 " + chip.group + " 的 RAM 没收录在 stm32f1.ts 里,链接脚本按 CubeMX db 的最小值 " + kbOf(ramBytes) + "K 生成(宁可小,栈不会越界);封装更大时可以把 LENGTH 改大。");
|
|
78
|
+
}
|
|
79
|
+
if (ramBytes > 0 && ramBytes <= 8 * 1024) {
|
|
80
|
+
warnings.push("这颗芯片只有 " + kbOf(ramBytes) + "K RAM,链接脚本仍保留默认的 1K 栈 + 512B 堆(_Min_Stack_Size/_Min_Heap_Size),紧张时请调小。");
|
|
81
|
+
}
|
|
82
|
+
const flashKb = flashBytes > 0 ? kbOf(flashBytes) : 64;
|
|
83
|
+
const ramKb = kbOf(ramBytes);
|
|
84
|
+
return {
|
|
85
|
+
mcu: chip.cpn,
|
|
86
|
+
deviceId,
|
|
87
|
+
fileName: deviceId + "_FLASH.ld",
|
|
88
|
+
flashBytes: flashKb * 1024,
|
|
89
|
+
ramBytes: ramBytes,
|
|
90
|
+
ramExact: exactRam !== null,
|
|
91
|
+
summary: flashKb + "K FLASH + " + ramKb + "K RAM",
|
|
92
|
+
warnings,
|
|
93
|
+
};
|
|
94
|
+
}
|
|
95
|
+
/**
|
|
96
|
+
* 把模板链接脚本里写死 C8T6 的四处改掉:
|
|
97
|
+
* 注释 :9 "Linker script for STM32F103C8Tx series"
|
|
98
|
+
* 注释 :10 "64Kbytes FLASH and 20Kbytes RAM"
|
|
99
|
+
* MEMORY :58 RAM LENGTH = 20K
|
|
100
|
+
* MEMORY :59 FLASH LENGTH = 64K
|
|
101
|
+
* 任何一处找不到(模板被人改过)就返回 null,让调用方明确报错,而不是生成一个尺寸错的脚本。
|
|
102
|
+
*/
|
|
103
|
+
export function renderLinkerScript(plan, template) {
|
|
104
|
+
const flashKb = kbOf(plan.flashBytes);
|
|
105
|
+
const ramKb = kbOf(plan.ramBytes);
|
|
106
|
+
let text = template;
|
|
107
|
+
let patched = 0;
|
|
108
|
+
const commentTitle = /^(\*\*\s+Abstract\s+:\s+Linker script for ).*$/mu;
|
|
109
|
+
if (commentTitle.test(text)) {
|
|
110
|
+
text = text.replace(commentTitle, "$1" + plan.deviceId + " series");
|
|
111
|
+
patched++;
|
|
112
|
+
}
|
|
113
|
+
const commentSizes = /^(\*\*\s+)([0-9]+Kbytes FLASH and [0-9]+Kbytes RAM)\s*$/mu;
|
|
114
|
+
if (commentSizes.test(text)) {
|
|
115
|
+
text = text.replace(commentSizes, "$1" + flashKb + "Kbytes FLASH and " + ramKb + "Kbytes RAM");
|
|
116
|
+
patched++;
|
|
117
|
+
}
|
|
118
|
+
const ramLine = /^([ \t]*RAM \(xrw\)[ \t]*:[ \t]*ORIGIN = 0x20000000, LENGTH = )[0-9]+[KM][ \t]*$/mu;
|
|
119
|
+
if (ramLine.test(text)) {
|
|
120
|
+
text = text.replace(ramLine, "$1" + ramKb + "K");
|
|
121
|
+
patched++;
|
|
122
|
+
}
|
|
123
|
+
const flashLine = /^([ \t]*FLASH \(rx\)[ \t]*:[ \t]*ORIGIN = 0x8000000, LENGTH = )[0-9]+[KM][ \t]*$/mu;
|
|
124
|
+
if (flashLine.test(text)) {
|
|
125
|
+
text = text.replace(flashLine, "$1" + flashKb + "K");
|
|
126
|
+
patched++;
|
|
127
|
+
}
|
|
128
|
+
return patched === 4 ? text : null;
|
|
129
|
+
}
|