gnu.io.SerialPort Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of rxtxcomm Show documentation
Show all versions of rxtxcomm Show documentation
RXTX is a native lib providing serial and parallel communication for the Java Development Toolkit (JDK).
This version of RXTXcomm is based on create-lab-commons fork. See http://code.google.com/p/create-lab-commons/source/browse/trunk/java/lib/rxtx/README.txt
The newest version!
/*-------------------------------------------------------------------------
| RXTX License v 2.1 - LGPL v 2.1 + Linking Over Controlled Interface.
| RXTX is a native interface to serial ports in java.
| Copyright 1997-2007 by Trent Jarvi [email protected] and others who
| actually wrote it. See individual source files for more information.
|
| A copy of the LGPL v 2.1 may be found at
| http://www.gnu.org/licenses/lgpl.txt on March 4th 2007. A copy is
| here for your convenience.
|
| This library is free software; you can redistribute it and/or
| modify it under the terms of the GNU Lesser General Public
| License as published by the Free Software Foundation; either
| version 2.1 of the License, or (at your option) any later version.
|
| This library is distributed in the hope that it will be useful,
| but WITHOUT ANY WARRANTY; without even the implied warranty of
| MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
| Lesser General Public License for more details.
|
| An executable that contains no derivative of any portion of RXTX, but
| is designed to work with RXTX by being dynamically linked with it,
| is considered a "work that uses the Library" subject to the terms and
| conditions of the GNU Lesser General Public License.
|
| The following has been added to the RXTX License to remove
| any confusion about linking to RXTX. We want to allow in part what
| section 5, paragraph 2 of the LGPL does not permit in the special
| case of linking over a controlled interface. The intent is to add a
| Java Specification Request or standards body defined interface in the
| future as another exception but one is not currently available.
|
| http://www.fsf.org/licenses/gpl-faq.html#LinkingOverControlledInterface
|
| As a special exception, the copyright holders of RXTX give you
| permission to link RXTX with independent modules that communicate with
| RXTX solely through the Sun Microsytems CommAPI interface version 2,
| regardless of the license terms of these independent modules, and to copy
| and distribute the resulting combined work under terms of your choice,
| provided that every copy of the combined work is accompanied by a complete
| copy of the source code of RXTX (the version of RXTX used to produce the
| combined work), being distributed under the terms of the GNU Lesser General
| Public License plus this exception. An independent module is a
| module which is not derived from or based on RXTX.
|
| Note that people who make modified versions of RXTX are not obligated
| to grant this special exception for their modified versions; it is
| their choice whether to do so. The GNU Lesser General Public License
| gives permission to release a modified version without this exception; this
| exception also makes it possible to release a modified version which
| carries forward this exception.
|
| You should have received a copy of the GNU Lesser General Public
| License along with this library; if not, write to the Free
| Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
| All trademarks belong to their respective owners.
--------------------------------------------------------------------------*/
package gnu.io;
import java.io.*;
import java.util.*;
/**
* @author Trent Jarvi
* @version %I%, %G%
* @since JDK1.0
*/
public abstract class SerialPort extends CommPort {
public static final int DATABITS_5 =5;
public static final int DATABITS_6 =6;
public static final int DATABITS_7 =7;
public static final int DATABITS_8 =8;
public static final int PARITY_NONE =0;
public static final int PARITY_ODD =1;
public static final int PARITY_EVEN =2;
public static final int PARITY_MARK =3;
public static final int PARITY_SPACE =4;
public static final int STOPBITS_1 =1;
public static final int STOPBITS_2 =2;
public static final int STOPBITS_1_5 =3;
public static final int FLOWCONTROL_NONE =0;
public static final int FLOWCONTROL_RTSCTS_IN =1;
public static final int FLOWCONTROL_RTSCTS_OUT =2;
public static final int FLOWCONTROL_XONXOFF_IN =4;
public static final int FLOWCONTROL_XONXOFF_OUT=8;
public abstract void setSerialPortParams( int b, int d, int s, int p )
throws UnsupportedCommOperationException;
public abstract int getBaudRate();
public abstract int getDataBits();
public abstract int getStopBits();
public abstract int getParity();
public abstract void setFlowControlMode( int flowcontrol )
throws UnsupportedCommOperationException;
public abstract int getFlowControlMode();
public abstract boolean isDTR();
public abstract void setDTR( boolean state );
public abstract void setRTS( boolean state );
public abstract boolean isCTS();
public abstract boolean isDSR();
public abstract boolean isCD();
public abstract boolean isRI();
public abstract boolean isRTS();
public abstract void sendBreak( int duration );
public abstract void addEventListener( SerialPortEventListener lsnr )
throws TooManyListenersException;
public abstract void removeEventListener();
public abstract void notifyOnDataAvailable( boolean enable );
public abstract void notifyOnOutputEmpty( boolean enable );
public abstract void notifyOnCTS( boolean enable );
public abstract void notifyOnDSR( boolean enable );
public abstract void notifyOnRingIndicator( boolean enable );
public abstract void notifyOnCarrierDetect( boolean enable );
public abstract void notifyOnOverrunError( boolean enable );
public abstract void notifyOnParityError( boolean enable );
public abstract void notifyOnFramingError( boolean enable );
public abstract void notifyOnBreakInterrupt( boolean enable );
/*
public abstract void setRcvFifoTrigger(int trigger);
deprecated
*/
/* ---------------------- end of commapi ------------------------ */
/*
can't have static abstract?
public abstract static boolean staticSetDTR( String port, boolean flag )
throws UnsupportedCommOperationException;
public abstract static boolean staticSetRTS( String port, boolean flag )
throws UnsupportedCommOperationException;
*/
public abstract byte getParityErrorChar( )
throws UnsupportedCommOperationException;
public abstract boolean setParityErrorChar( byte b )
throws UnsupportedCommOperationException;
public abstract byte getEndOfInputChar( )
throws UnsupportedCommOperationException;
public abstract boolean setEndOfInputChar( byte b )
throws UnsupportedCommOperationException;
public abstract boolean setUARTType(String type, boolean test)
throws UnsupportedCommOperationException;
public abstract String getUARTType()
throws UnsupportedCommOperationException;
public abstract boolean setBaudBase(int BaudBase)
throws UnsupportedCommOperationException,
IOException;
public abstract int getBaudBase()
throws UnsupportedCommOperationException,
IOException;
public abstract boolean setDivisor(int Divisor)
throws UnsupportedCommOperationException,
IOException;
public abstract int getDivisor()
throws UnsupportedCommOperationException,
IOException;
public abstract boolean setLowLatency()
throws UnsupportedCommOperationException;
public abstract boolean getLowLatency()
throws UnsupportedCommOperationException;
public abstract boolean setCallOutHangup(boolean NoHup)
throws UnsupportedCommOperationException;
public abstract boolean getCallOutHangup()
throws UnsupportedCommOperationException;
}