04ee5867b4
根因:静态 fd 零初始化为 0,而 0 是合法 socket 句柄;判据用 >=0 会把"未初始化"误判成"有效",关闭时误伤他人 fd。本次把该修复 契约化、机械化,而不是再补一个点。 - 新增 net_fd.h 定义唯一失效值 NET_FD_INVALID(-1),全仓零依赖复用 - fd 判据只用 ==/!= NET_FD_INVALID,禁 >=0/<0/数值形态/if(fd) - 网络层内部用 NET_FD_IN_RANGE 做范围校验,上界不外泄 - 主机 fake 改 0 基并跟踪已分配 fd,补冷启动回归(变异测试可捕获) - 新增 net-handle 静态门禁(钩子 53)+ 契约文档 + 审计 + 最小加固 验证:net-handle 487 文件 0 违规;8 个主机套件全绿;Keil 0 错误 0 警告; 审计 3 确认/5 疑似/35 安全,无第二处生产误判。
59 lines
2.8 KiB
Python
59 lines
2.8 KiB
Python
#!/usr/bin/env python3
|
||
# -*- coding: utf-8 -*-
|
||
"""时间同步(time_sync)的主机侧纯逻辑单元测试运行器(纯标准库)。
|
||
|
||
做什么:
|
||
用本机 MSVC 编译 test/host/time_sync/time_sync_test.c(它以 #include 纳入
|
||
**生产源文件** App/sync/time_sync.c),在 PC 上离线跑:
|
||
分片延时(心跳节奏)/ 任务主循环(就绪屏障、SNTP 节拍、代次下传)。
|
||
失败即非 0 退出。零硬件、零烧录、毫秒级。
|
||
|
||
工具链探测 / INCLUDE-LIB 拼接 / 编译运行 / 退出码判定全部委托给通用 harness
|
||
`test/host/common/unit_test_harness.py`(本文件只做声明)。
|
||
|
||
为什么要主机侧单测(而不是只用板端套件):
|
||
本模块是探针窗口心跳缺口那件事的当事方——心跳节奏(delay_fed 的 ≤50ms
|
||
分片 + 每片前置心跳、屏障等待态 100ms 分片喂心跳)全是**纯逻辑**,真机上
|
||
只能"跑起来看复位不复位",主机侧可**逐片断言**(2026-10-02 台架根因、
|
||
第 8b 轮消抖两条教训都钉在这里)。:8888 监听/协议用例已随 2026-11-04 的
|
||
:8888 退役删除(墙钟维护说明 §15),历史覆盖见 git 历史。
|
||
|
||
用法(仓库根目录):
|
||
python test/host/time_sync/run_unit_test.py
|
||
或统一用 .venv: & '.venv\\Scripts\\python.exe' test/host/time_sync/run_unit_test.py
|
||
|
||
退出码:0=PASS / 1=测试失败 / 2=环境错误(找不到编译器 / 编译失败 / 无汇总行)。
|
||
|
||
设计依据:App/sync/time_sync.c 文件头注释 + docs/子系统设计/系统墙钟时间维护说明.md §15/§16;
|
||
创建日期:2026-10-10(2026-11-04 随 :8888 退役收缩)
|
||
"""
|
||
import os
|
||
import sys
|
||
|
||
HERE = os.path.dirname(os.path.abspath(__file__))
|
||
ROOT = os.path.dirname(os.path.dirname(os.path.dirname(HERE)))
|
||
# harness 位于 test/host/common/
|
||
sys.path.insert(0, os.path.join(ROOT, "test", "host", "common"))
|
||
|
||
from unit_test_harness import TestBuild, run_host_unit_test # noqa: E402
|
||
|
||
# 顺序敏感:stub 目录必须**先于**生产目录,才能覆盖 FreeRTOS.h / task.h /
|
||
# net_socket.h / sys_events.h(真实头会拖入整套 FreeRTOS / CMSIS-RTOS / HAL)。
|
||
# task_watchdog.h 与 time_sntp.h 用**真实头**(接口契约原汁:前者只依赖 stdint.h,
|
||
# 后者自包含——替身签名由编译器对表)。
|
||
BUILD = TestBuild(
|
||
name="Time Sync Tests",
|
||
src=os.path.join(HERE, "time_sync_test.c"),
|
||
include_dirs=[
|
||
os.path.join(HERE, "stub"),
|
||
os.path.join(ROOT, "App", "util"),
|
||
os.path.join(ROOT, "App", "sync"),
|
||
os.path.join(ROOT, "Drivers", "BSP", "NET"), # net_fd.h(stub 先命中,仅补零依赖契约头)
|
||
HERE,
|
||
],
|
||
summary_marker="=== Time Sync Tests:",
|
||
)
|
||
|
||
if __name__ == "__main__":
|
||
sys.exit(run_host_unit_test(BUILD))
|