IEC 60870-5-104

Zeus 的 IEC104 模块面向电力远动、能源网关和站端数据采集场景。当前内置覆盖主站常用路径：STARTDT 启动、总召唤、单点命令，以及归一化、标度化、短浮点测量值和设点。

安装

dotnet add package Zeus.Communications
dotnet add package Zeus.Protocols.Iec104

IEC104 通常跑在 TCP 通道上。无硬件时可以先挂虚拟站：

var options = new Iec104Options { CommonAddress = 7 };
var memory = new Iec104StationMemory();
memory.SetSinglePoint(1, true);
memory.SetScaled(100, 253);
memory.SetShortFloat(200, 25.3);

await using var app = ZeusHost.Create(builder =>
{
    builder.AddVirtualChannel("iec-link", new Iec104SlaveResponder(options, memory));
    builder.AddIec104("station", "iec-link", options);
});

await app.StartAsync();
var station = app.Devices.Get<Iec104Device>("station");
var values = await station.InterrogateAsync();

换真实网关时，把通道换成 TCP：

builder.AddTcpClient("iec-link", "192.168.1.20", 2404);
builder.AddIec104("station", "iec-link", new Iec104Options { CommonAddress = 7 });

点表采集

builder.AddAcquisition(TimeSpan.FromMilliseconds(1000));
builder.AddIec104(
    "station",
    "iec-link",
    new Iec104Options { CommonAddress = 7 },
    points: map => map
        .SinglePoint("running", 1)
        .Scaled("temperature", 100, scale: 0.1)
        .ShortFloat("pressure", 200));

采集循环会周期执行总召唤，并把匹配到的 IOA 发布到点表。Scaled 配置 scale: 0.1 时，线值 253 会发布为工程值 25.3。

写回

builder.AddIec104(
    "station",
    "iec-link",
    new Iec104Options { CommonAddress = 7 },
    points: map => map
        .SinglePoint("remoteSwitch", 1).Writable("remoteSwitch")
        .Scaled("setpoint", 100, scale: 0.1).Writable("setpoint"));

await app.Points.WriteAsync("remoteSwitch", true);
await app.Points.WriteAsync("setpoint", 18.6);

SinglePoint 使用单点命令。Normalized、Scaled、ShortFloat 分别使用对应设点命令；配置了 scale 的点会在写回前反向换算为线值。

JSON 配置

{
  "channels": [
    { "name": "iec-link", "type": "tcp", "host": "192.168.1.20", "port": 2404 }
  ],
  "devices": [
    {
      "name": "station",
      "channel": "iec-link",
      "type": "iec104",
      "commonAddress": 7,
      "points": [
        { "name": "running", "address": 1, "dataType": "single-point" },
        { "name": "temperature", "address": 100, "dataType": "scaled", "scale": 0.1 },
        { "name": "pressure", "address": 200, "dataType": "short-float" }
      ]
    }
  ]
}

虚拟站配置可写成：

{ "name": "iec-link", "type": "virtual", "responder": "iec104", "commonAddress": 7 }

支持范围

类型	方向	Zeus 类型
M_SP_NA_1 / C_SC_NA_1	采集 / 写回	SinglePoint
M_ME_NA_1 / C_SE_NA_1	采集 / 写回	Normalized
M_ME_NB_1 / C_SE_NB_1	采集 / 写回	Scaled
M_ME_NC_1 / C_SE_NC_1	采集 / 写回	ShortFloat

如果现场需要时标 ASDU、双点命令、文件传输或平衡传输扩展，建议先用通道追踪确认对端实际帧，再扩展 Zeus.Protocols.Iec104。