jmri.jmrix.powerline
Class SerialTrafficController

java.lang.Object
  jmri.jmrix.AbstractMRTrafficController
      jmri.jmrix.powerline.SerialTrafficController

All Implemented Interfaces:

SerialInterface

Direct Known Subclasses:

SpecificTrafficController, SpecificTrafficController, SpecificTrafficController, SpecificTrafficController

public abstract class SerialTrafficController
extends AbstractMRTrafficController
implements SerialInterface

Converts Stream-based I/O to/from messages. The "SerialInterface" side sends/receives message objects.

The connection to a SerialPortController is via a pair of *Streams, which then carry sequences of characters for transmission. Note that this processing is handled in an independent thread.

This maintains a list of nodes, but doesn't currently do anything with it.

This implementation is complete and can be instantiated, but is not functional. It will be created e.g. when a default object is needed for configuring nodes, etc, during the initial configuration. A subclass must be instantiated to actually communicate with an adapter.

Author:

Bob Jacobsen Copyright (C) 2001, 2003, 2005, 2006, 2008 Converted to multiple connection, kcameron Copyright (C) 2011

Nested Class Summary

Nested classes/interfaces inherited from class jmri.jmrix.AbstractMRTrafficController

AbstractMRTrafficController.RcvNotifier, AbstractMRTrafficController.XmtNotifier

Field Summary

protected boolean

logDebug

Fields inherited from class jmri.jmrix.AbstractMRTrafficController

allowUnexpectedReply, AUTORETRYSTATE, cmdListeners, controller, flushReceiveChars, IDLESTATE, istream, mCurrentMode, mCurrentState, mLastSender, mWaitBeforePoll, NORMALMODE, NOTIFIEDSTATE, OKSENDMSGSTATE, ostream, POLLSTATE, PROGRAMINGMODE, rcvException, replyInDispatch, WAITMSGREPLYSTATE, WAITREPLYINNORMMODESTATE, WAITREPLYINPROGMODESTATE, waitTimePoll, xmtException, xmtRunnable

Constructor Summary

SerialTrafficController()

Method Summary

void	addSerialListener(SerialListener l)
protected boolean	endOfMessage(AbstractMRReply msg) This is a default, null implementation, which must be overridden in an adapter-specific subclass.
protected AbstractMRMessage	enterNormalMode()
protected AbstractMRMessage	enterProgMode()
protected int	enterProgModeDelayTime()
protected void	forwardMessage(AbstractMRListener client, AbstractMRMessage m) Forward a SerialMessage to all registered SerialInterface listeners.
protected void	forwardReply(AbstractMRListener client, AbstractMRReply r) Forward a reply to all registered SerialInterface listeners.
protected void	forwardToPort(AbstractMRMessage m, AbstractMRListener reply) Actually transmits the next message to the port
SerialSystemConnectionMemo	getAdapterMemo()
int	getNumberOfIntensitySteps() Provide the maximum number of dimming steps available.
SerialSensorManager	getSensorManager()
SerialMessage	getSerialMessage(int length) Get a message of a specific length for filling in.
protected AbstractMRReply	newReply() This is a default, null implementation, which must be overridden in an adapter-specific subclass.
protected AbstractMRMessage	pollMessage() Eventually, do initialization if needed
protected AbstractMRListener	pollReplyHandler()
void	removeSerialListener(SerialListener l)
void	sendInsteonSequence(InsteonSequence s, SerialListener l) Send a sequence of Insteon messages to an adapter.
void	sendSerialMessage(SerialMessage m, SerialListener reply) Forward a preformatted message to the actual interface.
void	sendX10Sequence(X10Sequence s, SerialListener l) Send a sequence of X10 messages to an adapter.
void	setAdapterMemo(SerialSystemConnectionMemo adaptermemo)
void	setInstance() Deprecated.
void	setSensorManager(SerialSensorManager m)

Methods inherited from class jmri.jmrix.AbstractMRTrafficController

addHeaderToOutput, addListener, addTrailerToOutput, canReceive, connectionWarn, connectPort, disconnectPort, finalize, getLastSender, getPortName, getSelfLock, handleOneIncomingReply, handleTimeout, hasTimeouts, lengthOfByteStream, loadChars, newRcvNotifier, notifyMessage, notifyReply, portReadyToSend, portWarn, portWarnTCP, programmerIdle, readByteProtected, receiveLoop, removeListener, reportReceiveLoopException, resetTimeout, sendMessage, setAllowUnexpectedReply, status, terminate, transmitWait, waitForStartOfReply

Methods inherited from class java.lang.Object

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

Methods inherited from interface jmri.jmrix.powerline.SerialInterface

status

Field Detail

logDebug

protected boolean logDebug

Constructor Detail

SerialTrafficController

public SerialTrafficController()

Method Detail

setInstance

@Deprecated
public void setInstance()

Deprecated.

instance use of the traffic controller is no longer used for multiple connections

Specified by:

setInstance in class AbstractMRTrafficController

sendX10Sequence

public void sendX10Sequence(X10Sequence s,
                            SerialListener l)

Send a sequence of X10 messages to an adapter.

Makes them into the local messages and then queues in order.

This is a default, null implementation, which must be overridden in an adapter-specific subclass.

sendInsteonSequence

public void sendInsteonSequence(InsteonSequence s,
                                SerialListener l)

Send a sequence of Insteon messages to an adapter.

Makes them into the local messages and then queues in order.

This is a default, null implementation, which must be overridden in an adapter-specific subclass.

getNumberOfIntensitySteps

public int getNumberOfIntensitySteps()

Provide the maximum number of dimming steps available.

Returns:

By default, dimming not available.

getSerialMessage

public SerialMessage getSerialMessage(int length)

Get a message of a specific length for filling in.

This is a default, null implementation, which must be overridden in an adapter-specific subclass.

addSerialListener

public void addSerialListener(SerialListener l)

Specified by:

addSerialListener in interface SerialInterface

removeSerialListener

public void removeSerialListener(SerialListener l)

Specified by:

removeSerialListener in interface SerialInterface

enterProgModeDelayTime

protected int enterProgModeDelayTime()

Overrides:

enterProgModeDelayTime in class AbstractMRTrafficController

forwardMessage

protected void forwardMessage(AbstractMRListener client,
                              AbstractMRMessage m)

Forward a SerialMessage to all registered SerialInterface listeners.

Specified by:

forwardMessage in class AbstractMRTrafficController

forwardReply

protected void forwardReply(AbstractMRListener client,
                            AbstractMRReply r)

Forward a reply to all registered SerialInterface listeners.

Specified by:

forwardReply in class AbstractMRTrafficController

setSensorManager

public void setSensorManager(SerialSensorManager m)

getSensorManager

public SerialSensorManager getSensorManager()

pollMessage

protected AbstractMRMessage pollMessage()

Eventually, do initialization if needed

Specified by:

pollMessage in class AbstractMRTrafficController

pollReplyHandler

protected AbstractMRListener pollReplyHandler()

Specified by:

pollReplyHandler in class AbstractMRTrafficController

sendSerialMessage

public void sendSerialMessage(SerialMessage m,
                              SerialListener reply)

Forward a preformatted message to the actual interface.

Specified by:

sendSerialMessage in interface SerialInterface

forwardToPort

protected void forwardToPort(AbstractMRMessage m,
                             AbstractMRListener reply)

Description copied from class: AbstractMRTrafficController

Actually transmits the next message to the port

Overrides:

forwardToPort in class AbstractMRTrafficController

enterProgMode

protected AbstractMRMessage enterProgMode()

Specified by:

enterProgMode in class AbstractMRTrafficController

enterNormalMode

protected AbstractMRMessage enterNormalMode()

Specified by:

enterNormalMode in class AbstractMRTrafficController

setAdapterMemo

public void setAdapterMemo(SerialSystemConnectionMemo adaptermemo)

getAdapterMemo

public SerialSystemConnectionMemo getAdapterMemo()

endOfMessage

protected boolean endOfMessage(AbstractMRReply msg)

This is a default, null implementation, which must be overridden in an adapter-specific subclass.

Specified by:

endOfMessage in class AbstractMRTrafficController

newReply

protected AbstractMRReply newReply()

This is a default, null implementation, which must be overridden in an adapter-specific subclass.

Specified by:

newReply in class AbstractMRTrafficController