Files

T

wandering1 f754d59218 docs(测试说明): 按用途分六个子目录并同步全库引用

分层：流程与规范/ 单元测试/ 板级测试/ 专项验证/ 测试工具/ 测试数据/，
顶层只留新增的目录导航 README.md（归层判据 + 硬约束 + 本次处置记录）。

- 搬迁 28 个路径：测试数据三个目录 58 个文件为纯改名（R100，内容逐字节不变）
- 全库引用同步 124 个文件：AGENTS / docs 索引 / skills / 门禁注释 / scripts
- 门禁面：scripts/check_test_traceability.py 的 glob 改 rglob
  （分层后不递归扫描＝追溯门禁直接瞎掉）
- scripts/rename_ref.py：收尾的 ℹ 提示在 GBK 代码页抛 UnicodeEncodeError，
  让进程以退出码 1 收场而改写其实已落盘（RC 与真实结果相反）；改为把
  stdout/stderr reconfigure 成 UTF-8，与 check_doc_links.py 等同法
- docs/文档规范.md §1.1 补「子目录文件过多时再分一层」；§3.6 补 rename_ref
  搬整目录的两个实测坑：① 会改写目录内部文件的内容 ② 内部文件的 ../ 出链
  不补层级（本次 23 个被误改的证据文件已按 HEAD 原始字节逐字节还原）
- docs/README.md §6 改为与六个子目录一一对应，并补登原先漏登记的
  「启动日志原子性复验流程」一行
- .cubemx_survival_baseline.json：App/util/task_watchdog.c 的注释路径也随分层更新，
  该文件是存活审计的 watchdog-module 漂移锚点，按脚本自己的提示跑 --write 重建基线
  （实测重建后仅 watchdog-module 一条哈希变化）
- 铁律 4 例外（本次在任务树里改了单写者文件）：AGENTS.md 与
  .pre-commit-config.yaml 只被 rename_ref 改写路径字面量（后者全在注释行），
  任务表块与钩子声明一字未动

验证：check_doc_links.py --sections-strict 覆盖全部 88 个改动 .md 全绿；
check_test_traceability.py 输出与主树逐行一致；196 个文本文件无 BOM、无新增
CR、无 U+FFFD、无行尾空白；陈旧引用面由主树 25 处降到 6 处（无新增断链）。

2026-10-30 07:16:07 +08:00

3.2 KiB

Raw Blame History

test/ — 测试代码与主机端脚本

测试分两部分，物理隔离在两个子目录：

board/ —— 板端测试套件（.c/.h，编入固件由 testTask 执行）

host/ —— 主机端脚本（.py，PC 侧驱动板子并判读结果）

目录结构

目录	内容	README
`board/`	板端测试套件（编入 Keil 工程，占 RAM）	`board/README.md`
`host/`	PC 端测试/判读脚本（Python）	`host/README.md`
`run_all_suites.py`	多套件回归编排（改宏 → 构建 → 烧录 → 采集，`try/finally` 保证还原开关）；`--check-build` = 只编译不烧录（纯离机）	本文 §多套件回归

运行方式

# @test 一键闭环（推荐）
& '.venv\Scripts\python.exe' .dsh/skills/serial-boot-test/scripts/run_boot_test.py

# 单独校验日志
& '.venv\Scripts\python.exe' .dsh/skills/serial-boot-test/scripts/verify_log.py <日志文件>

# 多套件回归编排（需真机；自动改开关 + 构建 + 烧录 + 采集，结束后还原）
& '.venv\Scripts\python.exe' test/run_all_suites.py
& '.venv\Scripts\python.exe' test/run_all_suites.py --suites STORAGE,GD5F
& '.venv\Scripts\python.exe' test/run_all_suites.py --dry-run      # 只看计划

# 只编译不烧录（不需要 MCU / 串口 / ST-LINK，验证 4 套件可编译性）
& '.venv\Scripts\python.exe' test/run_all_suites.py --check-build

退出码约定：0=PASS / 1=FAIL / 2=采集或烧录错误 / 3=用法或预检错误。

多套件回归（`run_all_suites.py`）

套件互斥（编译期 #error）意味着跑 4 个套件要手工循环 4 轮。本脚本把它编排成一条命令，并且无条件还原 test_config.h——跑完忘还原 = 测试固件进库，这是它存在的核心理由（与提交期门禁 test-suite-switch 互为独立防线）。

⚠️ 每轮要真机烧录 + 采集，4 套件约数分钟起；破坏性套件还会改设备持久状态。 仅回归窗口用，绝不挂 pre-commit。

--check-build 则相反：只改宏 + @build，不烧录不采集，无需任何硬件，用于防止 "测试套件长期编不过而无人知"（2026-08~09 CH395F 套件实例）。改动 test/board/ 下测试代码后建议先跑它——实测 4 套件均 BUILD_OK: 0 errors, 0 warnings。

⚠️ 注意

本目录被 pre-commit 门禁排除（测试代码不受 C 规范约束）
board/ 套件占用 RAM，启用前先核算预算（见 docs/内存管理/）
Keil 工程已同步：board/ 下 7 个 .c 编入 MDK-ARM/STM32F4-Demo.uvprojx， IncludePath 含 ../test/board；移动文件须同步改工程文件
套件选择开关：board/test_config.h 的 TEST_SUITE_*（互斥，一次只启用一个）
测试缓冲用分 Phase 复用静态缓冲（避免 L6406E 溢出）

3.2 KiB Raw Blame History Unescape Escape