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。
52 lines
2.4 KiB
Python
52 lines
2.4 KiB
Python
#!/usr/bin/env python3
|
||
# -*- coding: utf-8 -*-
|
||
"""录波段格式层（段文件字节布局编解码 + 打包游标 + 段名轮转，wave_store）主机侧纯逻辑单元测试运行器（纯标准库）。
|
||
|
||
做什么：
|
||
用本机 MSVC 编译 test/host/wave_store/wave_store_test.c（它以 #include 纳入
|
||
**生产源文件** App/algo/wave_store.c），在 PC 上离线跑 CRC-16/MODBUS 规范锚点、
|
||
整段长度等式（32 + 12*ch + pts*ch*2 + 2 == 5250）、段头编解码往返、拒绝清单、
|
||
按通道分列的偏移换算、打包游标三段推进与四条拒绝路径、自产字节自检、段文件名
|
||
轮转与反解，失败即非 0 退出。零硬件、零烧录、毫秒级。顺带把一段合成段写到 %TEMP%
|
||
供 PC 侧读段脚本（test/host/wave_read.py）做只读互验（不参与判定）。
|
||
工具链探测 / 编译运行全部委托 test/host/common/unit_test_harness.py。
|
||
|
||
为什么要主机侧单测（而不是只等台架）：
|
||
段文件是证据。偏移错一个字节、CRC 少覆盖一段、轮转号回绕错一位，在板子上全是
|
||
静默的，只有 PC 脚本或回放页才发现，而那时现场已经没了（口径属主见
|
||
docs/子系统设计/故障录波设计说明.md §6.2 与 §6.3）。FatFs 真落盘的短写判失败
|
||
（§5.2 第二条）需要板子，不在本套件。
|
||
|
||
本层为纯逻辑：不 include HAL/CMSIS/RTOS、不调 FatFs，**不需要任何桩目录**。
|
||
|
||
用法（仓库根目录）：
|
||
python test/host/wave_store/run_unit_test.py
|
||
|
||
退出码：0=PASS / 1=测试失败 / 2=环境错误。
|
||
设计依据：docs/子系统设计/故障录波设计说明.md §5.2 §6.2 §6.3 §8.1；
|
||
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_store.c 只依赖 stdint/stddef 与 App/algo/wave_store.h。
|
||
BUILD = TestBuild(
|
||
name="Wave Store Tests",
|
||
src=os.path.join(HERE, "wave_store_test.c"),
|
||
include_dirs=[
|
||
os.path.join(ROOT, "App", "algo"),
|
||
HERE,
|
||
],
|
||
summary_marker="=== Wave Store Tests:",
|
||
)
|
||
|
||
if __name__ == "__main__":
|
||
sys.exit(run_host_unit_test(BUILD))
|