# test/ — 测试代码与主机端脚本

> 测试分两部分：**板端测试套件**（`.c/.h`，编入固件由 testTask 执行）与
> **主机端脚本**（`.py`，PC 侧驱动板子并判读结果）。

## 板端测试套件（编入固件）

| 文件 | 测试对象 |
|---|---|
| `test_config.c/h` | 测试任务配置（启用哪些套件） |
| `ch395f_test_task.c/h` + `ch395f_test.h` | CH395F 以太网（硬件层 + NET 层） |
| `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` | 网络层 / 链路时延 |
| `nand_ftl_test.c`（如有） | FTL 层 |

## 主机端脚本（PC 侧）

| 脚本 | 作用 |
|---|---|
| `run_boot_test.py` | **`@test` 一键闭环**：开串口+清日志 → 烧录 → wait-idle → 校验（退出码 0=PASS） |
| `verify_log.py` | 日志标记校验（Required/Forbidden 标记） |
| `ch395f_socket_test.py` | Socket 通信测试 |
| `ftp_test.py` / `ftp_up_dl_test.py` / `ftp_speed_test.py` | FTP 功能 / 上传下载 / 速度 |
| `ftp_capture.py` / `ftp_regression.py` | FTP 抓包 / 回归 |
| `e02_probe.py` | E-02 专项探针 |
| `latency_peer.py` | 链路时延对端（PC peer） |
| `time_sync_server.py` | 时间同步推送服务 |

## 运行方式

```bash
# @test 一键闭环（推荐）
& '.venv\Scripts\python.exe' test/run_boot_test.py

# 单独校验日志
& '.venv\Scripts\python.exe' test/verify_log.py <日志文件>
```

退出码约定：`0`=PASS / `1`=FAIL / `2`=采集或烧录错误 / `3`=用法或预检错误。

## ⚠️ 注意

- 本目录**被 pre-commit 门禁排除**（测试代码不受 C 规范约束）
- 板端套件占用 RAM，启用前先核算预算（见 `docs/内存管理/`）
- 测试缓冲用**分 Phase 复用静态缓冲**（避免 `L6406E` 溢出）

## 相关文档

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