wandering1
593c5d0c84
用户裁定（2026-10-28）：L1/L1.5/L2/L2.5/L3 这套层号「谁能看懂」，改用语义名。 映射（同一批定稿，含 L4/L5）： L1 → 语义取数与有效性 L1.5 → 标定折算 L2 → 全周傅氏相量 L2.5 → 测频与遥测快照 L3 → 保护判据 L4 → 出口与记录 L5 → 动作留痕 实测规模：384 站点 / 62 文件（App/algo、App/task、test/host 六个套件、docs/算法、 产品需求、架构总览、启动顺序、ADC 采样节拍、IEC104 上行、采集短板评测、内存管理、 AGENTS.md、README.md、docs/README.md、.pre-commit-config.yaml 与 scripts 里的注释）。 改法（不是全局替换，逐模式有上下文规则）： - 先吃同位语再落裸词：L1 有效性校验 → 语义取数与有效性校验、L2 相量层 → 全周傅氏 相量层、L3 保护 → 保护判据、L2.5 遥测快照 → 测频与遥测快照，避免「保护判据保护判据」 这类重复（第一版就是这么坏掉的，已整体回滚重做）。 - .c/.h 只改注释：先把字符串字面量切出去（引号数为奇数的跨行注释按整行处理）， C 字符串里的 L2-in ring 之类原样保留——AGENTS 铁律「字符串字面量必须纯 ASCII」。 - 层内条目号（L1-3 / L2-3 这类）**本批不动**，属批次 2；另外三族（UI 菜单层级 L0~L3、链路延迟分段 L1~L8、CubeMX 防丢失三层）也不动，属批次 3。 - 顺手修的措辞：范围写法 L1~L3 → 「分层（语义取数与有效性 → 保护判据）」、 CI 段「不含 L1/L2/L3」→「不含采集链分层」、目录地图里同一处并列表述。 验证：@build 0 错 0 警（Code=236456，与改前逐字节同尺寸——纯注释改动）； 内存布局配图已按新脚本重生成（自检通过）；doc-links --all --sections-strict 通过 （195 文档）；mojibake / bom-guard / coding-standard / 新编号门禁自查 全 rc=0； git diff --check 干净。
58 lines
2.7 KiB
Python
58 lines
2.7 KiB
Python
#!/usr/bin/env python3
|
||
# -*- coding: utf-8 -*-
|
||
"""相量层（全周傅氏相量）的主机侧单元测试运行器（L0.5，纯标准库）。
|
||
|
||
做什么：
|
||
用本机 MSVC 编译 test/host/phasor/phasor_test.c（它以 #include 纳入**生产源文件**
|
||
App/algo/phasor.c 与 App/algo/sample_ring.c），在 PC 上离线跑完整的相量算法验证：
|
||
系数表逐项复核 / 幅值-有效值-相位 / 直流与谐波抑制 / 任意次谐波提取 /
|
||
频率敏感性 / 采样环时序与回绕 / 实例层与双区交换，失败即非 0 退出。
|
||
零硬件、零烧录、毫秒级。
|
||
|
||
工具链探测 / INCLUDE-LIB 拼接 / 编译运行 / 退出码判定全部委托给通用 harness
|
||
`test/host/common/unit_test_harness.py`（本文件只做声明）。
|
||
|
||
为什么要主机侧单测（而不是只用板端套件）：
|
||
相量算法是纯数学变换，与硬件无关。**板端无信号源**，无法注入已知幅值/相位/频率
|
||
的标准波形，因而无法验证"读数 = 设定有效值"这一 相量有效值输出 核心判据（与 STM32 ADC1 启动与扫描 的替代口径
|
||
同源）。主机侧可合成任意波形并精确构造边界（恰好一周波 / 不足一周波 / 环形回绕 /
|
||
任意次谐波 / 频偏），且不占 MCU 的 RAM。
|
||
|
||
本层为**纯算法**：无寄存器、无 RTOS、无文件/外设依赖，故**不需要任何桩目录**。
|
||
|
||
用法（仓库根目录）：
|
||
python test/host/phasor/run_unit_test.py
|
||
或统一用 .venv： & '.venv\\Scripts\\python.exe' test/host/phasor/run_unit_test.py
|
||
|
||
退出码：0=PASS / 1=测试失败 / 2=环境错误（找不到编译器 / 编译失败 / 无汇总行）。
|
||
|
||
设计依据：docs/算法/继电保护功能复现规划.md §3.2（全周傅氏系数表 等）；
|
||
docs/算法/傅氏算法详解.md §2.3（系数口径）；
|
||
docs/测试说明/测试开发标准流程.md §4.2（L0.5 主机侧单测）。
|
||
创建日期：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
|
||
|
||
# 无桩目录：被测代码为纯算法（phasor.c / sample_ring.c 仅依赖 math.h 与 App/algo 内的头）。
|
||
# App/algo 提供 phasor.h / sample_ring.h / adc_input.h（后者为纯枚举 + 声明，可主机编译）。
|
||
BUILD = TestBuild(
|
||
name="Phasor Tests",
|
||
src=os.path.join(HERE, "phasor_test.c"),
|
||
include_dirs=[
|
||
os.path.join(ROOT, "App", "algo"),
|
||
HERE,
|
||
],
|
||
summary_marker="=== Phasor Tests:",
|
||
)
|
||
|
||
if __name__ == "__main__":
|
||
sys.exit(run_host_unit_test(BUILD))
|