wandering1
4ceb5b41e6
用户指令（2026-10-30）：确认录波任务完成度，把除实际操作之外的所有 步骤做完，然后删除规划文件，避免已完成的工作被误读为未做。 审计结论：代码面确已全部收口——wave_read.py --selftest 92/92、 三套主机单测 113/170/110 复跑全 rc=0、bench 自抓与 PC 读段脚本在仓、 数据可信/复刻明细/短板评测/UI 两处回写均已做过。**唯一未跑的是 板级台架那一轮（实际操作）**，判据不得丢，故先迁后删： - 设计说明 §9 承接落盘道失败留痕名全清单（13+1 条，打印点现值 default_task.c:816/:831 实测核对） - 设计说明 §10 承接原卡 2/卡 3 的板级段（触发来路一行、回放页 一行）与本波执行顺序图（mermaid，原规划 §3 逐字迁） - §4/§11 头部定位、§11 尾注、§14 关系行改属主口径 - 全库 32 处引用改挂设计说明 §10/§9（18 文件）：任务规划 README 独立行（顺带订正单测数 100→113 为实测）、登记簿、数据可信 ×2、 复刻明细、产品需求 ×2、ADC 注入 ×3、短板评测 ×2、页面补齐规划、 App/algo README、配图生成器注释、录波三套单测注释 ×6 - git rm docs 该规划文件；人类索引任务规划 6→5 个文件（沿革注照 屏板链路先例走裸句，不留反引号死引用） 验证：残留两形态（任务规划/故障录波、裸文件名）全树扫描 0； mermaid 预检新发 0；doc-links 11 个被改文件逐文件 PASS；生成器 注释改动重跑产物逐字节不变（svg 60a0dd39e4）；三套单测与 wave_read selftest 复跑全绿；18 文件 BOM/CR/U+FFFD 全零。 本笔不含固件编译单元（test/host 仅注释行与文档），构建留待合并 轮统一跑；板级轮启动判据与顺序见设计说明 §10。
51 lines
2.3 KiB
Python
51 lines
2.3 KiB
Python
#!/usr/bin/env python3
|
||
# -*- coding: utf-8 -*-
|
||
"""录波环（故障录波数据面·滚动环与触发冻结状态机，wave_ring）主机侧纯逻辑单元测试运行器（纯标准库）。
|
||
|
||
做什么：
|
||
用本机 MSVC 编译 test/host/wave_ring/wave_ring_test.c（它以 #include 纳入
|
||
**生产源文件** App/algo/wave_ring.c + App/algo/wave_store.c），在 PC 上离线跑
|
||
环形态与预算、触发到封段的逐拍时序、段内容与点序（列序 = 语义序）、SEALED 期间
|
||
写指针真冻结、封存交棒握手、读窗夹取与跨环回绕、ACK 与冷却、轮转号推进规则，
|
||
失败即非 0 退出。零硬件、零烧录、毫秒级。
|
||
工具链探测 / 编译运行全部委托 test/host/common/unit_test_harness.py。
|
||
|
||
为什么要主机侧单测（而不是只等台架）：
|
||
本层判据几乎全是结构与并发类（docs/子系统设计/故障录波设计说明.md §4.2 与 §5.2）——
|
||
1 ms 一拍的冻结窗在人工读表下不可观测，"落盘道挂住两秒"这种注入在真机上等于
|
||
拿看门狗窗口赌；主机侧可拿影子样本序列逐点钉死。需要板子的判据（注入 1 V/50 Hz
|
||
后 FTP 拉回对表）不在本套件，见 docs/子系统设计/故障录波设计说明.md §10 板级行。
|
||
|
||
本层为纯逻辑：无寄存器、无 RTOS、无文件/外设依赖，**不需要任何桩目录**。
|
||
|
||
用法（仓库根目录）：
|
||
python test/host/wave_ring/run_unit_test.py
|
||
|
||
退出码：0=PASS / 1=测试失败 / 2=环境错误。
|
||
设计依据：docs/子系统设计/故障录波设计说明.md §4.2 §5.1 §5.2 §6.2 §7；
|
||
docs/子系统设计/故障录波设计说明.md §10。
|
||
创建日期：2026-10-29
|
||
"""
|
||
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
|
||
|
||
# 无桩目录：wave_ring.c / wave_store.c 只依赖 stdint/stddef 与本目录两份头。
|
||
BUILD = TestBuild(
|
||
name="Wave Ring Tests",
|
||
src=os.path.join(HERE, "wave_ring_test.c"),
|
||
include_dirs=[
|
||
os.path.join(ROOT, "App", "algo"),
|
||
HERE,
|
||
],
|
||
summary_marker="=== Wave Ring Tests:",
|
||
)
|
||
|
||
if __name__ == "__main__":
|
||
sys.exit(run_host_unit_test(BUILD))
|