Package jmri.jmrix.loconet

Class LocoNetConsist

java.lang.Object

jmri.implementation.DccConsist

jmri.jmrix.loconet.LocoNetConsist

All Implemented Interfaces:

EventListener, Consist, SlotListener, ProgListener, ThrottleListener

public class LocoNetConsist
extends DccConsist
implements SlotListener, ThrottleListener

LocoNetConsist.java This is the Consist definition for a consist on a LocoNet system. It uses the LocoNet specific commands to build a consist.

Nested Class Summary

Nested classes/interfaces inherited from interface jmri.ThrottleListener

ThrottleListener.DecisionType

Field Summary

Fields

Modifier and Type	Field	Description
(package private) static final int	IDLESTATE
(package private) static final int	LEADREQUESTSTATE
(package private) static final int	LINKSTAGEONESTATE
(package private) static final int	LINKSTAGETHREESTATE
(package private) static final int	LINKSTAGETWOSTATE
(package private) static final 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)	Add a Locomotive to an Advanced Consist.
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 this address allowed?
void	notifyChangedSlot(LocoNetSlot s)
void	notifyDecisionRequired(LocoAddress address, ThrottleListener.DecisionType question)	No steal or share decisions made locally
void	notifyFailedThrottleRequest(LocoAddress address, 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)	Remove a Locomotive from an Advanced Consist
void	removeFromCSConsist(DccLocoAddress locoAddress)	Remove a Locomotive from a LocoNet Universal Consist.
void	restore(DccLocoAddress locoAddress, boolean directionNormal)	Restore a Locomotive to a Consist, but don't write to the command station.
void	setConsistType(int type)	Set the Consist Type.
int	sizeLimit()	Is there a size limit for this 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 Details

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 Details

LocoNetConsist

public LocoNetConsist(int address,
 LocoNetSystemConnectionMemo lm)

LocoNetConsist

public LocoNetConsist(DccLocoAddress address,
 LocoNetSystemConnectionMemo lm)

Method Details

setConsistType

public void setConsistType(int type)

Description copied from interface: Consist

Set the Consist Type.

Specified by:

setConsistType in interface Consist

Overrides:

setConsistType in class DccConsist

Parameters:

type - the consist type

isAddressAllowed

public boolean isAddressAllowed(DccLocoAddress address)

Is this address allowed? On LocoNet systems, All addresses can be used in a Universal Consist and only 0 is not allowed in Advanced Consists. Is this address allowed? Since address 00 is an analog locomotive, we can't program CV19 to include it in a consist, but all other addresses are ok.

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()

Is there a size limit for this consist?

Specified by:

sizeLimit in interface Consist

Overrides:

sizeLimit in class DccConsist

Returns:

-1 (no limit) for both CS and Advanced Consists, 0 for any other consist type.

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)

Add a Locomotive to a Consist.

Specified by:

add in interface Consist

Overrides:

add in class DccConsist

Parameters:

locoAddress - the Locomotive address to add to the locomotive

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

restore

public void restore(DccLocoAddress locoAddress,
 boolean directionNormal)

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 - the Locomotive address to add to the locomotive

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

remove

public void remove(DccLocoAddress locoAddress)

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)

Add a Locomotive to an Advanced Consist.

Overrides:

addToAdvancedConsist in class DccConsist

Parameters:

locoAddress - the Locomotive address to add to the locomotive

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

removeFromAdvancedConsist

protected void removeFromAdvancedConsist(DccLocoAddress locoAddress)

Remove a Locomotive from an Advanced Consist

Overrides:

removeFromAdvancedConsist in class DccConsist

Parameters:

locoAddress - is the Locomotive address to add to the locomotive

removeFromCSConsist

public void removeFromCSConsist(DccLocoAddress locoAddress)

Remove a Locomotive from a LocoNet Universal Consist.

Parameters:

locoAddress - is the Locomotive address to add to the locomotive.

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,
 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