feat(ioboard): board test suite for DI/DO, fix default_task conditional compile
Bench verification of the IO board needs an observation window: production build has no consumer of ioboard_di_snap_read(), so the DI values were invisible. Add TEST_SUITE_IOBOARD as a semi-automatic bench sequence and fix two real bugs found while wiring it in. New files: - test/board/ioboard_test.h, test/board/ioboard_test_task.c Test suite: - Owns its own thread (iobTest, 4096 words) instead of running in testTask: testTask is osPriorityBelowNormal, below defaultTask whose 1ms console drain loop can starve a blocking wait in a lower priority context. - Phases: bit-order self-check, DI eight-point bijection, DO point-by-point toggle with operator confirmation, release-all on every exit path. - Only exit is ioboard_release_all(); it is called from the entry guard, every phase failure, the write-failure branch and the thread tail. - Sample window is 20 reads x 2ms = 40ms and does overlap the 50ms production poll. That is stated as harmless in the header: the driver wraps the whole read in taskENTER_CRITICAL (26us, not the whole 40ms), both sides only read, and a torn cross-reader sample is caught by the debounce layer rather than acted upon. default_task.c fix: - DEFAULT_TASK_DI_PUBLISH_EN was defined twice: once at file scope and once inside default_task_func(). #define has no scope, so the second was a redefinition of the first. Collapsed to a single authoritative site. - Add TEST_SUITE_STORAGE to the disable list: the STORAGE suite owns the file system via testTask, and default_task_di_poll() referenced four statics that live inside an !TEST_SUITE_STORAGE block, which broke the STORAGE build with 11 errors. - Shrink the !TEST_SUITE_STORAGE block to cover only default_task_net_cfg_save_notify() and move the three declarations out; move edges/fails into the #else branch so the empty branch references none of the four statics. Registration and gates: - MDK-ARM/STM32F407-Demo.uvprojx and simulator/CMakeLists.txt entries. - scripts/check_test_suite.py: whitelist TEST_SUITE_IOBOARD. - scripts/stack_report.py: let a self-started thread that is not declared in Src/freertos.c osThreadAttr_t still be budget checked. - test/run_all_suites.py: bring the suite into the orchestrator view. Verified: six-build matrix all 0 errors 0 warnings. CH395F/STORAGE/GD5F/RTC and the product build are bit-identical at Code=257936; the IOBOARD build is Code=264640 (+6704), which is the evidence that the suite really enters the image. Host unit tests 100/100, stack report 1760/4096 words (57%).
This commit is contained in:
@@ -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/ 不在仓库里,本钩子照不到(手工
|
||||
|
||||
+23
-18
@@ -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) {
|
||||
|
||||
@@ -2432,6 +2432,11 @@
|
||||
<FileType>1</FileType>
|
||||
<FilePath>..\test\board\sd2506_test_task.c</FilePath>
|
||||
</File>
|
||||
<File>
|
||||
<FileName>ioboard_test_task.c</FileName>
|
||||
<FileType>1</FileType>
|
||||
<FilePath>..\test\board\ioboard_test_task.c</FilePath>
|
||||
</File>
|
||||
</Files>
|
||||
</Group>
|
||||
<Group>
|
||||
|
||||
@@ -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 /
|
||||
|
||||
@@ -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)
|
||||
|
||||
@@ -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 <stdint.h>
|
||||
#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 */
|
||||
@@ -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 <string.h>
|
||||
|
||||
#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 */
|
||||
@@ -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
|
||||
|
||||
@@ -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 <stdint.h>
|
||||
|
||||
/* === 选择当前构建的测试套件(三选一,或都注释 = 正常产品构建)===
|
||||
/* === 选择当前构建的测试套件(五选一,或都注释 = 正常产品构建)===
|
||||
* ⚠️ 默认必须是**产品构建**(全部注释)——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
|
||||
|
||||
@@ -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 值仅为默认;实际以
|
||||
|
||||
Reference in New Issue
Block a user