Files
STM32F4-Base/test/board
wandering1 db9f256fd0 docs(收口): 批 1 台架记录与门禁/产物分家口径落档(道C 文案兑现)
- test/board/ch395f_test.h:f3 轮台架记录追加——VERDICT PASS,
  task stall 468→14(net 类 431→0,掩码复活实锤),余 13 条为
  netTask 自挂起前喂一次 vs 精确匹配判据的语义打架 + 1 条 uiTask
  瞬态 + 1 条设计内 P2 留痕;lead 裁决不放宽超集判定
- 主机单测覆盖率口径.md:中间产物路径 L80 与坑 12 重写为
  %TEMP%/dtu_host/<工作树哈希>/ 分家 + runs 独占(adabb6a 落地,
  旧固定共享名作废;判据正文指向 harness 顶部)
- 并行任务工作树方案.md §5 表:单测产物一行——不需要锁但必须
  按树分家(对照 build/bench 真独占)
- 门禁说明/cubemx-survival.md §6:新增第 7 条「基线漏项=静默不检」
  (net-msgq-adopt 实证,--write 后抽查新增条目)
- 门禁说明/id-check.md §5:拦下过真事追加——P1-10 注释裸编号被
  校验 6 拦(紧邻写法在 C 注释同样生效)
2026-10-25 06:12:02 +08:00
..

test/board/ — 板端测试套件

⚠️ 编入固件的测试代码(由 testTask 执行)。这些 .c 已注册到 Keil 工程 MDK-ARM/STM32F4-Demo.uvprojx,占用 MCU 的 RAM/Flash。

文件一览

文件 测试对象 / 作用
test_config.c/h 测试任务配置:TEST_SUITE_* 套件选择开关(互斥)+ ENABLE_DESTRUCTIVE_TESTS
test_common.h 公共断言内核:test_stats_t + TEST_CHECK_IMPL/TEST_REPORT_IMPL;各套件用一行宏绑定自身统计变量(T-4)
ch395f_test_task.c/h + ch395f_test.h CH395F 以太网(硬件层 Phase 15 / NET 层 Phase 611)
gd5f_test_task.c/h + gd5f_test.h GD5F2GQ5UE SPI NAND 存储
sd2506_test_task.c/h + sd2506_test.h SD2506 RTC
storage_test_task.c/h + storage_test.h 存储性能
net_test_task.c/h 网络层测试
net_latency_test.c/h 链路时延探针(DWT CYCCNT 时基,MCU 专属)

⚠️ 构建约束(AGENTS.md 详述)

  • 套件互斥:test_config.h 的 TEST_SUITE_CH395F/STORAGE/GD5F/RTC 一次只能启用一个 (违反则 #error);全部注释 = 产品构建
  • ⚠️ 测试固件不得静默提交:TEST_SUITE_* 开关受 pre-commit 钩子 test-suite-switch 门禁——默认要求全部注释。跑完套件回归务必改回产品构建再提交(2026-10-01 实测已提交 HEAD 里 TEST_SUITE_CH395F 就是开启状态,纯靠人记得改;故补此门禁)。确需提交测试构建时用 ALLOW_TEST_BUILD=1 git commit ... 或 python scripts/check_test_suite.py --allow-test-build 显式放行
  • 破坏性用例默认关闭:ENABLE_DESTRUCTIVE_TESTS(默认注释)控制写/擦 NAND、格式化、 坏块注入。关闭时为只读模式(横幅 mode: READ-ONLY),可随时在在用设备上跑
  • ⚠️ 实测一轮破坏性 GD5F 运行即让 dhara 多记一个坏块(容量下降且需全片擦除恢复)—— 只在产线首启或明确需要时打开
  • CH395F 套件:硬件层与 NET 层模式互斥
  • 总线独占:CH395F 硬件层模式下 netTask 自挂起,testTask 独占 CH395F

添加新测试套件

  1. 在 test_config.h 加开关(并入互斥 #error 检查)
  2. 新建 <模块>_test_task.c/h
  3. 注册进 Keil 工程(<FilePath>..\test\board\xxx.c</FilePath>)
  4. 跑回归:@test(.dsh/skills/serial-boot-test/scripts/run_boot_test.py)

相关文档

  • 测试指南:docs/测试说明/CH395F_Test_Guide.md、GD5F2GQ5UE_Test_Guide.md、SD2506_Test_Guide.md、FTP_Test_Guide.md
  • 套件配置:AGENTS.md「测试与验证」章
  • 容量恢复:docs/测试说明/存储维护与容量恢复.md