User manual

DEBUG MONITOR COMMANDS
M68CPU32BUG/D REV 1 3-34
MA Macro Define/Display MA
NOMA
Macro Delete NOMA
3.16 MACRO DEFINE/DISPLAY/DELETE
MA [<name>]
NOMA [<name>]
The <name> can be any combination of 1-8 alphanumeric characters.
The MA command allows the user to define a complex command consisting of any number of
CPU32Bug primitive commands with optional parameter specifications. By simply entering the
new <name> plus any arguments on the command line, the stored CPU32Bug commands are
executed. This allows the user to design new commands to simplify the debug process. The
NOMA command is used to delete either a single macro or all macros.
Entering MA without specifying a macro name causes CPU32Bug to list all currently defined
macros and their definitions.
When MA is executed with the name of a currently defined macro, that macro definition is
displayed.
Line numbers are shown when displaying macro definitions to facilitate editing via the macro
edit (MAE) command. If MA is executed with a valid name that does not currently have a
definition, then the CPU32Bug enters the macro definition mode. In response to each macro
definition prompt "M=", enter a CPU32Bug command and a carriage return. Commands entered
are not checked for syntax until the macro is executed. To exit the macro definition mode, enter
only a carriage return (null line) in response to the prompt. If the macro contains errors, it can
either be deleted and redefined or it can be edited with the MAE command. A macro containing
no primitive CPU32Bug commands (i.e., no definition) is not accepted.
Macro definitions are stored in a string pool of fixed size. If the string pool becomes full while in
the definition mode, the offending string is discarded, a message STRING POOL FULL, LAST
LINE DISCARDED is printed and the user is returned to the CPU32Bug command prompt. This
also happens if the string entered would cause the string pool to overflow. The string pool has a
capacity of 511 characters. The only way to add or expand macros when the string pool is full is
to either edit or delete macros.
CPU32Bug commands contained in macros may reference arguments supplied at invocation
time. Arguments are denoted in macro definitions by embedding a back slash (\) followed by a
numerial. As many as ten arguments are permitted. A definition containing a back slash followed
by a zero would cause the first argument to that macro to be inserted in place of the "\0"
characters.
DEBUG MONITOR COMMANDS
M68CPU32BUG/D REV 1 3-31
LO Load S-Records From Host LO
3.15 LOAD S-RECORDS FROM HOST
LO [<port><del>][<addr>][;<X/-C/T>][=<text>]
Use the LO command to download a Motorola S-records format data file from a host computer
to the BCC. The LO command accepts serial data from the host and loads it into on-board
memory.
The optional port number allows the user to specify the download port. If this number is omitted,
the default is port 0.
The BCC default hardware configuration consists of one I/O port; P4 on the BCC or P9 on the
PFB. This limits the user to one host computer running a terminal emulation program. To send S-
records, the user must escape out of the terminal emulation program because the host computer
can not perform terminal emulation and send S-records at the same time. When the host is not in
terminal emulation mode, all status messages from CPU32Bug would be lost. Thus the user must
press <CR> twice after re-entering the terminal emulation program to signal CPU32Bug that
status messages can now be sent.
The optional <addr> field allows the user to enter an offset address. This offset address is added
to the address contained in the address field of each record which causes the records to be stored
in memory at a different location. The contents of the automatic offset register are not added to
the S-record addresses (see OF command). If the address is in the range $0 to $1F and the port
number is omitted, enter a comma before the address to distinguish it from a port number. Only
absolute addresses (i.e., "1000") should be entered, as other addressing modes cause
unpredictable results. An address is allowed here rather than an offset (expression) to permit
support for function codes (see paragraph 2.5).
The optional text field, entered after the equal sign (=), is sent to the host before CPU32Bug
begins looking for S-records at the host port. This allows the user to send a download command
to the host device. This text should NOT be delimited by quote marks. The text string begins
immediately following the equal sign and terminates with the carriage return. If the host is
operating full duplex, the string is echoed back to the host port by the host and appears on the
user’s terminal screen.
In order to accommodate host systems that echo all received characters, the above-mentioned text
string is transmitted to and received from the host one character at a time. After the entire
command is sent to the host, LO looks for a line feed (LF) character from the host, signifying the
end of the echoed command. No data records are processed until this LF is received. If the host
system does not echo characters, LO continues looking for an LF character before data records
are processed. In situations where the host system does not echo characters, it is required that the
first record transferred by the host system be a header record. The header record is not used, but
the LF after the header record serves to break LO out of the loop so data records are processed.
Fr
eescale S
emiconduct
or
, I
Freescale Semiconductor, Inc.
For More Information On This Product,
Go to: www.freescale.com
nc...