西门子 - Snet Docs
文档/协议/siemens

Siemens 协议驱动

包: Snet.Siemens | 类: SiemensOperate | 类型: 10

提供通过 S7（S7-200/300/400/1200/1500）、PPI（S7-200）、S7Plus（S7-1200/1500 优化块访问）和 FetchWrite 协议连接西门子 PLC 的能力。

安装

dotnet add package Snet.Siemens

快速开始

using Snet.Siemens;

var op = new SiemensOperate(new SiemensData.Basics
{
    IpAddress = "192.168.1.100",
    Port = 102,
    Rack = 0,
    Slot = 1,
    PDULength = -1
});

var address = new Address(new List<AddressDetails>
{
    new("读数", "DB1.DBD0", DataType.Float),
    new("读数2", "DB1.DBD4", DataType.Float)
});
var result = await op.ReadAsync(address);
if (result.Status)
{
    var data = result.GetSource<ConcurrentDictionary<string, AddressValue>>();
    foreach (var kv in data)
        Console.WriteLine($"{kv.Key} = {kv.Value.ResultValue}");
}
else
{
    Console.WriteLine($"读取失败: {result.Message}");
}

// 订阅之前 绑定数据事件
op.OnDataEventAsync += async (sender, e) =>
{
    if (e.Status)
    {
        var data = e.GetSource<ConcurrentDictionary<string, AddressValue>>();
        foreach (var kv in data)
            Console.WriteLine($"{kv.Key} = {kv.Value.ResultValue}");
    }
    else
    {
        Console.WriteLine($"{e.Message}");
    }
};

var subAddr = new Address(new List<AddressDetails>
{
    new("读数", "DB1.DBD0", DataType.Float)
});
await op.SubscribeAsync(subAddr);

// 后续：取消订阅
// await op.UnSubscribeAsync(subAddr);

await op.DisposeAsync();

配置

参数 类型 默认值 描述
IpAddress string — PLC IP 地址
Port int 102 S7 通信端口
ConnectTimeOut int 1000 连接超时（毫秒）
ReceiveTimeOut int 1000 接收超时（毫秒）
Rack int 0 PLC 机架号
Slot int 1 PLC 槽位号
PDULength int -1 PDU 大小（字节，-1 为自动）
LocalTSAP int 19799 本地 TSAP 值

支持的协议类型

类型 描述
SiemensS7Net_S200 S7-200 以太网（ISO-on-TCP）
SiemensS7Net_S200Smart S7-200 Smart 以太网
SiemensS7Net_S300 S7-300 以太网（ISO-on-TCP）
SiemensS7Net_S400 S7-400 以太网（ISO-on-TCP）
SiemensS7Net_S1200 S7-1200 以太网（ISO-on-TCP）
SiemensS7Net_S1500 S7-1500 以太网（ISO-on-TCP）
SiemensFetchWriteNet Fetch/Write 被动协议
SiemensPPI 点对点接口（S7-200 串行，RS-232）
SiemensPPIOverTcp 通过 TCP 桥接的 PPI
SiemensS7Plus S7-1200/1500 优化块访问

地址格式

  • 数据块: DB1.DBD0, DB1.DBW2, DB1.DBX4.0
  • 输入: I0.0, IB1, IW2
  • 输出: Q0.0, QB1, QW2
  • 标志: M0.0, MB1, MW2
  • 定时器/计数器: T0, C0

支持的操作

操作 方法
连接 OnAsync()
断开 OffAsync()
读取 ReadAsync(address)
写入 WriteAsync(values)
订阅 SubscribeAsync(address)

参见