Package jmri.jmrix.marklin

Class MarklinMessage

java.lang.Object

jmri.jmrix.AbstractMessage

jmri.jmrix.AbstractMRMessage

jmri.jmrix.marklin.MarklinMessage

All Implemented Interfaces:

Message

public class MarklinMessage
extends AbstractMRMessage

Encodes a message to a Marklin command station.

The MarklinReply class handles the response from the command station. Packages of length 13 are interpreted as can-bus packages: 4 bytes Can-bus-ID (BigEndian or network order), 1-byte length and 8 bytes of data, if necessary with null bytes to fill in.

The message ID is divided into the areas of lower priority (priority), command (command), response and hash. The communication is based on the following format: Prio - 2 +2bit Command 8 bit Resp - 1 bit Hash - 16bit DLC - 4bit (ie CAN message length) CAN message 8 BYTES Can Message Bytes 0 to 3 are the address bytes, with byte 0 High, byte 3 low

Field Summary

Fields

Modifier and Type	Field	Description
(package private) static int	MY_UID

Fields inherited from class jmri.jmrix.AbstractMRMessage

LONG_TIMEOUT, SHORT_TIMEOUT

Fields inherited from class jmri.jmrix.AbstractMessage

_dataChars, _nDataChars

Constructor Summary

Constructors

Constructor	Description
MarklinMessage()
MarklinMessage(byte[] d)
MarklinMessage(int i)
MarklinMessage(int[] d)
MarklinMessage(MarklinMessage m)

Method Summary

Modifier and Type	Method	Description
long	getAddress()
static MarklinMessage	getCanBoot()	Generate CAN BOOT command (0xB1).
static MarklinMessage	getEnableMain()
static MarklinMessage	getExitProgMode()
static MarklinMessage	getKillMain()
static MarklinMessage	getProgMode()
static MarklinMessage	getQryLocoDirection(int addr)
static MarklinMessage	getQryLocoFunction(int addr, int funct)
static MarklinMessage	getQryLocoSpeed(int addr)
static MarklinMessage	getReadDirectCV(int cv)
static MarklinMessage	getReadPagedCV(int cv)
static MarklinMessage	getReadRegister(int reg)
static MarklinMessage	getSetTurnout(int addr, int state, int power)
static MarklinMessage	getWriteDirectCV(int cv, int val)
static MarklinMessage	getWritePagedCV(int cv, int val)
static MarklinMessage	getWriteRegister(int reg, int val)
static MarklinMessage	sensorPollMessage(int module)
static MarklinMessage	setLocoDirection(int addr, int dir)
static MarklinMessage	setLocoEmergencyStop(int addr)
static MarklinMessage	setLocoFunction(int addr, int funct, int state)
static MarklinMessage	setLocoSpeed(int addr, int speed)
static MarklinMessage	setLocoSpeedSteps(int addr, int step)

Methods inherited from class jmri.jmrix.AbstractMRMessage

addIntAsFourHex, addIntAsThree, addIntAsThreeHex, addIntAsTwoHex, getNeededMode, getOpCode, getOpCodeHex, getRetries, getTimeout, isBinary, replyExpected, setBinary, setNeededMode, setOpCode, setRetries, setTimeout, toString

Methods inherited from class jmri.jmrix.AbstractMessage

equals, getElement, getNumDataElements, hashCode, setElement

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface jmri.jmrix.Message

toMonitorString

Field Details

MY_UID

static int MY_UID

Constructor Details

MarklinMessage

MarklinMessage()

MarklinMessage

public MarklinMessage(int[] d)

MarklinMessage

public MarklinMessage(byte[] d)

MarklinMessage

public MarklinMessage(int i)

MarklinMessage

public MarklinMessage(MarklinMessage m)

Method Details

getEnableMain

public static MarklinMessage getEnableMain()

getKillMain

public static MarklinMessage getKillMain()

getCanBoot

public static MarklinMessage getCanBoot()

Generate CAN BOOT command (0xB1).

This command is used to invoke the bootloader update sequence for Märklin devices. According to German language forum research, this is part of the software/bootloader command range used for firmware updates and device initialization.

Returns:

MarklinMessage containing the CAN BOOT command

See Also:

• Märklin CAN Protokoll 0x1B commands documentation

getSetTurnout

public static MarklinMessage getSetTurnout(int addr,
 int state,
 int power)

getQryLocoSpeed

public static MarklinMessage getQryLocoSpeed(int addr)

setLocoSpeed

public static MarklinMessage setLocoSpeed(int addr,
 int speed)

setLocoEmergencyStop

public static MarklinMessage setLocoEmergencyStop(int addr)

setLocoSpeedSteps

public static MarklinMessage setLocoSpeedSteps(int addr,
 int step)

getQryLocoDirection

public static MarklinMessage getQryLocoDirection(int addr)

setLocoDirection

public static MarklinMessage setLocoDirection(int addr,
 int dir)

getQryLocoFunction

public static MarklinMessage getQryLocoFunction(int addr,
 int funct)

setLocoFunction

public static MarklinMessage setLocoFunction(int addr,
 int funct,
 int state)

sensorPollMessage

public static MarklinMessage sensorPollMessage(int module)

getAddress

public long getAddress()

getProgMode

public static MarklinMessage getProgMode()

getExitProgMode

public static MarklinMessage getExitProgMode()

getReadPagedCV

public static MarklinMessage getReadPagedCV(int cv)

getWritePagedCV

public static MarklinMessage getWritePagedCV(int cv,
 int val)

getReadRegister

public static MarklinMessage getReadRegister(int reg)

getWriteRegister

public static MarklinMessage getWriteRegister(int reg,
 int val)

getReadDirectCV

public static MarklinMessage getReadDirectCV(int cv)

getWriteDirectCV

public static MarklinMessage getWriteDirectCV(int cv,
 int val)