wandering1
f754d59218
分层：流程与规范/ 单元测试/ 板级测试/ 专项验证/ 测试工具/ 测试数据/， 顶层只留新增的目录导航 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 处（无新增断链）。
46 lines
2.7 KiB
Markdown
46 lines
2.7 KiB
Markdown
# 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`；各套件用一行宏绑定自身统计变量 |
|
||
| `ch395f_test_task.c/h` + `ch395f_test.h` | CH395F 以太网（硬件层 Phase 1~5 / NET 层 Phase 6~11） |
|
||
| `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`
|