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」状态词。冻结历史证据(带日期戳的台架日志)与
编号别名登记表里的旧路径按原样保留。
This commit is contained in:
2026-11-18 12:46:03 +08:00
parent b584601174
commit 685a366890
70 changed files with 415 additions and 224 deletions
+121
View File
@@ -0,0 +1,121 @@
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""E12:CH395F SPI 缓存区 TSL 时序 A/B 的字节级校验工作负载。
背景(E12):手册 §7.4 规定读写收发缓存区命令需在"长度与数据之间"留
TSL(读 0.4us / 写 0.2us)。本仓 ch395f_write_send_buf / ch395f_read_recv_buf
把命令头与数据打包进**同一 DMA 突发**(零间隔)。本脚本用 SHA-256 逐轮校验
"上传→回读"是否字节一致,为 A/B 提供灵敏判据:
- STOR(PC→设备)走设备 read_recv_buf(TSL 读 0.4us)
- RETR(设备→PC)走设备 write_send_buf(TSL 写 0.2us)
任一方向出现比特错位都会让 SHA 不匹配。
用法:
python ftp_integrity_test.py --rounds 20 --size 65536
python ftp_integrity_test.py --rounds 20 --size 65536 --tag A # 结果标记
判据:全部轮次 SHA-256 一致 = PASS;出现不一致则打印首个差异偏移,
并自动二次回读以区分"存储副本错(写路径/上传)"与"回读瞬时错(读路径)"。
"""
import os
import argparse
import hashlib
import io
import random
import sys
import time
from ftplib import FTP, error_perm
# 台架连接默认值单一真源已随域归档到 test/host/bench/bench_defaults.py:
# Python 的 sys.path[0] 是**脚本自身所在目录**,本脚本在 bench/<域>/ 下直接
# `import bench_defaults` 会 ModuleNotFoundError —— 先把 bench/ 补进 sys.path。
_BENCH_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
if _BENCH_DIR not in sys.path:
sys.path.insert(0, _BENCH_DIR)
import bench_defaults # noqa: E402 (台架连接默认值单一真源)
NAME = "e12a.bin" # 8.3 短名(FatFs FF_USE_LFN=0)
def sha(b: bytes) -> str:
return hashlib.sha256(b).hexdigest()
def first_diff(a: bytes, b: bytes):
n = min(len(a), len(b))
for i in range(n):
if a[i] != b[i]:
return i, a[i], b[i]
if len(a) != len(b):
return n, None, None
return None
def main() -> int:
ap = argparse.ArgumentParser()
ap.add_argument("--host", default=bench_defaults.DEVICE_IP)
ap.add_argument("--port", type=int, default=21)
ap.add_argument("--user", default="admin")
ap.add_argument("--pwd", default="admin")
ap.add_argument("--rounds", type=int, default=20)
ap.add_argument("--size", type=int, default=65536, help="每轮载荷字节数")
ap.add_argument("--seed", type=int, default=20261013)
ap.add_argument("--tag", default="", help="结果标记(A/B 分组)")
args = ap.parse_args()
rng = random.Random(args.seed)
ftp = FTP()
ftp.connect(args.host, args.port, timeout=20)
ftp.login(args.user, args.pwd)
ftp.set_pasv(True)
print(f"[E12{args.tag}] 已登录 {args.host}:{args.port} "
f"rounds={args.rounds} size={args.size}B", flush=True)
bad = 0
t_all = time.time()
for i in range(1, args.rounds + 1):
payload = rng.randbytes(args.size)
want = sha(payload)
t0 = time.time()
ftp.storbinary(f"STOR {NAME}", io.BytesIO(payload))
got = bytearray()
ftp.retrbinary(f"RETR {NAME}", got.extend)
got = bytes(got)
dt = time.time() - t0
if got == payload:
print(f" round {i:2d}/{args.rounds} OK "
f"size={len(got)}B sha={want[:16]} {dt:.2f}s "
f"({args.size / 1024 / max(dt, 1e-3):.0f} KB/s)", flush=True)
continue
bad += 1
fd = first_diff(got, payload)
print(f" round {i:2d}/{args.rounds} MISMATCH len={len(got)} want={len(payload)} "
f"first_diff={fd}", flush=True)
# 归因:二次回读
got2 = bytearray()
try:
ftp.retrbinary(f"RETR {NAME}", got2.extend)
got2 = bytes(got2)
if got2 == payload:
print(" → 二次回读一致:判为回读瞬时错(read 路径)", flush=True)
else:
print(f" → 二次回读仍不一致(sha2={sha(got2)[:16]}):"
f"判为存储副本错(write/上传路径)", flush=True)
except error_perm as e:
print(f" → 二次回读失败:{e}", flush=True)
ftp.quit() if False else ftp.close()
total = time.time() - t_all
print(f"[E12{args.tag}] 汇总:{args.rounds - bad}/{args.rounds} 轮字节一致"
f"({bad} 轮不一致),总耗时 {total:.1f}s", flush=True)
return 1 if bad else 0
if __name__ == "__main__":
sys.exit(main())