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 值仅为默认;实际以