Package jmri.jmrix.loconet

Class LocoNetConsist

java.lang.Object

jmri.implementation.DccConsist

jmri.jmrix.loconet.LocoNetConsist

All Implemented Interfaces:

java.util.EventListener, Consist, SlotListener, ProgListener, ThrottleListener

public class LocoNetConsist
extends DccConsist
implements SlotListener, ThrottleListener

Nested Class Summary

Nested classes/interfaces inherited from interface jmri.ThrottleListener

ThrottleListener.DecisionType

Field Summary

Fields

Modifier and Type	Field	Description
(package private) static int	IDLESTATE
(package private) static int	LEADREQUESTSTATE
(package private) static int	LINKSTAGEONESTATE
(package private) static int	LINKSTAGETHREESTATE
(package private) static int	LINKSTAGETWOSTATE
(package private) static int	UNLINKSTAGEONESTATE

Fields inherited from class jmri.implementation.DccConsist

consistAddress, consistDir, consistID, consistList, consistPosition, consistRoster, consistType

Fields inherited from interface jmri.Consist

ADVANCED_CONSIST, CS_CONSIST, POSITION_LEAD, POSITION_TRAIL

Fields inherited from interface jmri.ProgListener

CommError, ConfirmFailed, FailedTimeout, NoAck, NoLocoDetected, NotImplemented, OK, ProgrammerBusy, ProgrammingShort, SequenceError, UnknownError, UserAborted

Constructor Summary

Constructors

Constructor	Description
LocoNetConsist(int address, LocoNetSystemConnectionMemo lm)
LocoNetConsist(DccLocoAddress address, LocoNetSystemConnectionMemo lm)

Method Summary

Modifier and Type	Method	Description
void	add(DccLocoAddress LocoAddress, boolean directionNormal)	Add a Locomotive to a Consist
protected void	addToAdvancedConsist(DccLocoAddress LocoAddress, boolean directionNormal)
boolean	contains(DccLocoAddress address)	Does the consist contain the specified locomotive address?
boolean	getLocoDirection(DccLocoAddress address)	Get the relative direction setting for a specific locomotive in the consist.
boolean	isAddressAllowed(DccLocoAddress address)	Is the specific address allowed?
void	notifyChangedSlot(LocoNetSlot s)
void	notifyDecisionRequired(LocoAddress address, ThrottleListener.DecisionType question)	No steal or share decisions made locally
void	notifyFailedThrottleRequest(LocoAddress address, java.lang.String reason)	Get notification that an attempt to request a throttle has failed.
void	notifyThrottleFound(DccThrottle t)	Get notification that a throttle has been found as requested.
void	remove(DccLocoAddress LocoAddress)	Remove a Locomotive from this Consist
protected void	removeFromAdvancedConsist(DccLocoAddress LocoAddress)
void	removeFromCSConsist(DccLocoAddress LocoAddress)
void	restore(DccLocoAddress LocoAddress, boolean directionNormal)	Restore a Locomotive to a Consist, but don't write to the command station.
void	setConsistType(int consist_type)	Set the Consist Type.
int	sizeLimit()	Is there a size limit for this type of consist?

Methods inherited from class jmri.implementation.DccConsist

addConsistListener, dispose, getConsistAddress, getConsistID, getConsistList, getConsistType, getPosition, getRosterId, loadDecoderFile, loadDecoderFromLoco, notifyConsistListeners, programmingOpReply, removeConsistListener, resetRosterEntryCVValue, restore, reverse, setConsistID, setPosition, setRosterEntryCVValue, setRosterId, updateRosterCV

Methods inherited from class java.lang.Object

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

Field Detail

IDLESTATE

static final int IDLESTATE

See Also:

Constant Field Values

LEADREQUESTSTATE

static final int LEADREQUESTSTATE

See Also:

Constant Field Values

LINKSTAGEONESTATE

static final int LINKSTAGEONESTATE

See Also:

Constant Field Values

LINKSTAGETWOSTATE

static final int LINKSTAGETWOSTATE

See Also:

Constant Field Values

LINKSTAGETHREESTATE

static final int LINKSTAGETHREESTATE

See Also:

Constant Field Values

UNLINKSTAGEONESTATE

static final int UNLINKSTAGEONESTATE

See Also:

Constant Field Values

Constructor Detail

LocoNetConsist

public LocoNetConsist(int address,
                      LocoNetSystemConnectionMemo lm)

LocoNetConsist

public LocoNetConsist(DccLocoAddress address,
                      LocoNetSystemConnectionMemo lm)

Method Detail

setConsistType

public void setConsistType(int consist_type)

Description copied from interface: Consist

Set the Consist Type.

Specified by:

setConsistType in interface Consist

Overrides:

setConsistType in class DccConsist

Parameters:

consist_type - the consist type

isAddressAllowed

public boolean isAddressAllowed(DccLocoAddress address)

Description copied from interface: Consist

Is the specific address allowed? (needed for system specific restrictions)

Specified by:

isAddressAllowed in interface Consist

Overrides:

isAddressAllowed in class DccConsist

Parameters:

address - the address

Returns:

true if allowed; false otherwise

sizeLimit

public int sizeLimit()

Description copied from interface: Consist

Is there a size limit for this type of consist?

Specified by:

sizeLimit in interface Consist

Overrides:

sizeLimit in class DccConsist

Returns:

-1 if no limit; 0 if the Consist Type is not supported; or the total number of usable spaces if the consist has a limit (do not subtract used spaces).

contains

public boolean contains(DccLocoAddress address)

Description copied from interface: Consist

Does the consist contain the specified locomotive address?

Specified by:

contains in interface Consist

Overrides:

contains in class DccConsist

Parameters:

address - the address to check

Returns:

true if in consist; false otherwise

getLocoDirection

public boolean getLocoDirection(DccLocoAddress address)

Description copied from interface: Consist

Get the relative direction setting for a specific locomotive in the consist.

Specified by:

getLocoDirection in interface Consist

Overrides:

getLocoDirection in class DccConsist

Parameters:

address - the address to check

Returns:

true if locomotive is in consist in its normal direction of travel; false otherwise

add

public void add(DccLocoAddress LocoAddress,
                boolean directionNormal)

Description copied from interface: Consist

Add a Locomotive to a Consist

Specified by:

add in interface Consist

Overrides:

add in class DccConsist

Parameters:

LocoAddress - is the Locomotive address to add to the locomotive

directionNormal - is True if the locomotive is traveling the same direction as the consist, or false otherwise.

restore

public void restore(DccLocoAddress LocoAddress,
                    boolean directionNormal)

Description copied from interface: Consist

Restore a Locomotive to a Consist, but don't write to the command station. This is used for restoring the consist from a file or adding a consist read from the command station.

Specified by:

restore in interface Consist

Overrides:

restore in class DccConsist

Parameters:

LocoAddress - is the Locomotive address to add to the consist

directionNormal - is True if the locomotive is traveling the same direction as the consist, or false otherwise.

remove

public void remove(DccLocoAddress LocoAddress)

Description copied from interface: Consist

Remove a Locomotive from this Consist

Specified by:

remove in interface Consist

Overrides:

remove in class DccConsist

Parameters:

LocoAddress - is the Locomotive address to add to the locomotive

addToAdvancedConsist

protected void addToAdvancedConsist(DccLocoAddress LocoAddress,
                                    boolean directionNormal)

Overrides:

addToAdvancedConsist in class DccConsist

removeFromAdvancedConsist

protected void removeFromAdvancedConsist(DccLocoAddress LocoAddress)

Overrides:

removeFromAdvancedConsist in class DccConsist

removeFromCSConsist

public void removeFromCSConsist(DccLocoAddress LocoAddress)

notifyChangedSlot

public void notifyChangedSlot(LocoNetSlot s)

Specified by:

notifyChangedSlot in interface SlotListener

notifyThrottleFound

public void notifyThrottleFound(DccThrottle t)

Description copied from interface: ThrottleListener

Get notification that a throttle has been found as requested.

Specified by:

notifyThrottleFound in interface ThrottleListener

Parameters:

t - the throttle with the requested address

notifyFailedThrottleRequest

public void notifyFailedThrottleRequest(LocoAddress address,
                                        java.lang.String reason)

Description copied from interface: ThrottleListener

Get notification that an attempt to request a throttle has failed.

Specified by:

notifyFailedThrottleRequest in interface ThrottleListener

Parameters:

address - address of the failed request

reason - failure cause

notifyDecisionRequired

public void notifyDecisionRequired(LocoAddress address,
                                   ThrottleListener.DecisionType question)

No steal or share decisions made locally

Get notification that a throttle request is in use by another device, and a "steal", "share", or "steal/share" decision may be required.

Specified by:

notifyDecisionRequired in interface ThrottleListener

Parameters:

address - The LocoAddress that needs the decision.

question - The question being asked, steal / cancel, share / cancel, steal / share / cancel