Files
STM32F4-Base/test
wandering1 d8d8fbe081 test(iec104): 补回 104 适配层与服务层的主机单测,覆盖率门禁转绿
90cc9a7d 把旧自研协议层(iec104_asdu/iec104_link/iec104_pts)整体退役
时,连带删掉了 test/host/iec104 与 test/host/iec104_serv 两套单测,却
没给留下来的代码补替代测试,也没同步覆盖率基线。结果 test-coverage
门禁(manual 阶段、远端 CI 强制)一直是红的:

  [REGRESS] 总计: 已覆盖行 8848 -> 8052
  [REGRESS] App/task/iec104_serv.c 基线里在测,本次未出现在任何单测编译
            单元里
  [REGRESS] 模块 iec104 / iec104_serv: 基线里有,本次未跑到

两个模块里约 180 行现役代码一行主机单测都没有:104 的 [comm] 段存取
(iec104_comm.c)与现役服务层(iec104_serv.c)。本笔把它们补回来。

新增:
  test/host/iec104_comm/   50 用例,iec104_comm.c 50/50 行
  test/host/iec104_serv/   50 用例,iec104_serv.c 102/102 行
两个套件都 #include 真实生产源(不是测桩),依赖全部走受控 stub。

同时修两个门禁自身的问题:

一、纯 Python 套件被误判为"缺 BUILD"
  iec104_dtu/run_unit_test.py 是独立 oracle/解码器测试,只有一个 unittest
  模块、不编任何 C 文件,天然没有 TestBuild。覆盖率脚本却把它当 FAIL,
  于是基线里被写进一条 ok:false —— 等于把已知失败烤进台账,下次谁跑都
  还是红。改成显式标记 COVERAGE_SKIP:有标记即记入 no_coverage_suites、
  不计入 modules/modules_total,控制台打 SKIP。没有标记又没有 BUILD 的
  运行器仍然 FAIL,严格性不放宽。
  刻意不用"目录里没有 .c 就跳过"这类启发式:那会把真丢了 BUILD 的 C 套件
  静默洗成绿灯,正是这道门禁要拦的东西。

二、该运行器缺 sys.path 引导
  它 from oracle import ... 但没把自己目录加进 sys.path。直接跑能过
  (sys.path[0] 是脚本目录),被 importlib 加载就 No module named
  'oracle' —— 覆盖率脚本走的正是后者。补上后两种加载方式都过。

基线在全绿状态重建:modules_total = modules_ok = 49,没有任何 ok:false
条目,iec104_dtu 移入 no_coverage_suites;连跑两次全量都 RC=0 且汇总行
逐字一致(8204/9185 行、622/679 函数,suites 49/49)。

测试有牙(源变异实测,每次改完按字节还原并校验 sha 一致):
  iec104_comm.c  CA 下限 < 改 <=  / PORT 上限 > 改 >=  / ca_set 不置脏
                -> 三条全部 KILLED
  iec104_serv.c  carry 饱和值减一 / 回绕判定 < 改 <=  / carry += 改 =
                -> 三条全部 KILLED
最后一条边界判据 `carry > SAT - now` 改 `>=` 经穷举 20 万组输入证明是
等价变异(两个分支返回值相同),没有假装能区分它,只在测试注释里写明。

顺带把 s_monotonic 的用例从 6 条扩到 10 条:补 now == last 不算回绕、
饱和后 carry 恰好等于 SAT、以及 carry + now == SAT-1 不被提前饱和。
只断言返回值不看内部状态时,前一版测试对两个真变异是无感的。

验证:pre-commit 9 Passed / 0 Failed;manual 阶段 test-coverage 与
iec104-tcp(13/13 真实 TCP 回环)均 Passed;新旧文件字节体检 BOM=False
CR=0 U+FFFD=0。
2026-11-18 15:18:15 +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 = 只编译不烧录(纯离机) 本文 §多套件回归

运行方式

# /serial-boot-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 则相反:只改宏 + /keil-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 — 测试验证分层与门禁决策表
  • docs/测试说明/流程与规范/自动化测试流程.md — /serial-boot-test 细节与失败模式
  • 各模块测试指南:docs/测试说明/板级测试/*_Test_Guide.md
  • docs/测试说明/专项验证/链路延迟测试说明.md