wandering1
59e6d77224
假 CH395F 的第三批、也是 NET 域最后一块。net_events.c 覆盖 175/179 = 97.8%。共享 假芯片本批补齐**对端六元组**（get_remot_ipp 的 6 字节）与**链路变更计数**（ link_change_count / link_up_cached 改为可预置，原来硬编码 0/1）。 钉住的契约（都是真机上会发生、却不能按需复现的那类）： - 对端六元组解析：remote_ip 是**低字节在前**拼的（192.168.1.50 -> 0x3201A8C0，与 网络序相反）。钉住它是防止有人"顺手改成大端"，让所有按 IP 比对/白名单静默错位。 - 陈旧中断防误判：芯片说 TCP 还 ESTABLISHED 时，迟到的 DISCONNECT 一律忽略并报 ERROR（拆活会话的代价是 104 主站看到莫名掉线）；一条数据都没收就报断且芯片接收区 还有字节，判为疑似误报、只置 lost_conn_seen 延后交给对账器。 - 正常断开：优雅级沉降 + session_dead + last_peer_port 记旧端口 + 转 CLOSED + 发事件。 - 超时：ESTABLISHED 走隔离级沉降并置 released_abnormal —— 这正是 net_pending 收尾时 把挂起 recv 报成 CONNRESET 而不是 0 的那条输入（TC-NETPEND-014），**跨文件因果** 只有两边都能离线跑才可测。 - 丢中断自愈：芯片已连上而软件还写着 LISTENING 时补一次 accept；若软件已 CLOSED 则 只留痕不凭空造会话（TC-NETEV-042b 记现状）。 - 对账器：100ms 周期闸门（同一时刻不重复查芯片）；链路计数**基线那趟不打日志** （0xFFFF 哨兵，否则每次上电都冒一条假"link up"）、变化即留痕；五种不一致形态的 稳定计数分三档（会话死亡要连观 4 次、芯片偷重开监听 2 次、丢 CONNECT 自接 1 次）； 动作后 1000ms 冷却内不重复折腾；U11 重同步（软件 CLOSED 而芯片在 LISTEN -> 直接跟 芯片，不做多余重建）；不在用的槽位直接跳过。 三条初判失败的复盘（都是**我的期望值/场景写错**，实现是对的）：① remote_ip 字节序 我按网络序写了期望；② 自愈场景我用了 CLOSED 态，而 accept 分支只认 LISTENING/ CONNECTING，改场景并补一条现状断言；③ 链路"基线不打日志"我测在非基线场景（s_ link_last 是函数内 static，跨场景本就延续）。对账器的 s_last/s_bad[]/s_cool[] 都是 函数内 static（外部够不着），因此每个形态**各占一个 fd**、时基单调前进，互不串扰。 覆盖率与台账：套件 24 → 25 全绿；files_tested 28 → 29；未触及 .c 38 → 37；分母 3,766 → 3,945 行；line=3472/3945（**88.0%**，连涨两批）、func=263/290（90.7%）。 恒等式 37 = 3(P1 剩) + 5(P2) + 29(P3) 仍咬合。编号补建 TC-HOST-NETEV（游标 058）， 族数 18 → 19。 自查：test-cppcheck Passed（含补齐后的假芯片）；check_ids --strict 通过；doc-links 35 处（= 存量）；16 个新增/改动文件 BOM/CR/U+FFFD/行尾逐项净。零生产代码改动，未跑 @build。--all-files 仍只有 mem-numbers / mem-budget（.map 台账漂移，等 Lead 合并后 统一 --write 回填）与 ui-golden（simulator/tests/ref/*.bin 不入库，新 worktree 没有 黄金参考）三条失败，与本分支改动无关；提交按并行分支约定走 --no-verify。
61 lines
3.1 KiB
Python
61 lines
3.1 KiB
Python
#!/usr/bin/env python3
|
|
# -*- coding: utf-8 -*-
|
|
"""NET 层事件分发与周期对账（net_events）主机侧单元测试运行器（L0.5，纯标准库）。
|
|
|
|
做什么：
|
|
用本机 MSVC 编译 test/host/net_events/net_events_test.c（以 #include 纳入生产源
|
|
Drivers/BSP/NET/net_events.c 与共享假芯片 test/host/common/ch395f_fake.c），在 PC
|
|
上离线验证五个事件入口与周期对账器：对端六元组解析、陈旧中断防误判、疑似误报延后、
|
|
超时标异常释放、丢中断自愈，以及对账器的周期闸门、稳定计数（4/2/1 三档）、1000ms
|
|
冷却、U11 重同步与五种不一致形态。工具链与判定委托 unit_test_harness.py。
|
|
|
|
为什么要主机侧单测（而不是只用台架）：
|
|
CH395F 中断整体读即清、单连接 socket 复用同号，"迟到的 DISCONNECT"和"丢了 CONNECT
|
|
的已连接"真机上都会发生却不能按需复现；误判的代价直接落在现场设备上（拆掉活会话，
|
|
或让 socket 永久停在已连接假象里不再重开）。对账器的稳定计数本质是"别拿一次采样
|
|
就把连接折腾死"，100ms 一轮、要连观 4 次才动手，台架无法按毫秒喂；主机侧把时基
|
|
做成显式量后，第 3 次不该动、第 4 次该动、之后 1000ms 内不许再动都能精确断言。
|
|
另外 handle_timeout_event 置的 released_abnormal 是 net_pending 收尾报 CONNRESET 的
|
|
输入（见 test/host/net_pending 的 TC-NETPEND-014），这条跨文件因果只有两边都能
|
|
离线跑才可测。
|
|
|
|
桩的边界：net_events.h / net_types.h / net_pending.h / net_listener.h 用真实头；
|
|
net_socket.h 是桩，但 net_sock_raw 保留"未在用槽位也返回项"的真实语义（对账循环
|
|
必须能读 in_use==0）；ch395f.h 只转发到共享假芯片（本批补齐对端六元组与链路变更
|
|
计数）；事件回调做成可观测假件——应用层能不能收到、收到的是什么事件，是本模块
|
|
唯一的对外契约。刻意不定义 NET_BENCH_CMD_LOG（压测日志不是被测对象）。
|
|
|
|
用法（仓库根目录）：
|
|
python test/host/net_events/run_unit_test.py
|
|
|
|
退出码：0=PASS / 1=测试失败 / 2=环境错误。
|
|
|
|
设计依据：docs/网络/网络自愈架构设计.md §4.10、docs/网络/Net层阻塞模型架构设计.md、
|
|
docs/测试说明/主机单测覆盖率口径.md §9
|
|
创建日期：2026-10-23
|
|
"""
|
|
import os
|
|
import sys
|
|
|
|
HERE = os.path.dirname(os.path.abspath(__file__))
|
|
ROOT = os.path.dirname(os.path.dirname(os.path.dirname(HERE)))
|
|
sys.path.insert(0, os.path.join(ROOT, "test", "host", "common"))
|
|
|
|
from unit_test_harness import TestBuild, run_host_unit_test # noqa: E402
|
|
|
|
BUILD = TestBuild(
|
|
name="NET Events Tests",
|
|
src=os.path.join(HERE, "net_events_test.c"),
|
|
include_dirs=[
|
|
os.path.join(HERE, "stub"),
|
|
os.path.join(ROOT, "test", "host", "common"),
|
|
os.path.join(ROOT, "Drivers", "BSP", "NET"),
|
|
HERE,
|
|
],
|
|
summary_marker="=== NET Events Tests:",
|
|
)
|
|
|
|
if __name__ == "__main__":
|
|
sys.exit(run_host_unit_test(BUILD))
|
|
|