Java串口编程例子

古城微笑少年丶 2023-01-01 08:51 265阅读 0赞

最近笔者接触到串口编程,网上搜了些资料,顺便整理一下。网上都在推荐使用Java RXTX开源类库,它提供了Windows、Linux等不同操作系统下的串口和并口通信实现,遵循GNU LGPL协议。看起来不错,写个例子试试。

准备运行环境

下载RXTX

RXTX下载地址是:http://fizzed.com/oss/rxtx-for-java,笔者操作系统是Windows10,下载对应版本的压缩包,解压后复制RXTXcomm.jar到D:\\Program Files\Java\jdk1.8.0_152\jre\lib\ext目录下;复制rxtxParallel.dll和rxtxSerial.dll到D:\Program Files\Java\jdk1.8.0_152\jre\bin目录下。

注意:安装jdk时可能也顺便装了jre,需要复制到jdk的jre目录下。

下载Virtual Serial Port Driver

Virtual Serial Port Driver是一款非常好用的虚拟串口模拟软件,可以在计算机模拟串口,方便开发和测试。安装后打开界面如下:
在这里插入图片描述
可以看到右侧默认出现COM1和COM2的串口,点击Add pair就可以创建这两个串口了,打开计算机管理,可以看到本机多了这两个端口,如下图所示:
在这里插入图片描述

创建项目

创建serialPort项目,如下图所示:
在这里插入图片描述
源代码地址:https://github.com/wu-boy/serialPort.git
文中所用软件工具等资料下载:https://download.csdn.net/download/wu\_boy/14003992

串口工具类

现在可以写一个串口工具类,方便开发和测试,代码如下:

  1. public class SerialPortUtils {
  2. private static Logger log = LoggerFactory.getLogger(SerialPortUtils.class);
  3. /** * 打卡串口 * @param portName 串口名 * @param baudRate 波特率 * @param dataBits 数据位 * @param stopBits 停止位 * @param parity 校验位 * @return 串口对象 */
  4. public static SerialPort open(String portName, Integer baudRate, Integer dataBits,
  5. Integer stopBits, Integer parity) {
  6. SerialPort result = null;
  7. try {
  8. // 通过端口名识别端口
  9. CommPortIdentifier identifier = CommPortIdentifier.getPortIdentifier(portName);
  10. // 打开端口,并给端口名字和一个timeout(打开操作的超时时间)
  11. CommPort commPort = identifier.open(portName, 2000);
  12. // 判断是不是串口
  13. if (commPort instanceof SerialPort) {
  14. result = (SerialPort) commPort;
  15. // 设置一下串口的波特率等参数
  16. result.setSerialPortParams(baudRate, dataBits, stopBits, parity);
  17. log.info("打开串口{}成功", portName);
  18. }else{
  19. log.info("{}不是串口", portName);
  20. }
  21. } catch (Exception e) {
  22. log.error("打开串口{}错误", portName, e);
  23. }
  24. return result;
  25. }
  26. /** * 串口增加数据可用监听器 * @param serialPort * @param listener */
  27. public static void addListener(SerialPort serialPort, DataAvailableListener listener) {
  28. if(serialPort == null){
  29. return;
  30. }
  31. try {
  32. // 给串口添加监听器
  33. serialPort.addEventListener(new SerialPortListener(listener));
  34. // 设置当有数据到达时唤醒监听接收线程
  35. serialPort.notifyOnDataAvailable(Boolean.TRUE);
  36. // 设置当通信中断时唤醒中断线程
  37. serialPort.notifyOnBreakInterrupt(Boolean.TRUE);
  38. } catch (TooManyListenersException e) {
  39. log.error("串口{}增加数据可用监听器错误", serialPort.getName(), e);
  40. }
  41. }
  42. /** * 从串口读取数据 * @param serialPort * @return */
  43. public static byte[] read(SerialPort serialPort) {
  44. byte[] result = { };
  45. if(serialPort == null){
  46. return result;
  47. }
  48. InputStream inputStream = null;
  49. try {
  50. inputStream = serialPort.getInputStream();
  51. // 缓冲区大小为1个字节,可根据实际需求修改
  52. byte[] readBuffer = new byte[1];
  53. while (inputStream.available() > 0) {
  54. inputStream.read(readBuffer);
  55. result = ArrayUtil.addAll(result, readBuffer);
  56. }
  57. } catch (IOException e) {
  58. log.error("串口{}读取数据错误", serialPort.getName(), e);
  59. } finally {
  60. IoUtil.close(inputStream);
  61. }
  62. return result;
  63. }
  64. /** * 往串口发送数据 * @param serialPort * @param data */
  65. public static void write(SerialPort serialPort, byte[] data) {
  66. if(serialPort == null){
  67. return;
  68. }
  69. OutputStream outputStream = null;
  70. try {
  71. outputStream = serialPort.getOutputStream();
  72. outputStream.write(data);
  73. outputStream.flush();
  74. } catch (Exception e) {
  75. log.error("串口{}发送数据错误", serialPort.getName(), e);
  76. } finally {
  77. IoUtil.close(outputStream);
  78. }
  79. }
  80. /** * 关闭串口 * @param serialPort */
  81. public static void close(SerialPort serialPort) {
  82. if (serialPort != null) {
  83. serialPort.close();
  84. log.warn("串口{}关闭", serialPort.getName());
  85. }
  86. }
  87. /** * 查询可用端口 * @return 串口名List */
  88. public static List<String> listPortName() {
  89. List<String> result = new ArrayList<>();
  90. // 获得当前所有可用端口
  91. Enumeration<CommPortIdentifier> serialPorts = CommPortIdentifier.getPortIdentifiers();
  92. if(serialPorts == null){
  93. return result;
  94. }
  95. // 将可用端口名添加到List并返回该List
  96. while (serialPorts.hasMoreElements()) {
  97. result.add(serialPorts.nextElement().getName());
  98. }
  99. return result;
  100. }
  101. }

测试代码

测试代码如下,先不要着急运行,下一步打开串口调试助手协助测试。

  1. public class SerialPortTest {
  2. public static void main(String[] args) throws Exception{
  3. // 打开串口
  4. SerialPort serialPort = SerialPortUtils.open("COM1", 9600, SerialPort.DATABITS_8,
  5. SerialPort.STOPBITS_1, SerialPort.PARITY_NONE);
  6. // 监听串口读取数据
  7. SerialPortUtils.addListener(serialPort, () -> {
  8. byte[] data = SerialPortUtils.read(serialPort);
  9. System.out.println(HexUtil.encodeHexStr(data));
  10. });
  11. // 往串口发送数据
  12. byte[] data = { 1, 2, 3};
  13. SerialPortUtils.write(serialPort, data);
  14. /*// 关闭串口 Thread.sleep(2000); SerialPortUtils.close(serialPort);*/
  15. // 测试可用端口
  16. //SerialPortUtils.listPortName().forEach(o -> System.out.println(o));
  17. }
  18. }

串口调试助手

UartAssist是一款很好用的串口调试助手,先运行串口调试助手,接收设置和发送设置都选择HEX,串口号选择COM2->COM1(测试代码使用的COM1),其他默认,点击打开串口,然后运行测试代码SerialPortTest,效果如下图所示:
在这里插入图片描述
运行测试代码后,串口调试助手显示收到01 02 03,然后串口调试助手点击发送,idea控制台也会显示收到11223344556677,说明COM1和COM2串口互相发送和接收数据成功。

粘包/拆包的解决方案

在实际应用中,有些功能复杂的串口通信可能会发生粘包/拆包的情况,这时可以自建一个缓冲区,用来缓冲数据并处理数据。《Netty权威指南第2版》中,有TCP粘包/拆包问题的解决之道,原理可供参考,需要自己写代码实现,推荐使用Netty的缓冲区ByteBuf,功能强大。

参考资料

1、使用Java实现串口通信(二)
2、Java串口编程

在这里插入图片描述

发表评论

表情:
评论列表 (有 0 条评论,265人围观)

还没有评论,来说两句吧...

相关阅读

    相关 Java串口编程例子

    最近笔者接触到串口编程,网上搜了些资料,顺便整理一下。网上都在推荐使用Java RXTX开源类库,它提供了Windows、Linux等不同操作系统下的串口和并口通信实现,遵循G

    相关 WIN32串口编程

    [WIN32串口编程][WIN32]        -----已用   在工业控制中,工控机(一般都基于Windows平台)经常需要与智能仪表通过串口进行通信。串口通信方便