merge: 104 文档迁入 docs/iec60870、点表并回 104、按项目规范整理文档
This commit is contained in:
@@ -177,7 +177,6 @@ repos:
|
||||
App/iec60870/common/|
|
||||
App/iec60870/104/business/|
|
||||
App/iec60870/104/IEC104[_.]|
|
||||
App/iec60870/examples/|
|
||||
IEC60870-Slave/|
|
||||
Lib/|
|
||||
Middlewares/|
|
||||
|
||||
+1
-2
@@ -37,8 +37,7 @@ FreeRTOS/CMSIS-RTOS API**(本条与「就绪屏障位必须 `osFlagsNoClear`
|
||||
| 子目录 | 内容 |
|
||||
|---|---|
|
||||
| `common/` | ASDU / 信息对象 / 时间编解码与从站主体(与 101 等其它 60870 协议共用) |
|
||||
| `104/` | APCI 传输(Link / Connection / TcpServer / SendManager / AsduQueue)+ 业务状态机(`104/business/`)+ **平台适配与装配**(`iec104_core` / `iec104_source` / `iec104_net_mcu` / `iec104_dtu_table` / `iec104_comm`) |
|
||||
| `examples/` | DTU 点表 profile(`iec104_dtu_profile.h`) |
|
||||
| `104/` | APCI 传输(Link / Connection / TcpServer / SendManager / AsduQueue)+ 业务状态机(`104/business/`)+ **平台适配与装配**(`iec104_core` / `iec104_source` / `iec104_net_mcu` / `iec104_dtu_table` / `iec104_comm`)+ DTU 点表 profile(`iec104_dtu_profile.h`) |
|
||||
|
||||
改动口径:全部按项目自有代码对待(命名、注释、结构遵循 `docs/代码规范/`);
|
||||
`iec104_*` 是本项目自己的装配与平台层,`IEC104_*` / `IEC60870_*` 是协议主体与共享编解码。
|
||||
|
||||
@@ -20,6 +20,7 @@ Net 后端,装配代码与它服务的传输层放在一起才能一眼看清
|
||||
| `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_dtu_profile.h` | 标准 DTU 点表数据本体(五张 `static const` 表,由 `iec104_dtu_table.c` 包含进产品) |
|
||||
|
||||
## 2. 关键约束
|
||||
|
||||
@@ -38,6 +39,24 @@ Net 后端,装配代码与它服务的传输层放在一起才能一眼看清
|
||||
`IEC104_TCP_SOE_CAPACITY` 设为 `128U`(上游为 256),理由与合规依据见
|
||||
[`../README.md`](../README.md) §3.2。
|
||||
|
||||
### 点表 profile(`iec104_dtu_profile.h`)
|
||||
|
||||
这份头文件由 `iec104_dtu_table.c` `#include` 后编译进产品,是**实打实的产品代码**
|
||||
(不是示例、不受构建排除)。改它等于改点表,三条约束:
|
||||
|
||||
- **它是「标准 DTU 演示表」,不等于现场点表。** 按 IEC 60870-5-104 标准 DTU 的典型配置
|
||||
编排,用于跑通协议栈与主站对点工具,不代表现场实际接线。新旧通信地址相同**不代表
|
||||
语义相同**;当前哪些点真接了硬件来源,见 `docs/子系统设计/IEC104上行设计说明.md`
|
||||
的平台接缝章节。
|
||||
- **改点数要同步别处。** 遥信总数的事实来源是 `iec104_dtu_table.h` 的
|
||||
`IEC104_DTU_SP_COUNT`(59)/ `IEC104_DTU_DP_COUNT`(16),遥测为
|
||||
`IEC104_DTU_ME_COUNT`(30)。产品 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。** 五张表(`dtu_signals` / `dtu_measurements` /
|
||||
`dtu_energy` / `dtu_commands` / `dtu_parameters`)都是 `static const`,只被一个编译单元
|
||||
包含,不占静态 RAM,但体积直接影响 Flash 预算。
|
||||
|
||||
## 3. 装配与平台层(小写 `iec104_*`)
|
||||
|
||||
这五个模块是本项目的自有代码,不是协议主体的一部分:
|
||||
@@ -64,5 +83,6 @@ Net 后端,装配代码与它服务的传输层放在一起才能一眼看清
|
||||
|
||||
- 完整协议栈与目录总览 → [`../README.md`](../README.md)
|
||||
- 板端设计与落地结论 → `docs/子系统设计/IEC104上行设计说明.md`
|
||||
- 点表与 UI 视图的语义差异 → `docs/UI设计/UI_数据供给设计.md`
|
||||
- Net 适配契约 → `docs/网络/IEC104_Net适配契约.md`
|
||||
- 阻塞模型与 `netTask` 调用边界 → `docs/网络/Net层阻塞模型架构设计.md`
|
||||
|
||||
@@ -1,3 +1,4 @@
|
||||
/* 模块名称:DTU 标准点表 profile(const 数据);作者:DTU项目组。 */
|
||||
/*
|
||||
* DTU 100V1A / 100V1A demonstration profile.
|
||||
* Source: DTU(100V1A 100V1A)/参数配置 (430 XML parameter entries).
|
||||
@@ -1,6 +1,6 @@
|
||||
/* 模块名称:参数值槽 rank 映射表(生成文件,勿手改)。 */
|
||||
/* GENERATED FILE - do not edit by hand.
|
||||
* Source: App/iec60870/examples/iec104_dtu_profile.h (const profile table).
|
||||
* Source: App/iec60870/104/iec104_dtu_profile.h (const profile table).
|
||||
* Generator: ci-artifacts/iec104-cutover/gen_source_ranks.py
|
||||
* Design: ci-artifacts/iec104-cutover/package-b-design.md
|
||||
* Include exactly once, from App/iec60870/104/iec104_source.c only.
|
||||
|
||||
@@ -16,7 +16,8 @@
|
||||
| `common/` | 与传输无关的协议数据面:ASDU(应用服务数据单元)编解码、信息对象、时间表示,以及 101/104 共用的子站发送接口抽象 | [`common/README.md`](common/README.md) |
|
||||
| `104/` | APCI(应用规约控制信息)传输层 + 业务状态机 + **平台适配与装配** | [`104/README.md`](104/README.md) |
|
||||
| `104/business/` | 业务状态机:收到的 I 帧按业务类型分派、校验、应答与主动上送 | [`104/business/README.md`](104/business/README.md) |
|
||||
| `examples/` | 声明式 DTU(配电终端)点表 profile,一份头文件,无示例 main | [`examples/README.md`](examples/README.md) |
|
||||
|
||||
`iec104_dtu_profile.h`(标准 DTU 点表数据本体)也在 `104/` 下,由 `iec104_dtu_table.c` 包含进产品;它虽名为 profile,却是实打实的产品代码,详见 [`104/README.md`](104/README.md)。
|
||||
|
||||
`104/` 下有两类文件,**命名前缀就是分层标记**:`IEC104_*` 是协议主体(传输与状态机),
|
||||
`iec104_*`(小写)是本项目的装配与平台层——`iec104_core`(生命周期与事件循环)、
|
||||
|
||||
@@ -1,32 +0,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`](../README.md)
|
||||
- 点表与 UI 视图的语义差异 → `docs/UI设计/UI_数据供给设计.md`
|
||||
+25
-25
@@ -81,9 +81,9 @@ IEC60870-Slave/
|
||||
|
||||
## 构建与测试
|
||||
|
||||
按 `DTU(100V1A 100V1A)` 配置演示时,使用专用 DTU 入口。它保留原文件的 59 个遥信、19 个遥控和 345 项已填参数,接入通用示例的完整业务,并补充 30 个遥测、16 个双点反馈和 8 个电量点等演示地址。PT 为 100V/100V,相 CT 和零序 CT 均为 1A/1A;定值预置、固化、撤销及持久化、文件传输、历史、录波和升级的开启方法见 [DTU 配置演示](docs/examples/DTU配置演示.md)。
|
||||
按 `DTU(100V1A 100V1A)` 配置演示时,使用专用 DTU 入口。它保留原文件的 59 个遥信、19 个遥控和 345 项已填参数,接入通用示例的完整业务,并补充 30 个遥测、16 个双点反馈和 8 个电量点等演示地址。PT 为 100V/100V,相 CT 和零序 CT 均为 1A/1A;定值预置、固化、撤销及持久化、文件传输、历史、录波和升级的开启方法见 [DTU 配置演示](../docs/iec60870/examples/DTU配置演示.md)。
|
||||
|
||||
倍率、取反、测量换算、保护分合闸及触发录波已接入运行链;本地故障输入、逐项覆盖和仍缺定义的 FA/通信等项目见 [DTU 运行模型](docs/examples/DTU运行模型.md)。
|
||||
倍率、取反、测量换算、保护分合闸及触发录波已接入运行链;本地故障输入、逐项覆盖和仍缺定义的 FA/通信等项目见 [DTU 运行模型](../docs/iec60870/examples/DTU运行模型.md)。
|
||||
|
||||
```powershell
|
||||
./scripts/build.ps1
|
||||
@@ -103,9 +103,9 @@ IEC60870-Slave/
|
||||
./.build/slave-example/iec104_slave_example.exe --ca 1
|
||||
```
|
||||
|
||||
默认监听 `127.0.0.1:2404`;`--ca 1` 指定公共地址,不能只写 `--ca`。默认开启参数处理及field模拟输入,以达到门限的COT=3变化上送为主、低频COT=2背景刷新8个遥测,固定周期COT=1按需开启。主站用 Type102、COT=5、CA=1、IOA=0x4001(十进制16385)读取当前处理值,返回 Type11;其初始值2300随默认模拟运行变化,精确核对初值时加`--events 0`启动。具体默认值、模拟工况及操作步骤见[示例说明](docs/examples/IEC104子站示例.md#example-quick-start)。
|
||||
默认监听 `127.0.0.1:2404`;`--ca 1` 指定公共地址,不能只写 `--ca`。默认开启参数处理及field模拟输入,以达到门限的COT=3变化上送为主、低频COT=2背景刷新8个遥测,固定周期COT=1按需开启。主站用 Type102、COT=5、CA=1、IOA=0x4001(十进制16385)读取当前处理值,返回 Type11;其初始值2300随默认模拟运行变化,精确核对初值时加`--events 0`启动。具体默认值、模拟工况及操作步骤见[示例说明](../docs/iec60870/examples/IEC104子站示例.md#example-quick-start)。
|
||||
|
||||
主示例总召遥信使用Type1/3,总召之外的变位、遥控返回和Read遥信使用带CP56的Type30/31。默认全部命令点须选择后执行或撤销,选择保持60秒;没有S/E字段的51/64仅在`--command-extensions`下启用。集中点表按十六进制分区配置,旧标准参数INI须按[迁移说明](docs/examples/IEC104子站示例.md#example-point-migration)迁移;通用库仍保留显式无时标/双报及DIRECT能力。各模块职责、快照寿命及兼容边界见[默认策略设计](docs/104/IEC104_设计架构.md#spec-alignment-design)。
|
||||
主示例总召遥信使用Type1/3,总召之外的变位、遥控返回和Read遥信使用带CP56的Type30/31。默认全部命令点须选择后执行或撤销,选择保持60秒;没有S/E字段的51/64仅在`--command-extensions`下启用。集中点表按十六进制分区配置,旧标准参数INI须按[迁移说明](../docs/iec60870/examples/IEC104子站示例.md#example-point-migration)迁移;通用库仍保留显式无时标/双报及DIRECT能力。各模块职责、快照寿命及兼容边界见[默认策略设计](../docs/iec60870/104/IEC104_设计架构.md#spec-alignment-design)。
|
||||
|
||||
```powershell
|
||||
# 全量测试:需要 GCC 和 Node.js
|
||||
@@ -141,52 +141,52 @@ IEC60870-Slave/
|
||||
| 路径 | 用途 |
|
||||
|---|---|
|
||||
| `.build/slave-example/iec104_slave_example.exe` | 可供主站连接的示例程序 |
|
||||
| `.build/slave-example/iec104_dtu_example.exe` | DTU 100V/1A 点表、五区定值及完整业务演示;[实现组织](docs/examples/DTU配置演示.md#实现组织与数据流) |
|
||||
| `.build/slave-example/iec104_dtu_example.exe` | DTU 100V/1A 点表、五区定值及完整业务演示;[实现组织](../docs/iec60870/examples/DTU配置演示.md#实现组织与数据流) |
|
||||
| `.build/slave-example/tests/` | 自动测试可执行程序,由脚本运行 |
|
||||
| `test/` | 保留测试源码及真实TCP回环脚本 |
|
||||
|
||||
需要独立构建目录时使用 `-BuildName read-check`,随后运行 `.build/read-check/iec104_slave_example.exe`。它不会更新默认目录的exe。脚本会打印本次实际产物和启动命令;示例运行中不能覆盖同一路径的exe,应先退出该示例或换BuildName。
|
||||
|
||||
`-Test`覆盖公共ASDU、传输容量矩阵及ACK观察、Slave、示例业务、遥控、读命令、系统命令、参数装载及扩展、突发、Type42故障事件、召唤规则及真实TCP回环。实际执行配置数由脚本输出;完整Suite列表与覆盖范围见[测试说明](docs/test/IEC104测试文档.md#1-当前测试入口)。构建参数和源文件依赖统一维护在[build.ps1](scripts/build.ps1)。
|
||||
`-Test`覆盖公共ASDU、传输容量矩阵及ACK观察、Slave、示例业务、遥控、读命令、系统命令、参数装载及扩展、突发、Type42故障事件、召唤规则及真实TCP回环。实际执行配置数由脚本输出;完整Suite列表与覆盖范围见[测试说明](../docs/iec60870/test/IEC104测试文档.md#1-当前测试入口)。构建参数和源文件依赖统一维护在[build.ps1](scripts/build.ps1)。
|
||||
|
||||
`.build/`是本地生成目录,已加入忽略规则。旧exe和编译中间文件可以重新生成;历史`RESULTS.txt`、测量记录及`before/`快照用于追溯,不能作为当前启动入口。
|
||||
|
||||
## 接入自己的工程
|
||||
|
||||
附录C运行日志由`IEC60870_UserLog`循环保存1024条,`IEC60870_UserLogFile`生成`HISTORY/ULOG/ulog.xml`。示例加`--user-log existing-directory`独立启用并自动开启Type210,不隐含`--history`;启动、通道状态、实际参数变更及带模式标记的升级阶段按事实记录。04..09硬件来源通过公共Append接入,当前示例不生成假硬件事件。类型、XML字段取舍、持久恢复与移植边界见[运行日志设计](docs/common/IEC60870_UserLog_设计架构.md#user-log-design),操作见[日志示例](docs/examples/IEC104子站示例.md#example-user-log),验证见[日志测试](docs/test/IEC104测试文档.md#user-log-tests)。
|
||||
附录C运行日志由`IEC60870_UserLog`循环保存1024条,`IEC60870_UserLogFile`生成`HISTORY/ULOG/ulog.xml`。示例加`--user-log existing-directory`独立启用并自动开启Type210,不隐含`--history`;启动、通道状态、实际参数变更及带模式标记的升级阶段按事实记录。04..09硬件来源通过公共Append接入,当前示例不生成假硬件事件。类型、XML字段取舍、持久恢复与移植边界见[运行日志设计](../docs/iec60870/common/IEC60870_UserLog_设计架构.md),操作见[日志示例](../docs/iec60870/examples/IEC104子站示例.md#example-user-log),验证见[日志测试](../docs/iec60870/test/IEC104测试文档.md#user-log-tests)。
|
||||
|
||||
附录B历史由`IEC60870_History`维护SOE、遥控、定点和极值,`IEC60870_HistoryFile`流式生成XML。示例加`--history existing-directory`启用宿主持久存储并自动开启Type210;保存1024条SOE、30条遥控及32个日槽,导出最新30个完整历史日。库核心使用调用方提供的原子持久提交接口;Windows示例使用独占文件、双副本和系统同步。设计与持久性边界见[历史记录设计](docs/common/IEC60870_History_设计架构.md),启动和调阅见[历史示例](docs/examples/IEC104子站示例.md#example-history),专项入口见[历史测试](docs/test/IEC104测试文档.md#history-tests)。
|
||||
附录B历史由`IEC60870_History`维护SOE、遥控、定点和极值,`IEC60870_HistoryFile`流式生成XML。示例加`--history existing-directory`启用宿主持久存储并自动开启Type210;保存1024条SOE、30条遥控及32个日槽,导出最新30个完整历史日。库核心使用调用方提供的原子持久提交接口;Windows示例使用独占文件、双副本和系统同步。设计与持久性边界见[历史记录设计](../docs/iec60870/common/IEC60870_History_设计架构.md),启动和调阅见[历史示例](../docs/iec60870/examples/IEC104子站示例.md#example-history),专项入口见[历史测试](../docs/iec60870/test/IEC104测试文档.md#history-tests)。
|
||||
|
||||
Type42故障事件使用`IEC60870_FaultEvent`专用编解码和`IEC104_Spontaneous_Publish_Fault_Event`发布入口。应用提供故障时刻冻结的遥信、CP56时标和至少八项电气量,104按已确认的接收端布局使用统一3字节地址及无QDS遥测,默认短浮点;发送沿用NORMAL缓存和故障事件第6级。格式依据、与实施细则的地址差异及调用示例见[故障事件设计](docs/common/IEC60870_FaultEvent_设计架构.md)。接入Spontaneous的工程须同时编译`common/IEC60870_FaultEvent.c`。
|
||||
Type42故障事件使用`IEC60870_FaultEvent`专用编解码和`IEC104_Spontaneous_Publish_Fault_Event`发布入口。应用提供故障时刻冻结的遥信、CP56时标和至少八项电气量,104按已确认的接收端布局使用统一3字节地址及无QDS遥测,默认短浮点;发送沿用NORMAL缓存和故障事件第6级。格式依据、与实施细则的地址差异及调用示例见[故障事件设计](../docs/iec60870/common/IEC60870_FaultEvent_设计架构.md)。接入Spontaneous的工程须同时编译`common/IEC60870_FaultEvent.c`。
|
||||
|
||||
连续波形由`IEC60870_FaultRecorder`接收调用方采样,`IEC60870_Comtrade`生成1999格式CFG/BINARY DAT。主示例加`--recording-demo existing-directory`保存一份明确标记的模拟录波,并通过COMTRADE虚拟目录提供下载。模块位置、窗口与迟触发容量、文件布局及生命周期见[录波设计](docs/common/IEC60870_FaultRecorder_设计架构.md);真实采样、及时故障上送、多记录和持久存储见[产品接入要求](docs/common/IEC60870_FaultRecorder_设计架构.md#fault-recording-product)。运行步骤见[录波示例](docs/examples/IEC104子站示例.md#example-recording),已有验证及未验收范围见[录波测试](docs/test/IEC104测试文档.md#recording-tests)。
|
||||
连续波形由`IEC60870_FaultRecorder`接收调用方采样,`IEC60870_Comtrade`生成1999格式CFG/BINARY DAT。主示例加`--recording-demo existing-directory`保存一份明确标记的模拟录波,并通过COMTRADE虚拟目录提供下载。模块位置、窗口与迟触发容量、文件布局及生命周期见[录波设计](../docs/iec60870/common/IEC60870_FaultRecorder_设计架构.md);真实采样、及时故障上送、多记录和持久存储见[产品接入要求](../docs/iec60870/common/IEC60870_FaultRecorder_设计架构.md#fault-recording-product)。运行步骤见[录波示例](../docs/iec60870/examples/IEC104子站示例.md#example-recording),已有验证及未验收范围见[录波测试](../docs/iec60870/test/IEC104测试文档.md#recording-tests)。
|
||||
|
||||
电能量支持短浮点Type206/207,复用Type101计数量召唤及Spontaneous的COT=3上送。示例默认206读取当前示值,`--counter-type 207`读取冻结值和原冻结时刻;15/37整数模式可显式选择。点地址、单位和内存边界见[计数量示例](docs/examples/IEC104子站示例.md#计数量与主循环),协议范围见[计数量设计](docs/104/IEC104_CounterInterrogation_设计架构.md#1-请求与数据)。
|
||||
电能量支持短浮点Type206/207,复用Type101计数量召唤及Spontaneous的COT=3上送。示例默认206读取当前示值,`--counter-type 207`读取冻结值和原冻结时刻;15/37整数模式可显式选择。点地址、单位和内存边界见[计数量示例](../docs/iec60870/examples/IEC104子站示例.md#计数量与主循环),协议范围见[计数量设计](../docs/iec60870/104/IEC104_CounterInterrogation_设计架构.md#1-请求与数据)。
|
||||
|
||||
示例加`--energy-freeze existing-directory --energy-period-ms 1200000`启用独立energy.store、整数方波计量和Type210下的`HISTORY/FRZ`、`HISTORY/FLOWREV`,目录必须已存在。该模式采用Type206及QCC=0x05,BEGIN冻结本轮读取快照;QRP1保留计量与持久文件。记录封存、双bank故障边界、八值恢复和临时内存开销见[冻结电能设计](docs/common/IEC60870_EnergyFreeze_设计架构.md)。
|
||||
示例加`--energy-freeze existing-directory --energy-period-ms 1200000`启用独立energy.store、整数方波计量和Type210下的`HISTORY/FRZ`、`HISTORY/FLOWREV`,目录必须已存在。该模式采用Type206及QCC=0x05,BEGIN冻结本轮读取快照;QRP1保留计量与持久文件。记录封存、双bank故障边界、八值恢复和临时内存开销见[冻结电能设计](../docs/iec60870/common/IEC60870_EnergyFreeze_设计架构.md)。
|
||||
|
||||
Type211软件升级由独立`IEC104_SoftwareUpgrade`提供。`--file-service --software-upgrade`保留RAM演示;`--upgrade-store existing-directory`启用真实文件存储、`dtu/dtu-1`安装备份及跨进程恢复,首次需`--upgrade-seed`提供完整旧程序包。两模式均可用202读回版本/CRC,宿主不执行收到的负载。见[持久安装设计与用法](docs/common/IEC60870_FirmwareUpdate_设计架构.md)、[协议设计](docs/104/IEC104_SoftwareUpgrade_设计架构.md)及[验证](docs/test/IEC104测试文档.md#firmware-update-tests)。
|
||||
Type211软件升级由独立`IEC104_SoftwareUpgrade`提供。`--file-service --software-upgrade`保留RAM演示;`--upgrade-store existing-directory`启用真实文件存储、`dtu/dtu-1`安装备份及跨进程恢复,首次需`--upgrade-seed`提供完整旧程序包。两模式均可用202读回版本/CRC,宿主不执行收到的负载。见[持久安装设计与用法](../docs/iec60870/common/IEC60870_FirmwareUpdate_设计架构.md)、[协议设计](../docs/iec60870/104/IEC104_SoftwareUpgrade_设计架构.md)及[验证](../docs/iec60870/test/IEC104测试文档.md#firmware-update-tests)。
|
||||
|
||||
移植软件安装时,公共核心只接收存储及安装回调,Windows后端作为实文件参考实现。协议ACK、持久授权和健康确认分别由不同入口完成;错误处理须区分候选拒绝与提交结果不确定。按[升级文档导航](docs/README.md#firmware-update-guide)阅读布局、接口、恢复和调用时序;首次操作从[持久模式示例](docs/examples/IEC104子站示例.md#example-firmware-update)开始。目标Flash、Bootloader跳转和真实应用健康条件的接入范围见[板端边界](docs/common/IEC60870_FirmwareUpdate_设计架构.md#firmware-update-target)。
|
||||
移植软件安装时,公共核心只接收存储及安装回调,Windows后端作为实文件参考实现。协议ACK、持久授权和健康确认分别由不同入口完成;错误处理须区分候选拒绝与提交结果不确定。按[升级文档导航](../docs/iec60870/README.md#firmware-update-guide)阅读布局、接口、恢复和调用时序;首次操作从[持久模式示例](../docs/iec60870/examples/IEC104子站示例.md#example-firmware-update)开始。目标Flash、Bootloader跳转和真实应用健康条件的接入范围见[板端边界](../docs/iec60870/common/IEC60870_FirmwareUpdate_设计架构.md#firmware-update-target)。
|
||||
|
||||
Type200–203 远程参数由独立 `IEC104_RemoteParameter` 模块提供;通用示例默认关闭,加 `--remote-parameter` 开启,DTU 示例默认开启。支持切区、读区、TLV 分帧读取和预置/固化/撤销,存储与权限由应用实现。见[远程参数设计](docs/104/IEC104_RemoteParameter_设计架构.md)、[通用示例点表](docs/examples/IEC104子站示例.md#example-remote-parameter)、[DTU 定值与恢复](docs/examples/DTU配置演示.md#标准参数与远程定值)及[专项验证](docs/test/IEC104测试文档.md#remote-parameter-tests)。
|
||||
Type200–203 远程参数由独立 `IEC104_RemoteParameter` 模块提供;通用示例默认关闭,加 `--remote-parameter` 开启,DTU 示例默认开启。支持切区、读区、TLV 分帧读取和预置/固化/撤销,存储与权限由应用实现。见[远程参数设计](../docs/iec60870/104/IEC104_RemoteParameter_设计架构.md)、[通用示例点表](../docs/iec60870/examples/IEC104子站示例.md#example-remote-parameter)、[DTU 定值与恢复](../docs/iec60870/examples/DTU配置演示.md#标准参数与远程定值)及[专项验证](../docs/iec60870/test/IEC104测试文档.md#remote-parameter-tests)。
|
||||
|
||||
Type210 文件服务由独立 `IEC104_FileService` 提供;示例加 `--file-service` 开启,默认关闭。支持目录快照、IDLE读文件、连续写段的BUSY背压和COMMIT原子发布;普通TEMP文件可随`--config`保存到宿主文件,读取目录仍使用示例虚拟目录。见[文件服务设计](docs/104/IEC104_FileService_设计架构.md)、[示例用法](docs/examples/IEC104子站示例.md#example-file-service)及[专项验证](docs/test/IEC104测试文档.md#file-service-tests)。
|
||||
Type210 文件服务由独立 `IEC104_FileService` 提供;示例加 `--file-service` 开启,默认关闭。支持目录快照、IDLE读文件、连续写段的BUSY背压和COMMIT原子发布;普通TEMP文件可随`--config`保存到宿主文件,读取目录仍使用示例虚拟目录。见[文件服务设计](../docs/iec60870/104/IEC104_FileService_设计架构.md)、[示例用法](../docs/iec60870/examples/IEC104子站示例.md#example-file-service)及[专项验证](../docs/iec60870/test/IEC104测试文档.md#file-service-tests)。
|
||||
|
||||
Type110–113标准参数默认开启,`--no-parameter`可关闭。通用示例提供32项,DTU示例提供120项,用于遥测门限、平滑和量程品质处理,并支持总召读回;点表、QPA3周期控制及操作步骤见[参数应用](docs/examples/IEC104子站示例.md#example-parameter)和[DTU参数](docs/examples/DTU配置演示.md#标准参数与远程定值)。协议模块只负责通信,可选扩展及接入见[参数设计](docs/104/IEC104_Parameter_设计架构.md)和[调用流程](docs/104/IEC104_完整调用流程.md#flow-parameter)。
|
||||
Type110–113标准参数默认开启,`--no-parameter`可关闭。通用示例提供32项,DTU示例提供120项,用于遥测门限、平滑和量程品质处理,并支持总召读回;点表、QPA3周期控制及操作步骤见[参数应用](../docs/iec60870/examples/IEC104子站示例.md#example-parameter)和[DTU参数](../docs/iec60870/examples/DTU配置演示.md#标准参数与远程定值)。协议模块只负责通信,可选扩展及接入见[参数设计](../docs/iec60870/104/IEC104_Parameter_设计架构.md)和[调用流程](../docs/iec60870/104/IEC104_完整调用流程.md#flow-parameter)。
|
||||
|
||||
主示例可加`--config .build/slave-example/parameters.ini`,用一份INI保存和恢复标准参数、远程参数及TEMP文件,备份恢复只需该文件;不指定则只保存在内存。格式、旧文件迁移、加载校验和保存失败规则见[持久化说明](docs/examples/IEC104子站示例.md#example-parameter-persistence)。存储属于示例应用,不加入协议库。
|
||||
主示例可加`--config .build/slave-example/parameters.ini`,用一份INI保存和恢复标准参数、远程参数及TEMP文件,备份恢复只需该文件;不指定则只保存在内存。格式、旧文件迁移、加载校验和保存失败规则见[持久化说明](../docs/iec60870/examples/IEC104子站示例.md#example-parameter-persistence)。存储属于示例应用,不加入协议库。
|
||||
|
||||
周期扫描使用独立IDLE直发通道,保留HIGH/NORMAL调度。背景扫描默认开启;需要固定周期快照时可加`--cyclic-ms 1000`,背景周期由`--background-ms`单独调整,`--sequence`显式开启连续IOA编码。周期是名义网格,持续应答或突发可能使扫描延迟;点级周期、在线停用和整表替换见[扫描设计](docs/104/IEC104_PeriodicScan_设计架构.md)。
|
||||
周期扫描使用独立IDLE直发通道,保留HIGH/NORMAL调度。背景扫描默认开启;需要固定周期快照时可加`--cyclic-ms 1000`,背景周期由`--background-ms`单独调整,`--sequence`显式开启连续IOA编码。周期是名义网格,持续应答或突发可能使扫描延迟;点级周期、在线停用和整表替换见[扫描设计](../docs/iec60870/104/IEC104_PeriodicScan_设计架构.md)。
|
||||
|
||||
将 `104/` 和 `common/` 加入头文件搜索路径,使用业务模块时再加入 `104/business/`;按所用模块选择源文件,Windows网络后端链接 `Ws2_32`。统一入口为 `IEC104_Slave.h`,模块职责与依赖见[模块索引](docs/104/README.md),执行顺序见[完整调用流程](docs/104/IEC104_完整调用流程.md)。
|
||||
将 `104/` 和 `common/` 加入头文件搜索路径,使用业务模块时再加入 `104/business/`;按所用模块选择源文件,Windows网络后端链接 `Ws2_32`。统一入口为 `IEC104_Slave.h`,模块职责与依赖见[模块索引](../docs/iec60870/104/README.md),执行顺序见[完整调用流程](../docs/iec60870/104/IEC104_完整调用流程.md)。
|
||||
|
||||
按本目录细则接入启动补发时,使用 `IEC104_Startup_Config_Default` 统一设置传输、初始化、总召、计数量召唤和突发配置,再由 `IEC104_Startup` 协调本轮 Type70 与各站总召完成;主示例使用同一入口。配置函数不创建业务模块,也不替应用注册站点、登记COI或驱动严格业务循环,完整接线见[统一配置与启动流程](docs/104/IEC104_完整调用流程.md#startup-unified-entry)。五个分散的旧配置入口已移除,主示例和参数多主站示例均接入本轮初始化及总召协调;接口迁移见[迁移说明](docs/104/IEC104_完整调用流程.md#startup-config-migration)。
|
||||
按本目录细则接入启动补发时,使用 `IEC104_Startup_Config_Default` 统一设置传输、初始化、总召、计数量召唤和突发配置,再由 `IEC104_Startup` 协调本轮 Type70 与各站总召完成;主示例使用同一入口。配置函数不创建业务模块,也不替应用注册站点、登记COI或驱动严格业务循环,完整接线见[统一配置与启动流程](../docs/iec60870/104/IEC104_完整调用流程.md#startup-unified-entry)。五个分散的旧配置入口已移除,主示例和参数多主站示例均接入本轮初始化及总召协调;接口迁移见[迁移说明](../docs/iec60870/104/IEC104_完整调用流程.md#startup-config-migration)。
|
||||
|
||||
接收N(S)兼容和收到主站TESTFR后的终端主动探测抑制已统一在链路层实现,无需额外配置。两项修复的条款对应、行为变化、底层接口迁移及验证入口见[链路细则修复汇总](docs/104/IEC104_设计架构.md#link-spec-fixes)。
|
||||
接收N(S)兼容和收到主站TESTFR后的终端主动探测抑制已统一在链路层实现,无需额外配置。两项修复的条款对应、行为变化、底层接口迁移及验证入口见[链路细则修复汇总](../docs/iec60870/104/IEC104_设计架构.md#link-spec-fixes)。
|
||||
|
||||
业务模块的职责、状态和接口见[设计索引](docs/104/README.md#business-module-designs),跨模块的事件分派与发送边界见[业务层总览](docs/104/IEC104_业务层_设计架构.md)。
|
||||
业务模块的职责、状态和接口见[设计索引](../docs/iec60870/104/README.md#business-module-designs),跨模块的事件分派与发送边界见[业务层总览](../docs/iec60870/104/IEC104_业务层_设计架构.md)。
|
||||
|
||||
示例使用模拟点表和时钟;105 QRP1在确认按时被ACK后重建协议实例,不重启宿主进程。报文及操作边界见[系统命令联调](docs/examples/IEC104子站示例.md#example-system-command)。真实采集、设备输出及主站互操作仍由应用接入,完整资料见[文档索引](docs/README.md)。
|
||||
示例使用模拟点表和时钟;105 QRP1在确认按时被ACK后重建协议实例,不重启宿主进程。报文及操作边界见[系统命令联调](../docs/iec60870/examples/IEC104子站示例.md#example-system-command)。真实采集、设备输出及主站互操作仍由应用接入,完整资料见[文档索引](../docs/iec60870/README.md)。
|
||||
|
||||
接入系统命令时,先按[最小调用示例](docs/104/IEC104_完整调用流程.md#flow-system-command)创建模块并登记COI,再分派通知、推进回复及显式调用应用动作。调度与诊断字段见[状态和计数](docs/104/IEC104_API接口汇总.md#system-command-status);模拟复位前须按[收尾步骤](docs/examples/IEC104子站示例.md#example-system-command-shutdown)分别读空业务终结通知和Slave通知。
|
||||
接入系统命令时,先按[最小调用示例](../docs/iec60870/104/IEC104_完整调用流程.md#flow-system-command)创建模块并登记COI,再分派通知、推进回复及显式调用应用动作。调度与诊断字段见[状态和计数](../docs/iec60870/104/IEC104_API接口汇总.md#system-command-status);模拟复位前须按[收尾步骤](../docs/iec60870/examples/IEC104子站示例.md#example-system-command-shutdown)分别读空业务终结通知和Slave通知。
|
||||
|
||||
@@ -337,7 +337,7 @@
|
||||
<MiscControls>--diag_suppress=1,68,111,188,191,546,1293</MiscControls>
|
||||
<Define>USE_HAL_DRIVER,STM32F407xx,NDEBUG,IEC104_TCP_RX_CAPACITY=256,IEC104_TCP_HIGH_CAPACITY=288,IEC104_TCP_NORMAL_CAPACITY=272,IEC104_TCP_RECORD_CAPACITY=4,IEC104_TCP_EVENT_CAPACITY=11,IEC104_INTERROGATION_TASK_CAPACITY=1,IEC104_INTERROGATION_EVENT_CAPACITY=2,IEC104_SYSTEM_COMMAND_TASK_CAPACITY=1,IEC104_SYSTEM_COMMAND_RESET_CAPACITY=1,IEC104_PERIODIC_SCAN_GROUP_CAPACITY=1,IEC104_PARAMETER_TASK_CAPACITY=1,IEC104_REMOTE_PARAMETER_TASK_CAPACITY=1,IEC104_CLOCK_SYNCHRONIZATION_TASK_CAPACITY=1,IEC104_READ_TASK_CAPACITY=1,IEC104_COMMAND_REPLY_CAPACITY=1</Define>
|
||||
<Undefine />
|
||||
<IncludePath>../Inc;../Drivers/STM32F4xx_HAL_Driver/Inc;../Drivers/STM32F4xx_HAL_Driver/Inc/Legacy;../Drivers/CMSIS/Device/ST/STM32F4xx/Include;../Drivers/CMSIS/Include;../Drivers/BSP;../Drivers/BSP/CH395F;../Drivers/BSP/GD5F2GQ5UE;../Drivers/BSP/TPAFE5160;../Drivers/BSP/SD2506;../Drivers/BSP/RS485;../Drivers/BSP/ScreenLink;../Drivers/BSP/NET;../Drivers/BSP/NET/lftpd;../Drivers/BSP/NETCFG;../Drivers/BSP/IOBOARD;../App;../App/app;../App/algo;../App/cfg;../App/fs;../App/log;../App/sync;../App/task;../App/iec60870/common;../App/iec60870/104;../App/iec60870/104/business;../App/iec60870/examples;../App/util;../Middlewares/Third_Party/FreeRTOS/Source/include;../Middlewares/Third_Party/FreeRTOS/Source/CMSIS_RTOS_V2;../Middlewares/Third_Party/FreeRTOS/Source/portable/RVDS/ARM_CM4F;../Lib/dhara;../Lib/FatFs;../test/board;../Lib/lvgl;../Drivers/BSP/UI;../Lib;../Lib/coreSNTP/include</IncludePath>
|
||||
<IncludePath>../Inc;../Drivers/STM32F4xx_HAL_Driver/Inc;../Drivers/STM32F4xx_HAL_Driver/Inc/Legacy;../Drivers/CMSIS/Device/ST/STM32F4xx/Include;../Drivers/CMSIS/Include;../Drivers/BSP;../Drivers/BSP/CH395F;../Drivers/BSP/GD5F2GQ5UE;../Drivers/BSP/TPAFE5160;../Drivers/BSP/SD2506;../Drivers/BSP/RS485;../Drivers/BSP/ScreenLink;../Drivers/BSP/NET;../Drivers/BSP/NET/lftpd;../Drivers/BSP/NETCFG;../Drivers/BSP/IOBOARD;../App;../App/app;../App/algo;../App/cfg;../App/fs;../App/log;../App/sync;../App/task;../App/iec60870/common;../App/iec60870/104;../App/iec60870/104/business;../App/util;../Middlewares/Third_Party/FreeRTOS/Source/include;../Middlewares/Third_Party/FreeRTOS/Source/CMSIS_RTOS_V2;../Middlewares/Third_Party/FreeRTOS/Source/portable/RVDS/ARM_CM4F;../Lib/dhara;../Lib/FatFs;../test/board;../Lib/lvgl;../Drivers/BSP/UI;../Lib;../Lib/coreSNTP/include</IncludePath>
|
||||
</VariousControls>
|
||||
</Cads>
|
||||
<Aads>
|
||||
|
||||
@@ -15,6 +15,7 @@ docs/
|
||||
├── 产品需求/ 产品需求设计文档(需求基线)+ 参考产品复刻明细(逐项差额)
|
||||
├── 架构设计/ 全局架构与设计方法论(含 软件架构与运行时规格 / 硬件规格与能力边界:位表与引脚权威)
|
||||
├── 子系统设计/ 各功能子系统的设计说明
|
||||
├── iec60870/ IEC 60870-5-104 协议库设计与接口文档(36 篇,导航 iec60870/README.md)
|
||||
├── 算法/ 傅氏算法与继电保护算法专题
|
||||
├── 网络/ BSD Socket API 使用与内部实现
|
||||
├── 测试说明/ 测试流程与规范 · 单元测试 · 板级测试 · 专项验证 · 测试工具 · 测试数据(六个子目录,导航 `测试说明/README.md`)
|
||||
@@ -119,6 +120,52 @@ docs/
|
||||
|
||||
---
|
||||
|
||||
### 5.3 IEC 60870-5-104 协议库文档(`docs/iec60870/`,36 篇)
|
||||
|
||||
入口:[`iec60870/README.md`](iec60870/README.md)——按「想干什么」组织的导航(构建、点表、召唤、遥控、参数、文件、升级、历史、录波、日志、排障)。
|
||||
这批文档随 104 协议库从 `IEC60870-Slave/docs/` 迁入本仓文档库(2026-11-18),文中指向源码的链接已改指 `App/iec60870/`;**标「本项目未实现」的 7 篇是能力参考,不代表功能可用**。
|
||||
|
||||
| 文档 | 内容 |
|
||||
|---|---|
|
||||
| [`iec60870/104/IEC104_设计架构.md`](iec60870/104/IEC104_设计架构.md) | 编解码、独立接收器与报文层设计:APCI/ASDU 解析、长度校验、接收状态机 |
|
||||
| [`iec60870/104/IEC104_Link_设计架构.md`](iec60870/104/IEC104_Link_设计架构.md) | 链路层公共/主站/子站:序号、k/w 窗口、TESTFR/STARTDT/STOPDT |
|
||||
| [`iec60870/104/IEC104_Connection_设计架构.md`](iec60870/104/IEC104_Connection_设计架构.md) | 连接协调层:单连接状态、事件产出、断开判定 |
|
||||
| [`iec60870/104/IEC104_TcpServer_设计架构.md`](iec60870/104/IEC104_TcpServer_设计架构.md) | TCP 子站服务与网络适配:静态池、事件环、Net 后端接缝 |
|
||||
| [`iec60870/104/IEC104_发送模块_设计架构.md`](iec60870/104/IEC104_发送模块_设计架构.md) | 发送侧:AsduQueue 分级队列、SendBuffer 字节缓冲、SendManager 调度与 ACK 观察 |
|
||||
| [`iec60870/104/IEC104_业务优先级设计.md`](iec60870/104/IEC104_业务优先级设计.md) | 12 级业务优先级、严格模式、业务收集轮与事务顺序约束 |
|
||||
| [`iec60870/104/IEC104_业务层_设计架构.md`](iec60870/104/IEC104_业务层_设计架构.md) | `104/business/` 总览:各模块如何接请求、管状态、调应用、交报文 |
|
||||
| [`iec60870/104/IEC104_完整调用流程.md`](iec60870/104/IEC104_完整调用流程.md) | 端到端调用流程:总召、遥控、参数、文件、升级、扫描的时序与等待点定位 |
|
||||
| [`iec60870/104/IEC104_API接口汇总.md`](iec60870/104/IEC104_API接口汇总.md) | 全部公开函数按实现文件汇总(最大的单篇参考,约 500 KB) |
|
||||
| [`iec60870/104/IEC104_Interrogation_设计架构.md`](iec60870/104/IEC104_Interrogation_设计架构.md) | 总召引擎:阶段推进、期限、应用事件、广播与取消 |
|
||||
| [`iec60870/104/IEC104_CounterInterrogation_设计架构.md`](iec60870/104/IEC104_CounterInterrogation_设计架构.md) | 计数量召唤:QCC 的 RQT/FRZ 种类规则(复用总召引擎) |
|
||||
| [`iec60870/104/IEC104_Command_设计架构.md`](iec60870/104/IEC104_Command_设计架构.md) | 遥控/遥调/带时标命令:Type 45–51、58–64,选择执行匹配与事务收尾 |
|
||||
| [`iec60870/104/IEC104_ClockSynchronization_设计架构.md`](iec60870/104/IEC104_ClockSynchronization_设计架构.md) | 校时与读时:时区换算、滞留补偿、应用回调边界 |
|
||||
| [`iec60870/104/IEC104_Read_设计架构.md`](iec60870/104/IEC104_Read_设计架构.md) | 读命令 Type102 与应答 FIFO |
|
||||
| [`iec60870/104/IEC104_Spontaneous_设计架构.md`](iec60870/104/IEC104_Spontaneous_设计架构.md) | 突发上送:NORMAL 队列、COT=3 变化上送、Type42 故障事件发布入口 |
|
||||
| [`iec60870/104/IEC104_PeriodicScan_设计架构.md`](iec60870/104/IEC104_PeriodicScan_设计架构.md) | 周期/背景扫描:公共网格调度、IDLE 直发、不缓存点值 |
|
||||
| [`iec60870/104/IEC104_Parameter_设计架构.md`](iec60870/104/IEC104_Parameter_设计架构.md) | 标准参数 Type 110–113:只做通信,不拥有值与持久化 |
|
||||
| [`iec60870/104/IEC104_RemoteParameter_设计架构.md`](iec60870/104/IEC104_RemoteParameter_设计架构.md) | 远程参数 Type 200–203:切区、读区、TLV 分帧、预置/固化/撤销 |
|
||||
| [`iec60870/104/IEC104_SystemCommand_设计架构.md`](iec60870/104/IEC104_SystemCommand_设计架构.md) | 系统命令:104/105/107 测试与复位、70 初始化结束 |
|
||||
| [`iec60870/104/IEC104_FileService_设计架构.md`](iec60870/104/IEC104_FileService_设计架构.md) | 文件服务 Type210(**本项目未实现**,能力参考) |
|
||||
| [`iec60870/104/IEC104_SoftwareUpgrade_设计架构.md`](iec60870/104/IEC104_SoftwareUpgrade_设计架构.md) | 软件升级 Type211(**本项目未实现**,能力参考) |
|
||||
| [`iec60870/104/IEC104_有序应答修复记录.md`](iec60870/104/IEC104_有序应答修复记录.md) | 有序应答修复的问题、判据与回归证据 |
|
||||
| [`iec60870/104/IEC104_通用应答发送变更记录.md`](iec60870/104/IEC104_通用应答发送变更记录.md) | 通用应答发送路径的变更说明与影响面 |
|
||||
| [`iec60870/common/IEC60870_Time_设计架构.md`](iec60870/common/IEC60870_Time_设计架构.md) | 公共时间工具:CP56Time2a/CP24Time2a 编解码与接收策略 |
|
||||
| [`iec60870/common/IEC60870_FaultEvent_设计架构.md`](iec60870/common/IEC60870_FaultEvent_设计架构.md) | Type42 故障事件编解码与发布契约 |
|
||||
| [`iec60870/test/IEC104测试文档.md`](iec60870/test/IEC104测试文档.md) | 库自带测试说明:Suite 清单、覆盖矩阵、执行记录(GCC/MinGW 环境) |
|
||||
| [`iec60870/examples/IEC104子站示例.md`](iec60870/examples/IEC104子站示例.md) | Windows 示例程序的用法、命令行开关与业务演示(**示例不在本仓构建面**) |
|
||||
| [`iec60870/examples/DTU配置演示.md`](iec60870/examples/DTU配置演示.md) | DTU 100V/1A 演示点表、定值区、持久化与升级的配置方法(**示例资产,非现场点表**) |
|
||||
| [`iec60870/examples/DTU运行模型.md`](iec60870/examples/DTU运行模型.md) | DTU 演示的运行模型:模拟采样、电量积分、遥信 pending 与服务发布 |
|
||||
| [`iec60870/common/IEC60870_EnergyFreeze_设计架构.md`](iec60870/common/IEC60870_EnergyFreeze_设计架构.md) | 冻结电能与潮流反转(**本项目未实现**,能力参考) |
|
||||
| [`iec60870/common/IEC60870_FaultRecorder_设计架构.md`](iec60870/common/IEC60870_FaultRecorder_设计架构.md) | 故障录波与 COMTRADE 1999 生成(**本项目未实现**,能力参考;本仓录波走 `App/algo/wave_store`) |
|
||||
| [`iec60870/common/IEC60870_History_设计架构.md`](iec60870/common/IEC60870_History_设计架构.md) | 历史记录与 XML 生成(**本项目未实现**,能力参考) |
|
||||
| [`iec60870/common/IEC60870_UserLog_设计架构.md`](iec60870/common/IEC60870_UserLog_设计架构.md) | 附录 C 运行日志(**本项目未实现**,能力参考;本仓日志走 `App/log/sys_log`) |
|
||||
| [`iec60870/common/IEC60870_FirmwareUpdate_设计架构.md`](iec60870/common/IEC60870_FirmwareUpdate_设计架构.md) | 持久化三槽软件安装与恢复(**本项目未实现**,能力参考) |
|
||||
| [`iec60870/104/README.md`](iec60870/104/README.md) | 104 目录自身说明:文件分工、关键约束、平台适配层 |
|
||||
| [`iec60870/README.md`](iec60870/README.md) | 本批文档的总导航(按目的索引) |
|
||||
|
||||
> **与项目自有 104 文档的关系**:[`子系统设计/IEC104上行设计说明.md`](子系统设计/IEC104上行设计说明.md) 讲**板端怎么接**(点表、数据源、Net 后端、验收状态);本节这批讲**协议库内部怎么实现**。两者不重复:前者是本项目约定与落地状态,后者是协议模块的设计推理。
|
||||
|
||||
## 6. 测试说明
|
||||
|
||||
> 本目录分六个子目录(**归层判据与本目录文件清单 → [`测试说明/README.md`](测试说明/README.md)**);
|
||||
|
||||
@@ -175,7 +175,7 @@ typedef struct {
|
||||
**2026-11-17 通信骨架割接后,问的点表换了源**:旧的产品自有 33 点表实现 `App/protocol/iec104/iec104_pts.c`(`YX_N = 33`、`YX_DP_N = 4`,`iec104_pts_yx_is_dp()` 逐点判型)已随割接删除;现在问的是 DTU 标准表 `iec104_dtu_point()`(`App/iec60870/104/iec104_dtu_table.c`)。两套点表语义不同:新表 index 0~58 是单点(0~42 → IOA 0x0001~0x002B,43~58 → 0x0032~0x0041,源表 0x002C~0x0031 空号)、59~74 是双点(IOA 0x1001 起)、75~104 是测量值,共 59 + 16 = 75 个遥信点,**双点不在 0~3 而在 59~74**。
|
||||
**这不改变任何像素**:本字段只覆盖 `UI_DATA_YX_N = 33` 行,即新表的单点段;双点段落在 33 之外,取不到。而产品视图的 YX1~4(页面名表"位置1~4")在新表里是单点、旧表里是双点——这 4 点 V0.1 无开入硬件,不在 `yx_valid` 内,页面先按 valid 短路打 "--",走不到双点/单点选词分支,所以屏上无差异。**点表口径差异是既有事实,不是本节引入的问题。**
|
||||
点数一致性由写侧一条一次性 `DBG_ERROR` 兜(`UI_DATA_YX_N` 与 DTU 表 `SP_COUNT + DP_COUNT = 75` 不等时留痕)——该口径**自割接起会打且是应打的**:33 行产品视图与 75 点标准表本就不等,这条日志让差异现场可见,不影响显示。
|
||||
- **页面名表与 DTU 标准表同名下标语义不一致——这是既有事实,当前无运行期风险**。产品视图 `s_yx_name`(`Drivers/BSP/UI/ui_page_yx.c`)的前 33 行是按**旧产品点表**起的名;DTU 标准表同位置(前 59 个单点段中的同一 index)是另一批信号。逐点对照(下标取产品视图行号,DTU 侧取 `App/iec60870/examples/iec104_dtu_profile.h` 的 `dtu_signals[]` 原始名):
|
||||
- **页面名表与 DTU 标准表同名下标语义不一致——这是既有事实,当前无运行期风险**。产品视图 `s_yx_name`(`Drivers/BSP/UI/ui_page_yx.c`)的前 33 行是按**旧产品点表**起的名;DTU 标准表同位置(前 59 个单点段中的同一 index)是另一批信号。逐点对照(下标取产品视图行号,DTU 侧取 `App/iec60870/104/iec104_dtu_profile.h` 的 `dtu_signals[]` 原始名):
|
||||
|
||||
| 下标 | 产品视图名(页面) | DTU 标准表同下标信号(原名 / 释义) |
|
||||
|---|---|---|
|
||||
|
||||
@@ -161,7 +161,7 @@
|
||||
|
||||
## 104 默认参数与容量
|
||||
|
||||
`IEC104_APP_LAYER_PARAMETERS_DEFAULT` 位于 [IEC104_Types.h](../../104/IEC104_Types.h),值为 `{1, 1, 2, 0, 2, 3, IEC104_MAX_ASDU_LEN}`,依次为 Type ID、VSQ、COT 宽度、默认 OA、CA 宽度、IOA 宽度及最大 ASDU 长度。标准 104 为 COT/CA/IOA=2/2/3,ASDU 最长 249 字节,APCI 6 字节,APDU 最长 255 字节。共用 ASDU 模块也支持其他布局,104 发送适配器会拒绝不兼容参数。
|
||||
`IEC104_APP_LAYER_PARAMETERS_DEFAULT` 位于 [IEC104_Types.h](../../../App/iec60870/104/IEC104_Types.h),值为 `{1, 1, 2, 0, 2, 3, IEC104_MAX_ASDU_LEN}`,依次为 Type ID、VSQ、COT 宽度、默认 OA、CA 宽度、IOA 宽度及最大 ASDU 长度。标准 104 为 COT/CA/IOA=2/2/3,ASDU 最长 249 字节,APCI 6 字节,APDU 最长 255 字节。共用 ASDU 模块也支持其他布局,104 发送适配器会拒绝不兼容参数。
|
||||
|
||||
`IEC104_CA_BROADCAST`也位于IEC104_Types.h,固定值为`0xFFFFU`,表示104两字节CA的广播地址。它不是配置项;站点注册及总召的兼容common_address配置使用1..65534的实际站地址。绑定station时总召从节点取得CA。共用Asdu_Set_CA只负责字段编码,广播请求的接收与应答规则由对应业务模块决定。
|
||||
|
||||
@@ -171,7 +171,7 @@ Startup统一入口的transport参数填入监听 `0.0.0.0:2404`、k=12、w=8、
|
||||
|
||||
统一入口将`strict_business_priority`设为1,启用12级业务优先级及[集中调度](#slave-business-priority)。该字段只接受0/1,与`startup_event_gate`独立;严格模式的队列条目需要保存业务等级和顺序,容量校验及等级定义见[业务优先级设计](IEC104_业务优先级设计.md)。
|
||||
|
||||
编译期容量见 [IEC104_TcpServer_Config.h](../../104/IEC104_TcpServer_Config.h):服务槽1、接收暂存2048字节、HIGH/普通NORMAL各1024/4096字节,另有独立256×26字节SOE槽及默认32×8字节退休身份;控制帧8槽、发送记录32槽、事件保证容量68条,其中启停保留4条、收尾保留34条、普通通知保证30条。SOE两项存储共6912字节,另计控制字段;normal_queue的容量/占用/空闲为普通区与SOE区聚合值,分区不能互借。实际通知使用变长字节环,短通知可能多于保证条数;这些容量不等于k窗口,队列字节数还包含内部条目头。Slave和直接创建的TcpServer共享底层服务名额。
|
||||
编译期容量见 [IEC104_TcpServer_Config.h](../../../App/iec60870/104/IEC104_TcpServer_Config.h):服务槽1、接收暂存2048字节、HIGH/普通NORMAL各1024/4096字节,另有独立256×26字节SOE槽及默认32×8字节退休身份;控制帧8槽、发送记录32槽、事件保证容量68条,其中启停保留4条、收尾保留34条、普通通知保证30条。SOE两项存储共6912字节,另计控制字段;normal_queue的容量/占用/空闲为普通区与SOE区聚合值,分区不能互借。实际通知使用变长字节环,短通知可能多于保证条数;这些容量不等于k窗口,队列字节数还包含内部条目头。Slave和直接创建的TcpServer共享底层服务名额。
|
||||
|
||||
Command 的实例池与独立应答池另由 `IEC104_COMMAND_CAPACITY`、`IEC104_COMMAND_REPLY_CAPACITY` 配置,分别默认跟随 TCP 服务容量和取 4;每实例仍只有一个遥控事务。宏须作用于 IEC104_Command.c 的编译,详见[遥控配置与容量](#command-api-config)。
|
||||
|
||||
@@ -250,7 +250,7 @@ CONNECTED 先于同代次其他通知,DISCONNECTED 最后;实际启停变化
|
||||
|
||||
## 1. IEC104.c
|
||||
|
||||
实现:[IEC104.c](../../104/IEC104.c);声明:[IEC104.h](../../104/IEC104.h)。
|
||||
实现:`IEC104.c`;声明:`IEC104.h`。
|
||||
|
||||
旧版单路接收兼容入口,使用模块内的全局接收器和私有链路状态。
|
||||
|
||||
@@ -282,7 +282,7 @@ extern IEC104_RxResult_t IEC104_Rx_Feed_Byte(uint8_t byte);
|
||||
|
||||
## 2. IEC104_AsduQueue.c
|
||||
|
||||
实现:[IEC104_AsduQueue.c](../../104/IEC104_AsduQueue.c);声明:[IEC104_AsduQueue.h](../../104/IEC104_AsduQueue.h)。
|
||||
实现:[IEC104_AsduQueue.c](../../../App/iec60870/104/IEC104_AsduQueue.c);声明:[IEC104_AsduQueue.h](../../../App/iec60870/104/IEC104_AsduQueue.h)。
|
||||
|
||||
管理HIGH字节环以及NORMAL生命周期下的普通字节环和独立SOE槽,保存业务原文,不执行构帧或网络发送。SOE存储由Bind_Soe_Storage额外借用,详细容量、覆盖与ACK关系见[发送设计](IEC104_发送模块_设计架构.md#soe-retention)。
|
||||
|
||||
@@ -445,7 +445,7 @@ extern IEC104_AsduQueueResult_t IEC104_AsduQueue_Record_Direct_Response(
|
||||
|
||||
## 3. IEC104_Codec.c
|
||||
|
||||
实现:[IEC104_Codec.c](../../104/IEC104_Codec.c);声明:[IEC104_Codec.h](../../104/IEC104_Codec.h)。
|
||||
实现:[IEC104_Codec.c](../../../App/iec60870/104/IEC104_Codec.c);声明:[IEC104_Codec.h](../../../App/iec60870/104/IEC104_Codec.h)。
|
||||
|
||||
104专用无状态编解码,只检查完整APDU的APCI并构造I/S/U帧。公共ASDU参数和公共头解析位于 `IEC60870_Types.h`、`IEC60870_Codec.c/h`,本模块不提供公共ASDU解析声明。
|
||||
|
||||
@@ -489,7 +489,7 @@ extern int IEC104_Build_Uframe(uint8_t *buf, int function);
|
||||
|
||||
## 4. IEC104_Connection.c
|
||||
|
||||
实现:[IEC104_Connection.c](../../104/IEC104_Connection.c);声明:[IEC104_Connection.h](../../104/IEC104_Connection.h)。
|
||||
实现:[IEC104_Connection.c](../../../App/iec60870/104/IEC104_Connection.c);声明:[IEC104_Connection.h](../../../App/iec60870/104/IEC104_Connection.h)。
|
||||
|
||||
子站单连接协调层,串行衔接 Receiver、Link 和 SendManager,管理期限与接收批次;由 TcpServer 调用,不执行 socket I/O。
|
||||
|
||||
@@ -644,7 +644,7 @@ extern IEC104_ConnectionResult_t IEC104_Connection_Close(
|
||||
|
||||
## 5. IEC104_Link.c
|
||||
|
||||
实现:[IEC104_Link.c](../../104/IEC104_Link.c);声明:[IEC104_Link_Common.h](../../104/IEC104_Link_Common.h)、[IEC104_Link_Internal.h](../../104/IEC104_Link_Internal.h)。
|
||||
实现:[IEC104_Link.c](../../../App/iec60870/104/IEC104_Link.c);声明:[IEC104_Link_Common.h](../../../App/iec60870/104/IEC104_Link_Common.h)、[IEC104_Link_Internal.h](../../../App/iec60870/104/IEC104_Link_Internal.h)。
|
||||
|
||||
主站与子站共用的链路状态、序号、窗口、S 确认和 TESTFR 算法;不执行网络 I/O。标有“内部协作”的函数供链路实现跨文件调用。
|
||||
|
||||
@@ -793,7 +793,7 @@ extern int IEC104_Link_T1_Testfr_Con_Expired(
|
||||
|
||||
## 6. IEC104_Link_Master_StartStop.c
|
||||
|
||||
实现:[IEC104_Link_Master_StartStop.c](../../104/IEC104_Link_Master_StartStop.c);声明:[IEC104_Link_Master_StartStop.h](../../104/IEC104_Link_Master_StartStop.h)。
|
||||
实现:`IEC104_Link_Master_StartStop.c`;声明:`IEC104_Link_Master_StartStop.h`。
|
||||
|
||||
控制站主动 STARTDT/STOPDT 流程;当前 TcpServer 是子站实现,不通过这些入口发起启停。
|
||||
|
||||
@@ -856,7 +856,7 @@ extern int IEC104_Link_T1_Stopdt_Con_Expired(
|
||||
|
||||
## 7. IEC104_Link_Slave_StartStop.c
|
||||
|
||||
实现:[IEC104_Link_Slave_StartStop.c](../../104/IEC104_Link_Slave_StartStop.c);声明:[IEC104_Link_Slave_StartStop.h](../../104/IEC104_Link_Slave_StartStop.h)。
|
||||
实现:[IEC104_Link_Slave_StartStop.c](../../../App/iec60870/104/IEC104_Link_Slave_StartStop.c);声明:[IEC104_Link_Slave_StartStop.h](../../../App/iec60870/104/IEC104_Link_Slave_StartStop.h)。
|
||||
|
||||
被控站启停采用 ACT 受理即改变状态的模型;CON 的发送完成不回写启停状态。
|
||||
|
||||
@@ -904,7 +904,7 @@ extern IEC104_LinkResult_t IEC104_Link_Complete_Stopdt_Con_Send(
|
||||
|
||||
## 8. IEC104_Log.c
|
||||
|
||||
实现:[IEC104_Log.c](../../104/IEC104_Log.c);声明:[IEC104_Log.h](../../104/IEC104_Log.h)。
|
||||
实现:`IEC104_Log.c`;声明:`IEC104_Log.h`。
|
||||
|
||||
通用日志输出,使用固定栈缓冲;日志配置不带内部锁。
|
||||
|
||||
@@ -936,7 +936,7 @@ extern void IEC104_Log_Emit(int level, const char *fmt, ...);
|
||||
|
||||
## 9. IEC104_Net_Windows.c
|
||||
|
||||
实现:[IEC104_Net_Windows.c](../../104/IEC104_Net_Windows.c);声明:[IEC104_Net.h](../../104/IEC104_Net.h)。
|
||||
实现:[IEC104_Net_Windows.c](../../../App/iec60870/104/IEC104_Net_Windows.c);声明:[IEC104_Net.h](../../../App/iec60870/104/IEC104_Net.h)。
|
||||
|
||||
Windows 同步非阻塞网络后端,将 Winsock 操作和错误转换为通用网络接口结果。
|
||||
|
||||
@@ -1003,7 +1003,7 @@ extern uint64_t IEC104_Net_Now_Ms(void);
|
||||
|
||||
## 10. IEC104_Receiver.c
|
||||
|
||||
实现:[IEC104_Receiver.c](../../104/IEC104_Receiver.c);声明:[IEC104_Receiver.h](../../104/IEC104_Receiver.h)。
|
||||
实现:[IEC104_Receiver.c](../../../App/iec60870/104/IEC104_Receiver.c);声明:[IEC104_Receiver.h](../../../App/iec60870/104/IEC104_Receiver.h)。
|
||||
|
||||
每连接独立的流式接收器,一次保留一帧完整 APDU,不处理链路序号或协议 ACK。
|
||||
|
||||
@@ -1057,7 +1057,7 @@ extern IEC104_ReceiverResult_t IEC104_Receiver_Reset(
|
||||
|
||||
## 11. IEC104_SendBuffer.c
|
||||
|
||||
实现:[IEC104_SendBuffer.c](../../104/IEC104_SendBuffer.c);声明:[IEC104_SendBuffer.h](../../104/IEC104_SendBuffer.h)。
|
||||
实现:[IEC104_SendBuffer.c](../../../App/iec60870/104/IEC104_SendBuffer.c);声明:[IEC104_SendBuffer.h](../../../App/iec60870/104/IEC104_SendBuffer.h)。
|
||||
|
||||
保存一个当前 I 帧及独立的 S/U 控制 FIFO,管理预留、写入进度和本地发送期限,不执行网络 I/O。
|
||||
|
||||
@@ -1130,7 +1130,7 @@ extern void IEC104_SendBuffer_Abort(IEC104_SendBuffer_t *buffer);
|
||||
|
||||
## 12. IEC104_SendManager.c
|
||||
|
||||
实现:[IEC104_SendManager.c](../../104/IEC104_SendManager.c);声明:[IEC104_SendManager.h](../../104/IEC104_SendManager.h)。
|
||||
实现:[IEC104_SendManager.c](../../../App/iec60870/104/IEC104_SendManager.c);声明:[IEC104_SendManager.h](../../../App/iec60870/104/IEC104_SendManager.h)。
|
||||
|
||||
子站发送管理层,统一协调 Link、SendBuffer、AsduQueue 和 I 帧记录;当前只绑定 CONTROLLED 角色,不执行网络 I/O。
|
||||
|
||||
@@ -1315,9 +1315,9 @@ typedef struct {
|
||||
|
||||
## 13. IEC104_TcpServer.c
|
||||
|
||||
实现:[IEC104_TcpServer.c](../../104/IEC104_TcpServer.c);声明:[IEC104_TcpServer.h](../../104/IEC104_TcpServer.h)。
|
||||
实现:[IEC104_TcpServer.c](../../../App/iec60870/104/IEC104_TcpServer.c);声明:[IEC104_TcpServer.h](../../../App/iec60870/104/IEC104_TcpServer.h)。
|
||||
|
||||
IPv4 子站的底层 TCP 服务,供 Slave 调用或由集成方独立使用,内部持有连接、队列、缓冲和事件 FIFO。一个服务同时管理一个活动主站;全部操作由所属线程串行驱动。共用值类型声明在 [IEC104_TcpTypes.h](../../104/IEC104_TcpTypes.h),业务主入口见 [Slave](#file-19)。
|
||||
IPv4 子站的底层 TCP 服务,供 Slave 调用或由集成方独立使用,内部持有连接、队列、缓冲和事件 FIFO。一个服务同时管理一个活动主站;全部操作由所属线程串行驱动。共用值类型声明在 [IEC104_TcpTypes.h](../../../App/iec60870/104/IEC104_TcpTypes.h),业务主入口见 [Slave](#file-19)。
|
||||
|
||||
调用约定:Create → Startup统一配置/Init → Poll/NextEvent(或 Prepare/Process)→ Close → NextEvent 读空 → Destroy。Send_Response 输入原请求 generation 及不含 APCI 的 ASDU 字节;Enqueue_Event 同样输入 ASDU 原文,不能传完整 I 帧。直接使用本层时,应答来源身份由集成方保存;通过 Slave 时这些步骤已封装。
|
||||
|
||||
@@ -1513,7 +1513,7 @@ typedef enum {
|
||||
|
||||
## 14. IEC60870_Clock.c
|
||||
|
||||
实现:[IEC60870_Clock.c](../../common/IEC60870_Clock.c);声明:[IEC60870_Clock.h](../../common/IEC60870_Clock.h)。
|
||||
实现:`IEC60870_Clock.c`;声明:`IEC60870_Clock.h`。
|
||||
|
||||
读取或设置实际时钟,公共日历统一为固定 UTC+8 标准时间。Windows 实现已提供;RTC 由编译选项选择并调用外部驱动接口。
|
||||
|
||||
@@ -1544,7 +1544,7 @@ int IEC60870_Clock_Set(const IEC60870_WallTime_t *local_time);
|
||||
|
||||
## 15. IEC60870_Time.c
|
||||
|
||||
实现:[IEC60870_Time.c](../../common/IEC60870_Time.c);声明:[IEC60870_Time.h](../../common/IEC60870_Time.h)。
|
||||
实现:[IEC60870_Time.c](../../../App/iec60870/common/IEC60870_Time.c);声明:[IEC60870_Time.h](../../../App/iec60870/common/IEC60870_Time.h)。
|
||||
|
||||
101/104 共用的日历、纪元秒数和 CP16/CP24/CP56Time2a 工具;普通日历范围为 1970~2099 年,CP56 范围为 2000~2099 年,不读取或设置实际时钟。
|
||||
|
||||
@@ -1614,7 +1614,7 @@ int IEC60870_Time_From_CP56(const uint8_t *in, size_t length, IEC60870_CP56Time2
|
||||
|
||||
## 16. IEC60870_Asdu.c
|
||||
|
||||
实现:[IEC60870_Asdu.c](../../common/IEC60870_Asdu.c);声明:[IEC60870_Asdu.h](../../common/IEC60870_Asdu.h)。
|
||||
实现:[IEC60870_Asdu.c](../../../App/iec60870/common/IEC60870_Asdu.c);声明:[IEC60870_Asdu.h](../../../App/iec60870/common/IEC60870_Asdu.h)。
|
||||
|
||||
通用ASDU容器使用调用方存储和显式非空参数,参数在使用期间必须有效且不变。所有结果须显式比较`IEC60870_ASDU_OK`;FULL为容量或数量已满,ERROR为参数/格式错误,UNSUPPORTED为未知类型。单次ASDU接口失败不修改输出;Create产生的空构造容器不能导出,Create_From_Buffer借用对象沿用公共头最低长度校验。
|
||||
|
||||
@@ -1682,7 +1682,7 @@ IEC60870_AsduResult_t IEC60870_Asdu_Build_Response(const IEC60870_AppLayerParame
|
||||
|
||||
## 17. IEC60870_InformationObjects.c
|
||||
|
||||
实现:[IEC60870_InformationObjects.c](../../common/IEC60870_InformationObjects.c);公开声明:[IEC60870_InformationObjects.h](../../common/IEC60870_InformationObjects.h);内部协作声明:[IEC60870_InformationObjects_Internal.h](../../common/IEC60870_InformationObjects_Internal.h)。
|
||||
实现:[IEC60870_InformationObjects.c](../../../App/iec60870/common/IEC60870_InformationObjects.c);公开声明:[IEC60870_InformationObjects.h](../../../App/iec60870/common/IEC60870_InformationObjects.h);内部协作声明:[IEC60870_InformationObjects_Internal.h](../../../App/iec60870/common/IEC60870_InformationObjects_Internal.h)。
|
||||
|
||||
每种类型独立结构与Create/Get_From_Buffer,编码通过公共基类绑定的只读函数表。Create不分配内存,Get_From_Buffer只接收不含IOA的精确载荷和已解析IOA;结果按值保存,不借用输入。带CP24/CP56的普通监视与控制对象复用基础值处理;保护类型保留QDP及CP16。文件段对象有255字节独立存储,Create和解析复制段数据;ASDU按配置计算实际可发送长度。所有失败保持输出不变。
|
||||
|
||||
@@ -2299,7 +2299,7 @@ IEC60870_AsduResult_t IEC60870_InformationObject_Decode(uint8_t type_id, uint32_
|
||||
|
||||
## 18. IEC60870_Slave.c
|
||||
|
||||
实现:[IEC60870_Slave.c](../../common/IEC60870_Slave.c);声明:[IEC60870_Slave.h](../../common/IEC60870_Slave.h)。
|
||||
实现:[IEC60870_Slave.c](../../../App/iec60870/common/IEC60870_Slave.c);声明:[IEC60870_Slave.h](../../../App/iec60870/common/IEC60870_Slave.h)。
|
||||
|
||||
共用连接接口通过函数指针分派,供101/104接入复用。发送返回布尔值;true表示已接手,不等于主站ACK。确认和终止先修改ASDU再提交,提交失败不恢复字段。
|
||||
|
||||
@@ -2337,7 +2337,7 @@ const IEC60870_AppLayerParameters_t * IEC60870_MasterConnection_Get_Application_
|
||||
|
||||
## 19. IEC104_Slave.c
|
||||
|
||||
实现:[IEC104_Slave.c](../../104/IEC104_Slave.c);声明:[IEC104_Slave.h](../../104/IEC104_Slave.h)。
|
||||
实现:[IEC104_Slave.c](../../../App/iec60870/104/IEC104_Slave.c);声明:[IEC104_Slave.h](../../../App/iec60870/104/IEC104_Slave.h)。
|
||||
|
||||
Slave是业务统一入口,持有静态池TCP服务。NextEvent自动安装共用应答接口;业务仅管理事件存储,不手动绑定TCP句柄或generation。需要完整事件的延迟任务用Copy_Event复制,自引用不得直接赋值搬移;只需部分请求数据时可使用下述纯值身份入口。确认/终止失败仍保留已修改的ASDU。
|
||||
|
||||
@@ -2848,7 +2848,7 @@ IEC104_TcpSubmitResult_t IEC104_Slave_Set_Pending_Business_Priority(IEC104_Slave
|
||||
|
||||
## 20. IEC60870_Codec.c
|
||||
|
||||
实现:[IEC60870_Codec.c](../../common/IEC60870_Codec.c);声明:[IEC60870_Codec.h](../../common/IEC60870_Codec.h)。
|
||||
实现:[IEC60870_Codec.c](../../../App/iec60870/common/IEC60870_Codec.c);声明:[IEC60870_Codec.h](../../../App/iec60870/common/IEC60870_Codec.h)。
|
||||
|
||||
101/104共用的ASDU基础解析。应用层参数定义在 `IEC60870_Types.h`;检查公共头和最低载荷,不依赖104帧、TCP或串口,也不执行具体对象或业务校验。
|
||||
|
||||
@@ -2881,7 +2881,7 @@ extern int IEC60870_Parse_ASDU_Header(const IEC60870_AppLayerParameters_t *param
|
||||
|
||||
## 21. IEC104_Interrogation.c
|
||||
|
||||
实现:[IEC104_Interrogation.c](../../104/business/IEC104_Interrogation.c);声明:[IEC104_Interrogation.h](../../104/business/IEC104_Interrogation.h)、[IEC104_Interrogation_Internal.h](../../104/business/IEC104_Interrogation_Internal.h)(内部协作)。
|
||||
实现:[IEC104_Interrogation.c](../../../App/iec60870/104/business/IEC104_Interrogation.c);声明:[IEC104_Interrogation.h](../../../App/iec60870/104/business/IEC104_Interrogation.h)、[IEC104_Interrogation_Internal.h](../../../App/iec60870/104/business/IEC104_Interrogation_Internal.h)(内部协作)。
|
||||
|
||||
召唤共用引擎,本文件实现12个公开驱动接口及2个内部协作函数;总召Create按实际实现归入[第22节](#file-22)。请求追加freeze/data_cause,数据COT应取data_cause。Create_With_Rules及Execute_Action仅供种类文件协作,业务不直接调用。默认实例池为TCP服务容量的两倍,同一Slave允许总召、计数量各一实例,广播数组不得重叠。
|
||||
|
||||
@@ -3106,7 +3106,7 @@ data_timeout_ms只计算NEED_DATA入队至首次有效批次尝试、结束或
|
||||
|
||||
## 22. IEC104_GeneralInterrogation.c
|
||||
|
||||
实现:[IEC104_GeneralInterrogation.c](../../104/business/IEC104_GeneralInterrogation.c);声明:[IEC104_Interrogation.h](../../104/business/IEC104_Interrogation.h)([IEC104_GeneralInterrogation.h](../../104/business/IEC104_GeneralInterrogation.h)汇入此头文件)。
|
||||
实现:[IEC104_GeneralInterrogation.c](../../../App/iec60870/104/business/IEC104_GeneralInterrogation.c);声明:[IEC104_Interrogation.h](../../../App/iec60870/104/business/IEC104_Interrogation.h)([IEC104_GeneralInterrogation.h](../../../App/iec60870/104/business/IEC104_GeneralInterrogation.h)汇入此头文件)。
|
||||
|
||||
Type100总召种类入口,提供QOI20..36及数据类型规则,保留原`IEC104_Interrogation_Create(slave, config)`签名和总召行为。创建时把只读总召规则交给共用引擎,不另建状态机;工程须加入本实现文件,后续驱动使用[第21节](#file-21)接口。
|
||||
|
||||
@@ -3133,7 +3133,7 @@ IEC104_Interrogation_t *IEC104_Interrogation_Create(IEC104_Slave_t *slave,
|
||||
|
||||
## 23. IEC104_CounterInterrogation.c
|
||||
|
||||
实现:[IEC104_CounterInterrogation.c](../../104/business/IEC104_CounterInterrogation.c);声明:[IEC104_CounterInterrogation.h](../../104/business/IEC104_CounterInterrogation.h)。
|
||||
实现:[IEC104_CounterInterrogation.c](../../../App/iec60870/104/business/IEC104_CounterInterrogation.c);声明:[IEC104_CounterInterrogation.h](../../../App/iec60870/104/business/IEC104_CounterInterrogation.h)。
|
||||
|
||||
Type101计数量种类入口,使用独立实例复用召唤引擎。RQT=1..4为分组、5为总请求;FRZ=0读取应用快照,FRZ=1..3执行冻结、冻结并复位或仅复位。读取接受Type15(SQ=0/1)、Type37(SQ=0),以及仅限COT=37的Type206/207(SQ=0/1);206/207不接受分组COT=38..41。数据COT取request.data_cause;不支持COT=8撤销及Type16。206读取当前示值,207读取冻结值及原冻结时刻,应用须在整轮及WAIT重试间保持快照。
|
||||
|
||||
@@ -3174,7 +3174,7 @@ total_timeout_ms的库默认仍为0;示例在Create前以`--ci-total-timeout`
|
||||
|
||||
## 24. IEC104_ClockSynchronization.c
|
||||
|
||||
实现:[IEC104_ClockSynchronization.c](../../104/business/IEC104_ClockSynchronization.c);声明:[IEC104_ClockSynchronization.h](../../104/business/IEC104_ClockSynchronization.h)。
|
||||
实现:[IEC104_ClockSynchronization.c](../../../App/iec60870/104/business/IEC104_ClockSynchronization.c);声明:[IEC104_ClockSynchronization.h](../../../App/iec60870/104/business/IEC104_ClockSynchronization.h)。
|
||||
|
||||
Type103校时/读时模块,负责请求校验、排队、执行期限及回复,实际设备操作由Execute_Next_With_Read显式调用应用回调完成。独立静态池默认与TCP服务容量相同,每实例4个任务槽,只使用共用站点表。完整校验、时间计算及广播规则见[时钟同步设计](IEC104_ClockSynchronization_设计架构.md),COT=5的规范依据与项目策略集中在[读时钟](IEC104_ClockSynchronization_设计架构.md#clock-read)。
|
||||
|
||||
@@ -3268,7 +3268,7 @@ COT=6合法TEST=1直接进入REPLY并回肯定ACT_CON,回显T、OA及原CP56
|
||||
|
||||
## 25. IEC104_Command.c
|
||||
|
||||
实现:[IEC104_Command.c](../../104/business/IEC104_Command.c);声明:[IEC104_Command.h](../../104/business/IEC104_Command.h)。
|
||||
实现:[IEC104_Command.c](../../../App/iec60870/104/business/IEC104_Command.c);声明:[IEC104_Command.h](../../../App/iec60870/104/business/IEC104_Command.h)。
|
||||
|
||||
本节列出全部 **16 个公开函数**,并说明其配置、值类型及调用约束。状态机设计见[遥控设计](IEC104_Command_设计架构.md),事件循环与应用处理顺序见[遥控调用流程](IEC104_完整调用流程.md#flow-command)。
|
||||
|
||||
@@ -3780,7 +3780,7 @@ bool IEC104_Command_Get_Status(const IEC104_Command_t *self, IEC104_CommandStatu
|
||||
|
||||
## 26. IEC104_Spontaneous.c
|
||||
|
||||
实现:[IEC104_Spontaneous.c](../../104/business/IEC104_Spontaneous.c);声明:[IEC104_Spontaneous.h](../../104/business/IEC104_Spontaneous.h)。
|
||||
实现:[IEC104_Spontaneous.c](../../../App/iec60870/104/business/IEC104_Spontaneous.c);声明:[IEC104_Spontaneous.h](../../../App/iec60870/104/business/IEC104_Spontaneous.h)。
|
||||
|
||||
模块将应用提供的变化值组为监视ASDU并直接写NORMAL,不做变化检测、点表维护或周期扫描,不缓存待发变化;组帧共用一个可复用缓冲。完整算法、时标降级和跨业务顺序见[突发设计](IEC104_Spontaneous_设计架构.md),应用步骤见[调用流程](IEC104_完整调用流程.md#flow-spontaneous)。
|
||||
|
||||
@@ -3953,7 +3953,7 @@ void IEC104_Spontaneous_Clear_Overflow(IEC104_Spontaneous_t *self);
|
||||
|
||||
## 27. IEC104_Read.c
|
||||
|
||||
实现:[IEC104_Read.c](../../104/business/IEC104_Read.c);声明:[IEC104_Read.h](../../104/business/IEC104_Read.h)。
|
||||
实现:[IEC104_Read.c](../../../App/iec60870/104/business/IEC104_Read.c);声明:[IEC104_Read.h](../../../App/iec60870/104/business/IEC104_Read.h)。
|
||||
|
||||
独立Type102业务,按CA/IOA读一个监视点,以COT5数据或45/46/47回显应答。模块保存有界请求FIFO,应用在Execute_Next中同步读取单点快照;不提供异步取值或数据缓存。设计及lookup完整契约见[读命令设计](IEC104_Read_设计架构.md),接入见[1.7节](IEC104_完整调用流程.md#flow-read)。
|
||||
|
||||
@@ -4093,7 +4093,7 @@ bool IEC104_Read_Get_Status(const IEC104_Read_t *self, IEC104_ReadStatus_t *stat
|
||||
|
||||
## 28. IEC104_SystemCommand.c
|
||||
|
||||
实现:[IEC104_SystemCommand.c](../../104/business/IEC104_SystemCommand.c);声明:[IEC104_SystemCommand.h](../../104/business/IEC104_SystemCommand.h)。
|
||||
实现:[IEC104_SystemCommand.c](../../../App/iec60870/104/business/IEC104_SystemCommand.c);声明:[IEC104_SystemCommand.h](../../../App/iec60870/104/business/IEC104_SystemCommand.h)。
|
||||
|
||||
处理Type104/107测试回显、Type70初始化结束和Type105的QRP1进程复位许可、QRP2事件缓冲清除,以及显式启用的QRP128..255专用许可。任务FIFO、Type70轮次和ACK后授权分别保存状态;实际设备复位、专用动作及应用缓存清理由应用承担。现行状态机、取消边界及测试说明见[系统命令设计](IEC104_SystemCommand_设计架构.md),推进示例见[1.8节](IEC104_完整调用流程.md#flow-system-command)。
|
||||
|
||||
@@ -4284,7 +4284,7 @@ IEC104_Slave_t *IEC104_SystemCommand_Get_Slave(const IEC104_SystemCommand_t *sel
|
||||
|
||||
## 29. IEC104_PeriodicScan.c
|
||||
|
||||
实现:[IEC104_PeriodicScan.c](../../104/business/IEC104_PeriodicScan.c);声明:[IEC104_PeriodicScan.h](../../104/business/IEC104_PeriodicScan.h)。
|
||||
实现:[IEC104_PeriodicScan.c](../../../App/iec60870/104/business/IEC104_PeriodicScan.c);声明:[IEC104_PeriodicScan.h](../../../App/iec60870/104/business/IEC104_PeriodicScan.h)。
|
||||
|
||||
模块通过IDLE发送COT=1/2当前值,管理独立扫描组、公共时间网格、可选点级周期及SQ阈值;应用提供只读点表和同步lookup。点级组必须借用位图保存未交接资格,包含RETRY、局部取值中止和Cancel尚未交接的候选;查询、发送及内部错误进入faulted,应用修复后显式Resume。不缓存点值、不进入HIGH/NORMAL,不跨STOP或重连补发。完整调度、白名单、借用和错误语义集中在[扫描设计](IEC104_PeriodicScan_设计架构.md),调用次序见[流程](IEC104_完整调用流程.md#flow-periodic-scan)。
|
||||
|
||||
@@ -4386,7 +4386,7 @@ RECORD的priority可以为`IEC104_ASDU_PRIORITY_IDLE=3`;该值仅用于发送
|
||||
|
||||
## 30. IEC104_Parameter.c
|
||||
|
||||
头文件:[IEC104_Parameter.h](../../104/business/IEC104_Parameter.h)。Type110–113的固定槽请求状态机,显式短时同步动作,110–112确认带运行值。默认标准功能,全部扩展默认关闭。完整受理、取值顺序及ACK状态见[参数设计](IEC104_Parameter_设计架构.md),应用接入见[参数调用流程](IEC104_完整调用流程.md#flow-parameter)。
|
||||
头文件:[IEC104_Parameter.h](../../../App/iec60870/104/business/IEC104_Parameter.h)。Type110–113的固定槽请求状态机,显式短时同步动作,110–112确认带运行值。默认标准功能,全部扩展默认关闭。完整受理、取值顺序及ACK状态见[参数设计](IEC104_Parameter_设计架构.md),应用接入见[参数调用流程](IEC104_完整调用流程.md#flow-parameter)。
|
||||
|
||||
### 30.1 配置、公开值类型与常量
|
||||
|
||||
@@ -4472,7 +4472,7 @@ bool IEC104_Parameter_Get_Status(const IEC104_Parameter_t *self,
|
||||
|
||||
## 31. IEC104_RemoteParameter.c
|
||||
|
||||
实现:[IEC104_RemoteParameter.c](../../104/business/IEC104_RemoteParameter.c);声明:[IEC104_RemoteParameter.h](../../104/business/IEC104_RemoteParameter.h)。本节按入口说明应用如何使用接口,线格式、会话表及错误优先级集中在[远程参数设计](IEC104_RemoteParameter_设计架构.md),执行顺序见[调用流程](IEC104_完整调用流程.md#flow-remote-parameter)。
|
||||
实现:[IEC104_RemoteParameter.c](../../../App/iec60870/104/business/IEC104_RemoteParameter.c);声明:[IEC104_RemoteParameter.h](../../../App/iec60870/104/business/IEC104_RemoteParameter.h)。本节按入口说明应用如何使用接口,线格式、会话表及错误优先级集中在[远程参数设计](IEC104_RemoteParameter_设计架构.md),执行顺序见[调用流程](IEC104_完整调用流程.md#flow-remote-parameter)。
|
||||
|
||||
### 31.1 配置与公开类型
|
||||
|
||||
@@ -4530,7 +4530,7 @@ action负责200/201/203及DISCARD,lookup只负责202。启用相关类型就
|
||||
| Add_Boolean至Add_Double | 固定宽度小端编码,仍经过Add_Element检查;浮点额外验证宿主表示且拒绝NaN/Inf |
|
||||
| Add_Bytes / Add_String | Bytes原样复制0–235字节;String接受1–63字节非NUL ASCII内容并追加一个NUL,参数length不含追加字节 |
|
||||
|
||||
典型读取回调的返回映射为:成功查到点后调用一次 `Add_Uint(frame, ioa, value)`;ADD_OK映射LOOKUP_ADDED,ADD_FULL映射LOOKUP_FULL,ADD_ERROR映射LOOKUP_ERROR。未知指定地址在添加前返回UNKNOWN;读全部越过表尾在添加前返回END。不要把ADD枚举直接强转为LOOKUP枚举,两者数值含义不同。实际示例的 `Example_Remote_Action` / `Example_Remote_Lookup` 位于[示例源码](../../examples/iec104_slave_example.c),点表约定见[示例说明](../examples/IEC104子站示例.md#example-remote-parameter)。
|
||||
典型读取回调的返回映射为:成功查到点后调用一次 `Add_Uint(frame, ioa, value)`;ADD_OK映射LOOKUP_ADDED,ADD_FULL映射LOOKUP_FULL,ADD_ERROR映射LOOKUP_ERROR。未知指定地址在添加前返回UNKNOWN;读全部越过表尾在添加前返回END。不要把ADD枚举直接强转为LOOKUP枚举,两者数值含义不同。实际示例的 `Example_Remote_Action` / `Example_Remote_Lookup` 位于`iec104_slave_example.c`,点表约定见[示例说明](../examples/IEC104子站示例.md#example-remote-parameter)。
|
||||
|
||||
### 31.4 完整函数原型
|
||||
|
||||
@@ -4592,7 +4592,7 @@ IEC104_RemoteParameterAddResult_t IEC104_RemoteParameter_Add_String(
|
||||
|
||||
## 32. IEC104_FileService.c
|
||||
|
||||
实现:[IEC104_FileService.c](../../104/business/IEC104_FileService.c);声明:[IEC104_FileService.h](../../104/business/IEC104_FileService.h)。线格式、受理顺序、期限和状态以[文件服务设计](IEC104_FileService_设计架构.md)为准,事件保留示例见[调用流程](IEC104_完整调用流程.md#flow-file-service)。
|
||||
实现:`IEC104_FileService.c`;声明:`IEC104_FileService.h`。线格式、受理顺序、期限和状态以[文件服务设计](IEC104_FileService_设计架构.md)为准,事件保留示例见[调用流程](IEC104_完整调用流程.md#flow-file-service)。
|
||||
|
||||
### 32.1 创建与配置
|
||||
|
||||
@@ -4727,7 +4727,7 @@ bool IEC104_FileService_Get_Status(const IEC104_FileService_t *self,
|
||||
|
||||
## 33. IEC104_SoftwareUpgrade.c
|
||||
|
||||
实现:[IEC104_SoftwareUpgrade.c](../../104/business/IEC104_SoftwareUpgrade.c);声明:[IEC104_SoftwareUpgrade.h](../../104/business/IEC104_SoftwareUpgrade.h)。报文、状态、默认配置及计时以[软件升级设计](IEC104_SoftwareUpgrade_设计架构.md)为准,应用接入见[调用流程](IEC104_完整调用流程.md#flow-software-upgrade)。
|
||||
实现:`IEC104_SoftwareUpgrade.c`;声明:`IEC104_SoftwareUpgrade.h`。报文、状态、默认配置及计时以[软件升级设计](IEC104_SoftwareUpgrade_设计架构.md)为准,应用接入见[调用流程](IEC104_完整调用流程.md#flow-software-upgrade)。
|
||||
|
||||
### 33.1 入口职责与寿命
|
||||
|
||||
@@ -4802,7 +4802,7 @@ bool IEC104_SoftwareUpgrade_Get_Status(const IEC104_SoftwareUpgrade_t *self,
|
||||
|
||||
## 34. IEC60870_FaultEvent.c
|
||||
|
||||
声明见 [IEC60870_FaultEvent.h](../../common/IEC60870_FaultEvent.h),线格式和兼容边界见[故障事件设计](../common/IEC60870_FaultEvent_设计架构.md)。这是101/104共用的Type42扩展格式完整ASDU编解码,不含APCI,不依赖网络或系统时钟。普通 `Asdu_Parse/Get_Element/Add_InformationObject` 不解析或构造这两组内部记录。
|
||||
声明见 [IEC60870_FaultEvent.h](../../../App/iec60870/common/IEC60870_FaultEvent.h),线格式和兼容边界见[故障事件设计](../common/IEC60870_FaultEvent_设计架构.md)。这是101/104共用的Type42扩展格式完整ASDU编解码,不含APCI,不依赖网络或系统时钟。普通 `Asdu_Parse/Get_Element/Add_InformationObject` 不解析或构造这两组内部记录。
|
||||
|
||||
### 34.1 类型与所有权
|
||||
|
||||
@@ -4854,7 +4854,7 @@ IEC60870_AsduResult_t IEC60870_FaultEvent_Get_Measurement(
|
||||
|
||||
## 35. IEC60870_FaultRecorder.c
|
||||
|
||||
实现:[IEC60870_FaultRecorder.c](../../common/IEC60870_FaultRecorder.c);声明:[IEC60870_FaultRecorder.h](../../common/IEC60870_FaultRecorder.h)。本模块接收应用提供的瞬时采样,按故障采样序号冻结前后窗口;不读取硬件、系统时间、文件或网络。窗口计算与状态图见[录波采集设计](../common/IEC60870_FaultRecorder_设计架构.md#fault-recording-capture)。
|
||||
实现:`IEC60870_FaultRecorder.c`;声明:`IEC60870_FaultRecorder.h`。本模块接收应用提供的瞬时采样,按故障采样序号冻结前后窗口;不读取硬件、系统时间、文件或网络。窗口计算与状态图见[录波采集设计](../common/IEC60870_FaultRecorder_设计架构.md#fault-recording-capture)。
|
||||
|
||||
### 35.1 所有权、输入和完成点
|
||||
|
||||
@@ -4909,7 +4909,7 @@ bool IEC60870_FaultRecorder_Release(IEC60870_FaultRecorder_t *self);
|
||||
|
||||
## 36. IEC60870_Comtrade.c
|
||||
|
||||
实现:[IEC60870_Comtrade.c](../../common/IEC60870_Comtrade.c);声明:[IEC60870_Comtrade.h](../../common/IEC60870_Comtrade.h)。编码COMTRADE 1999 ASCII CFG及BINARY DAT,不分配内存、不保存文件,也不启动Type210会话。字段布局、时间舍入和物理量口径见[COMTRADE编码设计](../common/IEC60870_FaultRecorder_设计架构.md#fault-recording-format)。
|
||||
实现:`IEC60870_Comtrade.c`;声明:`IEC60870_Comtrade.h`。编码COMTRADE 1999 ASCII CFG及BINARY DAT,不分配内存、不保存文件,也不启动Type210会话。字段布局、时间舍入和物理量口径见[COMTRADE编码设计](../common/IEC60870_FaultRecorder_设计架构.md#fault-recording-format)。
|
||||
|
||||
### 36.1 借用与输出约定
|
||||
|
||||
@@ -4956,7 +4956,7 @@ uint16_t IEC60870_Comtrade_Next_Sequence(uint16_t sequence);
|
||||
|
||||
## 37. IEC60870_History.c
|
||||
|
||||
实现:[IEC60870_History.c](../../common/IEC60870_History.c);声明:[IEC60870_History.h](../../common/IEC60870_History.h)。核心保存SOE、遥控阶段、15分钟定点和每日极值,不依赖TCP、RTOS或具体介质;协议实时缓存与持久历史分别管理。时间、记录格式及恢复策略集中见[历史核心设计](../common/IEC60870_History_设计架构.md#history-core-api)。
|
||||
实现:`IEC60870_History.c`;声明:`IEC60870_History.h`。核心保存SOE、遥控阶段、15分钟定点和每日极值,不依赖TCP、RTOS或具体介质;协议实时缓存与持久历史分别管理。时间、记录格式及恢复策略集中见[历史核心设计](../common/IEC60870_History_设计架构.md#history-core-api)。
|
||||
|
||||
### 37.1 所有权与持久化边界
|
||||
|
||||
@@ -5024,7 +5024,7 @@ bool IEC60870_History_Latest_Day(const IEC60870_History_t *self, uint32_t *day);
|
||||
|
||||
## 38. IEC60870_HistoryFile.c
|
||||
|
||||
实现:[IEC60870_HistoryFile.c](../../common/IEC60870_HistoryFile.c);声明:[IEC60870_HistoryFile.h](../../common/IEC60870_HistoryFile.h)。选择附录B允许的XML格式,通过同步sink输出完整文件;不操作文件系统、不消费历史记录或建立传输会话。XML字段及快照寿命见[历史文件设计](../common/IEC60870_History_设计架构.md#history-snapshot-lifecycle)。
|
||||
实现:`IEC60870_HistoryFile.c`;声明:`IEC60870_HistoryFile.h`。选择附录B允许的XML格式,通过同步sink输出完整文件;不操作文件系统、不消费历史记录或建立传输会话。XML字段及快照寿命见[历史文件设计](../common/IEC60870_History_设计架构.md#history-snapshot-lifecycle)。
|
||||
|
||||
### 38.1 函数契约与冻结责任
|
||||
|
||||
@@ -5058,7 +5058,7 @@ bool IEC60870_HistoryFile_Write(IEC60870_History_t *history,
|
||||
|
||||
## 39. IEC60870_UserLog.c
|
||||
|
||||
实现:[IEC60870_UserLog.c](../../common/IEC60870_UserLog.c);声明:[IEC60870_UserLog.h](../../common/IEC60870_UserLog.h)。保存最新1024条附录C日志,无堆、无RTOS、无文件系统和104依赖。11类定义、按来源触发及恢复算法集中见[运行日志设计](../common/IEC60870_UserLog_设计架构.md#user-log-design)。
|
||||
实现:`IEC60870_UserLog.c`;声明:`IEC60870_UserLog.h`。保存最新1024条附录C日志,无堆、无RTOS、无文件系统和104依赖。11类定义、按来源触发及恢复算法集中见[运行日志设计](../common/IEC60870_UserLog_设计架构.md)。
|
||||
|
||||
### 39.1 输入、存储与所有权
|
||||
|
||||
@@ -5102,7 +5102,7 @@ bool IEC60870_UserLog_Latest_Time(const IEC60870_UserLog_t *self, uint64_t *utc_
|
||||
|
||||
## 40. IEC60870_UserLogFile.c
|
||||
|
||||
实现:[IEC60870_UserLogFile.c](../../common/IEC60870_UserLogFile.c);声明:[IEC60870_UserLogFile.h](../../common/IEC60870_UserLogFile.h)。固定文件名由`IEC60870_USER_LOG_FILE_NAME`提供,值为`HISTORY/ULOG/ulog.xml`;仅生成XML,不操作文件系统、不消费记录、不建立传输会话。
|
||||
实现:`IEC60870_UserLogFile.c`;声明:`IEC60870_UserLogFile.h`。固定文件名由`IEC60870_USER_LOG_FILE_NAME`提供,值为`HISTORY/ULOG/ulog.xml`;仅生成XML,不操作文件系统、不消费记录、不建立传输会话。
|
||||
|
||||
### 40.1 输出与冻结契约
|
||||
|
||||
@@ -5130,7 +5130,7 @@ bool IEC60870_UserLogFile_Write(IEC60870_UserLog_t *log, const char *device_id,
|
||||
|
||||
## 41. 持久化软件安装
|
||||
|
||||
实现:[IEC60870_FirmwareUpdate.c](../../common/IEC60870_FirmwareUpdate.c);声明:[IEC60870_FirmwareUpdate.h](../../common/IEC60870_FirmwareUpdate.h)。核心无协议、RTOS或文件系统依赖。下列声明逐项对应公开头文件;状态机、介质布局和完整恢复策略分别见[安装状态](../common/IEC60870_FirmwareUpdate_设计架构.md#firmware-update-state)、[存储设计](../common/IEC60870_FirmwareUpdate_设计架构.md#firmware-update-storage)和[恢复规则](../common/IEC60870_FirmwareUpdate_设计架构.md#firmware-update-recovery)。
|
||||
实现:`IEC60870_FirmwareUpdate.c`;声明:`IEC60870_FirmwareUpdate.h`。核心无协议、RTOS或文件系统依赖。下列声明逐项对应公开头文件;状态机、介质布局和完整恢复策略分别见[安装状态](../common/IEC60870_FirmwareUpdate_设计架构.md#firmware-update-state)、[存储设计](../common/IEC60870_FirmwareUpdate_设计架构.md#firmware-update-storage)和[恢复规则](../common/IEC60870_FirmwareUpdate_设计架构.md#firmware-update-recovery)。
|
||||
|
||||
### 41.1 核心所有权与返回值
|
||||
|
||||
@@ -5190,7 +5190,7 @@ bool IEC60870_FirmwareUpdate_Get_Status(const IEC60870_FirmwareUpdate_t *self,
|
||||
|
||||
### 41.3 Windows升级门面
|
||||
|
||||
实现:[iec104_example_upgrade.c](../../examples/iec104_example_upgrade.c);声明:[iec104_example_upgrade.h](../../examples/iec104_example_upgrade.h)。`ExampleUpgrade`首次清零,Open成功后保持地址稳定,由调用方持有至Close;后端context指回此对象。目录路径复制到对象,输入字节和输出描述不跨调用借用。Open取得独占存储锁,所有操作串行,Close前先交完原文件句柄及升级会话收尾。门面真实复制、校验安装文件,不加载或执行负载;详细文件责任见[宿主后端接口](../common/IEC60870_FirmwareUpdate_设计架构.md#firmware-update-host-api)。
|
||||
实现:`iec104_example_upgrade.c`;声明:`iec104_example_upgrade.h`。`ExampleUpgrade`首次清零,Open成功后保持地址稳定,由调用方持有至Close;后端context指回此对象。目录路径复制到对象,输入字节和输出描述不跨调用借用。Open取得独占存储锁,所有操作串行,Close前先交完原文件句柄及升级会话收尾。门面真实复制、校验安装文件,不加载或执行负载;详细文件责任见[宿主后端接口](../common/IEC60870_FirmwareUpdate_设计架构.md#firmware-update-host-api)。
|
||||
|
||||
除Close返回void外均为bool。false不是统一的“未产生副作用”:格式拒绝可按状态Abort后重传,核心faulted或不确定授权/确认须Close/Open恢复;Current和Candidate_Info失败保持输出。整包17字节至`EXAMPLE_UPGRADE_PACKAGE_MAX`(16MiB),门面接收偏移含16字节头,核心描述和源槽只保存负载。
|
||||
|
||||
@@ -5231,7 +5231,7 @@ bool Example_Upgrade_Store_Confirm(ExampleUpgrade *self);
|
||||
|
||||
## 42. IEC60870_EnergyFreeze.c
|
||||
|
||||
实现:[IEC60870_EnergyFreeze.c](../../common/IEC60870_EnergyFreeze.c);完整声明:[IEC60870_EnergyFreeze.h](../../common/IEC60870_EnergyFreeze.h)。这是独立于History的可移植C99核心,保存INTERVAL、DAY、FLOWREV、SEAL、META五类记录。数据规则、布局和恢复边界集中见[电能量冻结设计](../common/IEC60870_EnergyFreeze_设计架构.md)。
|
||||
实现:`IEC60870_EnergyFreeze.c`;完整声明:`IEC60870_EnergyFreeze.h`。这是独立于History的可移植C99核心,保存INTERVAL、DAY、FLOWREV、SEAL、META五类记录。数据规则、布局和恢复边界集中见[电能量冻结设计](../common/IEC60870_EnergyFreeze_设计架构.md)。
|
||||
|
||||
调用方静态分配实例,点表和store context在整个使用期保持有效,点表内容及顺序不变,所有访问串行。配置默认日界0、网格容差1000ms、最大迟到1000ms;点数0分别关闭FRZ或FLOWREV。单位语义改变须同步改变`value_semantics`。接口均使用UTC毫秒,核心不读取墙钟、不判断功率方向。对象借用关系见[生命周期](../common/IEC60870_EnergyFreeze_设计架构.md#energy-freeze-ownership),后端接入见[存储回调契约](../common/IEC60870_EnergyFreeze_设计架构.md#energy-freeze-store-contract)。
|
||||
|
||||
@@ -5258,7 +5258,7 @@ bool Example_Upgrade_Store_Confirm(ExampleUpgrade *self);
|
||||
|
||||
## 43. IEC60870_EnergyFreezeFile.c
|
||||
|
||||
实现:[IEC60870_EnergyFreezeFile.c](../../common/IEC60870_EnergyFreezeFile.c);声明:[IEC60870_EnergyFreezeFile.h](../../common/IEC60870_EnergyFreezeFile.h)。文件类别独立于存储类别:`IEC60870_ENERGY_FREEZE_FILE_FRZ`和`IEC60870_ENERGY_FREEZE_FILE_FLOWREV`。
|
||||
实现:`IEC60870_EnergyFreezeFile.c`;声明:`IEC60870_EnergyFreezeFile.h`。文件类别独立于存储类别:`IEC60870_ENERGY_FREEZE_FILE_FRZ`和`IEC60870_ENERGY_FREEZE_FILE_FLOWREV`。
|
||||
|
||||
名称缓冲、名义时标、sink片段生命周期及失败后的候选处理见[XML接口契约](../common/IEC60870_EnergyFreeze_设计架构.md#energy-freeze-export-contract)。`Name`只生成路径,不保证该文件可导出;`Write`返回false须丢弃候选,并结合核心状态区分普通不可导出与完整性故障。
|
||||
|
||||
@@ -5273,14 +5273,14 @@ bool IEC60870_EnergyFreezeFile_Write(IEC60870_EnergyFreeze_t *freeze,
|
||||
|
||||
配置包含`device_name`和按FRZ点序排列的`units`字符串数组。输出通过同步sink分片交付,编码期间独占核心;失败时丢弃全部前缀,只有完整成功才更新可选size。FRZ核对SEAL后发布,保留原节号并允许缺节/缺DAY;FLOWREV展开有效点,空库输出num=0。设备名和单位校验UTF-8/XML并转义,数值使用小数点为`.`的`%.9g`。
|
||||
|
||||
Windows后端声明见[iec104_example_energy_freeze.h](../../examples/iec104_example_energy_freeze.h):`Open/Close`管理独占介质,`Directory_Open/Count/Get/Close`管理目录缓存,`Read_Open/Read/Close`管理独立读快照;所有函数前缀为`Example_Energy_Freeze_`。模拟计量及墙钟分段接口单独位于[iec104_example_energy_meter.h](../../examples/iec104_example_energy_meter.h),其资源和启动恢复工作区不属于可移植核心。
|
||||
Windows后端声明见`iec104_example_energy_freeze.h`:`Open/Close`管理独占介质,`Directory_Open/Count/Get/Close`管理目录缓存,`Read_Open/Read/Close`管理独立读快照;所有函数前缀为`Example_Energy_Freeze_`。模拟计量及墙钟分段接口单独位于`iec104_example_energy_meter.h`,其资源和启动恢复工作区不属于可移植核心。
|
||||
|
||||
<a id="file-44"></a>
|
||||
<a id="startup-api"></a>
|
||||
|
||||
## 44. IEC104_Startup.c
|
||||
|
||||
实现:[IEC104_Startup.c](../../104/business/IEC104_Startup.c);声明:[IEC104_Startup.h](../../104/business/IEC104_Startup.h)。本模块统一本目录细则的启动补发配置与完成判据,主示例直接复用。接线和各层分工见[统一启动入口](IEC104_完整调用流程.md#startup-unified-entry);严格业务等级及业务轮仍由[应用调度](IEC104_业务优先级设计.md)驱动。
|
||||
实现:[IEC104_Startup.c](../../../App/iec60870/104/business/IEC104_Startup.c);声明:[IEC104_Startup.h](../../../App/iec60870/104/business/IEC104_Startup.h)。本模块统一本目录细则的启动补发配置与完成判据,主示例直接复用。接线和各层分工见[统一启动入口](IEC104_完整调用流程.md#startup-unified-entry);严格业务等级及业务轮仍由[应用调度](IEC104_业务优先级设计.md)驱动。
|
||||
|
||||
`IEC104_Startup_t`由调用方持有,保存原Slave事件身份、实际START轮次及`enabled/locked/initialized/open`。对象在使用中不得由应用改字段或复制,活跃轮次结束须Reset,不能用再次Init代替锁归还。模块复用Slave已有逐站记账,不增加站表、ASDU缓存、后台任务或动态分配。应用自己的GI取数引用和游标不属于该对象。
|
||||
|
||||
+5
-5
@@ -2,7 +2,7 @@
|
||||
|
||||
> **用途**:说明Type 103校时及读时请求如何进入固定任务槽、显式调用应用并按序交接回复。
|
||||
> **范围**:协议校验、校时补偿、读时快照、任务FIFO、原站身份、广播快照、执行期限及HIGH回复;设备读写留给应用。
|
||||
> **源码依据**:[IEC104_ClockSynchronization.c](../../104/business/IEC104_ClockSynchronization.c)、[公开头文件](../../104/business/IEC104_ClockSynchronization.h)、[Slave接口](../../104/IEC104_Slave.h)和[公共时间工具](../../common/IEC60870_Time.h)。
|
||||
> **源码依据**:[IEC104_ClockSynchronization.c](../../../App/iec60870/104/business/IEC104_ClockSynchronization.c)、[公开头文件](../../../App/iec60870/104/business/IEC104_ClockSynchronization.h)、[Slave接口](../../../App/iec60870/104/IEC104_Slave.h)和[公共时间工具](../../../App/iec60870/common/IEC60870_Time.h)。
|
||||
> **同步日期**:2026-11-11。第1至7节保留报文与接入细节;[读时钟](#clock-read)集中说明COT=5及其接入策略,[代码结构与执行框架](#clock-code-framework)说明固定槽、动作/回复状态及结果输出的边界,[接入排障](#clock-diagnostics-and-base-update)区分设时、基准更新与确认结果。
|
||||
|
||||
业务层整体位置、显式动作与发送完成模型见[业务层设计架构](IEC104_业务层_设计架构.md);本文详述校时契约。
|
||||
@@ -11,7 +11,7 @@
|
||||
|
||||
`IEC104_ClockSynchronization.c/h`处理Type 103(`C_CS_NA_1`)的COT=6校时和COT=5读时。模块负责请求校验、排队、站点路由、执行期限及回复;应用通过`Execute_Next_With_Read`显式提供同步设时/读时回调,兼容入口`Execute_Next`只提供设时回调。`Handle_Event`和`Process`不会调用应用代码,模块不保存回调/context,不直接依赖`IEC60870_Clock`或访问设备时钟。
|
||||
|
||||
源码:[IEC104_ClockSynchronization.h](../../104/business/IEC104_ClockSynchronization.h)、[IEC104_ClockSynchronization.c](../../104/business/IEC104_ClockSynchronization.c)。接入流程见[完整调用流程](IEC104_完整调用流程.md#flow-clock-synchronization),接口见[API汇总](IEC104_API接口汇总.md#file-24),运行入口见[子站示例](../examples/IEC104子站示例.md)。
|
||||
源码:[IEC104_ClockSynchronization.h](../../../App/iec60870/104/business/IEC104_ClockSynchronization.h)、[IEC104_ClockSynchronization.c](../../../App/iec60870/104/business/IEC104_ClockSynchronization.c)。接入流程见[完整调用流程](IEC104_完整调用流程.md#flow-clock-synchronization),接口见[API汇总](IEC104_API接口汇总.md#file-24),运行入口见[子站示例](../examples/IEC104子站示例.md)。
|
||||
|
||||
## 1. 业务边界
|
||||
|
||||
@@ -25,7 +25,7 @@
|
||||
<a id="clock-read"></a>
|
||||
### 1.1 COT=5读时钟:规范与接入策略
|
||||
|
||||
[细则原件](../../20170804163032284877151.pdf#page=32)第8.1.3节及图9(PDF第32–33页,从封面起计)规定:下行读取命令的七字节时间域全零,终端以当前本地时间回复,星期使用1–7;图示请求、回复均为Type 103、COT=5。第7.1.2节(PDF第13–14页)给出IOA=0及CP56格式。正常读时没有COT=7确认或COT=10终止。
|
||||
`20170804163032284877151.pdf`第8.1.3节及图9(PDF第32–33页,从封面起计)规定:下行读取命令的七字节时间域全零,终端以当前本地时间回复,星期使用1–7;图示请求、回复均为Type 103、COT=5。第7.1.2节(PDF第13–14页)给出IOA=0及CP56格式。正常读时没有COT=7确认或COT=10终止。
|
||||
|
||||
请求须为16字节ASDU、SQ=0、对象数1、P/N=0、合法CA、IOA=0及七个零字节。全零域是读取占位,不解码成日历。模块将合法请求放入`CLOCK_READ`,应用调用`Execute_Next_With_Read(self, set_action, read_action, context)`时才取样;`ReadRequest_t`仅含原请求身份、`is_test`及单调`accepted_ms/base_ms`,没有主站时间或校时补偿值。
|
||||
|
||||
@@ -205,7 +205,7 @@ STOP、断线、服务实例/连接代次失效及Cancel清除模块仍持有的
|
||||
|
||||
主示例的具体接线是`Example_Clock_Action`只在模拟更新成功或`Clock_Set`成功后置`clock_update_pending`,`Example_Drain_Clock`在回调返回后检查该标志,再更新Command和Spontaneous基准。因此旧`clock_valid=true`、执行接口返回OK或`confirm_pending=false`都不能单独触发新基准发布。反过来,已成功动作的确认提交失败也不取消这次基准更新。跨模块setter失败会使示例退出正常推进并清理,不会回滚设备时间或再次调用设时动作。
|
||||
|
||||
上述检查对应[示例时间接线](../../examples/iec104_slave_example.c)和[现有业务集成测试](../../test/iec104_slave_example_test.c),不新增一套协议重试策略。确认如何取消仍以[阶段提交与WAIT恢复](#clock-commit-and-wait)为准;Spontaneous如何解释保留的采集时刻见[突发时间基准](IEC104_Spontaneous_设计架构.md#5-时标)。
|
||||
上述检查对应`iec104_slave_example.c`和`iec104_slave_example_test.c`,不新增一套协议重试策略。确认如何取消仍以[阶段提交与WAIT恢复](#clock-commit-and-wait)为准;Spontaneous如何解释保留的采集时刻见[突发时间基准](IEC104_Spontaneous_设计架构.md#5-时标)。
|
||||
|
||||
<a id="clock-read-diagnostics"></a>
|
||||
### 7.2 读时状态、返回值与排查入口
|
||||
@@ -458,7 +458,7 @@ B的补偿从自己的受理时刻算起。若B在A动作前已经受理,A的
|
||||
<a id="clock-change-tests"></a>
|
||||
### 修改影响与测试导航
|
||||
|
||||
校时测试实际位于[示例及业务集成测试源文件](../../test/iec104_slave_example_test.c),不是独立的`iec104_clock_synchronization_test.c`。下列函数可定位已有断言;TEST修复的专项和全量执行记录见[测试文档](../test/IEC104测试文档.md#test-bit-regression)。
|
||||
校时测试实际位于`iec104_slave_example_test.c`,不是独立的`iec104_clock_synchronization_test.c`。下列函数可定位已有断言;TEST修复的专项和全量执行记录见[测试文档](../test/IEC104测试文档.md#test-bit-regression)。
|
||||
|
||||
| 修改位置 | 应核对的行为 | 对应测试函数 |
|
||||
|---|---|---|
|
||||
+8
-8
@@ -2,7 +2,7 @@
|
||||
|
||||
> **用途**:说明控制命令从请求校验、应用决定、设备动作到应答交接及资源回收的代码结构。
|
||||
> **范围**:Type 45–51、58–64;单实例单事务、独立短回复池、原连接HIGH应答及带时标准入。不负责硬件输出、并发设备调度或网络I/O。
|
||||
> **源码依据**:[IEC104_Command.c](../../104/business/IEC104_Command.c)、[IEC104_Command.h](../../104/business/IEC104_Command.h)、[Slave接口](../../104/IEC104_Slave.h)及[示例接入](../../examples/iec104_slave_example.c)。
|
||||
> **源码依据**:[IEC104_Command.c](../../../App/iec60870/104/business/IEC104_Command.c)、[IEC104_Command.h](../../../App/iec60870/104/business/IEC104_Command.h)、[Slave接口](../../../App/iec60870/104/IEC104_Slave.h)及`iec104_slave_example.c`。
|
||||
> **同步日期**:2026-11-14。第1至8节说明详细规则;[代码结构与执行框架](#command-code-framework)按内部对象、调用链和接口结果组织阅读。执行收尾采用固定规则:成功肯定终止,明确失败或等待结果超时否定终止,不因业务执行超时主动断开TCP。
|
||||
|
||||
业务层整体位置、应用驱动与跨模块协调见[业务层设计架构](IEC104_业务层_设计架构.md);本文详述命令阶段和动作契约。
|
||||
@@ -78,7 +78,7 @@ QU=0表示使用点预定义属性,1/2分别为短/长脉冲,3为持续输
|
||||
|
||||
错误分类依据[IEC 60870-5-101:1995/AMD2:2001的表9补充条文](https://www.theiteh.com/catalog/standards/iec/89b28a73-c875-4fe4-b78c-dce684bff848/iec-60870-5-101-1995-amd2-2001):控制方向的未知类型、传送原因、公共地址、信息对象地址分别以44、45、46、47镜像回复,P/N=1;未知IOA的撤销也属于地址错误。本库区分全局未知类型与已识别类型的点级策略拒绝:未启用或范围外的类型返回IGNORED,由分派末端在无人接管时回44;类型已识别而点掩码不允许的新激活仍回否定7,不将所有业务拒绝统称未知类型。已知点但没有匹配可撤销事务回否定9。上述拒绝不产生设备动作,不建立新事务;独立短回复的FIFO、WAIT和池满丢新约束保持。
|
||||
|
||||
本目录[实施细则表5(PDF第12页)](../../20170804163032284877151.pdf#page=12)另列COT=48“遥控执行软压板状态错误”和COT=49“遥控执行时间戳错误”。对应常量为`IEC60870_ASDU_COT_COMMAND_INTERLOCK_ERROR`及`IEC60870_ASDU_COT_COMMAND_TIME_ERROR`,Command均置P/N=1并保留原请求T/OA/CA及对象字节。48仅由应用明确报告软压板状态错误,不把权限、一般闭锁、忙、值越限、选择失配或设备动作失败自动归入48;49用于本节及第8节的命令时间错误。COT=50本轮不支持;这不改变Type50/63短浮点设点能力。
|
||||
本目录`20170804163032284877151.pdf`另列COT=48“遥控执行软压板状态错误”和COT=49“遥控执行时间戳错误”。对应常量为`IEC60870_ASDU_COT_COMMAND_INTERLOCK_ERROR`及`IEC60870_ASDU_COT_COMMAND_TIME_ERROR`,Command均置P/N=1并保留原请求T/OA/CA及对象字节。48仅由应用明确报告软压板状态错误,不把权限、一般闭锁、忙、值越限、选择失配或设备动作失败自动归入48;49用于本节及第8节的命令时间错误。COT=50本轮不支持;这不改变Type50/63短浮点设点能力。
|
||||
|
||||
应用`Reject`原因是独立枚举,不是线上COT:`REJECT_NEGATIVE=1`仍映射7,`REJECT_UNKNOWN_IOA=2`仍映射47,新增`REJECT_INTERLOCK=3`映射48、`REJECT_TIME=4`映射49;完整前缀均为`IEC104_COMMAND_`。四种拒绝均不调用动作,显式`REJECT_TIME`始终安排49,不受`negative_on_expired`影响;该配置仅控制自动判定真实过期的应答。应用拒绝的阶段、事件消费及FINISHED义务保持原规则。
|
||||
|
||||
@@ -94,11 +94,11 @@ SELECTED阶段的选择执行要求同会话、原站点注册编号、IOA、类
|
||||
|
||||
本功能的直接依据是本目录《配电自动化系统应用DL/T634.5104-2009实施细则(试行)》,下列页码从PDF封面开始计数。
|
||||
|
||||
[第33页§8.1.4](../../20170804163032284877151.pdf#page=33)规定:
|
||||
`20170804163032284877151.pdf`规定:
|
||||
|
||||
> 当终端处在遥控返校状态,不再接受任何遥控选择指令,返回否定确认。
|
||||
|
||||
同节还要求,同点选择之后再次收到选择命令,应恢复到未选择之前的初始状态。[第42页§8.2.7.1 c](../../20170804163032284877151.pdf#page=42)再次明确:
|
||||
同节还要求,同点选择之后再次收到选择命令,应恢复到未选择之前的初始状态。`20170804163032284877151.pdf`再次明确:
|
||||
|
||||
> 重复选择操作时应恢复到初始状态,等待新的遥控选择命令。
|
||||
|
||||
@@ -250,7 +250,7 @@ Cleanup_Ended不依赖会话,Expire及NextEvent入口都会调用。NextEvent
|
||||
| 连接与链路层 | t1/t2/t3管理发送确认、延迟确认和空闲探测;当前被动子站未实现主站t0建连流程。t1检查已发送I/U报文的链路确认等待,不等同于遥控ACT_CON或ACT_TERM的业务等待,不能替代三段收尾期限 |
|
||||
| 发送层 | 用凭证区分已接手和已交给SendBuffer;handover覆盖尚未交接的业务等待,HANDED仍不等于主站已收到或ACK |
|
||||
|
||||
配置在[IEC104_Command_Config_Default](../../104/business/IEC104_Command.c)中填入,期限单位均为毫秒。应用先调用Config_Default,在配置点表等字段时调整期限,再调用Create;Create按值复制配置,创建后修改原配置变量不影响已有实例。当前示例的完成、交接期限仍沿用30秒、60秒,执行终止规则固定,没有对应命令行开关。以下两项赋值放在Config_Default之后、Create之前:
|
||||
配置在[IEC104_Command_Config_Default](../../../App/iec60870/104/business/IEC104_Command.c)中填入,期限单位均为毫秒。应用先调用Config_Default,在配置点表等字段时调整期限,再调用Create;Create按值复制配置,创建后修改原配置变量不影响已有实例。当前示例的完成、交接期限仍沿用30秒、60秒,执行终止规则固定,没有对应命令行开关。以下两项赋值放在Config_Default之后、Create之前:
|
||||
|
||||
```c
|
||||
config.complete_timeout_ms = 30000U;
|
||||
@@ -323,7 +323,7 @@ Complete后的COMPLETED和EXECUTION_FAILED在最终应答交给SendBuffer后交
|
||||
|
||||
因此退出中的“清理应用引用”包含等待设备退出或让独立设备管理者接管存活记录,不能无条件在读到FINISHED后立刻Destroy全部context。`return_info_undelivered`只辅助处理已提交的返回信息,不能证明设备停止,也不涵盖尚未提交OK的应用快照。
|
||||
|
||||
协议侧对应[命令专项](../../test/iec104_command_test.c)的`test_command_timeout_term_lifetime`(STOP/断线后旧结果STALE)、`test_command_station_lifetime`(同CA替换仍保护旧节点)、`test_command_action_outcomes`和`test_command_finished_pairing`。这些测试验证协议身份与引用,不模拟具体驱动的异步回调;板级接入还应实际断开通信并延迟设备完成,检查启动次数始终为1、context在完成前存活、引用最终只释放一次。
|
||||
协议侧对应`iec104_command_test.c`的`test_command_timeout_term_lifetime`(STOP/断线后旧结果STALE)、`test_command_station_lifetime`(同CA替换仍保护旧节点)、`test_command_action_outcomes`和`test_command_finished_pairing`。这些测试验证协议身份与引用,不模拟具体驱动的异步回调;板级接入还应实际断开通信并延迟设备完成,检查启动次数始终为1、context在完成前存活、引用最终只释放一次。
|
||||
|
||||
## 7. 布局、固定存储与验证
|
||||
|
||||
@@ -338,7 +338,7 @@ S/E偏移只由`Se_Offset`计算,读取只能在已确认has_se的`Is_Select`
|
||||
<a id="command-example-policy"></a>
|
||||
### 7.1 示例配置与返回快照
|
||||
|
||||
示例地址常量集中在[点表头文件](../../examples/iec104_example_points.h),完整映射见[子站示例](../examples/IEC104子站示例.md)。45/58命令0x6001..0x6008对应遥信1001..1008,46/59命令0x6011..0x6018对应位置1101..1108,COT11分别使用带CP56的Type30/31;双点初值均为1。47/60命令0x6021..0x6028控制步位置;49/62命令0x6031..0x6038更新Type11遥测0x4001..0x4008的原始输入。CA来自命令行配置,物理点映射、限值及召唤分组仍属于应用。
|
||||
示例地址常量集中在`iec104_example_points.h`,完整映射见[子站示例](../examples/IEC104子站示例.md)。45/58命令0x6001..0x6008对应遥信1001..1008,46/59命令0x6011..0x6018对应位置1101..1108,COT11分别使用带CP56的Type30/31;双点初值均为1。47/60命令0x6021..0x6028控制步位置;49/62命令0x6031..0x6038更新Type11遥测0x4001..0x4008的原始输入。CA来自命令行配置,物理点映射、限值及召唤分组仍属于应用。
|
||||
|
||||
`Example_Init_Command`默认只注册上述32点,全部为SELECT_EXECUTE,`select_timeout_ms=60000`;未选择即执行回否定ACT_CON。默认全局掩码只保留45/46/47/49/58/59/60/62,同时清除51/64位并从Create借用范围排除末尾8个位串点。合法51/64请求因此由Command返回IGNORED,再由示例未知类型兜底返回COT44。只有显式传入`--command-extensions`,`Example_Init_Command_Mode(app, true)`才启用51/64并追加0x6041..0x6048的DIRECT点;这两种类型没有S/E字段,不能伪装成选择执行。库的DIRECT/SBO能力和30000ms通用默认选择有效期均保留。
|
||||
|
||||
@@ -608,7 +608,7 @@ action的request与context仅借用于本次同步调用。应用事件虽是纯
|
||||
<a id="command-change-tests"></a>
|
||||
### 修改影响与测试导航
|
||||
|
||||
下表给出[Command专项测试源文件](../../test/iec104_command_test.c)中的实际函数名,作为修改后的定向回归入口;执行结论以[测试验证记录](../test/IEC104测试文档.md#cot48-49-validation)及各次历史记录为准。
|
||||
下表给出`iec104_command_test.c`中的实际函数名,作为修改后的定向回归入口;执行结论以[测试验证记录](../test/IEC104测试文档.md#cot48-49-validation)及各次历史记录为准。
|
||||
|
||||
| 修改位置 | 必须保持的事实 | 对应测试函数 |
|
||||
|---|---|---|
|
||||
+1
-1
@@ -196,7 +196,7 @@ TcpServer把`head_info.pending_data`至`remaining_bytes`交给Net写操作,再
|
||||
|
||||
排障应记录STOP受理前的vs、当前frame_id、写入进度及随后ACT受理顺序。在没有新START的区间,判据是“不再增加vs、既有帧按原身份完成”,不是“STOP之后socket不再写任何字节”。业务事件按受理顺序出现,不能用较晚写出的旧CON覆盖已交付的最新启停状态。
|
||||
|
||||
现有[IDLE传输测试](../../test/iec104_idle_transport_test.c)的`test_stop_with_current_frame`使用3字节部分写入检查停止后vs不增加、sent_vs最终追上;[应答传输测试](../../test/iec104_response_transport_test.c)的`test_response_stop_cancels_pending_ticket`和`test_response_handed_ticket_survives_stop_and_disconnect`检查两类票据区别。CON交错状态由[子站启停实现](../../104/IEC104_Link_Slave_StartStop.c)及本章U帧路由规则约束。
|
||||
现有`iec104_idle_transport_test.c`的`test_stop_with_current_frame`使用3字节部分写入检查停止后vs不增加、sent_vs最终追上;`iec104_response_transport_test.c`的`test_response_stop_cancels_pending_ticket`和`test_response_handed_ticket_survives_stop_and_disconnect`检查两类票据区别。CON交错状态由[子站启停实现](../../../App/iec60870/104/IEC104_Link_Slave_StartStop.c)及本章U帧路由规则约束。
|
||||
|
||||
<a id="connection-strict-priority"></a>
|
||||
|
||||
+8
-8
@@ -2,7 +2,7 @@
|
||||
|
||||
> **用途**:在一个 Slave 上处理独立的计数量读取、冻结及复位事务。
|
||||
> **范围**:Type 101 请求、FRZ 分支、Type 15/37 与短浮点电能量206/207读取、广播及应用动作边界;计数器采集和存储由应用提供。
|
||||
> **源码依据**:[CounterInterrogation.c](../../104/business/IEC104_CounterInterrogation.c)、[公开头文件](../../104/business/IEC104_CounterInterrogation.h)、[共用引擎](../../104/business/IEC104_Interrogation.c)、[私有规则契约](../../104/business/IEC104_Interrogation_Internal.h)。
|
||||
> **源码依据**:[CounterInterrogation.c](../../../App/iec60870/104/business/IEC104_CounterInterrogation.c)、[公开头文件](../../../App/iec60870/104/business/IEC104_CounterInterrogation.h)、[共用引擎](../../../App/iec60870/104/business/IEC104_Interrogation.c)、[私有规则契约](../../../App/iec60870/104/business/IEC104_Interrogation_Internal.h)。
|
||||
> **同步日期**:2026-11-11。下文内部字段和函数用于解释实现,不新增应用可调用的私有接口。
|
||||
|
||||
与总召共用引擎的机制和规则边界见[业务层设计架构](IEC104_业务层_设计架构.md#business-interrogation);本文详述计数量动作和数据契约。
|
||||
@@ -50,7 +50,7 @@ flowchart TD
|
||||
|
||||
共用引擎对[同关联键ACT_CON](IEC104_Interrogation_设计架构.md#gi-confirm-order)保持接收顺序:同服务实例/代次、Type、实际CA、OA、TEST、IOA及完整QCC相同的后到忙否定,等待原确认被发送层接手。比较必须包含FRZ,不能把同RQT的读取、冻结、冻结并复位和仅复位视为同一关联键。原请求接受、拒绝及确认前超时均遵守该顺序,广播按每个实际CA判断;不等ACK或整轮结束,也不刷新原期限。不同键的就绪回复仍可先发;后到激活只有忙否定,不生成第二个BEGIN或执行第二次动作。
|
||||
|
||||
FRZ=0的数据COT使用`request.data_cause`:RQT=5为37,分组1..4为38..41。允许的数据类型如下;206/207依据配电自动化104细则§7.8接入总请求,不扩展到分组COT=38..41。
|
||||
FRZ=0的数据COT使用`request.data_cause`:RQT=5为37,分组1..4为38..41。允许的数据类型如下;206/207依据配电自动化104细则(外部手册,非本仓文档)§7.8接入总请求,不扩展到分组COT=38..41。
|
||||
|
||||
| 数据类型 | 数值与时标 | SQ | 数据COT | 249字节ASDU的对象上限(SQ=0 / SQ=1) |
|
||||
|---|---|---|---|---|
|
||||
@@ -66,15 +66,15 @@ FRZ=0的数据COT使用`request.data_cause`:RQT=5为37,分组1..4为38..41
|
||||
|
||||
206/207属于已有计数量业务的数据表示扩展。Type101仍负责请求、确认与结束,`CounterInterrogation`增加数据类型准入,`common`增加信息对象;采集、冻结及存储继续由应用负责,不新增独立电能量业务状态机或任务。COT=3的主动上送复用`Spontaneous`,它与计数量召唤分别消费应用提供的数据。
|
||||
|
||||
目录内[细则原件§7.8](../../20170804163032284877151.pdf#page=23)(23–25页)规定206/207的线格式、SQ及COT;[§8.1.11与图21–23](../../20170804163032284877151.pdf#page=38)(38–39页)区分应用场景:主站与终端电能量流程使用206读取当前示值,冻结数据通过文件记录和召回;207主要用于终端与线损采集模块间的冻结数据读取或主动上送。库同时提供两种对象;示例默认206,显式`--counter-type 207`才选择冻结值及时间的读取方式。支持207不表示终端必须默认向主站发送207,也不表示已实现线损模块的实际采集接口或冻结历史文件。
|
||||
目录内`20170804163032284877151.pdf`(23–25页)规定206/207的线格式、SQ及COT;`20170804163032284877151.pdf`(38–39页)区分应用场景:主站与终端电能量流程使用206读取当前示值,冻结数据通过文件记录和召回;207主要用于终端与线损采集模块间的冻结数据读取或主动上送。库同时提供两种对象;示例默认206,显式`--counter-type 207`才选择冻结值及时间的读取方式。支持207不表示终端必须默认向主站发送207,也不表示已实现线损模块的实际采集接口或冻结历史文件。
|
||||
|
||||
本模块的FRZ=1..3沿用既有IEC101兼容冻结/复位动作,具体完成方式见第2节;它们不是由细则§7.8的类型定义新增的流程要求。历史冻结文件需要应用记录、保存并接入文件服务,不能以207瞬时读取替代。
|
||||
本模块的FRZ=1..3沿用既有IEC101兼容冻结/复位动作,具体完成方式见第2节;它们不是由细则(外部手册)§7.8的类型定义新增的流程要求。历史冻结文件需要应用记录、保存并接入文件服务,不能以207瞬时读取替代。
|
||||
|
||||
Type101请求只携带QCC,没有“返回206还是207”的字段。应答类型由应用点表和运行配置决定;示例通过启动参数选择,一轮不会自动同时返回当前值和冻结值。库可在同一总请求中分别提交206和207的ASDU,但单帧不能混装两种类型,示例的一轮单类型是应用策略。真实点表须明确地址、正反向/有无功含义、单位和倍率;这些语义不包含在float32或QDS中。示例Wh到kWh的转换属于应用策略,公共对象不会自动缩放或累计电能。
|
||||
|
||||
| 实现位置 | 新增职责 | 保持的接口边界 |
|
||||
|---|---|---|
|
||||
| [InformationObjects.c/h](../../common/IEC60870_InformationObjects.c) | 206的float32+QDS,207再附CP56;登记对象长度、SQ支持及解码入口 | 通过Create/Get与ASDU Add/Get使用,不把15/37的BCR强转成新对象 |
|
||||
| [InformationObjects.c/h](../../../App/iec60870/common/IEC60870_InformationObjects.c) | 206的float32+QDS,207再附CP56;登记对象长度、SQ支持及解码入口 | 通过Create/Get与ASDU Add/Get使用,不把15/37的BCR强转成新对象 |
|
||||
| `Counter_Data_Allowed` | 读取批次允许206/207、SQ=0/1、COT=37 | 不选择数据源,不在冻结动作中附带数据,不改变15/37兼容规则 |
|
||||
| 共用`Interrogation`引擎 | 沿用BEGIN、NEED_DATA、FINISHED及HIGH背压流程 | 不保存电能值,不自动冻结,不替应用固定读取版本 |
|
||||
| 应用数据源与[示例接入](../examples/IEC104子站示例.md#计数量与主循环) | 选择当前/冻结数据,冻结时一起记录值、品质与时间,读取时固定整轮快照 | 实际采集、并发保护、断电恢复由应用实现 |
|
||||
@@ -217,7 +217,7 @@ FRZ=1..3在动作前继续检查BEGIN及业务期限,动作成功后按既有
|
||||
<a id="ci-scenarios"></a>
|
||||
### 4.1 冻结、读取及广播的端到端情景
|
||||
|
||||
以[示例实现](../../examples/iec104_slave_example.c)的Type15整数兼容模式为例,QCC=`0x85` 表示 RQT=5、FRZ=2。假定某点实时值120000、冻结序号0,按以下顺序处理:
|
||||
以`iec104_slave_example.c`的Type15整数兼容模式为例,QCC=`0x85` 表示 RQT=5、FRZ=2。假定某点实时值120000、冻结序号0,按以下顺序处理:
|
||||
|
||||
| 步骤 | 引擎和应用的操作 | 可观察结果 |
|
||||
|---|---|---|
|
||||
@@ -277,7 +277,7 @@ FRZ=1..3在动作前继续检查BEGIN及业务期限,动作成功后按既有
|
||||
<a id="ci-maintenance"></a>
|
||||
### 5.1 现有测试与修改影响
|
||||
|
||||
下表用于定位已有证据,不表示本次文档修改重新执行了测试。行为用例位于 [iec104_slave_example_test.c](../../test/iec104_slave_example_test.c) 的 `[CI/...]` 与 `[INTERROGATION/TOTAL_TIMEOUT]` 分区;后者同时执行总召与计数量读取,不是 Type102 Read。
|
||||
下表用于定位已有证据,不表示本次文档修改重新执行了测试。行为用例位于 `iec104_slave_example_test.c` 的 `[CI/...]` 与 `[INTERROGATION/TOTAL_TIMEOUT]` 分区;后者同时执行总召与计数量读取,不是 Type102 Read。
|
||||
|
||||
| 修改点/问题 | 对应现有测试函数 | 应保持的事实 |
|
||||
|---|---|---|
|
||||
@@ -294,7 +294,7 @@ FRZ=1..3在动作前继续检查BEGIN及业务期限,动作成功后按既有
|
||||
| 完成与共享连接退出 | `test_read_completed_before_term_handover`、`test_counter_stop_disconnect` | COMPLETED不是HANDED/ACK;STOP/断线同时使两种实例的旧交互失效 |
|
||||
| 多站读数/动作 | `test_counter_broadcast` | 读取三阶段,动作逐站确认;中间站拒绝不回滚已成功站,也不阻止后续站 |
|
||||
|
||||
规则文件是 [iec104_interrogation_rules_test.c](../../test/iec104_interrogation_rules_test.c),不经过网络或应用动作。`scripts/build.ps1 -Test -Suite Rules` 运行规则检查,`-Suite Example` 运行上述传输夹具用例(TCP容量1/2、HIGH251字节、业务事件FIFO2槽),`-Suite Loopback` 包含 [slave_example_loopback_test.cjs](../../test/slave_example_loopback_test.cjs) 的 `counterRead / counterReply` 及冻结、复位、重读序列。真实回环使用模拟计数器,不证明外部电表动作或现场主站互操作已通过。
|
||||
规则文件是 `iec104_interrogation_rules_test.c`,不经过网络或应用动作。`scripts/build.ps1 -Test -Suite Rules` 运行规则检查,`-Suite Example` 运行上述传输夹具用例(TCP容量1/2、HIGH251字节、业务事件FIFO2槽),`-Suite Loopback` 包含 `slave_example_loopback_test.cjs` 的 `counterRead / counterReply` 及冻结、复位、重读序列。真实回环使用模拟计数器,不证明外部电表动作或现场主站互操作已通过。
|
||||
|
||||
维护规则与引擎时需区分三类影响:
|
||||
|
||||
+5
-3
@@ -1,6 +1,8 @@
|
||||
# IEC104 文件服务设计架构
|
||||
|
||||
`IEC104_FileService`实现配电自动化国网扩展Type210的读目录、读文件和写文件。它与标准Type120–127的公共信息对象编解码独立,默认不在示例创建;通过`--file-service`启用。实现位于[IEC104_FileService.c](../../104/business/IEC104_FileService.c),公开契约位于[IEC104_FileService.h](../../104/business/IEC104_FileService.h)。验证记录见[专项测试](../test/IEC104测试文档.md#file-service-tests)。
|
||||
> **本项目未实现**:本文描述的能力在本仓 `App/iec60870/` 中**没有对应实现**(相关 `.c/.h` 在 2026-11-18 收编时裁除)。保留本文仅作协议能力与技术参考,不要据此判断功能可用;源码快照见 `IEC60870-Slave/`(该目录将来会删除)。
|
||||
|
||||
`IEC104_FileService`实现配电自动化国网扩展Type210的读目录、读文件和写文件。它与标准Type120–127的公共信息对象编解码独立,默认不在示例创建;通过`--file-service`启用。实现位于`IEC104_FileService.c`,公开契约位于`IEC104_FileService.h`。验证记录见[专项测试](../test/IEC104测试文档.md#file-service-tests)。
|
||||
|
||||
模块只负责传输协议:目录快照、文件存储、内容格式、压缩、权限、持久化和升级候选属于应用。COMMIT成功表示应用已经发布文件,确认交给发送层不表示主站收到;回复丢失后的结果核对仍由应用与主站完成。本文不声明目标主站互操作、ARMCC资源或掉电验收已经通过。
|
||||
|
||||
@@ -68,7 +70,7 @@ flowchart LR
|
||||
|
||||
### 1.2 可逐字节核对的ASDU
|
||||
|
||||
下表沿用[专项](../../test/iec104_file_service_test.c)的虚拟名称`H`,OA=0x35、CA=1、T=0,省略APCI。名称用于测试夹具;实际示例接受的文件路径见[示例目录](../examples/IEC104子站示例.md#example-file-service)。读场景文件为ASCII `ABC`,写场景声明4字节、请求ID为17,默认ZERO模式仍在确认里填ID0。
|
||||
下表沿用`iec104_file_service_test.c`的虚拟名称`H`,OA=0x35、CA=1、T=0,省略APCI。名称用于测试夹具;实际示例接受的文件路径见[示例目录](../examples/IEC104子站示例.md#example-file-service)。读场景文件为ASCII `ABC`,写场景声明4字节、请求ID为17,默认ZERO模式仍在确认里填ID0。
|
||||
|
||||
| 报文 | 长度 | ASDU十六进制 |
|
||||
|---|---:|---|
|
||||
@@ -502,7 +504,7 @@ Type211由独立[软件升级模块](IEC104_SoftwareUpgrade_设计架构.md)实
|
||||
|
||||
## 10. 规约来源与待联调项
|
||||
|
||||
设计依据为用户提供的《配电自动化系统应用DL/T634.5104-2009实施细则(试行)》§7.6、§8.1.9,101配套细则只用于明确补充。104文件字段在PDF19–22页、过程35–37页、P/N在11页、优先级45–46页;101相应为22–26页和45–47页。页码从封面起算。本次编码沿用提供的核对结论,不把它描述成新一轮原件复核或现场抓包。
|
||||
设计依据为用户提供的《配电自动化系统应用DL/T634.5104-2009实施细则(试行)》(外部手册,非本仓文档)§7.6、§8.1.9,101配套细则只用于明确补充。104文件字段在PDF19–22页、过程35–37页、P/N在11页、优先级45–46页;101相应为22–26页和45–47页。页码从封面起算。本次编码沿用提供的核对结论,不把它描述成新一轮原件复核或现场抓包。
|
||||
|
||||
提供方案记录的SHA256:104为`E453716ADBDE0B6D6F3DA47F758B506D4453944BFA21B20D8E43F9C4A73BC0CF`,101为`CFA174E9FDC1BF779EE2F88B1DC4B6C77917951AF78409531DB834720F72FBE6`。这些来源不是在线最新版本声明。
|
||||
|
||||
+6
-6
@@ -2,7 +2,7 @@
|
||||
|
||||
> **用途**:说明总召的独立接入方式,以及它使用的共用召唤引擎如何保存请求、驱动应用交互和回收资源。
|
||||
> **范围**:Type 100 总召及分组召唤、广播、撤销、业务期限和短应答;计数量仅在共用机制处作对照,不把两种业务合成一个实例。
|
||||
> **源码依据**:[Interrogation 实现](../../104/business/IEC104_Interrogation.c)、[公开契约](../../104/business/IEC104_Interrogation.h)、[私有规则接口](../../104/business/IEC104_Interrogation_Internal.h)及[GeneralInterrogation 实现](../../104/business/IEC104_GeneralInterrogation.c)。
|
||||
> **源码依据**:[Interrogation 实现](../../../App/iec60870/104/business/IEC104_Interrogation.c)、[公开契约](../../../App/iec60870/104/business/IEC104_Interrogation.h)、[私有规则接口](../../../App/iec60870/104/business/IEC104_Interrogation_Internal.h)及[GeneralInterrogation 实现](../../../App/iec60870/104/business/IEC104_GeneralInterrogation.c)。
|
||||
> **同步日期**:2026-11-11。内部结构用于解释实现,不是允许应用访问或复制的公开接口。
|
||||
|
||||
业务层整体位置、身份与驱动模型见[业务层设计架构](IEC104_业务层_设计架构.md);本文详述共用召唤引擎及总召契约。
|
||||
@@ -346,7 +346,7 @@ IOA、数据类型、分组成员和遍历方式均由调用者决定。BEGIN用
|
||||
|
||||
若调用者在当前值变成30后,仍把WAIT期间保存的旧ASDU20重新提交,格式和原交互合法时库不会因“值旧”而拒绝,也不会自动改成30。即使应用正确重读,积压突发仍可能晚于较新的总召值到达;需要避免主站实时值倒退时,须由应用与主站约定数据版本、时标或恢复策略,通用发送核心不代做点值一致性。
|
||||
|
||||
示例映射为:`Example_Build_Batch`从`signal_values/double_values/scaled_values`重新取值,`Example_Drain_Business`在WAIT时保留事件、OK时推进游标,不再检查应用发布队列是否为空。详见[示例总召取值流程](../examples/IEC104子站示例.md#gi-example-current-values)及[示例回归](../../test/iec104_slave_example_test.c)。
|
||||
示例映射为:`Example_Build_Batch`从`signal_values/double_values/scaled_values`重新取值,`Example_Drain_Business`在WAIT时保留事件、OK时推进游标,不再检查应用发布队列是否为空。详见[示例总召取值流程](../examples/IEC104子站示例.md#gi-example-current-values)及`iec104_slave_example_test.c`。
|
||||
|
||||
总召单/双点仍采用Type1/3无时标报文,符合本目录实施细则对总召的例外规定。Spontaneous默认形态改为CP56不影响总召组帧,也不能在这里复用保存历史发生时刻的SOE对象来代替当前值。总召之外的单/双点Type30/31及各自快照时刻,统一见[示例遥信策略](../examples/IEC104子站示例.md#example-signal-time)。
|
||||
|
||||
@@ -375,7 +375,7 @@ HIGH持续被其他生产者占满时仍可能反复WAIT;本设计不预留空
|
||||
|
||||
<a id="gi-sequence-profile"></a>
|
||||
|
||||
**项目规范与示例编码。** 项目所用规范§5.3(PDF第5页)要求回答总召时必须采用SQ=1连续地址方式;§8.1.2(PDF第31页)再次规定总召回答采用SQ=1压缩格式。主示例据此将站总召和已配置分组的Type1、3、11数据固定编码为SQ=1,不受`--sequence`影响。该选项仍只控制周期/背景扫描。通用ASDU及总召库继续支持上表中的SQ=0/1,由应用选择符合其接入规范的编码;不能把示例策略解释为公共库全面禁用SQ=0。
|
||||
**项目规范与示例编码。** 项目所用规范(外部手册,非本仓文档)§5.3(PDF第5页)要求回答总召时必须采用SQ=1连续地址方式;§8.1.2(PDF第31页)再次规定总召回答采用SQ=1压缩格式。主示例据此将站总召和已配置分组的Type1、3、11数据固定编码为SQ=1,不受`--sequence`影响。该选项仍只控制周期/背景扫描。通用ASDU及总召库继续支持上表中的SQ=0/1,由应用选择符合其接入规范的编码;不能把示例策略解释为公共库全面禁用SQ=0。
|
||||
|
||||
主示例默认配置每批最多4点;`Example_Build_Batch`实际受`request->max_objects_per_asdu`及缓冲容量约束,只把同一类型、IOA逐点连续的数据放入一帧,帧内仅保留首个IOA。遇到类型变化、地址断号或批次上限时结束当前帧,下一点另起一帧;不补造缺失点,也不为凑满4点跨越断号。单点批次同样允许SQ=1,此时VSQ为`0x81`。默认点表每帧4点,VSQ为`0x84`;COT/CA/IOA长度2/2/3时,Type1/3的ASDU各13字节,Type11为21字节,均不含6字节APCI。
|
||||
|
||||
@@ -581,7 +581,7 @@ B 整轮广播撤销:64 01 08 11 FF FF 00 00 00 14
|
||||
|
||||
表中的负7、负9、正9对应TEST=0时的原因字节`47`、`49`、`09`(十六进制);P/N与原因要分开解析。其他业务帧可穿插,因此抓包按Type100、CA、OA、QOI归类,不把全连接相邻帧当作这轮的全部顺序。若站2的BEGIN已经生成,A的前置条件不再成立,应按活动站撤销处理,不能仍期待负9。
|
||||
|
||||
应用事件台账只在实际取出BEGIN时登记该站的请求身份,在对应FINISHED时释放一次资源;不能按广播站数预先等待三个FINISHED。A可用`deactivated`没有增加、站2/3后续完成验证没有误取消;B可用站2/3不再产生工作事件验证整轮已停止。对应现有断言见[示例测试](../../test/iec104_slave_example_test.c)的`test_registry_pending_directed_deactivation`、`test_registry_failed_broadcast_deactivation`及满槽版本;测试还覆盖TEST位保留。这里提供对照推演,不增加一次新的测试通过记录。
|
||||
应用事件台账只在实际取出BEGIN时登记该站的请求身份,在对应FINISHED时释放一次资源;不能按广播站数预先等待三个FINISHED。A可用`deactivated`没有增加、站2/3后续完成验证没有误取消;B可用站2/3不再产生工作事件验证整轮已停止。对应现有断言见`iec104_slave_example_test.c`的`test_registry_pending_directed_deactivation`、`test_registry_failed_broadcast_deactivation`及满槽版本;测试还覆盖TEST位保留。这里提供对照推演,不增加一次新的测试通过记录。
|
||||
|
||||
## 10. 应用接入与退出顺序
|
||||
|
||||
@@ -713,7 +713,7 @@ Type100与Type101分别使用GeneralInterrogation和CounterInterrogation只读
|
||||
<a id="gi-maintenance"></a>
|
||||
### 13.1 现有测试定位
|
||||
|
||||
共用引擎的主要行为测试位于 [iec104_slave_example_test.c](../../test/iec104_slave_example_test.c),使用真实 Slave/传输路径及可控网络、时钟;文件名中的 example 不表示只测命令行。下表列可直接搜索的函数,不是本次文档修改重新运行的结果。`test_read_*` 这组用例在这里指总召与计数量读取,各跑两种实例,不是 Type 102 的 Read 模块。
|
||||
共用引擎的主要行为测试位于 `iec104_slave_example_test.c`,使用真实 Slave/传输路径及可控网络、时钟;文件名中的 example 不表示只测命令行。下表列可直接搜索的函数,不是本次文档修改重新运行的结果。`test_read_*` 这组用例在这里指总召与计数量读取,各跑两种实例,不是 Type 102 的 Read 模块。
|
||||
|
||||
| 修改或排查范围 | 现有用例 | 关键观察 |
|
||||
|---|---|---|
|
||||
@@ -730,7 +730,7 @@ Type100与Type101分别使用GeneralInterrogation和CounterInterrogation只读
|
||||
| 首站失败后的整轮广播撤销 | `test_registry_failed_broadcast_deactivation`、`test_registry_failed_broadcast_deactivation_full`、`test_registry_pending_directed_deactivation` | 未开始目标仍可整轮取消;原负7先于逐站负9/正9,满池及WAIT保持;每站首次FINISHED原因和定向匹配范围不变 |
|
||||
| 非当前站期限及慢链路预算 | `test_registry_total_deadline`、`test_registry_timeout_priority`、`test_read_slow_link_total_budget` | 已确认未来站也计时;总期限优先;持续进展不刷新总期限 |
|
||||
|
||||
无状态规则另见 [iec104_interrogation_rules_test.c](../../test/iec104_interrogation_rules_test.c) 的 `test_decode / test_qualifiers / test_types`;真实 TCP 的分组、广播、STOP/START 和重连见 [slave_example_loopback_test.cjs](../../test/slave_example_loopback_test.cjs)。构建入口分别是 `scripts/build.ps1 -Test -Suite Example`、`-Suite Rules`、`-Suite Loopback`。Example的兼容路径覆盖TCP容量1/2、HIGH 251字节和事件FIFO 2槽;严格模式使用符合新容量要求的独立配置。具体矩阵及完整运行记录仍以[测试说明](../test/IEC104测试文档.md)为准。
|
||||
无状态规则另见 `iec104_interrogation_rules_test.c` 的 `test_decode / test_qualifiers / test_types`;真实 TCP 的分组、广播、STOP/START 和重连见 `slave_example_loopback_test.cjs`。构建入口分别是 `scripts/build.ps1 -Test -Suite Example`、`-Suite Rules`、`-Suite Loopback`。Example的兼容路径覆盖TCP容量1/2、HIGH 251字节和事件FIFO 2槽;严格模式使用符合新容量要求的独立配置。具体矩阵及完整运行记录仍以[测试说明](../test/IEC104测试文档.md)为准。
|
||||
|
||||
### 13.2 修改一处时需要一起核对什么
|
||||
|
||||
+6
-53
@@ -361,7 +361,7 @@ return acknowledged_count <= outstanding_count;
|
||||
|
||||
### 3.2 接收 I 帧
|
||||
|
||||
依据[细则](../../20170804163032284877151.pdf)第 8.2.1 条注,接收方不检查发送序列号的连续性:收到的 15 位 `N(S)` 不与本地 `V(R)` 比较。重复、倒退、跳号或与本地计数不同的 `N(S)`,本身不会导致拒收或断链;通过其他校验的每帧仍分别受理,不按 `N(S)` 去重。这是统一接收行为,不增加配置项或切换模式。
|
||||
依据`20170804163032284877151.pdf`第 8.2.1 条注,接收方不检查发送序列号的连续性:收到的 15 位 `N(S)` 不与本地 `V(R)` 比较。重复、倒退、跳号或与本地计数不同的 `N(S)`,本身不会导致拒收或断链;通过其他校验的每帧仍分别受理,不按 `N(S)` 去重。这是统一接收行为,不增加配置项或切换模式。
|
||||
|
||||
`IEC104_Link_Handle_I_Frame()` 在修改状态前统一检查:
|
||||
|
||||
@@ -433,7 +433,7 @@ S接收要求STARTED,或本端为被控站且处于STOPPED/STOP_DRAINING。初
|
||||
|
||||
### 3.4 I 帧预留与 k 窗口
|
||||
|
||||
以下按 [IEC104_Link.c](../../104/IEC104_Link.c) 中的函数、变量名和执行顺序说明。`IEC104_Link_Prepare_I_Frame()` 是公开入口,内部依次完成序号规划、编码和提交;入口先检查 ASDU 及输出参数。这里的“原子”指失败时不留下部分提交的链路状态:返回 `0/-1` 时不修改 `state`、调用方的 `tx` 或 `frame`。同一连接仍须串行调用,函数内部不提供锁。
|
||||
以下按 [IEC104_Link.c](../../../App/iec60870/104/IEC104_Link.c) 中的函数、变量名和执行顺序说明。`IEC104_Link_Prepare_I_Frame()` 是公开入口,内部依次完成序号规划、编码和提交;入口先检查 ASDU 及输出参数。这里的“原子”指失败时不留下部分提交的链路状态:返回 `0/-1` 时不修改 `state`、调用方的 `tx` 或 `frame`。同一连接仍须串行调用,函数内部不提供锁。
|
||||
|
||||
#### 3.4.1 公开入口的参数检查
|
||||
|
||||
@@ -512,7 +512,7 @@ return IEC104_PLAN_READY;
|
||||
|
||||
#### 3.4.3 编码、提交及入队约定
|
||||
|
||||
公开入口使用计划中的序号调用 [IEC104_Codec.c](../../104/IEC104_Codec.c) 中的无状态编码函数:
|
||||
公开入口使用计划中的序号调用 [IEC104_Codec.c](../../../App/iec60870/104/IEC104_Codec.c) 中的无状态编码函数:
|
||||
|
||||
```c
|
||||
length = IEC104_Build_Iframe(frame,
|
||||
@@ -663,7 +663,7 @@ N(R)指向“下一帧期望序号”:32767只确认第一帧,0确认到第
|
||||
|
||||
时间同样不随ACK重新起算。若两帧分别在100ms和110ms完整写完,115ms只确认第一帧后,剩余I帧t1使用第二帧原始的110ms;不会从115ms重新计时。记录槽是否已经腾出还取决于TcpServer是否已转移RECORD,不能由va推进直接推断。
|
||||
|
||||
数值推演依据[Link的Plan_I_Frame、Acknowledge_Number_Valid和Complete_I_Send](../../104/IEC104_Link.c)。维护接收批次时可定位[调度测试](../../test/iec104_tcp_scheduler_test.c)的`test_invalid_ack`,它检查越界ACK最终归为PROTOCOL而非被提前归为确认超时;该场景不等于本节回绕数值的独立专项验证。
|
||||
数值推演依据[Link的Plan_I_Frame、Acknowledge_Number_Valid和Complete_I_Send](../../../App/iec60870/104/IEC104_Link.c)。维护接收批次时可定位`iec104_tcp_scheduler_test.c`的`test_invalid_ack`,它检查越界ACK最终归为PROTOCOL而非被提前归为确认超时;该场景不等于本节回绕数值的独立专项验证。
|
||||
|
||||
## 四、STARTDT 固定角色流程
|
||||
|
||||
@@ -811,7 +811,7 @@ START_CON、STOP_CON发送失败均返回FATAL,由上层断链,不回滚已
|
||||
|
||||
### 6.1 主动探测与连接接收事实
|
||||
|
||||
依据[细则](../../20170804163032284877151.pdf)第8.2.2、8.2.5条,被控站收到合法主站TESTFR_ACT后,在本TCP连接内停止准备新的主动ACT,后续主站ACT仍逐帧回复CON。控制站的主动探测不受此限制。被控站此前已准备、已入队或已发送的ACT继续按原FIFO、Complete及t1/CON规则完成,收到主站ACT不取消或续期已有探测。
|
||||
依据`20170804163032284877151.pdf`第8.2.2、8.2.5条,被控站收到合法主站TESTFR_ACT后,在本TCP连接内停止准备新的主动ACT,后续主站ACT仍逐帧回复CON。控制站的主动探测不受此限制。被控站此前已准备、已入队或已发送的ACT继续按原FIFO、Complete及t1/CON规则完成,收到主站ACT不取消或续期已有探测。
|
||||
|
||||
该接收事实由`peer_testfr_seen`保存:仅CONTROLLED角色收到合法ACT时置1;Init/Reset清0,正常STOP/START、发送完成及收到CON均不清除。TCP重连重新初始化后才恢复主动探测,不增加配置开关。`IEC104_LinkStatus_t`不扩展,调度统一查询`Can_Prepare_Testfr_Act()`,不另存门控副本。主动TESTFR仍使用独立`testfr_state`:
|
||||
|
||||
@@ -1049,7 +1049,7 @@ I/S路径只在结果精确等于 `IEC104_PLAN_READY` 时读取序号快照并
|
||||
|
||||
---
|
||||
|
||||
## 九、设计决策与变更记录
|
||||
## 九、设计决策
|
||||
|
||||
### 9.1 主要设计决策
|
||||
|
||||
@@ -1061,50 +1061,3 @@ I/S路径只在结果精确等于 `IEC104_PLAN_READY` 时读取序号快照并
|
||||
- **连接故障由连接层处理**:链路处理与完成接口通过 `FATAL` 返回值报告故障,TCP 连接上下文负责断连和隔离旧回调;链路状态不保存故障标志。
|
||||
- **算法与调度分离**:链路函数不读时钟、不发网络报文,便于确定性测试;集成层仍须串行提交单连接事件,但不要求人为保证首次STARTDT_CON发送完成回调先于对端首个I帧接收事件。
|
||||
- **先检查再提交**:I/S构帧保留序号规划,启停和TESTFR构帧直接判断状态;构帧路径在检查通过、编码成功后提交相应待发送状态。只受理请求的分支按自身契约修改状态;发送完成失败可以清理在途过程,但不提前提交成功的稳定状态。
|
||||
|
||||
### 9.2 变更记录
|
||||
|
||||
| 日期 | 变更 |
|
||||
|---|---|
|
||||
| 2026-09-03 | 从 `IEC104.c` 架构中拆出链路序号、启停和测试流程说明 |
|
||||
| 2026-09-07 | 增加 `k/w/t1/t2/t3`、S 确认快照以及 STARTDT/STOPDT/TESTFR 独立接口 |
|
||||
| 2026-09-08 | 改为每连接固定角色;稳定 `dt_state` 与统一 `dt_procedure` 分离;删除交叉启停状态和测试;STOPDT 复用公共 S 确认 |
|
||||
| 2026-09-08 | 完成接口改为 OK/IGNORED/FATAL 三态;非法确认快照纳入致命结果;删除链路层重复的故障标志和故障锁存接口,故障统一归连接上下文管理 |
|
||||
| 2026-09-09 | Handle 与 Complete 统一使用三态结果;合法重复/无匹配过程返回 IGNORED,协议、参数、状态和提前 STOPDT_CON 返回 FATAL |
|
||||
| 2026-09-09 | 已STARTED时的重复STARTDT_CON改为无状态应答,不占用dt_procedure;允许随后STOPDT_ACT直接进入排空,完成回调不覆盖停止过程 |
|
||||
| 2026-09-09 | I帧接收增加dt_state门控;STARTDT完成前及STOPDT完成后收到I帧返回FATAL,STOPDT排空半态仍允许接收并立即确认 |
|
||||
| 2026-09-10 | I帧接收与发送门控分离;被控站首次STARTDT_CON发送等待期间允许接收对端I帧,但继续禁止生成本端业务I帧 |
|
||||
| 2026-09-10 | I/S、STARTDT、STOPDT 和主动 TESTFR 的发送准备内部拆成只读状态规划、APCI 编码和成功提交三阶段;公开接口保持兼容 |
|
||||
| 2026-09-10 | 主动STOPDT拆成Request受理和Prepare推进,增加STOP_REQUESTED;两端停止准备接口改用明确枚举与报文类型/长度输出,调用方须迁移接口 |
|
||||
| 2026-09-10 | ACT准备与CON接收共用接收确认覆盖检查;拒绝未覆盖的新接收数据,兼容CON先于完整覆盖的S帧完成回调 |
|
||||
| 2026-09-10 | 被控站停止期间暂存一个STARTDT_ACT并返回DEFERRED;STOPDT_CON成功后通过Prepare_Pending_Startdt_Con推进启动,停止发送失败和Reset取消暂存 |
|
||||
| 2026-09-10 | 全部Plan函数统一使用私有IEC104_PlanResult_t;仅READY读取规划输出并编码,公开接口显式映射原有返回值和等待原因 |
|
||||
| 2026-09-10 | 删除入口已校验的U帧路径中不可达的编码失败分支;首次启动应答私有构造函数改为void,STOPDT的S准备检查独立保留,公开接口兼容 |
|
||||
| 2026-09-10 | STOPDT规划一次性输出报文类型与S帧N(R)快照;普通S确认和停止排空共用Build_S_Ack编码及提交,消除停止流程内的二次S规划 |
|
||||
| 2026-09-10 | 旧单路全局复位接口更名为IEC104_Legacy_Link_Reset,明确其兼容入口用途;外部调用方须更新名称并重新编译 |
|
||||
| 2026-09-10 | 统一ACT及停止CON完成分支的失败提前返回写法;T2/T3复用已校验内部准备路径,保留未到期非法参数返回-1;澄清STARTDT/STOPDT的T1允许合法被控站查询并返回0 |
|
||||
| 2026-09-10 | 同步完整状态字段、I帧FIFO完成边界与t1公式、收发门控表、结果与输出有效期;补充S完成身份边界、有界队列接入责任、兼容完成路径和验证状态链接 |
|
||||
| 2026-09-10 | 修复后到的STOPDT_ACT未取消旧暂存STARTDT:可受理的停止请求清除pending_start_act,保留停止进度和确认快照 |
|
||||
| 2026-09-11 | 按公共、主站、子站拆分实现和公开头文件;角色过程校验归各自模块,STOPDT准备去掉跨角色选择;保留旧总头文件和全部公开接口 |
|
||||
| 2026-09-11 | 精简5个启停/TESTFR规划函数,移除私有STOPDT计划和等待结果转换;去除重复状态校验与可推导的I帧判断 |
|
||||
| 2026-09-14 | 完善STARTDT方向门控:控制站允许ACT后的提前I帧;被控站受理ACT后接收I/S,首次CON完成前暂缓w/immediate/t2确认;补齐初始停止及主站启动等待的S接收门控 |
|
||||
| 2026-09-15 | 首次STARTDT_CON待完成期间,重复STARTDT_ACT逐个生成CON并返回OK;保持原启动过程,所有CON按FIFO发送并提交完成,首次成功完成提交STARTED,后续重复应答不覆盖启停状态 |
|
||||
| 2026-09-15 | 统一S确认、STARTDT/STOPDT及TESTFR的本地发送完成接口为Complete_*_Send,不保留旧名转发入口;同步声明、调用和文档,参数、状态结构、返回值及处理逻辑不变 |
|
||||
| 2026-09-15 | 明确后到STOP取消暂存START属于本实现策略,正常主动启停串行 |
|
||||
| 2026-09-16 | TESTFR 简化为三态,统一为先提交 ACT 发送完成再处理 CON;移除提前 CON 半态,未等待时忽略且不缓存 CON |
|
||||
| 2026-09-16 | 澄清 TESTFR t3 活动计时与 t1 等待计时的职责,补充同一连接旧探测定时器回调的处理约定 |
|
||||
| 2026-09-16 | 澄清 Reset 的字段复位范围、故障会话清理与旧事件隔离要求,明确新连接初始化时机和上下文安全复用条件;仅修改说明和代码注释 |
|
||||
| 2026-09-16 | 将 Reset 已实现行为与尚未实现的连接层接入要求分开标注,精简外部清理过程描述并同步接口注释 |
|
||||
| 2026-09-16 | 新增独立有界发送FIFO,支持先预留再构帧、部分写入和队首出队;明确未确认I帧须转存确认记录,实际TCP、Complete分派和定时器尚未集成 |
|
||||
| 2026-09-16 | 当时增加完整 APDU 保留及最早未确认帧 t1 判定,随后采用单节点池;该存储方案已由下述 2026-09-23 环形队列方案替代 |
|
||||
| 2026-09-16 | SendBuffer改为调用方单数组节点池;发送FIFO与I帧保留链引用同一节点,删除独立确认数组及APDU复制,I帧Commit_Send_Completion后等ACK再释放,链路Prepare/Complete接口不变 |
|
||||
| 2026-09-17 | 集中I/S启停准入与停止阶段立即确认判断;公共S完成失败和子站停止流程复用暂存启动取消操作,保持公开接口、状态结构及原有检查和提交顺序 |
|
||||
| 2026-09-23 | ACK上限收紧为本地完成位置sent_vs,SendBuffer同步按next_complete_ns校验;拒绝确认未发送/未完成提交的排队帧,先检查再提交;简化已完成未确认及保留帧计数,新增10个专项回归 |
|
||||
| 2026-09-23 | SendBuffer 改为 APDU 环形 FIFO,本地完成后释放槽位;Manager 独立保存确认记录并提供最早未确认记录和 I 帧 t1 查询,原始业务数据由业务层保留 |
|
||||
| 2026-09-23 | 三发送模块进一步改为变长ASDU字节环、单当前I帧和独立6字节控制槽;发送前编号,Link独占协议位置,有效ACK释放原文,回执独立消费,断线显式Rebind;测试文件保持原样 |
|
||||
| 2026-10-18 | 收紧被控站I帧接收门控:受理STOPDT_ACT后至再次进入启动接收阶段前,新I帧返回FATAL且不交付业务;保留控制站接收及S确认规则,暂存START不提前开放接收 |
|
||||
| 2026-10-19 | 先前补齐双向暂存:首个STARTDT_CON在途时以pending_stop_act暂存STOP,受理即关闭数据门控并开始停止总时限;后到START取消暂存STOP及计时,重复STOP不续期。停止排空时暂存START的处理由下条策略替代 |
|
||||
| 2026-10-19 | 调整启停行为:STOP_DRAINING收到START时取消停止并生成启动应答,结束STOP总计时;仅STOP_CON已生成时仍暂存START。保留发送完成提交、部分写入和FIFO约束,STOPPED下结束排空后仍按首个启动CON清理HIGH和配额 |
|
||||
| 2026-10-19 | 替代此前子站CON完成提交及双向暂存策略:START/STOP按受理立即激活/停用,取消两个pending字段和子站CON半态;旧CON完成不修改状态;S与STOP_CON可依次排队。Connection按匹配STOP_CON身份结束总期限,TcpServer在受理时交付状态事件。 |
|
||||
| 2026-11-15 | 按细则8.2.1注取消接收N(S)连续性检查,V(R)按受理数量递增;保留N(R)、字段、启停及本端发送FIFO校验。详见[接收规则](#link-receive-sequence-compatibility)。 |
|
||||
| 2026-11-15 | 按细则8.2.2登记被控站收到主站ACT的连接事实,统一抑制新主动TESTFR;接收接口改为(state,apci),CON由发送层编码,WAIT保留应答义务。详见[TESTFR规则](#link-testfr-master-preference)。 |
|
||||
+3
-3
@@ -1,6 +1,6 @@
|
||||
# IEC104 参数装载设计架构(Type 110–113)
|
||||
|
||||
实现:[`IEC104_Parameter.c`](../../104/business/IEC104_Parameter.c)、[公开头](../../104/business/IEC104_Parameter.h)。接入见[完整调用流程](IEC104_完整调用流程.md#flow-parameter),声明见[API 汇总](IEC104_API接口汇总.md#parameter-api),运行示例见[参数联调](../examples/IEC104子站示例.md#example-parameter),验证状态见[参数测试](../test/IEC104测试文档.md#parameter-tests)。
|
||||
实现:[`IEC104_Parameter.c`](../../../App/iec60870/104/business/IEC104_Parameter.c)、[公开头](../../../App/iec60870/104/business/IEC104_Parameter.h)。接入见[完整调用流程](IEC104_完整调用流程.md#flow-parameter),声明见[API 汇总](IEC104_API接口汇总.md#parameter-api),运行示例见[参数联调](../examples/IEC104子站示例.md#example-parameter),验证状态见[参数测试](../test/IEC104测试文档.md#parameter-tests)。
|
||||
|
||||
主示例中参数如何参与实际测量处理,集中见[示例应用测量链](#parameter-measurement-design);该节定义应用算法和状态,不改变本模块的报文契约。
|
||||
|
||||
@@ -233,9 +233,9 @@ Cancel 不撤回已交出的肯定帧。健康连接取消尚未 ACK 的准备
|
||||
|
||||
## 11. 示例应用测量链
|
||||
|
||||
本节对应 [`iec104_slave_example.c`](../../examples/iec104_slave_example.c) 的 `[MEASUREMENT/PROCESS]`、`[PARAMETER/ACTION]` 和 `[COMMON/LOOP]`。主示例默认启用参数处理,门限、上下限和平滑时间参与测量链;`--no-parameter`关闭后沿用直接更新和上送流程,`--parameter`可显式开启。默认采用变化上送及低频背景刷新,固定周期显式配置;这属于示例应用策略,不改变Parameter或PeriodicScan库默认契约。独立双主站小示例只展示配置共享和读回,不包含这条测量链。参数地址及初值维护在[示例点表](../examples/IEC104子站示例.md#example-parameter),模拟输入维护在[模拟工况](../examples/IEC104子站示例.md#example-simulation),不在此重复。
|
||||
本节对应 `iec104_slave_example.c` 的 `[MEASUREMENT/PROCESS]`、`[PARAMETER/ACTION]` 和 `[COMMON/LOOP]`。主示例默认启用参数处理,门限、上下限和平滑时间参与测量链;`--no-parameter`关闭后沿用直接更新和上送流程,`--parameter`可显式开启。默认采用变化上送及低频背景刷新,固定周期显式配置;这属于示例应用策略,不改变Parameter或PeriodicScan库默认契约。独立双主站小示例只展示配置共享和读回,不包含这条测量链。参数地址及初值维护在[示例点表](../examples/IEC104子站示例.md#example-parameter),模拟输入维护在[模拟工况](../examples/IEC104子站示例.md#example-simulation),不在此重复。
|
||||
|
||||
地址归示例应用所有,由[iec104_example_points.h](../../examples/iec104_example_points.h)集中定义;主示例、双主站参数示例及配置文件用途说明共用这些宏。32个参数点按四组各8点映射到8个测量点,参数IOA与测量IOA分属不同分区;QPA3仍寻址测量点,Parameter协议模块不根据地址差值推导参数与测量关系。表8分区、避开附录E参数范围的分配及其他消费者见[公共点表](../examples/IEC104子站示例.md#example-addresses)。
|
||||
地址归示例应用所有,由`iec104_example_points.h`集中定义;主示例、双主站参数示例及配置文件用途说明共用这些宏。32个参数点按四组各8点映射到8个测量点,参数IOA与测量IOA分属不同分区;QPA3仍寻址测量点,Parameter协议模块不根据地址差值推导参数与测量关系。表8分区、避开附录E参数范围的分配及其他消费者见[公共点表](../examples/IEC104子站示例.md#example-addresses)。
|
||||
|
||||
| 所属部分 | 负责的行为 |
|
||||
|---|---|
|
||||
+9
-9
@@ -27,13 +27,13 @@
|
||||
|
||||
| 文件或入口 | 职责 |
|
||||
|---|---|
|
||||
| [IEC104_PeriodicScan.h](../../104/business/IEC104_PeriodicScan.h) | 配置、点表、lookup、状态和在线修改的公开契约;实例为不透明句柄 |
|
||||
| [IEC104_PeriodicScan.c](../../104/business/IEC104_PeriodicScan.c) | 静态池、配置校验、组网格、候选点判断、组帧、游标提交和替换续扫 |
|
||||
| [IEC104_Slave.h](../../104/IEC104_Slave.h) | 生命周期身份、只读站点查询、IDLE 准入/交接及发送能力查询 |
|
||||
| [公共 ASDU](../../common/IEC60870_Asdu.h)与[对象层](../../common/IEC60870_InformationObjects.h) | 单对象容器、解析校验、SQ=0/1 编码;不管理扫描网格 |
|
||||
| [IEC104_PeriodicScan.h](../../../App/iec60870/104/business/IEC104_PeriodicScan.h) | 配置、点表、lookup、状态和在线修改的公开契约;实例为不透明句柄 |
|
||||
| [IEC104_PeriodicScan.c](../../../App/iec60870/104/business/IEC104_PeriodicScan.c) | 静态池、配置校验、组网格、候选点判断、组帧、游标提交和替换续扫 |
|
||||
| [IEC104_Slave.h](../../../App/iec60870/104/IEC104_Slave.h) | 生命周期身份、只读站点查询、IDLE 准入/交接及发送能力查询 |
|
||||
| [公共 ASDU](../../../App/iec60870/common/IEC60870_Asdu.h)与[对象层](../../../App/iec60870/common/IEC60870_InformationObjects.h) | 单对象容器、解析校验、SQ=0/1 编码;不管理扫描网格 |
|
||||
| [发送模块](IEC104_发送模块_设计架构.md) | IDLE 的编号、窗口/记录预留、写出与 ACK;不保存点表或扫描游标 |
|
||||
| [iec104_periodic_scan_test.c](../../test/iec104_periodic_scan_test.c) | 网格、预算、SQ、回调隔离、在线修改及多实例专项 |
|
||||
| [iec104_idle_transport_test.c](../../test/iec104_idle_transport_test.c) | 发送准入、未分派请求屏障和 HIGH/NORMAL/IDLE 记账专项 |
|
||||
| `iec104_periodic_scan_test.c` | 网格、预算、SQ、回调隔离、在线修改及多实例专项 |
|
||||
| `iec104_idle_transport_test.c` | 发送准入、未分派请求屏障和 HIGH/NORMAL/IDLE 记账专项 |
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
@@ -455,7 +455,7 @@ Cancel、Set_Group_Period、Set_Point_Period及Replace_Points不会解除faulted
|
||||
|
||||
在线换表与故障恢复的组合可以按现有测试逐步复查:三个点因发送查询错误进入faulted,全部未交接资格保留;新表在它们前面插入一个点并使用新位图,Replace_Points成功迁移旧三个点的资格,但仍保持faulted。只有Resume通过才重新进入调度,旧三个点按pending资格发送;新增前缀点没有继承旧资格,按新表的正常网格参与。不能把“换表成功”当作“扫描已恢复”,也不能为让新点立即出现而手工改位图。对应`test_point_faulted_replace_and_resume`,借用及迁移细节仍以[整表替换](#7-整表替换)为准。
|
||||
|
||||
这些检查使用[扫描专项](../../test/iec104_periodic_scan_test.c)的已有断言定位行为,不是本轮新增运行结果。若实例未故障且一直无法取得IDLE机会,继续检查HIGH/NORMAL待发、当前帧、窗口、记录槽和未分派请求;这属于[发送准入](#5-idle-发送与-reserve),不应通过缩短组周期或反复Resume制造发送机会。
|
||||
这些检查使用`iec104_periodic_scan_test.c`的已有断言定位行为,不是本轮新增运行结果。若实例未故障且一直无法取得IDLE机会,继续检查HIGH/NORMAL待发、当前帧、窗口、记录槽和未分派请求;这属于[发送准入](#5-idle-发送与-reserve),不应通过缩短组周期或反复Resume制造发送机会。
|
||||
|
||||
## 7. 整表替换
|
||||
|
||||
@@ -498,7 +498,7 @@ bool IEC104_PeriodicScan_Replace_Points(IEC104_PeriodicScan_t *self,
|
||||
|
||||
示例通过`--cyclic-ms`配置Type11周期组,通过`--background-ms`配置Type11背景组;两组都只有0x4001..0x4008的8个遥测,遥信不参与无时标扫描。首延迟各取一个周期;默认只启用低频背景刷新,固定周期须显式开启,两项均为0时不创建扫描实例。`--sequence`将两组阈值设为2,默认关闭。示例运行策略不改变扫描库的类型支持及默认配置;具体默认值、部署参数和点值见[示例说明](../examples/IEC104子站示例.md#example-periodic-scan)。
|
||||
|
||||
`EXAMPLE_SCAN_POINT_COUNT`等于8个遥测点数;`scan_points[0..7]`与遥测数组一一对应,每行属于两个组,COT=1和COT=2分别组帧。启用点级周期时,应用借出同序的8项`uint32_t point_period_ms`及1字节`point_retry_pending`,Create后只经扫描接口修改周期,由模块独占维护重试位。地址基值来自[共享点表常量](../../examples/iec104_example_points.h),参数QPA=3也按这些IOA查找扫描行,不再保留遥信行所占的索引前缀。
|
||||
`EXAMPLE_SCAN_POINT_COUNT`等于8个遥测点数;`scan_points[0..7]`与遥测数组一一对应,每行属于两个组,COT=1和COT=2分别组帧。启用点级周期时,应用借出同序的8项`uint32_t point_period_ms`及1字节`point_retry_pending`,Create后只经扫描接口修改周期,由模块独占维护重试位。地址基值来自`iec104_example_points.h`,参数QPA=3也按这些IOA查找扫描行,不再保留遥信行所占的索引前缀。
|
||||
|
||||
主示例默认启用参数处理;显式配置非零`--cyclic-ms`后,COT=1采用点级组,由Type113/QPA=3按遥测IOA启停,COT=2背景组保持独立。默认仅背景运行时,QPA3返回否定确认;`--no-parameter`关闭参数后,COT=1沿用组周期。扫描lookup读取应用已处理的测量值和品质,不推进滤波;普通COT=3变化门限不抑制周期或背景上送。参数动作先于本轮Step,启停和量程品质可以影响随后扫描,具体数据可见性见[示例测量调度](IEC104_Parameter_设计架构.md#parameter-measurement-schedule)。
|
||||
|
||||
@@ -603,4 +603,4 @@ PROGRESS可能是本次先交接、随后遇到WAIT,不能据此立即无限
|
||||
| 重试位图配置、替换和隔离 | 校验失败不写位图;按完整键和同点级组迁移,跨实例可写位图不能共用 | `test_point_retry_configuration`、`test_point_retry_replace_mapping_and_validation`、`test_point_retry_replace_group_membership`、`test_point_retry_independent_instances` |
|
||||
| IDLE跨层准入与收尾 | 保留请求优先、reserve空位、混合ACK、STOP后不新增编号 | 传输专项的`test_retained_request_resume`、`test_reserve_pair`、`test_mixed_ack`、`test_stop_with_current_frame` |
|
||||
|
||||
表中扫描相关用例位于[扫描专项](../../test/iec104_periodic_scan_test.c),末行位于[IDLE传输专项](../../test/iec104_idle_transport_test.c)。部分用例由组容量、TCP容量或行预算宏控制;查找测试名后还应核对main中的编译条件,不能只运行一个默认配置便认为所有边界都覆盖。当前完整矩阵由`./scripts/build.ps1 -Test -Suite PeriodicScan`运行,已移除旧开发阶段选择及历史实现替换入口。
|
||||
表中扫描相关用例位于`iec104_periodic_scan_test.c`,末行位于`iec104_idle_transport_test.c`。部分用例由组容量、TCP容量或行预算宏控制;查找测试名后还应核对main中的编译条件,不能只运行一个默认配置便认为所有边界都覆盖。当前完整矩阵由`./scripts/build.ps1 -Test -Suite PeriodicScan`运行,已移除旧开发阶段选择及历史实现替换入口。
|
||||
+14
-14
@@ -6,7 +6,7 @@
|
||||
|
||||
状态:已实施,2026-11-03。范围仅为 `IEC60870-Slave`。本文合并初稿及三轮评审结论;决定记录见第15节。
|
||||
|
||||
[`IEC104_Read.c`](../../104/business/IEC104_Read.c) / [`IEC104_Read.h`](../../104/business/IEC104_Read.h) 处理 Type 102(C_RD_NA_1)。主站按 CA、IOA 读取单个监视点当前值;模块负责校验、路由、FIFO、期限及应答,应用在显式调用 `Execute_Next` 时传入同步 lookup。
|
||||
[`IEC104_Read.c`](../../../App/iec60870/104/business/IEC104_Read.c) / [`IEC104_Read.h`](../../../App/iec60870/104/business/IEC104_Read.h) 处理 Type 102(C_RD_NA_1)。主站按 CA、IOA 读取单个监视点当前值;模块负责校验、路由、FIFO、期限及应答,应用在显式调用 `Execute_Next` 时传入同步 lookup。
|
||||
|
||||
> **用途**:说明读命令模块自己的依赖、任务模型、状态转换和调用契约,供接入及修改源码时使用。
|
||||
> **实现依据**:`104/business/IEC104_Read.c/h`;本文中的 READ/REPLY 分别对应私有阶段 `READ_VALUE`/`READ_REPLY`,不是新增的传输队列。
|
||||
@@ -21,12 +21,12 @@
|
||||
|
||||
| 文件或入口 | 在本模块中的职责 |
|
||||
|---|---|
|
||||
| [IEC104_Read.h](../../104/business/IEC104_Read.h) | 不透明句柄、配置、lookup 请求与结果、状态及八个公开入口 |
|
||||
| [IEC104_Read.c](../../104/business/IEC104_Read.c) | 静态实例池、固定任务槽、请求校验、取值隔离、应答及清理 |
|
||||
| [IEC104_Slave.h](../../104/IEC104_Slave.h) | 事件身份、站点引用、会话检查、HIGH 容量查询和应答提交 |
|
||||
| [公共 ASDU](../../common/IEC60870_Asdu.h)与[对象层](../../common/IEC60870_InformationObjects.h) | Type 102 解析、监视对象构造、应答容器校验及 CP56 解析 |
|
||||
| [iec104_read_test.c](../../test/iec104_read_test.c) | 请求顺序、回调隔离、期限、STOP、站点删除和发送等待的专项验证 |
|
||||
| [iec104_slave_example.c](../../examples/iec104_slave_example.c) | 应用事件分派、模拟点表 lookup 及其他业务之间的调度 |
|
||||
| [IEC104_Read.h](../../../App/iec60870/104/business/IEC104_Read.h) | 不透明句柄、配置、lookup 请求与结果、状态及八个公开入口 |
|
||||
| [IEC104_Read.c](../../../App/iec60870/104/business/IEC104_Read.c) | 静态实例池、固定任务槽、请求校验、取值隔离、应答及清理 |
|
||||
| [IEC104_Slave.h](../../../App/iec60870/104/IEC104_Slave.h) | 事件身份、站点引用、会话检查、HIGH 容量查询和应答提交 |
|
||||
| [公共 ASDU](../../../App/iec60870/common/IEC60870_Asdu.h)与[对象层](../../../App/iec60870/common/IEC60870_InformationObjects.h) | Type 102 解析、监视对象构造、应答容器校验及 CP56 解析 |
|
||||
| `iec104_read_test.c` | 请求顺序、回调隔离、期限、STOP、站点删除和发送等待的专项验证 |
|
||||
| `iec104_slave_example.c` | 应用事件分派、模拟点表 lookup 及其他业务之间的调度 |
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
@@ -135,7 +135,7 @@ REPLY由请求副本经 Create_From_Buffer、Set_COT、Set_Negative生成,字
|
||||
|
||||
## 4. 公共接口
|
||||
|
||||
完整声明与字段见[头文件](../../104/business/IEC104_Read.h)及[API汇总第27节](IEC104_API接口汇总.md#file-27)。
|
||||
完整声明与字段见[头文件](../../../App/iec60870/104/business/IEC104_Read.h)及[API汇总第27节](IEC104_API接口汇总.md#file-27)。
|
||||
|
||||
| 接口 | 契约 |
|
||||
|---|---|
|
||||
@@ -266,7 +266,7 @@ stateDiagram-v2
|
||||
<a id="read-progress-and-recovery"></a>
|
||||
### 6.8 推进、恢复与测试定位
|
||||
|
||||
排查一次读请求时,先按`receive_serial`确定原任务,再看它是否仍为队首READ;不能只按IOA匹配,因为同一点允许有多个请求。以下情景直接对应[现有专项](../../test/iec104_read_test.c)中的函数,作为修改入口、期限或释放路径时的核对位置;这不是本轮重新执行测试的记录。
|
||||
排查一次读请求时,先按`receive_serial`确定原任务,再看它是否仍为队首READ;不能只按IOA匹配,因为同一点允许有多个请求。以下情景直接对应`iec104_read_test.c`中的函数,作为修改入口、期限或释放路径时的核对位置;这不是本轮重新执行测试的记录。
|
||||
|
||||
| 情景与入口 | 实际推进及资源结果 | 现有测试函数 |
|
||||
|---|---|---|
|
||||
@@ -300,7 +300,7 @@ stateDiagram-v2
|
||||
|
||||
分支二只收到一帧不等于漏调lookup:B因期限到期静默结束,没有额外ACT_CON、否定确认或ACT_TERM。应同时查看`timeouts`及请求受理/提交时刻;不要仅靠`Execute_Next`的OK累计“读成功”,也不要在超时后补发缓存的10。若主站需要逐次区分相同CA/IOA/OA的读取,应串行等待响应或按双方允许的请求关联方式处理;模块内部`receive_serial`不会作为新增字段回传线上。
|
||||
|
||||
现有[Read专项](../../test/iec104_read_test.c)的`test_read_waits`验证22/23字节门槛与WAIT后重取,`test_read_quality_wait_refresh`验证值和IV一起刷新,`test_read_deadlines`及`test_read_expired_head_and_fifo`验证原受理期限和FIFO清理。上述A/B数值组合用于联调推演,不把它描述成新增的一次实测记录。
|
||||
现有`iec104_read_test.c`的`test_read_waits`验证22/23字节门槛与WAIT后重取,`test_read_quality_wait_refresh`验证值和IV一起刷新,`test_read_deadlines`及`test_read_expired_head_and_fifo`验证原受理期限和FIFO清理。上述A/B数值组合用于联调推演,不把它描述成新增的一次实测记录。
|
||||
|
||||
## 7. 期限
|
||||
|
||||
@@ -353,7 +353,7 @@ Windows x64 GCC结果不代表Keil/ARMCC的板端RAM或最坏栈,板端集成
|
||||
|
||||
## 11. 示例接入
|
||||
|
||||
[子站示例](../../examples/iec104_slave_example.c)在消费通知前创建Read;分派位于遥控后、44兜底前。兼容模式在遥控后、应用发布队列前推进Read,先Process再有界Execute_Next,每次OK后再Process;严格模式通过[集中业务轮](IEC104_业务层_设计架构.md#business-loop)准备第5级读应答,不用兼容模式的调用先后推断发送次序。Wait_Time使用第6.5节条件。
|
||||
`iec104_slave_example.c`在消费通知前创建Read;分派位于遥控后、44兜底前。兼容模式在遥控后、应用发布队列前推进Read,先Process再有界Execute_Next,每次OK后再Process;严格模式通过[集中业务轮](IEC104_业务层_设计架构.md#business-loop)准备第5级读应答,不用兼容模式的调用先后推断发送次序。Wait_Time使用第6.5节条件。
|
||||
|
||||
| 可读IOA | 类型 | 数据源 |
|
||||
|---|---|---|
|
||||
@@ -363,7 +363,7 @@ Windows x64 GCC结果不代表Keil/ARMCC的板端RAM或最坏栈,板端集成
|
||||
| 1301–1308 | 7 | bitstring_values及品质0 |
|
||||
| 0x4001–0x4008 | 11 | scaled_values及Example_Measurement_Quality返回的当前品质 |
|
||||
|
||||
点号来自集中[示例点表](../../examples/iec104_example_points.h),其中遥测从0x4001开始;单点1001的十六进制值为0x03E9,不把十进制外观当作地址分区。与总召、遥控共用运行值;0x6401–0x6408计数量及0x6001..0x6048范围内的命令点回47。接入真实采集源时,已知点的临时无效数据应通过该点原类型的品质IV=1快照返回FOUND;只有无法构造符合约定的对象才返回ERROR。主示例无额外Read开关。
|
||||
点号来自集中`iec104_example_points.h`,其中遥测从0x4001开始;单点1001的十六进制值为0x03E9,不把十进制外观当作地址分区。与总召、遥控共用运行值;0x6401–0x6408计数量及0x6001..0x6048范围内的命令点回47。接入真实采集源时,已知点的临时无效数据应通过该点原类型的品质IV=1快照返回FOUND;只有无法构造符合约定的对象才返回ERROR。主示例无额外Read开关。
|
||||
|
||||
主示例默认启用参数处理,遥测运行值为平滑处理值,配置量程之外保留数值并置OV,lookup仍返回FOUND、Type11、COT5、P/N=0。Read不等待值收敛,也不受普通COT3变化门限抑制;提交WAIT后下次lookup重取当时的处理值和品质。参数IOA0x8601..0x8608、0x8611..0x8618、0x8621..0x8628、0x8631..0x8638不属于Read可读点表,读这些地址返回47;32项参数配置通过站总召读回。显式`--no-parameter`时遥测直通且不附加参数总召。处理值与原始输入的关系见[测量平滑](IEC104_Parameter_设计架构.md#parameter-measurement-filter),各上送路径见[上送调度](IEC104_Parameter_设计架构.md#parameter-measurement-schedule)。
|
||||
|
||||
@@ -406,9 +406,9 @@ Read内部仍按请求FIFO推进。兼容模式HIGH余量20字节时,Read的23
|
||||
|
||||
## 12. 测试
|
||||
|
||||
[专项测试](../../test/iec104_read_test.c) 使用可控Net、单调时钟及真实Slave/TCP/发送队列,当前18组测试按TCP容量1/2 × 任务槽1/4、HIGH=251四配置运行,实测记录见[测试文档](../test/IEC104测试文档.md)。覆盖校验优先级、独立期望字节的16种类型、lookup结果/误用、数据无效应答及恢复、FIFO、余量/提交WAIT、期限、会话、重入、引用及同CA替换、k=1管线;另用TCP=2/实例池=1验证池耗尽。
|
||||
`iec104_read_test.c` 使用可控Net、单调时钟及真实Slave/TCP/发送队列,当前18组测试按TCP容量1/2 × 任务槽1/4、HIGH=251四配置运行,实测记录见[测试文档](../test/IEC104测试文档.md)。覆盖校验优先级、独立期望字节的16种类型、lookup结果/误用、数据无效应答及恢复、FIFO、余量/提交WAIT、期限、会话、重入、引用及同CA替换、k=1管线;另用TCP=2/实例池=1验证池耗尽。
|
||||
|
||||
`IEC104_READ_TEST_HOOKS`仅替换余量状态查询和提交,生产构建不定义且检查无 `IEC104_Read_Test_` 符号。[示例测试](../../test/iec104_slave_example_test.c) 覆盖真实点值/遥控后读取、47、未创建Read的44、拥塞调度及跨业务交错。[TCP回环](../../test/slave_example_loopback_test.cjs) 覆盖常规与10ms突发。
|
||||
`IEC104_READ_TEST_HOOKS`仅替换余量状态查询和提交,生产构建不定义且检查无 `IEC104_Read_Test_` 符号。`iec104_slave_example_test.c` 覆盖真实点值/遥控后读取、47、未创建Read的44、拥塞调度及跨业务交错。`slave_example_loopback_test.cjs` 覆盖常规与10ms突发。
|
||||
|
||||
示例中的`test_spec_monitoring_snapshot`使用独立期望字节验证:等待中的COT11仍保留动作值及动作时间,后续COT5读取获得新的当前值和读取时刻;`test_spec_addresses_and_command_extensions`核对集中地址分区。它们属于[2026-11-13主机验证记录](../test/IEC104测试文档.md#spec-alignment-tests)的既有结果;本轮仅补文档,未重新运行测试,也未执行Keil构建或硬件闭环,范围仅为当前IEC60870-Slave目录。
|
||||
|
||||
+1
-1
@@ -1,6 +1,6 @@
|
||||
# IEC104 远程参数设计架构
|
||||
|
||||
本模块实现配电自动化 Type200–203,与标准 Type110–113 的 [Parameter](IEC104_Parameter_设计架构.md) 独立启用。源码为 [IEC104_RemoteParameter.c](../../104/business/IEC104_RemoteParameter.c),公开接口为 [IEC104_RemoteParameter.h](../../104/business/IEC104_RemoteParameter.h)。宿主验证及未完成的目标验收见[专项测试](../test/IEC104测试文档.md#remote-parameter-tests)。本文描述软件契约,不声明目标主站已通过互操作认证。
|
||||
本模块实现配电自动化 Type200–203,与标准 Type110–113 的 [Parameter](IEC104_Parameter_设计架构.md) 独立启用。源码为 [IEC104_RemoteParameter.c](../../../App/iec60870/104/business/IEC104_RemoteParameter.c),公开接口为 [IEC104_RemoteParameter.h](../../../App/iec60870/104/business/IEC104_RemoteParameter.h)。宿主验证及未完成的目标验收见[专项测试](../test/IEC104测试文档.md#remote-parameter-tests)。本文描述软件契约,不声明目标主站已通过互操作认证。
|
||||
|
||||
```mermaid
|
||||
flowchart LR
|
||||
+4
-2
@@ -1,6 +1,8 @@
|
||||
# IEC104 软件升级设计架构(Type211)
|
||||
|
||||
本模块管理国网扩展Type211的启动、结束和撤销,提供显式应用动作、结束确认的ACK观察及一次性重启授权。源码为[IEC104_SoftwareUpgrade.c](../../104/business/IEC104_SoftwareUpgrade.c),公开声明为[IEC104_SoftwareUpgrade.h](../../104/business/IEC104_SoftwareUpgrade.h)。升级文件使用已经实现的[Type210文件服务](IEC104_FileService_设计架构.md),两模块没有编译依赖,由应用协调身份与候选存储。
|
||||
> **本项目未实现**:本文描述的能力在本仓 `App/iec60870/` 中**没有对应实现**(相关 `.c/.h` 在 2026-11-18 收编时裁除)。保留本文仅作协议能力与技术参考,不要据此判断功能可用;源码快照见 `IEC60870-Slave/`(该目录将来会删除)。
|
||||
|
||||
本模块管理国网扩展Type211的启动、结束和撤销,提供显式应用动作、结束确认的ACK观察及一次性重启授权。源码为`IEC104_SoftwareUpgrade.c`,公开声明为`IEC104_SoftwareUpgrade.h`。升级文件使用已经实现的[Type210文件服务](IEC104_FileService_设计架构.md),两模块没有编译依赖,由应用协调身份与候选存储。
|
||||
|
||||
协议验证集中在[软件升级验证](../test/IEC104测试文档.md#software-upgrade-tests)。持久模式另由[通用安装核心及Windows后端](../common/IEC60870_FirmwareUpdate_设计架构.md)提供候选存储、安装备份、试运行及恢复;通过`--upgrade-store`启用。本文的RAM示例段落仅指未启用该开关的兼容路径。实际Flash、签名和Bootloader仍须目标适配,不能用宿主文件安装替代硬件验收。
|
||||
|
||||
@@ -480,7 +482,7 @@ RAM模式的初始映像为版本1、负载CRC 0xCBF43926;持久模式的初
|
||||
| UQ-10 | 短延时、初始化原因 | 应用决定;示例COI2 |
|
||||
| UQ-11 | 升级成功读回、失败回退 | 示例202版本/CRC,产品Bootloader另定 |
|
||||
|
||||
规约定位沿用提供的核对记录:104细则§7.12在PDF29–30页,§8.1.12及图24在39–40页,版本参数附录E.2.1在63页;101对应34–35、53–55、84页仅作对照。正文END确认S/E0与图示1、VSQ0与通用规则、COT10表项与流程缺省均作为互操作差异保留。ACK门控、token、TEST和示例包格式为工程选择。
|
||||
规约定位沿用提供的核对记录:104细则(外部手册,非本仓文档)§7.12在PDF29–30页,§8.1.12及图24在39–40页,版本参数附录E.2.1在63页;101对应34–35、53–55、84页仅作对照。正文END确认S/E0与图示1、VSQ0与通用规则、COT10表项与流程缺省均作为互操作差异保留。ACK门控、token、TEST和示例包格式为工程选择。
|
||||
|
||||
双版本保存及以“程序名-1”备份旧版本属于设备应用要求,协议模块和RAM示例均不执行;新增持久后端实际生成`dtu/dtu-1`,状态和目标适配见[安装设计](../common/IEC60870_FirmwareUpdate_设计架构.md)。版本/校验码地址来自104参考性附录,不能推定生产设备的0x8006必然是升级文件CRC;本示例的负载CRC映射只是贯通202读回的工程约定。与目标主站联调时须同时确认这些点表和校验覆盖范围。
|
||||
|
||||
+10
-10
@@ -4,13 +4,13 @@
|
||||
|
||||
业务层整体位置、主动发布与应用排序职责见[业务层设计架构](IEC104_业务层_设计架构.md);本文详述突发数据和发布契约。
|
||||
|
||||
> 状态:普通变化已实现并接入示例(2026-11-01),Type42专用故障发布于2026-11-12补充。公共接口见[IEC104_Spontaneous.h](../../104/business/IEC104_Spontaneous.h),实现见[IEC104_Spontaneous.c](../../104/business/IEC104_Spontaneous.c)。既有严格GCC构建、容量矩阵及真实TCP回环的结果见[测试记录](../test/IEC104测试文档.md#5-验证记录);Type42的新增验证范围见3.4,不把既有结果视为主站实机验收。
|
||||
> 状态:普通变化已实现并接入示例(2026-11-01),Type42专用故障发布于2026-11-12补充。公共接口见[IEC104_Spontaneous.h](../../../App/iec60870/104/business/IEC104_Spontaneous.h),实现见[IEC104_Spontaneous.c](../../../App/iec60870/104/business/IEC104_Spontaneous.c)。既有严格GCC构建、容量矩阵及真实TCP回环的结果见[测试记录](../test/IEC104测试文档.md#5-验证记录);Type42的新增验证范围见3.4,不把既有结果视为主站实机验收。
|
||||
|
||||
应用把“某点在某时刻变成某值”交给模块;模块负责监视信息组帧、生成时标、通过`IEC104_Slave_Enqueue_Event`写入服务级 NORMAL,并统计本模块入队造成的覆盖。不持有点表、点值或应用变化指针,不做变化检测,不新增发送队列。
|
||||
|
||||
Type42使用专用 `Publish_Fault_Event` 接收整份故障快照,复用同一实例和NORMAL链路,时标直接来自输入CP56。它不加入普通变化的kind枚举、forms或联合体,整份编码、不双报、不自动拆帧;线格式由[公共故障事件模块](../common/IEC60870_FaultEvent_设计架构.md)独立维护。
|
||||
|
||||
实时SOE报文、Type42简报和历史文件分别交接:本模块负责实时发布,[History](../common/IEC60870_History_设计架构.md#history-design)负责源事件的持久记录与XML导出。NORMAL里的原文不会自动写入历史库,主站读取历史文件也不会自动补发为实时ASDU;三类故障相关数据的分工见[数据边界](../common/IEC60870_FaultEvent_设计架构.md#fault-event-data-boundaries)。
|
||||
实时SOE报文、Type42简报和历史文件分别交接:本模块负责实时发布,[History](../common/IEC60870_History_设计架构.md)负责源事件的持久记录与XML导出。NORMAL里的原文不会自动写入历史库,主站读取历史文件也不会自动补发为实时ASDU;三类故障相关数据的分工见[数据边界](../common/IEC60870_FaultEvent_设计架构.md#fault-event-data-boundaries)。
|
||||
|
||||
相关契约:[总召数据顺序](IEC104_Interrogation_设计架构.md#6-数据批次与发送路径)、[NORMAL 生命周期](IEC104_发送模块_设计架构.md#aq-reconnect-policy)、[遥控返回信息](IEC104_Command_设计架构.md)、[校时确认](IEC104_ClockSynchronization_设计架构.md)。完整函数签名与参数速查见[API 第26节](IEC104_API接口汇总.md#file-26),接入步骤见[完整调用流程](IEC104_完整调用流程.md#flow-spontaneous)。
|
||||
|
||||
@@ -42,7 +42,7 @@ Type42使用专用 `Publish_Fault_Event` 接收整份故障快照,复用同一
|
||||
| `IEC104_Net.h`、`IEC104_TcpServer_Config.h` | 本次单调时刻、默认静态池容量 | 不读取系统墙钟、不设置定时器 |
|
||||
| 公共ASDU、监视对象及时间编解码 | 校验字段布局/品质,构造23种Type,编码CP56;有限浮点业务约束另由本模块检查 | 不推断工程单位、保护事件来源或真实时钟可信度 |
|
||||
| `common/IEC60870_FaultEvent.c/h` | 按两组数量/类型/记录的扩展布局校验并编码完整Type42,借用现有单帧缓冲 | 不执行故障检测,不按普通Add对象接口拼装 |
|
||||
| `test/iec104_spontaneous_test.c` | 预期字节、分块、时间边界、覆盖及故障注入 | 测试替换不成为生产依赖 |
|
||||
| `IEC60870-Slave/test/iec104_spontaneous_test.c` | 预期字节、分块、时间边界、覆盖及故障注入 | 测试替换不成为生产依赖 |
|
||||
|
||||
应用调用Publish,模块调用Slave,Slave把原文复制入NORMAL。它不依赖Command、ClockSynchronization或召唤模块的私有结构;第6节的协作是应用层组合规则,不是这些模块之间的直接调用关系。
|
||||
|
||||
@@ -112,7 +112,7 @@ station_id防止应用队列中的旧变化在同CA重新注册后归到新站
|
||||
|
||||
`IEC104_SPONTANEOUS_FORM_PLAIN=0x01U`,`IEC104_SPONTANEOUS_FORM_CP56=0x02U`。配置和变化中的非0forms都按类型校验,不会把不存在的无时标或CP56类型自动换成另一种报文。变化中的forms=0继承配置,写0和显式写有效默认值按相同值分段。先用`IEC104_Startup_Config_Default(NULL, NULL, NULL, NULL, &config)`取得完整配置,再修改需要的项;扩展后的forms数组有14项,旧的手工初始化须补齐。
|
||||
|
||||
单点/双点的默认值于2026-11-13由双报调整为CP56,依据[实施细则](../../20170804163032284877151.pdf)的总召之外使用带时标遥信要求。总召的Type1/3由总召业务独立构造,不受此默认值影响。库仍保留显式PLAIN与双报能力;需要旧行为的其他工程必须在配置或变化条目中明确指定,不能再依赖默认双报。
|
||||
单点/双点的默认值于2026-11-13由双报调整为CP56,依据`20170804163032284877151.pdf`的总召之外使用带时标遥信要求。总召的Type1/3由总召业务独立构造,不受此默认值影响。库仍保留显式PLAIN与双报能力;需要旧行为的其他工程必须在配置或变化条目中明确指定,不能再依赖默认双报。
|
||||
|
||||
新增206/207保留原枚举编号和已有类型默认行为,将forms配置数组从13项扩展为14项,值复用原有`short_float`成员;库及调用方须全量重新编译,不能与旧配置布局的二进制混用。仍复用原249字节组帧缓冲,不增加任务或内部事件队列。
|
||||
|
||||
@@ -282,7 +282,7 @@ Create不接管Slave生命周期,Destroy也不取消已入队数据。Set_Time
|
||||
|
||||
与所属Slave串行、位于回调之外的调用前提不变。输入结构只复制了数组指针,应用按值保存报告描述后,仍须保证实际数组活到成功交接或明确丢弃;模块不替应用创建待重试事件队列,见[所有权与存储寿命](../common/IEC60870_FaultEvent_设计架构.md#fault-event-ownership)。采集上下文通过应用同步机制交出冻结数据,由协议循环发布,不能从采集中断直接调用,接入顺序见[应用接入](../common/IEC60870_FaultEvent_设计架构.md#fault-event-integration)。已入队原文沿用启动门禁、断线恢复和ACK回收,容量覆盖风险也与其他NORMAL事件一致。
|
||||
|
||||
新增回归入口为 [iec60870_fault_event_test.c](../../test/iec60870_fault_event_test.c) 和 [iec104_fault_event_test.c](../../test/iec104_fault_event_test.c)。它们与普通变化专项分别维护,主站实机联调仍是独立验收项;具体检查范围见[故障事件验证边界](../common/IEC60870_FaultEvent_设计架构.md#fault-event-validation)。
|
||||
新增回归入口为 `iec60870_fault_event_test.c` 和 `iec104_fault_event_test.c`。它们与普通变化专项分别维护,主站实机联调仍是独立验收项;具体检查范围见[故障事件验证边界](../common/IEC60870_FaultEvent_设计架构.md#fault-event-validation)。
|
||||
|
||||
## 4. 发布处理
|
||||
|
||||
@@ -369,7 +369,7 @@ OK和published只描述曾经成功交接,不保证已发、已确认或仍保
|
||||
<a id="spontaneous-publish-flow"></a>
|
||||
### 4.5 实现阅读路径
|
||||
|
||||
[实现文件](../../104/business/IEC104_Spontaneous.c)按生命周期、对象构造、时间处理、组帧和发布入口组织。阅读发布主线时从末尾的`IEC104_Spontaneous_Publish`进入,再按下表定位辅助函数;接口字段解释见[头文件](../../104/business/IEC104_Spontaneous.h)。
|
||||
[实现文件](../../../App/iec60870/104/business/IEC104_Spontaneous.c)按生命周期、对象构造、时间处理、组帧和发布入口组织。阅读发布主线时从末尾的`IEC104_Spontaneous_Publish`进入,再按下表定位辅助函数;接口字段解释见[头文件](../../../App/iec60870/104/business/IEC104_Spontaneous.h)。
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
@@ -442,7 +442,7 @@ flowchart TD
|
||||
|
||||
计数差应在同一实例、同一计数宽度下解释,注意自然回绕;销毁重建后不能与旧快照直接相减。accounting_errors出现后,下一次正常Publish只恢复之后的增量统计,不追补未知历史覆盖。若返回的是STATE/QUEUE/SUBMIT服务错误,按第4.4节恢复服务;覆盖统计异常本身不把一次成功交接改为可重试失败。
|
||||
|
||||
上述测试均位于[Spontaneous专项](../../test/iec104_spontaneous_test.c)。主示例另有应用队列淘汰计数,该计数与NORMAL覆盖属于两个位置,不能只看Spontaneous的overflow判定是否保留了全部原始变化;两级存储与同点选择边界见[应用队列](#6-应用侧队列与顺序)。
|
||||
上述测试均位于`iec104_spontaneous_test.c`。主示例另有应用队列淘汰计数,该计数与NORMAL覆盖属于两个位置,不能只看Spontaneous的overflow判定是否保留了全部原始变化;两级存储与同点选择边界见[应用队列](#6-应用侧队列与顺序)。
|
||||
|
||||
## 5. 时标
|
||||
|
||||
@@ -607,7 +607,7 @@ Spontaneous本身不处理Type105,也不持有待清除的应用变化。主
|
||||
|
||||
## 8. 验证与联调
|
||||
|
||||
新增`test/iec104_spontaneous_test.c`,通过可控Net后端、单调时间和提交/状态故障注入验证库契约。构建矩阵为`(TCP服务容量, NORMAL字节)=(1,4096)、(2,4096)、(1,272)`。脚本入口为`./scripts/build.ps1 -Test`,各阶段实跑结果在测试文档记录。
|
||||
新增`IEC60870-Slave/test/iec104_spontaneous_test.c`,通过可控Net后端、单调时间和提交/状态故障注入验证库契约。构建矩阵为`(TCP服务容量, NORMAL字节)=(1,4096)、(2,4096)、(1,272)`。脚本入口为`./scripts/build.ps1 -Test`,各阶段实跑结果在测试文档记录。
|
||||
|
||||
2026-11-13执行`./scripts/build.ps1 -BuildName spec-spontaneous -Test -Suite Spontaneous`,严格构建成功,上述三组容量均通过27组测试。新增默认单/双点CP56及未同步IV回归;既有双报分段测试改为显式配置,双报编码、重试及覆盖测试继续保留。
|
||||
|
||||
@@ -629,7 +629,7 @@ Spontaneous本身不处理Type105,也不持有待清除的应用变化。主
|
||||
<a id="spontaneous-test-scenarios"></a>
|
||||
### 8.2 典型情景与现有测试定位
|
||||
|
||||
以下定位均指[现有Spontaneous专项](../../test/iec104_spontaneous_test.c),用于维护时复查边界;不代表本轮文档编辑重新执行了测试。
|
||||
以下定位均指`iec104_spontaneous_test.c`,用于维护时复查边界;不代表本轮文档编辑重新执行了测试。
|
||||
|
||||
| 情景 | 需要核对的事实 | 测试函数 |
|
||||
|---|---|---|
|
||||
@@ -644,7 +644,7 @@ Spontaneous本身不处理Type105,也不持有待清除的应用变化。主
|
||||
| 查询错误,或双报第二帧提交ERROR/FATAL | 保留故障信息;Close、读空通知、Init完成后从空NORMAL恢复发布,不猜测旧帧还剩多少 | `test_spontaneous_service_recovery` |
|
||||
| 服务未Init/已Close时空批次;时间基准非法设置及老化 | 空批次不查询服务,非空按STATE拒绝;非法设置保持旧基准,老化恰等于上限仍同步,Clear后无基准 | `test_spontaneous_preconditions`、`test_spontaneous_time_base_lifecycle` |
|
||||
|
||||
主示例的集成边界另见[示例测试](../../test/iec104_slave_example_test.c):`test_spec_spontaneous_retry_timestamp`用独立期望字节验证应用队列WAIT跨校时仍保留原UTC;`test_spec_monitoring_snapshot`验证COT11动作快照与后续COT5当前快照;`test_example_system_command_forms`验证默认CP56删除、其他CA保留及占位不复生,`test_example_system_command_test_no_action`验证TEST无清除副作用。上述用例已纳入[2026-11-13主机验证记录](../test/IEC104测试文档.md#spec-alignment-tests),不代表Keil构建、硬件闭环或目标主站验收。
|
||||
主示例的集成边界另见`iec104_slave_example_test.c`:`test_spec_spontaneous_retry_timestamp`用独立期望字节验证应用队列WAIT跨校时仍保留原UTC;`test_spec_monitoring_snapshot`验证COT11动作快照与后续COT5当前快照;`test_example_system_command_forms`验证默认CP56删除、其他CA保留及占位不复生,`test_example_system_command_test_no_action`验证TEST无清除副作用。上述用例已纳入[2026-11-13主机验证记录](../test/IEC104测试文档.md#spec-alignment-tests),不代表Keil构建、硬件闭环或目标主站验收。
|
||||
|
||||
## 9. 交付范围
|
||||
|
||||
+6
-6
@@ -6,7 +6,7 @@
|
||||
|
||||
状态:现行实现说明,2026-11-11补入Type104及启动补发所需的Type70完成轮次契约。范围为IEC60870-Slave;最终验证与测量记录见[测试文档](../test/IEC104测试文档.md),不以设计中的预期代替实测结果。
|
||||
|
||||
[IEC104_SystemCommand.c](../../104/business/IEC104_SystemCommand.c)与[公共头文件](../../104/business/IEC104_SystemCommand.h)处理Type104/107测试回显、Type70初始化结束和Type105进程/事件缓冲复位及显式启用的专用许可。2026-11-11在既有状态域和调用链上接入Type104,复用普通回复FIFO。完整声明见[API第28节](IEC104_API接口汇总.md#file-28),应用推进见[调用流程](IEC104_完整调用流程.md#flow-system-command),报文及联调见[示例说明](../examples/IEC104子站示例.md#example-system-command)。
|
||||
[IEC104_SystemCommand.c](../../../App/iec60870/104/business/IEC104_SystemCommand.c)与[公共头文件](../../../App/iec60870/104/business/IEC104_SystemCommand.h)处理Type104/107测试回显、Type70初始化结束和Type105进程/事件缓冲复位及显式启用的专用许可。2026-11-11在既有状态域和调用链上接入Type104,复用普通回复FIFO。完整声明见[API第28节](IEC104_API接口汇总.md#file-28),应用推进见[调用流程](IEC104_完整调用流程.md#flow-system-command),报文及联调见[示例说明](../examples/IEC104子站示例.md#example-system-command)。
|
||||
|
||||
## 1. 范围与完成点
|
||||
|
||||
@@ -34,7 +34,7 @@ QRP=1以传输层记录的事实确定复位:肯定ACT_CON须在提交后的
|
||||
| `104/IEC104_Slave.h` | 通知身份、站点引用/快照、Tracked/Acked发送、NORMAL筛选 | 统一服务入口;不直接访问Manager或队列内存 |
|
||||
| `104/IEC104_TcpServer_Config.h`、`104/IEC104_Net.h` | 默认池容量、单调时间 | 配置边界及期限来源 |
|
||||
| 公共ASDU、对象与`IEC60870_Codec.h` | 回显容器、固定测试码与CP56合法性、字节读取 | 编解码;业务先确定接受/拒绝语义 |
|
||||
| `test/iec104_system_command_test.c` | 可控时间、提交和ACK故障、容量矩阵 | 验证以上边界,不属于生产调用链 |
|
||||
| `IEC60870-Slave/test/iec104_system_command_test.c` | 可控时间、提交和ACK故障、容量矩阵 | 验证以上边界,不属于生产调用链 |
|
||||
|
||||
应用向本模块分派通知并提供动作许可;本模块向Slave提交确认或查询交接/ACK事实。Clock、遥控、召唤和Spontaneous均不是它的下层依赖。`action`只对QRP1/专用QRP判定许可,实际动作须由应用在`Take_Reset`成功后执行;QRP2则在`action`中完成本CA应用缓存清除。
|
||||
|
||||
@@ -142,7 +142,7 @@ ARMED是否可立即启动由`start_allowed`另外控制:空轮/失败须等
|
||||
|
||||
### 4.1 服务入口与功能开关
|
||||
|
||||
目录内[实施细则第10页表4](../../20170804163032284877151.pdf#page=10)列出Type104测试命令。公共对象层已有编解码,本模块补齐的是请求接管、校验、保存及确认提交;表4是类型清单,本文的异常应答及调度策略以现行实现为准。核心入口为`Handle_Event → Request`,发送入口为`Process → Submit_Head`。
|
||||
目录内`20170804163032284877151.pdf`列出Type104测试命令。公共对象层已有编解码,本模块补齐的是请求接管、校验、保存及确认提交;表4是类型清单,本文的异常应答及调度策略以现行实现为准。核心入口为`Handle_Event → Request`,发送入口为`Process → Submit_Head`。
|
||||
|
||||
两种测试命令共用`IEC104_SYSTEM_COMMAND_FEATURE_TEST_COMMAND`(0x01),默认配置已开启;关闭后104/107均返回IGNORED,示例继续分派,最终无人接手时回未知类型44。Type104无需另建模块或配置点表,既有示例在SystemCommand实例创建后即可接入。最小调用方式沿用[系统命令接入流程](IEC104_完整调用流程.md#flow-system-command)。
|
||||
|
||||
@@ -224,7 +224,7 @@ OK只是业务与发送层之间的交接点,可能仍在HIGH中,不能当
|
||||
| 示例分发不落入44、正常/TEST/错误图样 | `test_example_system_command_echo_init` |
|
||||
| 真实TCP逐字节回显、105重建后的104请求 | `systemCommandLoopback`,可用`--system-command-only`单独运行 |
|
||||
|
||||
前五行位于[系统命令专项](../../test/iec104_system_command_test.c),示例接线位于[集成测试](../../test/iec104_slave_example_test.c),真实TCP入口位于[回环脚本](../../test/slave_example_loopback_test.cjs)。本次补文档只核对现行源码与既有验证记录,不将上一轮构建、回环或资源测量记为本次重新执行;覆盖范围不代表所有现场并发组合或第三方主站认证。
|
||||
前五行位于`iec104_system_command_test.c`,示例接线位于`iec104_slave_example_test.c`,真实TCP入口位于`slave_example_loopback_test.cjs`。本次补文档只核对现行源码与既有验证记录,不将上一轮构建、回环或资源测量记为本次重新执行;覆盖范围不代表所有现场并发组合或第三方主站认证。
|
||||
|
||||
## 5. Type70轮次
|
||||
|
||||
@@ -371,7 +371,7 @@ READY与当前连接的active、generation是不同状态域。应用不能以
|
||||
|
||||
这里STOP_ACT的U帧为`68 04 13 00 00 00`。相同毫秒时间戳不代表同时发生,真正边界是传输层解析顺序;不能用普通ACK查询替换Active查询。通知尚未读空时Take_Reset返回false且不修改输出,这也不是授权被取消:先按FIFO分派通知,再读取reset_ready并尝试领取;领取后再次调用必须为false。
|
||||
|
||||
定位时建议将原`receive_serial`、授权CA/station_id、`base_ms`、ACK首次时刻、首次STOP/断开顺序与`ack_timeouts/reset_cancelled/resets_released`一起记录。不要只打印当前active或最后一次调用时间。以上数值及同拍顺序分别对应[系统命令专项](../../test/iec104_system_command_test.c)的`test_system_reset_stop_deadlines`和`test_system_reset_ack_stop_order`,跨重连继续领取由`test_system_reset_commit_reconnect`覆盖;广播还须满足第6.1节的同批屏障,不能直接套用单目标reset_ready结果。
|
||||
定位时建议将原`receive_serial`、授权CA/station_id、`base_ms`、ACK首次时刻、首次STOP/断开顺序与`ack_timeouts/reset_cancelled/resets_released`一起记录。不要只打印当前active或最后一次调用时间。以上数值及同拍顺序分别对应`iec104_system_command_test.c`的`test_system_reset_stop_deadlines`和`test_system_reset_ack_stop_order`,跨重连继续领取由`test_system_reset_commit_reconnect`覆盖;广播还须满足第6.1节的同批屏障,不能直接套用单目标reset_ready结果。
|
||||
|
||||
## 8. QRP2清除与部分失败
|
||||
|
||||
@@ -501,7 +501,7 @@ GCC `-O2 -fstack-usage`的单函数静态帧:Handle_Event为272→288、Proces
|
||||
<a id="system-command-scenarios"></a>
|
||||
### 11.1 典型情景与现有测试定位
|
||||
|
||||
以下是[现有SystemCommand专项源码](../../test/iec104_system_command_test.c)的定位说明,不表示本轮文档整理重新运行了这些测试。修改对应状态提交点时应沿表中函数核对返回值、动作次数和资源终态。
|
||||
以下是`iec104_system_command_test.c`的定位说明,不表示本轮文档整理重新运行了这些测试。修改对应状态提交点时应沿表中函数核对返回值、动作次数和资源终态。
|
||||
|
||||
| 情景 | 必须区分的结果 | 测试函数 |
|
||||
|---|---|---|
|
||||
+3
-3
@@ -6,7 +6,7 @@
|
||||
|
||||
业务默认使用`IEC104_Slave.h`统一入口;Slave拥有并驱动本模块,自动为I帧提供ASDU及原连接应答接口。本文保留独立TCP接入与内部维护的接口说明,下文的TCP调用方通常为Slave。业务示例见[README](README.md#子站统一入口)。
|
||||
|
||||
`IEC104_TcpServer.c/h`负责IPv4监听调度、连接生命周期、收发预算和业务事件队列,通过现有`IEC104_Connection`驱动子站协议。应用可用Prepare查询监听和定时条件,在自己的事件循环中等待,再调用Process推进;独立TCP循环也可用Poll组合这三个步骤。业务事件通过NextEvent主动取出,TCP模块不保存或调用业务函数。真实网络操作和单调计时通过`IEC104_Net.h`调用;当前提供的实现为`IEC104_Net_Windows.c`,尚未提供Linux或其他平台后端。模块本身不带main;可运行的子站接入示例为[iec104_slave_example.c](../../examples/iec104_slave_example.c),构建及启动见[README](README.md)。每个服务同时维护一条活动主站连接;额外连接被接受后关闭,原连接继续运行。
|
||||
`IEC104_TcpServer.c/h`负责IPv4监听调度、连接生命周期、收发预算和业务事件队列,通过现有`IEC104_Connection`驱动子站协议。应用可用Prepare查询监听和定时条件,在自己的事件循环中等待,再调用Process推进;独立TCP循环也可用Poll组合这三个步骤。业务事件通过NextEvent主动取出,TCP模块不保存或调用业务函数。真实网络操作和单调计时通过`IEC104_Net.h`调用;当前提供的实现为`IEC104_Net_Windows.c`,尚未提供Linux或其他平台后端。模块本身不带main;可运行的子站接入示例为`iec104_slave_example.c`,构建及启动见[README](README.md)。每个服务同时维护一条活动主站连接;额外连接被接受后关闭,原连接继续运行。
|
||||
|
||||
## 1. 构建与接入
|
||||
|
||||
@@ -352,7 +352,7 @@ Connection的Feed、Prepare_Next_Send、发送回报及Tick均可能推进保留
|
||||
|
||||
一个容易漏掉的唤醒链是“通知FIFO刚被读空,但Connection还有已受理I帧”:NextEvent释放空间后,应用必须重新Prepare,看到need_process就安排本地Process。该轮不需要新的recv输入,先把保留I帧复制为事件;下一次NextEvent才取得请求。此时即使Slave的旧请求身份仍有效、HIGH/NORMAL都为空,IDLE也须WAIT,不能抢在该请求分派前发送快照。处理事件或提交应答后再Prepare,任何等待都使用最新快照。
|
||||
|
||||
维护入口:[Process_Events实现](../../104/IEC104_TcpServer.c)集中校验批次和身份;[Slave测试](../../test/iec104_slave_test.c)的`test_external_scheduler`检查公开门面的基本Prepare/Process接入,[IDLE传输测试](../../test/iec104_idle_transport_test.c)的`test_retained_request_resume`检查无新网络输入时的本地续跑。身份迟到表用于对照实现和现场注册日志,不把这两个测试扩大描述成全部token组合覆盖。
|
||||
维护入口:[Process_Events实现](../../../App/iec60870/104/IEC104_TcpServer.c)集中校验批次和身份;`iec104_slave_test.c`的`test_external_scheduler`检查公开门面的基本Prepare/Process接入,`iec104_idle_transport_test.c`的`test_retained_request_resume`检查无新网络输入时的本地续跑。身份迟到表用于对照实现和现场注册日志,不把这两个测试扩大描述成全部token组合覆盖。
|
||||
|
||||
<a id="tcp-business-cycle"></a>
|
||||
|
||||
@@ -605,7 +605,7 @@ Close_Connection直接复用Drop_Client:关闭客户端,将剩余已受理I
|
||||
|
||||
Acked入口先确认有可用观察槽,再提交应答;队列交接通过内部observer将非零票据关联到实际`frame_serial`,直接交接则在提交返回后立即补齐关联。两条路径都必须在`Finish_Submit`首次调用socket发送之前安装观察槽,保存generation、ticket及已交接帧身份。观察槽满返回WAIT,不先准备一个无法观察的新帧。链路累计ACK随后按发送记录关联观察槽,不以业务等级、票据数值大小或HIGH队首位置推断确认。
|
||||
|
||||
`SUBMIT_OK`只说明接手;票据HANDED、整帧写完、链路ACK和业务执行是不同事实。兼容模式普通直交可返回0,Acked入口则必须取得非零票据;严格模式排队和直交都分配非零票据,直交立即登记HANDED,关闭与重建服务时仍纳入已分配票据高水位。观察Release只结束观察,不撤帧;普通ACK与Active ACK的STOP边界保持[公开ACK接口约定](../../104/IEC104_TcpServer.h),业务依赖见[事务依赖与完成回执](IEC104_业务优先级设计.md#priority-dependencies-receipts)。
|
||||
`SUBMIT_OK`只说明接手;票据HANDED、整帧写完、链路ACK和业务执行是不同事实。兼容模式普通直交可返回0,Acked入口则必须取得非零票据;严格模式排队和直交都分配非零票据,直交立即登记HANDED,关闭与重建服务时仍纳入已分配票据高水位。观察Release只结束观察,不撤帧;普通ACK与Active ACK的STOP边界保持[公开ACK接口约定](../../../App/iec60870/104/IEC104_TcpServer.h),业务依赖见[事务依赖与完成回执](IEC104_业务优先级设计.md#priority-dependencies-receipts)。
|
||||
|
||||
## 5. 启停、断线和重连
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# IEC104 业务优先级设计
|
||||
|
||||
本文描述12级业务优先级的分类、集中调度及事务依赖,范围限于IEC60870-Slave。同步日期:2026-11-12。源码入口为[业务等级定义](../../104/IEC104_Types.h)、[Slave接口](../../104/IEC104_Slave.h)、[发送管理器](../../104/IEC104_SendManager.c)和[主示例](../../examples/iec104_slave_example.c)。
|
||||
本文描述12级业务优先级的分类、集中调度及事务依赖,范围限于IEC60870-Slave。同步日期:2026-11-12。源码入口为[业务等级定义](../../../App/iec60870/104/IEC104_Types.h)、[Slave接口](../../../App/iec60870/104/IEC104_Slave.h)、[发送管理器](../../../App/iec60870/104/IEC104_SendManager.c)和`iec104_slave_example.c`。
|
||||
|
||||
严格模式选择的是**下一条可以交给发送缓冲的业务报文**。它不改变线程优先级,也不打断正在运行的应用回调或正在发送的完整帧。现有Slave→TcpServer→Connection→SendManager→Queue/Link/SendBuffer分工保持;新增内容集中于业务分类、队列选择及应用的有序准备阶段。
|
||||
|
||||
@@ -176,7 +176,7 @@ Read及Command的动作前容量预检使用`IEC104_Slave_Query_Response_Priorit
|
||||
|
||||
`IEC104_FileService_Execute_Next_Mode`提供ALL、CONTROL、DATA三种模式。原`Execute_Next`等价于ALL;CONTROL负责收尾、目录、OPEN、写入与COMMIT,DATA仅推进已打开读会话的数据。使用DATA不能停止CONTROL,否则CLOSE/ABORT等资源收尾无人消费。
|
||||
|
||||
历史XML与录波文件共用上述文件召唤10、文件传输11两级,内容来自哪一种存储不改变等级。实时SOE的NORMAL原文与`HISTORY/SOE`持久记录分别管理:历史在业务事件发生处保存,发送WAIT、重新组帧或重连补报不能再次追加同一事件。协议队列清理也不删除持久历史,记录与下载快照的职责见[历史记录设计](../common/IEC60870_History_设计架构.md#history-design)。
|
||||
历史XML与录波文件共用上述文件召唤10、文件传输11两级,内容来自哪一种存储不改变等级。实时SOE的NORMAL原文与`HISTORY/SOE`持久记录分别管理:历史在业务事件发生处保存,发送WAIT、重新组帧或重连补报不能再次追加同一事件。协议队列清理也不删除持久历史,记录与下载快照的职责见[历史记录设计](../common/IEC60870_History_设计架构.md)。
|
||||
|
||||
提交OK、HANDED与ACK是三个不同事实。Response的OK仍表示原文已被接手,相关游标和提交计数只在此时推进。Tracked票据只通过原Slave查询;跨等级票据不能比较数值大小来推断谁先交接。兼容模式普通直交可成功返回零票据;严格模式排队与队满直交都返回真实非零票据。未提交时的初始零值不能当作完成。
|
||||
|
||||
@@ -207,15 +207,15 @@ STOP、断线、EOF、旧代次、取消、删除站点及ACK事实继续按原
|
||||
|
||||
| 位置 | 维护重点 |
|
||||
|---|---|
|
||||
| [AsduQueue](../../104/IEC104_AsduQueue.c) | 跨HIGH/NORMAL选帧、同级FIFO、环内压紧、NORMAL身份与分级票据 |
|
||||
| [SendManager](../../104/IEC104_SendManager.c)与[Connection](../../104/IEC104_Connection.c) | 队满直交、IDLE准入、帧边界、窗口和ACK记录 |
|
||||
| [Slave](../../104/IEC104_Slave.h)与[TcpServer](../../104/IEC104_TcpServer.h) | 显式等级、集中Cycle、待准备上限、通知及生命周期约束 |
|
||||
| [主示例](../../examples/iec104_slave_example.c) | 按级准备未编码候选、预算耗尽登记、文件CONTROL/DATA及退出End配对 |
|
||||
| [严格队列专项](../../test/iec104_strict_priority_queue_test.c) | 等级选择、跨存储同级顺序、条目和票据状态 |
|
||||
| [严格传输专项](../../test/iec104_strict_priority_transport_test.c) | 12级混排、部分写、跨等级ACK、队满旁路、通知与旧票据隔离 |
|
||||
| [突发专项](../../test/iec104_spontaneous_test.c) | 默认/显式分类、同级合帧、异级拆帧、双报继承和非法等级整批拒绝 |
|
||||
| [文件专项](../../test/iec104_file_service_test.c) | op4真实PENDING票据不提前read、CONTROL/DATA隔离及原分段/期限规则 |
|
||||
| [示例集成专项](../../test/iec104_slave_example_test.c) | 真实业务候选的竞争、初始化与普通GI、计数量、启动门禁及生命周期组合 |
|
||||
| [AsduQueue](../../../App/iec60870/104/IEC104_AsduQueue.c) | 跨HIGH/NORMAL选帧、同级FIFO、环内压紧、NORMAL身份与分级票据 |
|
||||
| [SendManager](../../../App/iec60870/104/IEC104_SendManager.c)与[Connection](../../../App/iec60870/104/IEC104_Connection.c) | 队满直交、IDLE准入、帧边界、窗口和ACK记录 |
|
||||
| [Slave](../../../App/iec60870/104/IEC104_Slave.h)与[TcpServer](../../../App/iec60870/104/IEC104_TcpServer.h) | 显式等级、集中Cycle、待准备上限、通知及生命周期约束 |
|
||||
| `iec104_slave_example.c` | 按级准备未编码候选、预算耗尽登记、文件CONTROL/DATA及退出End配对 |
|
||||
| `iec104_strict_priority_queue_test.c` | 等级选择、跨存储同级顺序、条目和票据状态 |
|
||||
| `iec104_strict_priority_transport_test.c` | 12级混排、部分写、跨等级ACK、队满旁路、通知与旧票据隔离 |
|
||||
| `iec104_spontaneous_test.c` | 默认/显式分类、同级合帧、异级拆帧、双报继承和非法等级整批拒绝 |
|
||||
| `iec104_file_service_test.c` | op4真实PENDING票据不提前read、CONTROL/DATA隔离及原分段/期限规则 |
|
||||
| `iec104_slave_example_test.c` | 真实业务候选的竞争、初始化与普通GI、计数量、启动门禁及生命周期组合 |
|
||||
|
||||
测试命令和已执行结果集中记录在[测试文档](../test/IEC104测试文档.md)。接口存在、设计推演或单项通过,均不替代最终集成及目标环境验证记录。
|
||||
|
||||
@@ -64,20 +64,20 @@ T位标识测试条件,P/N独立表示确认结果。IEC 60870-5-101:1995 §7.
|
||||
|
||||
| 源码入口 | 职责 | 详细设计 |
|
||||
|---|---|---|
|
||||
| [IEC104_Interrogation.h](../../104/business/IEC104_Interrogation.h) | 召唤任务、BEGIN/NEED_DATA/FINISHED、批次、广播、取消及交接等待 | [召唤引擎](IEC104_Interrogation_设计架构.md) |
|
||||
| [IEC104_GeneralInterrogation.h](../../104/business/IEC104_GeneralInterrogation.h) | Type 100 规则;公开创建入口仍为 IEC104_Interrogation_Create | [总召规则](IEC104_Interrogation_设计架构.md) |
|
||||
| [IEC104_CounterInterrogation.h](../../104/business/IEC104_CounterInterrogation.h) | Type 101 规则和显式计数量动作入口 | [计数量召唤](IEC104_CounterInterrogation_设计架构.md) |
|
||||
| [IEC104_Interrogation_Internal.h](../../104/business/IEC104_Interrogation_Internal.h) | 只读规则表、带规则创建及动作执行的私有接口 | [共用机制](#business-interrogation) |
|
||||
| [IEC104_ClockSynchronization.h](../../104/business/IEC104_ClockSynchronization.h) | Type103校时/读时,请求保存、设时补偿、显式回调、固定读时快照及FIFO回复 | [时钟业务](IEC104_ClockSynchronization_设计架构.md) |
|
||||
| [IEC104_Command.h](../../104/business/IEC104_Command.h) | 遥控遥调、选择执行、应用事件、动作结果、返回信息及收尾 | [命令](IEC104_Command_设计架构.md) |
|
||||
| [IEC104_Read.h](../../104/business/IEC104_Read.h) | Type 102,队首单点 lookup、应答校验及提交前期限 | [读命令](IEC104_Read_设计架构.md) |
|
||||
| [IEC104_SystemCommand.h](../../104/business/IEC104_SystemCommand.h) | 104/107 回显、70 初始化轮次、105 复位授权与事件清除 | [系统命令](IEC104_SystemCommand_设计架构.md) |
|
||||
| [IEC104_Parameter.h](../../104/business/IEC104_Parameter.h) | 110–113校验、FIFO、运行值确认和显式动作;默认关闭的暂存/同址/ACK扩展 | [参数装载](IEC104_Parameter_设计架构.md) |
|
||||
| [IEC104_RemoteParameter.h](../../104/business/IEC104_RemoteParameter.h) | 200–203、原文FIFO、TLV读取、预置/固化/撤销及DISCARD恢复 | [远程参数](IEC104_RemoteParameter_设计架构.md) |
|
||||
| [IEC104_FileService.h](../../104/business/IEC104_FileService.h) | 210、目录快照、IDLE读文件、写暂存/COMMIT、数据环BUSY及恰一次收尾 | [文件服务](IEC104_FileService_设计架构.md) |
|
||||
| [IEC104_SoftwareUpgrade.h](../../104/business/IEC104_SoftwareUpgrade.h) | 211、启动/结束/撤销、ACK观察、ABANDON及一次性重启授权 | [软件升级](IEC104_SoftwareUpgrade_设计架构.md) |
|
||||
| [IEC104_Spontaneous.h](../../104/business/IEC104_Spontaneous.h) | 监视变化的类型/时标校验、普通分帧及Type42整份故障快照发布 | [突发上送](IEC104_Spontaneous_设计架构.md) |
|
||||
| [IEC104_PeriodicScan.h](../../104/business/IEC104_PeriodicScan.h) | 周期/背景组、点级网格、SQ 阈值、在线配置及换表续扫 | [周期扫描](IEC104_PeriodicScan_设计架构.md) |
|
||||
| [IEC104_Interrogation.h](../../../App/iec60870/104/business/IEC104_Interrogation.h) | 召唤任务、BEGIN/NEED_DATA/FINISHED、批次、广播、取消及交接等待 | [召唤引擎](IEC104_Interrogation_设计架构.md) |
|
||||
| [IEC104_GeneralInterrogation.h](../../../App/iec60870/104/business/IEC104_GeneralInterrogation.h) | Type 100 规则;公开创建入口仍为 IEC104_Interrogation_Create | [总召规则](IEC104_Interrogation_设计架构.md) |
|
||||
| [IEC104_CounterInterrogation.h](../../../App/iec60870/104/business/IEC104_CounterInterrogation.h) | Type 101 规则和显式计数量动作入口 | [计数量召唤](IEC104_CounterInterrogation_设计架构.md) |
|
||||
| [IEC104_Interrogation_Internal.h](../../../App/iec60870/104/business/IEC104_Interrogation_Internal.h) | 只读规则表、带规则创建及动作执行的私有接口 | [共用机制](#business-interrogation) |
|
||||
| [IEC104_ClockSynchronization.h](../../../App/iec60870/104/business/IEC104_ClockSynchronization.h) | Type103校时/读时,请求保存、设时补偿、显式回调、固定读时快照及FIFO回复 | [时钟业务](IEC104_ClockSynchronization_设计架构.md) |
|
||||
| [IEC104_Command.h](../../../App/iec60870/104/business/IEC104_Command.h) | 遥控遥调、选择执行、应用事件、动作结果、返回信息及收尾 | [命令](IEC104_Command_设计架构.md) |
|
||||
| [IEC104_Read.h](../../../App/iec60870/104/business/IEC104_Read.h) | Type 102,队首单点 lookup、应答校验及提交前期限 | [读命令](IEC104_Read_设计架构.md) |
|
||||
| [IEC104_SystemCommand.h](../../../App/iec60870/104/business/IEC104_SystemCommand.h) | 104/107 回显、70 初始化轮次、105 复位授权与事件清除 | [系统命令](IEC104_SystemCommand_设计架构.md) |
|
||||
| [IEC104_Parameter.h](../../../App/iec60870/104/business/IEC104_Parameter.h) | 110–113校验、FIFO、运行值确认和显式动作;默认关闭的暂存/同址/ACK扩展 | [参数装载](IEC104_Parameter_设计架构.md) |
|
||||
| [IEC104_RemoteParameter.h](../../../App/iec60870/104/business/IEC104_RemoteParameter.h) | 200–203、原文FIFO、TLV读取、预置/固化/撤销及DISCARD恢复 | [远程参数](IEC104_RemoteParameter_设计架构.md) |
|
||||
| `IEC104_FileService.h` | 210、目录快照、IDLE读文件、写暂存/COMMIT、数据环BUSY及恰一次收尾 | [文件服务](IEC104_FileService_设计架构.md) |
|
||||
| `IEC104_SoftwareUpgrade.h` | 211、启动/结束/撤销、ACK观察、ABANDON及一次性重启授权 | [软件升级](IEC104_SoftwareUpgrade_设计架构.md) |
|
||||
| [IEC104_Spontaneous.h](../../../App/iec60870/104/business/IEC104_Spontaneous.h) | 监视变化的类型/时标校验、普通分帧及Type42整份故障快照发布 | [突发上送](IEC104_Spontaneous_设计架构.md) |
|
||||
| [IEC104_PeriodicScan.h](../../../App/iec60870/104/business/IEC104_PeriodicScan.h) | 周期/背景组、点级网格、SQ 阈值、在线配置及换表续扫 | [周期扫描](IEC104_PeriodicScan_设计架构.md) |
|
||||
|
||||
### 1.3 依赖与分层
|
||||
|
||||
@@ -131,7 +131,7 @@ General/Counter 把只读规则表交给共用引擎;引擎通过表内函数
|
||||
|
||||
SOE在源变位处落一次历史,发布WAIT只重试发送,不能再追加同一条记录。遥控记录在真实应用选择、执行、远端撤销入口产生;执行记录表示命令进入应用,不等于物理执行成功。历史采样使用同一份遥测值及品质,不调用扫描器来补齐缺测节;QRP2清发送事件不会清历史,QRP1协议重建也复用原持久对象。
|
||||
|
||||
应用持有点表、存储上下文和冻结快照,其寿命覆盖所有读取和收尾回调。目录枚举结束不一定意味着历史枚举缓存释放;独立下载快照必须保持至CLOSE_READ。窗口、二进制布局和恢复边界统一见[历史设计](../common/IEC60870_History_设计架构.md#history-design)及[录波设计](../common/IEC60870_FaultRecorder_设计架构.md),端到端顺序见[数据接入流程](IEC104_完整调用流程.md#flow-fault-recording-history)。
|
||||
应用持有点表、存储上下文和冻结快照,其寿命覆盖所有读取和收尾回调。目录枚举结束不一定意味着历史枚举缓存释放;独立下载快照必须保持至CLOSE_READ。窗口、二进制布局和恢复边界统一见[历史设计](../common/IEC60870_History_设计架构.md)及[录波设计](../common/IEC60870_FaultRecorder_设计架构.md),端到端顺序见[数据接入流程](IEC104_完整调用流程.md#flow-fault-recording-history)。
|
||||
|
||||
<a id="business-state"></a>
|
||||
## 二、对象、身份与状态归属
|
||||
@@ -569,7 +569,7 @@ lookup可能因为发送WAIT被多次调用,适合读取已准备的数据快
|
||||
|
||||
### 8.3 构建与内存边界
|
||||
|
||||
业务公开头目录为 `104/business/`,连同 `104/`、`common/` 加入搜索路径;新增业务源码注册到所使用的工程构建。当前独立库的 Windows 构建依赖由 [scripts/build.ps1](../../scripts/build.ps1) 维护,业务内部容量宏作用于相应实现翻译单元。
|
||||
业务公开头目录为 `104/business/`,连同 `104/`、`common/` 加入搜索路径;新增业务源码注册到所使用的工程构建。当前独立库的 Windows 构建依赖由 `build.ps1` 维护,业务内部容量宏作用于相应实现翻译单元。
|
||||
|
||||
本文不重复维护各模块 sizeof、栈链和容量默认值表。它们分别位于专项设计及[测试文档](../test/IEC104测试文档.md),改变任务槽、组数、批次缓冲或深调用链后须按目标 ABI 重新测量;Windows x64 测量不能当作 STM32 的 RAM 或最坏栈结论。
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
新增的严格调度见[12级业务优先级设计](IEC104_业务优先级设计.md)。本文原有双FIFO、公平配额和应答快速发送描述适用于兼容模式;严格模式另以业务等级选择候选,HIGH/NORMAL仍分别管理会话应答与跨连接事件的存储寿命。
|
||||
|
||||
同步日期:2026-11-15。本文对应 AsduQueue、SendBuffer、SendManager 当前实现,接口声明分别见 [AsduQueue.h](../../104/IEC104_AsduQueue.h)、[SendBuffer.h](../../104/IEC104_SendBuffer.h)、[SendManager.h](../../104/IEC104_SendManager.h)。
|
||||
同步日期:2026-11-15。本文对应 AsduQueue、SendBuffer、SendManager 当前实现,接口声明分别见 [AsduQueue.h](../../../App/iec60870/104/IEC104_AsduQueue.h)、[SendBuffer.h](../../../App/iec60870/104/IEC104_SendBuffer.h)、[SendManager.h](../../../App/iec60870/104/IEC104_SendManager.h)。
|
||||
|
||||
周期/背景快照使用 IDLE 直发入口:兼容模式要求HIGH/NORMAL均无待发;严格模式比较可发送候选的业务等级,同级排队项仍先于新IDLE。两种模式都要求当前帧及控制帧为空、窗口和记录槽留足reserve。队列仍只有两个生命周期,IDLE不保存原文或重连补发。完整准入和保证见[周期扫描设计](IEC104_PeriodicScan_设计架构.md#5-idle-发送与-reserve)。
|
||||
|
||||
@@ -66,7 +66,7 @@ flowchart LR
|
||||
|
||||
### 独立256条SOE存储
|
||||
|
||||
[实施细则](../../20170804163032284877151.pdf#page=42)§8.2.8原文规定“缓存遥信条数不超过256条”,超出后循环覆盖最早事件,未确认事件重连补发,掉电重启清空。实现以独立256条单/双点时标事件存储落实这一保留范围;普通遥测或其他NORMAL业务不能挤占SOE槽。这里的256按遥信对象计,不按一帧可以合并的对象数计算,也不是把所有带CP56的数据都归为SOE。
|
||||
`20170804163032284877151.pdf`§8.2.8原文规定“缓存遥信条数不超过256条”,超出后循环覆盖最早事件,未确认事件重连补发,掉电重启清空。实现以独立256条单/双点时标事件存储落实这一保留范围;普通遥测或其他NORMAL业务不能挤占SOE槽。这里的256按遥信对象计,不按一帧可以合并的对象数计算,也不是把所有带CP56的数据都归为SOE。
|
||||
|
||||
SOE入口只接收完整17字节的Type30/31、COT3、单对象原文。每槽保存17字节ASDU、8字节身份和1字节状态,共26字节;256槽占6656字节。另有默认32个64位退休身份,保存已被覆盖但仍可能收到旧ACK的来源编号,占256字节。这两部分合计6912字节,之外仍有控制字段;不是整个服务的RAM占用或目标平台预算。默认普通NORMAL仍为4096字节,没有改成一个更大的共享环。
|
||||
|
||||
@@ -99,7 +99,7 @@ SOE与普通NORMAL共用发送寿命及业务等级仲裁,不新增第13个业
|
||||
|
||||
## 2. SendBuffer:当前I帧与控制队列
|
||||
|
||||
源码:[IEC104_SendBuffer.c](../../104/IEC104_SendBuffer.c)。
|
||||
源码:[IEC104_SendBuffer.c](../../../App/iec60870/104/IEC104_SendBuffer.c)。
|
||||
|
||||
### 2.1 存储结构
|
||||
|
||||
@@ -174,7 +174,7 @@ Abort清除Buffer控制结构,不关闭TCP、不取消异步I/O;调用方先
|
||||
|
||||
## 3. AsduQueue:变长业务队列
|
||||
|
||||
源码:[IEC104_AsduQueue.c](../../104/IEC104_AsduQueue.c)。
|
||||
源码:[IEC104_AsduQueue.c](../../../App/iec60870/104/IEC104_AsduQueue.c)。
|
||||
|
||||
### 3.1 两级可跨尾部的字节环
|
||||
|
||||
@@ -410,7 +410,7 @@ Detach/Rebind须在旧I/O及Manager结束后执行:取消HIGH待发票据,
|
||||
|
||||
## 4. SendManager:发送准备、ACK及回执
|
||||
|
||||
源码:[IEC104_SendManager.c](../../104/IEC104_SendManager.c)。只绑定CONTROLLED子站;主站启停算法仍由独立Link角色模块提供,不在这里发送ACT。
|
||||
源码:[IEC104_SendManager.c](../../../App/iec60870/104/IEC104_SendManager.c)。只绑定CONTROLLED子站;主站启停算法仍由独立Link角色模块提供,不在这里发送ACT。
|
||||
|
||||
### 4.1 记录与返回值
|
||||
|
||||
@@ -808,7 +808,7 @@ reserve的作用可用两组数值区分。设k=3、记录容量足够、reserve
|
||||
|
||||
另设k=12、记录容量=3、reserve=1,已有两条已ACK但尚未移除的记录:窗口未确认数虽为0,IDLE仍因`record_count(2) + 1 + reserve(1) > 3`而WAIT。Get_Send_Capacity返回的3是总容量,不是空闲槽数;回执转移到FIFO后内部槽可释放,而Slave仍要求先消费该FIFO。公开connection.pending_send_records描述尚未转为事件的记录总数,不区分其中已经ACK的条目,精确事实以RECORD及必要的ACK观察结果判断。
|
||||
|
||||
上述定位对应现有[应答传输测试](../../test/iec104_response_transport_test.c)的`test_response_window_backpressure`,以及[IDLE传输测试](../../test/iec104_idle_transport_test.c)的`test_reserve_pair`、`test_record_reserve_and_tail_notification`、`test_mixed_ack`。完整准入仍以[IDLE设计](IEC104_PeriodicScan_设计架构.md#5-idle-发送与-reserve)为准;本表不增设第三条ASDU队列或新的超时重试规则。
|
||||
上述定位对应现有`iec104_response_transport_test.c`的`test_response_window_backpressure`,以及`iec104_idle_transport_test.c`的`test_reserve_pair`、`test_record_reserve_and_tail_notification`、`test_mixed_ack`。完整准入仍以[IDLE设计](IEC104_PeriodicScan_设计架构.md#5-idle-发送与-reserve)为准;本表不增设第三条ASDU队列或新的超时重试规则。
|
||||
|
||||
<a id="build"></a>
|
||||
|
||||
@@ -72,7 +72,7 @@ flowchart TD
|
||||
- `Create` 同时取得 Slave 槽及它私有的 TcpServer 槽,无动态内存分配和网络操作;取得失败返回 NULL。最后配对 `Destroy`。每个服务同时维护一条主站连接。
|
||||
- `Init` 成功即能缓存主动上报,连接尚未建立也可调用 `Enqueue_Event`。
|
||||
- `Poll` 返回后及时消费事件。仅反复调用 `Poll` 而不调用 `NextEvent`,会积压通知并触发后文的容量等待。
|
||||
- 子站业务包含 [IEC104_Slave.h](../../104/IEC104_Slave.h),即可使用服务、ASDU 和共用发送接口。底层的帧预留、完成提交、队列重绑定由内部调度完成。
|
||||
- 子站业务包含 [IEC104_Slave.h](../../../App/iec60870/104/IEC104_Slave.h),即可使用服务、ASDU 和共用发送接口。底层的帧预留、完成提交、队列重绑定由内部调度完成。
|
||||
|
||||
各组返回值必须分别判断:
|
||||
|
||||
@@ -132,8 +132,8 @@ flowchart TD
|
||||
| `high_priority_burst_limit` | 兼容模式默认4:有NORMAL待发时连续4帧HIGH后让出1帧NORMAL;0使该模式HIGH始终优先 |
|
||||
| `startup_event_gate` | 统一入口默认1;配套驱动Startup,完成本轮初始化和所有参与站真实全站总召后放行NORMAL/IDLE |
|
||||
| `strict_business_priority` | 统一入口默认1;只接受0/1,严格模式使用业务等级及收集轮,不使用兼容配额 |
|
||||
| `IEC104_APP_LAYER_PARAMETERS_DEFAULT` | 定义在 [IEC104_Types.h](../../104/IEC104_Types.h):Type ID 1、VSQ 1、COT 2、默认 OA 0、CA 2、IOA 3、ASDU 最大 249 字节 |
|
||||
| 静态存储容量 | 编译期由 [IEC104_TcpServer_Config.h](../../104/IEC104_TcpServer_Config.h) 配置,默认可创建 1 个服务。与上述运行参数分开 |
|
||||
| `IEC104_APP_LAYER_PARAMETERS_DEFAULT` | 定义在 [IEC104_Types.h](../../../App/iec60870/104/IEC104_Types.h):Type ID 1、VSQ 1、COT 2、默认 OA 0、CA 2、IOA 3、ASDU 最大 249 字节 |
|
||||
| 静态存储容量 | 编译期由 [IEC104_TcpServer_Config.h](../../../App/iec60870/104/IEC104_TcpServer_Config.h) 配置,默认可创建 1 个服务。与上述运行参数分开 |
|
||||
|
||||
传输、SystemCommand、GI、CI和Spontaneous统一通过Startup配置,其余业务保留各自的Config_Default;各模块仍独立Create,不能把业务期限填进Slave的链路配置。命令点表、全局类型掩码、阶段期限、固定ACT_TERM规则及编译期实例/应答池容量见[遥控创建与配置](#flow-command-create);这些期限须由应用与网络等待条件合并,Slave_Prepare不会自动读取业务模块状态。
|
||||
|
||||
@@ -143,7 +143,7 @@ flowchart TD
|
||||
|
||||
### 1.3 接入独立总召模块
|
||||
|
||||
[IEC104_Interrogation.h](../../104/business/IEC104_Interrogation.h) 提供站总召、分组总召、主站撤销及业务超时处理,接口详见[总召API](IEC104_API接口汇总.md#file-21)。配置包括CA、每批对象上限和三项业务期限,不注册业务回调。Slave交付网络通知,总召模块交付业务事件;应用在同一事件循环中主动读取这两条FIFO,再显式接受请求、提交批次或报告结束。
|
||||
[IEC104_Interrogation.h](../../../App/iec60870/104/business/IEC104_Interrogation.h) 提供站总召、分组总召、主站撤销及业务超时处理,接口详见[总召API](IEC104_API接口汇总.md#file-21)。配置包括CA、每批对象上限和三项业务期限,不注册业务回调。Slave交付网络通知,总召模块交付业务事件;应用在同一事件循环中主动读取这两条FIFO,再显式接受请求、提交批次或报告结束。
|
||||
|
||||
总召内部已经接入上述来源和会话校验:Handle_Event保存经Slave验证的身份,Process及Reply_Begin/Submit_Batch/Complete_Data/Fail_Request在推进前检查请求状态。应用仍按下列流程驱动,无需为总召重复调用这些校验接口;应用只负责业务数据、接受决定及资源清理。
|
||||
|
||||
@@ -562,7 +562,7 @@ COMPLETED/EXECUTION_FAILED在Complete后的最后应答交接后交付;其他
|
||||
|
||||
#### 1.5.8 事件循环与挂起重试
|
||||
|
||||
示例[iec104_slave_example.c](../../examples/iec104_slave_example.c)由Example_Handle_Event分派通知。Example_Step先重试已有校时确认,再Command_Process及Example_Drain_Command,随后推进Read、应用发布队列、召唤和新校时。Example_Command_Action改变模拟设备并记录实际变化,不在回调内发布;动作外报告结果,在肯定确认被接手后提交返回信息,不等待占位到队首。FINISHED清标志和引用并保留已执行点值。占位与失败补报见[1.6节](#flow-spontaneous)。
|
||||
示例`iec104_slave_example.c`由Example_Handle_Event分派通知。Example_Step先重试已有校时确认,再Command_Process及Example_Drain_Command,随后推进Read、应用发布队列、召唤和新校时。Example_Command_Action改变模拟设备并记录实际变化,不在回调内发布;动作外报告结果,在肯定确认被接手后提交返回信息,不等待占位到队首。FINISHED清标志和引用并保留已执行点值。占位与失败补报见[1.6节](#flow-spontaneous)。
|
||||
|
||||
单/双点动作同时保存值和`command_action_time`,COT11用Type30/31反馈该次动作快照,命令原CP56只参与准入与原文确认/终止回显。`Example_Build_Command_Return`将一帧编码进独立的17字节持久缓冲(6字节头+3字节IOA+1字节状态+7字节CP56),Submit_Return_Info的WAIT只重试原帧及原EXECUTE事件。等待中即使当前点值或时钟基准变化,也不能改写这次反馈;总召与Read另取当前快照。
|
||||
|
||||
@@ -679,7 +679,7 @@ static bool App_Read_Step(IEC104_Read_t *read, IEC104_ReadLookup_t lookup,
|
||||
}
|
||||
```
|
||||
|
||||
即使budget尚未用完,WAIT也结束本轮取值;下轮先推进网络、分派通知,再重新调用辅助函数。budget耗尽而仍有可执行READ时,快照会要求0等待,从下一轮继续。EMPTY只表示当前队首不是READ,不能据此销毁模块或省略Process。源码中的对应接线为[Example_Step_Read和Example_Wait_Time](../../examples/iec104_slave_example.c)。
|
||||
即使budget尚未用完,WAIT也结束本轮取值;下轮先推进网络、分派通知,再重新调用辅助函数。budget耗尽而仍有可执行READ时,快照会要求0等待,从下一轮继续。EMPTY只表示当前队首不是READ,不能据此销毁模块或省略Process。源码中的对应接线为`iec104_slave_example.c`。
|
||||
|
||||
Handle_Event对I帧返回HANDLED后停止业务分派,包含静默拒绝;返回ERROR则清理,不能兜底再回44。CONNECTED/ACTIVATED/DEACTIVATED/DISCONNECTED即使已被Read标为HANDLED,也须继续分派给其他业务实例。Get_Status是只读快照,不代替这些状态通知,也不自动释放到期任务。
|
||||
|
||||
@@ -894,7 +894,7 @@ static uint32_t Application_Parameter_Wait(const IEC104_ParameterStatus_t *statu
|
||||
|
||||
## 2. 创建服务与接入主站
|
||||
|
||||
实现入口:[IEC104_Slave.c](../../104/IEC104_Slave.c)、[IEC104_TcpServer.c](../../104/IEC104_TcpServer.c)、[IEC104_Connection.c](../../104/IEC104_Connection.c)、[IEC104_SendManager.c](../../104/IEC104_SendManager.c)。
|
||||
实现入口:[IEC104_Slave.c](../../../App/iec60870/104/IEC104_Slave.c)、[IEC104_TcpServer.c](../../../App/iec60870/104/IEC104_TcpServer.c)、[IEC104_Connection.c](../../../App/iec60870/104/IEC104_Connection.c)、[IEC104_SendManager.c](../../../App/iec60870/104/IEC104_SendManager.c)。
|
||||
|
||||
### 2.1 服务初始化
|
||||
|
||||
@@ -972,7 +972,7 @@ Destroy 成功后必须丢弃旧服务指针。裸指针本身不能识别静态
|
||||
|
||||
## 3. 每一轮 Poll / Process 如何推进
|
||||
|
||||
实现入口:[IEC104_TcpServer.c](../../104/IEC104_TcpServer.c)。
|
||||
实现入口:[IEC104_TcpServer.c](../../../App/iec60870/104/IEC104_TcpServer.c)。
|
||||
|
||||
```text
|
||||
IEC104_Slave_Poll() → IEC104_TcpServer_Poll()
|
||||
@@ -1040,7 +1040,7 @@ IDLE与队满应答直交合计每业务轮最多一帧;集中调度接入方
|
||||
|
||||
## 4. 字节接收、成帧与分派
|
||||
|
||||
实现入口:[IEC104_Receiver.c](../../104/IEC104_Receiver.c)、[IEC104_Codec.c](../../104/IEC104_Codec.c)、[IEC60870_Codec.c](../../common/IEC60870_Codec.c)、[IEC104_Connection.c](../../104/IEC104_Connection.c)。
|
||||
实现入口:[IEC104_Receiver.c](../../../App/iec60870/104/IEC104_Receiver.c)、[IEC104_Codec.c](../../../App/iec60870/104/IEC104_Codec.c)、[IEC60870_Codec.c](../../../App/iec60870/common/IEC60870_Codec.c)、[IEC104_Connection.c](../../../App/iec60870/104/IEC104_Connection.c)。
|
||||
|
||||
```text
|
||||
IEC104_Net_Recv()
|
||||
@@ -1076,7 +1076,7 @@ I 帧在进入 Link 前,已检查 ASDU 公共头和已知固定长度类型的
|
||||
|
||||
## 5. STARTDT:从受理到确认写出
|
||||
|
||||
实现入口:[IEC104_Link_Slave_StartStop.c](../../104/IEC104_Link_Slave_StartStop.c)、[IEC104_SendManager.c](../../104/IEC104_SendManager.c)。
|
||||
实现入口:[IEC104_Link_Slave_StartStop.c](../../../App/iec60870/104/IEC104_Link_Slave_StartStop.c)、[IEC104_SendManager.c](../../../App/iec60870/104/IEC104_SendManager.c)。
|
||||
|
||||
```text
|
||||
主站发送 STARTDT_ACT
|
||||
@@ -1183,7 +1183,7 @@ READY 会替换传给 NextEvent 的整个输出;EMPTY/ERROR 保持输出原值
|
||||
|
||||
## 7. 应答与主动上报如何进入同一发送流程
|
||||
|
||||
实现入口:[IEC60870_Slave.c](../../common/IEC60870_Slave.c)、[IEC104_Slave.c](../../104/IEC104_Slave.c)、[IEC104_TcpServer.c](../../104/IEC104_TcpServer.c)、[IEC104_SendManager.c](../../104/IEC104_SendManager.c)、[IEC104_AsduQueue.c](../../104/IEC104_AsduQueue.c)。
|
||||
实现入口:[IEC60870_Slave.c](../../../App/iec60870/common/IEC60870_Slave.c)、[IEC104_Slave.c](../../../App/iec60870/104/IEC104_Slave.c)、[IEC104_TcpServer.c](../../../App/iec60870/104/IEC104_TcpServer.c)、[IEC104_SendManager.c](../../../App/iec60870/104/IEC104_SendManager.c)、[IEC104_AsduQueue.c](../../../App/iec60870/104/IEC104_AsduQueue.c)。
|
||||
|
||||
### 7.1 请求应答:HIGH 或直接发送缓冲
|
||||
|
||||
@@ -1289,7 +1289,7 @@ IEC104_SendManager_Prepare_Next_Send()
|
||||
|
||||
## 8. 实际写 socket、部分发送与整帧完成
|
||||
|
||||
实现入口:[IEC104_SendBuffer.c](../../104/IEC104_SendBuffer.c)、[IEC104_SendManager.c](../../104/IEC104_SendManager.c)、[IEC104_Connection.c](../../104/IEC104_Connection.c)。
|
||||
实现入口:[IEC104_SendBuffer.c](../../../App/iec60870/104/IEC104_SendBuffer.c)、[IEC104_SendManager.c](../../../App/iec60870/104/IEC104_SendManager.c)、[IEC104_Connection.c](../../../App/iec60870/104/IEC104_Connection.c)。
|
||||
|
||||
```text
|
||||
[内部,TcpServer] Flush_Output()
|
||||
@@ -1411,7 +1411,7 @@ STOP ACT 受理即停止新 I 帧准入,TCP 仍保持连接。停止排空期
|
||||
|
||||
## 11. S 确认、TESTFR 与所有期限如何驱动
|
||||
|
||||
实现入口:[IEC104_Connection.c](../../104/IEC104_Connection.c)、[IEC104_Link.c](../../104/IEC104_Link.c)。
|
||||
实现入口:[IEC104_Connection.c](../../../App/iec60870/104/IEC104_Connection.c)、[IEC104_Link.c](../../../App/iec60870/104/IEC104_Link.c)。
|
||||
|
||||
### 11.1 接收确认
|
||||
|
||||
@@ -1488,7 +1488,7 @@ t2/t3 只有在控制容量和 Link 条件允许时才作为可调度动作,
|
||||
|
||||
## 12. 容量不足时,流程在哪里等待
|
||||
|
||||
通知 FIFO、ASDU 队列、发送缓冲和发送记录是不同的存储,等待位置也不同。容量配置见 [IEC104_TcpServer_Config.h](../../104/IEC104_TcpServer_Config.h)。
|
||||
通知 FIFO、ASDU 队列、发送缓冲和发送记录是不同的存储,等待位置也不同。容量配置见 [IEC104_TcpServer_Config.h](../../../App/iec60870/104/IEC104_TcpServer_Config.h)。
|
||||
|
||||
| 等待原因 | 保留内容与停止位置 | 继续条件 |
|
||||
| --- | --- | --- |
|
||||
@@ -1624,7 +1624,7 @@ NORMAL 恢复依据是仍保留的原文,不会恢复已经覆盖的旧条目
|
||||
|
||||
### 13.4 初始化、总召之后启动补发
|
||||
|
||||
本目录规约《配电自动化系统应用DL/T634.5104-2009实施细则(试行)》§8.2.8(43–44页)要求:通信恢复后先完成初始化和总召,再补发断线缓存。[IEC104_Startup](../../104/business/IEC104_Startup.h)提供统一配置与可复用启动协调,`iec104_slave_example`使用同一模块。本节集中定义接线顺序、完成条件与资源归还;各业务模块仍保留自己的协议状态机。统一入口覆盖本节启动、遥信形态及配套调度策略,不代表对整份细则的全部功能或目标设备作验收结论。
|
||||
本目录规约《配电自动化系统应用DL/T634.5104-2009实施细则(试行)》§8.2.8(43–44页)要求:通信恢复后先完成初始化和总召,再补发断线缓存。[IEC104_Startup](../../../App/iec60870/104/business/IEC104_Startup.h)提供统一配置与可复用启动协调,`iec104_slave_example`使用同一模块。本节集中定义接线顺序、完成条件与资源归还;各业务模块仍保留自己的协议状态机。统一入口覆盖本节启动、遥信形态及配套调度策略,不代表对整份细则的全部功能或目标设备作验收结论。
|
||||
|
||||
该节第42页总则另规定缓存遥信不超过256条、超出后覆盖最早事件,未确认事件在重连后重复上送,掉电重启清空。本库默认单/双点COT3、CP56单报逐对象进入独立256条SOE区,普通NORMAL仍保留原4096字节;源遥信和遥控单/双点补报绕开示例普通发布数组的31条淘汰限制。两区共同受本节门禁约束,启动同步期间继续采集及保存,达到256条才按SOE本区最旧顺序覆盖。存储、身份与统计详见[独立SOE存储](IEC104_发送模块_设计架构.md#soe-retention);历史SOE文件是另一份持久记录,不参与网络ACK回收,也不能替代待确认缓存。
|
||||
|
||||
@@ -1684,7 +1684,7 @@ stateDiagram-v2
|
||||
|
||||
例如只初始化计数量配置时调用`IEC104_Startup_Config_Default(NULL, NULL, NULL, &ci, NULL)`,其余对象可在各自创建处通过同一入口填写。原四参数Startup调用也须在spontaneous之前补上独立counter输出或NULL。ClockSynchronization、Read、Parameter等未列出的模块仍保留各自公开`Config_Default`。
|
||||
|
||||
基础填值函数`*_Config_Init_Base`只声明在库内的[传输配置私有头](../../104/IEC104_Config_Internal.h)和[业务配置私有头](../../104/business/IEC104_BusinessConfig_Internal.h),由Startup向下调用;应用、示例和测试不得直接包含这些私有头取得另一套配置。专项测试先使用统一入口,再显式设置`gate=0/strict=0/ONCE`或固定站模式隔离所测行为,并保留相应断言;这些覆盖不改变统一入口的产品策略。参数多主站示例对每个Slave独立执行初始化、真实全站总召、补发放行及严格业务轮,彼此的启动完成事实不能共用。
|
||||
基础填值函数`*_Config_Init_Base`只声明在库内的[传输配置私有头](../../../App/iec60870/104/IEC104_Config_Internal.h)和[业务配置私有头](../../../App/iec60870/104/business/IEC104_BusinessConfig_Internal.h),由Startup向下调用;应用、示例和测试不得直接包含这些私有头取得另一套配置。专项测试先使用统一入口,再显式设置`gate=0/strict=0/ONCE`或固定站模式隔离所测行为,并保留相应断言;这些覆盖不改变统一入口的产品策略。参数多主站示例对每个Slave独立执行初始化、真实全站总召、补发放行及严格业务轮,彼此的启动完成事实不能共用。
|
||||
|
||||
#### 13.4.1 推进顺序与层次分工
|
||||
|
||||
@@ -1696,12 +1696,12 @@ stateDiagram-v2
|
||||
|
||||
| 层次与源码 | 保存或判断的内容 | 不承担的工作 |
|
||||
|---|---|---|
|
||||
| [TcpServer](../../104/IEC104_TcpServer.c)与发送队列 | `startup_pending`、连接代次与实际START轮次;发送推进前闭锁,放行时重新校验身份及通知 | 不解析Type70、QOI或总召完成 |
|
||||
| [SystemCommand](../../104/business/IEC104_SystemCommand.c) | [初始化轮次及末帧交接](IEC104_SystemCommand_设计架构.md#system-initialization-completion),输出`init_completed_activation_id` | 不自动放行NORMAL或接管总召 |
|
||||
| [Interrogation](../../104/business/IEC104_Interrogation.c) | 协议提交进度、FINISHED和逐站[completion_ticket](IEC104_Interrogation_设计架构.md#gi-completion-ticket) | 不把COMPLETED改为等待ACK,也不筛选启动流程 |
|
||||
| [TcpServer](../../../App/iec60870/104/IEC104_TcpServer.c)与发送队列 | `startup_pending`、连接代次与实际START轮次;发送推进前闭锁,放行时重新校验身份及通知 | 不解析Type70、QOI或总召完成 |
|
||||
| [SystemCommand](../../../App/iec60870/104/business/IEC104_SystemCommand.c) | [初始化轮次及末帧交接](IEC104_SystemCommand_设计架构.md#system-initialization-completion),输出`init_completed_activation_id` | 不自动放行NORMAL或接管总召 |
|
||||
| [Interrogation](../../../App/iec60870/104/business/IEC104_Interrogation.c) | 协议提交进度、FINISHED和逐站[completion_ticket](IEC104_Interrogation_设计架构.md#gi-completion-ticket) | 不把COMPLETED改为等待ACK,也不筛选启动流程 |
|
||||
| [Slave逐站辅助接口](IEC104_API接口汇总.md#slave-startup-replay) | 原站注册号、模块/请求身份、成功记录和票据;汇总所有站是否HANDED | 不自动获取站表锁,不验证QOI/TEST,不直接发送总召 |
|
||||
| [Startup协调](../../104/business/IEC104_Startup.c) | 配套配置、原激活身份、阶段及站表锁;核对初始化归属,筛选真实全站GI并等待末帧交接 | 不消费业务事件、不推进其他模块、不持有应用取数引用 |
|
||||
| [示例应用](../../examples/iec104_slave_example.c) | 调用统一入口、串行分派与取数;按Reset结果清理自身游标及引用 | 不另建启动状态机或补发队列,不复制NORMAL原文或改写原事件时标 |
|
||||
| [Startup协调](../../../App/iec60870/104/business/IEC104_Startup.c) | 配套配置、原激活身份、阶段及站表锁;核对初始化归属,筛选真实全站GI并等待末帧交接 | 不消费业务事件、不推进其他模块、不持有应用取数引用 |
|
||||
| `iec104_slave_example.c` | 调用统一入口、串行分派与取数;按Reset结果清理自身游标及引用 | 不另建启动状态机或补发队列,不复制NORMAL原文或改写原事件时标 |
|
||||
|
||||
这些入口由同一应用循环串行调用。默认严格`Example_Step`在初始化等级推进SystemCommand并调用`Example_Startup_Step`观察初始化完成;在初始化总召及普通总召等级推进GI后,再调用启动步进检查本轮登记的结束票据。计数量在独立的后续等级推进。显式关闭严格模式时,兼容分支在GI/CI轮换前后检查启动状态。GI前的检查使其能及时领取BEGIN,GI后的检查使已交接的末站及时放行;PENDING仍留给后续网络推进,不通过循环重试制造交接事实。
|
||||
|
||||
@@ -1752,7 +1752,7 @@ Begin只记录尝试,尚未收到成功FINISHED时,新获准请求可以替
|
||||
| 同TCP/重连旧完成、多CA全体完成、未读通知下退出 | `test_startup_rejects_old_completion`、`test_startup_requires_all_stations`、`test_startup_drain_finished_with_notifications` |
|
||||
| 真实报文顺序、公平配额、未ACK原文恢复、独立IDLE门禁 | `startupReplayLoopback`、`startupIdleLoopback` |
|
||||
|
||||
前两行位于[示例C测试](../../test/iec104_slave_example_test.c),最后一行位于[主示例TCP回环](../../test/slave_example_loopback_test.cjs)。测试入口、容量矩阵及已执行结果以[启动补发测试说明](../test/IEC104测试文档.md#startup-replay-tests)和该文验证记录为准;本节描述现行设计,不把文档补充视作新增实跑。
|
||||
前两行位于`iec104_slave_example_test.c`,最后一行位于`slave_example_loopback_test.cjs`。测试入口、容量矩阵及已执行结果以[启动补发测试说明](../test/IEC104测试文档.md#startup-replay-tests)和该文验证记录为准;本节描述现行设计,不把文档补充视作新增实跑。
|
||||
|
||||
资源采用现有事件环与缓存容量,只增加状态/票据元数据;广播逐站状态增加一个64位票据。2026-11-11在Windows GCC `-O2`、默认单TCP、ACK观察容量2下,对修改的7个编译单元作前后对比,静态BSS合计增加192字节;示例`main`静态栈帧1136→1168字节、`Example_Drain_Business`160→192字节。该结果仅用于主机实现对比,嵌入式接入仍以对应ARMCC工程的链接及栈报告为准;本次没有改变任务、配置的栈或ASDU缓存容量。
|
||||
|
||||
@@ -1893,12 +1893,12 @@ Close 后读空事件,也可以再次 Init 重开;新服务和连接的身
|
||||
|
||||
| 实现文件 | 已有调用关系或用途 |
|
||||
| --- | --- |
|
||||
| [IEC104.c](../../104/IEC104.c) | 旧全局逐字节入口:Rx_Reset / Legacy_Link_Reset 后调用 Rx_Feed_Byte。它不是 TcpServer 当前使用的 Receiver 路径,也不提供上述完整事件与发送调度 |
|
||||
| [IEC104_Link_Master_StartStop.c](../../104/IEC104_Link_Master_StartStop.c) | 主站 Link 层 START:Prepare_Startdt_Act → 外部实际发送 → Complete_Startdt_Act_Send → Handle_Startdt_Con |
|
||||
| `IEC104.c` | 旧全局逐字节入口:Rx_Reset / Legacy_Link_Reset 后调用 Rx_Feed_Byte。它不是 TcpServer 当前使用的 Receiver 路径,也不提供上述完整事件与发送调度 |
|
||||
| `IEC104_Link_Master_StartStop.c` | 主站 Link 层 START:Prepare_Startdt_Act → 外部实际发送 → Complete_Startdt_Act_Send → Handle_Startdt_Con |
|
||||
| 同上 | 主站 Link 层 STOP:Request_Stopdt → Prepare_Stopdt_Request,必要时先 S → 对应 Complete → Handle_Stopdt_Con。TCP 连接、发送缓冲和计时驱动仍需主站集成方提供 |
|
||||
| [IEC60870_Time.c](../../common/IEC60870_Time.c) | 业务需要时调用日期校验、秒数/本地时间和 CP56Time2a 转换,不负责链路调度 |
|
||||
| [IEC60870_Clock.c](../../common/IEC60870_Clock.c) | 提供业务时钟读取/设置;RTC 适配钩子由平台补充,不自动完成校时 ASDU 业务 |
|
||||
| [IEC104_Log.c](../../104/IEC104_Log.c) | 应用按需要配置日志级别和日志输出回调,不承担收发事件调度 |
|
||||
| [IEC60870_Time.c](../../../App/iec60870/common/IEC60870_Time.c) | 业务需要时调用日期校验、秒数/本地时间和 CP56Time2a 转换,不负责链路调度 |
|
||||
| `IEC60870_Clock.c` | 提供业务时钟读取/设置;RTC 适配钩子由平台补充,不自动完成校时 ASDU 业务 |
|
||||
| `IEC104_Log.c` | 应用按需要配置日志级别和日志输出回调,不承担收发事件调度 |
|
||||
|
||||
阅读源码时,可沿以下顺序定位主要行为:
|
||||
|
||||
@@ -2387,4 +2387,3 @@ Windows后端的FlushFileBuffers和XML枚举是同步操作,目录打开最多
|
||||
Type101的BEGIN在电能量模式中只允许QCC=0x05,并按请求身份生成八点float32/QDS快照;确认WAIT、NEED_DATA及组帧不再采样。值不经过BCR。FRZ/FLOWREV仅通过Type210的精确目录及文件名路由导出,默认空目录仍代表SOE。
|
||||
|
||||
封存先提交SEAL,随后提交META提示;SEAL成功即不可重新写入。新日期复用槽之前先提交新的保留起点R。各操作中断后由Init扫描事实恢复,错误边界与不可检测情形见[持久与恢复设计](../common/IEC60870_EnergyFreeze_设计架构.md)。QRP1保留计量源、分段和存储;退出时先完成文件会话清理,再关闭后端。
|
||||
|
||||
@@ -342,7 +342,7 @@ TCP将它们拆成三次输入,第三次又把两帧粘在一起:
|
||||
|
||||
Connection受理A后,可能已推进I帧序号及捎带ACK,却因普通通知空间不足尚未交付I_FRAME。此时保留A和B,先消费NextEvent腾空间,再Process复制A并释放内部帧;不能为了优先处理B而跳过A,也不能再次提交A的Link处理。控制请求返回WAIT时也保留原帧:START尚未受理;TESTFR_ACT的接收事实已登记、CON等待入队,重试登记幂等。保留完整帧不代表所有状态都尚未更新。
|
||||
|
||||
维护时对照[Receiver_Feed实现](../../104/IEC104_Receiver.c)检查consumed和待帧分支;现有[事件环测试](../../test/iec104_tcp_event_ring_test.c)中的`test_fragmented_receive_and_budget`检查分片及交付预算,`test_pending_frame_before_record`检查保留I帧先于其触发的RECORD交付。上述字节划分是源码行为推演,不新增测试运行结论。
|
||||
维护时对照[Receiver_Feed实现](../../../App/iec60870/104/IEC104_Receiver.c)检查consumed和待帧分支;现有`iec104_tcp_event_ring_test.c`中的`test_fragmented_receive_and_budget`检查分片及交付预算,`test_pending_frame_before_record`检查保留I帧先于其触发的RECORD交付。上述字节划分是源码行为推演,不新增测试运行结论。
|
||||
|
||||
## 四、ASDU 公共头解析
|
||||
|
||||
@@ -472,28 +472,15 @@ Receiver和Codec不依赖日志模块。连接层根据返回值决定日志级
|
||||
|
||||
接口过期的旧测试入口已删除;当前测试直接使用现有TcpServer实现,不提供测试兼容层。
|
||||
|
||||
## 八、变更记录
|
||||
|
||||
| 日期 | 变更 |
|
||||
|---|---|
|
||||
| 2026-09-03 | 初始版本:依据当前源码建立成帧、APCI/ASDU 解析、链路序号、接口契约、测试基线和已知边界设计说明 |
|
||||
| 2026-09-03 | 拆分 `IEC104_Link.c` 设计:本文只保留调用边界和全局状态集成限制,链路状态、算法及测试迁移至独立文档 |
|
||||
| 2026-09-03 | 更正 ASDU 调用关系:明确当前接收链路只调用 APCI 解析,`IEC60870_Parse_ASDU_Header()` 尚未接入且仅由测试直接调用 |
|
||||
| 2026-09-04 | 增加I、S、U帧无状态构造接口及其参数、输出格式和职责边界说明 |
|
||||
| 2026-09-07 | 链路模块增加普通S帧的 `w` 门限、立即确认、N(R)快照和发送完成接口;全局接收器与发送调度仍未接入该流程 |
|
||||
| 2026-09-08 | 同步固定连接角色模型:全局旧入口默认被控站;连接故障只由外部 TCP 上下文管理,不在链路状态重复锁存;详细状态与接口契约见链路设计文档 |
|
||||
| 2026-09-10 | 同步IEC104_Legacy_Link_Reset命名及两类复位边界,纠正I/S链路结果类型,补充U帧编码返回约定与当前测试状态;区分已有算法和待实现的连接调度 |
|
||||
| 2026-09-17 | 将无状态编解码、协议常量和报文类型提取到IEC104_Codec.c/h;旧单路接收入口及其行为保留,IEC104.h继续提供原有声明,生产构建新增Codec源文件 |
|
||||
|
||||
## 九、当前验证与使用边界
|
||||
## 八、当前验证与使用边界
|
||||
|
||||
本文描述当前源码行为,不等于已经完成全部端到端协议验证。当前保留的传输、业务及示例测试入口、编译命令和覆盖范围集中维护在[测试说明](../test/IEC104测试文档.md);已删除旧回归套件的历史通过数不计入当前验证。本次文档核对不新增测试通过或硬件验收结论。
|
||||
|
||||
链路层已提供 `sent_vs`、不可变 I 帧快照、固定角色启停、按受理顺序立即启停和独立 TESTFR。独立 `IEC104_SendBuffer` 已提供 唯一当前I帧、独立紧凑S/U FIFO、部分写入及本地发送期限;`IEC104_AsduQueue` 和 `IEC104_SendManager` 已提供变长业务排队、发送前编号、未ACK原文保留、I/S接收、完成分派、独立回执、I帧t1及显式重连恢复。Receiver已提供独立接收上下文、完整APDU交付和代次隔离;Connection已统一收发事件分派、U帧路由及协议期限,Windows TcpServer已提供实际I/O,并用Poll周期调用Tick,无须业务另建协议定时器。基础编码器只校验可见参数,U枚举截断边界见2.4节,不能宣称已经全面校验所有整数输入。
|
||||
|
||||
## 十、集成设计与接入边界
|
||||
## 九、集成设计与接入边界
|
||||
|
||||
### 10.1 当前能力与职责分配
|
||||
### 9.1 当前能力与职责分配
|
||||
|
||||
Receiver已实现每连接成帧和完整APDU交付;独立发送队列、业务队列及发送调度接口见 [发送模块统一设计](IEC104_发送模块_设计架构.md)。当前Windows子站由Slave统一入口接入Connection、TcpServer和Net_Windows;应用持续Prepare/Process或Poll,通过NextEvent主动分派给所需业务模块,并提供数据源及动作执行。
|
||||
|
||||
@@ -515,7 +502,7 @@ Receiver已实现每连接成帧和完整APDU交付;独立发送队列、业
|
||||
| COT1周期及COT2背景扫描 | IEC104_PeriodicScan(已实现) | 按组或点级时间网格取当前值,IDLE直发保留窗口/记录余量;阻塞时重新取值,见[扫描设计](IEC104_PeriodicScan_设计架构.md) |
|
||||
| 实际遥信/遥测数据源、输出及设备设时 | 应用接入层 | 按业务模块请求读取点表或执行设备动作;示例提供模拟点表、遥控输出和模拟时钟,协议库不自动操作硬件 |
|
||||
|
||||
### 10.2 统一连接上下文
|
||||
### 9.2 统一连接上下文
|
||||
|
||||
独立Receiver由Connection持有,接收和发送使用同一份LinkState;已恢复的旧入口仍保留原有接收/Link私有全局对象,不参与TcpServer路径。当前归属如下:
|
||||
|
||||
@@ -546,7 +533,7 @@ Receiver的内部Peek视图持续有效到Release、Reset或重新Init。TcpServ
|
||||
|
||||
`strict_business_priority`与启动门禁独立。严格模式下HIGH/NORMAL表示原文生命周期,实际业务先后由1..12级决定,同级按共享受理顺序选择。应用仍在同一个串行循环内维护并准备业务,不创建12个任务或12份ASDU缓冲;已进入SendBuffer的帧、协议期限和ACK规则保持。新增结构及扫描/压紧成本的边界见[存储与准入](IEC104_业务优先级设计.md#priority-frame-admission)。
|
||||
|
||||
### 10.3 收发与状态提交顺序
|
||||
### 9.3 收发与状态提交顺序
|
||||
|
||||
以下说明底层顺序。SendManager.Prepare_Next_Send在实际发送前选择并准备当前帧,Handle_Send_Progress执行完整发送后的Complete/Commit_Send_Completion,Handle_I_S_Frame执行I/S校验、记录ACK并释放对应ASDU原文;调用方不再重复执行其中的底层步骤。S/TESTFR及子站启停构帧入队使用Manager封装;TESTFR_ACT由Link先登记接收事实,Manager再预留槽并调用Codec编码CON,CON等待容量时也已抑制本TCP连接的新主动ACT。已有探测的TESTFR_CON仍经Manager.Handle_Testfr_Con提交,只有受理成功才由Connection撤销该轮t1,详见[TESTFR职责与生命周期](IEC104_Link_设计架构.md#link-testfr-master-preference)。Connection安排调用时机及U帧路由,TcpServer执行I/O。Manager仅绑定CONTROLLED链路,不参与主站启停流程。
|
||||
|
||||
@@ -570,7 +557,7 @@ I帧完成接口要求快照的 `N(S)==sent_vs`,只推进本地完成边界和
|
||||
|
||||
被控站受理START时立即激活,受理STOP时立即停用并等待确认;相反ACT不暂存。后到START结束尚未生成CON的停止等待,已有CON按FIFO写出,完成不回写状态。S确认覆盖接收数据且I帧全部获ACK时可排STOP_CON;Connection最多依次推进S与CON两项。STOP总期限从received_at_ms起算,按本轮最后一帧STOP_CON身份结束,成功受理START也取消旧计时。状态事件由Connection内部适配器在ACT受理时交给TcpServer,通知容量不足则WAIT保留原请求。发送完成仍准确记录字节、序号及ACK事实,见[发送缓冲设计](IEC104_发送模块_设计架构.md#sendbuffer)。
|
||||
|
||||
### 10.4 建议实施顺序与验收点
|
||||
### 9.4 建议实施顺序与验收点
|
||||
|
||||
| 顺序 | 实施内容 | 可检查的完成条件 |
|
||||
|---:|---|---|
|
||||
@@ -585,9 +572,9 @@ I帧完成接口要求快照的 `N(S)==sent_vs`,只推进本地完成边界和
|
||||
|
||||
<a id="spec-alignment-design"></a>
|
||||
|
||||
### 10.5 实施细则默认策略与应用边界
|
||||
### 9.5 实施细则默认策略与应用边界
|
||||
|
||||
本轮依据目录内[实施细则原文](../../20170804163032284877151.pdf)§8.1.4、§8.1.5及§9.2表8,修正示例配置及应用适配。遥控条款要求选择后执行或撤销,默认选择保持60秒;遥信仅在总召时使用无时标报文,其他情况下使用带时标报文;表8的地址按十六进制解释。以下是这些要求在当前工程中的落点,不代表对整份实施细则的完整符合性声明。
|
||||
本轮依据目录内`20170804163032284877151.pdf`§8.1.4、§8.1.5及§9.2表8,修正示例配置及应用适配。遥控条款要求选择后执行或撤销,默认选择保持60秒;遥信仅在总召时使用无时标报文,其他情况下使用带时标报文;表8的地址按十六进制解释。以下是这些要求在当前工程中的落点,不代表对整份实施细则的完整符合性声明。
|
||||
|
||||
| 要求 | 当前实现及职责 | 通用库保留的能力 |
|
||||
|---|---|---|
|
||||
@@ -604,7 +591,7 @@ I帧完成接口要求快照的 `N(S)==sent_vs`,只推进本地完成边界和
|
||||
|
||||
<a id="link-spec-fixes"></a>
|
||||
|
||||
### 10.6 接收序号与TESTFR两项细则修复
|
||||
### 9.6 接收序号与TESTFR两项细则修复
|
||||
|
||||
下表汇总2026-11-15完成的两项链路修复。详细契约集中在Link设计,执行结果集中在测试文档;本节只提供条款与接入影响的对应关系,不作为整份细则的完整符合性声明。
|
||||
|
||||
+1
-1
@@ -2,7 +2,7 @@
|
||||
|
||||
状态:2026-11-03已实施。范围仅为IEC60870-Slave。本次以通用HIGH/NORMAL协议发送核心替代[有序应答机制](IEC104_有序应答修复记录.md),不实施R/O分道、FENCE、点链表、配额预留或紧急事件新队列。
|
||||
|
||||
后续命名整理:当前测试入口已改为[通用应答队列](../../test/iec104_response_queue_test.c)和[通用应答传输](../../test/iec104_response_transport_test.c),构建脚本同步使用response名称。下方验证记录中的旧ordered名称仅记载当时路径。
|
||||
后续命名整理:当前测试入口已改为`iec104_response_queue_test.c`和`iec104_response_transport_test.c`,构建脚本同步使用response名称。下方验证记录中的旧ordered名称仅记载当时路径。
|
||||
|
||||
本文记录HIGH/NORMAL迁移及随后遥控修复,不是完整的现行发送接口清单。后续加入的[ACK观察](IEC104_API接口汇总.md#response-ack-usage)与[IDLE直接发送](IEC104_API接口汇总.md#slave-idle-send)不增加第三条ASDU队列;当前状态字段、结构尺寸及全路径契约以[发送模块设计](IEC104_发送模块_设计架构.md)为准。下文的尺寸与测试组数保留各次验证时的事实。
|
||||
|
||||
@@ -47,7 +47,7 @@
|
||||
|
||||
接线时先完成[启动恢复](IEC104_完整调用流程.md#flow-firmware-update-startup),运行中按[持久授权交接](IEC104_完整调用流程.md#flow-firmware-update-authorization)处理文件完成、END和Take。`Prepare_Boot`每次启动或激活只调用一次,健康确认另由Confirm完成;普通105重建和网络重连不能借用启动恢复入口。存储布局、错误恢复和验证证据的集中入口见[升级导航](../README.md#firmware-update-guide)。
|
||||
|
||||
附录C运行日志以公共`IEC60870_UserLog`和`IEC60870_UserLogFile`提供1024条循环记录及XML导出,主示例用`--user-log existing-directory`独立启用并接入Type210。记录类型、来源边沿、校时回拨、存储及移植边界见[运行日志设计](../common/IEC60870_UserLog_设计架构.md#user-log-design),接口见[核心](IEC104_API接口汇总.md#user-log-api)和[XML](IEC104_API接口汇总.md#user-log-file-api)。
|
||||
附录C运行日志以公共`IEC60870_UserLog`和`IEC60870_UserLogFile`提供1024条循环记录及XML导出,主示例用`--user-log existing-directory`独立启用并接入Type210。记录类型、来源边沿、校时回拨、存储及移植边界见[运行日志设计](../common/IEC60870_UserLog_设计架构.md),接口见[核心](IEC104_API接口汇总.md#user-log-api)和[XML](IEC104_API接口汇总.md#user-log-file-api)。
|
||||
|
||||
软件升级由独立`business/IEC104_SoftwareUpgrade.c/h`提供Type211启动、结束、撤销及ACK后授权。应用通过Type210接收升级候选并维护设备owner;协议只通过显式action作决定,Take成功后由应用进入QUIESCING。默认ACKED允许STOP排空期ACK,ACTIVE_ACKED只认首次STOP前;已确定授权跨连接保留。见[设计](IEC104_SoftwareUpgrade_设计架构.md)、[接入](IEC104_完整调用流程.md#flow-software-upgrade)及[验证](../test/IEC104测试文档.md#software-upgrade-tests)。
|
||||
|
||||
@@ -67,7 +67,7 @@
|
||||
|
||||
Slave提供[共用站点表](IEC104_API接口汇总.md#station-registry):应用提供固定地址节点,动态注册多个CA和业务context,重复CA拒绝。删除立即退出路由,已有引用和遍历结束后才回收;Is_Reusable为true后应用才能释放存储。总召设置config.use_station_registry=true后按请求CA选站;多目标广播配置每站状态区,以一个任务执行“全部确认、逐站数据、全部终止”。其他业务可复用相同的查找、引用及快照遍历接口。
|
||||
|
||||
总召由独立库模块[IEC104_Interrogation.c/h](../../104/business/IEC104_Interrogation.h)实现,支持QOI=20站总召、21..36分组总召及多类型无时标监视数据,负责批次校验、发送等待、主站撤销、业务超时及停用/断线取消。应用通过BEGIN/NEED_DATA/FINISHED事件和显式应答管理IOA、分组、遍历、逐批取值及终结;[子站示例](../../examples/iec104_slave_example.c)提供模拟点表、事件分派和main,构建运行见[示例说明](../examples/IEC104子站示例.md)。
|
||||
总召由独立库模块[IEC104_Interrogation.c/h](../../../App/iec60870/104/business/IEC104_Interrogation.h)实现,支持QOI=20站总召、21..36分组总召及多类型无时标监视数据,负责批次校验、发送等待、主站撤销、业务超时及停用/断线取消。应用通过BEGIN/NEED_DATA/FINISHED事件和显式应答管理IOA、分组、遍历、逐批取值及终结;`iec104_slave_example.c`提供模拟点表、事件分派和main,构建运行见[示例说明](../examples/IEC104子站示例.md)。
|
||||
|
||||
内部调用关系为`Slave → TcpServer → Connection → SendManager/Receiver/Link`,网络I/O仍经Net执行,当前提供Windows后端。每个Slave保持单连接,使用静态内存、HIGH/NORMAL两类生命周期存储、IDLE直发及事件FIFO,由Prepare/Process或Poll驱动;兼容与严格模式共享这些存储但使用不同候选选择规则,多个主站分别使用独立Slave。共用ASDU及MasterConnection接口使用IEC60870前缀,104的Slave门面使用IEC104前缀;公共层不依赖104传输实现。下文的底层接口说明供维护和独立TCP接入使用,业务默认通过Slave操作服务。
|
||||
|
||||
@@ -395,7 +395,7 @@ NextEvent返回EMPTY/ERROR时保持输出不变。Close、重连、重新Init或
|
||||
|
||||
多帧总召的数据和正常终止应使用同一原请求身份,经HIGH接口依次提交并逐帧处理WAIT;把数据放NORMAL而终止放普通HIGH会造成优先级越序。可使用事件的connection调用Send_ASDU_Tracked,或保存紧凑身份后调用Send_Response_Tracked;门面不实现点表、总召状态机、遥控选择/执行或系统校时。
|
||||
|
||||
[子站示例](../../examples/iec104_slave_example.c)通过BEGIN/NEED_DATA/FINISHED事件与显式应答接入独立的[总召模块](../../104/business/IEC104_Interrogation.h)推进业务;Slave和TcpServer继续负责服务、连接及传输。总召接入顺序见[完整调用流程](IEC104_完整调用流程.md#flow-interrogation)。
|
||||
`iec104_slave_example.c`通过BEGIN/NEED_DATA/FINISHED事件与显式应答接入独立的[总召模块](../../../App/iec60870/104/business/IEC104_Interrogation.h)推进业务;Slave和TcpServer继续负责服务、连接及传输。总召接入顺序见[完整调用流程](IEC104_完整调用流程.md#flow-interrogation)。
|
||||
|
||||
调用`IEC104_Interrogation_Process(gi)`自动推进当前就绪任务,无需传入预算。每个实例至多一个未终结总召,包含等待生成BEGIN的请求;忙时相同和不同QOI的新激活均否定,不保存后续总召。4个任务槽共用于这个总召和待发短应答。Handle_Event在原会话有效、Slave通知已读空且无更早REPLY时尝试立即提交短应答,未接手再保存。满槽时尝试否定确认;不能安全提交/保存则仅丢新请求并累计dropped_requests,保留当前任务及TCP。Process在空闲、等待应用/事件空位、发送WAIT或Slave通知未读空时返回。对象、状态、调度及接入约定见[总召模块设计](IEC104_Interrogation_设计架构.md)。
|
||||
|
||||
@@ -419,7 +419,7 @@ BEGIN生成时启动已启用的业务期限,此前等待业务事件空位没
|
||||
|
||||
### 时钟同步业务
|
||||
|
||||
[ClockSynchronization](../../104/business/IEC104_ClockSynchronization.h)处理Type103、IOA=0的COT=6校时和COT=5读时,按共用站点表路由;COT=8等其他COT回45。独立静态池默认与TCP服务容量相同,每实例4个任务槽,与总召/计数量分别创建、分别取消。Handle_Event校验保存,Process处理期限及FIFO回复,应用通过Execute_Next_With_Read显式提供读/设时回调,模块不保存函数指针。旧Execute_Next保留为仅设时入口,遇未取样READ不会越过它。
|
||||
[ClockSynchronization](../../../App/iec60870/104/business/IEC104_ClockSynchronization.h)处理Type103、IOA=0的COT=6校时和COT=5读时,按共用站点表路由;COT=8等其他COT回45。独立静态池默认与TCP服务容量相同,每实例4个任务槽,与总召/计数量分别创建、分别取消。Handle_Event校验保存,Process处理期限及FIFO回复,应用通过Execute_Next_With_Read显式提供读/设时回调,模块不保存函数指针。旧Execute_Next保留为仅设时入口,遇未取样READ不会越过它。
|
||||
|
||||
默认设时源标准时区480分钟、读/设时执行期限15000ms,0禁用期限;设时IV/SU及时区由公共时间工具处理,64位毫秒计算只补偿受理后的站内滞留。设时action收到的local_time已经是固定UTC+8,base_ms为执行检查时刻,ACT_CON保留原CP56。读时接受全零占位,返回本地CP56快照及星期1–7,WAIT期间不重读;TEST、广播及失败策略见[读时钟设计](IEC104_ClockSynchronization_设计架构.md#clock-read)。
|
||||
|
||||
@@ -427,7 +427,7 @@ BEGIN生成时启动已启用的业务期限,此前等待业务事件空位没
|
||||
|
||||
### 遥控、遥调与带时标命令业务
|
||||
|
||||
[Command](../../104/business/IEC104_Command.h)处理Type45–51及58–64、COT=6激活与COT=8撤销;默认全局type_mask=0x3FFF,但points=NULL、point_count=0,不接入任何可执行点。应用提供按CA再IOA严格升序且唯一的只读点表,每点配置允许类型和DIRECT或SELECT_EXECUTE;51/64没有S/E位,只能采用DIRECT。Create借用点表至Destroy,不复制、不允许热更新;实际受理类型取全局和点掩码的交集。无点的新激活回47,点类型或模式不符回否定7,不生成工作事务。每个Slave只能绑定一个实例,事务槽未释放时所有站点的新命令互斥。正常完成等待最后应答HANDED;提前结束不等发送层已接手的尾帧,但仍须读完FINISHED并清空模块持有的本事务应答,详见[遥控设计](IEC104_Command_设计架构.md)。全局未启用类型继续交给后续处理器或44兜底。
|
||||
[Command](../../../App/iec60870/104/business/IEC104_Command.h)处理Type45–51及58–64、COT=6激活与COT=8撤销;默认全局type_mask=0x3FFF,但points=NULL、point_count=0,不接入任何可执行点。应用提供按CA再IOA严格升序且唯一的只读点表,每点配置允许类型和DIRECT或SELECT_EXECUTE;51/64没有S/E位,只能采用DIRECT。Create借用点表至Destroy,不复制、不允许热更新;实际受理类型取全局和点掩码的交集。无点的新激活回47,点类型或模式不符回否定7,不生成工作事务。每个Slave只能绑定一个实例,事务槽未释放时所有站点的新命令互斥。正常完成等待最后应答HANDED;提前结束不等发送层已接手的尾帧,但仍须读完FINISHED并清空模块持有的本事务应答,详见[遥控设计](IEC104_Command_设计架构.md)。全局未启用类型继续交给后续处理器或44兜底。
|
||||
|
||||
SELECT_WAIT/EXECUTE_WAIT决定期间,同会话代次、同站点注册编号、同IOA及同T位的新激活通常按OA分流:OA相同静默丢弃,OA不同以独立短应答回否定ACT_CON;两者均保留原工作事件和决定期限。SELECT_WAIT中的同点S/E=1重复选择候选跳过OA分流,先检查时效及点策略;合法后与SELECTED中的重复选择一样,否定回显第二次请求并以DUPLICATE_SELECT复归原选择。OA、合法命令值/限定词或该点允许的类型变化也会复归;旧事件立即失效,已交付工作事件的事务仍须消费一次FINISHED,TEST不产生应用事件。非法候选不清除旧选择,EXECUTE_WAIT/EXECUTING沿用原规则,详见[重复选择复归](IEC104_Command_设计架构.md#command-duplicate-select)。
|
||||
|
||||
@@ -445,7 +445,7 @@ Handle_Event校验并生成SELECT/EXECUTE。Accept动作前不提交旧回复;
|
||||
|
||||
Type42故障事件通过 `IEC104_Spontaneous_Publish_Fault_Event` 独立发布:输入已冻结的故障遥信、CP56和至少8项电气量,复用现有单帧缓冲,以第6级NORMAL上送,不增加普通kind或自动拆帧。接收端格式与实施细则的地址宽度差异、数值编码及WAIT契约见[故障事件设计](../common/IEC60870_FaultEvent_设计架构.md)、[业务入口](IEC104_Spontaneous_设计架构.md#spontaneous-fault-event)。
|
||||
|
||||
[Spontaneous](../../104/business/IEC104_Spontaneous.h)接收应用提供的纯值变化,支持14类、23个Type。单点、双点、步位置、32位串、归一化、标度化和短浮点保留COT=3/12;整数累计量15/37、短浮点电能量206/207、成组单点20、无品质归一化21、保护事件/成组启动/输出电路38–40只允许COT=3。单/双点默认只发CP56,保护三类仅CP56,其他类型默认无时标。20/21只能无时标,38–40只能CP56,原7类及两类电能量仍可显式选择单一形态或双报;CP24不进入本104入口。207须由应用提供原冻结时刻,双报使用同一输入值。其他工程显式开启双报前须核对适用规约及目标主站的点值更新、SOE和重复告警行为。
|
||||
[Spontaneous](../../../App/iec60870/104/business/IEC104_Spontaneous.h)接收应用提供的纯值变化,支持14类、23个Type。单点、双点、步位置、32位串、归一化、标度化和短浮点保留COT=3/12;整数累计量15/37、短浮点电能量206/207、成组单点20、无品质归一化21、保护事件/成组启动/输出电路38–40只允许COT=3。单/双点默认只发CP56,保护三类仅CP56,其他类型默认无时标。20/21只能无时标,38–40只能CP56,原7类及两类电能量仍可显式选择单一形态或双报;CP24不进入本104入口。207须由应用提供原冻结时刻,双报使用同一输入值。其他工程显式开启双报前须核对适用规约及目标主站的点值更新、SOE和重复告警行为。
|
||||
|
||||
Create复制配置并借用Slave,每Slave最多一个静态实例。应用变化包含CA、可选station_id、IOA、值/品质与采集时间。使用Config_Default填满14项forms,库及调用方须全量重编以适配结构扩展。Publish先全量校验,再按连续的CA/类型/COT/形态分段,按容量及重复IOA分块,仅生成启用的形态,双报时先无时标后CP56。错误输入零入队;WAIT用info.published保留未完成后缀并原样重试。成功只表示曾经进入NORMAL,不保证仍保留、已发出或已确认。
|
||||
|
||||
@@ -12,7 +12,7 @@
|
||||
|
||||
| 阅读目的 | 文档入口 |
|
||||
|---|---|
|
||||
| 模块分工、三个槽与持久状态 | [安装设计](common/IEC60870_FirmwareUpdate_设计架构.md#firmware-update-design)、[状态与角色](common/IEC60870_FirmwareUpdate_设计架构.md#firmware-update-state) |
|
||||
| 模块分工、三个槽与持久状态 | [安装设计](common/IEC60870_FirmwareUpdate_设计架构.md)、[状态与角色](common/IEC60870_FirmwareUpdate_设计架构.md#firmware-update-state) |
|
||||
| C接口、借用寿命与错误返回 | [公共核心声明](104/IEC104_API接口汇总.md#firmware-update-core-signatures)、[宿主适配声明](104/IEC104_API接口汇总.md#firmware-update-host-api)、[门面调用契约](common/IEC60870_FirmwareUpdate_设计架构.md#firmware-update-host-api) |
|
||||
| 介质布局和原子提交 | [60字节核心元数据](common/IEC60870_FirmwareUpdate_设计架构.md#firmware-update-wire)、[文件与双bank](common/IEC60870_FirmwareUpdate_设计架构.md#firmware-update-storage) |
|
||||
| 启动恢复、候选失败与试运行回退 | [恢复判据](common/IEC60870_FirmwareUpdate_设计架构.md#firmware-update-recovery)、[启动接线](104/IEC104_完整调用流程.md#flow-firmware-update-startup) |
|
||||
@@ -21,7 +21,7 @@
|
||||
| 资源和目标设备适配 | [缓冲与同步预算](common/IEC60870_FirmwareUpdate_设计架构.md#firmware-update-resources)、[Bootloader及新应用确认](common/IEC60870_FirmwareUpdate_设计架构.md#firmware-update-target) |
|
||||
| 测试场景、命令和已执行结果 | [升级安装专项](test/IEC104测试文档.md#firmware-update-tests) |
|
||||
|
||||
附录C运行日志入口:[类型、XML与持久恢复](common/IEC60870_UserLog_设计架构.md#user-log-design)、[核心API](104/IEC104_API接口汇总.md#user-log-api)、[独立开关及调阅](examples/IEC104子站示例.md#example-user-log)、[日志专项验证](test/IEC104测试文档.md#user-log-tests)。
|
||||
附录C运行日志入口:[类型、XML与持久恢复](common/IEC60870_UserLog_设计架构.md)、[核心API](104/IEC104_API接口汇总.md#user-log-api)、[独立开关及调阅](examples/IEC104子站示例.md#example-user-log)、[日志专项验证](test/IEC104测试文档.md#user-log-tests)。
|
||||
|
||||
附录B历史记录入口:[核心、持久化与XML](common/IEC60870_History_设计架构.md)、[启动及Type210调阅](examples/IEC104子站示例.md#example-history)、[循环、断点恢复及真实TCP测试](test/IEC104测试文档.md#history-tests)。
|
||||
|
||||
+17
-16
@@ -1,6 +1,7 @@
|
||||
<a id="energy-freeze-design"></a>
|
||||
# 冻结电能、潮流反转与持久恢复
|
||||
|
||||
> **本项目未实现**:本文描述的能力在本仓 `App/iec60870/` 中**没有对应实现**(相关 `.c/.h` 在 2026-11-18 收编时裁除)。保留本文仅作协议能力与技术参考,不要据此判断功能可用;源码快照见 `IEC60870-Slave/`(该目录将来会删除)。
|
||||
|
||||
本文说明当前EnergyFreeze实现的时间窗口、持久记录、封存、XML和宿主模拟计量接线。同步日期为2026-11-14。这里的持久冻结是附录B文件的数据源,与Type101请求中的FRZ命令限定词分开;104计数量请求规则仍由[CounterInterrogation](../104/IEC104_CounterInterrogation_设计架构.md)管理。
|
||||
|
||||
接入顺序:[对象生命周期](#energy-freeze-ownership) → [时间与网格](#energy-freeze-time) → [结果处理](#energy-freeze-results) → [存储回调](#energy-freeze-store-contract) → [示例调用顺序](#energy-freeze-integration)。恢复问题见[提交边界](#energy-freeze-commit-order)及[检测能力边界](#energy-freeze-recovery-limits),导出问题见[XML接口契约](#energy-freeze-export-contract)。函数签名集中在[API汇总](../104/IEC104_API接口汇总.md#energy-freeze-api)。
|
||||
@@ -9,11 +10,11 @@
|
||||
|
||||
| 文件 | 职责 |
|
||||
|---|---|
|
||||
| [IEC60870_EnergyFreeze.h](../../common/IEC60870_EnergyFreeze.h)、[实现](../../common/IEC60870_EnergyFreeze.c) | INTERVAL、DAY、FLOWREV、SEAL和META编码、时间准入、恢复及查询;不依赖104、文件系统或线程 |
|
||||
| [IEC60870_EnergyFreezeFile.h](../../common/IEC60870_EnergyFreezeFile.h)、[实现](../../common/IEC60870_EnergyFreezeFile.c) | 校验封存并流式生成FRZ/FLOWREV XML;不持有下载会话 |
|
||||
| [宿主存储适配](../../examples/iec104_example_energy_freeze.h)、[实现](../../examples/iec104_example_energy_freeze.c) | 独占energy.store、双bank提交,以及目录和下载的独立临时文件快照 |
|
||||
| [模拟计量源](../../examples/iec104_example_energy_meter.h)、[实现](../../examples/iec104_example_energy_meter.c) | 整数方波、八个当前示值、持久示值恢复、校时分段和有界FLOW补算 |
|
||||
| [主示例](../../examples/iec104_slave_example.c) | CLI、Type206计数量快照、Type210路由及主循环/退出编排 |
|
||||
| `IEC60870_EnergyFreeze.h`、`IEC60870_EnergyFreeze.c` | INTERVAL、DAY、FLOWREV、SEAL和META编码、时间准入、恢复及查询;不依赖104、文件系统或线程 |
|
||||
| `IEC60870_EnergyFreezeFile.h`、`IEC60870_EnergyFreezeFile.c` | 校验封存并流式生成FRZ/FLOWREV XML;不持有下载会话 |
|
||||
| `iec104_example_energy_freeze.h`、`iec104_example_energy_freeze.c` | 独占energy.store、双bank提交,以及目录和下载的独立临时文件快照 |
|
||||
| `iec104_example_energy_meter.h`、`iec104_example_energy_meter.c` | 整数方波、八个当前示值、持久示值恢复、校时分段和有界FLOW补算 |
|
||||
| `iec104_slave_example.c` | CLI、Type206计数量快照、Type210路由及主循环/退出编排 |
|
||||
|
||||
核心实例及其存储回调由应用持有;Config和Store结构按值复制,点表、context仍借用。调用方须使这些对象持续有效,串行执行记录、查询、恢复和导出;回调不可重入本实例。核心没有自动采集线程,也不因TCP断线停止计量或删除持久文件。
|
||||
|
||||
@@ -324,7 +325,7 @@ QRP1保留整个meter、分段时钟和energy.store;206在BEGIN获取一轮独
|
||||
<a id="energy-freeze-integration"></a>
|
||||
### 7.3 主循环的一轮接入顺序
|
||||
|
||||
当前顺序由[Example_Energy_Meter_Step](../../examples/iec104_example_energy_meter.c)实现:
|
||||
当前顺序由`iec104_example_energy_meter.c`实现:
|
||||
|
||||
1. 将本轮单调时刻映射为UTC,裁剪FLOW积压并按既定预算提交历史事件;事件示值按各自发生时刻求值。
|
||||
2. 清理已不再使用的墙钟分段,再调用`Advance(now)`;发生TIME_REVERSED时本轮结束,先前的FLOW处理已经完成。
|
||||
@@ -358,7 +359,7 @@ GCC `-fstack-usage`报告meter的单函数静态栈:Evaluate_At 160字节、Sn
|
||||
|
||||
一次非空FRZ编码使用GetSeal及97个记录位置,共98次逻辑读取;宿主目录另外读取一次SEAL判定是否为空,合计每窗99次。30个完整窗口、每窗96节加DAY、每条8点的宿主样本生成703222字节XML,目录打开实测503.843ms,共2970次逻辑read、5940次bank读取。该数值只描述这份Windows样本,不作为64点、其他磁盘或板端响应时限保证;目录生成仍为同步操作。
|
||||
|
||||
[meter专项](../../test/iec104_example_energy_meter_test.c)的9组已实跑通过,包含200000次确定种子原像/固定点测试、四象限精确整数期望、跨校时和回拨、有界长步补算、源不一致、近上限与失败隔离。两秒周期跨一天产生86400个反转候选,计数丢弃86144个,256个保留事件分64轮提交,较新读取不污染旧事件值。
|
||||
`iec104_example_energy_meter_test.c`的9组已实跑通过,包含200000次确定种子原像/固定点测试、四象限精确整数期望、跨校时和回拨、有界长步补算、源不一致、近上限与失败隔离。两秒周期跨一天产生86400个反转候选,计数丢弃86144个,256个保留事件分64轮提交,较新读取不污染旧事件值。
|
||||
|
||||
核心、XML、宿主故障注入及TCP测试入口统一为:
|
||||
|
||||
@@ -373,13 +374,13 @@ GCC `-fstack-usage`报告meter的单函数静态栈:Evaluate_At 160字节、Sn
|
||||
|
||||
| 设计约束 | 现有验证入口 |
|
||||
|---|---|
|
||||
| 网格/日界、回拨高水位、同网格重复及冲突、派生DAY、32窗口保留 | [核心专项](../../test/iec60870_energy_freeze_test.c):`test_record_time_and_duplicates`、`test_derive_maximum_and_due`、`test_offsets_tolerance_and_calendar_edges`等 |
|
||||
| SEAL连续性、META滞后、过期损坏仍报错、FLOW连续序号 | [核心恢复用例](../../test/iec60870_energy_freeze_test.c):`test_seal_meta_failure_and_manifest`、`test_meta_empty_hint_and_stale_corruption`、`test_flow_dedup_and_recovery` |
|
||||
| 缺节不改编号、单位区分、失败size不变、FLOW过滤及DI计数 | [XML专项](../../test/iec60870_energy_freeze_file_test.c):`Test_Frz`、`Test_Flow` |
|
||||
| 等长合法正文替换并重算单条CRC仍被SEAL检出;读取途中替换不发布候选 | [XML完整性用例](../../test/iec60870_energy_freeze_file_test.c):`Test_Seal_Replacement` |
|
||||
| bank损坏不能静默退回、META已记下的FLOW尾部丢失、打开的下载不随新目录变化 | [宿主持久适配专项](../../test/iec104_example_energy_freeze_test.c) |
|
||||
| 首次META、普通记录、DAY派生、SEAL→META、先淘汰再复用的分阶段失败恢复 | [提交中断矩阵](../../test/iec104_energy_freeze_transitions_test.c) |
|
||||
| 八值原像恢复、分段校时、旧事件值稳定、每轮FLOW预算、失败隔离 | [模拟计量专项](../../test/iec104_example_energy_meter_test.c) |
|
||||
| Type210目录与下载、96节+DAY、XML解析、跨进程重启与字节一致性 | [TCP回环](../../test/energy_freeze_loopback_test.cjs) |
|
||||
| 网格/日界、回拨高水位、同网格重复及冲突、派生DAY、32窗口保留 | `iec60870_energy_freeze_test.c`:`test_record_time_and_duplicates`、`test_derive_maximum_and_due`、`test_offsets_tolerance_and_calendar_edges`等 |
|
||||
| SEAL连续性、META滞后、过期损坏仍报错、FLOW连续序号 | `iec60870_energy_freeze_test.c`:`test_seal_meta_failure_and_manifest`、`test_meta_empty_hint_and_stale_corruption`、`test_flow_dedup_and_recovery` |
|
||||
| 缺节不改编号、单位区分、失败size不变、FLOW过滤及DI计数 | `iec60870_energy_freeze_file_test.c`:`Test_Frz`、`Test_Flow` |
|
||||
| 等长合法正文替换并重算单条CRC仍被SEAL检出;读取途中替换不发布候选 | `iec60870_energy_freeze_file_test.c`:`Test_Seal_Replacement` |
|
||||
| bank损坏不能静默退回、META已记下的FLOW尾部丢失、打开的下载不随新目录变化 | `iec104_example_energy_freeze_test.c` |
|
||||
| 首次META、普通记录、DAY派生、SEAL→META、先淘汰再复用的分阶段失败恢复 | `iec104_energy_freeze_transitions_test.c` |
|
||||
| 八值原像恢复、分段校时、旧事件值稳定、每轮FLOW预算、失败隔离 | `iec104_example_energy_meter_test.c` |
|
||||
| Type210目录与下载、96节+DAY、XML解析、跨进程重启与字节一致性 | `energy_freeze_loopback_test.cjs` |
|
||||
|
||||
编码实现还包含UTF-8/XML字符及locale处理规则,以上用例不代表每一种字符边界、运行时locale或目标编译器均已覆盖。现有同步故障注入、宿主回归和资源数据不替代实际主站互操作或真实介质掉电验收;当前没有板端Flash磨损、恢复时延上限、采集接线或硬件计量精度的验收结论。
|
||||
+7
-7
@@ -1,6 +1,6 @@
|
||||
# IEC60870 故障事件信息设计
|
||||
|
||||
本文定义 Type42 `M_FT_NA_1` 的扩展格式编解码,以及通过 Spontaneous 发布故障快照的接入契约。公共接口见 [IEC60870_FaultEvent.h](../../common/IEC60870_FaultEvent.h),104 发布入口见 [IEC104_Spontaneous.h](../../104/business/IEC104_Spontaneous.h)。所有实现和验证范围均限于 IEC60870-Slave。
|
||||
本文定义 Type42 `M_FT_NA_1` 的扩展格式编解码,以及通过 Spontaneous 发布故障快照的接入契约。公共接口见 [IEC60870_FaultEvent.h](../../../App/iec60870/common/IEC60870_FaultEvent.h),104 发布入口见 [IEC104_Spontaneous.h](../../../App/iec60870/104/business/IEC104_Spontaneous.h)。所有实现和验证范围均限于 IEC60870-Slave。
|
||||
|
||||
阅读导航:[协议依据](#fault-event-profile) · [报文布局](#fault-event-wire) · [校验顺序](#fault-event-validation-order) · [时标语义](#fault-event-time) · [内存所有权](#fault-event-ownership) · [模块分工](#fault-event-integration) · [上送流程](#fault-event-publish) · [错误处理](#fault-event-errors) · [资源与验证](#fault-event-validation)。
|
||||
|
||||
@@ -8,7 +8,7 @@
|
||||
|
||||
## 1. 协议依据与兼容范围
|
||||
|
||||
业务依据是项目所附[配电自动化实施细则](../../20170804163032284877151.pdf)的 §7.5、§8.1.6:Type42、COT=3,故障发生时上送对应遥信和故障时刻测量值,内容至少包含三相及零序电压、电流,并早于故障录波数据。该格式属于配电实施细则扩展,不能把它描述成基础 IEC 101/104 已定义的通用 ASDU。
|
||||
业务依据是项目所附`20170804163032284877151.pdf`的 §7.5、§8.1.6:Type42、COT=3,故障发生时上送对应遥信和故障时刻测量值,内容至少包含三相及零序电压、电流,并早于故障录波数据。该格式属于配电实施细则扩展,不能把它描述成基础 IEC 101/104 已定义的通用 ASDU。
|
||||
|
||||
具体线格式依据用户提供的主站接收端解析分析:101、104 均按两组数量、类型及记录解析故障事件,再交给故障事件页面显示。本文记录这份对接约定,不把接收端静态分析结果称作已完成主站实机联调,也不将该扩展格式描述为基础标准强制要求。
|
||||
|
||||
@@ -96,7 +96,7 @@ Parse先确认第二组的数量和类型字节都存在,再读取它们;随
|
||||
|
||||
### 3.2 CP56日历与原文字节的区别
|
||||
|
||||
故障时刻通过 `IEC60870_CP56Time2a_t` 传递,编码器保留日历、毫秒、IV及SU,不做时区换算。IV=1表示时间无效,但不允许用非法日期占位;调用方仍须提供可编码的日历。时标的星期和GEN遵循[公共时间模块](../../common/IEC60870_Time.c)的语义:
|
||||
故障时刻通过 `IEC60870_CP56Time2a_t` 传递,编码器保留日历、毫秒、IV及SU,不做时区换算。IV=1表示时间无效,但不允许用非法日期占位;调用方仍须提供可编码的日历。时标的星期和GEN遵循[公共时间模块](../../../App/iec60870/common/IEC60870_Time.c)的语义:
|
||||
|
||||
| 项目 | 处理方式 |
|
||||
|---|---|
|
||||
@@ -135,8 +135,8 @@ Parse先确认第二组的数量和类型字节都存在,再读取它们;随
|
||||
| 层次 | 负责内容 | 保持的边界 |
|
||||
|---|---|---|
|
||||
| 应用故障捕获 | 故障判据、冻结测量与时标、点表/单位/倍率、等待中的快照和录波开放顺序 | 库不能仅凭IOA证明八项测量的实际含义或同一时刻性 |
|
||||
| [公共FaultEvent](../../common/IEC60870_FaultEvent.c) | 扩展布局、字段校验、完整ASDU编解码及借用视图 | 参数可供101/104共用;公共编解码不等于已接入101上送业务 |
|
||||
| [104 Spontaneous](../../104/business/IEC104_Spontaneous.c) | 站点身份、最少记录、业务地址、固定等级、入队及发布统计 | 复用既有实例和单帧缓冲,不持有WAIT报告 |
|
||||
| [公共FaultEvent](../../../App/iec60870/common/IEC60870_FaultEvent.c) | 扩展布局、字段校验、完整ASDU编解码及借用视图 | 参数可供101/104共用;公共编解码不等于已接入101上送业务 |
|
||||
| [104 Spontaneous](../../../App/iec60870/104/business/IEC104_Spontaneous.c) | 站点身份、最少记录、业务地址、固定等级、入队及发布统计 | 复用既有实例和单帧缓冲,不持有WAIT报告 |
|
||||
| 服务队列与发送层 | 原文副本、启动门禁、下一帧选择、断线恢复、ACK及覆盖回收 | 不从报文反推采集值,不保证掉电持久化或主站界面已显示 |
|
||||
|
||||
<a id="fault-event-data-boundaries"></a>
|
||||
@@ -149,7 +149,7 @@ Parse先确认第二组的数量和类型字节都存在,再读取它们;随
|
||||
|---|---|---|
|
||||
| Type42 故障简报 | 应用在故障时冻结遥信、测量值及 CP56;发布等待不能改用当前值 | 主动上送一份 ASDU;成功只交接原文给 NORMAL,不写历史库 |
|
||||
| [连续采样录波](IEC60870_FaultRecorder_设计架构.md#fault-recording-capture) | 环形缓冲持续接收瞬时采样;故障前后窗口齐全后进入 READY | 生成 CFG/DAT,由应用成对保存并公开;READY 前还不能从录波只读接口取完整记录 |
|
||||
| [历史 SOE](IEC60870_History_设计架构.md#history-design) | 应用在源变位时按点表追加事件,与发送重试及 ACK 分开 | 持久循环保存,按需生成 `HISTORY/SOE/soe.xml`,经 Type210 读取 |
|
||||
| [历史 SOE](IEC60870_History_设计架构.md) | 应用在源变位时按点表追加事件,与发送重试及 ACK 分开 | 持久循环保存,按需生成 `HISTORY/SOE/soe.xml`,经 Type210 读取 |
|
||||
|
||||
简报中的一组故障测量不能还原连续波形,录波缓存中的遥信也不会自动成为历史 SOE。Spontaneous、FaultRecorder 与 History 没有隐式互调;应用须分别交接所需数据。当前历史示例接入普通单点/双点源变位,不把发布成功的 Type42 反向展开为历史事件,避免把网络重试或合成报告误记为新变位。
|
||||
|
||||
@@ -283,7 +283,7 @@ result = IEC104_Spontaneous_Publish_Fault_Event(spontaneous, &report, &info);
|
||||
|
||||
同一宿主配置的单函数栈报告为:故障发布288 B、Encode 128 B、Parse 224 B、两个Getter各80 B。发布复用了现有组帧缓冲;该单函数报告不能通过直接相加替代板端栈分析。
|
||||
|
||||
验证分为公共编解码与104发布两层,分别定位到 [iec60870_fault_event_test.c](../../test/iec60870_fault_event_test.c) 和 [iec104_fault_event_test.c](../../test/iec104_fault_event_test.c)。应覆盖固定预期字节、不同地址宽度、内部类型、负浮点和16位无符号码、每个截断位置、额外尾字节、错误输出不变、业务必需项、站点身份、WAIT原快照重试、固定等级和NORMAL生命周期。
|
||||
验证分为公共编解码与104发布两层,分别定位到 `iec60870_fault_event_test.c` 和 `iec104_fault_event_test.c`。应覆盖固定预期字节、不同地址宽度、内部类型、负浮点和16位无符号码、每个截断位置、额外尾字节、错误输出不变、业务必需项、站点身份、WAIT原快照重试、固定等级和NORMAL生命周期。
|
||||
|
||||
本次专项及完整回归已执行,覆盖249/250字节边界和多遥信后的记录偏移;实际命令、配置数量、沙箱重试过程及通过记录集中在[Type42测试记录](../test/IEC104测试文档.md#fault-event-tests)。
|
||||
|
||||
+13
-11
@@ -1,10 +1,12 @@
|
||||
# 故障录波与 COMTRADE 文件生成
|
||||
|
||||
> **本项目未实现**:本文描述的能力在本仓 `App/iec60870/` 中**没有对应实现**(相关 `.c/.h` 在 2026-11-18 收编时裁除)。保留本文仅作协议能力与技术参考,不要据此判断功能可用;源码快照见 `IEC60870-Slave/`(该目录将来会删除)。
|
||||
|
||||
<a id="fault-recording-overview"></a>
|
||||
|
||||
`IEC60870_FaultRecorder`接收连续瞬时采样和故障采样序号,冻结故障前后波形;`IEC60870_Comtrade`将冻结记录编码为COMTRADE 1999的ASCII配置文件及二进制数据文件。两者没有硬件、RTOS、文件系统、协议传输或堆分配依赖,存储由调用方提供。实现与公开契约分别见[录波核心](../../common/IEC60870_FaultRecorder.c)、[录波头文件](../../common/IEC60870_FaultRecorder.h)、[编码器](../../common/IEC60870_Comtrade.c)、[编码头文件](../../common/IEC60870_Comtrade.h)。
|
||||
`IEC60870_FaultRecorder`接收连续瞬时采样和故障采样序号,冻结故障前后波形;`IEC60870_Comtrade`将冻结记录编码为COMTRADE 1999的ASCII配置文件及二进制数据文件。两者没有硬件、RTOS、文件系统、协议传输或堆分配依赖,存储由调用方提供。实现与公开契约分别见`IEC60870_FaultRecorder.c`、`IEC60870_FaultRecorder.h`、`IEC60870_Comtrade.c`、`IEC60870_Comtrade.h`。
|
||||
|
||||
依据是项目所附[配电自动化实施细则](../../20170804163032284877151.pdf)附录A,PDF第47–48页:故障前不少于4周波、后不少于8周波、不少于80点/周波,包含三相及零序电压、电流和遥信;CFG与DAT成对,放入COMTRADE目录。此处实现格式与采样截取接口,真实传感器数据、故障判据、采样同步、时钟有效性及目标预算由产品接入保证。本次没有接入板级驱动。
|
||||
依据是项目所附`20170804163032284877151.pdf`附录A,PDF第47–48页:故障前不少于4周波、后不少于8周波、不少于80点/周波,包含三相及零序电压、电流和遥信;CFG与DAT成对,放入COMTRADE目录。此处实现格式与采样截取接口,真实传感器数据、故障判据、采样同步、时钟有效性及目标预算由产品接入保证。本次没有接入板级驱动。
|
||||
|
||||
本文是录波采样、编码和应用交接的设计入口;操作命令见[模拟录波示例](../examples/IEC104子站示例.md#example-recording),Type210线格式及主站兼容性见[文件服务设计](../104/IEC104_FileService_设计架构.md#file-service-client-compat),测试矩阵与执行记录统一维护在[录波验证](../test/IEC104测试文档.md#recording-tests)。
|
||||
|
||||
@@ -16,16 +18,16 @@
|
||||
|
||||
| 位置 | 职责 | 输入与输出 |
|
||||
|---|---|---|
|
||||
| [common/IEC60870_FaultRecorder.c](../../common/IEC60870_FaultRecorder.c) | 连续样本校验、环形历史、触发窗口、冻结记录 | 帧及绝对采样序号 → READY记录;不包含故障判据 |
|
||||
| [common/IEC60870_Comtrade.c](../../common/IEC60870_Comtrade.c) | COMTRADE 1999编码及BAY名称生成 | READY记录及元数据 → CFG文本、DAT字节切片;使用公共时间工具 |
|
||||
| [examples/iec104_example_recording.c](../../examples/iec104_example_recording.c) | 单条模拟波形、主机保存和内存读取适配 | 调用方对象 → 一对文件;属于演示应用 |
|
||||
| [examples/iec104_slave_example.c](../../examples/iec104_slave_example.c) | 命令行启用、TI42入队、目录与读回调 | 通过`saved/published`决定文件何时可见 |
|
||||
| [104/business/IEC104_FileService.c](../../104/business/IEC104_FileService.c) | Type210目录会话、文件激活及分段传输 | 借用应用提供的稳定清单和文件内容,不解析COMTRADE |
|
||||
| [104/business/IEC104_Spontaneous.c](../../104/business/IEC104_Spontaneous.c) | Type42故障快照发布与发送调度 | 接收独立故障简报,不从文件反推实时故障 |
|
||||
| `IEC60870_FaultRecorder.c` | 连续样本校验、环形历史、触发窗口、冻结记录 | 帧及绝对采样序号 → READY记录;不包含故障判据 |
|
||||
| `IEC60870_Comtrade.c` | COMTRADE 1999编码及BAY名称生成 | READY记录及元数据 → CFG文本、DAT字节切片;使用公共时间工具 |
|
||||
| `iec104_example_recording.c` | 单条模拟波形、主机保存和内存读取适配 | 调用方对象 → 一对文件;属于演示应用 |
|
||||
| `iec104_slave_example.c` | 命令行启用、TI42入队、目录与读回调 | 通过`saved/published`决定文件何时可见 |
|
||||
| `IEC104_FileService.c` | Type210目录会话、文件激活及分段传输 | 借用应用提供的稳定清单和文件内容,不解析COMTRADE |
|
||||
| [104/business/IEC104_Spontaneous.c](../../../App/iec60870/104/business/IEC104_Spontaneous.c) | Type42故障快照发布与发送调度 | 接收独立故障简报,不从文件反推实时故障 |
|
||||
|
||||
录波核心不依赖编码器;编码器依赖录波只读接口与`IEC60870_Time`;示例应用组合这些公共模块与104业务模块。公共模块可复用到其他传输方式,但这里的文件服务集成和验证仅覆盖104,不能据此认定101文件链路已经完成。
|
||||
|
||||
Type42简报、连续采样录波和持久历史SOE的区别见[三类数据边界](IEC60870_FaultEvent_设计架构.md#fault-event-data-boundaries)。本模块的“历史”指故障前的RAM采样环,与附录B的[历史记录存储](IEC60870_History_设计架构.md#history-design)分别管理;启用历史存储不会自动持久化录波环或恢复COMTRADE目录。
|
||||
Type42简报、连续采样录波和持久历史SOE的区别见[三类数据边界](IEC60870_FaultEvent_设计架构.md#fault-event-data-boundaries)。本模块的“历史”指故障前的RAM采样环,与附录B的[历史记录存储](IEC60870_History_设计架构.md)分别管理;启用历史存储不会自动持久化录波环或恢复COMTRADE目录。
|
||||
|
||||
### 1.2 数据流
|
||||
|
||||
@@ -101,7 +103,7 @@ capacity >= P + 1 + max(Q, Dmax)
|
||||
|
||||
## 3. 录波接口和状态
|
||||
|
||||
以下函数均以前缀`IEC60870_FaultRecorder_`导出;完整参数定义以[头文件](../../common/IEC60870_FaultRecorder.h)为准。
|
||||
以下函数均以前缀`IEC60870_FaultRecorder_`导出;完整参数定义以`IEC60870_FaultRecorder.h`为准。
|
||||
|
||||
| API | 契约 |
|
||||
|---|---|
|
||||
@@ -208,7 +210,7 @@ DAT多字节字段全部小端,每帧依次为4字节采样序号(从1起)
|
||||
|
||||
### 5.1 当前演示时序
|
||||
|
||||
[示例适配](../../examples/iec104_example_recording.h)通过`Example_Recording_Demo`产生确定性的模拟波形:采样序号从0开始,在序号320触发、960完成。示例将这一条记录保持到进程退出,不自动释放或轮换。
|
||||
`iec104_example_recording.h`通过`Example_Recording_Demo`产生确定性的模拟波形:采样序号从0开始,在序号320触发、960完成。示例将这一条记录保持到进程退出,不自动释放或轮换。
|
||||
|
||||
主示例用`--recording-demo existing-directory`启用,并自动开启Type210;命令和联调步骤见[录波示例](../examples/IEC104子站示例.md#example-recording)。示例只生成一次模拟故障,不使用真实采样驱动,也不受普通`--events`模拟变化节拍控制。CFG站名为`SIMULATION`,启动输出明确包含`RECORDING SIMULATED`。
|
||||
|
||||
+11
-11
@@ -1,18 +1,18 @@
|
||||
<a id="firmware-update-design"></a>
|
||||
|
||||
# 持久化软件安装与恢复设计
|
||||
|
||||
> **本项目未实现**:本文描述的能力在本仓 `App/iec60870/` 中**没有对应实现**(相关 `.c/.h` 在 2026-11-18 收编时裁除)。保留本文仅作协议能力与技术参考,不要据此判断功能可用;源码快照见 `IEC60870-Slave/`(该目录将来会删除)。
|
||||
|
||||
`IEC60870_FirmwareUpdate`管理候选接收、安装授权、试运行确认及失败恢复;`IEC104_SoftwareUpgrade`仍只负责211会话和结束确认的ACK。应用在`Take_Restart`成功后把一次性协议授权转为持久安装任务。已收完的文件、END肯定及未确认的END都不能单独触发安装。
|
||||
|
||||
依据为本目录规范PDF的§8.1.12(第39–40页):启动、通过210传文件、结束后短延时重启;保留两个程序版本,旧版以“程序名-1”备份。规范没有定义实际程序名、升级包封装或远程回退命令。本文的工程包、三槽、事务号和健康确认是实现选择,不作为规范原文要求。
|
||||
|
||||
| 层次 | 实现及职责 |
|
||||
|---|---|
|
||||
| 协议会话 | [SoftwareUpgrade](../../104/business/IEC104_SoftwareUpgrade.h):START、END、CANCEL、ABANDON及ACK后授权 |
|
||||
| 文件传输 | [FileService](../../104/business/IEC104_FileService.h):分段、偏移、段校验及最终COMMIT/ABORT |
|
||||
| 通用安装核心 | [FirmwareUpdate.c](../../common/IEC60870_FirmwareUpdate.c)、[头文件](../../common/IEC60870_FirmwareUpdate.h):持久状态、角色轮换、完整性复验和恢复决策 |
|
||||
| Windows介质后端 | [iec104_example_upgrade.c](../../examples/iec104_example_upgrade.c)、[头文件](../../examples/iec104_example_upgrade.h):真实文件、独占存储、持久提交及安装副本 |
|
||||
| 示例应用 | [iec104_slave_example.c](../../examples/iec104_slave_example.c):会话归属、延迟激活、协议重建、宿主文件健康确认、版本读回及阶段日志 |
|
||||
| 协议会话 | `IEC104_SoftwareUpgrade.h`:START、END、CANCEL、ABANDON及ACK后授权 |
|
||||
| 文件传输 | `IEC104_FileService.h`:分段、偏移、段校验及最终COMMIT/ABORT |
|
||||
| 通用安装核心 | `IEC60870_FirmwareUpdate.c`、`IEC60870_FirmwareUpdate.h`:持久状态、角色轮换、完整性复验和恢复决策 |
|
||||
| Windows介质后端 | `iec104_example_upgrade.c`、`iec104_example_upgrade.h`:真实文件、独占存储、持久提交及安装副本 |
|
||||
| 示例应用 | `iec104_slave_example.c`:会话归属、延迟激活、协议重建、宿主文件健康确认、版本读回及阶段日志 |
|
||||
|
||||
宿主模式真实保存、安装和恢复负载文件,不加载或执行负载,不刷写MCU,也不把协议重建等同于新固件已运行。目标Flash、复位与Bootloader调用时点见[板端接入](#firmware-update-target)。默认RAM演示和持久模式分别启用。
|
||||
|
||||
@@ -72,7 +72,7 @@ EMPTY要求事务号为0、三个角色均为255、所有描述全零。其余
|
||||
|
||||
## 2. 核心接口和错误契约
|
||||
|
||||
调用方持有`IEC60870_FirmwareUpdate_t`和后端context,所有操作串行。核心不分配堆、不创建任务、不依赖文件系统和协议库。完整参数及输出保持规则以[公开头](../../common/IEC60870_FirmwareUpdate.h)为准。
|
||||
调用方持有`IEC60870_FirmwareUpdate_t`和后端context,所有操作串行。核心不分配堆、不创建任务、不依赖文件系统和协议库。完整参数及输出保持规则以`IEC60870_FirmwareUpdate.h`为准。
|
||||
|
||||
| 接口(省略`IEC60870_FirmwareUpdate_`) | 约束与结果 |
|
||||
|---|---|
|
||||
@@ -193,7 +193,7 @@ validate也会检查current和已有backup,不能用“版本必须高于curre
|
||||
|
||||
### 3.3 宿主门面与生命周期
|
||||
|
||||
完整声明及参数见[宿主头文件](../../examples/iec104_example_upgrade.h)。下表省略`Example_Upgrade_Store_`,除Close为void外都返回bool;描述输出按值返回,失败保持输出。
|
||||
完整声明及参数见`iec104_example_upgrade.h`。下表省略`Example_Upgrade_Store_`,除Close为void外都返回bool;描述输出按值返回,失败保持输出。
|
||||
|
||||
| 接口 | 状态、所有权和失败边界 |
|
||||
|---|---|
|
||||
@@ -264,7 +264,7 @@ Close不是协议收尾替代品。外层先按原文件handle、owner及transfe
|
||||
|
||||
使用既有I104工程包:ASCII `I104`、u32le版本、u32le负载长度、u32le负载CRC32,随后非空负载。CRC算法和报文顺序见[工程包契约](../104/IEC104_SoftwareUpgrade_设计架构.md#software-upgrade-package)。文件名仍为`upgrade.bin`;安装目标名`dtu`是本宿主后端约定。
|
||||
|
||||
打包、首次建库、重复启动、线上操作及版本核对的完整命令集中在[持久安装操作入口](../examples/IEC104子站示例.md#example-firmware-update),工具实现为[make_upgrade_package.cjs](../../scripts/make_upgrade_package.cjs)。`--upgrade-store`自动开启210/211,首次显式seed与后续禁止seed覆盖的规则由后端落实,不是仅靠CLI提示约束。
|
||||
打包、首次建库、重复启动、线上操作及版本核对的完整命令集中在[持久安装操作入口](../examples/IEC104子站示例.md#example-firmware-update),工具实现为`make_upgrade_package.cjs`。`--upgrade-store`自动开启210/211,首次显式seed与后续禁止seed覆盖的规则由后端落实,不是仅靠CLI提示约束。
|
||||
|
||||
202的0x8005/0x8006来自已确认描述,不能把传输包、END肯定或TRIAL中的dtu提前发布为确认版本。配合`--user-log`时,持久模式阶段标为`HOST_FILE`,原RAM演示为`SIMULATED`;阶段记录只表达该动作已发生,不扩大健康检查的证明范围。
|
||||
|
||||
@@ -286,4 +286,4 @@ Flash分区、应用链接地址、向量表切换、掉电时存储行为、看
|
||||
|
||||
构建命令、场景映射和实际运行结果集中在[持久升级测试记录](../test/IEC104测试文档.md#firmware-update-tests),协议及原RAM演示另见[软件升级测试](../test/IEC104测试文档.md#software-upgrade-tests)。本设计不复制运行数量和产物结论。
|
||||
|
||||
验证分为三层:[核心夹具](../../test/iec60870_firmware_update_test.c)以可跨Init保留的内存介质检查状态及提交前后失败;[Windows后端测试](../../test/iec104_example_upgrade_test.c)使用实际文件及同步/替换后的故障钩子;[TCP回环](../../test/firmware_update_loopback_test.cjs)独立构造报文和CRC,核对线上授权与实际安装内容。夹具不证明文件系统行为,故障钩子不等于切断供电,宿主负载从不执行;这些验证不能代替目标ARMCC、Flash、Bootloader及硬件健康确认验收。
|
||||
验证分为三层:`iec60870_firmware_update_test.c`以可跨Init保留的内存介质检查状态及提交前后失败;`iec104_example_upgrade_test.c`使用实际文件及同步/替换后的故障钩子;`firmware_update_loopback_test.cjs`独立构造报文和CRC,核对线上授权与实际安装内容。夹具不证明文件系统行为,故障钩子不等于切断供电,宿主负载从不执行;这些验证不能代替目标ARMCC、Flash、Bootloader及硬件健康确认验收。
|
||||
+14
-14
@@ -1,20 +1,20 @@
|
||||
<a id="history-design"></a>
|
||||
|
||||
# 历史记录、持久存储与 XML 文件生成
|
||||
|
||||
本模块实现[规范 PDF](../../20170804163032284877151.pdf)附录 B 的 SOE、遥控操作、定点和极值记录。循环记录与 XML 编码可移植;示例通过 Windows 文件后端提供持久化,再由现有 TI=210 文件服务提供目录和下载。FRZ、FLOWREV 与附录 C 的 ULOG 不在本模块范围内。
|
||||
> **本项目未实现**:本文描述的能力在本仓 `App/iec60870/` 中**没有对应实现**(相关 `.c/.h` 在 2026-11-18 收编时裁除)。保留本文仅作协议能力与技术参考,不要据此判断功能可用;源码快照见 `IEC60870-Slave/`(该目录将来会删除)。
|
||||
|
||||
ULOG由独立的[运行日志模块](IEC60870_UserLog_设计架构.md#user-log-design)实现1024条循环及XML,示例通过`--user-log`启用并使用`ulog.store`;可与`--history`共用父目录,但不共用核心实例、槽布局或持久文件。
|
||||
本模块实现`20170804163032284877151.pdf`附录 B 的 SOE、遥控操作、定点和极值记录。循环记录与 XML 编码可移植;示例通过 Windows 文件后端提供持久化,再由现有 TI=210 文件服务提供目录和下载。FRZ、FLOWREV 与附录 C 的 ULOG 不在本模块范围内。
|
||||
|
||||
ULOG由独立的[运行日志模块](IEC60870_UserLog_设计架构.md)实现1024条循环及XML,示例通过`--user-log`启用并使用`ulog.store`;可与`--history`共用父目录,但不共用核心实例、槽布局或持久文件。
|
||||
|
||||
## 1. 模块边界
|
||||
|
||||
| 实现 | 职责 |
|
||||
|---|---|
|
||||
| [IEC60870_History.h](../../common/IEC60870_History.h)、[核心实现](../../common/IEC60870_History.c) | 点表校验、固定容量记录、UTC+8 日归属、极值累计、序列化、CRC 与启动恢复 |
|
||||
| [IEC60870_HistoryFile.h](../../common/IEC60870_HistoryFile.h)、[XML 编码](../../common/IEC60870_HistoryFile.c) | 附录 B.3.2 的四种 XML、大小写敏感文件名、分块输出与导出范围 |
|
||||
| [宿主适配接口](../../examples/iec104_example_history.h)、[Windows 后端](../../examples/iec104_example_history.c) | 双副本原子提交、独占文件、目录快照、稳定读文件 |
|
||||
| [子站示例](../../examples/iec104_slave_example.c) | 记录来源、墙钟基准、命令行选项及 FileService 回调接线 |
|
||||
| [FileService](../../104/business/IEC104_FileService.h) | TI=210 协议、目录时间筛选、分段传输、会话收尾 |
|
||||
| `IEC60870_History.h`、`IEC60870_History.c` | 点表校验、固定容量记录、UTC+8 日归属、极值累计、序列化、CRC 与启动恢复 |
|
||||
| `IEC60870_HistoryFile.h`、`IEC60870_HistoryFile.c` | 附录 B.3.2 的四种 XML、大小写敏感文件名、分块输出与导出范围 |
|
||||
| `iec104_example_history.h`、`iec104_example_history.c` | 双副本原子提交、独占文件、目录快照、稳定读文件 |
|
||||
| `iec104_slave_example.c` | 记录来源、墙钟基准、命令行选项及 FileService 回调接线 |
|
||||
| `IEC104_FileService.h` | TI=210 协议、目录时间筛选、分段传输、会话收尾 |
|
||||
|
||||
```mermaid
|
||||
flowchart LR
|
||||
@@ -89,7 +89,7 @@ flowchart LR
|
||||
|
||||
### 3.2 API、返回值与调用次序
|
||||
|
||||
下表省略函数名前缀 `IEC60870_History_`。参数校验、输出保持和所有权的完整声明见[核心头文件](../../common/IEC60870_History.h)。
|
||||
下表省略函数名前缀 `IEC60870_History_`。参数校验、输出保持和所有权的完整声明见`IEC60870_History.h`。
|
||||
|
||||
| 接口 | 输入与输出 | 关键失败或边界 |
|
||||
|---|---|---|
|
||||
@@ -315,13 +315,13 @@ Windows示例使用同步文件 I/O:极值变化可能执行三次同步,目
|
||||
|
||||
## 7. 验证入口与范围
|
||||
|
||||
`-Suite History` 注册于[构建脚本](../../scripts/build.ps1),包括:
|
||||
`-Suite History` 注册于`build.ps1`,包括:
|
||||
|
||||
| 测试 | 主要覆盖 |
|
||||
|---|---|
|
||||
| [核心测试](../../test/iec60870_history_test.c) | 1024/30条覆盖、提交前后失败恢复、96节与午夜、缺测与品质、32日轮转、32点、时间范围与迟到记录拒绝 |
|
||||
| [XML测试](../../test/iec60870_history_file_test.c) | 四类结构、实际条数、最新30完成日、第96节24:00、属性转义、UTF-8、输出失败与路径 |
|
||||
| [宿主后端测试](../../test/iec104_example_history_test.c) | bank同步边界中断、重开、损坏副本、30日目录、不可变下载快照 |
|
||||
| `iec60870_history_test.c` | 1024/30条覆盖、提交前后失败恢复、96节与午夜、缺测与品质、32日轮转、32点、时间范围与迟到记录拒绝 |
|
||||
| `iec60870_history_file_test.c` | 四类结构、实际条数、最新30完成日、第96节24:00、属性转义、UTF-8、输出失败与路径 |
|
||||
| `iec104_example_history_test.c` | bank同步边界中断、重开、损坏副本、30日目录、不可变下载快照 |
|
||||
|
||||
核心与XML专项使用 C99、`-pedantic -Wall -Wextra -Werror`。XML测试可接收已有输出目录参数,生成四类样本用于独立解析器检查;`.build/history-xml/`的一轮样本已使用.NET XML解析器核对1024条SOE、30条遥控、96节定点以及极值。
|
||||
|
||||
+1
-1
@@ -323,7 +323,7 @@ CP24的跨小时例子:接收时刻为可信的`2026-11-07 10:00:02`,短时
|
||||
|
||||
排查转换失败时先检查返回值,再观察输出;本模块失败保持旧输出,继续使用上一次成功日历会掩盖输入错误。对“解码成功但不能用作有效时间”的情况,保留原IV及原字节供诊断,再按业务策略拒绝校时或记录无效事件,不修改标志来强行通过转换。CP56字段规则仍以[接收策略](#cp56-reception-policy)为准。
|
||||
|
||||
已有回归入口为[公共扩展测试](../../test/iec60870_asdu_extended_test.c)的`test_short_times`(CP16/CP24边界及失败输出保持)、[公共ASDU测试](../../test/iec60870_asdu_test.c)的`test_cp56_reception`,以及[业务集成测试](../../test/iec104_slave_example_test.c)的`test_clock_timezone_rollover`和`test_clock_time_errors`。这些用例不提供CP24日期重建或目标RTC质量的验收;新增数据源仍须验证其时间基准和读取一致性。
|
||||
已有回归入口为`iec60870_asdu_extended_test.c`的`test_short_times`(CP16/CP24边界及失败输出保持)、`iec60870_asdu_test.c`的`test_cp56_reception`,以及`iec104_slave_example_test.c`的`test_clock_timezone_rollover`和`test_clock_time_errors`。这些用例不提供CP24日期重建或目标RTC质量的验收;新增数据源仍须验证其时间基准和读取一致性。
|
||||
|
||||
## 与原代码草案的差异
|
||||
|
||||
+10
-10
@@ -1,17 +1,17 @@
|
||||
<a id="user-log-design"></a>
|
||||
|
||||
# 附录 C 运行日志设计
|
||||
|
||||
> **本项目未实现**:本文描述的能力在本仓 `App/iec60870/` 中**没有对应实现**(相关 `.c/.h` 在 2026-11-18 收编时裁除)。保留本文仅作协议能力与技术参考,不要据此判断功能可用;源码快照见 `IEC60870-Slave/`(该目录将来会删除)。
|
||||
|
||||
`IEC60870_UserLog`保存最近1024条日志,`IEC60870_UserLogFile`生成`HISTORY/ULOG/ulog.xml`,应用通过Type210文件服务提供远程调阅。日志按持久提交序号排列,墙钟回拨不重排记录。核心、XML和宿主后端分别负责记录语义、文件编码及介质原子性;它们与附录B的SOE/遥控/定点/极值使用独立实例和存储。
|
||||
|
||||
规范依据为附录C的C.1、表C.1及C.2.2(PDF第60–61页):至少循环保存、上送最新1024条日志。掉电保存依据附录B.1 a)的历史数据要求及表B.1中的ULOG目录,附录C没有另行重述这一条。当前选择XML格式,不生成MSG;未满容量按实际条数输出,空库可以生成`num="0"`。
|
||||
|
||||
| 层次 | 实现与责任 |
|
||||
|---|---|
|
||||
| 公共记录核心 | [UserLog.c](../../common/IEC60870_UserLog.c)、[UserLog.h](../../common/IEC60870_UserLog.h):输入校验、循环序号、小端编码、CRC、恢复与查询 |
|
||||
| 公共XML编码 | [UserLogFile.c](../../common/IEC60870_UserLogFile.c)、[UserLogFile.h](../../common/IEC60870_UserLogFile.h):固定字段、转义、时标转换、同步分片输出;依赖公共Time |
|
||||
| Windows持久后端 | [iec104_example_user_log.c](../../examples/iec104_example_user_log.c)、[头文件](../../examples/iec104_example_user_log.h):独占文件、双bank提交、目录缓存和独立下载快照 |
|
||||
| 示例应用 | [iec104_slave_example.c](../../examples/iec104_slave_example.c):识别实际事实、维护来源状态、转换发生时刻、处理存储失败及Type210路由 |
|
||||
| 公共记录核心 | `IEC60870_UserLog.c`、`IEC60870_UserLog.h`:输入校验、循环序号、小端编码、CRC、恢复与查询 |
|
||||
| 公共XML编码 | `IEC60870_UserLogFile.c`、`IEC60870_UserLogFile.h`:固定字段、转义、时标转换、同步分片输出;依赖公共Time |
|
||||
| Windows持久后端 | `iec104_example_user_log.c`、`iec104_example_user_log.h`:独占文件、双bank提交、目录缓存和独立下载快照 |
|
||||
| 示例应用 | `iec104_slave_example.c`:识别实际事实、维护来源状态、转换发生时刻、处理存储失败及Type210路由 |
|
||||
|
||||
## 1. 类型与记录触发
|
||||
|
||||
@@ -172,7 +172,7 @@ Read_Open只接受完整固定路径,有目录缓存时复制该缓存,否
|
||||
|
||||
### 5.1 宿主接口与资源所有权
|
||||
|
||||
[宿主头文件](../../examples/iec104_example_user_log.h)公开9个接口,下表省略`Example_User_Log_`前缀。调用方提供首次全零的对象并串行使用;成功Open后`core.store.context`指回self,直到Close及所有使用结束前,整个对象地址必须稳定,不能按值复制或移动。parent和device_id在成功打开后存为对象内副本,线上名称按显式length比较、不要求NUL,也不直接拼接成宿主路径。
|
||||
`iec104_example_user_log.h`公开9个接口,下表省略`Example_User_Log_`前缀。调用方提供首次全零的对象并串行使用;成功Open后`core.store.context`指回self,直到Close及所有使用结束前,整个对象地址必须稳定,不能按值复制或移动。parent和device_id在成功打开后存为对象内副本,线上名称按显式length比较、不要求NUL,也不直接拼接成宿主路径。
|
||||
|
||||
| 接口 | 成功结果与借用 | 拒绝、失败和关闭边界 |
|
||||
|---|---|---|
|
||||
@@ -246,8 +246,8 @@ FileService的目录/读取打开路径只把后端false转换成文件请求拒
|
||||
|
||||
| 已运行的验证 | 覆盖与结果 |
|
||||
|---|---|
|
||||
| [公共核心单测](../../test/iec60870_user_log_test.c) | 严格C99、pedantic、Werror编译;6组通过:1025条循环/重启、全部类型和值、128字节ASCII、时标边界/回拨、提交前后失败、损坏/缺口及序号耗尽 |
|
||||
| [XML单测](../../test/iec60870_user_log_file_test.c) | 同等严格编译;4组通过:固定字段、实际条数、转义、时间两端、循环顺序、每个sink片段失败及存储读取失败 |
|
||||
| [宿主后端测试](../../test/iec104_example_user_log_test.c) | 严格C99、pedantic、Werror编译并通过:三次同步后的中断、实文件CRC损坏/截断、单/双bank、独占/重开、缓存与独立下载、历史存储隔离 |
|
||||
| `iec60870_user_log_test.c` | 严格C99、pedantic、Werror编译;6组通过:1025条循环/重启、全部类型和值、128字节ASCII、时标边界/回拨、提交前后失败、损坏/缺口及序号耗尽 |
|
||||
| `iec60870_user_log_file_test.c` | 同等严格编译;4组通过:固定字段、实际条数、转义、时间两端、循环顺序、每个sink片段失败及存储读取失败 |
|
||||
| `iec104_example_user_log_test.c` | 严格C99、pedantic、Werror编译并通过:三次同步后的中断、实文件CRC损坏/截断、单/双bank、独占/重开、缓存与独立下载、历史存储隔离 |
|
||||
|
||||
应用集成及真实TCP结果以测试文档最新实跑记录为准;这里不以已写测试或接口编译代替通过证据。04..09硬件来源和真实掉电验收尚不由上述主机测试证明。
|
||||
@@ -1,6 +1,6 @@
|
||||
# DTU 运行模型
|
||||
|
||||
本文定义 Windows DTU 示例采用的可测试仿真契约。入口与协议操作见 [DTU 配置演示](DTU配置演示.md)。实现位于 [测量模块](../../examples/iec104_dtu_measurement.c)、[保护状态机](../../examples/iec104_dtu_protection.c)、[运行适配](../../examples/iec104_dtu_runtime.inc) 和 [共享示例](../../examples/iec104_slave_example.c)。这些行为用于主站联调,不代表原设备厂家的保护算法、物理接线或实机验收结论。
|
||||
本文定义 Windows DTU 示例采用的可测试仿真契约。入口与协议操作见 [DTU 配置演示](DTU配置演示.md)。实现位于 `iec104_dtu_measurement.c`、`iec104_dtu_protection.c`、`iec104_dtu_runtime.inc` 和 `iec104_slave_example.c`。这些行为用于主站联调,不代表原设备厂家的保护算法、物理接线或实机验收结论。
|
||||
|
||||
**参数可读、可写、可保存,与其业务行为已实现是不同事实。** 源表保留 430 项,其中 345 项有值,85 项未配置。点表映射仍为只读;公共运行参数、动作参数、41 项遥测倍率和 93 项遥信取反可按协议修改。源空项不会因为示例增加了运行点就成为已配置项。
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# DTU 配置演示
|
||||
|
||||
本例使用目录 `DTU(100V1A 100V1A)` 中的 XML 设定建立 Windows IEC 104 子站。入口 [iec104_dtu_example.c](../../examples/iec104_dtu_example.c) 复用 [通用示例](IEC104子站示例.md) 的完整应用流程,并通过 [静态配置表](../../examples/iec104_dtu_profile.h) 提供 DTU 点表和初始定值。全部演示服务均可在同一入口启用;原 XML 作为只读配置来源。
|
||||
本例使用目录 `DTU(100V1A 100V1A)` 中的 XML 设定建立 Windows IEC 104 子站。入口 `iec104_dtu_example.c` 复用 [通用示例](IEC104子站示例.md) 的完整应用流程,并通过 [静态配置表](../../../App/iec60870/104/iec104_dtu_profile.h) 提供 DTU 点表和初始定值。全部演示服务均可在同一入口启用;原 XML 作为只读配置来源。
|
||||
|
||||
参数对应的测量、保护、分合闸和触发录波,以及逐项实现边界,见 [DTU 运行模型](DTU运行模型.md)。原配置缺少 FA 枚举、组合遥信公式和硬加密接口;这些缺项尚不能按原设备完成,不能将可读写的定值数量当作功能完成数量。
|
||||
|
||||
@@ -171,7 +171,7 @@ New-Item -ItemType Directory -Force .build/dtu-demo
|
||||
| `0x0040` | 1#PT 过压告警 | 正常初值为 0 |
|
||||
| `0x0041` | 00 开关过负荷告警 | 保留映射 |
|
||||
|
||||
其余遥信名称和映射见 [静态点表](../../examples/iec104_dtu_profile.h) 及 [源遥信配置](<../../DTU(100V1A 100V1A)/参数配置/点表参数/01_遥信点表参数.xml>)。初始健康状态是示例选择,不是原文件测得的状态。
|
||||
其余遥信名称和映射见 [静态点表](../../../App/iec60870/104/iec104_dtu_profile.h) 及 [源遥信配置](<../../DTU(100V1A 100V1A)/参数配置/点表参数/01_遥信点表参数.xml>)。初始健康状态是示例选择,不是原文件测得的状态。
|
||||
|
||||
19 个已配置遥控保持原 IOA:
|
||||
|
||||
@@ -264,7 +264,7 @@ DTU 的 field 模式每拍按初值和当前工况重新生成遥测,遥调写
|
||||
|
||||
多帧预置的中间帧 PI=`0x81`,最后一帧 PI=`0x80`;类型不符、未配置项、只读项及越界值会被拒绝。
|
||||
|
||||
固化校验各区“检有压 ≥ 检无压 ≥ 检残压”和公共“低电压 ≤ 过电压”等关系。值域见[定值校验实现](../../examples/iec104_dtu_settings.c),TLV 格式见[远程参数设计](../104/IEC104_RemoteParameter_设计架构.md)。
|
||||
固化校验各区“检有压 ≥ 检无压 ≥ 检残压”和公共“低电压 ≤ 过电压”等关系。值域见`iec104_dtu_settings.c`,TLV 格式见[远程参数设计](../104/IEC104_RemoteParameter_设计架构.md)。
|
||||
|
||||
预置不能跨连接延续。撤销或断连会丢弃暂存;应用校验或保存失败后,须由原归属先发 COT=8 撤销,再开始新预置。分段未收完便提前固化只被协议拒绝,暂存仍保留,可继续剩余分段。
|
||||
|
||||
@@ -320,16 +320,16 @@ DTU 是共享示例的编译期配置。两个 EXE 共用协议业务实现,
|
||||
|
||||
| 源文件 | 职责与修改入口 |
|
||||
|---|---|
|
||||
| [iec104_dtu_example.c](../../examples/iec104_dtu_example.c) | DTU 入口,定义模式并直接包含共享实现;不要再把 `iec104_slave_example.c` 单独链接到同一目标 |
|
||||
| [iec104_dtu_profile.h](../../examples/iec104_dtu_profile.h) | 只读 XML 快照、稀疏三遥映射和演示遥测初值;变更映射时同时核对 `source_addr`、业务 IOA 和补充地址 |
|
||||
| [iec104_dtu_settings.h](../../examples/iec104_dtu_settings.h) / [iec104_dtu_settings.c](../../examples/iec104_dtu_settings.c) | 五区已提交值、单区预置副本、地址查询、可见性、权限和数值校验 |
|
||||
| [iec104_dtu_settings.inc](../../examples/iec104_dtu_settings.inc) | Type200–203 应用回调,负责读取、事务身份、预置、固化及切区 |
|
||||
| [iec104_dtu_runtime.inc](../../examples/iec104_dtu_runtime.inc) | 输入注入、积分、测量/保护接线、防抖/取反、活化和触发录波 |
|
||||
| [iec104_dtu_measurement.c](../../examples/iec104_dtu_measurement.c) | 41 路测量换算、倍率、零漂及死区 |
|
||||
| [iec104_dtu_protection.c](../../examples/iec104_dtu_protection.c) | 二次量判据、保持、闭锁、加速、分闸与重合状态机 |
|
||||
| [iec104_slave_example.c](../../examples/iec104_slave_example.c) | 共享 `ExampleApp`、初始化、业务调度、遥控反馈、测量处理、启动门禁和资源清理 |
|
||||
| [iec104_example_config.c](../../examples/iec104_example_config.c) | 统一 INI 快照的校验、加载和原子保存 |
|
||||
| [build.ps1](../../scripts/build.ps1) | 同时构建通用与 DTU 目标;为 DTU 入口及配置、录波、计量等适配源统一传入模式宏 |
|
||||
| `iec104_dtu_example.c` | DTU 入口,定义模式并直接包含共享实现;不要再把 `iec104_slave_example.c` 单独链接到同一目标 |
|
||||
| [iec104_dtu_profile.h](../../../App/iec60870/104/iec104_dtu_profile.h) | 只读 XML 快照、稀疏三遥映射和演示遥测初值;变更映射时同时核对 `source_addr`、业务 IOA 和补充地址 |
|
||||
| `iec104_dtu_settings.h` / `iec104_dtu_settings.c` | 五区已提交值、单区预置副本、地址查询、可见性、权限和数值校验 |
|
||||
| `iec104_dtu_settings.inc` | Type200–203 应用回调,负责读取、事务身份、预置、固化及切区 |
|
||||
| `iec104_dtu_runtime.inc` | 输入注入、积分、测量/保护接线、防抖/取反、活化和触发录波 |
|
||||
| `iec104_dtu_measurement.c` | 41 路测量换算、倍率、零漂及死区 |
|
||||
| `iec104_dtu_protection.c` | 二次量判据、保持、闭锁、加速、分闸与重合状态机 |
|
||||
| `iec104_slave_example.c` | 共享 `ExampleApp`、初始化、业务调度、遥控反馈、测量处理、启动门禁和资源清理 |
|
||||
| `iec104_example_config.c` | 统一 INI 快照的校验、加载和原子保存 |
|
||||
| `build.ps1` | 同时构建通用与 DTU 目标;为 DTU 入口及配置、录波、计量等适配源统一传入模式宏 |
|
||||
|
||||
`.inc` 随共享引擎包含,不独立编译;所有适配源文件须使用同一 DTU 宏。采样先累计上一拍电量,再更新测量和告警;遥信按点表下标暂存最新值与变位时刻,同一点排队前的多次变位会合并。共享调度及启动门禁见[通用示例启动流程](IEC104子站示例.md#example-startup-replay)。
|
||||
|
||||
@@ -352,4 +352,3 @@ DTU 是共享示例的编译期配置。两个 EXE 共用协议业务实现,
|
||||
| 切区或固化被否定 | 检查未结束预置、连接/区号、TLV 类型及数值关系;应用校验或保存失败后先撤销解除恢复屏障。保存失败还会打印 `REMOTE_CONFIG save failed` |
|
||||
| 遥调值很快恢复 | field 下一拍重新生成模拟值;使用 `--events 0` 核对遥调回读 |
|
||||
| 目录为空或初始化失败 | 确认宿主父目录存在、服务已开启;日文件须完整封存后可见;配置错误先检查文件,勿用默认值覆盖 |
|
||||
|
||||
@@ -4,7 +4,7 @@
|
||||
|
||||
主示例显式启用`strict_business_priority=1`,按[12级业务优先级](../104/IEC104_业务优先级设计.md)准备及发送业务。`Example_Step_Strict`先推进维护,再按等级提交候选;已开始发送的完整帧继续完成,业务自身确认、数据和结束顺序保持。
|
||||
|
||||
[iec104_slave_example.c](../../examples/iec104_slave_example.c) 包含模拟点表、业务事件处理、其他命令兜底、事件循环及main。总召状态机使用独立库模块[IEC104_Interrogation.c/h](../../104/business/IEC104_Interrogation.h),不在示例内重复实现。
|
||||
`iec104_slave_example.c` 包含模拟点表、业务事件处理、其他命令兜底、事件循环及main。总召状态机使用独立库模块[IEC104_Interrogation.c/h](../../../App/iec60870/104/business/IEC104_Interrogation.h),不在示例内重复实现。
|
||||
|
||||
源码按“公共声明 → 应用测量处理 → 各业务连续实现区 → 跨业务编排 → CLI/main”组织,开头提供可搜索的方括号导航。`MEASUREMENT`集中原始输入、滤波、量程品质及变化基准处理;业务区依次为`SPONTANEOUS`、`GI`、`CI`、`CLOCK`、`COMMAND`、`READ`、`PARAMETER`、`REMOTE_PARAMETER`、`SOFTWARE_UPGRADE`、`FILE_SERVICE`、`PERIODIC_SCAN`、`SYSTEM_COMMAND`,各自集中专属初始化、取值/动作、事件消费和步进函数。`COMMON`保留共用点表、`ExampleApp`、必需模块创建及失败回退、通知分派、等待时间、主循环和生命周期;`ExampleApp`字段用`STATE`标明所属业务。函数定义按模块归拢,实际执行先后仍以`Example_Step`和`main`为准。
|
||||
|
||||
@@ -171,7 +171,7 @@ Begin成功后,无论正常完成、业务失败还是已领取重启授权,
|
||||
|
||||
### 地址分区与公共点表
|
||||
|
||||
示例按实施细则表8分配实际IOA,地址集中在[iec104_example_points.h](../../examples/iec104_example_points.h)。下表带`0x`的数值均为十六进制;主站要求十进制时须换算,例如0x4001=16385、0x6001=24577、0x6401=25601、0x8601=34305。原来的十进制遥测2001实际是0x07D1,不能靠改变显示进制进入遥测分区。规范依据及库与示例的职责边界见[实施细则适配设计](../104/IEC104_设计架构.md#spec-alignment-design)。
|
||||
示例按实施细则表8分配实际IOA,地址集中在`iec104_example_points.h`。下表带`0x`的数值均为十六进制;主站要求十进制时须换算,例如0x4001=16385、0x6001=24577、0x6401=25601、0x8601=34305。原来的十进制遥测2001实际是0x07D1,不能靠改变显示进制进入遥测分区。规范依据及库与示例的职责边界见[实施细则适配设计](../104/IEC104_设计架构.md#spec-alignment-design)。
|
||||
|
||||
| 类别 | 当前示例范围(十六进制) | 表8分区 |
|
||||
|---|---|---|
|
||||
@@ -191,7 +191,7 @@ Begin成功后,无论正常完成、业务失败还是已领取重启授权,
|
||||
|---|---|
|
||||
| 主示例监视及测量链 | 初值表、总召、Read、普通变化、周期/背景、命令目标和返回信息共用地址与索引;Type42故障值中的遥测也取同一测量表 |
|
||||
| 主示例专用业务 | Type101四种电能量表示共用`EXAMPLE_IOA_COUNTER_BASE`;History的SOE、CO及模拟量白名单由运行点表生成;标准参数及QPA3分别使用参数IOA和测量IOA |
|
||||
| 配置与双主站示例 | [配置实现](../../examples/iec104_example_config.c)使用宏说明参数对应测量点,并按调用方当前点表校验数值IOA;[双主站示例](../../examples/iec104_parameter_multi_master.c)按同一参数基址、步长生成32点 |
|
||||
| 配置与双主站示例 | `iec104_example_config.c`使用宏说明参数对应测量点,并按调用方当前点表校验数值IOA;`iec104_parameter_multi_master.c`按同一参数基址、步长生成32点 |
|
||||
| 主站配置、回环测试和已存文件 | 按当前表核对报文中的实际地址;它们不会因C宏修改自动改写,INI及历史存储的处理见[点表迁移](#example-point-migration) |
|
||||
|
||||
<a id="example-signal-time"></a>
|
||||
@@ -417,7 +417,7 @@ New-Item -ItemType Directory -Path .build/recording-demo -Force
|
||||
|
||||
主站完成本轮启动同步后,读取COMTRADE目录,将返回的`COMTRADE/BAY01_0001_...cfg`和`.dat`名称原样作为op3文件名,下载并保存到同一目录,再用查看器打开CFG。主站请求可携带目录ID6,终端仍按目录名称匹配,并按默认ZERO配置发ID0,不要求回显客户端的目录编号。应比较下载文件与本地导出的全部字节,并用独立解析器核对窗口、通道和时标;客户端的成功界面或op6结果0不能替代这些检查。
|
||||
|
||||
实现位于[录波示例适配](../../examples/iec104_example_recording.c)。保存采用暂存和两次改名,网络读取来自冻结RAM记录,不做磁盘I/O。它不提供持久目录索引、重启加载旧录波、持续多记录采集、跨进程并发发布或物理掉电事务;`--config`不保存录波,磁盘文件存在也不表示下次启动会重新列出它。完整API、内存及生命周期见[故障录波设计](../common/IEC60870_FaultRecorder_设计架构.md),当前演示与真实故障时序的区别见[接入流程](../common/IEC60870_FaultRecorder_设计架构.md#fault-recording-integration),实际采样和存储交接见[产品接入要求](../common/IEC60870_FaultRecorder_设计架构.md#fault-recording-product)。验证入口及证据范围见[录波测试](../test/IEC104测试文档.md#recording-tests),接收端静态分析及待实测边界见[互操作说明](../104/IEC104_FileService_设计架构.md#file-service-client-compat)。
|
||||
实现位于`iec104_example_recording.c`。保存采用暂存和两次改名,网络读取来自冻结RAM记录,不做磁盘I/O。它不提供持久目录索引、重启加载旧录波、持续多记录采集、跨进程并发发布或物理掉电事务;`--config`不保存录波,磁盘文件存在也不表示下次启动会重新列出它。完整API、内存及生命周期见[故障录波设计](../common/IEC60870_FaultRecorder_设计架构.md),当前演示与真实故障时序的区别见[接入流程](../common/IEC60870_FaultRecorder_设计架构.md#fault-recording-integration),实际采样和存储交接见[产品接入要求](../common/IEC60870_FaultRecorder_设计架构.md#fault-recording-product)。验证入口及证据范围见[录波测试](../test/IEC104测试文档.md#recording-tests),接收端静态分析及待实测边界见[互操作说明](../104/IEC104_FileService_设计架构.md#file-service-client-compat)。
|
||||
|
||||
<a id="example-storage-lifecycle"></a>
|
||||
|
||||
@@ -483,7 +483,7 @@ FRZ=1冻结值和时刻,并将整数BCR序号模32加一;FRZ=2冻结后将
|
||||
|
||||
#### 206/207的数据区与函数分工
|
||||
|
||||
实现位于[主示例源码](../../examples/iec104_slave_example.c)的`[CI/INIT]`、`[CI/DATA]`段。协议类型、QCC与发送校验规则集中在[浮点累计量设计](../104/IEC104_CounterInterrogation_设计架构.md#ci-float-energy-design);这里说明应用如何提供一轮稳定数据。
|
||||
实现位于`iec104_slave_example.c`的`[CI/INIT]`、`[CI/DATA]`段。协议类型、QCC与发送校验规则集中在[浮点累计量设计](../104/IEC104_CounterInterrogation_设计架构.md#ci-float-energy-design);这里说明应用如何提供一轮稳定数据。
|
||||
|
||||
| 数据区 | 所有者与用途 | 更新时机 |
|
||||
|---|---|---|
|
||||
@@ -664,7 +664,7 @@ QPA3按测量值IOA0x4001..0x4008寻址;与参数IOA不同。参数处理开
|
||||
|
||||
不指定`--config`时不读写配置文件,保持纯内存行为。指定后总是加载、校验并保留三类数据,协议模块开关只控制服务是否启用,不会在下次保存时删除已关闭模块的数据。`--parameter`和`--no-parameter`仍按最后一次出现决定启用状态;`--no-parameter --remote-parameter --config PATH`或`--no-parameter --file-service --config PATH`均可用,三类服务全部关闭却指定路径才在监听前报错。双主站小示例没有此选项。
|
||||
|
||||
存储实现位于[iec104_example_config.c](../../examples/iec104_example_config.c),接口见[头文件契约](../../examples/iec104_example_config.h)。每次保存都写入完整INI快照:使用同目录独占临时文件,完整写入、刷盘、关闭后原子替换主文件;失败只清理本次临时文件,保留旧目标,遗留临时文件不参与加载。一个路径只允许一个写者;停机后可复制主文件备份或替换恢复,INI也只能停机编辑,运行中不热加载。同步Windows I/O没有实时耗时或故障硬件下的绝对掉电保证。
|
||||
存储实现位于`iec104_example_config.c`,接口见`iec104_example_config.h`。每次保存都写入完整INI快照:使用同目录独占临时文件,完整写入、刷盘、关闭后原子替换主文件;失败只清理本次临时文件,保留旧目标,遗留临时文件不参与加载。一个路径只允许一个写者;停机后可复制主文件备份或替换恢复,INI也只能停机编辑,运行中不热加载。同步Windows I/O没有实时耗时或故障硬件下的绝对掉电保证。
|
||||
|
||||
标准参数INI是子站本地格式,主站仍通过Type110..113装载及总召读回。首次建档后可停机修改`value`,再以相同CA和路径启动;运行中编辑可能被后续保存覆盖。
|
||||
|
||||
@@ -774,7 +774,7 @@ TEMP在统一INI中使用`[temp]`节,上传内容仍受4096字节上限约束
|
||||
| `crc32` | CRC32/ISO-HDLC的8位十六进制值,覆盖固定容器头、CA、名称、大小、时间及内容 |
|
||||
| `data_0`至`data_31` | 每块最多128字节的十六进制文本,除末块外均须128字节;编号连续,块数和末块长度须与`size`一致,空文件没有内容块 |
|
||||
|
||||
保存时十六进制使用大写,读取接受大小写;CRC和编码边界以[存储实现](../../examples/iec104_example_config.c)为准。统一INI不是上传文件的原始字节副本,不能直接当作COMTRADE等业务文件打开;主站仍通过Type210虚拟目录和完整路径读文件。格式、名称、时间、长度或CRC不正确均拒绝启动且不覆盖原文件。
|
||||
保存时十六进制使用大写,读取接受大小写;CRC和编码边界以`iec104_example_config.c`为准。统一INI不是上传文件的原始字节副本,不能直接当作COMTRADE等业务文件打开;主站仍通过Type210虚拟目录和完整路径读文件。格式、名称、时间、长度或CRC不正确均拒绝启动且不覆盖原文件。
|
||||
|
||||
TEMP的COMMIT将新文件与当前标准运行值、已固化远程设置一起保存为完整INI,成功后才发布TEMP的RAM状态;失败保留上一个完整文件,不能把部分上传当成成功。预置写段、ABORT和TEST不写盘;远程或TEMP提交失败也不会撤销已经生效的标准参数,原待保存任务仍保留。恢复时沿用保存的CP56时标,目录项时间不会改成此次启动时间。未启用对应持久记录开关时,SOE、ULOG保留程序内固定演示文本;启用后分别由独立的`history.store`、`ulog.store`恢复并导出XML,不进入本INI。可选录波CFG/DAT由独立[录波演示](#example-recording)生成和保存;升级候选`upgrade.bin`、映像版本/CRC及升级激活状态也不属于本配置。
|
||||
|
||||
@@ -784,14 +784,14 @@ TEMP的COMMIT将新文件与当前标准运行值、已固化远程设置一起
|
||||
|
||||
### 两个主站共享参数
|
||||
|
||||
[iec104_parameter_multi_master.c](../../examples/iec104_parameter_multi_master.c)是独立的小示例,两个监听端口默认2404/2405、均为CA1;每个Slave各有Parameter、总召、SystemCommand及Startup协调状态,两个Parameter实例借用同一张32点表和同一份运行值数组,在一个事件循环串行调用。点表使用[公共地址宏](#example-addresses),与主示例保持四组参数IOA一致。它在完整启动同步和严格业务调度下演示共享参数装载和读回,不接入上述测量处理链,不开扫描,QPA3返回47;无扩展开关。该例门限和平滑仍以0初始化、上下限为±10000,不采用主示例的field输入及非零门限配置。
|
||||
`iec104_parameter_multi_master.c`是独立的小示例,两个监听端口默认2404/2405、均为CA1;每个Slave各有Parameter、总召、SystemCommand及Startup协调状态,两个Parameter实例借用同一张32点表和同一份运行值数组,在一个事件循环串行调用。点表使用[公共地址宏](#example-addresses),与主示例保持四组参数IOA一致。它在完整启动同步和严格业务调度下演示共享参数装载和读回,不接入上述测量处理链,不开扫描,QPA3返回47;无扩展开关。该例门限和平滑仍以0初始化、上下限为±10000,不采用主示例的field输入及非零门限配置。
|
||||
|
||||
```powershell
|
||||
./scripts/build.ps1 -Test -Suite Loopback
|
||||
./.build/slave-example/iec104_parameter_multi_master.exe --port 2404 --port2 2405
|
||||
```
|
||||
|
||||
Loopback构建会为此例设置`IEC104_TCP_SERVER_CAPACITY=2`,并执行[双主站TCP测试](../../test/parameter_multi_master_loopback_test.cjs)。主站A装载后,B之后形成的确认及总召读到新值;A的STOP或断线不停止B。各实例已固定的确认不因另一实例装载而刷新,这一情况由模块单测验证。多主站共享只保证读写串行,不提供跨实例全局快照。实例全部Destroy之前不能释放共享数组。
|
||||
Loopback构建会为此例设置`IEC104_TCP_SERVER_CAPACITY=2`,并执行`parameter_multi_master_loopback_test.cjs`。主站A装载后,B之后形成的确认及总召读到新值;A的STOP或断线不停止B。各实例已固定的确认不因另一实例装载而刷新,这一情况由模块单测验证。多主站共享只保证读写串行,不提供跨实例全局快照。实例全部Destroy之前不能释放共享数组。
|
||||
|
||||
两个端点分别通过Startup统一入口初始化传输、SystemCommand与GI配置,各自登记COI并驱动严格业务轮。SystemCommand仅启用INIT_END,不提供105复位动作;严格轮只推进本例支持的初始化、启动总召、参数及普通总召等级,GI和Parameter有界准备并登记尚未编码的待发等级。每个主站在实际START后先接收本端Type70,再执行本端真实全站总召;其ACT_TERM交接后仅放行该端点的缓存。A的初始化完成、总召票据或STOP不能替代或重置B的启动进度。GI使用独立配置和工作区;本例未创建CI,统一入口的counter输出传NULL;退出时先Startup_Reset归还本端站表锁,再完成各业务收尾。
|
||||
|
||||
@@ -927,7 +927,7 @@ system模式每60秒、请求分派之前的刷新更新应用和Command基准
|
||||
|
||||
#### Type103读取本地时钟
|
||||
|
||||
使用同一个监听端口,无额外开关。应用接线位于[主示例源码](../../examples/iec104_slave_example.c)的`[CLOCK/ACTION]`、`[CLOCK/STEP]`段。核心的请求校验、执行与应答次序见[读时序](../104/IEC104_ClockSynchronization_设计架构.md#clock-read-timeline),协议层、应用层和时间源的边界见[读时分层](../104/IEC104_ClockSynchronization_设计架构.md#clock-read-layering)。
|
||||
使用同一个监听端口,无额外开关。应用接线位于`iec104_slave_example.c`的`[CLOCK/ACTION]`、`[CLOCK/STEP]`段。核心的请求校验、执行与应答次序见[读时序](../104/IEC104_ClockSynchronization_设计架构.md#clock-read-timeline),协议层、应用层和时间源的边界见[读时分层](../104/IEC104_ClockSynchronization_设计架构.md#clock-read-layering)。
|
||||
|
||||
**时间来源与接线。** `--clock`选择示例业务取时方式;Windows/RTC则是公共Clock接口的构建时选择,二者不是同一组开关。
|
||||
|
||||
@@ -937,7 +937,7 @@ system模式每60秒、请求分派之前的刷新更新应用和Command基准
|
||||
| `--clock system`,Windows后端 | 每条新读请求都调用`IEC60870_Clock_Read`,读取当次Windows系统时间 | 不使用60秒刷新缓存;Clock内部将UTC转换为固定UTC+8,不随计算机本地时区或夏令时设置改变 |
|
||||
| 产品接入RTC后端 | 构建时选择`IEC60870_CLOCK_USE_RTC=1`,Clock调用产品提供的`IEC60870_Clock_RTC_Read` | 当前目录只提供RTC接口,未实现具体芯片驱动;驱动须提供一组一致的UTC+8日历和IV,无可用日历时返回失败 |
|
||||
|
||||
RTC初始化、读写串行化和实际有效性判断由接入产品负责。其接口契约集中在[Clock头文件](../../common/IEC60870_Clock.h):读成功且IV=1仍须给出合法日历;IV=0只表示未标记无效,不单独证明已经外部授时。Clock接口允许1970..2099日历,而Type103的CP56还要求2000..2099;读到1999年不会被示例改成当前年份,而是按输出不合法处理。
|
||||
RTC初始化、读写串行化和实际有效性判断由接入产品负责。其接口契约集中在`IEC60870_Clock.h`:读成功且IV=1仍须给出合法日历;IV=0只表示未标记无效,不单独证明已经外部授时。Clock接口允许1970..2099日历,而Type103的CP56还要求2000..2099;读到1999年不会被示例改成当前年份,而是按输出不合法处理。
|
||||
|
||||
| 函数 | 在读时链路中的职责 |
|
||||
|---|---|
|
||||
@@ -1245,7 +1245,7 @@ node ./scripts/make_upgrade_package.cjs --version 2 --input .build/firmware-inpu
|
||||
./.build/firmware-example/iec104_slave_example.exe --ca 1 --upgrade-store .build/firmware-store --upgrade-seed .build/firmware-input/current.i104 --remote-parameter --events 0 --background-ms 0
|
||||
```
|
||||
|
||||
[打包工具](../../scripts/make_upgrade_package.cjs)只接受`--version`、`--input`、`--output`三个键值参数,版本为1..4294967295的十进制整数,负载为1..16777200字节。它生成16字节I104头和负载,CRC覆盖实际写出的负载,最后同步输出;只创建新输出,已有输出不会被覆盖。创建后的写入失败可能留下不完整包,应保留失败原因并使用另一个新输出路径重新生成,不能把残留包当成功产物上传。工具不判定设备版本策略;接收端要求新版本严格高于最后确认版。格式选择及不含签名、机型许可的边界见[工程包设计](../common/IEC60870_FirmwareUpdate_设计架构.md#firmware-update-usage)。
|
||||
`make_upgrade_package.cjs`只接受`--version`、`--input`、`--output`三个键值参数,版本为1..4294967295的十进制整数,负载为1..16777200字节。它生成16字节I104头和负载,CRC覆盖实际写出的负载,最后同步输出;只创建新输出,已有输出不会被覆盖。创建后的写入失败可能留下不完整包,应保留失败原因并使用另一个新输出路径重新生成,不能把残留包当成功产物上传。工具不判定设备版本策略;接收端要求新版本严格高于最后确认版。格式选择及不含签名、机型许可的边界见[工程包设计](../common/IEC60870_FirmwareUpdate_设计架构.md#firmware-update-usage)。
|
||||
|
||||
首次缺seed会在创建档案前拒绝。提供seed后,Open只导入真实旧负载并登记角色,主示例另在监听前调用Prepare_Boot;种子复制、同步或登记中途失败留下的档案不会自动删除或重新格式化。已有存储再传seed会被拒绝,零长度、损坏档案也不能靠seed覆盖。进程正常结束或异常退出后,再次使用同目录时省略seed:
|
||||
|
||||
@@ -17,14 +17,14 @@
|
||||
|
||||
| 测试入口 | 覆盖内容 |
|
||||
|---|---|
|
||||
| [XML 与点表回环](../../test/dtu_example_loopback_test.cjs) | 独立读取随附 XML,核对 430 项定义、345 项已填参数及实际业务地址;检查总召、读取、遥控反馈、物理遥测与三段过流告警时序,使用 CA=7、k=1 |
|
||||
| [五区定值回环](../../test/dtu_settings_loopback_test.cjs) | SN0 的 345 项及其他四区各 88 项;分段预置、固化、切区、撤销、TEST、STOP/断线清理;类型/权限/跨字段校验、写盘失败保持旧值、同一 INI 恢复及重复键拒绝 |
|
||||
| [完整功能回环](../../test/dtu_features_loopback_test.cjs) | 扩展控制与扫描、四种电量编码和浮点冻结、压力轮转;TEMP、历史、日志、冻结文件、Type42 和 COMTRADE 下载及重启恢复;另以 DTU 产物调用内存升级和持久升级回环 |
|
||||
| [运行效果回环](../../test/dtu_process_loopback_test.cjs) | 倍率/取反/变比/极性/电量系数生效;真实模拟分闸/重合及闭锁;无采样时遥控与防抖;定值触发 COMTRADE 并下载;配置重启恢复 |
|
||||
| [设置模型](../../test/iec104_dtu_settings_model_test.c)、[测量模型](../../test/iec104_dtu_measurement_test.c)、[保护模型](../../test/iec104_dtu_protection_test.c) | 全部41倍率、93取反权限;换算、死区、零漂、计时、闭锁、锁存/复归、重合次数、无效输入等边界 |
|
||||
| [输入录波](../../test/iec104_dtu_trigger_recording_test.c) | 输入 RMS 对应的触发前后 DAT 幅值及数字量;非法输入拒绝且保留旧记录 |
|
||||
| [冻结电量定值](../../test/iec104_dtu_energy_settings_test.c) | 分段P/Q/电量增益、极性和反向事件;旧时刻查询不被新配置改写;容量拒绝与恢复后增益 |
|
||||
| [录波与冻结存储 C 校验](../../test/iec104_dtu_storage_test.c) | 100 V/1 A 模拟录波的幅值、PT/CT、961 点 DAT 及保存字节;八电量顺序和积分、FRZ/FLOWREV 导出与关闭重开恢复。追加 C99、pedantic 及纯整数时间后端编译配置 |
|
||||
| `dtu_example_loopback_test.cjs` | 独立读取随附 XML,核对 430 项定义、345 项已填参数及实际业务地址;检查总召、读取、遥控反馈、物理遥测与三段过流告警时序,使用 CA=7、k=1 |
|
||||
| `dtu_settings_loopback_test.cjs` | SN0 的 345 项及其他四区各 88 项;分段预置、固化、切区、撤销、TEST、STOP/断线清理;类型/权限/跨字段校验、写盘失败保持旧值、同一 INI 恢复及重复键拒绝 |
|
||||
| `dtu_features_loopback_test.cjs` | 扩展控制与扫描、四种电量编码和浮点冻结、压力轮转;TEMP、历史、日志、冻结文件、Type42 和 COMTRADE 下载及重启恢复;另以 DTU 产物调用内存升级和持久升级回环 |
|
||||
| `dtu_process_loopback_test.cjs` | 倍率/取反/变比/极性/电量系数生效;真实模拟分闸/重合及闭锁;无采样时遥控与防抖;定值触发 COMTRADE 并下载;配置重启恢复 |
|
||||
| `iec104_dtu_settings_model_test.c`、`iec104_dtu_measurement_test.c`、`iec104_dtu_protection_test.c` | 全部41倍率、93取反权限;换算、死区、零漂、计时、闭锁、锁存/复归、重合次数、无效输入等边界 |
|
||||
| `iec104_dtu_trigger_recording_test.c` | 输入 RMS 对应的触发前后 DAT 幅值及数字量;非法输入拒绝且保留旧记录 |
|
||||
| `iec104_dtu_energy_settings_test.c` | 分段P/Q/电量增益、极性和反向事件;旧时刻查询不被新配置改写;容量拒绝与恢复后增益 |
|
||||
| `iec104_dtu_storage_test.c` | 100 V/1 A 模拟录波的幅值、PT/CT、961 点 DAT 及保存字节;八电量顺序和积分、FRZ/FLOWREV 导出与关闭重开恢复。追加 C99、pedantic 及纯整数时间后端编译配置 |
|
||||
|
||||
编译产物在 `.build/dtu-check/`,回环存储夹具也在 `.build/`;验证范围为 Windows 宿主。
|
||||
|
||||
@@ -38,7 +38,7 @@
|
||||
|
||||
当前主示例总召遥信保持Type1/3;普通变位、遥控COT11和Read/COT5遥信使用Type30/31,周期及背景只扫描8个遥测。全部带S/E命令点默认SELECT_EXECUTE,选择保持60秒;无S/E的51/64仅以`--command-extensions`显式启用。通用库继续覆盖PLAIN/双报和DIRECT,不能以调整主示例默认策略为由删除这些能力测试。
|
||||
|
||||
点表由[集中地址定义](../../examples/iec104_example_points.h)维护:遥测0x4001起、命令0x6001/0x6011/0x6021/0x6031/0x6041起、电能量0x6401起、标准参数0x8601/0x8611/0x8621/0x8631起。旧5001系列INI不自动迁移,按[持久配置迁移说明](../examples/IEC104子站示例.md#example-parameter-persistence)调整32个参数节。下文按日期保留的旧点号、双报及直接执行实验结论只描述当时版本,不能用作当前点表。
|
||||
点表由`iec104_example_points.h`维护:遥测0x4001起、命令0x6001/0x6011/0x6021/0x6031/0x6041起、电能量0x6401起、标准参数0x8601/0x8611/0x8621/0x8631起。旧5001系列INI不自动迁移,按[持久配置迁移说明](../examples/IEC104子站示例.md#example-parameter-persistence)调整32个参数节。下文按日期保留的旧点号、双报及直接执行实验结论只描述当时版本,不能用作当前点表。
|
||||
|
||||
```powershell
|
||||
./scripts/build.ps1 -BuildName spec-spontaneous -Test -Suite Spontaneous
|
||||
@@ -88,13 +88,13 @@
|
||||
|
||||
| 测试入口 | 核对内容 |
|
||||
|---|---|
|
||||
| [示例C测试](../../test/iec104_slave_example_test.c):`check_gi`、`test_example_groups`及广播站表用例 | 独立核对SQ=1、首IOA、逐点值/品质、精确长度、站与分组归属;Type100确认和终止保持原布局 |
|
||||
| `iec104_slave_example_test.c`:`check_gi`、`test_example_groups`及广播站表用例 | 独立核对SQ=1、首IOA、逐点值/品质、精确长度、站与分组归属;Type100确认和终止保持原布局 |
|
||||
| 同文件:`test_example_sequence_batch_limits` | 每批上限1、3、127时全部24点无漏重;单点VSQ为0x81,末批保留剩余对象,类型切换另起帧 |
|
||||
| 同文件:`test_example_sequence_split_boundaries` | 跳号、重复及回跳地址结束当前连续段,不消费新点、不改旧帧;下一帧以该点为首地址。另验容量恰满、0xFFFFFF边界及非法地址/品质/异类型错误 |
|
||||
| 同文件:`test_wait_each_phase`、`test_example_double_wait_values` | 首次取数完成分组/参数游标初始化后,发送WAIT不推进位置;恢复时重新读取新值,已提交对象不重复 |
|
||||
| 同文件:`test_example_parameter_interrogation` | 同一站总召先发送SQ=1监视数据,再发送32项SQ=0单对象参数;分组不夹带参数,背压不改变编码规则 |
|
||||
| [主TCP回环](../../test/slave_example_loopback_test.cjs) | 常规与启动总召、突发交错、遥控后重连、参数总召和现场配置均按首地址推导后续IOA,核对值、品质与13/21字节ASDU长度;背景、事件和控制报文分别按各自规则校验 |
|
||||
| [扫描TCP回环](../../test/periodic_scan_loopback_test.cjs):`Master.startup` | 独立构造六帧SQ=1总召数据及SQ=0确认/终止;扫描SQ=0/1两种启动参数下都核对完整原文字节 |
|
||||
| `slave_example_loopback_test.cjs` | 常规与启动总召、突发交错、遥控后重连、参数总召和现场配置均按首地址推导后续IOA,核对值、品质与13/21字节ASDU长度;背景、事件和控制报文分别按各自规则校验 |
|
||||
| `periodic_scan_loopback_test.cjs`:`Master.startup` | 独立构造六帧SQ=1总召数据及SQ=0确认/终止;扫描SQ=0/1两种启动参数下都核对完整原文字节 |
|
||||
|
||||
2026-11-13实际执行上述两条命令均退出0。Example普通配置237/238组、严格配置各7组,共4个C程序通过;Loopback的Windows Net C程序及全部6个Node入口通过,覆盖配置持久化、周期/背景SQ=0/1、远程参数、软件升级和双主站兼容。生产示例也以`./scripts/build.ps1 -BuildName gi-sequence-build`独立构建通过,全部采用目录内GCC严格警告配置,零错误、零警告。
|
||||
|
||||
@@ -108,7 +108,7 @@
|
||||
./scripts/build.ps1 -Test -Suite FirmwareUpdate -BuildName firmware-update-check
|
||||
```
|
||||
|
||||
FirmwareUpdate编译[通用状态机测试](../../test/iec60870_firmware_update_test.c)及[Windows实文件测试](../../test/iec104_example_upgrade_test.c),再运行[独立TCP回环](../../test/firmware_update_loopback_test.cjs)。两项C测试使用C99、pedantic及`-Wall -Wextra -Werror`;回环使用Node内置模块,安装和备份内容逐字节核对,所有产物留在IEC60870-Slave的`.build`中。
|
||||
FirmwareUpdate编译`iec60870_firmware_update_test.c`及`iec104_example_upgrade_test.c`,再运行`firmware_update_loopback_test.cjs`。两项C测试使用C99、pedantic及`-Wall -Wextra -Werror`;回环使用Node内置模块,安装和备份内容逐字节核对,所有产物留在IEC60870-Slave的`.build`中。
|
||||
|
||||
| 层次 | 关键验证 |
|
||||
|---|---|
|
||||
@@ -125,23 +125,23 @@ FirmwareUpdate编译[通用状态机测试](../../test/iec60870_firmware_update_
|
||||
|
||||
| 源码与函数 | 验证的事实 |
|
||||
|---|---|
|
||||
| [核心测试](../../test/iec60870_firmware_update_test.c):`Inputs_And_Provision`、`Rotation_And_Trial_Rollback` | 非法输入保持状态/输出,真实基线登记后Init不安装;连续确认的三槽轮转、TRIAL时current仍旧版、重启回退保留原backup |
|
||||
| `iec60870_firmware_update_test.c`:`Inputs_And_Provision`、`Rotation_And_Trial_Rollback` | 非法输入保持状态/输出,真实基线登记后Init不安装;连续确认的三槽轮转、TRIAL时current仍旧版、重启回退保留原backup |
|
||||
| 同文件:`Orphans_And_Validation` | 连续接收边界、未授权接收/已验证候选重启取消、CRC及产品许可拒绝;坏current/backup在重用槽或安装前阻止动作 |
|
||||
| 同文件:`Every_Metadata_Boundary` | 对10个持久状态边界分别模拟“未提交”和“已提交却返回失败”;故障后不继续写,恢复只按实际元数据决定动作。使用内存后端,不是Windows断电测试 |
|
||||
| 同文件:`Platform_Failures`、`Metadata_Corruption_And_Exhaustion` | begin/write/sync/read/install失败,已授权候选缺失/截断/读错时回退;非法格式、保留位、角色及CRC拒绝;事务号耗尽拒绝新增而不回绕 |
|
||||
| [宿主测试](../../test/iec104_example_upgrade_test.c):`Test_Lifecycle` | 缺seed首次拒绝无档案、Open不自动安装、既有seed拒绝、独占锁/重开;跨段包头、低版本/坏CRC、70KB流式、未授权取消、授权恢复、未确认回退及两次角色轮转 |
|
||||
| `iec104_example_upgrade_test.c`:`Test_Lifecycle` | 缺seed首次拒绝无档案、Open不自动安装、既有seed拒绝、独占锁/重开;跨段包头、低版本/坏CRC、70KB流式、未授权取消、授权恢复、未确认回退及两次角色轮转 |
|
||||
| 同文件:`Test_Interruptions` | 从已关闭的真实基线复制独立用例,在成功升级链实际观察到的23个Flush/替换完成点逐一返回失败,再关闭重开;核对合法旧版或新版的全部负载字节和备份归属 |
|
||||
| 同文件:`Test_Health` | 直接破坏已安装`dtu`后Confirm拒绝,TRIAL与旧current保持;再次启动恢复原current及原backup,不把失败候选当备份 |
|
||||
| 同文件:`Test_Candidate_Recovery` | 已授权候选文件删除、截断或CRC错误,Prepare_Boot使用刚复验的旧角色恢复完整`dtu/dtu-1` |
|
||||
| 同文件:`Test_Corruption` | 坏文件头、已有零长度、单/双bank损坏、相同代次却不同有效内容、已确认源槽损坏及多余尾字节;当前契约要求任一bank可检测损坏时拒绝回退,不自动格式化或按文件存在猜角色 |
|
||||
| 同文件:`Test_Commit_Corruption` | 在已打开实例中分别损坏两个bank,再直接调用metadata_commit;均在任何同步/安装前失败,整个元数据文件逐字节不变,`dtu/dtu-1`及临时文件状态保持 |
|
||||
| [示例集成](../../test/iec104_slave_example_test.c):`test_example_upgrade_store_streaming` | 70KB分块写不触碰原64KB候选区的任一哨兵字节;COMMIT/END/ACK不安装,Take只持久授权,准备/确认后发布版本与CRC并记录一次HOST_FILE成功,关闭后恢复新版本 |
|
||||
| `iec104_slave_example_test.c`:`test_example_upgrade_store_streaming` | 70KB分块写不触碰原64KB候选区的任一哨兵字节;COMMIT/END/ACK不安装,Take只持久授权,准备/确认后发布版本与CRC并记录一次HOST_FILE成功,关闭后恢复新版本 |
|
||||
| 同文件:`test_example_upgrade_store_rejection` | 坏CRC可在同有效会话重传;取消仍须归还原handle,迟到COMMIT不能污染新候选,未授权取消不安装 |
|
||||
| 同文件:`test_example_upgrade_store_trial_rollback` | 安装进入TRIAL后故意令协议Init失败,退出保留持久试运行;下次启动真实回退并记录BOOT_ROLLBACK,不产生成功日志 |
|
||||
| 同文件:`test_example_upgrade_store_uncertain_authorization` | 真实metadata提交成功后才返回false;当轮只调用一次、锁存退出、不ABORT已交接授权,重开后继续原持久动作 |
|
||||
| 同文件:`test_example_upgrade_store_corrupt_authorized` | 安装前破坏授权候选,核心虽成功恢复旧版,应用仍将本次目标判失败;成功计数不增、失败计数增加、回退日志有且成功日志无 |
|
||||
| [独立TCP回环](../../test/firmware_update_loopback_test.cjs):`exercise`、`activate`、`imageValues`、`files` | 独立构造211/210/202及I104包;坏CRC/取消、70KB真实分段、两次升级、逐字节安装/备份、202读回、跨进程恢复及END确认未被有效104 ACK覆盖时终止进程后不安装 |
|
||||
| 同文件:`exercise`的打包及CLI检查 | [打包工具](../../scripts/make_upgrade_package.cjs)产物与独立构造逐字节相等;重复输出拒绝且原包不变;孤立seed选项、首次缺seed、第二进程锁冲突、已有存储重新给seed均拒绝 |
|
||||
| `firmware_update_loopback_test.cjs`:`exercise`、`activate`、`imageValues`、`files` | 独立构造211/210/202及I104包;坏CRC/取消、70KB真实分段、两次升级、逐字节安装/备份、202读回、跨进程恢复及END确认未被有效104 ACK覆盖时终止进程后不安装 |
|
||||
| 同文件:`exercise`的打包及CLI检查 | `make_upgrade_package.cjs`产物与独立构造逐字节相等;重复输出拒绝且原包不变;孤立seed选项、首次缺seed、第二进程锁冲突、已有存储重新给seed均拒绝 |
|
||||
|
||||
宿主23点注入发生在真实系统同步或替换已经完成之后,检查的是调用方收到失败时的恢复语义;不覆盖同步内部的扇区撕裂或物理掉电。安装文件通过长度及逐字节期望值检查,不能用版本号相等代替内容证据。核心10类提交边界覆盖逻辑失败前后,两种测试的计数不能相加解释为硬件故障覆盖率。主例测试使用确定性网络夹具;70KB完整线上过程另由独立TCP验证。
|
||||
|
||||
@@ -177,12 +177,12 @@ History套件编译核心、XML和Windows持久化适配三项C测试,再运
|
||||
|
||||
| 测试 | 关键断言 |
|
||||
|---|---|
|
||||
| [核心](../../test/iec60870_history_test.c) | 第1025条SOE/第31条CO循环、提交失败及模糊成功恢复、96节及午夜归属、缺测/品质/当日极值恢复、34天轮转、32测量点、配置指纹不符与损坏拒绝、2000..2099时间范围 |
|
||||
| [XML](../../test/iec60870_history_file_test.c) | 1024/30条、96节、拥有日24:00、真实缺节保留编号、极值点集、大小写路径、UTF-8与属性转义、输出失败不发布、最新30个完整日 |
|
||||
| [宿主持久化](../../test/iec104_example_history_test.c) | 三个实际同步边界注入中断、未提交候选保留旧版或完整提交后恢复新版、独占锁、短文件/损坏/零长度拒绝、32日存储与30日目录、任意偏移读取、目录与下载快照相互独立;任一bank损坏时读、提交和重开均拒绝 |
|
||||
| `iec60870_history_test.c` | 第1025条SOE/第31条CO循环、提交失败及模糊成功恢复、96节及午夜归属、缺测/品质/当日极值恢复、34天轮转、32测量点、配置指纹不符与损坏拒绝、2000..2099时间范围 |
|
||||
| `iec60870_history_file_test.c` | 1024/30条、96节、拥有日24:00、真实缺节保留编号、极值点集、大小写路径、UTF-8与属性转义、输出失败不发布、最新30个完整日 |
|
||||
| `iec104_example_history_test.c` | 三个实际同步边界注入中断、未提交候选保留旧版或完整提交后恢复新版、独占锁、短文件/损坏/零长度拒绝、32日存储与30日目录、任意偏移读取、目录与下载快照相互独立;任一bank损坏时读、提交和重开均拒绝 |
|
||||
| 同文件:`Test_Extrema_Corruption` | 同日最大值先保存10再保存20,分别损坏新旧bank;在线读取均报错并保持输出、置核心faulted,提交不改介质,重开不退回旧极值 |
|
||||
| 同文件:`Test_Equal_Generations` | 两bank外层CRC均正确时,同代次同内容可读写并重开;同代次载荷不同或长度不同则拒绝读取、提交和重开 |
|
||||
| [真实TCP](../../test/history_loopback_test.cjs) | 四目录、非零目录ID、时间筛选、分段模和与完整长度、遥控选择/执行/撤销、96节、强制结束进程并重启后下载字节一致 |
|
||||
| `history_loopback_test.cjs` | 四目录、非零目录ID、时间筛选、分段模和与完整长度、遥控选择/执行/撤销、96节、强制结束进程并重启后下载字节一致 |
|
||||
|
||||
XML测试可选一个已存在输出目录作为参数,再用独立XML解析器检查导出的文件;TCP主站直接构造和检查线上字节,不调用被测库编解码。回环使用模拟校时推进2090年的96个时段,不修改宿主系统时间;产物保留在本目录`.build/history-loopback-*`。原文件服务13项容量/内部配置与Example四项配置回归通过;物理介质断电、ARMCC布局、真机采样与目标主站现场互操作尚未验收。实现边界见[历史设计](../common/IEC60870_History_设计架构.md)。
|
||||
|
||||
@@ -201,14 +201,14 @@ UserLog套件构建公共核心、XML和Windows持久化后端三个C程序,
|
||||
|
||||
| 测试 | 关键断言 |
|
||||
|---|---|
|
||||
| [公共核心](../../test/iec60870_user_log_test.c),6组 | 第1025条覆盖最旧记录、恢复1024条顺序;01–11类型及状态/行为值限制;128字节ASCII和时间边界/回拨;提交前后失败、故障闭锁、CRC/缺口/旧尾拒绝及序号耗尽 |
|
||||
| [XML](../../test/iec60870_user_log_file_test.c),4组 | `fileType="Ulog"`、`devID`、`txt`及两位类型;空库/实际条数/1024条;转义、时标两端及提交顺序;每个输出片段失败和存储读取失败不发布成功大小 |
|
||||
| [宿主持久化](../../test/iec104_example_user_log_test.c) | 三次同步边界中断后恢复旧版或已提交新版;独占锁、错误路径、短文件、CRC和布局损坏拒绝;新旧任一bank损坏均阻止读取、提交和重开,拒绝提交不改介质;目录缓存及独立下载快照、任意偏移、大小写与读边界;同目录`history.store`保持原内容 |
|
||||
| `iec60870_user_log_test.c`,6组 | 第1025条覆盖最旧记录、恢复1024条顺序;01–11类型及状态/行为值限制;128字节ASCII和时间边界/回拨;提交前后失败、故障闭锁、CRC/缺口/旧尾拒绝及序号耗尽 |
|
||||
| `iec60870_user_log_file_test.c`,4组 | `fileType="Ulog"`、`devID`、`txt`及两位类型;空库/实际条数/1024条;转义、时标两端及提交顺序;每个输出片段失败和存储读取失败不发布成功大小 |
|
||||
| `iec104_example_user_log_test.c` | 三次同步边界中断后恢复旧版或已提交新版;独占锁、错误路径、短文件、CRC和布局损坏拒绝;新旧任一bank损坏均阻止读取、提交和重开,拒绝提交不改介质;目录缓存及独立下载快照、任意偏移、大小写与读边界;同目录`history.store`保持原内容 |
|
||||
| 同文件:`Test_Equal_Generations` | 同代次且相同长度/内容可重开、读取和提交;同代次载荷或长度冲突则拒绝读写和恢复,文件长度及摘要保持不变 |
|
||||
| [示例集成](../../test/iec104_slave_example_test.c):`test_example_user_log_lifecycle` | 真实CONNECTED/DISCONNECTED、START/STOP不记02;迟消费仍使用产生时刻;异常发生去重及重新连接恢复;启动恢复最后03状态;校时回拨、system刷新不移动日志基准;协议/进程重建、ULOG路由、稳定快照和错误owner关闭拒绝 |
|
||||
| `iec104_slave_example_test.c`:`test_example_user_log_lifecycle` | 真实CONNECTED/DISCONNECTED、START/STOP不记02;迟消费仍使用产生时刻;异常发生去重及重新连接恢复;启动恢复最后03状态;校时回拨、system刷新不移动日志基准;协议/进程重建、ULOG路由、稳定快照和错误owner关闭拒绝 |
|
||||
| 同文件:`test_example_user_log_parameters` | 标准参数已生效而确认WAIT时只记一次;TEST、同值和拒绝不记;周期启停按实际setter变化记录;远程PRESET不记,真实SOLIDIFY和切区才记,非当前区保存标记及TEST/撤销隔离 |
|
||||
| 同文件:`test_example_user_log_upgrade`及`test_example_user_log_failure_cleanup` | 升级TEST无动作日志;文件验证、END预留、ACK授权与最终激活分离,成功标记`SIMULATED`且只产生一次;注入日志提交失败后参数仍已生效、升级候选仍释放、文件仍可按原handle关闭,后续不重做动作 |
|
||||
| [真实TCP](../../test/user_log_loopback_test.cjs) | 非零目录ID、完整路径和准确大小;独立解析日志字段;真实参数变化与TEST/同值/拒绝隔离;新增日志后旧目录版本字节不变;STOP/START不增加日志,普通断线/重连只记02;时间筛选、大小写拒绝、进程重启保留旧记录前缀 |
|
||||
| `user_log_loopback_test.cjs` | 非零目录ID、完整路径和准确大小;独立解析日志字段;真实参数变化与TEST/同值/拒绝隔离;新增日志后旧目录版本字节不变;STOP/START不增加日志,普通断线/重连只记02;时间筛选、大小写拒绝、进程重启保留旧记录前缀 |
|
||||
|
||||
目录与下载验证检查线上段校验和、总长度和XML内容,不以客户端显示成功代替日志检查。Node产物位于本目录`.build/user-log-loopback-*`,其中`before-restart.xml`和`after-restart.xml`保留重启前后证据。宿主同步边界故障注入与进程重启已覆盖;物理介质断电、真实04–09硬件来源、目标复位原因、实际Flash升级和目标主站互操作须由产品验收补齐,不能从宿主`SIMULATED`日志推断完成。
|
||||
|
||||
@@ -252,7 +252,7 @@ UserLog套件构建公共核心、XML和Windows持久化后端三个C程序,
|
||||
|
||||
存储契约见[独立SOE设计](../104/IEC104_发送模块_设计架构.md#soe-retention),接口与统计见[SOE API](../104/IEC104_API接口汇总.md#soe-api)。256按单/双点COT3的事件对象计数,默认CP56单报进入独立槽;普通NORMAL仍为4096字节,显式PLAIN/双报及其他类型仍走旧路径。History的1024条持久SOE与网络待ACK缓存分别验证,不以文件中存在记录替代实时保留保证。
|
||||
|
||||
`test/iec104_strict_priority_transport_test.c`复用真实TcpServer、Connection、Manager与队列,仅替换Net和时钟;新增以下3组,每组内部各运行兼容、严格两模式。普通NORMAL刻意缩为512字节,以证明SOE不依赖扩大共享环;参数组合不额外计为测试组。实际构建及运行结论在第5节记录。
|
||||
`IEC60870-Slave/test/iec104_strict_priority_transport_test.c`复用真实TcpServer、Connection、Manager与队列,仅替换Net和时钟;新增以下3组,每组内部各运行兼容、严格两模式。普通NORMAL刻意缩为512字节,以证明SOE不依赖扩大共享环;参数组合不额外计为测试组。实际构建及运行结论在第5节记录。
|
||||
|
||||
| 用例 | 核对边界 |
|
||||
|---|---|
|
||||
@@ -292,7 +292,7 @@ node ./test/slave_example_loopback_test.cjs ./.build/startup-replay-example/iec1
|
||||
|
||||
### 远程参数专项
|
||||
|
||||
`./scripts/build.ps1 -Test -Suite RemoteParameter -BuildName remote-parameter-check` 编译运行 [iec104_remote_parameter_test.c](../../test/iec104_remote_parameter_test.c):TCP容量1/2 × 任务槽1/2/4,共六配置,HIGH=251。发送/查询/关闭/时钟注入仅在 `IEC104_REMOTE_PARAMETER_TEST_HOOKS` 构建中启用,生产模块不包含这些符号。`-Suite All` 包含本专项;`-Suite Loopback` 另运行 [remote_parameter_loopback_test.cjs](../../test/remote_parameter_loopback_test.cjs)。
|
||||
`./scripts/build.ps1 -Test -Suite RemoteParameter -BuildName remote-parameter-check` 编译运行 `iec104_remote_parameter_test.c`:TCP容量1/2 × 任务槽1/2/4,共六配置,HIGH=251。发送/查询/关闭/时钟注入仅在 `IEC104_REMOTE_PARAMETER_TEST_HOOKS` 构建中启用,生产模块不包含这些符号。`-Suite All` 包含本专项;`-Suite Loopback` 另运行 `remote_parameter_loopback_test.cjs`。
|
||||
|
||||
专项覆盖逐字节线格式、全部Tag和有限浮点、便捷写入器、镜像/简短兼容确认、真实/TEST隔离、区号与请求字段、预置/固化/撤销、FIFO错误续帧、超时恢复、站点删除重注册、读取预检/分帧/WAIT重取/固定负末帧,以及发送与关闭故障。期望报文直接按字段构造,独立于被测模块编码器。双任务排队分支仅在任务容量足够时执行;TCP容量1/2是编译配置矩阵,当前夹具并未同时创建两个RemoteParameter实例访问同一运行存储,不能据此声称双主站共享事务已联调。
|
||||
|
||||
@@ -300,7 +300,7 @@ node ./test/slave_example_loopback_test.cjs ./.build/startup-replay-example/iec1
|
||||
|
||||
真实本机TCP回环验证默认关闭与显式开启、七点读回、切区、暂存与固化、错误预置后的显式恢复、撤销SN不匹配、TEST、STOP清理,以及未传`--config`时的105复位与映像记录保留。启用`--config`后的恢复和复位行为另由[持久化回环](#extended-persistence-tests)验证。该回环不代表独立第三方主站认证;升级完成后版本更新另由[软件升级回环](#software-upgrade-tests)验证。目标ARMCC资源、硬件和现场主站验收不使用宿主结果替代。
|
||||
|
||||
另有[内部边界专项](../../test/iec104_remote_parameter_internal_test.c),仅测试构建直接包含实现,以有限步骤抵达 SIZE_MAX 游标和 UINT64_MAX 实例编号,并验证实际断开/重连后的旧DISCARD与faulted隔离;生产不暴露这些内部字段。专项总计七个可执行程序,公开接口六配置各31组全部通过,内部边界专项通过;命令退出0。已有Example两配置各195组通过。另以 `-std=c99 -O2 -Wall -Wextra -Werror -fsanitize=undefined -fsanitize-undefined-trap-on-error` 编译TCP2/任务槽4的公开专项,31组通过、退出0。公共头C++11编译通过,生产对象无测试注入符号。
|
||||
另有`iec104_remote_parameter_internal_test.c`,仅测试构建直接包含实现,以有限步骤抵达 SIZE_MAX 游标和 UINT64_MAX 实例编号,并验证实际断开/重连后的旧DISCARD与faulted隔离;生产不暴露这些内部字段。专项总计七个可执行程序,公开接口六配置各31组全部通过,内部边界专项通过;命令退出0。已有Example两配置各195组通过。另以 `-std=c99 -O2 -Wall -Wextra -Werror -fsanitize=undefined -fsanitize-undefined-trap-on-error` 编译TCP2/任务槽4的公开专项,31组通过、退出0。公共头C++11编译通过,生产对象无测试注入符号。
|
||||
|
||||
全量命令 `./scripts/build.ps1 -Test -Suite All -BuildName remote-parameter-all` 的54个C测试程序全部通过,随后因沙箱禁止Node创建子进程(EPERM)退出1;该次不记为整条命令成功。获准后以相同BuildName重跑 `-Suite Loopback`,重新严格构建并通过原有主示例、配置文件、周期扫描、双主站及新增远程参数全部TCP回环,退出0。最后增加的内部边界程序及补充断言由上述七程序专项再次通过。日志为`.build/remote-parameter-all-current.log`和`.build/remote-parameter-loopback-current.log`。
|
||||
|
||||
@@ -336,29 +336,29 @@ node ./test/slave_example_loopback_test.cjs ./.build/startup-replay-example/iec1
|
||||
|
||||
| Suite | 测试源码 | 默认配置数与范围 |
|
||||
|---|---|---|
|
||||
| Dtu | [XML/点表](../../test/dtu_example_loopback_test.cjs)、[五区定值](../../test/dtu_settings_loopback_test.cjs)、[运行效果](../../test/dtu_process_loopback_test.cjs)、[完整功能](../../test/dtu_features_loopback_test.cjs)及C模型/存储测试 | 真实TCP与纯模型共同验证;完整功能入口另调用两种升级回环,见[DTU专项](#dtu-tests) |
|
||||
| Common | [ASDU](../../test/iec60870_asdu_test.c)、[扩展ASDU](../../test/iec60870_asdu_extended_test.c)、[故障事件编解码](../../test/iec60870_fault_event_test.c) | 6:三套各跑默认/纯整数时间后端;Type42单独验证两组记录的扩展布局 |
|
||||
| Transport | [ASDU封装](../../test/iec104_asdu_transport_test.c)、[HIGH/NORMAL队列](../../test/iec104_response_queue_test.c)、[严格队列](../../test/iec104_strict_priority_queue_test.c)、[应答传输](../../test/iec104_response_transport_test.c)、[ACK观察](../../test/iec104_ack_tracking_test.c)、[事件环](../../test/iec104_tcp_event_ring_test.c)、[调度](../../test/iec104_tcp_scheduler_test.c)、[IDLE直发](../../test/iec104_idle_transport_test.c)、[严格发送](../../test/iec104_strict_priority_transport_test.c) | 11个配置程序,含事件环小/大容量;队列15组、严格队列13组、严格发送10组(含SOE三组)、ACK观察12组、IDLE8组 |
|
||||
| Slave | [共用子站与站点](../../test/iec104_slave_test.c) | 2:TCP服务容量1/2,各33组 |
|
||||
| Example | [示例集成](../../test/iec104_slave_example_test.c) | 4:TCP服务容量1/2的兼容配置分别245/247组,严格配置分别9/10组;含独立SOE与普通前缀保序、默认策略/地址分区与时标快照、启动补发、Type103读时、电能量、业务排序、录波、历史、日志及持久升级,TCP2另测两个Slave争用同一设备owner |
|
||||
| Command | [遥控/遥调](../../test/iec104_command_test.c) | 4:TCP容量1/2 × 回复槽1/4,各96组,含固定失败/超时否定TERM、TEST模拟、撤销寻址、COT48/49、CP56接收及FIFO、清理和会话边界 |
|
||||
| Read | [读命令](../../test/iec104_read_test.c) | 4:TCP容量1/2 × 任务槽1/4,各18组 |
|
||||
| SystemCommand | [系统命令](../../test/iec104_system_command_test.c) | 4:TCP容量1/2 × 任务槽1/4;任务槽1为256组、槽4为259组,HIGH=251,含Type70完成轮次、104固定测试码与107 CP56原文回显,启用专项注入钩子 |
|
||||
| Parameter | [参数装载](../../test/iec104_parameter_test.c)、[参数边界与总召](../../test/iec104_parameter_edge_test.c) | 5:主专项TCP容量1/2 × 任务槽1/4各20组,另边界3组;HIGH=251,主专项启用发送及ACK故障钩子 |
|
||||
| RemoteParameter | [远程参数](../../test/iec104_remote_parameter_test.c)、[内部边界](../../test/iec104_remote_parameter_internal_test.c) | 7:TCP容量1/2 × 任务槽1/2/4及内部编号/索引边界;见[记录](#remote-parameter-tests) |
|
||||
| FileService | [文件服务](../../test/iec104_file_service_test.c)、[内部边界](../../test/iec104_file_service_internal_test.c) | 13:TCP容量1/2 × 请求槽1/2 × 数据段1/2/4,另内部索引/编号/长度边界;见[记录](#file-service-tests) |
|
||||
| SoftwareUpgrade | [软件升级](../../test/iec104_software_upgrade_test.c)、[内部边界](../../test/iec104_software_upgrade_internal_test.c) | 9:TCP容量1/2 × 任务槽1/2 × ACK策略0/1共732组,另编号耗尽/收尾边界;见[记录](#software-upgrade-tests) |
|
||||
| FirmwareUpdate | [安装核心](../../test/iec60870_firmware_update_test.c)、[实文件后端](../../test/iec104_example_upgrade_test.c)、[TCP回环](../../test/firmware_update_loopback_test.cjs) | 2个C程序及1个Node入口:核心6组、宿主5组及23个真实中断点;见[持久安装验证](#firmware-update-tests) |
|
||||
| Spontaneous | [突发](../../test/iec104_spontaneous_test.c) | 3:(TCP,NORMAL)=(1,4096)/(2,4096)/(1,272),各30组,含独立SOE容量、延迟占位和逐对象失败前缀 |
|
||||
| FaultEvent | [故障事件编解码](../../test/iec60870_fault_event_test.c)、[故障事件上送](../../test/iec104_fault_event_test.c) | 5:公共编解码默认/纯整数时间后端,加上送(TCP,NORMAL)=(1,4096)/(2,4096)/(1,272);兼容/严格优先级由上送用例分别检查 |
|
||||
| Recording | [录波核心](../../test/iec60870_fault_recorder_test.c)、[COMTRADE编码](../../test/iec60870_comtrade_test.c)、[示例录波适配](../../test/iec104_example_recording_test.c) | 3:连续窗口9组、编码6组、主机保存5组,共20组;104集成另由Example及文件服务回环覆盖,见[录波验证](#recording-tests) |
|
||||
| History | [历史核心](../../test/iec60870_history_test.c)、[历史XML](../../test/iec60870_history_file_test.c)、[持久后端](../../test/iec104_example_history_test.c)、[历史TCP回环](../../test/history_loopback_test.cjs) | 3个C程序及1个Node入口:循环覆盖、整刻/日边界、提交中断与重开、XML内容、目录/读取快照及主进程重启;见[历史验证](#history-tests) |
|
||||
| UserLog | [日志核心](../../test/iec60870_user_log_test.c)、[日志XML](../../test/iec60870_user_log_file_test.c)、[持久后端](../../test/iec104_example_user_log_test.c)、[日志TCP回环](../../test/user_log_loopback_test.cjs) | 3个C程序及1个Node入口:核心6组、XML4组、持久提交中断/恢复、独立快照、真实参数与连接事实及重启调阅;应用4组另由Example执行,见[运行日志验证](#user-log-tests) |
|
||||
| PeriodicScan | [周期/背景扫描](../../test/iec104_periodic_scan_test.c) | 9:TCP容量1/2 × 组容量1/4 × 行预算4/256,另加行预算14反例 |
|
||||
| Rules | [召唤规则](../../test/iec104_interrogation_rules_test.c) | 1:3组规则矩阵 |
|
||||
| Loopback | [Windows Net](../../test/iec104_net_pending_input_test.c)、[示例TCP回环](../../test/slave_example_loopback_test.cjs)、[周期TCP回环](../../test/periodic_scan_loopback_test.cjs)、[多主站参数回环](../../test/parameter_multi_master_loopback_test.cjs)、[参数文件回环](../../test/parameter_config_loopback_test.cjs)、[远程参数回环](../../test/remote_parameter_loopback_test.cjs)、[软件升级回环](../../test/software_upgrade_loopback_test.cjs) | 1个C程序及6个Node入口;含既有业务、参数文件/共享值、周期扫描、远程参数、文件服务和升级后版本/CRC读回 |
|
||||
| Dtu | `dtu_example_loopback_test.cjs`、`dtu_settings_loopback_test.cjs`、`dtu_process_loopback_test.cjs`、`dtu_features_loopback_test.cjs`及C模型/存储测试 | 真实TCP与纯模型共同验证;完整功能入口另调用两种升级回环,见[DTU专项](#dtu-tests) |
|
||||
| Common | `iec60870_asdu_test.c`、`iec60870_asdu_extended_test.c`、`iec60870_fault_event_test.c` | 6:三套各跑默认/纯整数时间后端;Type42单独验证两组记录的扩展布局 |
|
||||
| Transport | `iec104_asdu_transport_test.c`、`iec104_response_queue_test.c`、`iec104_strict_priority_queue_test.c`、`iec104_response_transport_test.c`、`iec104_ack_tracking_test.c`、`iec104_tcp_event_ring_test.c`、`iec104_tcp_scheduler_test.c`、`iec104_idle_transport_test.c`、`iec104_strict_priority_transport_test.c` | 11个配置程序,含事件环小/大容量;队列15组、严格队列13组、严格发送10组(含SOE三组)、ACK观察12组、IDLE8组 |
|
||||
| Slave | `iec104_slave_test.c` | 2:TCP服务容量1/2,各33组 |
|
||||
| Example | `iec104_slave_example_test.c` | 4:TCP服务容量1/2的兼容配置分别245/247组,严格配置分别9/10组;含独立SOE与普通前缀保序、默认策略/地址分区与时标快照、启动补发、Type103读时、电能量、业务排序、录波、历史、日志及持久升级,TCP2另测两个Slave争用同一设备owner |
|
||||
| Command | `iec104_command_test.c` | 4:TCP容量1/2 × 回复槽1/4,各96组,含固定失败/超时否定TERM、TEST模拟、撤销寻址、COT48/49、CP56接收及FIFO、清理和会话边界 |
|
||||
| Read | `iec104_read_test.c` | 4:TCP容量1/2 × 任务槽1/4,各18组 |
|
||||
| SystemCommand | `iec104_system_command_test.c` | 4:TCP容量1/2 × 任务槽1/4;任务槽1为256组、槽4为259组,HIGH=251,含Type70完成轮次、104固定测试码与107 CP56原文回显,启用专项注入钩子 |
|
||||
| Parameter | `iec104_parameter_test.c`、`iec104_parameter_edge_test.c` | 5:主专项TCP容量1/2 × 任务槽1/4各20组,另边界3组;HIGH=251,主专项启用发送及ACK故障钩子 |
|
||||
| RemoteParameter | `iec104_remote_parameter_test.c`、`iec104_remote_parameter_internal_test.c` | 7:TCP容量1/2 × 任务槽1/2/4及内部编号/索引边界;见[记录](#remote-parameter-tests) |
|
||||
| FileService | `iec104_file_service_test.c`、`iec104_file_service_internal_test.c` | 13:TCP容量1/2 × 请求槽1/2 × 数据段1/2/4,另内部索引/编号/长度边界;见[记录](#file-service-tests) |
|
||||
| SoftwareUpgrade | `iec104_software_upgrade_test.c`、`iec104_software_upgrade_internal_test.c` | 9:TCP容量1/2 × 任务槽1/2 × ACK策略0/1共732组,另编号耗尽/收尾边界;见[记录](#software-upgrade-tests) |
|
||||
| FirmwareUpdate | `iec60870_firmware_update_test.c`、`iec104_example_upgrade_test.c`、`firmware_update_loopback_test.cjs` | 2个C程序及1个Node入口:核心6组、宿主5组及23个真实中断点;见[持久安装验证](#firmware-update-tests) |
|
||||
| Spontaneous | `iec104_spontaneous_test.c` | 3:(TCP,NORMAL)=(1,4096)/(2,4096)/(1,272),各30组,含独立SOE容量、延迟占位和逐对象失败前缀 |
|
||||
| FaultEvent | `iec60870_fault_event_test.c`、`iec104_fault_event_test.c` | 5:公共编解码默认/纯整数时间后端,加上送(TCP,NORMAL)=(1,4096)/(2,4096)/(1,272);兼容/严格优先级由上送用例分别检查 |
|
||||
| Recording | `iec60870_fault_recorder_test.c`、`iec60870_comtrade_test.c`、`iec104_example_recording_test.c` | 3:连续窗口9组、编码6组、主机保存5组,共20组;104集成另由Example及文件服务回环覆盖,见[录波验证](#recording-tests) |
|
||||
| History | `iec60870_history_test.c`、`iec60870_history_file_test.c`、`iec104_example_history_test.c`、`history_loopback_test.cjs` | 3个C程序及1个Node入口:循环覆盖、整刻/日边界、提交中断与重开、XML内容、目录/读取快照及主进程重启;见[历史验证](#history-tests) |
|
||||
| UserLog | `iec60870_user_log_test.c`、`iec60870_user_log_file_test.c`、`iec104_example_user_log_test.c`、`user_log_loopback_test.cjs` | 3个C程序及1个Node入口:核心6组、XML4组、持久提交中断/恢复、独立快照、真实参数与连接事实及重启调阅;应用4组另由Example执行,见[运行日志验证](#user-log-tests) |
|
||||
| PeriodicScan | `iec104_periodic_scan_test.c` | 9:TCP容量1/2 × 组容量1/4 × 行预算4/256,另加行预算14反例 |
|
||||
| Rules | `iec104_interrogation_rules_test.c` | 1:3组规则矩阵 |
|
||||
| Loopback | `iec104_net_pending_input_test.c`、`slave_example_loopback_test.cjs`、`periodic_scan_loopback_test.cjs`、`parameter_multi_master_loopback_test.cjs`、`parameter_config_loopback_test.cjs`、`remote_parameter_loopback_test.cjs`、`software_upgrade_loopback_test.cjs` | 1个C程序及6个Node入口;含既有业务、参数文件/共享值、周期扫描、远程参数、文件服务和升级后版本/CRC读回 |
|
||||
|
||||
`-Test`默认选择All,运行全部C测试配置及Node回环入口,实际配置数由脚本输出。可控Net共用[网络测试夹具](../../test/iec104_tcp_fixture.h),独立报文向量共用[ASDU测试夹具](../../test/iec60870_asdu_fixture.h);普通专项不包含其他业务测试。RemoteParameter/FileService的内部边界程序重用各自公开专项夹具并直接包含本模块实现,以有限步骤到达索引和编号耗尽,不为生产增加测试接口。构建依赖与矩阵以[build.ps1](../../scripts/build.ps1)为准。
|
||||
`-Test`默认选择All,运行全部C测试配置及Node回环入口,实际配置数由脚本输出。可控Net共用`iec104_tcp_fixture.h`,独立报文向量共用`iec60870_asdu_fixture.h`;普通专项不包含其他业务测试。RemoteParameter/FileService的内部边界程序重用各自公开专项夹具并直接包含本模块实现,以有限步骤到达索引和编号耗尽,不为生产增加测试接口。构建依赖与矩阵以`build.ps1`为准。
|
||||
|
||||
每个测试文件开头列出所属Suite及文件内导航。`COMMON`集中公共夹具、报文构造、拥塞控制及原文核对辅助,各业务区集中专属辅助及用例,入口用`RUN`/`CASE`细分执行组。跨文件复用与仅本文件共用的范围在导航中说明。示例集成测试按“公共辅助 → 各业务连续用例区 → 跨业务集成 → main”排列;总召/计数量整体期限在`INTEGRATION/GI_CI_TIMEOUT`,Type 102单业务用例在`READ/CASES`,读回和校时竞争等跨业务场景在`INTEGRATION/READ`。用例定义位置按模块归拢,`main`仍保留原执行顺序;周期/背景扫描由独立的`iec104_periodic_scan_test.c`专项及TCP回环覆盖。
|
||||
|
||||
@@ -504,12 +504,12 @@ ACK观察专项验证非零票据、QUEUED/SENT/ACKED、首次ACK时刻、重复
|
||||
|
||||
| 核对目标 | 测试入口与主要函数 |
|
||||
|---|---|
|
||||
| 请求校验、轮次、期限与授权 | [系统命令专项](../../test/iec104_system_command_test.c):`test_system_107_validation`、`test_system_init_pending_and_wait`、`test_system_ack_deadlines`、`test_system_reset_order_and_cancel` |
|
||||
| 未提交复位确认到期及清理边界 | [系统命令专项](../../test/iec104_system_command_test.c):`test_system_reset_pending_timeout`、`test_system_reset_pending_timeout_cleanup`;正常推进转否定,显式Cancel/STOP/断线只清理 |
|
||||
| 复位授权与会话结束的先后 | [系统命令专项](../../test/iec104_system_command_test.c):`test_system_reset_session_boundaries`,三个授权阶段分别交叉STOPDT/EOF;另测同批顺序、ACK期限、跨重连及显式Cancel |
|
||||
| 累计ACK时刻、观察槽与故障事实 | [ACK观察专项](../../test/iec104_ack_tracking_test.c):`test_ack_time_and_record_lifetime`、`test_cumulative_wrap_and_piggyback`、`test_ack_before_normal_cleanup_fatal` |
|
||||
| 应用forms、部分失败与复位收尾 | [示例集成](../../test/iec104_slave_example_test.c):`test_example_system_command_forms`、`test_example_system_command_commit_boundaries`、`test_example_system_command_fault_continues`、`test_example_restart_drains_active_business` |
|
||||
| 真实连接、主站ACK与复位后重连 | [Node回环](../../test/slave_example_loopback_test.cjs):`systemCommandLoopback`、`resetEventsLoopback`;手工报文和诊断见[示例联调](../examples/IEC104子站示例.md#example-system-command) |
|
||||
| 请求校验、轮次、期限与授权 | `iec104_system_command_test.c`:`test_system_107_validation`、`test_system_init_pending_and_wait`、`test_system_ack_deadlines`、`test_system_reset_order_and_cancel` |
|
||||
| 未提交复位确认到期及清理边界 | `iec104_system_command_test.c`:`test_system_reset_pending_timeout`、`test_system_reset_pending_timeout_cleanup`;正常推进转否定,显式Cancel/STOP/断线只清理 |
|
||||
| 复位授权与会话结束的先后 | `iec104_system_command_test.c`:`test_system_reset_session_boundaries`,三个授权阶段分别交叉STOPDT/EOF;另测同批顺序、ACK期限、跨重连及显式Cancel |
|
||||
| 累计ACK时刻、观察槽与故障事实 | `iec104_ack_tracking_test.c`:`test_ack_time_and_record_lifetime`、`test_cumulative_wrap_and_piggyback`、`test_ack_before_normal_cleanup_fatal` |
|
||||
| 应用forms、部分失败与复位收尾 | `iec104_slave_example_test.c`:`test_example_system_command_forms`、`test_example_system_command_commit_boundaries`、`test_example_system_command_fault_continues`、`test_example_restart_drains_active_business` |
|
||||
| 真实连接、主站ACK与复位后重连 | `slave_example_loopback_test.cjs`:`systemCommandLoopback`、`resetEventsLoopback`;手工报文和诊断见[示例联调](../examples/IEC104子站示例.md#example-system-command) |
|
||||
|
||||
业务专项中的可控时钟与提交故障钩子用于构造边界;真实TCP回环验证实际发送与收尾。测试内手写请求/期望字节不依赖业务模块的生成结果;只通过其中一个层级,不能推定其他层级也已通过。各次实际执行范围和结果保留在第5节。
|
||||
|
||||
@@ -643,7 +643,7 @@ node ./test/slave_example_loopback_test.cjs ./.build/slave-example/iec104_slave_
|
||||
|
||||
Spontaneous的其余检查覆盖重复IOA/有效默认值分段、单调前后推算/溢出/未来时刻、老化/倒退/重试、自己与其他发布者原文覆盖、在线已提交与重连待发统计、后快照失败/无效/计数不一致,以及离线、STOP、重复重发、ACK释放、Destroy保留原文和Close读空通知恢复。双报保留用例在272字节配置断言仅CP56仍保留,4096字节配置断言两帧都保留。实跑结果集中在第5节。
|
||||
|
||||
命令专项入口为`test/iec104_command_test.c`,复用TCP事件环测试的可控Net后端,独立驱动Slave和Command,不依赖示例应用状态。`-Suite Command`执行TCP容量1/2 × 命令独立应答槽1/4四种组合,每种96组;包含通用应答双凭证、补报及持续NORMAL积压时事务完成回归,以及10组收尾、时标与动作前准入专项、1组默认时标/决定期限边界回归、1组默认收到即过期回归、2组决定期间同点不同OA的回复回归、6组异常执行收尾回归和4组重复选择复归回归,另覆盖TEST、限定词/撤销寻址及CP56接收兼容。本轮另增3组应用拒绝原因、CP56混合错误优先级及撤销时标规则回归,实跑结论见[COT48/49验证记录](#cot48-49-validation)。默认收到即过期回归覆盖Type 58–64的13个选择/执行场景,核对唯一COT=49、P/N=1回复、无动作和无业务事件。库源文件包含`104/business/IEC104_Command.c`,测试自身包含可控TCP实现,不再额外链接Windows Net或第二份TcpServer。
|
||||
命令专项入口为`IEC60870-Slave/test/iec104_command_test.c`,复用TCP事件环测试的可控Net后端,独立驱动Slave和Command,不依赖示例应用状态。`-Suite Command`执行TCP容量1/2 × 命令独立应答槽1/4四种组合,每种96组;包含通用应答双凭证、补报及持续NORMAL积压时事务完成回归,以及10组收尾、时标与动作前准入专项、1组默认时标/决定期限边界回归、1组默认收到即过期回归、2组决定期间同点不同OA的回复回归、6组异常执行收尾回归和4组重复选择复归回归,另覆盖TEST、限定词/撤销寻址及CP56接收兼容。本轮另增3组应用拒绝原因、CP56混合错误优先级及撤销时标规则回归,实跑结论见[COT48/49验证记录](#cot48-49-validation)。默认收到即过期回归覆盖Type 58–64的13个选择/执行场景,核对唯一COT=49、P/N=1回复、无动作和无业务事件。库源文件包含`104/business/IEC104_Command.c`,测试自身包含可控TCP实现,不再额外链接Windows Net或第二份TcpServer。
|
||||
|
||||
命令原有覆盖45/46选择和直接执行、匹配/忙拒绝/撤销、三类动作结果、成功/失败终止、零/多帧返回信息、完整ASDU校验、全局FIFO、回复池满、窗口/部分写入、结果先于确认、重复及迟到事件、FINISHED配对、三个期限和时钟倒退(含期限配置0)、STOP提交竞态/FATAL、NORMAL覆盖反例、站点删除重注册、引用和单/双服务生命周期。扩展覆盖47–51/58–64;当前默认配置检查全局type_mask=0x3FFF及points=NULL、point_count=0。未启用47/58返回IGNORED的用例显式裁剪全局掩码,直接/选择执行由各点模式配置;非法配置使用保留bit14/15,另拒绝SELECT_EXECUTE点包含51/64、非法点表和时区越界。
|
||||
|
||||
@@ -720,16 +720,16 @@ Spontaneous的其余检查覆盖重复IOA/有效默认值分段、单调前后
|
||||
|
||||
| 契约 | 测试入口与函数 | 关键断言 |
|
||||
|---|---|---|
|
||||
| HIGH格式及容量 | [队列专项](../../test/iec104_response_queue_test.c):`wrapped_headers`、`capacity_exhaustion_and_output` | 2字节头及ASDU跨环保持原文;251字节可存最大249字节ASDU;FULL/ERROR不修改票据输出和队列 |
|
||||
| HIGH格式及容量 | `iec104_response_queue_test.c`:`wrapped_headers`、`capacity_exhaustion_and_output` | 2字节头及ASDU跨环保持原文;251字节可存最大249字节ASDU;FULL/ERROR不修改票据输出和队列 |
|
||||
| 凭证与NORMAL独立 | 队列专项:`precise_cancellation`、`normal_serials_independent_of_responses` | 单条取消不影响后续PENDING;HIGH不钉住NORMAL半环,NORMAL自身的编号保护仍有效 |
|
||||
| 普通/Tracked入口一致 | [传输专项](../../test/iec104_response_transport_test.c):`test_response_public_paths_share_fifo_and_quota` | 两入口共用HIGH FIFO;默认4帧配额耗尽后不能借直接构帧越过应获机会的NORMAL |
|
||||
| 普通/Tracked入口一致 | `iec104_response_transport_test.c`:`test_response_public_paths_share_fifo_and_quota` | 两入口共用HIGH FIFO;默认4帧配额耗尽后不能借直接构帧越过应获机会的NORMAL |
|
||||
| 持续负载双方推进 | 传输专项:`test_response_sustained_bidirectional_fairness` | 两队列持续补充,按k=5处理12轮ACK及回执,60帧中HIGH48帧、NORMAL12帧 |
|
||||
| 不保证跨队列点值顺序 | 传输专项:`test_response_current_value_can_precede_old_event` | 同一CA/IOA的HIGH总召当前值30先于NORMAL旧突发20到达;用独立报文字节检查 |
|
||||
| 窗口与协议期限 | 传输专项:`test_response_window_backpressure`、`test_response_due_ack_is_received_before_timeout` | k满仍可接手进HIGH,ACK释放后推进;到期提交不抢先处理远端超时 |
|
||||
| STOP与普通断线 | 传输专项:`test_response_handed_ticket_survives_stop_and_disconnect`、`test_response_stop_cancels_pending_ticket` | 非零HANDED凭证保留,PENDING被取消;交接不等于写完或ACK |
|
||||
| EOF与Close | 传输专项:`test_response_eof_drains_high_before_retaining_events`、`test_response_close_reinit_and_failed_retries` | EOF不等待NORMAL排空;Close后的保守取消及重新Init序号接续 |
|
||||
| 遥控完成与补报 | [遥控专项](../../test/iec104_command_test.c):`test_command_continuous_events`、`test_command_return_lifetime` | k=1且NORMAL仍积压时确认/返回/终止完成;STOP与本地Cancel的补报规则不混用 |
|
||||
| 示例无排空门控 | [示例专项](../../test/iec104_slave_example_test.c):`test_publication_does_not_gate_gi`、`test_command_return_precedes_publication`、`test_clock_does_not_pause_publication` | 未发布变化不阻挡总召;返校不等占位到队首;校时待确认期间继续发布 |
|
||||
| 遥控完成与补报 | `iec104_command_test.c`:`test_command_continuous_events`、`test_command_return_lifetime` | k=1且NORMAL仍积压时确认/返回/终止完成;STOP与本地Cancel的补报规则不混用 |
|
||||
| 示例无排空门控 | `iec104_slave_example_test.c`:`test_publication_does_not_gate_gi`、`test_command_return_precedes_publication`、`test_clock_does_not_pause_publication` | 未发布变化不阻挡总召;返校不等占位到队首;校时待确认期间继续发布 |
|
||||
|
||||
这些测试验证各自FIFO、公平发送机会和状态边界,不证明端到端实时期限、HIGH生产者准入公平、紧急事件不丢失或跨队列点值不回退。主站不ACK、应用不消费回执/通知、漏调遥控Complete等仍可阻碍业务;现有业务期限及集成责任见[通用应答发送变更记录](../104/IEC104_通用应答发送变更记录.md)。
|
||||
|
||||
@@ -802,7 +802,7 @@ Windows回环专项验证查询不会消费字节、部分recv后计数准确、
|
||||
|
||||
### 3.6 接收I帧的N(S)兼容边界
|
||||
|
||||
细则第8.2.1条注对应的[现行接收契约](../104/IEC104_Link_设计架构.md#link-receive-sequence-compatibility)统一忽略15位N(S)连续性,无配置开关。回归入口为[TCP调度专项](../../test/iec104_tcp_scheduler_test.c)及[事件环专项](../../test/iec104_tcp_event_ring_test.c)。下表列回归判据,实际执行范围和结果另在第5节记录;此前通过记录不代替本轮验证。
|
||||
细则第8.2.1条注对应的[现行接收契约](../104/IEC104_Link_设计架构.md#link-receive-sequence-compatibility)统一忽略15位N(S)连续性,无配置开关。回归入口为`iec104_tcp_scheduler_test.c`及`iec104_tcp_event_ring_test.c`。下表列回归判据,实际执行范围和结果另在第5节记录;此前通过记录不代替本轮验证。
|
||||
|
||||
| 场景 | 应核对的行为 |
|
||||
|---|---|
|
||||
@@ -820,7 +820,7 @@ Windows回环专项验证查询不会消费字节、部分recv后计数准确、
|
||||
|
||||
### 3.7 TESTFR主站发起后的终端行为
|
||||
|
||||
回归入口为[TCP调度专项](../../test/iec104_tcp_scheduler_test.c),契约见[TESTFR职责与生命周期](../104/IEC104_Link_设计架构.md#link-testfr-master-preference)。下表只列判据,实际执行结果另在第5节记录。
|
||||
回归入口为`iec104_tcp_scheduler_test.c`,契约见[TESTFR职责与生命周期](../104/IEC104_Link_设计架构.md#link-testfr-master-preference)。下表只列判据,实际执行结果另在第5节记录。
|
||||
|
||||
本TCP连接首次收到主站ACT之前,终端仍可按非零t3主动探测;仅收到CON不会触发抑制。该专项验证的是收到ACT后的行为切换,不是从建连起永久关闭终端心跳。
|
||||
|
||||
@@ -1189,7 +1189,7 @@ All入口在C测试结束后遇到沙箱`spawnSync EPERM`,该次脚本整体
|
||||
|
||||
2026-11-03 通用HIGH/NORMAL发送改造:删除屏障、NORMAL排空条件及示例三项跨业务门控,默认HIGH连续配额4,最小HIGH容量恢复251字节。严格GCC构建通过;应答队列9组、传输14组、TCP事件环13组、调度25组、Slave32组×2、示例141组×2、Command56组×4、Spontaneous23组×3、召唤规则3组通过。脚本末尾Node子进程启动遇沙箱EPERM,获准运行后同一真实TCP回环及10毫秒持续突发回环通过。31个公共头分别及合并通过严格C++11编译,HIGH=250按预期断言失败,251编译成功。接口迁移、行为边界和证据见[通用应答发送变更记录](../104/IEC104_通用应答发送变更记录.md)。以下日期记录保存当时事实,不代表当前接口及屏障契约。
|
||||
|
||||
2026-11-02 有序应答修复:`./scripts/build.ps1 -Test`最终完整运行退出0,严格GCC `-std=c11 -O2 -Wall -Wextra -Werror`无诊断。有序队列10组、有序传输15组、原TCP事件环13组及调度25组、Slave 32组×2、示例141组×2、Command 55组×4、Spontaneous 23组×3及召唤规则3组通过。新增测试入口为`test/iec104_ordered_queue_test.c`和`test/iec104_ordered_transport_test.c`;覆盖屏障、空NORMAL、饱和配额、半环保护、EOF、票据取消及跨Close接续、失败输出不变、遥控双凭证和FINISHED快照。
|
||||
2026-11-02 有序应答修复:`./scripts/build.ps1 -Test`最终完整运行退出0,严格GCC `-std=c11 -O2 -Wall -Wextra -Werror`无诊断。有序队列10组、有序传输15组、原TCP事件环13组及调度25组、Slave 32组×2、示例141组×2、Command 55组×4、Spontaneous 23组×3及召唤规则3组通过。新增测试入口为`iec104_ordered_queue_test.c`和`iec104_ordered_transport_test.c`(供应商快照内,已删除);覆盖屏障、空NORMAL、饱和配额、半环保护、EOF、票据取消及跨Close接续、失败输出不变、遥控双凭证和FINISHED快照。
|
||||
|
||||
真实Windows TCP常规回环及`--events 10`高频突发回环均通过,核对总召、校时、遥控与突发帧序、离线缓存及重连恢复。C++11公共头严格编译通过,HIGH=258仅触发预期静态断言,11个有序接口文档/声明/定义一致。读命令仍未实现,Type102仅验证现有否定应答。HIGH容量下限改为259;总召整体期限默认0及独立遥控收尾/时标修复均不在本次更改范围。基线、最终完整日志和尺寸/栈结果位于`.build/ordered-response-20261101/`,设计结论见[有序应答修复记录](../104/IEC104_有序应答修复记录.md)。
|
||||
|
||||
@@ -1311,9 +1311,9 @@ All入口在C测试结束后遇到沙箱`spawnSync EPERM`,该次脚本整体
|
||||
|
||||
| 入口 | 主要验证内容 |
|
||||
|---|---|
|
||||
| [IDLE传输专项](../../test/iec104_idle_transport_test.c) | HIGH/NORMAL/S/U让路、FIFO及Connection保留请求、Drive新请求、reserve、混合ACK、STOP、closing记录及重连 |
|
||||
| [扫描专项](../../test/iec104_periodic_scan_test.c) | 配置/白名单、lookup隔离、完成与计数、组优先、SQ/WAIT、组周期、点级网格、在线修改、溢出、整表替换、点级必需位图、统一中止资格及faulted/Resume |
|
||||
| [扫描TCP回环](../../test/periodic_scan_loopback_test.cjs) | 真实Windows后端、SQ=0/1、COT=1/2、点号/值/品质、STOP/START及重连 |
|
||||
| `iec104_idle_transport_test.c` | HIGH/NORMAL/S/U让路、FIFO及Connection保留请求、Drive新请求、reserve、混合ACK、STOP、closing记录及重连 |
|
||||
| `iec104_periodic_scan_test.c` | 配置/白名单、lookup隔离、完成与计数、组优先、SQ/WAIT、组周期、点级网格、在线修改、溢出、整表替换、点级必需位图、统一中止资格及faulted/Resume |
|
||||
| `periodic_scan_loopback_test.cjs` | 真实Windows后端、SQ=0/1、COT=1/2、点号/值/品质、STOP/START及重连 |
|
||||
|
||||
扫描专项矩阵为 TCP服务容量1/2 × ROW_BUDGET=256/4 × 组容量1/4;SQ跨Step反例另外以ROW_BUDGET=14构建。测试以独立预期对象集合、报文字节和定时器结果判断,不能以实现自己生成的结果作为预期。
|
||||
|
||||
@@ -1346,13 +1346,13 @@ sizeof和栈方法、结果集中于[扫描设计的实测节](../104/IEC104_Per
|
||||
|
||||
测试用独立外部主站解析真实TCP数据,四组合均通过:lib60870-C 2.4.1及c104 2.2.1分别接收SQ=0、SQ=1,检查Type20背景、Type21周期/背景的CA/OA、IOA、值、品质及TEST/P-N。Type21没有品质字段,不要求它携带IV。lib60870-C固定源码版本为`7a388e3e133999e1ca77ba7521d55d074b7cd2bc`,详细证据为`interop-RESULTS.txt`。
|
||||
|
||||
复现入口[run_periodic_scan_interop.ps1](../../test/run_periodic_scan_interop.ps1)要求调用者提供lib60870-C源码目录及装有c104的Python解释器;默认构建和生产代码不依赖它们。测试通过后已按用户要求删除本次c104隔离环境、外部源码/构建和两份互操作临时程序;保留测试源码、阶段快照及结果,删除核对见`cleanup.txt`。
|
||||
复现入口`run_periodic_scan_interop.ps1`要求调用者提供lib60870-C源码目录及装有c104的Python解释器;默认构建和生产代码不依赖它们。测试通过后已按用户要求删除本次c104隔离环境、外部源码/构建和两份互操作临时程序;保留测试源码、阶段快照及结果,删除核对见`cleanup.txt`。
|
||||
|
||||
目标主站仍须确认SQ=1接受情况、COT=2处理及它自己的w;外部开源客户端通过不代替该项联调。
|
||||
|
||||
### 6.3 实际长稳运行
|
||||
|
||||
[run_periodic_scan_soak.ps1](../../test/run_periodic_scan_soak.ps1)运行真实单调时间回环,默认86400000ms;SQ=0运行该时长,随后执行SQ=1短回归。主站逐帧检查序号、IOA、值与品质,分别检查四个COT/Type数据流持续到达;诊断与帧观察存储有界。应用退出或任何断言失败使运行失败。
|
||||
`run_periodic_scan_soak.ps1`运行真实单调时间回环,默认86400000ms;SQ=0运行该时长,随后执行SQ=1短回归。主站逐帧检查序号、IOA、值与品质,分别检查四个COT/Type数据流持续到达;诊断与帧观察存储有界。应用退出或任何断言失败使运行失败。
|
||||
|
||||
输出目录保存`result.json`、`stdout.log`和`stderr.log`。JSON记录进程号、开始/结束时间、可执行文件及测试脚本SHA256、退出码;RUNNING只表示已启动,须结合进程和日志判断是否仍在运行,只有正常结束且退出码0才记PASS。已有结果目录拒绝覆盖。包装脚本可用于短时自检,不能把缩短时长的结果计为24小时验收。
|
||||
|
||||
@@ -1366,7 +1366,7 @@ sizeof和栈方法、结果集中于[扫描设计的实测节](../104/IEC104_Per
|
||||
-OutputDirectory .build/periodic-scan-soak-24h
|
||||
```
|
||||
|
||||
[测试包装](../../test/periodic_scan_soak_example.c)包含原示例,局部截获状态、Step、生命周期、销毁和Poll调用,生产代码及点值不改。它检查`started=completed+aborted+in_progress`、对象/帧/lookup关系、完成游标、组状态、相同轮次的cycle_age及稳定网格下公开最早定时器与单调时钟的关系。4096次连续无扫描/通知进展的零等待迭代判失败,WAIT/lookups单独增长不算进展;这是本24点空闲链路夹具的空转检查,不是任意业务负载或时延保证,也不读取每组私有next_due。首次失败让示例立即退出,最终marker包含检查次数、Poll次数及最大无进展零等待次数。
|
||||
`periodic_scan_soak_example.c`包含原示例,局部截获状态、Step、生命周期、销毁和Poll调用,生产代码及点值不改。它检查`started=completed+aborted+in_progress`、对象/帧/lookup关系、完成游标、组状态、相同轮次的cycle_age及稳定网格下公开最早定时器与单调时钟的关系。4096次连续无扫描/通知进展的零等待迭代判失败,WAIT/lookups单独增长不算进展;这是本24点空闲链路夹具的空转检查,不是任意业务负载或时延保证,也不读取每组私有next_due。首次失败让示例立即退出,最终marker包含检查次数、Poll次数及最大无进展零等待次数。
|
||||
|
||||
### 6.4 点级单点RETRY回归(2026-11-06,局部中止恢复之前)
|
||||
|
||||
@@ -1591,7 +1591,7 @@ Windows x64、GCC 16.1.0、默认4任务槽实测:
|
||||
|
||||
### 12.3 示例参数应用处理验证(2026-11-07)
|
||||
|
||||
本次把门限、上下限和平滑时间接入主示例的应用测量链,处理规则见[参数应用](../examples/IEC104子站示例.md#example-parameter)。协议模块接口不变;独立双主站小示例继续只演示参数共享和读回。新增6组位于[示例测试](../../test/iec104_slave_example_test.c)的`[PARAMETER/MEASUREMENT]`区,参数由真实110–112请求写入,输入和单调时钟由夹具控制,不用真实等待代替边界断言。
|
||||
本次把门限、上下限和平滑时间接入主示例的应用测量链,处理规则见[参数应用](../examples/IEC104子站示例.md#example-parameter)。协议模块接口不变;独立双主站小示例继续只演示参数共享和读回。新增6组位于`iec104_slave_example_test.c`的`[PARAMETER/MEASUREMENT]`区,参数由真实110–112请求写入,输入和单调时钟由夹具控制,不用真实等待代替边界断言。
|
||||
|
||||
| 测试函数 | 覆盖范围 |
|
||||
|---|---|
|
||||
@@ -1618,7 +1618,7 @@ Windows x64尺寸测量:`ExampleApp`由5616增至5816字节,增加200字节
|
||||
|
||||
### 12.4 示例默认运行策略覆盖(2026-11-08)
|
||||
|
||||
主示例默认启用参数,使用field模拟采样,以门限变化上送和低频背景刷新运行;固定周期上送需显式启用。默认值、模拟波形及复位边界以[示例运行说明](../examples/IEC104子站示例.md#example-simulation)为准。这是可复现的演示工况,不代表现场标定或硬件采集。新增5组位于[示例测试](../../test/iec104_slave_example_test.c),使用可控时钟推进采样与扫描,现行Example矩阵为TCP容量1/2各195组,参数集成共14组。
|
||||
主示例默认启用参数,使用field模拟采样,以门限变化上送和低频背景刷新运行;固定周期上送需显式启用。默认值、模拟波形及复位边界以[示例运行说明](../examples/IEC104子站示例.md#example-simulation)为准。这是可复现的演示工况,不代表现场标定或硬件采集。新增5组位于`iec104_slave_example_test.c`,使用可控时钟推进采样与扫描,现行Example矩阵为TCP容量1/2各195组,参数集成共14组。
|
||||
|
||||
| 测试函数 | 覆盖范围 |
|
||||
|---|---|
|
||||
@@ -1628,7 +1628,7 @@ Windows x64尺寸测量:`ExampleApp`由5616增至5816字节,增加200字节
|
||||
| `test_example_field_profile_unfiltered` | 关闭参数时仍使用field模拟;±10000饱和且同值不排队,反向变化正常上送,遥信不自动翻转 |
|
||||
| `test_example_field_profile_background` | 默认无COT1;未达到变化门限时,30秒COT2仍读回当前值且不改变变化基准;随后累计变化199/200边界保持有效 |
|
||||
|
||||
[主Node回环](../../test/slave_example_loopback_test.cjs)另检查模拟模式非法值、默认及覆盖后的PROFILE输出、参数开关顺序,并执行两个field场景:默认30秒背景配置及显式300毫秒背景配置。前者核对默认策略、总召参数及阶跃COT3;后者在真实TCP连接上核对未达门限时仍有COT2刷新。常规精确读回场景使用`--events 0`,持续突发和QRP2积压场景显式使用stress;独立多主站示例仍沿用其原配置。以上为现行覆盖说明,本轮构建及实跑结果单列记录。
|
||||
`slave_example_loopback_test.cjs`另检查模拟模式非法值、默认及覆盖后的PROFILE输出、参数开关顺序,并执行两个field场景:默认30秒背景配置及显式300毫秒背景配置。前者核对默认策略、总召参数及阶跃COT3;后者在真实TCP连接上核对未达门限时仍有COT2刷新。常规精确读回场景使用`--events 0`,持续突发和QRP2积压场景显式使用stress;独立多主站示例仍沿用其原配置。以上为现行覆盖说明,本轮构建及实跑结果单列记录。
|
||||
|
||||
2026-11-08实跑结果:`./scripts/build.ps1 -Test -Suite Example -BuildName field-profile-example`的TCP容量1/2两配置各195组全部通过。最终默认产物由`./scripts/build.ps1 -Test -Suite Loopback`重建;首次因沙箱禁止Node启动子进程而报`spawnSync EPERM`,获准后原命令重跑退出0。Windows Net回环、CLI、七个主Node TCP场景、扫描SQ=0/1及独立双主站回环全部通过;短背景field场景确认2001门限50时依次上送2350、2400、2651,期间背景刷新不重置COT3比较基准。示例及所运行C配置均以GCC `-std=c11 -O2 -Wall -Wextra -Werror`构建,零错误、零警告。
|
||||
|
||||
@@ -1638,7 +1638,7 @@ Windows x64尺寸测量:`ExampleApp`由5616增至5816字节,增加200字节
|
||||
|
||||
### 12.5 示例参数文件验证
|
||||
|
||||
[参数文件回环](../../test/parameter_config_loopback_test.cjs)使用本次构建的主示例、真实TCP和独立测试文件,验证`--config`的标准参数、远程定值和TEMP持久化行为。配置规则以[参数持久化说明](../examples/IEC104子站示例.md#example-parameter-persistence)为准,标准参数模块的APPLIED与确认语义保持不变。统一INI及旧格式迁移夹具由测试独立构造、解析和校验,不复用被测C模块的编解码器。
|
||||
`parameter_config_loopback_test.cjs`使用本次构建的主示例、真实TCP和独立测试文件,验证`--config`的标准参数、远程定值和TEMP持久化行为。配置规则以[参数持久化说明](../examples/IEC104子站示例.md#example-parameter-persistence)为准,标准参数模块的APPLIED与确认语义保持不变。统一INI及旧格式迁移夹具由测试独立构造、解析和校验,不复用被测C模块的编解码器。
|
||||
|
||||
```powershell
|
||||
./scripts/build.ps1 -Test -Suite Loopback
|
||||
@@ -1761,9 +1761,9 @@ node ./test/parameter_config_loopback_test.cjs ./.build/slave-example/iec104_sla
|
||||
./scripts/build.ps1 -Test -Suite All -BuildName software-upgrade-all
|
||||
```
|
||||
|
||||
[公开专项](../../test/iec104_software_upgrade_test.c)使用真实Slave/TCP/发送层和可控Net,矩阵为TCP容量1/2 × 任务槽1/2 × restart_policy=ACKED/ACTIVE_ACKED。HIGH=251,ACK观察槽=1,故障替身仅在`IEC104_SOFTWARE_UPGRADE_TEST_HOOKS`下启用。主示例和Example测试构建时配置两个观察槽,库默认仍为1。
|
||||
`iec104_software_upgrade_test.c`使用真实Slave/TCP/发送层和可控Net,矩阵为TCP容量1/2 × 任务槽1/2 × restart_policy=ACKED/ACTIVE_ACKED。HIGH=251,ACK观察槽=1,故障替身仅在`IEC104_SOFTWARE_UPGRADE_TEST_HOOKS`下启用。主示例和Example测试构建时配置两个观察槽,库默认仍为1。
|
||||
|
||||
[升级TCP回环](../../test/software_upgrade_loopback_test.cjs)独立构造211确认及210工程升级包,用生产Windows后端运行:禁用211回44、CLI依赖、无会话END/撤销、TEST、包长度/CRC拒绝、跨段包头、上传后END、有效ACK后模拟重启、Type70及202版本/CRC读回、105保留映像、连续升级释放owner。它已注册到Loopback/All。
|
||||
`software_upgrade_loopback_test.cjs`独立构造211确认及210工程升级包,用生产Windows后端运行:禁用211回44、CLI依赖、无会话END/撤销、TEST、包长度/CRC拒绝、跨段包头、上传后END、有效ACK后模拟重启、Type70及202版本/CRC读回、105保留映像、连续升级释放owner。它已注册到Loopback/All。
|
||||
|
||||
状态、计数和产品边界见[软件升级设计](../104/IEC104_SoftwareUpgrade_设计架构.md)。宿主协议与RAM示例的验证不替代目标ARMCC预算、实际Flash、掉电、Bootloader或独立目标主站互操作。
|
||||
|
||||
@@ -1813,9 +1813,9 @@ Example最终独立矩阵使用`-BuildName upgrade-example-owner`:容量1为20
|
||||
./scripts/build.ps1 -Test -Suite All -BuildName type42-all
|
||||
```
|
||||
|
||||
[公共编解码专项](../../test/iec60870_fault_event_test.c)使用独立35字节预期报文,覆盖COT/CA宽度1/2、IOA宽度1/2/3、遥信1/3/30/31及遥测9/11/13的144种组合、256种VSQ、负浮点与0xFFFF原码、无QDS、逐字节截短与尾随字节、非法字段和失败输出不变。Common和FaultEvent套件均包含该测试的默认/纯整数时间后端配置,All只运行一次这两个配置。
|
||||
`iec60870_fault_event_test.c`使用独立35字节预期报文,覆盖COT/CA宽度1/2、IOA宽度1/2/3、遥信1/3/30/31及遥测9/11/13的144种组合、256种VSQ、负浮点与0xFFFF原码、无QDS、逐字节截短与尾随字节、非法字段和失败输出不变。Common和FaultEvent套件均包含该测试的默认/纯整数时间后端配置,All只运行一次这两个配置。
|
||||
|
||||
[业务上送专项](../../test/iec104_fault_event_test.c)使用真实Slave、TcpServer、队列和发送管理器,可控Net后端仅模拟I/O与时钟。矩阵为`(TCP服务容量,NORMAL字节)=(1,4096)/(2,4096)/(1,272)`,每配置分别运行兼容与严格调度,共12组。主要断言包括:
|
||||
`iec104_fault_event_test.c`使用真实Slave、TcpServer、队列和发送管理器,可控Net后端仅模拟I/O与时钟。矩阵为`(TCP服务容量,NORMAL字节)=(1,4096)/(2,4096)/(1,272)`,每配置分别运行兼容与严格调度,共12组。主要断言包括:
|
||||
|
||||
- 77字节Type42 ASDU经真实发送路径组成83字节I帧,逐字节比对独立预期值;两类地址均为3字节,无额外IOA或遥测QDS。
|
||||
- WAIT、随后校时、调用方复用数组、未确认断线及重连后的报文保持原快照;新启动轮次仍受门禁约束,旧轮次身份不能释放新门禁,真实ACK后才回收缓存。
|
||||
@@ -1858,16 +1858,16 @@ Recording套件构建主示例及3个C专项程序;专项额外使用`-std=c99
|
||||
|
||||
| 验证目标 | 测试入口与主要断言 | 证据边界 |
|
||||
|---|---|---|
|
||||
| 前4周波、后8周波及至少80点/周波 | [录波核心](../../test/iec60870_fault_recorder_test.c)检查默认320/640个采样间隔、含两端的961帧、触发下标320;4001 Hz向上取整及60 Hz配置也有覆盖 | 校验整数窗口和配置约束,不测真实采样节拍、抖动或实际工频 |
|
||||
| 前4周波、后8周波及至少80点/周波 | `iec60870_fault_recorder_test.c`检查默认320/640个采样间隔、含两端的961帧、触发下标320;4001 Hz向上取整及60 Hz配置也有覆盖 | 校验整数窗口和配置约束,不测真实采样节拍、抖动或实际工频 |
|
||||
| 环形历史与故障窗口完整性 | 同一专项覆盖物理回绕、延迟触发、历史不足、缺帧、重复序号、忙态、序号溢出、Release重建及重叠输出拒绝 | 单缓冲冻结模型;不提供多记录连续采集或并发访问证明 |
|
||||
| 八路电气量及遥信位序 | [编码专项](../../test/iec60870_comtrade_test.c)检查Ua/Ub/Uc/U0/Ia/Ib/Ic/I0;遥信数量1/16/17/31/32/33/64,末字多余位清零 | 验证通道编码,不证明板级接线、量纲标定或八路同一时刻性 |
|
||||
| 八路电气量及遥信位序 | `iec60870_comtrade_test.c`检查Ua/Ub/Uc/U0/Ia/Ib/Ic/I0;遥信数量1/16/17/31/32/33/64,末字多余位清零 | 验证通道编码,不证明板级接线、量纲标定或八路同一时刻性 |
|
||||
| CFG文本、比例和日期 | 编码专项检查1999字段、ASCII/CRLF、NUL不计入长度、先查容量再输出、系数/名称校验、闰日/跨年和微秒舍入 | 覆盖当前单采样率格式;未使用实际主站客户端或录波分析工具解析 |
|
||||
| DAT二进制及任意偏移 | 编码专项检查小端点号/微秒时标、有符号模拟量、`-32768`缺测编码、26字节记录和24,986字节总长;跨帧切片、重复偏移、越界及EOF零长度 | 文件字节一致不等于输入样本来自真实故障 |
|
||||
| 配对名称和保存 | [主机适配专项](../../test/iec104_example_recording_test.c)检查BAY完整名称、目录前缀、模拟标识、触发时间别名、磁盘与内存相同、已存在文件/暂存名不覆盖、非法父目录拒绝 | 未模拟写入中断、每个rename失败点或物理掉电;不验证重启恢复目录 |
|
||||
| TI42冻结快照和文件可见性 | [Example专项](../../test/iec104_slave_example_test.c)的`test_example_recording_publication`检查WAIT期间时钟变化后仍使用同一遥信、八项测量和时标;未发布不可读取,成功后新目录快照可见CFG/DAT | `published`仅表示入队;原先打开的空目录仍保持空快照,不代表事件已ACK |
|
||||
| 配对名称和保存 | `iec104_example_recording_test.c`检查BAY完整名称、目录前缀、模拟标识、触发时间别名、磁盘与内存相同、已存在文件/暂存名不覆盖、非法父目录拒绝 | 未模拟写入中断、每个rename失败点或物理掉电;不验证重启恢复目录 |
|
||||
| TI42冻结快照和文件可见性 | `iec104_slave_example_test.c`的`test_example_recording_publication`检查WAIT期间时钟变化后仍使用同一遥信、八项测量和时标;未发布不可读取,成功后新目录快照可见CFG/DAT | `published`仅表示入队;原先打开的空目录仍保持空快照,不代表事件已ACK |
|
||||
| 完整路径、重复读及读句柄归属 | 同文件的`test_example_recording_file_reads`按目录返回路径读取两文件,拒绝仅基本名,核对重复偏移、过期句柄与关闭后读取 | 该单元用例手动置`saved`隔离发布/读取;实际保存由主机适配专项和TCP回环覆盖 |
|
||||
| 非空目录末页与有界扫描 | [文件服务专项](../../test/iec104_file_service_test.c)的`test_directory_lookahead`覆盖预算1/2/64、名称长度1/100/218、过滤尾部、发送WAIT后的原页重建和前瞻错误;匹配项无遗漏且末页仍含项 | 真正空目录仍发规范零项末帧,未虚构条目规避接收端静态分析中发现的限制 |
|
||||
| 主动召取和网络/磁盘一致 | [Node回环](../../test/slave_example_loopback_test.cjs)用目录ID6请求COMTRADE、检查回复ID0、原样回传目录文件名、核对段校验和及大小、只在末段后发op6=0;所有下载字节与磁盘比较 | 测试客户端模拟相关行为,不等同于实际主站软件互操作 |
|
||||
| 非空目录末页与有界扫描 | `iec104_file_service_test.c`的`test_directory_lookahead`覆盖预算1/2/64、名称长度1/100/218、过滤尾部、发送WAIT后的原页重建和前瞻错误;匹配项无遗漏且末页仍含项 | 真正空目录仍发规范零项末帧,未虚构条目规避接收端静态分析中发现的限制 |
|
||||
| 主动召取和网络/磁盘一致 | `slave_example_loopback_test.cjs`用目录ID6请求COMTRADE、检查回复ID0、原样回传目录文件名、核对段校验和及大小、只在末段后发op6=0;所有下载字节与磁盘比较 | 测试客户端模拟相关行为,不等同于实际主站软件互操作 |
|
||||
|
||||
Node回环在启动总召后立即召目录,不先等待TI42;接收断言要求先收到TI42,再收到首个文件服务应答。下载后用独立JavaScript解析CFG/DAT,检查50 Hz、4000 Hz、961点、首点至触发80 ms、每点250 μs、遥信在下标320/360改变,以及模拟电压减半、电流增至5倍。相同回环还回归原SOE文件及12段TEMP突发写入/读回。这一结果只证明该连接、队列和故障场景下的顺序,不能推广为NORMAL覆盖、断线、协议复位后的持久送达保证。
|
||||
|
||||
@@ -1905,13 +1905,13 @@ Node回环在启动总召后立即召目录,不先等待TI42;接收断言要
|
||||
|
||||
| 测试入口 | 主要验证 |
|
||||
|---|---|
|
||||
| [iec60870_energy_freeze_test.c](../../test/iec60870_energy_freeze_test.c) | 配置指纹、网格与日界、检查顺序、Due纯查询、保留推进、SEAL空窗/摘要、META中断及回退边界、FLOW环绕与去重、重新Init |
|
||||
| [iec60870_energy_freeze_file_test.c](../../test/iec60870_energy_freeze_file_test.c) | FRZ结构、原始节号、缺DAY、单位转义、FLOW展开及无效点过滤、SEAL不一致、sink失败 |
|
||||
| [iec104_example_energy_freeze_test.c](../../test/iec104_example_energy_freeze_test.c) | Windows双bank五态、三次同步中断、已提交损坏拒绝回退、目录和独立读快照、30日目录耗时 |
|
||||
| [iec104_energy_freeze_transitions_test.c](../../test/iec104_energy_freeze_transitions_test.c) | 初始META、INTERVAL/DAY、补DAY、保留推进和封存的7组提交矩阵,在36个真实Flush边界中断并重新打开;FLOW中断由宿主适配专项覆盖 |
|
||||
| [iec104_example_energy_meter_test.c](../../test/iec104_example_energy_meter_test.c) | 整数方波纯函数、八值支配、20万原像/固定点样本、校时分段、回拨FLOW、事件预算/丢弃计数及溢出 |
|
||||
| [iec104_slave_example_test.c](../../test/iec104_slave_example_test.c)中的`test_example_energy` | 非0x05 QCC拒绝、大于int32的206取值、BEGIN确认WAIT保持快照、QRP1保留计量源 |
|
||||
| [energy_freeze_loopback_test.cjs](../../test/energy_freeze_loopback_test.cjs) | 独立构造TCP主站报文,96节加DAY下载、地址/时标/条数、目录时间筛选、FLOW文件、强制结束进程后恢复 |
|
||||
| `iec60870_energy_freeze_test.c` | 配置指纹、网格与日界、检查顺序、Due纯查询、保留推进、SEAL空窗/摘要、META中断及回退边界、FLOW环绕与去重、重新Init |
|
||||
| `iec60870_energy_freeze_file_test.c` | FRZ结构、原始节号、缺DAY、单位转义、FLOW展开及无效点过滤、SEAL不一致、sink失败 |
|
||||
| `iec104_example_energy_freeze_test.c` | Windows双bank五态、三次同步中断、已提交损坏拒绝回退、目录和独立读快照、30日目录耗时 |
|
||||
| `iec104_energy_freeze_transitions_test.c` | 初始META、INTERVAL/DAY、补DAY、保留推进和封存的7组提交矩阵,在36个真实Flush边界中断并重新打开;FLOW中断由宿主适配专项覆盖 |
|
||||
| `iec104_example_energy_meter_test.c` | 整数方波纯函数、八值支配、20万原像/固定点样本、校时分段、回拨FLOW、事件预算/丢弃计数及溢出 |
|
||||
| `iec104_slave_example_test.c`中的`test_example_energy` | 非0x05 QCC拒绝、大于int32的206取值、BEGIN确认WAIT保持快照、QRP1保留计量源 |
|
||||
| `energy_freeze_loopback_test.cjs` | 独立构造TCP主站报文,96节加DAY下载、地址/时标/条数、目录时间筛选、FLOW文件、强制结束进程后恢复 |
|
||||
|
||||
核心、XML、后端和计量测试使用`-std=c99 -pedantic -O2 -Wall -Wextra -Werror`。主示例使用现有C11严格构建。TCP测试自动分配本机回环端口,产物仅写入工程`.build/energy-loopback-*`;Type103只调整应用模拟墙钟,不修改Windows系统时间。XML另交PowerShell/.NET的`XmlDocument`独立解析。
|
||||
|
||||
@@ -101,6 +101,7 @@ digraph refgraph_full {
|
||||
"App/iec60870/104/iec104_comm.h" [fillcolor="#dbeafe", color="#1d4ed8"];
|
||||
"App/iec60870/104/iec104_core.c" [fillcolor="#dbeafe", color="#1d4ed8"];
|
||||
"App/iec60870/104/iec104_core.h" [fillcolor="#dbeafe", color="#1d4ed8"];
|
||||
"App/iec60870/104/iec104_dtu_profile.h" [fillcolor="#dbeafe", color="#1d4ed8"];
|
||||
"App/iec60870/104/iec104_dtu_table.c" [fillcolor="#dbeafe", color="#1d4ed8"];
|
||||
"App/iec60870/104/iec104_dtu_table.h" [fillcolor="#dbeafe", color="#1d4ed8"];
|
||||
"App/iec60870/104/iec104_net_mcu.c" [fillcolor="#dbeafe", color="#1d4ed8"];
|
||||
@@ -123,7 +124,6 @@ digraph refgraph_full {
|
||||
"App/iec60870/common/IEC60870_Time.c" [fillcolor="#dbeafe", color="#1d4ed8"];
|
||||
"App/iec60870/common/IEC60870_Time.h" [fillcolor="#dbeafe", color="#1d4ed8"];
|
||||
"App/iec60870/common/IEC60870_Types.h" [fillcolor="#dbeafe", color="#1d4ed8"];
|
||||
"App/iec60870/examples/iec104_dtu_profile.h" [fillcolor="#dbeafe", color="#1d4ed8"];
|
||||
"App/log/console_log.c" [fillcolor="#dbeafe", color="#1d4ed8"];
|
||||
"App/log/console_log.h" [fillcolor="#dbeafe", color="#1d4ed8"];
|
||||
"App/log/soe_rec.c" [fillcolor="#dbeafe", color="#1d4ed8"];
|
||||
@@ -873,8 +873,9 @@ digraph refgraph_full {
|
||||
"App/iec60870/104/iec104_core.c" -> "App/iec60870/104/iec104_source.h" [color="#2563eb", penwidth=1.0];
|
||||
"App/iec60870/104/iec104_core.c" -> "外部/系统头文件" [color="#f59e0b", penwidth=0.6, style=dashed];
|
||||
"App/iec60870/104/iec104_core.h" -> "外部/系统头文件" [color="#f59e0b", penwidth=0.6, style=dashed];
|
||||
"App/iec60870/104/iec104_dtu_profile.h" -> "外部/系统头文件" [color="#f59e0b", penwidth=0.6, style=dashed];
|
||||
"App/iec60870/104/iec104_dtu_table.c" -> "App/iec60870/104/iec104_dtu_profile.h" [color="#2563eb", penwidth=1.0];
|
||||
"App/iec60870/104/iec104_dtu_table.c" -> "App/iec60870/104/iec104_dtu_table.h" [color="#2563eb", penwidth=1.0];
|
||||
"App/iec60870/104/iec104_dtu_table.c" -> "App/iec60870/examples/iec104_dtu_profile.h" [color="#2563eb", penwidth=1.0];
|
||||
"App/iec60870/104/iec104_dtu_table.c" -> "外部/系统头文件" [color="#f59e0b", penwidth=0.6, style=dashed];
|
||||
"App/iec60870/104/iec104_dtu_table.h" -> "外部/系统头文件" [color="#f59e0b", penwidth=0.6, style=dashed];
|
||||
"App/iec60870/104/iec104_net_mcu.c" -> "App/iec60870/104/IEC104_Net.h" [color="#2563eb", penwidth=1.0];
|
||||
@@ -918,7 +919,6 @@ digraph refgraph_full {
|
||||
"App/iec60870/common/IEC60870_Time.h" -> "外部/系统头文件" [color="#f59e0b", penwidth=0.6, style=dashed];
|
||||
"App/iec60870/common/IEC60870_Types.h" -> "App/iec60870/common/IEC60870_StaticAssert.h" [color="#2563eb", penwidth=1.0];
|
||||
"App/iec60870/common/IEC60870_Types.h" -> "外部/系统头文件" [color="#f59e0b", penwidth=0.6, style=dashed];
|
||||
"App/iec60870/examples/iec104_dtu_profile.h" -> "外部/系统头文件" [color="#f59e0b", penwidth=0.6, style=dashed];
|
||||
"App/log/console_log.c" -> "App/app/sys_events.h" [color="#2563eb", penwidth=1.0];
|
||||
"App/log/console_log.c" -> "App/log/console_log.h" [color="#2563eb", penwidth=1.0];
|
||||
"App/log/console_log.c" -> "Inc/usart.h" [color="#2563eb", penwidth=1.0];
|
||||
|
||||
+28
-29
@@ -397,6 +397,10 @@
|
||||
"path": "App/iec60870/104/iec104_core.h",
|
||||
"class": "fp"
|
||||
},
|
||||
{
|
||||
"path": "App/iec60870/104/iec104_dtu_profile.h",
|
||||
"class": "fp"
|
||||
},
|
||||
{
|
||||
"path": "App/iec60870/104/iec104_dtu_table.c",
|
||||
"class": "fp"
|
||||
@@ -485,10 +489,6 @@
|
||||
"path": "App/iec60870/common/IEC60870_Types.h",
|
||||
"class": "fp"
|
||||
},
|
||||
{
|
||||
"path": "App/iec60870/examples/iec104_dtu_profile.h",
|
||||
"class": "fp"
|
||||
},
|
||||
{
|
||||
"path": "App/log/console_log.c",
|
||||
"class": "fp"
|
||||
@@ -9395,6 +9395,24 @@
|
||||
"kind": "fp-ext",
|
||||
"include": "stdint.h"
|
||||
},
|
||||
{
|
||||
"from": "App/iec60870/104/iec104_dtu_profile.h",
|
||||
"to": "外部/系统头文件",
|
||||
"kind": "fp-ext",
|
||||
"include": "stdbool.h"
|
||||
},
|
||||
{
|
||||
"from": "App/iec60870/104/iec104_dtu_profile.h",
|
||||
"to": "外部/系统头文件",
|
||||
"kind": "fp-ext",
|
||||
"include": "stddef.h"
|
||||
},
|
||||
{
|
||||
"from": "App/iec60870/104/iec104_dtu_profile.h",
|
||||
"to": "外部/系统头文件",
|
||||
"kind": "fp-ext",
|
||||
"include": "stdint.h"
|
||||
},
|
||||
{
|
||||
"from": "App/iec60870/104/iec104_dtu_table.c",
|
||||
"to": "App/iec60870/104/iec104_dtu_table.h",
|
||||
@@ -9403,7 +9421,7 @@
|
||||
},
|
||||
{
|
||||
"from": "App/iec60870/104/iec104_dtu_table.c",
|
||||
"to": "App/iec60870/examples/iec104_dtu_profile.h",
|
||||
"to": "App/iec60870/104/iec104_dtu_profile.h",
|
||||
"kind": "fp-fp",
|
||||
"include": "iec104_dtu_profile.h"
|
||||
},
|
||||
@@ -10223,24 +10241,6 @@
|
||||
"kind": "fp-fp",
|
||||
"include": "IEC60870_StaticAssert.h"
|
||||
},
|
||||
{
|
||||
"from": "App/iec60870/examples/iec104_dtu_profile.h",
|
||||
"to": "外部/系统头文件",
|
||||
"kind": "fp-ext",
|
||||
"include": "stdbool.h"
|
||||
},
|
||||
{
|
||||
"from": "App/iec60870/examples/iec104_dtu_profile.h",
|
||||
"to": "外部/系统头文件",
|
||||
"kind": "fp-ext",
|
||||
"include": "stddef.h"
|
||||
},
|
||||
{
|
||||
"from": "App/iec60870/examples/iec104_dtu_profile.h",
|
||||
"to": "外部/系统头文件",
|
||||
"kind": "fp-ext",
|
||||
"include": "stdint.h"
|
||||
},
|
||||
{
|
||||
"from": "App/log/console_log.c",
|
||||
"to": "App/log/console_log.h",
|
||||
@@ -54701,6 +54701,11 @@
|
||||
"App/iec60870/104/iec104_core.h": [
|
||||
"stdint.h"
|
||||
],
|
||||
"App/iec60870/104/iec104_dtu_profile.h": [
|
||||
"stdbool.h",
|
||||
"stddef.h",
|
||||
"stdint.h"
|
||||
],
|
||||
"App/iec60870/104/iec104_dtu_table.c": [
|
||||
"string.h"
|
||||
],
|
||||
@@ -54757,11 +54762,6 @@
|
||||
"App/iec60870/common/IEC60870_Types.h": [
|
||||
"stdint.h"
|
||||
],
|
||||
"App/iec60870/examples/iec104_dtu_profile.h": [
|
||||
"stdbool.h",
|
||||
"stddef.h",
|
||||
"stdint.h"
|
||||
],
|
||||
"App/log/console_log.c": [
|
||||
"stdio.h"
|
||||
],
|
||||
@@ -57843,7 +57843,6 @@
|
||||
"App/iec60870/common",
|
||||
"App/iec60870/104",
|
||||
"App/iec60870/104/business",
|
||||
"App/iec60870/examples",
|
||||
"App/util",
|
||||
"Middlewares/Third_Party/FreeRTOS/Source/include",
|
||||
"Middlewares/Third_Party/FreeRTOS/Source/CMSIS_RTOS_V2",
|
||||
|
||||
+1538
-1538
File diff suppressed because it is too large
Load Diff
|
Before Width: | Height: | Size: 1.3 MiB After Width: | Height: | Size: 1.3 MiB |
@@ -960,7 +960,7 @@
|
||||
},
|
||||
{
|
||||
"code_lines": 585,
|
||||
"path": "App/iec60870/examples/iec104_dtu_profile.h"
|
||||
"path": "App/iec60870/104/iec104_dtu_profile.h"
|
||||
},
|
||||
{
|
||||
"code_lines": 579,
|
||||
|
||||
@@ -65,7 +65,6 @@ include_directories(
|
||||
${IEC60870_DIR}/common
|
||||
${IEC60870_DIR}/104
|
||||
${IEC60870_DIR}/104/business
|
||||
${IEC60870_DIR}/examples
|
||||
${SDL2_DIR}/include # SDL2 头文件
|
||||
)
|
||||
|
||||
|
||||
@@ -11,7 +11,7 @@
|
||||
## 前置条件
|
||||
|
||||
- Real board: powered, reachable at `192.168.31.100`, firmware IEC104 listener on `2404`,
|
||||
profile table matching `App/iec60870/examples/iec104_dtu_profile.h`.
|
||||
profile table matching `App/iec60870/104/iec104_dtu_profile.h`.
|
||||
- Simulator: `simulator/build/Debug/lvgl_sim.exe` built with IEC104 headless CLI,
|
||||
chosen port free, Windows `Get-NetTCPConnection` available for the LAN bind probe.
|
||||
- All three scripts are Python 3 standard library only. They print ASCII only and
|
||||
|
||||
Reference in New Issue
Block a user