这个目录里的 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
104/ — APCI 传输层与协议状态机
本目录负责 104 协议的传输面:把字节流切成 APDU 帧、维护 k/w 发送窗口与超时,
并把解析出的事件交给 business/ 的业务状态机。要改「帧怎么收发、连接怎么管」在这一层;
要改「某类请求怎么应答」去 business/。
本目录同时承载平台适配与装配(小写 iec104_* 前缀,见 §3),因为一个目标只能链接一个
Net 后端,装配代码与它服务的传输层放在一起才能一眼看清这条唯一链路的全貌。
1. 文件分工
| 文件组 | 职责 |
|---|---|
IEC104_Codec.c |
APDU 帧编解码:I/S/U 帧格式、长度字段、APCI 头部 |
IEC104_Link.c · IEC104_Link_Slave_StartStop.c |
链路状态机:STARTDT/STOPDT/TESTFR 与从站启停 |
IEC104_Connection.c |
单条连接的收发状态、序号维护 |
IEC104_Receiver.c |
接收侧组帧与校验,产出待处理事件 |
IEC104_SendBuffer.c · IEC104_SendManager.c |
发送缓冲与发送调度(含部分发送处理、优先级车道) |
IEC104_AsduQueue.c |
ASDU 队列:HIGH/NORMAL 两级,跨重连保留语义见该文件注释 |
IEC104_TcpServer.c · IEC104_TcpServer_Config.h |
非阻塞 TCP 服务:连接身份、事件环、SOE 容量 |
IEC104_Slave.c · IEC104_Slave.h |
从站主体:对外统一入口(启动、轮询、状态查询) |
IEC104_Net.h · IEC104_Net_Windows.c |
Net 后端 ABI 与主机(模拟器)实现 |
IEC104_Log.h |
日志宏声明头,当前是孤儿:实现文件 IEC104_Log.c 未随迁,无任何文件 include 它,两套构建清单里也没有它。本目录按 §4 的零日志惯例运行,保留此头仅为不破坏上游文件集合的完整性 |
2. 关键约束
一个目标只能链接一个 Net 后端。 IEC104_Net.h 定义一套 ABI,板端由
iec104_net_mcu.c(经 CH395F)实现,模拟器由 IEC104_Net_Windows.c 实现。
同时链接两份会重复定义符号,或者更隐蔽地链到错的那份——两条路径的阻塞语义完全不同,
后者不会报错,只会让时序对不上。板端后端的句柄规则(LISTEN/CLIENT 双槽、代次不变式)
见 docs/网络/IEC104_Net适配契约.md。
非阻塞 I/O 与部分发送是这一层的前提。 Slave/TcpServer 假定 Net 后端从不在调用内
阻塞,因而发送必须能返回「已写一部分」,由 SendManager 记住偏移下轮续写。
板端网络层是「两段式等待 + netTask 单属主」模型,与本假设的接缝
→ docs/网络/Net层阻塞模型架构设计.md。
SOE 容量是 RAM 预算决策:IEC104_TcpServer_Config.h 把
IEC104_TCP_SOE_CAPACITY 设为 128U(上游为 256),理由与合规依据见
../README.md §3.2。
3. 装配与平台层(小写 iec104_*)
这五个模块是本项目的自有代码,不是协议主体的一部分:
| 文件 | 职责 | 不能据此推断 |
|---|---|---|
iec104_core.c |
iec104_core_start/poll/stop 生命周期与事件循环,串行驱动上面整套状态机 |
PC 运行不证明 CH395F、RTOS 或板端监听生命周期正确 |
iec104_source.c |
数据源、模拟动作、参数 RAM、虚拟设备墙钟;iec104_source_bind() 是可选平台接缝 |
接口存在不等于已绑定 UI、保护或标定真源 |
iec104_net_mcu.c |
CH395F 的 Net 后端实现(板端唯一后端) | 不经板端台架验证过 |
iec104_dtu_table.c |
标准 DTU 点表与元数据(含 SP/DP/ME 分段与参数表) | 新旧通信地址相同不代表语义相同 |
iec104_comm.c |
/config.ini 的 [comm] 段:本站公共地址/端口号的 RAM 副本、工厂默认、getter 合法带自愈与 setter 守卫;键表口径见 docs/子系统设计/网络配置说明.md |
落盘属主是配置引擎(App/cfg/),本模块只提供 iec104_comm_store_save() 与脏位 |
调用必须由同一事件循环属主串行执行,源回调必须短且不阻塞。当前属主是 netTask:
App/task/iec104_serv.c 在 1 ms 循环里调 iec104_serv_net_tick(),不另建 104 任务。
4. 日志与诊断
本目录的协议主体遵循零日志输出惯例(不 printf、不直写串口),状态通过
IEC104_Slave_Get_Status() 与各模块 status 结构暴露,由上层(App/task/iec104_serv.c)
决定怎么记录。理由:协议层不知道自己运行在哪个任务上下文,直写日志会引入不可重入与
栈深度不可控。要加诊断信息,请扩状态结构而不是往协议层塞日志宏。
5. 相关文档
- 完整协议栈与目录总览 →
../README.md - 板端设计与落地结论 →
docs/子系统设计/IEC104上行设计说明.md - Net 适配契约 →
docs/网络/IEC104_Net适配契约.md - 阻塞模型与
netTask调用边界 →docs/网络/Net层阻塞模型架构设计.md