Package jmri.jmrix.loconet

Class LncvDevicesManager

java.lang.Object

jmri.beans.PropertyChangeSupport

jmri.jmrix.loconet.LncvDevicesManager

All Implemented Interfaces:

java.util.EventListener, PropertyChangeFirer, PropertyChangeProvider, Disposable, LocoNetListener

public class LncvDevicesManager
extends PropertyChangeSupport
implements LocoNetListener, Disposable

LocoNet LNCV Devices Manager

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

Supports the following features: - LNCV "discovery" process supported via PROG_START_ALL call - LNCV Device "destination address" change supported by writing a new value to LNCV 0 (close session next) - LNCV 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 LNCV 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 class	LncvDevicesManager.ProgrammingResult

Field Summary

Fields

Modifier and Type	Field	Description
(package private) static java.lang.String	ROSTER_THREAD_NAME

Fields inherited from class jmri.beans.PropertyChangeSupport

propertyChangeSupport

Constructor Summary

Constructors

Constructor	Description
LncvDevicesManager(LocoNetSystemConnectionMemo memo)

Method Summary

Modifier and Type	Method	Description
void	clearDevicesList()
void	dispose()	Called when disposing of a disposable.
LncvDevice	getDevice(int art, int addr)
int	getDeviceCount()
LncvDevices	getDeviceList()
void	message(LocoNetMessage m)	Extract module information from LNCV READREPLY/READREPLY2 message, if not already in the lncvDevices list, try to find a matching decoder definition (by article number) and add it.
LncvDevicesManager.ProgrammingResult	prepareForSymbolicProgrammer(LncvDevice 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 Detail

ROSTER_THREAD_NAME

static final java.lang.String ROSTER_THREAD_NAME

See Also:

Constant Field Values

Constructor Detail

LncvDevicesManager

public LncvDevicesManager(@Nonnull
                          LocoNetSystemConnectionMemo memo)

Method Detail

getDeviceList

public LncvDevices getDeviceList()

getDeviceCount

public int getDeviceCount()

clearDevicesList

public void clearDevicesList()

message

public void message(LocoNetMessage m)

Extract module information from LNCV READREPLY/READREPLY2 message, if not already in the lncvDevices list, try to find a matching decoder definition (by article number) 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 LncvDevice getDevice(int art,
                            int addr)

prepareForSymbolicProgrammer

public LncvDevicesManager.ProgrammingResult prepareForSymbolicProgrammer(LncvDevice 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