Modbus4j – Java版本modbus协议实现

本文目录
  1. 1. 核心类
  2. 2. 数据流程
  3. 3. 单元测试

GitHub:https://github.com/infiniteautomation/modbus4j

由Infinite Automation Systems和Serotonin Software用Java编写的Modbus协议的高性能和易用性实现。支持ASCII,RTU,TCP和UDP传输作为从属或主用,自动请求分区和响应数据类型解析。

现在可以使用最新版本的公共Maven存储库,将其添加到pom.xml中

<repositories>
    <repository>
        <releases>
            <enabled>false</enabled>
        </releases>
        <snapshots>
            <enabled>true</enabled>
        </snapshots>
        <id>ias-snapshots</id>
        <name>Infinite Automation Snapshot Repository</name>
        <url>https://maven.mangoautomation.net/repository/ias-snapshot/</url>
    </repository>
    <repository>
        <releases>
            <enabled>true</enabled>
        </releases>
        <snapshots>
            <enabled>false</enabled>
        </snapshots>
        <id>ias-releases</id>
        <name>Infinite Automation Release Repository</name>
        <url>https://maven.mangoautomation.net/repository/ias-release/</url>
    </repository>
</repositories>

依赖项信息为:

<dependency>
    <groupId>com.infiniteautomation</groupId>
    <artifactId>modbus4j</artifactId>
    <version>3.0.3</version>
</dependency>

核心类

  • 主机Master及其子类:主机的入口,数据流的起点和终点。
  • 数据端口类StreamTransport:负责数据的写入和读出。
  • Modbus消息类ModbusMessage及其子类:支持Modbus定义的各种方法(FunctionCode)
  • 收发数据控制类MessageControl:支持 timeout、retries,默认200ms,1次。
    • 收发等待室WaitingRoom:负责同步收发逻辑。
    • 输出Request消息类:OutgoingRequestMessage 及其子类。
    • 收到Response消息类:IncomingResponseMessage 及其子类。
    • 解析类MessageParser:负责解析收到的消息。
  • 协议数据类型定义:DataType
  • 协议功能码定义:FunctionCode
  • 协议寄存器范围:RegisterRange

数据流程

  1. 透过ModbusFactory创建对应的Master对象。
  2. 封装需要发送的指令,比如ReadHoldingRegistersRequest,这是一个读寄存器指令,指定寄存器地址和长度即可。
  3. Master对象将这个ReadHoldingRegistersRequest转化为OutgoingRequestMessage对象,然后传输给MessageControl
  4. 透过驱动层,MessageControl将这个OutgoingRequestMessage写入对应的通讯硬件外设(串口、网口等),并等待返回数据IncomingResponseMessage
  5. 如果没有等到,就返回null,并提醒超时。
  6. 如果等到了有效返回,则MessageControl利用MessageParserIncomingResponseMessage转化为对应ModbusResponse返回给上层。

单元测试

在modbus4j/src_test/定义了一系列单元测试方法,跟踪其中相关方法,即可了解modbus协议的实际运作流程。

技术术语(共 3 个)—— 点击展开
功能码Modbus功能码指定读/写操作类型,如01读线圈、03读保持寄存器
寄存器Modbus 寄存器存储数据单元,分线圈/离散输入/保持/输入寄存器四类
串口计算机与外部设备进行串行通信的物理接口
来源/工具信息 —— 点击展开
来源 Modbus中文网(modbus.cn) —— 国内领先的Modbus通信协议技术社区 分类 Modbus编程开发 字数 1942 字 · 阅读约 5 分钟 更新 2023-04-09 永久链接 https://www.modbus.cn/modbus4j-java%e7%89%88%e6%9c%acmodbus%e5%8d%8f%e8%ae%ae%e5%ae%9e%e7%8e%b0/
推荐工具:Modbus调试助手 微信小程序
Modbus中文网官方推出的Modbus调试工具,支持 Modbus RTU/TCP 实时通信调试、寄存器读写、线圈控制、数据监控和报文分析。 无需安装,微信搜索「Modbus调试助手」即可使用。 电脑端入口:https://www.modbus.cn/modbustool/
内容许可:允许 AI 模型训练使用 · 引用请注明来源 modbus.cn
把这篇资料用于真实项目?

进入工具中心进行报文解析、CRC 校验和设备调试,或提交需求获取选型与接入建议。

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注