Files
STM32F4-Base/IEC60870-Slave/docs/104/README.md
T
STF bdcc8b6500
CI / L0 静态门禁 (pre-commit) (push) Failing after 7m46s
CI / L0.5 主机侧单测 (MSVC) (push) Successful in 21s
添加遥控、参数装载、文件传输等业务
2026-11-16 22:19:17 -08:00

574 lines
100 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# IEC104 链路模块
## 设计架构阅读路径
严格发送顺序见[12级业务优先级设计](IEC104_业务优先级设计.md):统一配置入口默认启用,主示例及参数多主站示例使用同一策略。业务等级独立于HIGH/NORMAL的存储生命周期,按完整帧边界仲裁,并纳入已就绪但尚未组帧的业务候选。
按层阅读:[各业务模块](#business-module-designs) → [TCP 服务](IEC104_TcpServer_设计架构.md) → [连接协调](IEC104_Connection_设计架构.md) → [发送模块](IEC104_发送模块_设计架构.md)与[链路算法](IEC104_Link_设计架构.md)。业务模块各有独立架构文档;[业务层总览](IEC104_业务层_设计架构.md)补充跨模块分派、发送路径和调度关系。
需要按具体问题定位时,从[接入与排障导航](../README.md#documentation-details)进入各模块的数值推演、异常时序和检查步骤;同一问题涉及多层时先看[完整流程的等待定位](IEC104_完整调用流程.md#flow-progress-diagnosis)。
启动补发通过 [IEC104_Startup](IEC104_API接口汇总.md#startup-api) 统一配置和协调,主示例直接复用;接入见[统一入口](IEC104_完整调用流程.md#startup-unified-entry)。该模块等待本轮Type70、全部参与站真实全站总召末帧HANDED后放行NORMAL/IDLE,HIGH应答和变化入队仍可推进。原五个分散配置入口已移除,迁移须使用[五参数统一配置](IEC104_完整调用流程.md#startup-config-migration)。
采集数据的三条保存与上送路径见[跨模块调用流程](IEC104_完整调用流程.md#flow-fault-recording-history):Type42发送同一故障时刻的快照,FaultRecorder/Comtrade提供连续波形,History/HistoryFile负责附录B循环记录及XML。后两类经Type210调阅,共享协议服务但各自管理数据、持久化和快照寿命。公共接口分别见[录波](IEC104_API接口汇总.md#fault-recorder-api)、[COMTRADE](IEC104_API接口汇总.md#comtrade-api)、[历史核心](IEC104_API接口汇总.md#history-core-api)和[历史文件](IEC104_API接口汇总.md#history-file-api)。
冻结电能由公共[EnergyFreeze](../common/IEC60870_EnergyFreeze_设计架构.md)独立维护INTERVAL/DAY、FLOWREV和SEAL/META,经Type210提供FRZ/FLOWREV文件。主示例用`--energy-freeze existing-directory`接入持久存储和整数模拟计量,206读取与文件冻结各持独立快照;计数量请求处理仍归CounterInterrogation。专项入口为`./scripts/build.ps1 -Test -Suite EnergyFreeze`。
<a id="business-module-designs"></a>
## 各业务模块设计架构
以下文档按模块说明职责和文件依赖、内部结构与所有权、状态与关键函数流程、公开接口及完成边界、设计取舍和验证依据。各文另有提交点、WAIT 后的持有与恢复、期限和清理顺序、具体情景及现有测试定位。接入时先读目标模块,再查[完整调用流程](IEC104_完整调用流程.md)和[API 汇总](IEC104_API接口汇总.md);维护时可直接从下表进入对应的状态推进与恢复说明。
| 独立业务 | 设计架构 | 重点状态与边界 | 维护入口 |
|---|---|---|---|
| 总召 / 分组总召 | [Interrogation](IEC104_Interrogation_设计架构.md) | 规则与引擎分工;BEGIN、数据批次、确认/终止、广播目标及撤销 | [入口判定](IEC104_Interrogation_设计架构.md#gi-entry-guards) · [修改与测试](IEC104_Interrogation_设计架构.md#gi-maintenance) |
| 计数量召唤 | [CounterInterrogation](IEC104_CounterInterrogation_设计架构.md) | QCC/FRZ 规则;读取和冻结/复位动作分支,共用引擎但实例状态独立 | [动作提交](IEC104_CounterInterrogation_设计架构.md#ci-action-transaction) · [修改与测试](IEC104_CounterInterrogation_设计架构.md#ci-maintenance) |
| 遥控 | [Command](IEC104_Command_设计架构.md) | 点配置、选择/执行、应用动作、返回信息、尾票据交接及 FINISHED | [提交与WAIT](IEC104_Command_设计架构.md#command-commit-and-wait) · [修改与测试](IEC104_Command_设计架构.md#command-change-tests) |
| 校时与读时钟 | [ClockSynchronization](IEC104_ClockSynchronization_设计架构.md) | 固定任务槽、读/设时回调、滞留补偿、快照与FIFO回复 | [COT5读时](IEC104_ClockSynchronization_设计架构.md#clock-read) · [提交与WAIT](IEC104_ClockSynchronization_设计架构.md#clock-commit-and-wait) |
| 读命令 | [Read](IEC104_Read_设计架构.md) | READ/REPLY FIFO、原站引用、队首取值、WAIT 重取及提交前期限 | [推进、恢复及测试](IEC104_Read_设计架构.md#read-progress-and-recovery) |
| 参数装载 | [Parameter](IEC104_Parameter_设计架构.md) | 110–113、运行值确认 FIFO、默认同步生效及可选 ACK 两阶段 | [接入](IEC104_完整调用流程.md#flow-parameter) · [示例测量链](IEC104_Parameter_设计架构.md#parameter-measurement-design) · [测试](../test/IEC104测试文档.md#parameter-tests) |
| 远程参数 | [RemoteParameter](IEC104_RemoteParameter_设计架构.md) | 200–203、显式预置/固化/撤销、TLV读取及恢复 | [预置与恢复](IEC104_RemoteParameter_设计架构.md#remote-parameter-preset) · [接入](IEC104_完整调用流程.md#flow-remote-parameter) · [测试](../test/IEC104测试文档.md#remote-parameter-tests) |
| 文件服务 | [FileService](IEC104_FileService_设计架构.md) | 210、目录快照、IDLE读取、写暂存与COMMIT、BUSY事件保留 | [状态](IEC104_FileService_设计架构.md#file-service-states) · [所有权](IEC104_FileService_设计架构.md#file-service-storage) · [BUSY](IEC104_FileService_设计架构.md#file-service-busy) · [接入](IEC104_完整调用流程.md#flow-file-service) · [测试](../test/IEC104测试文档.md#file-service-tests) |
| 系统命令 | [SystemCommand](IEC104_SystemCommand_设计架构.md) | 请求、初始化遍历、复位授权三个状态域;ACK 门控与事件清除 | [推进与恢复](IEC104_SystemCommand_设计架构.md#system-command-progress-and-recovery) · [情景与测试](IEC104_SystemCommand_设计架构.md#system-command-scenarios) |
| 启动补发协调 | [Startup统一流程](IEC104_完整调用流程.md#flow-startup-replay) | 配套配置、本轮初始化、逐站总召票据及生命周期归还 | [接入入口](IEC104_完整调用流程.md#startup-unified-entry) · [接口](IEC104_API接口汇总.md#startup-api) |
| 软件升级 | [SoftwareUpgrade](IEC104_SoftwareUpgrade_设计架构.md) | 211、真实/TEST会话、END确认ACK、ABANDON及一次性授权 | [状态](IEC104_SoftwareUpgrade_设计架构.md#software-upgrade-state) · [引用](IEC104_SoftwareUpgrade_设计架构.md#software-upgrade-storage) · [诊断](IEC104_SoftwareUpgrade_设计架构.md#software-upgrade-diagnostics) · [接入](IEC104_完整调用流程.md#flow-software-upgrade) · [测试](../test/IEC104测试文档.md#software-upgrade-tests) |
| 突发上送 | [Spontaneous](IEC104_Spontaneous_设计架构.md) | 普通变化完整前缀、双形态提交,以及Type42整份故障快照、NORMAL与应用重试 | [完整前缀与重试](IEC104_Spontaneous_设计架构.md#spontaneous-progress-and-recovery) · [故障快照](IEC104_Spontaneous_设计架构.md#spontaneous-fault-event) · [情景与测试](IEC104_Spontaneous_设计架构.md#spontaneous-test-scenarios) |
| 周期 / 背景扫描 | [PeriodicScan](IEC104_PeriodicScan_设计架构.md) | 会话、组网格、点级标签、有界组帧、IDLE 交接及在线替换 | [入口判定](IEC104_PeriodicScan_设计架构.md#periodic-scan-step-gates) · [修改与测试](IEC104_PeriodicScan_设计架构.md#periodic-scan-maintenance) |
各模块的“成功”含义不同:读命令以应答接手为完成点;扫描在接手每帧后推进游标,遍历结束才完成本轮,仍可能保留待重试点。遥控还观察尾帧HANDED,QRP1则在有效ACK后才可能交出复位授权,Parameter的可选ACK扩展另须交付COMMIT/ABORT。RemoteParameter的SOLIDIFY返回APPLIED时运行值已发布,确认提交及失败恢复另行推进。具体条件由各自文档定义,不能只按同名OK、Process或FINISHED推断。
## 当前业务与统一入口
接收N(S)兼容与主站TESTFR发起后的终端抑制,按细则第8.2.1条注和第8.2.2条统一生效。行为变化、底层接口迁移及验证证据集中见[两项链路修复汇总](IEC104_设计架构.md#link-spec-fixes),无需另配开关或应用心跳任务。
主示例按本目录实施细则使用总召外带时标遥信、选择后执行/撤销及表8十六进制地址分区。Spontaneous单/双点默认值随之改为仅CP56,Command/Read/PeriodicScan的通用能力保持各模块契约;对应职责与迁移入口集中见[默认策略设计](IEC104_设计架构.md#spec-alignment-design)。
软件安装由公共`IEC60870_FirmwareUpdate`管理三槽、持久授权、试运行和回退;示例用`--upgrade-store`接入实际文件安装及`dtu-1`备份。它在211的Take成功后开始持久任务,不改变协议ACK含义。通用核心没有对104、Windows、RTOS或文件系统的依赖,宿主适配单独位于`examples/iec104_example_upgrade.c/h`;目标Flash和Bootloader由平台实现相同回调。见[分工与存储设计](../common/IEC60870_FirmwareUpdate_设计架构.md)、[接口](IEC104_API接口汇总.md#firmware-update-api)及[使用入口](../examples/IEC104子站示例.md#example-firmware-update)。
接线时先完成[启动恢复](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)。
软件升级由独立`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)。
周期/背景扫描由独立 `business/IEC104_PeriodicScan.c/h` 提供:按组或点级公共网格同步取当前值,经 IDLE 直接交接,不占 HIGH/NORMAL 队列,不跨 STOP/重连补发。支持在线周期和整表替换;SQ 默认关闭。接入见[扫描调用流程](IEC104_完整调用流程.md#flow-periodic-scan),类型、借用和拥塞边界见[扫描设计](IEC104_PeriodicScan_设计架构.md)。
系统命令由独立`business/IEC104_SystemCommand.c/h`处理:107原文回显、70按初始化轮次逐站上送、105 QRP1在肯定确认按时被ACK后交出复位授权、QRP2只清本CA待发带时标事件。显式启用RESET_PRIVATE后,QRP128..255交应用逐值许可,再按QRP1的ACK、期限和广播屏障领取;应用按返回的qualifier执行专用动作,库不替它定义语义或清事件。默认features=0x0F,PRIVATE关闭;QRP0及3..127始终拒绝。正常会话中QRP1/专用QRP确认提交前到达ACK期限时,原FIFO任务转否定确认;已提交后超时只撤销授权,不补发相反确认。接入见[系统命令调用流程](IEC104_完整调用流程.md#flow-system-command),范围及取消边界见[设计说明](IEC104_SystemCommand_设计架构.md)。
读命令业务由独立 `business/IEC104_Read.c/h` 提供,Type102直接返回COT5单点值或45/46/47错误,不进入召唤的激活流程。只对队首同步lookup,默认15000ms提交前期限;HIGH拥塞不取值,提交WAIT后重取。主示例单/双点返回Type30/31,步位/位串/遥测返回Type5/7/11;通用白名单仍包含无时标监视类型及30–36。取值时刻见[示例读取快照](IEC104_Read_设计架构.md#read-example-snapshot),接入见[读命令调用流程](IEC104_完整调用流程.md#flow-read)。
参数装载由独立`business/IEC104_Parameter.c/h`提供Type110–113请求校验、固定FIFO、运行值确认和显式应用动作;默认同步生效,五项扩展全部关闭。主示例默认把参数接入门限、平滑和量程品质处理,`--no-parameter`可关闭、`--parameter`可显式开启;算法及比较基准属于应用。参数读回通过总召,不通过Type102或参数突发。接入与运行边界见[参数设计](IEC104_Parameter_设计架构.md),算法集中见[示例测量链](IEC104_Parameter_设计架构.md#parameter-measurement-design);可选`--config`的INI存储与停机编辑由示例负责,见[参数持久化](../examples/IEC104子站示例.md#example-parameter-persistence)。
远程参数由独立`business/IEC104_RemoteParameter.c/h`提供Type200–203区号、TLV读取和预置/固化/撤销;与标准Parameter分别启用,示例通过`--remote-parameter`开启、默认关闭。参数通过202读回,不加入总召;应用持有点表、暂存和运行值,负责原子固化与跨模块约束。协议状态见[预置与恢复](IEC104_RemoteParameter_设计架构.md#remote-parameter-preset),回调环境寿命见[应用契约](IEC104_RemoteParameter_设计架构.md#remote-parameter-application),具体地址与复位行为见[示例点表](../examples/IEC104子站示例.md#example-remote-parameter)。
文件服务由独立`business/IEC104_FileService.c/h`提供Type210目录、读文件及写文件;示例通过`--file-service`开启。数据环满返回BUSY,应用保留同一事件并推进本地写步骤,COMMIT与发送仍须先读空通知。目录快照和文件句柄成功打开后恰一次收尾,固定回复和COMMIT实际预留槽有独立期限;读数据走IDLE,确认走HIGH。存储事务、内容格式和升级候选由应用负责,见[文件服务设计](IEC104_FileService_设计架构.md)。
当前子站业务统一包含`IEC104_Slave.h`:Slave内部持有不透明TcpServer,提供生命周期、事件循环、主动上报和状态查询,并在NextEvent交付I帧时自动建立ASDU视图及原连接的共用应答接口。业务不再手动创建TcpServer、绑定generation或安装函数指针。入口和延迟任务示例见[子站统一入口](#子站统一入口)。
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)。
内部调用关系为`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操作服务。
当前总召、计数量、遥控、校时、读命令、参数装载、远程参数、系统命令、文件服务确认及错误应答共用HIGH,突发进入NORMAL。兼容模式每级内部FIFO,未启用启动门禁或本轮已开放时,默认连续4帧HIGH后让出一帧待发NORMAL;严格模式按业务等级选帧,同级保持相应顺序,不使用该公平配额。文件读取数据、周期与背景快照使用IDLE直发,不增加第三条队列;严格模式还须遵守收集阶段及候选仲裁,兼容模式满足准入条件后先调用者先取得机会。应答接手不等待NORMAL或应用发布队列排空。普通Tracked凭证只跟踪SendBuffer交接;独立[ACK回执](IEC104_API接口汇总.md#response-ack-usage)还记录有效累计ACK和首次时刻,两者都不提供跨队列点值排序。旧Try/Ordered迁移事实见[通用应答发送变更记录](IEC104_通用应答发送变更记录.md),当前普通凭证用法见[API说明](IEC104_API接口汇总.md#response-ticket-usage)。
`Get_Status`同时提供`high_queue`和`normal_queue`的待发条目数、保留原文条目数及总容量/已用/空闲字节数,先检查`asdu_queue_status_valid`。待发数不包含已交给发送模块的ASDU;NORMAL保留到ACK前的原文仍计入存储量,字节统计包含条目头。Init成功后离线也可查询,Close后统计无效;队列为空不代表发送或确认全部完成。公开状态结构已扩展,库与调用方须一起重新编译,字段含义见[ASDU队列积压查询](IEC104_TcpServer_设计架构.md#21-asdu队列积压查询)。
`NextEvent`区分连接建立(CONNECTED)、数据传输激活(ACTIVATED)、停用(DEACTIVATED)和连接断开(DISCONNECTED),四者共用`event.transport.data.connection`快照及对端地址。启停事件在对应ACT成功受理并提交状态变化后产生,CON可能仍待发送;同状态重复ACT不重复通知,直接断开不补造停用事件。业务可按事件类型处理启停,无需通过查询状态比较变化。
四类连接通知的`transport.data.connection.occurred_ms`在变化生成时冻结Net单调毫秒,不能用NextEvent出队时刻替换。运行日志将它与有效墙钟基准换算为UTC;该字段不增加到I_FRAME/RECORD载荷。当前x64连接载荷增加8字节,公开`IEC104_TcpEvent_t`仍为296字节;完整契约见[事件载荷API](IEC104_API接口汇总.md#api-events)和[日志接线](../common/IEC60870_UserLog_设计架构.md#user-log-integration)。
`Get_Status`的`pending_state_event_count`报告尚未消费的ACTIVATED/DEACTIVATED数量,不能追溯已消费的启停历史。当前请求的错误应答可在同步分派中调用`IEC104_Slave_Reject_Request`,支持COT=44..49且固定P/N=1,复用HIGH且不改输入事件;48表示遥控执行软压板状态错误,49表示遥控执行时间戳错误,50不支持。不新增示例应答队列。调用时机、WAIT丢新策略与FATAL不可重试约定见[同步拒绝当前请求](IEC104_API接口汇总.md#reject-request)。
发送队列NORMAL与`NextEvent`业务通知FIFO是两份独立存储:NORMAL满时可覆盖旧ASDU原文;已入队业务通知逐条保留,不覆盖、不合并启停变化。通知按有效载荷长度存放于字节环,配置宏仍表示保证条数:默认普通30条最长通知、启停4条及收尾32条记录加1个最长I帧和1个断开通知。当前x64 ABI下环占11283字节,接收暂存默认2048字节,两块合计13331字节;连接发生时标使默认环增加40字节,16字节APDU仍可在普通区缓存185条。普通通知不能占用启停及收尾预留;启停配额满时暂缓受理后续改变状态的ACT,已有CON继续发送。详细公式见[TCP服务设计](IEC104_TcpServer_设计架构.md)。
新I帧无普通空间可交付时保留原帧并暂停续收,`Prepare`及`Get_Status`的`receive_paused`为1;NextEvent腾出空间后安排Process恢复,等待中的I帧先于回执交付。已确认回执因普通空间或本轮预算不足暂留内部时,可能晚于随后发生的启停通知交付,保持不因回执积压而暂缓启停CON的行为。通知积压不直接断连,但保留I帧会阻挡后续S/U;长期不消费仍可能触发原有协议超时。应用应在每轮Process/Poll后及时取出事件。此前字节环调整未改变公开事件结构;新增连接发生时标后,库与调用方须一起重新编译。
`IEC104_TcpServer_Prepare(server, &info, error)`只读导出socket关注集合、最近协议等待上限及本地续跑标志;应用统一等待其他模块和TCP事件后,用`IEC104_TcpServer_Process(server, &ready, error)`有界推进,Process不执行等待。socket只借给事件循环注册,关闭/重连后的旧通知按注册token过滤;真实I/O与Connection调度仍由TCP内部处理。活动连接未EOF时入队成功、背压解除和预算耗尽后按need_process安排续跑,不能只等待新的socket边沿;离线或EOF后新增NORMAL只缓存,不因此触发空转。EOF后也停止为此前入队但尚未编号的NORMAL创建新I帧,将这些原文留给下一连接;当前已编号帧、允许交接的HIGH及控制帧继续收尾。EOF后已接手的HIGH照常收尾,不等待保留到下一连接的NORMAL。接入约定见[TCP事件循环说明](IEC104_TcpServer_设计架构.md#31-接入应用自己的事件循环)。
`IEC104_TcpServer_Poll(server, max_wait_ms, error)`组合相同的准备和推进核心,中间至多等待一次:0只查询就绪,正数允许等待并按最近协议期限缩短。原poll_interval_ms配置项已移除,业务无需分别驱动内部收发和Tick。
当前实现支持控制方向提前发送:控制站可在ACT成功入队后预留命令I帧,并在ACT之后发送,不必等待CON;被控站成功受理STARTDT_ACT即进入STARTED/IDLE,开放I/S处理与发送准备,已生成的CON按FIFO先于随后准备的I帧和S确认发送。初始STOPPED/IDLE仍禁止I/S接收及新I帧发送。标准适用条件与连接组管理边界集中说明于 [链路设计第3.2节](IEC104_Link_设计架构.md#32-接收-i-帧)。
| 阅读入口 | 负责内容 |
|---|---|
| `IEC60870_Types.h` | 101/104共用的应用层参数、ASDU存储上限;不包含传输状态 |
| `IEC104_Types.h` | 104尺寸常量、标准104应用层初始化值、ASDU优先级及链路配置 |
| `IEC60870_Codec.c/h` | 101/104共用的参数校验、ASDU公共头解析及已知类型最低载荷长度检查 |
| `IEC104_Codec.c/h` | 104专用APCI检查、I/S/U帧编码和帧类型 |
| `IEC60870_Asdu.c/h` | 通用ASDU容器、布局校验、对象分派与原文应答;使用说明见下文“ASDU信息对象模块” |
| `IEC60870_Slave.c/h` | 101/104共用的主站连接接口,分派ASDU发送、激活确认和激活终止 |
| `IEC104_Slave.c/h` | 子站统一入口:TCP服务、ASDU/应答接口、原连接隔离及各业务共用的CA站点表 |
| `business/IEC104_Interrogation.c/h` | 共用召唤引擎:任务、广播、期限、事件、取消与发送等待;接入见[总召流程](IEC104_完整调用流程.md#flow-interrogation) |
| `business/IEC104_GeneralInterrogation.c/h` | Type100规则及兼容的Interrogation_Create入口 |
| `business/IEC104_CounterInterrogation.c/h` | Type101规则、创建及一次动作执行入口;见[计数量设计](IEC104_CounterInterrogation_设计架构.md) |
| `business/IEC104_ClockSynchronization.c/h` | Type103校时/读时校验、显式回调、原文确认或当前时间快照;见[时钟同步设计](IEC104_ClockSynchronization_设计架构.md) |
| `business/IEC104_Read.c/h` | Type102单点当前值、结构校验、同步lookup、FIFO与提交前期限;见[读命令设计](IEC104_Read_设计架构.md) |
| `business/IEC104_Parameter.c/h` | Type110–113、参数点表与运行值借用、FIFO、显式动作、可选暂存/同址/ACK扩展;见[参数设计](IEC104_Parameter_设计架构.md) |
| `business/IEC104_RemoteParameter.c/h` | Type200–203、原文FIFO、区号/TLV、预置会话、显式动作、恢复/DISCARD;见[远程参数设计](IEC104_RemoteParameter_设计架构.md) |
| `business/IEC104_SystemCommand.c/h` | Type107/70/105,初始化轮次、ACK后复位/专用授权和按CA清除;专用QRP默认关闭,见[系统命令设计](IEC104_SystemCommand_设计架构.md) |
| `business/IEC104_Startup.c/h` | 统一细则配置,协调本轮初始化、全部站总召与缓存补发;见[统一启动入口](IEC104_完整调用流程.md#startup-unified-entry) |
| `IEC104_Config_Internal.h`、`business/IEC104_BusinessConfig_Internal.h` | 库内基础填值声明,供Startup向下调用;应用、示例和测试只用Startup公开配置入口,不直接依赖这两个私有头 |
| `business/IEC104_Command.c/h` | Type45–51/58–64遥控、遥调、按点模式、选择执行、动作前时效与容量检查、业务期限及返回信息;见[遥控设计](IEC104_Command_设计架构.md) |
| `business/IEC104_Spontaneous.c/h` | 普通14类/23个Type监视信息及Type42专用故障快照发布、无时标/CP56及双报、NORMAL覆盖统计;见[突发设计](IEC104_Spontaneous_设计架构.md) |
| `business/IEC104_PeriodicScan.c/h` | 周期/背景组网格、点级周期与待重试资格、同步lookup、IDLE直发及在线换表;见[扫描设计](IEC104_PeriodicScan_设计架构.md) |
| `IEC104_TcpTypes.h` | Slave与TcpServer共用的配置、调度、事件和状态值类型,无服务操作接口 |
| `IEC60870_InformationObjects.c/h` | 69种独立信息对象,覆盖监视、命令、初始化、参数和文件;编码通过只读函数表分派,支持变长文件段 |
| `IEC60870_FaultEvent.c/h` | Type42扩展格式的完整ASDU编解码,两组数量/类型及记录;不采用普通对象函数表,详见[故障事件设计](../common/IEC60870_FaultEvent_设计架构.md) |
| `IEC60870_FaultRecorder.c/h`、`IEC60870_Comtrade.c/h` | 连续采样窗口、冻结记录及COMTRADE 1999编码;通过应用接入Type42和Type210,详见[录波设计](../common/IEC60870_FaultRecorder_设计架构.md#fault-recording-integration) |
| `IEC60870_History.c/h` | 附录B的SOE/遥控事件环、32日定点与极值、点表指纹、序列化及恢复;存储回调由调用方提供,见[历史核心设计](../common/IEC60870_History_设计架构.md#history-core-api) |
| `IEC60870_HistoryFile.c/h` | 四类历史XML、规范文件名和最新30个完成日导出;流式输出不接管文件,见[历史文件API](IEC104_API接口汇总.md#history-file-api) |
| `examples/iec104_example_history.c/h` | Windows双bank持久后端及独立目录/读快照;属于宿主接入,见[历史存储与快照](../common/IEC60870_History_设计架构.md#history-store-layout) |
| `IEC60870_UserLog.c/h`、`IEC60870_UserLogFile.c/h` | 附录C的1024条循环日志、恢复及ULOG XML;独立于历史点表,见[日志核心与格式](../common/IEC60870_UserLog_设计架构.md#user-log-core-api) |
| `examples/iec104_example_user_log.c/h` | 独立ulog.store双bank后端、目录缓存与下载副本,见[日志持久与快照](../common/IEC60870_UserLog_设计架构.md#user-log-storage) |
| `IEC60870_Time.c/h` | 101/104共用时间工具:CP16/CP24/CP56Time2a编解码、本地标准时间转换、SU修正、日历/星期和纪元秒数工具;使用约定见[时间工具设计](../common/IEC60870_Time_设计架构.md) |
| `IEC60870_Clock.c/h` | 101/104共用时间源接口:直接读取和设置固定UTC+8日历;Clock.c内置Windows读写,Clock.h预留RTC接口,由编译选项二选一 |
| `IEC104_Receiver.c/h` | 每连接严格帧头检查、成帧、APCI及ASDU最低长度检查、完整APDU借用视图和显式释放;不处理链路序号 |
| `IEC104_Connection.c/h` | TCP内部连接协调:I/S/U分派、接收保留与释放、部分发送、超时推进及旧代次隔离;内部设计见[连接层设计](IEC104_Connection_设计架构.md) |
| `IEC104_TcpServer.c/h` | 底层TCP服务:IPv4单主站、静态池句柄、事件FIFO;Prepare/Process或Poll推进,Get_Remote_Address查询对端,Close_Connection按代次断开单连接 |
| `IEC104_TcpServer_Config.h` | 实现的编译期容量配置;默认一个服务器静态槽,可调整池及缓冲容量 |
| `IEC104_Net.h` / `IEC104_Net_Windows.c` | 通用网络接口及当前Windows实现:非阻塞监听/接入/收发、就绪等待、关闭及单调计时 |
| `IEC104.c/h` | 已恢复的旧单路逐字节接收入口,保留原有全局接收器及私有Link状态 |
| `IEC104_SendBuffer.c/h` | 唯一当前I帧、独立紧凑S/U队列、部分写入续传及本地发送期限 |
| `IEC104_AsduQueue.c/h` | 调用方提供的HIGH/NORMAL字节存储;兼容FIFO与严格等级选择、票据、NORMAL覆盖身份及显式重连恢复,见[严格存储契约](IEC104_发送模块_设计架构.md#strict-priority-storage) |
| `IEC104_SendManager.c/h` | Connection内部的Link/SendBuffer修改入口:会话初始化、发送调度、控制收发、完成分派、ACK和回执,以及发送期限查询 |
| `IEC104_Link.c`、`IEC104_Link_Common.h` | 初始化、完整状态校验、I/S序号、k/w窗口、S确认、公共超时判定和TESTFR |
| `IEC104_Link_Master_StartStop.c/h` | 主站发STARTDT/STOPDT_ACT,收CON,处理等待超时 |
| `IEC104_Link_Slave_StartStop.c/h` | 子站收STARTDT/STOPDT_ACT,受理时更新启停状态,生成CON并处理停止排空及交错启停 |
| `IEC104_Link_Internal.h` | 三个实现文件共用的私有声明,不供业务调用 |
| `IEC104_Link.h` | 兼容总头文件,汇总公共、主站、子站接口 |
维护内部链路实现时,可按本端角色包含 `IEC104_Link_Master_StartStop.h` 或 `IEC104_Link_Slave_StartStop.h`,两者都包含公共接口。只处理I/S或TESTFR时包含 `IEC104_Link_Common.h`。旧内部代码可继续包含 `IEC104_Link.h`;模块发送完成接口统一以 `_Send` 结尾,该命名调整本身不改变参数和处理行为。改名不保留旧名兼容入口,内部调用方须同步更新名称并重新编译。
公共ASDU基础解析由 `IEC60870_Codec.c/h` 提供,业务需要解析公共头时包含 `IEC60870_Codec.h`;104的APCI检查和I/S/U编码由 `IEC104_Codec.c/h` 提供。Receiver分别调用两层:先检查APCI,再显式传入104参数调用 `IEC60870_Parse_ASDU_Header`。遇到非法帧头或截短的已知固定长度对象时返回FRAME错误,不推进序号或ACK,也不生成I_FRAME。未知/变长类型及具体字段继续由完整ASDU解析器和应用检查,边界见[基础设计](IEC104_设计架构.md#43-已知类型的最低载荷长度)。旧 `IEC104.c/h` 的全局接收入口保留原行为,不参与TcpServer路径。两个Codec均只依赖标准库及值类型,公共Codec不依赖104实现。
| 模块及构建依赖范围 | 生产源文件 |
|---|---|
| 101/104公共ASDU头解析 | `IEC60870_Codec.c` |
| 104 APCI与I/S/U编解码 | `IEC104_Codec.c` |
| ASDU信息对象编解码 | `IEC60870_Asdu.c`、`IEC60870_InformationObjects.c`、`IEC60870_Codec.c`、`IEC60870_Time.c`;C11及IEEE 754 binary32,不依赖TcpServer或Clock |
| Type42公共故障事件编解码 | `common/IEC60870_FaultEvent.c`及公共Codec、Time;使用Asdu头值类型,专用Encode/Parse/Get入口,不依赖104网络 |
| 公共录波与COMTRADE | `common/IEC60870_FaultRecorder.c`负责采样窗口;编码另加`common/IEC60870_Comtrade.c`和Time,不包含文件系统或104传输 |
| 公共历史记录与XML | 核心使用`common/IEC60870_History.c`;XML另加`common/IEC60870_HistoryFile.c`和Time,持久存储由调用方回调提供 |
| Windows历史保存及下载接入 | 公共历史依赖加`examples/iec104_example_history.c`提供宿主后端;主示例再经`104/business/IEC104_FileService.c`接入Type210,核心自身不依赖文件服务 |
| 公共运行日志与XML | `common/IEC60870_UserLog.c`独立核心;XML另加`common/IEC60870_UserLogFile.c`与Time,不依赖History或104网络 |
| Windows日志保存及下载接入 | 公共日志依赖加`examples/iec104_example_user_log.c`;主示例通过FileService发布ULOG,只启用`--user-log`即可,不要求`--history` |
| 子站统一入口 | 在ASDU及TCP依赖之外增加`IEC60870_Slave.c`、`IEC104_Slave.c`;共用接口本身不依赖TCP或串口实现 |
| 104站/分组总召 | 在Slave及其依赖之外加入`104/business/IEC104_Interrogation.c`和`104/business/IEC104_GeneralInterrogation.c`,头文件搜索路径增加`104/business/`;应用按QOI选点表,响应NEED_DATA提交数据 |
| 104计数量召唤 | 引擎加`104/business/IEC104_CounterInterrogation.c`,头文件搜索路径增加`104/business/`;与总召分别创建,状态通知交付两边,动作通过Execute_Begin执行 |
| 104时钟同步 | Slave依赖加`104/business/IEC104_ClockSynchronization.c`,独立实例及静态池;显式Execute_Next_With_Read执行读/设时回调,模块不依赖Clock设备适配 |
| 104读命令 | Slave依赖加`104/business/IEC104_Read.c`,公共ASDU/对象及Time、Net单调时钟;不依赖召唤引擎或Clock,头文件搜索路径增加`104/business/` |
| 104系统命令 | Slave依赖加`104/business/IEC104_SystemCommand.c`,公共ASDU/对象及Net单调时钟;ACK观察由SendManager/Connection/TcpServer提供,NORMAL清除由AsduQueue提供,不依赖Clock或召唤引擎 |
| 104启动补发协调 | Slave、SystemCommand、Interrogation及Spontaneous依赖加`104/business/IEC104_Startup.c`;复用已有站表和缓存,应用仍负责业务循环、站点及COI登记 |
| 104参数装载 | Slave依赖加`104/business/IEC104_Parameter.c`、公共ASDU/对象、Net单调时钟;无扫描/总召编译依赖,应用负责协作 |
| 104远程参数 | Slave依赖加`104/business/IEC104_RemoteParameter.c`、公共ASDU/Codec及Net单调时钟;不依赖Parameter、文件系统或硬件 |
| 104遥控/遥调 | Slave依赖加`104/business/IEC104_Command.c`,使用公共信息对象和Time解析;每Slave一个实例、一个事务,Accept显式执行动作,应用报告结果、提交返回信息并提供带时标命令的时间基准;模块不读取Clock |
| 104突发上送 | Slave依赖加`104/business/IEC104_Spontaneous.c`和`common/IEC60870_FaultEvent.c`,包含`104/business/`;复用公共对象及Time,不读取Clock,无内部事件队列,无需Handle_Event/Process |
| 104周期/背景扫描 | Slave依赖加`104/business/IEC104_PeriodicScan.c`,使用公共ASDU/对象及Net单调时钟,头文件搜索路径增加`104/business/`;不依赖Parameter,应用提供点表与同步lookup并驱动Step |
| 101/104公共时间工具 | `IEC60870_Time.c`,对已有时间值进行日历校验、时间转换及编解码 |
| 101/104时间源:Windows系统时钟 | `IEC60870_Clock.c`、`IEC60870_Time.c`;`IEC60870_CLOCK_USE_RTC=0`(默认),Clock.c直接使用Windows的Kernel32接口 |
| 101/104时间源:RTC预留接口 | 上述两个源文件,定义`IEC60870_CLOCK_USE_RTC=1`,另需板级驱动实现`IEC60870_Clock_RTC_Read/Set`;具体芯片驱动暂不提供 |
| 独立子站发送缓冲 | `IEC104_Codec.c`、`IEC104_SendBuffer.c`;公共发送类型仍由Link公共头文件提供,无需链接Link实现 |
| 链路处理 | `IEC104_Codec.c`、`IEC104_Link.c`,再按所需启停接口加入主站/子站实现 |
| 子站发送管理 | `IEC104_SendManager.c`、`IEC104_AsduQueue.c`、`IEC104_SendBuffer.c`、`IEC104_Codec.c`、`IEC104_Link.c`、`IEC104_Link_Slave_StartStop.c` |
| 子站连接协调 | 上述子站发送管理源文件,加 `IEC104_Receiver.c`、`IEC104_Connection.c` 和 `IEC60870_Codec.c`;无需主站启停或日志实现 |
| Windows TCP子站模块 | 上述子站连接协调源文件,加 `IEC104_TcpServer.c`和`IEC104_Net_Windows.c`,应用工程链接`Ws2_32`;构建与接入见[TCP服务设计](IEC104_TcpServer_设计架构.md) |
| 独立流式接收 | `IEC104_Receiver.c`、`IEC104_Codec.c`、`IEC60870_Codec.c`;不依赖Link、SendManager或日志 |
| 旧单路逐字节接收 | `IEC104.c`、`IEC104_Codec.c`、`IEC104_Link.c`、`IEC104_Log.c` |
时间工具以`IEC60870_Time`作为公共入口,供101和104的ASDU业务层及平台接入层按需调用,不在Connection中自动执行校时。`IEC60870_InformationObjects.c`复用CP56Time2a处理带时标信息对象和命令;Type103由独立ClockSynchronization模块处理,实际读/设时由应用显式执行。**新生成业务时标及COT5读时回复使用本地标准时间、SU=0;COT6校时的ACT_CON回显原CP56及SU。** 公共编解码继续支持SU=0和1,按输入保留标志,不强制或自动清零。生成新时标前须保证日历本身已是本地标准时间,不能只清除夏令时标志而保留原小时值。
时间源提供UTC纪元秒数时,直接调用`IEC60870_Time_Seconds_To_Local(utc_seconds, ms, &local_time)`即可取得固定UTC+8的本地年月日、时分秒、毫秒和星期,调用前后都无需手动加八小时。接口内部统一处理跨日/月/年及范围检查;原始UTC秒数上限为4102415999,超过时返回0并保留输出。RTC已直接提供本地标准时间日历时,可直接构造CP56解析值并编码。
当前时间直接通过`IEC60870_Clock_Read(&value)`取得,设置实际时钟调用`IEC60870_Clock_Set(&local_time)`,均使用固定UTC+8日历。**时间源范围仅限Windows系统时钟和RTC;`IEC60870_CLOCK_USE_RTC=0`默认使用Clock.c内置的Windows实现,`=1`调用Clock.h声明的`IEC60870_Clock_RTC_Read/Set`接口。RTC具体芯片驱动暂不实现。** 编译选项须作用于`IEC60870_Clock.c`,不规划其他操作系统适配。公共入口无需时钟对象或绑定初始化;以后接RTC时,硬件仍按驱动要求初始化,已有本地标准时间日历可直接填入,无需转换成时间戳再还原。读取结果分别表示日历和`is_invalid`,读取成功不等于时间有效;失败不修改输出。RTC的BCD格式、时间基准、毫秒来源及掉电状态由具体驱动处理。接入示例见[统一时间源读写](../common/IEC60870_Time_设计架构.md#统一时间源读写),业务待接入项见[当前接入状态](../common/IEC60870_Time_设计架构.md#当前接入状态与待补齐项)。
时间戳转日期保留两种实现:Windows默认调用CRT的64位`_gmtime64_s`;编译`IEC60870_Time.c`时定义`IEC60870_TIME_USE_PLATFORM=0`即可使用原有整数算法,其他平台默认采用此配置。配置在编译时生效,业务接口、UTC含义及1970..2099年的范围一致。此选项只决定如何转换传入的时间戳,与是否接入RTC无关;应用使用RTC作为时间源时,仍需通过相应驱动读取时间,再按返回值的格式和时间基准调用转换或编码接口。详见[实现选择](../common/IEC60870_Time_设计架构.md#时间戳转日期的实现选择)。
业务接收按`From_CP56 → CP56_To_Local`调用:原始解码保留源日历及IV/SU,转换接口返回本地标准时间年月日、时分秒、毫秒和星期。双方使用本地标准时间基准时,源标准时区参数传`IEC60870_LOCAL_UTC_OFFSET_MINUTES`(480):SU=0保持原时间,SU=1减一小时并处理跨日/月/年,IV=1则转换失败。其他源时区须传入其标准偏移,输出仍为本地标准时间;调用方无需再加八小时或重复扣除夏令时。接收SU=1的兼容处理与本地发送SU=0的约定分别生效。
日历范围为1970..2099年,CP56Time2a采用2000..2099年的世纪约定;接口以1/0表示成功/失败,失败保留输出。通用纪元秒数接口保留UTC语义,不能将本地标准时间日历直接当UTC使用。RTC读写仍由平台实现,Link和Connection的`now_ms`继续使用单调计时,不受校时影响。当前提供CP16经过时间、CP24短时标、CP56及日历工具。CP24仅含分钟、分钟内毫秒及IV,不能单独恢复小时和日期,需由业务结合已有时间基准解释。完整范围、星期和保留位策略见[时间工具设计](../common/IEC60870_Time_设计架构.md)。
Connection内部持有独立 `IEC104_Receiver_t`,先用非零连接代次调用 `IEC104_Receiver_Init`,再调用 `Feed(receiver, generation, data, length, &consumed)`。Feed最多收齐一帧,TcpServer保留未消费的输入尾部;`FRAME_READY`后由Connection通过 `Peek_Frame`取得APDU和APCI并分派。S/U受理后释放,I帧在TcpServer成功复制为事件后经Connection释放。帧未释放时Feed消费0字节,不覆盖原文;`Reset`丢弃当前半帧或完整帧,但不改变连接代次或Link状态。内部接口和迁移说明见 [编解码与接收器设计](IEC104_设计架构.md)。
接收器校验APCI格式和ASDU最低长度。Connection将I/S帧交给同连接的SendManager处理序号及ACK,并按功能分派U帧;WAIT时保留接收帧。Slave内部通过TcpServer_NextEvent读取I_FRAME副本,无需释放底层帧。连接重建由TcpServer先结束旧I/O并Close,随即Detach队列回到离线状态;新连接以新代次Rebind队列并Init连接;旧代次事件返回ERROR。
I 帧本地发送结果通过 `IEC104_Link_Complete_I_Send()` 提交,`Send` 明确限定为本地发送,成功不表示对端已经确认。同一次发送结果只提交一次。具体契约见 [链路设计第3.4.4节](IEC104_Link_设计架构.md#344-complete_i_send-的本地发送完成提交)。
发送完成接口如下,表中省略统一前缀 `IEC104_Link_`。它们报告最终发送结果,包括失败;返回 OK 表示本地发送结果已成功提交,是否仍需等待对端确认由对应状态决定。
| 接口 | 对应的本地发送结果 |
|---|---|
| `Complete_I_Send` | I 帧 |
| `Complete_S_Ack_Send` | S 确认帧 |
| `Complete_Startdt_Act_Send` | 本端主动发送的 STARTDT_ACT |
| `Complete_Startdt_Con_Send` | 本端应答的 STARTDT_CON;完成不回写启停状态 |
| `Complete_Stopdt_Act_Send` | 本端主动发送的 STOPDT_ACT |
| `Complete_Stopdt_Con_Send` | 本端应答的 STOPDT_CON;完成不回写启停状态 |
| `Complete_Testfr_Act_Send` | 本端主动发送的 TESTFR_ACT |
`Prepare_*` 负责准备报文或推进准备流程,`Handle_*` 负责处理接收事件;二者名称保持原有职责划分。收到 TESTFR_CON 使用 `Handle_Testfr_Con()`,不能用本地发送完成替代对端确认。
主动TESTFR使用`IDLE → ACT_SEND_PENDING → CON_PENDING → IDLE`三态:ACT完整发送后先调用Complete,再处理对应CON;提前CON返回IGNORED且不缓存。被控站收到合法主站ACT后,在本TCP连接内禁止新主动ACT,仍逐帧回复CON;既有ACT及其t1/CON继续完成,STOP/START不解除抑制,重连初始化才恢复。默认t3=20000ms保持,无新配置,规则与细则对应见[TESTFR职责与生命周期](IEC104_Link_设计架构.md#link-testfr-master-preference)。
底层`Link_Handle_Testfr_Act`已改为`(state, apci)`两参数,仅登记接收事实;旧三参数构造CON接口删除,调用方须迁移并重新编译。Manager先登记,再预留控制槽并经Codec编码CON,WAIT时已抑制新主动ACT但CON尚未入队,须保留原请求重试。
完整状态校验集中在 `IEC104_Link.c`,主站、子站的状态组合规则由该文件内的 `static` 函数检查。角色实现通过 `IEC104_Link_Internal.h` 调用公共辅助函数,公共链路模块不再反向调用角色实现。构建时包含公共链路及基础编解码实现,再按实际使用的启停接口加入对应角色 `.c`;同时使用两端接口时加入两个角色实现。
I/S的启停准入和停止阶段立即确认规则集中在 `IEC104_Link.c` 的私有判断函数中;I/S处理与规划通过这些判断继续执行序号、窗口及确认检查。I帧接收、I帧预留、S帧接收和普通S确认分别判断,保留各自的方向与阶段差异。子站在ACT受理时提交启停状态,S确认与CON发送完成分别维护各自的完成事实。具体规则见 [I/S与启停的内部边界](IEC104_Link_设计架构.md#16-is与启停的内部边界)。
启停和主动TESTFR在对应构帧入口中直接检查状态、编码并提交;被动TESTFR_ACT由Link登记事实、Manager调用Codec编码CON。I/S帧保留序号规划。内部确认提交复用公开入口的状态校验,STOPDT直接返回各等待原因,不再经过私有计划对象和结果转换。
## ASDU信息对象模块
信息对象、ASDU容器、公共头解析及参数类型统一使用 `IEC60870_` 前缀,供101/104共用。旧信息对象/ASDU文件和符号直接迁移,不提供兼容头、宏或类型别名;调用方须更新包含路径、函数/类型名称和构建源文件并重新编译。104的APCI、链路、TCP及发送队列仍使用 `IEC104_` 前缀。
普通ASDU公共层需要 `IEC60870_Asdu.c`、`IEC60870_InformationObjects.c`、`IEC60870_Codec.c`、`IEC60870_Time.c`;头文件依赖也不包含任何104模块。101接入提供约定的字段宽度和容量,104接入提供标准2/2/3及249字节上限。两种接入共用同一套普通对象构造和解析接口。Type42另使用 `IEC60870_FaultEvent.c/h` 的专用整帧接口,不能通过普通Add或Get_Element处理内部遥信/遥测记录。
业务包含`IEC104_Slave.h`,取得`Slave_NextEvent`交付的I帧后可直接使用ASDU视图并解析具体对象,或先构造ASDU再交给发送接口。ASDU编解码层不分配内存、不操作连接、不读取或设置系统时钟;共用连接接口可构造并提交确认/终止应答。站/分组总召可交给IEC104_Interrogation管理校验、分批、撤销、期限和重试,应用响应业务事件提交数据,自行维护IOA、分组及遍历状态;Type45–51/58–64由IEC104_Command管理,Type103由独立校时模块管理,权限策略及设备动作仍由应用接入。
| 层次 | 职责 |
|---|---|
| `IEC60870_Codec.c/h` | 101/104共用的参数校验、ASDU公共头解析及已知类型最低载荷长度检查 |
| `IEC104_Codec.c/h` | 104专用APCI检查、I/S/U帧编码和帧类型 |
| `IEC60870_Asdu.c/h` | ASDU创建/添加/解析/取对象,维护Type ID、VSQ/SQ、IOA布局和容量,构造原文应答 |
| `IEC60870_InformationObjects.c/h` | 每种类型独立结构、Create和Get_From_Buffer;通过对象函数表编码,按Type ID选择具体解析器 |
| `IEC60870_Time.c/h` | CP16经过时间、CP24短时标及CP56日历的编解码、范围和保留位校验 |
| 能力 | 当前范围 |
|---|---|
| 监视对象编解码 | 1–21、30–40及206/207,共34种;含步位置、比特串、成组单点、CP24、保护事件及短浮点电能量;支持SQ=0/1 |
| 命令对象编解码 | 45–51、58–64、100–107,共22种;SQ=0、一个对象、精确长度 |
| 初始化结束 | 70;COI保留原因与本地参数改变标志;SQ=0、一个对象 |
| 参数对象编解码 | 110–113;QPM/QPA按独立限定词处理;每帧一个对象且SQ=0 |
| 文件对象编解码 | 120–127;含变长文件段125与归档查询127;126文件目录支持多个对象及SQ,其余只允许一个非SQ对象 |
| 应答构造 | COT=7激活确认、9停止激活确认、10激活终止和44–49错误应答;P/N显式传入,否定激活确认使用7和1;48表示遥控执行软压板状态错误,49表示遥控执行时间戳错误,50不支持 |
上述共69种类型都有独立结构、构造和解析接口,含配电自动化104细则的206/207电能量扩展;其他未列出的安全扩展、厂家私有类型不在当前范围内。本层提供无状态报文编解码;站总召状态机由IEC104_Interrogation提供,参数生效、文件传输、文件读写及归档检索仍由业务接入。类型编号可在公共对象头文件的`IEC60870_AsduType_t`中查到。
Type200–203由RemoteParameter按专用线格式校验和编码,不加入上述公共信息对象表;202/203的SN不能交给公共对象Parse当作IOA解析,见[远程参数线格式](IEC104_RemoteParameter_设计架构.md#remote-parameter-wire)。
应用层参数`IEC60870_AppLayerParameters_t`定义在`IEC60870_Types.h`:
| 字段 | 合法范围及含义 |
|---|---|
| `sizeOfTypeId`、`sizeOfVSQ` | 固定为1 |
| `sizeOfCOT` | 1或2;1字节时省略OA,解析OA为0 |
| `originatorAddress` | 0..255,供业务作为默认OA;构造以header中的显式OA为准 |
| `sizeOfCA` | 1或2;1字节配置拒绝大于255的公共地址 |
| `sizeOfIOA` | 1、2或3;IOA及SQ连续地址上限随宽度变化 |
| `maxSizeOfASDU` | 至少容纳公共头、最多254字节;104传输不得超过249字节 |
标准104包含 `IEC104_Types.h` 后使用`IEC104_APP_LAYER_PARAMETERS_DEFAULT`,即`{1,1,2,0,2,3,249}`。所有ASDU创建/解析入口必须显式传入非空参数。容器和解析视图借用参数,使用期间参数必须有效且不变。通用ASDU可复用到采用其他宽度的101接入,但本工程尚未提供101串口链路;Receiver、APCI、TcpServer和发送队列继续使用104布局及249字节上限。
每类对象通过自己的`Create`写入调用方提供的结构体,并绑定类型及只读编码函数表。例如单点用`IEC60870_SinglePointInformation_t`,双命令用`IEC60870_DoubleCommand_t`。普通监视和控制的带CP24/CP56对象用`base`保存基础对象、`time`保存时标,并复用基础值处理;保护事件则显式保存事件、QDP、CP16经过时间和时标。对象可按值复制,不需要销毁;业务可修改值或IOA,重新编码时仍会校验,类型和函数表不得手工修改。
容器调用顺序为`IEC60870_Asdu_Create → IEC60870_Asdu_Add_InformationObject → IEC60870_Asdu_Get_Data`。Create固定参数、SQ和公共头,首个成功添加的对象确定Type ID;后续对象必须同类型。SQ=1要求IOA连续且不越过所选宽度上限,SQ=0逐对象携带地址。Add成功后已经复制对象字节,可以立即复用对象存储。
容量取实际缓冲区与`maxSizeOfASDU`的较小值。空间不足、对象达到127个或单对象类型已加入一个对象时返回`IEC60870_ASDU_FULL`;业务提交当前非空ASDU后另起一条重试。空容器放不下首对象时须调整容量;文件数据须按可用长度分成更小的段。类型不匹配、SQ地址不连续或字段非法返回ERROR。所有失败保留容器、原文和输出参数,首对象失败不会提前设置Type ID。结果必须显式比较`IEC60870_ASDU_OK`,不可按布尔值判断。
业务包含 `IEC60870_Asdu.h`;本例使用104默认配置,还需包含 `IEC104_Types.h`。以下代码放入业务函数,`data`在原缓冲区未修改期间有效:
```c
uint8_t buffer[IEC104_MAX_ASDU_LEN];
const IEC60870_AppLayerParameters_t parameters = IEC104_APP_LAYER_PARAMETERS_DEFAULT;
IEC60870_Asdu_t asdu;
IEC60870_AsduHeader_t header = {
.cause_of_transmission = IEC60870_ASDU_COT_SPONTANEOUS,
.common_address = 1
};
IEC60870_SinglePointInformation_t point;
const uint8_t *data = NULL;
uint16_t length = 0;
IEC60870_AsduResult_t result =
IEC60870_SinglePointInformation_Create(&point, 100, 1, 0);
if (result == IEC60870_ASDU_OK) {
result = IEC60870_Asdu_Create(
&asdu, &parameters, buffer, sizeof(buffer), &header, 0);
}
if (result == IEC60870_ASDU_OK) {
result = IEC60870_Asdu_Add_InformationObject(&asdu, &point.object);
}
if (result == IEC60870_ASDU_OK) {
result = IEC60870_Asdu_Get_Data(&asdu, &data, &length);
}
/* OK时可将data/length交给Enqueue_Event;提交返回WAIT时保留原文重试。 */
```
监视和命令统一使用`IEC60870_Asdu_Parse`校验整条报文,再通过`IEC60870_Asdu_Get_Element`取得独立类型的对象。例如处理单命令:
```c
/* parameters、data、length对应收到的ASDU;处理期间原文保持有效。 */
IEC60870_AsduInfo_t info;
IEC60870_AsduResult_t status =
IEC60870_Asdu_Parse(&parameters, data, length, &info);
if (status == IEC60870_ASDU_OK && info.type_id == IEC60870_ASDU_C_SC_NA_1) {
IEC60870_SingleCommand_t command;
status = IEC60870_Asdu_Get_Element(&info, 0, &command, sizeof(command));
if (status == IEC60870_ASDU_OK) {
/* info保存COT/CA/OA;command.object.ioa、state、is_select、
* qualifier供业务判断地址、限定词、选择/执行及权限。 */
}
}
```
Get_Element输出无需预先Create,必须按`info.type_id`选择匹配的具体结构体并传入其尺寸;尺寸检查不能替代C类型匹配。解析视图借用原文和参数,取出的具体对象按值保存。只处理单个载荷时,可直接调用对应类型的`Get_From_Buffer`,传入已解析IOA及不含IOA的精确载荷;读命令载荷为0字节,允许NULL。
归一化值使用原始`int16_t`(实际值为原值/32768),标度值使用`int16_t`,短浮点保留IEEE 754 binary32位模式。累计量用`IEC60870_BinaryCounterReading_t`保存32位计数、5位序号及CY/CA/IV。对象层校验品质保留位、SCO、DCO/RCO状态、VTI有符号范围、保护事件QDP和CP24/CP56;COT、CA、IOA及限定词的业务适用性由应用判断。
`Build_Response(&parameters, request, length, cause, is_negative, out, capacity, &out_length)`仍以`IEC60870_Asdu_`为前缀。它复制请求,只替换COT/P/N,保留TEST、存在时的OA、CA、VSQ及全部对象原文,支持原地和部分重叠。它仅作公共头及最低长度检查,可回显未知类型。生成后以原请求身份调用Slave_Send_Response;直接接入TcpServer时传原generation,均须处理WAIT/ERROR/FATAL。Type110–112的运行值确认另由Parameter构造,不能一律用此镜像函数代替。
`IEC60870_Asdu_Create_From_Buffer(&asdu, &parameters, buffer, length)`直接借用可写原文,建立可修改的ASDU对象。它只做公共头及最低长度检查,未知类型也能建立对象,用于COT=44等错误应答;执行业务前仍须使用完整Parse和业务规则校验。借用对象不能Add,`Set_COT`、`Set_Negative`、`Set_CA`原地修改相应字段;Get_Data可以导出原文。Create创建的构造容器也可使用这三个设置接口,空构造容器仍不能导出。Set_CA按COT宽度定位、CA宽度写入,1字节仅允许0..255,2字节允许0..65535;非法容器或地址溢出返回ERROR且不修改原文,业务地址限制仍由业务层判断。ASDU结构新增来源标志,调用方须一起重新编译。
### 文件段和新增时间格式
`IEC60870_FileSegment_t`含255字节的数据数组。Create和Get_From_Buffer把有效数据复制进对象,调用结束后即可复用输入;对象无需销毁。它的线上载荷为`NOF(2)+NOS(1)+LOS(1)+数据(LOS)`,解析精确检查LOS与报文长度,不接受截短和多余尾字节。
先用`IEC60870_FileSegment_Get_Max_Data_Size(parameters)`计算当前配置允许的数据长度。默认104配置返回236;最短101头、1字节IOA、254字节上限时返回245。返回0表示只能容纳空段,-1表示配置非法或连空段都装不下。Create允许0..255字节,实际加入ASDU时仍检查总长;超过容量返回FULL,调用方负责分段。
`IEC60870_Time_To_CP16/From_CP16`处理0..65535毫秒的经过时间。`IEC60870_Time_To_CP24/From_CP24`处理分钟0..59、分钟内毫秒0..59999和IV;bit6是保留位,CP24没有SU、小时或日期。CP24编解码保留IV,不自动推断完整日历。所有接口均沿用成功1、失败0且保留输出的约定。
### 子站统一入口
业务包含`IEC104_Slave.h`,持有一个不透明的`IEC104_Slave_t *`。Slave内部创建、驱动和销毁TcpServer;配置、调度、状态和结果仍复用`IEC104_TcpTypes.h`中的值类型,业务头文件不引入TcpServer操作接口或内部布局。
生命周期为`IEC104_Slave_Create → Config_Default/Init → Prepare/Process或Poll → Close → NextEvent读空 → Destroy`。所有操作在同一事件循环线程串行执行。静态池容量沿用`IEC104_TCP_SERVER_CAPACITY`,与直接使用TcpServer共享底层名额,无动态分配。创建失败返回NULL;其他生命周期接口显式比较`IEC104_TCP_OK`。
`IEC104_Slave_NextEvent(slave, &event)`按原FIFO交付`IEC104_SlaveEvent_t`:`event.transport`是TCP事件副本;I_FRAME且`event.asdu_result == IEC60870_ASDU_OK`时,`event.asdu`已经借用事件自身的ASDU字节,`event.connection`已经绑定原服务实例及原连接代次。业务不再传入server/generation,也不再手工Create_From_Buffer。字段/地址/命令权限仍由业务校验,未知类型可以原文交付,视图创建成功不等于允许执行命令。
普通循环使用以下顺序;Application_Handle_Event为应用自己的同步处理函数,其中可以提交应答或复制事件到延迟任务:
```c
IEC104_TcpResult_t result = IEC104_Slave_Poll(slave, 10, NULL);
if (result == IEC104_TCP_OK) {
IEC104_SlaveEvent_t event;
IEC104_TcpEventResult_t next;
while ((next = IEC104_Slave_NextEvent(slave, &event)) == IEC104_TCP_EVENT_READY) {
Application_Handle_Event(slave, &event);
}
/* next为ERROR时处理内部读取错误;EMPTY表示本轮事件已读空。 */
}
```
外部事件循环使用Slave_Prepare/Process,继续保留原service_token和socket token;pending_event_count或need_process非零时先处理本地工作。主动上报通过`IEC104_Slave_Get_Application_Layer_Parameters`取得参数构造ASDU,再调用`IEC104_Slave_Enqueue_Event(slave, &asdu)`进入NORMAL。关闭单连接传原事件给`IEC104_Slave_Close_Connection(slave, &event, error)`,库内部使用该事件的原代次。
### 共用连接上的激活确认和激活终止
共用接口`IEC60870_MasterConnection_t`继续供101/104业务复用;当前104的接口由Slave_NextEvent自动安装,101串口后端仍未提供。下例放在业务已验证请求并决定肯定确认的分支,event为地址稳定的Slave事件:
```c
if (event.transport.type == IEC104_TCP_EVENT_I_FRAME &&
event.asdu_result == IEC60870_ASDU_OK) {
bool accepted = IEC60870_MasterConnection_Send_ACT_CON(
&event.connection, &event.asdu, false);
if (!accepted) {
IEC104_TcpSubmitResult_t submit =
IEC104_Slave_Get_Last_Submit_Result(&event.connection);
/* 按下表处理submit;WAIT需要保留事件及原文,不能忽略或盲目重发。 */
(void)submit;
}
}
```
| 共用操作 | 行为 |
|---|---|
| Send_ASDU | 提交给定ASDU对象的当前原文,也可提交业务另外构造的数据ASDU |
| Send_ACT_CON | 原地设置COT=7及指定P/N,然后提交 |
| Send_ACT_TERM | 原地设置COT=10、P/N=0,然后提交 |
| Get_Application_Layer_Parameters | 返回该连接的标准104只读参数,最大249字节 |
确认及终止先修改事件副本的字节再发送,失败也不回滚;TEST/OA/CA/VSQ和对象原文保留。需要原请求内容时,在修改前保存副本。
| 详细结果 | 布尔返回 | 业务处理 |
|---|---|---|
| OK | true | 已复制到发送缓冲或HIGH,可复用发送原文;不代表已写完或已ACK,不重复提交 |
| WAIT | false | 本次未接手;保留已修改的ASDU及原事件,待容量恢复后重试 |
| ERROR | false | 参数、布局、旧代次或调用阶段非法,不能按容量等待盲目重试 |
| FATAL | false | 发送路径故障,可能已写出字节;结合RECORD/DISCONNECTED处理 |
事件含有指向自身的ASDU视图和连接上下文,不能用赋值或memcpy搬到另一地址。延迟任务可让NextEvent直接写入自身稳定存储,或调用`IEC104_Slave_Copy_Event(&task.event, &event)`;复制时同时保存字节、重建自引用,并保留原服务实例和原连接代次。源事件随后可被下一次NextEvent覆盖,任务副本仍独立可用;复制不代表需要重发已经OK的报文。多个任务的事件存储由应用提供,库不额外引入待办任务池。
总召内部使用紧凑存储:只保留`Get_Event_Identity`取得的原身份及10字节请求ASDU,按需建立视图,通过`Slave_Send_Response / Slave_Send_Response_Tracked`应答,关闭原连接用`Slave_Close_Connection_By_Identity`。任务槽、事件队列和发送容量保持不变,内存测量见[固定存储](IEC104_Interrogation_设计架构.md#2-对象身份与固定存储)。其他需要完整事件的业务仍可用Copy_Event。
NextEvent返回EMPTY/ERROR时保持输出不变。Close、重连、重新Init或Destroy后复用服务槽,都不会把旧任务改绑到新连接;发送继续检查原身份。Destroy成功后旧服务句柄失效,但旧事件的字节仍由任务自身保存。所有延迟任务也在所属事件循环串行提交。
多帧总召的数据和正常终止应使用同一原请求身份,经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_Interrogation_Process(gi)`自动推进当前就绪任务,无需传入预算。每个实例至多一个未终结总召,包含等待生成BEGIN的请求;忙时相同和不同QOI的新激活均否定,不保存后续总召。4个任务槽共用于这个总召和待发短应答。Handle_Event在原会话有效、Slave通知已读空且无更早REPLY时尝试立即提交短应答,未接手再保存。满槽时尝试否定确认;不能安全提交/保存则仅丢新请求并累计dropped_requests,保留当前任务及TCP。Process在空闲、等待应用/事件空位、发送WAIT或Slave通知未读空时返回。对象、状态、调度及接入约定见[总召模块设计](IEC104_Interrogation_设计架构.md)。
总召Get_Status的`need_process`用于决定是否立即续跑,不能从`waiting`取反推断。应答或读取业务事件后重新查询;发送WAIT后等待网络推进再重试。每次Slave_Poll/Process及Slave通知处理结束仍须推进总召,即使need_process为false。外部事件循环同时合并Slave_Prepare的调度条件;新增状态字段后调用方须重新编译。
BEGIN由调用者决定,遍历状态可延至首个NEED_DATA建立;应用每批读取当前值和品质,库不冻结点表。Submit_Batch将数据提交HIGH,OK后推进游标;WAIT未接手,推进网络后重取值。已准入总召不等待应用发布队列或NORMAL排空;主示例在本轮初始化完成前暂不领取GI BEGIN,见[启动补发协调](IEC104_完整调用流程.md#flow-startup-replay)。HIGH与NORMAL之间不保证点值时间顺序,HIGH满时仍不保证接手机会和整轮完成期限。详见[数据批次与发送路径](IEC104_Interrogation_设计架构.md#6-数据批次与发送路径)。
BEGIN携带实际CA、station_id和QOI=20..36;应用检查数据源并决定接受,首个NEED_DATA才需建立取数游标。多目标广播先完成全部BEGIN/ACT_CON,再逐站取数,最后全部ACT_TERM;每站状态区保证FINISHED无损交付。Submit_Batch只接受事件目标CA。新增/替代站下轮参加,尚未选入BEGIN便删除的站跳过;已经选中尤其已确认的原站必须完成或明确终结。各站从自己的BEGIN独立计时,早期站须覆盖后续站工作,库总期限默认关闭;FINISHING的终结事件读完前仍忙拒绝新激活。详见[总召设计](IEC104_Interrogation_设计架构.md#33-广播地址与本站地址)。
主站COT=8按原连接、目标CA/OA/TEST/QOI匹配总召。定向撤销只匹配活动站,其他站继续;多目标广播撤销只要原快照还有未结束目标就停止整轮,包括尚未BEGIN的PENDING站,并按原快照逐站回复COT=9:未结束目标肯定,已结束或已拒绝目标否定。已有否定ACT_CON先交接,首次FINISHED原因保持;未交付BEGIN的站不补造FINISHED。已被发送层接手的帧不撤回,撤销不补发成功ACT_TERM,详见[总召撤销与取消](IEC104_Interrogation_设计架构.md#9-撤销取消与连接变化)。
库的业务接受和每批取数期限默认各15秒,执行整体期限默认0(禁用),各项均可单独配置;这些是业务策略,不是标准规定。命令行示例在Create前通过`--gi-total-timeout`、`--ci-total-timeout`分别设置120000ms初始值,显式0禁用并警告;部署必须按实际点数、编码、分批与链路条件评估,不能直接采用遥控60秒期限。预算覆盖`T_begin + T_confirm + ΣT_batch + T_term + 余量`,见[整体期限预算](IEC104_Interrogation_设计架构.md#81-整体期限预算与部署)。
BEGIN生成时启动已启用的业务期限,此前等待业务事件空位没有独立超时,但已占用总召资格,应及时读取FINISHED。总期限计至ACT_TERM接手,不因新批次或任何发送WAIT刷新;有效批次发送WAIT只停止本批data期限,通知WAIT及无效批次不停止。ACT_TERM接手后的HIGH排队/ACK、已终结否定REPLY及FINISHED消费不受整体期限约束,纯计数量动作成功后的确认等待也不纳入;不新增进展期限或HANDED阶段。START/CONFIRM超时及BEGIN阶段Fail_Request复用原槽安排否定ACT_CON,保留TCP及其他短应答;肯定ACT_CON接手后的失败关闭原连接,影响其他尚未结束业务,NORMAL保留的未ACK事件可能重连重发。终结事件保留具体原因,BEGIN未取出则只移除工作事件。等待前查询timer_active/timeout_remaining_ms并持续驱动Process。先前已移除queue_timeout_ms及多总召排队状态/统计,使用旧字段的调用方须调整并重新编译。
原`IEC104_SlaveConnection_Init`和手动接入对象已移除,调用方改用Slave服务及其事件接口并重新编译。TCP底层接口仍供独立通信接入和维护测试使用,业务的默认入口统一为Slave。
本次接口直接替换为独立对象与统一ASDU入口,删除旧通用监视/命令联合体及分类解析、Builder接口,不提供兼容包装;调用方须按上述示例迁移并重新编译。构建须新增`IEC60870_InformationObjects.c`。
时标保留IV/SU;IV=1可解码但不代表可校时。业务新上报应提供本地标准时间且SU=0,应答回显保留请求时标。验证命令和覆盖范围见[测试说明](../test/IEC104测试文档.md)。
### 时钟同步业务
[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不会越过它。
默认设时源标准时区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)。
全部回复走HIGH,WAIT只重试固定回复。confirm_pending仅覆盖设时动作开始至确认被接手;读时不更新同步状态或应用基准。仍在HIGH的回复可被STOP取消,已发生的设时不回滚。广播调用一次对应回调、逐站回复;满槽丢新。示例默认使用模拟基准,`--clock system`调用Windows时间源。详见[时钟同步设计](IEC104_ClockSynchronization_设计架构.md)。
### 遥控、遥调与带时标命令业务
[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兜底。
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)。
设定值由request.value交付应用;选择和执行比较原始值字节及屏蔽S/E后的QU/QL,不比较CP56。带时标激活默认按10秒窗口检查,应用通过Set_Time_Base提供UTC纪元毫秒及对应Net单调毫秒;受理时过期默认安排COT=49、P/N=1,超前、无基准或无效时间也回复49。完整长度、合法头且命令值/限定词通过后,CP56解码错误归49;整体格式、值或限定词错误仍按7/9或丢弃规则处理。Accept通过会话、决定期限和旧回复门禁后,对SELECT、EXECUTE在动作前再次复查;时效失败消费事件并返回STALE、动作不执行,按TIME_EXPIRED或TIME_REJECTED结束并安排49;不可变原请求突然无法解码仍属SERVICE_ERROR。negative_on_expired默认true同时适用于收到时及Accept前过期;显式false仅使真实过期请求静默,TEST和应用显式Reject(TIME)仍回复49。max=0跳过动作前复查及受理时的时差比较,受理时仍拒绝CP56错误、IV及UTC换算失败。真实撤销不做IV/时差检查,但CP56格式错误仍回49;TEST撤销时间检查失败也回49。校时成功后应在动作回调外更新基准,新的基准也用于待执行事件的复查;STOP/断线保留基准,失去可信时间时Clear_Time_Base。
Handle_Event校验并生成SELECT/EXECUTE。Accept动作前不提交旧回复;模块仍有旧回复或HIGH不足以放下本次确认时返回WAIT,事件不消费、动作不调用。通过时效及容量检查后才准备确认、消费事件、至多执行一次动作并提交确认一次。此容量保证依赖同一事件循环及动作回调不推进Slave,不新增发送层预留,也不保证生产者准入公平;STOP、断线或发送故障仍可中止确认。
启动后Report_Result,再逐帧Submit_Return_Info,全部OK后Complete。Report_Result启动默认30秒完成期限,Complete启动默认60秒交接期限,首次ENDED后的本事务残留回复复用handover期限清理;两个配置字段为0时禁用相应时长及倒退到期处理。完整完成判断优先于交接超时,handover=0仍能正常完成。NextEvent入口无会话门禁地清理ENDED残留并尝试回收,FINISHED仍须应用读取,所有期限转换仍由事件循环推进。
执行确认、返回信息和ACT_TERM走HIGH;正常FINISHED等必要回复全部接手且最后应答交给SendBuffer。完成/交接超时仅丢弃模块持有的本事务回复,不撤回HIGH原帧,不影响独立短回复;返回信息另有凭证决定补报,Finish冻结原因、副作用及补报结论。本地Cancel或收尾超时后原帧仍可能发出,保守补报可能重复,设备动作也可能仍在进行。
已取走工作事件的事务恰好产生一次FINISHED;FINISHED只结束协议事务,应用自行维护尚未结束的物理输出和站点引用。退出时Cancel、读完FINISHED,再关闭Slave并分派余下通知,最后Destroy。完整规则见[遥控设计](IEC104_Command_设计架构.md)、[API第25节](IEC104_API接口汇总.md#file-25)和[遥控调用流程](IEC104_完整调用流程.md#flow-command)。
### 突发上送业务
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和重复告警行为。
Create复制配置并借用Slave,每Slave最多一个静态实例。应用变化包含CA、可选station_id、IOA、值/品质与采集时间。使用Config_Default填满14项forms,库及调用方须全量重编以适配结构扩展。Publish先全量校验,再按连续的CA/类型/COT/形态分段,按容量及重复IOA分块,仅生成启用的形态,双报时先无时标后CP56。错误输入零入队;WAIT用info.published保留未完成后缀并原样重试。成功只表示曾经进入NORMAL,不保证仍保留、已发出或已确认。
模块没有Handle_Event/Process/NextEvent,不参加通知分派;Init后可离线发布,STOP或断线时NORMAL继续保留,Close清空服务缓存,QRP2另按CA清除规定范围的待发原文。单调时刻按本次Publish使用的UTC/Net基准映射为UTC+8标准时间,未同步、老化、缺基准或越界时置IV,不阻止上报;显式UTC输入的有效性独立于该基准及同步状态。Set_Time_Base与Command分别在校时回调外更新,模块不自行读时钟;WAIT后重试重新取基准,原采集单调时刻不保证得到相同的CP56换算值。
Get_Status只读返回本模块造成的待发/待重发原文覆盖与已提交原文覆盖计数,仅前者置overflow;待重发原文可能已被主站收到,不等于确定未送达。应用用自己的发布队列维护已选快照及失败补报,NORMAL另存已接手的编码原文。总召和返校走HIGH,可以越过积压事件;示例保留遥控占位用于补报,不再门控总召或校时期间的发布。模块本身不做变化检测、死区或限速;参数模式的应用选择与提交基准见[测量变化规则](IEC104_Parameter_设计架构.md#parameter-measurement-threshold)。完整契约见[突发设计](IEC104_Spontaneous_设计架构.md)、[API第26节](IEC104_API接口汇总.md#file-26)和[调用流程](IEC104_完整调用流程.md#flow-spontaneous)。
## 启停主流程
| 角色与过程 | 调用顺序 |
|---|---|
| 主站启动 | `Prepare_Startdt_Act` → 实际发送 → `Complete_Startdt_Act_Send` → 收CON → `Handle_Startdt_Con` |
| 主站停止 | `Request_Stopdt` → `Prepare_Stopdt_Request` → 依次发送S/ACT并提交完成 → 收CON → `Handle_Stopdt_Con` |
| 子站启动 | 收ACT → `Handle_Startdt_Act`(立即STARTED/IDLE)→ 发送CON → `Complete_Startdt_Con_Send` |
| 子站停止 | 收ACT → `Handle_Stopdt_Act`(立即STOPPED/STOP_DRAINING)→ `Prepare_Stopdt_Response` → 按需发送S、等待I帧确认 → 发送CON → `Complete_Stopdt_Con_Send` |
上表省略统一前缀 `IEC104_Link_`。只有具体接口返回值表明已生成报文时,才将本次输出交给发送层;生成不等于已发送。部分 Handle 只受理请求或提交对端确认,例如 `Handle_Stopdt_Act` 不生成应答,后续由 `Prepare_Stopdt_Response` 推进。S帧完成交给 `Complete_S_Ack_Send`。被控站不暂存相反方向ACT;停止等待期间成功受理START即恢复STARTED/IDLE,结束尚未生成STOPDT_CON的停止等待。
正常控制流程应串行执行启停,例如 `STOPDT_ACT → STOPDT_CON → STARTDT_ACT → STARTDT_CON`。主站的忙或重复请求结果不表示可以再次发送ACT。子站交错请求按实际受理顺序改变状态:START激活,STOP停用。已经生成的CON始终按FIFO发送,后到请求不撤回旧CON,旧CON完成也不覆盖后到ACT已经提交的状态。具体语义见 [链路设计第4.2节](IEC104_Link_设计架构.md#42-被控站受理启动)。
被控站成功受理STARTDT_ACT时立即进入STARTED/IDLE,并生成STARTDT_CON。首个CON尚未Complete时,后续每个成功受理的重复START也生成一帧CON;同状态重复请求不再次产生激活通知。所有CON按FIFO发送,Complete只确认对应发送结果,不重新提交启停状态。首个STARTDT_CON尚未完成也能受理STOP,立即停用并进入STOP_DRAINING。具体分支见 [链路设计第4.2节](IEC104_Link_设计架构.md#42-被控站受理启动)。
## 子站发送模块(已实现)
三个模块采用变长业务存储、发送前编号和独立确认记录组织。HIGH队列本身满时拒绝;严格Response另可在满足顺序条件时尝试队满直交。NORMAL允许覆盖最旧原文,严格模式仍保留已交接项的覆盖身份头,必要空间不足也会背压。IDLE准入后直接交给唯一当前I帧,不新增队列或重连原文。三条路径共用部分写入、期限、启停/TESTFR及回执;兼容模式使用HIGH公平配额,严格模式按业务等级及同级受理顺序仲裁,全部使用固定存储。两种模式的详细契约以[发送模块设计](IEC104_发送模块_设计架构.md#overview)为准。
ASDU队列的状态以业务条目为单位:`unsubmitted_*` 表示队列尚未登记发送交接的待发条目。操作顺序是 **SendBuffer接手完整I帧 → Manager建立发送记录 → Mark_Submitted完成队列记账**。最后一步执行前,队列仍保留待发旧状态,不能据此判断SendBuffer是否已经接手。这里的“已提交”不表示整帧已写完或对端已ACK。
HIGH在完成交接记账时消费队列原文,SendBuffer中的完整I帧及Manager记录继续有效;NORMAL则保留原文等待ACK。`retained_unacked_count`统计原文仍保留、已完成交接记账且待确认的ASDU条目,HIGH恒为0;`overwritten_unacked_count`统计NORMAL原文已覆盖、仍待确认的条目。全部已编号未ACK的I帧数等于Manager的`high_unacked_count + idle_unacked_count`加NORMAL保留及覆盖待确认数;已ACK但尚未消费的回执仍占记录槽,不能将记录数直接等同于未ACK数。`is_storage_empty`只表示ASDU原文环为空,HIGH/NORMAL/IDLE仍可能有I帧待确认;SendBuffer的`is_idle`表示当前无帧和预留。记账不变量见[发送一致性](IEC104_发送模块_设计架构.md#manager-consistency),接口和行为变化见[发送模块接口迁移](IEC104_发送模块_设计架构.md#migration)。
- **AsduQueue**:HIGH/NORMAL各用一个调用方字节数组。HIGH头兼容模式为2字节,严格模式为19字节;NORMAL使用其头长宏,当前Windows 64位GCC下为16字节。兼容模式按FIFO游标和循环NORMAL编号管理,严格模式扫描等级候选、使用共同非回绕受理顺序及逐级票据,并保留覆盖待ACK身份。两种模式都不保存user_tag或NORMAL排空屏障;存储状态、FULL/ERROR和借用失效条件见[队列设计](IEC104_发送模块_设计架构.md#asduqueue)及[严格存储契约](IEC104_发送模块_设计架构.md#strict-priority-storage)。
- **SendBuffer**:结构内只存一份255字节当前I帧,另用调用方提供的 `IEC104_SendBufferControlFrame_t[]` 保存S/U,每槽APDU仅6字节。当前帧连续写完;控制队列排在下一未编号业务之前。取消了APDU节点池、控制预留量和重复的协议序号边界。
- **SendManager**:Connection在准备实际写socket时调用`Prepare_Next_Send`,无当前帧才从HIGH/NORMAL重新选取并分配N(S);直接应答或IDLE也可先经各自提交入口建立当前帧。重复准备只返回当前帧剩余部分,最多一帧I尚未本地完成。实际写入后用`Handle_Send_Progress`;解析后的I/S用`Handle_I_S_Frame`。有效ACK先登记整个新确认区间的事实并逐帧通知内部acknowledged观察器,分别核减HIGH/IDLE未确认数,再对NORMAL释放原文或核减覆盖待确认数。IDLE不调用队列Mark_Submitted或handed,但正常参与ACK及收尾RECORD。确认记录由TcpServer复制为RECORD事件后经Connection移除,业务稍后处理事件副本。原文出队或覆盖不撤回当前帧、不释放k窗口,也不重置期限;完整顺序见[累计ACK处理](IEC104_发送模块_设计架构.md#manager-ack)。
业务入口为Slave;其下的TCP及发送内部调用主线为:
| 路径 | 内部职责与模式边界 |
|---|---|
| 主动上报 | `TcpServer_Enqueue_Event`复制进服务NORMAL,离线可缓存;严格模式另记录业务等级及共同受理顺序 |
| 普通/Tracked应答 | 经Connection、Manager的共同应答路径;兼容模式可直接准备或入HIGH,严格模式先尝试入队,容量WAIT时才检查有序直交 |
| ACK观察应答 | 先预留独立观察能力;兼容模式强制入HIGH,严格模式也允许符合条件的队满直交,两者均使用非零票据 |
| 空闲准入/提交 | `Query_Idle_Send`只读不预留,`Send_Idle`复查准入后直接建立IDLE帧;严格模式还比较业务候选 |
| 内部收发 | Connection经Manager准备字节,TcpServer经Net读写并回报进度;Receiver成帧后由Manager统一提交链路事件 |
| 事件交付 | TcpServer复制I帧/回执到事件队列并释放相应内部资源,业务通过`NextEvent`取值副本 |
表中省略统一IEC104前缀。普通与Tracked应答共用交接路径,普通入口不向应用输出票据;协议工作到期时Connection只把应答入HIGH,交回正常Process先处理接收与期限。严格直交时,ACK观察须在首次socket写入前关联实际帧身份,不能等写入以后才安装;具体条件见[严格候选仲裁](IEC104_发送模块_设计架构.md#manager-strict-priority)。
内部模块读取AsduQueue时,`AsduHeadInfo`通过两段借用返回可能跨环尾的原文,需要连续副本可用`Copy_Asdu`。HIGH的`entry_id.entry_serial`恒为0,不能作为逐条身份或应答凭证;从Peek到Mark之间不得改变所选候选。覆盖、ACK释放等操作会结束借用,严格模式的原地压紧还会使同环此前所有原文借用失效;完整规则见[队列接口](IEC104_发送模块_设计架构.md#aq-functions)。Manager已处理跨界原文,传输层取得的APDU仍连续。
HIGH容量按`N × (本模式头长 + L)`计算,头长兼容为2、严格为19;NORMAL还须考虑待ACK原文和严格覆盖身份头的占用,不能只按当前待发条数估算。TcpServer兼容HIGH最低251字节,严格模式初始化要求至少268字节;NORMAL最低为其头长加249字节,当前ABI下为265字节。额外票据元数据、栈工作区及完整计算口径见[静态存储与容量](IEC104_发送模块_设计架构.md#integration)。
兼容模式NORMAL使用非零循环条目编号,HIGH使用独立隐式FIFO序号。严格模式改用两环共同的非回绕受理顺序,NORMAL同时用它作为条目身份,HIGH另有逐级交接票据;不能沿用兼容模式的半环推导或编号回绕结论。各类编号、耗尽及取消历史见[严格存储契约](IEC104_发送模块_设计架构.md#strict-priority-storage)。
Manager的`Prepare_Next_Send`成功值是**OK**;`Submit_Response`以OK表示直接准备、QUEUED表示已缓存HIGH;控制帧入队成功仍为QUEUED,不能按布尔值判断。队列发送、直接应答及IDLE共用组帧和发送记录。两种模式都不能替换已准备的当前帧,也须遵守窗口、记录槽及控制义务;兼容模式另受旧HIGH及公平配额约束,严格模式按当前等级、已有候选和业务轮资格检查。IDLE的兼容准入要求没有待发队列项,严格准入可以在仅有更低等级候选时通过;两者都须满足reserve及启动/EOF门禁。完整条件见[严格仲裁](IEC104_发送模块_设计架构.md#manager-strict-priority)及[IDLE准入](IEC104_PeriodicScan_设计架构.md#5-idle-发送与-reserve)。TcpServer一次最多尝试一次非阻塞写入,部分写入继续同一帧。
`Submit_Response_Tracked`只增加交接票据,不改变普通应答的调度方式。兼容模式默认连续4帧HIGH后让出一次可发送NORMAL,配额设为0表示HIGH始终优先,**不等于启用严格业务模式**。严格模式不使用此配额,而是在可发送候选中按等级选择、同级按共同受理顺序比较;这仍不替应用规定采样值的新旧关系或事务依赖。
Slave提供`Send_ASDU_Tracked`和`Send_Response_Tracked`,票据输出可为NULL,只有成功接手才改写。兼容直接交接返回0,入HIGH返回非零;严格模式的入队和有序直交均取得非零票据,不能把0当作跨模式通用的直交标记。`Get_Response_State`只读返回PENDING/HANDED/CANCELLED/ERROR;HANDED仅表示SendBuffer接手,CANCELLED还可能代表旧历史无法精确确认。成功、失败输出及业务补报用法见[应答票据API](IEC104_API接口汇总.md#response-ticket-usage)。原Try接口删除的历史迁移事实保留于[通用应答发送变更记录](IEC104_通用应答发送变更记录.md),不能用该历史口径覆盖现行严格模式。
`Slave_Send_Response_Acked`先检查独立观察槽;兼容模式强制入HIGH,严格模式还允许符合仲裁条件的队满直交,两种模式均关联非零票据。排队路径在后续交接时补入帧身份,严格直交在首次socket写入前建立关联。ACKED或LOST仍占观察槽,业务须Release_Ack;观察本身不替应用推进网络或判断业务期限。完整生命周期及普通ACK/活动期ACK的区别见[ACK回执使用](IEC104_API接口汇总.md#response-ack-usage)。
IDLE的Query成功不预留容量,Send须复查会话、未读请求、期限及发送准入;WAIT不缓存本次快照,由扫描下次重新取值。IDLE不进入HIGH配额竞争、不产生HIGH票据,也不建立ACK观察槽,正常发送记录仍负责本地完成、累计ACK和关闭收尾。完整分层检查见[IDLE准入与reserve](IEC104_PeriodicScan_设计架构.md#5-idle-发送与-reserve)。
Slave/TcpServer原文提交统一返回`IEC104_TcpSubmitResult_t`:`IEC104_TCP_SUBMIT_OK`表示已接手ASDU,不保证已写完或已ACK;WAIT表示未接手,业务按该路径保留原文或重取当前值;FATAL可能发生在已写出字节后,须处理收尾事件。`Enqueue_Event`缓存NORMAL事件,`Send_Response`尝试直接发送或缓存HIGH,`Send_Response_Tracked`另提供交接凭证,`Send_Response_Acked`另保留ACK观察,`Send_Idle`只在准入时直接接手快照;调用后重新Prepare刷新调度条件。各业务模块另有自己的结果枚举,不能混用。旧Enqueue_Normal/Enqueue_High入口与TCP_ENQUEUE结果名已移除,不保留兼容包装。
子站受理STARTDT_ACT即进入STARTED,STARTDT_CON作为发送任务按FIFO完成。STOPDT受理即停用并停止选取新业务,最多完成一帧此前已编号的当前I帧,等待已发帧确认后返回CON;未提交的NORMAL保留未编号,HIGH按下述规则清理。公共S、t2、TESTFR、t3及子站启停继续由Manager封装。接收接口WAIT时须有界保留原帧并按顺序重试;START尚未受理,TESTFR_ACT已登记接收事实但CON等待入队。
Manager初始化成功会清空HIGH待发原文;新STOP受理时清空HIGH。从停用状态受理START时,生成本轮首个STARTDT_CON并清空HIGH;已激活状态下的重复START仅追加CON并保留HIGH。兼容模式在这些初始化/重新启用边界重置公平配额,严格模式继续按其等级与票据规则运行。START返回WAIT时尚未受理,不清理HIGH。以上清理均不影响NORMAL,也不撤销已提交的当前I帧及其发送记录。
初始化使用字节容量和控制槽数组,AsduQueue_Init最后一个参数为非零HIGH下一序号。此前改造已移除`Enqueue`的最后一个user_tag参数,以及条目查询、发送存储记录和记录查询中的user_tag字段;旧调用方须迁移、重新编译并初始化。HIGH/IDLE发送记录的`asdu_entry_serial`恒为0,不保存应答凭证,NORMAL继续保存条目编号;三种来源都用独立frame_id处理发送完成和帧回执,IDLE不属于队列优先级COUNT的遍历范围。发送记录数组使用`IEC104_IFrameSendRecordStorage_t`,连接代次由Manager统一保存;查询输出用`IEC104_IFrameSendRecord_t`,返回完整`frame_id`。Windows 64位GCC下,历史上的user_tag移除曾使每条存储记录由56字节降为48字节,查询快照由64字节降为56字节。下例仅展示兼容模式的内部绑定,不含严格模式的PriorityState绑定和模式启用:
```c
static IEC104_IFrameSendRecordStorage_t records[12];
IEC104_AsduQueue_Init(&queue, high_bytes, sizeof high_bytes,
normal_bytes, sizeof normal_bytes, generation, high_next_sequence);
IEC104_SendBuffer_Init(&buffer, control_frames, control_count, generation);
IEC104_SendManager_Init(&manager, &queue, &buffer, &link,
records, 12, k, high_burst_limit);
```
以上省略返回值检查,完整示例、接口替换及容量单位见 [发送模块设计](IEC104_发送模块_设计架构.md#integration) 和 [接口迁移](IEC104_发送模块_设计架构.md#migration)。全新HIGH凭证生命周期的high_next_sequence为1;同一服务Close后重新Init必须传回先前保存的next,不能从1复用旧号。Link须先按CONTROLLED初始化。Manager允许绑定有未编号业务的队列,绑定成功会清空HIGH、保留NORMAL,不接管运行中的旧连接。
`Manager.Abort`保留AsduQueue;结束旧I/O并核对记录中的ACK事实后,TcpServer经Detach清空HIGH并恢复NORMAL离线缓存,新连接再Rebind到新代次。**HIGH固定用于当前连接的请求应答,NORMAL固定用于允许跨连接恢复的事件。** 兼容Rebind只更新头和控制字段;严格Rebind还删除覆盖身份头并原地压紧剩余原文,保留其身份、等级和相应顺序,再恢复待发。两种模式均先完成校验,不使用额外载荷整理数组;不能把“不增加整理数组”理解成严格模式不移动原文。完整绑定、借用失效及恢复规则见[队列生命周期](IEC104_发送模块_设计架构.md#aq-reconnect-policy)与[严格存储契约](IEC104_发送模块_设计架构.md#strict-priority-storage)。
Rebind清除旧覆盖待确认计数,旧entry_id和原文借用失效;已覆盖原文不能恢复。它本身不发送,新连接仍须完成STARTDT;同一TCP上的STOPDT/STARTDT恢复不调用Rebind。HIGH清理登记取消区间并保留下一序号,应答凭证仍可查询;历史无法精确确认时保守返回CANCELLED。关闭整个服务时,TcpServer在Queue.Abort前把next保存到队列外;Reset_Server、Init失败重试及槽重用均不复用旧号,Close后仍可查询旧票据,重新Init从保存的起点继续。Destroy后旧句柄及其票据失效。未ACK不证明对端未收到,NORMAL只用于业务允许向同一接收方或冗余域恢复的事件;旧请求应答应放HIGH。服务关闭清空缓存,不提供掉电持久化。未编号条目被覆盖或重连丢弃时没有帧回执,旧帧回执须在Manager.Abort前读取;尚不提供冗余组切换或应用业务去重。
Connection通过`SendManager_Get_Deadlines`一次取得当前队首身份、本地发送及I帧t1剩余时间、控制槽容量;对应活动标志为1且剩余时间为0表示到期。原始queued_at_ms仍保存在SendBuffer,written_at_ms仍保存在Manager记录,部分ACK后选下一条的原始时刻。Connection的`Collect_Deadlines`汇合TESTFR、STOP、t2及t3,供超时检查、发送准入、控制推进和等待查询共用;不创建系统定时器,也不缓存第二份计时起点。原有底层单项超时接口保留。TcpServer在Process中执行TCP读写并驱动Connection,Poll复用该推进核心。
发送准备和写入回报仅因本地发送及STOP期限直接报告超时;ACK/TESTFR的t1故障交给接收阶段判定。旧确认t1已到时,统一发送准备入口暂停为HIGH/NORMAL创建、编号新I帧,IDLE的期限检查同样阻止新快照编号;已有帧及控制发送仍可推进,避免控制槽解阻后继续新增业务帧。有效确认解除所有已到期等待后自动恢复准入。Send_Response和常规发送仍按send后的真实时刻登记完成,发送期间跨过确认期限时安排立即Process,先有界处理已到达的确认,再按原始t1检查。Prepare对到期协议期限返回零等待;不增加恢复期限或固定宽限时间,也不改变真实容量背压下的超时策略。
## 子站连接协调层(已实现)
TcpServer内部的`IEC104_Connection_t`内含一个Receiver、一个Link、一个SendBuffer和一个SendManager,借用TcpServer提供的ASDU队列、控制槽数组及发送记录数组。初始化后保持对象地址不变,同一连接的所有调用串行执行。内部接口、时间规则及重连顺序见[连接层设计](IEC104_Connection_设计架构.md)。
Connection_Init先准备Receiver及配置,再由`SendManager_Init_Connection`校验并向最终地址提交Link、SendBuffer和绑定关系,最后提交其余连接字段;失败保留原Connection和队列。
控制帧是否可准备由Link的`Can_Prepare_*`只读接口判断,并与实际构帧共用规则。Connection对Link保留只读访问,运行期修改统一经SendManager,TESTFR_CON也经`SendManager_Handle_Testfr_Con`提交;只有返回OK才撤销本端探测t1,IGNORED不取消计时。Connection不直接查询SendBuffer,也不操作Manager的内部指针。Connection及SendManager的完整结构体供内部静态嵌入;TcpServer公开头文件隐藏这些布局,业务只使用TCP句柄、公开值类型及事件接口。
以下步骤均在TcpServer及Connection内部执行:
1. `Connection_Init`以CONTROLLED角色初始化STOPPED链路。成功受理STARTDT_ACT即进入STARTED/IDLE并开放I帧准入,发送队列保证已有CON先于随后准备的本端I帧写出。
2. 收到TCP字节后调用`Connection_Feed`,按`consumed_length`推进输入。一次最多处理一帧;未消费尾部由TcpServer保留。半帧留在Receiver中;S/U受理后自动释放;I帧返回FRAME_READY后由TcpServer经Peek复制为事件,再按`receive_serial`显式Release。
3. WAIT时Connection保留原文并在后续驱动中重试;START尚未受理,TESTFR_ACT已登记接收事实但CON待入队。成功受理的START/STOP按控制帧路径自动释放原帧;重复驱动不会再次提交同一I帧的序号或ACK,TESTFR_ACT重复登记幂等。
4. `Connection_Prepare_Next_Send == SEND_READY`时取剩余字节实际写入,再用`Handle_Send_Progress`回报增量;0字节和部分写入保留当前帧及原期限。整帧完成自动提交对应Link完成和Manager记录,不能另调底层Complete。本地已知发送完成必须先回报,再Feed覆盖该帧的ACK。
5. 定期调用`Connection_Tick`推进本地发送期限、I帧/TESTFR的t1、w/t2确认、允许时的t3探测和STOP总期限。收到主站ACT后抑制新的t3探测,既有TESTFR等待CON的t1继续且不因其他活动续期。停止过程中的重复STOP和WAIT不延长原期限;START成功受理取消旧STOP总计时,但不清除TESTFR接收事实。t2保留连续未确认接收区间的最早起点,前缀被确认时不续期。
6. FATAL后连接冻结,TcpServer停止真实I/O,把剩余记录和断开通知复制为事件,再调用Connection_Close。Connection_Close保留内部ASDU队列;TcpServer随后Queue.Detach清空HIGH并保留NORMAL,离线期间继续接受NORMAL;重连时Queue.Rebind到新代次,再Connection.Init。仅Close服务清空全部ASDU。所有旧代次事件返回ERROR,不修改新连接。业务只处理TcpServer交付的事件并执行ASDU业务逻辑。
旧 `IEC104_Rx_Feed_Byte`、`IEC104_Rx_Reset`、`IEC104_Legacy_Link_Reset`及相关类型保持原样;旧入口继续使用全局单路状态、预设STARTED,成帧后检查I/S接收条件和N(R),通过共用Link忽略接收N(S)连续性,只返回接收结果。旧入口不路由U帧,也不替调用方处理TESTFR应答。Connection使用新Receiver并共享自身Link与SendManager,不调用旧全局接收入口。同一条连接不能同时交给这两条接收路径。
因接口过期而无法编译的旧回归测试及专用辅助文件已删除。当前事件环、调度和Windows Net回环检查分别由`iec104_tcp_event_ring_test.c`、`iec104_tcp_scheduler_test.c`和`iec104_net_pending_input_test.c`提供;现行数量及两项链路修复的覆盖范围以[测试说明](../test/IEC104测试文档.md#receive-sequence-compatibility-regression)为准,历史记录不替代当前测试范围。
2026-10-20调度修复:预算让出时固定已到达输入范围并立即续跑,处理完后再判定ACK/TESTFR超时;后续新输入不能扩大旧批次。发送使用独立预算,持续接收不再跳过发送阶段。业务API及配置宏不变,内部Connection和Net新增续收/输入快照支持,自定义Net后端需实现`IEC104_Net_Pending_Input`。真正容量背压仍遵守原有严格期限;回执与启停通知的顺序继续按B方案。
以下为历史变更与验证记录,不代表当前保留的测试范围:
2026-09-23:NORMAL空间不足时改为覆盖最旧原文(含已提交未ACK条目),HIGH继续满时拒绝;当前APDU和发送记录独立保留,ACK兼容原文已覆盖。条目支持跨尾部存放,无填充碎片。仅更新代码和设计文档,测试文件保持原样。
2026-09-23:三发送模块改为变长ASDU字节环、单当前I帧和紧凑控制队列,发送前编号,有效ACK释放原文,业务回执独立消费,支持显式Rebind。保留ACK不得越过本地完成位置的修复。原有全部119个用例通过;本次补充校验从标准输入编译执行,未修改或新增测试源码、测试配置和测试文档。
2026-09-18:LINK测试改为报文回放用例,当时默认LINK套件68个、全部套件119个场景通过。该套件已随过期测试清理移除,历史记录保存在`.build`中。
2026-09-16:TESTFR改为三态,取消提前CON的缓存;当时旧用例因状态枚举变化而无法编译,未计为该次变更的验证结果。
2026-09-14:完善STARTDT期间的收发方向门控,当时新增LINK 36至40。算法契约见[链路设计](IEC104_Link_设计架构.md)。