Files
STM32F4-Base/scripts/check_iec104_tcp.py
T
wandering1 90cc9a7d99 feat(iec104): 把 104 骨架完整迁到 MCU 板端并在台架跑通总召
把 IEC104 从模拟器端整体搬到板端:协议栈原先由独立 iec104Task 驱动,
现在改为 netTask 单 owner 的 threadless 驱动,退役独立任务。

驱动与后端:
- 新增 iec104_net_mcu.c/.h,实现 IEC104_Net.h 的 11 个 ABI 函数,
  用槽表加单调句柄映射 net_socket 的单 fd 模型;CLIENT 拆除只走
  net_drop_conn_locked,绝不 net_close 监听 fd。
- net_socket 增 5 个 owner-only 接口(net_accept_locked、
  net_drop_conn_locked、net_pending_bytes、net_send_try、
  net_mono_now_ms)。
- iec104_serv.c 重写为 iec104_serv_net_tick(),在 netTask 1ms 主循环
  里驱动 core;无 osDelay/阻塞调用,喂狗是第一句。
- Src/freertos.c 删除 iec104Task 三件套,对应栈水位探针表项同步删除。

内存:目标板 192KB SRAM 装不下 vendor 默认容量档,按实测裁剪到
skeleton 档(TCP 缓冲、业务池、SOE 256->128、值槽密集化),
RW_IRAM1 118,408 B / 90.3%,留 2,178 B 余量。

台架修复(只在真硬件暴露):
- SNTP s_ctx.fd 零初始化后为 0,而 net fd 0 是合法槽位下标,
  首次代次变化时误 net_close(0) 关掉 ftpTask 的监听槽,导致 104
  连接被 FTP 的 220 banner 抢走;改为显式 .fd = -1。
- Accept 幂等:单 fd 模型下 vendor 每轮重试 Accept 会拿到同一 fd,
  后端改为会话在役时返 WOULD_BLOCK,Close 不再清槽。

验证:
- Keil 全量重建 0 error 0 warning,uvprojx 零抖动。
- 模拟器真实 TCP 13/13、transport 10/10。
- netmcu 后端单测 13/13(新增 N12)。
- 台架 serial-boot-test required 全中;板端 2404 总召 129 帧收到
  59 遥信(53 有源、全 IV)+ 16 双点 + 30 遥测(PT1 三相非零、
  UN/频率/温度按未标定置 IV)、遥控选择执行全否定、校时 COT 7。
- 期间顺带修正 UI 漂移自检文案、.serialtest required 陈旧项、
  coding-standard 对 vendor 与外部 ABI 名字的排除口径。
2026-11-18 10:29:18 +08:00

102 lines
5.2 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""IEC 104 真实回环验收门禁包装器(manual 阶段专用)。
为什么要这根钩子(2026-11-18):
`test/host/iec104_dtu/` 下有两个 runner,但**只有** `run_unit_test.py` 会被
`scripts/check_test_coverage.py` 的 `rglob("run_unit_test.py")` 发现,而它只跑
7 条 decoder/oracle 用例;真正的产品验收 `run_tcp_test.py`(13 条真实 TCP 回环)
一直**没有**被任何门禁登记。结果是覆盖率表里 `iec104_dtu` 赫然在列,
却让人误以为"104 的验收已经被门禁覆盖了"——这是最容易骗人的那种假象。
本钩子把那 13 条接进门禁,把假象补成真话。
为什么是 `stages: [manual]` 而不是提交期自动跑:
实测全量 14.5 s(把 `--sbo-timeout` 从 30 s 降 2 s 之后;新增 2 条标准参数
用例各约 0.3 s),仍在本仓
"2~4 秒自动门禁"判据之外(见 .pre-commit-config.yaml 里 cppcheck 那段的口径:
一个逼人 --no-verify 的门禁等于没有门禁)。故与 cppcheck / test-coverage 同档,
只在 `scripts/ci_local.py` 的 manual 段与手工复跑时执行。
为什么远端 CI 跑不了它:
`.gitea/workflows/ci.yml` 不构建模拟器(grep `lvgl_sim|build_sim|simulator` 零命中),
而本钩子需要 `simulator/build/Debug/lvgl_sim.exe`。所以它在远端只能靠
"本机有构建产物"这一前提,**远端 CI 不跑它**;这也是它没有进提交期自动门禁的
第二个理由。缺 exe 时本脚本**显式 FAIL 并给出可执行提示,不"跳过当通过"**
(与 uinav-selftest 的缺帧教训同一条:跳过即绿灯,绿灯即遗忘)。
被包装脚本不吃文件参数:
pre-commit 会把本次变更的文件名传给钩子,而 `run_tcp_test.py` 是按"整套 13 条用例"
工作的、不接受文件参数,故本包装器**有意忽略** argv(与 check_ui_golden.py 同形)。
本地手工复跑:
& '.venv\\Scripts\\python.exe' scripts/check_iec104_tcp.py
或只跑一根用例:`python test/host/iec104_dtu/run_tcp_test.py --exe <lvgl_sim.exe> --only test_link_start`
"""
import os
import subprocess
import sys
ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
BUILD_BAT = os.path.join(ROOT, 'simulator', 'build_sim.bat')
EXE = os.path.join(ROOT, 'simulator', 'build', 'Debug', 'lvgl_sim.exe')
# 能力档位边界(2026-11-18 实测,必读):本钩子调 `build_sim.bat`,编出的是
# **vendor 默认容量**(RX 2048 / HIGH 1024 / NORMAL 4096 / RECORD 32 / EVENT 68),
# 不是产品固件实际使用的 P6a 档(RX 256 / HIGH 288 / NORMAL 272 / RECORD 4 / EVENT 11)。
# 因此本钩子证明的是"协议栈在默认容量下行为正确",**不证明 P6a 档**。P6a 的证据是
# `ci-artifacts/iec104-cutover/build_sim_p6a.ps1`(独立 build-p6a 目录注入 5 个宏)
# 加同一 runner 的 13/13 PASS。两者的用例集相同、容量档不同,别拿这一份当另一份。
RUNNER = os.path.join(ROOT, 'test', 'host', 'iec104_dtu', 'run_tcp_test.py')
OUTPUT = os.path.join(ROOT, 'ci-artifacts', 'iec104-tests', 'tcp-gate')
PY = sys.executable
def run(cmd):
"""执行一条命令,透传输出,返回退出码。
参数:cmd - 命令列表 list[str]
返回值:子进程退出码 int
"""
return subprocess.call(cmd, cwd=ROOT)
def main():
"""先增量构建模拟器,再跑 13 条真实 TCP 回环验收。
返回值:0 - 全部用例通过
1 - 构建失败或用例失败
2 - 环境错误(没装 VS / 工具链探测失败),与 pre-commit 的 2 号语义一致
"""
print('[iec104-tcp] 增量构建模拟器 ...')
rc = run([BUILD_BAT])
if rc == 3:
print('[iec104-tcp] 环境错误:模拟器构建找不到 VS 工具链(build_sim.bat 返回 3)。')
print('[iec104-tcp] 这是环境问题、不是本改动的问题;装好 VS 2019/2022/2026 后重跑,')
print('[iec104-tcp] 或临时 SKIP=iec104-tcp 提交(远端 CI 不构建模拟器,本就跑不了这根)。')
return 2
if rc != 0:
print('[iec104-tcp] FAIL 模拟器构建失败(build_sim.bat 返回 %d),无法做回环验收' % rc)
return 1
if not os.path.exists(EXE):
print('[iec104-tcp] FAIL 构建成功但没找到 %s' % os.path.relpath(EXE, ROOT))
print('[iec104-tcp] 这说明构建产物布局变了(build_sim.ps1 的 $Config 默认 Debug),')
print('[iec104-tcp] 请核对后同步本脚本的 EXE 常量 —— 不跳过、不当作通过。')
return 1
print('[iec104-tcp] 跑 13 条真实 TCP 回环验收 ...')
rc = run([PY, '-B', RUNNER, '--exe', EXE, '--output', OUTPUT])
if rc == 0:
print('[iec104-tcp] PASS 13/13 真实 TCP 回环用例通过(证据目录 %s)'
% os.path.relpath(OUTPUT, ROOT))
return 0
print('[iec104-tcp] FAIL run_tcp_test.py 退出码 %d' % rc)
print('[iec104-tcp] 证据(逐例耗时、simulator.log 的 START/READY/STOP 摘要)在 %s'
% os.path.relpath(OUTPUT, ROOT))
return 1
if __name__ == '__main__':
sys.exit(main())