4784df923e
这个目录里的 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
44 lines
3.0 KiB
Markdown
44 lines
3.0 KiB
Markdown
# `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`
|