jmri.jmrix
Interface SerialPortAdapter

All Superinterfaces:

PortAdapter

All Known Implementing Classes:

AbstractPortController, AcelaPortController, EasyDccPortController, EliteAdapter, GcPortController, GcSerialDriverAdapter, IntelliboxAdapter, LI100Adapter, LI100Adapter, LI101Adapter, LIUSBAdapter, LnHexFilePort, LnPortController, LnTcpDriverAdapter, LocoBufferAdapter, LocoBufferIIAdapter, LocoBufferUsbAdapter, MrcPortController, MS100Adapter, Mx1Adapter, Mx1PortController, NcePortController, NetworkDriverAdapter, NetworkDriverAdapter, NetworkDriverAdapter, Port, PortController, PortController, PR2Adapter, PR3Adapter, QsiPortController, SerialAdapter, SerialDriverAdapter, SerialDriverAdapter, SerialDriverAdapter, SerialDriverAdapter, SerialDriverAdapter, SerialDriverAdapter, SerialDriverAdapter, SerialDriverAdapter, SerialDriverAdapter, SerialDriverAdapter, SerialDriverAdapter, SerialDriverAdapter, SerialDriverAdapter, SerialDriverAdapter, SerialDriverAdapter, SerialDriverAdapter, SerialDriverAdapter, SerialDriverAdapter, SerialDriverAdapter, SerialDriverAdapter, SerialDriverAdapter, SerialDriverAdapter, SerialDriverAdapter, SerialPortController, SerialPortController, SerialPortController, SerialPortController, SerialPortController, SerialPortController, SerialPortController, SerialSensorAdapter, SprogPortController, SRCPPortController, UsbDriverAdapter, XNetPortController, XnTcpAdapter, XpaPortController, ZTC640Adapter

public interface SerialPortAdapter
extends PortAdapter

Enables basic setup of a serial interface for a jmrix implementation.

Author:

Bob Jacobsen Copyright (C) 2001, 2003, 2008

See Also:

SerialConfigException

Method Summary

void	configure() Configure all of the other jmrix widgets needed to work with this adapter
void	configureBaudRate(String rate) Set the baud rate.
void	configureOption1(String value) Set the first port option.
void	configureOption2(String value) Set the second port option.
String	getCurrentBaudRate()
String	getCurrentOption1Setting()
String	getCurrentOption2Setting() Get current option 2 value
String	getCurrentPortName()
Vector	getPortNames() Provide a vector of valid port names, each a String.
String	handlePortBusy(javax.comm.PortInUseException p, String portName, org.apache.log4j.Category log) Error handling for busy port at open.
String	openPort(String portName, String appName) Open a specified port.
String	option1Name() Get a String that says what Option 1 represents May be an empty string, but will not be null
String	option2Name() Get a String that says what Option 2 represents May be an empty string, but will not be null
void	setPort(String s) Remember the associated port name
boolean	status() Query the status of this connection.
String[]	validBaudRates() Get an array of valid baud rates; used to display valid options.
String[]	validOption1() Get an array of valid values for "option 1"; used to display valid options.
String[]	validOption2() Get an array of valid values for "option 2"; used to display valid options.

Method Detail

getPortNames

Vector getPortNames()

Provide a vector of valid port names, each a String.

openPort

String openPort(String portName,
                String appName)

Open a specified port. The appname argument is to be provided to the underlying OS during startup so that it can show on status displays, etc

configure

void configure()

Configure all of the other jmrix widgets needed to work with this adapter

Specified by:

configure in interface PortAdapter

status

boolean status()

Query the status of this connection. If all OK, at least as far as is known, return true

Specified by:

status in interface PortAdapter

setPort

void setPort(String s)

Remember the associated port name

Parameters:

s -

getCurrentPortName

String getCurrentPortName()

validBaudRates

String[] validBaudRates()

Get an array of valid baud rates; used to display valid options.

configureBaudRate

void configureBaudRate(String rate)

Set the baud rate. Only to be used after construction, but before the openPort call.

getCurrentBaudRate

String getCurrentBaudRate()

validOption1

String[] validOption1()

Get an array of valid values for "option 1"; used to display valid options. May not be null, but may have zero entries

option1Name

String option1Name()

Get a String that says what Option 1 represents May be an empty string, but will not be null

configureOption1

void configureOption1(String value)

Set the first port option. Only to be used after construction, but before the openPort call

getCurrentOption1Setting

String getCurrentOption1Setting()

validOption2

String[] validOption2()

Get an array of valid values for "option 2"; used to display valid options. May not be null, but may have zero entries

option2Name

String option2Name()

Get a String that says what Option 2 represents May be an empty string, but will not be null

configureOption2

void configureOption2(String value)

Set the second port option. Only to be used after construction, but before the openPort call

getCurrentOption2Setting

String getCurrentOption2Setting()

Get current option 2 value

handlePortBusy

String handlePortBusy(javax.comm.PortInUseException p,
                      String portName,
                      org.apache.log4j.Category log)

Error handling for busy port at open.

See Also:

AbstractPortController