hades.models.rtl
Class IDT6116

java.lang.Object
  hades.simulator.SimObject
      hades.models.rtl.IDT6116

All Implemented Interfaces:

java.lang.Cloneable, ContextToolTip, Memory, java.io.Serializable, Simulatable

Direct Known Subclasses:

IDT6164

public class IDT6116

extends SimObject

implements Memory

IDT6116 - static CMOS RAM of 2Kx8 bits. We use the IDT name instead of the original Hitachi (HC6116), because IDT seems to be the only company left that provides a datasheet...

The RAM has separate low-active nCS chip select, nOE output enable, and nWE asynchronous write enable control inputs. Data lines are bidirectional.

The RAM outputs are tri-stated and the input disabled as long as nCS is high. When nCS is low and nOE is low, the data from the currently addressed RAM cell is outputted at the data lines after t_access. If nCS is low and nWE low, the addressed RAM cell is written (continuously) with the current data inputs.

Clicking 'edit' on the RAM model will open a graphical editor for the RAM data, that also allows to specify the (optional) RAM initialization data file.

See Also:

Serialized Form

Field Summary

protected java.util.Hashtable	_listenerTable
protected int	address
protected long[]	data
protected int	index_A0
protected int	index_D0
protected MemoryEditorFrame	MEF
protected int	N_ADDRESS_INPUTS
static int	N_BITS_PER_WORD
static int	N_DATA_INPUTS
protected int	n_words
protected StdLogic1164	output_0
protected StdLogic1164	output_1
protected StdLogic1164	output_X
protected StdLogic1164	output_Z
protected PortStdLogic1164	port_nCS
protected PortStdLogic1164	port_nOE
protected PortStdLogic1164	port_nWE
protected java.lang.String	resourcename
protected double	t_access
protected double	t_tristate
protected double	t_undefined
static int	TRISTATED
static int	UNDEFINED

Fields inherited from class hades.simulator.SimObject

classloader, console, debug, editor, name, parent, ports, propertySheet, simulator, symbol, versionId, visible

Constructor Summary

IDT6116()
IDT6116 constructor

Method Summary

void	addMemoryListener(MemoryListener ML)
boolean	canChangeSize()
void	configure() create and display a 'ConfigDialog' to set the parameters for a SimObject.
void	dbg(java.lang.String msg)
void	elaborate(java.lang.Object arg) elaborate(): This method is called by the simulation engine to initialize the simulation object.
void	evaluate(java.lang.Object arg) evaluate(): called by the simulation engine on all events that concern this object.
int	getAddrOffset() utility method to support systems with different memory components mapped into a single address space at different offsets.
protected void	getAdress()
int	getBitsPerWord() return the number of bits per word in this memory.
PropertySheet	getConfigDialog()
long[]	getDataArray()
long	getDataAt(int address)
java.lang.String[]	getExternalResources() return a String[] array of length 1 with our RAM contents file.
protected java.lang.String	getHexString(long value, int n_chars)
int	getNumberOfAddressInputs()
java.awt.Component	getPropertySheet() return a reference to the 'property sheet' or configuration window for this SimObject.
java.lang.String	getResourcename()
int	getSize() get the number of words in this memory.
boolean	initialize(java.lang.String s) initialize a IDT6116 from a String.
void	initRAM()
boolean	merge(java.io.BufferedReader reader)
boolean	needsExternalResources() we use one external resource: the data file to initialize the RAM contents.
boolean	parse(java.io.BufferedReader br) parse RAM data from a file specified via its Java 1.1 resourcename.
void	parseRAM(java.lang.String resourcename)
void	printSramContent()
void	removeMemoryListener(MemoryListener ML)
boolean	resize(int n_words, int n_bits_per_word)
boolean	save(java.io.PrintWriter PW)
void	setBitsPerWord(int n_bits)
void	setDataArray(long[] data)
void	setDataAt(int address, long value)
void	setResourcename(java.lang.String s)
void	setSize(int n_words)
java.lang.String	toString() toString() - the usual info method
void	write(java.io.PrintWriter ps)

Methods inherited from class hades.simulator.SimObject

constructDynamicSymbol, copy, getBindkey, getClassLoader, getDebug, getEditor, getFullName, getName, getParent, getPort, getPorts, getResourceAsStream, getSimulator, getSymbol, getSymbolResourceName, getToolTip, getVersionId, isVisible, keyPressed, message, mousePressed, needsDynamicSymbol, setClassLoader, setConsole, setDebug, setEditor, setName, setParent, setPorts, setSimulator, setSymbol, setVersionId, setVisible, tearDown

Methods inherited from class java.lang.Object

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

Field Detail

N_DATA_INPUTS

public static final int N_DATA_INPUTS

See Also:

Constant Field Values

N_BITS_PER_WORD

public static final int N_BITS_PER_WORD

See Also:

Constant Field Values

TRISTATED

public static final int TRISTATED

See Also:

Constant Field Values

UNDEFINED

public static final int UNDEFINED

See Also:

Constant Field Values

output_0

protected StdLogic1164 output_0

output_1

protected StdLogic1164 output_1

output_X

protected StdLogic1164 output_X

output_Z

protected StdLogic1164 output_Z

port_nCS

protected PortStdLogic1164 port_nCS

port_nOE

protected PortStdLogic1164 port_nOE

port_nWE

protected PortStdLogic1164 port_nWE

index_A0

protected int index_A0

index_D0

protected int index_D0

N_ADDRESS_INPUTS

protected int N_ADDRESS_INPUTS

n_words

protected int n_words

address

protected int address

data

protected long[] data

_listenerTable

protected java.util.Hashtable _listenerTable

t_access

protected double t_access

t_tristate

protected double t_tristate

t_undefined

protected double t_undefined

resourcename

protected java.lang.String resourcename

MEF

protected MemoryEditorFrame MEF

Constructor Detail

IDT6116

public IDT6116()

IDT6116 constructor

Method Detail

getNumberOfAddressInputs

public int getNumberOfAddressInputs()

needsExternalResources

public boolean needsExternalResources()

we use one external resource: the data file to initialize the RAM contents.

Overrides:

needsExternalResources in class SimObject

getExternalResources

public java.lang.String[] getExternalResources()

return a String[] array of length 1 with our RAM contents file.

Overrides:

getExternalResources in class SimObject

initRAM

public void initRAM()

printSramContent

public void printSramContent()

getResourcename

public java.lang.String getResourcename()

Specified by:

getResourcename in interface Memory

setResourcename

public void setResourcename(java.lang.String s)

Specified by:

setResourcename in interface Memory

initialize

public boolean initialize(java.lang.String s)

initialize a IDT6116 from a String. Currently, the String should contain the following things: the IDT6116 versionId, and the Java resource-name of the RAM datafile to parse, e.g.

       1002 /hades/examples/b-tutorial/ampel-43.rom
    

Overrides:

initialize in class SimObject

write

public void write(java.io.PrintWriter ps)

Overrides:

write in class SimObject

parseRAM

public void parseRAM(java.lang.String resourcename)

parse

public boolean parse(java.io.BufferedReader br)

parse RAM data from a file specified via its Java 1.1 resourcename. If the file is not found or contains illegal data, the RAM is re-initialized to the all-invalid state.

Each line of the RAM data file should contain the address and the corresponding data in hex format, seperated by a colon, e.g. '0001:D3' or '03FF:20'.

The alternative DigLOG compact format, e.g. '0000:000102030405060708090A0B0C0D0E0F' is also accepted.

The RAM model will issue a warning message, if the same location is written multiple times.

Specified by:

parse in interface Memory

setDataAt

public void setDataAt(int address,
                      long value)

Specified by:

setDataAt in interface Memory

getDataAt

public long getDataAt(int address)

Specified by:

getDataAt in interface Memory

getAddrOffset

public int getAddrOffset()

Description copied from interface: Memory

utility method to support systems with different memory components mapped into a single address space at different offsets. Note that the value returned is just used for displaying the addresses in the GUI (e.g. MemoryHexEditorField or MRCanvas), while the simulation uses the raw adresses (always starting at 0).

For example, the D*CORE processor used in our T3 practical course uses one ROM mapped to addresses 0x000..0x6FFF with address offset 0, a RAM mapped to addresses 0x8000..0xFFFF with address offset 0x8000, and IO components mapped to 0x7000..0x7FFF. Standard memory components will usually return 0 here.

Specified by:

getAddrOffset in interface Memory

getBitsPerWord

public int getBitsPerWord()

Description copied from interface: Memory

return the number of bits per word in this memory. This should typically be in the range 1 .. 64.

Specified by:

getBitsPerWord in interface Memory

setBitsPerWord

public void setBitsPerWord(int n_bits)
                    throws java.lang.Exception

Specified by:

setBitsPerWord in interface Memory

Throws:

java.lang.Exception

getSize

public int getSize()

Description copied from interface: Memory

get the number of words in this memory.

Specified by:

getSize in interface Memory

setSize

public void setSize(int n_words)
             throws java.lang.Exception

Specified by:

setSize in interface Memory

Throws:

java.lang.Exception

resize

public boolean resize(int n_words,
                      int n_bits_per_word)
               throws java.lang.Exception

Specified by:

resize in interface Memory

Throws:

java.lang.Exception

canChangeSize

public boolean canChangeSize()

Specified by:

canChangeSize in interface Memory

getDataArray

public long[] getDataArray()

Specified by:

getDataArray in interface Memory

setDataArray

public void setDataArray(long[] data)

Specified by:

setDataArray in interface Memory

merge

public boolean merge(java.io.BufferedReader reader)

Specified by:

merge in interface Memory

addMemoryListener

public void addMemoryListener(MemoryListener ML)

Specified by:

addMemoryListener in interface Memory

removeMemoryListener

public void removeMemoryListener(MemoryListener ML)

Specified by:

removeMemoryListener in interface Memory

getHexString

protected java.lang.String getHexString(long value,
                                        int n_chars)

save

public boolean save(java.io.PrintWriter PW)

Specified by:

save in interface Memory

configure

public void configure()

Description copied from class: SimObject

create and display a 'ConfigDialog' to set the parameters for a SimObject. The default ConfigDialog for the base class (SimObject) itself is empty except for the 'instance name' of the SimObject.

Overrides:

configure in class SimObject

getPropertySheet

public java.awt.Component getPropertySheet()

Description copied from class: SimObject

return a reference to the 'property sheet' or configuration window for this SimObject. We cast the return value to an AWT Component, but typically you can expect either a hades.gui.PropertySheet or an java.awt.Window (Dialog or Frame).

Overrides:

getPropertySheet in class SimObject

getConfigDialog

public PropertySheet getConfigDialog()

Specified by:

getConfigDialog in interface Memory

elaborate

public void elaborate(java.lang.Object arg)

elaborate(): This method is called by the simulation engine to initialize the simulation object.

Specified by:

elaborate in interface Simulatable

Overrides:

elaborate in class SimObject

evaluate

public void evaluate(java.lang.Object arg)

evaluate(): called by the simulation engine on all events that concern this object. The object is responsible for updating its internal state and for scheduling all pending output events.

Specified by:

evaluate in interface Simulatable

Overrides:

evaluate in class SimObject

Parameters:

arg - an arbitrary object argument

getAdress

protected void getAdress()

dbg

public void dbg(java.lang.String msg)

toString

public java.lang.String toString()

toString() - the usual info method

Overrides:

toString in class SimObject