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」状态词。冻结历史证据(带日期戳的台架日志)与 编号别名登记表里的旧路径按原样保留。
test/host/bench/ — 台架驱动与探针
一次性台架动作(连板 / 连模拟器 / 连 PC 对端)都住在这里;纯逻辑的主机侧单测在
test/host/<模块>/run_unit_test.py,不在本目录。目录分工的总表见../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 或调用方的工作目录。