#!/usr/bin/env python3 # -*- coding: utf-8 -*- """开入开出板(ioboard)主机侧纯逻辑单元测试运行器(纯标准库)。 做什么:用本机 MSVC 离线编译 test/host/ioboard 下的测试单元 .c (单元内部 #include 纳入生产源文件 Drivers/BSP/IOBOARD/ioboard_bits.c), 在 PC 上验证: 一、74HC165 位序组装(ioboard_bits.c 的 ioboard_di_assemble) 器件按 A→H→QH 移位,第一个时钟沿之前 QH 上已经是 H 位,所以软件读 8 次 拿到的是 H,G,F,E,D,C,B,A;接口约定 A 在 bit0,组装必须把 reads[0] 放 bit7。 二、开出极性与语义位的宏契约(ioboard.h 的 IOBOARD_DO_* 宏) 为什么非要主机侧单测(板级套件是**测不出来**的): 位序写反只会让「A 路信号出现在 bit7」,而台架上看到的仍然是「某一路开入有信号」—— 与线接错一位完全同形,无法归因、无法判废。`docs/门禁说明/host-unit-tests.md` §6 第 5 条写明「时序与并发不在主机侧范围」,反过来说:**能在这里钉住的纯逻辑就必须 在这里钉住**,否则它就是裸奔上线。 被测对象为什么是 ioboard_bits.c 而不是 ioboard.c: ioboard.c 里是真实的 GPIO/FreeRTOS 时序(HAL_GPIO_*、taskENTER_CRITICAL、DWT), 宿主 MSVC 编不过也不该编过。位序/极性已被拆成零依赖的编译单元(正交解法), 本运行器只 include 那一个单元——**不搭 HAL 桩**,所以不存在「桩与真实头不同步」 这类假绿(同一条限制,host-unit-tests.md §6 第 2 条)。 用法(仓库根目录): & '.venv\\Scripts\\python.exe' test/host/ioboard/run_unit_test.py 退出码:0=PASS / 1=测试失败 / 2=环境错误。 设计依据:docs/门禁说明/host-unit-tests.md 创建日期:2026-11-16 """ 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 IOBOARD_DIR = os.path.join(ROOT, "Drivers", "BSP", "IOBOARD") # 测试单元内部 #include 生产源;HERE 在前,便于将来加本目录私有桩时不改顺序。 BUILD = TestBuild( name="IO Board Tests", src=os.path.join(HERE, "ioboard_test.c"), include_dirs=[ HERE, IOBOARD_DIR, os.path.join(ROOT, "Drivers", "BSP"), # bsp_err.h(ioboard.h 的依赖) os.path.join(ROOT, "App", "util"), # ioboard_di.c(去抖 + 快照纯逻辑) ], summary_marker="=== IO Board Tests:", ) if __name__ == "__main__": sys.exit(run_host_unit_test(BUILD))