主机单测：新增卷锁与时间同步两套用例（33+80 项）并登记钩子
- vol_lock（App/fs/vol_lock.c）：33 用例。核心不变量是 fail-open—— 互斥量创建失败时 vol_lock_wait() 必须返回 1 且绝不阻塞，因为调用者 defaultTask 是看门狗喂狗点；板端该路径只在内存耗尽时才可能走到。 - time_sync（App/sync/time_sync.c）：80 用例。本模块是 N-17 看门狗风险的 全部逻辑贡献者，用例钉死分片喂狗节奏、监听退避、报文重组（半包/粘连/ EOF/真错/预算耗尽/tick 回绕）、重听门控；用 longjmp 跳出 for(;;) 任务循环。 - 两套均为纯逻辑主机侧测试，MSVC 离线编译真实源文件（#include 纳入）。 - 新增钩子 vol-lock-unit-test、time-sync-unit-test（7f/7g）。 - 全量主机单测：watchdog 39 + sys_clock 100 + cfg_file 149 + phasor 57 + adc_input 70 + vol_lock 33 + time_sync 80 = 528 项，全绿。
This commit is contained in:
@@ -0,0 +1,53 @@
|
||||
#!/usr/bin/env python3
|
||||
# -*- coding: utf-8 -*-
|
||||
"""卷锁（vol_lock）的主机侧单元测试运行器（L0.5，纯标准库）。
|
||||
|
||||
做什么：
|
||||
用本机 MSVC 编译 test/host/vol_lock/vol_lock_test.c（它以 #include 纳入
|
||||
**生产源文件** App/fs/vol_lock.c），在 PC 上离线跑创建/幂等/等待/超时/
|
||||
**fail-open**/释放，失败即非 0 退出。零硬件、零烧录、毫秒级。
|
||||
|
||||
工具链探测 / INCLUDE-LIB 拼接 / 编译运行 / 退出码判定全部委托给通用 harness
|
||||
`test/host/common/unit_test_harness.py`（本文件只做声明）。
|
||||
|
||||
为什么要主机侧单测（而不是只用板端套件）：
|
||||
本模块最要紧的语义是 **fail-open**——锁创建失败时 vol_lock_wait 必须返回 1
|
||||
且**绝不阻塞**（defaultTask 是看门狗喂狗点，等锁 = 停喂 = IWDG 误复位）。
|
||||
真机上 osMutexNew 失败几乎不可复现（需堆耗尽），板端套件无法构造；主机侧
|
||||
一次钉死。幂等性 / 超时透传 / 未创建时 release 无害 同属纯状态逻辑。
|
||||
|
||||
用法（仓库根目录）：
|
||||
python test/host/vol_lock/run_unit_test.py
|
||||
或统一用 .venv： & '.venv\\Scripts\\python.exe' test/host/vol_lock/run_unit_test.py
|
||||
|
||||
退出码：0=PASS / 1=测试失败 / 2=环境错误（找不到编译器 / 编译失败 / 无汇总行）。
|
||||
|
||||
设计依据：App/fs/vol_lock.h 文件头「使用约定（铁律）」；
|
||||
创建日期：2026-10-10
|
||||
"""
|
||||
import os
|
||||
import sys
|
||||
|
||||
HERE = os.path.dirname(os.path.abspath(__file__))
|
||||
ROOT = os.path.dirname(os.path.dirname(os.path.dirname(HERE)))
|
||||
# harness 位于 test/host/common/
|
||||
sys.path.insert(0, os.path.join(ROOT, "test", "host", "common"))
|
||||
|
||||
from unit_test_harness import TestBuild, run_host_unit_test # noqa: E402
|
||||
|
||||
# 顺序敏感：stub 目录必须**先于**生产目录，才能覆盖 cmsis_os.h
|
||||
# （真实头在 Middlewares/Third_Party/FreeRTOS/Source/CMSIS_RTOS_V2/，会拖入整套
|
||||
# FreeRTOS）。vol_lock.h 用真实头（接口契约原汁）；三个 osMutex* 由测试单元给强符号桩。
|
||||
BUILD = TestBuild(
|
||||
name="Volume Lock Tests",
|
||||
src=os.path.join(HERE, "vol_lock_test.c"),
|
||||
include_dirs=[
|
||||
os.path.join(HERE, "stub"),
|
||||
os.path.join(ROOT, "App", "fs"),
|
||||
HERE,
|
||||
],
|
||||
summary_marker="=== Volume Lock Tests:",
|
||||
)
|
||||
|
||||
if __name__ == "__main__":
|
||||
sys.exit(run_host_unit_test(BUILD))
|
||||
@@ -0,0 +1,56 @@
|
||||
/*
|
||||
* 主机侧单测桩：cmsis_os.h（CMSIS-RTOS v1 兼容层）
|
||||
* 模块功能：为 App/fs/vol_lock.c 提供主机可编译的 CMSIS-RTOS 互斥量接口。
|
||||
*
|
||||
* ⚠ 仅供 test/host/vol_lock/ 使用，不参与 MCU 构建。
|
||||
* 真实头来自 Middlewares/Third_Party/FreeRTOS/Source/CMSIS_RTOS_V2/cmsis_os.h，
|
||||
* 会拖入整套 FreeRTOS（FreeRTOS.h / task.h / queue.h / semphr.h …），主机侧不引入。
|
||||
*
|
||||
* 保真点（对齐 cmsis_os.h + cmsis_os2.h）：
|
||||
* - osMutexId_t = void*（cmsis_os2.h:198）；
|
||||
* - osMutexNew(const osMutexAttr_t *attr)（cmsis_os2.h:552）；
|
||||
* - osMutexWait(osMutexId_t, uint32_t) —— 真实头是 `#define osMutexWait osMutexAcquire`，
|
||||
* 两者签名一致（cmsis_os.h:617）；
|
||||
* - osMutexRelease(osMutexId_t)（cmsis_os.h:626）；
|
||||
* - osStatus_t 枚举含 osOK = 0（cmsis_os.h:204）。
|
||||
* 三个接口由测试单元给强符号桩（可注入"创建失败 / 等待超时"）。
|
||||
*
|
||||
* 创建日期：2026-10-10
|
||||
*/
|
||||
|
||||
#ifndef CMSIS_OS_H
|
||||
#define CMSIS_OS_H
|
||||
|
||||
#include <stdint.h>
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
#endif
|
||||
|
||||
/* 不透明句柄（真实定义见 cmsis_os2.h:195/198） */
|
||||
typedef void *osMutexId_t;
|
||||
typedef void *osEventFlagsId_t;
|
||||
|
||||
/* 状态码（cmsis_os.h:204 起的枚举；此处只保留被测代码用到的子集） */
|
||||
typedef enum {
|
||||
osOK = 0, /* 成功 */
|
||||
osError = -1, /* 通用错误 */
|
||||
osErrorTimeout = -2, /* 超时 */
|
||||
osErrorResource = -3, /* 资源不可用 */
|
||||
osErrorParameter = -4 /* 参数错误 */
|
||||
} osStatus_t;
|
||||
|
||||
/* 互斥量属性：被测代码只传 NULL，故仅占位 */
|
||||
typedef struct {
|
||||
uint32_t attr_bits;
|
||||
} osMutexAttr_t;
|
||||
|
||||
osMutexId_t osMutexNew(const osMutexAttr_t *attr);
|
||||
osStatus_t osMutexWait(osMutexId_t mutex_id, uint32_t millisec);
|
||||
osStatus_t osMutexRelease(osMutexId_t mutex_id);
|
||||
|
||||
#ifdef __cplusplus
|
||||
}
|
||||
#endif
|
||||
|
||||
#endif /* CMSIS_OS_H */
|
||||
@@ -0,0 +1,224 @@
|
||||
/*
|
||||
* 模块名称：Volume Lock（卷锁）主机侧单元测试
|
||||
* 模块功能：在 PC 上对 App/fs/vol_lock.c 做离线验证（3 个公开函数全覆盖）。
|
||||
*
|
||||
* 被测对象：真实源文件 ../../../App/fs/vol_lock.c（以 #include 原样纳入，
|
||||
* 保证测的是生产代码而非副本）。平台依赖由本文件提供的**可注入桩**实现：
|
||||
* - cmsis_os.h -> osMutexNew / osMutexWait / osMutexRelease
|
||||
* （可注入 创建失败 / 等待超时 / 获取成功）
|
||||
*
|
||||
* 为什么要主机侧单测（而不是只用板端套件）：
|
||||
* 1. 本模块最要紧的语义是 **fail-open**（锁创建失败时 `vol_lock_wait` 必须返回 1
|
||||
* 且**绝不阻塞**）——这是"defaultTask 喂狗点绝不能因等锁而停摆"的最后一道保险。
|
||||
* 真机上 `osMutexNew` 失败几乎不可能复现（需堆耗尽），板端套件无法构造。
|
||||
* 2. 幂等性（重复 `vol_lock_init` 不得重复创建）、等待超时透传、未创建时 release 无害，
|
||||
* 都是纯状态逻辑，主机侧一次钉死。
|
||||
* 3. 不占 MCU 的 RAM，毫秒级完成。
|
||||
*
|
||||
* 覆盖点：
|
||||
* TC-VL-001 init 首次调用创建互斥量并返回 0
|
||||
* TC-VL-002 init 幂等（重复调用不再创建）
|
||||
* TC-VL-003 init 在 osMutexNew 失败时返回 -1
|
||||
* TC-VL-004 init 失败后可重试成功（s_lock 未被污染）
|
||||
* TC-VL-005 wait 成功后返回 1，且把 timeout 原样透传给 osMutexWait
|
||||
* TC-VL-006 wait 超时（osMutexWait != osOK）返回 0
|
||||
* TC-VL-007 wait 在锁未创建时自动 init，再正常获取
|
||||
* TC-VL-008 ⭐ fail-open：锁未创建且创建失败 -> 返回 1 且**不调用** osMutexWait
|
||||
* TC-VL-009 fail-open 之后 release 无害（s_lock 仍为 NULL，不调用 osMutexRelease）
|
||||
* TC-VL-010 已创建时 wait 不再调用 osMutexNew
|
||||
* TC-VL-011 release 在已持锁时调用 osMutexRelease 一次
|
||||
* TC-VL-012 release 在锁未创建时静默返回（不崩溃、不调用）
|
||||
* TC-VL-013 完整周期 init -> wait -> release -> wait -> release
|
||||
* TC-VL-014 wait(0) 的 timeout 透传为 0（defaultTask 的 try 语义）
|
||||
*
|
||||
* 通过：全部 TC PASS（main 返回 0）。
|
||||
* 入口：int main(void)，返回 0=PASS / 1=FAIL（由 run 脚本判读）。
|
||||
*
|
||||
* 创建日期：2026-10-10
|
||||
*/
|
||||
|
||||
#include <stddef.h>
|
||||
#include <stdint.h>
|
||||
#include <stdio.h>
|
||||
|
||||
/* ===================== 平台桩（先纳入，覆盖真实头） ===================== */
|
||||
#include "cmsis_os.h"
|
||||
|
||||
/* ===================== CMSIS-RTOS 互斥量桩 =====================
|
||||
* s_new_fail osMutexNew 返回 NULL（注入创建失败）
|
||||
* s_wait_ok 0 -> osMutexWait 返回 osErrorTimeout（注入超时）
|
||||
* s_fake_mutex 成功创建时返回的伪句柄（非 NULL 即可）
|
||||
* s_last_timeout 记录 osMutexWait 收到的 millisec（断言透传）
|
||||
*/
|
||||
static int s_new_calls;
|
||||
static int s_new_fail;
|
||||
static int s_wait_calls;
|
||||
static int s_wait_ok;
|
||||
static int s_release_calls;
|
||||
static uint32_t s_last_timeout;
|
||||
static void *s_fake_mutex = (void *)0x1234;
|
||||
|
||||
osMutexId_t osMutexNew(const osMutexAttr_t *attr) {
|
||||
(void)attr;
|
||||
s_new_calls++;
|
||||
return s_new_fail ? NULL : (osMutexId_t)s_fake_mutex;
|
||||
}
|
||||
|
||||
osStatus_t osMutexWait(osMutexId_t mutex_id, uint32_t millisec) {
|
||||
(void)mutex_id;
|
||||
s_wait_calls++;
|
||||
s_last_timeout = millisec;
|
||||
return s_wait_ok ? osOK : osErrorTimeout;
|
||||
}
|
||||
|
||||
osStatus_t osMutexRelease(osMutexId_t mutex_id) {
|
||||
(void)mutex_id;
|
||||
s_release_calls++;
|
||||
return osOK;
|
||||
}
|
||||
|
||||
/* ===================== 断言 ===================== */
|
||||
static int s_total = 0, s_passed = 0, s_failed = 0;
|
||||
|
||||
#define CHECK(cond, name) do { \
|
||||
s_total++; \
|
||||
if (cond) { s_passed++; printf(" [PASS] %s\n", name); } \
|
||||
else { s_failed++; printf(" [FAIL] %s (line %d)\n", name, __LINE__); } \
|
||||
} while (0)
|
||||
|
||||
/* ===================== 被测代码（原样纳入生产源） ===================== */
|
||||
#include "vol_lock.c"
|
||||
|
||||
/* ===================== 工具 ===================== */
|
||||
|
||||
/*
|
||||
* 函数功能：把全部桩与模块静态态复位到"刚上电"初值
|
||||
* 入口参数：无
|
||||
* 返 回 值：无
|
||||
* 限定条件：无
|
||||
* 函数说明：`s_lock` 是 vol_lock.c 的文件静态量（源文件已被纳入同一编译单元），
|
||||
* 直接置 NULL 等价于"未初始化过"——这是白盒单测的可接受代价。
|
||||
*/
|
||||
static void fakes_reset(void) {
|
||||
s_new_calls = 0;
|
||||
s_new_fail = 0;
|
||||
s_wait_calls = 0;
|
||||
s_wait_ok = 1;
|
||||
s_release_calls = 0;
|
||||
s_last_timeout = 0xFFFFFFFFu;
|
||||
s_fake_mutex = (void *)0x1234;
|
||||
s_lock = NULL;
|
||||
}
|
||||
|
||||
/* ===================== TC-VL-001..004：vol_lock_init ===================== */
|
||||
|
||||
static void tc_init(void) {
|
||||
fakes_reset();
|
||||
CHECK(vol_lock_init() == 0, "TC-VL-001 init 首次调用返回 0");
|
||||
CHECK(s_new_calls == 1, "TC-VL-001b init 创建互斥量一次（osMutexNew）");
|
||||
CHECK(s_lock != NULL, "TC-VL-001c 模块静态态已持有句柄");
|
||||
|
||||
CHECK(vol_lock_init() == 0, "TC-VL-002 init 重复调用仍返回 0（幂等）");
|
||||
CHECK(s_new_calls == 1, "TC-VL-002b 幂等：不再创建第二个互斥量");
|
||||
|
||||
fakes_reset();
|
||||
s_new_fail = 1;
|
||||
CHECK(vol_lock_init() == -1, "TC-VL-003 osMutexNew 失败 -> init 返回 -1");
|
||||
CHECK(s_lock == NULL, "TC-VL-003b 失败时不留下半初始化句柄");
|
||||
|
||||
s_new_fail = 0;
|
||||
CHECK(vol_lock_init() == 0, "TC-VL-004 失败后重试可成功（返回 0）");
|
||||
CHECK(s_new_calls == 2, "TC-VL-004b 重试确实再次调用 osMutexNew");
|
||||
}
|
||||
|
||||
/* ===================== TC-VL-005..010：vol_lock_wait ===================== */
|
||||
|
||||
static void tc_wait(void) {
|
||||
/* --- 已创建：超时值原样透传 --- */
|
||||
fakes_reset();
|
||||
(void)vol_lock_init();
|
||||
CHECK(vol_lock_wait(100U) == 1, "TC-VL-005 wait 获取成功返回 1");
|
||||
CHECK(s_wait_calls == 1, "TC-VL-005b osMutexWait 被调用一次");
|
||||
CHECK(s_last_timeout == 100U, "TC-VL-005c timeout 原样透传给 osMutexWait");
|
||||
|
||||
fakes_reset();
|
||||
(void)vol_lock_init();
|
||||
CHECK(vol_lock_wait(0U) == 1, "TC-VL-014 wait(0) 获取成功返回 1（try 语义）");
|
||||
CHECK(s_last_timeout == 0U, "TC-VL-014b wait(0) 的 timeout 透传为 0");
|
||||
|
||||
/* --- 超时：osMutexWait != osOK -> 返回 0 --- */
|
||||
fakes_reset();
|
||||
(void)vol_lock_init();
|
||||
s_wait_ok = 0;
|
||||
CHECK(vol_lock_wait(50U) == 0, "TC-VL-006 osMutexWait 非 osOK -> wait 返回 0");
|
||||
CHECK(s_wait_calls == 1, "TC-VL-006b 超时路径确实尝试过等待");
|
||||
|
||||
/* --- 锁未创建：自动 init 后正常获取 --- */
|
||||
fakes_reset();
|
||||
CHECK(vol_lock_wait(10U) == 1, "TC-VL-007 锁未创建时 wait 自动 init 并获取");
|
||||
CHECK(s_new_calls == 1, "TC-VL-007b 自动 init 创建了互斥量");
|
||||
CHECK(s_wait_calls == 1, "TC-VL-007c 随后执行了一次等待");
|
||||
|
||||
/* --- ⭐ fail-open：创建失败必须返回 1 且绝不阻塞 --- */
|
||||
fakes_reset();
|
||||
s_new_fail = 1;
|
||||
CHECK(vol_lock_wait(0U) == 1, "TC-VL-008 fail-open：锁创建失败仍返回 1（不阻塞喂狗点）");
|
||||
CHECK(s_wait_calls == 0, "TC-VL-008b fail-open 时**不调用** osMutexWait（零阻塞）");
|
||||
CHECK(s_lock == NULL, "TC-VL-008c fail-open 后仍无句柄");
|
||||
|
||||
/* --- fail-open 之后 release 无害 --- */
|
||||
vol_lock_release();
|
||||
CHECK(s_release_calls == 0, "TC-VL-009 fail-open 后 release 不调用 osMutexRelease（判空静默）");
|
||||
|
||||
/* --- 已创建时 wait 不再创建 --- */
|
||||
fakes_reset();
|
||||
(void)vol_lock_init();
|
||||
(void)vol_lock_wait(0U);
|
||||
(void)vol_lock_wait(0U);
|
||||
CHECK(s_new_calls == 1, "TC-VL-010 多次 wait 不重复创建互斥量");
|
||||
CHECK(s_wait_calls == 2, "TC-VL-010b 每次 wait 各等待一次");
|
||||
}
|
||||
|
||||
/* ===================== TC-VL-011..013：vol_lock_release ===================== */
|
||||
|
||||
static void tc_release(void) {
|
||||
/* --- 已持锁：释放一次 --- */
|
||||
fakes_reset();
|
||||
(void)vol_lock_init();
|
||||
(void)vol_lock_wait(0U);
|
||||
vol_lock_release();
|
||||
CHECK(s_release_calls == 1, "TC-VL-011 已持锁时 release 调用 osMutexRelease 一次");
|
||||
|
||||
/* --- 锁未创建：静默返回 --- */
|
||||
fakes_reset();
|
||||
vol_lock_release();
|
||||
CHECK(s_release_calls == 0, "TC-VL-012 锁未创建时 release 静默返回（不调用、不崩溃）");
|
||||
|
||||
/* --- 完整周期 --- */
|
||||
fakes_reset();
|
||||
CHECK(vol_lock_init() == 0, "TC-VL-013 周期：init -> 0");
|
||||
CHECK(vol_lock_wait(0U) == 1, "TC-VL-013b 周期：wait -> 1");
|
||||
vol_lock_release();
|
||||
CHECK(vol_lock_wait(100U) == 1, "TC-VL-013c 周期：再 wait -> 1（可重复获取）");
|
||||
vol_lock_release();
|
||||
CHECK(s_new_calls == 1, "TC-VL-013d 周期：全程只创建一次互斥量");
|
||||
CHECK(s_release_calls == 2, "TC-VL-013e 周期：释放两次");
|
||||
CHECK(s_last_timeout == 100U, "TC-VL-013f 周期：第二次 wait 的 timeout 透传正确");
|
||||
}
|
||||
|
||||
/* ===================== main ===================== */
|
||||
|
||||
int main(void) {
|
||||
printf("=== Volume Lock Tests ===\n");
|
||||
|
||||
printf("-- vol_lock_init --\n");
|
||||
tc_init();
|
||||
printf("-- vol_lock_wait (incl. fail-open) --\n");
|
||||
tc_wait();
|
||||
printf("-- vol_lock_release --\n");
|
||||
tc_release();
|
||||
|
||||
printf("\n=== Volume Lock Tests: %d/%d PASSED (failed=%d) ===\n",
|
||||
s_passed, s_total, s_failed);
|
||||
return (s_failed == 0) ? 0 : 1;
|
||||
}
|
||||
Reference in New Issue
Block a user