/****************************************************************************** * 模块名称:开入开出板测试套件(TEST_SUITE_IOBOARD) * 模块功能:8 路开入位序双射判据 + 4 路开出逐个点动的台架观察窗口。 * 半自动:时间轴自动推进,人工按日志提示短接 DI / 听继电器动作。 * 适用平台:STM32F407 + 开入开出板(Drivers/BSP/IOBOARD) * 作者:王建锋 * 创建日期:2026-11-16 * 修改记录: * 2026-11-16 王建锋 创建。开入开出驱动早已上线,但 8 路开入的实际位序与 * 4 路开出的动作在台架上没有任何观察窗口 * (ioboard_di_snap_read() 至今无消费者),本套件即那扇窗口。 ******************************************************************************/ #ifndef IOBOARD_TEST_H #define IOBOARD_TEST_H #include #include "test_common.h" #ifdef __cplusplus extern "C" { #endif /* * 开入开出板测试套件(TEST_SUITE_IOBOARD) * * 为什么存在:开入开出驱动早已在板上跑起来(Src/main.c 的 ioboard_init()、 * defaultTask 每 50 ms 喂一拍去抖),但 8 路开入的**实际位序**与 4 路开出的 * **动作**在台架上没有任何观察窗口——去抖快照 ioboard_di_snap_read() 至今 * 没有消费者。本套件就是那扇窗口:一次跑完,日志里逐路可见。 * * ⚠ 本套件**半自动**:本平台没有串口输入通道(serial_tool.py 只有采集与发送, * 且 defaultTask 是唯一串口写者),无法「等操作员敲命令」。所以序列是**时间轴 * 自动推进 + 打印提示让人配合**:提示出现后操作员按提示短接/断开端子、 * 听继电器动作,套件按固定节拍采信。 * * ⚠ 本头文件**不 include dbg_log.h**:理由见 test_common.h 文件头(DBG_TAG 冻结)。 */ /* ============ Phase 使能开关(取消注释即启用,默认全开) ============ */ #define ENABLE_IOBOARD_SELFTEST_TESTS /* Phase 0: ioboard_init 确认 + 开出现状 */ #define ENABLE_IOBOARD_DI_ORDER_TESTS /* Phase 1: 开入位序(单比特两端 + 双射,位序主判据) */ #define ENABLE_IOBOARD_DI_STABLE_TESTS /* Phase 2: 全断开稳定性(20 次一致,证去抖生效) */ #define ENABLE_IOBOARD_DO_TESTS /* Phase 3: 开出逐个点动(空载,人工听动作声) */ /* * 开入位序的采样口径(Phase 1 / Phase 2 共用)。 * 每「采样一轮」= 在一次 ioDelay(IOBOARD_TEST_DI_SAMPLE_GAP_MS) 间隔内连读 * IOBOARD_TEST_DI_SAMPLES 次,并计其按位与(all)与按位或(any): * all == any → 这一轮没有抖动;否则这一轮内部就在抖。 * 选择「采样而不是单读」的理由:去抖在软件层(ioboard_di.c),ioboard_di_read() * 读到的是引脚原始态,单读一次会被触点抖动骗到。 */ #define IOBOARD_TEST_DI_SAMPLES 20U #define IOBOARD_TEST_DI_SAMPLE_GAP_MS 2U /* 人工配合窗口:提示出现后等这么久再采信(给操作员留出动手时间) */ #define IOBOARD_TEST_DI_ARM_MS 3000U /* Phase 2 的采样轮数(每轮 20 次×2 ms ≈ 40 ms) */ #define IOBOARD_TEST_DI_STABLE_ROUNDS 20U /* 开出点动保持时长:1 s(空载继电器,动作声足以辨认) */ #define IOBOARD_TEST_DO_ARM_MS 1000U /* 开出释放后的稳定时长 */ #define IOBOARD_TEST_DO_RELEASE_MS 300U /* 单个采样隔拍上限(防误配出荒谬值) */ #define IOBOARD_TEST_DI_SAMPLE_GAP_MAX_MS 100U /* ============ 测试统计(本套件独立,防跨套件串数;内核见 test_common.h) ============ */ typedef test_stats_t ioboard_test_stats_t; extern ioboard_test_stats_t g_ioboard_test_stats; #define IOBOARD_TEST_CHECK(cond, fmt, ...) \ TEST_CHECK_IMPL(g_ioboard_test_stats, cond, fmt, ##__VA_ARGS__) #define IOBOARD_TEST_REPORT(name) TEST_REPORT_IMPL(g_ioboard_test_stats, name) /* * 函数功能:套件入口(由 start_test_task 经 TEST_SUITE_IOBOARD 调度) * 入口参数:无 * 返回值:无 * 限定条件:在 testTask 上下文被调用;内部**自起一个 Normal 优先级线程**跑序列, * 本函数立即返回(理由见 ioboard_test_task.c 的启动段注释)。 * 函数说明:**本套件不干预 defaultTask 的开入轮询**——驱动已用 * taskENTER_CRITICAL() 把单次读整段护住,两处只读不写同一组引脚, * 因此不存在数据损坏。注意时序上两处**必然交叠**(套件采样窗约 40 ms, * defaultTask 每 50 ms 读一次),但交叠只影响跨读者一致性、不影响单次读 * 完整性,本套件判据的成立也不依赖 defaultTask 是否同时读。 * 完整论证见 ioboard_test_task.c 文件头。 * 若台架实跑出现两份不一致的开入视图,最小规避手段是让 defaultTask 的 * poll 在套件期间跳过,但那需要改 App/task/default_task.c,届时先报 Lead。 */ void ioboard_test_run(void); #ifdef __cplusplus } #endif #endif /* IOBOARD_TEST_H */