685a366890
原来 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」状态词。冻结历史证据(带日期戳的台架日志)与 编号别名登记表里的旧路径按原样保留。
36 lines
3.9 KiB
Markdown
36 lines
3.9 KiB
Markdown
# 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` 或调用方的工作目录。
|