Package jmri.jmrix.mrc

Class MrcClockControl

java.lang.Object

jmri.implementation.DefaultClockControl

jmri.jmrix.mrc.MrcClockControl

All Implemented Interfaces:

ClockControl, MrcTrafficListener

public class MrcClockControl
extends DefaultClockControl
implements MrcTrafficListener

Implementation of the Hardware Fast Clock for Mrc

This module is based on the NCE version.

This file is part of JMRI.

JMRI is free software; you can redistribute it and/or modify it under the terms of version 2 of the GNU General Public License as published by the Free Software Foundation. See the "COPYING" file for a copy of this license.

JMRI is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

Field Summary

Fields

Modifier and Type	Field	Description
(package private) Timer	alarmSyncUpdate
static final int	CMD_CLOCK_SET_PARAM_SIZE
static final int	CMD_CLOCK_SET_REPLY_SIZE
static final int	CMD_CLOCK_SET_RUN_SIZE
static final int	CMD_CLOCK_SET_TIME_SIZE
static final int	CMD_MEM_SET_REPLY_SIZE
static final int	CS_CLOCK_1224
static final int	CS_CLOCK_AMPM
static final int	CS_CLOCK_HOURS
static final int	CS_CLOCK_MINUTES
static final int	CS_CLOCK_SCALE
static final int	CS_CLOCK_STATUS
(package private) DecimalFormat	fiveDigits
(package private) DecimalFormat	fourDigits
(package private) Timebase	internalClock
static final int	MAX_ERROR_ARRAY
(package private) PropertyChangeListener	minuteChangeListener
static final int	SYNCMODE_INTERNAL_MASTER
static final int	SYNCMODE_MRC_MASTER
static final int	SYNCMODE_OFF
static final double	TARGET_SYNC_DELAY
(package private) DecimalFormat	threeDigits
(package private) DecimalFormat	twoDigits
static final int	WAIT_CMD_EXECUTION

Constructor Summary

Constructors

Constructor	Description
MrcClockControl(MrcTrafficController tc, String prefix)	Create a ClockControl object for a Mrc clock

Method Summary

Modifier and Type	Method	Description
boolean	canCorrectHardwareClock()	Mrc clock runs stable enough
boolean	canSet12Or24HourClock()	Mrc clock supports 12/24 operation
void	dispose()	stops any sync, removes listeners
String	getHardwareClockName()	name of Mrc clock
double	getRate()	last known ratio from Mrc clock
Date	getTime()	returns the current Mrc time, does not have a date component
void	initializeHardwareClock(double rate, Date now, boolean getTime)	Default implementation is to ignore this request.
void	message(MrcMessage r)
void	newInternalMinute()	Handles minute notifications for MRC Clock Monitor/Synchronizer
void	notifyFailedXmit(Date timestamp, MrcMessage m)
void	notifyRcv(Date timestamp, MrcMessage m)
void	notifyXmit(Date timestamp, MrcMessage m)
boolean	requiresIntegerRate()	Mrc only supports integer rates
void	setRate(double newRate)	sets Mrc clock speed, must be 1 to 60
void	setTime(Date now)	set the time, the date part is ignored
void	startHardwareClock(Date now)	set Mrc clock and start clock

Methods inherited from class jmri.implementation.DefaultClockControl

getStatus, stopHardwareClock

Methods inherited from class java.lang.Object

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

Field Details

CS_CLOCK_SCALE

public static final int CS_CLOCK_SCALE

See Also:

• Constant Field Values

CS_CLOCK_MINUTES

public static final int CS_CLOCK_MINUTES

See Also:

• Constant Field Values

CS_CLOCK_HOURS

public static final int CS_CLOCK_HOURS

See Also:

• Constant Field Values

CS_CLOCK_AMPM

public static final int CS_CLOCK_AMPM

See Also:

• Constant Field Values

CS_CLOCK_1224

public static final int CS_CLOCK_1224

See Also:

• Constant Field Values

CS_CLOCK_STATUS

public static final int CS_CLOCK_STATUS

See Also:

• Constant Field Values

CMD_CLOCK_SET_TIME_SIZE

public static final int CMD_CLOCK_SET_TIME_SIZE

See Also:

• Constant Field Values

CMD_CLOCK_SET_PARAM_SIZE

public static final int CMD_CLOCK_SET_PARAM_SIZE

See Also:

• Constant Field Values

CMD_CLOCK_SET_RUN_SIZE

public static final int CMD_CLOCK_SET_RUN_SIZE

See Also:

• Constant Field Values

CMD_CLOCK_SET_REPLY_SIZE

public static final int CMD_CLOCK_SET_REPLY_SIZE

See Also:

• Constant Field Values

CMD_MEM_SET_REPLY_SIZE

public static final int CMD_MEM_SET_REPLY_SIZE

See Also:

• Constant Field Values

MAX_ERROR_ARRAY

public static final int MAX_ERROR_ARRAY

See Also:

• Constant Field Values

TARGET_SYNC_DELAY

public static final double TARGET_SYNC_DELAY

See Also:

• Constant Field Values

SYNCMODE_OFF

public static final int SYNCMODE_OFF

See Also:

• Constant Field Values

SYNCMODE_MRC_MASTER

public static final int SYNCMODE_MRC_MASTER

See Also:

• Constant Field Values

SYNCMODE_INTERNAL_MASTER

public static final int SYNCMODE_INTERNAL_MASTER

See Also:

• Constant Field Values

WAIT_CMD_EXECUTION

public static final int WAIT_CMD_EXECUTION

See Also:

• Constant Field Values

fiveDigits

DecimalFormat fiveDigits

fourDigits

DecimalFormat fourDigits

threeDigits

DecimalFormat threeDigits

twoDigits

DecimalFormat twoDigits

internalClock

Timebase internalClock

alarmSyncUpdate

Timer alarmSyncUpdate

minuteChangeListener

PropertyChangeListener minuteChangeListener

Constructor Details

MrcClockControl

public MrcClockControl(MrcTrafficController tc,
 String prefix)

Create a ClockControl object for a Mrc clock

Parameters:

tc - traffic control for connection

prefix - system prefix for connection

Method Details

message

public void message(MrcMessage r)

notifyXmit

public void notifyXmit(Date timestamp,
 MrcMessage m)

Specified by:

notifyXmit in interface MrcTrafficListener

notifyFailedXmit

public void notifyFailedXmit(Date timestamp,
 MrcMessage m)

Specified by:

notifyFailedXmit in interface MrcTrafficListener

notifyRcv

public void notifyRcv(Date timestamp,
 MrcMessage m)

Specified by:

notifyRcv in interface MrcTrafficListener

getHardwareClockName

public String getHardwareClockName()

name of Mrc clock

Specified by:

getHardwareClockName in interface ClockControl

Overrides:

getHardwareClockName in class DefaultClockControl

Returns:

the name

canCorrectHardwareClock

public boolean canCorrectHardwareClock()

Mrc clock runs stable enough

Specified by:

canCorrectHardwareClock in interface ClockControl

Overrides:

canCorrectHardwareClock in class DefaultClockControl

Returns:

true if correctable; false otherwise

canSet12Or24HourClock

public boolean canSet12Or24HourClock()

Mrc clock supports 12/24 operation

Specified by:

canSet12Or24HourClock in interface ClockControl

Overrides:

canSet12Or24HourClock in class DefaultClockControl

Returns:

true if settable; false otherwise

setRate

public void setRate(double newRate)

sets Mrc clock speed, must be 1 to 60

Specified by:

setRate in interface ClockControl

Overrides:

setRate in class DefaultClockControl

Parameters:

newRate - the new rate

requiresIntegerRate

public boolean requiresIntegerRate()

Mrc only supports integer rates

Specified by:

requiresIntegerRate in interface ClockControl

Overrides:

requiresIntegerRate in class DefaultClockControl

Returns:

true if integer rates only; false otherwise

getRate

public double getRate()

last known ratio from Mrc clock

Specified by:

getRate in interface ClockControl

Overrides:

getRate in class DefaultClockControl

Returns:

Fast Clock rate.

setTime

public void setTime(Date now)

set the time, the date part is ignored

Specified by:

setTime in interface ClockControl

Overrides:

setTime in class DefaultClockControl

Parameters:

now - the new time

getTime

public Date getTime()

returns the current Mrc time, does not have a date component

Specified by:

getTime in interface ClockControl

Overrides:

getTime in class DefaultClockControl

Returns:

current time.

startHardwareClock

public void startHardwareClock(Date now)

set Mrc clock and start clock

Specified by:

startHardwareClock in interface ClockControl

Overrides:

startHardwareClock in class DefaultClockControl

Parameters:

now - the starting time

initializeHardwareClock

public void initializeHardwareClock(double rate,
 Date now,
 boolean getTime)

Description copied from class: DefaultClockControl

Default implementation is to ignore this request. Initialize the hardware fast clock Note: When the hardware clock control receives this, it should initialize those clock settings that are available on the hardware clock. This method is used when the fast clock is started, and when time source, synchronize, or correct options are changed. If rate is 0.0, the hardware clock should be initialized "stopped", and the current rate saved for when the clock is restarted. If getTime is "true" the time from the hardware clock should be used in place of the supplied time if possible.

Specified by:

initializeHardwareClock in interface ClockControl

Overrides:

initializeHardwareClock in class DefaultClockControl

Parameters:

rate - the rate

now - the time

getTime - true if hardware clock should be used; false otherwise

dispose

public void dispose()

stops any sync, removes listeners

newInternalMinute

public void newInternalMinute()

Handles minute notifications for MRC Clock Monitor/Synchronizer