Files
STM32F4-Base/test/host/bench/README.md
T
wandering1 685a366890 refactor(test): 把 test/host 顶层 25 个台架脚本按域收进 bench/
原来 test/host 一层混了三类东西:51 个主机侧单测模块目录、25 个台架驱动
与探针、若干专用目录。台架脚本平铺在顶层,与单测目录并列,看不出哪个是
「连板跑一次的」,也看不出加新脚本该往哪放。

现在按被验对象分域归档,单测模块目录一律不动(22 根 pre-commit 钩子逐个
点名它们,50 个运行器按固定层数推仓库根):

- bench/bench_defaults.py 台架连接默认值单一真源
- bench/ftp/ (10) FTP 功能、速率、鉴权、中止、完整性、背靠背复现
- bench/net/ (9) CH395F socket、keepalive 判死、挂机、复连压力、PASV、
  UDP 队列、链路时延对端
- bench/iec104/ (2) 主站客户端与它的离线样帧自检
- bench/wave/ (1) 录波段文件 PC 侧解码
- bench/screenlink/ (2) 屏板链路顶替与拉帧压测

顶层条目 78 -> 53。逐脚本作用、运行前置与「加新脚本往哪放」写在新建的
test/host/bench/README.md;test/host/README.md 增目录地图表,把原平铺的
网络/FTP 两节压成指针。

配套修正(移动后不修就会坏):
- 17 个脚本加上 bench/ 到 sys.path 的 bootstrap(sys.path[0] 是脚本自身
  目录,不补就 import bench_defaults 失败)
- cal/cal_write.py 本来就坏的(只插 cal/ 到自己 sys.path,import
  bench_defaults 直接 ModuleNotFoundError),补两段路径后可用
- e6_soak 与 wave_read 用 dirname 固定层数推仓库根,多两层后分别指向
  test/test 与 test/ci-artifacts(后者静默写错目录、不报错),层数已改对
- scripts/board_ui_nav.py 与 MDK-ARM 两个探针的 bench_defaults 搜索路径

清理与标注:删掉 test/host/iec104/(旧自研协议层单测退役后只剩一个零引用
的 stub 桩头);文档里对 test/host/iec104 与 iec104_serv 的引用加上「已
删除/已不存在 2026-11-18」状态词。冻结历史证据(带日期戳的台架日志)与
编号别名登记表里的旧路径按原样保留。
2026-11-18 12:46:03 +08:00

36 lines
3.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# test/host/bench/ — 台架驱动与探针
> **一次性台架动作**(连板 / 连模拟器 / 连 PC 对端)都住在这里;纯逻辑的主机侧单测在
> `test/host/<模块>/run_unit_test.py`,不在本目录。目录分工的总表见
> [`../README.md`](../README.md) §目录地图。
## 域索引
| 域 | 目录 | 脚本 → 一句话作用 |
|---|---|---|
| 配置 | (本层) | `bench_defaults.py` → 台架连接默认值单一真源(设备 IP / 网关 / PC 对端 IP),**换台架只改这里** |
| FTP | `ftp/` | `ftp_test.py` → FTP 基本功能(连上 / LIST / STOR / RETR 冒烟);`ftp_up_dl_test.py` → 上传+下载往返;`ftp_speed_test.py` → 大文件传输速率;`ftp_capture.py` → 模拟 FTP Server 打印客户端每条命令(抓协议用);`ftp_regression.py` → 数据连接复用回归(D20:同会话第二个数据连接必失败);`ftp_abort_probe.py` → 中止场景探针(RST→450 / FIN→226,`--check-abort`);`ftp_integrity_test.py` → 上传后 SHA-256 多轮字节级校验(E12);`ftp_list_fill_test.py` → LIST 满块静默截断回归(目录一大多回 550);`ftp_auth_bench.py` → 鉴权矩阵(530/331/230/550、跨会话锁定);`n30_repro.py` → 背靠背 STOR 复现器(TRAP-NET-20 常备回归腿) |
| 网络 | `net/` | `ch395f_socket_test.py` → CH395F BSD Socket 全模式测试(回显 / 文件收发 / DHCP);`ch395f_reuse_host.py` → Socket 复用与中止形态的 PC 对端;`e11_keepalive_probe.py` → KeepAlive「链路在、对端静默」判死探针(E11);`e6_soak.py` → 24h 挂机驱动(常态 + 每小时/每 4h 注入 E1 压测);`relisten_stress.py` → 监听快速复连压力(E1/E5);`pasv_probe.py` → PASV 端口复用「风暴」签名探针(E8);`udp_queue_bench.py` → UDP 数据面队列化真机回归(板端阶段 16 的 PC 对端);`udp_queue_bench_loopback.py` → 上一支的离线回路自检(假板子,不需要真机);`latency_peer.py` → 链路时延测试的服务端驱动 PC 对端(M2) |
| IEC 104 | `iec104/` | `iec104_master.py` → 104 主站客户端(STARTDT / 总召 / C_SE 定值两段写 / YK / C_RD,含 `--b7-*` 保护定值跨复位持久化模式);`test_iec104_master_rx.py` → 上者的离线样帧自检(不需要台架) |
| 录波 | `wave/` | `wave_read.py` → 录波段文件 PC 侧解码(`dump`/`fft`/`shape`/`plot`,与 `App/algo/wave_store.c` 是两份独立实现) |
| 屏板链路 | `screenlink/` | `screenlink_bench.py` → 用 PC + USB 转 TTL 顶替屏板,按召唤节拍发帧 A;`remolcd_pull_test.py` → RemoDispBus(:7003) 拉整帧压力客户端 |
## 运行前置
- **从仓库根执行**(脚本按仓库根相对路径读写 `ci-artifacts/` 等),解释器用 `.venv`:
`& '.venv\Scripts\python.exe' test/host/bench/ftp/ftp_test.py --help`
- **台架地址只改一处**:设备 IP / 网关 / PC 对端 IP 全在 `bench_defaults.py`;下面的脚本
从**上两级目录**(`bench/`)把它补进 `sys.path` 后再 import,所以脚本自己放在哪个域子目录都不影响。
`test/host/cal/`、`scripts/board_ui_nav.py`、`MDK-ARM/*.py` 也依赖同一份真源,
挪 `bench_defaults.py` 时这几处的 `sys.path` 要一起改。
- **需要真机的脚本**在缺参数时会以 rc=2 退出(argparse 用法错误),这是「可用」而非失败;
只有 `ModuleNotFoundError` / `ImportError` / `SyntaxError` 才算坏。
- 输出约定:纯 ASCII stdout,可直接重定向归档为台架证据;退出码 `0` 全过 / `1` 有失败 /
`2` 用法或连接错误。
## 加新脚本往哪放
按**被验对象**选域子目录;跨域共用的连接默认值只往 `bench_defaults.py` 加。若新脚本要
`import bench_defaults`,照抄本目录任一脚本顶部那段 `_BENCH_DIR` 三行 `sys.path` bootstrap(注释写清为什么),
不要靠 `PYTHONPATH` 或调用方的工作目录。