简介本资源是一套基于C#实现串口与三菱PLC通信的完整工程实践方案面向工业自动化领域的初/中级开发者、自控工程师及高校机电类专业学生解决PLC底层数据交互中单点/批量布尔量、Word/Dword数值读写、心跳监测与多线程稳定通信等核心问题。压缩包共49个文件含12个核心C#源码文件如MitsubshiPLC.cs、SerialPortClass.cs、frmMain.cs等、3个可执行程序exe用于快速验证、3个配置文件config支持串口参数灵活设定以及pdb调试符号、resx本地化资源等配套文件整体仅184KB轻量易部署。已有2155人学习下载代码结构清晰分层明确上位机界面DebugClass、PLC协议封装MitsubshiPLCSerialPort、串口基础类SerialPortClass三大模块解耦良好附带完整VS解决方案sln与项目配置开箱即可编译运行特别适合理解工业通信协议封装逻辑与多线程串口管理实战。1. C#串口读写三菱PLC不是发AT指令而是和FX/Q系列“说协议话”你手头有一台FX3U或Q03UDE PLC串口RS-232/485连着工控机想用C#程序实时读取M100状态、批量读M0~M31、写入D100的温度值、监控D1000心跳寄存器——但试了SerialPort.Write()发一串十六进制字节PLC毫无反应串口调试助手收不到回包Wireshark抓不到有效帧。这不是串口没通是根本没“对上频道”三菱PLC串口通信不认裸数据必须走MC协议也称QnA兼容3E帧格式它是一套带起始符、站号、命令码、地址偏移、数据长度、校验和的结构化报文。本方案不依赖第三方DLL或商业库纯C#实现协议组包/解包超时重传心跳保活已稳定运行于某高校自动化产线Demo中支持FX1S/3U/5U、Q/L系列需确认PLC串口模式设为“协议”而非“ASCII”。适合需要轻量集成、拒绝黑盒驱动、对通信时序有控制权的现场工程师与设备上位机开发者。2. 搭建通信基础从物理接线到MC协议帧结构解析2.1 硬件连接与PLC端关键设置90%翻车始于这一步PLC串口通信失败70%源于物理层或PLC参数错配。务必按以下顺序逐项确认接线方式FX系列如FX3U使用SC-09编程电缆内置MAX232电平转换DB9公头接PCRJ45端接PLC编程口若用USB转RS-232适配器必须选CH340/FTDI芯片且支持RTS/CTS硬件流控劣质PL2303常丢帧。Q系列如Q03UDE需专用串口模块QJ71C24N-R4其RS-422/485端子对应接线TX→PC RXRX→PC TXGND共地RS-485需加120Ω终端电阻。PLC参数设置以GX Works2为例注意必须在PLC处于STOP状态时修改RUN状态下修改无效进入【在线】→【PLC参数设置】→【串行通信设置】通信方式协议MC Protocol❌不能选“Modbus RTU”或“ASCII”波特率与C#代码中SerialPort.BaudRate严格一致常用9600/19200/38400数据位7位MC协议固定停止位1位校验位偶校验Even站号设置为1~32C#代码中StationNumber需匹配默认1验证通路用三菱官方软件GX Developer或GX Works2通过同一串口尝试在线连接PLC。若软件能读写软元件则证明硬件与PLC设置正确若失败先解决此步再进C#编码。2.2 MC协议3E帧结构为什么你的0x54 0x00发出去PLC不理你MC协议QnA兼容3E帧是二进制报文非ASCII字符串。一个典型读M100的请求帧长15字节结构如下以站号1、读M100为例字节位置值十六进制含义说明00x54固定起始符STX10x00网络号通常020xFFPLC号通常FF30x03单元号CPU单元0340x00站号此处为1 →0x00 0x01小端序50x01——60x04请求0x04读 /0x14写70x00请求子命令读位元件00读字元件0180x00软元件类型高位M0x00D0x00X0x00Y0x0090x00软元件类型低位M0x00D0x00X0x00Y0x00100x00地址高位M100 → 100 0x0064 → 小端序0x64 0x00110x64——120x00数据长度高位读1个bit →0x0001→ 小端0x01 0x00130x01——140xXX异或校验和字节0~13异或结果关键点所有地址、长度均用小端序Little-Endian表示M100不是0x00000064而是0x64 0x002字节D100是0x64 0x002字节但D1000是0xE8 0x031000 0x03E8。校验和 字节0 XOR 字节1 XOR ... XOR 字节13不包含起始符0x54本身部分文档误写含STX实测不含。读位元件M/X/Y时子命令0x00读字元件D/W时子命令0x01写操作同理但命令码为0x14。2.3 C#串口初始化超时与缓冲区不是默认值就够用public class MitsubishiPlcSerial { private SerialPort _serial; private readonly int _stationNumber 1; // 站号需与PLC设置一致 private readonly int _timeoutMs 1000; // 单次读超时非总超时 public void Initialize(string portName, int baudRate) { _serial new SerialPort { PortName portName, BaudRate baudRate, DataBits 7, // MC协议强制7位 StopBits StopBits.One, Parity Parity.Even, // 强制偶校验 ReadTimeout _timeoutMs, WriteTimeout _timeoutMs, // 关键禁用DTR/RTS避免PLC误判为断开 DtrEnable false, RtsEnable false }; // 清空缓冲区防止历史垃圾数据干扰 try { _serial.Open(); _serial.DiscardInBuffer(); _serial.DiscardOutBuffer(); } catch (UnauthorizedAccessException ex) { throw new InvalidOperationException($串口 {portName} 被占用或权限不足{ex.Message}); } catch (IOException ex) { throw new InvalidOperationException($串口 {portName} 打开失败{ex.Message}); } } }为什么关DTR/RTS某些PLC尤其老型号FX1S将DTR信号作为“通信使能”若C#开启DTR而PLC未配置响应会导致PLC拒绝应答。实测关闭后通信成功率从30%升至100%。ReadTimeout设为1000ms的依据一次MC协议读请求应答正常耗时200ms9600bps下15字节发送约15msPLC处理50ms回包200ms。设1000ms留足余量避免网络抖动误判若频繁超时优先查PLC站号或波特率是否错配而非调大超时。DiscardInBuffer()必须在Open()后立即执行串口打开瞬间可能残留上次通信的残帧不清空会导致后续Read()读到乱码解包失败。3. 实现核心读写逻辑从单个Bool到批量Word的完整封装3.1 组包函数把“读M100”翻译成15字节二进制帧/// summary /// 构建MC协议读位元件请求帧M/X/Y /// /summary /// param nameaddress软元件地址如100表示M100/param /// param namecount读取点数1~8192受限于PLC型号/param /// returns完整请求字节数组/returns private byte[] BuildReadBitRequest(int address, int count) { // 固定头部STX 网络号 PLC号 单元号 站号2字节小端 var frame new Listbyte { 0x54, 0x00, 0xFF, 0x03 }; // 站号小端 frame.AddRange(BitConverter.GetBytes((ushort)_stationNumber).Take(2)); // 命令读0x04子命令0x00位元件 frame.AddRange(new byte[] { 0x04, 0x00 }); // 软元件类型M0x0000X0x0000Y0x0000高位低位 frame.AddRange(new byte[] { 0x00, 0x00 }); // 地址小端2字节M100 → 100 → 0x0064 → [0x64, 0x00] frame.AddRange(BitConverter.GetBytes((ushort)address).Take(2)); // 长度小端2字节读1点 → 0x0001 → [0x01, 0x00] frame.AddRange(BitConverter.GetBytes((ushort)count).Take(2)); // 计算校验和字节0~倒数第二字节异或不含STX含实测含0x54 // 注三菱官方文档未明确但抓包验证校验和 0x54 XOR 0x00 XOR ... XOR 最后一个数据字节 byte checksum 0; for (int i 0; i frame.Count; i) { checksum ^ frame[i]; } frame.Add(checksum); return frame.ToArray(); } // 示例读M100单个点 var request BuildReadBitRequest(100, 1); // 输出15字节数组 // request[0]0x54, request[10]0x64, request[11]0x00, request[14]校验和地址计算逻辑M100地址100直接传入BuildReadBitRequest(100,1)M1000则传1000。函数内部用BitConverter.GetBytes((ushort)address)自动转小端无需手动拆高低字节。校验和范围争议网上资料有“含STX”和“不含STX”两种说法。经用GX Works2抓包比对实际校验和包含起始符0x54。若按“不含”计算PLC会返回0x54 0x00 0xFF 0x03 ... 0x0F错误码0F校验错此时需修正校验逻辑。3.2 解包函数从PLC回包中精准提取Bool数组PLC成功应答时返回帧结构为STX 网络号 PLC号 单元号 站号 命令码 子命令 错误码 数据长度 数据体 校验和。其中数据体为压缩的位数组每字节8个bitMSB在前。/// summary /// 解析PLC返回的位元件数据M/X/Y /// /summary /// param nameresponsePLC返回的完整字节数组/param /// param nameexpectedCount期望读取的点数/param /// returnsbool数组trueONfalseOFF/returns private bool[] ParseBitResponse(byte[] response, int expectedCount) { // 检查基本长度最小应答帧13字节无数据体 校验和 if (response.Length 13) throw new InvalidDataException(响应帧过短); // 检查错误码字节7索引70x00成功非0为错误如0x0F校验错 if (response[7] ! 0x00) { throw new InvalidOperationException($PLC返回错误码0x{response[7]:X2}); } // 数据长度在字节8-9小端如读8点 → 0x0008 → response[8]0x08, response[9]0x00 int dataLength BitConverter.ToUInt16(response, 8); // 小端解析 // 数据体起始位置字节10长度dataLength字节 int dataStartIndex 10; if (dataStartIndex dataLength response.Length - 1) // -1因最后1字节为校验和 throw new InvalidDataException(响应数据体长度异常); // 核心将dataLength字节的位数据展开为bool数组 // PLC按字节打包第0字节的bit7~bit0对应M0~M7第1字节对应M8~M15... var result new bool[expectedCount]; int bitIndex 0; for (int i 0; i dataLength bitIndex expectedCount; i) { byte b response[dataStartIndex i]; // 从MSBbit7开始取对应M0/M8/M16... for (int j 7; j 0 bitIndex expectedCount; j--) { result[bitIndex] (b (1 j)) ! 0; } } return result; } // 示例读M100~M1078点调用ParseBitResponse(res, 8) // 返回bool[8]res[0]是M100状态res[1]是M101...位序玄学PLC返回的位数据是MSB在前Big-Endian within byte即1字节0x80表示该字节对应8个点中第一个为ONM100ON0x01表示最后一个为ONM107ON。若按LSB在前解析所有状态全反。expectedCount作用防止dataLength计算错误导致数组越界。例如请求读8点但PLC返回dataLength1正确ParseBitResponse只取前8位若PLC故障返回dataLength10则bitIndex expectedCount条件截断避免写入多余元素。3.3 批量读Word/Dword地址偏移与数据类型转换读D寄存器字元件与读M不同需改子命令、地址长度、数据解析方式/// summary /// 构建MC协议读字元件请求帧D/W /// /summary /// param nameaddress软元件地址如100表示D100/param /// param namecount读取字数1~2048FX系列限制/param /// param nameisDwordtrueD32位falseD16位/param private byte[] BuildReadWordRequest(int address, int count, bool isDword false) { var frame new Listbyte { 0x54, 0x00, 0xFF, 0x03 }; frame.AddRange(BitConverter.GetBytes((ushort)_stationNumber).Take(2)); frame.AddRange(new byte[] { 0x04, 0x01 }); // 读命令字元件子命令 frame.AddRange(new byte[] { 0x00, 0x00 }); // D寄存器类型码 // 地址D100 → 100 → 小端2字节 [0x64,0x00] frame.AddRange(BitConverter.GetBytes((ushort)address).Take(2)); // 长度按字数计D100~D1012字 → 0x0002 frame.AddRange(BitConverter.GetBytes((ushort)count).Take(2)); // 校验和 byte checksum 0; foreach (byte b in frame) checksum ^ b; frame.Add(checksum); return frame.ToArray(); } /// summary /// 解析字元件响应D/W /// /summary /// param nameresponsePLC响应/param /// param namecount请求字数/param /// param nameisDwordtrue32位false16位/param /// returnsshort[] 或 int[]/returns private object ParseWordResponse(byte[] response, int count, bool isDword) { if (response[7] ! 0x00) throw new InvalidOperationException($D读取错误0x{response[7]:X2}); int dataLength BitConverter.ToUInt16(response, 8); int dataStartIndex 10; if (isDword) { // D32每个值占4字节小端序 var values new int[count]; for (int i 0; i count; i) { values[i] BitConverter.ToInt32(response, dataStartIndex i * 4); } return values; } else { // D16每个值占2字节小端序 var values new short[count]; for (int i 0; i count; i) { values[i] BitConverter.ToInt16(response, dataStartIndex i * 2); } return values; } } // 示例读D100~D1034个字 var req BuildReadWordRequest(100, 4, isDword: false); var res SendRequest(req); // 发送并接收 var dValues (short[])ParseWordResponse(res, 4, false); // dValues[0] D100值Dword陷阱isDwordtrue时PLC返回的是32位整数但FX系列D寄存器本质是16位D100/D101组合成D10032位。若PLC未启用32位模式强行读D100 as D32会返回错误码。Q系列原生支持D32FX需确认PLC型号与固件版本。地址连续性BuildReadWordRequest(100, 4)读的是D100、D101、D102、D103不是D100~D104后者是5个。count4即4个连续字元件。4. 心跳机制与异常恢复让通信在工业现场不死机4.1 心跳信号设计用D寄存器做“活着”的证据单纯轮询M点无法判断PLC是否宕机——PLC死机时M点状态可能冻结。可靠方案是PLC侧用定时器每500ms自增D1000心跳寄存器C#侧每1s读一次D1000若连续3次值未变则判定通信中断。private Timer _heartbeatTimer; private int _lastHeartbeatValue -1; private int _staleCount 0; private const int MAX_STALE_COUNT 3; public void StartHeartbeat() { _heartbeatTimer new Timer(OnHeartbeatTick, null, TimeSpan.Zero, TimeSpan.FromSeconds(1)); } private void OnHeartbeatTick(object state) { try { var res SendRequest(BuildReadWordRequest(1000, 1, false)); var currentValue ((short[])ParseWordResponse(res, 1, false))[0]; if (currentValue _lastHeartbeatValue) { _staleCount; if (_staleCount MAX_STALE_COUNT) { OnConnectionLost(); // 触发重连逻辑 } } else { _lastHeartbeatValue currentValue; _staleCount 0; } } catch (Exception ex) { // 读取异常超时/校验错也计入stale _staleCount; if (_staleCount MAX_STALE_COUNT) { OnConnectionLost(); } } } private void OnConnectionLost() { Console.WriteLine($心跳超时尝试重连...); _heartbeatTimer?.Change(Timeout.Infinite, Timeout.Infinite); Reconnect(); }为什么选D1000D1000是PLC通用寄存器非特殊功能寄存器如D8000系统寄存器用户程序可自由写入。避免用D8000等系统区防止PLC保护机制拦截。staleCount清零时机仅当currentValue ! _lastHeartbeatValue时清零。若PLC卡在某个值如D10001234不动_staleCount持续累加直至触发重连。4.2 通信异常恢复断线重连不是简单Close/OpenPLC串口通信中物理断开拔线、PLC重启、PC休眠都可能导致SerialPort对象进入不可用状态。直接Close()再Open()常失败需彻底重建private void Reconnect() { try { _serial?.Close(); _serial?.Dispose(); _serial null; Thread.Sleep(500); // 等待硬件释放 Initialize(_currentPortName, _currentBaudRate); Console.WriteLine(重连成功); _staleCount 0; _lastHeartbeatValue -1; // 重连后立即读一次心跳重置状态 var res SendRequest(BuildReadWordRequest(1000, 1, false)); _lastHeartbeatValue ((short[])ParseWordResponse(res, 1, false))[0]; } catch (Exception ex) { Console.WriteLine($重连失败{ex.Message}3秒后重试); _heartbeatTimer?.Change(TimeSpan.FromSeconds(3), TimeSpan.Infinite); } }Dispose()不可省略SerialPort是IDisposable对象不调用Dispose()可能导致句柄泄漏多次重连后抛出IOException: 所请求的资源在使用中。Thread.Sleep(500)Windows串口驱动需要时间释放底层资源立即重开大概率失败。500ms是实测稳定值低于200ms失败率50%。4.3 避坑MC协议通信的5个血泪经验现象1SendRequest()后Read()永远阻塞直到超时原因PLC站号设置为2但C#代码中_stationNumber1PLC收到帧后检查站号不匹配直接丢弃不回任何数据。解决用GX Works2在线连接PLC确认【PLC参数】→【串行通信设置】中“站号”数值并同步修改C#代码。现象2读M100返回值恒为false但GX Works2显示M100ON原因BuildReadBitRequest(100,1)生成的地址字节是0x64 0x00100的小端但PLC实际要求M地址用十进制地址而某些旧版FX需用十六进制地址M1000x64但M10000x3E8函数已正确处理。更可能是PLC未处于RUN状态——STOP状态下M点无法被外部读取。解决PLC拨动开关至RUN或在GX Works2中强制M100ON后测试。现象3批量读M0~M3132点返回数据错位M0状态出现在M1位置原因ParseBitResponse()中位循环方向错误用了for (int j 0; j 8; j)LSB在前但PLC是MSB在前。解决严格按代码中for (int j 7; j 0; j--)实现确保0x80对应第一个点。现象4写D100值后PLC中D100不变但无错误码返回原因MC协议写操作需额外步骤——PLC的“写入允许”软元件如M8030未置ON。FX系列默认禁止外部写入需在PLC程序中添加SET M8030。解决在GX Works2中编写梯形图LD X000 OUT M8030用X0启动写入允许或直接在PLC参数中启用“外部设备写入允许”。现象5程序运行2小时后串口卡死Read()抛出InvalidOperationException: 该端口已关闭原因SerialPort对象被多线程并发访问如心跳Timer与UI按钮点击同时调用SendRequest导致内部状态混乱。解决增加锁机制所有SendRequest调用前加lock(_syncLock)确保串口操作原子性。5. 工业级增强超时重传、日志追踪与性能压测技巧5.1 带重传的SendRequest三次机会救活一次通信MC协议无TCP重传机制单次丢帧即失败。加入指数退避重传提升弱环境鲁棒性private readonly object _syncLock new object(); /// summary /// 发送请求并等待响应支持重传 /// /summary /// param namerequest请求帧/param /// param namemaxRetries最大重试次数/param /// returnsPLC响应帧/returns public byte[] SendRequest(byte[] request, int maxRetries 2) { lock (_syncLock) // 防止多线程并发写串口 { for (int attempt 0; attempt maxRetries; attempt) { try { // 清空输入缓冲区避免旧数据干扰 _serial.DiscardInBuffer(); // 发送请求 _serial.Write(request, 0, request.Length); // 读取响应先读2字节头STX网络号再读剩余 var header new byte[2]; _serial.Read(header, 0, 2); if (header[0] ! 0x54) throw new InvalidDataException(响应无STX起始符); // 读取剩余长度根据协议最小响应13字节含校验和 var remaining new byte[11]; // 13-211 int read _serial.Read(remaining, 0, 11); if (read 11) throw new TimeoutException($响应不完整只读到{read}字节); var fullResponse new byte[13]; Buffer.BlockCopy(header, 0, fullResponse, 0, 2); Buffer.BlockCopy(remaining, 0, fullResponse, 2, 11); // 检查校验和fullResponse[0]~fullResponse[12]异或结果应为0 byte checksum 0; for (int i 0; i fullResponse.Length - 1; i) // 不含末尾校验字节 checksum ^ fullResponse[i]; if (checksum ! fullResponse[fullResponse.Length - 1]) throw new InvalidDataException(响应校验和错误); return fullResponse; } catch (TimeoutException) when (attempt maxRetries) { Thread.Sleep((int)Math.Pow(2, attempt) * 100); // 100ms, 200ms, 400ms continue; } } throw new Exception(重试3次后仍失败); } }重传间隔策略采用指数退避Math.Pow(2, attempt) * 100避免网络拥塞时集中重传。第一次失败后等100ms第二次200ms第三次400ms总耗时1s。校验和二次验证在SendRequest内再次校验确保即使PLC返回错误帧如校验错也能被C#捕获而非传给ParseXXX函数导致解析崩溃。5.2 通信日志用十六进制快照定位每一帧问题生产环境不能靠Console.WriteLine需结构化日志记录原始帧private void LogFrame(string direction, byte[] frame, string tag ) { var hex BitConverter.ToString(frame).Replace(-, ); var timestamp DateTime.Now.ToString(HH:mm:ss.fff); var logLine $[{timestamp}] {direction} [{tag}] {frame.Length}B: {hex}; // 写入文件按日分割 var logFile $plc_log_{DateTime.Today:yyyyMMdd}.txt; File.AppendAllText(logFile, logLine Environment.NewLine); } // 调用点 LogFrame(TX, request, READ_M100); var res SendRequest(request); LogFrame(RX, res, READ_M100_RESP);日志价值当现场报告“M100读错”直接查日志TX: 54 00 FF 03 00 01 04 00 00 00 64 00 01 00 3A→ 请求正确RX: 54 00 FF 03 00 01 04 00 00 00 01 00 01 00 3A→ 响应错误码00但数据长度0001数据体缺失 → 判定PLC未返回数据体查PLC程序是否M100被复位。文件按日分割避免单文件过大plc_log_20240520.txt便于运维按日期检索。5.3 性能压测单串口每秒最多读多少点某跨平台系统实测数据FX3U-64MT9600bpsWindows 10操作类型单次耗时ms每秒理论吞吐实际稳定吞吐备注读单个M点120~150~6.6次/s5次/s含PLC处理线缆延迟读32个M点130~160~6.2次/s5次/s批量读效率≈单点读读4个D点125~155~6.4次/s5次/sD16与M点耗时相近心跳D1000110~140~7.1次/s6次/s最简请求推荐用于保活结论单串口瓶颈在物理层9600bps ≈ 960字节/秒一帧读32M点约20字节理论极限50次/秒但PLC处理能力限制在5~6次/秒本文还有配套的精品资源点击获取
