Java 串口编程使用 RXTX 库教程

简介

本文将指导你如何使用 Java 编程语言通过 RXTX 库实现串口通信。RXTX 是一个开源的 Java 串口通信库，可以实现与硬件设备的串口通信。

流程图

以下是实现 Java 串口编程的整个流程：

sequenceDiagram
    participant Developer as 开发者
    participant Newbie as 刚入行的小白

    Developer->>Newbie: 介绍串口编程流程
    Developer->>Newbie: 详细解释每个步骤
    Developer->>Newbie: 提供代码示例和注释

状态图

以下是串口通信的状态图示例：

stateDiagram
    [*] --> Closed
    Closed --> Opened: open()
    Opened --> Closed: close()
    Opened --> ReadData: read()
    ReadData --> Opened: write()
    ReadData --> Closed: close()
    Opened --> WriteData: write()
    WriteData --> Opened: read()
    WriteData --> Closed: close()

步骤

  1. 导入 RXTX 库 首先，你需要下载并导入 RXTX 库到你的 Java 项目中。可以从 RXTX 官方网站（

  2. 配置串口 在开始使用串口前，你需要先确定要使用的串口名称，例如 "/dev/ttyUSB0" 或 "COM1"。你可以通过以下代码获取可用串口列表：

    import gnu.io.CommPortIdentifier;

public class ListSerialPorts {
    public static void main(String[] args) {
        CommPortIdentifier portId;
        Enumeration ports = CommPortIdentifier.getPortIdentifiers();

        while (ports.hasMoreElements()) {
            portId = (CommPortIdentifier) ports.nextElement();
            System.out.println(portId.getName());
        }
    }
}

  3. 打开串口 通过以下代码可以打开串口：

    import gnu.io.CommPort;
import gnu.io.CommPortIdentifier;
import gnu.io.SerialPort;

public class OpenSerialPort {
    public static void main(String[] args) {
        String portName = "/dev/ttyUSB0"; // 或者 "COM1"

        try {
            CommPortIdentifier portIdentifier = CommPortIdentifier.getPortIdentifier(portName);
            if (portIdentifier.isCurrentlyOwned()) {
                System.out.println("Error: Port is currently in use");
            } else {
                CommPort commPort = portIdentifier.open("MyApp", 2000);

                if (commPort instanceof SerialPort) {
                    SerialPort serialPort = (SerialPort) commPort;
                    serialPort.setSerialPortParams(9600, SerialPort.DATABITS_8, SerialPort.STOPBITS_1, SerialPort.PARITY_NONE);

                    // 在这里添加读写逻辑
                } else {
                    System.out.println("Error: Only serial ports are handled by this example.");
                }
            }
        } catch (Exception e) {
            System.out.println("Error: " + e);
        }
    }
}

  4. 读取串口数据 通过以下代码可以从串口读取数据：

    import gnu.io.SerialPort;
import gnu.io.SerialPortEvent;
import gnu.io.SerialPortEventListener;

public class ReadSerialPort implements SerialPortEventListener {
    private SerialPort serialPort;

    public ReadSerialPort(SerialPort serialPort) {
        this.serialPort = serialPort;
    }

    public void start() {
        try {
            serialPort.addEventListener(this);
            serialPort.notifyOnDataAvailable(true);
        } catch (Exception e) {
            System.out.println("Error: " + e);
        }
    }

    public synchronized void serialEvent(SerialPortEvent event) {
        if (event.getEventType() == SerialPortEvent.DATA_AVAILABLE) {
            try {
                // 在这里处理接收到的数据
                byte[] buffer = new byte[1024];
                int len = 0;

                while ((len = serialPort.getInputStream().read(buffer)) > -1) {
                    String data = new String(buffer, 0, len);
                    System.out.print(data);
                }
            } catch (Exception e) {
                System.out.println("Error: " + e);
            }
        }
    }

    public static void main(String[] args) {
        // 在打开串口的代码中添加以下代码
        SerialPort serialPort = (SerialPort) commPort;
        ReadSerialPort reader = new ReadSerialPort(serialPort);
        reader.start();
    }
}

  5. 写入串口数据