1. 项目缘起为什么我们需要自己动手读写PLC数据在工业自动化领域西门子S7系列PLC可编程逻辑控制器几乎是绕不开的存在。无论是工厂里的生产线、楼宇里的暖通空调系统还是复杂的物流分拣线背后都有它的身影。作为一名软件开发者特别是从事工业上位机软件、MES制造执行系统或SCADA数据采集与监视控制系统开发的同行经常会遇到一个核心需求如何让我们的C#程序与现场的西门子PLC“对话”实时读取设备状态、工艺参数或者下发控制指令你可能听说过OPC UA这是一种标准的工业通信协议功能强大且跨平台。但在很多实际场景中尤其是面对存量设备改造、成本敏感或对实时性有特殊要求的项目时直接通过以太网/TCP协议与S7 PLC通信往往是最直接、最灵活、也最经济的方案。它绕过了OPC服务器这个中间层减少了潜在的故障点也让程序对数据的掌控力更强。然而当你打开搜索引擎输入“C# 读写西门子PLC”时扑面而来的可能是各种商业库的广告或者是零散、过时甚至无法运行的代码片段。官方提供的S7.Net库虽然经典但文档有限遇到复杂数据类型或网络异常时调试起来颇为头疼。更不用说很多项目对通信的稳定性、重连机制、错误处理有严苛的要求这些在现成的库中往往需要二次开发。因此我决定结合自己多年的项目实战经验从头梳理一遍使用C#通过S7协议与西门子PLC通信的完整流程。这不是一个简单的API调用教程而是一次从协议原理、连接建立、数据读写到异常处理、性能优化的深度实践。我会提供一套经过生产环境验证的、可复用的源码框架并重点讲解那些官方文档里不会写、但实际开发中一定会踩到的“坑”。2. 协议基石理解西门子S7通信的核心机制在动手写代码之前我们必须先理解S7协议特别是S7-1200/1500及S7-300/400常用的S7comm或S7comm-plus的基本工作方式。这能帮助我们在遇到通信故障时快速定位问题是出在网络层、协议层还是数据层而不是盲目地重启程序或PLC。2.1 S7协议的本质基于TCP的“问答”模型S7协议运行在TCP/IP协议栈之上通常使用102端口这是S7comm的默认端口S7-1200/1500也可能使用其他端口但102最常见。其通信模型非常简洁客户端我们的C#程序发起请求RequestPLC作为服务器返回响应Response。每一次有效的数据交换都遵循这个“一问一答”的模式。这个请求/响应数据包被称为PDU。一个PDU内部又包含了协议头、参数区和数据区。我们最需要关心的是参数区因为它指明了我们想要做什么操作读、写、启动、停止以及操作哪个数据。2.2 关键概念PLC的存储区与地址要读写数据首先得知道数据在哪里。西门子PLC的数据存储在几个不同的区域每个区域有对应的缩写I (Inputs): 输入映像区。物理输入模块如按钮、传感器的状态会周期性地扫描并更新到这个区域。注意在程序中读取I区是读取PLC内部更新后的映像值而非直接读取物理端子。Q (Outputs): 输出映像区。程序运算的结果写入此区域PLC会周期性地将此处值输出到物理输出模块如继电器、指示灯。M (Memory): 标志位存储区或中间变量区。这是用户程序内部使用的全局变量区没有对应的物理输入输出点非常灵活。DB (Data Block): 数据块。这是最重要的数据存储区用于存储结构化数据如配方、生产计数、设备参数等。一个DB块相当于一个结构体或类的实例里面可以定义各种类型的变量Bool, Int, Real, String, Array等。地址的表示方法是另一个核心。S7协议使用一种特定的“点分”格式来定位一个变量。例如DB10.DBX0.0: 表示数据块10DB10中字节0Byte 0的第0位Bit 0。这是一个布尔量Bool。DB10.DBB2: 表示数据块10中字节2Byte 2。这是一个8位无符号整数Byte。DB10.DBW4: 表示数据块10中起始于字节4的一个字Word2个字节。这是一个16位整数Int。DB10.DBD6: 表示数据块10中起始于字节6的一个双字Double Word4个字节。这可以是一个32位整数DInt或一个浮点数Real。理解这个寻址规则是正确构造读写请求参数的基础。很多通信失败根源就在于地址字符串写错了。2.3 连接建立ISO-on-TCP与COTPS7协议在建立正式通信前有一个“握手”过程。它基于ISO-on-TCPRFC 1006和COTP面向连接的传输协议。简单来说我们的程序需要先与PLC建立TCP连接然后发送COTP连接请求协商通信参数最后才能进行S7协议的PDU交换。幸运的是像S7.Net这样的开源库已经帮我们封装好了这个过程。但了解这一点很重要当你调用Connect()方法时底层实际上完成了上述多个步骤。如果连接失败我们需要能区分是网络不通TCP连接失败、PLC未在监听COTP拒绝还是S7参数不匹配PDU协商失败。3. 实战准备搭建开发环境与项目结构理论清楚了我们开始动手。首先我们需要一个清晰、可维护的项目结构。我不推荐把所有代码都堆在一个Main函数里而是采用分层设计便于后续扩展和维护。3.1 开发环境与依赖库IDE: Visual Studio 2022 或更高版本。.NET版本: 建议使用.NET 6或.NET 8LTS版本它们对异步操作和网络通信的支持更好性能也更优。核心库: 我们将使用S7.Net。这是一个非常成熟且活跃的开源库支持S7-200, 300, 400, 1200, 1500等系列。你可以通过NuGet包管理器直接安装。打开Visual Studio创建一个新的“控制台应用”或“类库”项目。然后在“工具”-“NuGet包管理器”-“管理解决方案的NuGet程序包”中搜索并安装S7.Net。3.2 设计通信管理层我们创建一个名为S7PlcClient的类它将封装与PLC通信的所有细节。这个类应该实现IDisposable接口以确保网络连接等资源能被正确释放。using S7.Net; using S7.Net.Types; using System.Net.Sockets; namespace MyIndustrialApp.PlcCommunication { /// summary /// 西门子S7 PLC通信客户端 /// /summary public class S7PlcClient : IDisposable { private Plc? _plc; private readonly object _connectionLock new object(); private readonly ILoggerS7PlcClient? _logger; /// summary /// PLC连接配置 /// /summary public class PlcConfig { public CpuType CpuType { get; set; } CpuType.S71200; public string IpAddress { get; set; } 192.168.0.1; public short Rack { get; set; } 0; public short Slot { get; set; } 1; public int Port { get; set; } 102; public int TimeoutMs { get; set; } 5000; } public bool IsConnected _plc?.IsConnected ?? false; /// summary /// 构造函数可注入日志 /// /summary /// param nameconfigPLC配置/param /// param namelogger日志记录器可选/param public S7PlcClient(PlcConfig config, ILoggerS7PlcClient? logger null) { _plc new Plc(config.CpuType, config.IpAddress, config.Rack, config.Slot, config.Port); _plc.ReadTimeout config.TimeoutMs; _plc.WriteTimeout config.TimeoutMs; _logger logger; } /// summary /// 建立连接 /// /summary public async Taskbool ConnectAsync(CancellationToken cancellationToken default) { if (_plc null) throw new ObjectDisposedException(nameof(S7PlcClient)); if (IsConnected) return true; lock (_connectionLock) { if (IsConnected) return true; // 双重检查 try { // S7.Net 的 OpenAsync 内部实际是同步调用我们包装一下 await Task.Run(() _plc.Open(), cancellationToken).ConfigureAwait(false); _logger?.LogInformation(成功连接到PLC {Ip}:{Port}, _plc.IP, _plc.Port); return true; } catch (SocketException ex) { _logger?.LogError(ex, 网络连接失败请检查PLC IP地址和端口。IP: {Ip}, Port: {Port}, _plc.IP, _plc.Port); throw new PlcCommunicationException($网络连接失败: {ex.Message}, ex); } catch (Exception ex) { _logger?.LogError(ex, PLC连接失败。); throw new PlcCommunicationException($PLC连接失败: {ex.Message}, ex); } } } // 其他读写方法将在后续章节实现... public void Dispose() { _plc?.Close(); _plc?.Dispose(); _plc null; GC.SuppressFinalize(this); } } /// summary /// 自定义PLC通信异常 /// /summary public class PlcCommunicationException : Exception { public PlcCommunicationException(string message) : base(message) { } public PlcCommunicationException(string message, Exception innerException) : base(message, innerException) { } } }注意这里我引入了ILogger接口和自定义异常PlcCommunicationException。在生产环境中完善的日志和清晰的异常类型是快速排错的关键。S7.Net本身的异常信息有时比较笼统包装一下能提供更多上下文。4. 核心读写操作从简单变量到复杂结构连接建立后最核心的部分就是读写数据。S7.Net提供了Read和Write方法但直接使用它们处理复杂数据或批量操作时代码会变得冗长且易错。我们需要进行封装。4.1 基础数据类型的读写封装我们先封装最常用的单点读写。注意PLC中数据的存储顺序字节序可能与PC不同。西门子PLC通常采用大端序而x86/x64架构的PC采用小端序。S7.Net库已经帮我们处理了大部分转换但对于自定义结构我们仍需留意。public class S7PlcClient { // ... 接上文构造函数和连接方法 ... /// summary /// 读取单个布尔值 /// /summary public async Taskbool ReadBoolAsync(string address, CancellationToken cancellationToken default) { await EnsureConnectedAsync(cancellationToken).ConfigureAwait(false); try { var value await Task.Run(() _plc!.Read(address), cancellationToken).ConfigureAwait(false); return Convert.ToBoolean(value); } catch (Exception ex) when (ex is not OperationCanceledException) { _logger?.LogError(ex, 读取布尔值失败。地址: {Address}, address); throw new PlcCommunicationException($读取地址 {address} 失败, ex); } } /// summary /// 读取一个16位整数Int /// /summary public async Taskshort ReadIntAsync(string address, CancellationToken cancellationToken default) { await EnsureConnectedAsync(cancellationToken).ConfigureAwait(false); try { var bytes await Task.Run(() _plc!.ReadBytes(DataType.DataBlock, ParseDbNumber(address), ParseDbByteOffset(address), 2), cancellationToken).ConfigureAwait(false); return S7.Net.Types.Int.FromByteArray(bytes); } catch (Exception ex) when (ex is not OperationCanceledException) { _logger?.LogError(ex, 读取Int失败。地址: {Address}, address); throw new PlcCommunicationException($读取Int地址 {address} 失败, ex); } } /// summary /// 读取一个32位浮点数Real /// /summary public async Taskfloat ReadRealAsync(string address, CancellationToken cancellationToken default) { await EnsureConnectedAsync(cancellationToken).ConfigureAwait(false); try { var bytes await Task.Run(() _plc!.ReadBytes(DataType.DataBlock, ParseDbNumber(address), ParseDbByteOffset(address), 4), cancellationToken).ConfigureAwait(false); return S7.Net.Types.Real.FromByteArray(bytes); } catch (Exception ex) when (ex is not OperationCanceledException) { _logger?.LogError(ex, 读取Real失败。地址: {Address}, address); throw new PlcCommunicationException($读取Real地址 {address} 失败, ex); } } /// summary /// 写入单个布尔值 /// /summary public async Task WriteBoolAsync(string address, bool value, CancellationToken cancellationToken default) { await EnsureConnectedAsync(cancellationToken).ConfigureAwait(false); try { await Task.Run(() _plc!.Write(address, value), cancellationToken).ConfigureAwait(false); } catch (Exception ex) when (ex is not OperationCanceledException) { _logger?.LogError(ex, 写入布尔值失败。地址: {Address}, 值: {Value}, address, value); throw new PlcCommunicationException($写入地址 {address} 失败, ex); } } // 类似的可以封装 WriteIntAsync, WriteRealAsync 等方法... /// summary /// 确保已连接未连接则尝试连接 /// /summary private async Task EnsureConnectedAsync(CancellationToken cancellationToken) { if (!IsConnected) { await ConnectAsync(cancellationToken).ConfigureAwait(false); } } // 简单的地址解析辅助方法仅示例实际需要更健壮的解析 private static int ParseDbNumber(string address) { // 例如从 DB10.DBD20 中提取 10 var dbPart address.Split(.)[0]; return int.Parse(dbPart.Substring(2)); // 去掉DB } private static int ParseDbByteOffset(string address) { // 例如从 DB10.DBD20 中提取 20 var dataPart address.Split(.)[1]; var type dataPart.Substring(2, 1); // 取 B, W, D 等 var offset int.Parse(dataPart.Substring(3)); // 根据类型计算字节偏移这里简化处理实际需考虑 DBX0.0 等情况 return offset; } }4.2 批量读取提升效率的关键在工业场景中我们经常需要一次性读取几十甚至上百个变量。如果每个变量都发起一次独立的请求效率极低网络延迟会被放大。S7协议支持在一个PDU内读取多个、可能不连续的数据区域这称为“多重读取”。S7.Net通过ReadMultipleVars方法支持此功能。public class S7PlcClient { // ... 接上文 ... /// summary /// 批量读取多个变量 /// /summary /// param namevarList变量地址列表/param /// returns与输入顺序对应的结果列表/returns public async TaskListobject? ReadMultipleVarsAsync(Liststring varList, CancellationToken cancellationToken default) { if (varList null || varList.Count 0) return new Listobject?(); await EnsureConnectedAsync(cancellationToken).ConfigureAwait(false); try { var results await Task.Run(() _plc!.ReadMultipleVars(varList.ToArray()), cancellationToken).ConfigureAwait(false); // results 本身是一个数组直接转换为List return results.ToList(); } catch (Exception ex) when (ex is not OperationCanceledException) { _logger?.LogError(ex, 批量读取失败。变量数量: {Count}, varList.Count); throw new PlcCommunicationException(批量读取操作失败, ex); } } }实操心得批量读取是优化性能的首选。但在构造varList时尽量将地址相近的变量放在一起。虽然协议支持不连续的地址但过于分散的地址可能会被PLC拆分成多个PDU响应反而降低效率。一个经验法则是将同一个DB块内的变量集中读取。4.3 处理复杂数据类型字符串与自定义结构体PLC中的字符串String和自定义结构体UDT是读写中的难点。字符串西门子PLC中的字符串通常有固定长度并在前两个字节存储最大长度和当前长度。例如String[254]在DB中实际占用256个字节2字节头部254字符。S7.Net提供了S7.Net.Types.String辅助类来处理。public async Taskstring ReadStringAsync(string address, int maxLength 254, CancellationToken cancellationToken default) { await EnsureConnectedAsync(cancellationToken).ConfigureAwait(false); try { // 读取字符串所需的总字节数2字节头部 最大字符数 int totalBytes 2 maxLength; var bytes await Task.Run(() _plc!.ReadBytes(DataType.DataBlock, ParseDbNumber(address), ParseDbByteOffset(address), totalBytes), cancellationToken).ConfigureAwait(false); return S7.Net.Types.String.FromByteArray(bytes); } catch (Exception ex) { _logger?.LogError(ex, 读取字符串失败。地址: {Address}, address); throw; } }自定义结构体这是最灵活也最复杂的情况。假设PLC中定义了一个UDT用户自定义数据类型Recipe包含IdInt、NameString[20]、TemperatureReal。在C#中我们需要定义一个内存布局完全匹配的类或结构体并使用Class辅助类进行转换。首先在C#中定义对应的类并使用S7.Net的特性public class PlcRecipe { [S7NetCallable(Offset 0)] public short Id { get; set; } // DB中占2字节 [S7NetCallable(Offset 2, StringLength 20)] public string Name { get; set; } string.Empty; // 占22字节 (220) [S7NetCallable(Offset 24)] // 偏移量 2 22 public float Temperature { get; set; } // 占4字节 }然后在S7PlcClient中增加读写方法public async TaskPlcRecipe ReadStructAsyncPlcRecipe(string dbAddress, int startByte) where T : class, new() { await EnsureConnectedAsync().ConfigureAwait(false); try { // 计算结构体总大小 int structSize S7.Net.Types.Class.GetClassSize(typeof(T)); var bytes await Task.Run(() _plc!.ReadBytes(DataType.DataBlock, ParseDbNumber(dbAddress), startByte, structSize)).ConfigureAwait(false); return S7.Net.Types.Class.FromBytesT(bytes); } catch (Exception ex) { _logger?.LogError(ex, 读取结构体失败。DB地址: {DbAddress}, 起始字节: {StartByte}, dbAddress, startByte); throw; } } public async Task WriteStructAsyncPlcRecipe(string dbAddress, int startByte, T data) where T : class { await EnsureConnectedAsync().ConfigureAwait(false); try { var bytes S7.Net.Types.Class.ToBytes(data); await Task.Run(() _plc!.WriteBytes(DataType.DataBlock, ParseDbNumber(dbAddress), startByte, bytes)).ConfigureAwait(false); } catch (Exception ex) { _logger?.LogError(ex, 写入结构体失败。DB地址: {DbAddress}, 起始字节: {StartByte}, dbAddress, startByte); throw; } }踩坑提醒结构体读写最大的坑在于字节对齐和填充。西门子PLC的某些数据类型如LReal-Double可能需要从偶数字节开始。如果C#结构体的字段偏移量与PLC中UDT的布局不完全一致会导致数据错乱。务必使用TIA Portal博途中的“块比较”或“监控表”功能仔细核对每个字段在DB中的确切偏移量。[S7NetCallable(Offset x)]中的x必须精确无误。5. 通信稳定性保障心跳、重连与异常处理工业现场网络环境复杂PLC可能重启网线可能松动。一个健壮的通信程序必须能应对这些异常。5.1 实现心跳检测与自动重连心跳机制用于周期性检查连接是否存活。我们可以在后台启动一个定时任务。public class S7PlcClient { private readonly PlcConfig _config; private Timer? _heartbeatTimer; private volatile bool _isReconnecting false; public S7PlcClient(PlcConfig config, ILoggerS7PlcClient? logger null) { _config config; // ... 其他初始化 ... } public async Task StartHeartbeatAsync(int intervalSeconds 30) { if (_heartbeatTimer ! null) return; _heartbeatTimer new Timer(async _ { if (_isReconnecting) return; // 防止重连堆积 if (!IsConnected) { _logger?.LogWarning(心跳检测到连接断开尝试重连...); await TryReconnectAsync(); } else { // 简单的连接保持读取一个固定的、无害的地址如某个M位 try { // 使用一个很短的超时时间避免心跳阻塞 using var cts new CancellationTokenSource(TimeSpan.FromSeconds(2)); await ReadBoolAsync(MB0, cts.Token).ConfigureAwait(false); } catch (Exception ex) { _logger?.LogDebug(ex, 心跳读取失败连接可能已异常。); _plc?.Close(); // 主动关闭旧连接 await TryReconnectAsync(); } } }, null, TimeSpan.FromSeconds(intervalSeconds), TimeSpan.FromSeconds(intervalSeconds)); } private async Task TryReconnectAsync() { if (_isReconnecting) return; _isReconnecting true; try { // 延迟一段时间再重试避免频繁冲击 await Task.Delay(TimeSpan.FromSeconds(5)).ConfigureAwait(false); await ConnectAsync().ConfigureAwait(false); _logger?.LogInformation(自动重连成功。); } catch (Exception ex) { _logger?.LogError(ex, 自动重连失败将在下次心跳时重试。); } finally { _isReconnecting false; } } public void Dispose() { _heartbeatTimer?.Dispose(); _plc?.Close(); _plc?.Dispose(); _plc null; GC.SuppressFinalize(this); } }5.2 精细化异常处理与状态管理不是所有异常都需要触发重连。我们需要区分不同类型的错误。public async TaskT ExecuteWithRetryAsyncT(FuncTaskT operation, int maxRetries 2, CancellationToken cancellationToken default) { int retryCount 0; while (true) { try { return await operation().ConfigureAwait(false); } catch (PlcCommunicationException ex) when (ex.InnerException is SocketException) { // 网络层异常很可能是连接断了 _logger?.LogWarning(ex, 网络通信异常尝试重连后重试。重试次数: {RetryCount}, retryCount); if (retryCount maxRetries) throw; await TryReconnectAsync().ConfigureAwait(false); await Task.Delay(1000, cancellationToken).ConfigureAwait(false); // 重连后稍作等待 } catch (PlcCommunicationException ex) when (ex.Message.Contains(PDU)) { // PDU错误可能是请求格式错误或PLC忙不一定是连接问题 _logger?.LogError(ex, 协议层错误地址或数据可能无效。); throw; // 直接抛出因为重试可能无效 } catch (OperationCanceledException) { _logger?.LogInformation(操作被取消。); throw; } catch (Exception ex) { _logger?.LogError(ex, 执行PLC操作时发生未预期异常。); throw; } } }然后我们的公开读写方法可以包装在这个ExecuteWithRetryAsync中public async Taskbool ReadBoolWithRetryAsync(string address, CancellationToken cancellationToken default) { return await ExecuteWithRetryAsync(() ReadBoolAsync(address, cancellationToken), 2, cancellationToken).ConfigureAwait(false); }6. 高级应用与性能优化当基础功能稳定后我们可以考虑更高级的应用和优化。6.1 使用异步流进行数据变更订阅在某些场景下我们需要监听PLC中某个变量的变化。虽然S7协议本身没有“订阅”机制但我们可以通过周期性读取比较来模拟。public class PlcVariableMonitorT { private readonly S7PlcClient _client; private readonly string _address; private readonly Funcstring, CancellationToken, TaskT _readFunc; private readonly IEqualityComparerT _comparer; private Timer? _pollTimer; private T? _lastValue; public event EventHandlerT? ValueChanged; public PlcVariableMonitor(S7PlcClient client, string address, Funcstring, CancellationToken, TaskT readFunc, IEqualityComparerT? comparer null) { _client client; _address address; _readFunc readFunc; _comparer comparer ?? EqualityComparerT.Default; } public async Task StartMonitoringAsync(int pollIntervalMs 500, CancellationToken cancellationToken default) { // 先读取一次初始值 _lastValue await _readFunc(_address, cancellationToken).ConfigureAwait(false); _pollTimer new Timer(async _ { try { var currentValue await _readFunc(_address, CancellationToken.None).ConfigureAwait(false); if (!_comparer.Equals(currentValue, _lastValue)) { _lastValue currentValue; ValueChanged?.Invoke(this, currentValue); } } catch (Exception ex) { // 记录错误但不要停止定时器等待下次轮询或由心跳机制处理重连 Debug.WriteLine($监控轮询失败: {ex.Message}); } }, null, pollIntervalMs, pollIntervalMs); } public void StopMonitoring() { _pollTimer?.Dispose(); _pollTimer null; } }使用方式var monitor new PlcVariableMonitorfloat(plcClient, DB10.DBD30, (addr, ct) plcClient.ReadRealAsync(addr, ct)); monitor.ValueChanged (sender, newTemp) Console.WriteLine($温度变更为: {newTemp}); await monitor.StartMonitoringAsync(1000); // 每秒检查一次6.2 读写性能分析与优化建议批量操作优先这是最重要的原则。将多个读写请求合并为一个ReadMultipleVars或WriteMultipleVars调用能极大减少网络往返次数。合理设置PDU大小S7协议有最大PDU长度限制早期PLC是240字节S7-1200/1500可以更大默认约960字节。确保一次批量读取的数据总量不要超过PLC的PDU限制否则库内部会拆分影响效率。可以通过_plc!.PDU属性获取协商后的PDU大小。避免高频单点读写不要用Timer以10ms的间隔去读一个Bool值。这会给PLC的通信处理器带来不必要的负担。对于需要快速响应的信号考虑使用PLC的“变化检测”功能将信号汇总到一个字或双字中上位机一次读取后再解析。使用ConfigureAwait(false)在库代码和你的异步方法中对不需要回到原始同步上下文如UI线程的await使用ConfigureAwait(false)可以避免不必要的线程上下文切换提升吞吐量特别是在服务端应用中。连接池考虑对于需要与多个PLC通信的大型系统可以考虑实现一个简单的连接池管理Plc对象的创建和销毁但要注意Plc对象本身不是线程安全的需要妥善管理。7. 完整示例一个简单的设备状态监控程序最后我们用一个完整的控制台程序示例将上述所有模块串联起来。using Microsoft.Extensions.Logging; using MyIndustrialApp.PlcCommunication; class Program { static async Task Main(string[] args) { // 1. 配置 var config new S7PlcClient.PlcConfig { CpuType CpuType.S71500, IpAddress 192.168.1.100, Rack 0, Slot 1, TimeoutMs 3000 }; // 2. 创建客户端使用控制台日志 using var loggerFactory LoggerFactory.Create(builder builder.AddConsole()); var logger loggerFactory.CreateLoggerS7PlcClient(); using var plcClient new S7PlcClient(config, logger); try { // 3. 连接 Console.WriteLine(正在连接PLC...); if (await plcClient.ConnectAsync()) { Console.WriteLine(连接成功); // 启动心跳 await plcClient.StartHeartbeatAsync(20); } // 4. 读取单个值 var motorRunning await plcClient.ReadBoolWithRetryAsync(DB1.DBX0.0); Console.WriteLine($电机运行状态: {motorRunning}); var currentSpeed await plcClient.ReadIntWithRetryAsync(DB1.DBW2); Console.WriteLine($当前转速: {currentSpeed} RPM); // 5. 批量读取 var addressesToRead new Liststring { DB1.DBX0.0, DB1.DBW2, DB1.DBD4, M0.0 }; var results await plcClient.ReadMultipleVarsAsync(addressesToRead); Console.WriteLine(批量读取结果:); for (int i 0; i addressesToRead.Count; i) { Console.WriteLine($ {addressesToRead[i]} : {results[i]}); } // 6. 写入一个值 await plcClient.WriteBoolWithRetryAsync(DB1.DBX10.0, true); Console.WriteLine(已下发启动命令。); // 7. 监控一个变量变化 var tempMonitor new PlcVariableMonitorfloat(plcClient, DB1.DBD20, (addr, ct) plcClient.ReadRealAsync(addr, ct)); tempMonitor.ValueChanged (sender, newTemp) { Console.WriteLine($[{DateTime.Now:HH:mm:ss}] 温度报警当前温度: {newTemp:F1} °C); }; await tempMonitor.StartMonitoringAsync(2000); // 每2秒检查一次 Console.WriteLine(监控已启动按任意键退出...); Console.ReadKey(); tempMonitor.StopMonitoring(); } catch (PlcCommunicationException ex) { Console.WriteLine($PLC通信发生严重错误: {ex.Message}); if (ex.InnerException ! null) { Console.WriteLine($内部异常: {ex.InnerException.Message}); } } catch (Exception ex) { Console.WriteLine($程序发生未预期错误: {ex}); } finally { Console.WriteLine(程序结束。); } } }这个示例展示了从连接、单点读写、批量操作到变化监控的完整流程并集成了错误处理和心跳机制是一个可以直接用于小型监控项目的起点。8. 排错指南常见问题与解决方案在实际部署中你几乎一定会遇到下面这些问题。这里是我的排查清单连接失败提示“No connection could be made because the target machine actively refused it”检查IP和端口确认PLC的IP地址是否正确并且PC与PLC在同一网段。用ping命令测试网络连通性。确认PLC的S7通信服务已启用对于S7-1200/1500需要在TIA Portal的“设备配置”-“防护与安全”-“连接机制”中勾选“允许来自远程对象的PUT/GET通信访问”。检查机架/槽号对于S7-300/400机架和槽号必须正确。通常机架为0槽号在硬件组态中查看CPU所在的插槽号从1开始。对于S7-1200/1500机架和槽号通常固定为0和1。防火墙关闭PC和PLC侧的防火墙进行测试。读写数据返回错误或数据明显不对地址格式错误这是最常见的原因。仔细核对地址字符串确保DB号、字节偏移、位偏移正确。特别注意DB块必须先被PLC程序调用至少一次才能被访问。数据类型不匹配试图用ReadInt去读一个Real地址或者String的长度定义错误。字节序问题如果你自己处理字节数组要记得S7协议是大端序。使用S7.Net.Types下的Int.FromByteArray、Real.FromByteArray等方法可以避免这个问题。PLC处于STOP模式某些PLC在STOP模式下数据块可能无法访问。通信间歇性中断偶尔超时网络负载检查网络是否拥堵是否有广播风暴。工业环境建议使用独立的交换机或VLAN。PLC负载过高如果PLC的CPU利用率长期过高可能无法及时响应通信请求。优化PLC程序或降低上位机的轮询频率。超时设置适当增加ReadTimeout和WriteTimeout的值比如从默认的1秒增加到5秒。启用Keep-Alive可以尝试在创建Plc对象后设置底层的TCP Socket的KeepAlive属性_plc.TcpClient.Client.SetSocketOption但这需要修改S7.Net源码或通过反射实现。批量读取时部分数据正确部分错误PDU大小超限检查单次批量读取的数据总量是否超过了PLC的PDU最大值。尝试减少单次请求的变量数量。地址跨区域一次批量读取的地址最好集中在同一个数据区如同一个DB块内。跨区域如同时读DB和M区的请求在某些PLC上可能效率较低或受限制。这套从原理到实践再到排错的完整方案是我在多个工业数据采集项目中总结提炼出来的。它没有使用任何复杂的框架核心依赖就是S7.Net库但通过良好的封装和错误处理其稳定性和可维护性足以应对大多数中小型项目。当然对于超大规模、高并发的场景你可能需要考虑更专业的工业通信平台或分布式架构但那时你今天在这里学到的关于S7协议本身的知识依然是不可或缺的基础。