Files
STM32F4-Base/App/iec60870/common/README.md
T
wandering1 4784df923e 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
2026-11-18 21:31:03 +08:00

44 lines
3.0 KiB
Markdown
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.
# `common/` — 与传输无关的协议数据面
本目录放 104 协议里**不关心网络怎么收发**的那一半:ASDU 编解码、信息对象(遥信/遥测/遥控/
累计量)的字段布局、时间表示。要改「报文内容长什么样」在这里;要改「报文怎么送出去」去
`104/`。这一层同时被 101(串口)等其它 IEC 60870-5 变体共用,所以它刻意不依赖任何网络类型。
## 1. 文件分工
| 文件 | 职责 |
| --- | --- |
| `IEC60870_Types.h` | 类型与参数基线:应用层参数结构(COT/CA/IOA 各自宽度)、长度上限 |
| `IEC60870_StaticAssert.h` | C99 编译期断言 shim,见 [`../README.md`](../README.md) §3.1 |
| `IEC60870_Asdu.h` / `.c` | ASDU 容器:公共头构造与字段读写(Type ID / VSQ / COT / CA) |
| `IEC60870_Codec.h` / `.c` | 通用字节层编解码:小端读写、长度校验、视图借用 |
| `IEC60870_InformationObjects.h` / `.c` | 信息对象类型(Type 1~207)与品质位、CP56Time2a 等结构 |
| `IEC60870_Slave.h` / `.c` | 101/104 共用的**子站发送接口**(抽象层,用函数指针分派,不含 TCP/串口/队列/连接状态机,不分配内存);104 的具体实现是 `104/IEC104_Slave.c` |
| `IEC60870_Time.h` / `.c` | CP56Time2a / CP16Time2a 编解码与整数公历换算(400 年周期展开、以三月为年内起点统一处理闰日;仅在 1970..2099 年范围内运算,不读 RTC、不执行校时) |
| `IEC60870_FaultEvent.h` / `.c` | Type42 故障事件的扩展布局编解码,见 §2 |
## 2. 关键约束
**`FaultEvent` 不是可选模块,是链接依赖。** `104/business/IEC104_Spontaneous.c` 的
`IEC104_Spontaneous_Publish_Fault_Event()` 在发布路径上调用
`IEC60870_FaultEvent_Encode()`。它实现的是 Type42 的**扩展布局**(两组异构记录共用链路
IOA 宽度、计数位于报文体),不属于基础标准定义的 Type42 对象——所以别拿标准 Type42 的
字节期望去比对它。
**应用层参数必须两端一致。** `IEC60870_AppLayerParameters_t` 定义 Type ID / VSQ / COT / CA /
IOA 各占几个字节以及 ASDU 上限。通用上限是 254;接入本工程 104 TCP 时固定用
`IEC104_APP_LAYER_PARAMETERS_DEFAULT`(COT=2、CA=2、IOA=3,ASDU 上限 249),
`IEC104_Slave.c` 的 `Parameters_Compatible()` 会拒绝不匹配的配置。改了参数就等于改了线上
字节布局,主站侧必须同步——不存在自动协商。
**断言条件一行都不许动。** 全目录共 43 处编译期断言,本目录分布 3 处
(`IEC60870_FaultEvent.c` 1 处、`IEC60870_InformationObjects.c` 2 处),其余在
`104/` 与 `104/business/`。改容量宏时断言条件(如 `SOE_CAPACITY == ASDU_SOE_MAX_CAPACITY`)
保持不变,它守的不变式才有意义。shim 本身见 §1 表首行。
## 3. 相关文档
- 完整协议栈与目录总览 → [`../README.md`](../README.md)
- 信息对象与品质位口径在平台侧怎么消费 → `App/algo/meas.h` 的 `MEAS_QDS_*` 注释
- ASDU 头与 COT 宽度 → `docs/子系统设计/IEC104上行设计说明.md`