Files
STM32F4-Base/IEC60870-Slave

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通知。