Files
STM32F4-Base/test
wandering1 2d16fdddc0 fix(看门狗): 停喂判定按位分账——复合串窗不再误停喂(2026-10-25 大窗判读 F2)
道F task-23。动因 = 2026-10-25 台架大窗判读:9 条 stall 行里 16:24/16:28 两起为
复合判据误升级——旧逻辑喂狗前置 = 全必需位同窗跑过,任一窗缺任一位即断喂,
复合连续 8 窗申报 stall;UI 一窗缺、IEC104 下一窗缺、再下窗 FTP 缺这类互不相干
的亚秒抖动被串成 800ms 假停摆(mg=877/918,两事件中无任何任务达单任务容忍线)。
16:39 那起才是真 UI 单任务串(~1.2s,bit4 到 8 连击——受害者面修复 = F3 票)。

【改造】stall/停喂唯一判据 = 任一必需位自己的连续缺席窗数(s_miss_bits[] 分账,
+9B BSS):同一任务 8 窗(800ms)没跑过 → 申报 + 停喂 → IWDG 自然溢出
(IWDGRSTF 权威归因不变);所有位连击 <8 的缺席窗照常喂狗;位出现即该位清零,
掩码外位不入账(wd_required_mask 随构建变化自动跟随、不留旧账)。`MISS start`
保留为复合边沿诊断行(不再代表停喂,判读口径以设计说明 §6.1/§11.1 为准)。
代价:真停摆从挂死到复位总时长最坏 +约 0.7s(≈2.5s 最坏 / ≈3.3s 标称),V2
台架判据「声明 stall 后 ≤2.5s 复位」不受影响(申报时点未变,停喂起点即申报)。

【测试】test/host/watchdog 断言按新判据改写 5 处(004/005/006/008/013:缺席窗
照常喂),新增 TC-WATCHDOG-017(20 窗 UI/NET 交替缺席:零 stall + 20 窗持续喂——
旧复合判据必在第 8 窗误报,回归钉)与 TC-WATCHDOG-018(同位 8/9/10 连击必报停
+ 停喂;恢复窗喂、账本重启,第二段亚容忍串重新从零计)。47/47 全绿。

【文档】看门狗设计说明 §0/§2.2(停喂链加「v1.5 起字面成立」注)/§3.2/§5.3/
§6.1/§11.1/§11.6 大窗补记 + 变更记录;看门狗单元测试说明(用例表 + 47 断言 +
变更记录,顺带修正 TC-WATCHDOG-003 行 10-12 后未跟的 `0x37`→`0x1F7`)。

【越界申报】① docs/测试说明/看门狗单元测试说明.md——票面写域外,但该文档
§4 自要求「行为变更须同步改单测与本文」,执行性同步;② 根目录
.cubemx_survival_baseline.json——cubemx-survival 钩子对 task_watchdog.c(watchdog-
module 审计项 = 全文哈希基线)明示「有意改动请 --write 重建基线」,重建后
31 通过 / 0 失败。均非他人并行改动面。

【门禁】@build 0 错误 0 警告(Code=224768 RO=24640 RW=1328 ZI=135096)。
--all-files 43 绿;红仅 mem-numbers/mem-budget = 台账漂移(vs 2026-10-25 行:
Code +80B / ER_IROM1 249328→249408 / ZI +8B(s_miss_bits)/ IRAM1 约 +8B,待回填)。
id-check 增量拦截通过(首跑拦下变更记录里 TC-003/TC-004 裸形,已改全 ID)、
test-coverage 通过、cubemx-survival 通过。
gate: only mem-budget/mem-numbers pending lead ledger backfill

【台架】等你排窗两轮(各 ≥30min):单独 relisten_stress :7003 / 探针轮。判据按
v1.1 口径 = stall 行零为硬判据;预期本修复后 16:24/16:28 型复合误升级归零,
MISS start 仍会出现(诊断量);16:39 型 UI 真单串在 F3 落地前仍可能照报——
那属于「判据抓对了人」,请连同 mask 一起记给我。
2026-10-25 17:58:18 +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      # 只看计划

# 只编译不烧录(S6;不需要 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