C#源码解析：欧姆龙NX1P通讯DEMO的CIP通讯实现

C#编写CIP通讯源码欧姆龙NX1P通讯DEMO一、概述本代码是基于C#语言开发的CIPCommon Industrial Protocol通讯Demo程序专门用于与欧姆龙NX1P2系列PLC进行工业通讯交互。程序采用.NET Framework 4.8框架开发通过TCP/IP协议实现与PLC的连接、会话管理、标签数据读写等核心功能提供了直观的Windows窗体操作界面支持单标签读写、多标签自动轮询、数据变化监控等工业场景常用功能适用于工业自动化控制系统中上位机与PLC的通讯开发参考。二、开发环境与技术栈一开发环境框架版本.NET Framework 4.8开发语言C#目标平台AnyCPU开发工具Visual Studio支持2017及以上版本对应MSBuild ToolsVersion 15.0二核心技术栈网络通讯TCP/IP Socket编程Stream类型Socket基于TCP协议工业协议CIP协议Common Industrial Protocol封装与解析界面开发Windows FormsWinForms多线程后台数据接收线程、定时器自动轮询线程数据结构字典Dictionary用于标签映射管理、队列Queue用于标签轮询调度三、项目结构与文件说明项目共包含15个文件核心文件按功能分类如下一配置文件文件名功能描述App.config应用程序配置文件指定目标框架为.NET Framework 4.8CIP_TEST.csproj项目配置文件定义编译选项、输出路径、引用集、文件包含等项目属性bin\Debug\CIP_TEST.exe.config编译输出后的配置文件与App.config内容一致二核心功能文件文件名功能描述CipHelp.csCIP协议核心处理类封装会话注册/注销、标签读写报文构造、接收数据解析等核心逻辑PublicHandle.cs公共枚举定义类包含CIP通讯状态码枚举如成功、无效命令、内存不足等Form1.cs主窗体逻辑类处理界面交互、Socket连接管理、线程控制、标签数据展示等Form1.Designer.cs主窗体设计文件定义界面控件布局、控件属性及事件绑定三辅助文件文件名功能描述Program.cs应用程序入口类启动主窗体Properties\AssemblyInfo.cs程序集信息文件包含程序集标题、版本、版权等元数据Properties\Resources.Designer.cs资源管理设计文件自动生成的资源访问代码Properties\Settings.Designer.cs配置管理设计文件自动生成的配置项访问代码obj\Debug目录下文件编译过程中生成的临时文件、程序集属性文件等不影响运行逻辑四、核心功能模块详解一CIP协议处理模块CipHelp.cs该类是整个通讯Demo的核心封装了CIP协议的底层实现主要功能包括会话管理、报文构造、数据解析三大块。1. 核心成员与数据结构事件定义SessionEvent会话注册成功后触发传递会话句柄信息TagValueExchangeEvent标签值变化时触发传递标签名称、类型、值等信息TagValueEvent标签值获取事件预留扩展字典映射TagFlag_TagValue标签标志与标签值的映射用于缓存标签当前值TagFlag_TagStr标签标志与标签名称的映射用于通过标志反向查找标签名TagStr_TagFlag标签名称与标签标志的映射用于通过标签名查找标志协议常量RegisterSession会话注册请求报文固定字节数组命令码0x65UnregisterSession会话注销请求报文动态填充会话句柄其他固定字段如服务标识、请求路径、超时时间等CIP协议固定参数2. 核心方法1会话管理相关Get_SessionHandle(byte[] data)解析PLC返回的会话注册响应提取会话句柄并验证状态码成功后触发SessionEvent事件。会话注册流程发送RegisterSession报文 → 接收PLC响应 → 解析会话句柄 → 缓存会话句柄用于后续通讯。2报文构造相关GetCipRSingle_Tag(string TAG)构造单个标签的读取请求报文功能根据标签名称生成符合CIP协议的读取请求字节数组流程标签名称UTF-8编码 → 补齐偶数字节长度 → 封装CIP协议头、服务标识、标签信息、请求路径等 → 组合完整报文包含会话句柄、发送方描述等GetCipWSingle_Tag(string TAG, bool B1)构造单个标签的写入请求报文BOOL类型功能根据标签名称和布尔值生成CIP协议写入请求字节数组差异相比读取报文增加写入类型0xc1表示BOOL、写入值0x01为置位0x00为复位字段3数据解析相关RevmsgHandle(byte[] Rev_Data)接收数据分发处理功能根据响应报文的命令码首字节分发处理逻辑分支命令码0x65会话注册响应→ 调用GetSessionHandle命令码0x6f标签数据响应→ 调用GetSingleTagValGet_SingleTagVal(byte[] data)解析标签数据响应报文流程1. 验证报文长度封装头长度数据长度是否匹配2. 验证会话句柄一致性防止非法响应3. 提取发送方描述标签标志4. 解析数据类型BOOL、Byte、int、long、real、string及对应值5. 对比缓存值若变化则触发TagValueExchangeEvent事件3. 支持的数据类型数据类型协议标识处理逻辑BOOL0x00c1解析为bool类型转换为True/False字符串Byte0x00d1直接读取字节值转换为十进制字符串int0x00c3解析2字节整型数据转换为十进制字符串long0x00c4解析4字节长整型数据转换为十进制字符串real0x00CA解析4字节浮点型数据BitConverter转换转换为字符串string0x00D0读取指定长度的ASCII编码字符串二界面交互模块Form1.cs Form1.Designer.cs主窗体提供了完整的操作界面包含连接参数配置、标签读写操作、数据展示等功能区域界面控件布局与逻辑处理紧密结合。1. 界面功能区域区域名称核心控件功能描述连接参数区文本框IP/端口、按钮连接/断开/注册会话配置PLC的IP地址默认192.168.250.1和端口默认44818管理TCP连接和CIP会话标签操作区文本框标签名称/值、按钮读取/添加/自动读取/置位/复位单标签读写、标签添加到轮询列表、批量自动轮询、BOOL类型标签置位/复位标签列表区ListBox已添加标签列表、按钮仅显示选中项展示已添加的标签支持选中单个标签单独监控日志展示区多行文本框显示标签值变化日志、操作日志如标签添加成功、时间戳2. 核心界面逻辑1连接与会话管理button1_Click连接创建TCP Socket连接指定IP和端口连接成功后启用断开和注册会话按钮button2_Click断开关闭TCP连接重置会话句柄恢复按钮状态button3_Click注册会话发送会话注册报文等待SessionEvent事件更新会话句柄显示2标签操作button4_Click读取当前标签构造指定标签的读取请求发送TCP报文等待响应后更新标签值文本框button5_Click添加当前标签将输入的标签名称添加到轮询字典和列表框避免重复添加button6_Click自动读取所有标签启动/停止自动轮询通过AutoRead标志控制定时器按队列顺序发送所有标签的读取请求button9_Click置位/复位构造BOOL类型标签的写入请求根据按钮状态发送置位true或复位false指令3数据展示与监控CipHelpTagValueExchangeEvent标签值变化事件处理根据selectswitch标志决定显示所有标签变化或仅显示选中标签变化listBox1_SelectedIndexChanged选中标签列表项时记录当前选中标签名称button7Click仅显示选中项切换selectswitch标志状态控制日志显示范围三多线程与异步处理模块为避免界面卡顿程序采用多线程设计核心线程包括1. 数据接收线程Fun方法后台线程IsBackground true程序启动时自动启动循环监听TCP Socket的接收缓冲区收到数据后调用CipHelp.RevmsgHandle解析异常捕获机制防止接收数据时的Socket异常导致线程终止2. 自动轮询定时器tm1定时器间隔1ms可调整触发Tm1_Elapsed事件当AutoRead为true时按队列顺序发送标签读取请求队列空时重新填充所有已添加标签避免并发冲突通过队列实现有序发送五、通讯流程说明一完整通讯流程以读取标签为例配置PLC IP和端口默认192.168.250.1:44818点击连接按钮建立TCP连接点击注册会话按钮发送CIP会话注册请求PLC返回会话响应程序解析会话句柄并显示输入标签名称如TAG1点击读取当前标签程序构造CIP读取报文包含会话句柄、标签信息通过TCP发送报文到PLCPLC返回标签数据响应程序解析响应报文提取标签值触发标签值变化事件更新界面显示和日志二异常处理机制连接异常TCP连接失败时弹出异常信息如IP错误、端口占用会话异常会话注册失败时显示错误代码基于State_Code枚举数据异常报文长度不匹配、会话句柄不一致时直接丢弃无效数据线程异常定时器和接收线程均包含异常捕获防止程序崩溃六、功能特点与适用场景一功能特点协议完整实现CIP协议核心功能支持会话管理、单标签读写多类型支持兼容BOOL、Byte、int、long、real、string等常用数据类型界面友好操作流程清晰日志实时展示支持标签单独监控稳定可靠多线程设计避免界面卡顿异常处理保障程序稳定性易于扩展核心协议逻辑与界面分离可扩展多标签批量读写、更多数据类型支持等功能二适用场景欧姆龙NX1P2 PLC的上位机通讯开发参考CIP协议学习与验证包含完整的报文构造与解析逻辑工业自动化控制系统中简单的PLC数据采集与控制场景基于.NET Framework的工业通讯程序快速开发模板七、使用说明环境准备安装.NET Framework 4.8运行时确保上位机与PLC网络互通配置参数在连接参数区域输入PLC的IP地址和端口默认44818建立连接点击连接按钮连接成功后点击注册会话获取会话句柄标签操作- 单标签读取输入标签名称点击读取当前标签- 批量监控输入标签名称点击添加当前标签重复添加多个标签后点击自动读取所有标签- BOOL标签控制输入BOOL类型标签名称点击置位或复位日志查看在日志展示区查看标签值变化记录可通过仅显示选中项聚焦特定标签八、扩展建议增加多标签批量读写功能优化报文构造逻辑支持单次请求读写多个标签提升通讯效率完善数据类型支持扩展数组类型、结构体类型等复杂数据类型的解析增加异常重试机制针对网络抖动增加TCP重连、报文重发功能日志持久化将操作日志和标签值变化日志保存到本地文件便于追溯配置保存保存PLC连接参数、常用标签列表等配置下次启动自动加载通讯状态监控增加TCP连接状态、会话状态的实时监控与提示如红色表示断开绿色表示连接正常C#编写CIP通讯源码欧姆龙NX1P通讯DEMO