wandering1
|
2053f6d913
|
docs(iec60870): 把 104 板端落地文档归入 docs/iec60870/板端落地
四篇讲「本项目怎么接 104」的文档原来散在子系统设计与网络两个目录,
和随库迁入的 36 篇协议库设计混在一起。现集中到 docs/iec60870/板端落地/:
- IEC104上行设计说明.md(原 docs/子系统设计/)
- IEC104_Net适配契约.md(原 docs/网络/)
- IEC104_MCU落地规划.md(原 docs/子系统设计/)
- IEC104_MCU最小可行性验证.md(原 docs/子系统设计/)
改动:
- 四篇 git mv 保留历史,全库引用经 rename_ref.py 逐篇改写(27 个文件
54 处引用行),旧路径残留扫描为 0。
- docs/README.md:§5.3 改为「IEC 60870-5-104 文档(40 篇)」,拆成
「板端落地 4 篇」与「协议库设计与接口 36 篇」两张表,说明两条轴的分工;
从 §5.1 功能子系统表里移除这三篇的重复条目。
- docs/iec60870/README.md:新增两条轴入口与板端落地表,原阅读顺序
改标注为「协议库部分」。
验证:
- check_doc_links.py --all --sections-strict:310 篇 0 问题。
- 三份索引 markdown 链接可达性逐个 exists() 校验,断链 0;索引表覆盖
36 篇协议库文档,与实际磁盘文件双向差集为空。
- 板端落地目录 4 篇 BOM / CR / U+FFFD 均为 0。
- 工作树 Keil 权威构建 0 errors 0 warnings(Code=365896 RO=48336
RW=2736 ZI=173104),此后预提交 21 Passed / 0 Failed。
|
2026-11-18 23:31:37 +08:00 |
|
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 |
|
wandering1
|
ce72cdfc41
|
refactor(iec60870): 裁掉项目用不到的信息对象类型,Flash 省约 1.9 KB
这一版的目标是把第三方协议库变成项目自己的代码,第一步先删掉项目
根本用不到的部分,让后续维护不必假装这些能力还在。
删除的 12 个纯头文件(只声明、没有实现,全仓 0 处 include):
- common/IEC60870_Comtrade.h
- common/IEC60870_EnergyFreeze.h
- common/IEC60870_EnergyFreezeFile.h
- common/IEC60870_FaultRecorder.h
- common/IEC60870_FirmwareUpdate.h
- common/IEC60870_History.h
- common/IEC60870_HistoryFile.h
- common/IEC60870_UserLog.h
- common/IEC60870_UserLogFile.h
- common/IEC60870_Clock.h
- 104/business/IEC104_FileService.h
- 104/business/IEC104_SoftwareUpgrade.h
它们描述的是录波、历史文件、用户日志、固件升级、文件传输这些没有
实现的接口,留着只会让人误以为协议栈具备这些能力。
裁掉的 9 个信息对象类型(无任何创建、解析或发送引用):
- Type 106 延时获取命令
- Type 120~127 文件传输与日志查询(Type 125 本就不在长度表里)
改动只删整块:类型定义、vtable、编解码入口、两处 switch 分支,以及
长度校验表 asdu_object_lengths 的 8 项。Type 110~113 被两个删除块
夹住的场景经逐行比对证实为 diff 对齐伪影,源码零插入、零替换。
主站若发送被删类型,仍按原路径回 COT 44(未知类型):ASDU 头解析只
用长度表判载荷,业务模块本就不认领,最后由 iec104_core 的 dispatch
统一拒绝。行为不变。
验证(本机实跑):
- Keil 0 错误 0 警告;Code 367,464→365,768,RO 48,492→48,224
- 模拟器构建 OK;真实 TCP 回环 13/13 全过
- 6 个主机单测全过(comm 50/50、serv 50/50、netmcu 13/13 与 2/2、
soe 32/32、dtu 7/7)
- 覆盖率 89.3%、49/49 套件,无回退
- 内存台账按新构建回填(ER_IROM1 413,992 B / 39.5%)
|
2026-11-18 21:06:33 +08:00 |
|
wandering1
|
c0cef2fca0
|
refactor(app): 去掉 App/protocol 层,104 迁入 App/iec60870/104_port
IEC 60870 是标准族(含 104/101),原 App/protocol/ 把它拆成
iec60870/(vendor 核心)+ iec104/(我方适配)两棵同级树,多一层且
看不出「104 只维护一个」。现按标准族收口:
App/protocol/iec60870 -> App/iec60870
App/protocol/iec104 -> App/iec60870/104_port
App/protocol/{README.md,.gitkeep} 删除
App/protocol/iec104/iec104_asdu.h 删除(零 include / 零注册的孤儿)
vendor 子树(104/ common/ examples/)逐字节未改:91 个 R100 重命名、
git diff --cached -M 后 0 insertions / 0 deletions,另按字节直比 89/89
一致;UPSTREAM.sha256 差异集仍等于既有 17 项受控差异,非篡改。
适配层只改注释里的路径字样,无逻辑行。
门禁配套:
- coding-standard 的 exclude 不能写祖先 App/iec60870/——rename_ref 机械
改出的祖先形态会把 2,191 行适配层一起豁免掉。改为三条精确前缀
common/ 104/ examples/,适配层 11/11 回到受检;vendor 直调脚本仍报
88 处违规而钩子 Skipped,证明确实由 exclude 生效而非空跑。
- check_registration 的 KNOWN_GAPS 键与理由文本同步到新路径。
验证:Keil 0 errors 0 warnings(Code=367464 RO-data=48492
RW-data=2288 ZI-data=173544),构建日志与 .d 依赖证明 5 个适配 .o
真被编入;模拟器 0 警告并跑通 iec104-tcp 13/13 真实 TCP 回环;
pre-commit 25 Passed / 0 Failed;doc-links 30 处问题全在
IEC60870-Slave/ 供应商快照,我方文档零新增。
顺带删掉仓根误入库且零引用的 _all_hook.txt 与 _scope.txt。
|
2026-11-18 14:15:10 +08:00 |
|