西门子 - 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 = await SiemensOperate.InstanceAsync(new SiemensData.Basics
{
    IpAddress = "192.168.1.100",
    Port = 102,
    ProtocolType = ProtocolType.SiemensS7Net_S1200,
    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 127.0.0.1 PLC IP 地址
Port int 6688 S7 通信端口
ConnectTimeOut int 1000 连接超时（毫秒）
ReceiveTimeOut int 1000 接收超时（毫秒）
Rack int 0 PLC 机架号（仅 S7/S7Plus）
Slot int 0 PLC 槽位号（仅 S7/S7Plus）
PDULength int -1 PDU 大小（字节，-1 为自动）
LocalTSAP int 19799 本地 TSAP 值
ProtocolType enum SiemensPPIOverTcp 协议类型 — 默认 PPI 无法通过以太网连接 S7-300/1200，且忽略 Rack/Slot/PDULength；请使用 SiemensS7Net_S300 / SiemensS7Net_S1200 / SiemensS7Net_S1500 等
SleepTime int 0 帧间休眠（毫秒）
SocketKeepAliveTime int -1 TCP 保活（毫秒，-1 禁用）
IsPersistentConnection bool true 复用 TCP 连接
SerialPortInfo string COM3-9600-8-N-1 串口设置（PPI）
Station int 1 站号（PPI）

支持的协议类型

类型 描述
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 优化块访问

地址格式

S7 按字节寻址,可带字内位。区域字母不区分大小写。

区域 地址格式 示例
数据块 (DB) DB{n}.DBX{字节}.{位} / DBB / DBW / DBD DB1.DBX0.3, DB1.DBW4, DB1.DBD2
输入 (I) I{字节}[.{位}] I0.0, I0.7, I12
输出 (Q) Q{字节}[.{位}] Q0.0, Q4.1
位存储区 (M) M{字节}[.{位}] M100.0, M100
定时器 / 计数器 T{n} / C{n} T0, C0
注意

DB 号属于区域键(DB1 与 DB2 独立组批);位号可选,解析器不做 0-7 范围校验。T/C/AI/AQ 按字编址（字节偏移 = 编号 × 2）。MaxReadLength = 240(PhysicalMaxBytes 960)。

支持的数据类型

所有读取按 AddressDetails.DataType 分发 — 别名(Short = Int16、Float = Single、Int = Int32 等)共用同一分支。

数据类型 支持 说明
Bool ✅ 位读取 — 线圈 / 字内位
Int16 / Short, UInt16 / Ushort ✅ 16 位整数
Int32 / Int, UInt32 / Uint ✅ 32 位整数
Int64 / Long, UInt64 / Ulong ✅ 64 位整数
Float / Single, Double ✅ 32 / 64 位浮点
String / Char ✅ 带 length + 编码读取 — WString（UTF-16 大端）用 EncodingType.BigEndianUnicode（26.235 起修复：大端编码在 GetEncoding 中不再抛异常）
ByteArray + 全部 10 种 *Array ✅ 带 length 的数组读取
Byte ⚠️ 部分 除 SiemensPPI 外支持
注意

None、Date、DateTime、Time 在 ReadAsync 中没有分支 — 不支持。

地址自动组包与解包

每个数采驱动都实现 IPacker，因此 SiemensOperate 可直接将分散地址合并为最小批量读取，并直接解包结果——无需装配处理器（见 IPacker 接口）：

// 组包：将分散地址合并为最少的批量读取
var packed = await op.PackerAsync(address, "SiemensS7Net_S1200");
if (!packed.Status) return;                                  // 组包失败
var packedAddr = packed.GetSource<Address>();

// 一次往返读取组包后的批次
var result = await op.ReadAsync(packedAddr);
if (!result.Status) return;                                  // 读取失败
var data = result.GetSource<ConcurrentDictionary<string, AddressValue>>();

// 解包：将每个批次的原始字节解析回各地址的值
var unpacked = await op.UnPackerAsync(data);
if (!unpacked.Status) return;                                // 解包失败
var values = unpacked.GetSource<List<ConcurrentDictionary<string, AddressValue>>>();
foreach (var dict in values)
    foreach (var v in dict)
        Console.WriteLine($"{v.Key} = {v.Value.ResultValue}");

S7 系列单次读取最多组包 240 字节（物理上限 960）。SiemensS7Plus（符号/优化块访问）不支持组包——Packer 原样返回地址集合。引擎细节：地址自动组包。

M/I/Q/T/C/V/SM/AI/AQ/P/DB 之外的区域不可组包（驱动抛 NotSupportedDataType）。

订阅

先绑定数据事件，再通过 SubscribeAsync 添加地址；数据通过 OnDataEventAsync 到达：

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);

支持的操作

操作 方法
连接 OnAsync()
断开 OffAsync()
读取 ReadAsync(address)
写入 WriteAsync(values)
订阅 SubscribeAsync(address)
组包 / 解包 PackerAsync(address, protocolTypeKey) / UnPackerAsync(data)

参见