15 Emulator Definition Files

Emulator definition files contain a series of commands used to marshall and configure a set of components to emulate a specific hardware platform. These files have a default extension of "CEF". They are plain text and contain one or more commands. Only one command may occur on a line and commands may not span lines. Blank lines are ignored by the application. If the application doesn't support a command, it may ignore it, but should not report an error (warnings are allowed). The valid commands are:

ASCII command

Format: ASCII

Changes memory display to ASCII from EBCDIC.

BYTE command

Format: BYTE

Changes memory display to BYTE view.

CAPTION command

Format: CAPTION text

Changes the application caption to the passed text. All text following the command on the line is used as the caption text.

CONNECT command

Format: CONNECT component1 component2

Connects two components. The outputs of component1 are connected to the inputs of component2. "component1" and "component2" are the names of loaded components. If the names contain spaces, the entire name must be enclosed by single quotes (') or double quotes (").

DISCONNECT command

Format; DISCONNECT component1 component2

Removes all connections between the two specified components. If the names contain spaces, the entire name must be enclosed by single quotes (') or double quotes (").

DOUBLE command

Format: DOUBLE

Changes memory display to double-long (8 byte) integers.

EBCDIC command

Format: EBCDIC

Changes memory display to EBCDIC from ASCII.

HIGH command

Format: HIGH address

Changes the highest shown address to the specified address.

LOAD command

Format: LOAD filespec{/NAME=name} {startup}

Loads a component from the specified file. The optional /NAME switch can be used to rename the component. It is this name that must be used in subsequent UNLOAD, CONNECT, and DISCONNECT commands. "startup" is a startup command to pass to the component. The text in the command is dependant upon the specific component being loaded. If the startup command contains any spaces, it must be delimited with a single (') or double (") quote.

LONG command

Format: LONG

Changes memory display to long (4 byte) integers.

LOW command

Format: LOW address

Changes the lowest shown address to the specified address.

RADIX command

Format: RADIX base

Changes the memory display to the specified base. The value must be between 2 and 36, inclusive, although a given application may support additional bases.

SIGNED command

Format: SIGNED

Changes the memory display to signed integers.

UNLOAD_ALL command

Format: UNLOAD_ALL

Unloads all components.

UNLOAD command

Format: UNLOAD name

Unloads the component with the specified name.

UNSIGNED command

Format: UNSIGNED

Changes the memory display to unsigned integers.

WORD command

Format: WORD

Changes memory display to 2 byte integers.

Command	Description
CONNECT x y	Connect component named x to component named y. Component y is connected to the output of x. Both components must be loaded. If the names contain spaces, they should be enclosed in quotes.
DISCONNECT x y	Disconnect component named x from component named y. If the names contain spaces, they should be enclosed in quotes.
LOAD x {y}	Load component from file named x. Optionally a command line can be passed to the component as y. If the command line contains spaces, it must be enclosed in quotes. "/NAME=z" may be appended to the end of the line, where z is the name by which this component will be referenced.
RUN	Starts execution of the (default) CPU.
UNLOAD_ALL	Removes all loaded components.
UNLOAD x	Removes component named x. If x contains spaces, it must be enclosed in quotes.