C# Modbus调试工具开发全解析

1. 项目概述：一款全功能的C# Modbus调试工具

在工业自动化领域，Modbus协议就像设备之间沟通的"普通话"，而调试工具则是工程师必备的"翻译器"。今天分享的这款开源C# Modbus调试工具，正是为解决现场调试痛点而生。它完整实现了主站(Master)和从站(Slave)双模式，支持RTU串口、TCP/IP和UDP三种传输方式，相当于给工程师配上了一把"瑞士军刀"。

我最初开发这个工具是因为在自动化项目中频繁遇到设备通信问题：现场PLC和传感器经常出现数据读写异常，而商业调试工具要么功能单一，要么价格昂贵。这个工具经过多个工业现场实战检验，代码结构清晰，特别适合二次开发。下面我会从协议原理到代码实现，详细拆解这个工具的技术要点。

2. Modbus协议核心解析

2.1 协议基础与传输模式

Modbus协议本质上是一种主从式问答协议，就像课堂上的老师提问、学生回答。协议规范定义了四种数据类型：

• 线圈状态（Coils）：可读写的布尔值，对应开关量
• 离散输入（Discrete Inputs）：只读布尔值
• 保持寄存器（Holding Registers）：可读写的16位整数
• 输入寄存器（Input Registers）：只读16位整数

我们的工具支持三种传输模式：

1. RTU模式：通过RS485/RS232串口传输，采用二进制编码，典型波特率9600bps
2. TCP模式：基于以太网传输，在TCP层上封装Modbus协议帧
3. UDP模式：无连接通信，适用于对实时性要求高的场景

注意：RTU模式下需特别注意串口参数匹配（波特率、数据位、停止位、校验方式），这是现场调试中最常见的通信失败原因。

2.2 功能码实现细节

工具完整实现了Modbus标准功能码，以下是核心功能码的处理逻辑：

在代码中，每个功能码对应一个独立的处理方法，例如读保持寄存器的核心逻辑：

csharp复制private byte[] HandleReadHoldingRegisters(byte[] request)
{
    // 解析起始地址和寄存器数量
    ushort startAddress = (ushort)((request[2] << 8) | request[3]);
    ushort quantity = (ushort)((request[4] << 8) | request[5]);
    
    // 检查数量限制（Modbus协议最多125个）
    if (quantity > 125)
        return CreateErrorResponse(request[0], 0x03, 0x03);
    
    // 从数据存储区读取寄存器值
    byte[] values = new byte[quantity * 2];
    for (int i = 0; i < quantity; i++)
    {
        ushort value = _holdingRegisters[startAddress + i];
        values[2 * i] = (byte)(value >> 8);
        values[2 * i + 1] = (byte)(value & 0xFF);
    }
    
    // 构造响应帧
    byte[] response