“师傅我想做个上位机读PLC的数据但是完全不知道从哪下手……”刚入行的小徒弟抱着电脑蹲在我旁边屏幕上是一个空白的WinForm窗体。我看了看他想起了10年前的自己。那时候我也是这样对着PLC和串口线发呆觉得上位机开发高深莫测。“别慌Modbus TCP是工业界的‘普通话’最简单也最通用。今天我带你从新建项目到读写PLC数据一步到位看完你就能跑通。”一、准备工作先把家伙事儿备齐在写代码之前我们需要准备几样东西开发环境Visual Studio 2022社区版就行免费安装时选上“.NET 桌面开发”工作负载。PLC或仿真器如果你有真实的PLC比如西门子S7-200 SMART、三菱FX5U、或者国产台达/汇川确保它支持Modbus TCP并设置好IP地址。如果没有PLC没关系我们用Modbus Slave软件来仿真一个PLC这是新手入门的神器。通信库别自己写Socket了我们用成熟的开源库——HslCommunication。它封装好了所有Modbus逻辑几行代码就能搞定。二、快速上手5分钟写个“Hello World”我们先不搞复杂的界面先写个控制台程序把数据读出来再说建立信心最重要。第一步新建项目打开Visual Studio 2022新建一个“控制台应用(控制台应用)”框架选.NET 8 (长期支持)项目名随便起比如ModbusTcpDemo。第二步安装通信库右键点击项目选择“管理NuGet程序包”搜索HslCommunication安装最新稳定版。第三步编写核心代码把Program.cs里的代码替换成下面的我加了详细的注释usingHslCommunication;usingHslCommunication.ModBus;usingSystem;namespaceModbusTcpDemo{classProgram{staticvoidMain(string[]args){Console.WriteLine( C# Modbus TCP 新手入门Demo );// 1. 实例化Modbus TCP客户端对象// 参数1PLC的IP地址如果是Modbus Slave仿真就是你电脑的IP// 参数2Modbus TCP端口号默认502ModbusTcpNetmodbusClientnewModbusTcpNet(192.168.1.100,502);// 可选设置站号Slave ID默认是1如果你的PLC是其他站号改这里// modbusClient.Station 2;// 2. 连接PLCConsole.WriteLine(正在连接 PLC...);OperateResultconnectResultmodbusClient.ConnectServer();if(connectResult.IsSuccess){Console.WriteLine(✅ PLC连接成功);Console.WriteLine();// 核心功能演示 // 示例1读取保持寄存器 (Hold Register, 功能码0x03)// 这是最常用的功能PLC里的参数、数据通常存在这里// 参数1起始地址比如从地址100开始读// 参数2读取长度比如读2个寄存器Console.WriteLine(--- 示例1读取保持寄存器 D100 开始的2个数据 ---);OperateResultshort[]readResultmodbusClient.ReadInt16(100,2);if(readResult.IsSuccess){Console.WriteLine($读取成功D100{readResult.Content[0]}, D101{readResult.Content[1]});}else{Console.WriteLine($❌ 读取失败{readResult.Message});}Console.WriteLine();// 示例2写入单个保持寄存器// 参数1写入地址// 参数2写入的值Console.WriteLine(--- 示例2向 D200 写入数据 1234 ---);OperateResultwriteResultmodbusClient.Write(200,(short)1234);if(writeResult.IsSuccess){Console.WriteLine(✅ 写入成功你可以用PLC编程软件或Modbus Slave验证一下。);}else{Console.WriteLine($❌ 写入失败{writeResult.Message});}Console.WriteLine();// 示例3读取线圈 (Coil, 功能码0x01)// 也就是PLC的输出点比如M0.0, Y0之类的Console.WriteLine(--- 示例3读取线圈 M0 开始的5个状态 ---);OperateResultbool[]readCoilResultmodbusClient.ReadCoil(0,5);if(readCoilResult.IsSuccess){Console.WriteLine($读取成功状态{string.Join(, ,readCoilResult.Content)});}Console.WriteLine();Console.WriteLine(按任意键退出并断开连接...);Console.ReadKey();// 3. 断开连接modbusClient.ConnectClose();Console.WriteLine(已断开连接。);}else{Console.WriteLine($❌ PLC连接失败{connectResult.Message});Console.WriteLine(请检查1. IP地址是否正确2. 网线是否插好3. 防火墙是否关闭。);Console.ReadKey();}}}}第四步运行测试如果你用的是Modbus Slave打开Modbus Slave设置好Connection连接方式选Modbus TCP/IPSetup里定义好Hold Register保持寄存器。把代码里的IP地址改成你电脑的IP比如127.0.0.1。如果你用的是真实PLC确保电脑和PLC在同一个网段能Ping通。把代码里的IP改成PLC的IP。点击“启动”按钮如果一切顺利你就能看到控制台里打印出读取的数据了三、进阶做个简单的WinForm界面控制台虽然能跑但不够直观。我们来做个最简单的WinForm界面有按钮有文本框像个真正的上位机。界面设计拖拽几个控件到窗体上两个TextBox用来输入IP地址和端口。两个Button一个叫“连接”一个叫“读取/写入”。几个Label用来显示状态和数据。核心代码逻辑usingHslCommunication;usingHslCommunication.ModBus;usingSystem;usingSystem.Windows.Forms;namespaceWinFormsModbusDemo{publicpartialclassForm1:Form{// 把Modbus客户端对象定义成全局的方便各个按钮调用privateModbusTcpNet_modbusClient;publicForm1(){InitializeComponent();}// 连接按钮点击事件privatevoidBtn_Connect_Click(objectsender,EventArgse){try{// 实例化对象_modbusClientnewModbusTcpNet(txt_Ip.Text,int.Parse(txt_Port.Text));// 连接OperateResultresult_modbusClient.ConnectServer();if(result.IsSuccess){lbl_Status.Text✅ 已连接;lbl_Status.ForeColorSystem.Drawing.Color.Green;Btn_Connect.Enabledfalse;Btn_ReadWrite.Enabledtrue;}else{MessageBox.Show($连接失败{result.Message});}}catch(Exceptionex){MessageBox.Show($出错{ex.Message});}}// 读取按钮点击事件privatevoidBtn_ReadWrite_Click(objectsender,EventArgse){if(_modbusClientnull||!_modbusClient.IsConnected)return;// 简单演示读取地址100的数据OperateResultshortresult_modbusClient.ReadInt16(100);if(result.IsSuccess){txt_Data.Textresult.Content.ToString();}else{MessageBox.Show($读取失败{result.Message});}}// 窗体关闭时断开连接privatevoidForm1_FormClosing(objectsender,FormClosingEventArgse){_modbusClient?.ConnectClose();}}}四、新手避坑指南这几个坑我帮你踩过了IP地址和端口确保电脑和PLC在同一网段能Ping通。Modbus TCP默认端口是502别写错。如果连接失败先试试关闭电脑防火墙。地址的问题功能码对应关系ReadCoil- 读线圈 (0x01)ReadDiscrete- 读离散输入 (0x02)ReadInt16- 读保持寄存器 (0x03)ReadInputRegister- 读输入寄存器 (0x04)地址是从0开始还是从1开始HslCommunication默认是从0开始的如果你PLC里的地址是D100直接写100就行不用减1。数据类型的问题PLC里的寄存器通常是16位的short/Int16。如果你要读32位的整数int/Int32或者浮点数float需要读两个连续的寄存器然后拼接起来。HslCommunication提供了ReadInt32和ReadFloat方法直接用就行不用自己拼。不要在界面线程里做耗时操作如果是简单的读一两个寄存器上面的代码没问题。如果要循环采集大量数据别直接写在按钮点击事件里会导致界面卡死。要用BackgroundWorker或者Task多线程。五、下一步该学什么恭喜你已经入门了如果你想继续深入可以研究这几个方向MVVM模式别把代码都写在Form.cs里学学WPF和MVVM让代码更整洁。异常处理和日志工业现场环境复杂要加try-catch还要用Serilog之类的库记录日志方便排查问题。其他协议比如西门子的S7协议、欧姆龙的FINS协议原理都差不多一通百通。数据存储读出来的数据不能只显示在界面上要存到数据库里比如SQLite、SQL Server。结尾“怎么样是不是没想象中那么难”我拍了拍小徒弟的肩膀。他看着屏幕上跳动的数据兴奋地点了点头“原来如此我这就去试试写个批量采集的功能”看着他的背影我想起了一句话“工控这行难的从来不是写代码而是解决现场的实际问题。”但不管怎样先把这第一步迈出去后面的路就好走了。