org.harctoolbox.harchardware.comm

Class LocalSerialPort

java.lang.Object

org.harctoolbox.harchardware.comm.LocalSerialPort

All Implemented Interfaces:

Closeable, AutoCloseable, IHarcHardware

Direct Known Subclasses:

LocalSerialPortBuffered, LocalSerialPortRaw

public abstract class LocalSerialPort
extends Object
implements IHarcHardware

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	LocalSerialPort.FlowControl
static class	LocalSerialPort.Parity

Field Summary

Fields

Modifier and Type	Field and Description
static String	defaultPort
protected InputStream	inStream
protected OutputStream	outStream
protected boolean	verbose

Constructor Summary

Constructors

Constructor and Description
LocalSerialPort(int portNumber)
LocalSerialPort(String portName)
LocalSerialPort(String portName, int baud)
LocalSerialPort(String portName, int baud, int length, int stopBits, LocalSerialPort.Parity parity, LocalSerialPort.FlowControl flowControl, int timeout)

Method Summary

Modifier and Type	Method and Description
void	close()
void	dropDTR(int duration)
void	flush()
void	flushInput()
String	getPortName() Returns the nominal port name being used.
static String	getSerialPortName(int portNumber)
static ArrayList<String>	getSerialPortNames(boolean useCached) Returns all serial port names found in the system.
String	getVersion() Returns the hardware version (not the version of the driver software).
boolean	isValid() Tries to identify instances that are not valid.
void	open() Opens the device.
void	setDTR(boolean state)
void	setTimeout(int timeout) Set timeout in milliseconds.
void	setVerbosity(boolean verbosity) Sets a verbosity flag, causing commands to be executed verbosely.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.harctoolbox.harchardware.IHarcHardware

setDebug

Field Detail

defaultPort

public static final String defaultPort

See Also:

Constant Field Values

inStream

protected InputStream inStream

outStream

protected OutputStream outStream

verbose

protected boolean verbose

Constructor Detail

LocalSerialPort

public LocalSerialPort(String portName,
                       int baud,
                       int length,
                       int stopBits,
                       LocalSerialPort.Parity parity,
                       LocalSerialPort.FlowControl flowControl,
                       int timeout)
                throws NoSuchPortException,
                       PortInUseException,
                       UnsupportedCommOperationException,
                       IOException

Throws:

NoSuchPortException

PortInUseException

UnsupportedCommOperationException

IOException

LocalSerialPort

public LocalSerialPort(String portName,
                       int baud)
                throws NoSuchPortException,
                       PortInUseException,
                       UnsupportedCommOperationException,
                       IOException

Throws:

NoSuchPortException

PortInUseException

UnsupportedCommOperationException

IOException

LocalSerialPort

public LocalSerialPort(String portName)
                throws NoSuchPortException,
                       PortInUseException,
                       UnsupportedCommOperationException,
                       IOException

Throws:

NoSuchPortException

PortInUseException

UnsupportedCommOperationException

IOException

LocalSerialPort

public LocalSerialPort(int portNumber)
                throws IOException,
                       NoSuchPortException,
                       PortInUseException,
                       UnsupportedCommOperationException

Throws:

IOException

NoSuchPortException

PortInUseException

UnsupportedCommOperationException

Method Detail

getSerialPortName

public static String getSerialPortName(int portNumber)
                                throws IOException,
                                       NoSuchPortException

Throws:

IOException

NoSuchPortException

getSerialPortNames

public static ArrayList<String> getSerialPortNames(boolean useCached)
                                            throws IOException

Returns all serial port names found in the system.

Parameters:

useCached - If true, use previously acquired list, if available

Returns:

ArrayList<String>

Throws:

IOException

setVerbosity

public void setVerbosity(boolean verbosity)

Description copied from interface: IHarcHardware

Sets a verbosity flag, causing commands to be executed verbosely. Exact semantic depends on the implementation.

Specified by:

setVerbosity in interface IHarcHardware

Parameters:

verbosity - on or off

open

public void open()
          throws HarcHardwareException,
                 IOException

Opens the device.

Specified by:

open in interface IHarcHardware

Throws:

HarcHardwareException - Bundles RXTX exceptions together.

IOException

flushInput

public void flushInput()
                throws IOException

Throws:

IOException

isValid

public boolean isValid()

Description copied from interface: IHarcHardware

Tries to identify instances that are not valid. Exact meaning can vary.

Specified by:

isValid in interface IHarcHardware

Returns:

validity of the instance.

setTimeout

public void setTimeout(int timeout)
                throws IOException

Description copied from interface: IHarcHardware

Set timeout in milliseconds. Exact semantics may be dependent on the hardware.

Specified by:

setTimeout in interface IHarcHardware

Parameters:

timeout - Timeout in milliseconds.

Throws:

IOException

getVersion

public String getVersion()

Description copied from interface: IHarcHardware

Returns the hardware version (not the version of the driver software). May be null if no relevant information available.

Specified by:

getVersion in interface IHarcHardware

Returns:

Version string. Semantics can vary.

getPortName

public String getPortName()

Returns the nominal port name being used. May differ from one requested in the constructor if the device was opened with open(true), or if it is symlink (for example created by udev).

Returns:

port name used.

close

public void close()

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

flush

public void flush()
           throws IOException

Throws:

IOException

setDTR

public void setDTR(boolean state)

dropDTR

public void dropDTR(int duration)