Files
STM32F4-Base/test/host/ioboard/run_unit_test.py
T
wandering1 fd767d1dcd feat(ioboard): 开入开出板驱动、去抖快照与主机侧单测接入
74HC165 开入 + 光耦继电器开出的完整硬件抽象层,接进 defaultTask
的 50ms 节拍。开入 8 路(第二块 165 数据线板上未接,故只有 8 位),
开出 4 路(高电平吸合)。

驱动 BSP drivers:
- IOBOARD/ioboard.c 装载与移位时序,每步注明数据手册依据;
  SH/LD 拉高前先拉低 CLK,否则装载瞬间多移一位;
  单次读取上界 26us(延时按最慢列 VCC 2V 全温区取值)。
- IOBOARD/ioboard_bits.c 位序组装纯函数,只依赖 stdint.h,
  主机侧可直接 include 做单测:读 8 次为 H,G,F,E,D,C,B,A,
  A 放 bit0(bit(7-i) = reads[i])。
- 极性集中在 IOBOARD_DO_LEVEL_ACTIVE 一处,接口语义统一为
  mask 的 1 = 吸合。

业务接线:
- App/util/ioboard_di.c 通道去抖与双区快照,纯逻辑;
  刻意不 include ioboard.h(其引脚宏会牵入 main.h),
  两处路数常量由测试的编译期静态断言钉住。
- default_task.c 的 default_task_di_poll():读失败不喂去抖、
  不写发布值,只把上一有效值加 valid=0 发布出去,
  避免"全 0"被现场读成开入全部复归。
- 去抖实际粒度 50ms(每个轮询周期喂一拍),最坏上报约 100ms;
  想要真 20ms 需另建定时器,本次不做。
- Src/main.c 在 app_main_init 之前调 ioboard_init(),
  上电即把 4 路出口钉在全释放并确认 165 静止态。

测试:
- test/host/ioboard/ 100 条断言。位序主判据为单比特两端
  (只有 A 得 0x01、只有 H 得 0x80)加八点双射穷举;
  混合图样降级为辅助,因该图样曾先后被算成 0xA5、0x5A、0xAA。
- 去抖覆盖 20ms 边界、抖动不翻、跨 49.7 天回绕。
- 失败语义覆盖"失败保留上次有效值"与"失败窗口内的真实变位不丢"。

文档:
- 新增 docs/硬件平台/开入开出实施说明.md。
- 硬件规格与能力边界 §5 的能力边界现状改写:出口继电器与
  开入回路已具备、业务层未接入;4 路开出只可台架验证,
  不得用于真实跳闸。
- 修正 docs/文档规范.md §3.1:原文要求所有互链用仓库根相对,
  与 check_doc_links.py 的实际解析基准矛盾(markdown 链接按
  当前文档目录解析,反引号路径才按仓库根)。改为区分两类,
  并补 §3.1b 写明对应校验器。
- 清理 docs/任务规划/登记簿.md 改名为硬件改版登记.md 后
  遗留的 9 处旧名引用。

门禁: keil-build 0 Error 0 Warning;主机侧单测 ioboard 100/100、
sb_proto 45/45;pre-commit 48 根钩子全通过。
2026-11-16 18:30:31 +08:00

61 lines
2.8 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 -*-
"""开入开出板(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))