简介这是一份面向工业自动化领域C#开发者的欧姆龙PLC上位机通信开源解决方案专为需要快速集成FINS协议读写功能的工程师设计解决传统方案依赖第三方组件、线程阻塞、部署复杂等痛点。资源包共30个文件含9个核心C#源码文件如Form1.cs、Program.cs、2个可执行程序exe、1个Visual Studio解决方案sln与1个项目文件csproj辅以配置文件config、资源文件resx、调试符号pdb及使用说明文档txt整体仅42KB轻量易集成。已有5098人学习下载验证于多个实际产线项目。开发者可直接复用全开源通信模块无需额外安装驱动或SDK后台线程安全调用机制保障UI响应性完整VS工程结构支持开箱即用、二次开发与协议扩展是C#快速构建欧姆龙PLC监控、数据采集与HMI系统的高性价比起点。1. C# 直连欧姆龙PLC 的 FINS 协议实战不装驱动、不配网关、后台线程零卡顿的上位机开发方案你有没有遇到过这种场景现场调试一台欧姆龙 CP1E 或 NJ 系列 PLC客户明确要求“不能装任何第三方 OPC 服务器不能动 PLC 网络配置最好一个 EXE 就能读写 D 区和 CIO 区”我去年在某高校自动化实验室做设备监控模块时就撞上这堵墙——OPC UA 配置被禁FinsGateway 试了三天连不上最后翻出一份压箱底的 C# FINS TCP 实现改两行 IP、填四个寄存器地址5 分钟跑通读写。这不是 Demo是真实产线已用两年的轻量级上位机底座全开源、无依赖、纯 .NET Framework 4.6.1、TCP 层直打 FINS 帧连System.Net.Sockets都没封装成黑匣子。它解决的不是“能不能连”而是“怎么让工程师下班前把数据采进 Excel”。适合需要快速交付 PLC 数据采集界面的产线改造、教学实验、小型 SCADA 补丁开发尤其适合对 COM 组件过敏、反感注册表操作、又不想啃欧姆龙官方 SDK 文档的 C# 开发者。附件里那个winPlc.sln不是玩具工程是某跨平台系统中负责实时采集 32 台 CP1H 的核心通信模块裁剪版。2. FINS 协议底层原理与 C# 实现选型为什么放弃官方 SDK 而手撕 TCP 帧2.1 欧姆龙 FINS 是什么不是协议栈是寄存器搬运工FINSFactory Interface Network Service本质是一套定义在 TCP/UDP 之上的应用层指令集不是像 Modbus TCP 那样有公开标准文档的通用协议。它的核心逻辑极其朴素客户端构造一个固定结构的二进制帧Header Command Data发给 PLC 的 9600 端口TCP或 9600 端口UDPPLC 解析后返回带状态码的响应帧。关键点在于无状态连接每次读写都是独立请求/响应不维持会话地址映射硬编码D100 对应0x00000064十六进制地址CIO100 对应0x00000064但区域码不同命令极简0x0101读内存块、0x0102写内存块、0x0201读 CPU 状态仅此三类覆盖 95% 场景。官方 SDK如 CX-One 的 .NET 类库之所以被绕开是因为它强制依赖Omron.Fins.dll而该 DLL 在无 CX-One 环境下无法注册且内部做了线程池封装调试时根本看不到原始帧。本项目选择裸 TCP是为了把“PLC 怎么回包”这个黑匣子彻底打开——所有字节都暴露在byte[]里出问题时抓个 Wireshark 就能比对。2.2 项目结构解剖从Form1.cs到FinsTcpClient.cs的三层穿透打开winPlc.sln你会看到一个精简到极致的 WinForms 工程结构UI 层Form1.cs仅负责按钮点击事件绑定和 DataGridView 绑定所有通信逻辑外移协议层FinsTcpClient.cs虽未显式命名但逻辑集中在Form1.cs的SendFinsCommand方法中——这才是核心。它不继承任何基类纯静态方法构造帧private byte[] BuildReadCommand(string areaCode, ushort startAddress, ushort wordCount) { // FINS Header: 10 bytes (ICF0x80, RSV0x00, GCT0x00, DNA0x00, DA10x00, DA20x00, SNA0x00, SA10x00, SA20x00, SID0x01) byte[] header { 0x80, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x01 }; // Command: 0x0101 (read memory), Area Code (0x82D区, 0x30CIO区), Address (little-endian 4-byte) byte[] command new byte[10]; Buffer.BlockCopy(BitConverter.GetBytes((ushort)0x0101), 0, command, 0, 2); // cmd command[2] Convert.ToByte(areaCode, 16); // area code byte[] addrBytes BitConverter.GetBytes(IPAddress.HostToNetworkOrder((int)startAddress)); Buffer.BlockCopy(addrBytes, 0, command, 3, 4); // address Buffer.BlockCopy(BitConverter.GetBytes(wordCount), 0, command, 7, 2); // word count return header.Concat(command).ToArray(); }提示areaCode是欧姆龙 FINS 的灵魂参数。0x82对应 D 区0x30对应 CIO 区0xB0对应 WR 区必须严格匹配 PLC 型号手册。CP1E 默认 D 区起始地址为0x0000而 NJ 系列需查《FINS 指令参考手册》确认偏移。配置层App.config仅存三项add keyPlcIp value192.168.1.10/、add keyPlcPort value9600/、add keyTimeoutMs value3000/。没有 XML 序列化、没有属性反射改完直接生效。2.3 为什么必须用后台线程WinForms 主线程阻塞的血泪现场Form1.cs中所有 PLC 通信调用都包裹在Task.Run(() { ... })中这不是为了“高大上”而是物理定律决定的TCP 连接建立耗时约 100~500ms取决于网络抖动FINS 响应超时默认设为 3 秒若在 UI 线程执行client.Receive()整个窗体将冻结更致命的是欧姆龙 PLC 在高负载时可能延迟响应此时Receive()会卡死直到超时用户点击按钮后光标变圈长达 3 秒——这在产线监控中是不可接受的。本项目采用最朴素的异步模式private async void btnReadD100_Click(object sender, EventArgs e) { var result await Task.Run(() ReadDRegister(192.168.1.10, 100, 1)); // 读 D100 1 个字 if (result.Success) txtD100.Text result.Value.ToString(); // 更新 UI 必须切回主线程 else MessageBox.Show($读取失败: {result.Message}); }注意ReadDRegister方法内部完成全部 TCP 发送、接收、帧解析返回Resultint结构体。UI 更新用Control.Invoke保证线程安全——这是 WinForms 下最稳的写法比async/awaitSynchronizationContext更易懂、更少坑。3. 核心通信流程拆解从构造 FINS 帧到解析响应的完整闭环3.1 构造读 D 区指令帧10 字节头 10 字节命令的精确排布FINS 读命令帧分两段Header10 字节和 Command10 字节。以读D1001 个字为例完整帧为 20 字节字节位置值十六进制含义0-10x80 0x00ICF0x80请求帧、RSV0x00保留2-30x00 0x00GCT0x00网关跳数、DNA0x00目的网络地址4-50x00 0x00DA1/DA2目的节点地址通常为 06-70x00 0x00SNA0x00源网络地址、SA1/SA2源节点地址8-90x00 0x01SID0x01序列号可自增10-110x01 0x01命令码0x0101读内存块120x82区域码0x82 D 区13-160x00 0x00 0x00 0x64起始地址D100 0x64小端序排列17-180x00 0x01读取字数1190x00保留字节部分固件要求注意地址0x00000064是 D100 的绝对地址不是偏移量。欧姆龙手册中 D100 的地址描述为D100实际转换为 FINS 地址时需乘以 1D 区单位为字再转小端序。若读D100.0位则需用0x0103命令地址计算方式完全不同。3.2 发送与接收Socket 层的超时控制与粘包处理SendFinsCommand方法中Socket 创建与发送逻辑如下using (var client new TcpClient()) { client.Connect(plcIp, plcPort); client.Client.SendTimeout timeoutMs; client.Client.ReceiveTimeout timeoutMs; var sendBuffer BuildReadCommand(82, 100, 1); // D100 client.Client.Send(sendBuffer); // 接收响应FINS 响应帧最小为 12 字节Header 10 Status 2 var recvBuffer new byte[1024]; int received client.Client.Receive(recvBuffer, SocketFlags.None); if (received 12) throw new Exception(响应帧过短); return ParseResponse(recvBuffer, received); }这里的关键参数是SendTimeout和ReceiveTimeout。很多开发者忽略这点导致网络波动时Send()卡死。本项目设为 3000ms与App.config中的TimeoutMs一致。粘包处理FINS 协议本身无长度字段但欧姆龙 PLC 严格遵循“一问一答”每次Receive()只会收到一个完整响应帧实测最大 256 字节。因此无需复杂拆包逻辑直接Receive()一次即可。若需批量读取应循环发送多个独立请求而非拼接帧。3.3 响应帧解析从 12 字节状态码到真实数据的提取成功响应帧结构Header10 字节 Status2 字节 DataN 字节。以读 D100 成功为例响应帧前 12 字节为0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x01 0x00 0x00第 10-11 字节0x00 0x00是状态码0x0000表示成功第 12 字节起为数据0x?? ??2 字节D100 的值小端序。解析代码private Resultint ParseResponse(byte[] buffer, int length) { ushort status BitConverter.ToUInt16(buffer, 10); // 从第 10 字节开始取 2 字节 if (status ! 0) return new Resultint(false, $FINS 错误码: 0x{status:X4}); // 数据从第 12 字节开始2 字节整数 if (length 12) return new Resultint(false, 响应数据不足); ushort value BitConverter.ToUInt16(buffer, 12); return new Resultint(true, value); }提示若读取多字如 D100-D103 共 4 字响应帧中数据部分为连续 8 字节每个字 2 字节需用BitConverter.ToInt16(buffer, 12 i*2)循环解析。本项目ReadDRegister方法支持wordCount参数自动处理多字解析。4. 避坑指南欧姆龙 PLC FINS 通信的五个高频翻车点4.1 现象连接始终超时Wireshark 显示 SYN 包发出但无 ACK原因PLC 的 FINS 服务未启用或防火墙拦截 9600 端口。欧姆龙 CP 系列默认关闭 FINS需通过 CX-Programmer 或 Ladder Logic 设置FINS Enable ONNJ/NX 系列需在Controller Settings → Network Settings → FINS/IT Settings中启用。解决用telnet 192.168.1.10 9600测试端口连通性。若不通检查 PLC 网络配置确认FINS/IT功能已使能且 IP 地址与 PC 在同一网段。4.2 现象连接成功但返回状态码0x0001命令未实现原因命令码或区域码错误。常见错误是将 D 区区域码0x82误写为0x02或将 CIO 区0x30写成0x03。欧姆龙对区域码校验极严错一位即报0x0001。解决对照《FINS 指令参考手册》第 3 章“内存区域代码表”确认所用 PLC 型号支持的区域码。CP1E 的 D 区是0x82而 CJ2M 的 D 区是0x80不可混用。4.3 现象读取数据恒为 0或数值异常如 D100 读出0xFFFF原因地址字节序错误。FINS 要求地址为小端序Little-Endian但开发者常误用BitConverter.GetBytes(100)结果为0x64 0x00 0x00 0x00直接填充而正确应为0x00 0x00 0x00 0x644 字节地址。解决使用IPAddress.HostToNetworkOrder()转换int address 100; // D100 byte[] addrBytes BitConverter.GetBytes(IPAddress.HostToNetworkOrder(address)); // 此时 addrBytes {0x00, 0x00, 0x00, 0x64}符合 FINS 要求4.4 现象写入操作失败状态码0x0002访问拒绝原因PLC 处于MONITOR或RUN模式时部分区域如 CIO 区禁止写入。欧姆龙默认只允许在PROGRAM模式下写入 CIO 区D 区则需确认D Memory Write Enable设置。解决进入 PLC 设置菜单将运行模式切换为PROGRAM或在Memory Settings中启用对应区域的写入权限。生产环境建议只读关键区域写操作限定在调试阶段。4.5 现象多线程并发读写时偶发SocketException连接重置原因欧姆龙 PLC 的 FINS 服务为单线程处理同一时刻只接受一个连接。若多个Task.Run并发创建TcpClientPLC 可能拒绝后续连接。解决在FinsTcpClient层加锁或改用连接池本项目简化版采用单例TcpClient复用见Form1.cs中的_client字段。更优方案是引入SemaphoreSlim限制并发数private static readonly SemaphoreSlim _semaphore new SemaphoreSlim(1, 1); private async TaskResultint SafeReadD(int address) { await _semaphore.WaitAsync(); try { return await Task.Run(() ReadDRegister(address)); } finally { _semaphore.Release(); } }5. 生产级增强从单次读写到稳定轮询的工程化改造5.1 添加心跳保活与自动重连机制产线环境中网络抖动或 PLC 重启会导致连接中断。原项目SendFinsCommand是“一锤子买卖”需升级为带状态管理的客户端。我在某模拟项目 X 的部署中增加了FinsConnectionManager类public class FinsConnectionManager { private TcpClient _client; private readonly string _plcIp; private readonly int _plcPort; private Timer _heartbeatTimer; public FinsConnectionManager(string plcIp, int plcPort 9600) { _plcIp plcIp; _plcPort plcPort; Connect(); _heartbeatTimer new Timer(Heartbeat, null, TimeSpan.FromSeconds(30), TimeSpan.FromSeconds(30)); } private void Heartbeat(object state) { try { if (_client null || !_client.Connected) Connect(); else SendFinsCommand(new byte[] { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x01, 0x02, 0x01 }); // CPU 状态查询 } catch { /* 忽略心跳异常Connect() 会在下次触发 */ } } private void Connect() { _client?.Close(); _client new TcpClient(); _client.Connect(_plcIp, _plcPort); } }提示心跳命令用0x0201读 CPU 状态它不修改 PLC 数据仅验证连接有效性。30 秒间隔是平衡资源消耗与故障发现速度的经验值太短增加 PLC 负载太长影响恢复时效。5.2 实现寄存器缓存与变更通知避免 UI 频繁刷新直接轮询 D100 每秒 10 次UI 会疯狂闪烁。改进方案是引入RegisterCachepublic class RegisterCache { private readonly Dictionarystring, CacheEntry _cache new Dictionarystring, CacheEntry(); private readonly object _lock new object(); public void Update(string key, int newValue, int threshold 1) // 阈值变化超过 threshold 才触发通知 { lock (_lock) { if (!_cache.TryGetValue(key, out var entry)) { _cache[key] new CacheEntry { Value newValue, LastUpdate DateTime.Now }; OnValueChanged?.Invoke(key, newValue); return; } if (Math.Abs(newValue - entry.Value) threshold) { entry.Value newValue; entry.LastUpdate DateTime.Now; OnValueChanged?.Invoke(key, newValue); } } } }在Form1.cs中订阅OnValueChanged仅当 D100 值变化 ≥1 时才更新txtD100.Text。这大幅降低 UI 线程负担也减少无意义的Invoke调用。5.3 日志与诊断把“为什么连不上”变成可搜索的文本原项目无日志故障排查靠猜。我在Properties/Settings.settings中添加LogEnabled和LogLevel配置项并在SendFinsCommand中插入结构化日志if (Properties.Settings.Default.LogEnabled) { File.AppendAllText(fins_log.txt, ${DateTime.Now:HH:mm:ss.fff} [SEND] {BitConverter.ToString(sendBuffer)}\r\n); } // ... 执行发送 ... if (Properties.Settings.Default.LogEnabled) { File.AppendAllText(fins_log.txt, ${DateTime.Now:HH:mm:ss.fff} [RECV] {BitConverter.ToString(recvBuffer, 0, received)}\r\n); }日志文件按时间戳排序可快速定位是请求帧发错了还是 PLC 根本没回包或是回包状态码异常从那以后我每次部署新产线都强制走一遍telnet 日志开关 Wireshark三件套再没被半夜叫起来修“连不上”的 bug。希望帮到你。本文还有配套的精品资源点击获取