wandering1
04997e48aa
同族第二道：代码注释面。41 个 run_unit_test.py 文件头与引用行、common harness 与两份 README、4 个 *_test.c 文件头、App/** 14 处（含 BOM 文件 App/cfg/cfg_file.c）、 GD5F nand_ftl.c 1 处，共 73 站点 / 64 文件；措辞取「主机侧纯逻辑单元测试运行器 （纯标准库）」避免同行「主机侧」重复。 零行为改动（机器证据，不是口头）： - 17 个 .c/.h 剥掉注释后与 HEAD **逐字节相同**； - 42 个 .py 走 ast.dump 比较、仅归一 docstring（真实字符串字面量参与比较，故旗标或 输出文本被动过必然报红）→ 全部相等；behaviour_changed=0。 - py_compile 42/42；抽跑 watchdog 47/47、freq 46/46（动手前先取基线，改后同数）； CR 字节 0、EF BF BD 0、BOM 与 HEAD 逐一一致、check_bom_drift rc=0。 刻意未动：6 处字符串字面量（FTP 应答 "215 UNIX Type: L8"、lftpd_test.c SYST 断言、 console_log_test.c 的 "L1\r\n"、phasor_test.c 的 "L2-in ring" 文案与 printf 标题）—— 改了就是改测试输出/行为；UI 设计令牌层 L0（ui_tokens.h、ui_content_page.c）与 test/host/README.md 的算法层号是**另外的族**。 两条 SyntaxWarning（ftp_cfg / net_cfg 文件头 \S 转义）**HEAD 同样存在**，已对 HEAD 副本 复现证明非本次引入，未顺手改。
50 lines
2.1 KiB
Python
50 lines
2.1 KiB
Python
#!/usr/bin/env python3
|
|
# -*- coding: utf-8 -*-
|
|
"""遥测快照层（全周傅氏相量发布侧，meas）主机侧纯逻辑单元测试运行器（纯标准库）。
|
|
|
|
做什么：
|
|
用本机 MSVC 编译 test/host/meas/meas_test.c（它以 #include 纳入
|
|
**生产源文件** App/algo/meas.c + phasor.c + sample_ring.c），在 PC 上离线
|
|
跑 200 ms 遥测快照的：§4.5 布局钉死 / seq 只增 / 双区切换无撕裂 /
|
|
基波有效值与 phasor 使用区同拍同值 / 品质汇总（CLIPPED 位图）/ TEMP 透传 /
|
|
采样环回绕连续性，失败即非 0 退出。零硬件、零烧录、毫秒级。
|
|
工具链探测 / 编译运行全部委托 test/host/common/unit_test_harness.py。
|
|
|
|
为什么要主机侧单测（而不是只等台架）：
|
|
遥测快照发布（docs/任务规划/数据可信.md）判据一半是并发与结构类——双区撕裂窗在
|
|
台架上不可观测，削顶品质要等两点标定才真实出现；读数与注入源比对类
|
|
判据仍归台架（实测采样类，本套件不覆盖）。
|
|
|
|
本层为纯算法：无寄存器、无 RTOS、无文件/外设依赖，**不需要任何桩目录**。
|
|
|
|
用法（仓库根目录）：
|
|
python test/host/meas/run_unit_test.py
|
|
|
|
退出码：0=PASS / 1=测试失败 / 2=环境错误。
|
|
设计依据：docs/任务规划/数据可信.md 遥测快照发布（道D，§4.5 快照布局）；
|
|
创建日期：2026-10-25
|
|
"""
|
|
import os
|
|
import sys
|
|
|
|
HERE = os.path.dirname(os.path.abspath(__file__))
|
|
ROOT = os.path.dirname(os.path.dirname(os.path.dirname(HERE)))
|
|
sys.path.insert(0, os.path.join(ROOT, "test", "host", "common"))
|
|
|
|
from unit_test_harness import TestBuild, run_host_unit_test # noqa: E402
|
|
|
|
# 无桩目录：meas.c / phasor.c / sample_ring.c 仅依赖 stdint/stddef/math 与
|
|
# App/algo 内的头（adc_input.h 为纯枚举 + 声明，可主机编译）。
|
|
BUILD = TestBuild(
|
|
name="Meas Layer Tests",
|
|
src=os.path.join(HERE, "meas_test.c"),
|
|
include_dirs=[
|
|
os.path.join(ROOT, "App", "algo"),
|
|
HERE,
|
|
],
|
|
summary_marker="=== Meas Layer Tests:",
|
|
)
|
|
|
|
if __name__ == "__main__":
|
|
sys.exit(run_host_unit_test(BUILD))
|