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
examples/ — 声明式 DTU 点表 profile
本目录只有一份头文件:iec104_dtu_profile.h,用纯数据结构声明标准 DTU
(Distribution Terminal Unit,配电终端)点表——遥信、遥测、遥控、参数各段分别有多少点、
IOA 怎么分、每个点的类型与元数据是什么。
它被 App/iec60870/104/iec104_dtu_table.c #include 后编译进产品,所以它是
实打实的产品代码,不是示例、不会被排除在构建之外。改这里等于改点表。
本目录没有任何示例 main,也没有运行时实现。 没被产品链接的文件不要往这里放:
放进来的东西会让人误以为它参与构建。要加运行时逻辑,去 104/ 或 104/business/。
关键约束
- 点表是「标准 DTU 演示表」,不等于现场点表。 它按 IEC 60870-5-104 标准 DTU(配电终端)
的典型配置编排,用于把协议栈跑通、把主站侧对点工具点亮,不代表任何现场实际接线。
新旧通信地址相同不代表语义相同;候选映射不代表真实绑定。当前哪些点真接了硬件来源,
见
docs/子系统设计/IEC104上行设计说明.md的平台接缝章节。 - 改点数要同步改别处。 遥信总数的事实来源是
App/iec60870/104/iec104_dtu_table.h的IEC104_DTU_SP_COUNT(59,单点遥信 Single Point)与IEC104_DTU_DP_COUNT(16,双点遥信 Double Point);遥测为IEC104_DTU_ME_COUNT(30,测量值 Measured Value)。 而产品 UI 视图的行数UI_DATA_YX_N是另一个数(两者语义不同、数值本就不等)。 改动前先读Drivers/BSP/UI/ui_data.h的yx_dp字段注释与App/app/ui_data_feed.c的feed_yx_dp()——那里有一条一次性DBG_ERROR专门盯着这个差异。 - 本文件是
const数据,进 Flash。 五个表都声明为static const(dtu_signals/dtu_measurements/dtu_energy/dtu_commands/dtu_parameters),只需被一个 编译单元包含,因此不占静态 RAM;但体积直接影响 Flash 预算。
相关文档
- 完整协议栈与目录总览 →
../README.md - 点表与 UI 视图的语义差异 →
docs/UI设计/UI_数据供给设计.md