easymodbus4j更新0.0.4发布,新增支持modbus RTU协议
码云地址:https://gitee.com/zengfr/easymodbus4j
easymodbus4j是一个高性能和易用的 Modbus 协议的 Java 实现,基于 Netty 开发,可用于 Modbus协议的Java客户端和服务器开发. easymodbus4j A high-performance and ease-of-use implementation of the Modbus protocol written in Java netty support for modbus 8 mode client/server and master/slave.
easymodbus4j 特点: 1、Netty NIO high performance高性能. 2、Modbus Function sync/aync 同步/异步非阻塞。 3、Modbus IoT Data Connector Supports工业物联网平台IoT支持。 4、支持Modbus TCP\Modbus RTU protocol两种通信协议. 5、完全支持Modbus TCP 4种部署模式: TCP服务器master,TCP客户端slave,TCP服务器slave,TCP客户端master。 6、完全支持Modbus RTU 4种部署模式: RTU服务器master,RTU客户端slave,RTU服务器slave,RTU客户端master。 7、友好的调试以及日志支持bit\bitset\byte\short\int\float\double。 8、Supports Function Codes: Read Coils (FC1) Read Discrete Inputs (FC2) Read Holding Registers (FC3) Read Input Registers (FC4) Write Single Coil (FC5) Write Single Register (FC6) Write Multiple Coils (FC15) Write Multiple Registers (FC16) Read/Write Multiple Registers (FC23)
#Example Project Code in https://github.com/zengfr/easymodbus4j
Repositories Central Sonatype Mvnrepository easymodbus4j
artifactId/jar: easymodbus4j-core.jar Modbus protocol协议 easymodbus4j-codec.jar Modbus 通用编码器解码器 easymodbus4j.jar Modbus General/Common公共通用包 easymodbus4j-client.jar Modbus client客户端 easymodbus4j-server.jar Modbus server服务器端 easymodbus4j-extension.jar Modbus extension扩展包 ModbusMasterResponseProcessor/ModbusSlaveRequestProcessor interface
快速开发Quick Start: 第一步step1 ,import jar: maven: <dependency> <groupId>com.github.zengfr</groupId> <artifactId>easymodbus4j-client</artifactId> <version>0.0.4</version> </dependency> <dependency> <groupId>com.github.zengfr</groupId> <artifactId>easymodbus4j-server</artifactId> <version>0.0.4</version> </dependency> <dependency> <groupId>com.github.zengfr</groupId> <artifactId>easymodbus4j-extension</artifactId> <version>0.0.4</version> </dependency> 第二步step2, implement handler: 2.1 if master 实现implement ResponseHandler接口 see easymodbus4j-example:ModbusMasterResponseHandler.java or 实现implement ModbusMasterResponseProcessor 接口 use new ModbusMasterResponseHandler(responseProcessor); 2.2 if slave 实现implement RequestHandler接口 see easymodbus4j-example:ModbusSlaveRequestHandler.java or 实现implement ModbusSlaveRequestProcessor 接口 use new ModbusSlaveRequestHandler(reqProcessor); 第三步step3, select one master/slave client/server mode: modbusServer = ModbusServerTcpFactory.getInstance().createServer4Master(port, responseHandler); modbusClient = ModbusClientTcpFactory.getInstance().createClient4Slave(host,port, requestHandler); modbusClient = ModbusClientTcpFactory.getInstance().createClient4Master(host, port, responseHandler); modbusServer = ModbusServerTcpFactory.getInstance().createServer4Slave(port, requestHandler); modbusServer = ModbusServerRtuFactory.getInstance().createServer4Master(port, responseHandler); modbusClient = ModbusClientRtuFactory.getInstance().createClient4Slave(host,port, requestHandler); modbusClient = ModbusClientRtuFactory.getInstance().createClient4Master(host, port, responseHandler); modbusServer = ModbusServerRtuFactory.getInstance().createServer4Slave(port, requestHandler); 第四步step4: 4.1 how to send a request ? ChannelSender sender = ChannelSenderFactory.getInstance().get(channel); sender.readCoils(...) sender.readDiscreteInputs(...) sender.writeSingleRegister(...) 4.2 how to process request/response? see code in processResponseFrame mothod in ModbusMasterResponseHandler.java or ModbusMasterResponseProcessor.java public void processResponseFrame(Channel channel, int unitId, AbstractFunction reqFunc, ModbusFunction respFunc) { if (respFunc instanceof ReadCoilsResponse) { ReadCoilsResponse resp = (ReadCoilsResponse) respFunc; ReadCoilsRequest req = (ReadCoilsRequest) reqFunc; //process business logic for req/resp } }; 4.3 how to show log? see ModbusMasterResponseHandler.java in example project. ModbusFrameUtil.showFrameLog(logger, channel, frame); 4.4 how to custom a client/server? ModbusChannelInitializer modbusChannelInitializer=...; ModbusServerTcpFactory.getInstance().createServer4Master(port,modbusChannelInitializer);
#Example Project Code master/easymodbus4j-example/src/main/java/com/github/zengfr/easymodbus4j/example
Example run startup: 1、unzip file easymodbus4j-example-0.0.1-release.zip. 2、for modbus master mode:open autosend.txt file in dir or autosend.txt rsourcefile in easymodbus4j-example-0.0.1.jar 3、for modbus master mode:edit autosend.txt file 4、start startup.bat. 5、you also can edit *.bat for modbus master/salve mode: . 说明: 1、解压缩zip文件到文件夹 2、java程序 运行不了 则安装jdk8. 3、解压后8个bat文件 对应TCP/RTU 服务器master,客户端slave,服务器slave,客户端master 8种模式. 4、Master模式 可以设置autosend.txt文件,定时发送读写请求。 5、记事本打开bat文件可以编辑相关参数,如定时延时发送时间以及详细日志开关。
capture运行效果图截屏:
update feature/history: 0.0.4 2019.08.03 support Modbus RTU protocol and heartbeat