SpringBoot项目串口通讯之jSerialComm

本文介绍了如何在SpringBoot项目中使用jSerialComm库进行串口通信,并展示了如何通过WebSocket实现实时数据传输,包括发现串口、打开串口、发送数据和接收数据的控制层实现以及ResponseResult类的使用。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

1.pom坐标

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.3.4.RELEASE</version>
        <relativePath/> 
    </parent>
    <groupId>com.example</groupId>
    <artifactId>rxtxcommon</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>rxtxcommon</name>
    <description>Demo project for Spring Boot</description>
    <properties>
        <java.version>1.8</java.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-devtools</artifactId>
            <optional>true</optional>
        </dependency>
         <!--websocket-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-websocket</artifactId>
        </dependency>
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <version>1.18.20</version>
            <scope>provided</scope>
        </dependency>
        <!--jSerialComm库串口通讯-->
        <dependency>
            <groupId>com.fazecast</groupId>
            <artifactId>jSerialComm</artifactId>
            <version>2.6.2</version>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

2.控制层

import com.fazecast.jSerialComm.SerialPort;
import com.example.rxtxcommon.entity.ResponseResult;
import com.example.rxtxcommon.service.SerialPortService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.socket.WebSocketSession;
import java.io.IOException;
import java.util.ArrayList;
import java.util.List;

@RestController
@RequestMapping("/serial")
public class SerialController {

    @Autowired
    private SerialPortService serialPortService;
    public List<SerialPort> serialPortList;
    public int countsend;
    public int countreceive;

    @GetMapping("/discover")
    public ResponseResult<List<String>> discoverSerialPort() {
        List<SerialPort> list1 = serialPortService.discoverSerialPort();
        List<String> list = new ArrayList<>();
        serialPortList = list1;
        list1.forEach(item -> {
            list.add(item.getSystemPortName());
        });
        ResponseResult<List<String>> response = new ResponseResult<>(list.size() == 0 ? 500 : 1, "", list);
        return response;
    }

    @GetMapping("/open")
    public ResponseResult<Boolean> openSerialPort(SerialPort port1) {
        WebSocketSession session = null;
        for (SerialPort port : serialPortList) {
            if (port.getSystemPortName().equals("COM10")) {
                return serialPortService.openSerialPort(port, session);
            }
        }
        return ResponseResult.getErrorResult("Failed to find port ");
    }

    @GetMapping("/send")
    public String sendData(SerialPort port1, String data) throws IOException {
    //发送数据注意,提前与接收设备沟通好协议,发送什么样类型的数据设备才可以进行响应,否则设备无响应
        for (SerialPort port : serialPortList) {
            if (port.getSystemPortName().equals("COM10")) {
                serialPortService.sendData(port, data);
            }
        }
        return "Data sent>>>" + (countsend++);
    }

    @GetMapping("/close")
    public String closeSerialPort(SerialPort port1) {
        for (SerialPort port : serialPortList) {
            // 遍历串口列表并为每个串口设置参数
            serialPortService.closeSerialPort(port);
        }
        return "Serial port closed";
    }

}

3.接口

import com.fazecast.jSerialComm.SerialPort;
import com.example.rxtxcommon.entity.ResponseResult;
import org.springframework.web.socket.WebSocketSession;

import java.io.IOException;
import java.util.List;

public interface SerialPortService {
    List<SerialPort> discoverSerialPort();

    boolean closeSerialPort(SerialPort port);

    void sendData(SerialPort port, String data) throws IOException;

    ResponseResult<Boolean> openSerialPort(SerialPort port, WebSocketSession session);
}

4.实现类-通过串口向设备发数据

import com.fazecast.jSerialComm.SerialPort;
import com.example.rxtxcommon.config.DataListener;
import com.example.rxtxcommon.entity.ResponseResult;
import com.example.rxtxcommon.service.SerialPortService;
import com.example.rxtxcommon.utils.ByteUtils;
import org.springframework.stereotype.Service;
import org.springframework.web.socket.WebSocketSession;

import java.io.IOException;
import java.io.InputStream;
import java.util.Arrays;
import java.util.List;


@Service
public class SerialPortServiceImp implements SerialPortService {

    public List<SerialPort> serialPortList;

    @Override
    public List<SerialPort> discoverSerialPort() {
        serialPortList = Arrays.asList(SerialPort.getCommPorts());
        // 遍历串口列表并打印每个串口的名称
        for (SerialPort port : serialPortList) {
            System.out.println("获取串口: " + port.getSystemPortName());
        }
        return serialPortList;
    }

    //关闭串口
    @Override
    public boolean closeSerialPort(SerialPort port) {
        for (SerialPort portItem : serialPortList) {
            if (portItem.getSystemPortName().equals("COM10")) {
                if (portItem != null) {
                    System.out.println("断开端口" + portItem.getSystemPortName() + "连接");
                    return portItem.closePort();
                }
            }
        }
        return false;
    }


    //发送数据到串口
    @Override
    public void sendData(SerialPort port, String data) throws IOException {
        byte[] buffer2 = ByteUtils.hexStr2Byte(data);
        port.writeBytes(buffer2, buffer2.length);
    }

   
    @Override
    public ResponseResult<Boolean> openSerialPort(SerialPort port, WebSocketSession session) {
        if (port.getSystemPortName().equals("COM10")) {
            int baudRate = 2400; // 波特率
            int parity = SerialPort.EVEN_PARITY; // 校验位
            int dataBits = 8; // 数据位
            int stopBits = SerialPort.ONE_STOP_BIT; // 停止位
            if (port.openPort()) {
                try {
                    boolean setComResult = port.setComPortParameters(baudRate, dataBits, stopBits, parity); // 设置参数
                    boolean setComTimes = port.setComPortTimeouts(SerialPort.TIMEOUT_READ_SEMI_BLOCKING, 20000, 0); // 设置超时
                    if (setComResult && setComTimes) {
                        port.addDataListener(new DataListener(port.getSystemPortName(), session));
                    }
                } catch (Exception e) {
                    e.printStackTrace();
                    return ResponseResult.getErrorResult("Failed to open port " + port.getSystemPortName() + e.getMessage().toString());
                }
                System.out.println("COM10 Serial port open 打开");
                return ResponseResult.getSuccessResult("COM10 Serial port open");
            } else {
                return ResponseResult.getErrorResult("Failed to open port " + port.getSystemPortName());
            }
        }
        return ResponseResult.getErrorResult("Failed to find port " + port.getSystemPortName());
    }

}

5.监听设备通过串口返回数据

import com.fazecast.jSerialComm.SerialPort;
import com.fazecast.jSerialComm.SerialPortDataListener;
import com.fazecast.jSerialComm.SerialPortEvent;
import com.example.rxtxcommon.utils.ByteUtils;
import lombok.SneakyThrows;
import org.springframework.web.socket.TextMessage;
import org.springframework.web.socket.WebSocketSession;

public class DataListener implements SerialPortDataListener {
    private WebSocketSession session;
    private String portName;
	
	//通过websocket打开监听设备的时候绑定session返回给前端数据
    public DataListener(String portName, WebSocketSession session) {
        this.portName = portName;
        this.session = session;
    }

    @Override
    public int getListeningEvents() {
        return SerialPort.LISTENING_EVENT_DATA_WRITTEN;
    }

    @SneakyThrows
    @Override
    public void serialEvent(SerialPortEvent event) {
        String hexString = "";
        if (event.getEventType() == SerialPort.LISTENING_EVENT_DATA_WRITTEN) {
            byte[] newData = new byte[event.getSerialPort().bytesAvailable()];
            int numRead = event.getSerialPort().readBytes(newData, newData.length);
            hexString = ByteUtils.byteArrayToHexString(newData);
        }
        System.out.println("监听接收串口" + portName + ";数据:" + hexString);
        session.sendMessage(new TextMessage(hexString));
    }
}

6.创建响应结果类ResponseResult

import lombok.Data;
import java.io.Serializable;

@Data
public class ResponseResult<T> implements Serializable {
    /**
     * responseCode : 成功默认为1
     */
    public static final int CODE_SUCCESS = 1;

    /**
     * responseCode : 失败默认为500
     */
    public static final int CODE_ERROR = 500;
    private Integer code;
    private String message;
    private T data;
    
    public ResponseResult(Integer code, String message, T data) {
        this.code = code;
        this.message = message;
        this.data = data;
    }
    public ResponseResult(Integer code, String message) {
        this.code = code;
        this.message = message;
        this.data = data;
   }
    public static <T> ResponseResult<T> getSuccessResult(String message, T data) {
        return new ResponseResult<>(CODE_SUCCESS, message, data);
    }
    public static <T> ResponseResult<T> getSuccessResult(String message) {
        return new ResponseResult<>(CODE_SUCCESS, message);
    }
    public static <T> ResponseResult<T> getErrorResult(String message) {
        return new ResponseResult<>(CODE_ERROR, message);
    }
}
### 使用 Spring Boot 连接串口服务器 为了实现通过 Spring Boot 应用程序连接到串口服务器,通常需要引入第三方库来处理底层的串口通信逻辑。一种常见的做法是利用 `JSerialComm` 来管理串口操作。 #### 添加依赖项 首先,在构建文件中加入必要的 Maven 或 Gradle 依赖: 对于 Maven 用户来说,应该在 pom.xml 文件里添加如下片段: ```xml <dependency> <groupId>com.fazecast</groupId> <artifactId>jserialcomm</artifactId> <version>2.9.1</version> </dependency> ``` 而对于采用 Gradle 的项目,则可以在 build.gradle 中声明该依赖关系: ```groovy implementation 'com.fazecast:jserialcomm:2.9.1' ``` #### 编写服务类 创建一个新的 Java 类用于封装与特定端口之间的交互行为。下面是一个简单的例子展示怎样打开指定编号的 COM 端口并向其发送数据包: ```java import com.fazecast.jSerialComm.SerialPort; import org.springframework.stereotype.Service; @Service public class SerialService { private static final int BAUD_RATE = 9600; // 波特率设置为标准值 public void sendToComPort(String portName, String message){ SerialPort[] ports = SerialPort.getCommPorts(); for (SerialPort port : ports) { if(port.getSystemPortName().equals(portName)){ System.out.println("Found target port:" +port); boolean openedSuccessfully = port.openPort(); if(openedSuccessfully){ port.setBaudRate(BAUD_RATE); byte[] dataToSend = message.getBytes(); port.writeBytes(dataToSend,dataToSend.length); try{ Thread.sleep(500L); // 给予足够的时间让设备响应 }catch(Exception e){} port.closePort(); // 记得每次使用完毕都要关闭端口 break; } } } } } ``` 此代码段展示了如何遍历可用的串行端口列表寻找匹配的目标名称,并尝试建立连接以及传输字符串形式的消息给选定的物理接口[^2]。 #### 配置自动扫描组件 为了让上述定义的服务能够被 Spring 容器识别并注入其他地方使用,请确保已经激活了@ComponentScan 注解或者将其所在包路径显式地注册到了应用程序上下文中。 #### 控制层集成 最后一步是在控制器层面编写 RESTful API 接收外部请求触发实际的数据交换过程。这里给出一个基本示例说明如何接受 HTTP POST 请求并将携带的内容转发至本地计算机上的某个串行端口上: ```java @RestController @RequestMapping("/api/serial") public class SerialController { @Autowired private SerialService serialService; @PostMapping("/{port}") public ResponseEntity<String> postMessage(@PathVariable String port,@RequestBody Map<String,Object> body){ Object msgObj = body.getOrDefault("message",""); String message = ""; if(msgObj instanceof String){ message=(String)msgObj; } this.serialService.sendToComPort(port,message); return new ResponseEntity<>("Sent",HttpStatus.OK); } } ``` 以上就是关于如何借助 Spring Boot 实现串口通讯的一个简单介绍和实践指南[^1]。
评论 3
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值