Package jmri.jmrix.loconet

Class Lnsv1DevicesManager

java.lang.Object

jmri.beans.PropertyChangeSupport

jmri.jmrix.loconet.Lnsv1DevicesManager

All Implemented Interfaces:

EventListener, PropertyChangeFirer, PropertyChangeProvider, Disposable, LocoNetListener

public class Lnsv1DevicesManager
extends PropertyChangeSupport
implements LocoNetListener, Disposable

LocoNet LNSV1 Devices Manager

A centralized resource to help identify LocoNet "LNSV1 Format" devices and "manage" them.

Supports the following features: - LNSV1 "discovery" process supported via BROADCAST call - LNSV1 Device "destination address" change supported by writing a new value to LNSV 0 (close session next) - LNSV1 Device "reconfigure/reset" not supported/documented - identification of devices with conflicting "destination address"es (warning before program start) - identification of a matching JMRI "decoder definition" for each discovered device, if an appropriate definition exists (only 1 value is matched, checks for LNSVf1 protocol support) - identification of matching JMRI "roster entry" which matches each discovered device, if an appropriate roster entry exists - ability to open a symbolic programmer for a given discovered device, if an appropriate roster entry exists

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	Lnsv1DevicesManager.ProgrammingResult

Field Summary

Fields

Modifier and Type	Field	Description
(package private) static final String	ROSTER_THREAD_NAME

Fields inherited from class jmri.beans.PropertyChangeSupport

propertyChangeSupport

Constructor Summary

Constructors

Constructor	Description
Lnsv1DevicesManager(LocoNetSystemConnectionMemo memo)

Method Summary

Modifier and Type	Method	Description
void	clearDevicesList()
void	dispose()	Called when disposing of a disposable.
Lnsv1Device	getDevice(int vrs, int addr)
int	getDeviceCount()
Lnsv1Devices	getDeviceList()
void	message(LocoNetMessage m)	Extract module information from a LNSVf1 READ_ONE REPLY message.
Lnsv1DevicesManager.ProgrammingResult	prepareForSymbolicProgrammer(Lnsv1Device dev, ProgrammingTool t)

Methods inherited from class jmri.beans.PropertyChangeSupport

addPropertyChangeListener, addPropertyChangeListener, fireIndexedPropertyChange, fireIndexedPropertyChange, fireIndexedPropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getPropertyChangeListeners, getPropertyChangeListeners, removePropertyChangeListener, removePropertyChangeListener

Methods inherited from class java.lang.Object

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

Field Details

ROSTER_THREAD_NAME

static final String ROSTER_THREAD_NAME

See Also:

• Constant Field Values

Constructor Details

Lnsv1DevicesManager

public Lnsv1DevicesManager(@Nonnull
 LocoNetSystemConnectionMemo memo)

Method Details

getDeviceList

public Lnsv1Devices getDeviceList()

getDeviceCount

public int getDeviceCount()

clearDevicesList

public void clearDevicesList()

message

public void message(LocoNetMessage m)

Extract module information from a LNSVf1 READ_ONE REPLY message. If not already in the lnsv1Devices list, try to find a matching decoder definition (by address number and programming mode) and add it. Skip if already in the list.

Specified by:

message in interface LocoNetListener

Parameters:

m - The received LocoNet message. Note that this same object may be presented to multiple users. It should not be modified here.

getDevice

public Lnsv1Device getDevice(int vrs,
 int addr)

prepareForSymbolicProgrammer

public Lnsv1DevicesManager.ProgrammingResult prepareForSymbolicProgrammer(Lnsv1Device dev,
 ProgrammingTool t)

dispose

public void dispose()

Description copied from interface: Disposable

Called when disposing of a disposable.

Note there are no assurances this method will not be called multiple times against a single instance of this Disposable. It is the responsibility of this Disposable to protect itself and the application from ensuring that calling this method multiple times has no unwanted side effects.

Specified by:

dispose in interface Disposable