简介本资源是面向工业自动化开发者的C#与汇川PLC通信实战示例适用于具备基础C#编程能力、希望切入工控系统集成的中初级工程师及高校自动化相关专业学生。项目聚焦Modbus TCP协议在C#中的工程化实现覆盖Socket网络通信、寄存器读写、异常处理、实时数据交互等核心场景可直接用于产线监控界面开发或PLC数据采集模块搭建。压缩包共624个文件约214.54MB含43个可执行程序exe、36个动态链接库dll、12个C#源码文件cs、46个头文件h及大量编译中间产物tlog、obj、pdb等体现完整VS工程结构与调试部署流程其中多个.csproj与.sln文件表明项目支持多方案对比验证。目前已有582人学习下载读者可获得可运行的通信Demo、标准化Modbus API调用范例、汇川PLC地址映射配置参考及常见通信超时与CRC校验失败的排错逻辑助力快速打通C#上位机与国产主流PLC的数据链路。1. C# 与汇川 PLC 通信示例不是调个库就完事而是搞懂 TCP 底层握手、寄存器映射和心跳保活这三道关你写好 C# 程序填上 IP 和端口点运行——结果SocketException: 连接被拒绝或者更玄学的能连上读一次数据正常第二次就卡死第三次直接超时断开。这不是代码写错了是没摸清汇川 PLC 的通信逻辑本质。这个「C# 与汇川 PLC 通信示例」资源不是教你怎么拖控件绑按钮的玩具 Demo而是一套完整落地于某产线视觉定位工位的实操包它包含基于原生 Socket 封装的轻量通信类非第三方库依赖、支持 H3U/H5U 系列的 Modbus TCP 协议解析器、带自动重连与超时熔断的连接管理器以及最关键的——一份对照汇川官方《H3U 用户手册 V2.8》第 7.4 节寄存器地址表逐项验证过的读写映射表。适合正在做设备集成、想摆脱 EasyIO 或 Kepware 等中间件依赖、需要把通信模块嵌入自有 MES/SCADA 架构的 C# 工程师。如果你只想要“复制粘贴就能跑”的 hello world它可能太重但如果你正被现场 PLC 偶发掉线、数据错位、写入失败反复折磨这份资源就是你该拆开的第一份黑匣子。2. 为什么选原生 Socket Modbus TCP 而非厂商 SDK协议层可控性决定现场鲁棒性2.1 汇川 PLC 的通信协议栈真相Modbus TCP 是事实标准不是可选项汇川 H3U/H5U 系列 PLC 在以太网侧默认启用的是 Modbus TCP 协议端口 502这是 IEC 61158 标准定义的工业通用协议而非汇川私有协议。虽然汇川也提供 IS6000 SDK需单独申请授权和串口 Modbus RTU 支持但在实际产线部署中90% 以上的 C# 上位机选择 Modbus TCP原因很现实免驱动免授权无需安装汇川专用驱动或申请 SDK 许可证部署到客户现场不踩合规雷区跨平台兼容同一套 C# 通信逻辑稍作适配即可对接西门子 S7-1200S7Comm over TCP、三菱 FX5UMC 协议封装在 TCP 中等其他品牌抓包可验证Wireshark 抓到的 Modbus TCP 流量结构清晰事务标识符协议标识符长度单元标识符功能码数据出问题时能直接比对字节流而不是对着 SDK 文档猜“为什么 ReadBool 返回 false”。提示本资源所有通信均基于 RFC 1006 定义的 Modbus TCP不使用汇川扩展的“汇川自定义协议”该协议需额外配置 PLC 网关模式且文档极不透明现场已有多起因固件升级导致协议变更而瘫痪的案例。2.2 原生 Socket 封装 vs 第三方库控制粒度决定故障定位速度常见做法是直接引用 NModbus4 或 EasyModbus.NET它们封装了 Modbus 功能码细节用起来确实快。但某次在某高校实验室调试一台 H3U 控制的传送带时我们遇到一个典型问题ReadHoldingRegisters(40001, 10)总是返回全 0而用 Modbus Poll 工具读同一地址却正常。排查三天后发现NModbus4 默认将起始地址40001解析为 0-based 寄存器索引即读 0 号寄存器而汇川 PLC 的 Modbus TCP 实现严格遵循 Modbus 规范40001表示“保持寄存器区第 1 个”对应索引 0但其内部地址映射要求功能码 0x03 的起始地址必须传入 0不能传 40001。NModbus4 的ReadHoldingRegisters方法签名是ReadHoldingRegisters(int startingAddress, int numberOfPoints)这里的startingAddress是 0-based但大量工程师习惯性传入 40001 —— 这就是血泪经验第三方库帮你省了 10 行代码却藏了 3 个协议细节坑。本资源采用原生System.Net.Sockets.Socket封装核心通信类H3UModbusClient公开所有协议字段public class H3UModbusClient { private Socket _socket; private readonly byte[] _transactionId new byte[2]; // 手动控制事务ID用于多请求并发时匹配响应 private readonly byte[] _protocolId { 0x00, 0x00 }; // Modbus TCP 固定为 0x0000 private readonly byte[] _unitId new byte[1]; // 汇川默认为 0x01但部分固件需设为 0xFF // 关键地址转换由使用者显式控制杜绝隐式转换陷阱 public ushort ConvertToModbusAddress(string addressCode) { // 40001 - 0, 40010 - 9, 30001 - 0 (输入寄存器) return (ushort)(int.Parse(addressCode.Substring(1)) - 1); } }这段代码的意义不在语法而在把地址转换这个最易出错的环节暴露出来。当你调用client.ReadHoldingRegisters(0, 10)时你知道自己传的是协议层真实索引当你要读40001必须先调ConvertToModbusAddress(40001)这个强制步骤就是防错保险丝。2.3 连接模型设计为什么必须实现心跳保活与连接状态机PLC 以太网口不是 PC 网卡其 TCP 栈资源极其有限H3U 最大并发连接数仅 4 个。若 C# 程序异常退出未发送 FIN 包PLC 会维持该 socket 连接长达 5 分钟TCP keepalive 默认超时导致后续连接被拒绝。更糟的是某些现场交换机启用了 ARP 老化机制PLC 缓存的 PC MAC 地址过期后即使 socket 处于 ESTABLISHED 状态实际数据包也无法送达。因此本资源的H3UModbusClient内置两级保活应用层心跳每 15 秒发送一次0x00 0x00 0x00 0x00 0x00 0x06 0x01 0x03 0x00 0x00 0x00 0x01读取 40001 寄存器长度 1响应超时则触发重连Socket 层 keepalive设置Socket.SetSocketOption(SocketOptionLevel.Socket, SocketOptionName.KeepAlive, true)并手动配置IOControl(IOControlCode.KeepAliveValues, ...)确保底层 TCP 探测包生效。连接状态机采用四状态设计状态触发条件自动迁移Disconnected初始化或主动断开→ Connecting调用 Connect() 后ConnectingSocket.ConnectAsync 开始→ Connected成功或 Disconnected失败Connected收到心跳响应→ Connected持续心跳或 Disconnected心跳超时 3 次Disconnecting主动 Close()→ Disconnected清理资源后这个状态机不是炫技而是让日志能精准回答“此刻连接为何不可用”——是 DNS 解析失败TCP 三次握手卡在 SYN_SENT还是心跳连续丢包每一行日志都对应一个确定状态。3. 通信流程拆解从建立连接到读写 D 区、M 区、R 区寄存器的完整链路3.1 连接建立IP、端口、超时参数的工业级配置逻辑汇川 PLC 的以太网配置界面中“IP 地址”和“子网掩码”必须与上位机在同一网段但最关键却常被忽略的是‘网关’设置。即使 PLC 不需要访问外网若网关配置为空或错误部分固件版本如 H3U V3.2.1会禁用 Modbus TCP 服务。某次在某公司装配线调试时PLC IP 为192.168.1.10上位机为192.168.1.100ping 通但 Modbus 连接失败最终发现 PLC 网关被误设为0.0.0.0改为192.168.1.1后立即恢复。连接代码中超时参数必须分层设置public async Taskbool ConnectAsync(string plcIp, int plcPort 502, TimeSpan connectTimeout default, TimeSpan sendTimeout default, TimeSpan receiveTimeout default) { _socket new Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp); // 1. 连接超时仅控制三次握手阶段设为 3~5 秒足够 var cts new CancellationTokenSource(connectTimeout default ? TimeSpan.FromSeconds(5) : connectTimeout); try { var endPoint new IPEndPoint(IPAddress.Parse(plcIp), plcPort); await _socket.ConnectAsync(endPoint, cts.Token).ConfigureAwait(false); // 2. Socket 级超时影响所有 Send/Receive 操作设为 1~2 秒防卡死 _socket.SendTimeout (int)(sendTimeout default ? TimeSpan.FromMilliseconds(1500) : sendTimeout).TotalMilliseconds; _socket.ReceiveTimeout (int)(receiveTimeout default ? TimeSpan.FromMilliseconds(1500) : receiveTimeout).TotalMilliseconds; // 3. 启用 Nagle 算法关闭工业通信要求低延迟禁用合并小包 _socket.SetSocketOption(SocketOptionLevel.Tcp, SocketOptionName.NoDelay, true); _connectionState ConnectionState.Connected; _logger.LogInformation($Connected to {plcIp}:{plcPort}); return true; } catch (OperationCanceledException) when (cts.IsCancellationRequested) { _logger.LogWarning($Connection timeout to {plcIp}:{plcPort}); return false; } catch (SocketException ex) when (ex.SocketErrorCode SocketError.ConnectionRefused) { _logger.LogError(ex, $PLC refused connection. Check if Modbus TCP is enabled in PLC config.); return false; } }关键参数说明connectTimeout仅作用于ConnectAsync超过则抛OperationCanceledException此时 socket 未建立可安全释放Send/ReceiveTimeout作用于后续所有SendAsync/ReceiveAsync超时后 socket 仍处于连接状态但需主动ShutdownCloseNoDelay true禁用 Nagle 算法避免小数据包如单个字节写入被缓冲 200ms这对实时控制指令至关重要。3.2 读取 D 区保持寄存器地址偏移、字节序与数据类型还原汇川 PLC 的 D 区保持寄存器对应 Modbus 功能码0x03Read Holding Registers。但要注意地址映射D100 对应 Modbus 地址40101D 区起始为 D0 → 40001因此读 D100 需传入索引100即40101 - 1字节序汇川默认使用Big-Endian高字节在前但 C#BitConverter默认 Little-Endian必须手动反转数据类型单个寄存器为 16 位无符号整数UInt16但常用数据如浮点数32 位、双整数32 位需跨 2 个寄存器。读取 D100-D101构成一个 float的完整流程public async Taskfloat? ReadFloatFromD(int dStartAddress, int count 1) { // 1. 地址转换D100 → 索引 100 ushort startIdx (ushort)(dStartAddress); // 2. 发送 Modbus TCP 请求帧功能码 0x03读 2 个寄存器 byte[] request BuildReadRequest(startIdx, (ushort)(count * 2)); // float 占 2 寄存器 // 3. 发送并接收响应 byte[] response await SendAndReceive(request).ConfigureAwait(false); // 4. 解析响应跳过头 9 字节事务ID协议ID长度单元ID功能码字节数取后续数据 if (response.Length 12) return null; byte[] dataBytes response.Skip(9).Take(4).ToArray(); // float 需 4 字节 // 5. Big-Endian 转换汇川返回 [byte3, byte2, byte1, byte0]需转为 C# 的 [byte0, byte1, byte2, byte3] Array.Reverse(dataBytes); // 关键不反转则 float 值完全错误 return BitConverter.ToSingle(dataBytes, 0); } private byte[] BuildReadRequest(ushort startAddress, ushort quantity) { // Modbus TCP 帧格式[事务ID][协议ID][长度][单元ID][功能码][起始地址][数量] return new byte[] { _transactionId[0], _transactionId[1], // 事务ID每次递增 0x00, 0x00, // 协议ID固定 0x0000 0x00, 0x06, // 长度6 字节单元ID功能码地址数量 _unitId[0], // 单元ID汇川默认 0x01 0x03, // 功能码读保持寄存器 (byte)(startAddress 8), (byte)startAddress, // 起始地址Big-Endian (byte)(quantity 8), (byte)quantity // 数量Big-Endian }; }注意Array.Reverse(dataBytes)这一行是 D 区读取的生死线。曾有项目因漏掉此步导致温度值显示为1.2e-38IEEE 754 非法值现场排查 2 天才发现是字节序问题。3.3 写入 M 区线圈与 R 区输入寄存器功能码差异与权限校验M 区线圈对应功能码0x05Write Single Coil和0x0FWrite Multiple CoilsR 区输入寄存器只读对应功能码0x04Read Input Registers。关键区别在于地址基点M0-M999 对应 Modbus 地址00001-00999线圈区0-basedR0-R999 对应10001-10999输入寄存器区1-based汇川 PLC 中R 区通常映射物理输入点如 X0-X17不可写M 区为内部线圈可读可写。写入 M100地址00101为 ON 的代码public async Taskbool WriteCoilAsync(int mAddress, bool value) { ushort coilAddress (ushort)(mAddress); // M100 → 索引 100 byte[] request BuildWriteCoilRequest(coilAddress, value); byte[] response await SendAndReceive(request).ConfigureAwait(false); // 成功响应回传相同功能码 地址 值0xFF00 表示 ON0x0000 表示 OFF return response.Length 8 response[7] 0x05 BitConverter.ToUInt16(response, 8) coilAddress BitConverter.ToUInt16(response, 10) (value ? (ushort)0xFF00 : (ushort)0x0000); } private byte[] BuildWriteCoilRequest(ushort coilAddress, bool value) { // 功能码 0x05[事务ID][协议ID][长度][单元ID][功能码][地址][值] return new byte[] { _transactionId[0], _transactionId[1], 0x00, 0x00, 0x00, 0x06, _unitId[0], 0x05, (byte)(coilAddress 8), (byte)coilAddress, (byte)(value ? 0xFF : 0x00), 0x00 // 值0xFF00 或 0x0000 }; }权限陷阱汇川 PLC 默认禁止远程写入 M 区需在编程软件如 AutoShop中打开“允许远程写入线圈”选项位于 PLC 参数 → 网络设置 → Modbus TCP 设置。未开启时写入请求会静默失败响应帧与成功帧相同但 PLC 内部状态不变这是最隐蔽的坑之一。4. 避坑指南现场高频翻车场景与血泪排查路径4.1 现象SocketException: 连接被拒绝但 ping 通且 PLC 网页能登录原因PLC 的 Modbus TCP 服务未启用或端口被防火墙拦截。汇川 PLC 的 Modbus TCP 是独立服务需在编程软件中手动勾选启用非默认开启。解决用 AutoShop 连接 PLC → 查看“PLC 参数” → “网络设置” → “Modbus TCP 设置” → 确认“启用 Modbus TCP”已勾选检查 PLC 固件版本V3.0 以下版本需额外设置“Modbus TCP 端口”为 502部分旧版默认为 503在 PLC 本地执行netstat -an如有命令行接口确认TCP 0.0.0.0:502处于LISTENING状态。4.2 现象读取 D 区数据始终为 0但 Modbus Poll 工具读取正常原因C# 代码中地址传入了十进制地址如40101而 Modbus TCP 协议要求传入 0-based 索引100。第三方库常做隐式转换但原生实现必须手动转换。解决严格使用ConvertToModbusAddress(40101)方法禁止硬编码数字在BuildReadRequest中添加日志_logger.LogDebug($Writing address: {startAddress} (0-based))与 Wireshark 抓包对比。4.3 现象程序运行 2 小时后突然无法读取重启 C# 程序恢复但 PLC 未重启原因PLC TCP 连接数耗尽。H3U 最大并发连接数为 4若 C# 程序异常退出未调用Socket.Close()连接残留或心跳包未发送PLC 主动断开后未触发重连。解决在H3UModbusClient的Dispose方法中强制Shutdown(SocketShutdown.Both)Close()实现心跳失败后Disconnect()→ConnectAsync()的完整重连闭环而非仅重发心跳在 PLC 端启用“连接超时”设置建议 60 秒避免长连接占用。4.4 现象写入 M100 成功但 PLC 程序中LD M100无动作原因PLC 程序扫描周期未更新或 M100 被其他逻辑复位。更常见的是——写入的是“线圈”Coil但 PLC 程序中使用的是“触点”Contact而汇川部分固件对线圈写入有 1 个扫描周期延迟。解决在 PLC 程序中添加OUT M100指令测试排除逻辑错误使用WriteMultipleCoils一次性写入多个线圈降低通信开销在 C# 中写入后延时await Task.Delay(50)再读取确认避开扫描周期窗口。4.5 现象浮点数读取值为NaN或极大值如3.4e38原因字节序反转错误或寄存器数量不足。float 需 2 个连续寄存器4 字节若只读 1 个寄存器2 字节BitConverter.ToSingle会用后续内存垃圾填充。解决强制检查response.Length读 float 必须 12字节头 9 数据 4 -1等等修正头 9 字节 2 字节字节数 4 字节数据 15 字节不标准 Modbus TCP 响应头为 9 字节后跟 1 字节字节数 N 字节数据float 为 4 字节数据故总长 9 1 4 14使用Spanbyte安全切片var dataSpan response.AsSpan(91, 4)避免越界添加float.IsNaN(result)校验失败时记录原始字节流供分析。5. 寄存器映射表实战H3U 常用 D/M/R 区地址与 C# 类型转换速查5.1 为什么必须有一份手写的映射表而不是依赖文档汇川《H3U 用户手册》中的寄存器地址表存在三大问题地址表述混乱同一寄存器在不同章节出现为D100、40101、0x0064三种格式新手无法关联功能描述模糊如“D200用户自定义”未说明是否支持浮点、字节序、读写权限固件差异缺失V3.1 与 V3.2 中 D500 的用途可能不同手册未标注。本资源附带的H3U_RegisterMap.xlsx是某产线实测 6 个月后整理的权威映射覆盖 95% 常用场景。下表为精选核心条目已脱敏PLC 区域地址PLC 格式Modbus 地址C# 读取方法数据类型用途说明实测固件D 区D10040101ReadInt16FromD(100)Int16温度设定值℃V3.2.1D 区D101-D10240102-40103ReadFloatFromD(101)float实际温度℃V3.2.1D 区D200-D20140201-40202ReadFloatFromD(200)float电机转速RPMV3.2.1M 区M10000101ReadCoilAsync(100)bool启动按钮状态V3.2.1M 区M10100102WriteCoilAsync(101, true)bool急停输出信号V3.2.1R 区R010001ReadInputRegisterAsync(0)UInt16X0 输入状态bit0V3.2.1提示表格中“C# 读取方法”列是直接可抄的 API 名称对应资源包中H3UModbusClient类的公开方法无需二次封装。5.2 D 区数据类型转换从寄存器值到工程值的标定公式PLC 寄存器存储的是原始整数需按传感器量程转换为工程值。例如某温度传感器量程 0~100℃输出 4~20mA经 AD 转换后存入 D100其值范围为 0~10000对应 4~20mA。C# 中需做线性转换// 读取 D100 原始值 short rawValue await client.ReadInt16FromD(100); // 返回 -32768 ~ 32767 // 标定公式工程值 (rawValue - rawMin) * (engMax - engMin) / (rawMax - rawMin) engMin double temperature (rawValue - 0) * (100.0 - 0.0) / (10000.0 - 0.0) 0.0; // 更健壮的写法封装为扩展方法 public static double ToTemperature(this short raw, short rawMin 0, short rawMax 10000, double engMin 0.0, double engMax 100.0) { return (raw - rawMin) * (engMax - engMin) / (rawMax - rawMin) engMin; }关键教训标定参数rawMin/rawMax绝不能硬编码在业务逻辑中必须从配置文件或数据库加载。某次固件升级后传感器更换rawMax 从 10000 变为 12000因未抽离配置导致全线温度显示偏高 20%返工 3 天。5.3 M 区批量操作如何用单次请求读写 100 个线圈提升吞吐Modbus TCP 协议支持0x0FWrite Multiple Coils一次写入最多 0x07B01968个线圈但汇川 PLC 实测最大为 128 个。批量操作可将 100 次单线圈写入100×15ms 1.5s压缩至 1 次15ms提升 100 倍效率。写入 M100-M199 的代码框架public async Taskbool WriteMultipleCoilsAsync(int startMAddress, bool[] values) { if (values.Length 128) throw new ArgumentException(Max 128 coils per request for H3U); ushort startIdx (ushort)startMAddress; byte[] coilBytes PackCoilValues(values); // 将 bool[] 转为 bit-packed byte[] byte[] request BuildWriteMultipleCoilsRequest(startIdx, (ushort)values.Length, coilBytes); byte[] response await SendAndReceive(request).ConfigureAwait(false); return response.Length 8 response[7] 0x0F BitConverter.ToUInt16(response, 8) startIdx BitConverter.ToUInt16(response, 10) (ushort)values.Length; } private byte[] PackCoilValues(bool[] values) { int byteCount (values.Length 7) / 8; byte[] bytes new byte[byteCount]; for (int i 0; i values.Length; i) { if (values[i]) { bytes[i / 8] | (byte)(1 (i % 8)); } } return bytes; }性能实测在千兆内网中单线圈写入平均耗时 12~18ms100 线圈批量写入平均耗时 14~16ms吞吐量从 55 次/秒提升至 5000 次/秒以上。这对需要高速同步 IO 的场景如飞剪定位至关重要。6. 连接诊断与日志审计用 Wireshark 抓包 自定义日志分级定位通信瓶颈6.1 Wireshark 过滤规则三步锁定 Modbus TCP 问题帧当 C# 程序行为异常不要先改代码先抓包。Wireshark 是唯一能穿透协议栈的真相之眼。针对汇川 PLC 通信设置以下过滤器过滤目标Wireshark 显示过滤器用途查看所有 Modbus TCP 流量tcp.port 502确认流量是否到达 PLC查看 C# 发送的请求tcp.port 502 and ip.src 192.168.1.100检查请求帧是否符合规范事务ID递增、地址正确查看 PLC 返回的响应tcp.port 502 and ip.dst 192.168.1.100 and modbus.func_code 3验证响应数据长度、字节序、功能码是否匹配关键技巧右键响应帧 → “Decode As…” → 将 TCP 流强制解码为 ModbusWireshark 会自动解析功能码、地址、数据比肉眼数十六进制快 10 倍。6.2 日志分级设计INFO 级别不记录原始字节DEBUG 级别才输出生产环境日志若每秒记录 100 次 20 字节的 Modbus 帧日志文件 1 小时就超 1GB。本资源采用四级日志策略日志级别触发条件输出内容示例Warning心跳超时、连接断开连接状态、重试次数、最后成功时间WARN: Heartbeat timeout #3. Last success: 2023-10-05 14:22:31ErrorSocketException、协议解析失败异常类型、PLC IP、失败帧前 16 字节hexERROR: SocketException (10061) connecting to 192.168.1.10Debug单次读写操作完整请求/响应帧hex、耗时、地址、数据长度DEBUG: Read 40101, 2 regs, 14 bytes, time12.3ms: 000000000006010300640002...Trace连接建立/断开Socket 本地端口、远程端口、连接耗时TRACE: Connected to 192.168.1.10:502 via 192.168.1.100:54321, time8.2ms在appsettings.json中配置{ Logging: { LogLevel: { Default: Information, H3UModbusClient: Debug } } }这样生产环境只需 INFO 级日志排查时临时调高为 Debug既保性能又保可追溯性。6.3 通信质量仪表盘用 Prometheus Grafana 监控连接健康度对于长期运行的系统人工查日志效率低下。本资源提供轻量监控方案在H3UModbusClient中暴露指标modbus_connection_up{plch3u_line1}1在线0离线、modbus_request_duration_seconds{plch3u_line1,typeread}[1m]P95 延迟使用PrometheusNet库暴露/metrics端点Grafana 配置看板关键告警规则modbus_connection_up 0持续 30 秒 → 触发邮件告警rate(modbus_request_duration_seconds_sum[5m]) / rate(modbus_request_duration_seconds_count[5m]) 0.5→ 延迟超 500ms需检查网络或 PLC本文还有配套的精品资源点击获取