All Packages Class Hierarchy This Package Previous Next Index
Class javax.comm.SerialPort
java.lang.Object
|
+----javax.comm.CommPort
|
+----javax.comm.SerialPort
- public abstract class SerialPort
- extends CommPort
An RS-232 serial communications port. SerialPort
describes
the low-level interface to a serial communications port made available
by the underlying system. SerialPort
defines the minimum
required functionality for serial communications ports.
- See Also:
- CommPort, CommPortIdentifier
-
DATABITS_5
- 5 data bit format.
-
DATABITS_6
- 6 data bit format.
-
DATABITS_7
- 7 data bit format.
-
DATABITS_8
- 8 data bit format.
-
FLOWCTRL_NONE
- Flow control off.
-
FLOWCTRL_RTSCTS_IN
- RTS/CTS flow control on input.
-
FLOWCTRL_RTSCTS_OUT
- RTS/CTS flow control on output.
-
FLOWCTRL_XONXOFF_IN
- XON/XOFF flow control on input.
-
FLOWCTRL_XONXOFF_OUT
- XON/XOFF flow control on output.
-
PARITY_EVEN
- EVEN parity scheme.
-
PARITY_MARK
- MARK parity scheme.
-
PARITY_NONE
- No parity bit.
-
PARITY_ODD
- ODD parity scheme.
-
PARITY_SPACE
- SPACE parity scheme.
-
STOPBITS_1
- Number of STOP bits - 1.
-
STOPBITS_1_5
-
Number of STOP bits - 1-1/2.
-
STOPBITS_2
- Number of STOP bits - 2.
-
SerialPort()
-
-
addEventListener(SerialPortEventListener)
- Registers a
SerialPortEventListener
object to listen
for SerialEvent
s.
-
getBaudrate()
- Gets the currently configured baud rate.
-
getDataBits()
- Gets the currently configured number of data bits.
-
getFlowcontrolMode()
- Gets the currently configured flow control mode.
-
getParity()
- Get the currently configured parity setting.
-
getStopBits()
- Gets the currently defined stop bits.
-
isCD()
- Gets the state of the CD (Carrier Detect) bit in the UART.
-
isCTS()
- Gets the state of the CTS (Clear To Send) bit in the UART.
-
isDSR()
- Gets the state of the DSR (Data Set Ready) bit in the UART.
-
isDTR()
- Gets the state of the DTR (Data Terminal Ready) bit in the UART.
-
isRI()
- Gets the state of the RI (Ring Indicator) bit in the UART.
-
isRTS()
- Gets the state of the RTS (Request To Send) bit in the UART.
-
notifyOnBreakInterrupt(boolean)
- Expresses interest in receiving notification
when there is a break interrupt on the line.
-
notifyOnCarrierDetect(boolean)
- Expresses interest in receiving notification
when the CD (Carrier Detect) bit changes.
-
notifyOnCTS(boolean)
- Expresses interest in receiving notification
when the CTS (Clear To Send) bit changes.
-
notifyOnDataAvailable(boolean)
- Expresses interest in receiving notification when input data is available.
-
notifyOnDSR(boolean)
- Expresses interest in receiving notification
when the DSR (Data Set Ready) bit changes.
-
notifyOnFramingError(boolean)
- Expresses interest in receiving notification
when there is a framing error.
-
notifyOnOutputEmpty(boolean)
- Expresses interest in receiving notification when the output buffer
is empty.
-
notifyOnOverrunError(boolean)
- Expresses interest in receiving notification
when there is an overrun error.
-
notifyOnParityError(boolean)
- Expresses interest in receiving notification
when there is a parity error.
-
notifyOnRingIndicator(boolean)
- Expresses interest in receiving notification
when the RI (Ring Indicator) bit changes.
-
removeEventListener()
- Deregisters event listener registered using
addEventListener
.
-
sendBreak(int)
- Sends a break of
millis
milliseconds duration.
-
setDTR(boolean)
- Sets or clears the DTR (Data Terminal Ready) bit in the UART.
-
setFlowcontrolMode(int)
- Sets the flow control mode.
-
setRcvFifoTrigger(int)
- Set the Receive Fifo trigger level
If the uart has a FIFO and if it can have programmable trigger levels,
then this method will cause the uart to raise an interrupt after trigger
bytes have been received.
Deprecated.
-
setRTS(boolean)
- Sets or clears the RTS (Request To Send) bit in the UART.
-
setSerialPortParams(int, int, int, int)
- Sets serial port parameters.
DATABITS_5
public static final int DATABITS_5
- 5 data bit format.
DATABITS_6
public static final int DATABITS_6
- 6 data bit format.
DATABITS_7
public static final int DATABITS_7
- 7 data bit format.
DATABITS_8
public static final int DATABITS_8
- 8 data bit format.
STOPBITS_1
public static final int STOPBITS_1
- Number of STOP bits - 1.
STOPBITS_2
public static final int STOPBITS_2
- Number of STOP bits - 2.
STOPBITS_1_5
public static final int STOPBITS_1_5
- Number of STOP bits - 1-1/2. Some UARTs permit 1-1/2 STOP
bits only with 5 data bit format, but permit 1 or 2 STOP bits with any
format.
PARITY_NONE
public static final int PARITY_NONE
- No parity bit.
PARITY_ODD
public static final int PARITY_ODD
- ODD parity scheme. The parity bit is added so there are an odd
number of TRUE bits.
PARITY_EVEN
public static final int PARITY_EVEN
- EVEN parity scheme. The parity bit is added so there are an even
number of TRUE bits.
PARITY_MARK
public static final int PARITY_MARK
- MARK parity scheme.
PARITY_SPACE
public static final int PARITY_SPACE
- SPACE parity scheme.
FLOWCTRL_NONE
public static final int FLOWCTRL_NONE
- Flow control off.
FLOWCTRL_RTSCTS_IN
public static final int FLOWCTRL_RTSCTS_IN
- RTS/CTS flow control on input.
FLOWCTRL_RTSCTS_OUT
public static final int FLOWCTRL_RTSCTS_OUT
- RTS/CTS flow control on output.
FLOWCTRL_XONXOFF_IN
public static final int FLOWCTRL_XONXOFF_IN
- XON/XOFF flow control on input.
FLOWCTRL_XONXOFF_OUT
public static final int FLOWCTRL_XONXOFF_OUT
- XON/XOFF flow control on output.
SerialPort
public SerialPort()
getBaudrate
public abstract int getBaudrate()
- Gets the currently configured baud rate.
- Returns:
- integer value indicating the baud rate
getDataBits
public abstract int getDataBits()
- Gets the currently configured number of data bits.
- Returns:
- integer that can be equal to DATABITS_5, DATABITS_6,
DATABITS_7, or DATABITS_8
getStopBits
public abstract int getStopBits()
- Gets the currently defined stop bits.
- Returns:
- integer that can be equal to STOPBITS_1,
STOPBITS_2, or STOPBITS_1_5
getParity
public abstract int getParity()
- Get the currently configured parity setting.
- Returns:
- integer that can be equal to PARITY_NONE,
PARITY_ODD, PARITY_EVEN, PARITY_MARK or PARITY_SPACE.
sendBreak
public abstract void sendBreak(int millis)
- Sends a break of
millis
milliseconds duration.
Note that it may not be possible to time the duration of the break
under certain Operating Systems. Hence this parameter is advisory.
- Parameters:
- millis - duration of break to send
setFlowcontrolMode
public abstract void setFlowcontrolMode(int flowcontrol)
- Sets the flow control mode.
- Parameters:
- flow - control Can be a bitmask combination of
-
FLOWCTRL_NONE: no flow control
-
FLOWCTRL_RTSCTS_IN: RTS/CTS (hardware) flow control for input
-
FLOWCTRL_RTSCTS_OUT: RTS/CTS (hardware) flow control for output
-
FLOWCTRL_XONXOFF_IN: XON/XOFF (software) flow control for input
-
FLOWCTRL_XONXOFF_OUT: XON/XOFF (software) flow control for output
getFlowcontrolMode
public abstract int getFlowcontrolMode()
- Gets the currently configured flow control mode.
- Returns:
- an integer bitmask of the modes FLOWCTRL_NONE,
FLOWCTRL_RTSCTS_IN, FLOWCTRL_RTSCTS_OUT,
FLOWCTRL_XONXOFF_IN, and FLOWCTRL_XONXOFF_OUT.
setRcvFifoTrigger
public void setRcvFifoTrigger(int trigger)
- Note: setRcvFifoTrigger() is deprecated.
This was advisory only.
- Set the Receive Fifo trigger level
If the uart has a FIFO and if it can have programmable trigger levels,
then this method will cause the uart to raise an interrupt after trigger
bytes have been received.
- Parameters:
- trigger - level
setSerialPortParams
public abstract void setSerialPortParams(int baudrate,
int dataBits,
int stopBits,
int parity) throws UnsupportedCommOperationException
- Sets serial port parameters.
- Parameters:
- baudrate
- If the baudrate passed in by the application is unsupported by the
driver, the driver will throw an UnsupportedCommOperationException
- dataBits
-
-
DATABITS_5: 5 bits
-
DATABITS_6: 6 bits
-
DATABITS_7: 7 bits
-
DATABITS_8: 8 bits
- stopBits
-
-
STOPBITS_1: 1 stop bit
-
STOPBITS_2: 2 stop bits
-
STOPBITS_1_5: 1.5 stop bits
- parity
-
-
PARITY_NONE: no parity
-
PARITY_ODD: odd parity
-
PARITY_EVEN: even parity
- Throws: UnsupportedCommOperationException
- if any of the
above parameters are specified incorrectly.
All four of the parameters will revert to the
values before the call was made.
DEFAULT: 9600 baud, 8 data bits, 1 stop bit, no parity
setDTR
public abstract void setDTR(boolean dtr)
- Sets or clears the DTR (Data Terminal Ready) bit in the UART.
- Parameters:
- dtr
-
-
true: set DTR
-
true: clear DTR
isDTR
public abstract boolean isDTR()
- Gets the state of the DTR (Data Terminal Ready) bit in the UART.
setRTS
public abstract void setRTS(boolean rts)
- Sets or clears the RTS (Request To Send) bit in the UART.
- Parameters:
- rts
-
-
true: set RTS
-
true: clear RTS
isRTS
public abstract boolean isRTS()
- Gets the state of the RTS (Request To Send) bit in the UART.
isCTS
public abstract boolean isCTS()
- Gets the state of the CTS (Clear To Send) bit in the UART.
isDSR
public abstract boolean isDSR()
- Gets the state of the DSR (Data Set Ready) bit in the UART.
isRI
public abstract boolean isRI()
- Gets the state of the RI (Ring Indicator) bit in the UART.
isCD
public abstract boolean isCD()
- Gets the state of the CD (Carrier Detect) bit in the UART.
addEventListener
public abstract void addEventListener(SerialPortEventListener lsnr)
- Registers a
SerialPortEventListener
object to listen
for SerialEvent
s. Interest in specific events may
be expressed using the notifyOnXXX
calls. The
serialEvent
method of SerialPortEventListener
will be called with a SerialEvent
object describing
the event.
- Parameters:
- lsnr - The
SerialPortEventListener
object
whose serialEvent
method will be called
with a SerialEvent
describing the event.
removeEventListener
public abstract void removeEventListener()
- Deregisters event listener registered using
addEventListener
.
This is done automatically at port close.
notifyOnDataAvailable
public abstract void notifyOnDataAvailable(boolean enable)
- Expresses interest in receiving notification when input data is available.
This may be used to drive asynchronous input. When data is
available in the input buffer, this event is propagated to
the listener registered using
addEventListener
.
- Parameters:
- enable
-
-
true: enable notification
-
false: disable notification
notifyOnOutputEmpty
public abstract void notifyOnOutputEmpty(boolean enable)
- Expresses interest in receiving notification when the output buffer
is empty. This may be used to drive asynchronous output. When the
output buffer becomes empty, this event is propagated to the listener
registered using
addEventListener
.
- Parameters:
- enable
-
-
true: enable notification
-
false: disable notification
notifyOnCTS
public abstract void notifyOnCTS(boolean enable)
- Expresses interest in receiving notification
when the CTS (Clear To Send) bit changes.
- Parameters:
- enable
-
-
true: enable notification
-
false: disable notification
notifyOnDSR
public abstract void notifyOnDSR(boolean enable)
- Expresses interest in receiving notification
when the DSR (Data Set Ready) bit changes.
- Parameters:
- enable
-
-
true: enable notification
-
false: disable notification
notifyOnRingIndicator
public abstract void notifyOnRingIndicator(boolean enable)
- Expresses interest in receiving notification
when the RI (Ring Indicator) bit changes.
- Parameters:
- enable
-
-
true: enable notification
-
false: disable notification
notifyOnCarrierDetect
public abstract void notifyOnCarrierDetect(boolean enable)
- Expresses interest in receiving notification
when the CD (Carrier Detect) bit changes.
- Parameters:
- enable
-
-
true: enable notification
-
false: disable notification
notifyOnOverrunError
public abstract void notifyOnOverrunError(boolean enable)
- Expresses interest in receiving notification
when there is an overrun error.
- Parameters:
- enable
-
-
true: enable notification
-
false: disable notification
notifyOnParityError
public abstract void notifyOnParityError(boolean enable)
- Expresses interest in receiving notification
when there is a parity error.
- Parameters:
- enable
-
-
true: enable notification
-
false: disable notification
notifyOnFramingError
public abstract void notifyOnFramingError(boolean enable)
- Expresses interest in receiving notification
when there is a framing error.
- Parameters:
- enable
-
-
true: enable notification
-
false: disable notification
notifyOnBreakInterrupt
public abstract void notifyOnBreakInterrupt(boolean enable)
- Expresses interest in receiving notification
when there is a break interrupt on the line.
- Parameters:
- enable
-
-
true: enable notification
-
false: disable notification
All Packages Class Hierarchy This Package Previous Next Index