Files
STM32F4-Base/test
wandering1 95beaab313 refactor(编号): 第一批清号——登记簿旧号/阶段号/台架阶段裸形三族清零,位号目录排除
按 §9 批次一执行。**这批的关键发现是「看着像 62 处编号,实际能算编号的只有一小半」**,所以先分类再动手,
没有按站点数硬清:

· **真·编号(已改名)**:`N-6`(`MDK-ARM/tcp_reconnect_probe.py` 的「TRAP-NET-17 / N-6
」→ 只留 TRAP 锚点
  + 中文说明);台架阶段裸形 `T0`~`T3` 全部转成场景名——`e11_keepalive_probe.py` 的「静默对端 / 正常空闲存活」、
  `ftp_auth_bench.py` 的「匿名登录 / 未登录直接 NLST / 错口令锁定」、`serial_tool.py` 自检里的「行拆分 /
  解码回退链 / 时间戳行格式 / 端口建议」、`net_test_task.c` 与 `CH395F_Test_Guide.md` 的「空闲存活场景」、
  网络自愈设计里的「三路审计」。另把 `test/host/iec104_master.py` 的变量 `T0` 改成 `t_start`(那是起始时刻
  变量,被裸形族误抓)。
· **不是编号、但被误判(按 §4.4 处理,不改语料)**:`tools/netlist_semantics/` 里的 `T1` 是**网络变压
器位号**
  (硬件知识库),整目录进 `excluded_paths`,与 `docs/硬件平台/` 同口径;`BSD_Socket_API_函数调用关系.
md` 的
  `T1/T2/T3` 是 **Mermaid 节点名**,已改成语义节点(`RetryTick`/`PendTick`/`PendShimTic
k`/`ReconcileTick`)——
  图本身没变,只是节点不再叫字母号;`docs/门禁说明/gitlint.md` 里的 `T2` 是 **gitlint 自己的规则名**(不是本仓
  的号),已改写成规则描述;`docs/算法/傅氏算法详解.md` 的 `N-1` 是**数学记号**(求和上界 `x(N-1)`),保留不动,
  并在 §4.4 登记为「唯一已知误判」。
· **规范自身两处示例**顺手去掉字面量:`S3 / TM-PHY-01 / DP-03` → `S3 / TM-… / DP-…`;「报告 N-
16」→「报告 +
  登记簿旧号」。

结果(用门禁接口复测):`TM` 族 0 引用、`T-TEST` 族只剩规范自身 2 处示例、`N` 族只剩数学记号 1 处;
`F-*`(38 站点 / 12 个号,代码注释里的网络设计条目号)**留下批单独做**,因为每处要读懂语义、不能替换字面量。

口径变更已写进 §4.4:位号目录 `tools/netlist_semantics/` 进排除面;`N-1` 声明为已知误判。歧义面收窄后,
新错误级仍为 0、`id-check --strict` exit 0。

⚠ 这批**刻意没有复活「别名表洗白」那条路**:`N-6` 这类死号不进 `id_aliases.json`,让门禁继续咬将来的残留
引用(与 FTP 死号同一处理,见 §5.7)。
2026-10-27 07:39:00 +08:00
..

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 溢出)

相关文档

  • docs/测试说明/测试开发标准流程.md — L0~L3 分层与门禁决策表
  • docs/测试说明/自动化测试流程.md — @test 细节与失败模式
  • 各模块测试指南:docs/测试说明/*_Test_Guide.md
  • docs/测试说明/链路延迟测试说明.md