jmri.progdebugger
Class ProgDebugger

java.lang.Object
  jmri.progdebugger.ProgDebugger

All Implemented Interfaces:

Programmer

public class ProgDebugger
extends Object
implements Programmer

Debugging implementation of Programmer interface.

Remembers writes, and returns the last written value when a read to the same CV is made.

Author:

Bob Jacobsen Copyright (C) 2001, 2007

Field Summary

protected int

_mode

Fields inherited from interface jmri.Programmer

ADDRESSMODE, CBUSNODEVARMODE, DIRECTBITMODE, DIRECTBYTEMODE, NONE, OPSACCBITMODE, OPSACCBYTEMODE, OPSACCEXTBITMODE, OPSACCEXTBYTEMODE, OPSBITMODE, OPSBYTEMODE, PAGEMODE, REGISTERMODE

Constructor Summary

ProgDebugger()

Method Summary

void	addPropertyChangeListener(PropertyChangeListener l)
void	confirmCV(int CV, int val, ProgListener p) Confirm the value of a CV using the specified programming mode.
String	decodeErrorCode(int i)
boolean	getCanRead()
int	getCvVal(int cv) Get the CV value directly, without going through the usual indirect protocol.
int	getMode() Get the current programming mode
boolean	hasMode(int mode) Check if a given mode is available
int	lastReadCv()
int	lastWrite()
int	lastWriteCv()
void	nextRead(int r)
protected void	notifyPropertyChange(String name, int oldval, int newval)
void	readCV(int CV, ProgListener p) Perform a CV read in the system-specific manner, and using the specified programming mode.
void	removePropertyChangeListener(PropertyChangeListener l)
void	resetCv(int cv, int val) Reset the CV to a value so one can detect if it's been written.
void	setMode(int mode) Set the programmer to a particular mode.
void	writeCV(int CV, int val, ProgListener p) Perform a CV write in the system-specific manner, and using the specified programming mode.

Methods inherited from class java.lang.Object

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

Field Detail

_mode

protected int _mode

Constructor Detail

ProgDebugger

public ProgDebugger()

Method Detail

lastWrite

public int lastWrite()

lastWriteCv

public int lastWriteCv()

resetCv

public void resetCv(int cv,
                    int val)

Reset the CV to a value so one can detect if it's been written.

Does not change the "lastWrite" and "lastWriteCv" results.

getCvVal

public int getCvVal(int cv)

Get the CV value directly, without going through the usual indirect protocol. Used for e.g. testing.

Does not change the "lastRead" and "lastReadCv" results.

decodeErrorCode

public String decodeErrorCode(int i)

Specified by:

decodeErrorCode in interface Programmer

writeCV

public void writeCV(int CV,
                    int val,
                    ProgListener p)
             throws ProgrammerException

Description copied from interface: Programmer

Perform a CV write in the system-specific manner, and using the specified programming mode. Note that this returns before the write is complete; you have to provide a ProgListener to hear about completion. The exceptions will only be thrown at the start, not during the actual programming sequence. A typical exception would be due to an invalid mode (though that should be prevented earlier)

Specified by:

writeCV in interface Programmer

Throws:

ProgrammerException

nextRead

public void nextRead(int r)

lastReadCv

public int lastReadCv()

confirmCV

public void confirmCV(int CV,
                      int val,
                      ProgListener p)
               throws ProgrammerException

Description copied from interface: Programmer

Confirm the value of a CV using the specified programming mode. On some systems, this is faster than a read. Note that this returns before the confirm is complete; you have to provide a ProgListener to hear about completion. The exceptions will only be thrown at the start, not during the actual programming sequence. A typical exception would be due to an invalid mode (though that should be prevented earlier)

Specified by:

confirmCV in interface Programmer

Throws:

ProgrammerException

readCV

public void readCV(int CV,
                   ProgListener p)
            throws ProgrammerException

Description copied from interface: Programmer

Perform a CV read in the system-specific manner, and using the specified programming mode. Note that this returns before the read is complete; you have to provide a ProgListener to hear about completion. The exceptions will only be thrown at the start, not during the actual programming sequence. A typical exception would be due to an invalid mode (though that should be prevented earlier)

Specified by:

readCV in interface Programmer

Throws:

ProgrammerException

setMode

public void setMode(int mode)

Description copied from interface: Programmer

Set the programmer to a particular mode. Only certain modes may be available for any particular implementation. If an invalid mode is requested, the active mode is unchanged.

Specified by:

setMode in interface Programmer

Parameters:

mode - One of the class-constant mode values

getMode

public int getMode()

Description copied from interface: Programmer

Get the current programming mode

Specified by:

getMode in interface Programmer

Returns:

one of the class constants identifying a mode

hasMode

public boolean hasMode(int mode)

Description copied from interface: Programmer

Check if a given mode is available

Specified by:

hasMode in interface Programmer

Parameters:

mode - Availability of this mode is returned

Returns:

True if the mode is available

getCanRead

public boolean getCanRead()

Specified by:

getCanRead in interface Programmer

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener l)

Specified by:

addPropertyChangeListener in interface Programmer

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener l)

Specified by:

removePropertyChangeListener in interface Programmer

notifyPropertyChange

protected void notifyPropertyChange(String name,
                                    int oldval,
                                    int newval)