Files
STM32F4-Base/App/iec60870/examples/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

33 lines
2.2 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.
# `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`](../README.md)
- 点表与 UI 视图的语义差异 → `docs/UI设计/UI_数据供给设计.md`