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
+194
View File
@@ -0,0 +1,194 @@
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""E11:CH395F 服务器侧 KeepAlive —— "链路在、对端静默"判死验证(PC 侧注入)。
背景(E11):手册 §5.56 规定 TCP 服务器应在 SINT_STAT_CONNECT 后开启
KeepAlive;本仓该调用 2026-10-12 被撤回,全仓仅剩客户端分支启用,而
App/ 无任何 net_connect() → 产品上 keepalive 实际关闭。本脚本用于验证
"开启后能否在有界时间内判死静默对端,且不误杀正常空闲会话"。
用法:
# 场景「正常空闲存活」:连接后静默 hold 秒,末尾发 KEEPLIVE 验证会话仍在
python e11_keepalive_probe.py --mode idle --hold-s 90
# 场景「静默对端」:连接后立即装 Windows 防火墙入站 DROP(仅本连接本地端口 +
# 设备 IP)→ 芯片 keepalive 探测得不到 ACK → 期望设备在
# IDLE + INTVL×CNT 内判死(本仓 60 + 5x3 = 75s)
python e11_keepalive_probe.py --mode block --hold-s 120
判据(设备侧事件由串口日志核对,本脚本打印 PC 侧时间线):
期望:串口出现 `[ERR][NET] sockN TIMEOUT`(耗时≈75s),随后
`sockN pump/relisten` 恢复;本脚本移除规则后新连接必须成功。
期望:hold 期间**无** TIMEOUT;末尾 KEEPLIVE 必须收到 0xBB 回显。
需要管理员权限(仅 block 模式装/卸防火墙规则;脚本自行清理)。
"""
import os
import argparse
import socket
import subprocess
import sys
import time
# 台架连接默认值单一真源已随域归档到 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 (台架连接默认值单一真源)
TAG_C, TAG_D = 0xAA, 0xBB
CMD_KEEPLIVE = 0
RULE_NAME = "SELFHEAL-E11-DROP"
def _crc(data: bytes) -> int:
c = 0
for b in data:
c ^= b
return c
def build_frame(cmd: int, data: bytes = b"") -> bytes:
n = len(data)
return bytes([TAG_C, cmd, (n >> 8) & 0xFF, n & 0xFF]) + data + bytes([_crc(data)])
def recv_frame(sock: socket.socket, timeout: float = 3.0):
sock.settimeout(timeout)
hdr = b""
while len(hdr) < 4:
chunk = sock.recv(4 - len(hdr))
if not chunk:
return None
hdr += chunk
tag, cmd, n = hdr[0], hdr[1], (hdr[2] << 8) | hdr[3]
body = b""
while len(body) < n + 1:
chunk = sock.recv(n + 1 - len(body))
if not chunk:
return None
body += chunk
data, crcb = body[:n], body[n]
return cmd, data, (tag == TAG_D) and (crcb == _crc(data))
def firewall(action: str, local_port: int, remote_ip: str) -> bool:
verb = "add" if action == "add" else "delete"
cmd = ["netsh", "advfirewall", "firewall", verb, "rule",
f"name={RULE_NAME}", "dir=in", "action=block", "protocol=TCP",
f"localport={local_port}", f"remoteip={remote_ip}"]
if verb == "delete":
cmd = ["netsh", "advfirewall", "firewall", "delete", "rule",
f"name={RULE_NAME}"]
r = subprocess.run(cmd, capture_output=True, text=True)
if r.returncode != 0:
print(f"[WARN] 防火墙 {verb} 失败:{r.stdout.strip()} {r.stderr.strip()}")
return False
return True
def connect(host: str, port: int, timeout: float = 5.0):
s = socket.create_connection((host, port), timeout)
return s
def main() -> int:
ap = argparse.ArgumentParser()
ap.add_argument("--host", default=bench_defaults.DEVICE_IP)
ap.add_argument("--port", type=int, default=7003)
ap.add_argument("--mode", choices=["idle", "block"], required=True)
ap.add_argument("--hold-s", type=float, default=90.0)
ap.add_argument("--expect-detect-s", type=float, default=75.0,
help="判死上界(IDLE + INTVL*CNT),仅用于提示")
args = ap.parse_args()
t0 = time.time()
def log(msg: str) -> None:
print(f"[{time.strftime('%H:%M:%S')} +{time.time() - t0:6.1f}s] {msg}",
flush=True)
log(f"模式={args.mode} 目标={args.host}:{args.port} hold={args.hold_s}s")
log(f"(设备侧判死上界参考 = {args.expect_detect_s}s)")
try:
s = connect(args.host, args.port)
except OSError as e:
print(f"[FAIL] 连接失败:{e}")
return 2
s.setsockopt(socket.SOL_SOCKET, socket.SO_KEEPALIVE, 0) # PC 侧不参与
lport = s.getsockname()[1]
log(f"已连接(本地端口 {lport})→ 进入静默")
rc = 0
if args.mode == "block":
# 入站 DROP:设备发来的 keepalive 探测包在 PC 侧被丢弃 → 永不回 ACK
if not firewall("add", lport, args.host):
s.close()
return 2
log(f"已装防火墙入站 DROP(本地端口 {lport} <- {args.host})→ 对端静默开始")
try:
time.sleep(args.hold_s)
except KeyboardInterrupt:
pass
if args.mode == "idle":
# 存活探针:KEEPLIVE 必须被回显
log("静默结束 → 发 KEEPLIVE 验证会话存活")
try:
s.sendall(build_frame(CMD_KEEPLIVE))
r = recv_frame(s, 3.0)
except OSError as e:
r = None
log(f"KEEPLIVE 发送/接收异常:{e}")
if r and r[2]:
log("PASS:收到 0xBB KEEPLIVE 回显 → 正常空闲会话未被误杀")
else:
log(f"FAIL:未收到有效回显({r})→ 空闲置的会话被断开(误杀)")
rc = 1
s.close()
return rc
# block 模式:卸规则 → 验证旧连接已死 + 监听器已恢复
log("静默结束 → 卸载防火墙规则")
firewall("delete", lport, args.host)
time.sleep(1.0)
# 旧连接是否已被设备判死(应读到 EOF/RST;读不到也算进程侧正常)
try:
s.settimeout(2.0)
d = s.recv(16)
log(f"旧连接 recv → {d!r}(b'' = 已收到 FIN,即设备已判死并释放)")
except OSError as e:
log(f"旧连接 recv 异常(设备已判死/连接被拆):{e}")
s.close()
# 监听器恢复验证:新连接 + KEEPLIVE 回显
log("验证监听器恢复:新建连接 + KEEPLIVE")
ok = False
for attempt in range(1, 6):
try:
s2 = connect(args.host, args.port)
s2.sendall(build_frame(CMD_KEEPLIVE))
r = recv_frame(s2, 3.0)
s2.close()
if r and r[2]:
log(f"PASS:第 {attempt} 次新连接建立并收到回显 → 监听器已恢复")
ok = True
break
except OSError as e:
log(f"第 {attempt} 次新连接失败:{e}")
time.sleep(2.0)
if not ok:
log("FAIL:监听器未恢复(端口仍不接客)")
rc = 1
return rc
if __name__ == "__main__":
sys.exit(main())