Package jmri.jmrix.loconet

Class LnSensorAddress

java.lang.Object

jmri.jmrix.loconet.LnSensorAddress

public class LnSensorAddress
extends Object

Utilities for handling LocoNet sensor addresses.

There are three addressing spaces for LocoNet sensors:

• The space used for DS54 inputs, where the least-significant-bit in the address refers to the "Aux" and "Switch" inputs. These are represented by system names of the form LSnnnA and LSnnnS respectively. nnn is then the turnout number of the DS54 channel.
• The space used for BDL16 inputs, where the card and section numbers are part of the address. These are represented by names of the form LScccA1 through LScccA4, LScccB1 through LScccB4, and on through LScccD4. ccc is the BDL16 card number.
• A straight-forward numeric space, represented by LSmmm. Note that this is a 1-4096 scheme, not a 0-4095.

Some of the message formats used in this class are Copyright Digitrax, Inc. and used with permission as part of the JMRI project. That permission does not extend to uses in other software products. If you wish to use this code, algorithm or these message formats outside of JMRI, please contact Digitrax Inc for separate permission.

Field Summary

Fields

Modifier and Type	Field	Description
(package private) int	_as
(package private) int	_high
(package private) int	_low
(package private) boolean	_valid
(package private) String	prefix

Constructor Summary

Constructors

Constructor	Description
LnSensorAddress(int sw1, int sw2, String prefix)
LnSensorAddress(String s, String prefix)

Method Summary

Modifier and Type	Method	Description
protected int	asInt()
int	getASBit()	The bit representing the Aux or Sensor input
String	getBDL16Address()	Name in the BDL16 space
String	getDS54Address()	Name in the DS54 space
int	getHighBits()
int	getLowBits()
String	getNumericAddress()	Name in the 1-4096 space
void	insertAddress(LocoNetMessage m)	Update a LocoNet message to have this address.
boolean	isValid()
boolean	matchAddress(int a1, int a2)
(package private) void	reportParseError(String s)
String	toString()

Methods inherited from class java.lang.Object

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

Field Details

_low

int _low

_high

int _high

_as

int _as

prefix

String prefix

_valid

boolean _valid

Constructor Details

LnSensorAddress

public LnSensorAddress(int sw1,
 int sw2,
 String prefix)

LnSensorAddress

public LnSensorAddress(String s,
 String prefix)

Method Details

reportParseError

void reportParseError(String s)

insertAddress

public void insertAddress(LocoNetMessage m)

Update a LocoNet message to have this address. It is assumed that the sensor address may be encoded into bytes 1 and 2 of the message.

Parameters:

m - a LocoNetmessage to be updated to contain this object's sensor address

matchAddress

public boolean matchAddress(int a1,
 int a2)

asInt

protected int asInt()

Returns:

integer value of this address in 0-4095 space

getLowBits

public int getLowBits()

getHighBits

public int getHighBits()

getASBit

public int getASBit()

The bit representing the Aux or Sensor input

Returns:

0x20 for aux input, 0x00 for switch input

isValid

public boolean isValid()

toString

public String toString()

Overrides:

toString in class Object

getNumericAddress

public String getNumericAddress()

Name in the 1-4096 space

Returns:

LSnnn

getDS54Address

public String getDS54Address()

Name in the DS54 space

Returns:

LSnnnA or LSnnnS, depending on Aux or Switch input

getBDL16Address

public String getBDL16Address()

Name in the BDL16 space

Returns:

e.g. LSnnnA3, with nnn the BDL16 number, A the section number, and 3 the channel number