java基于RXTXcomm.jar的串口通信

RXTX的下载及配置

• mfz-rxtx-2.2-20081207-win-x64      
  下载地址：http://download.csdn.net/download/baidu_30541191/9383178
• RXTXComm.jar的API文档                
  下载地址：http://download.csdn.net/download/baidu_30541191/9383209  
  
• 首先确定你安装的JDK的位数，安装相应位数的jar包。
• 将rxtxSerial.dll、rxtxParallel.dll复制到<JAVA_HOME>\jre\bin目录下
• 将RXTXcomm.jar复制到<JAVA_HOME>\jre\lib\ext目录下
• 到eclipse中右击项目--->Build Path---> Configure Build Path --> Libraries --> Add External JARs...--->找到<JAVA_HOME>/jre/lib/ext目录下的RXTXcomm.jar--->打开-->OK。
• 到此为止所有的准备工作都已经做完了，开始学习吧！

API概述

• 接口

• CommDriver 可负载设备（the loadable device）驱动程序接口的一部分
• CommPortOwnershipListener 传递各种通讯端口的所有权事件
• ParallelPortEventListener 传递并行端口事件
• SerialPortEventListener 传递串行端口事件

• 类

• CommPort 通讯端口 CommDriver 可负载设备（the loadable device）驱动程序接口的一部分
• CommPortOwnershipListener 传递各种通讯端口的所有权事件
• ParallelPortEventListener 传递并行端口事件
• SerialPortEventListener 传递串行端口事件

• SerialPortEvent 异常类

• NoSuchPortException 当驱动程序不能找到指定端口时抛出
• PortInUseException 当碰到指定端口正在使用中时抛出
• UnsupportedCommOperationException 驱动程序不允许指定操作时抛出

重要类详述

CommPort类

• 描述被底层系统支持的端口的抽象类。包含一些高层的IO控制方法，这些方法对于所有不同的通讯端口来说是通用的。SerialPort（串口） 和ParallelPort（并口）都是它的子类。

CommPortIdentifier

• 主要用于对串口进行管理和设置，是对串口进行访问控制的核心类。主要方法如下：
  

  addPortName(String, int, CommDriver) 添加端口名到端口列表里addPortOwnershipListener(CommPortOwnershipListener) 添加端口拥有的监听器removePortOwnershipListener(CommPortOwnershipListener) 移除端口拥有的监听器getCurrentOwner() 得到当前占有端口的对象或应用程序getName() 得到端口名称getPortIdentifier(CommPort) 得到参数打开的端口的CommPortIdentifier类型对象getPortIdentifier(String) 得到以参数命名的端口的CommPortIdentifier类型对象getPortIdentifiers() 得到系统中的端口列表getPortType() 得到端口的类型isCurrentlyOwned() 判断当前端口是否被占用open(FileDescriptor) 用文件描述的类型打开端口open(String, int) 打开端口,两个参数：程序名称,延迟时间(毫秒数)

  
  
  

SerialPort

• 描述RS-232串行通信端口的底层接口，它定义了串口通信所需的最小功能集。可以直接对串口进行读、写及设置工作。
• 串口参数的函数
  

  getBaudRate() 得到波特率getParity() 得到检验类型getDataBits() 得到数据位数 getStopBits() 得到停止位数setSerialPortParams(int, int, int, int) 设置串口参数依次为(波特率,数据位,停止位,奇偶检验)close() 关闭串口getOutputStream() 得到OutputStream类型的输出流getInputStream() 得到InputStream类型的输入流

  
  

• 事件及事件方法
  

  isCD() 是否有载波isCTS() 是否清除发送isDSR() 数据是否准备就绪isDTR() 数据终端是否准备就绪isRI() 是否响铃侦测isRTS()   是否要求发送addEventListener(SerialPortEventListener)    向SerialPort对象中添加串口事件监听器removeEventListener() 移除SerialPort对象中的串口事件监听器getEventType() 得到发生的事件类型返回值为int型sendBreak(int) 设置中断过程的时间，参数为毫秒值setRTS(boolean) 设置或清除RTS位setDTR(boolean) 设置或清除DTR位notifyOnBreakInterrupt(boolean) 设置中断事件notifyOnCarrierDetect(boolean) 设置载波监听事件notifyOnCTS(boolean) 设置清除发送事件notifyOnDataAvailable(boolean) 设置串口有数据的事件notifyOnDSR(boolean) 设置数据备妥事件notifyOnFramingError(boolean) 设置发生错误事件notifyOnOutputEmpty(boolean) 设置发送缓冲区为空事件notifyOnParityError(boolean) 设置发生奇偶检验错误事件notifyOnRingIndicator(boolean) 设置响铃侦测事件

  
  

• 串口参数的静态成员变量
  

  成员变量      说明       成员变量      说明       成员变量      说明DATABITS_5  数据位为5  STOPBITS_2    停止位为2  PARITY_ODD    奇检验DATABITS_6  数据位为6  STOPBITS_1    停止位为1  PARITY_MARK   标记检验DATABITS_7  数据位为7  STOPBITS_1_5  停止为1.5  PARITY_NONE   空格检验DATABITS_8  数据位为8  PARITY_EVEN   偶检验     PARITY_SPACE  无检验

  
  

参考代码：

package Dao;import java.io.IOException;import java.io.InputStream;import java.io.OutputStream;import java.util.Enumeration;import java.util.HashSet;import java.util.Set;import java.util.TooManyListenersException;import gnu.io.CommPortIdentifier;import gnu.io.PortInUseException;import gnu.io.SerialPort;import gnu.io.SerialPortEvent;import gnu.io.SerialPortEventListener;import gnu.io.UnsupportedCommOperationException;public class SerialPortDao implements Runnable, SerialPortEventListener {private static boolean isOpen=false;static Set<CommPortIdentifier> portList=new HashSet<CommPortIdentifier>();final static String appName="MyApp";private static InputStream is;private static OutputStream os;private static SerialPort serialPort;byte[] readBuffer=new byte[100];public Set<CommPortIdentifier> getPortList(){Enumeration tempPortList;  //枚举类CommPortIdentifier portIp;tempPortList=CommPortIdentifier.getPortIdentifiers();/*不带参数的getPortIdentifiers方法获得一个枚举对象，该对象又包含了系统中管理每个端口的CommPortIdentifier对象。 * 注意这里的端口不仅仅是指串口，也包括并口。 * 这个方法还可以带参数。 * getPortIdentifiers(CommPort)获得与已经被应用程序打开的端口相对应的CommPortIdentifier对象。  * getPortIdentifier(String portName)获取指定端口名（比如“COM1”）的CommPortIdentifier对象。 */while(tempPortList.hasMoreElements()){//在这里可以调用getPortType方法返回端口类型，串口为CommPortIdentifier.PORT_SERIALportIp=(CommPortIdentifier) tempPortList.nextElement();portList.add(portIp);}return portList;}public boolean openSerialPort(CommPortIdentifier portIp,int delay){try {serialPort=(SerialPort) portIp.open(appName, delay);/* open方法打开通讯端口，获得一个CommPort对象。它使程序独占端口。 * 如果端口正被其他应用程序占用，将使用 CommPortOwnershipListener事件机制，传递一个PORT_OWNERSHIP_REQUESTED事件。 * 每个端口都关联一个 InputStream 和一个OutputStream。 * 如果端口是用open方法打开的，那么任何的getInputStream都将返回相同的数据流对象，除非有close 被调用。 * 有两个参数，第一个为应用程序名；第二个参数是在端口打开时阻塞等待的毫秒数。 */} catch (PortInUseException e) {return false;}try {is=serialPort.getInputStream();/*获取端口的输入流对象*/os=serialPort.getOutputStream();/*获取端口的输出流对象*/} catch (IOException e) {return false;}try {serialPort.addEventListener(this);/*注册一个SerialPortEventListener事件来监听串口事件*/} catch (TooManyListenersException e) {return false;}serialPort.notifyOnDataAvailable(true);/*数据可用*/try {/*设置串口初始化参数，依次是波特率，数据位，停止位和校验*/serialPort.setSerialPortParams(4800, SerialPort.DATABITS_8,SerialPort.STOPBITS_1 , SerialPort.PARITY_NONE);} catch (UnsupportedCommOperationException e) {return false;}return true;}public boolean closeSerialPort(){if(isOpen){try {is.close();os.close();serialPort.notifyOnDataAvailable(false);serialPort.removeEventListener();serialPort.close();isOpen = false;} catch (IOException e) {return false;}}return true;}public boolean sendMessage(String message){try {os.write(message.getBytes());} catch (IOException e) {return false;}return true;}@Overridepublic void serialEvent(SerialPortEvent event) {/* * 此处省略一下事件，可酌情添加 *  SerialPortEvent.BI:/*Break interrupt,通讯中断 *  SerialPortEvent.OE:/*Overrun error，溢位错误 *  SerialPortEvent.FE:/*Framing error，传帧错误 *  SerialPortEvent.PE:/*Parity error，校验错误 *  SerialPortEvent.CD:/*Carrier detect，载波检测  *  SerialPortEvent.CTS:/*Clear to send，清除发送  *  SerialPortEvent.DSR:/*Data set ready，数据设备就绪 *  SerialPortEvent.RI:/*Ring indicator，响铃指示 *  SerialPortEvent.OUTPUT_BUFFER_EMPTY:/*Output buffer is empty，输出缓冲区清空 */if(event.getEventType()==SerialPortEvent.DATA_AVAILABLE){/*Data available at the serial port，端口有可用数据。读到缓冲数组，输出到终端*/try {while(is.available()>0){is.read(readBuffer);//收到的数据再此，可视情况处理}SPCommandDao.startDoMessage(new String (readBuffer));//这一句是我的自定义类，处理接受到的信息，可删除} catch (IOException e) {}}}@Overridepublic void run() {try {Thread.sleep(50);//每次收发数据完毕后线程暂停50ms} catch (InterruptedException e) {e.printStackTrace();}}}