Java串口通信 最佳实践

概要

  如果你的领导坚持坚持坚持让你用java来进行串口交互, 不是项目有问题就是他有问题,为了解决你们的问题.
Nettyx提供了两种串口通信实现, 分别是Rxtx系和Jsc系, 个人强烈建议使用Jsc, 毕竟Rxtx不仅老,且使用时需要添加依赖包或平台执行文件至类路径, 麻烦啊
那正文开始了, 先引入Nettyx的依赖

请从maven中央仓获取{lastest.version},最新版本号
<dependency>
    <groupId>io.github.fbbzl</groupId>
    <artifactId>nettyx</artifactId>
    <version>{lastest.version}</version>
</dependency>

一. Rxtx(极力不推荐, 底层库陈旧, 版本兼容极差,无人维护,使用麻烦,平台限制,不支持串口热插拔,截止2025/04/11, 甚至jdk8部分子版本已经不兼容,启动直接报错)

  作为java曾经唯一能用的串口通信库, 现在已经全面被舍弃, rxtx的最后一次更新, 笔者还是未成年,你可敢信,使用前先确保Rxtx的依赖库动态链接dll放在正确的类路径下

1. abstract SingleRxtxChannelTemplate

  虽然Rxtx已经过时,但Nettyx依然提供了SingleRxtxChannelTemplate来帮助初始化一个单串口通道客户端, 保存了单个rxtx-channel, 此客户端可以作为spring中的一个bean去使用, 完全可以当做是jdbcClient,redisClient, HttpClient这种工具组件去使用, 线程安全

以下展示了一个简单的 单通道 rxtxTemplate

@Component
public class TestSingleRxtxTemplate extends SingleRxtxChannelTemplate {
   
   

   // 此示例需要重连, 所以有用来重连的定时器, 用于定时重连 
    static ScheduledExecutorService executor = Executors.newSingleThreadScheduledExecutor();
 
    public TestSingleRxtxTemplate(String commAddress) {
   
   
        super(commAddress);
    }

    @Override
    protected ChannelInitializer<RxtxChannel> channelInitializer() {
   
   
        // 实际使用替换成你的业务channelinitializer即可. 这里不展示ChannelInitializer用法
        return new TestChannelInitializer<>();
    }
    // 重写doChannelConfig来进行参数设置,此方法入参channelConfig是一个空白的config对象,需要你set指定的业务通信参数
    @Override
    protected void doChannelConfig(RxtxChannelConfig channelConfig) {
   
   
        channelConfig
                .setBaudRate(115200)
                .setDataBits(RxtxChannelConfig.DataBits.DATA_BITS_8)
                .setStopBits(RxtxChannelConfig.StopBits.STOP_BITS_1)
                .setParityBit(RxtxChannelConfig.ParityBit.NO)
                .setDtr(false)
                .setRts(false);
    }
}

测试方法

    public static void main(String[] args) {
   
   
    	// 这里直接使用main函数演示用法, 各位在项目中使用时,请将其实现作为spring bean来使用!!!
        TestSingleRxtxTemplate testSingleRxtx = new TestSingleRxtxTemplate("COM3");
        ChannelFutureListener listener = new ActionChannelFutureListener()
        		 // 当成功时执行指定函数, 通过lambda来指定
                .whenSuccess((l, cf) -> {
   
   
                    executor.scheduleAtFixedRate(() -> {
   
   
                        byte[] msg = new byte[300];
                        Arrays.fill(msg, (byte) 1);
                        testSingleRxtx.writeAndFlush(Unpooled.wrappedBuffer(msg));
                    }, 2, 30, TimeUnit.MILLISECONDS);

                    System.err.println(cf.channel().localAddress() + ": ok");
                })
                // 取消时执行指定函数, 通过lambda指定
                .whenCancel((l, cf) -> System.err