Omron Host Link

Zeus 的 Host Link 模块面向 Omron PLC 的 ASCII Host Link 通信，支持 @UU 站号帧、FCS 校验、CIO/LR/HR/AR/DM 常用字区读写、点表采集、按点名写回和虚拟 PLC 联调。

没硬件时先跑虚拟 PLC

var memory = new HostLinkSlaveMemory();
memory.DataMemoryWords[100] = 253;
memory.CioWords[10] = 0x0001;

await using var app = ZeusHost.Create(builder =>
{
    builder.AddAcquisition(TimeSpan.FromMilliseconds(100));
    builder.AddVirtualChannel("host-link", new HostLinkSlaveResponder(unitNumber: 0, memory));
    builder.AddOmronHostLink("plc", "host-link", new HostLinkOptions
    {
        UnitNumber = 0
    }, points: map => map
        .DmWord("temperature", address: 100, scale: 0.1).Writable("temperature")
        .CioBit("running", address: 10, bitOffset: 0).Writable("running"));
});

await app.StartAsync();
var temperature = app.Points.Get<double>("temperature");
await app.Points.WriteAsync("temperature", 18.6);

这段代码里：

代码	含义
HostLinkSlaveMemory	虚拟 PLC 的 CIO/LR/HR/AR/DM 内存映像
HostLinkSlaveResponder(0, memory)	模拟 00 号 Host Link PLC
UnitNumber = 0	Host Link 帧里的两位十进制单元号
.DmWord(..., 0.1)	D100 原始字乘以 0.1 后进入点表；写回时反算

可运行示例：samples/Zeus.Samples.Console.HostLink。

连接真实 PLC

串口 Host Link 常见参数由 PLC 工程决定，示例：

await using var app = ZeusHost.Create(builder =>
{
    builder.AddSerialPort("host-link", "COM3", 9600);
    builder.AddOmronHostLink("plc", "host-link", new HostLinkOptions
    {
        UnitNumber = 0
    });
});

如果现场通过以太网串口服务器或 PLC 网关做 TCP 透传，通道可以换成 TCP：

builder.AddTcpClient("host-link", "192.168.250.1", 9600);
builder.AddOmronHostLink("plc", "host-link", new HostLinkOptions { UnitNumber = 0 });

读写 API

var plc = app.Devices.Get<HostLinkDevice>("plc");

var dm = await plc.ReadDataMemoryWordsAsync(100, 2);
await plc.WriteDataMemoryWordsAsync(110, [10, 20, 30]);

var cio = await plc.ReadCioWordsAsync(10, 1);
await plc.WriteCioWordsAsync(10, [0x0001]);

也可以直接发任意 Host Link 命令：

string data = await plc.ExecuteAsync("RD", "01000002");

支持的内存区

区域	读命令	写命令	点表便捷方法
CIO / IR	RR	WR	.CioWord(...) / .CioBit(...)
LR	RL	WL	.LinkWord(...) / .LinkBit(...)
HR	RH	WH	.HoldingWord(...) / .HoldingBit(...)
AR	RJ	WJ	.AuxiliaryWord(...) / .AuxiliaryBit(...)
DM	RD	WD	.DmWord(...) / .DmBit(...)

Host Link 位点通过读写所在字实现，写回时会先读取当前字，再只修改目标 bit。

点表采集

builder.AddOmronHostLink("plc", "host-link", new HostLinkOptions
{
    UnitNumber = 0,
    WordOrder = HostLinkWordOrder.HighWordFirst
}, points: map => map
    .DmWord("temperature", 100, 0.1).Writable("temperature")
    .Int16("pressure", HostLinkArea.DataMemory, 120)
    .Real("flow", HostLinkArea.DataMemory, 130)
    .CioBit("running", 10, 0).Writable("running"));

Host Link 原始字是 16 位。UInt32、Int32 和 Real 占两个连续字，字序由 HostLinkOptions.WordOrder 控制，默认高字在前。

JSON 配置

{
  "channels": [
    { "name": "host-link", "type": "serial", "portName": "COM3", "baudRate": 9600 }
  ],
  "devices": [
    {
      "name": "plc",
      "channel": "host-link",
      "type": "omron-host-link",
      "unitId": 0,
      "points": [
        { "name": "temperature", "area": "dm", "address": 100, "dataType": "word", "scale": 0.1, "writable": true },
        { "name": "running", "area": "cio", "address": 10, "bit": 0, "dataType": "bit", "writable": true }
      ]
    }
  ]
}

虚拟 Host Link PLC：

{ "name": "host-link", "type": "virtual", "responder": "host-link", "unitId": 0 }

可直接复制的真实串口配置样例位于 samples/Zeus.Samples.Console.Config/zeus-host-link.json。

常见问题

现象	最可能原因	处理
一直超时	单元号、串口参数或 TCP 透传端口不对	先用 HostLinkSlaveResponder 跑通，再查 PLC 通信设置
FCS 校验失败	波特率/校验位错误，或接入的不是 Host Link ASCII	核对串口参数和对端协议模式
读到结束码	内存区、地址或数量不被 PLC 支持	看异常里的 Host Link 结束码，核对 CPU 手册
32 位值高低字反了	字序和 PLC 工程约定不一致	改 HostLinkOptions.WordOrder
写回没执行	点没有 .Writable(...) 或 JSON 没设 writable: true	标记点为可写

下一步：周期读取数据看 点表与采集。