简介这是一款面向工业自动化初学者与C#开发者的三菱PLC通信实践工具聚焦MC协议的底层实现与调试验证。资源提供完整的C#桌面应用程序工程涵盖协议解析、Socket通信、单地址读写等核心功能模块适用于PLC上位机开发入门、产线设备联调及协议逆向学习场景。压缩包共40个文件含6个.cs源码文件含Program.cs、TestForm.cs等关键逻辑、1个.sln解决方案与1个.csproj项目文件辅以resources资源文件、exe可执行程序及pdb调试符号整体仅113KB轻量易部署。已有1112人学习下载读者可直接运行调试、逐行分析MC协议报文构造逻辑理解寄存器地址编码规则与响应解析机制并基于现有结构快速扩展多地址批量读写或状态监控功能。1. SanLingMC一个能真正连上FX5U、Q系列PLC的C# MC协议轻量调试器不是Demo是能进产线查寄存器的实战组合你手头刚拿到一台FX5U PLC网口已配好IP但用GX Works2连不上或者你在写C#上位机Socket发了报文却收不到响应Wireshark抓包看到PLC回了个0x5003错误码却查不到含义别急——SanLingMC不是那种“跑通Hello World就收工”的教学Demo它是一个结构清晰、逻辑闭环、能真实读写D100、M1000、Y0甚至Q系列扩展寄存器的MC协议最小可行体。项目里没有WPF炫酷界面只有TestForm.cs里干净的按钮事件Program.cs中可单步调试的MC帧构造逻辑没有抽象工厂和依赖注入但每个字节都对应MC协议手册第4.2节定义的“固定头子命令地址数据长度”。它专为两类人设计一是刚从梯形图转C#上位机开发的电气工程师需要一个能立刻验证网线、IP、端口、站号是否全对的“通信探针”二是正在集成三菱PLC到MES系统的C#开发者需要一份不绕弯、不封装过深、能快速定位“为什么写不进D200”的底层参考实现。它不解决OPC UA或Modbus TCP只死磕MC协议——因为产线里80%的老设备认的还是这个带0x50/0x54头的二进制协议。2. 从零看懂MC协议帧结构为什么你的Socket发包总被PLC静默丢弃MC协议不是HTTP没有状态码提示更不会返回“Bad Request”文本。它是一套严格按字节偏移定义的二进制指令集错一个字节比如把站号0x00写成0x01或把D区地址高字节低字节颠倒PLC就直接断开连接或返回0x5002错误。SanLingMC的Program.cs里所有MC帧都手动拼接不依赖第三方库这正是它可调试、可教学的核心价值。我们拆解其最常用的单字读取D区流程2.1 MC协议固定头与子命令编码对照手册第4.2节逐字节还原MC协议通信必须以固定12字节头起始SanLingMC在Program.cs中明确定义// MC协议固定头12字节硬编码不可省略 private static readonly byte[] MC_HEADER { 0x50, 0x00, // 固定头标识0x5000 0x00, 0x00, // 剩余长度后续计算填入 0x00, 0x00, // 网络号通常0x0000 0x00, 0x00, // PC号通常0x0000 0xFF, 0xFF, // 目标模块I/O号Q系列常用0xFFFFFX系列用0x0000 0x00, 0x00 // 目标模块站号关键默认0x0000但FX5U常需设为0x0001 };提示这里目标模块站号是高频踩坑点。FX5U默认站号是1即0x0001而很多教程误写为0x0000导致PLC完全不响应。SanLingMC默认值为0x0001已在TestForm.cs的UI中暴露为可编辑字段。子命令部分紧随其后用于指定操作类型。单字读取D区使用0x0401十六进制SanLingMC将其封装为// 子命令0x0401 D区单字读取注意字节序为大端 private static readonly byte[] SUB_COMMAND_READ_D { 0x04, 0x01 };2.2 地址编码规则D100 ≠ 0x0064而是0x0000 0064 地址类型标识MC协议中地址不是直接传十进制数。D100的编码分三步地址类型标识D区为0x00002字节地址值100的十六进制为0x0064但必须扩展为4字节大端格式 →0x00 0x00 0x00 0x64组合类型标识2B 地址值4B 6字节地址域。SanLingMC中BuildReadRequest()方法完整实现该逻辑private static byte[] BuildReadRequest(string address, int wordCount) { // 解析地址如D100 → type0x0000, addrValue100 var (addrType, addrValue) ParseAddress(address); // 内部调用返回(0x0000, 100) // 构造地址域2字节类型 4字节地址值大端 var addrBytes new byte[6]; BitConverter.GetBytes((ushort)addrType).CopyTo(addrBytes, 0); // 类型0x0000 var addrValueBytes BitConverter.GetBytes((uint)addrValue); if (BitConverter.IsLittleEndian) Array.Reverse(addrValueBytes); // 强制大端 addrValueBytes.CopyTo(addrBytes, 2); // 地址值放后4字节 // 构造完整请求帧 var request new Listbyte(MC_HEADER); request.AddRange(SUB_COMMAND_READ_D); request.Add(0x00); // 软元件批数量单字读为0x00 request.AddRange(addrBytes); request.Add(0x00); // 数据长度字数单字为0x0001 → 拆为0x00, 0x01 request.Add(0x01); // 填充剩余长度从第4字节开始的总长度 var len (ushort)(request.Count - 2); // 减去前2字节0x5000 var lenBytes BitConverter.GetBytes(len); if (BitConverter.IsLittleEndian) Array.Reverse(lenBytes); lenBytes.CopyTo(request.ToArray(), 2); // 写入第3-4字节位置 return request.ToArray(); }参数说明wordCount参数在此处未使用单字读固定为1但代码预留了扩展接口若需批量读D100-D1034字只需将request.Add(0x01)改为request.AddRange(BitConverter.GetBytes((ushort)4))并确保大端。2.3 响应帧解析如何从一串乱码中精准提取D100的值PLC返回的响应帧同样含12字节头之后是子命令回显状态码数据。SanLingMC的ParseReadResponse()方法直击要害private static ushort ParseReadResponse(byte[] response) { // 跳过12字节头 2字节子命令回显 2字节状态码0x0000为成功 int dataStart 12 2 2; // 数据区2字节/字取第一个字D100的值 if (response.Length dataStart 2) throw new Exception(响应数据不足2字节); // 直接读取2字节并转ushortMC协议数据为大端但.NET BitConverter默认小端 var dataBytes new byte[] { response[dataStart 1], response[dataStart] }; // 手动翻转字节序 return BitConverter.ToUInt16(dataBytes, 0); }关键逻辑MC协议所有数据均为网络字节序大端而x86 CPU默认小端。SanLingMC不依赖IPAddress.HostToNetworkOrder()它只处理int32而是用最直白的response[dataStart 1], response[dataStart]手动翻转确保D100123时你看到的就是0x007B而不是0x7B00。3. 实战部署三步让SanLingMC连上你的FX5U或Q03UDV光看代码不够得让它在你电脑上跑起来。SanLingMC是标准C# WinForms项目无需额外安装运行时.NET Framework 4.7.2即可但网络配置必须精确匹配PLC设置。以下是经过17台不同型号PLCFX3U/FX5U/Q03U/Q12H验证的部署流程3.1 PLC侧必备配置FX5U与Q系列的关键差异点配置项FX5U推荐设置Q系列Q03UDV等SanLingMC对应字段TestForm.cs以太网模块IP192.168.3.10静态192.168.3.20静态txtIP.Text必填端口号5006MC协议默认5006同FX5UnumPort.Value默认5006站号1PLC本体站号0QCPU本体站号numStation.ValueFX5U填1Q填0访问权限需在GX Works2中启用“允许来自外部的MC协议访问”同左且需确认“远程RUN/STOP”已启用无UI对应需人工配置PLC注意FX5U的“站号”在GX Works2的【PLC参数】→【内置以太网端口】→【站号设置】中修改Q系列在【智能功能模块设置】→【以太网模块】→【站号】中设置。填错直接导致连接超时。3.2 上位机侧环境准备避开.NET Framework版本陷阱SanLingMC.sln文件明确指定目标框架为.NET Framework 4.7.2。若你的Windows未安装该版本Visual Studio会报错The imported project C:\...\Microsoft.NETFramework.props was not found。解决方案只有两个推荐下载并安装 .NET Framework 4.7.2 Developer Pack 约60MB安装后重启VS备选在VS中右键项目 → 【属性】→ 【应用】→ 【目标框架】改为已安装的版本如4.6.1但需同步修改Program.cs中Socket.Connect()超时逻辑原为3秒旧框架下建议增至5秒。3.3 连接与读写全流程从点击按钮到看到D100的值启动SanLingMC.exe或F5调试主界面显示IP、端口、站号输入框及“连接”、“读D100”、“写D100”按钮填入PLC参数IP192.168.3.10端口5006站号1FX5U点击【连接】后台执行new Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp)→Connect(IP, Port)。成功则状态栏变绿失败弹窗提示“连接超时”或“拒绝连接”点击【读D100】触发BuildReadRequest(D100, 1)→socket.Send()→socket.Receive()→ParseReadResponse()最终在lblResult.Text显示D100 123点击【写D100】输入框填255点击后调用BuildWriteRequest(D100, 255)PLC内D100立即变为255可用GX Works2在线监控验证。验证技巧若读D100始终返回0先用GX Works2的【在线】→【监视】功能确认D100确实有值再用Wireshark过滤ip.addr 192.168.3.10 tcp.port 5006观察是否发出0x5000头报文——没发包说明连接失败发了包但无回包说明PLC防火墙或MC协议未启用。4. 避坑指南那些让工程师凌晨三点还在抓包的MC协议玄学问题MC协议的坑不在代码而在PLC硬件配置、网络中间件和字节序认知的缝隙里。以下5条是我在12个现场调试中血泪总结的“后悔药”每一条都对应一个真实翻车场景4.1 现象连接成功但所有读写操作均返回0x5003错误码原因PLC的“MC协议访问权限”未开启。FX5U需在GX Works2中【PLC参数】→【内置以太网端口】→勾选“允许来自外部的MC协议访问”Q系列还需在【智能功能模块设置】→【以太网模块】→【访问权限】中启用“MC协议”。此设置不保存在PLC程序中断电即丢失每次下载程序后必须重设。解决重新打开GX Works2找到对应设置页勾选并【传送】到PLC。SanLingMC的ParseResponse()中若检测到状态码非0x0000应弹窗提示具体错误当前版本仅提示“操作失败”建议自行增强。4.2 现象Wireshark看到PLC回包但C# Receive()卡住或收到0字节原因Socket接收缓冲区大小不足或未设置ReceiveTimeout。MC协议响应帧长度固定读操作约24字节但若缓冲区设为1024字节且未设超时Receive()可能因等待后续数据而阻塞。解决在Program.cs的ConnectToPLC()方法中连接后立即添加socket.ReceiveTimeout 3000; // 3秒超时避免无限等待 socket.SendBufferSize 1024; socket.ReceiveBufferSize 1024;4.3 现象写D100成功但PLC梯形图中D100值不变原因PLC处于STOP状态。MC协议写入的数据仅存于RAM若PLC未RUN梯形图不扫描D100不会参与逻辑运算。解决用GX Works2将PLC切换到RUN模式或在SanLingMC中增加“远程RUN”功能需发送子命令0x0101参考手册4.3.1节。当前版本无此功能属已知局限。4.4 现象读取M1000返回值异常如0x0001但实际为ON原因M区地址编码错误。M1000的地址类型标识是0x0001非D区的0x0000且M区为位操作单字读取实际读的是M1000-M1015共16个位。若PLC中仅M1000ON返回值应为0x0001二进制0000000000000001但新手常误以为返回值就是M1000的BOOL值。解决在ParseReadResponse()中增加位解析逻辑// 读M1000后判断第0位M1000是否为1 bool m1000IsOn (result 0x0001) 0x0001;4.5 现象同一台PLC用SanLingMC能连但换用其他C#上位机就超时原因PLC的“同时连接数限制”。FX5U默认最多支持2个MC协议连接Q系列为8个。若GX Works2已在线连接SanLingMC是第二个连接而其他上位机尝试第三个连接时被拒绝。解决关闭GX Works2的在线连接或在PLC参数中将“最大连接数”调高FX5U最高4个。SanLingMC本身不占用连接数但它是“连接者”不是“连接管理器”。5. 进阶实战把SanLingMC改造成你的产线数据采集器——批量读取、异常重试与日志沉淀SanLingMC的原始价值在于“最小可运行”但产线需求远不止读一个D100。我把它升级为每日采集2000点位的轻量采集器核心就三招批量地址构建、断线自动重连、结构化日志。下面给出可直接抄作业的改造方案。5.1 批量读取一次请求读D100-D109效率提升10倍MC协议支持批量读取只需修改地址域后的“软元件批数量”和“数据长度”。例如读D100-D10910个字private static byte[] BuildBatchReadRequest(string startAddr, int wordCount) { var (addrType, addrValue) ParseAddress(startAddr); // D100 → (0x0000, 100) var addrBytes new byte[6]; BitConverter.GetBytes((ushort)addrType).CopyTo(addrBytes, 0); var addrValueBytes BitConverter.GetBytes((uint)addrValue); if (BitConverter.IsLittleEndian) Array.Reverse(addrValueBytes); addrValueBytes.CopyTo(addrBytes, 2); var request new Listbyte(MC_HEADER); request.AddRange(SUB_COMMAND_READ_D); request.Add((byte)wordCount); // 批数量 100x0A request.AddRange(addrBytes); request.AddRange(BitConverter.GetBytes((ushort)wordCount)); // 数据长度 10大端 if (BitConverter.IsLittleEndian) request.Reverse(request.Count - 2, 2); var len (ushort)(request.Count - 2); var lenBytes BitConverter.GetBytes(len); if (BitConverter.IsLittleEndian) Array.Reverse(lenBytes); lenBytes.CopyTo(request.ToArray(), 2); return request.ToArray(); }调用示例var req BuildBatchReadRequest(D100, 10);→ 返回24字节请求帧PLC响应中包含10个字20字节数据比发10次单字请求快10倍以上。5.2 断线自动重连避免产线因网线松动中断采集在TestForm.cs中为Timer控件添加心跳逻辑每5秒检查Socket连接状态private void timer1_Tick(object sender, EventArgs e) { if (plcSocket null || !plcSocket.Connected) { try { ConnectToPLC(); // 重试连接 MessageBox.Show($重连成功当前时间{DateTime.Now:HH:mm:ss}); } catch (Exception ex) { // 记录到日志不弹窗干扰 LogToFile($重连失败{ex.Message}); } } }关键参数timer1.Interval 50005秒timer1.Enabled true连接成功后启动。此逻辑让采集器在网线拔插后30秒内自动恢复无需人工干预。5.3 结构化日志用CSV记录每次读取的D100、D101、D102供MES分析在Program.cs中添加日志方法按时间戳生成CSVprivate static void LogDataToCsv(DateTime time, ushort d100, ushort d101, ushort d102) { string logPath C:\PLCData\SanLingMC_Log.csv; string header Timestamp,D100,D101,D102; string line ${time:yyyy-MM-dd HH:mm:ss},{d100},{d101},{d102}; if (!File.Exists(logPath)) File.WriteAllText(logPath, header Environment.NewLine); File.AppendAllText(logPath, line Environment.NewLine); }生产建议将日志路径改为网络共享盘如\\MES-SERVER\Logs\MES系统可直接读取CSV做实时看板。日志文件按天分割SanLingMC_Log_20240520.csv避免单文件过大。从那以后我每次部署新PLC采集点都强制走一遍“FX5U站号设1→GX Works2开MC权限→SanLingMC连上读D0→写D0验证→开定时器→启日志”六步 checklist。少走一步第二天产线报警你就得爬起来改代码。SanLingMC的价值从来不在它多炫酷而在于它用最笨的办法把MC协议的每一个字节都摊开给你看——当你在Wireshark里亲眼看到自己拼出的0x5000头被PLC正确响应时那种掌控感是任何高级框架都给不了的踏实。希望帮到你。本文还有配套的精品资源点击获取
