digitalpetri Modbus

digitalpetri Modbus 是一款适用于 Java 17 的客户端与服务器库，支持 Modbus TCP、Modbus TCP Security（TLS）、基于串行的 Modbus RTU 以及基于 TCP 的 Modbus RTU。该库提供类型化的请求与响应 PDU、可插拔的传输层与编解码器，同时支持同步和异步客户端操作。

从 Modbus TCP 设备读取保持寄存器的示例如下：

var transport = NettyTcpClientTransport.create(cfg -> cfg.setHostname("10.0.0.100"));
var client = ModbusTcpClient.create(transport);

try (var ignored = client.open()) {
  var response = client.readHoldingRegisters(1, new ReadHoldingRegistersRequest(0, 2));
  System.out.println("register bytes: " + HexFormat.of().formatHex(response.registers()));
}

安装与模块

大多数应用程序依赖于其使用的传输模块；Maven 会自动引入核心 modbus 模块。

模块	用途
modbus	核心客户端/服务器 API、PDU、成帧、服务和传输接口
modbus-tcp	用于 Modbus TCP、带 TLS 的 TCP 以及 RTU over TCP 的 Netty 传输
modbus-serial	用于通过串行端口进行 Modbus RTU 的 jSerialComm 传输

对于 Modbus TCP 应用程序：

<dependency>
  <groupId>com.digitalpetri.modbus</groupId>
  <artifactId>modbus-tcp</artifactId>
  <version>2.1.6</version>
</dependency>

有关串行坐标、Java 要求和模块详情，请参见安装与模块。

传输功能

传输方式	客户端	服务器	TLS
Modbus TCP	支持	支持	可选双向 TLS
Modbus RTU over serial	支持	支持	不支持
Modbus RTU over TCP	支持	支持	可选双向 TLS

有关类型化功能码、原始PDU和广播支持，请参见功能与传输矩阵。

文档

文档索引列出了所有操作指南、概念和参考页面。

常见任务：

• 通过 Modbus TCP 进行读写
• 通过串行 RTU 进行通信
• 使用 TLS 保护 Modbus TCP 客户端
• 通过 Modbus TCP 公开数据
• 配置超时和重连
• 排查通信问题

概念与参考：

• 如果您不熟悉数据区、单元 ID、PDU 和传输方式之间的关系，请从Modbus 心智模型开始。
• 在将设备手册转换为请求之前，请先了解地址、单元 ID 和数据。
• 浏览API 参考链接以获取生成的 Javadoc。

许可

digitalpetri Modbus 根据Eclipse Public License 2.0许可。