1. 手搓 MC 帧两小时 vs 调功能库十分钟:这次我选后者
一条老产线上取 PLC 的 D 区数据,我最初是手写报文:帧头、命令码、软元件地址、校验,串口一套网口一套,一个字节算错整包就丢。折腾两小时后我改用现成的 C# 功能库 McProtocol——纯 C# 实现、无第三方依赖、串口和网口共用同一套 API,把“发帧、等回包、解包”压成了几个方法调用。
这篇写的就是这个功能库怎么装、两种连接方式的参数怎么对、读写方法怎么包成自己能用的类,以及哪几个地方会把真实的产线数据读成 0。会写 C#、想跳过帧格式直接拿到数据的人可以照着走;想彻底吃透协议本身,那是另一条路,别指望一个库替你讲明白。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 功能库落地第一步:NuGet 装包与两种连接方式
2.1 为什么用一个功能库,而不是继续自己拼帧
MC 协议本身的帧不算复杂,但“不算复杂”和“能稳定跑”是两回事。手拼一次报文,要处理帧头、命令码、软元件地址的编码方式、校验,还要区分位操作和字操作——读一个 M 点和读一个 D 字,报文结构不一样;串口和网口又是两套帧,回包里还带异常码需要解析。这些东西写一次能跑,写十次就有十次出错的机会,尤其地址编码,差一位就是另一个软元件。
功能库把这层活接了过去:ReadDWord、WriteDWord、ReadM、WriteM 四个方法,背后是组帧、发送、等回包、解析、异常码转换。选它的理由就三条——纯 C# 实现、无第三方依赖、串口和网口共用同一套 API,换连接方式不用换调用代码。
| 维度 | 自己拼帧 | 用功能库 |
|---|---|---|
| 组帧与校验 | 手写,逐字节核对 | 库内部完成 |
| 位操作与字操作 | 两套报文分别实现 | 不同方法区分 |
| 串口与网口切换 | 换一套收发代码 | 只换构造函数 |
| 出错定位 | 从字节流里找 | 看返回码和异常 |
边界也要说清楚:功能库只负责“一次请求变成一帧、一帧解析成结果”,轮询节奏、超时、断线重连、缓存和业务校验都还在自己这边。把它当业务框架用,后面一定会失望——这是我第一次封装时踩的认知坑,不是库的问题。
2.2 装包与两种构造:TCP 走 5000,串口对齐 8-N-1
安装只有一条命令,在 NuGet 包管理器控制台里执行:
powershell复制Install-Package McProtocol
装完就能用 McIf 这个入口类。它的构造函数对应两种物理连接,网口和串口各一个重载:
csharp复制using McProtocol;
// 网口 TCP:端口给 5000,这是 MC 协议网口侧的默认端口
var mcTcp = new McIf(plcIp, 5000);
// 串口:波特率取设备手册上的值,帧格式 8 数据位、无校验、1 停止位
var mcSerial = new McIf(comPort, baudRate, Parity.None, 8, StopBits.One);
5000 这个默认值是现场最容易翻车的地方之一:设备侧改过端口,代码里还写 5000,表现就是一直连不上,而不是报参数错误。串口那四个参数同理,常见做法是保持 8-N-1,一旦设备侧被改成偶校验或者 7 数据位,Open 就会失败。
| 连接方式 | 构造写法 | 适用场景 | 现场核对项 |
|---|---|---|---|
| 网口 TCP | new McIf(ip, 5000) |
设备带网口、走交换机接入 | IP、端口号是否被改过 |
| 串口 | new McIf(comPort, baudRate, Parity.None, 8, StopBits.One) |
只有 RS485/RS232 可用 | 波特率、数据位、校验、停止位四项全对齐 |
我一般会把这两组参数写进配置,而不是写死在代码里:换设备的时候,改配置文件比重新编译省事得多,也避免改了一处忘了另一处。
2.3 连接结果怎么判:Open() 返回 0 才算通
连接这一步没有花活,关键是别把返回值理解错:
csharp复制public bool Connect()
{
try
{
_isConnected = _mcIf.Open() == 0;
return _isConnected;
}
catch (Exception ex)
{
Console.WriteLine($"PLC 连接失败:{ex.Message}");
return false;
}
}
Open() 返回 0 表示成功,非 0 是失败码;走异常路径的通常是端口被别的进程占用、串口名写错、网络不可达。两个分支都要落到 _isConnected 这一个标志上,因为后面所有读写方法都会先看它——这个设计的初衷是“连不上就别发请求”,但它同时埋了一个坑,第四章细说。
连接这一步还有个容易被忽略的点:Connect() 成功只代表链路建立,不代表对面的软元件地址可用。地址写错、区域不支持,要等到第一次读才会暴露,所以别把连接成功当成联调完成。
3. 功能库的读写封装:D 区按字、M 区按位
3.1 D 区读写:字地址,写入看返回码
数据区里最常用的是 D 区,读写的封装也就两行:
csharp复制public int ReadDInt16(int dAddr)
{
if (!_isConnected) return 0;
return _mcIf.ReadDWord(dAddr);
}
public bool WriteDInt16(int dAddr, int value)
{
if (!_isConnected) return false;
return _mcIf.WriteDWord(dAddr, value) == 0;
}
ReadDWord(dAddr) 返回该地址上的数值,WriteDWord(dAddr, value) 返回 0 表示写入成功。这里有两个必须记住的语义:第一,D 区按字编址,相邻地址之间差一个字,不要按字节去算偏移,否则会读到隔壁软元件上;第二,方法名里带 DWord,但接口返回的仍是 int,命名和类型并不完全对应,写代码时按 32 位有符号整数处理就行,别自己再去做一次扩展。
写入那条我特意用 == 0 转成 bool,是为了让调用侧只关心“成没成功”,而不是每次都要记“0 是成功还是失败”。这种约定必须在封装层统一,一旦某个方法返回 0 表示失败、另一个返回 0 表示成功,代码里迟早会出现把失败当成功的判断。
3.2 M 区读写:1 就是 ON,0 就是 OFF
位操作的封装比字操作多一层转换,因为业务侧要的是 bool,库侧收发的是 1/0:
csharp复制public bool ReadM(int mAddr)
{
if (!_isConnected) return false;
return _mcIf.ReadM(mAddr) == 1;
}
public bool WriteM(int mAddr, bool value)
{
if (!_isConnected) return false;
return _mcIf.WriteM(mAddr, value ? 1 : 0) == 0;
}
ReadM 返回 1 表示 ON、0 表示 OFF,封装层把它转成 bool;WriteM 收 bool,往库里传 1 或 0,返回 0 表示写成功。位地址和字地址是两套编号,别把 M 点当成 D 区地址传进去,这类错误不会报异常,只会安静地读到另一个点。
顺便说一句,功能库的接口覆盖了 D、M 以及 X、Y 这些常见软元件区,读位和读字分开走不同方法。业务上要读一个“状态字”的某一位时,两种做法都行:直接读 D 字再用位运算取,或者找到对应的 M 点直接读。前者省一次请求,后者语义更清楚,我一般在需要频繁判断单个状态时选 M 点。
3.3 状态标志与释放顺序
连接对象持有的是串口句柄或 socket,释放顺序错了就是资源泄漏:
csharp复制public void Dispose()
{
if (_isConnected)
{
_mcIf.Close();
_isConnected = false;
}
_mcIf.Dispose();
}
先 Close() 再 Dispose(),并且 Close 之前判一次 _isConnected,避免对一个没连上的实例反复关闭。调用侧用 using 包住整个生命周期最省心:
csharp复制using (var plc = new MitsubishiPlcClient(plcIp, 5000))
{
if (!plc.Connect()) return;
int speed = plc.ReadDInt16(speedAddr); // 读一个 D 字
plc.WriteM(startAddr, true); // 置一个 M 点为 ON
}
using 会在作用域结束时保证 Dispose 被调用,哪怕中间抛了异常。反过来说,如果你的采集线程是常驻的,就别用 using,改成单例托管、进程退出时统一释放——常驻服务里频繁建连断连,比句柄泄漏更伤。
4. 功能库踩坑排查:五种把数据读成 0 的现场
4.1 未连接返回 0,和真的读到 0 长得一模一样
现象:设备明明在运行,ReadDInt16 读回来是 0,换个地址还是 0,现场一开始怀疑是设备停机。原因:封装里那句 if (!_isConnected) return 0; 把“没连上”和“读到 0”压成了同一个返回值,调用侧根本分不出来。解决:读写接口不要拿 0 当失败值,改成 Try 模式:
csharp复制public bool TryReadDInt16(int dAddr, out int value)
{
value = 0;
if (!_isConnected) return false; // 失败原因由返回值区分,不再靠 0
value = _mcIf.ReadDWord(dAddr);
return true;
}
调用侧先看 bool,再看 value,线上日志里也就不会出现“读到的值全是 0”这种查半天的现象。
4.2 只包了 Connect 的异常,跑几小时采集线程就没了
现象:程序启动正常,跑几分钟到几小时后采集线程悄悄退出,日志最后一条停在读 D 区。原因:try/catch 只写在 Connect() 里,读写路径上的异常没人接,线程被直接带走。解决:每次 IO 都包一层,失败时把 _isConnected 置 false 并交给重连逻辑:
csharp复制try
{
value = _mcIf.ReadDWord(dAddr);
}
catch (Exception ex)
{
_isConnected = false;
Console.WriteLine($"读 D 区失败:{ex.Message}");
}
别假设“库不会抛”,串口被拔、网线松掉、设备重启,都会在读写这一层炸出来。
4.3 网口通、串口 Open 不过:8-N-1 和波特率没对齐
现象:同一台设备,网口能读能写,换串口 Open() 直接失败,或者连上了读回全 0。原因:串口四个参数(波特率、数据位、校验、停止位)和设备侧不一致,最常见的是校验位被改成偶校验、或者波特率写成了另一个档位。解决:按设备手册逐项对齐 baudRate、Parity.None、8、StopBits.One,改一处就要改全,别只改波特率。串口还有个隐性前提:COM 口不能被别的调试工具占着。
4.4 单字当双字用,数值错位
现象:某个数值突然翻倍,或者读出来是隔壁地址上的值。原因:把 ReadDWord 当双字读,或者把 D 区地址按字节做了偏移。解决:D 区按字编址,一个地址就是一个字;需要连续两个字时,自己按“地址 + 1”分别读再拼,不要指望一次调用返回两个地址的内容。地址表要从设备侧的软元件分配表抄,别凭记忆写。
4.5 重复 Dispose 与句柄泄漏
现象:连续跑一天后句柄数缓慢上涨,重启才恢复。原因:连接失败后没有 Close 就直接 Dispose,或者同一个实例被 Dispose 了两次。解决:Dispose 里先判 _isConnected 再 Close、再 Dispose;把实例的生命周期收敛到一个地方管理,不要在几个方法里各自 new 一个再各自释放。
排查顺序上我一般按这个次序走:先确认 Open() 的返回码,再看地址是不是从设备侧表里抄的,然后看串口/网口参数,最后才怀疑库本身。九成问题在前三步。
5. 进阶:让这个功能库在产线上跑满一个班次
真正上产线之后,功能库本身很少出问题,出问题的都是使用方式。
第一是线程模型。一个 McIf 实例不要被 UI 线程和采集线程同时读写,请求和回包会错位,读到的值看着正常、其实来自另一次请求。常见做法是一个采集线程独占一个实例,或者所有调用套同一把锁——后者简单,但会把并发读变成排队读。
第二是写后读回。WriteDWord 返回 0 只代表这一帧被接受了,不代表设备侧的值已经生效。写完立刻读回同一个地址做比对,是我现在必做的一步,成本很低,能把“写成功但没生效”这类问题挡在联调阶段。
第三是自检。定时读一个已知不变的地址,连续失败就判定连接已死并触发重连,而不是等业务读到 0 才发现链路断了。下表是我常用的验证清单:
| 验证项 | 做法 | 通过标准 |
|---|---|---|
| 链路 | Connect() 后看返回值 |
返回 true,即 Open() 为 0 |
| 读字 | 读一个已知的 D 地址 | 与设备侧显示一致 |
| 读位 | 读一个已知的 M 点 | 与设备侧 ON/OFF 一致 |
| 写字 | 写一个可写的 D 地址再读回 | 读回值等于写入值 |
| 写位 | 置一个 M 点为 ON 再读回 | 读回为 true |
| 释放 | 退出作用域后看句柄 | 句柄数回落,无残留 |
从那以后我每次接新设备,都先把「连接、读一个点、写一个点、读回、释放」这条最小链路跑通,再接业务逻辑,宁可多花二十分钟,也不在业务代码里查“为什么值是 0”。希望帮到你。
