NAME
s51, savr, sz80 - 8051, AVR and Z80 microcontrollers simulator for
SDCC.
SYNOPSIS
s51 [options] filenames
savr [options] filenames
sz80 [options] filenames
WARNING
The information in this man page is an extract from the full
documentation of SDCC, and is limited to the meaning of the options.
For complete and current documentation, refer to the ucSim simulator
User Guide.
DESCRIPTION
ucSim is a microcontroller simulator. It is extensible to support
different microcontroller families.
MCS51 family is simulated bys51.
AVR family is simulated by savr.
Z80 processor is simulated by sz80.
Specified files must be names of Intel hex files. Simulator loads them
in specified order into the ROM of the simulated system.
OPTIONS
-t CPU Type of CPU. Recognized types are: 51, 8051, 8751, C51, 80C51,
87C51, 31, 8031, C31, 80C31, 52, 8052, 8752, C52, 80C52, 87C52,
32, 8032, C32, 80C32, 51R, 51RA, 51RB, 51RC, C51R, C51RA, C51RB,
C51RC, 89C51R, 251, C251, DS390, DS390F. Note that recongition
of a CPU type as option does not mean that the simulator can
simulate that kind of CPU. Default type is C51. DS390 supports
Dallas DS80C390 dual-dptr operations, DS390F supports minimal
flat24 mode code and dual-dptr operations.
-X freq[k|M]
XTAL frequency is freq Hertz. k or M can be used to specify
frequency in kHZ or MHz. Space is not allowed between the number
and the k or M. Default value is 11059200 Hz.
-c file
Open command console on file. Command consoles are on standard
input and output by default. Using this option the console can
be opened on any file for example on the serial interface of the
computer.
-Z portnum
Listen for incoming connections on port portnum. Using this
option uCsim can serve multiple consoles. You can get a console
by simply telnet into machine running uCsimto port portnumber.
This option is not available on platforms which doesn’t support
BSD networking.
-s file
Connect serial interface of the simulated microcontroller to the
file. Nothing is used by default which means that characters
transmitted by serial interface of the simulated microcontroller
go to nowhere and it will never receive anything. If you are
going to communicate with serial interface interactively the
best idea is to specify a teminal with -s option.
-S in=file,out=file
Using this option you can specify different files for input and
output streams that uCsim uses to simulate microprocessor’s
serial interface.
-p prompt
Using this option you can specify any string to be the prompt of
command interpreter, for example:
$ s51 -p "s51> "
ucsim 0.2.12, Copyright (C) 1997 Daniel Drotos, Talker Bt.
ucsim comes with ABSOLUTELY NO WARRANTY; for details type ‘show w’.
This is free software, and you are welcome to redistribute it
under certain conditions; type ‘show c’ for details.
s51>
-P Prompt will be a null (’\0’) character. This feature can be
useful for programs which controlls simulator through a pipe.
-V Verbose mode. The simulator notifies you about some kind of
internal actions for example interrupts. Messages are printed on
command console.
-v Print out version number and stop.
-H Print out types of known CPUs. Names printed out by this option
can be used to determine CPU type using -t option.
-h Print out a short help about the options and stop.
COPYING
ucSim is distributed under the GNU General Public License.
SEE ALSO
sdcc(1), s51(1), savr(1), sz80(1).
AUTHOR
This manual page was written by Aurelien Jarno <aurel32@debian.org>,
for the Debian GNU/Linux system (but may be used by others).
UCSIM(1)