From ea5ef6b7515aefc2ee4510f54a599c56e78b44f0 Mon Sep 17 00:00:00 2001 From: Wanderingss <1624155937@qq.com> Date: Thu, 19 Nov 2026 16:42:34 +0800 Subject: [PATCH] =?UTF-8?q?docs(iec104):=20=E5=BD=92=E6=A1=A3=E9=81=A5?= =?UTF-8?q?=E4=BF=A1=E7=82=B9=E8=A1=A8=E5=8E=9F=E5=A7=8B=20XML=20=E5=B9=B6?= =?UTF-8?q?=E7=99=BB=E8=AE=B0=E5=85=B6=E4=B8=8E=E4=BB=A3=E7=A0=81=E7=82=B9?= =?UTF-8?q?=E8=A1=A8=E7=9A=84=E5=AF=B9=E5=BA=94=E5=85=B3=E7=B3=BB?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 用户交付 01_遥信点表参数.xml(351 条 Item,39,990 B),这是代码点表 iec104_dtu_profile.h 此前只在头部声明却未入库的事实来源。按交付原样 归档到 docs/iec60870/点表/,不改内容与文件名。 实测内容清点:Boolean 65 条(0x9141~0x919E 64 条 + 0xAB41),文本值 0001~0041 与文件序号逐条相等且连续;UShort 286 条(0x9601~0x971E)。 与代码点表的对应关系已逐项核对:dtu_signals[] 59 条的 source_addr 全部 命中本文件,dtu_measurements[] 30 条全部落在 0x9601~0x962C。运行期 IOA 取自 XML 文本值(即文件序号),与参数地址分属两套编号,桥接字段是 source_addr——这一点此前无处可查,是本轮最容易踩的坑。 登记两个缺口:一是 Boolean 有 6 条重合闸动作未进 dtu_signals[],对应 运行期 IOA 0x002C~0x0031 空位(profile 第 58 行已注 "remain absent", 但未说明是哪 6 个点);二是保护定值、告警运行、遥信取反、模拟量倍率四 个参数段在本文件中命中 0 条,profile 头部所称 430 项参数来自另一份未交 付的参数配置 XML。 同步更新两份索引的篇数(40 → 41,点表说明 1 篇 + XML 1 份)与上行设计 说明 §3 的点表权威口径。 --- docs/README.md | 14 +- docs/iec60870/README.md | 11 +- docs/iec60870/板端落地/IEC104上行设计说明.md | 7 + docs/iec60870/点表/01_遥信点表参数.xml | 354 +++++++++++++++++++ docs/iec60870/点表/README.md | 64 ++++ 5 files changed, 446 insertions(+), 4 deletions(-) create mode 100644 docs/iec60870/点表/01_遥信点表参数.xml create mode 100644 docs/iec60870/点表/README.md diff --git a/docs/README.md b/docs/README.md index f62ab0ef..866d45fd 100644 --- a/docs/README.md +++ b/docs/README.md @@ -15,7 +15,8 @@ docs/ ├── 产品需求/ 产品需求设计文档(需求基线)+ 参考产品复刻明细(逐项差额) ├── 架构设计/ 全局架构与设计方法论(含 软件架构与运行时规格 / 硬件规格与能力边界:位表与引脚权威) ├── 子系统设计/ 各功能子系统的设计说明 -├── iec60870/ IEC 60870-5-104 文档(40 篇:板端落地 4 + 协议库设计 36,导航 iec60870/README.md) +├── iec60870/ IEC 60870-5-104 文档(41 篇:板端落地 4 + 协议库设计 36 + 点表说明 1,导航 iec60870/README.md) +│ └── 点表/ 上位机导出的点表 XML 原样归档(代码点表的事实来源) ├── 算法/ 傅氏算法与继电保护算法专题 ├── 网络/ BSD Socket API 使用与内部实现 ├── 测试说明/ 测试流程与规范 · 单元测试 · 板级测试 · 专项验证 · 测试工具 · 测试数据(六个子目录,导航 `测试说明/README.md`) @@ -117,10 +118,10 @@ docs/ --- -### 5.3 IEC 60870-5-104 文档(`docs/iec60870/`,40 篇) +### 5.3 IEC 60870-5-104 文档(`docs/iec60870/`,41 篇) 入口:[`iec60870/README.md`](iec60870/README.md)——按「想干什么」组织的导航(构建、点表、召唤、遥控、参数、文件、升级、历史、录波、日志、排障)。 -这个目录里有两条轴:**板端落地**是本项目自己的约定(怎么接、接成什么样),**协议库设计**是库内部各模块怎么实现(随库从 `IEC60870-Slave/docs/` 迁入,文中指向源码的链接已改指 `App/iec60870/`,标「本项目未实现」的 7 篇只是能力参考)。 +这个目录里有两条轴:**板端落地**是本项目自己的约定(怎么接、接成什么样),**协议库设计**是库内部各模块怎么实现(随库从 `IEC60870-Slave/docs/` 迁入,文中指向源码的链接已改指 `App/iec60870/`,标「本项目未实现」的 7 篇只是能力参考)。第三类不是文档:`点表/` 存上位机导出的点表 XML 原样归档,是代码点表的事实来源。 **板端落地(本项目自有,4 篇)** @@ -131,6 +132,13 @@ docs/ | [`iec60870/板端落地/IEC104_MCU落地规划.md`](iec60870/板端落地/IEC104_MCU落地规划.md) | **MCU 全功能规划(尚未实施)**:全点、全参数持久化及原子生效、通信切换、电能与严格兼容文件、网络与完整资源调查、逐项审批及分波次全量验收 | | [`iec60870/板端落地/IEC104_MCU最小可行性验证.md`](iec60870/板端落地/IEC104_MCU最小可行性验证.md) | **最小可行性验证记录**:已批准工作包的隔离验证结果与资源域 STOP 结论;记录当时的决策与证据,不是产品落地完成报告 | +**点表原始输入(1 篇说明 + 1 份 XML)** + +| 文件 | 内容 | +|---|---| +| [`iec60870/点表/README.md`](iec60870/点表/README.md) | **点表原文说明**:`01_遥信点表参数.xml` 内容清点(遥信 65 / 遥测 286)、IOA 与参数地址的对应关系、6 条未映射缺口;讲清「addr 不是 IOA」 | +| `iec60870/点表/01_遥信点表参数.xml` | 2026-11-19 交付的点表原文(39,990 B),代码点表 `iec104_dtu_profile.h` 的事实来源 | + **协议库设计与接口(随库迁入,36 篇)** | 文档 | 内容 | diff --git a/docs/iec60870/README.md b/docs/iec60870/README.md index a4c20777..03225bf1 100644 --- a/docs/iec60870/README.md +++ b/docs/iec60870/README.md @@ -8,8 +8,10 @@ |---|---|---| | **本项目板端落地** | [`板端落地/`](板端落地/) | 本项目自己怎么写:104 上行基线(范围/点表/链路/接入/预算)、板端 Net 后端契约、MCU 落地规划、最小可行性验证记录 | | **协议库设计与接口** | `104/` `common/` `examples/` `test/` | 协议库各模块内部怎么实现(随库迁入,源码落点 `App/iec60870/`) | +| **点表原始输入** | [`点表/`](点表/) | 上位机导出的点表 XML 原样归档:这是代码点表 `iec104_dtu_profile.h` 的事实来源,不是文档 | -要判断「这块功能在本项目能不能用」,看 `板端落地/`;要理解「协议库内部某个模块怎么工作」,看下面这批。 +要判断「这块功能在本项目能不能用」,看 `板端落地/`;要理解「协议库内部某个模块怎么工作」,看下面这批; +要核对某个点「主站叫什么、地址是多少」,看 `点表/`,代码里的字符串注释只是它的摘要。 ## 板端落地(本项目自有,4 篇) @@ -20,6 +22,13 @@ | [MCU 全功能落地规划](板端落地/IEC104_MCU落地规划.md) | 全点、全参数持久化、通信切换、电能与文件服务、资源调查与分波次验收(尚未实施) | | [MCU 最小可行性验证](板端落地/IEC104_MCU最小可行性验证.md) | 已批准工作包的隔离验证结果与资源域 STOP 结论(决策记录,不是落地完成报告) | +## 点表原始输入(1 篇说明 + 1 份 XML) + +| 文件 | 内容 | +|---|---| +| [点表原始输入说明](点表/README.md) | `01_遥信点表参数.xml` 的内容清点(遥信 65 / 遥测 286)、与 `dtu_signals[]` 的 IOA 对应关系、6 条未映射缺口、地址空间与 IOA 的区别 | +| `点表/01_遥信点表参数.xml` | 2026-11-19 交付的点表原文(39,990 B,只读输入,按原样保存) | + ## 推荐阅读顺序(协议库部分) 以下是协议库内部的阅读路径,源码落点见上文。专用示例的点表、定值、运行与恢复见 [DTU 配置演示](examples/DTU配置演示.md),验证入口见 [DTU 测试](test/IEC104测试文档.md#dtu-tests)。 diff --git a/docs/iec60870/板端落地/IEC104上行设计说明.md b/docs/iec60870/板端落地/IEC104上行设计说明.md index 5bb591c3..f625089c 100644 --- a/docs/iec60870/板端落地/IEC104上行设计说明.md +++ b/docs/iec60870/板端落地/IEC104上行设计说明.md @@ -107,6 +107,13 @@ ## 3. 点表(V0.1) +> **本节的选择器口径**:本节讲「哪些点存在、绑什么源」。点的**中文名与参数地址**以 +> `docs/iec60870/点表/README.md` 登记的原始点表为准(2026-11-19 交付的 +> `01_遥信点表参数.xml`:遥信 65 条、遥测 286 条);代码侧 `dtu_signals[]` / +> `dtu_measurements[]` 只是它的子集与摘要,字符串注释不是权威点名。 +> 注意两份地址空间不同:XML 的 `addr`(`0x91xx` / `0x96xx`)是**参数地址**, +> 本节的 `IOA`(`0x0001`~`0x0041` / `0x4001`~)是**运行期点号**,桥接字段是 `source_addr`。 + ### 3.1 遥测 YC(IOA 0x4011+,短浮点,系数 1) | IOA | 点 | 来源 | V0.1 状态 | diff --git a/docs/iec60870/点表/01_遥信点表参数.xml b/docs/iec60870/点表/01_遥信点表参数.xml new file mode 100644 index 00000000..df7ca438 --- /dev/null +++ b/docs/iec60870/点表/01_遥信点表参数.xml @@ -0,0 +1,354 @@ + + + 0001 + 0002 + 0003 + 0004 + 0005 + 0006 + 0007 + 0008 + 0009 + 000A + 000B + 000C + 000D + 000E + 000F + 0010 + 0011 + 0012 + 0013 + 0014 + 0015 + 0016 + 0017 + 0018 + 0019 + 001A + 001B + 001C + 001D + 001E + 001F + 0020 + 0021 + 0022 + 0023 + 0024 + 0025 + 0026 + 0027 + 0028 + 0029 + 002A + 002B + 002C + 002D + 002E + 002F + 0030 + 0031 + 0032 + 0033 + 0034 + 0035 + 0036 + 0037 + 0038 + 0039 + 003A + 003B + 003C + 003D + 003E + 003F + 0040 + 0041 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/docs/iec60870/点表/README.md b/docs/iec60870/点表/README.md new file mode 100644 index 00000000..a713309d --- /dev/null +++ b/docs/iec60870/点表/README.md @@ -0,0 +1,64 @@ +# 点表原始输入 + +> **定位**:主站/上位机侧导出的点表原始文件,**只读输入资料**——按交付原样保存,不改内容、不改文件名、不做格式化。 +> 代码侧的点表产物在 `App/iec60870/104/iec104_dtu_profile.h`;本目录是它的事实来源。 + +## 1. 文件清单 + +| 文件 | 内容 | 大小 | 用途 | +|---|---|---|---| +| `01_遥信点表参数.xml` | 遥信 65 条 + 遥测 286 条 | 39,990 B | **遥信与遥测的验收依据**(2026-11-19 交付) | + +## 2. 内容清点(实测) + +`Item` 共 351 条,两种 `tag`: + +| tag | 条数 | 地址段 | 地址语义 | 文本值 | +|---|---|---|---|---| +| `Boolean` | 65 | `0x9141`~`0x919E`(64 条)+ `0xAB41`(1 条) | 遥信参数地址 | 4 位十六进制,与本文件序号 `0001`~`0041` **逐条相等且连续无缺** | +| `UShort` | 286 | `0x9601`~`0x971E` | 遥测/模拟量参数地址 | 空 | + +- 地址无重复;**文件内顺序与地址顺序不一致**(按功能分组排列,不是按地址升序)。 +- `desc` 非空 251 条,取值是单位注记(`单位:V` / `单位:Hz` / `单位:℃` / `单位:%` / `单位:h` / `单位:kb`)或间隔注记(`"第 N 间隔`,前导半角引号是源文件残留,未清理)。 + +## 3. 与代码点表的对应关系 + +`App/iec60870/104/iec104_dtu_profile.h` 的 `dtu_signals[]` 用 `source_addr` 字段对应本文件的 `addr`;**运行期 IOA 取本文件的文本值(即文件序号)**,59 条逐项吻合: + +``` +IOA 0x0001 ← addr 0x9146(序号 0001) IOA 0x003E ← addr 0x9174(序号 003E) +IOA 0x0002 ← addr 0x9149(序号 0002) IOA 0x003F ← addr 0x914F(序号 003F) +... +IOA 0x0038 ← addr 0xAB41(序号 0038) IOA 0x0041 ← addr 0x916D(序号 0041) +``` + +- `dtu_measurements[]` 的 30 条全部落在 `0x9601`~`0x962C`(该段本文件共 44 条,14 条未用)。 +- `dtu_commands[]`(19 条,`0x6001` / `0x9801` 段)**不在本文件内**。 + +## 4. 尚未映射的 6 条(缺口) + +`Boolean` 65 条中有 6 条未进 `dtu_signals[]`,对应运行期 IOA `0x002C`~`0x0031` 为空位(`dtu_signals[]` 从 `0x002B` 直接跳到 `0x0032`): + +| 序号 | 参数地址 | 点 | +|---|---|---| +| `002C` | `0x917B` | 开闭所(环网箱)00开关过流重合闸第一次动作 | +| `002D` | `0x917C` | 开闭所(环网箱)00开关过流重合闸第二次动作 | +| `002E` | `0x917D` | 开闭所(环网箱)00开关过流重合闸第三次动作 | +| `002F` | `0x917E` | 开闭所(环网箱)00开关零流重合闸第一次动作 | +| `0030` | `0x917F` | 开闭所(环网箱)00开关零流重合闸第二次动作 | +| `0031` | `0x9180` | 开闭所(环网箱)00开关零流重合闸第三次动作 | + +这 6 条是重合闸动作记录,当前无生产方(重合闸功能未实现);补点前需先有数据源,否则只能置 IV。 + +## 5. 本文件不包含什么 + +| 缺的东西 | 说明 | +|---|---| +| 保护定值与区域参数 `0x8820`~`0x88FF`、告警/运行参数 `0x8020`~`0x8056`、遥信取反 `0x9E01`~`0x9E5D`、模拟量倍率 `0xA2C1`~`0xA2EC` | 实测 0 条。`iec104_dtu_profile.h` 头部所称「430 XML parameter entries」是**另一份参数配置 XML**,未随本文件交付 | +| 遥控点表 `0x6001` / `0x9801` 段 | 实测 0 条 | + +## 6. 约束 + +- **地址不是 IOA**:`addr` 是参数地址空间(`0x91xx` / `0x96xx`),与运行期 104 IOA(`0x0001`~`0x0041` / `0x4001`~)分属两套编号,不可混用。二者的唯一桥接是 `dtu_signals[].source_addr` 与 `dtu_measurements[].source_addr`。 +- **改代码点表时以本文件为准**,不要反向从代码里的字符串猜语义;`name` 是本文件的中文点名的唯一出处。 +- 本目录文件不受 `docs/` 的 Markdown 规范约束(非 `.md` 输入资料),但同样**禁止用脚本改写内容**——需要新版本时按新文件名另存并在上表登记。