From 685a3668909322035e14c8a1c7892157b6a572f6 Mon Sep 17 00:00:00 2001 From: Wanderingss <1624155937@qq.com> Date: Wed, 18 Nov 2026 12:46:03 +0800 Subject: [PATCH] =?UTF-8?q?refactor(test):=20=E6=8A=8A=20test/host=20?= =?UTF-8?q?=E9=A1=B6=E5=B1=82=2025=20=E4=B8=AA=E5=8F=B0=E6=9E=B6=E8=84=9A?= =?UTF-8?q?=E6=9C=AC=E6=8C=89=E5=9F=9F=E6=94=B6=E8=BF=9B=20bench/?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 原来 test/host 一层混了三类东西:51 个主机侧单测模块目录、25 个台架驱动 与探针、若干专用目录。台架脚本平铺在顶层,与单测目录并列,看不出哪个是 「连板跑一次的」,也看不出加新脚本该往哪放。 现在按被验对象分域归档,单测模块目录一律不动(22 根 pre-commit 钩子逐个 点名它们,50 个运行器按固定层数推仓库根): - bench/bench_defaults.py 台架连接默认值单一真源 - bench/ftp/ (10) FTP 功能、速率、鉴权、中止、完整性、背靠背复现 - bench/net/ (9) CH395F socket、keepalive 判死、挂机、复连压力、PASV、 UDP 队列、链路时延对端 - bench/iec104/ (2) 主站客户端与它的离线样帧自检 - bench/wave/ (1) 录波段文件 PC 侧解码 - bench/screenlink/ (2) 屏板链路顶替与拉帧压测 顶层条目 78 -> 53。逐脚本作用、运行前置与「加新脚本往哪放」写在新建的 test/host/bench/README.md;test/host/README.md 增目录地图表,把原平铺的 网络/FTP 两节压成指针。 配套修正(移动后不修就会坏): - 17 个脚本加上 bench/ 到 sys.path 的 bootstrap(sys.path[0] 是脚本自身 目录,不补就 import bench_defaults 失败) - cal/cal_write.py 本来就坏的(只插 cal/ 到自己 sys.path,import bench_defaults 直接 ModuleNotFoundError),补两段路径后可用 - e6_soak 与 wave_read 用 dirname 固定层数推仓库根,多两层后分别指向 test/test 与 test/ci-artifacts(后者静默写错目录、不报错),层数已改对 - scripts/board_ui_nav.py 与 MDK-ARM 两个探针的 bench_defaults 搜索路径 清理与标注:删掉 test/host/iec104/(旧自研协议层单测退役后只剩一个零引用 的 stub 桩头);文档里对 test/host/iec104 与 iec104_serv 的引用加上「已 删除/已不存在 2026-11-18」状态词。冻结历史证据(带日期戳的台架日志)与 编号别名登记表里的旧路径按原样保留。 --- .dsh/skills/board-ui-nav/SKILL.md | 11 ++ .../id-family-semantic-migration/SKILL.md | 6 + .dsh/skills/stale-doc-count-sweep/SKILL.md | 6 + App/algo/wave_store.h | 2 +- Drivers/BSP/CH395F/README.md | 2 +- Drivers/BSP/NET/lftpd/README.md | 2 +- MDK-ARM/ftp_freeze_probe.py | 4 +- MDK-ARM/tcp_reconnect_probe.py | 4 +- docs/内存管理/RAM使用分析与优化方案.md | 2 +- docs/子系统设计/IEC104上行设计说明.md | 8 +- docs/子系统设计/屏板链路设计.md | 2 +- docs/子系统设计/故障录波设计说明.md | 12 +- docs/架构设计/项目架构总览.md | 4 +- docs/测试说明/专项验证/ADC前端注入验证流程.md | 12 +- docs/测试说明/专项验证/存储维护与容量恢复.md | 2 +- .../专项验证/故障录波板级到场轮执行手册.md | 6 +- docs/测试说明/专项验证/链路延迟测试说明.md | 20 +-- docs/测试说明/单元测试/主机单测覆盖率口径.md | 8 +- docs/测试说明/板级测试/CH395F_Test_Guide.md | 38 +++--- docs/测试说明/板级测试/FTP_Test_Guide.md | 10 +- docs/测试说明/板级测试/实机测试实施指南.md | 4 +- .../测试说明/测试数据/boot_log_data/README.md | 6 +- docs/测试说明/测试数据/m2_data/README.md | 2 +- .../测试数据/wave_fix_20261107/README.md | 4 +- .../测试数据/wave_shot_20261106/README.md | 4 +- docs/算法/采集与算法层设计说明.md | 6 +- docs/网络/BSD_Socket_API_使用指南.md | 2 +- docs/网络/Net层阻塞模型架构设计.md | 2 +- docs/网络/网络自愈架构设计.md | 4 +- docs/门禁说明/README.md | 2 +- docs/问题记录/CH395F_Trap_Records.md | 14 +- scripts/archive/id_gate/编号治理历史.md | 4 +- scripts/board_ui_nav.py | 4 +- test/board/ch395f_reuse_bench.c | 4 +- test/board/ch395f_test.h | 2 +- test/board/net_latency_test.c | 2 +- test/board/net_latency_test.h | 4 +- test/board/net_test_task.c | 4 +- test/board/net_test_task.h | 2 +- test/host/README.md | 121 ++++++++++-------- test/host/bench/README.md | 35 +++++ test/host/{ => bench}/bench_defaults.py | 0 test/host/{ => bench/ftp}/ftp_abort_probe.py | 11 +- test/host/{ => bench/ftp}/ftp_auth_bench.py | 10 +- test/host/{ => bench/ftp}/ftp_capture.py | 0 .../{ => bench/ftp}/ftp_integrity_test.py | 10 +- .../{ => bench/ftp}/ftp_list_fill_test.py | 10 +- test/host/{ => bench/ftp}/ftp_regression.py | 10 +- test/host/{ => bench/ftp}/ftp_speed_test.py | 9 +- test/host/{ => bench/ftp}/ftp_test.py | 10 +- test/host/{ => bench/ftp}/ftp_up_dl_test.py | 9 +- test/host/{ => bench/ftp}/n30_repro.py | 10 +- test/host/{ => bench/iec104}/iec104_master.py | 12 +- .../iec104}/test_iec104_master_rx.py | 2 +- .../host/{ => bench/net}/ch395f_reuse_host.py | 10 +- .../{ => bench/net}/ch395f_socket_test.py | 9 +- .../{ => bench/net}/e11_keepalive_probe.py | 10 +- test/host/{ => bench/net}/e6_soak.py | 6 +- test/host/{ => bench/net}/latency_peer.py | 10 +- test/host/{ => bench/net}/pasv_probe.py | 10 +- test/host/{ => bench/net}/relisten_stress.py | 10 +- test/host/{ => bench/net}/udp_queue_bench.py | 2 +- .../net}/udp_queue_bench_loopback.py | 2 +- .../screenlink}/remolcd_pull_test.py | 10 +- .../screenlink}/screenlink_bench.py | 6 +- test/host/{ => bench/wave}/wave_read.py | 19 +-- test/host/cal/cal_write.py | 15 ++- test/host/iec104/stub/dbg_log.h | 20 --- test/host/wave_store/run_unit_test.py | 2 +- test/host/wave_trig/wave_trig_test.c | 2 +- 70 files changed, 415 insertions(+), 224 deletions(-) create mode 100644 test/host/bench/README.md rename test/host/{ => bench}/bench_defaults.py (100%) rename test/host/{ => bench/ftp}/ftp_abort_probe.py (91%) rename test/host/{ => bench/ftp}/ftp_auth_bench.py (93%) rename test/host/{ => bench/ftp}/ftp_capture.py (100%) rename test/host/{ => bench/ftp}/ftp_integrity_test.py (89%) rename test/host/{ => bench/ftp}/ftp_list_fill_test.py (90%) rename test/host/{ => bench/ftp}/ftp_regression.py (89%) rename test/host/{ => bench/ftp}/ftp_speed_test.py (95%) rename test/host/{ => bench/ftp}/ftp_test.py (93%) rename test/host/{ => bench/ftp}/ftp_up_dl_test.py (95%) rename test/host/{ => bench/ftp}/n30_repro.py (83%) rename test/host/{ => bench/iec104}/iec104_master.py (98%) rename test/host/{ => bench/iec104}/test_iec104_master_rx.py (98%) rename test/host/{ => bench/net}/ch395f_reuse_host.py (91%) rename test/host/{ => bench/net}/ch395f_socket_test.py (99%) rename test/host/{ => bench/net}/e11_keepalive_probe.py (93%) rename test/host/{ => bench/net}/e6_soak.py (87%) rename test/host/{ => bench/net}/latency_peer.py (98%) rename test/host/{ => bench/net}/pasv_probe.py (89%) rename test/host/{ => bench/net}/relisten_stress.py (83%) rename test/host/{ => bench/net}/udp_queue_bench.py (99%) rename test/host/{ => bench/net}/udp_queue_bench_loopback.py (99%) rename test/host/{ => bench/screenlink}/remolcd_pull_test.py (94%) rename test/host/{ => bench/screenlink}/screenlink_bench.py (97%) rename test/host/{ => bench/wave}/wave_read.py (98%) delete mode 100644 test/host/iec104/stub/dbg_log.h diff --git a/.dsh/skills/board-ui-nav/SKILL.md b/.dsh/skills/board-ui-nav/SKILL.md index b4d13fac..cdbe52f2 100644 --- a/.dsh/skills/board-ui-nav/SKILL.md +++ b/.dsh/skills/board-ui-nav/SKILL.md @@ -42,6 +42,17 @@ whenToUse: 需要上真机/台架进某页面看图(如故障录波、回放 - 执行类页面 `clear`/`reset`(第二次 ENTER 即真执行)主机与固件**双侧**默认拒绝, `--allow-exec-pages` 才放行,放行 = 接受后果。 +## 成功输出(默认路径跑通的样子) + +无台架时的门禁快检 = `--selftest-quick`,本轮实跑 RC=0,末两行原文如下;看到三项「错 0」齐即通过,不用再往下看。 + +```text +汇总(快检):黄金参考 76 帧错 0;留档帧 0 帧错 0;硬闸用例 7 条错 0 +闭环导航未跑(需 lvgl_sim.exe):完整自检用 --selftest +``` + +带 `--where`/`--to` 的台架路径成功判据 = 退出码 0 + `--trace` jsonl 落盘(本轮无台架未实跑,故只写判据、不伪造 stdout)。 + ## 失败处置索引(退出码 / 报错 → 查哪一节) 执行体 `scripts/board_ui_nav.py` 在仓库根 `scripts/`、不在本技能目录,脚本无法打印技能内指针——**本表由主文件显式维护**。退出码:`0` 成功 / `1` 分类或导航失败 / `2` 环境错误 / `3` 拒动(未持锁确认位等)。失败时按索引键到 [recovery.md](reference/recovery.md) 读**同名小节**(每节 = 判据 / 处置 / 证据边界);正常路径不展开。 diff --git a/.dsh/skills/id-family-semantic-migration/SKILL.md b/.dsh/skills/id-family-semantic-migration/SKILL.md index df470977..b1c17105 100644 --- a/.dsh/skills/id-family-semantic-migration/SKILL.md +++ b/.dsh/skills/id-family-semantic-migration/SKILL.md @@ -64,6 +64,12 @@ version: 1.1.0 9. 收尾复跑 + 清中间产物 > 本节全文(逐字搬移、未改写,含命令与实测数字)→ [steps-chinese-prefix-family.md](reference/steps-chinese-prefix-family.md)。动手前先读那篇。 +## 成功输出(默认路径跑通的样子) + +本技能为流程型,无单一成功 stdout(`rename_ids.py` / `check_ids.py` 两道门禁 2026-10-28/29 已退役,不跑它们当样例)。 + +**完成判据**:门禁 rc=0 + 本族残留计数归零 + `docs/文档规范.md` §7.1 已回写。 + ## 涨点归因(只在不可判定引用绝对数涨点时读) - [ ] **attribution** → 涨了 N 处要定位落在哪个文件时,读 [attribution.md](reference/attribution.md) 的 `attribution` 节;禁止拿 diff 新增行 grep 形态归因。 diff --git a/.dsh/skills/stale-doc-count-sweep/SKILL.md b/.dsh/skills/stale-doc-count-sweep/SKILL.md index 7ed5086e..4498ab44 100644 --- a/.dsh/skills/stale-doc-count-sweep/SKILL.md +++ b/.dsh/skills/stale-doc-count-sweep/SKILL.md @@ -34,6 +34,12 @@ whenToUse: 某个计数/数字变了要跨 md/yaml/py/txt 同步、用户说「 8. 跑门禁、分笔提交 > 本节全文(逐字搬移、未改写,含命令与实测数字)→ [steps.md](reference/steps.md)。动手前先读那篇。 +## 成功输出(默认路径跑通的样子) + +本技能为流程型,无单一成功 stdout(主文件记录的各 `check_*.py` 通过行是**别的门禁**的输出,不冒充本技能产物)。 + +**完成判据**:全部旧形态复扫、当前态残留 = 0,各道门禁分笔 rc=0 / `failed=0`。 + ## Pitfalls - 把伪命中计进真值 diff --git a/App/algo/wave_store.h b/App/algo/wave_store.h index 66c24bfe..aa9a6c45 100644 --- a/App/algo/wave_store.h +++ b/App/algo/wave_store.h @@ -2,7 +2,7 @@ * 模块名称:录波段格式层(故障录波 · 段文件字节布局编解码 + 打包游标 + 段名轮转) * 模块功能:把「一段录波」在内存字节缓冲与结构化元数据之间逐字节翻译,并给落盘道 * 提供分次搬运的打包游标。口径唯一属主 = docs/子系统设计/故障录波设计说明.md §6.2 - * (字节布局)与 §6.3(九问裁定:板端编码器与 PC 解码器 test/host/wave_read.py + * (字节布局)与 §6.3(九问裁定:板端编码器与 PC 解码器 test/host/bench/wave/wave_read.py * 两份独立实现的共同依据)。本文件是它的机器可执行形态,不在此重新定义任何口径; * 两处冲突以设计文档为准并回报 lead,不在代码里单方面「修正」。 * 纯逻辑层纪律:不 include HAL / CMSIS / RTOS 头、不调 FatFs、不碰文件系统、 diff --git a/Drivers/BSP/CH395F/README.md b/Drivers/BSP/CH395F/README.md index 6b76cb1b..bf1f57a1 100644 --- a/Drivers/BSP/CH395F/README.md +++ b/Drivers/BSP/CH395F/README.md @@ -31,4 +31,4 @@ - 测试指南:`docs/测试说明/板级测试/CH395F_Test_Guide.md` - 上层抽象:`../NET/README.md` -- 台架探针:`MDK-ARM/tcp_reconnect_probe.py`、`test/host/ftp_abort_probe.py` +- 台架探针:`MDK-ARM/tcp_reconnect_probe.py`、`test/host/bench/ftp/ftp_abort_probe.py` diff --git a/Drivers/BSP/NET/lftpd/README.md b/Drivers/BSP/NET/lftpd/README.md index a835da52..3f808249 100644 --- a/Drivers/BSP/NET/lftpd/README.md +++ b/Drivers/BSP/NET/lftpd/README.md @@ -37,5 +37,5 @@ lftpd(本目录) ## 相关文档 - 测试指南:`docs/测试说明/板级测试/FTP_Test_Guide.md` -- 台架探针:`test/host/ftp_abort_probe.py`、`MDK-ARM/ftp_freeze_probe.py` +- 台架探针:`test/host/bench/ftp/ftp_abort_probe.py`、`MDK-ARM/ftp_freeze_probe.py` - 内存优化:`docs/内存管理/RAM使用分析与优化方案.md` §4.1.4 diff --git a/MDK-ARM/ftp_freeze_probe.py b/MDK-ARM/ftp_freeze_probe.py index c9ef2dd4..d22119f8 100644 --- a/MDK-ARM/ftp_freeze_probe.py +++ b/MDK-ARM/ftp_freeze_probe.py @@ -22,9 +22,9 @@ import argparse, hashlib, io, os, random, socket, sys, time from ftplib import FTP, error_reply, error_temp, error_perm, all_errors -# 台架连接默认值单一真源在 test/host/bench_defaults.py(跨目录:补 sys.path 后 import) +# 台架连接默认值单一真源在 test/host/bench/bench_defaults.py(跨目录:补 sys.path 后 import) _sys_path = os.path.join(os.path.dirname(os.path.abspath(__file__)), - "..", "test", "host") + "..", "test", "host", "bench") if _sys_path not in sys.path: sys.path.insert(0, _sys_path) import bench_defaults # noqa: E402 diff --git a/MDK-ARM/tcp_reconnect_probe.py b/MDK-ARM/tcp_reconnect_probe.py index 4f45b2c3..cab287a1 100644 --- a/MDK-ARM/tcp_reconnect_probe.py +++ b/MDK-ARM/tcp_reconnect_probe.py @@ -21,9 +21,9 @@ # Exit: 0 all rounds connected / 1 any failure / 2 usage import argparse, os, socket, sys, time -# 台架连接默认值单一真源在 test/host/bench_defaults.py(跨目录:补 sys.path 后 import) +# 台架连接默认值单一真源在 test/host/bench/bench_defaults.py(跨目录:补 sys.path 后 import) _sys_path = os.path.join(os.path.dirname(os.path.abspath(__file__)), - "..", "test", "host") + "..", "test", "host", "bench") if _sys_path not in sys.path: sys.path.insert(0, _sys_path) import bench_defaults # noqa: E402 diff --git a/docs/内存管理/RAM使用分析与优化方案.md b/docs/内存管理/RAM使用分析与优化方案.md index 4c938c30..e686ed12 100644 --- a/docs/内存管理/RAM使用分析与优化方案.md +++ b/docs/内存管理/RAM使用分析与优化方案.md @@ -418,7 +418,7 @@ void vApplicationMallocFailedHook(void) - 帧宽榜直接点名宽度大户(自身帧):`s_append` 704 B(FIL 512 + 记录 64 + 时间戳)、`StartDefaultTask` 560 B(探针 `FIL __chk`)、`cfg_store_read`/`cfg_store_write_atomic` 576 B、LVGL 绘制 624/560/400 B——与 §4.1.4 的整改项对得上。**lftpd 三项已于 2026-09-21 静态化(§4.1.4),已退出帧宽榜前 15**(原 `handle_control_channel` 1104 B、`receive_file`/`send_file` 1088 B、`send_response` 800 B)。 - **静态分析的天然盲区**:递归/互递归(LVGL widget 树、`layout_update_core`、`apply_theme` 等)与间接调用只能按 "Cycle" 近似,armlink 明确标注 `+ Unknown(Cycles, Untraceable Function Pointers)`。因此 uiTask 的 912 B 是**下限**(实测 3824 B),必须靠运行时水位。 - testTask 在产品构建里只是 `osDelay` 空循环(168 B);2048 words 是给**存储套件构建**(`TEST_SUITE_STORAGE`)预留的,测套件时应重跑本脚本看该构建的静态值。 -- **测 ftpTask 的复现配方**:设备就绪后跑 `& '.venv\Scripts\python.exe' test/host/ftp_speed_test.py --size 128`(STOR 128KB + RETR + 逐字节比对),再按上面命令叠加串口日志出报告。**不要用裸 TCP 工具探测 21 端口**——CH395F 单客户端复用,探测会占掉唯一会话(见 `docs/测试说明/板级测试/FTP_Test_Guide.md` §8.9)。 +- **测 ftpTask 的复现配方**:设备就绪后跑 `& '.venv\Scripts\python.exe' test/host/bench/ftp/ftp_speed_test.py --size 128`(STOR 128KB + RETR + 逐字节比对),再按上面命令叠加串口日志出报告。**不要用裸 TCP 工具探测 21 端口**——CH395F 单客户端复用,探测会占掉唯一会话(见 `docs/测试说明/板级测试/FTP_Test_Guide.md` §8.9)。 #### 2026-10-10 复测:**不抬栈**把 defaultTask 从 FAIL 拉回 PASS(该项销项) diff --git a/docs/子系统设计/IEC104上行设计说明.md b/docs/子系统设计/IEC104上行设计说明.md index 57d6882c..ec4f508b 100644 --- a/docs/子系统设计/IEC104上行设计说明.md +++ b/docs/子系统设计/IEC104上行设计说明.md @@ -99,7 +99,7 @@ | 通讯参数段 | `App/protocol/iec104/iec104_comm.c/h`(道G task-8) | `[comm]` 段注册 + ca/端口 getter 合法带自愈 / setter 守卫 | cfg_file 引擎(只注册不属主) | > 三个纯逻辑模块 + 真实数据源(`App/algo/` 全纯逻辑)可整体在主机侧编译 → -> 主机侧纯逻辑单测覆盖**全协议栈**(`test/host/iec104/`),与 `test/host/prot_elm/` 同模式。 +> 主机侧纯逻辑单测覆盖**全协议栈**(`test/host/iec104/` 已删除 2026-11-18,随旧自研协议层三源退役),与 `test/host/prot_elm/` 同模式。 ## 3. 点表(V0.1) @@ -300,9 +300,9 @@ | 层 | 内容 | |---|---| -| 主机侧纯逻辑单测 | `test/host/iec104/`:APCI 重组/坏帧、STARTDT 握手、总召全流程(含 RBT/分片/预算)、COV、k/w 窗、t1/t2/t3(假时基)、遥控两段式与 PN、YK12 软压板两段转真 + 置脏(保护定值持久化)、定值两段写 + set_sealed 后 selfcheck、C_RD(含本地项不可寻址)、C_CS(含闰年)、错地址/错类型 EVI;**板端默认源真实链**(ring→phasor→freq→meas 快照,非桩):值/品质透传、CLIPPED→IV、0x401D 绑频(收敛 ±0.02 Hz / 未新鲜 IV)、死区运行时化 + 2 点确认/回摆撤销、seq 去重(104 改读快照与频率点绑定,TC-IEC104-025~028)+ 运行参数段路由/两段式/RMW(TC-IEC104-029)+ `[comm]` 段真链(道G task-8,TC-IEC104-031~033:注册/出厂模板/沉降重载/带外自愈/setter 守卫/ca 端到端 = C_RD 正答与旧写死 ca=1 转 COT13+EVI);`test/host/iec104_serv/` 钉端口与 ca 取值来源(TC-I104SRV-001b/c);`test/host/cfg_file/` 钉段/键容量上限(TC-CONFIG-056/057);`test/host/run_par/`:[run_par] 注册/落盘往返/守卫/系数直通合法带(TC-RUNPAR-001~008);`test/host/prot_set/`:blob 往返 + 损坏整表拒绝(all-or-nothing)| +| 主机侧纯逻辑单测 | `test/host/iec104/`(已删除 2026-11-18):APCI 重组/坏帧、STARTDT 握手、总召全流程(含 RBT/分片/预算)、COV、k/w 窗、t1/t2/t3(假时基)、遥控两段式与 PN、YK12 软压板两段转真 + 置脏(保护定值持久化)、定值两段写 + set_sealed 后 selfcheck、C_RD(含本地项不可寻址)、C_CS(含闰年)、错地址/错类型 EVI;**板端默认源真实链**(ring→phasor→freq→meas 快照,非桩):值/品质透传、CLIPPED→IV、0x401D 绑频(收敛 ±0.02 Hz / 未新鲜 IV)、死区运行时化 + 2 点确认/回摆撤销、seq 去重(104 改读快照与频率点绑定,TC-IEC104-025~028)+ 运行参数段路由/两段式/RMW(TC-IEC104-029)+ `[comm]` 段真链(道G task-8,TC-IEC104-031~033:注册/出厂模板/沉降重载/带外自愈/setter 守卫/ca 端到端 = C_RD 正答与旧写死 ca=1 转 COT13+EVI);`test/host/iec104_serv/`(已不存在,2026-11-18 复核)钉端口与 ca 取值来源(TC-I104SRV-001b/c);`test/host/cfg_file/` 钉段/键容量上限(TC-CONFIG-056/057);`test/host/run_par/`:[run_par] 注册/落盘往返/守卫/系数直通合法带(TC-RUNPAR-001~008);`test/host/prot_set/`:blob 往返 + 损坏整表拒绝(all-or-nothing)| | 静态门禁 | `iec104-unit-test` 钩子 + cppcheck/coding-standard | -| 台架 | `/serial-boot-test` 锚点(104 服务启动/监听行);**PC 主站客户端 `test/host/iec104_master.py`(纯标准库,台架复测 2026-10-12 就绪)**:STARTDT/总召四组+actterm/C_SE 定值两段写→YX15·16 变位(COT=3)/恢复复归/YK11 两段正答/C_RD 读回,台架往返 **18/18 PASS**(证据 `../测试说明/测试数据/boot_log_data/20261012_B6_iec104_roundtrip_log.txt`);**保护定值持久化模式 `--b7-pre/--b7-post/--b7-mark/--b7-check`**(中间 ST-LINK 复位):YK12 两段投退→保护退出/联动、**定值与压板态跨复位保持**(含非默认 7.5 往返),**21/21 + 13/13 + 4/4+4/4 PASS**(证据 `../测试说明/测试数据/boot_log_data/20261012_B7_iec104_persist_log.txt`);**SOE 记录腿**(同工具同轮回归):自发 YX 断言 **M_SP_TB_1 带 ts**(工具解析 type 30/1 双型)+ FTP 下载 `/log/soe.log` 经 `test/host/soe/decode_soe.py` 解码断言(校验和/seq 单调/CP56↔epoch UTC 交叉),pre 21/21 + post 13/13 不回归;lib60870 级第三方全流程归 第三方送检验收 | +| 台架 | `/serial-boot-test` 锚点(104 服务启动/监听行);**PC 主站客户端 `test/host/bench/iec104/iec104_master.py`(纯标准库,台架复测 2026-10-12 就绪)**:STARTDT/总召四组+actterm/C_SE 定值两段写→YX15·16 变位(COT=3)/恢复复归/YK11 两段正答/C_RD 读回,台架往返 **18/18 PASS**(证据 `../测试说明/测试数据/boot_log_data/20261012_B6_iec104_roundtrip_log.txt`);**保护定值持久化模式 `--b7-pre/--b7-post/--b7-mark/--b7-check`**(中间 ST-LINK 复位):YK12 两段投退→保护退出/联动、**定值与压板态跨复位保持**(含非默认 7.5 往返),**21/21 + 13/13 + 4/4+4/4 PASS**(证据 `../测试说明/测试数据/boot_log_data/20261012_B7_iec104_persist_log.txt`);**SOE 记录腿**(同工具同轮回归):自发 YX 断言 **M_SP_TB_1 带 ts**(工具解析 type 30/1 双型)+ FTP 下载 `/log/soe.log` 经 `test/host/soe/decode_soe.py` 解码断言(校验和/seq 单调/CP56↔epoch UTC 交叉),pre 21/21 + post 13/13 不回归;lib60870 级第三方全流程归 第三方送检验收 | ## 8. V0.1 限制与待办(如实登记) @@ -316,7 +316,7 @@ **不存系数**,系数真源在 [adc_cal] 段,见 §3.4 表注),`iec104_pts_yc_set_deadband` 降级为转发壳。 5. 多主站/双链路冗余不做(单连接语义)。 -6. 主站侧验证工具 = `test/host/iec104_master.py`(台架复测 2026-10-12 就绪,台架往返 18/18,覆盖总召/变位/遥控/定值);**第三方送检环境仍未就绪**——lib60870 级第三方全流程归 第三方送检验收。 +6. 主站侧验证工具 = `test/host/bench/iec104/iec104_master.py`(台架复测 2026-10-12 就绪,台架往返 18/18,覆盖总召/变位/遥控/定值);**第三方送检环境仍未就绪**——lib60870 级第三方全流程归 第三方送检验收。 7. **后连优先未实现**(V0.1 = 首到优先):单连接 socket 连接态无法 accept, 旧会话结束前新主站接入被拒;后连优先需 net 层(CH395F 单连接模型)支持, 真需要冗余切换时随 net 扩展立项。 diff --git a/docs/子系统设计/屏板链路设计.md b/docs/子系统设计/屏板链路设计.md index 7aa7f0f9..1eefa662 100644 --- a/docs/子系统设计/屏板链路设计.md +++ b/docs/子系统设计/屏板链路设计.md @@ -78,7 +78,7 @@ flowchart TB ### 3.2 PC 顶替屏板(无屏板实物的台架验证) - USB 转 TTL 适配器:`TXD` → `U5.B10`、`RXD` → `U5.A10`、`GND` → 板地;700000 8N1; - 激励脚本 `test/host/screenlink_bench.py` 按屏板节拍发 6 B 帧 A(`--key-fixed` 持续改画面取组帧样本、 + 激励脚本 `test/host/bench/screenlink/screenlink_bench.py` 按屏板节拍发 6 B 帧 A(`--key-fixed` 持续改画面取组帧样本、 `--glitch-baud` 灌噪声验自愈、`--reply` 收应答)。 - ⚠ **CH340 收不了 700 kbaud 连续流**(RX FIFO 几十字节 + USB 每 1 ms 才搬一次,实测只收到 ≈2373 B / 9.5 kB/s): **收不全 ≠ 固件没发**,同轮 `tx == done` 即自证;要收全 4208 B 帧验内容须换 FTDI / CP210x。 diff --git a/docs/子系统设计/故障录波设计说明.md b/docs/子系统设计/故障录波设计说明.md index 6150a9c7..ba1ea76d 100644 --- a/docs/子系统设计/故障录波设计说明.md +++ b/docs/子系统设计/故障录波设计说明.md @@ -209,7 +209,7 @@ flowchart TD ### 6.3 字段口径裁定(两份独立实现的共同依据) -本波段格式有**两份独立实现**:板端编码器 `App/algo/wave_store.c` 与 PC 解码器 `test/host/wave_read.py`,两份必须逐字节同解,所以动工前把 §6.2 的含糊处一次钉死(PC 道九问的逐条答复): +本波段格式有**两份独立实现**:板端编码器 `App/algo/wave_store.c` 与 PC 解码器 `test/host/bench/wave/wave_read.py`,两份必须逐字节同解,所以动工前把 §6.2 的含糊处一次钉死(PC 道九问的逐条答复): | 问题 | 裁定 | |---|---| @@ -300,7 +300,7 @@ flowchart TD ### 8.4 现场之外,PC 侧必须同时具备 - **取回**:FTP 拉 /wave/WAVE 段文件(lftpd 与 config.ini 的 ftp 段鉴权现成,无需新代码); -- **PC 脚本**:仓内新增一个纯标准库脚本(与 `test/host/iec104_master.py` 同族风格)——读段、画图、重算全周傅氏,输出「板上报数 vs PC 重算」对照表。**这才是 `docs/算法/采集与算法层设计说明.md §13.10` 那套判据想要的东西**; +- **PC 脚本**:仓内新增一个纯标准库脚本(与 `test/host/bench/iec104/iec104_master.py` 同族风格)——读段、画图、重算全周傅氏,输出「板上报数 vs PC 重算」对照表。**这才是 `docs/算法/采集与算法层设计说明.md §13.10` 那套判据想要的东西**; - **远端看图不是波形通路**:RemoDispBus 一帧 3204 B、最坏约 4 s(`Drivers/BSP/UI/ui_net_sink.h` 的阻塞口径),只适合拍一张回放页的屏做留证。 --- @@ -324,7 +324,7 @@ flowchart TD | 层 | 内容 | |---|---| | 主机侧纯逻辑单测(新增,进 `test/host/`) | ① 环:预触发与后触发点数、冻结与解冻、冷却丢弃计数;② 段格式编解码往返,含 CRC 不符、零长度、字节数不符三条失败路径;③ 触发状态机三条来路(手动 / 保护 / bench)。**环与格式必须是纯逻辑**(不碰寄存器、不碰 RTOS)才能这样测——这是 `App/algo/` 既有分层纪律 | -| PC 侧工具的定性 | `test/host/wave_read.py` 是 **bench 工具**(`test/host/` 下的 loose .py,先例 `test/host/ftp_capture.py`),**不是**主机单测套件 → 不建 `run_unit_test.py`、不加 pre-commit 专属钩子(专属钩子默认不补,按 Lead 裁定 2026-10-27);它自带 `--selftest` 就是它的自带回归,跑法与四个子命令见 `docs/测试说明/专项验证/ADC前端注入验证流程.md` §4 | +| PC 侧工具的定性 | `test/host/bench/wave/wave_read.py` 是 **bench 工具**(`test/host/` 下的 loose .py,先例 `test/host/bench/ftp/ftp_capture.py`),**不是**主机单测套件 → 不建 `run_unit_test.py`、不加 pre-commit 专属钩子(专属钩子默认不补,按 Lead 裁定 2026-10-27);它自带 `--selftest` 就是它的自带回归,跑法与四个子命令见 `docs/测试说明/专项验证/ADC前端注入验证流程.md` §4 | | 跨工具链分叉(实证,写进来是为了下一个模块别重踩) | 两份录波 .c 只 include 自身头(链上只有 stdint.h)时,ARMCC 报 22 条 identifier "NULL" is undefined;而主机 MSVC / gcc 会传递性把 stddef.h 拉进来,**主机单测完全照不出这个分叉** → 新增模块需要用 NULL 就自己 include stddef.h(与 `App/algo/sample_ring.c` 同口径,别塞公共头) | | 板级 | 信号发生器注 1 V / 50 Hz → 手动一段 → FTP 拉回 → PC 脚本量出周波数、幅值、极性与注入一致;再把 PC 重算的基波有效值与板上 `meas:` 对表。**判据只量四样:周波数、幅值、极性、钉轨路数——不比绝对相位**(理由见 §4.2「段内点序」:触发瞬间在工频周期内任意落点,段字节里没有绝对时间参考;真要比相位必须让发生器给同步触发,本波不做)。**钉轨对表的合格判据 = 头位图 ⊇ 实测钉轨路数,且差异必须能由注入条件解释**——因为 `clip_mask` 是按来源派生的链路可信性标记(§6.2 偏移 24 行),不是本段实测值:只加直流或小幅注入时那五路本就不该钉轨,硬取等式会假红。**同段另起一条强观察项**:V0.1 下这五路若在做**交流注入**时反而没钉轨,先怀疑接线或该路根本没被驱动——这是告警面,不是失败面(等式仍作为默认尺子留在 PC 侧 `shape --strict` 里,因为它有这个信号价值;要放行差异用那条判据的解释权,不靠改尺子)。**§5.2 第四条的板级观察项(代码与单测面已有、板级未测)**:bench 连续自抓期间人为把卷占住 2 s 以上(例如同一段跑 FTP 大文件读),看串口 `wave:` 行的 `err` 是否加一、是否只出现**一条** `[ERR] … seg drop: ring abandoned` 留痕(不是每拍刷屏)、且段号不推进(下一段仍写同号文件)——**2026-11-07 已闭环**:bench 定时自抓与临界占卷三判据台架远程轮逐条对上,长占卷静默自弃(72.6 s 连续占卷 `err` 1→15 零留痕)与临界命中唯一留痕(`err` 恰 +1、同号重写)两种形态都有实证,见下「bench 定时自抓与占卷弃段观察闭环记录」小节 | | 板级·触发来路(2026-10-30 并入原卡「手动触发与保护启动接线」板级段) | 真机面板按一次「手动录波」出一段;造一次过流,段号与该时刻 `/log/start.log` 事件对齐;冷却期内二次触发只加 `ovf` 不重录(**同时看 `armed` 与那一刻 start.log 的时刻,不要只盯 `ovf` 数字**——容差见 §9);冻结窗口内 104 上送与保护判据不受影响(这条是「丢录波样本不丢采集」的验收) | @@ -368,7 +368,7 @@ bench 锁全程持有(收工 release,PASS 证据就是本小节);设备 | 冷却后再触发恢复 | 前一触发后独立走完整链(进页 → 二次确认 → 执行)再成段;`ovf` 全程干净 | | 轮转命名 | 段号顺序推进;坏段 DELE 后重触发**同号覆盖**为真段(WAVE05) | | PC 侧坏段拒收 | 位翻转样本 `wave_read dump` → `REJECT: data CRC16 mismatch: stored 0x2F13 calc 0x03D5 over 5120 bytes at offset 128 -- segment rejected, nothing drawn`(rc=1)✓ | -| 冻结窗口内 104 上送无恙(**正式判据项**) | 参考主站 `test/host/iec104_master.py` 全程跑在落盘窗口内:GI 扫描(双点组 / 单点组 / YC 组 / 频率)+ actterm + 定值读回全绿,**唯二 FAIL 是两条 COV 腿 = 标定闭锁腿(OC1 不出口,物理预期,非链路故障)**;全程无链路异常、无 send fail | +| 冻结窗口内 104 上送无恙(**正式判据项**) | 参考主站 `test/host/bench/iec104/iec104_master.py` 全程跑在落盘窗口内:GI 扫描(双点组 / 单点组 / YC 组 / 频率)+ actterm + 定值读回全绿,**唯二 FAIL 是两条 COV 腿 = 标定闭锁腿(OC1 不出口,物理预期,非链路故障)**;全程无链路异常、无 send fail | | `drop` 观测 | 每冻结窗约 400–640 点(51–79 拍 × 8 路)入账,量级 = SEALED 态每拍 push +8 直到落盘 ACK 的窗口长度;`seg` 无丢段、`err`=0,采集无恙——纯观察项非失败(「丢样本不丢采集」的实测面) | **新发现缺陷「回放页段表枚举恒空(板级)」**(**2026-11-02 修复闭环,完整记录即本小节**):回放页真机开屏恒显 @@ -561,7 +561,7 @@ bench 锁全程持有(任务 `exec-issue-84`,`_wt` 规范锁区手工获取 TAIL,CRC}=1..5`(宏值域按「接口只增不改」纪律钉死),判废时单点 `DBG_ERROR("ui wave head idx=%u reject=%u stored=0x%04X calc=0x%04X")` **逐次一条不去重** (频控天然 = 每次进入坏段一行,与按键、画面一一对应;判废是低频人工动作,逐次留痕正是 - 取证要的)。第 5 类附 stored/calc 两组值、与 PC 侧 `test/host/wave_read.py` 的 REJECT 行 + 取证要的)。第 5 类附 stored/calc 两组值、与 PC 侧 `test/host/bench/wave/wave_read.py` 的 REJECT 行 **同名同值互证**,其余四类该两字段打 `0x0000` 占位。级别 ERROR 与同函数 `open fail` 同面; `/serial-boot-test` 的 `[ERR]` Forbidden 会命中**故意投坏段的轮次**——判读行已补进手册 §4 与 §8(坏段轮 reject 行 = 预期内,其余 `[ERR]` 照旧停幕)。画面零改动:判废态仍 @@ -604,7 +604,7 @@ Before/After 表与串口原文。 **板级取证**(FTP 直读 `192.168.31.100`,admin/admin;100 件全部归档到 `ci-artifacts/wave_append_backup_20261110/`):`/wave` 共 100 个 `WAVE00.BIN`…`WAVE99.BIN`、 9,807,000 B = 1868 段;尺寸 10,500~147,000 B **全部是 5250 的整数倍**,**恰好等于 5250 的文件数为 0**; -用 `test/host/wave_read.py` 的 `parse_segment()` 逐段校验 **1868 段全过、零损坏**。也就是说数据 +用 `test/host/bench/wave/wave_read.py` 的 `parse_segment()` 逐段校验 **1868 段全过、零损坏**。也就是说数据 一直是好的,只是容器尺寸与写者语义相抵。 **修复(用户裁定取「写者截断」,否掉「读侧多段感知」——后者改动面大,还要同步 PC 侧 diff --git a/docs/架构设计/项目架构总览.md b/docs/架构设计/项目架构总览.md index 13b22df9..9c20ccc3 100644 --- a/docs/架构设计/项目架构总览.md +++ b/docs/架构设计/项目架构总览.md @@ -229,7 +229,7 @@ flowchart TB **单连接约束**:CH395F 配置为 8 Socket(索引寻址)+ TCP Server 单连接(`set_fun_para(0x08)`,bit3 SOCKET_CLOSE;bit0 保留必须为 0),Socket 0 复用监听与数据通道;FTP / 对时 / 远程显示 / IEC104 四个 TCP 服务**串行**占用连接,连接断开后自动回到 LISTEN。人机显存的另一路出口(屏板)走 USART1 串口、不经 TCP——显存**一份三出**:屏板(主)/ :7003(网络镜像)/ 模拟器(同源像素)。 > **FTP 启动门(2026-09-21 修复)**:`ftpTask` 必须等 `NET_READY` **且** `STORAGE_READY`(两位均 `NoClear`)才 `lftpd_start`——此前就绪位被其它等待者消费,FTP **静默不监听**(详见 §2.2 与 `docs/测试说明/板级测试/FTP_Test_Guide.md` §8.6)。 -> **单客户端实测注意**:同一时刻只服务 1 个会话,旧会话异常断开后经 `net_listener` 重建监听(实测恢复窗 p50 **208 ms**,n=30;口径见 `docs/网络/网络自愈架构设计.md`)。测试脚本必须内置连接重试(`test/host/ftp_up_dl_test.py`、`test/host/ftp_regression.py` 已内置),且**不要用裸 TCP 工具探测 21 端口**(探测会占掉唯一会话,见 `docs/测试说明/板级测试/FTP_Test_Guide.md` §8.7)。 +> **单客户端实测注意**:同一时刻只服务 1 个会话,旧会话异常断开后经 `net_listener` 重建监听(实测恢复窗 p50 **208 ms**,n=30;口径见 `docs/网络/网络自愈架构设计.md`)。测试脚本必须内置连接重试(`test/host/bench/ftp/ftp_up_dl_test.py`、`test/host/bench/ftp/ftp_regression.py` 已内置),且**不要用裸 TCP 工具探测 21 端口**(探测会占掉唯一会话,见 `docs/测试说明/板级测试/FTP_Test_Guide.md` §8.7)。 > **阻塞模型(2026-10-14 SEND 二期落地)**:阻塞 recv/send 经 `net_pending` 挂起请求表续作,调用方铁律 `sent < len`(末块写完即返回、不得登记挂起);架构与五路语义见 `docs/网络/Net层阻塞模型架构设计.md`,监听重建/沉降隔离/周期对账见 `docs/网络/网络自愈架构设计.md`。 > 2026-10-14 实测:FTP 回归连续 19 次 11/11;`ftp_integrity_test` 20 轮 × 64 KB STOR/RETR SHA-256 20/20 一致,吞吐稳定 ≈80 KB/s。 @@ -400,7 +400,7 @@ flowchart LR | 看门狗 / CubeMX 重生成存活方法论 | `docs/子系统设计/看门狗设计说明.md` §10 | | RAM 预算与优化 | `docs/内存管理/RAM使用分析与优化方案.md` | | 栈/内存观测工具 | `scripts/stack_report.py`(Keil 静态调用图 × 串口 `[STACK]` 水位,判定取两者更坏者)· `scripts/ram_report.py`(.map 静态占用)—— 用法与基线见内存方案 §4.0.6 | -| FTP 功能与陷阱 | `docs/测试说明/板级测试/FTP_Test_Guide.md` §8.6(启动门)/ §8.7(单客户端)· 脚本 `test/host/ftp_up_dl_test.py`、`test/host/ftp_regression.py`、`test/host/ftp_integrity_test.py` | +| FTP 功能与陷阱 | `docs/测试说明/板级测试/FTP_Test_Guide.md` §8.6(启动门)/ §8.7(单客户端)· 脚本 `test/host/bench/ftp/ftp_up_dl_test.py`、`test/host/bench/ftp/ftp_regression.py`、`test/host/bench/ftp/ftp_integrity_test.py` | | UI 设计架构 / 内容页 / 菜单 | `docs/UI设计/UI_设计架构.md` · `内容页架构.md` · `菜单页面设计.md` | | UI 数据供给契约(rt/par/info 三帧) | `docs/UI设计/UI_数据供给设计.md` | | RemoDispBus 远程显示协议(:7003) | `docs/UI设计/RemoDispBus协议与接收设计说明.md` | diff --git a/docs/测试说明/专项验证/ADC前端注入验证流程.md b/docs/测试说明/专项验证/ADC前端注入验证流程.md index 57797c2e..e303dee0 100644 --- a/docs/测试说明/专项验证/ADC前端注入验证流程.md +++ b/docs/测试说明/专项验证/ADC前端注入验证流程.md @@ -54,7 +54,7 @@ | `phasor(hb) C0x-…: Re=.. Im=.. rms=..`、`freq(hb): f=.. valid=..` | 每 10 s | 基波相量与测频(×0.1 / ×0.01 定点) | **交流轮(§8)主要读的数**(直流轮只旁证) | | `meas: seq=.. v=.. ua_mv=.. un_mv=.. ia_mv=.. f=.. fv=..` | 每 10 s | 200 ms 遥测快照轨(基波有效值 mV) | 交流幅值比对(1 mV 分辨率) | | **段文件** `/wave/WAVE00.BIN` 起 100 号轮转(FTP 根下,与 /log 平级) | 每次触发一段 | 8 路 × 320 点 + 封存瞬间标定与品质快照(`docs/子系统设计/故障录波设计说明.md` §6.2) | **录波档要用的原始样本**:预触发 160 + 后触发 160 点,触发瞬间在段内点 159 | -| PC 侧 `test/host/wave_read.py`(纯标准库) | 手动跑;`--selftest` 自带回归 | 四子命令:dump(逐字段双 CRC)/ fft(全周傅氏重算基波有效值与相位)/ shape(削顶与形态,可 `--strict`)/ plot(SVG/PNG,PNG 用 `-o`) | 「PC 独立重算」执行体;CRC 不符或零长度必须**拒绝** | +| PC 侧 `test/host/bench/wave/wave_read.py`(纯标准库) | 手动跑;`--selftest` 自带回归 | 四子命令:dump(逐字段双 CRC)/ fft(全周傅氏重算基波有效值与相位)/ shape(削顶与形态,可 `--strict`)/ plot(SVG/PNG,PNG 用 `-o`) | 「PC 独立重算」执行体;CRC 不符或零长度必须**拒绝** | > ⚠ 交流轮次(判据 `docs/算法/采集与算法层设计说明.md §13.10`)必须用 `meas:` 比幅值,别用 `phasor(hb)`——那行 ×0.1 定点,注 1 V 只剩 10 格。 @@ -200,7 +200,7 @@ TPAFE 双极性补码可注负压;STM32 单极性负半周测不了。UA/UN/IA | **串口心跳行** `phasor(hb)`(打印处 `App/task/adc_task.c:209`) | `phasor(hb) C0x-…-F1: Re=.. Im=.. rms=.. (x0.1)` | **0.1 V、向下截断**(×0.1 定点) | 有数没数、量级、象限 | ⚠ 相位 ≤2°、谐波 ±2 % 想都别想:注 Vpp 2.828 V(板上 ≈1000 mV)时 `rms` 满打满算 10 格,20 % 谐波只占 2 格 | | **串口心跳行** `freq(hb)`(打印处 `App/task/adc_task.c:224`) | `freq(hb): f=.. valid=.. (x0.01)` | 0.01 Hz | 测频轮的读数和新鲜度(`valid`) | — | | **板子屏幕** 主界面→实时数据→交流量(代码 `Drivers/BSP/UI/ui_page_ac.c:47`) | 页 7 行 `Ua/U0/Ia/Ia2/Ia5/Hz/量纲`;量值行 3 位小数、Hz 行 2 位 | **1 mV**(靠人眼看屏 + 拍照留证) | 谐波轮 `Ia2`/`Ia5` 幅值;幅值轮交叉旁证;测频轮 `Hz` 显 `--` | 相位(页面上没有角度) | -| **录波段文件 + PC 重算**:把 `/wave/WAVE.BIN` 段取回本机用 `test/host/wave_read.py` 算(四子命令见 §4 表;格式属主 `docs/子系统设计/故障录波设计说明.md` §6.2/§6.3) | 段内 8 路 × 320 点原始码 + 封存瞬间的标定与品质快照 | `fft` 浮点重算:基波有效值、相位、2 次与 5 次谐波有效值(mV) | 相位 ≤2°、谐波 ±2 %——**只有这条路判得动**;顺带 PC 独立重算与板上数字互相对表 | 段与发生器**没有绝对相位锁**(触发点固定在段内点 159)→ 只能比同一段内的相对相位;一段 320 ms,不代表长时间稳定 | +| **录波段文件 + PC 重算**:把 `/wave/WAVE.BIN` 段取回本机用 `test/host/bench/wave/wave_read.py` 算(四子命令见 §4 表;格式属主 `docs/子系统设计/故障录波设计说明.md` §6.2/§6.3) | 段内 8 路 × 320 点原始码 + 封存瞬间的标定与品质快照 | `fft` 浮点重算:基波有效值、相位、2 次与 5 次谐波有效值(mV) | 相位 ≤2°、谐波 ±2 %——**只有这条路判得动**;顺带 PC 独立重算与板上数字互相对表 | 段与发生器**没有绝对相位锁**(触发点固定在段内点 159)→ 只能比同一段内的相对相位;一段 320 ms,不代表长时间稳定 | > **2026-11-02 / 11-04 两轮已跑、六轮全部闭合**。实测结论只详述在 `docs/硬件平台/ADC通道映射说明.md` §8.2,此处不抄第二份。 @@ -271,7 +271,7 @@ TPAFE 双极性补码可注负压;STM32 单极性负半周测不了。UA/UN/IA 1. 接好线、开发生器输出,等 ≥30 s 读数稳定; 2. 从串口取**连续 ≥10 行**心跳,先确认 `frames` 在涨、`adc1_err=0`(采不到算不得数),再核对卡片要求的读数——数字要取这 ≥10 行的**中位数**,别拿单行(`meas:` 是瞬时基波有效值透传、200 ms 是上送节拍非平均窗,`docs/算法/采集与算法层设计说明.md §13.9`,单行带拍频式跳动); -3. 这张卡的判据要录波取证的:抄完数后,从面板第 26 叶「手动录波」触发一段,把录波页屏上显示的文件名(`WAVE`)抄进该轮记录表;分析前在本机跑一次 `test/host/wave_read.py --selftest`,**不通过,分析结果不算证据**(不赶时间,六轮跑完统一取回再做); +3. 这张卡的判据要录波取证的:抄完数后,从面板第 26 叶「手动录波」触发一段,把录波页屏上显示的文件名(`WAVE`)抄进该轮记录表;分析前在本机跑一次 `test/host/bench/wave/wave_read.py --selftest`,**不通过,分析结果不算证据**(不赶时间,六轮跑完统一取回再做); 4. 关掉发生器输出,把数填进该卡记录表。 **两种情况先修再测,别往下走**:采集链没清(`frames` 不涨 / `adc1_err≠0`)→ 按 §8.2 前置门逐项查采集链;偏差没进判据 → 先复查三件事(端接 / 万用表响应类型 / 共地),改完重测,复查仍超才谈固件问题。 @@ -337,7 +337,7 @@ TPAFE 双极性补码可注负压;STM32 单极性负半周测不了。UA/UN/IA 1. `UA`(R31)与 `UN`(R28)两路接同一发生器输出(同相),注 **Vpp 2.828 V / 50.000 Hz**;稳定 ≥30 s 后在 UI「手动录波」确认页触发一次;成段有**秒级**延迟(落盘在 defaultTask,卷空闲后搬段)→ 等 `wave:` 行 `seg=` +1、`armed` 回 0 再取文件; 2. FTP 取 `/wave/WAVE.BIN`,**取完立刻改名**(100 号轮转会被覆盖); -3. 跑 `& '.venv\Scripts\python.exe' test/host/wave_read.py fft WAVE.BIN --all`——每个整周波给一行:基波有效值、相位、2 次与 5 次谐波有效值(mV,系数镜像 `App/algo/phasor.c`); +3. 跑 `& '.venv\Scripts\python.exe' test/host/bench/wave/wave_read.py fft WAVE.BIN --all`——每个整周波给一行:基波有效值、相位、2 次与 5 次谐波有效值(mV,系数镜像 `App/algo/phasor.c`); 4. 判据:`UA`(`--ch 0`)与 `UN`(`--ch 3`)在**同一周波**内相位差——同相 ≈0°,改 90° 后 ≈90°,容差 ±2°(`docs/算法/采集与算法层设计说明.md §13.10`); 5. ⚠ 段**绝对**相位与发生器无锁定(触发瞬间落在段内点 159)→ **只能比同段内相对差**,跨段比相位不成立(段内点序 `docs/子系统设计/故障录波设计说明.md` §6.2); 6. 交叉旁证:同一段先 `dump`(逐字段 + 双 CRC16),再 `plot --ch 0`(CRC 不符或零长度**必须拒收**);板上 `phasor(hb)` 象限应与脚本一致(×0.1 只够核象限)。 @@ -380,7 +380,7 @@ TPAFE 双极性补码可注负压;STM32 单极性负半周测不了。UA/UN/IA **段文件档的两个量具("来源派生 vs 实测"一次分清)** -`shape` 拿**实测**贴底与段头 `clip_mask` 对表;段头 bit **来源派生、从不实测**(`test/host/wave_read.py` 文件头与 `cl=0xE6` 同源互证)→ 三种注入各配一个量具: +`shape` 拿**实测**贴底与段头 `clip_mask` 对表;段头 bit **来源派生、从不实测**(`test/host/bench/wave/wave_read.py` 文件头与 `cl=0xE6` 同源互证)→ 三种注入各配一个量具: | 注入 | 命令 | 期望 | |---|---|---| @@ -417,7 +417,7 @@ TPAFE 双极性补码可注负压;STM32 单极性负半周测不了。UA/UN/IA 同一次注入(叠加档设想值:基波 Vpp 2.263 V + 二次与五次各 Vpp 0.453 V,峰值预算见上表;本轮发生器无叠加功能、未跑此档)触发一段,FTP 取回跑: ```text -& '.venv\Scripts\python.exe' test/host/wave_read.py fft WAVE.BIN --ch 4 --all +& '.venv\Scripts\python.exe' test/host/bench/wave/wave_read.py fft WAVE.BIN --ch 4 --all ``` `fft` 每整周波给基波与 2 次/5 次谐波有效值(mV,浮点重算),±2 % 是定量判据;`--ch` = 段内通道表序,`IA` = 4(`UA UB UC UN IA IB IC IN`,TEMP 不录,`App/algo/wave_ring.h:216`)。UI 目检只是**旁证**(证"板上与脚本算的是同一个东西"),不是替代判据。THD 与根均方不在本轮(谐波轨要做 THD 归 `docs/算法/继电保护功能复现规划.md` 的「遥测谐波轨(可选)」)。 diff --git a/docs/测试说明/专项验证/存储维护与容量恢复.md b/docs/测试说明/专项验证/存储维护与容量恢复.md index 8c05cafd..2826bbcc 100644 --- a/docs/测试说明/专项验证/存储维护与容量恢复.md +++ b/docs/测试说明/专项验证/存储维护与容量恢复.md @@ -108,7 +108,7 @@ LPN"上,格式化就在第一道闸门返回,`dhara_map_clear()` **从未执 必须含 **`/config.ini`**(网口与 FTP 鉴权配置)、**`/PROT_SET.BIN`**(保护定值 blob, `PROT_SET_BLOB_SZ` = 176 B,删了等于把定值清零)、**`/log`** 目录(运行与自检记录)。 - 三步验收:① 清完 `LIST` 只剩 `LOG` + `CONFIG.INI` + `PROT_SET.BIN`;② `/serial-boot-test` PASS(定值巡检 - 与配置加载都在这条链上);③ 跑 `test/host/ftp_list_fill_test.py` 确认 FTP 面正常。 + 与配置加载都在这条链上);③ 跑 `test/host/bench/ftp/ftp_list_fill_test.py` 确认 FTP 面正常。 - 这属于**动作 D(清文件)**,与本文 §1 的 A(重建 BBT + 格式化)/ B(全片擦除)/ C(容量恢复) 都不同:A/B 会丢卷内容,D 不动文件系统结构。 diff --git a/docs/测试说明/专项验证/故障录波板级到场轮执行手册.md b/docs/测试说明/专项验证/故障录波板级到场轮执行手册.md index 29ace3a2..ce56d27d 100644 --- a/docs/测试说明/专项验证/故障录波板级到场轮执行手册.md +++ b/docs/测试说明/专项验证/故障录波板级到场轮执行手册.md @@ -69,14 +69,14 @@ flowchart LR 1. **到你接线了**:发生器正弦 **50.000 Hz / 1.000 V rms** 接 **UA 端子**(接线四条件照 ADC 注入流程 §8.3:发生器端接高阻、端子侧焊盘、万用表并接、单点共地)——接好说"接上了"。 2. **[agent]** 先落一个基准:抓串口最近三条 `meas:` 与 `wave:` 心跳存证(对表分母)。 3. **到按键**(二选一,agent 会问):你面板走 主界面 → 装置维护 → 手动录波 →(修改密码 123)→ `e` 确认 → `e` 执行,页面出「已请求录波」即成;**或者**让 agent 从 7003 远程注键——键时序它已趟熟(drain 纪律见 `scripts/board_ui_nav.py` 文件头)。 -4. **[agent]** 等 `wave:` 心跳 seg+1 → FTP 拉回新段 → `test/host/wave_read.py dump`(双 CRC 必须绿)→ 量:**周波数**(160 点窗内基波频率,应 ≈50 Hz)、**幅值**(与万用表读数对,误差口径看 `docs/算法/采集与算法层设计说明.md §13.12` 前置决策 #1「精度目标」——**该目标还没拍板,量完记实测数即可,别现场编合格线**)、**极性**(触发拍在段内点 159,正半周起点看符号)、**钉轨路数**(UA 不该钉;`clip_mask` 位图对表规则照 `docs/子系统设计/故障录波设计说明.md` §10 板级行——**V0.1 五路在交流注入时反而没钉,先怀疑接线**)。 +4. **[agent]** 等 `wave:` 心跳 seg+1 → FTP 拉回新段 → `test/host/bench/wave/wave_read.py dump`(双 CRC 必须绿)→ 量:**周波数**(160 点窗内基波频率,应 ≈50 Hz)、**幅值**(与万用表读数对,误差口径看 `docs/算法/采集与算法层设计说明.md §13.12` 前置决策 #1「精度目标」——**该目标还没拍板,量完记实测数即可,别现场编合格线**)、**极性**(触发拍在段内点 159,正半周起点看符号)、**钉轨路数**(UA 不该钉;`clip_mask` 位图对表规则照 `docs/子系统设计/故障录波设计说明.md` §10 板级行——**V0.1 五路在交流注入时反而没钉,先怀疑接线**)。 5. **换点再来一遍**:发生器升到能钉住 UB/UC/IB/IC/IN 任一路的量级(削顶的老口径见 `docs/测试说明/专项验证/ADC前端注入验证流程.md` §8.5 削顶卡;片内 ADC 五路单极性、负半周钉 0 的机理在 `docs/硬件平台/ADC通道映射说明.md`)——**这一遍你只拧幅值键**,录波触发重复第 3~4 步,钉轨对表应见 ≥1 路实测钉轨且能由注入解释。 -6. **[agent]** `meas:` 与 104 浮点遥测对表:参考主站 `test/host/iec104_master.py` 读 YC 浮点,和 `meas:` 行、和你注入的 1.000 V 三方对齐——**你只需报万用表读数**。 +6. **[agent]** `meas:` 与 104 浮点遥测对表:参考主站 `test/host/bench/iec104/iec104_master.py` 读 YC 浮点,和 `meas:` 行、和你注入的 1.000 V 三方对齐——**你只需报万用表读数**。 7. **坏段画面(这一幕的收尾,要第一幕修好)**:[agent] 造一份位翻转坏段上板(`RETR→翻一位→STOR 回同号`)→ 开回放页翻到该段——**判据:绝不许画成一条直线**,该显拒收态;agent 抓屏给你目检。 - **2026-11-07 起(#93/#94)串口同步留痕**:每一次进入判废段,串口出一条 `[ERR][UI_TASK] ui wave head idx=<段号> reject=<1..5> stored=0x%04X calc=0x%04X`—— 原因码 1 头解析 / 2 长度等式 / 3 窗读 / 4 尾读 / **5 数据 CRC 不符**(第 5 类附两组 CRC, - 可与 PC 侧 `test/host/wave_read.py dump` 的 REJECT 行同名同值互证;1~4 类两字段打 `0x0000`)。 + 可与 PC 侧 `test/host/bench/wave/wave_read.py dump` 的 REJECT 行同名同值互证;1~4 类两字段打 `0x0000`)。 坏段轮这些 `[ERR]` 行 = **预期内**,不算停幕(见 §8);恢复原字节后再进该段应零 reject 行、放波正常。 - **开页作废纪律(#93 F1)**:回放页**每次开页**重扫段表(页开着投放的新段要**再开一次页**才见; 空态按 `LR` 即投即见)。页内 `UD/LR` 连按不产生重扫,也不新增 `ui wave scan` 锚点。 diff --git a/docs/测试说明/专项验证/链路延迟测试说明.md b/docs/测试说明/专项验证/链路延迟测试说明.md index 76a7e011..cfb48031 100644 --- a/docs/测试说明/专项验证/链路延迟测试说明.md +++ b/docs/测试说明/专项验证/链路延迟测试说明.md @@ -133,8 +133,8 @@ sequenceDiagram |---|---|---| | `test/board/net_latency_test.h` | 计时/统计/报告 API + Phase 入口声明 | 头文件随工程包含路径,无需注册 | | `test/board/net_latency_test.c` | DWT µs 时基 + 统计 + Phase 12/13/14 用例 | **仅 `MDK-ARM/STM32F407-Demo.uvprojx`**(Test 组;模拟器 CMake 不编 `test/*.c`,与现有测试文件一致) | -| `test/host/latency_peer.py` | PC 端 peer(纯标准库):`--mode net`(M2)/`--mode remo`(M3),`--samples N`,`--json out.json` | 无(Python) | -| `test/host/ftp_regression.py` | D20 复现/回归:单会话 7 次数据连接 + 1KB/32KB 往返内容校验,退出码 = 是否全通过 | 无(Python) | +| `test/host/bench/net/latency_peer.py` | PC 端 peer(纯标准库):`--mode net`(M2)/`--mode remo`(M3),`--samples N`,`--json out.json` | 无(Python) | +| `test/host/bench/ftp/ftp_regression.py` | D20 复现/回归:单会话 7 次数据连接 + 1KB/32KB 往返内容校验,退出码 = 是否全通过 | 无(Python) | | 本文档 | 分段/架构/流程/基线/缺陷现状 | — | ### 4.2 阶段编号与构建配置(沿用 `ch395f_test.h` 互斥体系) @@ -259,7 +259,7 @@ DTU-RemoteLCD 客户端;输出每帧 `req2first / total / recv 批次到达时 & '.venv\Scripts\python.exe' .dsh\skills\keil-build\scripts\keil_build.py # 必须 0 错 0 警 # 1) 先 clear 再起 peer(顺序不可反:wait-idle 需要看到会话活跃期) & '.venv\Scripts\python.exe' .dsh\skills\serial-assistant\scripts\serial_tool.py clear -& '.venv\Scripts\python.exe' test\host\latency_peer.py --host 192.168.31.100 --port 8080 ` +& '.venv\Scripts\python.exe' test\host\bench\net\latency_peer.py --host 192.168.31.100 --port 8080 ` --json "docs\测试说明\测试数据\m2_data\m2_quiet.json" --wait 170 # 后台作业 # 2) 烧录(Reset&Run 不可省) & '.venv\Scripts\python.exe' .dsh\skills\stlink-flash\scripts\stlink_flash.py flash @@ -285,20 +285,20 @@ DTU-RemoteLCD 客户端;输出每帧 `req2first / total / recv 批次到达时 & '.venv\Scripts\python.exe' .dsh\skills\keil-build\scripts\keil_build.py # 0 错 0 警(Phase 14 构建) & '.venv\Scripts\python.exe' .dsh\skills\serial-assistant\scripts\serial_tool.py clear & '.venv\Scripts\python.exe' .dsh\skills\stlink-flash\scripts\stlink_flash.py flash # 先烧录,再起 peer(顺序不可反!) -& '.venv\Scripts\python.exe' test\host\latency_peer.py --mode remo --host 192.168.31.100 --port 7003 ` +& '.venv\Scripts\python.exe' test\host\bench\net\latency_peer.py --mode remo --host 192.168.31.100 --port 7003 ` --samples 45 --stress-from 15 --ftp-stress --json "docs\测试说明\测试数据\m3_data\m3_dev_stress.json" # 模拟器基线(Δ 的对照端) & "simulator\build_sim.bat"; .\simulator\build\Debug\lvgl_sim.exe # 等 7003 就绪 -& '.venv\Scripts\python.exe' test\host\latency_peer.py --mode remo --host 127.0.0.1 --port 7003 ` +& '.venv\Scripts\python.exe' test\host\bench\net\latency_peer.py --mode remo --host 127.0.0.1 --port 7003 ` --samples 50 --json "docs\测试说明\测试数据\m3_data\m3_sim_quiet.json" # 尾批定性/解法(都不需要抓包工具) -& '.venv\Scripts\python.exe' test\host\latency_peer.py --mode remo --host 192.168.31.100 --port 7003 ` +& '.venv\Scripts\python.exe' test\host\bench\net\latency_peer.py --mode remo --host 192.168.31.100 --port 7003 ` --samples 30 --ack-probe --json "docs\测试说明\测试数据\m3_data\m3_tail_ackprobe.json" # 带内补 ACK -& '.venv\Scripts\python.exe' test\host\latency_peer.py --mode remo --host 192.168.31.100 --port 7003 ` +& '.venv\Scripts\python.exe' test\host\bench\net\latency_peer.py --mode remo --host 192.168.31.100 --port 7003 ` --samples 30 --ack-fast --json "docs\测试说明\测试数据\m3_data\m3_tail_ackfast.json" # 关延迟 ACK ``` -### 5.4 D20 回归(`test/host/ftp_regression.py`) +### 5.4 D20 回归(`test/host/bench/ftp/ftp_regression.py`) 单会话内 7 次数据连接 + 1KB/32KB 往返内容校验,退出码 = 是否全通过。 **D20 的失败窗口在"每次开机后的第一个 FTP 会话"**(稳态会话恒过)→ 复现/验证必须以 @@ -669,7 +669,7 @@ sock4 auto-relisten ok / relisten retry ok ← 监听器随后自行恢复 | **`relisten` 段 FAIL、断线固定 ~588ms** | **D10** 回归(退回 `osDelay(500)`) | 核对 `net_listener_request`/`net_listener_tick` 非阻塞重试在位(§8 D10) | | **远端显示整帧卡住十几秒后自恢复** | **头阻塞回归** | 核对 挂起 recv 在位:`net_recv_locked` 阻塞分支登记 pending(哨兵 `NET_PENDING_REGISTERED`)+ `net_pending_tick` 在主循环 + 调用方剩余预算循环(lftpd/timeSync)(§8.3 要点 4) | | **INIT 应答帧字节数字段恒为 0** | **D17** 回归 | 核对 `remo_send_init` 发满 8B(§8 D17) | -| **开机首个 FTP 会话第 2 个数据连接 425** | **D20**(已定位未修,§8.2) | 复现:`test/host/ftp_regression.py`(复位开边界);现场规避:客户端重试 425(瞬态 4xx);根治方向:数据 Socket 轮换 | +| **开机首个 FTP 会话第 2 个数据连接 425** | **D20**(已定位未修,§8.2) | 复现:`test/host/bench/ftp/ftp_regression.py`(复位开边界);现场规避:客户端重试 425(瞬态 4xx);根治方向:数据 Socket 轮换 | | **`[LAT]` 多段数值雷同 / 全 0 却 verdict=OK** | **D18/D19**(测试工装) | 核对 `lat_probe_add_seg` 段名过滤 + `lat_time_init` 调用 + `med==0` 判无效 | | **连接建立后 15~30s 无流量即被 RST** | **D13**:芯片空闲超时(芯片行为) | 客户端须容忍并重连(peer `--wait` 重试是正常路径) | | **peer 重连后 MCU 状态滞留、新连接字节被吞** | **D14**:芯片静默回收 Socket | 对账⑤自动认领(手动 `net_resync_listen`/`net_relisten` 已退役,Phase 13 abort 期自愈亦交 net 层) | @@ -706,7 +706,7 @@ sock4 auto-relisten ok / relisten retry ok ← 监听器随后自行恢复 6. 发送块配额与 MSS:48 块按实际使用的 3 个 socket 重新分配(各 16 块),MSS → 1460 (3209B 从 4 段降到 1~2 段);**约束**:单次写长度必须 ≤ 发送缓冲(TRAP-NET-16 铁律), 改分配策略需同步 `net_bind` 重复分配路径,改前先读 `CH395F_Trap_Records.md`,改后跑 Phase 8 吞吐用例; - **另**:MSS/块配额变更**必须**跑可信用例(`test/host/ch395f_socket_test.py tcp_client` 全序列 + 新连接独立 4096B 对照),判据 = **客户端侧内容完全匹配**(勿用带固件内读者的台架配方,其短收是读者吞数据不是故障); + **另**:MSS/块配额变更**必须**跑可信用例(`test/host/bench/net/ch395f_socket_test.py tcp_client` 全序列 + 新连接独立 4096B 对照),判据 = **客户端侧内容完全匹配**(勿用带固件内读者的台架配方,其短收是读者吞数据不是故障); 7. 去掉一次 3200B 拷贝(`g_tx` 直接承接位图,省 ~3.2KB 常驻 RAM;改前跑 `scripts/ram_report.py`); 8. uiTask:`ui_net_sink_poll()` 前置到 `ui_port_step` 前 + while 排空(省按键一整拍); 9. **日志非阻塞化:已实施·形态变更(生产者侧 2026-09-24 单写者;2026-10-25 与日志静默观察项合并评估收口)**: diff --git a/docs/测试说明/单元测试/主机单测覆盖率口径.md b/docs/测试说明/单元测试/主机单测覆盖率口径.md index 2b4a04ae..eeb682ac 100644 --- a/docs/测试说明/单元测试/主机单测覆盖率口径.md +++ b/docs/测试说明/单元测试/主机单测覆盖率口径.md @@ -250,7 +250,7 @@ | **FTP 一套** | `lftpd.c`(694)、`lftpd_io.c`(207)、`lftpd_inet.c`(171)、`lftpd_string.c`(11) = 1,083 | 0.99/0.90/0.93 | 真实 `ff.h` + 假 diskio;复用 `net_socket.h` | `docs/测试说明/板级测试/FTP_Test_Guide.md`、`docs/子系统设计/网络配置说明.md` §3.4(`pwd_hash`=SHA-256(user‖password)、连续 5 次失败锁 60 s、默认口令启动告警) | **20 次提交里 6 次是 fix**,最近两条都是"静默型":LIST/NLST 满块被截断回 550、对端行为误打 `[ERR]`(2026-10-23)——覆盖率最擅长照的就是这类"日志看不出根因" | | **NET 拆出来的四块** | `net_pending.c`(287)、`net_events.c`(263)、`net_listener.c`(191)、`net_select.c`(162) = 903 | 0.90/0.78/–/0.93 | **新建 `stub/ch395f.h`**(芯片寄存器只到函数边界)+ 假任务通知;`net_socket.h` 已有 | `docs/网络/网络自愈架构设计.md` §4.10(socket 读清点审计 + 新增一处读清的三条准入判据)、`docs/网络/Net层阻塞模型架构设计.md` | 挂起 recv、监听按代次重建、退避这些**语义在真机上极难复现**;这一族的 网络自愈("顺手全量清一遍把别的 socket 门焊死")与 N34 E14 都是 fix 出来的真事 | | **配置与工具(最便宜,建议第一个落地)** | `net_cfg.c`(167)、`task_prof.c`(160)、`ftp_cfg.c`(59)、`prot_set_store.c`(43) = 429 | 1.00/0.97/–/– | 真实头即可(`cfg_file.h` 已被现有单测证明能在 PC 上编),最多补 `dbg_log.h` | `docs/子系统设计/网络配置说明.md`(工厂默认 192.168.31.100/24、MAC 全零=芯片内置、保存立即生效)、`docs/算法/采集与算法层设计说明.md` | 硬件符号 0~2 处,纯解析/编解码/格式化。**一天内能出第一份绿**,用来把"新增 `files_tested`"这条路先跑通 | -| **104 服务层** | `iec104_serv.c`(202) | 0.96 | 复用 `time_sync`/stub 的 `cmsis_os2.h` + 已有 `net_socket.h` | 与 `test/host/iec104/`(97 用例)同一套脚手架 | 同族的 `iec104_pts.c` 现在只有 **67.2%**(全仓最低之一);服务层进来才能把 YK/YX 编排的分支照全 | +| **104 服务层** | `iec104_serv.c`(202) | 0.96 | 复用 `time_sync`/stub 的 `cmsis_os2.h` + 已有 `net_socket.h` | 与 `test/host/iec104/`(97 用例)同一套脚手架(该目录已删除 2026-11-18,随旧自研协议层三源退役) | 同族的 `iec104_pts.c` 现在只有 **67.2%**(全仓最低之一);服务层进来才能把 YK/YX 编排的分支照全 | **落地进度(2026-10-23,同日推进)**: @@ -277,7 +277,7 @@ (芯片说还在连接就不许拆活会话)、疑似误报延后、超时标异常释放(正是 `net_pending` 收尾报 CONNRESET 的那条输入,**跨文件因果两头都能离线跑才测得到**)、丢中断自愈, 以及对账器的 100ms 周期闸门 / 稳定计数 4·2·1 三档 / 1000ms 冷却 / U11 重同步 | -| 104 服务层:`iec104_serv.c` | ✅ 完成(**117/139 = 84.2%**) | `test/host/iec104_serv`(28 条) | +| 104 服务层:`iec104_serv.c` | ✅ 完成(**117/139 = 84.2%**) | `test/host/iec104_serv`(28 条;该目录已不存在,2026-11-18 复核时已随旧服务层重写退役) | 服务生命周期:代次一变就重建监听、accept 门控与表项失效自愈、单连接断线只关数据口 (与监听同号时绝不关)、连续短写判死(成功即复位)、32 分频探活、协议掉回 IDLE 丢弃 重生、时钟桥接两个溢出边界(>4G 秒拒绝、未对时回哨兵) | @@ -640,7 +640,7 @@ uint16_t ch395f_link_change_count(void); **后续项(本轮不做)**:① 把「剥注释词法扫描」收进 `scripts/` 当门禁(需用户点头,并先定 `test/` 是否纳入 -`coding-standard` 的口径——该钩子现在 `exclude` 了 `test/`);② `test/host/iec104/` 里「`TC-` 直接接三位序号、不带模块码」这类**简写形态** +`coding-standard` 的口径——该钩子现在 `exclude` 了 `test/`);② `test/host/iec104/`(已删除 2026-11-18)里「`TC-` 直接接三位序号、不带模块码」这类**简写形态** 归族(属编号登记与可追溯性改动,牵 `id_registry.json`,不能顺手做);③ `runner .py` 的中文 docstring **不动** (口径是 `.c/​.h`,且 Python 源不经 ARMCC 代码页,翻它无工程收益)。 @@ -727,7 +727,7 @@ uint16_t ch395f_link_change_count(void); - **本轮覆盖率**(收尾那次全仓跑数,`--update-baseline` 已把数字连同本轮提交一起落盘):`net_udp.c` 237/239 行(99.2%)、函数 **14/14**;`net_socket.c` 966/969(99.7%)、函数 **59/59**;`net_pending.c` 173/199(86.9%);全仓 line 8372/9290(90.1%)、47/47 套绿,无回退。剩两处未覆盖:`net_udp.c` 的槽越界兜底(调用方已挡,属防御性代码)与 `net_socket.c` 错误码槽重查竞态(真并发才走得到,改造前后同为那 2 行)。 - **台架必验(登记于本轮,2026-11-04 已全部跑完,见下一条)**:① 两端真机互通,服务器形态收发 + 客户端形态往返,重点看 48 B 这类小应答**载荷完整**且源地址正确;② `sendto` 切形态后 `net_udp_set_peer(fd, NULL)` 能否真恢复收其它源的包——手册只写 DesIP 语义,没写切换时机;③ 截断包排空后下一个包是否完整(scratch 循环在真芯片读指针上的行为);④ 挂起 recv 等待期间的 IWDG 余量;⑤ bind 在 open **之前**写 DesIP 的顺序在真芯片上的实际效果(TRAP-NET-14 的 UDP 侧对照)。 - **真机回归结果(2026-11-04 08:42,PR #74 分支 head 走到 `b5671e8`(剥头修正)之后)**:板端 `=== Phase 16: 77/77 PASSED (failed=0) ===`、PC peer `=== UDP Bench PC Peer: 27/27 PASSED (failed=0) ===`,①~⑤ **全部成立**,逐条串口原文见 `docs/测试说明/板级测试/CH395F_Test_Guide.md` §12.6 的「实测结果」表。**第一轮(08:16)其实是 33/47**:`TC-NET-1603` 报 `tag 0x02 got 0x38 (n=56)`,把本轮最大的一条设计错误照了出来——**芯片加不加 8 字节信息头是在 OPEN_SOCKET 那一刻由 DesIP 定死的,运行时把 DesIP 改成具体对端并不会让头消失**,而 UDP-4/UDP-24 当时按"客户端形态不剥头"写死了假件脚本,240 轮随机全绿也没发现。修法:`net_udp_datagram_read` 的剥头条件改为**只看 `avail >= 8`、与 `udp_mode` 无关**(`udp_mode` 退化为发送去向 + 对端记账),主机侧 UDP-4 与 UDP-24 客户端轮按真机重写(UDP-4 补一条 `addrlen`/family 断言,改完判据后覆盖率门禁又照出兜底那侧一行没人走,补 UDP-26 残包组 → 全套 **677/677**),板级 1603 的判据文字同步改写;定案登记在 TRAP-NET-22 的 2026-11-04 追加段。产品镜像尺寸 `Code=249120 RO=29836 RW=2052 ZI=149996`(比改造前基线少 4 B,`RW/ZI` 一字未增)。 -- **这 5 条已落成可执行的板级阶段**:阶段 16(`docs/测试说明/板级测试/CH395F_Test_Guide.md` §12.6,板端 `test/board/net_test_task.c` 的 `net_layer_udp_bench_test_main`,PC 侧 `test/host/udp_queue_bench.py`),TC-NET-1601~1609 与 ①~⑤ 的对应关系写在表里。**真机跑了四轮才跑完整**:2026-11-03 夜第一次上台架,① 的上半段已见证据——`TC-NET-1601` 建 socket/bind `:6001`/形态回 SERVER、`TC-NET-1602` 服务端形态收到 20 B 且 `addrlen`/`sin_family`/源端口全对、回显逐字节一致并把形态翻成 CLIENT;②③④⑤ 未测,板子当晚两次失电(SWD `No target connected`、ping 不通,19:19 与 21:0x 各一次),两趟还各暴露一个**台架**缺陷(peer 被 Windows 的 ICMP 10054 打死;单步预算 8 s < 板端 25 s park 导致整条梯子错位,另有一版 peer 在失败后瞬间狂重发,单个日志刷到 940,949 B),修法与守卫见上面那份指南。2026-11-04 08:16 第一次跑完整梯子是 **33/47**,唯一的真缺陷就是上面那条剥头判据,14 条 FAIL 全是它的级联;修完 08:42 第二轮 **77/77**,跑完立刻把板子恢复成产品镜像(`Code=249120`,串口 `[PROF2]` 心跳连续、`netn=0`、`[ERR][WD] task stall` 零条)并释放台架锁。 +- **这 5 条已落成可执行的板级阶段**:阶段 16(`docs/测试说明/板级测试/CH395F_Test_Guide.md` §12.6,板端 `test/board/net_test_task.c` 的 `net_layer_udp_bench_test_main`,PC 侧 `test/host/bench/net/udp_queue_bench.py`),TC-NET-1601~1609 与 ①~⑤ 的对应关系写在表里。**真机跑了四轮才跑完整**:2026-11-03 夜第一次上台架,① 的上半段已见证据——`TC-NET-1601` 建 socket/bind `:6001`/形态回 SERVER、`TC-NET-1602` 服务端形态收到 20 B 且 `addrlen`/`sin_family`/源端口全对、回显逐字节一致并把形态翻成 CLIENT;②③④⑤ 未测,板子当晚两次失电(SWD `No target connected`、ping 不通,19:19 与 21:0x 各一次),两趟还各暴露一个**台架**缺陷(peer 被 Windows 的 ICMP 10054 打死;单步预算 8 s < 板端 25 s park 导致整条梯子错位,另有一版 peer 在失败后瞬间狂重发,单个日志刷到 940,949 B),修法与守卫见上面那份指南。2026-11-04 08:16 第一次跑完整梯子是 **33/47**,唯一的真缺陷就是上面那条剥头判据,14 条 FAIL 全是它的级联;修完 08:42 第二轮 **77/77**,跑完立刻把板子恢复成产品镜像(`Code=249120`,串口 `[PROF2]` 心跳连续、`netn=0`、`[ERR][WD] task stall` 零条)并释放台架锁。 - **同一轮补的免对端那半(2026-11-04)**:第一次上台架就是被"没有对端"卡住的——peer 脚本被 Windows 的 ICMP 10054 打死、梯子错位,1601 之后一步都测不到,整趟证据归零。故阶段 16 加了 **TC-NET-1610**:17 条断言不需要 PC 发一个包,把「形态记账(新建 socket 与 bind 都读 SERVER、`sendto` 显式对端才切 CLIENT)」「参数与出参守卫(未 bind 报 -5、流式 API 读 `DGRAM` 报 -3、`to_ms == 0` 报 -3、`src_addr` 缺 `addrlen` 或容量只有 4 字节报 -3、空缓冲 `DONTWAIT` 报 -7)」「`net_recvfrom_to(2000)` 返回 **-2** 且实测睡眠落在 2~4.5 s(等待睡在任务通知上,不在 SPI 总线上自旋)」「`net_close` 后同一槽重新 bind 不被上一条命毒化」四类在真芯片上一次确认。执行位置在 1601 之前、编号留在段尾(编号是台账用的,不等于执行顺序)。代价只有 flash:Code +2,380 B、RO +3,108 B(全是断言字符串),`RW/ZI` 一字未增——它复用那块 1,600 B 收发缓冲。**ARMCC 已编过(bench 与产品两态都 0 error 0 warning),并在 2026-11-04 08:42 那轮真机上 17 条全绿**(`TC-NET-1610a..q`,含 `1610i: park slept 2002ms against a 2000ms budget` 这条"睡在通知上"的硬证据)——它也正是那一轮板子断线时唯一还能自证的段落,先跑完再等对端的设计目的达到了。 - 本轮改动面:`Drivers/BSP/NET/net_udp.c` 与 `Drivers/BSP/NET/net_udp.h`(新)、`net_socket.c` / `net_socket.h`、`net_pending.c` / `net_pending.h`、`net_types.h`、`MDK-ARM/STM32F407-Demo.uvprojx`、`scripts/check_registration.py`、`test/host/common/ch395f_fake.c` 与 `test/host/common/ch395f_fake.h`、`test/host/net_socket/`(含新分片);文档 → `docs/网络/BSD_Socket_API_使用指南.md` §6.0 / §6.1 / §6.2 / §6.3 / §9.0、`docs/网络/BSD_Socket_API_函数调用关系.md` §4.11、`docs/问题记录/CH395F_Trap_Records.md`(TRAP-NET-14 UDP 段 + 新条)。 diff --git a/docs/测试说明/板级测试/CH395F_Test_Guide.md b/docs/测试说明/板级测试/CH395F_Test_Guide.md index d3bbd9f5..9784fa6e 100644 --- a/docs/测试说明/板级测试/CH395F_Test_Guide.md +++ b/docs/测试说明/板级测试/CH395F_Test_Guide.md @@ -155,7 +155,7 @@ MCU: STM32F407ZGTx @ 168MHz, Keil MDK-ARM v5 (ARMCC) | **优先级** | P0 | | **类型** | 功能测试(硬件层) | | **标题** | ch395f TCP Client → PC TCP Server,64 字节收发 | -| **前置条件** | PC: `python test/host/ch395f_socket_test.py tcp_server --port 8081`(PC 作 TCP 回显服务器,收到数据原样回显) | +| **前置条件** | PC: `python test/host/bench/net/ch395f_socket_test.py tcp_server --port 8081`(PC 作 TCP 回显服务器,收到数据原样回显) | **测试步骤与判定标准**: @@ -235,7 +235,7 @@ MCU: STM32F407ZGTx @ 168MHz, Keil MDK-ARM v5 (ARMCC) | **优先级** | P1 | | **类型** | 机理对照(硬件层,2026-10-11 新增) | | **标题** | `close` / `disconnect→close` / `disconnect` 三种关闭次序的芯片行为 | -| **前置条件** | 1. PC: `python test/host/ch395f_socket_test.py tcp_server --port 8081 --timeout 900`(⚠ 默认 `--timeout 180` 且连接间隔 >60 s 会自行退出,长轮次须放大)
2. TC-NET-201 通过;`FUN_PARA=0x08`(`net_stack_bring_up` 与生产同构) | +| **前置条件** | 1. PC: `python test/host/bench/net/ch395f_socket_test.py tcp_server --port 8081 --timeout 900`(⚠ 默认 `--timeout 180` 且连接间隔 >60 s 会自行退出,长轮次须放大)
2. TC-NET-201 通过;`FUN_PARA=0x08`(`net_stack_bring_up` 与生产同构) | | **规模** | 3 模式 × 5 轮,每轮 3 项判定(会话 / 关闭次序 / 重开会话),共 45 项 | **测试步骤与判定标准**(每轮:`open`→`connect`→64 B 回显比对 → 按模式执行关闭次序 → 重开重连回显): @@ -277,7 +277,7 @@ MCU: STM32F407ZGTx @ 168MHz, Keil MDK-ARM v5 (ARMCC) | **优先级** | P0 | | **类型** | 功能测试(硬件层) | | **标题** | 30 轮 64B UDP 数据报回显 | -| **前置条件** | PC: `python test/host/ch395f_socket_test.py udp_client --ip 192.168.31.100 --port 60000` | +| **前置条件** | PC: `python test/host/bench/net/ch395f_socket_test.py udp_client --ip 192.168.31.100 --port 60000` | > **会话结构**(固件单会话,与 udp_client 脚本约定):累计 **60 个有效数据包**后关闭 Socket——第 1~30 轮对应本用例(PC 发 64B),第 31~60 轮对应 TC-NET-302(变长);脚本 `"HELLO"` 就绪探针只回显、**不计数**,不占用用例预算。 @@ -364,7 +364,7 @@ CH395F PC (dhcp_server) | **优先级** | P0 | | **类型** | 功能测试(硬件层) | | **标题** | DISCOVER → OFFER → REQUEST → ACK 全流程获取 IP | -| **前置条件** | 管理员 PowerShell: `python test/host/ch395f_socket_test.py dhcp_server --ip 192.168.31.77 --dhcp-iface 192.168.31.2`(`--ip` 建议 ≠ 静态 IP,以证明确为动态获取) | +| **前置条件** | 管理员 PowerShell: `python test/host/bench/net/ch395f_socket_test.py dhcp_server --ip 192.168.31.77 --dhcp-iface 192.168.31.2`(`--ip` 建议 ≠ 静态 IP,以证明确为动态获取) | **测试步骤与判定标准**: @@ -486,7 +486,7 @@ MCU (TCP Client, ch395f_* 裸命令) PC (tcp_bulk --port 8081) | **优先级** | P0 | | **类型** | 功能测试(硬件层) | | **标题** | 先连续发送 256KB(PC 只收),再连续接收 256KB(PC 回放),逐字节校验 + 总账一致 | -| **前置条件** | PC: `python test/host/ch395f_socket_test.py tcp_bulk --port 8081 --bulk 262144 --chunk 4096`(先启动等待连接) | +| **前置条件** | PC: `python test/host/bench/net/ch395f_socket_test.py tcp_bulk --port 8081 --bulk 262144 --chunk 4096`(先启动等待连接) | **测试步骤与判定标准**: @@ -671,7 +671,7 @@ sequenceDiagram **覆盖原则**:DMA 边界安全(2KB 接收缓冲边界 + 单次 DMA 上限) | > **2026-09-23 结案**:TC-NET-604 的"缓冲满回显"路径**判定为非缺陷**——真实生产路径(产品固件 + 真 lftpd FTP 上传,判据 = FTP 协议结果 + **上传后 RETR 回读 SHA-256**)实测 **227 轮全过**(8KB~1MB,含零间隔快速重连与 100 轮浸泡),并发生产 UI 流(`:7003`)600 帧 CRC 全过;原台架"停摆"系**测试程序自吞数据 + 判读工具误判**(详见 `CH395F_Trap_Records.md`「台架纪律」节)。 -> - **本用例判据(不变)**:PC 发 4096B → 固件分次取空并回显 → **PC 侧内容完全匹配**即 PASS;上传/中止类真实缺陷见 **TRAP-NET-18**(回归工具 `test/host/ftp_abort_probe.py`)。 +> - **本用例判据(不变)**:PC 发 4096B → 固件分次取空并回显 → **PC 侧内容完全匹配**即 PASS;上传/中止类真实缺陷见 **TRAP-NET-18**(回归工具 `test/host/bench/ftp/ftp_abort_probe.py`)。 > - **台架纪律**:判读一律用 `MDK-ARM/bench_verdict.py`(脚本层 STEP 行为真值,并扣除固件读者吞噬的字节);`probe_classify.py` 的 A/C 判定**不可信**;**禁止**把"固件内非回显读者"(Phase 9/11、固件探针)与固定期望值混用在同一配方里。 > - **Phase 6-only 构建禁止无间隔连跑**:<~1s 重连间隔会触发 TRAP-NET-17 失同步(自 run2 起:无 standalone accept、`send -1`、其后全部 connection refused)——快速重连场景须留 ≥15s 间隔;带 Phase 9/11 的构建会被其读者吞数据,不能当对照。 @@ -789,7 +789,7 @@ sequenceDiagram | **优先级** | P0 | | **类型** | 功能测试(NET 层) | | **标题** | net_socket TCP Client → PC TCP Server,64 字节收发 | -| **前置条件** | 1. PC: `python ./test/host/ch395f_socket_test.py tcp_server --port 8081`(TCP 回显服务器)
2. `net_init()` 已完成、SYS_EVT_NET_READY 已广播(netTask 周期 `net_poll()` 运行中)
3. `ENABLE_PHASE7_TESTS` 已定义,入口为 `net_layer_client_test_main()`(见「构建模式与执行顺序」)
4. 建议:硬件层固件中 TC-NET-201/202/203 已通过(跨构建前置,见「构建模式与执行顺序」) | +| **前置条件** | 1. PC: `python test/host/bench/net/ch395f_socket_test.py tcp_server --port 8081`(TCP 回显服务器)
2. `net_init()` 已完成、SYS_EVT_NET_READY 已广播(netTask 周期 `net_poll()` 运行中)
3. `ENABLE_PHASE7_TESTS` 已定义,入口为 `net_layer_client_test_main()`(见「构建模式与执行顺序」)
4. 建议:硬件层固件中 TC-NET-201/202/203 已通过(跨构建前置,见「构建模式与执行顺序」) | **测试步骤与判定标准**: @@ -861,7 +861,7 @@ sequenceDiagram | **优先级** | P0 | | **类型** | 功能测试 / 并发测试(NET 层) | | **标题** | 同时打开 5 个 Socket 连接 PC Server,各自 64B 收发 | -| **前置条件** | 1. PC: `python ./test/host/ch395f_socket_test.py tcp_server --port 8081 --max-conn 5`(并发回显,`--max-conn` 为并发计数)
2. `net_init()` 已置 `FUN_PARA=0x08`,Socket 缓冲按「CH395F 缓冲架构」分配(每 Socket 接收 2KB + 发送 1KB,MSS=1024)——**缓冲显式分配是本用例的前提**(Socket 可用性不依赖 FUN_PARA)
3. `ENABLE_PHASE7_TESTS` 已定义
4. `PHASE7_MULTI_COUNT=5`(并发上限 = `NET_MAX_SOCKETS`(8) − 3 常驻监听;2026-10-15 由 8 降至此) | +| **前置条件** | 1. PC: `python test/host/bench/net/ch395f_socket_test.py tcp_server --port 8081 --max-conn 5`(并发回显,`--max-conn` 为并发计数)
2. `net_init()` 已置 `FUN_PARA=0x08`,Socket 缓冲按「CH395F 缓冲架构」分配(每 Socket 接收 2KB + 发送 1KB,MSS=1024)——**缓冲显式分配是本用例的前提**(Socket 可用性不依赖 FUN_PARA)
3. `ENABLE_PHASE7_TESTS` 已定义
4. `PHASE7_MULTI_COUNT=5`(并发上限 = `NET_MAX_SOCKETS`(8) − 3 常驻监听;2026-10-15 由 8 降至此) | **测试步骤与判定标准**: @@ -889,7 +889,7 @@ sequenceDiagram | **耗时** | 取决于文件大小与速率(100KB 约数秒) | | **入口** | `ENABLE_PHASE8_TESTS` | | **配置** | `PHASE8_FILE_SIZE`(默认 102400 = 100KB);`PHASE8_DIRECTION`(SEND / RECV / ECHO,默认 ECHO) | -| **PC 配合** | `python ./test/host/ch395f_socket_test.py tcp_file --ip 192.168.31.100 --port 8080 --op recv --file rx_100k.bin --size 102400`(文件发送)
`... --op send --file tx_100k.bin --size 102400`(文件接收) | +| **PC 配合** | `python test/host/bench/net/ch395f_socket_test.py tcp_file --ip 192.168.31.100 --port 8080 --op recv --file rx_100k.bin --size 102400`(文件发送)
`... --op send --file tx_100k.bin --size 102400`(文件接收) | > 架构:MCU 为 TCP Server(`net_test_task` 监听 8080,`net_accept` 后 `phase8_run(acc)`);PC 用 `tcp_file` 子命令作 Client 连接 MCU:8080。一次 `phase8_run` 对应一次 PC 连接。 @@ -912,7 +912,7 @@ sequenceDiagram | **优先级** | P0 | | **类型** | 功能测试(文件发送) | | **标题** | MCU 流式发送 100KB 至 PC 并落盘校验 | -| **前置条件** | 1. PC: `python ./test/host/ch395f_socket_test.py tcp_file --ip 192.168.31.100 --port 8080 --op recv --file rx_100k.bin --size 102400`(先连接等待数据)
2. `ENABLE_PHASE8_TESTS`,`PHASE8_FILE_SIZE=102400`,`PHASE8_DIRECTION=SEND`
3. `net_init` 完成,MSS=1024 | +| **前置条件** | 1. PC: `python test/host/bench/net/ch395f_socket_test.py tcp_file --ip 192.168.31.100 --port 8080 --op recv --file rx_100k.bin --size 102400`(先连接等待数据)
2. `ENABLE_PHASE8_TESTS`,`PHASE8_FILE_SIZE=102400`,`PHASE8_DIRECTION=SEND`
3. `net_init` 完成,MSS=1024 | | **测试步骤** | 1. MCU `net_accept` 建链(PC 已连接)
2. 循环填充一个滑动窗口(≤ s_tx_buf)并调用 `net_send`;`net_send` 内部按硬件发送 FIFO(`NET_SEND_CHUNK_MAX`=1KB,见 TRAP-NET-16)自动拆分写入,直至 100KB 发完
3. PC 接收全部字节写入 `rx_100k.bin`,按递增模式或预置 CRC32 校验 | | **通过标准** | PC 收满 102400B 且逐字节/CRC32 校验一致,MCU 无发送错误 | | **覆盖原则** | DMA 边界安全(分块发送、DMA 边界)、缓冲架构(1KB 发送缓冲) | @@ -926,7 +926,7 @@ sequenceDiagram | **优先级** | P0 | | **类型** | 功能测试(文件接收) | | **标题** | PC 流式发送 100KB 文件,MCU 接收并校验 | -| **前置条件** | 1. PC: `python ./test/host/ch395f_socket_test.py tcp_file --ip 192.168.31.100 --port 8080 --op send --file tx_100k.bin --size 102400`(先连接并发送;无文件则生成 100KB 递增模式)
2. 同 TC-NET-801(`PHASE8_DIRECTION=RECV`) | +| **前置条件** | 1. PC: `python test/host/bench/net/ch395f_socket_test.py tcp_file --ip 192.168.31.100 --port 8080 --op send --file tx_100k.bin --size 102400`(先连接并发送;无文件则生成 100KB 递增模式)
2. 同 TC-NET-801(`PHASE8_DIRECTION=RECV`) | | **测试步骤** | 1. MCU `net_accept` 建链(PC 已连接)
2. 循环 `net_recv`(≤2KB/次,保守一次读空)→ 按 offset 字节校验 + 累计 CRC32,直至收满 100KB
3. PC 在文件末尾附 4 字节 CRC32(小端);MCU 收齐后比对 CRC32 | | **通过标准** | MCU 收满 102400B,字节校验全过且 CRC32 匹配,无溢出/截断 | | **覆盖原则** | DMA 边界安全(接收缓冲 2KB 一次读空) | @@ -940,7 +940,7 @@ sequenceDiagram | **优先级** | P1 | | **类型** | 恢复/压力测试 | | **标题** | MCU 发 100KB 经 PC 回显原样返回,MCU 收齐校验 | -| **前置条件** | MCU: `PHASE8_DIRECTION=ECHO`(net_accept 监听 8080);PC: `python ./test/host/ch395f_socket_test.py tcp_file --ip 192.168.31.100 --port 8080 --op echo`(PC 作 Client 连 MCU 并原样回显) | +| **前置条件** | MCU: `PHASE8_DIRECTION=ECHO`(net_accept 监听 8080);PC: `python test/host/bench/net/ch395f_socket_test.py tcp_file --ip 192.168.31.100 --port 8080 --op echo`(PC 作 Client 连 MCU 并原样回显) | | **测试步骤** | MCU 发 100KB → PC 回显 → MCU 收 100KB 字节校验 | | **通过标准** | 100KB 全过,验证 100KB 经回显链路完整 | | **覆盖原则** | 单连接 socket、DMA 边界安全 | @@ -1139,7 +1139,7 @@ WAIT_CLOSE 阶段已内置二段补发(只补一次),生产 net 层则靠 **必须板端先听**:PC 侧是 DHCP(本轮实测 192.168.31.161),`net_test_task.h` 里那个 `TEST_PC_PEER_IP` 192.168.31.2 并不在本机上,让板端当客户端就连不上;板端当服务端则从不断言 "对端是谁"才收,对端从实测包文学来,PC 换 IP 也不用改固件。PC 侧跑 -`test/host/udp_queue_bench.py` 逐步激励,用**三个不同源端口的 socket** 分批发("切形态之后还能不能收别人的包" +`test/host/bench/net/udp_queue_bench.py` 逐步激励,用**三个不同源端口的 socket** 分批发("切形态之后还能不能收别人的包" 那一步必须有区分度才有意义)。 | 用例 | 内容 | 通过标准 | 必验 | @@ -1191,12 +1191,12 @@ open 起来,形态记账(SERVER/CLIENT)、参数与出参守卫、"阻塞 **运行方法**: -1. 先在 PC 上自检 peer 脚本(不用板子):`python test/host/udp_queue_bench_loopback.py`,绿了再往下走。 +1. 先在 PC 上自检 peer 脚本(不用板子):`python test/host/bench/net/udp_queue_bench_loopback.py`,绿了再往下走。 2. `test/board/test_config.h` 开 `TEST_SUITE_CH395F`;`test/board/ch395f_test.h` **只**开 `ENABLE_PHASE16_TESTS`,并把默认的 `ENABLE_PHASE11_TESTS` / `ENABLE_PHASE14_TESTS` 注掉—— 它们会带进 `TEST_LATENCY_PROBE`,污染要证的 UDP 面。 3. `/keil-build` 后烧录(`.dsh/skills/stlink-flash/scripts/stlink_flash.py flash`,`-Rst -Run` 必带)。 -4. PC 先起 peer:`python test/host/udp_queue_bench.py --board 192.168.31.100`,再给板子上电/复位; +4. PC 先起 peer:`python test/host/bench/net/udp_queue_bench.py --board 192.168.31.100`,再给板子上电/复位; peer 首步每 4 s 重发,能盖住板子启动那段时间。 5. 判据是**两侧都绿**:板端串口 `=== Phase 16: N/N PASSED (failed=0) ===`,PC 端 `=== UDP Bench PC Peer: N/N PASSED (failed=0) ===`。PC 绿板红 = 板端断言没对上激励; @@ -1211,7 +1211,7 @@ open 起来,形态记账(SERVER/CLIENT)、参数与出参守卫、"阻塞 调用者)。peer 把它当**观测量**而不是错误:TC-NET-1609 的 1025 / 1472 两条要求「所有片拼回来与发出的 载荷逐字节一致」,并打印实测分片形状;只有拼接后长度或内容不对才判 [FAIL]。 产品侧结论:**UDP 单包保持在 1024 B 以内**(#57 的 SNTP 是 48 B,碰不到这条)。 -- peer 脚本自己有 PC 侧回路自检,不用板子:`python test/host/udp_queue_bench_loopback.py`——它在 +- peer 脚本自己有 PC 侧回路自检,不用板子:`python test/host/bench/net/udp_queue_bench_loopback.py`——它在 127.0.0.1 上放一个按上面三条规矩说话的假板子(同样剥 tag 0x04 到 64 B、同样 1024 拆片),把步骤表、 模式函数、分片预期先验一遍。2026-11-03 首跑 `27/27 PASSED`(实测拆片形状 `[1024, 1]` / `[1024, 448]`)。 它只证明**对端脚本**可用,不证明板端行为——真机那一趟仍然一条都不能省。 @@ -1238,7 +1238,7 @@ open 起来,形态记账(SERVER/CLIENT)、参数与出参守卫、"阻塞 下一次 `recvfrom` 才抛出来;本机 CPython 3.14.7 既没有 `socket.SIO_UDP_CONNRESET` 也不接受它的 数值,所以主力防线改成把 10054 当「这一轮没收到」继续重试(`udp_queue_bench.py` 的 `new_peer_socket` / `_recv_after` / `_recv_maybe`),并由 - `test/host/udp_queue_bench_loopback.py` 的冷端口探针守着(用脚本真正在用的那条路判定, + `test/host/bench/net/udp_queue_bench_loopback.py` 的冷端口探针守着(用脚本真正在用的那条路判定, 同时拿裸套接句证明这台机器确实会回 ICMP,否则探针没有牙)。 2. **一步超时→整条梯子错位**:板端每步等 25 s,peer 每步只等 8 s,于是 1602 之后每一步都踩在板子 的上一步预算里,日志看起来像"全灭"。现在两侧各自加固:peer 每步都重发且单步预算 `--step-budget` @@ -1258,8 +1258,8 @@ open 起来,形态记账(SERVER/CLIENT)、参数与出参守卫、"阻塞 | `tcp_file --ip ... --port 8080 --size 20480` | PC 作文件接收 | 测试大文件传输(阶段 7) | | `udp_client --ip ... --port 60000` | PC 作 UDP Client | 测试 UDP Echo(阶段 3) | | `udp_server --port 8082` | PC 作 UDP Server | 接收 CH395F UDP 数据 | -| `python test/host/udp_queue_bench.py --board <板 IP>` | PC 作 UDP 对端(独立脚本,不在上面那个脚本的模式里) | 阶段 16 BSD UDP 数据面回归:逐步换源端口、切形态、截断、空窗、迟到包(§12.6) | -| `python test/host/udp_queue_bench_loopback.py` | 不用板子的 peer 回路自检(本机假板子) | 上阶段 16 台架前先验 peer 的步骤表与分片预期(§12.6 第 1 步) | +| `python test/host/bench/net/udp_queue_bench.py --board <板 IP>` | PC 作 UDP 对端(独立脚本,不在上面那个脚本的模式里) | 阶段 16 BSD UDP 数据面回归:逐步换源端口、切形态、截断、空窗、迟到包(§12.6) | +| `python test/host/bench/net/udp_queue_bench_loopback.py` | 不用板子的 peer 回路自检(本机假板子) | 上阶段 16 台架前先验 peer 的步骤表与分片预期(§12.6 第 1 步) | | `dhcp_server ...` | DHCP Server | 内置 DHCP(阶段 4,需管理员权限) | ### 通用参数 diff --git a/docs/测试说明/板级测试/FTP_Test_Guide.md b/docs/测试说明/板级测试/FTP_Test_Guide.md index 147dca69..21fd56a5 100644 --- a/docs/测试说明/板级测试/FTP_Test_Guide.md +++ b/docs/测试说明/板级测试/FTP_Test_Guide.md @@ -53,12 +53,12 @@ 所有脚本支持 `--host`(默认 `192.168.31.100`)、`--port`(默认 21)、`--user` / `--password` (默认出厂账号 `admin` / `admin`;设备口令改过就要显式传,**没有匿名通道**),在 `test/` 目录运行;`ftp_up_dl_test.py` / `ftp_speed_test.py` 内置**连接重试**(单客户端:旧会话未释放时自动等待重试,默认 6 次 × 3s)。 -推荐入口:`& '.venv\Scripts\python.exe' test/host/ftp_up_dl_test.py`(功能闭环:登录/TYPE I/PASV/STOR/LIST/RETR/比对/DELE/QUIT)与 `& '.venv\Scripts\python.exe' test/host/ftp_speed_test.py --size 128`(大文件 + 吞吐);后者同时是 **ftpTask 栈水位测量**的负载(见 `docs/内存管理/RAM使用分析与优化方案.md` §4.0.6)。 +推荐入口:`& '.venv\Scripts\python.exe' test/host/bench/ftp/ftp_up_dl_test.py`(功能闭环:登录/TYPE I/PASV/STOR/LIST/RETR/比对/DELE/QUIT)与 `& '.venv\Scripts\python.exe' test/host/bench/ftp/ftp_speed_test.py --size 128`(大文件 + 吞吐);后者同时是 **ftpTask 栈水位测量**的负载(见 `docs/内存管理/RAM使用分析与优化方案.md` §4.0.6)。 ### 4.1 冒烟测试:`ftp_test.py` - 用途:验证连接、登录、`PWD`、`PASV`、`LIST` 基本链路。 -- 命令:`python ./test/host/ftp_test.py --host 192.168.31.100` +- 命令:`python test/host/bench/ftp/ftp_test.py --host 192.168.31.100` - 预期: - 连接成功并读到 `220` 欢迎; - `USER admin` 返回 `331`(需要口令)、`PASS admin` 返回 `230`; @@ -70,7 +70,7 @@ ### 4.2 上传 / 下载 / 比对:`ftp_up_dl_test.py` - 用途:验证 `STOR`/`RETR`/`DELE` 与数据一致性(`TYPE I` 二进制 + `PASV`)。 -- 命令:`python ./test/host/ftp_up_dl_test.py --host 192.168.31.100` +- 命令:`python test/host/bench/ftp/ftp_up_dl_test.py --host 192.168.31.100` - 流程:登录 → `TYPE I` → `STOR up_test.dat` → `LIST` 校验存在 → `RETR up_test.dat` → 逐字节比对 → `DELE` 清理 → `QUIT`。 - 预期:`*** MATCH! Upload/Download success. ***`,且 LIST 中出现 `up_test.dat`。 - 判据:上传/下载字节数相等且内容逐字节一致。 @@ -78,7 +78,7 @@ ### 4.3 速度与大数据量:`ftp_speed_test.py` - 用途:测量上传/下载吞吐,作回归基线,同时验证大文件不丢字节。 -- 命令:`python ./test/host/ftp_speed_test.py --host 192.168.31.100 --size 512`(默认 512KB,`--size` 可调)。 +- 命令:`python test/host/bench/ftp/ftp_speed_test.py --host 192.168.31.100 --size 512`(默认 512KB,`--size` 可调)。 - 预期:上传/下载均返回 `226`,回读 `MATCH!`,打印 KB/s。 - 注意:脚本使用 8.3 文件名 `SPEEDTST.DAT`(**FTP 仅支持 8.3 短文件名**,见 §8.3);以回读比对(MATCH)为最终判据,中间打印的 Sent 字段仅供参考。 - 判据:size 一致 + MATCH + 速度稳定(受 SPI2 分频 8 限制,通常约 300~450 KB/s,参见 `CH395F_Test_Guide.md` 阶段 5 吞吐基线)。 @@ -96,7 +96,7 @@ 24 条目(1512 B),6 个文件凭空消失。修完之后,**目录清空的设备上这颗雷再也暴露不出来**, 所以需要一个自己把目录撑过一块的回归。机理与修复见 `../../问题记录/CH395F_Trap_Records.md` 的 LIST 吞包定案(定案三)增补。 -- 命令:`& '.venv\Scripts\python.exe' test/host/ftp_list_fill_test.py`(`--files 26` 默认) +- 命令:`& '.venv\Scripts\python.exe' test/host/bench/ftp/ftp_list_fill_test.py`(`--files 26` 默认) - 做什么:造 26 个 8.3 短名小文件(`ZZFTnn.TXT`)→ `LIST` → 三条判据 → 逐个 `DELE` 还原 - 判据:① 26 个 STOR 全 226;② LIST 全文里每个名字都在(少一个 = 截断回归);③ LIST 的 **完成回包是 226 而不是 550**(用 ftplib 的 `retrlines`,非 2xx 完成会直接抛异常)。 diff --git a/docs/测试说明/板级测试/实机测试实施指南.md b/docs/测试说明/板级测试/实机测试实施指南.md index 1bb20052..6302d66d 100644 --- a/docs/测试说明/板级测试/实机测试实施指南.md +++ b/docs/测试说明/板级测试/实机测试实施指南.md @@ -137,8 +137,8 @@ $cli = if ($env:DTU_STLINK_CLI) { $env:DTU_STLINK_CLI } else { (Get-Command ST-L # 5) 撤销注入,/keil-build 回产品态,再跑一轮 /serial-boot-test 确认正常 # --- V5(长跑,需真实负载)--- -# 1) 用 test/host/ftp_speed_test.py / ftp_up_dl_test.py 持续传输大文件 -& '.venv\Scripts\python.exe' test/host/ftp_speed_test.py +# 1) 用 test/host/bench/ftp/ftp_speed_test.py / ftp_up_dl_test.py 持续传输大文件 +& '.venv\Scripts\python.exe' test/host/bench/ftp/ftp_speed_test.py # 2) 同时人工/脚本遍历 UI 菜单 + 反复保存配置 + 触发网络重配 # 3) 持续 ≥30 min,全程串口记录 # 判据:零复位(日志无 "reset cause=watchdog reset");业务不中断 diff --git a/docs/测试说明/测试数据/boot_log_data/README.md b/docs/测试说明/测试数据/boot_log_data/README.md index 672600a9..fe0f1eb8 100644 --- a/docs/测试说明/测试数据/boot_log_data/README.md +++ b/docs/测试说明/测试数据/boot_log_data/README.md @@ -65,15 +65,15 @@ git add -f docs/测试说明/测试数据/boot_log_data/20261012_B9_soe_after_po | 2026-10-11 | `prod_adc_health` / 开机 + 30 s 空载(L1-6 + 抬栈 640 words) | `adc` **952/2560(62%)**(静态最坏链 1080 B,`adc_health_report`→`syslog_post` 回显尾);`default` 2152/4096(47%);heap free=14576 **min_ever=6640**(抬栈 -512 B,符合预算) | `20261011_prod_adc_health_boot_log.txt` | | 2026-10-12 | `prod`(HEAD d3107f3,B4/B5 验收窗口 B6)/ 开机 + 30 s 空载 | **首采**:`iec104` 424/2560(83%);`protect` 828/2048(59%,free_min 1220);新 56 KB 堆 heap free=17936 **min_ever=10000**(>3072 告警线,无 `[HEAP]` 告警);⚠ **@test FAIL(缺陷证据快照)**:`protect task start` 锚点行字节级交错损坏(`st[art: cycle=220ms elm=70`,两次开机同形复现)= protectTask 违反控制台写者注册前门控纪律(`控制台单写者日志设计.md` §3.4),其余 8 Required / 零 `[ERR]` / 锚点×1 / 回读一致全过;**缺陷已修**(启动行改 writer-ready 首拍补打),修复后 PASS 见下行 | `20261012_B6_prod_boot_log_PROTECT_MISS.txt` | | 2026-10-12 | `prod`(B7 `1fe163b` + B6 门控修复)/ 开机 + 30 s 空载(**B6 复测 PASS**) | `protect` 828/2048(59%,free_min 1220);`iec104` 424/2560(83%);heap free=17936 **min_ever=10000**(**N-33 抬栈 min_ever 背书就绪**);锚点行完好 `cycle=20ms elm=7`(+577 ms,写者 attach 后首拍);零 `[ERR]`、采样闭锁不误报 | `20261012_B6_prod_boot_log.txt` | -| 2026-10-12 | 同 MISS 固件(d3107f3)/ **PC 主站 2404 往返**(`test/host/iec104_master.py`) | STARTDT/总召四组+actterm/C_SE 两段写触发 YX15·16 变位(COT=3)/恢复复归/YK11 两段正答/C_RD 读回 10.000 → **18/18 PASS**(104 链与锚点缺陷无关,验收窗口固件本身上先行闭环) | `20261012_B6_iec104_roundtrip_pre-fix_log.txt` | +| 2026-10-12 | 同 MISS 固件(d3107f3)/ **PC 主站 2404 往返**(`test/host/bench/iec104/iec104_master.py`) | STARTDT/总召四组+actterm/C_SE 两段写触发 YX15·16 变位(COT=3)/恢复复归/YK11 两段正答/C_RD 读回 10.000 → **18/18 PASS**(104 链与锚点缺陷无关,验收窗口固件本身上先行闭环) | `20261012_B6_iec104_roundtrip_pre-fix_log.txt` | | 2026-10-12 | 同 PASS 固件(B7+fix)/ **PC 主站 2404 往返**(复测) | 同上全链 18/18 PASS——B7 `set_sealed`+持久化写路径下 C_SE→YX 联动仍成立(B5 遗留"104 YX 联动"腿闭环) | `20261012_B6_iec104_roundtrip_log.txt` | -| 2026-10-12 | 同 PASS 固件 / **B7 定值持久化 + 软压板 YK12 台架腿**(`test/host/iec104_master.py --b7-pre/--b7-post/--b7-mark/--b7-check`,中间 ST-LINK 复位) | pre **21/21**:C_SE 写 7.5+C_RD 回读、YK12 两段 OFF → 0.05 A 低定值**不动作**(保护退出)、YK12 ON → YX15/16 立即动作(COT=3)、收尾留压板退出;post **13/13**:**压板退出态跨复位保持**(开机日志 `global plate OUT -> protection disabled` + 低定值仍不动作)、重启后 YK12 ON 即动作(联动在位);mark/check **4/4+4/4**:**非默认定值 7.5 跨复位保持**(C_RD=7.500,与出厂默认可区分);开机日志两次 `[CFG] prot set loaded (/prot_set.bin)` | `20261012_B7_iec104_persist_log.txt` / `20261012_B7_persist_boot_log.txt` | +| 2026-10-12 | 同 PASS 固件 / **B7 定值持久化 + 软压板 YK12 台架腿**(`test/host/bench/iec104/iec104_master.py --b7-pre/--b7-post/--b7-mark/--b7-check`,中间 ST-LINK 复位) | pre **21/21**:C_SE 写 7.5+C_RD 回读、YK12 两段 OFF → 0.05 A 低定值**不动作**(保护退出)、YK12 ON → YX15/16 立即动作(COT=3)、收尾留压板退出;post **13/13**:**压板退出态跨复位保持**(开机日志 `global plate OUT -> protection disabled` + 低定值仍不动作)、重启后 YK12 ON 即动作(联动在位);mark/check **4/4+4/4**:**非默认定值 7.5 跨复位保持**(C_RD=7.500,与出厂默认可区分);开机日志两次 `[CFG] prot set loaded (/prot_set.bin)` | `20261012_B7_iec104_persist_log.txt` / `20261012_B7_persist_boot_log.txt` | | 2026-10-12 | `prod`(B9 `1d96fc9` sync 追平 B8/N33 后重跑,merge `6cbf400` 覆盖代码)/ **B9 SOE 动作记录 + 时标台架腿** | `@test` **PASS**:锚点 `protection init: OK (set=40 elm=9)`、`freq layer init: OK`、`freq(hb): f=0 valid=0`(浮空不发散)、**`prot set blob version change (ver=1 cnt=32), defaults in use`**(B8 换代 INFO ≠ CORRUPT 实证)、零 `[ERR]`、`protect` 828/2048(59%,与静态 872 相符);主站回归 `--b7-pre` **21/21** + `--b7-post` **13/13** 不回归,**自发 YX = M_SP_TB_1 带 CP56 时标**(动作/复归/重启后联动三段,iv=0);FTP 下载 `/log/soe.log` **56 条** `test/host/soe/decode_soe.py --max-elm 16` **PASS**(boot 段内 seq 严格 +1、ELM_ASSERT 26、CP56↔epoch UTC 交叉一致);`.bin` 为原始 64 B 记录可复解码 | `20261012_B9_prod_boot_log.txt` / `20261012_B9_iec104_soe_pre_log.txt` / `20261012_B9_iec104_soe_post_log.txt` / `20261012_B9_soe_pre.bin` + `20261012_B9_soe_after_post.bin` / `20261012_B9_soe_decode_pre.txt` + `20261012_B9_soe_decode_post.txt` | | 2026-10-25 | `prod`(最终主干 `1a624b1`:看门狗 v1.5 按位分账 + F3 推流心跳边界)/ **f3rounds 轮① :7003 relisten_stress 单独 30 min**(11×200=2200 个 connect/close 周期,零拒绝) | **v1.1 判据 PASS**:`task stall`=0;MISS 758 条中 NET 缺席=0(旧 12 条 NET 参与组合消失达成);推流段在途峰值 103 ms / 完成段 183 ms(UI 周期最坏 254 ms)——F2 复合零误报 + F3 阻塞型治愈的定案样本;gz 前置 6 行 ASCII 来源/判据头 | `f3rounds_r1_7003_churn_30min.log.gz` | | 2026-10-25 | 同固件 / **f3rounds 轮② e02_probe 单独 30 min**(50 个探针掉线窗) | **v1.1 判据 FAIL(如实申报,零放水)**:stall=8 = 3 事件(20:06:05/20:16:54/20:20:30,miss=998-1000/1187-1189/1249-1250),mask=0x1E7 纯 UI 单串×7 + 0x167 UI+I104×1,h= 环全部 ≥8 连窗真申报;**饿死型**(每样本点 uisn=0、mg=217/262、拖点不在推流段而在 feed/port 墙钟)=「reconcile 突发饿死 uiTask」登记行与 E-27/E-28 批 3 的直接立项证据;全窗无 IWDG 复位 | `f3rounds_r2_probe_30min.log.gz` | | 2026-10-21 | `prod` + **兜底新鲜度门停 TIM3 注入探针**(`task/adc-health-design-doc`,探针已撤)/ 开机 + 45 s | `protect` **620/2048(69%)**、`adc` 与 heap 水位同前;`[ERR][PROT] … blocked (hf=0x00000100)` +5462ms、`recovered` +5757ms、`health:` 0 次、`reset cause:` ×1 | `20261021_probe_stale_gate_boot_log.txt` | | 2026-10-26 | `prod`(**像来自仓外只读 detached worktree `_wt/bench-21-77779d49` @ 77779d49**;主树当时另有在飞文档改动,这份像**不含**主树未提交内容——别拿本行结论去对主树源码)/ 开机 + 30 s 空载,**@test PASS** | `protect` **492/2048(75%)**、`iec104` 540/2560(78%)、`adc` 1000/2560(60%)、`ui` 4088/16384(75%)、`default` 2160/5120(57%)、heap free=15624 **min_ever=8464**;`protection init: OK (set=40 elm=9)`、锚点 `reset cause:` ×1、**[ERR]=0 / Fault=0**、`net init: OK` **+762 ms**、身份戳 `Oct 26 2026 16:27:01 suite=NONE dstr=off` 从 hex 抠出并与线上相符、`-CmpFile` 回读 No difference found(**排在采日志之后**);⚠ **启动日志行内字节交错缺陷**:protectTask `[PROT]` 与 `[NAND_FTL]` 两个写者并发,3 次启动命中 2 次,hexdump 实证「某行内多出的字节恰等于下一行被吃掉的行首」(串口 framing 错不可能让行变长)→ 已立项派 App/log 属主 | `20261026_prod_77779d49_boot_log.txt` / `20261026_prod_77779d49_boot_log_reset_only.txt` / `20261026_prod_console_interleave_evidence.txt` | -| 2026-10-26 | 同镜像 / **整定页两条实机判据**(主站 `test/host/iec104_master.py` 以库形式复用,驱动脚本留在仓外 `_wt/scratch/bench21_104.py`(原写 `_wt/.state/`,但那是 task-worktree 的**台账目录**,放脚手架会把 `list` 撞崩,已挪出),**未改仓库**;复位只用 `-Rst -Run`,**全程不重烧**) | **C_RD 27/27 可寻址项全中出厂值**(清单取自 `git show 77779d49:App/algo/prot_set.[ch]` 而非工作树;**13 个 comm_addr=0 本地项结构性不可寻址 → 明确不参与本判据**,另以 0x8854/0x8855/0x8862 三个未映射地址实证「不应答」);⚠ **未标定闭锁态下 C_SE 仍允许写**(闭锁 ≠ 禁写):0x8858=7.5 / 0x885D=1234 / 0x8820=11000 三项 sel+exe 均 actcon 且 C_RD 同值 → 仅复位后仍为 7.5/1234/11000,启动日志 `[CFG] prot set loaded (/prot_set.bin)`、CORRUPT=0、version change=0、YX31=OFF(**校验和通过**);越界写 0x8858=500(>100)、0x8821=0.5(<1) 均回 **actcon+PN** 且原值一字未变;还原默认值 → 再复位 → 27/27 回默认(双向持久化,台架留在出厂态)。屏检:整定页(123 修改密码)标题右侧**「未标定」徽标在位**(Glyph 精确命中 x=105/117/129;同页用查看密码进去无徽标 = 设计如此),**LOCK 未见且可证未闭锁**(ENTER 被消费进入数值编辑,而闭锁时 ENTER 一律不消费),全程零提交;强制真 LOCK 需篡改 `/prot_set.bin`,台架禁做 | `20261026_prod_77779d49_iec104_setpoint_leg.txt` / `20261026_prod_77779d49_ui_set_badge_uncal.png`(同名 `.bin` = 原始 3200 B 帧、可 `board_ui_nav.py --classify` 复判,但被 `.gitignore` 的 `*.bin` 全局规则挡住,**入库需 `git add -f`**;顺带一条既存事实:本目录上方 B9 那两行引用的 `20261012_B9_soe*.bin` 同样从未入库,`git ls-files` 查不到)/ `20261026_prod_77779d49_ui_set_view_readonly.png` / `20261026_prod_77779d49_ui_set_edit_enter_accepted.png` / `20261026_prod_77779d49_ui_nav_trace.json` | +| 2026-10-26 | 同镜像 / **整定页两条实机判据**(主站 `test/host/bench/iec104/iec104_master.py` 以库形式复用,驱动脚本留在仓外 `_wt/scratch/bench21_104.py`(原写 `_wt/.state/`,但那是 task-worktree 的**台账目录**,放脚手架会把 `list` 撞崩,已挪出),**未改仓库**;复位只用 `-Rst -Run`,**全程不重烧**) | **C_RD 27/27 可寻址项全中出厂值**(清单取自 `git show 77779d49:App/algo/prot_set.[ch]` 而非工作树;**13 个 comm_addr=0 本地项结构性不可寻址 → 明确不参与本判据**,另以 0x8854/0x8855/0x8862 三个未映射地址实证「不应答」);⚠ **未标定闭锁态下 C_SE 仍允许写**(闭锁 ≠ 禁写):0x8858=7.5 / 0x885D=1234 / 0x8820=11000 三项 sel+exe 均 actcon 且 C_RD 同值 → 仅复位后仍为 7.5/1234/11000,启动日志 `[CFG] prot set loaded (/prot_set.bin)`、CORRUPT=0、version change=0、YX31=OFF(**校验和通过**);越界写 0x8858=500(>100)、0x8821=0.5(<1) 均回 **actcon+PN** 且原值一字未变;还原默认值 → 再复位 → 27/27 回默认(双向持久化,台架留在出厂态)。屏检:整定页(123 修改密码)标题右侧**「未标定」徽标在位**(Glyph 精确命中 x=105/117/129;同页用查看密码进去无徽标 = 设计如此),**LOCK 未见且可证未闭锁**(ENTER 被消费进入数值编辑,而闭锁时 ENTER 一律不消费),全程零提交;强制真 LOCK 需篡改 `/prot_set.bin`,台架禁做 | `20261026_prod_77779d49_iec104_setpoint_leg.txt` / `20261026_prod_77779d49_ui_set_badge_uncal.png`(同名 `.bin` = 原始 3200 B 帧、可 `board_ui_nav.py --classify` 复判,但被 `.gitignore` 的 `*.bin` 全局规则挡住,**入库需 `git add -f`**;顺带一条既存事实:本目录上方 B9 那两行引用的 `20261012_B9_soe*.bin` 同样从未入库,`git ls-files` 查不到)/ `20261026_prod_77779d49_ui_set_view_readonly.png` / `20261026_prod_77779d49_ui_set_edit_enter_accepted.png` / `20261026_prod_77779d49_ui_nav_trace.json` | | 2026-10-26 | `prod`(**像 = `1d4b6a17` 控制台整行独占修复**;仓外只读 detached worktree `_wt/bench-23-1d4b6a17` 出像,主树同 HEAD 但压着 UI 道 task-6 未提交半成品 → **像不含它**)/ **task-23 收口复验:1 次烧录启动 + 连续 4 次「仅复位不重烧」** | **5/5 启动 [ERR]=0、CONSOLE dropped=0**(让路没被计成 [ERR],与设计一致);两条旧受害行**逐字节完整**:`[PROT]` 未标定行恒 91 px、`[NAND_FTL] Initializing…` 恒 56 px 且行首 `[ts]` 齐(旧缺陷正是吃它行首);锚点 `reset cause:` ×1、无 Fault、`comm init: OK (ca=1 port=2404)` 每次都在、`prot set loaded` ×1 且 CORRUPT ×0;heap **free=15624 min_ever=8464 与上一轮逐字节相同**、protect 492/2048 相同;ui 峰值 **4116~4188/16384** —— **同一份像自己就摆 72 B**,故相对上一轮 4088 的 +100 B **不可归因于本修复**(顺带记账:`[STACK]` 峰值有 ±100 B 噪声,拿它当门禁得先定容差);行序一处变化:`[NAND_FTL]` 现排在 `[PROT]` 前一行 = 抢不到独占者整行入环延后发,与修法吻合;**反证非空跑**:同一校验器打旧缺陷那份 → rc=1 FAIL、`nand_head_ok=false`(那行真读作 `26-10-26 …`);`-CmpFile` 排在全批日志之后、No difference found | `20261026_bench23_flash_boot_log.txt` / `20261026_bench23_reset_only_boots_r1_r4.txt`(4 次仅复位原始字节,按 gen 264~267 分块)/ `20261026_bench23_recheck_verdicts.txt`(逐启动判据 + 反证 + 栈口径 + 最终回读) | | 2026-10-27 | `prod`(**身份戳为准、SHA 只当坐标**:`fw build: Oct 26 2026 22:52:09 suite=NONE dstr=off`;坐标 HEAD `b24b2b5f`;像 = 主树现成 `MDK-ARM/STM32F407-Demo/STM32F407-Demo.hex`,出像前机械核验「`b623a406` 之后无任何提交碰过 `*.c/*.h`、工作树 `*.c/.h` 全干净、唯一比 .hex 新的源文件是 `test/host/console_log/console_log_test.c`(主机侧单测,不在 uvprojx)」→ **无需重建**,UI 道三页与维护链已含在像内)/ **task-42 台架窗口:UI 落地后同判据复跑 + 执行类页面真机硬闸** | **烧录启动 1 次(00:25,不计入仅复位序列)**:`@test` **PASS**,9 条 required 全中(含身份戳)、Forbidden 零命中、锚点 `reset cause:` ×1、boot→`net init: OK` **777 ms**、回读 **No difference found**。**仅复位 4 次(01:46–01:52,逐圈 clear 使 serial gen 273→276 单调递增自证窗口不重叠;`stlink_flash.py reset` = `-c SWD -Rst -Run`,零重烧)**:4/4 **PASS** —— `[ERR]` / `CONSOLE dropped` / 任一 Fault 令牌 / `ERROR` / `assert` **全部零命中**;两条旧受害行**逐字节完整**:`[PROT] … protection blocked (UA/UN/IA VALID not all set)` 恒 **91 px**、`[NAND_FTL] Initializing NAND FTL` 恒 **56 px**(行首 `[` 齐全、`loose_neighbours=0`、`head_bad=0`),锚定用**仓内** `verify_log.py --exact`(`b1280e3c` 并入的能力,本轮首次自用);`[APP] comm init: OK (ca=1 port=2404)` 恒 **57 px**;`prot set loaded (/prot_set.bin)` ×4、CORRUPT ×0;boot→net init 733–786 ms。**反证非空跑**:同一把尺指向修复前归档 `20261026_prod_77779d49_boot_log_reset_only.txt` → **rc=1 FAIL**、缺行首邻居原样打回 `26-10-26 08:37:07][NAND_FTL] …`。**执行类页面硬闸真机实证**:`board_ui_nav --to clear / --to reset` **在下钻前即拒绝**(连轨迹文件都没生成、非零退出),理由文本点名「第二次 ENTER 即真执行」——正是 00:17 我报的那条三段叠险的收口;`--to clock` 正常到达(9 步,每次 ENTER 都落在菜单上下文),页面渲染无缺字白框(`年/月/日/时/分/秒` + `第 1 页,共 1 页` 全显),帧见 PNG。**栈/堆**:heap `free=15624 min_ever=8464` 与 task-30 **逐字节相同**,`protect 492/2048`、`ui 4188/16384` 四轮内部零摆动(本轮 max=4188,与上轮 max 4188 持平 → 无回退);仍按 task-32 未定稿口径**只报数不做单次比较**。**收尾**:`-CmpFile` 排在全部日志采集**之后**(它复位目标),`No difference found`;bench 锁 `task-42` 释放并复验 build/bench 双空闲。**两次如实申报**:① 01:34 头一圈采到 0 字节——根因**不是板子**,是常驻 daemon(pid 18020,uptime 156589 s)已死,而 `serial_tool.py status` 会**自动拉起新 daemon**、于是 status 一直"正常"地报 `port.ready=false / rx_lines=0 / 日志 58 B`;事后证明板子那次复位后正常启动(uptime 计数对得上、PROF 成流)→ 立口径:**每圈复位前 `open` + 断言 ready + 观察 rx_lines 增长,别假设 @test 留下的端口状态能过夜**;② 我加的 Forbidden 令牌 `Fault` 是**假红**:它子串命中 `de*fault*`(打到 `[FTP] using factory default password` 与 `[STACK] default peak_used`),已换成显式故障令牌——四个 Fault 本来都以 `[ERR]` 开头,裸 `Fault` 只是噪声。**另记一条观察(不下结论、不属本卡职责)**:装置墙钟显示 `2026-10-26 18:00:35`,而主机记录为 `2026-10-27 01:5x +08:00`(固件日志时标与 daemon 时标也恒差 8 h)→ 时区/RTC 语义请 lead 定道处理 | `20261027_bench42_reset_only_boots_r1_r4.txt`、`20261027_bench42_verdicts.txt`、`20261027_bench42_ui_clock_page.png` | diff --git a/docs/测试说明/测试数据/m2_data/README.md b/docs/测试说明/测试数据/m2_data/README.md index 2040cbfc..7283f261 100644 --- a/docs/测试说明/测试数据/m2_data/README.md +++ b/docs/测试说明/测试数据/m2_data/README.md @@ -11,7 +11,7 @@ | 台架 | COM6 @115200;目标 192.168.1.100:8080(Phase 13 独占 socket 2) | | 固件 | `test/board/test_config.h` = `TEST_SUITE_CH395F`;`test/board/ch395f_test.h` = `ENABLE_PHASE13_TESTS`(仅此一项) | | 构建 | `keil-build` skill(`keil_build.py`)→ **0 错误 0 警告**(测试构建与产品构建均 0/0) | -| 对端 | `.venv\Scripts\python.exe test/host/latency_peer.py --mode net`(纯标准库,`--wait 170`) | +| 对端 | `.venv\Scripts\python.exe test/host/bench/net/latency_peer.py --mode net`(纯标准库,`--wait 170`) | | 会话顺序 | HELLO → L5_RECV → L5_SEND → L3 → L10 → L6 → L7 → DONE | | 干扰 | 无(安静档,`ftp_stress=0`;未跑 `--ftp-stress`) | | PASS 轮次 | **run12 / run13 / run15** 三次独立完整 PASS(`summary verdict=OK`、`=== Phase 13: 1/1 PASSED (failed=0) ===`、peer exit 0) | diff --git a/docs/测试说明/测试数据/wave_fix_20261107/README.md b/docs/测试说明/测试数据/wave_fix_20261107/README.md index abad0a38..67a9678d 100644 --- a/docs/测试说明/测试数据/wave_fix_20261107/README.md +++ b/docs/测试说明/测试数据/wave_fix_20261107/README.md @@ -8,7 +8,7 @@ PNG 为 4× 放大目检件(非判据)。 ## 到场盘面事实(与修复无关,如实记档) - `/WAVE` 100 件 `WAVE00…99.BIN`,尺寸为 5250 B 的 **2~27 倍拼接**(共 1866 段,逐段过 - `test/host/wave_read.py` 校验**全部合法、零损坏**)——写者 `FA_OPEN_APPEND` 跨开机累积 + `test/host/bench/wave/wave_read.py` 校验**全部合法、零损坏**)——写者 `FA_OPEN_APPEND` 跨开机累积 属既有设计,回放页单段读侧(`size == total`)按口径逐件判「长度废」:全板无可放段。 全量原件 RETR 备份 + sha256 台账在轮末**逐字节还原**(见「收工」节)。 ⚠ 上面这段描述的是**当时**(2026-11-07)的盘面;「追加属既有设计」的口径已于 2026-11-10 @@ -73,5 +73,5 @@ F2-3(无坏段常规板况启动门禁):`boot_new2/` 与 `boot_new3/` 两 # 测试件(5250 B 单段):任一合法段文件翻 byte[130](数据 CRC 废)或翻 byte[8](头废) # FTP admin/admin → CWD /WAVE → STOR → 7003 开回放页 → 串口见 # [ERR][UI_TASK] ui wave head idx= reject=<1|5> stored=0x…. calc=0x…. -# PC 互证:& .venv\Scripts\python.exe test\host\wave_read.py dump <同款测试件> +# PC 互证:& .venv\Scripts\python.exe test\host\bench\wave\wave_read.py dump <同款测试件> ``` diff --git a/docs/测试说明/测试数据/wave_shot_20261106/README.md b/docs/测试说明/测试数据/wave_shot_20261106/README.md index 0331d6e9..2cbbbe31 100644 --- a/docs/测试说明/测试数据/wave_shot_20261106/README.md +++ b/docs/测试说明/测试数据/wave_shot_20261106/README.md @@ -30,7 +30,7 @@ 样本在 `samples/`:`WAVE06_original.BIN`(sha256 `9f88ee34…`,与覆盖后板上现行字节复验一致) 与 `WAVE06_bitflip_reject.BIN`(sha256 `a9e097bf…`),两件只差第 131 字节一比特。 -PC 侧同件判据实录见 `pc_side_dump.txt`:`test/host/wave_read.py dump` 对坏件打印 +PC 侧同件判据实录见 `pc_side_dump.txt`:`test/host/bench/wave/wave_read.py dump` 对坏件打印 `REJECT: … data CRC16 mismatch: stored 0xF991 calc 0xB111 over 5120 bytes at offset 128 -- segment rejected, nothing drawn`(rc=1),对原件双 CRC OK(rc=0)——板上画面与 PC 解码器 **同一判据、两份独立实现**互证。 @@ -69,6 +69,6 @@ segment rejected, nothing drawn`(rc=1),对原件双 CRC OK(rc=0)—— 1. `& .venv\Scripts\python.exe scripts\board_ui_nav.py --where --i-hold-bench-lock`(身份互证) 2. FTP `admin` 登录 → `CWD /WAVE` → `RETR WAVE06.BIN` → 翻 `byte[130]` → `STOR WAVE06.BIN`(页开着覆盖) -3. `& .venv\Scripts\python.exe test\host\wave_read.py dump <坏件>`(应 REJECT rc=1) +3. `& .venv\Scripts\python.exe test\host\bench\wave\wave_read.py dump <坏件>`(应 REJECT rc=1) 4. 7003 开回放页(记录查询列第 10 行)→ `r` 走满一圈回踩该段 → `LCDMEM` 取帧(本目录坏段帧生成法) 5. `DELE` 全部段 → 关开页 → 取空态帧 → `STOR` 九件原件恢复(逐件 RETR+sha 复验) diff --git a/docs/算法/采集与算法层设计说明.md b/docs/算法/采集与算法层设计说明.md index 5fd6e987..fae19b1e 100644 --- a/docs/算法/采集与算法层设计说明.md +++ b/docs/算法/采集与算法层设计说明.md @@ -828,10 +828,10 @@ typedef struct { |---|---|---|---|---| | **幅值轮** | 基波幅值计量 | UA(R31 / `AIN1`)注 Vpp 2.828 V(= 峰值 ±1.414 V)、50.000 Hz 正弦 | `meas:` 的 `ua_mv` | 读数 = 万用表 AC 档读数,偏差 ≤2 %(与静态同档)。⚠ 别用 `phasor(hb)` 行比幅值——那是 ×0.1 定点,注 1 V 只剩 10 格 | | **波形轮** | 读数是否只跟基波走 | 同幅值改方波、三角 | 同上 | 期望值 = **基波分量有效值**(同峰值下的基波 / 峰值比:方波 ≈ **0.90**,闭式 4/π ÷ √2 = 0.900、20 点整周期 DFT 实算 0.904;三角 ≈ **0.573**,闭式 8/π² ÷ √2 = 0.573、实算 0.578),**不是**真有效值(方波 = 1.000、三角 = 0.583 峰值);偏差 ≤2 %。算术与逐波形对照表见 `docs/测试说明/专项验证/ADC前端注入验证流程.md` §8.5 的波形卡。顺带把"这台仪表读的是基波"这条口径钉进文档——用户拿真有效值表去对会以为差了 10 % | -| **相位轮** | 相位 | UA 与 UN 两路**同片**(都走 TPAFE)注同幅、同相 | **录波档**:录波段文件 `test/host/wave_read.py fft`(浮点重算基波相位;段内表序 `UA` = 0、`UN` = 3);**心跳档**:`phasor(hb)` 各行 `Re=` / `Im=` | **录波档**:同段内两路相位差 ≤2°,把发生器相位改 90° 后差值跟到 ≈90°。**心跳档只判"跟随"**(差值落进 80°~100°)——`phasor` 串口行是 ×0.1 定点,Vpp 2.828 V(板上读数 ≈1000 mV)时每格 0.1 V,角度量化最坏 ≈ atan(0.1 / 0.707) ≈ 8°,判不动 2°。⚠ 段与发生器**无绝对相位锁定**(触发瞬间钉在段内点 159),只能比**同段内两路**的相对差,跨段比相位或拿发生器相位当绝对基准都不成立。**只许比同片内**——跨转换器两片没有共同采样触发,比相位无意义(见 `docs/硬件平台/ADC通道映射说明.md` §7 通道归属行),STM32 那五路还有 1 拍乒乓滞后 | +| **相位轮** | 相位 | UA 与 UN 两路**同片**(都走 TPAFE)注同幅、同相 | **录波档**:录波段文件 `test/host/bench/wave/wave_read.py fft`(浮点重算基波相位;段内表序 `UA` = 0、`UN` = 3);**心跳档**:`phasor(hb)` 各行 `Re=` / `Im=` | **录波档**:同段内两路相位差 ≤2°,把发生器相位改 90° 后差值跟到 ≈90°。**心跳档只判"跟随"**(差值落进 80°~100°)——`phasor` 串口行是 ×0.1 定点,Vpp 2.828 V(板上读数 ≈1000 mV)时每格 0.1 V,角度量化最坏 ≈ atan(0.1 / 0.707) ≈ 8°,判不动 2°。⚠ 段与发生器**无绝对相位锁定**(触发瞬间钉在段内点 159),只能比**同段内两路**的相对差,跨段比相位或拿发生器相位当绝对基准都不成立。**只许比同片内**——跨转换器两片没有共同采样触发,比相位无意义(见 `docs/硬件平台/ADC通道映射说明.md` §7 通道归属行),STM32 那五路还有 1 拍乒乓滞后 | | **测频轮** | 测频 | 同幅值轮的 Vpp 2.828 V / 50 Hz | `freq(hb):` | **预期就是"不出数"**(幅值门 50 V 在引脚域恒不过,§13.7 #1)→ 这条的判据是"如实报不可测"(`freq_valid=0`、UI `Hz` 显示 `--`),**不是**报出一个错误的 50.00。想真验 45~55 Hz 精度(PC 侧判据 0.02 Hz)须临时把 `FREQ_AMP_MIN` 降到引脚域量级(如 0.5 V)单跑一轮(动产品头文件,跑完必须还原并重跑 `/keil-build`)。**2026-11-13 更新**:幅值门已由用户裁定**永久**放宽到 5 V(二次域,§13.7 #1),标定完成后继保仪注 ≥5 V / 45~55 Hz 即可直接出数复测,不再需要临时改门。**本轮当日已跑**:≥5 V 出数正常;60 Hz 注入暴露带外钉 ~55 现象,实测定量与「参数不改」裁定登记在 §7.3(60 Hz 属带外,判据仍只覆盖 45~55 Hz) | | **削顶轮** | 削顶与品质路由(**负向用例**) | 给 UB(R52 / `AIN2`)注 **DC −1.00 V 并保持 ≥5 s**;或 Vpp 2.828 V 而频率 **2.0 Hz** 的正弦——两档都能造出"连续贴同一侧轨带"。⚠ **注 50 Hz 同幅正弦造不出锁存,且这是预期而非故障**:1 kHz 下一个周波只 20 点、正半周必落中带,而 `adc_health_rail_watch()` 任何一拍回中带就把计数清零(`App/algo/adc_health.c`),连续贴底最长 ≈ 209/360 × 20 ≈ 11 拍 < 20。TPAFE 侧在 ±2 V 判据上限内造不出这条(轨带 ±32112 码 ≈ ±4.9 V),只有 STM32 那五路能做 | `cal:` 行的 `rail=` / `edge=`;`rail: edge=…` 的 `[ERR]` 行;录波档另加 `wave_read.py shape` 的三把尺子(`--strict` / 再加 `--clip-superset` / 不带),逐条配法见 `docs/测试说明/专项验证/ADC前端注入验证流程.md` §8.5 的削顶卡 | 负半周钉下轨 → **连续 20 拍同侧后该路贴轨位锁存**(`ADC_RAIL_N_RUN = 20`,`App/algo/adc_health.h:174`)、`edge` 起沿。锁存另有**释放沿前提**:该通道此前须出现过中带样本 → **先上电见基线摆动、再开发生器输出**,开机就注会测出假不通过。撤掉注入后 `rail` 仍非 0 是 sticky 语义(只有 `adc_health_rail_init()` / 复位清)——**复位后仍不清才是 bug**。⚠ 这条会**故意造出 `[ERR]`**,而 `/serial-boot-test` 的 forbidden 标记含 `[ERR]` → 人工判读、排在最后单独一轮,且这一轮的结论不按 `/serial-boot-test` 判 | -| **谐波轮** | 谐波轨 | 基波 + 20 % 二次 + 20 % 五次(IA 上注)。⚠ 峰值预算:Vpp 2.828 V 基波 + 两个 20 % 分量的最坏对齐峰值 ≈ 1.98 V 已顶 ±2 V 红线 → 基波用 **Vpp 2.263 V**、二次与五次各 Vpp 0.453 V | **录波档**:段文件 `test/host/wave_read.py fft --ch 4 --all`(`IA` = 段内表序 4,直接给基波与 2 / 5 次谐波有效值,单位 mV);**旁证**:UI 交流量页 `Ia2` / `Ia5`(1 mV)与 `phasor(hb) C04-IA-F2` / `C05-IA-F5`(×0.1 定点,只证这根轨不是恒 0) | 谐波轨读数 = 注入分量(**±2 %,走录波档**;心跳档判不动:读数 0.160 V 在 ×0.1 串口行上只有 1~2 格)。⚠ 这两根轨**目前没有任何下游消费者**(`prot_elm.c` 无引用、`meas` 只算 `harm=1`),所以谐波轮只证"算得对",**不证"有人用"**——接到哪、给谁用,归 `docs/算法/继电保护功能复现规划.md` 的「遥测谐波轨(可选)」 | +| **谐波轮** | 谐波轨 | 基波 + 20 % 二次 + 20 % 五次(IA 上注)。⚠ 峰值预算:Vpp 2.828 V 基波 + 两个 20 % 分量的最坏对齐峰值 ≈ 1.98 V 已顶 ±2 V 红线 → 基波用 **Vpp 2.263 V**、二次与五次各 Vpp 0.453 V | **录波档**:段文件 `test/host/bench/wave/wave_read.py fft --ch 4 --all`(`IA` = 段内表序 4,直接给基波与 2 / 5 次谐波有效值,单位 mV);**旁证**:UI 交流量页 `Ia2` / `Ia5`(1 mV)与 `phasor(hb) C04-IA-F2` / `C05-IA-F5`(×0.1 定点,只证这根轨不是恒 0) | 谐波轨读数 = 注入分量(**±2 %,走录波档**;心跳档判不动:读数 0.160 V 在 ×0.1 串口行上只有 1~2 格)。⚠ 这两根轨**目前没有任何下游消费者**(`prot_elm.c` 无引用、`meas` 只算 `harm=1`),所以谐波轮只证"算得对",**不证"有人用"**——接到哪、给谁用,归 `docs/算法/继电保护功能复现规划.md` 的「遥测谐波轨(可选)」 | ### 13.11 数字能从哪儿读(零固件改动) @@ -839,7 +839,7 @@ typedef struct { |---|---|---| | 串口每 10 s 心跳(`App/task/adc_task.c` 心跳块) | `adc:`(9 路码值)、`cal:`(三路 mV + `vl`/`cl`/`rail`/`edge` 位图)、`phasor(hb)`(逐实例 `Re` / `Im` / `rms`)、`freq(hb)`、`meas:`(快照轨) | MicroLIB 无 `%f`,全是定点:`phasor` ×0.1(**1 V 注入只剩 10 格**)、`freq` ×0.01 Hz、`cal:` / `meas:` ×1000(1 mV)。10 s 一行的单点瞬时值对 50 Hz 等价于随机相位抽样 | | UI 交流量页 | `Ua` / `U0` / `Ia` / `Ia2` / `Ia5` / `Hz` / 标定徽标 共 7 行 | 160×160 单色;`--` **同时**表示"没数"和"有数但不可信" → 不能当判据,只能当旁证 | -| **段文件(原始样本)** | 每次触发一段:`/wave/WAVE00.BIN` 起共 100 个号轮转(FTP 根下可见),8 路 × 320 点原始码值加封存瞬间的标定与品质快照;PC 侧 `test/host/wave_read.py` 提供 dump / fft / shape / plot 四个子命令(bench 工具,纯标准库,自带 `--selftest`) | 判据是「PC 独立重算 vs 板上读数」对表(执行步骤见 `docs/测试说明/专项验证/ADC前端注入验证流程.md` §4,格式属主见 `docs/子系统设计/故障录波设计说明.md` §6.2 与 §6.3)。**板级注入对表已随交流六轮跑过两轮**(2026-11-02 / 11-04,注 Vpp 2.828 V / 50 Hz、fft 与 `meas:` 互合,结论 `docs/硬件平台/ADC通道映射说明.md` §8.2;CRC 不符必须拒收的判据也在 2026-10-31 远程半轮验过),余下板级判据(周波数 / 极性等逐项)见 `docs/子系统设计/故障录波设计说明.md` §10;示波器只作旁证、不当判据。段内点序:触发瞬间落在段内点 159(预触发 160 点的最后一点),段的绝对相位与发生器无锁定关系,可核对的是相对相位与极性 | +| **段文件(原始样本)** | 每次触发一段:`/wave/WAVE00.BIN` 起共 100 个号轮转(FTP 根下可见),8 路 × 320 点原始码值加封存瞬间的标定与品质快照;PC 侧 `test/host/bench/wave/wave_read.py` 提供 dump / fft / shape / plot 四个子命令(bench 工具,纯标准库,自带 `--selftest`) | 判据是「PC 独立重算 vs 板上读数」对表(执行步骤见 `docs/测试说明/专项验证/ADC前端注入验证流程.md` §4,格式属主见 `docs/子系统设计/故障录波设计说明.md` §6.2 与 §6.3)。**板级注入对表已随交流六轮跑过两轮**(2026-11-02 / 11-04,注 Vpp 2.828 V / 50 Hz、fft 与 `meas:` 互合,结论 `docs/硬件平台/ADC通道映射说明.md` §8.2;CRC 不符必须拒收的判据也在 2026-10-31 远程半轮验过),余下板级判据(周波数 / 极性等逐项)见 `docs/子系统设计/故障录波设计说明.md` §10;示波器只作旁证、不当判据。段内点序:触发瞬间落在段内点 159(预触发 160 点的最后一点),段的绝对相位与发生器无锁定关系,可核对的是相对相位与极性 | | **没有的** | 没有命令控制台,也没有「把窗里 20 / 40 个点导出来」的定点 dump 子命令——原始样本走上一行的段文件(一次 320 点 / 8 路) | 现场取回一律走现成 FTP(21 端口),形状就地看回放页单通道、或在 PC 侧用同一脚本出图 | --- diff --git a/docs/网络/BSD_Socket_API_使用指南.md b/docs/网络/BSD_Socket_API_使用指南.md index b6f1422f..3c7525da 100644 --- a/docs/网络/BSD_Socket_API_使用指南.md +++ b/docs/网络/BSD_Socket_API_使用指南.md @@ -1582,4 +1582,4 @@ CH395F 底层驱动返回的状态码(`ch395f_get_cmd_status()` 或 `ch395f_po | **TRAP-NET-18** 中止后首笔复连上传被静默截断 ≤2048B 并误报 226 成功 | RST/FIN 中止上传 → 紧接着的首笔上传"收"到 ~2KB 残留后判结束回 226 → 客户端以为成功 = **静默数据损坏**(第二笔起正常) | 异常释放(TIMEOUT)预重监听隔离:`net_drain_chip_rx()` 分块排空 RX 残渣 + 主动 close + 排空中断 + 等 CLOSED/TCP_CLOSED(400ms 起 / 800ms 上限 < 2s 时限) | RST 10/10、FIN 5/5 全通过;正常路径 30/30 + 20/20,SHA-256 全匹配 | | **TC-NET-604**"接收冻结"虚警 | 旧判读脚本把"对端填满 2KB RX 窗口"误判为 STALL/WEDGE | **结论:非缺陷**(芯片 RX 缓冲即窗口,对端填满是常态);判据改为脚本层 STEP + 客户端内容校验(RET SHA-256),虚警工具归档(`MDK-ARM/retracted_bench_20260922/`,README 禁重跑) | 真实 FTP 路径 227 轮全通过(8KB×10 … 1MB×2);并发 UI 流 600/600 CRC;设备零 FAIL/ERROR/WARN | -**排障判据**(无 Wireshark 环境,纯生产路径):`MDK-ARM/ftp_freeze_probe.py`(真实 STOR + RETR SHA-256)、`test/host/ftp_abort_probe.py`(RST/FIN 中止复连)、`MDK-ARM/tcp_reconnect_probe.py`(快速复连存活甄别)、`MDK-ARM/bench_verdict.py`(脚本层 STEP 为真值;**`probe_classify.py` A/C 判读不可信**,见 retracted 归档 README)。详见 `docs/问题记录/CH395F_Trap_Records.md`。 +**排障判据**(无 Wireshark 环境,纯生产路径):`MDK-ARM/ftp_freeze_probe.py`(真实 STOR + RETR SHA-256)、`test/host/bench/ftp/ftp_abort_probe.py`(RST/FIN 中止复连)、`MDK-ARM/tcp_reconnect_probe.py`(快速复连存活甄别)、`MDK-ARM/bench_verdict.py`(脚本层 STEP 为真值;**`probe_classify.py` A/C 判读不可信**,见 retracted 归档 README)。详见 `docs/问题记录/CH395F_Trap_Records.md`。 diff --git a/docs/网络/Net层阻塞模型架构设计.md b/docs/网络/Net层阻塞模型架构设计.md index 790a7d43..18b8e801 100644 --- a/docs/网络/Net层阻塞模型架构设计.md +++ b/docs/网络/Net层阻塞模型架构设计.md @@ -399,7 +399,7 @@ send 与 recv 语义不同:recv 是"等一次到达即完成",send 是"**分 `sent >= len → INVAL` 拒收(**无剩余块可挂起**),一次已完整交付芯片的发送会被报成失败。 该守卫同时保证后续 `net_send_pending_register` 调用必伴随 `sent < len`,登记必获受理; 末块路径零额外延迟。**自旋预算与"末块"是两个正交维度,组合必须显式覆盖**——回归由 -`test/host/ftp_regression.py`(RETR 1 KB 单块帧最敏感)覆盖。 +`test/host/bench/ftp/ftp_regression.py`(RETR 1 KB 单块帧最敏感)覆盖。 --- diff --git a/docs/网络/网络自愈架构设计.md b/docs/网络/网络自愈架构设计.md index 00322512..d47832e9 100644 --- a/docs/网络/网络自愈架构设计.md +++ b/docs/网络/网络自愈架构设计.md @@ -614,7 +614,7 @@ DISCONNECT 会被 `(void)` 丢掉。但 RECV_OK 是条件位(下轮补回) > 「假设 → 方法 → 判据 → 它门禁哪个决策」四段式;本表只给**方法与结论**,原始记录(假设、 > 原始日志、统计)已归档,取用命令见 §12。 > ⚠ **这些编号是冻结标识**:`net_socket.c` / `net_events.c` / `net_listener.c` 注释、 -> `test/host/e6_soak.py`、`docs/问题记录/CH395F_Trap_Records.md` +> `test/host/bench/net/e6_soak.py`、`docs/问题记录/CH395F_Trap_Records.md` > 都直接引用它们(原 `test/host/e02_probe.py` 已删除——2026-11-04 随 :8888 退役,正文见 git 历史), > **重排或改名会断链**。 > ⚠ 末行 **不是实验编号**——它记录的是**历史审计发现** @@ -629,7 +629,7 @@ DISCONNECT 会被 `(void)` 丢掉。但 RECV_OK 是条件位(下轮补回) | **E3** | 同场固件,OPEN / LISTEN / CLOSE / SET_* 五条命令各 50 样本,测 `GET_CMD_STATUS` 判别力 | OPEN / LISTEN / CLOSE **无判别力**,陈旧错误码 0x17 跨命令持续存活;SET 类**完全不更新** | 命令完成判据改用**状态回读**(`ch395f_cmd_done`) | | **E4** | 裸机 3 复位变体 ×20 轮:先造污染会话(发 3000B 后 RST),复位后**立即**重开监听并上传 4096B 图案载荷,逐字节校验 | 变体 A(排空 RX→CLOSE→排空事件→等 byte0=00H)**20/20**;变体 C(什么都不做)**0/20** 级联自持;实测 `rxdrain=2048`(芯片单 Socket RX 缓冲满容) | §4.4 复位序列定案;两档沉降**都必须排 RX** | | **E5** | `:7003` 上 connect→发 1B→对端 FIN→等 3 s→复连 ×10,找"芯片静默回收回 LISTEN 却不发 DISCONNECT" | 20 次 FIN **全部**正常产生 `DISCONNECTED`;静默回收在累计 ~110 次连接中断里**零复现** | 缺口真实但触发罕见 → 形态⑤ 顺带修,不单独立项 | -| **E6** | 插桩固件(`NET_U15_PROBE=1` + `test/host/e6_soak.py`):常态 + 每小时 `:7003`×10 + 压测,探"`GET_RECV_LEN>0` 但 `!readable`"失配 | 命中 **0**(~4 h 常态) | U15 观察项**不立项**(I8);上层盲收保留现状(§4.8) | +| **E6** | 插桩固件(`NET_U15_PROBE=1` + `test/host/bench/net/e6_soak.py`):常态 + 每小时 `:7003`×10 + 压测,探"`GET_RECV_LEN>0` 但 `!readable`"失配 | 命中 **0**(~4 h 常态) | U15 观察项**不立项**(I8);上层盲收保留现状(§4.8) | | **E7 / E7b** | 候选修改 M1(GRACEFUL 沉降无条件化)+ M2(门控换 `net_listener_armed`),叠加/去掉 M4-lite(删沉降段全局读即清),跑 `n30` | M1+M2+M4-lite 把 `n30` 成功率 **8% → 96.7%**;**M1 单独上会放大全局读即清的搁浅面(§7)** | 三者即现状(§4.2 门控 / §4.3 沉降);纪律:**M1 与 M4-lite 必须同批** | | **E8** | 同固件同负载,**只变设备状态**跑 `n30` 矩阵(全新启动 / 累积后 / 仅 ST-Link 复位) | 故障率在 **2%~54%** 间随状态摆动 → 故障率 ∝ 芯片侧残留存量;抓到"风暴签名"三机制(§7「风暴态三机制」) | M3 可疑门 + `sock_reset` quiescent 排空;"沉降让位救回"红线 | | **E9** | M3 可疑门判据三轮迭代(`0x05/0x00` + `lost_conn_seen==0` + `recv_bytes==0` + 芯片 RX 有在途数据) | 判据定案为**资产门版**;风暴态免疫 + 零误伤 | §4.1.6 M3 门 | diff --git a/docs/门禁说明/README.md b/docs/门禁说明/README.md index 0805b072..5a6bdbcb 100644 --- a/docs/门禁说明/README.md +++ b/docs/门禁说明/README.md @@ -16,7 +16,7 @@ 2026-10-30:51 → **52** 加 `mermaid-syntax`(mermaid 围栏内确定性语法:坏图渲染失败靠肉眼才逮过, 详见 [`mermaid-syntax.md`](mermaid-syntax.md)); 2026-11-17:52 → 51 摘掉 `iec104-unit-test`(旧自研协议层三源随 vendor 库接入整体删除,测试脚本 - `test/host/iec104/run_unit_test.py` 已不存在 ⇒ 死钩子,每次触发必 RC=2); + `test/host/iec104/run_unit_test.py` 已不存在(该目录已删除 2026-11-18)⇒ 死钩子,每次触发必 RC=2); 2026-11-18:51 → **52** 加 `iec104-tcp`(IEC 104 真实回环 11 条 TCP 用例,`stages: [manual]`))。 ⇒ **两笔合并后声明数仍是 52,但结构变了:pre-commit 阶段 48 → 47、manual 3 → 4。** ⚠ **别用 `grep -c` 去数配置里的声明行**:该文件里有一条**注释掉的**候选钩子(clang-format,第 65 行), diff --git a/docs/问题记录/CH395F_Trap_Records.md b/docs/问题记录/CH395F_Trap_Records.md index 65d57d64..1c816547 100644 --- a/docs/问题记录/CH395F_Trap_Records.md +++ b/docs/问题记录/CH395F_Trap_Records.md @@ -124,7 +124,7 @@ CH395F 以太网驱动与 NET 层的实证陷阱:现象、定案根因、修 - **状态**:✅(回归 4 轮 11/11;全局寄存器读即清见第六章 B3) - **现象**:同一会话内**第 2 次及以后**的数据连接(LIST/STOR/RETR)两类失败,概率随上一条数据连接的负载与间隔变化:① **吞数据**——新连接建立成功、服务端 `net_send` 返回成功,客户端 20s 收不到任何字节;② **425**——新连接被接受后 ~10-20ms 出现 DISCONNECT(`chip tcp=0x00`),accept 失败。 -- **定案实验(裸机芯片台架,剥离 OS/net/FTP)**:`test/board/ch395f_reuse_bench.c` 内核启动前直接调 `ch395f_*` 受控矩阵 + 主机侧 `test/host/ch395f_reuse_host.py`。**剥离后 bug 依旧复现** → 纯芯片操作时序问题。关键现场:`post-listen st=0x05/0x04`(listen 成功但 TCP 态停在旧连接 ESTABLISHED=幽灵态)、`unexpected int=0x10`(只等来旧连接滞后 DISCONNECT)、`no CONNECT within 10s`(芯片状态已 0x04 但事件始终未到等待环——E14 复核:事件已被 drain 读清消费,非芯片丢失)。 +- **定案实验(裸机芯片台架,剥离 OS/net/FTP)**:`test/board/ch395f_reuse_bench.c` 内核启动前直接调 `ch395f_*` 受控矩阵 + 主机侧 `test/host/bench/net/ch395f_reuse_host.py`。**剥离后 bug 依旧复现** → 纯芯片操作时序问题。关键现场:`post-listen st=0x05/0x04`(listen 成功但 TCP 态停在旧连接 ESTABLISHED=幽灵态)、`unexpected int=0x10`(只等来旧连接滞后 DISCONNECT)、`no CONNECT within 10s`(芯片状态已 0x04 但事件始终未到等待环——E14 复核:事件已被 drain 读清消费,非芯片丢失)。 - **芯片级规律**:CH395F 拆链收尾窗口**变长且不可观测**(状态显示 CLOSED 持续 1s+ 也不代表拆完,实测可 >2s 且时长不定)。窗口内重新 `open+listen` 三种形态:① 握手完成但 **CONNECT 事件未收到**(E14 复核:事件被台架 post-listen drain 或读清竞态吞掉,非芯片侧丢失)→ 吞数据;② 状态显示 0x04 幽灵态——旧连接拆链进行中,状态如实如此(E15 见下条;回读对端端口=旧连接端口);③ 旧连接滞后 DISCONNECT 打到新监听 → relisten 毁掉新连接 → 425。 - **归因更正(E15,2026-10-14,官方出处)**:旧"芯片谎报 0x04"措辞推翻——芯片**如实报告旧连接拆链进行中**:① `FUN_PARA` bit3 `SOCKET_CLOSE=1` 为我方设置(`net_init` 版本门控 ≥0x46;§5.52②/§5.23:DISCONNECT/TIM_OUT 后芯片**按设计不动 Socket 状态与缓冲**,等 MCU 关闭——"保留现场"是自家配置的文档化行为);② 拆链走 TCP/IP 协议状态机(RFC 9293 §3.3.2 图 5;芯片状态码表见手册 §5.22,明言"其他状态芯片会自动处理并更新"):主动关闭 FIN_WAIT_1→FIN_WAIT_2→TIME_WAIT(对端同时关经 CLOSING、同时关闭直达),TIME_WAIT 驻留 2MSL 才落 CLOSED——这就是拆链窗;TIME_WAIT 的协议目的即"防旧连接迟到报文影响新连接"(RFC 9293 §3.3.2),正是"断连即重连被拒"的协议层根源。重传默认 12 次(§5.17),实测重传耗尽 ≥3s(`test/board/ch395f_test_task.c` 超时分类实测)——与拆链窗实测 >2s 同量级;③ WCH 官方博客(《【WCH以太网接口系列芯片---CH395】CH395 TCP Server模式下客户端重连设置》,cnblogs sw111/18451802)明言"客户端主动断连并立即重新发起连接请求,此时 CH395 会拒绝该连接请求,因此需要程序中做一些特殊处理",官方方案 = 关闭完成后再 open+listen——即我们的 settle/quarantine 等待;幽灵甄别是"强制放行"路径的护栏(防把拆链中的连接当新连接 accept)。状态面从来是真——I3 就此加强。 - **已证伪的修复**(受控实验全部无效,列出防重踩):close 后固定沉降 100~3000ms / Socket 轮换(跨 socket 毒化)/ listen 后 close+重试 / 缓冲重分配 / close 前 TX 排空延时 / 禁用对账 tick(对账不是元凶)。 @@ -133,10 +133,10 @@ CH395F 以太网驱动与 NET 层的实证陷阱:现象、定案根因、修 2. **幽灵态甄别**:补 accept 前回读对端端口(`GET_REMOT_IPP`),**= 上一条连接端口(`last_peer_port`)→ 幽灵,不 accept**; 3. 对账②同步加幽灵甄别;`last_peer_port` 登记点:`handle_disconnect_event` / `handle_timeout_event` / `net_relisten_try`(清零 remote_port 前转登)/ `net_close_locked`(跨 memset 保留——幽灵属芯片 Socket 级,与 fd 复用无关)。 - **定案二:closed-with-data accept(425 真根因=accept 竞态自毁缓冲)**:`FUN_PARA` bit3 `SOCKET_CLOSE=1`(§5.52 ②)下产生 DISCONNECT 后芯片**不关 Socket、不清缓冲**,RX 缓冲里 STOR 载荷一个不少(探针实证 `recv_len=1027 re-read st=0x05/0x00`);那个 DISCONNECT 是**客户端正常 FIN**(ftplib `storbinary` 发完即关,局域网小文件 ~5ms)。旧 `net_accept_locked` 把 CLOSED 一律当"无连接" → `net_relisten_try`(close+open **清空芯片 RX 缓冲**)→ 数据被**我方亲手销毁** → 425。**修复**:CLOSED + auto_relisten + **芯片 RX 有数据**(`GET_RECV_LEN_SN`>0)→ 接受这条"已关但可读"连接(日志 `closed-with-data accept (drain pending)`),应用快路径排空,排空后 EOF 自然触发 relisten——对齐 §5.52 ② 契约。 -- **定案三:LIST 吞包 = 背靠背小段写毒化芯片 TX**:决定性对照——同一目录,LIST #1(行间天然间隔)通过;LIST #4/#7(每行一次 `net_send` ~60B 背靠背小段)必挂。芯片对同一连接的**背靠背多段小写入**会毒化 TX(芯片报 SEND_OK 但对端全部丢弃,无 RST 无 DISCONNECT);RETR 1KB 满块连发不受影响。**修复**:`send_list`/`send_nlst` 整份目录**一次性批量发送**(static 1536B 缓冲;注意 `lftpd_inet_write` 成功返回**字节数**非 0)。 **2026-10-22 增补(同一处缓冲埋的第二颗雷)**:批量发送把"装满就 `break` + 回 −1"留在了路径上,`cmd_list` 据此回 **550**——目录一旦超过 1536 B,客户端拿到的是**静默截断**的清单**外加一个错误码**,而清单看起来完全像"目录里就这些"。实测台架根目录 30 条目:修复前 1512 B / 24 条目 / 完成回包 550,修复后 1880 B / 30 条目 / 226,**6 个文件凭空消失**。改成**满块续发**(装满一块整块发出、清空再装):既保住"只发大块"这条实测结论(定案三的本体),又不让清单完整性由一个缓冲区上限决定;单行真装不下时**明确失败**而不是少发条目。同一函数还有个已知偏差:`cmd_list`/`cmd_nlst` 忽略命令参数、恒列 `client->directory`(会话 CWD)——主流客户端都是 `CWD` + 裸 `LIST`,暂未修,登记在案。 **回归**:`test/host/ftp_list_fill_test.py`(自造 26 个 8.3 短名文件把清单撑过一块,判"全列出 + 完成回包 226",跑完自动删干净;用法见 `../测试说明/板级测试/FTP_Test_Guide.md` §4.5)——设备目录清空后,只有这种自己造规模的脚本才拦得住这颗雷。 +- **定案三:LIST 吞包 = 背靠背小段写毒化芯片 TX**:决定性对照——同一目录,LIST #1(行间天然间隔)通过;LIST #4/#7(每行一次 `net_send` ~60B 背靠背小段)必挂。芯片对同一连接的**背靠背多段小写入**会毒化 TX(芯片报 SEND_OK 但对端全部丢弃,无 RST 无 DISCONNECT);RETR 1KB 满块连发不受影响。**修复**:`send_list`/`send_nlst` 整份目录**一次性批量发送**(static 1536B 缓冲;注意 `lftpd_inet_write` 成功返回**字节数**非 0)。 **2026-10-22 增补(同一处缓冲埋的第二颗雷)**:批量发送把"装满就 `break` + 回 −1"留在了路径上,`cmd_list` 据此回 **550**——目录一旦超过 1536 B,客户端拿到的是**静默截断**的清单**外加一个错误码**,而清单看起来完全像"目录里就这些"。实测台架根目录 30 条目:修复前 1512 B / 24 条目 / 完成回包 550,修复后 1880 B / 30 条目 / 226,**6 个文件凭空消失**。改成**满块续发**(装满一块整块发出、清空再装):既保住"只发大块"这条实测结论(定案三的本体),又不让清单完整性由一个缓冲区上限决定;单行真装不下时**明确失败**而不是少发条目。同一函数还有个已知偏差:`cmd_list`/`cmd_nlst` 忽略命令参数、恒列 `client->directory`(会话 CWD)——主流客户端都是 `CWD` + 裸 `LIST`,暂未修,登记在案。 **回归**:`test/host/bench/ftp/ftp_list_fill_test.py`(自造 26 个 8.3 短名文件把清单撑过一块,判"全列出 + 完成回包 226",跑完自动删干净;用法见 `../测试说明/板级测试/FTP_Test_Guide.md` §4.5)——设备目录清空后,只有这种自己造规模的脚本才拦得住这颗雷。 - **与 TRAP-NET-17 的关系**:周期对账对常驻监听器有效;FTP 数据通道是"活 1 秒就死"的短命监听器,对账②无幽灵甄别时既救不全又帮凶。本条把"看状态补 accept"内联进 accept 热路径(短去抖、无冷却)+ 端口甄别,对账②保留为兜底网。 - **教训(总纲)**:**CH395F 的"成功"(中断位/状态码)只代表芯片本地动作完成,不代表对端收到;判定必须回到对端可见证据(主机侧收发)+ 手册语义(FUN_PARA §5.52、状态码 §5.22)**。 -- **对应文件**:`net_events.c`(`net_lost_connect_probe` / `net_reconcile_tick`②;原在 `net_socket.c`,2026-10-14 抽出)、`net_socket.c`(closed-with-data accept)、`net_types.h`(`last_peer_port`)、`lftpd.c`(批量发送);台架 `test/board/ch395f_reuse_bench.{c,h}` + `test/host/ch395f_reuse_host.py`(主分支存档)。 +- **对应文件**:`net_events.c`(`net_lost_connect_probe` / `net_reconcile_tick`②;原在 `net_socket.c`,2026-10-14 抽出)、`net_socket.c`(closed-with-data accept)、`net_types.h`(`last_peer_port`)、`lftpd.c`(批量发送);台架 `test/board/ch395f_reuse_bench.{c,h}` + `test/host/bench/net/ch395f_reuse_host.py`(主分支存档)。 --- @@ -181,7 +181,7 @@ CH395F 以太网驱动与 NET 层的实证陷阱:现象、定案根因、修 ## TRAP-NET-18 · 上传中止后首笔复连上传被静默截断(≤2048B)并误报成功 -- **状态**:✅(三阶段全部闭环;回归判据常备:`test/host/ftp_abort_probe.py`) +- **状态**:✅(三阶段全部闭环;回归判据常备:`test/host/bench/ftp/ftp_abort_probe.py`) - **现象**:客户端上传(STOR)中途断开(**RST 或优雅 FIN 均可**),**紧随其后的第一笔复连上传被截断到 ≤2048 字节(= 芯片单 socket RX 缓冲大小),且服务端回报 226 成功** = **静默数据损坏**;第二笔及以后恢复正常。 - **证据(可信复现:生产固件、零固件探针)**:判据 = FTP 协议结果 + 紧接一笔正常上传的 SHA-256 往返 + 控制通道 NOOP 存活探测。RST 中止 **10/10** 复现;优雅 FIN **5/5** 同样复现 → 凡"数据未发完即断开"均触发。对照(无中止)177 轮(8KB~1MB,含 100 轮零间隔浸泡)SHA-256 全匹配(`MDK-ARM/ftp_freeze_probe.py`)→ 中止路径是唯一触发条件。 - **机制(设备侧日志实证)**:① 中止时数据 socket 释放(RST 时芯片报 `sock4 TIMEOUT`),net 层随即 relisten(监听端口复用);② 中止时在途数据(约一个缓冲=2048B 残渣)**随后才落进芯片 RX 缓冲**;③ 下一笔连接 accept 后 ~10-20ms 出现伪 `DISCONNECTED, releasing (chip tcp=0x00)`,lftpd 读到 EOF → 把已到的 2048B 当整个文件 → 226;④ 再下一笔芯片已干净 → 正常(**一次性**)。**缺陷位于 fd 复用生命周期**(上一条连接的残留状态投递给下一条连接),不在 FTP 命令逻辑。 @@ -257,7 +257,7 @@ CH395F 以太网驱动与 NET 层的实证陷阱:现象、定案根因、修 - **状态**:✅ - **现象**:Python DHCP Server 收到 DISCOVER 后无法匹配 Offer/Ack 的 xid。 - **根因(定案)**:误用 `data[232:236]`(Wireshark 某旧版显示误导);标准偏移 xid=`data[4:8]`、msg_type=`data[242]`、client_mac=`data[28:34]`、magic cookie=`data[236:240]`。 -- **对应**:`test/host/ch395f_socket_test.py` DHCP server 模式。 +- **对应**:`test/host/bench/net/ch395f_socket_test.py` DHCP server 模式。 ## TRAP-NET-10 · 消息队列值拷贝导致结果无法回传 @@ -310,8 +310,8 @@ CH395F 以太网驱动与 NET 层的实证陷阱:现象、定案根因、修 ## 主机侧测试工具过期 -- **`test/host/ftp_abort_probe.py` 已修**:原用匿名登录,FTP 鉴权落地后匿名被 530 拒 → TRAP-NET-18 两条腿**假 0/5**(第 1 轮 `PASV failed`,且半认证会话占死 FTP 唯一会话,后续轮全变 `ConnectionRefused`)。改 `admin/admin` 后 RST 5/5、FIN 5/5。**教训:跑既有回归腿前先确认凭据仍有效,否则会把工具过期读成固件回归。** -- **同族未修**:`test/host/ftp_up_dl_test.py`、`ftp_speed_test.py`、`ftp_test.py` 仍用匿名登录 → 对当前固件必挂登录步;`docs/测试说明/板级测试/FTP_Test_Guide.md` 推荐的这几个入口因此已失效(现行可用入口是 `test/host/ftp_regression.py`,默认 `admin/admin`)。 +- **`test/host/bench/ftp/ftp_abort_probe.py` 已修**:原用匿名登录,FTP 鉴权落地后匿名被 530 拒 → TRAP-NET-18 两条腿**假 0/5**(第 1 轮 `PASV failed`,且半认证会话占死 FTP 唯一会话,后续轮全变 `ConnectionRefused`)。改 `admin/admin` 后 RST 5/5、FIN 5/5。**教训:跑既有回归腿前先确认凭据仍有效,否则会把工具过期读成固件回归。** +- **同族未修**:`test/host/bench/ftp/ftp_up_dl_test.py`、`ftp_speed_test.py`、`ftp_test.py` 仍用匿名登录 → 对当前固件必挂登录步;`docs/测试说明/板级测试/FTP_Test_Guide.md` 推荐的这几个入口因此已失效(现行可用入口是 `test/host/bench/ftp/ftp_regression.py`,默认 `admin/admin`)。 ## 文档侧待修清单 diff --git a/scripts/archive/id_gate/编号治理历史.md b/scripts/archive/id_gate/编号治理历史.md index 9157bca6..cf5a73ca 100644 --- a/scripts/archive/id_gate/编号治理历史.md +++ b/scripts/archive/id_gate/编号治理历史.md @@ -331,7 +331,7 @@ P-6 号必须能反查到定义(属主登记处得存在)· P-7 编号不语 **四条边界与裁定,写给下一个动这块的人**: -1. **peer 的 JSON 键不改(本族清退到 schema 边界为止)**:`test/host/latency_peer.py` 的 +1. **peer 的 JSON 键不改(本族清退到 schema 边界为止)**:`test/host/bench/net/latency_peer.py` 的 `l5_recv` / `l5_send` / `l3_drain` / `l7_crc` / `seg_l6` / `seg_l7_first_byte` / `seg_l7_total` / `frames_l7` 与内部字典键 `l3`/`l6`/`l7`(共 48 token)是 `docs/测试说明/测试数据/m2_data/*.json` 五份 **冻结实测证据**的 schema。改名要么让代码与归档数据漂移,要么得回头改证据文件(等于篡改 @@ -348,7 +348,7 @@ P-6 号必须能反查到定义(属主登记处得存在)· P-7 编号不语 编号规范好例子清单);归档里那条历史 note 原文不动,它是当时决定的记录。 另修一处上一批路径残留:`net_latency_test.c/.h` 三处注释把 peer 少写一级目录(正确路径是 -`test/host/latency_peer.py`),已改对。 +`test/host/bench/net/latency_peer.py`),已改对。 ## 变更记录(2026-10-28 瘦身以前的全量流水) diff --git a/scripts/board_ui_nav.py b/scripts/board_ui_nav.py index 801daea1..d246192d 100644 --- a/scripts/board_ui_nav.py +++ b/scripts/board_ui_nav.py @@ -58,9 +58,9 @@ import subprocess import sys import time -# 台架连接默认值单一真源在 test/host/bench_defaults.py(跨目录:补 sys.path 后 import) +# 台架连接默认值单一真源在 test/host/bench/bench_defaults.py(跨目录:补 sys.path 后 import) _sys_path = os.path.join(os.path.dirname(os.path.abspath(__file__)), - "..", "test", "host") + "..", "test", "host", "bench") if _sys_path not in sys.path: sys.path.insert(0, _sys_path) import bench_defaults # noqa: E402 diff --git a/test/board/ch395f_reuse_bench.c b/test/board/ch395f_reuse_bench.c index e70330cb..055a13bf 100644 --- a/test/board/ch395f_reuse_bench.c +++ b/test/board/ch395f_reuse_bench.c @@ -3,7 +3,7 @@ * @brief relisten 沉降段原语化受阻的芯片级 Socket 复用时序台架(裸机,内核前运行,OS/net/FTP 全剥离) * @details 直接调用 ch395f_* 命令,循环执行受控时序矩阵(延迟/关闭次序/载荷/Socket 号), * 每步打印芯片状态与中断寄存器,定位"关→开→监听→连接"复用时序中 - * 芯片行为的确切规律。配套主机脚本 test/host/ch395f_reuse_host.py。 + * 芯片行为的确切规律。配套主机脚本 test/host/bench/net/ch395f_reuse_host.py。 * 定案结论与实验矩阵演进 → CH395F_Trap_Records.md TRAP-NET-20。 * * 存档状态:本文件在主分支**不注册编译**(未加入 uvprojx),仅作实验工具存档; @@ -18,7 +18,7 @@ * E3 = GET_CMD_STATUS 判别力矩阵(OPEN/LISTEN/CLOSE/SET_SOUR_PORT/SET_PROTO_TYPE, * 含"命令未发时"对照读,复核 Trap 记录的 SET 类无判别力 + 陈旧 BUSY 残留); * E4 = sock_reset 内部顺序 A/B/C 变体 ×10 轮(轮间换端口)+ 立即复连载荷完整性自证 - * (配套 test/host/ch395f_reuse_host.py --mode e4)。 + * (配套 test/host/bench/net/ch395f_reuse_host.py --mode e4)。 * 判据与结果锚点 → docs/网络/网络自愈架构设计.md §5.2 E2/E3/E4(过程全文已归档,见该文档 §12)。 * * close_mode:0=主机先关(芯片等 DISCONNECT);1=芯片先关;2=无数据连上即关 diff --git a/test/board/ch395f_test.h b/test/board/ch395f_test.h index 342870f6..cc42db40 100644 --- a/test/board/ch395f_test.h +++ b/test/board/ch395f_test.h @@ -77,7 +77,7 @@ extern "C" { * 不永久挡 accept */ #define ENABLE_PHASE14_TESTS /* [网] 生产路径时延(PROD_CYCLE~UI_LOOP) */ /* [网] BSD UDP 数据面真机回归(阶段 16,PR #74 UDP 队列化的台架对照):需 PC 端 - * `python test/host/udp_queue_bench.py --board <板 IP>`,**只开本宏**——阶段 7/11/14 + * `python test/host/bench/net/udp_queue_bench.py --board <板 IP>`,**只开本宏**——阶段 7/11/14 * 会把 TEST_LATENCY_PROBE 带进产品路径,污染要证的 UDP 面。判据见 CH395F_Test_Guide 阶段 16。 */ //#define ENABLE_PHASE16_TESTS /* [网] BSD UDP 数据面真机回归(需 PC peer,独立运行) */ diff --git a/test/board/net_latency_test.c b/test/board/net_latency_test.c index d8fb3778..b11a272f 100644 --- a/test/board/net_latency_test.c +++ b/test/board/net_latency_test.c @@ -513,7 +513,7 @@ void net_latency_phase12_run(void) * Phase 13 — 芯片 + 队列时延(CHUNK_WAIT~FRAME_RT/LOGTAX,需 PC peer,M2) * * 由 net_layer_test_main() 监听循环(8080 端口,~10ms 节拍)事件驱动。 - * 服务器驱动协议:MCU 发操作字节,peer(test/host/latency_peer.py --mode net) + * 服务器驱动协议:MCU 发操作字节,peer(test/host/bench/net/latency_peer.py --mode net) * 执行对应流量;段完成后 MCU 打 [LAT] 报告行并推进下一操作。 * * 段定义(说明文档 §1): diff --git a/test/board/net_latency_test.h b/test/board/net_latency_test.h index b0bab174..028979a2 100644 --- a/test/board/net_latency_test.h +++ b/test/board/net_latency_test.h @@ -128,7 +128,7 @@ void net_latency_phase12_run(void); * 入口参数:sockfd - 测试监听 socket(连接后的数据通道 fd,8080 端口) * 返回值:无 * 限定条件:由 net_layer_test_main() 监听循环每 ~10ms 调用一次(事件驱动 - * 状态机);需 test/host/latency_peer.py --mode net 配合;须独立运行 + * 状态机);需 test/host/bench/net/latency_peer.py --mode net 配合;须独立运行 * 函数说明:服务器驱动协议(见文件头协议注释);会话完成后 s_done 置位, * 后续调用为空操作;套件未选中本 Phase 时函数体为空 */ @@ -147,7 +147,7 @@ int net_latency_phase13_busy(void); * 入口参数:无(本 Phase 不占用测试 socket,测量生产 socket 的服务端行为) * 返回值:无 * 限定条件:由 net_layer_test_main() 循环每 ~10ms 调用一次;需 - * test/host/latency_peer.py --mode remo --port 7003 配合;须单独使能 + * test/host/bench/net/latency_peer.py --mode remo --port 7003 配合;须单独使能 * (与 Phase 13 同启时两者都会跑,M3 台架建议只开 Phase 14) * 函数说明:状态机顺序 = ui_loop(本地节拍窗口)→ prod_cycle_mcu(等 peer * 发满 N 帧 LCDMEM)→ relisten(等 peer 断开重连)→ DONE; diff --git a/test/board/net_test_task.c b/test/board/net_test_task.c index eb36cac1..384ad1b1 100644 --- a/test/board/net_test_task.c +++ b/test/board/net_test_task.c @@ -1009,7 +1009,7 @@ void net_layer_test_main(void) * 这样 PC 侧不需要固定 IP——台架机器是 DHCP,与 net_test_task.h 里 * TEST_PC_PEER_IP 的 192.168.31.2 并不一致,写死会让本阶段只能在那台机器上跑。 * - * PC 端:python test/host/udp_queue_bench.py --board <板 IP> + * PC 端:python test/host/bench/net/udp_queue_bench.py --board <板 IP> * 两侧的步骤表(tag/长度/端口/源套接字)必须一一对应,改一边就改另一边。 * * 缓冲:本阶段自带 1600 B 静态缓冲(>1472 上限,≤2KB 约定),不复用 32KB 的 @@ -1335,7 +1335,7 @@ void net_layer_udp_bench_test_main(void) static const int s_sizes[5] = { 1, 20, 1024, 1025, 1472 }; DBG_INFO("=== CH395F Phase 16 Tests (BSD UDP Queue) ==="); - DBG_INFO("PC peer: python test/host/udp_queue_bench.py --board --port %u", + DBG_INFO("PC peer: python test/host/bench/net/udp_queue_bench.py --board --port %u", (unsigned)UDP_BENCH_PORT); /* ---------- TC-NET-1600:模式函数自检(先信校验收件,再信它判的包) ---------- */ diff --git a/test/board/net_test_task.h b/test/board/net_test_task.h index c4d630c8..374c3838 100644 --- a/test/board/net_test_task.h +++ b/test/board/net_test_task.h @@ -21,7 +21,7 @@ void net_layer_client_test_main(void); /* NET 层 BSD UDP 数据面回归入口(定义于 net_test_task.c,阶段 16)。 * 板端做 UDP 服务端(先 bind :6001,再从收到的包里学对端地址回显), - * PC 侧跑 test/host/udp_queue_bench.py 提供逐步激励;PC 缺席时每步 + * PC 侧跑 test/host/bench/net/udp_queue_bench.py 提供逐步激励;PC 缺席时每步 * 都有 25 s 预算,报 [FAIL] 而不是把 testTask 挂死。 */ void net_layer_udp_bench_test_main(void); diff --git a/test/host/README.md b/test/host/README.md index facf7831..3fecdf82 100644 --- a/test/host/README.md +++ b/test/host/README.md @@ -1,57 +1,53 @@ # test/host/ — 主机端测试脚本 -> PC 侧的测试驱动与判读脚本(Python,跑在开发机上,经串口/网络与目标板交互)。 +> PC 侧的两类东西:**主机侧纯逻辑单测**(编真实 C 源码跑在开发机上,零硬件)与 +> **台架驱动/探针**(连板 / 连模拟器 / 连 PC 对端,一次性台架动作)。 +> 台架脚本自 2026-11-18 起全部收进 `bench/`,本层只剩目录与表格。 -## 文件一览 +## 目录地图 -### 流程与判读 +**先看这张表再加东西**——四个位置服务四种不同目的,放错了要么门禁跑不到,要么被门禁误伤。 + +| 类别 | 位置 | 放什么 | 加新东西该往哪放 | +|---|---|---|---| +| 主机侧单测模块 | `<模块>/run_unit_test.py`(本层 51 个模块目录,其中 48 个带运行器;`cal/` `common/` `iec104_netmcu/` 不带;另有一个 `bench/` 见下行) | 声明式 `TestBuild` + 真实 C 源码 + `stub/`,MSVC 离线编译,纯逻辑零硬件 | **新增单测才往这里加**。目录名即模块名,被 pre-commit 的 21 根 `-unit-test` 钩子逐个点名(`files:` 触发面按目录),`scripts/ci_local.py` 与 `test-coverage` 总闸按 `test/host/**/run_unit_test.py` 发现 | +| 台架驱动与探针 | `bench/`(按域分 `ftp/` `net/` `iec104/` `wave/` `screenlink/`) | 连板 / 连模拟器 / 连 PC 对端的东西:压测、复现器、验收腿、协议抓包 | **一次性台架动作都往这儿**,按被验对象选域子目录。索引与逐脚本一句话见 [`bench/README.md`](bench/README.md) | +| 104 验收资产 / fake net 单测 | `iec104_dtu/`、`iec104_netmcu/` | 前者:真板 104 只读验收探针 + 回环 TCP 用例(`PROBE_RUNBOOK.md`);后者:vendor 协议核与 `net_socket` fake 的静态+动态核查 | 专用,各自 `MATRIX.md` 是口径。**不要**往 `bench/iec104/` 混——那里只有主站客户端与它的离线自检 | +| harness 与假件 | `common/` | `unit_test_harness.py`(MSVC 探测→编译→运行→判退出码)+ 跨模块复用的 `*_fake.c/h` | 新单测只**声明** `TestBuild`,工具链细节不进各模块 | +| 标定工具 | `cal/` | `cal_collect.py`(串口日志取中位数填执行卡)/ `cal_fit.py`(N 点最小二乘,全仓唯一实现)/ `cal_write.py`(C_SE 两段写下发 + C_RD 读回) | 标定是一次性台架动作但**位置固定不动**:执行卡与文档都按这个路径写,挪了要同步 `docs/测试说明/专项验证/ADC多点标定执行流程.md` | + +> 已删除(2026-11-18):`iec104/`(旧自研协议层单测,随三源退役,只剩一个零引用的 `stub/dbg_log.h`) +> 与 `iec104_serv/`(旧服务层单测,随服务层重写退役)。 + +## bench/ — 台架驱动与探针 + +原来平铺在本层的 25 个脚本(FTP / CH395F / E1·E6·E8·E11·E12 自愈腿 / 104 主站 / 录波 / 屏板链路) +已按域归档进 `bench/`。**逐脚本一句话作用、运行前置、连接默认值在哪 → [`bench/README.md`](bench/README.md)。** + +两个高频入口先记在这里: + +- **台架地址只改一处**:`bench/bench_defaults.py`(设备 IP / 网关 / PC 对端 IP)。下面的脚本、`cal/`、 + `scripts/board_ui_nav.py`、`MDK-ARM/*.py` 都从它取默认值。 +- **自愈/Trap 常备回归腿**在 `bench/net/`(`relisten_stress` / `e6_soak` / `e11_keepalive_probe` / + `pasv_probe`)与 `bench/ftp/`(`ftp_abort_probe` / `n30_repro` / `ftp_list_fill_test`)。 + +## cal/ — 标定三件套(位置固定,勿挪) + +一次性的台架标定动作,但路径被执行卡与文档按死(执行卡 `docs/测试说明/专项验证/ADC多点标定执行流程.md` +§3/§4 直接写 `test/host/cal/…`),所以留在本层不进 `bench/`。 | 脚本 | 作用 | |---|---| -| `run_boot_test.py` | **`/serial-boot-test` 一键闭环**:开串口+清日志 → 烧录 → wait-idle → `verify_log` 校验(退出码 0=PASS) | -| `verify_log.py` | **日志标记校验**:Required / Forbidden 标记 → PASS / FAIL;可选 `--require-suite-summary` 校验套件汇总行(`=== <名称>: N/M PASSED (failed=0) ===` 且 `N>0`),抓"没跑到汇总行/断言数为 0"的盲区 | +| `cal_collect.py` | **串口日志取数**:从 `serial.log` 最近 N 拍(默认 15)取 `meas:` 读数中位数,填进执行卡 `CALDATA` 表对应行;同一 `--point` 重跑覆盖旧值 | +| `cal_fit.py` | **N 点最小二乘标定求解(全仓唯一实现,v2.2 起固件侧拟合已删除)**(**3~8 点**,推荐 5 点):`--selftest` 跑金标向量回归(原 C 侧 `r_q16=39322000 / b=12` + 4 条拒绝路径,exit 0 全过 / 1 有失败,改动算法后必跑);`--from-doc` 直接读执行卡 §3 `CALDATA` 长表按路分组拟合,输出合并 `WRITE-ALL` 命令;单路 `--sem/--x/--y` 亦可;exit 0 可写 / 2 拒绝(入参越界、点数越界、点位没拉开、单调性反转、斜率非正、r/b 越带、残差 >2%、表还是旧 6 列)或未填 | +| `cal_write.py` | **标定参数写入器**(库层复用 `bench/iec104/iec104_master.py`):C_SE 两段写下发定值段 `0x8050~`(变比 r)/`0x8048~`(零点 b,落笔置 VALID),C_RD 读回复核;每路**先 r 后 b**(b 置 VALID 要求 r 已在带);输出纯 ASCII 可归档;exit 0 全过 / 1 有失败 / 2 连接或协议错误 | -### 网络 / FTP - -| 脚本 | 作用 | -|---|---| -| `ch395f_socket_test.py` | Socket 通信测试(回显服务器 / 文件收发) | -| `ftp_test.py` | FTP 基本功能测试 | -| `ftp_up_dl_test.py` | FTP 上传下载测试 | -| `ftp_speed_test.py` | FTP 传输速度测试 | -| `ftp_capture.py` | FTP 流量抓取 | -| `ftp_regression.py` | FTP 回归套件 | -| `ftp_abort_probe.py` | FTP 中止场景探针(TRAP-NET-18;RST→450 / FIN→226,`--check-abort`;2026-10-13 自 `MDK-ARM/` 迁入) | -| `ftp_integrity_test.py` | FTP 上传 SHA-256 完整性多轮回归 | -| `n30_repro.py` | 背靠背 STOR 复现器(TRAP-NET-20 常备回归腿) | -| `relisten_stress.py` | 监听快速复连压力(TRAP-NET-17 / E1:`--port --n --gap-ms [--hold-ms]`) | -| `e11_keepalive_probe.py` | keepalive 黑洞判死探针(E11) | -| `e6_soak.py` | E6 24h 挂机驱动(常态 + 每小时/每 4h E1 压测注入;判据读串口 `U15 probe` 计数) | -| `pasv_probe.py` | PASV 数据通道时序探针 | -| `ch395f_reuse_host.py` | Socket 复用/中止形态 PC 对端(bench 配套) | -| `ftp_auth_bench.py` | FTP 鉴权/锁定台架腿 | -| `iec104_master.py` | **IEC 60870-5-104 主站客户端(台架复测/保护定值持久化)**:连设备 :2404(工厂默认,`--port` 可指别的)跑 STARTDT → 总召(actcon/四组背景扫描/actterm)→ 经 C_SE 两段写临时压低 OC1 定值确定性触发 YX16 变位(COT=3)→ 恢复 → YK11 两段式 → C_RD 读回;**保护定值持久化模式 `--b7-pre/--b7-post/--b7-mark/--b7-check`**(中间 ST-LINK 复位):YK12 两段投退→保护退出/联动、定值与压板态跨复位保持(含非默认 7.5 往返);纯标准库,输出纯 ASCII 可直接重定向归档为台架证据(判据 exit 0/1/2) | -| `cal_fit.py` | **N 点最小二乘标定参数求解(全仓唯一实现,v2.2 起固件侧拟合已删除)**(**3~8 点**,推荐 5 点):`--selftest` 跑金标向量回归(原 C 侧 `r_q16=39322000 / b=12` + 4 条拒绝路径,exit 0 全过 / 1 有失败,改动算法后必跑);`--from-doc` 直接读执行卡 §3 `CALDATA` 长表(每行一个点:路 \| 序号 \| 屏上读数 \| 注入已知量)按路分组拟合,输出合并 `WRITE-ALL` 命令;单路 `--sem/--x/--y` 亦可(`--x` = `meas:` 行 mV/mA 原样、`--y` = V/A 内部 ×1000,`--r-old/--b-old` 指读数采集时的设备参数);执行卡 `docs/测试说明/专项验证/ADC多点标定执行流程.md` §3;exit 0 可写 / 2 拒绝(入参越界 `bad argument`、点数越界、点位没拉开、单调性反转、斜率非正、r/b 越带、残差 >2%、表还是旧 6 列)或未填 | -| `cal_write.py` | **标定参数写入器**(库层复用 `iec104_master.py`):C_SE 两段写下发定值段 `0x8050~`(变比 r)/`0x8048~`(零点 b,落笔置 VALID),C_RD 读回复核;每路先 r 后 b,输出纯 ASCII 可归档;执行卡 `docs/测试说明/专项验证/ADC多点标定执行流程.md` §4;exit 0 全过 / 1 有失败 / 2 连接或协议错误 | -| `iec104_dtu/verify_board_acceptance.py` | **真板 104 只读验收**(STARTDT→总召→逐点核对 10 个映射遥测 + 59 SP + 16 DP →命令拒绝→对时确认):固件/点表变更后连板跑;`--host/--port` 默认 `192.168.31.100:2404`,纯标准库、ASCII 输出;exit 0 全过 / 1 检查失败 / 2 连接或协议错误;用法见 `iec104_dtu/PROBE_RUNBOOK.md` | -| `iec104_dtu/verify_simulator_lan_bind.py` | **模拟器 104 任意地址绑定与局域网可达性验证**(启动 `lvgl_sim` 后查 `0.0.0.0:port` 监听 + 本机 IPv4 STARTDT 握手):模拟器绑定/CLI 变更后跑;`--exe/--output/--duration/--lan-ip` 可覆盖,纯标准库、ASCII 输出;exit 0 通过 / 1 断言失败 / 2 环境错误;同机验证,不证明防火墙放行 | -| `iec104_dtu/verify_simulator_duration_evidence.py` | **模拟器自然退出证据探针**(拒绝 select/execute→对时→无 COT10/11→`--iec104-duration` 自然退出打印 STOP 汇总):引用 `simulated_actions` 前跑;`--exe/--host/--port/--duration/--output` 可覆盖,纯标准库、ASCII 输出;exit 0 全过 / 1 行为失败 / 2 启动或读取错误 | - -### 时间 / 时延 - -| 脚本 | 作用 | -|---|---| -| `latency_peer.py` | 链路时延测试的 PC 对端(peer) | - -> 原 `time_sync_server.py`(:8888 推送对时源)已随 :8888 退役删除(2026-11-04,#78); -> 对时改为板端 SNTP 客户端出向(墙钟说明 §16),台架用真实/私有 NTP 源即可。 - -### 主机侧单元测试(纯逻辑,无硬件) +## 主机侧单元测试(纯逻辑,无硬件) | 文件 | 作用 | |---|---| | `common/unit_test_harness.py` | **通用单测 harness**(主机侧纯逻辑单测):探测 MSVC → 拼 `INCLUDE`/`LIB` → 编译 → 运行 → 判定退出码。各模块运行器只做**声明式**配置(`TestBuild`),不含工具链细节 | -| `watchdog/run_unit_test.py` | **看门狗判定状态机单测**:声明 `TestBuild` 后调 harness,用 MSVC 离线编译真实 `App/util/task_watchdog.c`(可观测桩驱动),39 用例穷举边界。零硬件、秒级(退出码 0=PASS/1=FAIL/2=环境错误) | +| `watchdog/run_unit_test.py` | **看门狗判定状态机单测**:声明 `TestBuild` 后调 harness,用 MSVC 离线编译真实 `App/util/task_watchdog.c`(可观测桩驱动),47 用例穷举边界。零硬件、秒级(退出码 0=PASS/1=FAIL/2=环境错误) | | `watchdog/watchdog_test.c` | 测试单元本体(`#include` 生产源码 + 平台钩子桩) | | `watchdog/stub/` | 桩头文件(`main.h`/`iwdg.h`/`dbg_log.h`),覆盖 MCU 版以在 PC 上编译 | | `sys_clock/run_unit_test.py` | **系统时钟换算单测**:离线编译真实 `App/util/sys_clock.c`,以可控时钟 + 阴影 RTC 桩驱动,100 断言点覆盖闰年/月末/世纪/2038 上限/星期/30 天惰性再基准化/RTC 故障降级 | @@ -71,17 +67,22 @@ | `time_sync/run_unit_test.py` | **时间同步任务载体单测(v2.0)**:离线编译真实 `App/sync/time_sync.c`,33 断言点覆盖分片喂狗延时 / 就绪屏障(100 ms 分片、`osFlagsNoClear`、永不就绪不挂死)/ SNTP 节拍驱动与**网络代次当轮交接** / 未出网守门(:8888 退役后任务即纯校时节拍宿主) | | `time_sync/time_sync_test.c` | 测试单元本体(`#include` 生产源码 + 网络 / 事件 / RTOS 可脚本化桩 + `longjmp` 跳出 `for(;;)` 任务循环) | | `time_sync/stub/` | 桩头文件(`FreeRTOS.h` / `task.h` / `cmsis_os2.h` / `net_socket.h`(裁剪至 `net_get_generation`,**编译期绊线**:生产码若再引监听类 API 立刻炸)/ `sys_events.h`) | -| `iec104/run_unit_test.py` | **IEC 60870-5-104 协议栈单测(IEC 104 上行)**:离线编译真实 `App/protocol/iec104/` 三模块 + 数据源(prot_set/prot_elm/phasor/sample_ring),**82** 用例覆盖 CP56 往返 / APCI 半帧·粘帧·坏帧 / STARTDT 握手 / 总召分片+RBT / COV 死区 / k=12 窗满 / w=8 触发 S / t1·t2·t3 / N(R) 倒退判故障 / 遥控·定值两段式与 PN / C_CS / 未知类型·地址错误应答 | | `nand_port/run_unit_test.py` | **dhara NAND 移植层单测**:离线编译真实 `Drivers/BSP/GD5F2GQ5UE/nand_ftl.c` + 真实 `Lib/dhara/{journal,map}.c`,以 **RAM 假芯片**驱动,**149** 断言覆盖 is_free 整页扫描 / 六个 HAL 入口的越界守卫 / 故障注入 / dhara map"写入 → 重新 resume"场景 | | `nand_port/nand_port_test.c` | 测试单元本体(`#include` 生产源码 + RAM 假芯片;内联一份"只看页首 64 B"的**旧算法对照**,证明断言能咬人) | | `nand_port/stub/` | 桩头文件(`gd5f2gq5ue.h` 芯片几何与 SPI 原语声明 / `dbg_log.h` 日志宏计数) | +> 本表只列**有专属说明文档**的那几套;`test/host/` 下带 `run_unit_test.py` 的目录共 **48** 个, +> 全量清单以 `scripts/check_test_coverage.py --list` 为准(它同时是 `test-coverage` 总闸的 +> 发现规则)。 +> 已删除(2026-11-18):`iec104/run_unit_test.py`(82 用例,旧自研协议层三源退役)—— +> 对应 `iec104-unit-test` 钩子已于 2026-11-17 摘除,见 `docs/门禁说明/README.md`。 + > 详见 `docs/测试说明/单元测试/看门狗单元测试说明.md`、`docs/测试说明/单元测试/系统时钟单元测试说明.md`、 > `docs/测试说明/单元测试/配置文件单元测试说明.md`、`docs/测试说明/单元测试/ADC输入层单元测试说明.md`、 > `docs/测试说明/单元测试/相量层单元测试说明.md`、`docs/测试说明/单元测试/卷锁单元测试说明.md`、 > `docs/测试说明/单元测试/时间同步单元测试说明.md`; > harness 用法见 [`common/README.md`](common/README.md)。 -> 已挂 pre-commit 钩子(各模块同名 `*-unit-test`,共 **22** 个;逐个说明见 +> 已挂 pre-commit 钩子(各模块同名 `*-unit-test`,共 **21** 个;逐个说明见 > `docs/代码规范/pre-commit使用说明.md` §2.2 与 `docs/门禁说明/host-unit-tests.md`)。 ### nand_port —— dhara NAND 移植层为什么能在 PC 上测 @@ -135,29 +136,39 @@ # dhara NAND 移植层单测(纯逻辑 + RAM 假芯片,无需真机) & '.venv\Scripts\python.exe' test/host/nand_port/run_unit_test.py + +# 台架脚本(需真机;台架地址在 bench/bench_defaults.py) +& '.venv\Scripts\python.exe' test/host/bench/net/relisten_stress.py --port 7003 +& '.venv\Scripts\python.exe' test/host/bench/ftp/ftp_regression.py +& '.venv\Scripts\python.exe' test/host/bench/iec104/iec104_master.py ``` > 串口端口配置在 `.serialtest/config.json`(单一配置源,当前 COM6/115200)。 ## ⚠️ 注意 -- **PYTHONPATH/路径敏感**:脚本按仓库根相对路径读写,**从仓库根执行** +- **PYTHONPATH/路径敏感**:脚本按仓库根相对路径读写,**从仓库根执行**;解释器用 `.venv`。 - 本目录**被 pre-commit 门禁的 cppcheck / 代码规范排除**(`test/` 豁免); - 但各模块的 `run_unit_test.py` 自身**作为独立钩子**参与门禁(见上,共 22 个) -- 台架探针族分工(2026-10-13 起):**自愈/Trap 常备回归腿在本目录**(`relisten_stress` / - `ftp_abort_probe` / `n30_repro` / `e6_soak` 等;`e02_probe` 已随 :8888 退役删除,2026-11-04); - `MDK-ARM/*.py` 只余被文档**当作 - 可信判据引用过**的三件(`ftp_freeze_probe` / `tcp_reconnect_probe` / `bench_verdict`)—— - 2026-10-22 清掉了一批既无人引用、又因设备侧启用鉴权而再也登录不上的历史一次性探针 - (`MDK-ARM/ftp_retr_abort_probe.py` 与整个 `MDK-ARM/bench_diag/`(4 个诊断脚本)),需要时从 - git 历史取回;`ftp_freeze_probe.py` 因被 Trap 记录当复现配方而保留,已改用设备账号登录。 -- 全部主机侧单测(16 个模块目录,含本目录新增的 `nand_port/`)都需要本机装有 MSVC - (VS2019/2022/2026 的 C++ 工具链);无则脚本报环境错误(退出码 2) + 但各模块的 `run_unit_test.py` 自身**作为独立钩子**参与门禁(见上,共 21 个) +- `bench/` 下的脚本要 `import bench_defaults` 时**自带 `_BENCH_DIR` 那三行 `sys.path` bootstrap** + (补 `bench/` 进 `sys.path`),不靠调用方的工作目录或 `PYTHONPATH`;`cal/`、 + `scripts/board_ui_nav.py`、`MDK-ARM/*.py` 是跨目录的三处同类 bootstrap。 +- `MDK-ARM/*.py` 只余被文档**当作可信判据引用过**的三件(`ftp_freeze_probe` / + `tcp_reconnect_probe` / `bench_verdict`)——2026-10-22 清掉了一批既无人引用、又因设备侧 + 启用鉴权而再也登录不上的历史一次性探针(`MDK-ARM/ftp_retr_abort_probe.py` 与整个 + `MDK-ARM/bench_diag/`(4 个诊断脚本)),需要时从 git 历史取回;`ftp_freeze_probe.py` + 因被 Trap 记录当复现配方而保留,已改用设备账号登录。它们也 import `bench_defaults` + (从 `MDK-ARM/` 补 `../test/host/bench`)。 +- 全部主机侧单测(48 个带 `run_unit_test.py` 的模块目录)都需要本机装有 MSVC(VS2019/2022/2026 的 C++ 工具链); + 无则脚本报环境错误(退出码 2) ## 相关文档 +- [`bench/README.md`](bench/README.md) — 台架脚本域索引(逐脚本一句话)+ 运行前置 +- [`common/README.md`](common/README.md) — 单测 harness 用法 - `docs/测试说明/流程与规范/自动化测试流程.md` — `/serial-boot-test` 细节与失败模式 - `docs/测试说明/流程与规范/测试开发标准流程.md` — 测试分层与门禁 +- `docs/门禁说明/host-unit-tests.md` — 21 根专属钩子台账与补钩判据 - `docs/测试说明/单元测试/看门狗单元测试说明.md` — 主机侧单测(用例 / 平台层 / 扩展方法) - `docs/测试说明/单元测试/系统时钟单元测试说明.md` — 系统时钟换算单测(用例 / 桩 / Zeller 缺陷记录) - `docs/测试说明/单元测试/配置文件单元测试说明.md` — 配置引擎单测(内存 FS 桩 / 抓出的 P0) diff --git a/test/host/bench/README.md b/test/host/bench/README.md new file mode 100644 index 00000000..e88c4c1a --- /dev/null +++ b/test/host/bench/README.md @@ -0,0 +1,35 @@ +# test/host/bench/ — 台架驱动与探针 + +> **一次性台架动作**(连板 / 连模拟器 / 连 PC 对端)都住在这里;纯逻辑的主机侧单测在 +> `test/host/<模块>/run_unit_test.py`,不在本目录。目录分工的总表见 +> [`../README.md`](../README.md) §目录地图。 + +## 域索引 + +| 域 | 目录 | 脚本 → 一句话作用 | +|---|---|---| +| 配置 | (本层) | `bench_defaults.py` → 台架连接默认值单一真源(设备 IP / 网关 / PC 对端 IP),**换台架只改这里** | +| FTP | `ftp/` | `ftp_test.py` → FTP 基本功能(连上 / LIST / STOR / RETR 冒烟);`ftp_up_dl_test.py` → 上传+下载往返;`ftp_speed_test.py` → 大文件传输速率;`ftp_capture.py` → 模拟 FTP Server 打印客户端每条命令(抓协议用);`ftp_regression.py` → 数据连接复用回归(D20:同会话第二个数据连接必失败);`ftp_abort_probe.py` → 中止场景探针(RST→450 / FIN→226,`--check-abort`);`ftp_integrity_test.py` → 上传后 SHA-256 多轮字节级校验(E12);`ftp_list_fill_test.py` → LIST 满块静默截断回归(目录一大多回 550);`ftp_auth_bench.py` → 鉴权矩阵(530/331/230/550、跨会话锁定);`n30_repro.py` → 背靠背 STOR 复现器(TRAP-NET-20 常备回归腿) | +| 网络 | `net/` | `ch395f_socket_test.py` → CH395F BSD Socket 全模式测试(回显 / 文件收发 / DHCP);`ch395f_reuse_host.py` → Socket 复用与中止形态的 PC 对端;`e11_keepalive_probe.py` → KeepAlive「链路在、对端静默」判死探针(E11);`e6_soak.py` → 24h 挂机驱动(常态 + 每小时/每 4h 注入 E1 压测);`relisten_stress.py` → 监听快速复连压力(E1/E5);`pasv_probe.py` → PASV 端口复用「风暴」签名探针(E8);`udp_queue_bench.py` → UDP 数据面队列化真机回归(板端阶段 16 的 PC 对端);`udp_queue_bench_loopback.py` → 上一支的离线回路自检(假板子,不需要真机);`latency_peer.py` → 链路时延测试的服务端驱动 PC 对端(M2) | +| IEC 104 | `iec104/` | `iec104_master.py` → 104 主站客户端(STARTDT / 总召 / C_SE 定值两段写 / YK / C_RD,含 `--b7-*` 保护定值跨复位持久化模式);`test_iec104_master_rx.py` → 上者的离线样帧自检(不需要台架) | +| 录波 | `wave/` | `wave_read.py` → 录波段文件 PC 侧解码(`dump`/`fft`/`shape`/`plot`,与 `App/algo/wave_store.c` 是两份独立实现) | +| 屏板链路 | `screenlink/` | `screenlink_bench.py` → 用 PC + USB 转 TTL 顶替屏板,按召唤节拍发帧 A;`remolcd_pull_test.py` → RemoDispBus(:7003) 拉整帧压力客户端 | + +## 运行前置 + +- **从仓库根执行**(脚本按仓库根相对路径读写 `ci-artifacts/` 等),解释器用 `.venv`: + `& '.venv\Scripts\python.exe' test/host/bench/ftp/ftp_test.py --help` +- **台架地址只改一处**:设备 IP / 网关 / PC 对端 IP 全在 `bench_defaults.py`;下面的脚本 + 从**上两级目录**(`bench/`)把它补进 `sys.path` 后再 import,所以脚本自己放在哪个域子目录都不影响。 + `test/host/cal/`、`scripts/board_ui_nav.py`、`MDK-ARM/*.py` 也依赖同一份真源, + 挪 `bench_defaults.py` 时这几处的 `sys.path` 要一起改。 +- **需要真机的脚本**在缺参数时会以 rc=2 退出(argparse 用法错误),这是「可用」而非失败; + 只有 `ModuleNotFoundError` / `ImportError` / `SyntaxError` 才算坏。 +- 输出约定:纯 ASCII stdout,可直接重定向归档为台架证据;退出码 `0` 全过 / `1` 有失败 / + `2` 用法或连接错误。 + +## 加新脚本往哪放 + +按**被验对象**选域子目录;跨域共用的连接默认值只往 `bench_defaults.py` 加。若新脚本要 +`import bench_defaults`,照抄本目录任一脚本顶部那段 `_BENCH_DIR` 三行 `sys.path` bootstrap(注释写清为什么), +不要靠 `PYTHONPATH` 或调用方的工作目录。 diff --git a/test/host/bench_defaults.py b/test/host/bench/bench_defaults.py similarity index 100% rename from test/host/bench_defaults.py rename to test/host/bench/bench_defaults.py diff --git a/test/host/ftp_abort_probe.py b/test/host/bench/ftp/ftp_abort_probe.py similarity index 91% rename from test/host/ftp_abort_probe.py rename to test/host/bench/ftp/ftp_abort_probe.py index aa5f89cf..fe1aec58 100644 --- a/test/host/ftp_abort_probe.py +++ b/test/host/bench/ftp/ftp_abort_probe.py @@ -16,10 +16,17 @@ # = protocol boundary, still reported as success) # SUMMARY rounds= pass= fail= # Exit 0 all rounds pass, 1 otherwise. -import argparse, hashlib, io, random, re, socket, struct, sys, time +import argparse, hashlib, io, os, random, re, socket, struct, sys, time from ftplib import FTP, all_errors -import bench_defaults # 台架连接默认值单一真源 +# 台架连接默认值单一真源已随域归档到 test/host/bench/bench_defaults.py: +# Python 的 sys.path[0] 是**脚本自身所在目录**,本脚本在 bench/<域>/ 下直接 +# `import bench_defaults` 会 ModuleNotFoundError —— 先把 bench/ 补进 sys.path。 +_BENCH_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__))) +if _BENCH_DIR not in sys.path: + sys.path.insert(0, _BENCH_DIR) + +import bench_defaults # noqa: E402 (台架连接默认值单一真源) def log(m): sys.stdout.write(m + "\n"); sys.stdout.flush() diff --git a/test/host/ftp_auth_bench.py b/test/host/bench/ftp/ftp_auth_bench.py similarity index 93% rename from test/host/ftp_auth_bench.py rename to test/host/bench/ftp/ftp_auth_bench.py index 7c0d1e2b..fbccfb52 100644 --- a/test/host/ftp_auth_bench.py +++ b/test/host/bench/ftp/ftp_auth_bench.py @@ -26,6 +26,7 @@ 创建日期:2026-10-11 """ +import os import argparse import io import socket @@ -33,7 +34,14 @@ import sys import time from ftplib import FTP, error_perm -import bench_defaults # 台架连接默认值单一真源 +# 台架连接默认值单一真源已随域归档到 test/host/bench/bench_defaults.py: +# Python 的 sys.path[0] 是**脚本自身所在目录**,本脚本在 bench/<域>/ 下直接 +# `import bench_defaults` 会 ModuleNotFoundError —— 先把 bench/ 补进 sys.path。 +_BENCH_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__))) +if _BENCH_DIR not in sys.path: + sys.path.insert(0, _BENCH_DIR) + +import bench_defaults # noqa: E402 (台架连接默认值单一真源) LOCK_WAIT_S = 62 # 固件锁定 60 s + 余量 diff --git a/test/host/ftp_capture.py b/test/host/bench/ftp/ftp_capture.py similarity index 100% rename from test/host/ftp_capture.py rename to test/host/bench/ftp/ftp_capture.py diff --git a/test/host/ftp_integrity_test.py b/test/host/bench/ftp/ftp_integrity_test.py similarity index 89% rename from test/host/ftp_integrity_test.py rename to test/host/bench/ftp/ftp_integrity_test.py index f86bef31..1c3a80fa 100644 --- a/test/host/ftp_integrity_test.py +++ b/test/host/bench/ftp/ftp_integrity_test.py @@ -18,6 +18,7 @@ TSL(读 0.4us / 写 0.2us)。本仓 ch395f_write_send_buf / ch395f_read_recv 并自动二次回读以区分"存储副本错(写路径/上传)"与"回读瞬时错(读路径)"。 """ +import os import argparse import hashlib import io @@ -26,7 +27,14 @@ import sys import time from ftplib import FTP, error_perm -import bench_defaults # 台架连接默认值单一真源 +# 台架连接默认值单一真源已随域归档到 test/host/bench/bench_defaults.py: +# Python 的 sys.path[0] 是**脚本自身所在目录**,本脚本在 bench/<域>/ 下直接 +# `import bench_defaults` 会 ModuleNotFoundError —— 先把 bench/ 补进 sys.path。 +_BENCH_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__))) +if _BENCH_DIR not in sys.path: + sys.path.insert(0, _BENCH_DIR) + +import bench_defaults # noqa: E402 (台架连接默认值单一真源) NAME = "e12a.bin" # 8.3 短名(FatFs FF_USE_LFN=0) diff --git a/test/host/ftp_list_fill_test.py b/test/host/bench/ftp/ftp_list_fill_test.py similarity index 90% rename from test/host/ftp_list_fill_test.py rename to test/host/bench/ftp/ftp_list_fill_test.py index bc4163be..ea6ce94b 100644 --- a/test/host/ftp_list_fill_test.py +++ b/test/host/bench/ftp/ftp_list_fill_test.py @@ -22,12 +22,20 @@ break 并回 -1,cmd_list 据此回 **550**——目录一大,客户端拿到 条目时更小也能触发,取 26 保证空目录也能越过一块。 """ +import os import argparse import io import sys from ftplib import FTP, all_errors -import bench_defaults # 台架连接默认值单一真源 +# 台架连接默认值单一真源已随域归档到 test/host/bench/bench_defaults.py: +# Python 的 sys.path[0] 是**脚本自身所在目录**,本脚本在 bench/<域>/ 下直接 +# `import bench_defaults` 会 ModuleNotFoundError —— 先把 bench/ 补进 sys.path。 +_BENCH_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__))) +if _BENCH_DIR not in sys.path: + sys.path.insert(0, _BENCH_DIR) + +import bench_defaults # noqa: E402 (台架连接默认值单一真源) HOST = bench_defaults.DEVICE_IP PORT = 21 diff --git a/test/host/ftp_regression.py b/test/host/bench/ftp/ftp_regression.py similarity index 89% rename from test/host/ftp_regression.py rename to test/host/bench/ftp/ftp_regression.py index 676aa224..64578393 100644 --- a/test/host/ftp_regression.py +++ b/test/host/bench/ftp/ftp_regression.py @@ -15,13 +15,21 @@ net 层当作"刚建立就断开"释放。修复见 net_socket.c handle_disconne & '.venv\\Scripts\\python.exe' test/host/ftp_regression.py --host <设备IP> """ +import os import argparse import io import sys import time from ftplib import FTP -import bench_defaults # 台架连接默认值单一真源 +# 台架连接默认值单一真源已随域归档到 test/host/bench/bench_defaults.py: +# Python 的 sys.path[0] 是**脚本自身所在目录**,本脚本在 bench/<域>/ 下直接 +# `import bench_defaults` 会 ModuleNotFoundError —— 先把 bench/ 补进 sys.path。 +_BENCH_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__))) +if _BENCH_DIR not in sys.path: + sys.path.insert(0, _BENCH_DIR) + +import bench_defaults # noqa: E402 (台架连接默认值单一真源) SMALL = b"D20-small-" + b"A" * 1017 # 1024B BIG = bytes(((i * 7 + 3) & 0xFF) for i in range(32768)) # 32KB 模式数据 diff --git a/test/host/ftp_speed_test.py b/test/host/bench/ftp/ftp_speed_test.py similarity index 95% rename from test/host/ftp_speed_test.py rename to test/host/bench/ftp/ftp_speed_test.py index b1bf3793..109666ca 100644 --- a/test/host/ftp_speed_test.py +++ b/test/host/bench/ftp/ftp_speed_test.py @@ -12,7 +12,14 @@ import re import argparse import os -import bench_defaults # 台架连接默认值单一真源 +# 台架连接默认值单一真源已随域归档到 test/host/bench/bench_defaults.py: +# Python 的 sys.path[0] 是**脚本自身所在目录**,本脚本在 bench/<域>/ 下直接 +# `import bench_defaults` 会 ModuleNotFoundError —— 先把 bench/ 补进 sys.path。 +_BENCH_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__))) +if _BENCH_DIR not in sys.path: + sys.path.insert(0, _BENCH_DIR) + +import bench_defaults # noqa: E402 (台架连接默认值单一真源) HOST = bench_defaults.DEVICE_IP PORT = 21 diff --git a/test/host/ftp_test.py b/test/host/bench/ftp/ftp_test.py similarity index 93% rename from test/host/ftp_test.py rename to test/host/bench/ftp/ftp_test.py index 649155c9..6ef33574 100644 --- a/test/host/ftp_test.py +++ b/test/host/bench/ftp/ftp_test.py @@ -5,12 +5,20 @@ FTP Server 测试脚本 — 连接 STM32F4 上的 lftpd 服务器 用法:python ftp_test.py [--host <设备IP>] [--port 21] [--user admin] [--password admin] """ +import os import socket import sys import time import argparse -import bench_defaults # 台架连接默认值单一真源 +# 台架连接默认值单一真源已随域归档到 test/host/bench/bench_defaults.py: +# Python 的 sys.path[0] 是**脚本自身所在目录**,本脚本在 bench/<域>/ 下直接 +# `import bench_defaults` 会 ModuleNotFoundError —— 先把 bench/ 补进 sys.path。 +_BENCH_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__))) +if _BENCH_DIR not in sys.path: + sys.path.insert(0, _BENCH_DIR) + +import bench_defaults # noqa: E402 (台架连接默认值单一真源) HOST = bench_defaults.DEVICE_IP PORT = 21 diff --git a/test/host/ftp_up_dl_test.py b/test/host/bench/ftp/ftp_up_dl_test.py similarity index 95% rename from test/host/ftp_up_dl_test.py rename to test/host/bench/ftp/ftp_up_dl_test.py index 9a199c66..c68e7d52 100644 --- a/test/host/ftp_up_dl_test.py +++ b/test/host/bench/ftp/ftp_up_dl_test.py @@ -12,7 +12,14 @@ import re import argparse import os -import bench_defaults # 台架连接默认值单一真源 +# 台架连接默认值单一真源已随域归档到 test/host/bench/bench_defaults.py: +# Python 的 sys.path[0] 是**脚本自身所在目录**,本脚本在 bench/<域>/ 下直接 +# `import bench_defaults` 会 ModuleNotFoundError —— 先把 bench/ 补进 sys.path。 +_BENCH_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__))) +if _BENCH_DIR not in sys.path: + sys.path.insert(0, _BENCH_DIR) + +import bench_defaults # noqa: E402 (台架连接默认值单一真源) HOST = bench_defaults.DEVICE_IP PORT = 21 diff --git a/test/host/n30_repro.py b/test/host/bench/ftp/n30_repro.py similarity index 83% rename from test/host/n30_repro.py rename to test/host/bench/ftp/n30_repro.py index 7dd2501e..bb242701 100644 --- a/test/host/n30_repro.py +++ b/test/host/bench/ftp/n30_repro.py @@ -1,12 +1,20 @@ # relisten 沉降段原语化受阻的确定性复现:连续快速 STOR(无间隔),统计 425/超时失败次数 # 用法: python n30_repro.py [--host IP] [--user U --pwd P] [--n 10] [--size 1024] # 退出码: 0=全部成功 / 1=有失败 / 2=连接错误 +import os import argparse import io import sys from ftplib import FTP, error_temp, error_perm -import bench_defaults # 台架连接默认值单一真源 +# 台架连接默认值单一真源已随域归档到 test/host/bench/bench_defaults.py: +# Python 的 sys.path[0] 是**脚本自身所在目录**,本脚本在 bench/<域>/ 下直接 +# `import bench_defaults` 会 ModuleNotFoundError —— 先把 bench/ 补进 sys.path。 +_BENCH_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__))) +if _BENCH_DIR not in sys.path: + sys.path.insert(0, _BENCH_DIR) + +import bench_defaults # noqa: E402 (台架连接默认值单一真源) def main(): diff --git a/test/host/iec104_master.py b/test/host/bench/iec104/iec104_master.py similarity index 98% rename from test/host/iec104_master.py rename to test/host/bench/iec104/iec104_master.py index 0e89e3c8..bcb5fe04 100644 --- a/test/host/iec104_master.py +++ b/test/host/bench/iec104/iec104_master.py @@ -47,13 +47,21 @@ bench leg, firmware side App/cfg/prot_set_store.c): setpoint (save), reset, read it back (literal "setpoint hold" proof, distinguishable from factory default), restore. """ +import sys +import os import argparse import collections -import bench_defaults # 台架连接默认值单一真源 +# 台架连接默认值单一真源已随域归档到 test/host/bench/bench_defaults.py: +# Python 的 sys.path[0] 是**脚本自身所在目录**,本脚本在 bench/<域>/ 下直接 +# `import bench_defaults` 会 ModuleNotFoundError —— 先把 bench/ 补进 sys.path。 +_BENCH_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__))) +if _BENCH_DIR not in sys.path: + sys.path.insert(0, _BENCH_DIR) + +import bench_defaults # noqa: E402 (台架连接默认值单一真源) import socket import struct -import sys import time # ---- constants (mirror iec104_asdu.h / iec104_link.h) ----------------------- diff --git a/test/host/test_iec104_master_rx.py b/test/host/bench/iec104/test_iec104_master_rx.py similarity index 98% rename from test/host/test_iec104_master_rx.py rename to test/host/bench/iec104/test_iec104_master_rx.py index 0fb7c7ef..7ca06565 100644 --- a/test/host/test_iec104_master_rx.py +++ b/test/host/bench/iec104/test_iec104_master_rx.py @@ -19,7 +19,7 @@ cause value 16..23 would collide with RBT=1. The firmware never sets RBT on TX (iec104_link.c passes cot_hi=0/0x40 only); proper fix belongs to the standard COT=2 rework (registry: 104 ASDU head in-house-COT1 compression), not this task. -Usage: python test/host/test_iec104_master_rx.py [-v] +Usage: python test/host/bench/iec104/test_iec104_master_rx.py [-v] Exit code: 0 = all PASS. Created 2026-10-25 (lane-d, task-21). """ diff --git a/test/host/ch395f_reuse_host.py b/test/host/bench/net/ch395f_reuse_host.py similarity index 91% rename from test/host/ch395f_reuse_host.py rename to test/host/bench/net/ch395f_reuse_host.py index 7e8d212e..cb25be5d 100644 --- a/test/host/ch395f_reuse_host.py +++ b/test/host/bench/net/ch395f_reuse_host.py @@ -5,13 +5,21 @@ # ①污染:连上发 3000B 后 RST(SO_LINGER 0,TRAP-NET-18 中止形态); # ②载荷:立即重连发 4096B 图案(pat[i]=(seed+i)&0xFF, seed=(rg*97+13)&0xFF)后 FIN。 # 端口 5100+rg,rg=0..(3*rounds-1),变体顺序 A/B/C(与固件 bench 表一致)。 +import os import argparse import socket import struct import sys import time -import bench_defaults # 台架连接默认值单一真源 +# 台架连接默认值单一真源已随域归档到 test/host/bench/bench_defaults.py: +# Python 的 sys.path[0] 是**脚本自身所在目录**,本脚本在 bench/<域>/ 下直接 +# `import bench_defaults` 会 ModuleNotFoundError —— 先把 bench/ 补进 sys.path。 +_BENCH_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__))) +if _BENCH_DIR not in sys.path: + sys.path.insert(0, _BENCH_DIR) + +import bench_defaults # noqa: E402 (台架连接默认值单一真源) # {idx: (tx_len, close_mode)} 与固件表一致 VARS = { diff --git a/test/host/ch395f_socket_test.py b/test/host/bench/net/ch395f_socket_test.py similarity index 99% rename from test/host/ch395f_socket_test.py rename to test/host/bench/net/ch395f_socket_test.py index bda6c800..822881c8 100644 --- a/test/host/ch395f_socket_test.py +++ b/test/host/bench/net/ch395f_socket_test.py @@ -63,7 +63,14 @@ import string import zlib from datetime import datetime -import bench_defaults # 台架连接默认值单一真源 +# 台架连接默认值单一真源已随域归档到 test/host/bench/bench_defaults.py: +# Python 的 sys.path[0] 是**脚本自身所在目录**,本脚本在 bench/<域>/ 下直接 +# `import bench_defaults` 会 ModuleNotFoundError —— 先把 bench/ 补进 sys.path。 +_BENCH_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__))) +if _BENCH_DIR not in sys.path: + sys.path.insert(0, _BENCH_DIR) + +import bench_defaults # noqa: E402 (台架连接默认值单一真源) # TCP 回显服务器(tcp_server 模式)参数 INTER_ACCEPT_TIMEOUT = 60 # 首个连接后,等待下一个连接的超时秒数 diff --git a/test/host/e11_keepalive_probe.py b/test/host/bench/net/e11_keepalive_probe.py similarity index 93% rename from test/host/e11_keepalive_probe.py rename to test/host/bench/net/e11_keepalive_probe.py index d2b6aec4..8afc767b 100644 --- a/test/host/e11_keepalive_probe.py +++ b/test/host/bench/net/e11_keepalive_probe.py @@ -24,13 +24,21 @@ App/ 无任何 net_connect() → 产品上 keepalive 实际关闭。本脚本用 需要管理员权限(仅 block 模式装/卸防火墙规则;脚本自行清理)。 """ +import os import argparse import socket import subprocess import sys import time -import bench_defaults # 台架连接默认值单一真源 +# 台架连接默认值单一真源已随域归档到 test/host/bench/bench_defaults.py: +# Python 的 sys.path[0] 是**脚本自身所在目录**,本脚本在 bench/<域>/ 下直接 +# `import bench_defaults` 会 ModuleNotFoundError —— 先把 bench/ 补进 sys.path。 +_BENCH_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__))) +if _BENCH_DIR not in sys.path: + sys.path.insert(0, _BENCH_DIR) + +import bench_defaults # noqa: E402 (台架连接默认值单一真源) TAG_C, TAG_D = 0xAA, 0xBB CMD_KEEPLIVE = 0 diff --git a/test/host/e6_soak.py b/test/host/bench/net/e6_soak.py similarity index 87% rename from test/host/e6_soak.py rename to test/host/bench/net/e6_soak.py index 585147c1..c31b2807 100644 --- a/test/host/e6_soak.py +++ b/test/host/bench/net/e6_soak.py @@ -19,8 +19,10 @@ import subprocess import sys import time -ROOT = os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__)))) -STRESS = os.path.join(ROOT, "test", "host", "relisten_stress.py") +# 本脚本归档在 test/host/bench/net/:向上 5 级才到仓库根(多出 bench/ 与域目录两层)。 +ROOT = os.path.dirname(os.path.dirname(os.path.dirname(os.path.dirname(os.path.dirname( + os.path.abspath(__file__)))))) +STRESS = os.path.join(ROOT, "test", "host", "bench", "net", "relisten_stress.py") def log(msg): diff --git a/test/host/latency_peer.py b/test/host/bench/net/latency_peer.py similarity index 98% rename from test/host/latency_peer.py rename to test/host/bench/net/latency_peer.py index 0656a871..1004c46a 100644 --- a/test/host/latency_peer.py +++ b/test/host/bench/net/latency_peer.py @@ -24,6 +24,7 @@ Usage: Pure stdlib (socket/json/time/argparse/threading). ASCII output only. """ +import os import argparse import json import socket @@ -31,7 +32,14 @@ import sys import threading import time -import bench_defaults # 台架连接默认值单一真源 +# 台架连接默认值单一真源已随域归档到 test/host/bench/bench_defaults.py: +# Python 的 sys.path[0] 是**脚本自身所在目录**,本脚本在 bench/<域>/ 下直接 +# `import bench_defaults` 会 ModuleNotFoundError —— 先把 bench/ 补进 sys.path。 +_BENCH_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__))) +if _BENCH_DIR not in sys.path: + sys.path.insert(0, _BENCH_DIR) + +import bench_defaults # noqa: E402 (台架连接默认值单一真源) # --- Protocol constants (mirror test/board/net_latency_test.c Phase 13 defines) --- HELLO = b"\x5a\xa5\x58\x01" diff --git a/test/host/pasv_probe.py b/test/host/bench/net/pasv_probe.py similarity index 89% rename from test/host/pasv_probe.py rename to test/host/bench/net/pasv_probe.py index fc10fe63..b0bc6505 100644 --- a/test/host/pasv_probe.py +++ b/test/host/bench/net/pasv_probe.py @@ -14,13 +14,21 @@ Usage: python pasv_probe.py --rounds 5 --delay 2 # reproduce (fast rounds) python pasv_probe.py --rounds 3 --delay 35 # TIME_WAIT window test """ +import os import argparse import re import socket import sys import time -import bench_defaults # 台架连接默认值单一真源 +# 台架连接默认值单一真源已随域归档到 test/host/bench/bench_defaults.py: +# Python 的 sys.path[0] 是**脚本自身所在目录**,本脚本在 bench/<域>/ 下直接 +# `import bench_defaults` 会 ModuleNotFoundError —— 先把 bench/ 补进 sys.path。 +_BENCH_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__))) +if _BENCH_DIR not in sys.path: + sys.path.insert(0, _BENCH_DIR) + +import bench_defaults # noqa: E402 (台架连接默认值单一真源) IP_DEFAULT = bench_defaults.DEVICE_IP diff --git a/test/host/relisten_stress.py b/test/host/bench/net/relisten_stress.py similarity index 83% rename from test/host/relisten_stress.py rename to test/host/bench/net/relisten_stress.py index 518d39d7..8b8c376d 100644 --- a/test/host/relisten_stress.py +++ b/test/host/bench/net/relisten_stress.py @@ -11,12 +11,20 @@ Usage: python relisten_stress.py --port 7003 --n 20 --gap-ms 0 --hold-ms 50 Exit codes: 0 = zero refusals / 1 = refusals seen / 2 = usage. """ +import os import argparse import socket import sys import time -import bench_defaults # 台架连接默认值单一真源 +# 台架连接默认值单一真源已随域归档到 test/host/bench/bench_defaults.py: +# Python 的 sys.path[0] 是**脚本自身所在目录**,本脚本在 bench/<域>/ 下直接 +# `import bench_defaults` 会 ModuleNotFoundError —— 先把 bench/ 补进 sys.path。 +_BENCH_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__))) +if _BENCH_DIR not in sys.path: + sys.path.insert(0, _BENCH_DIR) + +import bench_defaults # noqa: E402 (台架连接默认值单一真源) def main(): diff --git a/test/host/udp_queue_bench.py b/test/host/bench/net/udp_queue_bench.py similarity index 99% rename from test/host/udp_queue_bench.py rename to test/host/bench/net/udp_queue_bench.py index 21f5d731..f6857e1c 100644 --- a/test/host/udp_queue_bench.py +++ b/test/host/bench/net/udp_queue_bench.py @@ -9,7 +9,7 @@ DHCP 地址,与 net_test_task.h 的 TEST_PC_PEER_IP 不一定一致,服务 不需要 PC 侧固定 IP。 跑法(板子烧好阶段 16 固件后): - python test/host/udp_queue_bench.py --board 192.168.31.100 + python test/host/bench/net/udp_queue_bench.py --board 192.168.31.100 # 可选:--first-wait 180 等板子重启;--late 12 调迟发时刻 判读:每步打印 [PASS]/[FAIL],末尾一行 diff --git a/test/host/udp_queue_bench_loopback.py b/test/host/bench/net/udp_queue_bench_loopback.py similarity index 99% rename from test/host/udp_queue_bench_loopback.py rename to test/host/bench/net/udp_queue_bench_loopback.py index e60cf114..b0ef64bf 100644 --- a/test/host/udp_queue_bench_loopback.py +++ b/test/host/bench/net/udp_queue_bench_loopback.py @@ -10,7 +10,7 @@ 3. 回显超过芯片发送缓冲(1KB)时按 1024 拆成多个数据报发出(NET_SEND_CHUNK_MAX)。 用法(在本仓库根目录): - python test/host/udp_queue_bench_loopback.py + python test/host/bench/net/udp_queue_bench_loopback.py 退出码:0 = 对端脚本判定逻辑全绿;1 = 有问题,先别上台架。 """ diff --git a/test/host/remolcd_pull_test.py b/test/host/bench/screenlink/remolcd_pull_test.py similarity index 94% rename from test/host/remolcd_pull_test.py rename to test/host/bench/screenlink/remolcd_pull_test.py index 6d85ad7c..12639eda 100644 --- a/test/host/remolcd_pull_test.py +++ b/test/host/bench/screenlink/remolcd_pull_test.py @@ -33,13 +33,21 @@ 设计依据:docs/子系统设计/屏板链路设计.md §9.1(双通道并发)。 创建日期:2026-10-30 """ +import os import argparse import socket import struct import sys import time -import bench_defaults # 台架连接默认值单一真源 +# 台架连接默认值单一真源已随域归档到 test/host/bench/bench_defaults.py: +# Python 的 sys.path[0] 是**脚本自身所在目录**,本脚本在 bench/<域>/ 下直接 +# `import bench_defaults` 会 ModuleNotFoundError —— 先把 bench/ 补进 sys.path。 +_BENCH_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__))) +if _BENCH_DIR not in sys.path: + sys.path.insert(0, _BENCH_DIR) + +import bench_defaults # noqa: E402 (台架连接默认值单一真源) DEFAULT_IP = bench_defaults.DEVICE_IP DEFAULT_PORT = 7003 diff --git a/test/host/screenlink_bench.py b/test/host/bench/screenlink/screenlink_bench.py similarity index 97% rename from test/host/screenlink_bench.py rename to test/host/bench/screenlink/screenlink_bench.py index 70ddce14..ee2a50c1 100644 --- a/test/host/screenlink_bench.py +++ b/test/host/bench/screenlink/screenlink_bench.py @@ -31,9 +31,9 @@ **另一路 TTL 口**(台架上通常是 COM6)——两者互不相干,可同时跑。 用法(仓库根目录): - & '.venv\\Scripts\\python.exe' test/host/screenlink_bench.py --port COM6 --seconds 30 - & '.venv\\Scripts\\python.exe' test/host/screenlink_bench.py --port COM6 --seconds 600 # 10 min 判据 - & '.venv\\Scripts\\python.exe' test/host/screenlink_bench.py --port COM6 --reply --dump lcd.pbm + & '.venv\\Scripts\\python.exe' test/host/bench/screenlink/screenlink_bench.py --port COM6 --seconds 30 + & '.venv\\Scripts\\python.exe' test/host/bench/screenlink/screenlink_bench.py --port COM6 --seconds 600 # 10 min 判据 + & '.venv\\Scripts\\python.exe' test/host/bench/screenlink/screenlink_bench.py --port COM6 --reply --dump lcd.pbm --key N 每 N 个周期把召唤帧换成按键帧(键值在 1/2/3/4/7/8/9 里轮换;0 = 不发按键帧) --reply 每帧收应答并校验(长度 / CRC / 填充一致) --dump P 把最后一帧应答的点阵存成 PBM(P4,160x160,可直接看) diff --git a/test/host/wave_read.py b/test/host/bench/wave/wave_read.py similarity index 98% rename from test/host/wave_read.py rename to test/host/bench/wave/wave_read.py index aa2e18ef..7be3f99e 100644 --- a/test/host/wave_read.py +++ b/test/host/bench/wave/wave_read.py @@ -2,7 +2,7 @@ # -*- coding: utf-8 -*- """PC-side fault-recording (wave) segment reader: dump / fft / shape / plot. -Pure stdlib. Style sibling: test/host/iec104_master.py (same family: +Pure stdlib. Style sibling: test/host/bench/iec104/iec104_master.py (same family: argparse subcommands, explicit exit codes, ASCII-only stdout). This file and App/algo/wave_store.c are TWO INDEPENDENT implementations of @@ -61,12 +61,12 @@ Exit codes: 0 = ok (all checks pass) / 1 = integrity reject or check FAIL / 2 = usage or IO error. Usage: - python test/host/wave_read.py dump ci-artifacts/WAVE.BIN - python test/host/wave_read.py fft ci-artifacts/WAVE.BIN --all - python test/host/wave_read.py shape ci-artifacts/WAVE.BIN --strict - python test/host/wave_read.py shape ci-artifacts/WAVE.BIN --strict --clip-superset - python test/host/wave_read.py plot ci-artifacts/WAVE.BIN --ch 0 - python test/host/wave_read.py --selftest + python test/host/bench/wave/wave_read.py dump ci-artifacts/WAVE.BIN + python test/host/bench/wave/wave_read.py fft ci-artifacts/WAVE.BIN --all + python test/host/bench/wave/wave_read.py shape ci-artifacts/WAVE.BIN --strict + python test/host/bench/wave/wave_read.py shape ci-artifacts/WAVE.BIN --strict --clip-superset + python test/host/bench/wave/wave_read.py plot ci-artifacts/WAVE.BIN --ch 0 + python test/host/bench/wave/wave_read.py --selftest SPEC CONFORMANCE (design doc sections 6.2 + 6.3, lead ruling 2026-10-29 answering the PC-track nine-question list; this decoder and @@ -799,8 +799,9 @@ def svg_for_channel(seg, ci, seg_label): def default_outdir(): - root = os.path.dirname(os.path.dirname(os.path.dirname( - os.path.abspath(__file__)))) + # 本脚本归档在 test/host/bench/wave/:向上 5 级才到仓库根(多出 bench/ 与域目录两层)。 + root = os.path.dirname(os.path.dirname(os.path.dirname(os.path.dirname( + os.path.dirname(os.path.abspath(__file__)))))) return os.path.join(root, "ci-artifacts") diff --git a/test/host/cal/cal_write.py b/test/host/cal/cal_write.py index 0b11f7e5..5cee1392 100644 --- a/test/host/cal/cal_write.py +++ b/test/host/cal/cal_write.py @@ -2,15 +2,15 @@ # -*- coding: utf-8 -*- """两点标定写入器:C_SE_NC_1 两段写下发 r/b,C_RD 读回复核。 -复用台架已验收主站库 test/host/iec104_master.py(不重写协议层)。 +复用台架已验收主站库 test/host/bench/iec104/iec104_master.py(不重写协议层)。 地址(App/algo/run_par.c run_par_104_write):r = 0x8050+slot, b = 0x8048+slot;slot UA0/UN3/IA4。执行卡: docs/测试说明/专项验证/ADC多点标定执行流程.md §4。 用法: - python test/host/cal_write.py --r 0x8050=995.99 --b 0x8048=-1 \ + python test/host/cal/cal_write.py --r 0x8050=995.99 --b 0x8048=-1 \ --read 0x8050,0x8048 --expect 995.99,-1 - python test/host/cal_write.py --read 0x8050,0x8054 --expect 995.99,29.52 + python test/host/cal/cal_write.py --read 0x8050,0x8054 --expect 995.99,29.52 写入顺序刻意**先 r 后 b**:b 走 adc_cal_set() 置 VALID 位,而 VALID 要求 r 已在带——先让 r 就位,语义干净。--b 必须是整数码值。 @@ -21,7 +21,14 @@ import argparse import os import sys -sys.path.insert(0, os.path.dirname(os.path.abspath(__file__))) +# 依赖已随域归档:bench_defaults 在 test/host/bench/,iec104_master 在 +# test/host/bench/iec104/。两者都要补进 sys.path(Python 默认只加脚本目录)。 +_BENCH_DIR = os.path.join(os.path.dirname(os.path.abspath(__file__)), + os.pardir, "bench") +for _p in (os.path.abspath(_BENCH_DIR), + os.path.abspath(os.path.join(_BENCH_DIR, "iec104"))): + if _p not in sys.path: + sys.path.insert(0, _p) import bench_defaults # noqa: E402 import iec104_master as m104 # noqa: E402 diff --git a/test/host/iec104/stub/dbg_log.h b/test/host/iec104/stub/dbg_log.h deleted file mode 100644 index 3b60ea04..00000000 --- a/test/host/iec104/stub/dbg_log.h +++ /dev/null @@ -1,20 +0,0 @@ -/* - * 主机侧单测桩:dbg_log.h(IEC104 套件专用) - * 模块功能:为运行参数段起纳入本 TU 的 cfg_file.c / adc_cal.c / run_par.c 提供 - * 主机可编译的日志宏(映射为计数)。⚠ 仅供 test/host/iec104/ 使用, - * 不参与 MCU 构建。模式同 test/host/adc_cal/stub/ 先例。 - * 创建日期:2026-10-25(道D 运行参数段) - */ - -#ifndef DBG_LOG_H -#define DBG_LOG_H - -extern int g_dbgstub104_err_count; -extern int g_dbgstub104_info_count; -extern int g_dbgstub104_debug_count; - -#define DBG_INFO(fmt, ...) do { g_dbgstub104_info_count++; } while (0) -#define DBG_DEBUG(fmt, ...) do { g_dbgstub104_debug_count++; } while (0) -#define DBG_ERROR(fmt, ...) do { g_dbgstub104_err_count++; } while (0) - -#endif /* DBG_LOG_H */ diff --git a/test/host/wave_store/run_unit_test.py b/test/host/wave_store/run_unit_test.py index 40b18aa8..c157cd2b 100644 --- a/test/host/wave_store/run_unit_test.py +++ b/test/host/wave_store/run_unit_test.py @@ -8,7 +8,7 @@ 整段长度等式(32 + 16*ch + pts*ch*2 + 2 == 5282)、段头编解码往返、拒绝清单、 按通道分列的偏移换算、打包游标三段推进与四条拒绝路径、自产字节自检、段文件名 轮转与反解,失败即非 0 退出。零硬件、零烧录、毫秒级。顺带把一段合成段写到 %TEMP% - 供 PC 侧读段脚本(test/host/wave_read.py)做只读互验(不参与判定)。 + 供 PC 侧读段脚本(test/host/bench/wave/wave_read.py)做只读互验(不参与判定)。 工具链探测 / 编译运行全部委托 test/host/common/unit_test_harness.py。 为什么要主机侧单测(而不是只等台架): diff --git a/test/host/wave_trig/wave_trig_test.c b/test/host/wave_trig/wave_trig_test.c index bcdc76cc..8617522f 100644 --- a/test/host/wave_trig/wave_trig_test.c +++ b/test/host/wave_trig/wave_trig_test.c @@ -667,7 +667,7 @@ int main(void) { /* 形态在日志里说清楚:本套给的是本波(V0.1 未标定)真值形态 */ printf("[INFO] 互验产物(本波真值形态:avail 0x00 / 0x02,逐路有效位图全零;" "信号形态 = 三路 50 Hz 正弦(UA / UN / IA)+ 三路方波(UB / UC / IN)+ 两路满幅斜坡(IB / IC)," - "供 test/host/wave_read.py dump/shape/fft 只读校验):%s\n", + "供 test/host/bench/wave/wave_read.py dump/shape/fft 只读校验):%s\n", path); } else { printf("[INFO] 打不开临时目录文件,跳过互验产物\n");