Files
STM32F4-Base/test/host/bench/net/e11_keepalive_probe.py
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

195 lines
7.0 KiB
Python
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.
#!/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())