docs(iec60870): 4 篇文档首行改一级标题,删两处变更记录节

4 篇 common/ 设计文档原以 <a id="..."></a> 空锚点开头,一级标题在第 2 或
第 3 行,不符合 docs/文档规范.md §5.1「文档首行为 # 标题」。已删掉文档级
锚点行,让一级标题回到首行;11 处指向这些锚点的跨文档链接同步去掉
#anchor 后缀(同文档本就只有一个一级主题,去掉后缀仍指向文件顶部)。

删除两处「变更记录」节(规范 §5.1:一律不设该节,改动过程查 git log):
- 104/IEC104_设计架构.md:删「## 八、变更记录」8 行表;原第九、第十节
  前移为第八、第九节,其下 9.1~9.6 子节号同步重排,全文无 10.x 残留。
- 104/IEC104_Link_设计架构.md:删「### 9.2 变更记录」42 行表;「## 九、
  设计决策与变更记录」改名「## 九、设计决策」,9.1 保留。

验证:check_doc_links.py --all --sections-strict RC=0(308 篇全过,问题 0);
mermaid 预检 10 文件 18 块新发 0;pre_commit 6 Passed / 0 Failed;
6 文件 BOM=False / CR=0 / U+FFFD=0。纯文档改动,未碰代码与构建。
This commit is contained in:
2026-11-18 22:57:58 +08:00
parent b7a23d9f85
commit 11f7c07b3d
15 changed files with 20 additions and 87 deletions
+1 -1
View File
@@ -153,7 +153,7 @@ IEC60870-Slave/
## 接入自己的工程
附录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#user-log-design),操作见[日志示例](../docs/iec60870/examples/IEC104子站示例.md#example-user-log),验证见[日志测试](../docs/iec60870/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/iec60870/common/IEC60870_History_设计架构.md),启动和调阅见[历史示例](../docs/iec60870/examples/IEC104子站示例.md#example-history),专项入口见[历史测试](../docs/iec60870/test/IEC104测试文档.md#history-tests)。
+1 -1
View File
@@ -5058,7 +5058,7 @@ bool IEC60870_HistoryFile_Write(IEC60870_History_t *history,
## 39. IEC60870_UserLog.c
实现:`IEC60870_UserLog.c`;声明:`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 输入、存储与所有权
+1 -48
View File
@@ -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)。 |
@@ -10,7 +10,7 @@
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)。
@@ -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查询;跨等级票据不能比较数值大小来推断谁先交接。兼容模式普通直交可成功返回零票据;严格模式排队与队满直交都返回真实非零票据。未提交时的初始零值不能当作完成。
@@ -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>
## 二、对象、身份与状态归属
+8 -21
View File
@@ -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,7 +572,7 @@ 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的地址按十六进制解释。以下是这些要求在当前工程中的落点,不代表对整份实施细则的完整符合性声明。
@@ -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
View File
@@ -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)。
+2 -2
View File
@@ -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)。
@@ -1,4 +1,3 @@
<a id="energy-freeze-design"></a>
# 冻结电能、潮流反转与持久恢复
> **本项目未实现**:本文描述的能力在本仓 `App/iec60870/` 中**没有对应实现**(相关 `.c/.h` 在 2026-11-18 收编时裁除)。保留本文仅作协议能力与技术参考,不要据此判断功能可用;源码快照见 `IEC60870-Slave/`(该目录将来会删除)。
@@ -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 反向展开为历史事件,避免把网络重试或合成报告误记为新变位。
@@ -27,7 +27,7 @@
录波核心不依赖编码器;编码器依赖录波只读接口与`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 数据流
@@ -1,5 +1,3 @@
<a id="firmware-update-design"></a>
# 持久化软件安装与恢复设计
> **本项目未实现**:本文描述的能力在本仓 `App/iec60870/` 中**没有对应实现**(相关 `.c/.h` 在 2026-11-18 收编时裁除)。保留本文仅作协议能力与技术参考,不要据此判断功能可用;源码快照见 `IEC60870-Slave/`(该目录将来会删除)。
@@ -1,12 +1,10 @@
<a id="history-design"></a>
# 历史记录、持久存储与 XML 文件生成
> **本项目未实现**:本文描述的能力在本仓 `App/iec60870/` 中**没有对应实现**(相关 `.c/.h` 在 2026-11-18 收编时裁除)。保留本文仅作协议能力与技术参考,不要据此判断功能可用;源码快照见 `IEC60870-Slave/`(该目录将来会删除)。
本模块实现`20170804163032284877151.pdf`附录 B 的 SOE、遥控操作、定点和极值记录。循环记录与 XML 编码可移植;示例通过 Windows 文件后端提供持久化,再由现有 TI=210 文件服务提供目录和下载。FRZ、FLOWREV 与附录 C 的 ULOG 不在本模块范围内。
ULOG由独立的[运行日志模块](IEC60870_UserLog_设计架构.md#user-log-design)实现1024条循环及XML,示例通过`--user-log`启用并使用`ulog.store`;可与`--history`共用父目录,但不共用核心实例、槽布局或持久文件。
ULOG由独立的[运行日志模块](IEC60870_UserLog_设计架构.md)实现1024条循环及XML,示例通过`--user-log`启用并使用`ulog.store`;可与`--history`共用父目录,但不共用核心实例、槽布局或持久文件。
## 1. 模块边界
@@ -1,5 +1,3 @@
<a id="user-log-design"></a>
# 附录 C 运行日志设计
> **本项目未实现**:本文描述的能力在本仓 `App/iec60870/` 中**没有对应实现**(相关 `.c/.h` 在 2026-11-18 收编时裁除)。保留本文仅作协议能力与技术参考,不要据此判断功能可用;源码快照见 `IEC60870-Slave/`(该目录将来会删除)。