Files
STM32F4-Base/test/host/bench
wandering1 84c5a5d92a fix(docs): 修 16 处指向已删文件的历史指针,别让读者照着找空门
上一笔改名把 App/protocol/iec104 搬到 App/iec60870/104_port 时,机械
文本替换把「讲一个已经删掉的文件当初做什么」的叙述也一起改了:

  iec104_pts.c  / iec104_asdu.c  / iec104_link.c

这三个文件在 90cc9a7d 里就删了(旧自研协议层整体退役),
App/iec60870/104_port/ 下从来没有它们。于是文档与注释里出现了一批
「新路径 + 旧行为」的混合描述,读者按图索骥只会撞空。

按两类分别处理,共 11 个文件(只有注释与 Markdown,零代码行):

一、讲历史事实的 -> 写回当时真实的旧名,就近标「已删除」
  App/task/ui_task.c            SYSLOG_OPER 那条原写入点
  App/algo/run_par.h            104 消费侧每拍读取
  Drivers/BSP/UI/ui_data.h      YX_DP_N / 遥控记录两条
  Drivers/BSP/UI/ui_page_oper.c 操作页写入点
  Drivers/BSP/UI/ui_page_reset.c 复归串与远端那条刻意不同
  Drivers/BSP/UI/ui_page_yk.c   遥控页写入点
  Drivers/BSP/UI/ui_data.c      CP56 正反两套实现同族
  test/host/ui_data/ui_data_test.c  两处历史注释
  simulator/main.c              双点位图固定帧的来历
  App/log/README.md             oper.log / yk.log 生产者
  docs/UI设计/UI_数据供给设计.md
  docs/UI设计/页面扩充详细方案.md
  docs/产品需求/产品需求设计文档.md  链路层与点表实现指针

二、讲现在仍活着的接缝的 -> 指向真实存在的文件,并 test -f 过
  App/algo/run_par.h:23  死区分流现由 iec104_dtu_table.c +
                         iec104_source.c 承担
  App/algo/meas.h        数值口径改指 common/IEC60870_InformationObjects.h
                         的 IEC60870_ASDU_QUALITY_*;顺带修掉同句里两个
                         既有错:引用了不存在的 test/host/iec104/,
                         且 104 当前消费点是 iec104_serv.c 的 s_measure()
  test/host/bench/iec104/iec104_master.py  常量与帧头说明改指
                         common/IEC60870_Asdu.c 与 104/IEC104_Types.h

App/task/iec104_serv.c 单独说明:文件还在但 s_clock_sync() 已随新契约
消失(grep RC=1),所以写「同日重写后不再投递」,不写「已删除」。

验证:grep 新假路径零命中;旧真名 14 处全部带删除标注;check_bom_drift
RC=0(6 个带 BOM 文件按原始字节补回,未过文本编解码);check_mojibake
RC=0;check_coding_standard 逐文件 RC=0;doc-links 308 篇 / 30 处问题
全部仍在 IEC60870-Slave 供应商快照内,非 vendor 计数仍为 0。
2026-11-18 14:32:40 +08:00
..

test/host/bench/ — 台架驱动与探针

一次性台架动作(连板 / 连模拟器 / 连 PC 对端)都住在这里;纯逻辑的主机侧单测在 test/host/<模块>/run_unit_test.py,不在本目录。目录分工的总表见 ../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 或调用方的工作目录。