IEC104 链路模块
设计架构阅读路径
严格发送顺序见12级业务优先级设计:统一配置入口默认启用,主示例及参数多主站示例使用同一策略。业务等级独立于HIGH/NORMAL的存储生命周期,按完整帧边界仲裁,并纳入已就绪但尚未组帧的业务候选。
按层阅读:各业务模块 → TCP 服务 → 连接协调 → 发送模块与链路算法。业务模块各有独立架构文档;业务层总览补充跨模块分派、发送路径和调度关系。
需要按具体问题定位时,从接入与排障导航进入各模块的数值推演、异常时序和检查步骤;同一问题涉及多层时先看完整流程的等待定位。
启动补发通过 IEC104_Startup 统一配置和协调,主示例直接复用;接入见统一入口。该模块等待本轮Type70、全部参与站真实全站总召末帧HANDED后放行NORMAL/IDLE,HIGH应答和变化入队仍可推进。原五个分散配置入口已移除,迁移须使用五参数统一配置。
采集数据的三条保存与上送路径见跨模块调用流程:Type42发送同一故障时刻的快照,FaultRecorder/Comtrade提供连续波形,History/HistoryFile负责附录B循环记录及XML。后两类经Type210调阅,共享协议服务但各自管理数据、持久化和快照寿命。公共接口分别见录波、COMTRADE、历史核心和历史文件。
冻结电能由公共EnergyFreeze独立维护INTERVAL/DAY、FLOWREV和SEAL/META,经Type210提供FRZ/FLOWREV文件。主示例用--energy-freeze existing-directory接入持久存储和整数模拟计量,206读取与文件冻结各持独立快照;计数量请求处理仍归CounterInterrogation。专项入口为./scripts/build.ps1 -Test -Suite EnergyFreeze。
各业务模块设计架构
以下文档按模块说明职责和文件依赖、内部结构与所有权、状态与关键函数流程、公开接口及完成边界、设计取舍和验证依据。各文另有提交点、WAIT 后的持有与恢复、期限和清理顺序、具体情景及现有测试定位。接入时先读目标模块,再查完整调用流程和API 汇总;维护时可直接从下表进入对应的状态推进与恢复说明。
| 独立业务 | 设计架构 | 重点状态与边界 | 维护入口 |
|---|---|---|---|
| 总召 / 分组总召 | Interrogation | 规则与引擎分工;BEGIN、数据批次、确认/终止、广播目标及撤销 | 入口判定 · 修改与测试 |
| 计数量召唤 | CounterInterrogation | QCC/FRZ 规则;读取和冻结/复位动作分支,共用引擎但实例状态独立 | 动作提交 · 修改与测试 |
| 遥控 | Command | 点配置、选择/执行、应用动作、返回信息、尾票据交接及 FINISHED | 提交与WAIT · 修改与测试 |
| 校时与读时钟 | ClockSynchronization | 固定任务槽、读/设时回调、滞留补偿、快照与FIFO回复 | COT5读时 · 提交与WAIT |
| 读命令 | Read | READ/REPLY FIFO、原站引用、队首取值、WAIT 重取及提交前期限 | 推进、恢复及测试 |
| 参数装载 | Parameter | 110–113、运行值确认 FIFO、默认同步生效及可选 ACK 两阶段 | 接入 · 示例测量链 · 测试 |
| 远程参数 | RemoteParameter | 200–203、显式预置/固化/撤销、TLV读取及恢复 | 预置与恢复 · 接入 · 测试 |
| 文件服务 | FileService | 210、目录快照、IDLE读取、写暂存与COMMIT、BUSY事件保留 | 状态 · 所有权 · BUSY · 接入 · 测试 |
| 系统命令 | SystemCommand | 请求、初始化遍历、复位授权三个状态域;ACK 门控与事件清除 | 推进与恢复 · 情景与测试 |
| 启动补发协调 | Startup统一流程 | 配套配置、本轮初始化、逐站总召票据及生命周期归还 | 接入入口 · 接口 |
| 软件升级 | SoftwareUpgrade | 211、真实/TEST会话、END确认ACK、ABANDON及一次性授权 | 状态 · 引用 · 诊断 · 接入 · 测试 |
| 突发上送 | Spontaneous | 普通变化完整前缀、双形态提交,以及Type42整份故障快照、NORMAL与应用重试 | 完整前缀与重试 · 故障快照 · 情景与测试 |
| 周期 / 背景扫描 | PeriodicScan | 会话、组网格、点级标签、有界组帧、IDLE 交接及在线替换 | 入口判定 · 修改与测试 |
各模块的“成功”含义不同:读命令以应答接手为完成点;扫描在接手每帧后推进游标,遍历结束才完成本轮,仍可能保留待重试点。遥控还观察尾帧HANDED,QRP1则在有效ACK后才可能交出复位授权,Parameter的可选ACK扩展另须交付COMMIT/ABORT。RemoteParameter的SOLIDIFY返回APPLIED时运行值已发布,确认提交及失败恢复另行推进。具体条件由各自文档定义,不能只按同名OK、Process或FINISHED推断。
当前业务与统一入口
接收N(S)兼容与主站TESTFR发起后的终端抑制,按细则第8.2.1条注和第8.2.2条统一生效。行为变化、底层接口迁移及验证证据集中见两项链路修复汇总,无需另配开关或应用心跳任务。
主示例按本目录实施细则使用总召外带时标遥信、选择后执行/撤销及表8十六进制地址分区。Spontaneous单/双点默认值随之改为仅CP56,Command/Read/PeriodicScan的通用能力保持各模块契约;对应职责与迁移入口集中见默认策略设计。
软件安装由公共IEC60870_FirmwareUpdate管理三槽、持久授权、试运行和回退;示例用--upgrade-store接入实际文件安装及dtu-1备份。它在211的Take成功后开始持久任务,不改变协议ACK含义。通用核心没有对104、Windows、RTOS或文件系统的依赖,宿主适配单独位于examples/iec104_example_upgrade.c/h;目标Flash和Bootloader由平台实现相同回调。见分工与存储设计、接口及使用入口。
接线时先完成启动恢复,运行中按持久授权交接处理文件完成、END和Take。Prepare_Boot每次启动或激活只调用一次,健康确认另由Confirm完成;普通105重建和网络重连不能借用启动恢复入口。存储布局、错误恢复和验证证据的集中入口见升级导航。
附录C运行日志以公共IEC60870_UserLog和IEC60870_UserLogFile提供1024条循环记录及XML导出,主示例用--user-log existing-directory独立启用并接入Type210。记录类型、来源边沿、校时回拨、存储及移植边界见运行日志设计,接口见核心和XML。
软件升级由独立business/IEC104_SoftwareUpgrade.c/h提供Type211启动、结束、撤销及ACK后授权。应用通过Type210接收升级候选并维护设备owner;协议只通过显式action作决定,Take成功后由应用进入QUIESCING。默认ACKED允许STOP排空期ACK,ACTIVE_ACKED只认首次STOP前;已确定授权跨连接保留。见设计、接入及验证。
周期/背景扫描由独立 business/IEC104_PeriodicScan.c/h 提供:按组或点级公共网格同步取当前值,经 IDLE 直接交接,不占 HIGH/NORMAL 队列,不跨 STOP/重连补发。支持在线周期和整表替换;SQ 默认关闭。接入见扫描调用流程,类型、借用和拥塞边界见扫描设计。
系统命令由独立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任务转否定确认;已提交后超时只撤销授权,不补发相反确认。接入见系统命令调用流程,范围及取消边界见设计说明。
读命令业务由独立 business/IEC104_Read.c/h 提供,Type102直接返回COT5单点值或45/46/47错误,不进入召唤的激活流程。只对队首同步lookup,默认15000ms提交前期限;HIGH拥塞不取值,提交WAIT后重取。主示例单/双点返回Type30/31,步位/位串/遥测返回Type5/7/11;通用白名单仍包含无时标监视类型及30–36。取值时刻见示例读取快照,接入见读命令调用流程。
参数装载由独立business/IEC104_Parameter.c/h提供Type110–113请求校验、固定FIFO、运行值确认和显式应用动作;默认同步生效,五项扩展全部关闭。主示例默认把参数接入门限、平滑和量程品质处理,--no-parameter可关闭、--parameter可显式开启;算法及比较基准属于应用。参数读回通过总召,不通过Type102或参数突发。接入与运行边界见参数设计,算法集中见示例测量链;可选--config的INI存储与停机编辑由示例负责,见参数持久化。
远程参数由独立business/IEC104_RemoteParameter.c/h提供Type200–203区号、TLV读取和预置/固化/撤销;与标准Parameter分别启用,示例通过--remote-parameter开启、默认关闭。参数通过202读回,不加入总召;应用持有点表、暂存和运行值,负责原子固化与跨模块约束。协议状态见预置与恢复,回调环境寿命见应用契约,具体地址与复位行为见示例点表。
文件服务由独立business/IEC104_FileService.c/h提供Type210目录、读文件及写文件;示例通过--file-service开启。数据环满返回BUSY,应用保留同一事件并推进本地写步骤,COMMIT与发送仍须先读空通知。目录快照和文件句柄成功打开后恰一次收尾,固定回复和COMMIT实际预留槽有独立期限;读数据走IDLE,确认走HIGH。存储事务、内容格式和升级候选由应用负责,见文件服务设计。
当前子站业务统一包含IEC104_Slave.h:Slave内部持有不透明TcpServer,提供生命周期、事件循环、主动上报和状态查询,并在NextEvent交付I帧时自动建立ASDU视图及原连接的共用应答接口。业务不再手动创建TcpServer、绑定generation或安装函数指针。入口和延迟任务示例见子站统一入口。
Slave提供共用站点表:应用提供固定地址节点,动态注册多个CA和业务context,重复CA拒绝。删除立即退出路由,已有引用和遍历结束后才回收;Is_Reusable为true后应用才能释放存储。总召设置config.use_station_registry=true后按请求CA选站;多目标广播配置每站状态区,以一个任务执行“全部确认、逐站数据、全部终止”。其他业务可复用相同的查找、引用及快照遍历接口。
总召由独立库模块IEC104_Interrogation.c/h实现,支持QOI=20站总召、21..36分组总召及多类型无时标监视数据,负责批次校验、发送等待、主站撤销、业务超时及停用/断线取消。应用通过BEGIN/NEED_DATA/FINISHED事件和显式应答管理IOA、分组、遍历、逐批取值及终结;子站示例提供模拟点表、事件分派和main,构建运行见示例说明。
内部调用关系为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回执还记录有效累计ACK和首次时刻,两者都不提供跨队列点值排序。旧Try/Ordered迁移事实见通用应答发送变更记录,当前普通凭证用法见API说明。
Get_Status同时提供high_queue和normal_queue的待发条目数、保留原文条目数及总容量/已用/空闲字节数,先检查asdu_queue_status_valid。待发数不包含已交给发送模块的ASDU;NORMAL保留到ACK前的原文仍计入存储量,字节统计包含条目头。Init成功后离线也可查询,Close后统计无效;队列为空不代表发送或确认全部完成。公开状态结构已扩展,库与调用方须一起重新编译,字段含义见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和日志接线。
Get_Status的pending_state_event_count报告尚未消费的ACTIVATED/DEACTIVATED数量,不能追溯已消费的启停历史。当前请求的错误应答可在同步分派中调用IEC104_Slave_Reject_Request,支持COT=44..49且固定P/N=1,复用HIGH且不改输入事件;48表示遥控执行软压板状态错误,49表示遥控执行时间戳错误,50不支持。不新增示例应答队列。调用时机、WAIT丢新策略与FATAL不可重试约定见同步拒绝当前请求。
发送队列NORMAL与NextEvent业务通知FIFO是两份独立存储:NORMAL满时可覆盖旧ASDU原文;已入队业务通知逐条保留,不覆盖、不合并启停变化。通知按有效载荷长度存放于字节环,配置宏仍表示保证条数:默认普通30条最长通知、启停4条及收尾32条记录加1个最长I帧和1个断开通知。当前x64 ABI下环占11283字节,接收暂存默认2048字节,两块合计13331字节;连接发生时标使默认环增加40字节,16字节APDU仍可在普通区缓存185条。普通通知不能占用启停及收尾预留;启停配额满时暂缓受理后续改变状态的ACT,已有CON继续发送。详细公式见TCP服务设计。
新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_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节。
| 阅读入口 | 负责内容 |
|---|---|
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 |
共用召唤引擎:任务、广播、期限、事件、取消与发送等待;接入见总召流程 |
business/IEC104_GeneralInterrogation.c/h |
Type100规则及兼容的Interrogation_Create入口 |
business/IEC104_CounterInterrogation.c/h |
Type101规则、创建及一次动作执行入口;见计数量设计 |
business/IEC104_ClockSynchronization.c/h |
Type103校时/读时校验、显式回调、原文确认或当前时间快照;见时钟同步设计 |
business/IEC104_Read.c/h |
Type102单点当前值、结构校验、同步lookup、FIFO与提交前期限;见读命令设计 |
business/IEC104_Parameter.c/h |
Type110–113、参数点表与运行值借用、FIFO、显式动作、可选暂存/同址/ACK扩展;见参数设计 |
business/IEC104_RemoteParameter.c/h |
Type200–203、原文FIFO、区号/TLV、预置会话、显式动作、恢复/DISCARD;见远程参数设计 |
business/IEC104_SystemCommand.c/h |
Type107/70/105,初始化轮次、ACK后复位/专用授权和按CA清除;专用QRP默认关闭,见系统命令设计 |
business/IEC104_Startup.c/h |
统一细则配置,协调本轮初始化、全部站总召与缓存补发;见统一启动入口 |
IEC104_Config_Internal.h、business/IEC104_BusinessConfig_Internal.h |
库内基础填值声明,供Startup向下调用;应用、示例和测试只用Startup公开配置入口,不直接依赖这两个私有头 |
business/IEC104_Command.c/h |
Type45–51/58–64遥控、遥调、按点模式、选择执行、动作前时效与容量检查、业务期限及返回信息;见遥控设计 |
business/IEC104_Spontaneous.c/h |
普通14类/23个Type监视信息及Type42专用故障快照发布、无时标/CP56及双报、NORMAL覆盖统计;见突发设计 |
business/IEC104_PeriodicScan.c/h |
周期/背景组网格、点级周期与待重试资格、同步lookup、IDLE直发及在线换表;见扫描设计 |
IEC104_TcpTypes.h |
Slave与TcpServer共用的配置、调度、事件和状态值类型,无服务操作接口 |
IEC60870_InformationObjects.c/h |
69种独立信息对象,覆盖监视、命令、初始化、参数和文件;编码通过只读函数表分派,支持变长文件段 |
IEC60870_FaultEvent.c/h |
Type42扩展格式的完整ASDU编解码,两组数量/类型及记录;不采用普通对象函数表,详见故障事件设计 |
IEC60870_FaultRecorder.c/h、IEC60870_Comtrade.c/h |
连续采样窗口、冻结记录及COMTRADE 1999编码;通过应用接入Type42和Type210,详见录波设计 |
IEC60870_History.c/h |
附录B的SOE/遥控事件环、32日定点与极值、点表指纹、序列化及恢复;存储回调由调用方提供,见历史核心设计 |
IEC60870_HistoryFile.c/h |
四类历史XML、规范文件名和最新30个完成日导出;流式输出不接管文件,见历史文件API |
examples/iec104_example_history.c/h |
Windows双bank持久后端及独立目录/读快照;属于宿主接入,见历史存储与快照 |
IEC60870_UserLog.c/h、IEC60870_UserLogFile.c/h |
附录C的1024条循环日志、恢复及ULOG XML;独立于历史点表,见日志核心与格式 |
examples/iec104_example_user_log.c/h |
独立ulog.store双bank后端、目录缓存与下载副本,见日志持久与快照 |
IEC60870_Time.c/h |
101/104共用时间工具:CP16/CP24/CP56Time2a编解码、本地标准时间转换、SU修正、日历/星期和纪元秒数工具;使用约定见时间工具设计 |
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_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_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.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_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格式、时间基准、毫秒来源及掉电状态由具体驱动处理。接入示例见统一时间源读写,业务待接入项见当前接入状态。
时间戳转日期保留两种实现:Windows默认调用CRT的64位_gmtime64_s;编译IEC60870_Time.c时定义IEC60870_TIME_USE_PLATFORM=0即可使用原有整数算法,其他平台默认采用此配置。配置在编译时生效,业务接口、UTC含义及1970..2099年的范围一致。此选项只决定如何转换传入的时间戳,与是否接入RTC无关;应用使用RTC作为时间源时,仍需通过相应驱动读取时间,再按返回值的格式和时间基准调用转换或编码接口。详见实现选择。
业务接收按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,不能单独恢复小时和日期,需由业务结合已有时间基准解释。完整范围、星期和保留位策略见时间工具设计。
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状态。内部接口和迁移说明见 编解码与接收器设计。
接收器校验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_。它们报告最终发送结果,包括失败;返回 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职责与生命周期。
底层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与启停的内部边界。
启停和主动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解析,见远程参数线格式。
应用层参数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在原缓冲区未修改期间有效:
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, ¶meters, 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取得独立类型的对象。例如处理单命令:
/* parameters、data、length对应收到的ASDU;处理期间原文保持有效。 */
IEC60870_AsduInfo_t info;
IEC60870_AsduResult_t status =
IEC60870_Asdu_Parse(¶meters, 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(¶meters, 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, ¶meters, 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为应用自己的同步处理函数,其中可以提交应答或复制事件到延迟任务:
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事件:
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。任务槽、事件队列和发送容量保持不变,内存测量见固定存储。其他需要完整事件的业务仍可用Copy_Event。
NextEvent返回EMPTY/ERROR时保持输出不变。Close、重连、重新Init或Destroy后复用服务槽,都不会把旧任务改绑到新连接;发送继续检查原身份。Destroy成功后旧服务句柄失效,但旧事件的字节仍由任务自身保存。所有延迟任务也在所属事件循环串行提交。
多帧总召的数据和正常终止应使用同一原请求身份,经HIGH接口依次提交并逐帧处理WAIT;把数据放NORMAL而终止放普通HIGH会造成优先级越序。可使用事件的connection调用Send_ASDU_Tracked,或保存紧凑身份后调用Send_Response_Tracked;门面不实现点表、总召状态机、遥控选择/执行或系统校时。
子站示例通过BEGIN/NEED_DATA/FINISHED事件与显式应答接入独立的总召模块推进业务;Slave和TcpServer继续负责服务、连接及传输。总召接入顺序见完整调用流程。
调用IEC104_Interrogation_Process(gi)自动推进当前就绪任务,无需传入预算。每个实例至多一个未终结总召,包含等待生成BEGIN的请求;忙时相同和不同QOI的新激活均否定,不保存后续总召。4个任务槽共用于这个总召和待发短应答。Handle_Event在原会话有效、Slave通知已读空且无更早REPLY时尝试立即提交短应答,未接手再保存。满槽时尝试否定确认;不能安全提交/保存则仅丢新请求并累计dropped_requests,保留当前任务及TCP。Process在空闲、等待应用/事件空位、发送WAIT或Slave通知未读空时返回。对象、状态、调度及接入约定见总召模块设计。
总召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,见启动补发协调。HIGH与NORMAL之间不保证点值时间顺序,HIGH满时仍不保证接手机会和整轮完成期限。详见数据批次与发送路径。
BEGIN携带实际CA、station_id和QOI=20..36;应用检查数据源并决定接受,首个NEED_DATA才需建立取数游标。多目标广播先完成全部BEGIN/ACT_CON,再逐站取数,最后全部ACT_TERM;每站状态区保证FINISHED无损交付。Submit_Batch只接受事件目标CA。新增/替代站下轮参加,尚未选入BEGIN便删除的站跳过;已经选中尤其已确认的原站必须完成或明确终结。各站从自己的BEGIN独立计时,早期站须覆盖后续站工作,库总期限默认关闭;FINISHING的终结事件读完前仍忙拒绝新激活。详见总召设计。
主站COT=8按原连接、目标CA/OA/TEST/QOI匹配总召。定向撤销只匹配活动站,其他站继续;多目标广播撤销只要原快照还有未结束目标就停止整轮,包括尚未BEGIN的PENDING站,并按原快照逐站回复COT=9:未结束目标肯定,已结束或已拒绝目标否定。已有否定ACT_CON先交接,首次FINISHED原因保持;未交付BEGIN的站不补造FINISHED。已被发送层接手的帧不撤回,撤销不补发成功ACT_TERM,详见总召撤销与取消。
库的业务接受和每批取数期限默认各15秒,执行整体期限默认0(禁用),各项均可单独配置;这些是业务策略,不是标准规定。命令行示例在Create前通过--gi-total-timeout、--ci-total-timeout分别设置120000ms初始值,显式0禁用并警告;部署必须按实际点数、编码、分批与链路条件评估,不能直接采用遥控60秒期限。预算覆盖T_begin + T_confirm + ΣT_batch + T_term + 余量,见整体期限预算。
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,应答回显保留请求时标。验证命令和覆盖范围见测试说明。
时钟同步业务
ClockSynchronization处理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、广播及失败策略见读时钟设计。
全部回复走HIGH,WAIT只重试固定回复。confirm_pending仅覆盖设时动作开始至确认被接手;读时不更新同步状态或应用基准。仍在HIGH的回复可被STOP取消,已发生的设时不回滚。广播调用一次对应回调、逐站回复;满槽丢新。示例默认使用模拟基准,--clock system调用Windows时间源。详见时钟同步设计。
遥控、遥调与带时标命令业务
Command处理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并清空模块持有的本事务应答,详见遥控设计。全局未启用类型继续交给后续处理器或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沿用原规则,详见重复选择复归。
设定值由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。完整规则见遥控设计、API第25节和遥控调用流程。
突发上送业务
Type42故障事件通过 IEC104_Spontaneous_Publish_Fault_Event 独立发布:输入已冻结的故障遥信、CP56和至少8项电气量,复用现有单帧缓冲,以第6级NORMAL上送,不增加普通kind或自动拆帧。接收端格式与实施细则的地址宽度差异、数值编码及WAIT契约见故障事件设计、业务入口。
Spontaneous接收应用提供的纯值变化,支持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,可以越过积压事件;示例保留遥控占位用于补报,不再门控总召或校时期间的发布。模块本身不做变化检测、死区或限速;参数模式的应用选择与提交基准见测量变化规则。完整契约见突发设计、API第26节和调用流程。
启停主流程
| 角色与过程 | 调用顺序 |
|---|---|
| 主站启动 | 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节。
被控站成功受理STARTDT_ACT时立即进入STARTED/IDLE,并生成STARTDT_CON。首个CON尚未Complete时,后续每个成功受理的重复START也生成一帧CON;同状态重复请求不再次产生激活通知。所有CON按FIFO发送,Complete只确认对应发送结果,不重新提交启停状态。首个STARTDT_CON尚未完成也能受理STOP,立即停用并进入STOP_DRAINING。具体分支见 链路设计第4.2节。
子站发送模块(已实现)
三个模块采用变长业务存储、发送前编号和独立确认记录组织。HIGH队列本身满时拒绝;严格Response另可在满足顺序条件时尝试队满直交。NORMAL允许覆盖最旧原文,严格模式仍保留已交接项的覆盖身份头,必要空间不足也会背压。IDLE准入后直接交给唯一当前I帧,不新增队列或重连原文。三条路径共用部分写入、期限、启停/TESTFR及回执;兼容模式使用HIGH公平配额,严格模式按业务等级及同级受理顺序仲裁,全部使用固定存储。两种模式的详细契约以发送模块设计为准。
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表示当前无帧和预留。记账不变量见发送一致性,接口和行为变化见发送模块接口迁移。
- AsduQueue:HIGH/NORMAL各用一个调用方字节数组。HIGH头兼容模式为2字节,严格模式为19字节;NORMAL使用其头长宏,当前Windows 64位GCC下为16字节。兼容模式按FIFO游标和循环NORMAL编号管理,严格模式扫描等级候选、使用共同非回绕受理顺序及逐级票据,并保留覆盖待ACK身份。两种模式都不保存user_tag或NORMAL排空屏障;存储状态、FULL/ERROR和借用失效条件见队列设计及严格存储契约。
- 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处理。
业务入口为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写入前关联实际帧身份,不能等写入以后才安装;具体条件见严格候选仲裁。
内部模块读取AsduQueue时,AsduHeadInfo通过两段借用返回可能跨环尾的原文,需要连续副本可用Copy_Asdu。HIGH的entry_id.entry_serial恒为0,不能作为逐条身份或应答凭证;从Peek到Mark之间不得改变所选候选。覆盖、ACK释放等操作会结束借用,严格模式的原地压紧还会使同环此前所有原文借用失效;完整规则见队列接口。Manager已处理跨界原文,传输层取得的APDU仍连续。
HIGH容量按N × (本模式头长 + L)计算,头长兼容为2、严格为19;NORMAL还须考虑待ACK原文和严格覆盖身份头的占用,不能只按当前待发条数估算。TcpServer兼容HIGH最低251字节,严格模式初始化要求至少268字节;NORMAL最低为其头长加249字节,当前ABI下为265字节。额外票据元数据、栈工作区及完整计算口径见静态存储与容量。
兼容模式NORMAL使用非零循环条目编号,HIGH使用独立隐式FIFO序号。严格模式改用两环共同的非回绕受理顺序,NORMAL同时用它作为条目身份,HIGH另有逐级交接票据;不能沿用兼容模式的半环推导或编号回绕结论。各类编号、耗尽及取消历史见严格存储契约。
Manager的Prepare_Next_Send成功值是OK;Submit_Response以OK表示直接准备、QUEUED表示已缓存HIGH;控制帧入队成功仍为QUEUED,不能按布尔值判断。队列发送、直接应答及IDLE共用组帧和发送记录。两种模式都不能替换已准备的当前帧,也须遵守窗口、记录槽及控制义务;兼容模式另受旧HIGH及公平配额约束,严格模式按当前等级、已有候选和业务轮资格检查。IDLE的兼容准入要求没有待发队列项,严格准入可以在仅有更低等级候选时通过;两者都须满足reserve及启动/EOF门禁。完整条件见严格仲裁及IDLE准入。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。原Try接口删除的历史迁移事实保留于通用应答发送变更记录,不能用该历史口径覆盖现行严格模式。
Slave_Send_Response_Acked先检查独立观察槽;兼容模式强制入HIGH,严格模式还允许符合仲裁条件的队满直交,两种模式均关联非零票据。排队路径在后续交接时补入帧身份,严格直交在首次socket写入前建立关联。ACKED或LOST仍占观察槽,业务须Release_Ack;观察本身不替应用推进网络或判断业务期限。完整生命周期及普通ACK/活动期ACK的区别见ACK回执使用。
IDLE的Query成功不预留容量,Send须复查会话、未读请求、期限及发送准入;WAIT不缓存本次快照,由扫描下次重新取值。IDLE不进入HIGH配额竞争、不产生HIGH票据,也不建立ACK观察槽,正常发送记录仍负责本地完成、累计ACK和关闭收尾。完整分层检查见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绑定和模式启用:
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);
以上省略返回值检查,完整示例、接口替换及容量单位见 发送模块设计 和 接口迁移。全新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还删除覆盖身份头并原地压紧剩余原文,保留其身份、等级和相应顺序,再恢复待发。两种模式均先完成校验,不使用额外载荷整理数组;不能把“不增加整理数组”理解成严格模式不移动原文。完整绑定、借用失效及恢复规则见队列生命周期与严格存储契约。
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队列、控制槽数组及发送记录数组。初始化后保持对象地址不变,同一连接的所有调用串行执行。内部接口、时间规则及重连顺序见连接层设计。
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内部执行:
Connection_Init以CONTROLLED角色初始化STOPPED链路。成功受理STARTDT_ACT即进入STARTED/IDLE并开放I帧准入,发送队列保证已有CON先于随后准备的本端I帧写出。- 收到TCP字节后调用
Connection_Feed,按consumed_length推进输入。一次最多处理一帧;未消费尾部由TcpServer保留。半帧留在Receiver中;S/U受理后自动释放;I帧返回FRAME_READY后由TcpServer经Peek复制为事件,再按receive_serial显式Release。 - WAIT时Connection保留原文并在后续驱动中重试;START尚未受理,TESTFR_ACT已登记接收事实但CON待入队。成功受理的START/STOP按控制帧路径自动释放原帧;重复驱动不会再次提交同一I帧的序号或ACK,TESTFR_ACT重复登记幂等。
Connection_Prepare_Next_Send == SEND_READY时取剩余字节实际写入,再用Handle_Send_Progress回报增量;0字节和部分写入保留当前帧及原期限。整帧完成自动提交对应Link完成和Manager记录,不能另调底层Complete。本地已知发送完成必须先回报,再Feed覆盖该帧的ACK。- 定期调用
Connection_Tick推进本地发送期限、I帧/TESTFR的t1、w/t2确认、允许时的t3探测和STOP总期限。收到主站ACT后抑制新的t3探测,既有TESTFR等待CON的t1继续且不因其他活动续期。停止过程中的重复STOP和WAIT不延长原期限;START成功受理取消旧STOP总计时,但不清除TESTFR接收事实。t2保留连续未确认接收区间的最早起点,前缀被确认时不续期。 - 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提供;现行数量及两项链路修复的覆盖范围以测试说明为准,历史记录不替代当前测试范围。
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。算法契约见链路设计。