fd767d1dcd
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 根钩子全通过。
61 lines
2.8 KiB
Python
61 lines
2.8 KiB
Python
#!/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))
|