Package mars.tools

Class DigitalLabSimulator

java.lang.Object

java.awt.Component

java.awt.Container

java.awt.Window

java.awt.Frame

javax.swing.JFrame

mars.tools.AbstractMarsTool

mars.tools.DigitalLabSimulator

All Implemented Interfaces:

ImageObserver, MenuContainer, Serializable, EventListener, Accessible, RootPaneContainer, WindowConstants, Memory.Listener, MarsTool

public class DigitalLabSimulator
extends AbstractMarsTool

Didier Teifreto LIFC Université de franche-Comté www.lifc.univ-fcomte.fr/~teifreto didier.teifreto@univ-fcomte.fr

See Also:

• Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
class	DigitalLabSimulator.HexadecimalKeyboard
static class	DigitalLabSimulator.OneSecondCounter
static class	DigitalLabSimulator.SevenSegmentDisplay
static class	DigitalLabSimulator.SevenSegmentPanel

Nested classes/interfaces inherited from class javax.swing.JFrame

JFrame.AccessibleJFrame

Nested classes/interfaces inherited from class java.awt.Frame

Frame.AccessibleAWTFrame

Nested classes/interfaces inherited from class java.awt.Window

Window.AccessibleAWTWindow, Window.Type

Nested classes/interfaces inherited from class java.awt.Container

Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields

Modifier and Type	Field	Description
static final int	EXTERNAL_INTERRUPT_HEXADECIMAL_KEYBOARD
static final int	EXTERNAL_INTERRUPT_TIMER

Fields inherited from class mars.tools.AbstractMarsTool

dialog

Fields inherited from class javax.swing.JFrame

accessibleContext, rootPane, rootPaneCheckingEnabled

Fields inherited from class java.awt.Frame

CROSSHAIR_CURSOR, DEFAULT_CURSOR, E_RESIZE_CURSOR, HAND_CURSOR, ICONIFIED, MAXIMIZED_BOTH, MAXIMIZED_HORIZ, MAXIMIZED_VERT, MOVE_CURSOR, N_RESIZE_CURSOR, NE_RESIZE_CURSOR, NORMAL, NW_RESIZE_CURSOR, S_RESIZE_CURSOR, SE_RESIZE_CURSOR, SW_RESIZE_CURSOR, TEXT_CURSOR, W_RESIZE_CURSOR, WAIT_CURSOR

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Fields inherited from interface javax.swing.WindowConstants

DISPOSE_ON_CLOSE, DO_NOTHING_ON_CLOSE, EXIT_ON_CLOSE, HIDE_ON_CLOSE

Constructor Summary

Constructors

Constructor	Description
DigitalLabSimulator()	Construct an instance of this tool.

Method Summary

Modifier and Type	Method	Description
protected JComponent	buildMainDisplayArea()	Abstract method that must be instantiated by subclass to build the main display area of the GUI.
protected JComponent	getHelpComponent()	Override this method to provide a JComponent (probably a JButton) of your choice to be placed just left of the Close/Exit button.
String	getName()	Required MarsTool method to return Tool name.
void	memoryWritten(int address, int length, int value, int wordAddress, int wordValue)	Invoked upon any write operation which is relevant to this listener's active range.
protected void	reset()	Method that will be called each time the default Reset button is clicked.
protected void	startObserving()	Register this tool as a listener of memory and/or registers, if applicable.
protected void	stopObserving()	Unregister this tool as a listener of memory and/or registers, if applicable.
void	updateHexadecimalKeyboard(int row)
void	updateOneSecondCounter(int value)

Methods inherited from class mars.tools.AbstractMarsTool

action, buildButtonArea, buildContentPane, closeTool, handleClose, initializePostGUI, initializePreGUI

Methods inherited from class javax.swing.JFrame

addImpl, createRootPane, frameInit, getAccessibleContext, getContentPane, getDefaultCloseOperation, getGlassPane, getGraphics, getJMenuBar, getLayeredPane, getRootPane, getTransferHandler, isDefaultLookAndFeelDecorated, isRootPaneCheckingEnabled, paramString, processWindowEvent, remove, repaint, setContentPane, setDefaultCloseOperation, setDefaultLookAndFeelDecorated, setGlassPane, setIconImage, setJMenuBar, setLayeredPane, setLayout, setRootPane, setRootPaneCheckingEnabled, setTransferHandler, update

Methods inherited from class java.awt.Frame

addNotify, getCursorType, getExtendedState, getFrames, getIconImage, getMaximizedBounds, getMenuBar, getState, getTitle, isResizable, isUndecorated, remove, removeNotify, setBackground, setCursor, setExtendedState, setMaximizedBounds, setMenuBar, setOpacity, setResizable, setShape, setState, setTitle, setUndecorated

Methods inherited from class java.awt.Window

addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getBackground, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getIconImages, getInputContext, getListeners, getLocale, getModalExclusionType, getMostRecentFocusOwner, getOpacity, getOwnedWindows, getOwner, getOwnerlessWindows, getShape, getToolkit, getType, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, hide, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isAutoRequestFocus, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isOpaque, isShowing, isValidateRoot, pack, paint, postEvent, processEvent, processWindowFocusEvent, processWindowStateEvent, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setAutoRequestFocus, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImages, setLocation, setLocation, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setSize, setSize, setType, setVisible, show, toBack, toFront

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, requestFocusInWindow, resize, resize, revalidate, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setMaximumSize, setMixingCutoutShape, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Methods inherited from interface mars.tools.MarsTool

getIcon, getToolMenuOrder

Methods inherited from interface mars.mips.hardware.Memory.Listener

memoryRead, memoryReset

Methods inherited from interface java.awt.MenuContainer

getFont, postEvent

Field Details

EXTERNAL_INTERRUPT_TIMER

public static final int EXTERNAL_INTERRUPT_TIMER

See Also:

• Constant Field Values

EXTERNAL_INTERRUPT_HEXADECIMAL_KEYBOARD

public static final int EXTERNAL_INTERRUPT_HEXADECIMAL_KEYBOARD

See Also:

• Constant Field Values

Constructor Details

DigitalLabSimulator

public DigitalLabSimulator()

Construct an instance of this tool. This will be used by the ToolManager.

Method Details

getName

public String getName()

Description copied from class: AbstractMarsTool

Required MarsTool method to return Tool name. Must be defined by subclass.

Specified by:

getName in interface MarsTool

Specified by:

getName in class AbstractMarsTool

Returns:

Tool name. MARS will display this in menu item.

startObserving

protected void startObserving()

Description copied from class: AbstractMarsTool

Register this tool as a listener of memory and/or registers, if applicable. This method is called when the tool is opened by the user. Does nothing by default.

Overrides:

startObserving in class AbstractMarsTool

See Also:

• Register.addListener(Register.Listener)
• Memory.addListener(Memory.Listener)
• Memory.addListener(Memory.Listener, int)
• Memory.addListener(Memory.Listener, int, int)

stopObserving

protected void stopObserving()

Description copied from class: AbstractMarsTool

Unregister this tool as a listener of memory and/or registers, if applicable. This method is called when the tool is closed by the user. Does nothing by default.

Overrides:

stopObserving in class AbstractMarsTool

See Also:

• Register.removeListener(Register.Listener)
• Memory.removeListener(Memory.Listener)

memoryWritten

public void memoryWritten(int address,
 int length,
 int value,
 int wordAddress,
 int wordValue)

Description copied from interface: Memory.Listener

Invoked upon any write operation which is relevant to this listener's active range. Does nothing by default.

Parameters:

address - The address which was written to.

length - The number of bytes written. Will always be 1 (single byte), Memory.BYTES_PER_HALFWORD, or Memory.BYTES_PER_WORD.

value - The value which was written.

wordAddress - The address of the word affected by the operation.

wordValue - The resulting value of the word.

reset

protected void reset()

Description copied from class: AbstractMarsTool

Method that will be called each time the default Reset button is clicked. Use it to reset any data structures and/or GUI components. Does nothing by default.

Overrides:

reset in class AbstractMarsTool

buildMainDisplayArea

protected JComponent buildMainDisplayArea()

Description copied from class: AbstractMarsTool

Abstract method that must be instantiated by subclass to build the main display area of the GUI. It will be placed in the CENTER area of a BorderLayout. The title is in the NORTH area, and the controls are in the SOUTH area.

Specified by:

buildMainDisplayArea in class AbstractMarsTool

getHelpComponent

protected JComponent getHelpComponent()

Description copied from class: AbstractMarsTool

Override this method to provide a JComponent (probably a JButton) of your choice to be placed just left of the Close/Exit button. Its anticipated use is for a "help" button that launches a help message or dialog. But it can be any valid JComponent that doesn't mind co-existing among a bunch of JButtons.

Overrides:

getHelpComponent in class AbstractMarsTool

updateHexadecimalKeyboard

public void updateHexadecimalKeyboard(int row)

updateOneSecondCounter

public void updateOneSecondCounter(int value)