ModbusRTU源码（c#开发） C#开发，示例源码。 本项目为VS2010开发，可转换为VS其他版本的编辑器打开项目。 已应用到多个行业的几百个应用现场，长时间运行稳定，可靠。 本项目为ModbusRTU的软件开发源码，有详细的注释，注释详细，二次开发清晰明了。

最近在整理硬盘发现了个宝藏项目——自己十年前用C#撸的ModbusRTU协议栈。这玩意当年可是跟着工控设备跑过煤矿、混过钢厂、甚至还在海上石油平台飘过，几百个项目现场验证过的稳定性真不是吹的。今天就把这老伙计从SVN里刨出来，带大家看看工业级通信协议该怎么写。

先上硬货，这个库最骚的操作是数据帧自动拼接。现场最怕的就是串口数据被切成碎包，来看看咱们的接收处理：

private void sp_DataReceived(object sender, SerialDataReceivedEventArgs e)
{
    // 收到一帧就装车，等500ms没新数据就当收齐了（实测比定时器靠谱）
    byte[] buffer = new byte[sp.BytesToRead];
    sp.Read(buffer, 0, buffer.Length);
    _receiveBuffer.AddRange(buffer);
    
    if (!_dataReceivedFlag)
    {
        _dataReceivedFlag = true;
        ThreadPool.QueueUserWorkItem(state => 
        {
            Thread.Sleep(500);
            ProcessReceivedData();
            _receiveBuffer.Clear();
            _dataReceivedFlag = false;
        });
    }
}

这招"收到数据就开定时器，超时处理"的套路，当年可是干翻了无数干扰现场。比纯用定时器节省资源，比算数据长度灵活——毕竟从站可能返回异常报文。

再说说核心的CRC校验，这里用了预生成码表的邪派武功：

// 预先生成CRC16表（运行效率直接起飞）
private static ushort[] crcTable = new ushort[256];
static ModbusRTU()
{
    for (int i = 0; i < 256; i++)
    {
        ushort crc = (ushort)i;
        for (int j = 0; j < 8; j++)
        {
            if ((crc & 0x0001) == 0x0001)
                crc = (ushort)((crc >> 1) ^ 0xA001);
            else
                crc >>= 1;
        }
        crcTable[i] = crc;
    }
}

// 查表法校验（比实时计算快3倍不止）
public static bool CheckCRC(byte[] data)
{
    ushort crc = 0xFFFF;
    foreach (byte b in data)
    {
        crc = (ushort)((crc >> 8) ^ crcTable[(crc ^ b) & 0xFF]);
    }
    return crc == 0x0000;
}

现场维护过的都懂，CRC校验出错可能导致从站设备直接挂起。这个查表法比实时计算快三倍，在早期工控机性能拉胯的年代简直是救命稻草。

项目结构也很有意思：

• ModbusDevice.cs // 设备基类，挂载预定义寄存器
• ModbusMaster.cs // 主站操作：03/04读保持寄存器、06写单寄存器
• ModbusSlave.cs // 从站模拟器，带自动响应线程
• ProtocolParser // 协议解析三件套（帧头、数据体、CRC）
• DemoUI // 实测能跑的生产级demo

二次开发有多简单？看这个读线圈状态的示例：

var master = new ModbusMaster("COM1", 9600, Parity.None, 8, StopBits.One);
master.Open();

// 读从站地址1的00001-00008线圈
bool[] coils = master.ReadCoils(1, 0, 8);

// 写寄存器40001的值
master.WriteSingleRegister(1, 0, 12345); 

// 批量读保持寄存器（03功能码）
ushort[] registers = master.ReadHoldingRegisters(1, 0, 10);

当年有个现场小哥拿着这个demo，两天就对接上了西门子S7-200，后来还成了他们公司的标准对接方案。

项目里埋了不少实用彩蛋：

1. 自动重试机制（默认3次，可配置）
2. 超时动态调整（根据网络质量自动伸缩等待时间）
3. 异常报文熔断（连续错误超阈值自动断连）
4. 调试模式（可以dump原始通信数据）

要说遗憾也是有的，比如没做异步await支持（那会C#还没这玩意儿）。不过核心协议栈和业务逻辑完全解耦，现在要改也容易。有次客户非要上TCP转RTU的网关，我们直接把串口驱动层换成Socket就搞定了。

十年过去，虽然现在各种Modbus库满天飞，但这个项目的注释文档绝对能打——每个关键方法都带着这样的吐槽：

/// <summary>
/// 写多个线圈（功能码0x0F）
/// 注意：有些PLC要求写入长度必须是8的倍数，不然装孙子不响应
/// 作者被这个坑浪费了两天生命 ->_<-
/// </summary>
public bool WriteMultipleCoils(byte slaveAddress, ushort startAddress, bool[] states)
{
    // 这里省略一堆处理八阿哥的代码...
}

这种祖传注释，比什么设计文档都实在。后来团队新人接手，靠着这些吐槽三天就能改需求，客户要的称重传感器对接两天搞定。

最后扔个Github地址（虚构的，别真访问）：

https://github.com/oldDriver/ModbusRTU-Legacy

用的时候记得把串口超时设长点，毕竟现在都是USB转串口，和当年直连COM口不一样。遇到问题翻翻Issues里，可能有你想要的答案——十年前的老哥已经踩过坑了。