移除 OpenCode 配置与命令，技能与串口单一配置源迁移至 .dsh/skills 与 .serialtest，同步更新全部文档引用
This commit is contained in:
@@ -0,0 +1,72 @@
|
||||
---
|
||||
name: draw-diagram
|
||||
description: docs/ 文档技术配图绘制流程（精确布局图用 SVG 生成器 / 拓扑图用 Mermaid）：挑脚本 → 改顶部数据 → 重跑生成 → 目检 → md 相对路径引用 → 脚本+产物一并提交，产物统一放 docs/images/。
|
||||
whenToUse: 需要新增/修改 docs/ 文档的技术配图（协议帧、分层架构、依赖/就绪屏障、流程图、时序、状态机），或用户要求"画个图 / 生成图 / 更新架构图 / 帧格式图"时。
|
||||
---
|
||||
|
||||
# 文档配图绘制（SVG / Mermaid）
|
||||
|
||||
`docs/` 文档技术配图的统一流程；完整选型依据 / 约定 / 检查清单见 `docs/架构设计/图形绘制流程.md`。**产物统一放 `docs/images/`**（专门配图目录，`.svg` 入库；PNG 预览属本地派生物、不入库）。
|
||||
|
||||
## 工具选型
|
||||
|
||||
| 图形类型 | 工具 |
|
||||
|---|---|
|
||||
| 协议帧 / 字节布局（字段宽 ∝ 字节数、偏移标尺） | SVG：`tools/arch_diagram/gen_frame_svg.py` |
|
||||
| 分层架构 / 模块依赖 | SVG：`tools/arch_diagram/gen_arch_svg.py` |
|
||||
| 就绪屏障 / 生产者-消费者 | SVG：`tools/arch_diagram/gen_barrier_svg.py` |
|
||||
| 其他精确布局图 | **复制**最接近的生成器改顶部数据（`build()` 与数据解耦，通用） |
|
||||
| 流程 / 时序 / 状态机 / ER（只表达拓扑关系） | Markdown 内嵌 ` ```mermaid ` 代码块（`flowchart` / `sequenceDiagram` / `stateDiagram-v2` / `erDiagram`），无需生成图片 |
|
||||
|
||||
> Mermaid 盒子按文本自适应宽、自动加有向边，**只适合"关系"类图**；凡需精确像素 / 比例的布局图一律走 SVG 生成器。
|
||||
|
||||
## SVG 生成流程（仓库根目录执行）
|
||||
|
||||
1. **挑 / 复制脚本**：新类型图复制最接近的生成器，只改顶部数据区。
|
||||
2. **改顶部数据**：字段 / 节点 / 标题 / 配色。沿用既有调色板（主色 / 底色）：
|
||||
|
||||
| 语义 | 主色 | 底色 |
|
||||
|---|---|---|
|
||||
| 蓝 | `#2563eb` | `#eff6ff` |
|
||||
| 青 | `#0d9488` | `#f0fdfa` |
|
||||
| 绿 | `#16a34a` | `#f0fdf4` |
|
||||
| 琥珀 | `#d97706` | `#fffbeb` |
|
||||
| 紫 | `#7c3aed` | `#f5f3ff` |
|
||||
| 灰 | `#475569` | `#f1f5f9` |
|
||||
| 玫红 | `#e11d48` | `#fff1f2` |
|
||||
|
||||
3. **重跑**（脚本内置 `ElementTree` 自检，XML 不合法直接抛错）：
|
||||
|
||||
```powershell
|
||||
& '.venv\Scripts\python.exe' tools/arch_diagram/gen_xxx.py
|
||||
# 成功输出：OK <字节> bytes, canvas <W>x<H> -> <路径>
|
||||
```
|
||||
|
||||
4. **目检**：浏览器打开 `docs/images/*.svg`——文字不溢出盒外、框 / 线 / 标签对齐、配色符合调色板。
|
||||
5. **md 引用**（相对路径）：`docs/` 根的 md 写 ``；`docs/UI设计/` 等子目录 md 写 ``。
|
||||
6. **提交**：生成器脚本（源）+ 生成的 `.svg`（产物）**一并**提交。
|
||||
|
||||
## SVG 约定（手写 / 新增生成器必须遵循）
|
||||
|
||||
- **纯标准库**拼 SVG（只用 `html` / `os`（+ `math`）），不引第三方库（SVG 由浏览器用系统字体渲染）
|
||||
- 所有文本经 `html.escape(s, quote=True)`，防止破坏 XML
|
||||
- 字体栈：`Microsoft YaHei, Segoe UI, PingFang SC, sans-serif`
|
||||
- 文本宽估算（自适应盒宽）：CJK / 全角 / 圈码 / 箭头 ≈ `1.0em`，其余 ≈ `0.58em`（**宁大勿小**防溢出）
|
||||
- 落盘：`open(OUT, "w", encoding="utf-8", newline="\n")`（UTF-8 无 BOM + LF）
|
||||
- 写盘后 `xml.etree.ElementTree.fromstring(svg)` 自检
|
||||
- 产物放 `docs/images/`，命名 `<主题>.svg`（可与同名 `.md` 对应）
|
||||
|
||||
## SVG → PNG（可选，本地派生物不入库）
|
||||
|
||||
- 最简单：浏览器打开 `.svg` → 另存为图片
|
||||
- 脚本化：`& '.venv\Scripts\python.exe' -m pip install cairosvg` 后
|
||||
`& '.venv\Scripts\python.exe' -c "import cairosvg; cairosvg.svg2png(url='docs/images/xxx.svg', write_to='x.png', scale=2)"`
|
||||
- `.gitignore` 已含 `docs/images/*.png`
|
||||
|
||||
## 提交前检查清单
|
||||
|
||||
- [ ] 生成器输出 `OK … bytes`（无异常 = XML 合法）
|
||||
- [ ] 浏览器目检：文字不溢出、框 / 线 / 标签对齐、配色符合调色板
|
||||
- [ ] 引用它的 `.md` 里图片**相对路径**正确（能显示）
|
||||
- [ ] 脚本 + 产物 `.svg` **一并**暂存
|
||||
- [ ] `pre-commit run --files <脚本> <svg> <md>` 全过（无乱码 / 行尾空白 / 编码 OK）
|
||||
@@ -0,0 +1,33 @@
|
||||
---
|
||||
name: font-regen
|
||||
description: 重生成中文子集字体 ui_font_cn_12（extract_cn 提取 → make_font 生成 → diff 检查，固定 4 步，.venv 解释器）。
|
||||
whenToUse: UI 代码新增中文文案、用户报告屏幕缺字/空白块、或提交任何含新汉字的 UI 字符串之前。
|
||||
---
|
||||
|
||||
# 中文字体重生成
|
||||
|
||||
本工程**唯一字体** `ui_font_cn_12`（宋体 12px 1bpp 子集，MCU/模拟器双端共用）。**缺字渲染为空白**——新增汉字必须走以下固定顺序，不得跳过或调换。详细原理见 `docs/UI设计/UI_中文字体生成与配置.md`。
|
||||
|
||||
## 固定顺序（仓库根目录执行）
|
||||
|
||||
```powershell
|
||||
# 1. 代码落库（新界面字符串已写入 ui_menu.c / ui_content_page.c 等 UI 源码）
|
||||
# 2. 提取字符集（纯标准库，任意 python3 均可）
|
||||
python tools/font_gen/extract_cn.py # 扫描 UI 源码字符串 → 仓库根 ui_cn_chars.txt
|
||||
# 3. 生成字体（需 fontTools，一律用 .venv；宋体 .ttc 的 face0 抽取与 ▶ 箭头补回均自动完成，幂等）
|
||||
.venv\Scripts\python.exe tools/font_gen/make_font.py
|
||||
# 变体：--bpp 2（宋体细笔画发虚时）/ --font C:/path/to/font.ttf（换字体）
|
||||
# 4. diff 检查：新增字在位、旧字不变、生成物 Opts 行字符集与预期一致
|
||||
```
|
||||
|
||||
## 提交清单
|
||||
|
||||
`ui_cn_chars.txt`（仓库根）+ `Drivers/BSP/UI/ui_font_cn_12.c` **随代码一起提交**，缺一个都会让另一端/下次构建字体与字集不一致。
|
||||
|
||||
## 坑
|
||||
|
||||
- 不要用 PATH 默认 `python`（msys64，无 fonttools）跑 make_font.py；`.venv` 缺失时按 AGENTS.md「Python 环境」重建
|
||||
- `requirements.txt` 必须**纯 ASCII**（Windows 下 pip 按 GBK 解码，中文注释 → UnicodeDecodeError）
|
||||
- 生僻字（宋体可能无字形）→ **写码前先手动验证字形**，避免"代码写完才发现是空白"
|
||||
- 生成成功后跑 `ui-verify` skill 全回归；黄金参考因字形变化而 FAIL 属预期 → `check_content_pages.py --update` 刷新
|
||||
- 字数变化时同步更新文档中的字符集计数（当前 97 汉字 + ASCII 0x20-0x7E，共 193 字形）：`UI_中文字体生成与配置.md`、`UI_界面制作流程.md` C3、`UI_设计架构.md`、`simulator/README.md` 已知坑 #4
|
||||
@@ -0,0 +1 @@
|
||||
__pycache__/
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
name: keil-build
|
||||
description: Keil MDK-ARM 命令行编译闭环（自带独立脚本 keil_build.py，纯标准库，拷到任何 Keil 项目即用）：UV4 -b 构建 → "0 错误 0 警告"判定 → build_log 定位报错。封装入口约定、退出码判读、UV4 改写工程文件的入库陷阱。
|
||||
whenToUse: 需要编译 Keil MDK 工程、验证代码改动是否 0 错误 0 警告、或解读 UV4 构建日志时。
|
||||
---
|
||||
|
||||
# keil-build — Keil 命令行编译（独立可运行 skill）
|
||||
|
||||
**执行体 = 本 skill 自带脚本** `.dsh/skills/keil-build/scripts/keil_build.py`
|
||||
（纯标准库，任意 python3；拷整个 skill 目录到别的 Keil 项目即可用，不依赖仓库脚本）。
|
||||
|
||||
```powershell
|
||||
# cwd = 项目根目录
|
||||
& $PY ".dsh\skills\keil-build\scripts\keil_build.py"
|
||||
# 覆盖：--project X.uvprojx --uv4 UV4.exe --target 名字 --log 路径 --timeout 600
|
||||
```
|
||||
|
||||
解析顺序（命令行 > 项目档案 `.serialtest/config.json` > 环境 > 探测）：
|
||||
工程 `uvprojx`（档案缺省时自动搜 cwd 下唯一 `*.uvprojx`）；UV4 `uv4` >
|
||||
`$DSH_KEIL_UV4` > `$DTU_KEIL_UV4` > PATH（**显式设了但路径无效 = 立即报错，不静默回退**）。
|
||||
退出码：`0`=PASS(0错0警) / `1`=构建失败（打印报错行）/ `2`=UV4 未找到/无效 / `3`=用法。
|
||||
|
||||
## 本仓库
|
||||
|
||||
仓库原生入口 `& "MDK-ARM\build.bat"`（`@build` 约定）与本 skill 脚本判定口径一致
|
||||
（先删旧日志 → `-b -j0 -o` → 无 `error:` 且含 `0 Error(s), 0 Warning(s)`），
|
||||
两者任选；`@build` 文档口径不变。环境变量 `DTU_KEIL_UV4`（用户级，指向 UV4.exe）。
|
||||
|
||||
## 铁律与陷阱（实测教训）
|
||||
|
||||
- **任何代码改动后必须先编译验证（0 错误 0 警告）再谈烧录/提交**——编译不过就进
|
||||
硬件闭环只会把编译错误伪装成运行问题。
|
||||
- **警告也算失败**：判 PASS 只认退出码 0，别只看"有没有 error:"。
|
||||
- **`MDK-ARM/*.uvprojx` 每次构建后被 UV4 自动改写，改动一律不入库**：UV4 会把工程
|
||||
XML 归一化成本机风格（`<Tag />` → `<Tag></Tag>` 等）并把 `PackID` 降到本机 DFP 版本。
|
||||
判断：`git diff` 里只见 XML 格式/`PackID` 差异而**无源文件挂载增删** →
|
||||
`git checkout -- <uvprojx>` 丢弃；只有真的增删了源文件（grep 文件名计数变化）才提交。
|
||||
- 报错定位读日志别只看终端回显：本仓库 = `MDK-ARM\build_log.txt`。
|
||||
- **exit 2 先分清"真没设"还是"会话没继承"**（2026-10-10 实测）：agent 的 shell 由
|
||||
常驻服务派生，服务启动**之后**设置的用户级环境变量不会自动进来。查
|
||||
`[Environment]::GetEnvironmentVariable('DTU_KEIL_UV4','User')`，有值就
|
||||
`$env:DTU_KEIL_UV4 = <该值>` 注入本会话再跑，别急着让用户去设。
|
||||
- 编码类报错（`#870-D: invalid multibyte character sequence` 等）先怀疑源文件
|
||||
BOM/编码被改写，而不是代码本身（见仓库 AGENTS.md 编码铁律）。
|
||||
|
||||
## 与其它 skill 的衔接
|
||||
|
||||
- 烧录/回读 = `stlink-flash` skill；串口闭环 = `serial-boot-test` skill
|
||||
（其档案 `flash_cmd`/`readback_cmd` 即 stlink-flash 的入口命令）。
|
||||
@@ -0,0 +1,188 @@
|
||||
#!/usr/bin/env python3
|
||||
# -*- coding: utf-8 -*-
|
||||
"""keil_build.py - Keil MDK-ARM 命令行构建 + 判定（纯标准库，可移植 skill 版）。
|
||||
|
||||
用法（**项目根目录**下运行，任意 python3）:
|
||||
python <skill>/scripts/keil_build.py
|
||||
[--project X.uvprojx] [--uv4 UV4.exe] [--target 名字]
|
||||
[--log build_log.txt] [--timeout 600]
|
||||
|
||||
解析顺序（命令行 > 项目档案 > 环境 > 探测）:
|
||||
工程 --project > 档案 "uvprojx" > 自动搜 cwd 下唯一 *.uvprojx
|
||||
UV4 --uv4 > 档案 "uv4" > $DSH_KEIL_UV4 > $DTU_KEIL_UV4 > PATH
|
||||
（环境变量**显式设了但路径无效 = 立即报错，不静默回退**）
|
||||
日志 --log > 档案 "build_log" > <工程目录>\\build_log.txt
|
||||
|
||||
判定口径（与仓库 build.bat 一致，实测教训沉淀）:
|
||||
1. 先删旧日志——UV4 -o 只在真跑了构建才写日志，残留旧日志会被当成本次结果
|
||||
2. UV4 单实例：IDE 开着时 -b 可能被转发给 IDE（退出码丢失）→ 只 WARN 不杀进程
|
||||
3. PASS = 日志存在 + 无 "error:"（大小写不敏感）+ 含 "0 Error(s), 0 Warning(s)"
|
||||
（0E0W 精确匹配同时把"只有警告"的构建判 FAIL）
|
||||
|
||||
退出码: 0=PASS(0错0警) 1=构建失败(看打印的报错行/日志) 2=UV4 未找到/无效 3=用法错误
|
||||
"""
|
||||
|
||||
import argparse
|
||||
import json
|
||||
import os
|
||||
import shutil
|
||||
import subprocess
|
||||
import sys
|
||||
from pathlib import Path
|
||||
|
||||
|
||||
def find_config_file():
|
||||
env = os.environ.get("DSH_SERIAL_CONFIG")
|
||||
if env:
|
||||
return Path(env)
|
||||
cwd = Path.cwd()
|
||||
candidates = [cwd / ".serialtest" / "config.json",
|
||||
cwd / ".opencode" / "serial_config.json"]
|
||||
for c in candidates:
|
||||
if c.is_file():
|
||||
return c
|
||||
return candidates[0]
|
||||
|
||||
|
||||
def load_config():
|
||||
"""档案缺失不是错误；解析失败报错由调用方 exit 3。返回 (cfg, err)。"""
|
||||
f = find_config_file()
|
||||
if not f.is_file():
|
||||
return {}, ""
|
||||
try:
|
||||
raw = json.loads(f.read_text(encoding="utf-8-sig"))
|
||||
except (OSError, ValueError) as e:
|
||||
return {}, "cannot parse {}: {}".format(f, e)
|
||||
if not isinstance(raw, dict):
|
||||
return {}, "config root is not an object: {}".format(f)
|
||||
return raw, ""
|
||||
|
||||
|
||||
def find_uv4(cli_arg, cfg):
|
||||
"""UV4 解析。显式来源（--uv4/档案/环境变量）设了但无效 = 硬错误，不回退。"""
|
||||
for label, val in (("--uv4", cli_arg),
|
||||
("config 'uv4'", cfg.get("uv4")),
|
||||
("$DSH_KEIL_UV4", os.environ.get("DSH_KEIL_UV4")),
|
||||
("$DTU_KEIL_UV4", os.environ.get("DTU_KEIL_UV4"))):
|
||||
if val:
|
||||
if Path(val).is_file():
|
||||
return Path(val), label
|
||||
raise SystemExit(("BUILD_ENV_ERROR: {} is set but not a file: {} "
|
||||
"(fix the value; no silent fallback)").format(label, val))
|
||||
w = shutil.which("UV4.exe") or shutil.which("UV4")
|
||||
if w:
|
||||
return Path(w), "PATH"
|
||||
raise SystemExit("BUILD_ENV_ERROR: UV4.exe not found "
|
||||
"(--uv4 / config 'uv4' / $DSH_KEIL_UV4 / $DTU_KEIL_UV4 / PATH)")
|
||||
|
||||
|
||||
def find_project(cli_arg, cfg):
|
||||
if cli_arg:
|
||||
p = Path(cli_arg)
|
||||
if not p.is_file():
|
||||
raise SystemExit("BUILD_ENV_ERROR: --project not found: {}".format(p))
|
||||
return p
|
||||
v = cfg.get("uvprojx")
|
||||
if v:
|
||||
p = Path(v)
|
||||
if not p.is_file():
|
||||
raise SystemExit("BUILD_ENV_ERROR: config 'uvprojx' not found: {}".format(p))
|
||||
return p
|
||||
hits = sorted(p for p in Path.cwd().rglob("*.uvprojx")
|
||||
if not any(part.startswith(".") for part in p.parts))
|
||||
if len(hits) == 1:
|
||||
print("PROJ: auto-detected {}".format(hits[0]))
|
||||
return hits[0]
|
||||
if not hits:
|
||||
raise SystemExit("BUILD_ENV_ERROR: no *.uvprojx under cwd "
|
||||
"(--project or config 'uvprojx')")
|
||||
raise SystemExit("BUILD_ENV_ERROR: multiple .uvprojx found, pick one "
|
||||
"(--project or config 'uvprojx'):\n " +
|
||||
"\n ".join(str(h) for h in hits))
|
||||
|
||||
|
||||
def main(argv=None):
|
||||
for stream in (sys.stdout, sys.stderr):
|
||||
try:
|
||||
stream.reconfigure(encoding="utf-8", errors="replace")
|
||||
except Exception:
|
||||
pass
|
||||
|
||||
ap = argparse.ArgumentParser(description="Keil UV4 CLI build + verdict (pure stdlib)")
|
||||
ap.add_argument("--project", default=None, help="*.uvprojx (default: config/auto-detect)")
|
||||
ap.add_argument("--uv4", default=None, help="UV4.exe path")
|
||||
ap.add_argument("--target", default=None, help="build target name (-t; default: project default)")
|
||||
ap.add_argument("--log", default=None, help="build log path (default: <proj dir>/build_log.txt)")
|
||||
ap.add_argument("--timeout", type=int, default=600, help="UV4 timeout seconds")
|
||||
args = ap.parse_args(argv)
|
||||
|
||||
cfg, err = load_config()
|
||||
if err:
|
||||
print("BUILD_ENV_ERROR: {}".format(err))
|
||||
return 3
|
||||
|
||||
proj = find_project(args.project, cfg)
|
||||
uv4, src = find_uv4(args.uv4, cfg)
|
||||
target = args.target or cfg.get("uv_target") or ""
|
||||
log = Path(args.log or cfg.get("build_log") or (proj.parent / "build_log.txt"))
|
||||
|
||||
print("UV4: {} ({})".format(uv4, src))
|
||||
print("PROJ: {} target={}".format(proj, target or "(default)"))
|
||||
print("LOG: {}".format(log))
|
||||
|
||||
# UV4 单实例陷阱：IDE 开着时 -b 可能被转发（退出码丢失、GUI 弹出）——只 WARN
|
||||
try:
|
||||
tl = subprocess.run(["tasklist", "/fi", "imagename eq UV4.exe", "/nh"],
|
||||
capture_output=True, timeout=10)
|
||||
if b"UV4.exe" in (tl.stdout or b""):
|
||||
print("WARN: UV4 IDE is running - this build may be forwarded to it. "
|
||||
"Close the IDE for a deterministic CLI build.")
|
||||
except (OSError, subprocess.TimeoutExpired):
|
||||
pass
|
||||
|
||||
# 先删旧日志：UV4 -o 只在真跑构建时写日志，残留会被当成本次结果
|
||||
try:
|
||||
log.unlink()
|
||||
except FileNotFoundError:
|
||||
pass
|
||||
|
||||
cmd = [str(uv4), "-b", str(proj), "-j0", "-o", str(log)]
|
||||
if target:
|
||||
cmd.insert(3, "-t" + target)
|
||||
try:
|
||||
proc = subprocess.run(cmd, capture_output=True, timeout=args.timeout)
|
||||
rc = proc.returncode
|
||||
except subprocess.TimeoutExpired:
|
||||
print("BUILD_FAIL: UV4 timed out after {}s (hung or forwarded to IDE?)".format(args.timeout))
|
||||
return 1
|
||||
print("UV4_RC: {}".format(rc))
|
||||
|
||||
if not log.is_file():
|
||||
print("BUILD_FAIL: no build log produced - UV4 did not run or hung")
|
||||
return 1
|
||||
text = log.read_text(encoding="utf-8", errors="replace")
|
||||
lines = text.splitlines()
|
||||
|
||||
errs = [l for l in lines if "error:" in l.lower()]
|
||||
if errs:
|
||||
print("BUILD_FAIL: {} error line(s) in log:".format(len(errs)))
|
||||
for l in errs[:20]:
|
||||
print(" | {}".format(l.strip()))
|
||||
if len(errs) > 20:
|
||||
print(" ... {} more".format(len(errs) - 20))
|
||||
return 1
|
||||
if "0 Error(s), 0 Warning(s)" not in text:
|
||||
print("BUILD_FAIL: no '0 Error(s), 0 Warning(s)' marker in log "
|
||||
"(warnings present or build incomplete). Tail:")
|
||||
for l in lines[-15:]:
|
||||
print(" | {}".format(l.strip()))
|
||||
return 1
|
||||
for l in lines:
|
||||
if l.strip().startswith("Program Size:"):
|
||||
print(l.strip())
|
||||
print("BUILD_OK: 0 errors, 0 warnings")
|
||||
return 0
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
sys.exit(main())
|
||||
@@ -0,0 +1,40 @@
|
||||
---
|
||||
name: new-source-file
|
||||
description: 新增 .c 源文件的双端注册：MDK-ARM/STM32F407-Demo.uvprojx 与 simulator/CMakeLists.txt 均为显式文件列表，新文件必须手动加进两处再双端构建验证。
|
||||
whenToUse: 新建 App/、Drivers/BSP/ 下的 .c 文件，或构建/运行报 undefined reference、"改了代码没生效" 而怀疑文件漏注册时。
|
||||
---
|
||||
|
||||
# 新文件双端注册
|
||||
|
||||
本工程 Keil 工程与 PC 模拟器都使用**显式文件列表**（无通配扫描）——新 `.c` 文件不手动注册就不会被编译；只注册一端 = 另一端**静默**缺文件（不一定报错，功能悄悄不生效）。
|
||||
|
||||
## 注册步骤
|
||||
|
||||
1. **Keil MDK**：编辑 `MDK-ARM/STM32F407-Demo.uvprojx`，在对应 `<GroupName>` 的 `<Files>` 中按相邻条目格式插入（`..\` 开头反斜杠路径）：
|
||||
|
||||
```xml
|
||||
<File>
|
||||
<FileName>ui_new_module.c</FileName>
|
||||
<FileType>1</FileType>
|
||||
<FilePath>..\Drivers\BSP\UI\ui_new_module.c</FilePath>
|
||||
</File>
|
||||
```
|
||||
|
||||
现有组：`App`、`Drivers/BSP`、`Drivers/BSP/UI`、`Test` 等；新文件放语义对应的组。
|
||||
|
||||
2. **模拟器**（仅当文件需 PC 端编译，如 `Drivers/BSP/UI/*.c`）：在 `simulator/CMakeLists.txt` 的 `set(UI_SOURCES ...)` 列表加一行 `${UI_DIR}/ui_new_module.c`。非 UI 模块文件通常不需模拟器注册。
|
||||
|
||||
3. **双端构建验证**（两端都必须过）：
|
||||
|
||||
```powershell
|
||||
cmake --build simulator/build --config Debug # 0 警告
|
||||
& "MDK-ARM\build.bat" # BUILD_OK，0 错 0 警
|
||||
```
|
||||
|
||||
## 注意
|
||||
|
||||
- **禁止**把源文件复制进 `simulator/`——两端共用 `Drivers/BSP/` 原件（UI_界面制作流程.md C7）
|
||||
- 只注册 `.c`（含 `.s`）；`.h` 靠 include 路径找到，不加工程
|
||||
- 漏注册的典型症状：一端编译失败（undefined reference）或一端行为悄悄停留在旧逻辑
|
||||
- 注册完成后跑回归：UI 文件 → `ui-verify` skill；其他模块 → `@test`（`test/host/run_boot_test.py`）
|
||||
- 改过 `CMakeLists.txt` 后需重新 `cmake -B build` 配置
|
||||
@@ -0,0 +1,4 @@
|
||||
# 运行时产物不入库（daemon 日志/状态、专用 venv、字节码缓存）
|
||||
scripts/state/
|
||||
venv/
|
||||
__pycache__/
|
||||
@@ -0,0 +1,61 @@
|
||||
---
|
||||
name: serial-assistant
|
||||
description: 常驻串口助手（采集层）：daemon + 薄 CLI + 日志文件即接口。ports/open/send/log/clear/wait-idle/status 全套命令；RX/TX 全量历史落盘可直接 Read/Grep；一台机单 daemon 跨进程共享，自动拉起。serial-boot-test 等串口工作流的底座。
|
||||
whenToUse: 需要打开/关闭串口、发送命令或字节、查询串口历史日志、等 RX 静默（抓开机日志）、排查串口占用或端口参数问题时。
|
||||
---
|
||||
|
||||
# serial-assistant — 串口助手（项目级 skill，采集层）
|
||||
|
||||
单脚本 `.dsh/skills/serial-assistant/scripts/serial_tool.py`（Python + pyserial）。
|
||||
架构：CLI（短命进程，硬超时）→ HTTP JSON → daemon（detached 单实例，127.0.0.1:18765）；
|
||||
daemon = 串口读线程（唯一 I/O 者）+ 日志写线程（唯一文件写者）。
|
||||
**历史 = `scripts/state/serial.log`**（纯文本、只含完整行；绝对路径以 `status` 的
|
||||
`log.path` 为准，直接 Read/Grep 即是历史，无采集窗口仪式）。
|
||||
|
||||
## 前置条件
|
||||
|
||||
解释器需装有 pyserial：优先项目自己的 venv；否则一次性建 skill 专用 venv：
|
||||
|
||||
```powershell
|
||||
python -m venv ".dsh\skills\serial-assistant\venv"
|
||||
& ".dsh\skills\serial-assistant\venv\Scripts\python.exe" -m pip install pyserial
|
||||
```
|
||||
|
||||
下文 `$PY` = 选定解释器，`$TOOL` = `.dsh\skills\serial-assistant\scripts\serial_tool.py`。
|
||||
**所有命令在项目根目录下运行**（cwd 决定配置源解析）。
|
||||
|
||||
## 命令（全部 JSON 输出；退出码 0=成功 1=领域错误 2=daemon 不可达/超时 3=用法）
|
||||
|
||||
```powershell
|
||||
& $PY $TOOL ports # 枚举 COM 口 + configured 标注 + 唯一候选 hint
|
||||
& $PY $TOOL open # 开串口（幂等；daemon 未跑自动拉起）；--port/--baud 可覆盖
|
||||
& $PY $TOOL send "help" # 发文本；send --hex 0D0A --nl 发字节并追加 CRLF
|
||||
& $PY $TOOL log --tail 40 # 读日志；--grep P [-i] [--regex]（先过滤后截尾）
|
||||
& $PY $TOOL clear # 清空日志（代际 +1，会话边界）
|
||||
& $PY $TOOL wait-idle # 等 RX 静默：--settle-ms 8000 --max-ms 30000 --first-timeout-ms 12000
|
||||
& $PY $TOOL status # 全状态 JSON（daemon 版本/端口/计数/rx_age_ms/log.path）
|
||||
& $PY $TOOL start|stop|restart # daemon 生命周期
|
||||
& $PY $TOOL selftest # 无头自检（行拆分/解码/截头/wait 判据，无需硬件）
|
||||
```
|
||||
|
||||
**抓开机日志铁律**：`open` → `clear` → 烧录/复位 → `wait-idle` → 读日志校验标记
|
||||
（采集必须先于烧录，否则错过开机头几行）。
|
||||
|
||||
## 配置源（串口参数单一配置源）
|
||||
|
||||
解析顺序：`$DSH_SERIAL_CONFIG` > `<cwd>/.serialtest/config.json` >
|
||||
`<cwd>/.opencode/serial_config.json`（旧位置）。用到的键：`portName`、`baudRate`、
|
||||
`httpPort`（缺省 18765）。端口变化**只改这个文件**，改完必须 `restart`
|
||||
（daemon 启动时缓存配置）。
|
||||
|
||||
## 陷阱（实测教训）
|
||||
|
||||
- **一台机只有一个 daemon**（HTTP 口 `SO_EXCLUSIVEADDRUSE` 独占绑定）。多个项目的
|
||||
serial_tool 副本协议兼容、可互连：`status` 的 `daemon.version` 辨归属
|
||||
（本 skill 版 = `1.1.0-skill`），`log.path` 辨日志落点。
|
||||
- **`open` 报"拒绝访问/端口被占用"**：先 `status` 查是不是残留旧 daemon 占着口 →
|
||||
`stop`（或 `taskkill /F /PID`）→ 重新 `open`。
|
||||
- **`wait-idle` 判据**：`no_data` = 本次等待期间零字节；首字节到达前不启动静默计时；
|
||||
返回的 `rx_bytes` 是本次增量。`settle-ms` 必须大于固件的自然静默间隙（常见 3~4s）。
|
||||
- **`open` 不带 `--dtr/--rts` = 保持当前线路状态**；显式给才翻转。
|
||||
- 日志 20MB 上限自动按行边界截头保尾 10MB；无换行残行 64KB 封顶。
|
||||
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,4 @@
|
||||
# 运行时产物不入库（daemon 日志/状态、专用 venv、字节码缓存）
|
||||
state/
|
||||
venv/
|
||||
__pycache__/
|
||||
@@ -0,0 +1,88 @@
|
||||
---
|
||||
name: serial-boot-test
|
||||
description: 嵌入式目标"烧录/复位 → 抓串口开机日志 → 标记校验"一键闭环。构建在 serial-assistant skill（串口采集层）之上，自带烧录测试编排器与日志标记校验器；项目差异全部收在 <项目根>/.serialtest/config.json，任何带调试串口的项目都能用。
|
||||
whenToUse: 需要向目标板烧录或复位后，用串口日志自动判定运行是否正常（开机回归、固件身份校验、HardFault/FAIL 标记扫描、开机耗时测量），或需要交互式串口收发与日志回放时。
|
||||
---
|
||||
|
||||
# serial-boot-test — 串口自动验证（判定层，构建在 serial-assistant 之上）
|
||||
|
||||
分层：**采集层 = 兄弟 skill `serial-assistant`**（常驻 daemon 串口助手），
|
||||
本 skill 只负责**闭环编排 + 判定**。换项目时把 `serial-boot-test` 和
|
||||
`serial-assistant` 两个文件夹一起拷进目标项目的 `.dsh/skills/`
|
||||
（或 `.agents/skills/`），脚本不含任何仓库路径。
|
||||
|
||||
| 脚本 | 作用 |
|
||||
|---|---|
|
||||
| `.dsh/skills/serial-boot-test/scripts/run_boot_test.py` | 一键闭环：open+clear → 烧录 → wait-idle → 提取 boot log → 烧录回读校验 → 标记校验。串口助手按 `$DSH_SERIAL_TOOL` > 同目录 > `../serial-assistant/scripts/serial_tool.py` 解析 |
|
||||
| `.dsh/skills/serial-boot-test/scripts/verify_log.py` | 对任意日志文件做标记校验（Required/Forbidden/锚点计数/顺序/耗时），可单独用 |
|
||||
|
||||
交互式串口操作（open/send/log/wait-idle/status 等）不属于本 skill——
|
||||
**用 `serial-assistant` skill**。
|
||||
|
||||
## 前置条件
|
||||
|
||||
1. **解释器需装有 pyserial**（闭环经采集层脚本用串口）。优先用项目自己的 venv；
|
||||
否则按 `serial-assistant` skill 的"前置条件"建专用 venv。
|
||||
下文 `$PY` = 选定的解释器，`$SKILL` = `.dsh\skills\serial-boot-test`（项目根下相对路径）。
|
||||
2. **所有命令都在项目根目录下运行**（cwd 决定配置源解析）。
|
||||
|
||||
## 第一步：项目档案（每个项目一次）
|
||||
|
||||
配置解析顺序：`$DSH_SERIAL_CONFIG` > `<cwd>/.serialtest/config.json` > `<cwd>/.opencode/serial_config.json`（旧位置，仅串口字段）。
|
||||
|
||||
若项目没有 `.serialtest/config.json`：**先从项目文档（AGENTS.md/README/测试文档）推断各字段，推断不了的问用户**，然后按 `config.example.json` 写一份。字段含义：
|
||||
|
||||
| 键 | 含义 | 缺省行为 |
|
||||
|---|---|---|
|
||||
| `portName` / `baudRate` | 串口 | 无 portName 直接 exit 3 |
|
||||
| `flash_cmd` | 烧录命令（**必须含复位运行**，如 `-Rst -Run`；可带参数） | 空 = 不烧录，脚本提示人工复位板子 |
|
||||
| `hex` | 刚构建的镜像（Intel HEX），供身份戳 + 回读比对 | 空 = 两项都跳过（WARN） |
|
||||
| `fw_marker` | 固件身份戳前缀（固件里打印 `"<前缀>" __DATE__ " " __TIME__`） | 默认 `fw build: `；hex 里无此串只 WARN 不假判 |
|
||||
| `readback_cmd` | 回读校验命令模板，`{hex}` = 镜像路径（引号自动加） | 空 = 跳过 |
|
||||
| `readback_ok` | 回读成功判据（按行首匹配，大小写不敏感） | `no difference found` |
|
||||
| `required` | 必须出现的标记（`;` 分隔，大小写敏感） | **空 = exit 3**（必须给） |
|
||||
| `forbidden` | 禁止出现的模式（`;` 分隔，大小写不敏感） | `FAIL;ERROR;HardFault` |
|
||||
| `boot_marker` | 一轮启动的锚点子串（如 `reset cause:`） | 空 = 锚点计数关闭 |
|
||||
| `max_boot_count` | 锚点出现 0 次或 >N 次 = FAIL | 1（仅 boot_marker 非空时生效） |
|
||||
| `done_marker` + `max_boot_ms` | 开机耗时口径与上限 | 空/0 = 只报告不判 |
|
||||
| `settle_ms` / `max_wait_ms` / `first_wait_ms` | RX 静默判据 / 总超时 / 首字节超时 | 8000 / 30000 / 12000 |
|
||||
| `require_order` / `expect_reset_cause` / `require_suite_summary` | 顺序校验 / 复位原因白名单 / 套件汇总行 | 空 = 关闭 |
|
||||
| `require_selftest_pass` + `device_ip` | 设备侧自检台账联合判定（FTP 抓取） | 关闭 |
|
||||
|
||||
**先跑项目的构建**（本仓库 = `keil-build` skill，其它 Keil 项目照该 skill 套；
|
||||
非 Keil 项目用项目自己的构建入口），确认 0 错误 0 警告后再进闭环。
|
||||
档案里的 `flash_cmd`/`readback_cmd` 就是烧录层的入口命令
|
||||
（本仓库 = `stlink-flash` skill 的 `MDK-ARM\reset.bat flash` / `cmp {hex}`）。
|
||||
|
||||
## 第二步：跑闭环
|
||||
|
||||
```powershell
|
||||
# cwd = 项目根目录
|
||||
& $PY "$SKILL\scripts\run_boot_test.py"
|
||||
# 临时覆盖：--port COM7 --required "..." --forbidden "..." --flash-cmd "..."
|
||||
```
|
||||
|
||||
退出码：`0=PASS` / `1=FAIL`（标记缺失或命中）/ `2=采集或烧录错误`（含回读不一致，本次运行作废）/ `3=用法/预检错误`。
|
||||
|
||||
产物：boot log（每行带 `[+Nms]` 相对时基）写到 `%TEMP%\serial-boot-test\boot_log_<时间戳>.txt`（`--out-dir` 改，保留最近 20 份）。
|
||||
|
||||
## 第三步：判读与迭代
|
||||
|
||||
- **PASS** → 报告命中的标记与开机耗时。
|
||||
- **FAIL** → `[MISS]`/`[HIT]` 行（Forbidden 命中带行号+内容）+ 日志尾部已给出；需要更多上下文直接 Read/Grep boot log 文件或 `status` 里 `log.path` 指向的 serial.log。修代码 → 重新构建 → 重跑闭环。
|
||||
- **exit 2 `no_data`** → 板子全程零字节：查端口在位（`ports`）、板电、烧录命令是否真的复位了目标。
|
||||
|
||||
## 交互式串口调试（不跑闭环时）
|
||||
|
||||
用 **`serial-assistant` skill**（`ports/open/send/log/clear/wait-idle/status` 全套命令、
|
||||
抓开机日志铁律、daemon 陷阱都在那边）。本 skill 不重复采集层用法。
|
||||
|
||||
## 陷阱（都是实测教训）
|
||||
|
||||
- **daemon 一台机只有一个**（HTTP 口 18765 独占绑定，由采集层 serial-assistant 管理）。改配置后必须 `restart`（daemon 启动时缓存配置）。若机器上还有旧 daemon，先 `status` 看 `daemon.version`（serial-assistant 版 = `1.1.0-skill`）确认归属，必要时 `stop` 后重开。
|
||||
- **回读校验排在日志采集之后**：部分烧录工具（如 ST-LINK `-CmpFile`）连接时会复位目标，提前跑会截断开机日志。脚本已按此顺序，勿手工调换。
|
||||
- **烧录命令必须让目标复位运行**（裸 `-P` 类写入在目标核死循环时不落地）；写完镜像后 `fw build` 身份戳校验会揭穿"芯片还是旧镜像"。
|
||||
- **`settle_ms` 必须大于固件的自然静默间隙**（常见 3~4s），默认 8000；日志被截断先调大它。
|
||||
- **Required 标记宁少勿多**：先用启动锚点 + 少数里程碑标记；按用例临时覆盖 `--forbidden`（预期出现的 `[ERR]` 负路径用例）。
|
||||
- **烧录与串口采集不冲突**：SWD 下载走探针、调试日志走 USB-serial（CH340 类），互不占用；烧录期间串口侧静默几秒属正常，不算 `no_data`（首字节门会兜住）。
|
||||
- 中文/编码：脚本全程字节级处理，不受控制台代码页影响；配置文件存 UTF-8（BOM 容忍）。
|
||||
@@ -0,0 +1,29 @@
|
||||
{
|
||||
"portName": "COM6",
|
||||
"baudRate": 115200,
|
||||
|
||||
"flash_cmd": "MDK-ARM\\reset.bat flash",
|
||||
"flash_timeout": 180,
|
||||
"hex": "MDK-ARM\\STM32F407-Demo\\STM32F407-Demo.hex",
|
||||
"fw_marker": "fw build: ",
|
||||
"readback_cmd": "MDK-ARM\\reset.bat cmp {hex}",
|
||||
"readback_ok": "no difference found",
|
||||
|
||||
"required": "App init OK;Network Init;net init: OK",
|
||||
"forbidden": "FAIL;ERROR;HardFault;[ERR]",
|
||||
"boot_marker": "reset cause:",
|
||||
"max_boot_count": 1,
|
||||
"done_marker": "net init: OK",
|
||||
"max_boot_ms": 0,
|
||||
"require_order": "",
|
||||
"expect_reset_cause": "",
|
||||
|
||||
"settle_ms": 8000,
|
||||
"max_wait_ms": 30000,
|
||||
"first_wait_ms": 12000,
|
||||
|
||||
"require_selftest_pass": false,
|
||||
"device_ip": "",
|
||||
|
||||
"httpPort": 18765
|
||||
}
|
||||
@@ -0,0 +1,618 @@
|
||||
#!/usr/bin/env python3
|
||||
"""run_boot_test.py - 一键开机日志抓取 + 校验（纯标准库；可移植 skill 版）。
|
||||
|
||||
调用串口助手（采集层 = 兄弟 skill serial-assistant 的 serial_tool.py，常驻 daemon，
|
||||
子进程 CLI + JSON；解析顺序见 find_serial_tool）:
|
||||
1. open 串口 + clear 日志（本次运行独立代际）
|
||||
2. 烧录（config "flash_cmd"；未配置 = 跳过烧录，等人工复位板子）
|
||||
2.5 固件身份戳：从待烧 hex（config "hex"）里抠出固件戳（config "fw_marker"，
|
||||
默认 `fw build: <DATE> <TIME>`），追加成 Required 标记——
|
||||
芯片里跑的必须就是这份构建（--no-fw-check 关闭）
|
||||
3. wait-idle：RX 静默 >= settle-ms 收尾；首字节超过 --first-wait-ms 未到 → no_data
|
||||
（快速失败）；整体 max-wait-ms 超时
|
||||
4. 从日志提取 [RX] 载荷行（剥掉 "[RX] <ISO时间戳> " 前缀），并给每行加 `[+Nms]` 相对
|
||||
偏移（daemon 毫秒时基，本次第一行 = +0ms；--raw-log 出纯载荷）。固件侧时间戳往往
|
||||
只有秒级、开机头几行还没时钟，量不了耗时——这个前缀就是耗时口径
|
||||
4.5 烧录回读校验：config "readback_cmd" 模板（{hex} = 镜像路径），成功判据 =
|
||||
某行以 "readback_ok"（默认 No difference found）开头；未配置 = 跳过。
|
||||
**必须排在采集之后**：ST-LINK -CmpFile 实测连接时会复位目标
|
||||
5. verify_log.py 标记校验（含启动锚点计数 config "boot_marker" + --max-boot-count；
|
||||
--expect-reset-cause 原因白名单；--require-order 标记顺序；
|
||||
--done-marker + --max-boot-ms 开机耗时）
|
||||
6. （仅当 --require-selftest-pass）自检记录联合判定（S7）：
|
||||
--selftest-log 提供本地副本则直接用它，否则从设备 FTP 抓取 /log/selftest.log
|
||||
（需 config "device_ip"）；判定：文件缺失 / 0 字节 = 无故障 → PASS
|
||||
|
||||
采集在烧录**之前**武装（open + clear 先于烧录），daemon 常驻全量日志兜底，
|
||||
无采集窗口/首字节等待仪式。
|
||||
|
||||
项目差异全部收在 <cwd>/.serialtest/config.json（见 config.example.json）：
|
||||
portName/baudRate/flash_cmd/hex/fw_marker/readback_cmd/readback_ok/
|
||||
required/forbidden/boot_marker/done_marker/settle_ms/...
|
||||
解析顺序：$DSH_SERIAL_CONFIG > <cwd>/.serialtest/config.json >
|
||||
<cwd>/.opencode/serial_config.json（旧位置，仅串口字段）。
|
||||
优先级：命令行 > 档案 > 内置通用默认。
|
||||
|
||||
加固口径（Windows 实测教训）:
|
||||
- 子进程输出按**字节**读取、显式 UTF-8 解码 —— 不受控制台代码页（GBK）影响
|
||||
- 配置 JSON 按 UTF-8（容忍 BOM）解析
|
||||
- 不经 PowerShell —— 无执行策略拦截
|
||||
- 烧录/回读带超时 —— 坏连接不会永久挂起
|
||||
|
||||
用法（**项目根目录**下运行，python 需装有 pyserial）:
|
||||
python <skill>/scripts/run_boot_test.py
|
||||
[--port COM7] [--baud-rate 115200] [--settle-ms 8000] [--max-wait-ms 30000]
|
||||
[--first-wait-ms 12000]
|
||||
[--flash-cmd "<烧录命令>"] [--flash-timeout 180]
|
||||
[--required "m1;m2"] [--forbidden "FAIL;ERROR;HardFault"]
|
||||
[--require-suite-summary "Storage Tests"]
|
||||
[--require-selftest-pass] [--selftest-log <本地副本>]
|
||||
[--device-ip 192.168.1.100] [--out-dir <目录>] [--show-tail-lines 15]
|
||||
[--fw-hex <构建产物 hex>] [--no-fw-check]
|
||||
[--no-verify-flash] [--readback-timeout 120]
|
||||
[--max-boot-count 1] [--expect-reset-cause 'software;power-on']
|
||||
[--require-order 'a>b>c'] [--done-marker 'ok'] [--max-boot-ms 0]
|
||||
[--raw-log] [--keep-out 20]
|
||||
|
||||
未显式给的参数取 <cwd>/.serialtest/config.json（见 config.example.json）
|
||||
|
||||
退出码（与旧版一致）:
|
||||
0 = PASS（采集成功 + Required 全中 + Forbidden 零命中）
|
||||
1 = FAIL（标记缺失/命中）
|
||||
2 = 采集或烧录错误（含烧录回读不一致 = 芯片内容与刚编的镜像不同，本次运行作废）
|
||||
3 = 用法/预检错误
|
||||
"""
|
||||
|
||||
import argparse
|
||||
import ftplib
|
||||
import json
|
||||
import os
|
||||
import shlex
|
||||
import subprocess
|
||||
import sys
|
||||
import tempfile
|
||||
import time
|
||||
from datetime import datetime
|
||||
from pathlib import Path
|
||||
|
||||
SCRIPT_DIR = Path(__file__).resolve().parent
|
||||
VERIFY_LOG = SCRIPT_DIR / "verify_log.py"
|
||||
|
||||
|
||||
def find_serial_tool():
|
||||
"""串口助手脚本解析顺序（分层 skill：采集层 = 兄弟 skill serial-assistant）：
|
||||
1. $DSH_SERIAL_TOOL 环境变量（显式指定）
|
||||
2. 与本脚本同目录（兼容单独整包拷贝的场景）
|
||||
3. 兄弟 skill：<skills 根>/serial-assistant/scripts/serial_tool.py
|
||||
都不存在时返回第 3 候选（错误信息照它报）。"""
|
||||
env = os.environ.get("DSH_SERIAL_TOOL")
|
||||
if env:
|
||||
return Path(env)
|
||||
candidates = [SCRIPT_DIR / "serial_tool.py",
|
||||
SCRIPT_DIR.parent.parent / "serial-assistant" / "scripts" / "serial_tool.py"]
|
||||
for c in candidates:
|
||||
if c.is_file():
|
||||
return c
|
||||
return candidates[1]
|
||||
|
||||
|
||||
SERIAL_TOOL = find_serial_tool()
|
||||
|
||||
|
||||
def find_config_file():
|
||||
"""项目测试档案解析顺序（cwd = 项目根目录）：
|
||||
1. $DSH_SERIAL_CONFIG 环境变量（显式文件）
|
||||
2. <cwd>/.serialtest/config.json （本 skill 约定）
|
||||
3. <cwd>/.opencode/serial_config.json （旧位置，仅串口字段）
|
||||
都不存在时返回第 1 候选（错误信息照它报）。"""
|
||||
env = os.environ.get("DSH_SERIAL_CONFIG")
|
||||
if env:
|
||||
return Path(env)
|
||||
cwd = Path.cwd()
|
||||
candidates = [cwd / ".serialtest" / "config.json",
|
||||
cwd / ".opencode" / "serial_config.json"]
|
||||
for c in candidates:
|
||||
if c.is_file():
|
||||
return c
|
||||
return candidates[0]
|
||||
|
||||
|
||||
CFG_FILE = find_config_file()
|
||||
|
||||
# 通用默认（与具体项目无关；项目差异全部进 .serialtest/config.json）
|
||||
FORBIDDEN_DEFAULT = "FAIL;ERROR;HardFault"
|
||||
# 固件身份戳：固件里打印 `"<fw_marker>" __DATE__ " " __TIME__`（编译期展开成连续
|
||||
# ASCII），脚本从待烧 hex 里抠出该串追加成 Required 标记——芯片里跑的镜像必须
|
||||
# 就是刚编出来的这份。旧镜像/错镜像在纯固定串标记下不可见。
|
||||
# 固件没有这类戳 → config 里 "fw_marker": "" 关闭（只 WARN 跳过，不假判）。
|
||||
FW_MARKER_DEFAULT = "fw build: "
|
||||
# 烧录回读校验的成功判据（按**行首**匹配，大小写不敏感）：ST-LINK_CLI -CmpFile
|
||||
# 输出 `No difference found`。其他烧录工具按其成功行改 config 里的 "readback_ok"。
|
||||
READBACK_OK_DEFAULT = "no difference found"
|
||||
|
||||
|
||||
def _split_cmd(cmd_str):
|
||||
r"""把 `--flash-cmd` 这类命令串拆成 [exe, arg, ...]（2026-10-10 实测坑）。
|
||||
|
||||
直接交给 subprocess、**不经 `cmd /c`**：CreateProcess 能直接跑 .bat，且 Python
|
||||
会给含空格的路径正确加引号。旧写法 `['cmd','/c', 串]` 在本仓库（目录名
|
||||
`DTU Code` 含空格）会被 cmd 的 /c 引号规则玩坏——实测报
|
||||
`'D:\Code\DTU' is not recognized`，回读校验被假判成"芯片内容不一致"。
|
||||
路径本身含空格时把该段用引号包住（`"D:\some dir\reset.bat" flash`）。
|
||||
posix=False 是必须的：posix=True 会吃掉 Windows 路径里的反斜杠。
|
||||
"""
|
||||
return [p.strip('"') for p in shlex.split(cmd_str, posix=False)]
|
||||
|
||||
|
||||
def _run_cmd(argv, timeout):
|
||||
"""跑一条外部命令，按字节取回输出并显式 UTF-8 解码（不受控制台代码页影响）。"""
|
||||
try:
|
||||
proc = subprocess.run(argv, capture_output=True, timeout=timeout)
|
||||
rc = proc.returncode
|
||||
raw = (proc.stdout or b"") + (proc.stderr or b"")
|
||||
except subprocess.TimeoutExpired as e:
|
||||
rc = -1
|
||||
raw = (e.stdout or b"") + (e.stderr or b"")
|
||||
return rc, raw.decode("utf-8", errors="replace")
|
||||
|
||||
|
||||
def extract_fw_stamp(hex_path, marker):
|
||||
"""从 Intel HEX 里抠固件身份戳（只扫数据记录，不建整片镜像，内存 O(镜像体积)）。
|
||||
|
||||
返回戳串（如 'Oct 10 2026 02:38:12'）；找不到（旧固件/未重编译）返回 None。
|
||||
"""
|
||||
data = bytearray()
|
||||
for line in Path(hex_path).read_text(errors="replace").splitlines():
|
||||
line = line.strip()
|
||||
if not line.startswith(":"):
|
||||
continue
|
||||
try:
|
||||
rec = bytes.fromhex(line[1:])
|
||||
except ValueError:
|
||||
continue
|
||||
if len(rec) > 4 and rec[3] == 0:
|
||||
data += rec[4:4 + rec[0]]
|
||||
i = data.find(marker.encode("ascii"))
|
||||
if i < 0:
|
||||
return None
|
||||
j = i + len(marker)
|
||||
end = j
|
||||
while end < len(data) and 0x20 <= data[end] < 0x7F:
|
||||
end += 1
|
||||
return data[j:end].decode("ascii", errors="replace")
|
||||
|
||||
|
||||
def _cli(cmd_args, timeout):
|
||||
"""调用串口助手 CLI，返回 (rc, stdout_text, parsed_json_or_None)。
|
||||
|
||||
全程字节级处理（capture_output 取 bytes 后显式 UTF-8 解码），
|
||||
任何 Windows 控制台代码页都不参与数据路径。
|
||||
"""
|
||||
try:
|
||||
proc = subprocess.run(cmd_args, capture_output=True, timeout=timeout)
|
||||
except subprocess.TimeoutExpired:
|
||||
return 2, "client timeout ({}s)".format(timeout), None
|
||||
text = proc.stdout.decode("utf-8", errors="replace")
|
||||
try:
|
||||
return proc.returncode, text, json.loads(text)
|
||||
except ValueError:
|
||||
return proc.returncode, text, None
|
||||
|
||||
|
||||
def _tool_cmd(py, cmd, *rest, timeout=15):
|
||||
rc, out, data = _cli([py, str(SERIAL_TOOL), cmd, *rest], timeout)
|
||||
if rc != 0 or data is None:
|
||||
return None, out
|
||||
return data, out
|
||||
|
||||
|
||||
def _ftp_quit(ftp):
|
||||
"""尽力关闭 FTP 控制连接（QUIT 失败不影响判定）。"""
|
||||
try:
|
||||
ftp.quit()
|
||||
except (OSError, ftplib.Error):
|
||||
pass
|
||||
|
||||
|
||||
def _prune_out_dir(out_dir, keep):
|
||||
"""只保留最近 N 份产物（`boot_log_*.txt` / `selftest_log_*.log`）。
|
||||
|
||||
这些文件按 `%Y%m%d_%H%M%S` 命名、每次 @test 各留一份，旧实现从不清理——
|
||||
本机实测 out 目录已堆到 31 份 boot_log + 7 份 selftest_log（2026-10-10）。
|
||||
文件名含时间戳 → 按名字排序即按时间排序。
|
||||
"""
|
||||
if keep <= 0:
|
||||
return 0
|
||||
removed = 0
|
||||
for pat in ("boot_log_*.txt", "selftest_log_*.log"):
|
||||
for p in sorted(out_dir.glob(pat), key=lambda q: q.name)[:-keep]:
|
||||
try:
|
||||
p.unlink()
|
||||
removed += 1
|
||||
except OSError:
|
||||
pass
|
||||
return removed
|
||||
|
||||
|
||||
def _fetch_selftest_log(device_ip, out_dir, stamp):
|
||||
"""从设备 FTP 抓取 /log/selftest.log（lftpd :21 匿名，根目录 = 卷根）。
|
||||
|
||||
成功返回本地路径字符串；失败（网络不可达 / FTP 错误 / 设备侧文件缺失）返回 ""
|
||||
（按 S7 语义视为无故障记录；此处打 WARN，调用方不判整体 FAIL）。
|
||||
|
||||
2026-10-02 台架修复：原实现只 `except OSError`，而 ftplib 的 error_temp /
|
||||
error_perm 继承自 Exception 而非 OSError —— 台账"仅故障才写"，干净设备上
|
||||
/log/selftest.log 根本不存在，RETR 返回 450 直接抛出未捕获异常，令整个
|
||||
`@test --require-selftest-pass` 在最后一步崩掉（而它本该是 PASS 路径）。
|
||||
现把"设备侧无此文件"单列为正常路径（INFO），其余 FTP 错误保留 WARN。
|
||||
"""
|
||||
local = Path(out_dir) / "selftest_log_{}.log".format(stamp)
|
||||
ftp = ftplib.FTP()
|
||||
try:
|
||||
ftp.connect(device_ip, 21, timeout=10)
|
||||
ftp.login() # 匿名（lftpd 接受 USER anonymous / 空 PASS）
|
||||
except (OSError, ftplib.Error) as e:
|
||||
print("RUN_TEST_WARN: selftest fetch failed: {} "
|
||||
"(按 S7 语义视为无记录；设备网络/FTP 需另行排查)".format(e))
|
||||
return ""
|
||||
|
||||
buf = bytearray()
|
||||
try:
|
||||
ftp.retrbinary("RETR /log/selftest.log", buf.extend)
|
||||
except ftplib.all_errors as e:
|
||||
# 450/550 = 设备侧无此文件：干净台账，S7 判 PASS（正常路径，非故障）
|
||||
print("SELFTEST_FETCH: {} -> (ledger absent: {}) 按 S7 视为无故障记录"
|
||||
.format(device_ip, str(e).strip()))
|
||||
_ftp_quit(ftp)
|
||||
return ""
|
||||
|
||||
_ftp_quit(ftp)
|
||||
local.write_bytes(bytes(buf))
|
||||
print("SELFTEST_FETCH: {} -> {} ({} bytes)".format(device_ip, local, len(buf)))
|
||||
return str(local)
|
||||
|
||||
|
||||
def main(argv=None):
|
||||
# 控制台输出固定 UTF-8：Windows 代码页只影响显示，不会让脚本崩溃
|
||||
for stream in (sys.stdout, sys.stderr):
|
||||
try:
|
||||
stream.reconfigure(encoding="utf-8", errors="replace")
|
||||
except Exception:
|
||||
pass
|
||||
|
||||
ap = argparse.ArgumentParser(description="boot log capture + verify (pure stdlib, no PowerShell)")
|
||||
ap.add_argument("--port", default=None,
|
||||
help="serial port (default: portName from project config)")
|
||||
ap.add_argument("--baud-rate", type=int, default=None)
|
||||
ap.add_argument("--settle-ms", type=int, default=None,
|
||||
help="RX silence that ends the capture")
|
||||
ap.add_argument("--max-wait-ms", type=int, default=None,
|
||||
help="overall wait-idle timeout")
|
||||
ap.add_argument("--first-wait-ms", type=int, default=None,
|
||||
help="give up as no_data if the board sent ZERO bytes this long "
|
||||
"after flash started the wait (0 = same as --max-wait-ms)")
|
||||
ap.add_argument("--flash-cmd", default=None,
|
||||
help="flash command (from config 'flash_cmd'; empty = skip flashing, "
|
||||
"reset the board manually right after the run starts)")
|
||||
ap.add_argument("--flash-timeout", type=int, default=None,
|
||||
help="flash subprocess timeout in seconds")
|
||||
ap.add_argument("--required", default=None,
|
||||
help="required markers, ';' separated (config 'required')")
|
||||
ap.add_argument("--forbidden", default=None,
|
||||
help="forbidden patterns, ';' separated (config 'forbidden')")
|
||||
ap.add_argument("--require-suite-summary", default=None,
|
||||
help="suite names that MUST appear as '=== <name>: N/M PASSED (failed=0) ===' "
|
||||
"with N>0, ';' separated (T-2). Empty = off")
|
||||
ap.add_argument("--require-selftest-pass", action="store_true", default=None,
|
||||
help="jointly judge /log/selftest.log (S7): missing/empty = PASS, "
|
||||
"any 64B record = FAIL")
|
||||
ap.add_argument("--selftest-log", default=None,
|
||||
help="local copy of /log/selftest.log (skips device-side fetch when given)")
|
||||
ap.add_argument("--device-ip", default=None,
|
||||
help="device IP for fetching /log/selftest.log via FTP (anonymous)")
|
||||
ap.add_argument("--out-dir", default=None)
|
||||
ap.add_argument("--show-tail-lines", type=int, default=None)
|
||||
ap.add_argument("--fw-hex", default=None,
|
||||
help="built image for the firmware-identity stamp and the readback "
|
||||
"compare (config 'hex')")
|
||||
ap.add_argument("--no-fw-check", action="store_true", default=None,
|
||||
help="do not require the firmware build stamp in the boot log")
|
||||
ap.add_argument("--no-verify-flash", action="store_true", default=None,
|
||||
help="skip the readback compare (config 'readback_cmd')")
|
||||
ap.add_argument("--readback-timeout", type=int, default=None,
|
||||
help="timeout for the readback compare, seconds")
|
||||
ap.add_argument("--max-boot-count", type=int, default=None,
|
||||
help="fail if the boot banner (config 'boot_marker') appears 0 times or "
|
||||
"more than N times (0 = check off)")
|
||||
ap.add_argument("--expect-reset-cause", default=None,
|
||||
help="';'-separated substrings the FIRST reset cause must match "
|
||||
"(case-insensitive); empty = report only, no verdict")
|
||||
ap.add_argument("--require-order", default=None,
|
||||
help="'>'-separated markers that must appear in that line order "
|
||||
"(catches out-of-order boot steps); empty = off")
|
||||
ap.add_argument("--done-marker", default=None,
|
||||
help="marker whose line marks boot completion (for --max-boot-ms); "
|
||||
"empty = don't measure")
|
||||
ap.add_argument("--max-boot-ms", type=int, default=None,
|
||||
help="fail if time from first line to --done-marker exceeds N ms "
|
||||
"(0 = measure and report only)")
|
||||
ap.add_argument("--raw-log", action="store_true", default=None,
|
||||
help="write payload-only boot log (no '[+Nms]' relative-time prefix)")
|
||||
ap.add_argument("--keep-out", type=int, default=None,
|
||||
help="keep the newest N boot_log_*/selftest_log_* files in --out-dir "
|
||||
"(0 = keep everything)")
|
||||
args = ap.parse_args(argv)
|
||||
|
||||
# 串口助手 CLI 用当前解释器（需装有 pyserial）
|
||||
py = sys.executable
|
||||
|
||||
# 项目测试档案（.serialtest/config.json，UTF-8 容忍 BOM）：
|
||||
# 优先级 = 命令行 > 档案 > 内置通用默认。档案缺失不是错误（纯命令行也能跑）。
|
||||
cfg = {}
|
||||
if CFG_FILE.is_file():
|
||||
try:
|
||||
raw = json.loads(CFG_FILE.read_text(encoding="utf-8-sig"))
|
||||
except (OSError, ValueError) as e:
|
||||
print("RUN_TEST_ERROR: cannot parse {}: {}".format(CFG_FILE, e))
|
||||
return 3
|
||||
if not isinstance(raw, dict):
|
||||
print("RUN_TEST_ERROR: config root is not an object: {}".format(CFG_FILE))
|
||||
return 3
|
||||
cfg = raw
|
||||
print("CONFIG: {}".format(CFG_FILE if cfg else "(none, CLI-only)"))
|
||||
|
||||
def _pick(cli, key, default=None):
|
||||
if cli is not None:
|
||||
return cli
|
||||
v = cfg.get(key)
|
||||
return default if v is None else v
|
||||
|
||||
port = str(_pick(args.port, "portName", default="") or "")
|
||||
args.baud_rate = int(_pick(args.baud_rate, "baudRate", default=115200))
|
||||
args.settle_ms = int(_pick(args.settle_ms, "settle_ms", default=8000))
|
||||
args.max_wait_ms = int(_pick(args.max_wait_ms, "max_wait_ms", default=30000))
|
||||
args.first_wait_ms = int(_pick(args.first_wait_ms, "first_wait_ms", default=12000))
|
||||
args.flash_cmd = str(_pick(args.flash_cmd, "flash_cmd", default="") or "")
|
||||
args.flash_timeout = int(_pick(args.flash_timeout, "flash_timeout", default=180))
|
||||
args.required = str(_pick(args.required, "required", default="") or "")
|
||||
args.forbidden = str(_pick(args.forbidden, "forbidden", default=FORBIDDEN_DEFAULT))
|
||||
args.require_suite_summary = str(_pick(args.require_suite_summary,
|
||||
"require_suite_summary", default="") or "")
|
||||
args.require_selftest_pass = bool(_pick(args.require_selftest_pass,
|
||||
"require_selftest_pass", default=False))
|
||||
args.selftest_log = str(_pick(args.selftest_log, "selftest_log", default="") or "")
|
||||
args.device_ip = str(_pick(args.device_ip, "device_ip", default="") or "")
|
||||
args.out_dir = str(_pick(args.out_dir, "out_dir",
|
||||
default=str(Path(tempfile.gettempdir()) / "serial-boot-test")))
|
||||
args.show_tail_lines = int(_pick(args.show_tail_lines, "show_tail_lines", default=15))
|
||||
args.fw_hex = str(_pick(args.fw_hex, "hex", default="") or "")
|
||||
args.no_fw_check = bool(_pick(args.no_fw_check, "no_fw_check", default=False))
|
||||
args.fw_marker = str(cfg.get("fw_marker", FW_MARKER_DEFAULT) or "")
|
||||
args.no_verify_flash = bool(_pick(args.no_verify_flash, "no_verify_flash", default=False))
|
||||
args.readback_cmd = str(cfg.get("readback_cmd", "") or "")
|
||||
args.readback_ok = str(cfg.get("readback_ok", READBACK_OK_DEFAULT) or READBACK_OK_DEFAULT)
|
||||
args.readback_timeout = int(_pick(args.readback_timeout, "readback_timeout", default=120))
|
||||
args.max_boot_count = int(_pick(args.max_boot_count, "max_boot_count", default=1))
|
||||
args.boot_marker = str(cfg.get("boot_marker", "") or "")
|
||||
args.expect_reset_cause = str(_pick(args.expect_reset_cause,
|
||||
"expect_reset_cause", default="") or "")
|
||||
args.require_order = str(_pick(args.require_order, "require_order", default="") or "")
|
||||
args.done_marker = str(_pick(args.done_marker, "done_marker", default="") or "")
|
||||
args.max_boot_ms = int(_pick(args.max_boot_ms, "max_boot_ms", default=0))
|
||||
args.raw_log = bool(_pick(args.raw_log, "raw_log", default=False))
|
||||
args.keep_out = int(_pick(args.keep_out, "keep_out", default=20))
|
||||
|
||||
if not port:
|
||||
print("RUN_TEST_ERROR: no --port given and no portName in {} "
|
||||
"(create .serialtest/config.json, see config.example.json)".format(CFG_FILE))
|
||||
return 3
|
||||
if not args.required:
|
||||
print("RUN_TEST_ERROR: no required markers (--required or 'required' in {})".format(CFG_FILE))
|
||||
return 3
|
||||
|
||||
# --flash-cmd 允许带参数（如 "MDK-ARM\reset.bat flash"）：拆成 argv，
|
||||
# 存在性只查 exe 段（整串当文件名必然 missing，2026-10-10 实测）
|
||||
flash_argv = _split_cmd(args.flash_cmd) if args.flash_cmd else None
|
||||
|
||||
# 预检（对应旧版 missing-file 检查）
|
||||
preflight = [SERIAL_TOOL, VERIFY_LOG]
|
||||
if flash_argv is not None:
|
||||
preflight.append(Path(flash_argv[0]))
|
||||
for p in preflight:
|
||||
if not p.is_file():
|
||||
print("RUN_TEST_ERROR: missing {}".format(p))
|
||||
return 3
|
||||
|
||||
out_dir = Path(args.out_dir)
|
||||
out_dir.mkdir(parents=True, exist_ok=True)
|
||||
pruned = _prune_out_dir(out_dir, args.keep_out)
|
||||
if pruned:
|
||||
print("OUT: pruned {} old artifact file(s) in {} (keep={})".format(
|
||||
pruned, out_dir, args.keep_out))
|
||||
|
||||
stamp = datetime.now().strftime("%Y%m%d_%H%M%S")
|
||||
boot_txt = out_dir / "boot_log_{}.txt".format(stamp)
|
||||
|
||||
def tool(cmd, *rest, timeout=15):
|
||||
return _tool_cmd(py, cmd, *rest, timeout=timeout)
|
||||
|
||||
print("=== Boot test {} ===".format(stamp))
|
||||
print("Port: {} @ {} settle={}ms max={}ms".format(
|
||||
port, args.baud_rate, args.settle_ms, args.max_wait_ms))
|
||||
|
||||
# 1. open（幂等；未运行则自动拉起常驻 daemon）
|
||||
data, out = tool("open", "--port", port, "--baud", str(args.baud_rate), "--timeout", "15")
|
||||
if data is None:
|
||||
print("RUN_TEST_ERROR: open failed: {}".format(out))
|
||||
return 2
|
||||
|
||||
# 2. clear（新代际；此后数据才属于本次运行）
|
||||
data, out = tool("clear", "--timeout", "15")
|
||||
if data is None:
|
||||
print("RUN_TEST_ERROR: clear failed: {}".format(out))
|
||||
return 2
|
||||
|
||||
# 3. flash（下载 + Reset & Run）。烧录失败不中断：板子可能已复位，
|
||||
# 由采集 + 标记判定结果（与旧版一致）。flash_cmd 为空 = 不烧录，
|
||||
# 采集已武装，等人工复位/上电目标板（纯串口验证项目常用）。
|
||||
if flash_argv is None:
|
||||
print("FLASH: skipped (no flash_cmd) -- reset/power-cycle the board NOW")
|
||||
else:
|
||||
print("FLASH_START: {}".format(" ".join(flash_argv)))
|
||||
t0 = time.monotonic()
|
||||
try:
|
||||
proc = subprocess.run(flash_argv,
|
||||
capture_output=True, timeout=args.flash_timeout)
|
||||
flash_rc = proc.returncode
|
||||
flash_bytes = (proc.stdout or b"") + (proc.stderr or b"")
|
||||
except subprocess.TimeoutExpired as e:
|
||||
flash_rc = -1
|
||||
flash_bytes = (e.stdout or b"") + (e.stderr or b"")
|
||||
elapsed_ms = int((time.monotonic() - t0) * 1000)
|
||||
for line in flash_bytes.decode("utf-8", errors="replace").strip().splitlines()[-12:]:
|
||||
print(line)
|
||||
print("FLASH_RC: {} elapsed_ms={}".format(flash_rc, elapsed_ms))
|
||||
if flash_rc != 0:
|
||||
print("RUN_TEST_WARN: flash rc={} (continuing: board may still have reset)".format(flash_rc))
|
||||
|
||||
# 3.5 固件身份戳：从**刚烧进去的那份 hex** 里抠出固件戳（config "fw_marker"，
|
||||
# 默认 'fw build: '），追加成 Required 标记 → 芯片里跑的必须就是这份构建。
|
||||
# hex 里没有该串（旧构建/无此机制）时只 WARN 跳过，不假判 FAIL。
|
||||
required = args.required
|
||||
fw_hex = Path(args.fw_hex) if args.fw_hex else None
|
||||
if args.no_fw_check:
|
||||
print("FW ID: skipped (--no-fw-check)")
|
||||
elif not args.fw_marker:
|
||||
print("FW ID: skipped (fw_marker empty)")
|
||||
elif fw_hex is None:
|
||||
print("RUN_TEST_WARN: no 'hex' configured -> identity + readback skipped")
|
||||
elif not fw_hex.is_file():
|
||||
print("RUN_TEST_WARN: fw hex not found {} -> identity + readback skipped".format(fw_hex))
|
||||
else:
|
||||
fw_stamp = extract_fw_stamp(fw_hex, args.fw_marker)
|
||||
if fw_stamp is None:
|
||||
print("RUN_TEST_WARN: no '{}' stamp in {} -> identity check skipped "
|
||||
"(stale image: rebuild first)".format(args.fw_marker, fw_hex.name))
|
||||
else:
|
||||
marker = args.fw_marker + fw_stamp
|
||||
required = (args.required + ";" + marker) if args.required else marker
|
||||
print("FW ID: expected stamp '{}' (from {})".format(marker, fw_hex.name))
|
||||
|
||||
# 4. wait-idle（RX 静默收尾或整体超时）
|
||||
# --first-timeout-ms：首字节门——烧录后板子全程不吐字节时按 no_data 快速失败
|
||||
# （旧版 daemon 常驻累计 rx_bytes>0，no_data 永不触发，只能靠后面"日志里没有
|
||||
# [RX] 行"兜底，报错信息误导成 device silent?）
|
||||
wait_timeout_s = args.max_wait_ms // 1000 + 20
|
||||
wait_args = ["--settle-ms", str(args.settle_ms),
|
||||
"--max-ms", str(args.max_wait_ms),
|
||||
"--timeout", str(wait_timeout_s)]
|
||||
if args.first_wait_ms:
|
||||
wait_args += ["--first-timeout-ms", str(args.first_wait_ms)]
|
||||
data, out = tool("wait-idle", *wait_args, timeout=wait_timeout_s + 15)
|
||||
if data is None:
|
||||
print("RUN_TEST_ERROR: wait-idle failed: {}".format(out))
|
||||
return 2
|
||||
print("WAIT: reason={} rx_bytes={} waited_ms={}".format(
|
||||
data.get("reason"), data.get("rx_bytes"), data.get("waited_ms")))
|
||||
if data.get("reason") == "no_data":
|
||||
print("RUN_TEST_ERROR: no RX data at all (check port / board power / flash)")
|
||||
return 2
|
||||
|
||||
# 5. 提取 [RX] 载荷行（剥掉 "[RX] <ISO时间戳> " 前缀）
|
||||
# 默认给每行加 `[+Nms]` 相对偏移（daemon 毫秒时基，本次采集第一行 = +0ms）。
|
||||
# 为什么加：MCU 侧时间戳只有**秒级**，且开机头几行时钟还没起（`----/--/--`），
|
||||
# 根本量不了耗时；有了它 verify_log 才能查"能开机但慢了几秒"（--max-boot-ms）。
|
||||
# --raw-log 恢复旧格式（纯载荷）。
|
||||
data, out = tool("log", "--tail", "0", "--timeout", "15")
|
||||
if data is None:
|
||||
print("RUN_TEST_ERROR: log read failed: {}".format(out))
|
||||
return 2
|
||||
rx = []
|
||||
t0 = None
|
||||
for l in data.get("lines", []):
|
||||
if not (isinstance(l, str) and l.startswith("[RX] ")):
|
||||
continue
|
||||
rest = l[5:]
|
||||
sp = rest.find(" ")
|
||||
ts_txt = rest[:sp] if sp >= 0 else ""
|
||||
payload = rest[sp + 1:] if sp >= 0 else rest
|
||||
if args.raw_log:
|
||||
rx.append(payload)
|
||||
continue
|
||||
ts = None
|
||||
if ts_txt:
|
||||
try:
|
||||
ts = datetime.fromisoformat(ts_txt)
|
||||
except ValueError:
|
||||
ts = None
|
||||
if ts is None:
|
||||
rx.append(payload) # 时间戳读不出来就不加前缀（不猜）
|
||||
continue
|
||||
if t0 is None:
|
||||
t0 = ts
|
||||
rx.append("[+{}ms] {}".format(int((ts - t0).total_seconds() * 1000), payload))
|
||||
if not rx:
|
||||
print("RUN_TEST_ERROR: no [RX] lines in log (device silent?)")
|
||||
return 2
|
||||
boot_txt.write_bytes(("\r\n".join(rx) + "\r\n").encode("utf-8"))
|
||||
print("Boot log: {} (lines={} gen={} ts={})".format(
|
||||
boot_txt, len(rx), data.get("gen"), "raw" if args.raw_log else "+ms"))
|
||||
|
||||
# 5.6 烧录回读校验（config "readback_cmd" 模板，{hex} = 待比对镜像路径；
|
||||
# 成功判据 = 某行以 "readback_ok"（默认 No difference found）开头）。
|
||||
# 必须排在**采集之后**：实测 ST-LINK -CmpFile 连接时会复位目标（板子当场
|
||||
# 重打一遍开机日志），排在采集前会截断开机日志并让启动锚点计数误判。
|
||||
if args.no_verify_flash:
|
||||
print("READBACK: skipped (--no-verify-flash)")
|
||||
elif not args.readback_cmd:
|
||||
print("READBACK: skipped (no 'readback_cmd' in config)")
|
||||
elif fw_hex is None or not fw_hex.is_file():
|
||||
print("READBACK: skipped (no fw hex: {})".format(args.fw_hex or "(unset)"))
|
||||
else:
|
||||
rb_cmd = args.readback_cmd.replace("{hex}", '"{}"'.format(fw_hex))
|
||||
rb_rc, rb_text = _run_cmd(_split_cmd(rb_cmd), args.readback_timeout)
|
||||
# 判定按**行首**匹配：进度条和帮助文本里也可能含成功字样，
|
||||
# 只有工具自己那行才独占行首（实测 `...100%\r\nNo difference found.`）
|
||||
rb_ok = any(ln.strip().lower().startswith(args.readback_ok.lower())
|
||||
for ln in rb_text.splitlines())
|
||||
if rb_ok:
|
||||
print("READBACK: OK ({}) rc={}".format(args.readback_ok, rb_rc))
|
||||
else:
|
||||
print("READBACK: FAIL -- device flash does NOT match {}".format(fw_hex.name))
|
||||
for line in rb_text.strip().splitlines()[-10:]:
|
||||
print(" | {}".format(line))
|
||||
print("RUN_TEST_ERROR: flash readback mismatch (chip content != built image)")
|
||||
return 2
|
||||
|
||||
# 5.5 自检记录抓取（S7）：启用且未提供本地副本时才走 FTP（需 config "device_ip"）
|
||||
selftest_local = args.selftest_log
|
||||
if args.require_selftest_pass and not selftest_local and not args.device_ip:
|
||||
print("RUN_TEST_WARN: require_selftest_pass but no device_ip/selftest_log "
|
||||
"-> treated as no record (S7 PASS path)")
|
||||
if args.require_selftest_pass and not selftest_local and args.device_ip:
|
||||
selftest_local = _fetch_selftest_log(args.device_ip, out_dir, stamp)
|
||||
|
||||
# 6. 标记校验（含固件身份戳、启动锚点计数、可选的自检记录联合判定）
|
||||
# 启动锚点（config "boot_marker"，如本仓库的 'reset cause:'）未配置 =
|
||||
# 锚点计数关闭——不同固件的"一轮启动"锚点各不相同，宁关勿假判。
|
||||
from verify_log import verify
|
||||
boot_count = args.max_boot_count if args.boot_marker else 0
|
||||
if not args.boot_marker:
|
||||
print("BOOT ANCHOR: off (set 'boot_marker' in config to catch "
|
||||
"mid-capture resets / stale captures)")
|
||||
rc = verify(str(boot_txt), required, args.forbidden, args.show_tail_lines,
|
||||
suite_summary=args.require_suite_summary,
|
||||
selftest_pass=args.require_selftest_pass,
|
||||
selftest_log=selftest_local,
|
||||
boot_marker=args.boot_marker or "reset cause:",
|
||||
max_boot_count=boot_count,
|
||||
expect_reset_cause=args.expect_reset_cause,
|
||||
require_order=args.require_order,
|
||||
done_marker=args.done_marker,
|
||||
max_boot_ms=args.max_boot_ms)
|
||||
print("RUN_TEST_RC={}".format(rc))
|
||||
return rc
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
sys.exit(main())
|
||||
@@ -0,0 +1,448 @@
|
||||
#!/usr/bin/env python3
|
||||
"""verify_log.py - 对抓取的 MCU 调试日志做标记校验（纯标准库，2026-09-20 替代 verify_log.ps1）。
|
||||
|
||||
用于 @test 闭环：烧录后从串口助手日志提取的开机日志交给本脚本 grep 标记，
|
||||
输出结构化判定（格式与旧 PowerShell 版逐字一致，下游文档/习惯不受影响）。
|
||||
|
||||
用法:
|
||||
& '.venv\\Scripts\\python.exe' test/host/verify_log.py --log-path <file>
|
||||
[--required 'marker1;marker2']
|
||||
[--forbidden 'FAIL;ERROR;HardFault;assert;[ERR]']
|
||||
[--require-suite-summary 'Storage Tests;GD5F2GQ5UE Tests']
|
||||
[--require-selftest-pass] [--selftest-log <selftest.log 本地副本>]
|
||||
[--show-tail-lines 40]
|
||||
[--max-boot-count 1] [--boot-marker 'reset cause:']
|
||||
[--expect-reset-cause 'software;power-on']
|
||||
[--require-order 'App init OK>Network Init>net init: OK']
|
||||
[--done-marker 'net init: OK'] [--max-boot-ms 8000] [--json]
|
||||
|
||||
退出码（与旧版一致）:
|
||||
0 = PASS（所有 Required 标记找到，Forbidden 零命中，汇总行要求满足）
|
||||
1 = FAIL（缺 Required / 命中 Forbidden / 汇总行要求不满足）
|
||||
2 = ERROR（日志文件不存在/不可读）
|
||||
|
||||
默认 Required 标记对应 STM32F4-Base 启动序列（见 App/app/app_main.c + App/task/net_task.c），
|
||||
按测试用例覆盖，例如:
|
||||
--required 'App init OK;net init: OK;PHY: 100M FULL'
|
||||
--forbidden 'FAIL;ERROR;HardFault;assert;[ERR]'
|
||||
|
||||
语义约定（与旧 PowerShell 版对齐）:
|
||||
- Required：大小写敏感子串匹配（全文）
|
||||
- Forbidden：大小写**不敏感**子串匹配、逐行计数（旧版 -like 语义；
|
||||
如 Forbidden 'FAIL' 会命中 "write /log/run.log fail (7)" 这类行）
|
||||
- 固件错误级日志前缀是 `[ERR]`（`DBG_ERROR`，形如 `[时间][ERR][TAG] 消息`），
|
||||
与 `ERROR` 子串**不匹配**——默认 Forbidden 因此显式包含 `[ERR]`，驱动/模块
|
||||
错误行不再漏检（2026-09-21 修复）。测试套件中**预期**出现 `[ERR]` 的用例
|
||||
（如 GD5F DMA 守卫负路径、FatFs 非法名校验）须用 --forbidden 覆盖默认值。
|
||||
- 读取编码：先按 UTF-8，解码失败回退系统 locale 编码（旧版 Get-Content 行为）
|
||||
- 控制台输出重配置为 UTF-8（errors=replace）：任何 Windows 控制台代码页
|
||||
都只影响终端显示，不会导致本脚本崩溃
|
||||
- 汇总行（2026-10-01 加，T-2）：纯 Required 子串匹配有个盲区——套件启动横幅
|
||||
命中即判 PASS，**套件是否跑到汇总行、断言数是否为 0 完全不可见**（套件中途
|
||||
挂死/复位、或 Phase 宏全关时会被误判为通过）。`--require-suite-summary`
|
||||
要求日志中出现 `=== <名称>: N/M PASSED (failed=0) ===` 且 **N > 0**。
|
||||
- 自检记录联合判定（S7，2026-10 实机窗口）：`--require-selftest-pass` 对 /log/selftest.log
|
||||
的本地副本（定长 64B 记录，格式见 App/log/sys_log.h）判定。自检仅故障写盘（v1 不记
|
||||
通过项）：**文件缺失 / 0 字节 = 无故障 → PASS**；存在任何一条记录 = 有故障 → FAIL
|
||||
（退出码 1），并逐条打印时间戳 + 描述。抓取失败（设备不可达 / FTP 错误等）由调用方
|
||||
（run_boot_test.py）先打 WARN，本地文件按缺失处理 → 按上述规则不判整体 FAIL。
|
||||
- 启动锚点计数（2026-10-10）：`--max-boot-count N`（run_boot_test.py 默认传 1）统计
|
||||
`reset cause:` 锚点出现次数——**0 次** = 采集没从复位开始（标记全中也可能只是上一轮
|
||||
的残留日志）；**>N 次** = 板子在采集窗口内自己复位过（IWDG 咬狗 / Fault 后
|
||||
`NVIC_SystemReset` / 掉电重启），此前这类运行只要不命中 Forbidden 就判 PASS。
|
||||
`--expect-reset-cause` 对第一个锚点做原因白名单（大小写不敏感子串），空 = 只报告不判。
|
||||
- Forbidden 命中行（2026-10-10）：命中时逐行打印**行号 + 内容**（最多 6 行，超出报剩余数）。
|
||||
旧实现只说 `forbidden pattern: [ERR] (3 line(s))`，人还得自己再 grep 一遍才知道是哪几行
|
||||
——而"是哪几行"恰恰是定位要的东西。
|
||||
- 标记顺序（`--require-order 'a>b>c'`）：按**首次出现的行序**校验启动步骤先后。标记全中
|
||||
但顺序颠倒 = 某步在另一步之后补做（屏障失序、重试后补跑），旧实现完全看不见。
|
||||
- 开机耗时（`--done-marker` + `--max-boot-ms`）：依赖行首 `[+Nms]` 前缀（run_boot_test.py
|
||||
2026-10-10 起按 daemon 毫秒时基给每行加，MCU 侧时间戳只有秒级且开机头几行根本没有）。
|
||||
量"第一行 → done-marker"的真实耗时，抓"能开机但慢了几秒"（mount 重试 / PHY 重协商）。
|
||||
日志里没有该前缀 → 只 WARN 跳过，不假判 FAIL。
|
||||
- `--json`：同一套判定以 JSON 输出（供 CI / 上层脚本消费；退出码语义不变）。
|
||||
"""
|
||||
|
||||
import argparse
|
||||
import json
|
||||
import locale
|
||||
import re
|
||||
import sys
|
||||
from pathlib import Path
|
||||
|
||||
REQUIRED_DEFAULT = "App init OK;Network Init;net init: OK"
|
||||
FORBIDDEN_DEFAULT = "FAIL;ERROR;HardFault;assert;[ERR]"
|
||||
|
||||
# Forbidden 命中时最多打印几条命中行（够定位又不刷屏；剩余条数会报出来）
|
||||
HIT_LINES_MAX = 6
|
||||
|
||||
# 行首 `[+1234ms] `：run_boot_test.py 按 daemon 毫秒时基给每行加的相对偏移
|
||||
# （MCU 侧时间戳只有秒级，且开机头几行时钟还没起 → 量不了耗时）
|
||||
_TS_OFF_RE = re.compile(r"^\[\+(\d+)ms\]\s")
|
||||
|
||||
# 每轮启动的锚点行（App/app/app_main.c：`reset cause: <原因> (CSR=0x…)`）。
|
||||
# 一次采集里出现 >1 次 = 板子在采集窗口内自己复位过（IWDG 咬狗 / Fault 后
|
||||
# NVIC_SystemReset / 掉电重启），此前只有 Forbidden 命中时才被发现，
|
||||
# "跑完 PASS 但中途重启过"完全不可见（2026-10-10 加）。
|
||||
BOOT_MARKER_DEFAULT = "reset cause:"
|
||||
|
||||
# 套件汇总行：`=== Storage Tests: 3/3 PASSED (failed=0) ===`
|
||||
# 名称可含空格；N/M 为十进制；failed 允许前导 0。宽松容忍前后空白与
|
||||
# 日志时间戳前缀（`[2026-10-01 12:00:00.000]`）——故用 search 而非 match。
|
||||
_SUMMARY_RE = re.compile(
|
||||
r"===\s*(?P<name>[^:=]+?)\s*:\s*(?P<passed>\d+)\s*/\s*(?P<total>\d+)\s+"
|
||||
r"PASSED\s*\(\s*failed\s*=\s*(?P<failed>\d+)\s*\)\s*==="
|
||||
)
|
||||
|
||||
|
||||
def _split_list(spec):
|
||||
"""';' 分隔列表 → 去空白、去空项。"""
|
||||
return [p.strip() for p in spec.split(";") if p.strip()]
|
||||
|
||||
|
||||
def _read_lines(path):
|
||||
raw = Path(path).read_bytes()
|
||||
for enc in ("utf-8", locale.getpreferredencoding(False)):
|
||||
try:
|
||||
return raw.decode(enc).splitlines()
|
||||
except UnicodeDecodeError:
|
||||
continue
|
||||
return raw.decode("utf-8", errors="replace").splitlines()
|
||||
|
||||
|
||||
def _reset_cause_of(line, marker):
|
||||
"""从 `reset cause: software (NVIC_SystemReset) (CSR=0x14000000)` 取原因文本。"""
|
||||
i = line.find(marker)
|
||||
if i < 0:
|
||||
return ""
|
||||
tail = line[i + len(marker):].strip()
|
||||
j = tail.find(" (CSR=")
|
||||
return tail[:j] if j > 0 else tail
|
||||
|
||||
|
||||
def verify(log_path, required=REQUIRED_DEFAULT, forbidden=FORBIDDEN_DEFAULT,
|
||||
show_tail=40, out=print, suite_summary="",
|
||||
selftest_pass=False, selftest_log="",
|
||||
boot_marker=BOOT_MARKER_DEFAULT, max_boot_count=0,
|
||||
expect_reset_cause="", require_order="", done_marker="",
|
||||
max_boot_ms=0, as_json=False):
|
||||
"""标记校验核心（可被 run_boot_test.py 复用）。返回退出码 0/1/2。
|
||||
|
||||
suite_summary: ';' 分隔的套件名列表。非空时，要求日志中每个套件都出现
|
||||
`=== <名称>: N/M PASSED (failed=0) ===` 且 **N > 0**。
|
||||
selftest_pass: True 时对 selftest_log（/log/selftest.log 本地副本）联合判定：
|
||||
文件缺失 / 0 字节 = 无故障（PASS）；存在任何 64B 记录 = FAIL（S7）。
|
||||
selftest_log: 自检记录文件本地路径（空串 = 按文件缺失处理）。
|
||||
boot_marker / max_boot_count（2026-10-10）：统计启动锚点出现次数。
|
||||
max_boot_count>0 时启用：0 次 = 采集没从复位开始；>N 次 = 板子
|
||||
在采集窗口内自己复位过（IWDG / Fault 后 NVIC_SystemReset）。
|
||||
expect_reset_cause: ';' 分隔的原因子串白名单，只对**第一个**锚点生效（大小写不敏感）。
|
||||
空 = 只报告不判定。
|
||||
require_order: '>' 分隔的标记序列（2026-10-10），按**首次出现的行序**校验先后；
|
||||
顺序颠倒 = 某步在另一步之后补做（屏障失序 / 重试补跑）。空 = 不查。
|
||||
done_marker / max_boot_ms（2026-10-10）：量"第一行 → done_marker"的毫秒耗时
|
||||
（靠行首 `[+Nms]` 前缀）；超过 max_boot_ms 判 FAIL。
|
||||
日志无该前缀 → WARN 跳过，不假判。
|
||||
as_json: True = 不打印文本判定，最后输出一个 JSON 对象（退出码不变）。
|
||||
"""
|
||||
res = {"log_path": str(log_path), "lines": 0, "bytes": 0, "required_missing": [],
|
||||
"forbidden_hits": [], "boot": None, "suites_bad": [], "selftest": None,
|
||||
"order_bad": [], "timing": None, "tail": [], "verdict": None, "exit": None}
|
||||
emit = out
|
||||
|
||||
def finish(code):
|
||||
res["exit"] = code
|
||||
res["verdict"] = {0: "PASS", 1: "FAIL", 2: "ERROR"}[code]
|
||||
if as_json:
|
||||
emit(json.dumps(res, ensure_ascii=False, indent=2))
|
||||
return code
|
||||
|
||||
if as_json:
|
||||
out = lambda *a, **k: None # 文本判定静默，结果走 JSON
|
||||
|
||||
p = Path(log_path)
|
||||
if not p.is_file():
|
||||
out("VERIFY_ERROR: log file not found: {}".format(log_path))
|
||||
return finish(2)
|
||||
try:
|
||||
lines = _read_lines(log_path)
|
||||
except OSError:
|
||||
out("VERIFY_ERROR: cannot read log file: {}".format(log_path))
|
||||
return finish(2)
|
||||
|
||||
full = "\n".join(lines)
|
||||
req_list = _split_list(required)
|
||||
forb_list = _split_list(forbidden)
|
||||
summary_list = _split_list(suite_summary)
|
||||
|
||||
out("=== Log verdict: {} ===".format(log_path))
|
||||
out("Lines: {}, bytes: {}".format(len(lines), p.stat().st_size))
|
||||
res["lines"] = len(lines)
|
||||
res["bytes"] = p.stat().st_size
|
||||
|
||||
missing = []
|
||||
for m in req_list:
|
||||
if m in full:
|
||||
out("[OK] required marker found: {}".format(m))
|
||||
else:
|
||||
out("[MISS] required marker NOT found: {}".format(m))
|
||||
missing.append(m)
|
||||
res["required_missing"] = list(missing)
|
||||
|
||||
hits = []
|
||||
for f in forb_list:
|
||||
fl = f.lower()
|
||||
matched = [(i + 1, ln) for i, ln in enumerate(lines) if fl in ln.lower()]
|
||||
if matched:
|
||||
out("[HIT] forbidden pattern: {} ({} line(s))".format(f, len(matched)))
|
||||
# 命中行必须打出来（2026-10-10）：旧实现只报 "(3 line(s))"，人还得自己
|
||||
# 再 grep 一遍才知道是哪几行——而"哪几行"正是定位所需的那一步
|
||||
for ln_no, ln in matched[:HIT_LINES_MAX]:
|
||||
out(" L{}: {}".format(ln_no, ln.strip()[:200]))
|
||||
if len(matched) > HIT_LINES_MAX:
|
||||
out(" ... {} more".format(len(matched) - HIT_LINES_MAX))
|
||||
hits.append(f)
|
||||
res["forbidden_hits"].append({
|
||||
"pattern": f, "count": len(matched),
|
||||
"lines": [{"no": n, "text": t.strip()[:200]}
|
||||
for n, t in matched[:HIT_LINES_MAX]]})
|
||||
else:
|
||||
out("[OK] forbidden pattern absent: {}".format(f))
|
||||
|
||||
# 启动锚点计数（2026-10-10）：抓"跑完但中途复位过"和"采集没从复位开始"
|
||||
boot_issue = False
|
||||
if max_boot_count > 0:
|
||||
banner_lines = [ln for ln in lines if boot_marker in ln]
|
||||
n_boot = len(banner_lines)
|
||||
causes = [_reset_cause_of(ln, boot_marker) for ln in banner_lines]
|
||||
if n_boot == 0:
|
||||
out("[FAIL] no boot banner (marker '{}'): capture did not start at a reset".format(
|
||||
boot_marker))
|
||||
boot_issue = True
|
||||
elif n_boot > max_boot_count:
|
||||
out("[FAIL] boot banner x{} > allowed {} -> board reset itself during capture".format(
|
||||
n_boot, max_boot_count))
|
||||
for ln in banner_lines[:6]:
|
||||
out(" {}".format(ln.strip()))
|
||||
boot_issue = True
|
||||
else:
|
||||
out("[OK] boot banner x{} (marker '{}')".format(n_boot, boot_marker))
|
||||
if causes:
|
||||
out("[INFO] reset cause(s): {}".format("; ".join(causes)))
|
||||
exp = _split_list(expect_reset_cause)
|
||||
if exp:
|
||||
got = causes[0].lower()
|
||||
if any(e.lower() in got for e in exp):
|
||||
out("[OK] reset cause '{}' matches expected {}".format(
|
||||
causes[0], expect_reset_cause))
|
||||
else:
|
||||
out("[FAIL] reset cause '{}' not in expected: {}".format(
|
||||
causes[0], expect_reset_cause))
|
||||
boot_issue = True
|
||||
res["boot"] = {"marker": boot_marker, "count": n_boot, "allowed": max_boot_count,
|
||||
"causes": causes, "issue": boot_issue}
|
||||
|
||||
# 标记顺序（2026-10-10）：标记全中但**顺序颠倒** = 某步在另一步之后补做
|
||||
# （屏障失序 / 失败重试补跑）。旧实现只看子串存在性，这类失序完全看不见。
|
||||
order_issue = False
|
||||
if require_order:
|
||||
seq = [s.strip() for s in require_order.split(">") if s.strip()]
|
||||
pos = []
|
||||
for m in seq:
|
||||
idx = next((i for i, ln in enumerate(lines) if m in ln), -1)
|
||||
pos.append((m, idx))
|
||||
absent = [m for m, i in pos if i < 0]
|
||||
if absent:
|
||||
out("[FAIL] require-order: marker(s) not found: {}".format("; ".join(absent)))
|
||||
order_issue = True
|
||||
else:
|
||||
bad = [(pos[k][0], pos[k + 1][0]) for k in range(len(pos) - 1)
|
||||
if pos[k][1] > pos[k + 1][1]]
|
||||
if bad:
|
||||
out("[FAIL] marker order violated (expected {})".format(require_order))
|
||||
for a, b in bad:
|
||||
out(" '{}' first appeared AFTER '{}'".format(a, b))
|
||||
for m, i in pos:
|
||||
out(" L{}: {}".format(i + 1, m))
|
||||
order_issue = True
|
||||
else:
|
||||
out("[OK] marker order ok: {}".format(require_order))
|
||||
res["order_bad"] = [m for m, i in pos if i < 0] + [
|
||||
"{}>{}".format(a, b) for a, b in
|
||||
[(pos[k][0], pos[k + 1][0]) for k in range(len(pos) - 1) if pos[k][1] > pos[k + 1][1]]]
|
||||
|
||||
# 开机耗时（2026-10-10）：行首 [+Nms] = daemon 毫秒时基的相对偏移
|
||||
# （MCU 侧时间戳只有秒级，且开机头几行时钟还没起，量不出耗时）。
|
||||
timing = None
|
||||
timing_issue = False
|
||||
offs = []
|
||||
for i, ln in enumerate(lines):
|
||||
m = _TS_OFF_RE.match(ln)
|
||||
if m:
|
||||
offs.append((i, int(m.group(1))))
|
||||
if offs:
|
||||
timing = {"ts_lines": len(offs), "first_ms": offs[0][1], "last_ms": offs[-1][1],
|
||||
"span_ms": offs[-1][1] - offs[0][1]}
|
||||
out("[INFO] capture span: +{}ms .. +{}ms ({} timestamped line(s))".format(
|
||||
timing["first_ms"], timing["last_ms"], timing["ts_lines"]))
|
||||
if done_marker:
|
||||
di = next((i for i, ln in enumerate(lines) if done_marker in ln), -1)
|
||||
if di < 0:
|
||||
out("[WARN] done marker '{}' not found -> boot time not measured".format(
|
||||
done_marker))
|
||||
else:
|
||||
doff = next((off for i, off in offs if i >= di), None)
|
||||
if doff is None:
|
||||
out("[WARN] done marker line has no [+Nms] prefix -> not measured")
|
||||
else:
|
||||
boot_ms = doff - offs[0][1]
|
||||
timing["boot_ms"] = boot_ms
|
||||
timing["done_marker"] = done_marker
|
||||
out("[INFO] boot time to '{}': {} ms".format(done_marker, boot_ms))
|
||||
if max_boot_ms > 0 and boot_ms > max_boot_ms:
|
||||
out("[FAIL] boot time {} ms > limit {} ms".format(boot_ms, max_boot_ms))
|
||||
timing_issue = True
|
||||
elif done_marker or max_boot_ms > 0:
|
||||
out("[WARN] no [+Nms] line prefix in this log -> timing checks skipped "
|
||||
"(run_boot_test.py adds it; --raw-log turns it off)")
|
||||
res["timing"] = timing
|
||||
|
||||
# 套件汇总行解析（T-2）：抓"没跑到汇总行 / 断言数为 0"的盲区
|
||||
bad_summary = []
|
||||
if summary_list:
|
||||
parsed = {}
|
||||
for ln in lines:
|
||||
m = _SUMMARY_RE.search(ln)
|
||||
if m:
|
||||
parsed.setdefault(m.group("name").strip(), []).append(m)
|
||||
for name in summary_list:
|
||||
cands = parsed.get(name)
|
||||
if not cands:
|
||||
out("[MISS] suite summary NOT found: '=== {}: N/M PASSED (failed=0) ==='".format(name))
|
||||
bad_summary.append(name)
|
||||
continue
|
||||
ok = False
|
||||
for m in cands:
|
||||
passed = int(m.group("passed"))
|
||||
total = int(m.group("total"))
|
||||
failed = int(m.group("failed"))
|
||||
if failed != 0:
|
||||
out("[FAIL] suite summary reports failures: {} -> {}/{} PASSED (failed={})".format(
|
||||
name, passed, total, failed))
|
||||
continue
|
||||
if total == 0:
|
||||
out("[FAIL] suite summary total is 0 (no assertion ran): '{}'".format(name))
|
||||
continue
|
||||
if passed != total:
|
||||
out("[FAIL] suite summary inconsistent: {} -> {}/{} PASSED".format(
|
||||
name, passed, total))
|
||||
continue
|
||||
out("[OK] suite summary ok: {} -> {}/{} PASSED".format(name, passed, total))
|
||||
ok = True
|
||||
if not ok:
|
||||
bad_summary.append(name)
|
||||
res["suites_bad"] = list(bad_summary)
|
||||
|
||||
# 自检记录联合判定（S7）：/log/selftest.log 定长 64B 记录（格式见 App/log/sys_log.h），
|
||||
# 仅故障写盘：文件缺失 / 0 字节 = 无故障 → PASS；存在任何一条记录 → FAIL
|
||||
selftest_fail = False
|
||||
if selftest_pass:
|
||||
sp = Path(selftest_log) if selftest_log else None
|
||||
if sp is None or not sp.is_file() or sp.stat().st_size == 0:
|
||||
out("[OK] selftest: no fault record (file missing or empty)")
|
||||
res["selftest"] = {"path": str(sp) if sp else None, "faults": 0, "records": []}
|
||||
else:
|
||||
raw = sp.read_bytes()
|
||||
n = len(raw) // 64
|
||||
if len(raw) % 64:
|
||||
out("[WARN] selftest log has {} trailing incomplete bytes (ignored)".format(len(raw) % 64))
|
||||
recs = []
|
||||
for i in range(n):
|
||||
rec = raw[i * 64:(i + 1) * 64]
|
||||
ts = rec[0:19].decode("ascii", errors="replace")
|
||||
desc = rec[31:59].split(b"\0", 1)[0].decode("utf-8", errors="replace")
|
||||
recs.append({"no": i, "ts": ts, "desc": desc})
|
||||
res["selftest"] = {"path": str(sp), "faults": n, "records": recs}
|
||||
if n > 0:
|
||||
selftest_fail = True
|
||||
out("[FAIL] selftest: {} fault record(s) in {}".format(n, selftest_log))
|
||||
for r in recs:
|
||||
out(" #{}: {} {}".format(r["no"], r["ts"], r["desc"]))
|
||||
else:
|
||||
out("[OK] selftest: no fault record (0 complete records)")
|
||||
|
||||
if show_tail > 0 and lines:
|
||||
res["tail"] = lines[-show_tail:]
|
||||
out("")
|
||||
out("=== Last {} line(s) of log ===".format(show_tail))
|
||||
for ln in lines[-show_tail:]:
|
||||
out(ln)
|
||||
|
||||
out("")
|
||||
if (missing or hits or bad_summary or selftest_fail or boot_issue
|
||||
or order_issue or timing_issue):
|
||||
out("VERDICT: FAIL")
|
||||
return finish(1)
|
||||
out("VERDICT: PASS")
|
||||
return finish(0)
|
||||
|
||||
|
||||
def main(argv=None):
|
||||
# 控制台输出固定 UTF-8：Windows 代码页（GBK/UTF-8 终端）均不会让本脚本崩溃
|
||||
for stream in (sys.stdout, sys.stderr):
|
||||
try:
|
||||
stream.reconfigure(encoding="utf-8", errors="replace")
|
||||
except Exception:
|
||||
pass
|
||||
|
||||
ap = argparse.ArgumentParser(description="MCU debug log marker check (pure stdlib)")
|
||||
ap.add_argument("--log-path", required=True, help="boot log file to check")
|
||||
ap.add_argument("--required", default=REQUIRED_DEFAULT,
|
||||
help="required markers, ';' separated (case-sensitive)")
|
||||
ap.add_argument("--forbidden", default=FORBIDDEN_DEFAULT,
|
||||
help="forbidden patterns, ';' separated (case-insensitive)")
|
||||
ap.add_argument("--require-suite-summary", default="",
|
||||
help="suite names that MUST appear as '=== <name>: N/M PASSED (failed=0) ===' "
|
||||
"with N>0, ';' separated (T-2). Empty = off")
|
||||
ap.add_argument("--show-tail-lines", type=int, default=40,
|
||||
help="show last N log lines (0 = off)")
|
||||
ap.add_argument("--require-selftest-pass", action="store_true",
|
||||
help="judge /log/selftest.log local copy (S7): "
|
||||
"missing/empty = PASS, any 64B record = FAIL")
|
||||
ap.add_argument("--selftest-log", default="",
|
||||
help="local copy path of /log/selftest.log (with --require-selftest-pass)")
|
||||
ap.add_argument("--boot-marker", default=BOOT_MARKER_DEFAULT,
|
||||
help="per-boot banner substring (default '{}')".format(BOOT_MARKER_DEFAULT))
|
||||
ap.add_argument("--max-boot-count", type=int, default=0,
|
||||
help="fail if the boot banner appears 0 times or more than N times "
|
||||
"(0 = check off). run_boot_test.py passes 1 by default")
|
||||
ap.add_argument("--expect-reset-cause", default="",
|
||||
help="';'-separated substrings the FIRST reset cause must match "
|
||||
"(case-insensitive). Empty = report only, no verdict")
|
||||
ap.add_argument("--require-order", default="",
|
||||
help="'>'-separated markers that must appear in that line order "
|
||||
"(e.g. 'App init OK>Network Init>net init: OK'). Empty = off")
|
||||
ap.add_argument("--done-marker", default="",
|
||||
help="marker whose line marks boot completion, for --max-boot-ms")
|
||||
ap.add_argument("--max-boot-ms", type=int, default=0,
|
||||
help="fail if time from first line to --done-marker exceeds N ms "
|
||||
"(needs '[+Nms]' line prefix; 0 = off)")
|
||||
ap.add_argument("--json", action="store_true",
|
||||
help="emit one JSON object instead of the text verdict (exit code unchanged)")
|
||||
args = ap.parse_args(argv)
|
||||
|
||||
return verify(args.log_path, args.required, args.forbidden,
|
||||
args.show_tail_lines, suite_summary=args.require_suite_summary,
|
||||
selftest_pass=args.require_selftest_pass,
|
||||
selftest_log=args.selftest_log,
|
||||
boot_marker=args.boot_marker,
|
||||
max_boot_count=args.max_boot_count,
|
||||
expect_reset_cause=args.expect_reset_cause,
|
||||
require_order=args.require_order,
|
||||
done_marker=args.done_marker,
|
||||
max_boot_ms=args.max_boot_ms,
|
||||
as_json=args.json)
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
sys.exit(main())
|
||||
@@ -0,0 +1 @@
|
||||
__pycache__/
|
||||
@@ -0,0 +1,52 @@
|
||||
---
|
||||
name: stlink-flash
|
||||
description: ST-LINK 命令行烧录/复位/回读校验（自带独立脚本 stlink_flash.py，纯标准库，拷到任何 ST-Link+STM32 项目即用）：-P 烧录+复位运行 / -CmpFile 全片回读比对 / 只复位。封装"烧后必须 -Rst -Run + 回读校验"的铁律与 -CmpFile 复位目标等实测陷阱。
|
||||
whenToUse: 需要向 STM32 目标烧录 .hex/.bin、只复位重启目标、校验芯片内容与刚构建镜像是否一致、或排查"反复重下载芯片仍是旧镜像"类烧录假成功时。
|
||||
---
|
||||
|
||||
# stlink-flash — ST-LINK 烧录/复位/回读（独立可运行 skill）
|
||||
|
||||
**执行体 = 本 skill 自带脚本** `.dsh/skills/stlink-flash/scripts/stlink_flash.py`
|
||||
（纯标准库；拷整个 skill 目录到别的 ST-Link 项目即可用，不依赖仓库脚本）。
|
||||
|
||||
```powershell
|
||||
# cwd = 项目根目录
|
||||
& $PY ".dsh\skills\stlink-flash\scripts\stlink_flash.py" list
|
||||
& $PY ".dsh\skills\stlink-flash\scripts\stlink_flash.py" flash [hex] # 烧录 + -Rst -Run
|
||||
& $PY ".dsh\skills\stlink-flash\scripts\stlink_flash.py" cmp [hex] # 回读比对（会复位目标）
|
||||
& $PY ".dsh\skills\stlink-flash\scripts\stlink_flash.py" reset # 只复位运行
|
||||
```
|
||||
|
||||
镜像缺省取项目档案 `hex`；ST-LINK_CLI 解析：`--cli` > 档案 `stlink_cli` >
|
||||
`$DSH_STLINK_CLI` > `$DTU_STLINK_CLI` > PATH（**显式设了但无效 = 立即报错，不回退**）。
|
||||
退出码：`0`=OK / `1`=探针或目标错误 / `2`=CLI 未找到 / `3`=用法。
|
||||
成功判据内置：flash = rc0 + `Programming Complete`；cmp = 行首 `No difference found`
|
||||
（输出原样透传，serial-boot-test 的 `readback_ok` 默认值直接可用）。
|
||||
|
||||
## 本仓库
|
||||
|
||||
仓库原生入口 `MDK-ARM\reset.bat`（flash/cmp/halt/run/list 子命令）与本 skill 脚本
|
||||
语义一致，两者任选。环境变量 `DTU_STLINK_CLI`（未设回退 PATH；设了但无效 = 报错 exit 2）。
|
||||
|
||||
## 铁律与陷阱（实测教训）
|
||||
|
||||
- **烧录必须带 `-Rst -Run`，不可省略**：裸 `-P` 会报 `Programming Complete`，但目标核
|
||||
处于死循环/异常状态时写入并不落地（芯片内容不变）——"反复重下载、芯片一直是旧镜像、
|
||||
二分法失效"的根因。上层若做自动闭环，固件里加编译期身份戳（`fw build: __DATE__
|
||||
__TIME__`）才能把这种假成功揪出来（serial-boot-test 的 `fw_marker` 机制）。
|
||||
- **烧录后必须回读校验**：`-CmpFile` 全片逐字节比对，`No difference found` 才算真写入；
|
||||
不一致 = 本次运行作废。
|
||||
- **`-CmpFile` 连接时会复位目标**：板子当场重打一遍开机日志——在自动闭环里必须排在
|
||||
**串口日志采集之后**，否则开机日志被截断、启动锚点计数误判成"中途复位"。
|
||||
- **只重启不烧录**用无参 `-Rst -Run`；nRST 未接线的台架（3 线 SWD）这是唯一复位手段，
|
||||
`-HardRst`/`RM=` 在部分 CLI 版本（v3.5.0 实测）不可用。
|
||||
- 探针在位先 `list`；`Programming Complete` 但行为像旧固件 → 先怀疑缺 `-Rst -Run`，
|
||||
再怀疑 hex 没重编（对比 hex 时间戳）。
|
||||
- 完整复位语义/故障排查（本仓库）：`docs/测试说明/ST-LINK_CLI_复位使用说明.md`。
|
||||
|
||||
## 与其它 skill 的衔接
|
||||
|
||||
- 编译 = `keil-build` skill（先 0 错 0 警再烧）。
|
||||
- `serial-boot-test` 档案里 `flash_cmd` = 本 skill 入口（如
|
||||
`"MDK-ARM\\reset.bat flash"`）、`readback_cmd` = `"MDK-ARM\\reset.bat cmp {hex}"`、
|
||||
`readback_ok` = `no difference found`——闭环脚本已保证"回读排在采集之后"。
|
||||
@@ -0,0 +1,184 @@
|
||||
#!/usr/bin/env python3
|
||||
# -*- coding: utf-8 -*-
|
||||
"""stlink_flash.py - ST-LINK 命令行烧录/复位/回读校验（纯标准库，可移植 skill 版）。
|
||||
|
||||
用法（**项目根目录**下运行，任意 python3）:
|
||||
python <skill>/scripts/stlink_flash.py list
|
||||
python <skill>/scripts/stlink_flash.py flash [镜像.hex|.bin] # 烧录 + -Rst -Run
|
||||
python <skill>/scripts/stlink_flash.py cmp [镜像.hex|.bin] [--base 0x08000000]
|
||||
python <skill>/scripts/stlink_flash.py reset # 只复位运行
|
||||
python <skill>/scripts/stlink_flash.py halt | run
|
||||
|
||||
镜像缺省取项目档案 "hex"（解析顺序同下）。
|
||||
ST-LINK_CLI 解析（命令行 > 档案 > 环境 > PATH）:
|
||||
--cli > 档案 "stlink_cli" > $DSH_STLINK_CLI > $DTU_STLINK_CLI > PATH
|
||||
（环境变量**显式设了但路径无效 = 立即报错，不静默回退**）
|
||||
|
||||
铁律（实测教训，脚本已内置）:
|
||||
- 烧录必带 -Rst -Run：裸 -P 在目标核死循环时报 Complete 但内容不落地
|
||||
- flash 成功判据 = rc==0 且输出含 "Programming Complete"
|
||||
- cmp 成功判据 = 某行以 "No difference found" 开头（原样透传 CLI 输出，
|
||||
上层 run_boot_test 的 readback_ok 默认值直接可用）
|
||||
- cmp 连接时会**复位目标**（板子重打开机日志）→ 自动闭环里必须排在日志采集之后
|
||||
|
||||
退出码: 0=OK 1=探针/目标错误 2=CLI 未找到/无效 3=用法错误
|
||||
"""
|
||||
|
||||
import argparse
|
||||
import json
|
||||
import os
|
||||
import shutil
|
||||
import subprocess
|
||||
import sys
|
||||
import time
|
||||
from pathlib import Path
|
||||
|
||||
|
||||
def find_config_file():
|
||||
env = os.environ.get("DSH_SERIAL_CONFIG")
|
||||
if env:
|
||||
return Path(env)
|
||||
cwd = Path.cwd()
|
||||
candidates = [cwd / ".serialtest" / "config.json",
|
||||
cwd / ".opencode" / "serial_config.json"]
|
||||
for c in candidates:
|
||||
if c.is_file():
|
||||
return c
|
||||
return candidates[0]
|
||||
|
||||
|
||||
def load_config():
|
||||
f = find_config_file()
|
||||
if not f.is_file():
|
||||
return {}, ""
|
||||
try:
|
||||
raw = json.loads(f.read_text(encoding="utf-8-sig"))
|
||||
except (OSError, ValueError) as e:
|
||||
return {}, "cannot parse {}: {}".format(f, e)
|
||||
if not isinstance(raw, dict):
|
||||
return {}, "config root is not an object: {}".format(f)
|
||||
return raw, ""
|
||||
|
||||
|
||||
def find_cli(cli_arg, cfg):
|
||||
for label, val in (("--cli", cli_arg),
|
||||
("config 'stlink_cli'", cfg.get("stlink_cli")),
|
||||
("$DSH_STLINK_CLI", os.environ.get("DSH_STLINK_CLI")),
|
||||
("$DTU_STLINK_CLI", os.environ.get("DTU_STLINK_CLI"))):
|
||||
if val:
|
||||
if Path(val).is_file():
|
||||
return Path(val), label
|
||||
raise SystemExit("ENV_ERROR: {} is set but not a file: {} "
|
||||
"(fix the value; no silent fallback)".format(label, val))
|
||||
w = shutil.which("ST-LINK_CLI.exe") or shutil.which("ST-LINK_CLI")
|
||||
if w:
|
||||
return Path(w), "PATH"
|
||||
raise SystemExit("ENV_ERROR: ST-LINK_CLI.exe not found "
|
||||
"(--cli / config 'stlink_cli' / $DSH_STLINK_CLI / $DTU_STLINK_CLI / PATH)")
|
||||
|
||||
|
||||
def run_cli(cli, args, timeout):
|
||||
t0 = time.monotonic()
|
||||
try:
|
||||
proc = subprocess.run([str(cli)] + args, capture_output=True, timeout=timeout)
|
||||
rc = proc.returncode
|
||||
raw = (proc.stdout or b"") + (proc.stderr or b"")
|
||||
except subprocess.TimeoutExpired as e:
|
||||
rc = -1
|
||||
raw = (e.stdout or b"") + (e.stderr or b"")
|
||||
text = raw.decode("utf-8", errors="replace")
|
||||
for line in text.strip().splitlines():
|
||||
print(line)
|
||||
print("RC: {} elapsed_ms={}".format(rc, int((time.monotonic() - t0) * 1000)))
|
||||
return rc, text
|
||||
|
||||
|
||||
def main(argv=None):
|
||||
for stream in (sys.stdout, sys.stderr):
|
||||
try:
|
||||
stream.reconfigure(encoding="utf-8", errors="replace")
|
||||
except Exception:
|
||||
pass
|
||||
|
||||
ap = argparse.ArgumentParser(description="ST-LINK CLI flash/reset/readback (pure stdlib)")
|
||||
ap.add_argument("command", choices=["list", "flash", "cmp", "reset", "halt", "run"])
|
||||
ap.add_argument("image", nargs="?", default=None,
|
||||
help="image file (.hex/.bin; default: config 'hex')")
|
||||
ap.add_argument("--cli", default=None, help="ST-LINK_CLI.exe path")
|
||||
ap.add_argument("--base", default="0x08000000", help="cmp base address")
|
||||
ap.add_argument("--timeout", type=int, default=None,
|
||||
help="subprocess timeout (default: flash 300 / cmp 180 / other 60)")
|
||||
args = ap.parse_args(argv)
|
||||
|
||||
cfg, err = load_config()
|
||||
if err:
|
||||
print("ENV_ERROR: {}".format(err))
|
||||
return 3
|
||||
|
||||
cli, src = find_cli(args.cli, cfg)
|
||||
print("CLI: {} ({})".format(cli, src))
|
||||
|
||||
if args.command in ("list", "reset", "halt", "run"):
|
||||
if args.image:
|
||||
print("NOTE: image argument ignored for '{}'".format(args.command))
|
||||
timeout = args.timeout or 60
|
||||
if args.command == "list":
|
||||
rc, _ = run_cli(cli, ["-List"], timeout)
|
||||
print("STLINK_RC={}".format(rc))
|
||||
return 0 if rc == 0 else 1
|
||||
if args.command == "reset":
|
||||
rc, _ = run_cli(cli, ["-c", "SWD", "-Rst", "-Run", "-Q"], timeout)
|
||||
print("STLINK_RC={}".format(rc))
|
||||
return 0 if rc == 0 else 1
|
||||
if args.command == "halt":
|
||||
rc, _ = run_cli(cli, ["-c", "SWD", "-Rst", "-Halt"], timeout)
|
||||
print("STLINK_RC={}".format(rc))
|
||||
return 0 if rc == 0 else 1
|
||||
rc, _ = run_cli(cli, ["-c", "SWD", "-Run"], timeout)
|
||||
print("STLINK_RC={}".format(rc))
|
||||
return 0 if rc == 0 else 1
|
||||
|
||||
# flash / cmp 需要镜像
|
||||
img = args.image or cfg.get("hex") or ""
|
||||
if not img:
|
||||
print("STLINK_ERROR: no image given and no config 'hex'")
|
||||
return 3
|
||||
img = Path(img)
|
||||
if not img.is_file():
|
||||
print("STLINK_ERROR: image not found: {}".format(img))
|
||||
return 3
|
||||
|
||||
if args.command == "flash":
|
||||
print("FLASH: {} then reset and run".format(img))
|
||||
rc, text = run_cli(cli, ["-c", "SWD", "-P", str(img), "-Rst", "-Run", "-Q"],
|
||||
args.timeout or 300)
|
||||
if rc == 0 and "programming complete" in text.lower():
|
||||
print("FLASH: OK")
|
||||
print("STLINK_RC=0")
|
||||
return 0
|
||||
if rc == 0:
|
||||
print("STLINK_ERROR: rc=0 but no 'Programming Complete' in output "
|
||||
"(treat as failure - possible forwarded/hung run)")
|
||||
print("STLINK_RC=1")
|
||||
return 1
|
||||
print("STLINK_RC=1")
|
||||
return 1
|
||||
|
||||
# cmp：原样透传输出（"No difference found" 独占行首 = 成功判据）
|
||||
print("CMP: {} vs device flash @ {} (NOTE: connecting resets the target)".format(
|
||||
img, args.base))
|
||||
rc, text = run_cli(cli, ["-c", "SWD", "-CmpFile", str(img), args.base],
|
||||
args.timeout or 180)
|
||||
ok = any(ln.strip().lower().startswith("no difference found")
|
||||
for ln in text.splitlines())
|
||||
if ok:
|
||||
print("CMP: OK (No difference found)")
|
||||
print("STLINK_RC=0")
|
||||
return 0
|
||||
print("STLINK_ERROR: readback mismatch or compare failed")
|
||||
print("STLINK_RC=1")
|
||||
return 1
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
sys.exit(main())
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
name: ui-verify
|
||||
description: UI 改动后的回归验证：5 步门禁（模拟器构建、菜单像素回归、内容页黄金参考、Keil 构建、代码规范）。
|
||||
whenToUse: Drivers/BSP/UI、字体 ui_font_cn_12.c / ui_cn_chars.txt、菜单/内容页被修改之后，或用户要求"验证 UI / 跑 UI 回归 / UI 改动检查"时。
|
||||
---
|
||||
|
||||
# UI 回归验证
|
||||
|
||||
UI 相关改动完成后必须跑完 5 个门禁再提交。完整说明见 `docs/UI设计/UI_自动化测试流程.md`。
|
||||
|
||||
## 步骤（仓库根目录执行，python 一律用 .venv）
|
||||
|
||||
```powershell
|
||||
cmake --build simulator/build --config Debug # 0) 构建模拟器（须 0 警告）
|
||||
.venv\Scripts\python.exe simulator/tests/check_menu_rows.py # 1) 菜单 8 状态像素回归 + 池基线门禁
|
||||
.venv\Scripts\python.exe simulator/tests/check_content_pages.py # 2) 内容页黄金参考回归 + 往返池门禁
|
||||
& "MDK-ARM\build.bat" # 3) Keil 构建（BUILD_OK，0 错 0 警）
|
||||
.venv\Scripts\python.exe scripts/check_coding_standard.py # 4) 代码规范检查（PASS）
|
||||
```
|
||||
|
||||
退出码：0=PASS / 1=断言失败 / 2=环境错误（exe 缺失等，先按 AGENTS.md 重建对应环境再重跑）。
|
||||
|
||||
## 失败处置决策
|
||||
|
||||
| 现象 | 判定 | 处置 |
|
||||
|---|---|---|
|
||||
| 内容页 FAIL，且**有意**改了该页视觉 | 预期变化 | 先肉眼确认新效果正确（窗口模式或 `i1_to_png.py` 出图对照 mockup），再 `.venv\Scripts\python.exe simulator/tests/check_content_pages.py --update` 刷参考，`git diff` 检查 ref/ 变化后随代码提交 |
|
||||
| 内容页 FAIL，但**未**有意改视觉 | bug（缺字/几何漂移/样式回归） | 修代码；**禁止**刷参考掩盖 |
|
||||
| 池水位门禁失败但像素一致 | 结构/样式变更（常量样式转换、增删框体等） | 确认新值合理（残留分解见 `菜单页面设计.md` §9.5）→ 更新脚本常量 + 在流程文档变更记录登记 |
|
||||
| 菜单回归失败 | 结构断言（白带占比/边框/往返一致） | 按脚本打印的未过断言清单逐项修代码，无参考文件可刷 |
|
||||
|
||||
## 池水位门禁常量（在脚本头部）
|
||||
|
||||
| 常量 | 脚本 | 当前值 | 含义 |
|
||||
|---|---|---|---|
|
||||
| `MENU_POOL_BASELINE` | check_menu_rows.py | 4784 B | 菜单根框建完的 LVGL 池 used（x64 模拟器） |
|
||||
| `POOL_AFTER_ROUNDTRIP` | check_content_pages.py | 4864 B | 开页-关页往返后 = 基线 + 80 B 一次性残留 |
|
||||
|
||||
**禁止为过门禁盲目改常量**——无法解释的漂移 = 内存回归 bug。
|
||||
|
||||
## 关联注意
|
||||
|
||||
- `.venv` 缺失/换机：`& <本机任一 python ≥3.10> -m venv .venv; & '.venv\Scripts\python.exe' -m pip install -r requirements.txt`（`requirements.txt` 已含 `pre-commit`，重建后 L0 门禁直接可跑）
|
||||
- 新增 UI `.c` 文件先走 `new-source-file` skill 双端注册，否则一端静默缺文件
|
||||
- 字体重生成后全页大面积像素差异属预期：确认字形正确后 `--update` 刷参考
|
||||
- 涉及新界面/大改时本 skill 是 P3 门禁，完整管线（P0~P5）见 `docs/UI设计/UI_界面制作流程.md`
|
||||
Reference in New Issue
Block a user