refactor(iec60870): 解除第三方钉死,104 协议栈按项目自有代码维护

这个目录里的 104 协议栈原先按「第三方导入、逐字节保真」的方式管理:
改动要登记进哈希清单,门禁靠对比上游字节来判断有没有被动过。现在它已经是
团队自己的代码(用户裁定有完整处置权),这套机制就变成了纯粹的阻力——
它会让正常的功能修改看起来像篡改。这一版把它拆掉。

主要动作:

- App/iec60870/IMPORT.md 改名为 README.md。原来的名字本身就在说「这是导入的」,
  而按仓库文档规范,每个自建代码目录都该有 README。
- 删除 App/iec60870/UPSTREAM.sha256(84 条上游哈希)。它唯一的运行时消费者
  是 transport 测试的源文件清单,那个脚本已改成显式列出 27 个 .c。
- 许可证表述改为项目自有。仓库根的 IEC60870-Slave/ 是另一件事:那份仍是原始
  快照、仅作独立验证基线,许可状态未确认,不因本目录收编而改变。
- 四个子目录 README 从 4~6 行扩写到 32~69 行,各自说清职责、边界与改动纪律。
- coding-standard 的排除面收窄:从排除整个 104/ 改为只排除 business/ 与
  大写开头的 IEC104_*。我们自己的适配层 iec104_*.{c,h} 重新进入受检面,
  11 个文件实测 RC=0。

保留的技术知识(没有随保真框架一起删掉):C99 静态断言为何需要 shim 与
43 处断言条件未改、SOE 深度 128 的合规依据、点表元素 12B 降到 8B 以放进
const Flash、无符号上界比较消诊断、FaultEvent 的链接依赖、11 个容量宏的
默认值表、以及能力边界(历史/录波/文件/升级后端未导入)。

验证:

- 全量 pre-commit 12 Passed / 0 Failed
- doc-links 308 篇 / 30 处问题,全部在 IEC60870-Slave/ 内,我方零新增
- transport 测试改前改后编译集逐字节一致(27 个 .c,哈希相同),10 条用例全过
- 8 个改动文件字节体检 BOM=False / CR=0 / U+FFFD=0
This commit is contained in:
2026-11-18 21:31:03 +08:00
parent ce72cdfc41
commit 4784df923e
11 changed files with 395 additions and 241 deletions
@@ -9,15 +9,17 @@
## 0. 成熟协议核心迁入状态与验证边界
本节说明正在迁入的 `IEC60870-Slave` 产品子集。**下文 §1 至 §8 仍描述既有板端实现及其历史验证,不代表新核心已经替换板端。**
本节说明已迁入的 104 协议栈的验证边界。**下文 §1 至 §8 仍描述既有板端实现及其历史验证,不代表新核心已经替换板端。**
> **2026-11-18 补记(旧栈状态已变,此处按日期冻结)**:本节原写「当前旧 asdu/pts/link 与 `App/task/iec104_serv.c` 仍保留;删除旧栈必须在板端切换、资源闭环及实际验证后进行」——**该描述在当天之后失效**:`iec104_asdu/pts/link` 三源在同一日随骨架迁 MCU 删除(`App/task/iec104_serv.c` 被重写为新契约,不再含旧胶水),`App/protocol/` 这一层整体并入 `App/iec60870/`。§1–§8 保留为历史实现记录,其中出现的 `App/protocol/iec104/…` 路径与 `iec104Task` 承载描述均属当时事实;当前结构见 §0.1 与 `App/README.md`。
>
> **同日起该目录代码已收编为项目自有**:不再是「必须逐字节保真的第三方导入」,按本仓规范维护即可;仓库根 `IEC60870-Slave/` 仅作独立验证基线保留。
### 0.1 装配与生命周期
| 落点 | 当前职责 | 不能据此推断 |
|---|---|---|
| `App/iec60870/` | 成熟 ASDU、Slave、业务状态机、TcpServer 与网络后端;来源见 `App/iec60870/IMPORT.md` | 目录迁入不等于 MCU 集成通过 |
| `App/iec60870/` | 成熟 ASDU、Slave、业务状态机、TcpServer 与网络后端;目录说明与设计约束见 `App/iec60870/README.md` | 目录迁入不等于 MCU 集成通过 |
| `App/iec60870/104/iec104_core.c` | `iec104_core_start()` / `iec104_core_poll()` / `iec104_core_stop()` 装配共享核心;`iec104_core_get_status()` 提供状态 | PC 运行不证明 CH395F、RTOS 或板端监听生命周期正确 |
| `App/iec60870/104/iec104_source.c` | 数据、模拟动作、参数 RAM 与虚拟设备墙钟;`iec104_source_bind()` 是可选平台接缝 | 接口存在不等于已绑定 UI、保护或标定真源 |
| `App/iec60870/104/iec104_dtu_table.c` | 标准 DTU 演示点表与元数据 | 新旧通信地址相同不代表语义相同;候选映射不代表真实绑定 |