IEC60870-Slave
IEC 60870 子站协议库,提供IEC104子站、Windows TCP后端、总召、计数量召唤、读命令、校时与读时钟、遥控遥调、系统命令、标准参数与远程参数、Type210文件服务、Type211软件升级、突发上送、Type42故障事件及周期/背景扫描。101/104可复用的ASDU、信息对象、时间工具、故障录波与COMTRADE编码、附录B历史和冻结电能、附录C运行日志及其XML生成、持久软件安装核心、子站应答接口集中在公共目录。
目录结构
按职责归档,同一模块的 .c 和 .h 放在一起:
IEC60870-Slave/
├── 104/ # IEC104 专用协议代码
│ ├── IEC104_Slave.c/h # 子站统一入口
│ ├── business/ # 104业务模块
│ │ ├── IEC104_Interrogation.c/h # 共用召唤引擎
│ │ ├── IEC104_Interrogation_Internal.h # 引擎与种类规则的私有接口
│ │ ├── IEC104_GeneralInterrogation.c/h # 站总召、分组总召规则
│ │ ├── IEC104_CounterInterrogation.c/h # 计数量读取、冻结与复位
│ │ ├── IEC104_ClockSynchronization.c/h # 校时/读时校验、显式回调与回复
│ │ ├── IEC104_Command.c/h # 遥控/遥调、带时标命令、选择执行与返回信息
│ │ ├── IEC104_Read.c/h # 单点读取、同步lookup、FIFO与期限
│ │ ├── IEC104_SystemCommand.c/h # 104/107回显、70初始化结束、105复位授权与事件清除
│ │ ├── IEC104_Startup.c/h # 细则配置、初始化与总召后的缓存补发协调
│ │ ├── IEC104_SoftwareUpgrade.c/h # 211升级会话、ACK观察、ABANDON与重启授权
│ │ ├── IEC104_Parameter.c/h # 110–113参数FIFO、运行值确认及可选ACK两阶段
│ │ ├── IEC104_RemoteParameter.c/h # 200–203读区、切区、预置/固化/撤销
│ │ ├── IEC104_FileService.c/h # 210目录、分段读写与提交
│ │ ├── IEC104_Spontaneous.c/h # 突发上送、CP56时标与NORMAL覆盖统计
│ │ └── IEC104_PeriodicScan.c/h # IDLE周期/背景扫描、点级网格与整表替换
│ ├── IEC104_TcpServer.c/h # TCP 服务与事件调度
│ ├── IEC104_Connection.c/h # 连接协调
│ ├── IEC104_Link*.c/h # 链路、主站/子站启停
│ ├── IEC104_Send*.c/h # 发送管理与缓冲
│ ├── IEC104_AsduQueue.c/h # ASDU 队列
│ ├── IEC104_Receiver.c/h # 流式接收
│ ├── IEC104_Codec.c/h # APCI 编解码
│ ├── IEC104_Net.h / IEC104_Net_Windows.c # 网络接口与 Windows 后端
│ └── IEC104*.c/h # 类型、容量配置、日志及旧接收入口
├── common/ # 101/104 公共代码
│ ├── IEC60870_Types.h # 公共类型及应用层参数
│ ├── IEC60870_Codec.c/h # ASDU 公共头编解码
│ ├── IEC60870_Asdu.c/h # ASDU 容器
│ ├── IEC60870_FaultEvent.c/h # Type42故障事件完整ASDU编解码
│ ├── IEC60870_FaultRecorder.c/h # 调用方采样、前后窗口与冻结记录
│ ├── IEC60870_Comtrade.c/h # COMTRADE 1999 CFG与二进制DAT
│ ├── IEC60870_History.c/h # SOE/遥控循环记录、定点及每日极值
│ ├── IEC60870_HistoryFile.c/h # 附录B文件名与流式XML生成
│ ├── IEC60870_EnergyFreeze.c/h # 冻结电能、潮流反转、封存与持久恢复
│ ├── IEC60870_EnergyFreezeFile.c/h # FRZ/FLOWREV文件名及流式XML
│ ├── IEC60870_UserLog.c/h # 附录C的1024条日志循环、持久化及恢复
│ ├── IEC60870_UserLogFile.c/h # ULOG固定路径与流式XML生成
│ ├── IEC60870_FirmwareUpdate.c/h # 三槽升级、持久安装授权、试运行确认与回退
│ ├── IEC60870_InformationObjects*.c/h # 信息对象
│ ├── IEC60870_Slave.c/h # 公共子站应答接口
│ └── IEC60870_Time.c/h / IEC60870_Clock.c/h # 时间工具与时钟接口
├── examples/ # 应用示例
│ ├── iec104_slave_example.c # 模拟点表、业务分派与程序入口
│ ├── iec104_parameter_multi_master.c # 两主站共享参数生效值
│ ├── iec104_example_history.c/h # Windows双副本持久存储与历史文件快照
│ ├── iec104_example_energy_freeze.c/h # 独立energy.store与目录/下载快照
│ ├── iec104_example_energy_meter.c/h # 整数方波、八值恢复与分段校时
│ ├── iec104_example_user_log.c/h # 独立ulog.store与目录/下载快照
│ ├── iec104_example_upgrade.c/h # Windows升级槽、双bank提交与dtu/dtu-1安装恢复
│ ├── iec104_example_recording.c/h # 模拟录波保存与COMTRADE虚拟目录
│ └── iec104_example_config.c/h # 标准/远程参数及TEMP的统一INI持久化
├── test/ # 测试源码与主机脚本
│ ├── iec104_*_test.c # 104 传输、调度、子站及业务测试
│ ├── iec60870_*_test.c # 公共 ASDU 与信息对象测试
│ └── slave_example_loopback_test.cjs # 真实 TCP 回环测试
├── docs/ # 设计、接口、示例及测试说明
│ ├── README.md # 文档索引与推荐阅读顺序
│ ├── 104/ # 104 设计及接口说明
│ ├── common/ # 公共模块说明
│ ├── examples/ # 示例使用说明
│ └── test/ # 测试说明与验证记录
├── scripts/ # 构建与工程包工具
│ ├── build.ps1 # 构建示例,-Test 运行业务回归、容量矩阵及回环
│ └── make_upgrade_package.cjs # 将已有负载封装为I104基线包或上传包
├── .build/ # 本地构建及验证产物(运行脚本后生成)
└── README.md # 项目总览
构建与测试
按 DTU(100V1A 100V1A) 配置演示时,使用专用 DTU 入口。它保留原文件的 59 个遥信、19 个遥控和 345 项已填参数,接入通用示例的完整业务,并补充 30 个遥测、16 个双点反馈和 8 个电量点等演示地址。PT 为 100V/100V,相 CT 和零序 CT 均为 1A/1A;定值预置、固化、撤销及持久化、文件传输、历史、录波和升级的开启方法见 DTU 配置演示。
倍率、取反、测量换算、保护分合闸及触发录波已接入运行链;本地故障输入、逐项覆盖和仍缺定义的 FA/通信等项目见 DTU 运行模型。
./scripts/build.ps1
./.build/slave-example/iec104_dtu_example.exe --ca 1
# 固定初值,便于逐点核对
./.build/slave-example/iec104_dtu_example.exe --ca 1 --events 0
# 校验源 XML、点表、参数和真实 TCP 交互
./scripts/build.ps1 -Test -Suite Dtu
以下 iec104_slave_example.exe 保留通用协议功能及原有 8 点测试布局;DTU 演示应启动上面的 iec104_dtu_example.exe。
在本目录的 PowerShell 中执行,需要 MinGW GCC。先构建成功,再启动生成的示例:
./scripts/build.ps1
./.build/slave-example/iec104_slave_example.exe --ca 1
默认监听 127.0.0.1:2404;--ca 1 指定公共地址,不能只写 --ca。默认开启参数处理及field模拟输入,以达到门限的COT=3变化上送为主、低频COT=2背景刷新8个遥测,固定周期COT=1按需开启。主站用 Type102、COT=5、CA=1、IOA=0x4001(十进制16385)读取当前处理值,返回 Type11;其初始值2300随默认模拟运行变化,精确核对初值时加--events 0启动。具体默认值、模拟工况及操作步骤见示例说明。
主示例总召遥信使用Type1/3,总召之外的变位、遥控返回和Read遥信使用带CP56的Type30/31。默认全部命令点须选择后执行或撤销,选择保持60秒;没有S/E字段的51/64仅在--command-extensions下启用。集中点表按十六进制分区配置,旧标准参数INI须按迁移说明迁移;通用库仍保留显式无时标/双报及DIRECT能力。各模块职责、快照寿命及兼容边界见默认策略设计。
# 全量测试:需要 GCC 和 Node.js
./scripts/build.ps1 -Test
# 只运行读命令专项的四种容量配置:只需 GCC
./scripts/build.ps1 -Test -Suite Read
# 系统命令四种容量配置;ACK观察与队列清除另在Transport中
./scripts/build.ps1 -Test -Suite SystemCommand
./scripts/build.ps1 -Test -Suite Transport
# 周期/背景扫描专项与容量矩阵
./scripts/build.ps1 -Test -Suite PeriodicScan
# 参数装载、扩展及ACK两阶段四种容量配置
./scripts/build.ps1 -Test -Suite Parameter
./scripts/build.ps1 -Test -Suite RemoteParameter
./scripts/build.ps1 -Test -Suite FileService
./scripts/build.ps1 -Test -Suite SoftwareUpgrade
# 持久安装核心、实际文件中断恢复及TCP升级;需要Node.js
./scripts/build.ps1 -Test -Suite FirmwareUpdate
# Type42公共编解码与故障事件上送容量矩阵
./scripts/build.ps1 -Test -Suite FaultEvent
# 故障录波、COMTRADE编码与宿主保存适配
./scripts/build.ps1 -Test -Suite Recording
# 附录B历史、持久化故障注入、XML及真实TCP恢复
./scripts/build.ps1 -Test -Suite History
# FRZ/FLOWREV、整数计量、持久恢复及TCP文件调阅
./scripts/build.ps1 -Test -Suite EnergyFreeze
# 附录C日志核心、XML、宿主持久化与TCP调阅
./scripts/build.ps1 -Test -Suite UserLog
默认产物分为:
| 路径 | 用途 |
|---|---|
.build/slave-example/iec104_slave_example.exe |
可供主站连接的示例程序 |
.build/slave-example/iec104_dtu_example.exe |
DTU 100V/1A 点表、五区定值及完整业务演示;实现组织 |
.build/slave-example/tests/ |
自动测试可执行程序,由脚本运行 |
test/ |
保留测试源码及真实TCP回环脚本 |
需要独立构建目录时使用 -BuildName read-check,随后运行 .build/read-check/iec104_slave_example.exe。它不会更新默认目录的exe。脚本会打印本次实际产物和启动命令;示例运行中不能覆盖同一路径的exe,应先退出该示例或换BuildName。
-Test覆盖公共ASDU、传输容量矩阵及ACK观察、Slave、示例业务、遥控、读命令、系统命令、参数装载及扩展、突发、Type42故障事件、召唤规则及真实TCP回环。实际执行配置数由脚本输出;完整Suite列表与覆盖范围见测试说明。构建参数和源文件依赖统一维护在build.ps1。
.build/是本地生成目录,已加入忽略规则。旧exe和编译中间文件可以重新生成;历史RESULTS.txt、测量记录及before/快照用于追溯,不能作为当前启动入口。
接入自己的工程
附录C运行日志由IEC60870_UserLog循环保存1024条,IEC60870_UserLogFile生成HISTORY/ULOG/ulog.xml。示例加--user-log existing-directory独立启用并自动开启Type210,不隐含--history;启动、通道状态、实际参数变更及带模式标记的升级阶段按事实记录。04..09硬件来源通过公共Append接入,当前示例不生成假硬件事件。类型、XML字段取舍、持久恢复与移植边界见运行日志设计,操作见日志示例,验证见日志测试。
附录B历史由IEC60870_History维护SOE、遥控、定点和极值,IEC60870_HistoryFile流式生成XML。示例加--history existing-directory启用宿主持久存储并自动开启Type210;保存1024条SOE、30条遥控及32个日槽,导出最新30个完整历史日。库核心使用调用方提供的原子持久提交接口;Windows示例使用独占文件、双副本和系统同步。设计与持久性边界见历史记录设计,启动和调阅见历史示例,专项入口见历史测试。
Type42故障事件使用IEC60870_FaultEvent专用编解码和IEC104_Spontaneous_Publish_Fault_Event发布入口。应用提供故障时刻冻结的遥信、CP56时标和至少八项电气量,104按已确认的接收端布局使用统一3字节地址及无QDS遥测,默认短浮点;发送沿用NORMAL缓存和故障事件第6级。格式依据、与实施细则的地址差异及调用示例见故障事件设计。接入Spontaneous的工程须同时编译common/IEC60870_FaultEvent.c。
连续波形由IEC60870_FaultRecorder接收调用方采样,IEC60870_Comtrade生成1999格式CFG/BINARY DAT。主示例加--recording-demo existing-directory保存一份明确标记的模拟录波,并通过COMTRADE虚拟目录提供下载。模块位置、窗口与迟触发容量、文件布局及生命周期见录波设计;真实采样、及时故障上送、多记录和持久存储见产品接入要求。运行步骤见录波示例,已有验证及未验收范围见录波测试。
电能量支持短浮点Type206/207,复用Type101计数量召唤及Spontaneous的COT=3上送。示例默认206读取当前示值,--counter-type 207读取冻结值和原冻结时刻;15/37整数模式可显式选择。点地址、单位和内存边界见计数量示例,协议范围见计数量设计。
示例加--energy-freeze existing-directory --energy-period-ms 1200000启用独立energy.store、整数方波计量和Type210下的HISTORY/FRZ、HISTORY/FLOWREV,目录必须已存在。该模式采用Type206及QCC=0x05,BEGIN冻结本轮读取快照;QRP1保留计量与持久文件。记录封存、双bank故障边界、八值恢复和临时内存开销见冻结电能设计。
Type211软件升级由独立IEC104_SoftwareUpgrade提供。--file-service --software-upgrade保留RAM演示;--upgrade-store existing-directory启用真实文件存储、dtu/dtu-1安装备份及跨进程恢复,首次需--upgrade-seed提供完整旧程序包。两模式均可用202读回版本/CRC,宿主不执行收到的负载。见持久安装设计与用法、协议设计及验证。
移植软件安装时,公共核心只接收存储及安装回调,Windows后端作为实文件参考实现。协议ACK、持久授权和健康确认分别由不同入口完成;错误处理须区分候选拒绝与提交结果不确定。按升级文档导航阅读布局、接口、恢复和调用时序;首次操作从持久模式示例开始。目标Flash、Bootloader跳转和真实应用健康条件的接入范围见板端边界。
Type200–203 远程参数由独立 IEC104_RemoteParameter 模块提供;通用示例默认关闭,加 --remote-parameter 开启,DTU 示例默认开启。支持切区、读区、TLV 分帧读取和预置/固化/撤销,存储与权限由应用实现。见远程参数设计、通用示例点表、DTU 定值与恢复及专项验证。
Type210 文件服务由独立 IEC104_FileService 提供;示例加 --file-service 开启,默认关闭。支持目录快照、IDLE读文件、连续写段的BUSY背压和COMMIT原子发布;普通TEMP文件可随--config保存到宿主文件,读取目录仍使用示例虚拟目录。见文件服务设计、示例用法及专项验证。
Type110–113标准参数默认开启,--no-parameter可关闭。通用示例提供32项,DTU示例提供120项,用于遥测门限、平滑和量程品质处理,并支持总召读回;点表、QPA3周期控制及操作步骤见参数应用和DTU参数。协议模块只负责通信,可选扩展及接入见参数设计和调用流程。
主示例可加--config .build/slave-example/parameters.ini,用一份INI保存和恢复标准参数、远程参数及TEMP文件,备份恢复只需该文件;不指定则只保存在内存。格式、旧文件迁移、加载校验和保存失败规则见持久化说明。存储属于示例应用,不加入协议库。
周期扫描使用独立IDLE直发通道,保留HIGH/NORMAL调度。背景扫描默认开启;需要固定周期快照时可加--cyclic-ms 1000,背景周期由--background-ms单独调整,--sequence显式开启连续IOA编码。周期是名义网格,持续应答或突发可能使扫描延迟;点级周期、在线停用和整表替换见扫描设计。
将 104/ 和 common/ 加入头文件搜索路径,使用业务模块时再加入 104/business/;按所用模块选择源文件,Windows网络后端链接 Ws2_32。统一入口为 IEC104_Slave.h,模块职责与依赖见模块索引,执行顺序见完整调用流程。
按本目录细则接入启动补发时,使用 IEC104_Startup_Config_Default 统一设置传输、初始化、总召、计数量召唤和突发配置,再由 IEC104_Startup 协调本轮 Type70 与各站总召完成;主示例使用同一入口。配置函数不创建业务模块,也不替应用注册站点、登记COI或驱动严格业务循环,完整接线见统一配置与启动流程。五个分散的旧配置入口已移除,主示例和参数多主站示例均接入本轮初始化及总召协调;接口迁移见迁移说明。
接收N(S)兼容和收到主站TESTFR后的终端主动探测抑制已统一在链路层实现,无需额外配置。两项修复的条款对应、行为变化、底层接口迁移及验证入口见链路细则修复汇总。
业务模块的职责、状态和接口见设计索引,跨模块的事件分派与发送边界见业务层总览。
示例使用模拟点表和时钟;105 QRP1在确认按时被ACK后重建协议实例,不重启宿主进程。报文及操作边界见系统命令联调。真实采集、设备输出及主站互操作仍由应用接入,完整资料见文档索引。
接入系统命令时,先按最小调用示例创建模块并登记COI,再分派通知、推进回复及显式调用应用动作。调度与诊断字段见状态和计数;模拟复位前须按收尾步骤分别读空业务终结通知和Slave通知。