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 名字的排除口径。
This commit is contained in:
2026-11-18 10:29:18 +08:00
parent 2e9272cc8a
commit 90cc9a7d99
125 changed files with 7463 additions and 5335 deletions
+55 -14
View File
@@ -155,6 +155,12 @@ repos:
types: [c]
# 范围与 cppcheck 钩子一致;另排除 CubeMX 生成文件(Src/、Inc/,重新生成即覆盖)、
# dhara/FatFS 接口适配层(nand_ftl,函数名由外部 API 固定)
# `App/protocol/iec60870/` 与 `IEC60870-Slave/` 是逐字节钉在 UPSTREAM.sha256 上的
# 第三方源码(IEC 60870-5-104 子站库,45k 行):函数命名/注释块/typedef 形态都是
# 上游风格,改一字节就等于篡改第三方(`verify_vendor.py` 会判定受控差异漂移)。
# 这就是本文档 §0 写明的"排除…第三方"口径落到实处;Lib/、Middlewares/、
# Drivers/CMSIS/ 同理。**我们自己的适配层不在排除面内**:
# App/protocol/iec104/ 全目录、App/task/、Drivers/BSP/NET/ 照旧受检。
exclude: |
(?x)^(
Drivers/CMSIS/|
@@ -162,6 +168,8 @@ repos:
Drivers/BSP/NET/lftpd/|
Drivers/BSP/GD5F2GQ5UE/nand_ftl\.|
Drivers/BSP/dhara/|
App/protocol/iec60870/|
IEC60870-Slave/|
Lib/|
Middlewares/|
MDK-ARM/|
@@ -187,7 +195,8 @@ repos:
MDK-ARM/RTE/|
docs/芯片手册/
)
# mermaid 图:围栏内确定性语法预检(第 52 条,2026-10-30 加,口径 51 → 52,提交期实跑 48 → 49)。
# mermaid 图:围栏内确定性语法预检(2026-10-30 加;当日口径 51 → 52、提交期实跑 48 → 49,
# 2026-11-17/18 摘 `iec104-unit-test` + 加 `iec104-tcp` 后收敛为 52 / 47 / 48)。
# 为什么要有:屏板链路设计.md §1 的 flowchart 里 `-.|"文字"|`(`-.` 直接跟管道,不是任何合法
# 箭头 token)让 mermaid 渲染 `Syntax error in text`——该图 2026-10-29 落库、期间 doc-links 等
# 全绿:文档门禁查链接与章节,**从不查围栏内图表语法**,这是它们的共同盲区。
@@ -496,19 +505,21 @@ repos:
files: ^(Drivers/BSP/NET/lftpd/lftpd_auth\.(c|h)|App/util/sha256\.(c|h)|test/host/ftp_auth/.*|test/host/common/unit_test_harness\.py)$
pass_filenames: false
# 7m) IEC 60870-5-104 被控站协议栈主机侧单元测试(2026-10-12 加,B4)
# APCI 重组/STARTDT/总召分片/COV/k-w-t1~t3/遥控定值两段式/C_CS/错误
# 应答——link 层 tick 注入 + pts 数据源 vtable 抽象就是为主机侧纯逻辑单测全离线
# 穷举设计(分层约束);板端复现这些分支要真主站+真等待。
# 触发面含数据源依赖(prot_set/prot_elm/phasor/sample_ring)——测试
# 直接 #include 这些生产源,签名变了要立刻在这里暴露。
- id: iec104-unit-test
name: IEC104 协议栈单测(主机侧)
entry: scripts/gate_python.py test/host/iec104/run_unit_test.py
language: system
# 运行参数段落地起本 TU 链入真实 cfg_file/adc_cal/run_par(板端真源链),触发面同步扩
files: ^(App/protocol/iec104/iec104_(asdu|pts|link)\.(c|h)|App/algo/(prot_set|prot_elm|phasor|sample_ring|adc_input|freq|meas|adc_cal|run_par)\.(c|h)|App/cfg/cfg_file(_store)?\.(c|h)|test/host/iec104/.*|test/host/common/unit_test_harness\.py)$
pass_filenames: false
# 7m) 【已退役 2026-11-17】IEC 60870-5-104 协议栈主机侧单元测试(2026-10-12 加,B4);
# 曾覆盖 APCI 重组/STARTDT/总召分片/COV/k-w-t1~t3/遥控定值两段式/C_CS。
# 退役原因:它的被删对象是旧自研协议层(iec104_asdu / iec104_pts / iec104_link),
# 三者已随 vendor 库接入整体删除,测试脚本
# test/host/iec104/run_unit_test.py 一并删除 ⇒ 本钩子每次触发都得 RC=2
# (gate_python 报「目标脚本不存在」),是必红的死钩子。
# 新板端网络后端的等价验证是 test/host/iec104_netmcu/(fake net 层 + 自定义
# runner,不是 run_unit_test.py 形态,硬套进这里只会得到一个跑不起来的钩子),
# 由 scripts/ci_local.py 与人工运行,不进提交门禁。
# ⚠ 计数口径(2026-11-18 两笔合并后实测):本条摘除使 YAML 解析条目 52 → 51、
# 提交期实跑 49 → 48;同日新增的 `iec104-tcp`(下面 12b 条,manual 阶段)再把
# 声明数加回 **52**、manual 根数 3 → **4**、manual 阶段枚举行数 50 → **51**。
# ⇒ 终态:**声明 52 / pre-commit 阶段 47 / 一次 git commit 实跑 48 / manual 4**。
# 须与 AGENTS.md 的「共 N 个钩子」、docs/门禁说明/README.md §2 标题、
# docs/代码规范/pre-commit使用说明.md 三处同批改(勿在别处另立字面量)。
# 7m2) SOE 动作记录编解码主机侧单元测试(2026-10-12 加,B9)
# 64 B 定长记录(类型/seq/CP56Time2a/epoch/校验和)是磁盘上的
@@ -698,6 +709,36 @@ repos:
files: ^(scripts/board_ui_nav\.py$|simulator/tests/ref/.*\.bin$)
pass_filenames: false
# 12b) IEC 104 真实回环验收(2026-11-18 加,task-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`
# (11 条真实 TCP 回环:STARTDT/TESTFR、总召、电度、读、定值、区间、未知请求、
# 最大 APDU、命令一律否定确认、校时不改主机钟)**从来没被任何门禁登记**。
# 结果是覆盖率表里 `iec104_dtu` 赫然在列,让人误以为"104 验收已被门禁覆盖"——
# 最容易骗人的那种假象。本钩子把那 11 条接进来,把假象补成真话。
# ⚠ stages: [manual](2026-11-18 Lead 裁定):实测全量 13.7 s(`--sbo-timeout`
# 从 30 s 降 2 s 之后),仍在本仓"2~4 秒自动门禁"判据之外;与 cppcheck /
# test-coverage 同档,只在 local 的 manual 段与手工复跑时执行。
# 手工复跑:python scripts/check_iec104_tcp.py
# 单根用例:python test/host/iec104_dtu/run_tcp_test.py --exe <lvgl_sim.exe> --only <name>
# ⚠ **远端 CI 跑不了它**:`.gitea/workflows/ci.yml` 不构建模拟器
# (grep `lvgl_sim|build_sim|simulator` 零命中),本钩子需要
# `simulator/build/Debug/lvgl_sim.exe`。包装器先调 `simulator/build_sim.bat`
# 增量构建;构建不出(返回 3 = 没装 VS)时按环境错误退出 2,**不静默跳过**
# (与 uinav-selftest 缺 exe 报 FAIL 同一条教训:跳过即绿灯,绿灯即遗忘)。
# ⚠ 被包装的 runner 按"整套 11 条用例"工作、不接受文件参数,故包装器有意忽略
# argv 并 pass_filenames: false(同 ui-golden 的既有做法)。
# ⚠ 触发面**含门禁自身**(`.pre-commit-config.yaml`):不带自身就等于谁改坏这根闸的
# files: 模式,它就再也不跑且无人察觉。
- id: iec104-tcp
name: IEC 104 真实回环验收(13 条 TCP 用例,manual 阶段)
stages: [manual]
entry: scripts/gate_python.py scripts/check_iec104_tcp.py
language: system
files: ^(App/protocol/iec104/|App/protocol/iec60870/104/|test/host/iec104_dtu/|simulator/(sim|main\.c|CMakeLists\.txt)|scripts/check_iec104_tcp\.py$|\.pre-commit-config\.yaml$)
pass_filenames: false
# 13) 编号门禁的历史:2026-10-20 起曾有一版「全库语料审计」(规范 §8 的 8 项校验 +
# 99 族 registry + 别名表)。它 2026-10-28 退役——维护成本高过收益(近 80 笔提交
# 61 笔被编号体系牵连),脚本与语料整体移入 `scripts/archive/id_gate/`