diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index d63ade32..c85e089a 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -624,13 +624,13 @@ repos:
files: ^(Drivers/BSP/UI/|App/task/ui_task\.(c|h)$|ui_cn_chars\.txt$|tools/font_gen/|scripts/check_font_charset\.py$)
pass_filenames: false
# 12a) BOM 漂移门禁(2026-10-25 道E task-20)
- # 背景:AGENTS 铁律第 2 条——编辑工具会**静默剥掉**文件原有 BOM,ARMCC 于是按 CP936
+ # 背景:编码铁律第 2 条(docs/文档规范.md §2)——编辑工具会**静默剥掉**文件原有 BOM,ARMCC 于是按 CP936
# 解码带中文的源文件,报 #870-D / #8 / #274 一类**假语法错**(报错位置与内容都不指向
# 真因),而 MSVC(模拟器侧)与既有钩子全照不出来。2026-10-25 一天内道E 踩 4 次、
# 道B 批 1 踩 1 次,此前全靠人工逐文件比 HEAD 兜底——人工审计只防得住记得做的人。
# 判定:HEAD 有 EF BB BF 而工作区没有 → FAIL。两条刻意不报(新增文件无 BOM、HEAD 无
# BOM 而工作区加了 BOM)与一条刻意不做(不自动补:整文件重写正是本仓更大的坑)都
- # 写在脚本头部。files 与 AGENTS 名单、脚本内 BOM_LIST **三处互指**,脚本每次跑核一次,
+ # 写在脚本头部。files 与 docs/文档规范.md §2 的 BOM 名单、脚本内 BOM_LIST **三处互指**,脚本每次跑核一次,
# 单独改任何一处都会在别人的提交里被拦下——名单散在三处而无人同步等于没有名单。
- id: bom-guard
name: BOM 漂移检查(带 BOM 文件被剥掉即拦)
@@ -711,7 +711,7 @@ repos:
# docs/门禁说明/README.md §2 标题三数同源同批改(自查命令见该条;别在注释里写数钩子的字面量)。
# 14) 分层方向门禁(2026-10-22 加,结构债的"防扩大"那一半)
- # 背景:AGENTS.md 与 项目架构总览.md 早就写着"六层单向依赖",但**从来没有机械检查**
+ # 背景:项目架构总览.md §1/§2 早就写着"六层单向依赖",但**从来没有机械检查**
# ——Drivers/BSP/ 里可以随手 include "cfg_file.h" 而无人报警。后果可测量:2026-09 审查
# 报告记"NETCFG 一处",2026-10-22 实测已长到 **8 个文件 9 处**。边界的静默腐蚀只能
# 靠门禁止住,所以本钩子做**增量拦截**(与 id-check 同构):现状 6 条钉成 BASELINE
@@ -850,7 +850,7 @@ repos:
# → FAIL;带 UTF-8 BOM → FAIL(插件按 utf-8 解析,BOM 会让 frontmatter 读歪)。
# 全树扫不只看变更文件:钩子拿到 filenames 只当触发用,判定始终扫整个 .dsh/skills/——因为改
# reference/*.md 时 SKILL.md 没动,但它可能正是被那次外置撑过线/掏空的那一份。
- # 为什么 entry 敢用裸 python:AGENTS.md「钩子 entry 的裸 python 不等于 .venv」那条教训针对的是
+ # 为什么 entry 敢用裸 python:「裸 python 不等于 .venv」那条教训(口径 → keil-build skill)针对的是
# 第三方依赖(fontTools);本脚本纯标准库,任意 python3 均可(实测 .venv 3.12 与 PATH 上 3.14
# 都跑通),所以不需要脚本内再自解析解释器。
# ⚠ 盲区:只管仓库内 .dsh/skills/;用户级 ~/.dsh/skills/ 不在仓库里,本钩子照不到(手工
diff --git a/App/task/default_task.c b/App/task/default_task.c
index 11d1aca0..d0b97b86 100644
--- a/App/task/default_task.c
+++ b/App/task/default_task.c
@@ -121,10 +121,19 @@ static const stack_probe_task_t s_stack_probe[] = {
static void stack_probe_poll(void);
#if !defined(TEST_SUITE_STORAGE)
static void default_task_net_cfg_save_notify(void);
+static FRESULT storage_bring_up(FATFS *fs);
+static void wave_store_drain(void);
static uint8_t default_task_di_poll(void);
-/* 周期性发布者的编译期开关:两个测试套件构建都禁用本任务的发布(见 poll 函数的说明四) */
-#if defined(TEST_SUITE_CH395F) || defined(TEST_SUITE_GDRAM)
+/*
+ * 周期性发布者的编译期开关:测试套件构建下禁用本任务的发布(见 poll 函数的说明四)。
+ * 为什么把 STORAGE 也算进来:STORAGE 套件由 testTask 独占文件系统,而本任务的发布路径
+ * 会经 syslog_post() 写 run.log;同时那四个开入静态变量声明在 !TEST_SUITE_STORAGE 区里,
+ * 若本开关对它仍判 1,poll 函数体就会引用到被条件编译挖掉的变量而编不过。
+ * **本段是 DEFAULT_TASK_DI_PUBLISH_EN 的唯一权威定义点**——函数体内不得再定义一次
+ * (#define 没有作用域,重复定义是宏重定义警告,且让"当前生效的值"变成靠行号推断)。
+ */
+#if defined(TEST_SUITE_CH395F) || defined(TEST_SUITE_GDRAM) || defined(TEST_SUITE_STORAGE)
#define DEFAULT_TASK_DI_PUBLISH_EN 0
#else
#define DEFAULT_TASK_DI_PUBLISH_EN 1
@@ -144,8 +153,6 @@ static ioboard_di_ch_t s_di_ch[IOBOARD_DI_CH_NUM];
static ioboard_di_snapshot_t s_di_snap;
static uint8_t s_di_pub_mask;
static uint32_t s_di_fail_edges_seen;
-static FRESULT storage_bring_up(FATFS *fs);
-static void wave_store_drain(void);
#endif
/*
@@ -214,14 +221,9 @@ void default_task_func(void *argument) {
uint32_t cfg_poll_cnt = 0u;
uint32_t led_tick = HAL_GetTick();
- /* 周期性发布者的编译期开关:两个套件都禁用本任务的发布(见下方 poll 函数的说明) */
- #if defined(TEST_SUITE_CH395F) || defined(TEST_SUITE_GDRAM)
- #define DEFAULT_TASK_DI_PUBLISH_EN 0
- #else
- #define DEFAULT_TASK_DI_PUBLISH_EN 1
- #endif
/* 开入第一次读取放在 bring-up 之后:此刻 MX_GPIO_Init 早已配好引脚(模块初始化期),
- * 且看门狗尚未启动,几十微秒的移位读不会影响任何节拍。 */
+ * 且看门狗尚未启动,几十微秒的移位读不会影响任何节拍。
+ * 发布开关 DEFAULT_TASK_DI_PUBLISH_EN 在文件作用域统一定义,此处**不得重复定义**。 */
(void)default_task_di_poll();
/* 注册控制台写者:本任务此后是串口唯一发送者(其余任务只写环形缓冲)。
@@ -967,22 +969,25 @@ static void default_task_net_cfg_save_notify(void) {
* 有效性下降沿(有效 → 失效)各落一条 run.log。判据用 fail_edges 的**边沿**
* 而不是失败计数,保证一个故障 episode 只记一条(与 task_wd_poll 的位图边沿同款)。
* 写日志点放在本函数内而非 ioboard_di.c:纯逻辑层不碰文件系统。
- * 且只在 !TEST_SUITE_CH395F && !TEST_SUITE_GDRAM 时发布 —— 那两个套件构建下
- * 卷由 testTask 独占(与 TEST_SUITE_STORAGE 同款理由),defaultTask 侧只读不算不写盘。
+ * 且只在 !TEST_SUITE_CH395F && !TEST_SUITE_GDRAM && !TEST_SUITE_STORAGE 时发布 ——
+ * 那三个套件构建下卷由 testTask 独占,defaultTask 侧只读不算不写盘。
*/
static uint8_t default_task_di_poll(void) {
uint8_t mask = 0u;
uint8_t rc = 0u;
uint8_t i;
uint32_t now = HAL_GetTick();
+
+#if (DEFAULT_TASK_DI_PUBLISH_EN == 0)
+ /* 测试套件构建:卷上写者不是本任务,本函数不发布也不写日志(见函数说明四)。
+ * 这一分支下不触碰 s_di_ch / s_di_snap / s_di_pub_mask / s_di_fail_edges_seen:
+ * TEST_SUITE_STORAGE 构建把它们的声明整段条件编译掉了,引用就是编译错误。 */
+ (void)mask; (void)rc; (void)i; (void)now;
+ return 0u;
+#else
uint32_t edges = 0u;
int32_t fails = 0;
-#if (DEFAULT_TASK_DI_PUBLISH_EN == 0)
- /* 测试套件构建:卷上写者不是本任务,本函数不发布也不写日志(见函数说明四) */
- (void)mask; (void)rc; (void)i; (void)now; (void)edges; (void)fails;
- return 0u;
-#else
if (ioboard_di_read(&mask) == BSP_OK) {
/* 成功:第一拍(或刚从故障恢复)先整组重新确立基准,再喂本拍 */
if (s_di_snap.valid == 0u) {
diff --git a/MDK-ARM/STM32F407-Demo.uvprojx b/MDK-ARM/STM32F407-Demo.uvprojx
index d01bb569..378294f1 100644
--- a/MDK-ARM/STM32F407-Demo.uvprojx
+++ b/MDK-ARM/STM32F407-Demo.uvprojx
@@ -2432,6 +2432,11 @@
1
..\test\board\sd2506_test_task.c
+
+ ioboard_test_task.c
+ 1
+ ..\test\board\ioboard_test_task.c
+
diff --git a/scripts/check_test_suite.py b/scripts/check_test_suite.py
index 5cd0b68d..9639e884 100644
--- a/scripts/check_test_suite.py
+++ b/scripts/check_test_suite.py
@@ -57,6 +57,7 @@ SUITE_MACROS = [
("TEST_SUITE_STORAGE", "STORAGE 存储套件(FTL + FatFS)"),
("TEST_SUITE_GD5F", "GD5F NAND 驱动套件(10 阶段)"),
("TEST_SUITE_RTC", "RTC 套件(SD2506)"),
+ ("TEST_SUITE_IOBOARD", "开入开出板套件(8 路 DI 位序 + 4 路 DO 点动,半自动)"),
]
# 只关注"套件选择开关"本身。同文件里还有派生的 TEST_SUITE_SELECTED /
diff --git a/scripts/stack_report.py b/scripts/stack_report.py
index cd315e7d..191dbc6c 100644
--- a/scripts/stack_report.py
+++ b/scripts/stack_report.py
@@ -48,6 +48,16 @@ ROOTS = {
"adc_task_func": "adcTask",
"iec104_serv_task": "iec104Task",
"protect_task": "protectTask",
+ # 套件自起线程(xTaskCreateStatic,TCB 与栈都在 .bss,不在 freertos.c 的
+ # osThreadAttr_t 表里)。配置值由下面 STATIC_TASK_STACKS 直接读源码常量。
+ "ioboard_thread_entry": "iobTest",
+}
+
+# 自起线程的栈**不由 freertos.c 声明**,配置值只能从定义处读:任务名 -> (文件, 常量名)。
+# 常量本身是**字节数**(`(1024U * 4U)` 这种写法也认);读不到即视为 0 → 报告里显示
+# N/A,而不是拿一个猜的数去算余量。
+STATIC_TASK_STACKS = {
+ "iobTest": ("test/board/ioboard_test_task.c", "IOBOARD_TEST_THREAD_STACK"),
}
# Runtime lines use the short labels emitted by stack_probe_poll() in freertos.c.
@@ -130,6 +140,37 @@ def parse_task_stacks(path):
return stacks
+def parse_static_task_stacks():
+ """Configured stack size (bytes) of self-spawned tasks.
+
+ These tasks never appear as osThreadAttr_t in freertos.c, so without this the
+ table would show them as "N/A (not in image)" and the very thread that was added
+ to hold a big buffer would escape the budget check entirely.
+
+ Accepted forms at the definition site (C integer literals, 0-2 multiplications):
+ #define X (1024U * 4U) -> 4096
+ #define X 2048U -> 2048
+ """
+ sizes = {}
+ for task, (rel, macro) in STATIC_TASK_STACKS.items():
+ p = REPO_ROOT / rel
+ try:
+ text = p.read_text(encoding='utf-8', errors='replace')
+ except OSError:
+ continue
+ m = re.search(r'^\s*#define\s+' + re.escape(macro) + r'\s+([^\r\n/]+)', text, re.M)
+ if not m:
+ continue
+ expr = m.group(1)
+ factors = re.findall(r'(\d+)\s*[uU]?', expr)
+ if factors and not re.search(r'(?i)[a-wyz]', expr.replace('u', '').replace('U', '')):
+ total = 1
+ for f in factors:
+ total *= int(f)
+ sizes[task] = total
+ return sizes
+
+
def parse_runtime(path):
"""Extract the last [STACK] block from a serial log: task -> peak/free."""
text = pathlib.Path(path).read_text(encoding='utf-8', errors='replace')
@@ -168,6 +209,7 @@ def main():
meta, functions = parse_callgraph(html_path)
stacks = parse_task_stacks(FREERTOS_C)
+ stacks.update(parse_static_task_stacks()) # 自起线程(不在 freertos.c 里)
runtime, heap = ({}, None)
if args.serial:
runtime, heap = parse_runtime(args.serial)
diff --git a/test/board/ioboard_test.h b/test/board/ioboard_test.h
new file mode 100644
index 00000000..c960f218
--- /dev/null
+++ b/test/board/ioboard_test.h
@@ -0,0 +1,99 @@
+/******************************************************************************
+ * 模块名称:开入开出板测试套件(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 */
diff --git a/test/board/ioboard_test_task.c b/test/board/ioboard_test_task.c
new file mode 100644
index 00000000..f9743188
--- /dev/null
+++ b/test/board/ioboard_test_task.c
@@ -0,0 +1,756 @@
+/******************************************************************************
+ * 模块名称:开入开出板(IOBOARD)板级测试套件
+ * 模块功能:为 74HC165 八路开入与四路光耦继电器开出提供台架观察窗口——
+ * 逐路给出「哪一路变了 / 变成什么」,而不是只给一个 0xFF 的混合图样。
+ *
+ * 为什么是**半自动**(本平台三条事实决定了它不能做成交互式):
+ * 一、没有串口输入通道:serial_tool.py 只有采集(log)与发送(send),
+ * 而 defaultTask 是唯一串口写者——套件读不到「操作员敲的命令」。
+ * 二、testTask 是 osPriorityBelowNormal,低于 defaultTask:defaultTask 的
+ * 1 ms 控制台排空循环会把低优先级的「靠 osDelay 等人」饿死。所以本套件
+ * **自起一个 Normal 优先级线程**(见 ioboard_test_run),不在 testTask
+ * 上下文里等人工。
+ * 三、人工动作只能靠**时间轴 + 提示**:日志打印「请短接 DI_A」,等 3 s,
+ * 然后采信。操作员要跟着日志节奏走。
+ *
+ * 开入位序为什么用「单比特两端 + 双射」而不是混合图样:
+ * 全短接读 0xFF / 全断开读 0x00 对位序完全不敏感(无论 bit 怎么排都是那两个值)。
+ * 逐个单比特短接才能把「第 k 路物理端子 ↔ mask 第 k 位」钉死;8 次单比特结果
+ * 必须是 8 个互不相同、各含 1 个 1 的掩码,且并起来恰好覆盖 bit0..bit7
+ * (双射)——这才排除了「两位同时被读成同一路」这类串扰。
+ *
+ * 与 defaultTask 的 HC165 竞争(调研结论,不是猜测):**本套件不干预 defaultTask 的轮询**
+ * 产品构建下 default_task_di_poll() 每主循环一轮(基准 50 ms)调 ioboard_di_read()
+ * 读同一组 PC2/PC3/PE3。驱动把「装载 + 8 拍移位」整段包在一个
+ * taskENTER_CRITICAL() 里(ioboard_di_read_impl)。据此四条结论:
+ * · **单次读内部不可能被另一处插进来**——两处绝不会读出"混杂位序"的半截数据;
+ * · 两处都**只读不写**引脚(SH/LD 装载 + 移位,不碰输出锁存),
+ * 且套件与 defaultTask 读的是同一物理状态,因此不存在数据损坏;
+ * · **时序上碰得到,但碰得到无害**:本套件的采样窗是 20 次读、彼此间隔 2 ms、
+ * 整窗约 40 ms;defaultTask 每 50 ms 读一次——40 ms 窗与 50 ms 周期**必然交叠**
+ * (几乎每窗至少一次),两者无法互避。交叠不影响单次读的完整性
+ * (两份都是临界区内的完整样本,见上面第一条),只影响**跨读者一致性**
+ * (即判据基准的纯粹性);而本套件自身判据的成立**不依赖** defaultTask 是否
+ * 同时读——它只依赖"套件自己这 20 次读的一致性与相对基线的差异";
+ * · 注意 40 ms 是**采样窗总时长,不是全程关中断**:每次读的临界区仅
+ * IOBOARD_DI_READ_MAX_US = 26 us,窗内绝大部分时间在 ioboard_io_delay 里让 CPU。
+ * 结论:风险不成立,故**不做任何干预**——不加编译开关、不加标志位、不改分片。
+ * 若台架实跑确实出现两份不一致的开入视图(例如本套件的
+ * "[PASS] other 7 unchanged" 判据假红),最小规避手段是让 defaultTask 的 poll
+ * 在套件期间跳过;**那需要改 App/task/default_task.c**,届时先报 Lead 定夺。
+ * 驱动实现(Drivers/BSP/IOBOARD/)与 App/util/ioboard_di.* 一行未改。
+ *
+ * 两处开入读的耗时口径:IOBOARD_DI_READ_MAX_US = 26 us(8 拍移位的时序上限,
+ * 见 ioboard.h),相对 50 ms 一拍占 0.05%,套件的 20 次采样也不会被它拖慢。
+ *
+ * 入口:ioboard_test_run()(由 start_test_task 经 TEST_SUITE_IOBOARD 调度)
+ * 创建日期:2026-11-16
+ ******************************************************************************/
+
+#include
+
+#include "ioboard.h" /* 板级套件在目标上编译:驱动函数声明 + IOBOARD_DO_* 位与极性宏 */
+#include "bsp_err.h"
+#include "ioboard_bits.h" /* IOBOARD_DI_COUNT / IOBOARD_DO_MASK_ALL(纯逻辑层,无 HAL 依赖) */
+
+/* 先 include 套件头(它只依赖 test_common.h + stdint),再 include 驱动头;
+ * 与 sd2506 套件同序,保证「套件自述」出现在任何驱动依赖之前。 */
+#include "ioboard_test.h"
+#include "test_config.h"
+
+#ifdef TEST_SUITE_IOBOARD
+
+#include "ioboard.h" /* 板级套件在目标上编译:可直接取掩码宏与极性宏 */
+#include "ioboard_bits.h"
+#include "bsp_err.h"
+
+#include "cmsis_os.h"
+#include "FreeRTOS.h"
+#include "task.h"
+#include "main.h" /* HAL_GetTick(Inc/main.h → HAL 头);不能只依赖 cmsis_os.h 的间接包含 */
+
+#define DBG_TAG "[IOBOARD_TEST]"
+#include "dbg_log.h"
+
+/* 套件汇总行名称:run_all_suites.py 的 --require-suite-summary 按它匹配 */
+#define IOBOARD_TEST_SUMMARY_NAME "IOBOARD Tests"
+
+/* 自起线程:Normal(= defaultTask 同级)。为什么不做 AboveNormal:
+ * 本线程绝大多数时间在 ioboard_io_delay 里让 CPU,只在打印与几十微秒的移位读时占用;
+ * 与 defaultTask 同级即可保证「osDelay 到期后与 defaultTask 公平竞争」,
+ * 不会因优先级太低被 defaultTask 的 1 ms 排空循环反复抢走而错过人工窗口。 */
+#define IOBOARD_TEST_THREAD_STACK (1024U * 4U) /* 4 KB(1024 words) */
+#define IOBOARD_TEST_THREAD_PRIO osPriorityNormal
+
+/* 开入/开出路数的编译期一致性钉:ioboard.h 与 ioboard_di.h 刻意互不 include
+ * (后者是纯逻辑层),两者的一致性由这里钉死。 */
+#define IOBOARD_TEST_DI_COUNT_EXPECT 8U
+#define IOBOARD_TEST_DO_COUNT_EXPECT 4U
+
+#if (IOBOARD_DI_COUNT != IOBOARD_TEST_DI_COUNT_EXPECT)
+#error "IOBOARD_DI_CH_NUM/IOBOARD_DI_COUNT must be 8 (suite assumes 8 DI channels)"
+#endif
+#if (IOBOARD_DO_COUNT != IOBOARD_TEST_DO_COUNT_EXPECT)
+#error "IOBOARD_DO_COUNT must be 4 (suite assumes 4 DO channels)"
+#endif
+
+#if (IOBOARD_TEST_DI_SAMPLE_GAP_MS > IOBOARD_TEST_DI_SAMPLE_GAP_MAX_MS)
+#error "IOBOARD_TEST_DI_SAMPLE_GAP_MS too large"
+#endif
+#if (IOBOARD_TEST_DI_SAMPLES == 0U)
+#error "IOBOARD_TEST_DI_SAMPLES must be > 0"
+#endif
+
+#define IOBOARD_TEST_DI_MASK_ALL ((uint8_t)IOBOARD_DI_MASK_ALL)
+#define IOBOARD_TEST_DO_MASK_ALL ((uint8_t)IOBOARD_DO_MASK_ALL)
+
+/* 全局测试统计(宏自动管理) */
+ioboard_test_stats_t g_ioboard_test_stats;
+
+/* 自起线程的 TCB(静态分配,不走堆;本仓禁用 C 库堆分配) */
+static StaticTask_t s_ioboard_thread_tcb;
+static StackType_t s_ioboard_thread_stack[IOBOARD_TEST_THREAD_STACK / sizeof(StackType_t)];
+
+/* 开入通道名(纯 ASCII 字符串字面量;中文只在注释里) */
+static const char *const k_di_name[IOBOARD_TEST_DI_COUNT_EXPECT] = {
+ "DI_A", "DI_B", "DI_C", "DI_D", "DI_E", "DI_F", "DI_G", "DI_H"
+};
+
+/* 开出通道名(与八位语义位的顺序一一对应,见 ioboard.h 的 IOBOARD_DO_* 宏) */
+static const uint8_t k_do_bit[IOBOARD_TEST_DO_COUNT_EXPECT] = {
+ (uint8_t)IOBOARD_DO_KO6, (uint8_t)IOBOARD_DO_TRIP,
+ (uint8_t)IOBOARD_DO_ERT, (uint8_t)IOBOARD_DO_CLZ
+};
+static const char *const k_do_name[IOBOARD_TEST_DO_COUNT_EXPECT] = {
+ "KO6", "TRIP", "ERT", "CLZ"
+};
+
+/* Phase 1 的单比特结果(0 = 本路未通过,不进双射核对的集合) */
+static uint8_t s_phase1_mask[IOBOARD_TEST_DI_COUNT_EXPECT];
+static uint8_t s_phase1_valid[IOBOARD_TEST_DI_COUNT_EXPECT];
+
+/* ===================== 延时与开出安全 ===================== */
+
+/* 基于 HAL_GetTick 的绝对时刻节拍延时。
+ * 为什么不用 `for (;;) { osDelay(1); }` 的近似凑数:tick 是 HAL 时基(TIM7,1 ms),
+ * 与调度器无关,绝对时刻判定在 tick 回绕处用无符号减法也安全。
+ *
+ * 函数功能:阻塞指定毫秒数,期间以 osDelay(1) 让出 CPU。
+ * 入口参数:ms - 延时毫秒数(0 时立即返回)
+ * 返回值:无
+ * 限定条件:仅限任务上下文(内部调 osDelay);不保证精确到 1 ms,只会 >= ms。
+ * 函数说明:用 HAL_GetTick() 的绝对时刻而非累加 osDelay(1) 的次数,
+ * 因此调度的抖动不会累积成"人工窗口整体偏短"。
+ */
+static void ioboard_io_delay(uint32_t ms)
+{
+ uint32_t start = HAL_GetTick();
+
+ /* 反码比较:tick 回绕(49 天)时判定仍然正确 */
+ while ((uint32_t)(HAL_GetTick() - start) < ms) {
+ osDelay(1);
+ }
+}
+
+/*
+ * 全释放的**唯一出口**:任何失败路径、任何 Phase 收尾、线程退出前都必须过这里。
+ * 打印与断言分开——这样"释放"这个动作本身不会被套件的统计口径影响。
+ *
+ * 「与极性一致」的判法:ioboard_do_read_level() 给的是**电气电平**(1 = 引脚为高),
+ * 而 IOBOARD_DO_LEVEL_ACTIVE 定义了「吸合 = 高还是低」。两者按位异或 RELEASE 电平,
+ * 就把电气电平折回「是否吸合」,极性宏一旦被改,本判据自动跟着改。
+ *
+ * 函数功能:ioboard_do_write(0) 全释放,并回读电气电平核对是否真回到 RELEASE。
+ * 入口参数:where - 调用点标识(纯 ASCII,进日志用于定位是哪个 Phase 释放的)
+ * 返回值:无
+ * 限定条件:仅套件线程调用;内部不修改测试统计(避免"释放"动作污染 PASS/FAIL 计数)。
+ * 函数说明:写失败或回读不符都只打 !!! 级告警而不计 FAIL —— 这类故障意味着
+ * 硬件/驱动异常,台架日志里那条 !!! 比统计数字显眼得多。
+ */
+static void ioboard_release_all(const char *where)
+{
+ uint8_t level = 0xFFu;
+ bsp_err_t rc = ioboard_do_write(0u);
+
+ if (rc != BSP_OK) {
+ DBG_ERROR("!!! RELEASE FAILED (%s): ioboard_do_write(0) ret=%d !!!",
+ where, (int)rc);
+ return;
+ }
+
+ (void)ioboard_do_read_level(&level);
+ if ((uint8_t)(level & IOBOARD_TEST_DO_MASK_ALL) !=
+ (uint8_t)(IOBOARD_DO_LEVEL_RELEASE & IOBOARD_TEST_DO_MASK_ALL)) {
+ DBG_ERROR("!!! RELEASE READBACK MISMATCH (%s): level=0x%02X expect release !!!",
+ where, (unsigned int)level);
+ }
+}
+
+/* 失败即刹车的醒目告警 + 全释放
+ *
+ * 函数功能:先在日志里打一条高可见度分隔告警(台架日志滚屏时不会被忽略),
+ * 再走 ioboard_release_all() 全释放。
+ * 入口参数:why - 失败原因(纯 ASCII,直接进日志)
+ * 返回值:无
+ * 限定条件:仅套件线程调用。本函数不修改测试统计——
+ * "释放动作是否成功"由 release_all 内部自行告警,不计入 PASS/FAIL 数。
+ */
+static void ioboard_emergency_release(const char *why)
+{
+ DBG_ERROR("================ IOBOARD ALARM ================");
+ DBG_ERROR("!! %s -> all 4 relays released NOW !!", why);
+ ioboard_release_all("emergency");
+ DBG_ERROR("===============================================");
+}
+
+/* ===================== Phase 0:自检 ===================== */
+
+/*
+ * 函数功能:Phase 0 —— 确认开入开出驱动在本构建下可用,并打出开出的当前原始电平。
+ * 入口参数:无
+ * 返回值:1 = 自检通过(驱动就绪、开出可读可写);0 = 不通过,调用方应整体判 FAIL
+ * 限定条件:仅套件线程调用;内部分别走一次 ioboard_di_read() 与 ioboard_do_read_level()。
+ * 函数说明:本题不做「值对不对」的判断——那要靠 Phase 1/3 的人工配合。
+ * 这里只回答一个前置问题:驱动是不是活的。
+ * 若驱动未初始化(g_ioboard_main_rc 失败)或读回 BSP 错误,
+ * 后面所有 Phase 的失败都会失去归因意义,故必须先停下来。
+ */
+static int ioboard_phase_selftest(void)
+{
+ bsp_err_t rc;
+ uint8_t shadow = 0xFFu;
+ uint8_t level = 0xFFu;
+ int ok = 1;
+
+ DBG_INFO("=== IOBOARD Phase 0: self test (init / release state) ===");
+
+ rc = ioboard_init();
+ IOBOARD_TEST_CHECK(rc == BSP_OK,
+ "ioboard_init() ret=%d (expect 0; BSP_ERR_STATE=pin idle check failed)",
+ (int)rc);
+ if (rc != BSP_OK) {
+ DBG_ERROR("Phase 0 FAIL: ioboard_init() != BSP_OK -> ABORT whole suite");
+ ok = 0;
+ }
+
+ rc = ioboard_do_get(&shadow);
+ IOBOARD_TEST_CHECK(rc == BSP_OK, "ioboard_do_get() ret=%d", (int)rc);
+
+ rc = ioboard_do_read_level(&level);
+ IOBOARD_TEST_CHECK(rc == BSP_OK, "ioboard_do_read_level() ret=%d", (int)rc);
+
+ DBG_INFO(" DO shadow=0x%02X (bit0=KO6 bit1=TRIP bit2=ERT bit3=CLZ), GPIO level=0x%02X",
+ (unsigned int)shadow, (unsigned int)level);
+ DBG_INFO(" DO polarity: ACTIVE=%u RELEASE=%u",
+ (unsigned int)IOBOARD_DO_LEVEL_ACTIVE,
+ (unsigned int)IOBOARD_DO_LEVEL_RELEASE);
+
+ IOBOARD_TEST_CHECK((uint8_t)(shadow & IOBOARD_TEST_DO_MASK_ALL) == 0u,
+ "all 4 DO released at entry (shadow=0x%02X expect 0x00)",
+ (unsigned int)shadow);
+ IOBOARD_TEST_CHECK((uint8_t)(level & IOBOARD_TEST_DO_MASK_ALL) ==
+ (uint8_t)(IOBOARD_DO_LEVEL_RELEASE & 0x0Fu),
+ "all 4 DO pins at RELEASE level (level=0x%02X)",
+ (unsigned int)level);
+
+ IOBOARD_TEST_REPORT("Phase 0 self test");
+ return ok;
+}
+
+/* ===================== 开入采样内核 ===================== */
+
+/*
+ * 采样一轮:在 gap_ms 内连读 samples 次,给出按位与/按位或与失败次数。
+ * 返回值:0 = 本轮的读成功次数都是 0(无法判定);1 = 至少读到一次。
+ */
+static uint8_t ioboard_di_sample(uint32_t samples, uint32_t gap_ms,
+ uint8_t *out_all, uint8_t *out_any,
+ uint32_t *out_ok, uint32_t *out_fail)
+{
+ uint8_t allv = IOBOARD_TEST_DI_MASK_ALL;
+ uint8_t anyv = 0u;
+ uint32_t ok = 0u;
+ uint32_t fail = 0u;
+ uint32_t i;
+ uint8_t m = 0u;
+
+ for (i = 0u; i < samples; i++) {
+ if (ioboard_di_read(&m) == BSP_OK) {
+ allv = (uint8_t)(allv & m);
+ anyv = (uint8_t)(anyv | m);
+ ok++;
+ } else {
+ fail++;
+ }
+ if (gap_ms > 0u) {
+ ioboard_io_delay(gap_ms);
+ }
+ }
+
+ if (out_all != NULL) { *out_all = allv; }
+ if (out_any != NULL) { *out_any = anyv; }
+ if (out_ok != NULL) { *out_ok = ok; }
+ if (out_fail != NULL) { *out_fail = fail; }
+
+ return (ok > 0u) ? 1u : 0u;
+}
+
+/* 把 mask 写成 "bit7..bit0" 的可读串(1 = 该路开入为高)。
+ * buf 至少 IOBOARD_TEST_DI_COUNT_EXPECT + 1 字节。
+ *
+ * 函数功能:把 8 位开入 mask 渲染成 "01101001" 这样的定宽串,供日志逐位对照。
+ * 入口参数:mask - 开入 mask(bit7..bit0 对应 H..A 通道);buf - 输出缓冲
+ * 返回值:无
+ * 限定条件:buf 长度 >= IOBOARD_TEST_DI_COUNT_EXPECT + 1(含结尾 NUL),本函数不校验。
+ * 函数说明:为什么不用 %02X 就够了——十六进制要人在脑子里拆位,
+ * 而位序判据恰恰是"哪一位变了",定宽串让日志可以逐位目视比对。
+ */
+static void ioboard_di_mask_str(uint8_t mask, char *buf)
+{
+ uint32_t bit;
+
+ for (bit = 0u; bit < (uint32_t)IOBOARD_TEST_DI_COUNT_EXPECT; bit++) {
+ uint32_t pos = (uint32_t)(IOBOARD_TEST_DI_COUNT_EXPECT - 1U) - bit;
+ buf[bit] = (((mask >> pos) & 1u) != 0u) ? '1' : '0';
+ }
+ buf[IOBOARD_TEST_DI_COUNT_EXPECT] = '\0';
+}
+
+/* ===================== Phase 1:开入位序(主判据) ===================== */
+
+/*
+ * 函数功能:Phase 1 —— 逐路提示短接,验开入位序(本套件的**主判据**)。
+ * 入口参数:无
+ * 返回值:无(结果计入 g_ioboard_test_stats)
+ * 限定条件:需人工配合;每路给 IOBOARD_TEST_DI_ARM_MS 的动手窗口,超时不报错只采样。
+ * 函数说明:判据分三层,从弱到强——
+ * ① 单路:短接后**只有**该路对应的 bit 变化;
+ * ② 单路:**其余 7 位保持不变**(防"一短接就整体漂"的接线错误);
+ * ③ 双射(主判据):8 路各自得到的掩码必须是 8 个互不相同、各含 1 个 1 的掩码,
+ * 合起来恰好覆盖 bit0~bit7 全集。
+ * 为什么双射比"全短接读 0xFF / 全断开读 0x00"可靠:全 0 与全 1 对位序不敏感——
+ * 哪怕 A~H 的线整组接反,全 0/全 1 依然成立。只有"每路单独变化 + 8 个掩码互不相同"
+ * 才能把"接反"与"接错位"区分出来。混合图样只作辅助打印,不计入判据。
+ */
+static void ioboard_phase_di_order(void)
+{
+ uint8_t baseline = 0u;
+ uint8_t allv = 0u;
+ uint8_t anyv = 0u;
+ uint32_t ok = 0u;
+ uint32_t fail = 0u;
+ uint32_t i;
+ uint8_t used = 0u;
+ int bij = 1;
+ char line[IOBOARD_TEST_DI_COUNT_EXPECT + 1U];
+
+ DBG_INFO("=== IOBOARD Phase 1: DI bit order (one channel at a time + bijection) ===");
+
+ /* 基线:全部断开时应为 0。先采一轮建立"静止基准",后面每一路都以它为参照。 */
+ if (ioboard_di_sample(IOBOARD_TEST_DI_SAMPLES, IOBOARD_TEST_DI_SAMPLE_GAP_MS,
+ &allv, &anyv, &ok, &fail) == 0u) {
+ DBG_ERROR("Phase 1 ABORT: cannot read DI at all (all %u reads failed)",
+ (unsigned int)IOBOARD_TEST_DI_SAMPLES);
+ IOBOARD_TEST_CHECK(0, "DI readable at Phase 1 entry (all reads failed)");
+ IOBOARD_TEST_REPORT("Phase 1 DI order");
+ return;
+ }
+ baseline = allv;
+ ioboard_di_mask_str(baseline, line);
+ IOBOARD_TEST_CHECK(anyv == allv,
+ "DI quiescent baseline stable during sampling (all=0x%02X any=0x%02X)",
+ (unsigned int)allv, (unsigned int)anyv);
+ DBG_INFO(" baseline (all DI open) = 0x%02X [bit7..bit0]=%s",
+ (unsigned int)baseline, line);
+
+ for (i = 0u; i < (uint32_t)IOBOARD_TEST_DI_COUNT_EXPECT; i++) {
+ uint8_t active = 0u;
+ uint8_t diff = 0u;
+ uint8_t others = 0u;
+ int one_bit;
+
+ s_phase1_mask[i] = 0u;
+ s_phase1_valid[i] = 0u;
+
+ DBG_INFO(" [%u/8] SHORT %s now (short DI terminal %u to common) .. sampling in %u ms",
+ (unsigned int)(i + 1u), k_di_name[i], (unsigned int)(i + 1u),
+ (unsigned int)IOBOARD_TEST_DI_ARM_MS);
+ ioboard_io_delay(IOBOARD_TEST_DI_ARM_MS);
+
+ if (ioboard_di_sample(IOBOARD_TEST_DI_SAMPLES, IOBOARD_TEST_DI_SAMPLE_GAP_MS,
+ &allv, &anyv, &ok, &fail) == 0u) {
+ IOBOARD_TEST_CHECK(0, "%s: DI unreadable while expected SHORTED (%u failed reads)",
+ k_di_name[i], (unsigned int)fail);
+ DBG_INFO(" -> release %s; waiting for next channel", k_di_name[i]);
+ continue;
+ }
+
+ active = allv;
+ diff = (uint8_t)(active ^ baseline);
+ /* "其余 7 位保持不变" = 只有 baseline 为 0 的那些位不许置 1;
+ * baseline 里本来就是 1 的位不参与这项(很多台架 DI 采用常闭/常开混接,
+ * 硬要求全 0 会把正确接线判成失败,见报告"与任务书的偏差")。 */
+ others = (uint8_t)(active & (uint8_t)(~baseline) & (uint8_t)(~diff));
+
+ one_bit = ((allv == anyv) && (diff != 0u) &&
+ (((uint32_t)diff & ((uint32_t)diff - 1u)) == 0u));
+
+ s_phase1_mask[i] = diff;
+ s_phase1_valid[i] = one_bit ? 1u : 0u;
+
+ ioboard_di_mask_str(active, line);
+ DBG_INFO(" read=0x%02X [bit7..bit0]=%s diff=0x%02X ok_reads=%u fails=%u",
+ (unsigned int)active, line, (unsigned int)diff,
+ (unsigned int)ok, (unsigned int)fail);
+
+ IOBOARD_TEST_CHECK(allv == anyv,
+ "%s: stable across %u samples (all=0x%02X any=0x%02X)",
+ k_di_name[i], (unsigned int)IOBOARD_TEST_DI_SAMPLES,
+ (unsigned int)allv, (unsigned int)anyv);
+ IOBOARD_TEST_CHECK(diff != 0u,
+ "%s: shorting it changed DI mask vs baseline=0x%02X (diff=0x%02X)",
+ k_di_name[i], (unsigned int)baseline, (unsigned int)diff);
+ IOBOARD_TEST_CHECK(others == 0u,
+ "%s: only this bit rose (other bits raised=0x%02X expect 0x00)",
+ k_di_name[i], (unsigned int)others);
+ IOBOARD_TEST_CHECK(one_bit,
+ "%s: exactly one bit changed (diff=0x%02X popcount must be 1)",
+ k_di_name[i], (unsigned int)diff);
+
+ if (one_bit) {
+ uint32_t p = 0u;
+ while ((((uint32_t)diff >> p) & 1u) == 0u) {
+ p++;
+ }
+ DBG_INFO(" -> %s maps to DI bit%u (terminal %u)",
+ k_di_name[i], (unsigned int)p, (unsigned int)(i + 1u));
+ } else {
+ DBG_ERROR(" -> %s did NOT produce a single-bit change; check terminal %u wiring",
+ k_di_name[i], (unsigned int)(i + 1u));
+ }
+
+ DBG_INFO(" RELEASE %s now; next channel in %u ms",
+ k_di_name[i], (unsigned int)IOBOARD_TEST_DI_ARM_MS);
+ /* 通道间留出"松开上一个、准备下一个"的时间,同时让本路变化回落到基线 */
+ ioboard_io_delay(IOBOARD_TEST_DI_ARM_MS);
+ }
+
+ /* 双射核对:8 次单比特结果必须两两不同,且并起来恰好覆盖 bit0..bit7 */
+ for (i = 0u; i < (uint32_t)IOBOARD_TEST_DI_COUNT_EXPECT; i++) {
+ if (s_phase1_valid[i] == 0u) {
+ bij = 0;
+ } else {
+ uint8_t dup = (uint8_t)(used & s_phase1_mask[i]);
+ if (dup != 0u) {
+ bij = 0;
+ }
+ used = (uint8_t)(used | s_phase1_mask[i]);
+ }
+ }
+ DBG_INFO(" bijection: union of per-channel masks = 0x%02X (expect 0x%02X)",
+ (unsigned int)used, (unsigned int)IOBOARD_TEST_DI_MASK_ALL);
+ IOBOARD_TEST_CHECK(used == IOBOARD_TEST_DI_MASK_ALL,
+ "bijection: 8 single-bit masks cover bit0..bit7 (union=0x%02X)",
+ (unsigned int)used);
+ IOBOARD_TEST_CHECK(bij == 1,
+ "bijection: 8 masks are 8 distinct single-bit values (no duplicate/multi-bit)");
+
+ /* 混合图样只作辅助:全断开读 0x00 / 全短接读 0xFF 对位序不敏感 */
+ IOBOARD_TEST_CHECK(baseline == 0x00u,
+ "aux: all DI open reads 0x00 (got 0x%02X; non-zero may be field wiring)",
+ (unsigned int)baseline);
+
+ DBG_INFO(" if any DI_x FAILED with 'exactly one bit': the terminal numbering in this"
+ " log is what you shorted - check the wiring of that terminal");
+ IOBOARD_TEST_REPORT("Phase 1 DI order");
+}
+
+/* ===================== Phase 2:回差与稳定性 ===================== */
+
+/*
+ * 函数功能:Phase 2 —— 全断开保持期间连采多轮,验开入读数无抖动、无回差。
+ * 入口参数:无
+ * 返回值:无(结果计入 g_ioboard_test_stats)
+ * 限定条件:需人工保持全部 DI 端子断开;中途读取失败即中止本轮判据。
+ * 函数说明:每轮连读 IOBOARD_TEST_DI_SAMPLES 次,本轮内 all == any 才算"无抖动";
+ * 轮与轮之间的读数必须完全一致才算"无回差"。
+ * 判据选"轮内 all==any + 跨轮相等"而不是"20 次全等",是因为前者能区分
+ * 两种不同故障:轮内抖 = 触点/去抖没生效;跨轮不等 = 回差或干扰。
+ * 读失败时报 FAIL 并中止,不把"读不到"稀释成"数值不一致"。
+ */
+static void ioboard_phase_di_stable(void)
+{
+ uint8_t allv = 0u;
+ uint8_t anyv = 0u;
+ uint32_t ok = 0u;
+ uint32_t fail = 0u;
+ uint32_t round;
+ uint8_t first = 0xFFu;
+ uint8_t differs = 0u;
+ char line[IOBOARD_TEST_DI_COUNT_EXPECT + 1U];
+
+ DBG_INFO("=== IOBOARD Phase 2: DI stability with all channels open ===");
+ DBG_INFO(" KEEP ALL DI TERMINALS OPEN for the next ~%u ms",
+ (unsigned int)(IOBOARD_TEST_DI_STABLE_ROUNDS *
+ (IOBOARD_TEST_DI_SAMPLES * IOBOARD_TEST_DI_SAMPLE_GAP_MS)));
+
+ for (round = 0u; round < (uint32_t)IOBOARD_TEST_DI_STABLE_ROUNDS; round++) {
+ /* 读失败即中止采样:继续读只会把「读不到」稀释成「数值不一致」,
+ * 那是把硬件故障误报成稳定性问题。用 break 退出(规范 CODE-RULE-07 禁 goto),
+ * 已采到的 first/differs 在循环后照常打印。 */
+ if (ioboard_di_sample(IOBOARD_TEST_DI_SAMPLES, IOBOARD_TEST_DI_SAMPLE_GAP_MS,
+ &allv, &anyv, &ok, &fail) == 0u) {
+ IOBOARD_TEST_CHECK(0, "stability round %u: DI unreadable (%u failed reads)",
+ (unsigned int)round, (unsigned int)fail);
+ break;
+ }
+
+ if (round == 0u) {
+ first = allv;
+ } else if (allv != first) {
+ differs++;
+ ioboard_di_mask_str(allv, line);
+ DBG_ERROR(" round %u differs: 0x%02X [bit7..bit0]=%s",
+ (unsigned int)round, (unsigned int)allv, line);
+ }
+ IOBOARD_TEST_CHECK(allv == anyv,
+ "stability round %u: no jitter inside round (all=0x%02X any=0x%02X)",
+ (unsigned int)round, (unsigned int)allv, (unsigned int)anyv);
+ }
+
+ /* 无论是否中途 break,都把「读到的第一轮值」和一致性结论打出来:
+ * abort_round 只影响「本轮判据是否算数」,不影响已经采到的证据。 */
+ (void)ok;
+ ioboard_di_mask_str(first, line);
+ DBG_INFO(" first-round reading = 0x%02X [bit7..bit0]=%s",
+ (unsigned int)first, line);
+ IOBOARD_TEST_CHECK(differs == 0u,
+ "stability: %u rounds all read the same value (differs=%u)",
+ (unsigned int)IOBOARD_TEST_DI_STABLE_ROUNDS, (unsigned int)differs);
+ IOBOARD_TEST_REPORT("Phase 2 DI stability");
+}
+
+/* ===================== Phase 3:开出逐个点动 ===================== */
+
+/*
+ * 函数功能:Phase 3 —— 4 路开出逐个点动(空载),验动作与回读极性。
+ * 入口参数:无
+ * 返回值:无(结果计入 g_ioboard_test_stats)
+ * 限定条件:需人工听继电器动作声;**开出当前空载**,可安全点动。
+ * 函数说明:每路点动时长 IOBOARD_TEST_DO_ARM_MS(1 s,空载继电器动作声足以辨认)。
+ * 判据三条:
+ * ① ioboard_do_read_level() 回读电平与 IOBOARD_DO_LEVEL_ACTIVE 极性一致;
+ * ② 其余 3 路保持不吸合(防"一位写全组动"的锁存错误);
+ * ③ 释放后回读全部回到 IOBOARD_DO_LEVEL_RELEASE。
+ * ⚠ 若判据 ① 全线失败,第一嫌疑是**极性宏写反**而不是硬件损坏:
+ * ioboard.h 的 README 步骤 2 明确"DO 极性未在板上验证"。
+ * 日志里同时打出 RELEASE 与 ACTIVE 两个电平值,就是为了一眼分辨这一点。
+ * 任何一路写失败立即 ioboard_emergency_release 刹车并终止后续点动。
+ */
+static void ioboard_phase_do_actuation(void)
+{
+ uint32_t i;
+
+ DBG_INFO("=== IOBOARD Phase 3: DO relay tap test (4 relays, NO LOAD) ===");
+ DBG_INFO(" listen for the relay click; release level = %u, active level = %u",
+ (unsigned int)IOBOARD_DO_LEVEL_RELEASE, (unsigned int)IOBOARD_DO_LEVEL_ACTIVE);
+
+ for (i = 0u; i < (uint32_t)IOBOARD_TEST_DO_COUNT_EXPECT; i++) {
+ uint8_t one = (uint8_t)(IOBOARD_TEST_DO_MASK_ALL & (uint8_t)(~k_do_bit[i]));
+ uint8_t shadow = 0xFFu;
+ uint8_t level = 0xFFu;
+ uint32_t active_bits;
+ bsp_err_t rc;
+
+ DBG_INFO(" [%u/4] CUE: %s relay will CLOSE for %u ms .. listen for click",
+ (unsigned int)(i + 1u), k_do_name[i], (unsigned int)IOBOARD_TEST_DO_ARM_MS);
+ rc = ioboard_do_write(one);
+ if (rc != BSP_OK) {
+ IOBOARD_TEST_CHECK(0, "%s: ioboard_do_write(0x%02X) ret=%d",
+ k_do_name[i], (unsigned int)one, (int)rc);
+ ioboard_emergency_release("ioboard_do_write failed");
+ ioboard_release_all("after emergency");
+ continue;
+ }
+
+ ioboard_io_delay(IOBOARD_TEST_DO_ARM_MS);
+
+ (void)ioboard_do_get(&shadow);
+ (void)ioboard_do_read_level(&level);
+
+ /* "与极性一致":按 IOBOARD_DO_LEVEL_ACTIVE 把电气电平折回"是否吸合" */
+ active_bits = ((level ^ (uint8_t)(IOBOARD_DO_LEVEL_RELEASE & 0x0Fu)) & 0x0Fu);
+
+ DBG_INFO(" shadow=0x%02X level=0x%02X -> attracted=0x%02X (expected 0x%02X)",
+ (unsigned int)shadow, (unsigned int)level,
+ (unsigned int)active_bits, (unsigned int)k_do_bit[i]);
+
+ IOBOARD_TEST_CHECK((uint8_t)(shadow & 0x0Fu) == one,
+ "%s: shadow=0x%02X (expect 0x%02X: only this bit set)",
+ k_do_name[i], (unsigned int)shadow, (unsigned int)one);
+ IOBOARD_TEST_CHECK((active_bits & k_do_bit[i]) != 0u,
+ "%s: pin at ACTIVE level while commanded (level=0x%02X)",
+ k_do_name[i], (unsigned int)level);
+ IOBOARD_TEST_CHECK((active_bits | k_do_bit[i]) == k_do_bit[i],
+ "%s: other 3 relays stay released (attracted=0x%02X)",
+ k_do_name[i], (unsigned int)active_bits);
+
+ /* 立即释放,并核对全部回到不吸合 */
+ ioboard_release_all("after tap");
+ (void)ioboard_do_read_level(&level);
+ IOBOARD_TEST_CHECK((uint8_t)(level & 0x0Fu) ==
+ (uint8_t)(IOBOARD_DO_LEVEL_RELEASE & 0x0Fu),
+ "%s: all 4 released after tap (level=0x%02X)",
+ k_do_name[i], (unsigned int)level);
+ ioboard_io_delay(IOBOARD_TEST_DO_RELEASE_MS);
+ }
+
+ IOBOARD_TEST_REPORT("Phase 3 DO actuation");
+}
+
+/* ===================== 序列主体 ===================== */
+
+/*
+ * 函数功能:按 Phase 0→4 的顺序跑完整条半自动序列。
+ * 入口参数:无
+ * 返回值:无(结果全部计入 g_ioboard_test_stats)
+ * 限定条件:仅由套件线程调用;Phase 0 自检失败即整体中止(后续判据失去归因意义)。
+ * 函数说明:开头无条件 ioboard_release_all("suite entry"),Phase 之间每次跳转前
+ * 都过一次 release_all —— 这样"任何一条路径都不留下吸合的继电器"
+ * 只依赖一处实现,而不是每个分支各写一遍。
+ */
+static void ioboard_test_body(void)
+{
+ int selftest_ok;
+
+ DBG_INFO("");
+ DBG_INFO("#### IOBOARD test suite: semi-automatic bench sequence ####");
+ DBG_INFO("#### You will be asked to SHORT DI terminals one by one, then ####");
+ DBG_INFO("#### to listen for relay clicks. Follow the cues; 3 s per step. ####");
+ DBG_INFO("#### Strings are English-only; order matches the log lines. ####");
+ DBG_INFO("");
+
+ (void)memset(&g_ioboard_test_stats, 0, sizeof(g_ioboard_test_stats));
+
+ /* 任何异常退出(Phase 之间 return、断言崩溃之外)都保证全释放 */
+ ioboard_release_all("suite entry");
+
+#ifdef ENABLE_IOBOARD_SELFTEST_TESTS
+ selftest_ok = ioboard_phase_selftest();
+ if (selftest_ok == 0) {
+ DBG_ERROR("suite ABORT after Phase 0: ioboard_init() failed, DI/DO tests skipped");
+ ioboard_release_all("abort after Phase 0");
+ return;
+ }
+#else
+ selftest_ok = 1;
+#endif
+
+#ifdef ENABLE_IOBOARD_DI_ORDER_TESTS
+ ioboard_phase_di_order();
+#else
+ (void)selftest_ok;
+#endif
+
+#ifdef ENABLE_IOBOARD_DI_STABLE_TESTS
+ ioboard_phase_di_stable();
+#endif
+
+ /* Phase 3 前再确认一次释放:DI 阶段结束后开出必须仍是全释放 */
+ ioboard_release_all("before Phase 3");
+
+#ifdef ENABLE_IOBOARD_DO_TESTS
+ ioboard_phase_do_actuation();
+#endif
+
+ /* Phase 4:重置(无论前序成败) */
+ DBG_INFO("=== IOBOARD Phase 4: reset (all DO released) ===");
+ ioboard_release_all("Phase 4 reset");
+}
+
+/*
+ * 函数功能:套件线程入口 —— 跑序列主体、结束后无条件全释放、打印汇总、自行退出。
+ * 入口参数:argument - 未使用(xTaskCreateStatic 传 NULL)
+ * 返回值:无(线程退出即删除自己)
+ * 限定条件:只允许由 ioboard_test_run() 经 xTaskCreateStatic 创建,且只创建一次。
+ * 函数说明:release_all 在这里再走一次是**刻意冗余**——主体内部各 Phase 已经释放过,
+ * 但线程退出是最后一刻,"末尾再确认一次"让安全口径不依赖主体的控制流。
+ * 随后单独断言并 REPORT,保证即使主体提前 return 也一定打出汇总行。
+ */
+static void ioboard_thread_entry(void *argument)
+{
+ uint8_t level = 0xFFu;
+
+ (void)argument;
+
+ ioboard_test_body();
+
+ /* 序列结束(无论成败)必须全释放,并单独记一条断言:这是安全口径的最后一道 */
+ ioboard_release_all("suite end");
+ (void)ioboard_do_read_level(&level);
+ IOBOARD_TEST_CHECK((uint8_t)(level & 0x0Fu) ==
+ (uint8_t)(IOBOARD_DO_LEVEL_RELEASE & 0x0Fu),
+ "final: all 4 DO at RELEASE level after suite (level=0x%02X)",
+ (unsigned int)level);
+
+ IOBOARD_TEST_REPORT(IOBOARD_TEST_SUMMARY_NAME);
+ DBG_INFO("IOBOARD test suite done (relays released, thread exits)");
+}
+
+/* ===================== 套件入口 ===================== */
+
+/*
+ * 为什么自起线程而不是在 testTask 上下文直接跑:
+ * testTask 的优先级是 osPriorityBelowNormal(Src/freertos.c 的 testTask_attributes),
+ * 低于 defaultTask(Normal)。本套件绝大部分时间是 osDelay 等人工窗口,
+ * 若在 testTask 里等,defaultTask 每轮 1 ms 的控制台排空循环会让它久久抢不到 CPU,
+ * 人工窗口随之失真(提示打印后还没开始采样就又被推迟)。自起的线程用 Normal,
+ * 与 defaultTask 同级公平轮转。
+ *
+ * 线程 TCB 走 xTaskCreateStatic:本仓禁用 C 库堆分配,且静态 TCB 让栈尺寸固定可核算
+ * (Inc/FreeRTOSConfig.h 的 configSUPPORT_STATIC_ALLOCATION = 1)。
+ * 栈 4 KB(1024 words)。**实测值**(scripts/stack_report.py,由本次 IOBOARD 构建的
+ * 静态调用图得出):本线程最坏链 1760 B、own frame 248 B、余量 2336 B(57%),
+ * 判据要求 margin >= max(1024, 30%*4096=1228) 故 PASS。最坏链落在**失败分支**
+ * (emergency_release 打告警那条),正是最该留余量的地方。
+ *
+ * 函数功能:套件入口。打启动横幅与开出现状、先全释放、自起套件线程后立即返回。
+ * 入口参数:无
+ * 返回值:无
+ * 限定条件:由 start_test_task 在 testTask 上下文调用一次;**本函数不等线程结束**。
+ * 函数说明:返回而不是 join 的原因见上面两段——testTask 优先级低且只做 osDelay,
+ * 套件的时序必须由 Normal 优先级的独立线程掌握。
+ * 若线程创建失败:记一条 FAIL + REPORT 后返回(此时开出已在上面强制释放)。
+ */
+void ioboard_test_run(void)
+{
+ TaskHandle_t h_thread = NULL;
+ uint8_t do_shadow = 0xFFu;
+ uint8_t do_level = 0xFFu;
+
+ DBG_INFO("IOBOARD test suite started (semi-automatic; self-spawned thread prio=Normal)");
+ DBG_INFO("thread stack: %u B static (TCB static, no heap)", (unsigned int)sizeof(s_ioboard_thread_stack));
+
+ /* 启动期先全释放并核对一次:套件条目之前若有人(上电残留、上一轮台架)动过开出,
+ * 这一行会把事实连同电气电平一起打出来,而不是等到 Phase 0。 */
+ (void)ioboard_do_get(&do_shadow);
+ (void)ioboard_do_read_level(&do_level);
+ (void)ioboard_do_write(0u); /* 启动期无条件全释放 */
+ DBG_INFO(" DO before start: shadow=0x%02X level=0x%02X -> forced to release",
+ (unsigned int)do_shadow, (unsigned int)do_level);
+
+ h_thread = xTaskCreateStatic(ioboard_thread_entry, "iobTest",
+ (uint32_t)(sizeof(s_ioboard_thread_stack) / sizeof(StackType_t)),
+ NULL, (UBaseType_t)IOBOARD_TEST_THREAD_PRIO,
+ s_ioboard_thread_stack, &s_ioboard_thread_tcb);
+ if (h_thread == NULL) {
+ DBG_ERROR("xTaskCreateStatic failed -> suite NOT run (relays already released)");
+ IOBOARD_TEST_CHECK(0, "xTaskCreateStatic() for suite thread returned NULL");
+ IOBOARD_TEST_REPORT(IOBOARD_TEST_SUMMARY_NAME);
+ return;
+ }
+
+ DBG_INFO("suite thread created (static TCB + static stack); testTask returns to idle loop");
+}
+
+#endif /* TEST_SUITE_IOBOARD */
diff --git a/test/board/test_config.c b/test/board/test_config.c
index 8adad1ee..eeff17c3 100644
--- a/test/board/test_config.c
+++ b/test/board/test_config.c
@@ -5,8 +5,8 @@
* TEST_SUITE_* 宏,将测试分发到对应套件的运行函数。
*
* 各套件运行函数(ch395f_test_run / storage_test_run / gd5f_test_run
- * / sd2506_test_run)各自实现具体测试逻辑,本文件只负责"选哪个跑",
- * 不掺杂任何具体测试细节,使测试入口界限清晰、易于维护。
+ * / sd2506_test_run / ioboard_test_run)各自实现具体测试逻辑,本文件
+ * 只负责"选哪个跑",不掺杂任何具体测试细节,使测试入口界限清晰、易于维护。
* 作者:王建锋
* 创建日期:2026-08-29
******************************************************************************/
@@ -21,6 +21,7 @@
#include "storage_test.h"
#include "gd5f_test.h"
#include "sd2506_test.h"
+#include "ioboard_test.h"
/*
* 测试任务统一入口(FreeRTOS start_test_task 线程函数)。
@@ -40,6 +41,9 @@ void start_test_task(void *argument)
gd5f_test_run();
#elif defined(TEST_SUITE_RTC)
sd2506_test_run();
+#elif defined(TEST_SUITE_IOBOARD)
+ /* ioboard_test_run() 自起 Normal 优先级线程后立即返回(理由见 ioboard_test_task.c) */
+ ioboard_test_run();
#else
DBG_INFO("No test suite selected (normal product build)");
#endif
diff --git a/test/board/test_config.h b/test/board/test_config.h
index fb50672e..c7ef099f 100644
--- a/test/board/test_config.h
+++ b/test/board/test_config.h
@@ -11,6 +11,8 @@
* TEST_SUITE_CH395F : CH395F 测试(沿用 ch395f_test.h 阶段宏,HW 1~5 / NET 6~11)
* TEST_SUITE_STORAGE : FTL + FatFS 存储测试(从 defaultTask 迁入)
* TEST_SUITE_GD5F : GD5F2GQ5UE NAND 驱动测试
+ * TEST_SUITE_RTC : SD2506 RTC 测试
+ * TEST_SUITE_IOBOARD : 开入开出板测试(8 路 DI 位序 + 4 路 DO 点动,半自动)
*/
#ifndef TEST_CONFIG_H
@@ -22,7 +24,7 @@ extern "C" {
#include
-/* === 选择当前构建的测试套件(三选一,或都注释 = 正常产品构建)===
+/* === 选择当前构建的测试套件(五选一,或都注释 = 正常产品构建)===
* ⚠️ 默认必须是**产品构建**(全部注释)——pre-commit 钩子 `test-suite-switch` 会拦截
* 未显式放行的测试构建(`--allow-test-build` / `ALLOW_TEST_BUILD=1`)。
* 跑套件回归时取消注释所需套件;跑完务必改回、或直接用 `test/run_all_suites.py`
@@ -31,6 +33,7 @@ extern "C" {
//#define TEST_SUITE_STORAGE
//#define TEST_SUITE_GD5F
//#define TEST_SUITE_RTC
+//#define TEST_SUITE_IOBOARD
/* === 破坏性测试总开关(默认关闭)===
* 破坏性用例会改变设备的**持久状态**,跑一次即有代价(2026-09-21 实测:GD5F 整轮
@@ -42,7 +45,7 @@ extern "C" {
* 仅在**产品首次上电/产线首启**或明确需要时打开;打开跑完建议做一次恢复。 */
//#define ENABLE_DESTRUCTIVE_TESTS
-#if defined(TEST_SUITE_CH395F) + defined(TEST_SUITE_STORAGE) + defined(TEST_SUITE_GD5F) + defined(TEST_SUITE_RTC) > 1
+#if defined(TEST_SUITE_CH395F) + defined(TEST_SUITE_STORAGE) + defined(TEST_SUITE_GD5F) + defined(TEST_SUITE_RTC) + defined(TEST_SUITE_IOBOARD) > 1
#error "测试套件互斥:一次构建只能启用一个 TEST_SUITE_*"
#endif
@@ -54,8 +57,10 @@ extern "C" {
* 创建"的旧疑点不成立(实测 RTC 套件正常执行;RTC 已计入下方析取,故 RTC 构建下本
* 标记亦置位、testTask 正常保留)。
* 4 个套件(含 RTC)在此补齐:若将来再引入"测试构建下 defaultTask 空闲"等分支而复用
- * 本标记,可避免重演"漏 RTC"的隐患。详见 docs/测试说明/板级测试/实机测试实施指南.md §8.3。 */
-#if defined(TEST_SUITE_CH395F) || defined(TEST_SUITE_STORAGE) || defined(TEST_SUITE_GD5F) || defined(TEST_SUITE_RTC)
+ * 本标记,可避免重演"漏 RTC"的隐患。IOBOARD 同批补入(本标记的另一消费点 =
+ * `Src/freertos.c` 对 testTask 的回收,漏一个套件就等于该套件的 testTask 被回收、
+ * 套件永不执行,且不报错)。详见 docs/测试说明/板级测试/实机测试实施指南.md §8.3。 */
+#if defined(TEST_SUITE_CH395F) || defined(TEST_SUITE_STORAGE) || defined(TEST_SUITE_GD5F) || defined(TEST_SUITE_RTC) || defined(TEST_SUITE_IOBOARD)
#define TEST_SUITE_SELECTED
#endif
@@ -100,6 +105,13 @@ extern "C" {
#define TEST_SUITE_NAME "RTC"
#endif
+#ifdef TEST_SUITE_IOBOARD
+/* 开入开出板套件:行序/点动序列全在 ioboard_test_task.c;
+ * 本块只做"选它 + 给它一个名字"。 */
+#include "ioboard_test.h"
+#define TEST_SUITE_NAME "IOBOARD"
+#endif
+
#ifndef TEST_SUITE_NAME
#define TEST_SUITE_NAME "NONE"
#endif
diff --git a/test/run_all_suites.py b/test/run_all_suites.py
index 095bd134..d4734b9b 100644
--- a/test/run_all_suites.py
+++ b/test/run_all_suites.py
@@ -86,6 +86,9 @@ SUITES = {
"STORAGE": ("TEST_SUITE_STORAGE", "Storage Tests", "=== Storage Tests:", ""),
"GD5F": ("TEST_SUITE_GD5F", "GD5F2GQ5UE Tests", "=== GD5F2GQ5UE Tests:", FORBIDDEN_SUITE),
"RTC": ("TEST_SUITE_RTC", "RTC Tests", "=== RTC Tests:", ""),
+ # IOBOARD:半自动台架套件(人工按提示短接 DI / 听继电器动作)。--check-build 只编译;
+ # 完整回归要求操作员在场跟着日志节拍动手,汇总行 `=== IOBOARD Tests:` 是判定标记。
+ "IOBOARD": ("TEST_SUITE_IOBOARD", "IOBOARD Tests", "=== IOBOARD Tests:", ""),
}
# 套件名 -> 汇总行里的名称可能因模块而异,故上面的 summary 值仅为默认;实际以