java modbus4j tcp通信

### 使用Modbus4j在Java中实现TCP通信

为了利用`modbus4j`库在Java环境中建立并维护Modbus TCP通信，开发者可以遵循一系列特定的方法和实践。此过程不仅涉及理解基础的Modbus协议及其TCP变体的工作原理[^1]，还需要熟悉`modbus4j`这一专门用于简化此类任务的第三方库。

#### 创建Modbus主站实例

首先，在使用`modbus4j`之前，需导入必要的依赖项到项目中。对于Maven项目而言，这可以通过编辑pom.xml文件完成；而对于Gradle，则是在build.gradle内添加相应的配置。之后，创建一个表示Modbus Master的对象是至关重要的一步：

// 导入所需包
import com.serotonin.modbus4j.ModbusFactory;
import com.serotonin.modbus4j.ModbusMaster;

public class ModbusExample {
    private static final String IP_ADDRESS = "192.168.1.10"; // 替换成目标设备的实际IP地址
    private static final int PORT = 502;                     // 默认端口为502
    
    public static void main(String[] args){
        ModbusFactory modbusFactory = new ModbusFactory();
        ModbusMaster tcpMaster = modbusFactory.createTcpMaster(IP_ADDRESS, PORT);
        
        try{
            tcpMaster.setConnectTimeout(3000);               // 设置超时时间（毫秒）
            tcpMaster.init();                                // 初始化连接
            
            System.out.println("Connection established.");
            
            // 执行读取/写入操作...
            
        }catch(Exception ex){
            ex.printStackTrace();
        }finally{
            tcpMaster.destroy();                             // 断开连接
        }
    }
}

这段代码展示了如何设置与远程Modbus服务器之间的TCP链接，并包含了基本异常处理逻辑以确保资源能够被妥善释放[^4]。

#### 实施数据交换功能

一旦建立了有效的连接，下一步便是定义具体的请求——即向远端节点发送指令来获取或更新其状态信息。下面的例子说明了怎样通过调用API函数来进行简单的寄存器读取动作：

import com.serotonin.modbus4j.exception.ModbusTransportException;
import com.serotonin.modbus4j.locator.BaseLocator;

...

try {
    short startReference = 0;          // 开始位置编号
    int numberOfRegisters = 10;         // 要读取的数量
    BaseLocator<Short> locator = BaseLocator.holdingRegister(tcpMaster, startReference, numberOfRegisters);

    Short[] results = tcpMaster.getValue(locator).getValues();

    for(int i=0;i<results.length;i++){
        System.out.printf("Register %d value is %s\n",startReference+i,results[i]);
    }

} catch (ModbusTransportException | InterruptedException e) {
    e.printStackTrace();
}

上述片段实现了从指定起始点连续读取多个保持寄存器的内容，并打印出来供调试之用[^3]。